Rational Developer for Power Systems Software
V7.6

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

java.lang.Object
  extended by Composite
      extended by com.ibm.etools.iseries.rse.ui.widgets.QSYSBasePrompt
          extended by 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...


Rational Developer for Power Systems Software
V7.6

Copyright 2011 IBM Corp. All Rights Reserved.

Note: This documentation is for part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.