com.ibm.etools.iseries.rse.ui.widgets
Class QSYSAUTLPrompt

java.lang.Object
  Composite
      com.ibm.etools.iseries.rse.ui.widgets.QSYSBasePrompt
          com.ibm.etools.iseries.rse.ui.widgets.QSYSAUTLPrompt

All Implemented Interfaces:

IIBMiHistoryKeys

public class QSYSAUTLPrompt
extends QSYSBasePrompt
implements IIBMiHistoryKeys

This re-usable composite widget is for prompting the user for an authorization list name. This is a commonly required parameter for many iSeries create commands. The autl name widget is a combo that lists special values and previously entered (historical) names. Beside the combo is a button with a Browse label for selecting an authorization list from a remote list.

The composite is layed as follows:

   Authorization list: ______________________v  Browse...
 

There are two modes for this, depending if you are prompting for the AUT parameter, or the CRTAUT parameter. This affects the special values allowed.

See Also:

#setAUTLChangeListener(IQSYSAUTLPromptListener)

Field Summary

String[]	AUT_VALUES
protected ValidatorIBMiObject	autlValidator
protected boolean	autMode
static String	copyright
String[]	CRTAUT_VALUES
protected QSYSAUTLPromptListener	listener

Fields inherited from class com.ibm.etools.iseries.rse.ui.widgets.QSYSBasePrompt

browseAction, browseButton, defaultConnection, enableBrowse, gridColumns, ignoreChanges, onlyConnection, promptCombo, promptLabel, rb, showNewConnection, testing

Fields inherited from interface com.ibm.etools.iseries.rse.ui.IIBMiHistoryKeys

ATTR_OBJ, Copyright, GENERIC_ATTR_OBJ, GENERIC_NAME_CMD, GENERIC_NAME_DTAARA, GENERIC_NAME_DTAQ, GENERIC_NAME_FILE, GENERIC_NAME_FILE_DSPF, GENERIC_NAME_FILE_DSPF_PRTF, GENERIC_NAME_FILE_DTA, GENERIC_NAME_FILE_PRTF, GENERIC_NAME_FILE_SRC, GENERIC_NAME_FILE_SRC_DTA, GENERIC_NAME_FLD, GENERIC_NAME_JOBD, GENERIC_NAME_LIB, GENERIC_NAME_LIB_NOLIBL, GENERIC_NAME_MBR, GENERIC_NAME_MODULE, GENERIC_NAME_MSGF, GENERIC_NAME_OBJ, GENERIC_NAME_PGM, GENERIC_NAME_PGM_SRVPGM, GENERIC_NAME_RCD, GENERIC_NAME_SRVPGM, GENERIC_PREFIX, GENERIC_TYPE_MBR, GENERIC_TYPE_OBJ, HISTORY_PREFIX, JOB_CURR_USERID, JOB_NAME, JOB_NUMBER, JOB_SUBSYSTEM, JOB_USER, KEY_NAME, NAME_ASPDEV, NAME_AUTL, NAME_AUTL_AUT, NAME_AUTL_CRTAUT, NAME_CMD, NAME_DTAARA, NAME_DTAQ, NAME_FILE, NAME_FILE_DSPF, NAME_FILE_DSPF_PRTF, NAME_FILE_DTA, NAME_FILE_PRTF, NAME_FILE_SRC, NAME_FILE_SRC_DTA, NAME_FLD, NAME_JOBD, NAME_LIB, NAME_LIB_NOCURLIB, NAME_LIB_NOLIBL, NAME_MBR, NAME_MODULE, NAME_MSGF, NAME_OBJ, NAME_PGM, NAME_PGM_SRVPGM, NAME_RCD, NAME_SRVPGM, RELEASE_JOB_COMMAND, SAVF_LIB_HISTORY_KEY, SAVF_OBJ_HISTORY_KEY, SAVF_RSTLIB_HISTORY_KEY, SAVF_SAVELIB_HISTORY_KEY, SPLF_FILE, SPLF_USER, STRING_FIND, TYPE_MBR, TYPE_OBJ

Constructor Summary

QSYSAUTLPrompt(Composite parent, int style, boolean autMode, IHost connection)
Constructor

Method Summary

protected void	addOurButtonSelectionListener() AUTL's Browse button pressed handler
String	getAUTLName() Get the user entered or selected authorization list name.
protected IIBMiSelectAction	getBrowseAction(Shell shell, IHost defaultConnection, boolean onlyConnection) Overridable method.
protected boolean	isSpecialValue(String value) Test if given value is one of the special values...
protected void	populateCombo(SystemHistoryCombo combo) Populates the library combo.
void	setAUTLChangeListener(QSYSAUTLPromptListener listener) Identify a caller that is interested in being informed of live error checking status
void	setAUTLName(String name) Set the authorization list name or special displayed in the combo box.
void	setDefaultConnection(IHost defaultConnection) Set the default connection to preselect when Browse is pressed.
void	setPromptLabel(String label) Set the prompt label.
void	setSystemConnection(IHost onlyConnection) Set the system connection to use when Browse is pressed.
SystemMessage	validateAutlInput() Validate authorization list name, as it is typed, or in batch if you wish to call directly.

Methods inherited from class com.ibm.etools.iseries.rse.ui.widgets.QSYSBasePrompt

addBrowseButtonSelectionListener, addModifyListener, addSelectionChangedListener, addSelectionListener, createCombo, createHistoryCombo, createPushButton, createPushButton, getBrowseButton, getCombo, getGridColumns, getItems, getPromptLabel, getSelection, getText, lineUpWith, lineUpWith, prepareComposite, removeBrowseButtonSelectionListener, removeModifyListener, removeSelectionChangedListener, removeSelectionListener, setBrowseButtonFocus, setBrowseButtonLabel, setBrowseButtonToolTipText, setButtonWidthHint, setButtonWidthHint, setEnabled, setFocus, setHost, setIgnoreChanges, setItems, setSelection, setShowNewConnectionPrompt, setText, setToolTipText, setWidthHint, showBrowseButton, showBrowseButton, updateHistory, updateHistory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

copyright

public static final String copyright

See Also:

Constant Field Values

autMode

protected boolean autMode

listener

protected QSYSAUTLPromptListener listener

autlValidator

protected ValidatorIBMiObject autlValidator

CRTAUT_VALUES

public String[] CRTAUT_VALUES

AUT_VALUES

public String[] AUT_VALUES

Constructor Detail

QSYSAUTLPrompt

public QSYSAUTLPrompt(Composite parent,
                      int style,
                      boolean autMode,
                      IHost connection)

Constructor

Parameters:

parent - Parent composite

style - The SWT style flags for overall composite widget. Typically just pass SWT.NULL

boolean - Pass true for AUT mode, false for CRTAUT mode

connection - The connection to limit the user to selecting from.

Method Detail

setAUTLChangeListener

public void setAUTLChangeListener(QSYSAUTLPromptListener listener)

Identify a caller that is interested in being informed of live error checking status

setDefaultConnection

public void setDefaultConnection(IHost defaultConnection)

Set the default connection to preselect when Browse is pressed. This still allows users to select or create other connections.

Overrides:

setDefaultConnection in class QSYSBasePrompt

See Also:

#setSystemConnection(SystemConnection)

setSystemConnection

public void setSystemConnection(IHost onlyConnection)

Set the system connection to use when Browse is pressed. Unlike setDefaultConnection, this has the result of not allowing the user to select or create any other connection.

See Also:

#setDefaultConnection(SystemConnection)

setPromptLabel

public void setPromptLabel(String label)

Set the prompt label. Default is "Authority" or "Create authority" depending on the mode

Overrides:

setPromptLabel in class QSYSBasePrompt

getAUTLName

public String getAUTLName()

Get the user entered or selected authorization list name. Same as calling QSYSBasePrompt.getText()

setAUTLName

public void setAUTLName(String name)

Set the authorization list name or special displayed in the combo box. Same as calling QSYSBasePrompt.setText(String)

getBrowseAction

protected IIBMiSelectAction getBrowseAction(Shell shell,
                                            IHost defaultConnection,
                                            boolean onlyConnection)

Overridable method. Internal use. Returns action to be called when Browse... pressed.

Specified by:

getBrowseAction in class QSYSBasePrompt

populateCombo

protected void populateCombo(SystemHistoryCombo combo)

Populates the library combo. Internal use.

addOurButtonSelectionListener

protected void addOurButtonSelectionListener()

AUTL's Browse button pressed handler

Overrides:

addOurButtonSelectionListener in class QSYSBasePrompt

validateAutlInput

public SystemMessage validateAutlInput()

Validate authorization list name, as it is typed, or in batch if you wish to call directly.

isSpecialValue

protected boolean isSpecialValue(String value)

Test if given value is one of the special values...