Rational Developer for Power Systems Software
V7.6

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

java.lang.Object
  extended by com.ibm.etools.iseries.rse.ui.widgets.QSYSSelectQSYSAndRemoteFileOrFolderForm
All Implemented Interfaces:
IIBMiConstants, IQSYSSelectionTypes

public class QSYSSelectQSYSAndRemoteFileOrFolderForm
extends Object
implements IIBMiConstants, IQSYSSelectionTypes

Class for selecting a QSYS resource and/or a file or folder from Local, IFS or any hierarchical file system (e.g. Linux).


Field Summary
protected  boolean addMode
           
protected  boolean allowFolderSelection
           
protected  boolean allowForMultipleParents
           
protected  boolean alwaysEnableOK
           
protected  int autoExpandDepth
           
protected  Object caller
           
protected  boolean callerInstanceOfSystemPromptDialog
           
protected  boolean callerInstanceOfWizardPage
           
protected  boolean contentsCreated
           
protected  Hashtable convertedObjects
           
static String copyright
           
protected  IHost defaultConnection
           
protected  SystemFilter[] defaultFilters
           
protected  boolean fileMode
           
protected  boolean filesOnlyMode
           
protected  String fileTypes
           
protected  boolean forceDefaultFiltersNull
           
protected  boolean initDone
           
protected  SelectQSYSAndRemoteObjectAPIProvider inputProvider
           
protected  IRemoteSelectionAddListener iSeriesAddButtonCallback
           
protected  SystemRemoteObjectMatcher iSeriesObjectMatcher
           
protected  SystemFilterSimple liblQuickFilter
           
protected  Vector listeners
           
protected  String locationPrompt
           
protected  ISystemMessageLine msgLine
           
protected  boolean multipleSelectionMode
           
protected  Text nameEntryValue
           
protected  Composite outerParent
           
protected  IHost outputConnection
           
protected  Object[] outputObjects
           
protected  SystemFilter preSelectFilter
           
protected  String preSelectFilterChild
           
protected  boolean preSelectRoot
           
protected  Object previousSelection
           
protected static int PROMPT_WIDTH
           
protected  SystemPropertySheetForm ps
           
protected  Composite ps_composite
           
protected  ResourceBundle rb
           
protected  ISystemAddFileListener remoteAddButtonCallback
           
protected  SystemRemoteObjectMatcher remoteObjectMatcher
           
protected  int selectionType
           
protected  IValidatorRemoteSelection selectionValidator
           
protected  boolean showLiblFilter
           
protected  boolean showLocationPrompt
           
protected  boolean showPropertySheet
           
protected  boolean showRootFilter
           
protected  boolean showYourLibrariesPrompt
           
protected  Label spacer1
           
protected  Label spacer2
           
protected  ISystemRegistry sr
           
protected  boolean srcFilesOnly
           
protected  SystemViewForm tree
           
protected  String treeTip
           
protected  boolean valid
           
protected  String verbage
           
protected  Label verbageLabel
           
protected  List viewerFilters
           
 
Fields inherited from interface com.ibm.etools.iseries.rse.ui.IIBMiConstants
ICON_ACTION_NEWDTAARA_WIZ, ICON_ACTION_NEWDTAARA_WIZ_ID, ICON_ACTION_NEWDTAARA_WIZ_ROOT, ICON_ACTION_NEWDTAQ_WIZ, ICON_ACTION_NEWDTAQ_WIZ_ID, ICON_ACTION_NEWDTAQ_WIZ_ROOT, ICON_ACTION_NEWLIB_WIZ, ICON_ACTION_NEWLIB_WIZ_ID, ICON_ACTION_NEWLIB_WIZ_ROOT, ICON_ACTION_NEWMBR_WIZ, ICON_ACTION_NEWMBR_WIZ_ID, ICON_ACTION_NEWMBR_WIZ_ROOT, ICON_ACTION_NEWMSG_WIZ, ICON_ACTION_NEWMSG_WIZ_ID, ICON_ACTION_NEWMSG_WIZ_ROOT, ICON_ACTION_NEWMSGFILE_WIZ, ICON_ACTION_NEWMSGFILE_WIZ_ID, ICON_ACTION_NEWMSGFILE_WIZ_ROOT, ICON_ACTION_NEWOBJ_WIZ, ICON_ACTION_NEWOBJ_WIZ_ID, ICON_ACTION_NEWOBJ_WIZ_ROOT, ICON_ACTION_NEWSRCFILE_WIZ, ICON_ACTION_NEWSRCFILE_WIZ_ID, ICON_ACTION_NEWSRCFILE_WIZ_ROOT, ICON_CMD_FILTER_CMD, ICON_CMD_FILTER_CMD_ID, ICON_CMD_FILTER_CMD_ROOT, ICON_ERRORLIST_DELETED_LINE, ICON_ERRORLIST_DELETED_LINE_ID, ICON_ERRORLIST_DELETED_LINE_ROOT, ICON_ERRORLIST_GO_BACK, ICON_ERRORLIST_GO_BACK_DISABLE, ICON_ERRORLIST_GO_BACK_DISABLE_ID, ICON_ERRORLIST_GO_BACK_DISABLE_ROOT, ICON_ERRORLIST_GO_BACK_ID, ICON_ERRORLIST_GO_BACK_ROOT, ICON_ERRORLIST_GO_FORWARD, ICON_ERRORLIST_GO_FORWARD_DISABLE, ICON_ERRORLIST_GO_FORWARD_DISABLE_ID, ICON_ERRORLIST_GO_FORWARD_DISABLE_ROOT, ICON_ERRORLIST_GO_FORWARD_ID, ICON_ERRORLIST_GO_FORWARD_ROOT, ICON_ERRORLIST_MODIFIED_LINE, ICON_ERRORLIST_MODIFIED_LINE_ID, ICON_ERRORLIST_MODIFIED_LINE_ROOT, ICON_ERRORLIST_REMOVE, ICON_ERRORLIST_REMOVE_ALL, ICON_ERRORLIST_REMOVE_ALL_DISABLE, ICON_ERRORLIST_REMOVE_ALL_DISABLE_ID, ICON_ERRORLIST_REMOVE_ALL_DISABLE_ROOT, ICON_ERRORLIST_REMOVE_ALL_ID, ICON_ERRORLIST_REMOVE_ALL_ROOT, ICON_ERRORLIST_REMOVE_DISABLE, ICON_ERRORLIST_REMOVE_DISABLE_ID, ICON_ERRORLIST_REMOVE_DISABLE_ROOT, ICON_ERRORLIST_REMOVE_ID, ICON_ERRORLIST_REMOVE_ROOT, ICON_ERRORLIST_SEVERITY_ERROR, ICON_ERRORLIST_SEVERITY_ERROR_ID, ICON_ERRORLIST_SEVERITY_ERROR_ROOT, ICON_ERRORLIST_SEVERITY_INFORMATION, ICON_ERRORLIST_SEVERITY_INFORMATION_ID, ICON_ERRORLIST_SEVERITY_INFORMATION_ROOT, ICON_ERRORLIST_SEVERITY_SEVERE, ICON_ERRORLIST_SEVERITY_SEVERE_ID, ICON_ERRORLIST_SEVERITY_SEVERE_ROOT, ICON_ERRORLIST_SEVERITY_TERMINATING, ICON_ERRORLIST_SEVERITY_TERMINATING_ID, ICON_ERRORLIST_SEVERITY_TERMINATING_ROOT, ICON_ERRORLIST_SEVERITY_WARNING, ICON_ERRORLIST_SEVERITY_WARNING_ID, ICON_ERRORLIST_SEVERITY_WARNING_ROOT, ICON_EXT, ICON_JOB_FILTER_JOB, ICON_JOB_FILTER_JOB_ID, ICON_JOB_FILTER_JOB_ROOT, ICON_JOBSUBSYSTEM, ICON_JOBSUBSYSTEM_ID, ICON_JOBSUBSYSTEM_ROOT, ICON_NFS_ACTION_REFRESH, ICON_NFS_ACTION_REFRESH_DISABLE, ICON_NFS_ACTION_REFRESH_DISABLE_ID, ICON_NFS_ACTION_REFRESH_DISABLE_ROOT, ICON_NFS_ACTION_REFRESH_ID, ICON_NFS_ACTION_REFRESH_ROOT, ICON_NFS_ACTION_TABLEVIEW_UP, ICON_NFS_ACTION_TABLEVIEW_UP_DISABLED, ICON_NFS_ACTION_TABLEVIEW_UP_DISABLED_ID, ICON_NFS_ACTION_TABLEVIEW_UP_DISABLED_ROOT, ICON_NFS_ACTION_TABLEVIEW_UP_ID, ICON_NFS_ACTION_TABLEVIEW_UP_ROOT, ICON_NFS_FILTER_LIBLIST, ICON_NFS_FILTER_LIBLIST_ID, ICON_NFS_FILTER_LIBLIST_ROOT, ICON_NFS_FILTER_LIBRARY, ICON_NFS_FILTER_LIBRARY_ID, ICON_NFS_FILTER_LIBRARY_ROOT, ICON_NFS_FILTER_MEMBER, ICON_NFS_FILTER_MEMBER_ID, ICON_NFS_FILTER_MEMBER_ROOT, ICON_NFS_FILTER_OBJECT, ICON_NFS_FILTER_OBJECT_ID, ICON_NFS_FILTER_OBJECT_ROOT, ICON_NFS_FLD_TYPE_BIN, ICON_NFS_FLD_TYPE_BIN_ID, ICON_NFS_FLD_TYPE_BIN_ROOT, ICON_NFS_FLD_TYPE_CHAR, ICON_NFS_FLD_TYPE_CHAR_ID, ICON_NFS_FLD_TYPE_CHAR_ROOT, ICON_NFS_FLD_TYPE_DATE, ICON_NFS_FLD_TYPE_DATE_ID, ICON_NFS_FLD_TYPE_DATE_ROOT, ICON_NFS_FLD_TYPE_FLOAT, ICON_NFS_FLD_TYPE_FLOAT_ID, ICON_NFS_FLD_TYPE_FLOAT_ROOT, ICON_NFS_FLD_TYPE_HEX, ICON_NFS_FLD_TYPE_HEX_ID, ICON_NFS_FLD_TYPE_HEX_ROOT, ICON_NFS_FLD_TYPE_PACKED, ICON_NFS_FLD_TYPE_PACKED_ID, ICON_NFS_FLD_TYPE_PACKED_ROOT, ICON_NFS_FLD_TYPE_TIME, ICON_NFS_FLD_TYPE_TIME_ID, ICON_NFS_FLD_TYPE_TIME_ROOT, ICON_NFS_FLD_TYPE_TIMESTAMP, ICON_NFS_FLD_TYPE_TIMESTAMP_ID, ICON_NFS_FLD_TYPE_TIMESTAMP_ROOT, ICON_NFS_FLD_TYPE_ZONED, ICON_NFS_FLD_TYPE_ZONED_ID, ICON_NFS_FLD_TYPE_ZONED_ROOT, ICON_NFS_MBR_TYPE_DTA, ICON_NFS_MBR_TYPE_DTA_ID, ICON_NFS_MBR_TYPE_DTA_ROOT, ICON_NFS_MBR_TYPE_SRC, ICON_NFS_MBR_TYPE_SRC_ID, ICON_NFS_MBR_TYPE_SRC_ROOT, ICON_NFS_OBJ_MSGF_MESSAGE, ICON_NFS_OBJ_MSGF_MESSAGE_ID, ICON_NFS_OBJ_MSGF_MESSAGE_ROOT, ICON_NFS_OBJ_TYPE_BNDDIR, ICON_NFS_OBJ_TYPE_BNDDIR_ID, ICON_NFS_OBJ_TYPE_BNDDIR_ROOT, ICON_NFS_OBJ_TYPE_CMD, ICON_NFS_OBJ_TYPE_CMD_ID, ICON_NFS_OBJ_TYPE_CMD_ROOT, ICON_NFS_OBJ_TYPE_CURRLIB, ICON_NFS_OBJ_TYPE_CURRLIB_ID, ICON_NFS_OBJ_TYPE_CURRLIB_ROOT, ICON_NFS_OBJ_TYPE_DATAAREA, ICON_NFS_OBJ_TYPE_DATAAREA_ID, ICON_NFS_OBJ_TYPE_DATAAREA_ROOT, ICON_NFS_OBJ_TYPE_DATAQUEUE, ICON_NFS_OBJ_TYPE_DATAQUEUE_ID, ICON_NFS_OBJ_TYPE_DATAQUEUE_ROOT, ICON_NFS_OBJ_TYPE_DDMF, ICON_NFS_OBJ_TYPE_DDMF_ID, ICON_NFS_OBJ_TYPE_DDMF_ROOT, ICON_NFS_OBJ_TYPE_DISPLAYFILE, ICON_NFS_OBJ_TYPE_DISPLAYFILE_ID, ICON_NFS_OBJ_TYPE_DISPLAYFILE_ROOT, ICON_NFS_OBJ_TYPE_ISERIESOBJ, ICON_NFS_OBJ_TYPE_ISERIESOBJ_ID, ICON_NFS_OBJ_TYPE_ISERIESOBJ_ROOT, ICON_NFS_OBJ_TYPE_JOBDESCRIPTION, ICON_NFS_OBJ_TYPE_JOBDESCRIPTION_ID, ICON_NFS_OBJ_TYPE_JOBDESCRIPTION_ROOT, ICON_NFS_OBJ_TYPE_JOBQ, ICON_NFS_OBJ_TYPE_JOBQ_ID, ICON_NFS_OBJ_TYPE_JOBQ_ROOT, ICON_NFS_OBJ_TYPE_LF, ICON_NFS_OBJ_TYPE_LF_ID, ICON_NFS_OBJ_TYPE_LF_ROOT, ICON_NFS_OBJ_TYPE_LIBRARY, ICON_NFS_OBJ_TYPE_LIBRARY_ID, ICON_NFS_OBJ_TYPE_LIBRARY_ROOT, ICON_NFS_OBJ_TYPE_MESSAGEFILE, ICON_NFS_OBJ_TYPE_MESSAGEFILE_ID, ICON_NFS_OBJ_TYPE_MESSAGEFILE_ROOT, ICON_NFS_OBJ_TYPE_MODULE, ICON_NFS_OBJ_TYPE_MODULE_ID, ICON_NFS_OBJ_TYPE_MODULE_ROOT, ICON_NFS_OBJ_TYPE_MSGQ, ICON_NFS_OBJ_TYPE_MSGQ_ID, ICON_NFS_OBJ_TYPE_MSGQ_ROOT, ICON_NFS_OBJ_TYPE_OUTQ, ICON_NFS_OBJ_TYPE_OUTQ_ID, ICON_NFS_OBJ_TYPE_OUTQ_ROOT, ICON_NFS_OBJ_TYPE_PFSRC, ICON_NFS_OBJ_TYPE_PFSRC_ID, ICON_NFS_OBJ_TYPE_PFSRC_ROOT, ICON_NFS_OBJ_TYPE_PHYSICALFILE, ICON_NFS_OBJ_TYPE_PHYSICALFILE_ID, ICON_NFS_OBJ_TYPE_PHYSICALFILE_ROOT, ICON_NFS_OBJ_TYPE_PNLGRP, ICON_NFS_OBJ_TYPE_PNLGRP_ID, ICON_NFS_OBJ_TYPE_PNLGRP_ROOT, ICON_NFS_OBJ_TYPE_PRINTERFILE, ICON_NFS_OBJ_TYPE_PRINTERFILE_ID, ICON_NFS_OBJ_TYPE_PRINTERFILE_ROOT, ICON_NFS_OBJ_TYPE_PROGRAM, ICON_NFS_OBJ_TYPE_PROGRAM_ID, ICON_NFS_OBJ_TYPE_PROGRAM_ROOT, ICON_NFS_OBJ_TYPE_SAVF, ICON_NFS_OBJ_TYPE_SAVF_ID, ICON_NFS_OBJ_TYPE_SAVF_ROOT, ICON_NFS_OBJ_TYPE_SERVICEPGM, ICON_NFS_OBJ_TYPE_SERVICEPGM_ID, ICON_NFS_OBJ_TYPE_SERVICEPGM_ROOT, ICON_NFS_OBJ_TYPE_SQLPKG, ICON_NFS_OBJ_TYPE_SQLPKG_ID, ICON_NFS_OBJ_TYPE_SQLPKG_ROOT, ICON_NFS_OBJ_TYPE_SYSTEM400_MESSAGE, ICON_NFS_OBJ_TYPE_SYSTEM400_MESSAGE_ROOT, ICON_NFS_OBJ_TYPE_SYSTEM400_MESSAGESEVERE, ICON_NFS_OBJ_TYPE_SYSTEM400_MESSAGESEVERE_ROOT, ICON_NFS_OBJ_TYPE_TBL, ICON_NFS_OBJ_TYPE_TBL_ID, ICON_NFS_OBJ_TYPE_TBL_ROOT, ICON_NFS_OBJ_TYPE_USRQ, ICON_NFS_OBJ_TYPE_USRQ_ID, ICON_NFS_OBJ_TYPE_USRQ_ROOT, ICON_NFS_OBJ_TYPE_USRSPC, ICON_NFS_OBJ_TYPE_USRSPC_ID, ICON_NFS_OBJ_TYPE_USRSPC_ROOT, ICON_NFS_RCD_TYPE_NORMAL, ICON_NFS_RCD_TYPE_NORMAL_ID, ICON_NFS_RCD_TYPE_NORMAL_ROOT, ICON_NULL_FIELD, ICON_NULL_FIELD_ID, ICON_NULL_FIELD_OBJ, ICON_NULL_FIELD_OBJ_ID, ICON_NULL_FIELD_OBJ_ROOT, ICON_NULL_FIELD_ROOT, ICON_RELATIVE_PATH_DLCL16, ICON_RELATIVE_PATH_ELCL16, ICON_RELATIVE_PATH_ETOOL16, ICON_RELATIVE_PATH_FULL, ICON_RELATIVE_PATH_OBJ16, ICON_RELATIVE_PATH_WIZBAN, ICON_SHOW_IN_ERROR_LIST, ICON_SHOW_IN_ERROR_LIST_D, ICON_SHOW_IN_ERROR_LIST_D_ID, ICON_SHOW_IN_ERROR_LIST_D_ROOT, ICON_SHOW_IN_ERROR_LIST_ID, ICON_SHOW_IN_ERROR_LIST_ROOT, ICON_SUFFIX, ICON_SYSTEM_ASUBPROC, ICON_SYSTEM_ASUBPROC_ID, ICON_SYSTEM_ASUBPROC_ROOT, ICON_SYSTEM_CODE, ICON_SYSTEM_CODE_ID, ICON_SYSTEM_CODE_ROOT, ICON_SYSTEM_CODEDSU, ICON_SYSTEM_CODEDSU_ID, ICON_SYSTEM_CODEDSU_ROOT, ICON_SYSTEM_FILTER_WWLIBS, ICON_SYSTEM_FILTER_WWLIBS_ID, ICON_SYSTEM_FILTER_WWLIBS_ROOT, ICON_SYSTEM_FILTER_WWMBRS, ICON_SYSTEM_FILTER_WWMBRS_ID, ICON_SYSTEM_FILTER_WWMBRS_ROOT, ICON_SYSTEM_FILTER_WWOBJS, ICON_SYSTEM_FILTER_WWOBJS_ID, ICON_SYSTEM_FILTER_WWOBJS_ROOT, ICON_SYSTEM_INTERJOB, ICON_SYSTEM_INTERJOB_ID, ICON_SYSTEM_INTERJOB_ROOT, ICON_SYSTEM_JOB, ICON_SYSTEM_JOB_ID, ICON_SYSTEM_JOB_ROOT, ICON_SYSTEM_JOBACTIVE, ICON_SYSTEM_JOBACTIVE_ID, ICON_SYSTEM_JOBACTIVE_ROOT, ICON_SYSTEM_JOBQUEUED, ICON_SYSTEM_JOBQUEUED_ID, ICON_SYSTEM_JOBQUEUED_ROOT, ICON_SYSTEM_KEYFIELD, ICON_SYSTEM_KEYFIELD_ID, ICON_SYSTEM_KEYFIELD_ROOT, ICON_SYSTEM_MESSAGE_ID, ICON_SYSTEM_MESSAGESEVERE_ID, ICON_SYSTEM_NEWDTAARA, ICON_SYSTEM_NEWDTAARA_ID, ICON_SYSTEM_NEWDTAARA_ROOT, ICON_SYSTEM_NEWDTAQ, ICON_SYSTEM_NEWDTAQ_ID, ICON_SYSTEM_NEWDTAQ_ROOT, ICON_SYSTEM_NEWLIBRARY, ICON_SYSTEM_NEWLIBRARY_ID, ICON_SYSTEM_NEWLIBRARY_ROOT, ICON_SYSTEM_NEWMEMBER, ICON_SYSTEM_NEWMEMBER_ID, ICON_SYSTEM_NEWMEMBER_ROOT, ICON_SYSTEM_NEWMSG, ICON_SYSTEM_NEWMSG_ID, ICON_SYSTEM_NEWMSG_ROOT, ICON_SYSTEM_NEWMSGFILE, ICON_SYSTEM_NEWMSGFILE_ID, ICON_SYSTEM_NEWMSGFILE_ROOT, ICON_SYSTEM_NEWSRCFILE, ICON_SYSTEM_NEWSRCFILE_ID, ICON_SYSTEM_NEWSRCFILE_ROOT, ICON_SYSTEM_RUN, ICON_SYSTEM_RUN_ID, ICON_SYSTEM_RUN_ROOT, ICON_SYSTEM_SERVERJOB, ICON_SYSTEM_SERVERJOB_ID, ICON_SYSTEM_SERVERJOB_ROOT, PLUGIN_ID, PREFIX, RSE_TEMP_LIB, RUN_IN_BATCH, RUN_IN_BATCH_CMD_PREFIX, RUN_IN_INTERACTIVE, RUN_IN_INTERACTIVE_CMD_PREFIX, RUN_IN_RSESERVER, RUN_IN_RSESERVER_CMD_PREFIX, RUN_IN_RSESERVERMULTITHREADED, RUN_IN_RSESERVERMULTITHREADED_CMD_PREFIX, validJobNameChars, VARIANTS
 
Fields inherited from interface com.ibm.etools.iseries.rse.ui.widgets.IQSYSSelectionTypes
BROWSEFOR_ANY, BROWSEFOR_COMMAND, BROWSEFOR_CRT_COMMAND, BROWSEFOR_DTAARA, BROWSEFOR_DTAQ, BROWSEFOR_FIELD, BROWSEFOR_FILE, BROWSEFOR_JOB, BROWSEFOR_JOBD, BROWSEFOR_JOBQ, BROWSEFOR_LIBRARY, BROWSEFOR_MEMBER, BROWSEFOR_MESSAGE, BROWSEFOR_MODULE, BROWSEFOR_MSGF, BROWSEFOR_OBJECT, BROWSEFOR_PGM, BROWSEFOR_PGM_MODULE, BROWSEFOR_PGMSRVPGM, BROWSEFOR_PROCEDURE, BROWSEFOR_RECORD, BROWSEFOR_SRVPGM, Copyright
 
Constructor Summary
QSYSSelectQSYSAndRemoteFileOrFolderForm(ISystemMessageLine msgLine, Object caller, int selectionType, boolean srcFilesOnly, boolean fileMode)
          Constructor.
 
Method Summary
 void addFilter(String filterString)
          Add a filter that users can expand to start their search.
 void addFilter(SystemFilter filter)
          Add a filter that users can expand to start their search.
 void addFilters(Vector filterStrings)
          Add one or more filters that users can expand to start their search.
protected  SystemFilter[] addQuickFilter(SystemFilter newFilter)
          Add a filter to the default filter list
 void addSelectionChangedListener(ISelectionChangedListener l)
          Add a listener to selection change events in the tree
protected  void clearErrorMessage()
           
 Control createContents(Shell shell, Composite parent)
          In this method, we populate the given SWT container with widgets and return the container to the caller.
 ISystemFilter createFilterByPrompting(ISystemFilter filterPrompt, Shell shell)
           
 SystemFilter createFilterByPrompting(SystemFilter filterPrompt, Shell shell)
          Prompt the user to create a new filter as a result of the user expanding a promptable transient filter (one of the ones created above).
protected  SystemFilterSimple createQuickFilter(String name, String filterString)
          Create a transient filter given the name and filter string
 void doubleClick(DoubleClickEvent event)
          Triggers a selection changed event and then notifies the caller of the form.
 void enableAddMode(IRemoteSelectionAddListener caller)
          Enable Add mode.
 void enableAddMode(ISystemAddFileListener caller)
          Enable Add mode.
protected  ISystemViewElementAdapter getAdapter(Object o)
          Returns the implementation of ISystemViewElement for the given object.
protected  Object getFirstSelection(ISelection selection)
          Return first item currently selected.
 Control getInitialFocusControl()
          Return control to recieve initial focus
protected  SystemFilterSimple getLiblQuickFilter()
          Create a commonly needed transient filter for *LIBL
 boolean getMultipleSelectionMode()
          Return the multiple selection mode state
protected  SystemFilter[] getQuickFilters()
          Build and return array of transient filters to be shown when the user expands a connection
protected  ISystemRemoteElementAdapter getRemoteAdapter(Object o)
          Returns the implementation of ISystemRemoteElement for the given object.
 IHost getSelectedConnection()
          Return selected connection
 Object getSelectedObject()
          Return first selected object
 Object[] getSelectedObjects()
          Return all selected objects.
protected  Object[] getSelections(ISelection selection)
          Return all items currently selected.
protected  Shell getShell()
          Return shell of parent dialog or wizard
 SystemViewForm getSystemViewForm()
          Return the embedded System Tree object.
 boolean isPageComplete()
          This method can be called by the dialog or wizard page host, to decide whether to enable or disable the next, final or ok buttons.
 void removeSelectionChangedListener(ISelectionChangedListener l)
          Remove a listener for selection change events
 void selectionChanged(SelectionChangedEvent e)
          User selected something in the tree.
 void setAllowForMultipleParents(boolean flag)
          Indicate whether the form should allow selection of objects from different parents
 void setAutoExpandDepth(int depth)
          Specify the zero-based auto-expand level for the tree.
 void setDefaultConnection(IHost conn)
          Set the connection to pre-select and expand
protected  void setErrorMessage(String msg)
           
protected  void setErrorMessage(SystemMessage msg)
           
 void setFileTypes(String fileTypes)
          For files mode, restrict the files list by a comman-delimited array of file types.
 void setFileTypes(String[] fileTypes)
          For files mode, restrict the files list by an array of file types
 void setMemberTypes(String[] mbrTypes)
          Set the members types and attributes to subset by, when the selection mode is members
 void setMessage(String message)
          Set the message shown as the text at the top of the form.
 void setMessageLine(ISystemMessageLine msgLine)
          Often the message line is null at the time of instantiation, so we have to call this after it is created.
 void setMultipleSelectionMode(boolean multiple)
          Set multiple selection mode.
protected  void setNameText(String text)
          Set the hidden name field that enables the OK button
 void setObjectTypes(String[] objTypes)
          Set the object types and attributes to subset by, when the selection mode is anything but libraries.
 void setPageComplete()
          Inform caller of page-complete status of this form
 void setPreSelection(IHost connection, String libraryName)
          Set an library to preselect.
 void setPreSelection(IHost connection, String libraryName, String objectName)
          Set an object to preselect.
 void setPreSelection(IRemoteFile selection)
          Set a file or folder to preselect.
 void setRestrictFolders(boolean restrict)
          Specify whether setRootFolder should prevent the user from being able to see or select any other folder.
 void setRootFolder(IHost connection, String folderAbsolutePath)
          Set the root folder from which to start listing folders or files.
 void setRootFolder(IRemoteFile rootFolder)
          Set the root folder from which to start listing folders.
 void setRootLibrary(IHost connection, String libraryName)
          Set the root library from which to start listing objects.
 void setRootLibrary(IQSYSLibrary library)
          Set the root library from which to start listing objects.
 void setSelectionTreeToolTipText(String tip)
          Set the tooltip text for the remote systems tree from which an item is selected.
 void setSelectionValidator(IValidatorRemoteSelection selectionValidator)
          Specify a validator to use when the user selects a remote file or folder.
 void setShowLiblFilter(boolean show)
          Set to false to not show "*LIBL" library filter on initial expand of a connection.
 void setShowNewConnectionPrompt(boolean show)
          Set to true if a "New Connection..." special connection is to be shown for creating new connections
 void setShowPropertySheet(boolean show)
          Show the property sheet on the right hand side, to show the properties of the selected object.
 void setShowYourLibrariesPrompt(boolean show)
          Set to false to not show "YourLibraries..." special filter prompt
 void setSystemConnection(IHost conn)
          Set the connection to restrict the user to seeing
 void setSystemTypes(IRSESystemType[] systemTypes)
          Restrict to certain system types
 boolean toggleShowPropertySheet(Shell shell, Control contents)
          Show or hide the property sheet.
 boolean verify()
          Completes processing of the wizard page or dialog.
 
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

PROMPT_WIDTH

protected static final int PROMPT_WIDTH
See Also:
Constant Field Values

verbageLabel

protected Label verbageLabel

spacer1

protected Label spacer1

spacer2

protected Label spacer2

nameEntryValue

protected Text nameEntryValue

tree

protected SystemViewForm tree

ps

protected SystemPropertySheetForm ps

msgLine

protected ISystemMessageLine msgLine

outerParent

protected Composite outerParent

ps_composite

protected Composite ps_composite

sr

protected ISystemRegistry sr

verbage

protected String verbage

treeTip

protected String treeTip

selectionType

protected int selectionType

showPropertySheet

protected boolean showPropertySheet

multipleSelectionMode

protected boolean multipleSelectionMode

listeners

protected Vector listeners

selectionValidator

protected IValidatorRemoteSelection selectionValidator

srcFilesOnly

protected boolean srcFilesOnly

showLiblFilter

protected boolean showLiblFilter

showYourLibrariesPrompt

protected boolean showYourLibrariesPrompt

forceDefaultFiltersNull

protected boolean forceDefaultFiltersNull

addMode

protected boolean addMode

iSeriesObjectMatcher

protected SystemRemoteObjectMatcher iSeriesObjectMatcher

iSeriesAddButtonCallback

protected IRemoteSelectionAddListener iSeriesAddButtonCallback

defaultConnection

protected IHost defaultConnection

locationPrompt

protected String locationPrompt

fileTypes

protected String fileTypes

fileMode

protected boolean fileMode

valid

protected boolean valid

filesOnlyMode

protected boolean filesOnlyMode

showRootFilter

protected boolean showRootFilter

alwaysEnableOK

protected boolean alwaysEnableOK

allowForMultipleParents

protected boolean allowForMultipleParents

showLocationPrompt

protected boolean showLocationPrompt

allowFolderSelection

protected boolean allowFolderSelection

remoteAddButtonCallback

protected ISystemAddFileListener remoteAddButtonCallback

remoteObjectMatcher

protected SystemRemoteObjectMatcher remoteObjectMatcher

outputObjects

protected Object[] outputObjects

outputConnection

protected IHost outputConnection

rb

protected ResourceBundle rb

preSelectFilter

protected SystemFilter preSelectFilter

initDone

protected boolean initDone

contentsCreated

protected boolean contentsCreated

inputProvider

protected SelectQSYSAndRemoteObjectAPIProvider inputProvider

liblQuickFilter

protected SystemFilterSimple liblQuickFilter

convertedObjects

protected Hashtable convertedObjects

defaultFilters

protected SystemFilter[] defaultFilters

preSelectFilterChild

protected String preSelectFilterChild

preSelectRoot

protected boolean preSelectRoot

caller

protected Object caller

callerInstanceOfWizardPage

protected boolean callerInstanceOfWizardPage

callerInstanceOfSystemPromptDialog

protected boolean callerInstanceOfSystemPromptDialog

autoExpandDepth

protected int autoExpandDepth

previousSelection

protected Object previousSelection

viewerFilters

protected List viewerFilters
Constructor Detail

QSYSSelectQSYSAndRemoteFileOrFolderForm

public QSYSSelectQSYSAndRemoteFileOrFolderForm(ISystemMessageLine msgLine,
                                               Object caller,
                                               int selectionType,
                                               boolean srcFilesOnly,
                                               boolean fileMode)
Constructor.

Parameters:
msgLine - a GUI widget capable of writing error messages to.
caller - the wizardpage or dialog hosting this form.
selectionType - an enumeration indicating the type of iSeries object to browse for, as specified in IISeriesSelectionTypes
srcFilesOnly - if the selection type is files or members, indicate whether to restrict to source files.
fileMode - true if in select-file mode, false if in select-folder mode for hierarchical file systems, such as IFS, Linux, Unix, etc.
Method Detail

setAllowForMultipleParents

public void setAllowForMultipleParents(boolean flag)
Indicate whether the form should allow selection of objects from different parents


setSystemConnection

public void setSystemConnection(IHost conn)
Set the connection to restrict the user to seeing


setDefaultConnection

public void setDefaultConnection(IHost conn)
Set the connection to pre-select and expand


setShowNewConnectionPrompt

public void setShowNewConnectionPrompt(boolean show)
Set to true if a "New Connection..." special connection is to be shown for creating new connections


setSystemTypes

public void setSystemTypes(IRSESystemType[] systemTypes)
Restrict to certain system types

Parameters:
systemTypes - the system types to restrict what connections are shown and what types of connections the user can create
See Also:
com.ibm.etools.systems.core.ISystemTypes

setRootFolder

public void setRootFolder(IHost connection,
                          String folderAbsolutePath)
Set the root folder from which to start listing folders or files. This version identifies the folder via a connection object and absolute path. There is another overload that identifies the folder via a single IRemoteFile object.

Parameters:
connection - The connection to the remote system containing the root folder
folderAbsolutePath - The fully qualified folder to start listing from (eg: "\folder1\folder2")
See Also:
com.ibm.etools.systems.files.RemoteFileFilterString

setRootFolder

public void setRootFolder(IRemoteFile rootFolder)
Set the root folder from which to start listing folders. This version identifies the folder via an IRemoteFile object. There is another overload that identifies the folder via a connection and folder path.

Parameters:
rootFolder - The IRemoteFile object representing the remote folder to start the list from
See Also:
com.ibm.etools.systems.files.RemoteFileFilterString

setPreSelection

public void setPreSelection(IRemoteFile selection)
Set a file or folder to preselect. This will: If there is no parent, then we were given a root. In which case we will


setFileTypes

public void setFileTypes(String[] fileTypes)
For files mode, restrict the files list by an array of file types

This must be called BEFORE setRootFolder!


setFileTypes

public void setFileTypes(String fileTypes)
For files mode, restrict the files list by a comman-delimited array of file types. The last type must also end in a comma. Eg "java, class," or "class,".

This must be called BEFORE setRootFolder!


setRestrictFolders

public void setRestrictFolders(boolean restrict)
Specify whether setRootFolder should prevent the user from being able to see or select any other folder. This causes two effects:
  1. The special filter for root/drives is not shown
  2. No subfolders are listed in the target folder, if we are listing files. Of course, they are shown if we are listing folders, else it would be an empty list!


enableAddMode

public void enableAddMode(ISystemAddFileListener caller)
Enable Add mode. This means the OK button is replaced with an Add button, and the Cancel with a Close button. When Add is pressed, the caller is called back. The dialog is not exited until Close is pressed.

When a library is selected, the caller is called back to decide to enable the Add button or not.


setShowYourLibrariesPrompt

public void setShowYourLibrariesPrompt(boolean show)
Set to false to not show "YourLibraries..." special filter prompt


setShowLiblFilter

public void setShowLiblFilter(boolean show)
Set to false to not show "*LIBL" library filter on initial expand of a connection. Default is true. If you turn off this and you turn off setShowYourLibrariesPrompt, then the expansion of a connection will be an empty list. So, you must call addLibraryFilter to supply your own, or call setRootLibrary such that expanding a connection immediately lists the contens of that library as per the objTypes setting.


setMessage

public void setMessage(String message)
Set the message shown as the text at the top of the form. Eg, "Select a file"


setSelectionTreeToolTipText

public void setSelectionTreeToolTipText(String tip)
Set the tooltip text for the remote systems tree from which an item is selected.


addFilter

public void addFilter(String filterString)
Add a filter that users can expand to start their search.

This is really a filter string versus a filter, but it is realized in the GUI as a temporary filter.


addFilter

public void addFilter(SystemFilter filter)
Add a filter that users can expand to start their search.

This is really a filter versus a filter string, so you can decide on the name


addFilters

public void addFilters(Vector filterStrings)
Add one or more filters that users can expand to start their search.

These are really filter strings versus filters, but they are realized in the GUI as temporary filters.

Parameters:
filterstrings - Vector of strings or SystemFilter objects

setRootLibrary

public void setRootLibrary(IHost connection,
                           String libraryName)
Set the root library from which to start listing objects. What this means is that when a connection is expanded, the user will immediately see the contents of the given library, subject to the object types you have specified via setObjectTypes.

Not applicable for select-library mode.

Parameters:
connection - The connection to the remote system containing the root library
libraryName - The name of the library to start listing from

setRootLibrary

public void setRootLibrary(IQSYSLibrary library)
Set the root library from which to start listing objects. What this means is that when a connection is expanded, the user will immediately see the contents of the given library, subject to the object types you have specified via setObjectTypes.

Not applicable for select-library mode.

Parameters:
library - An ISeriesLibrary object

setPreSelection

public void setPreSelection(IHost connection,
                            String libraryName)
Set an library to preselect. This will:


setPreSelection

public void setPreSelection(IHost connection,
                            String libraryName,
                            String objectName)
Set an object to preselect. This will:


setObjectTypes

public void setObjectTypes(String[] objTypes)
Set the object types and attributes to subset by, when the selection mode is anything but libraries.

Each String can be a simple type like "*FILE" or a type and attribute, colon-separated, like "*FILE:DSPF".

Here are the default object types per selection type:


  if (selectionType == BROWSEFOR_FILE)
          setObjectTypes(new String[] {"*FILE:*"});
        else if (selectionType == BROWSEFOR_MEMBER)
    setObjectTypes(new String[] {"*FILE:PF-*"});
        else if (selectionType == BROWSEFOR_FIELD)
          setObjectTypes(new String[] {"*FILE:PF-DTA"});                
        else if (selectionType == BROWSEFOR_RECORD)
          setObjectTypes(new String[] {"*FILE:DSPF", "*FILE:PRTF"});            
        else if (selectionType == BROWSEFOR_COMMAND)
          setObjectTypes(new String[] {"*CMD"});                
 


setMemberTypes

public void setMemberTypes(String[] mbrTypes)
Set the members types and attributes to subset by, when the selection mode is members

Each String can be a simple type like "RPG" or a generic string like "RPG*"


setAutoExpandDepth

public void setAutoExpandDepth(int depth)
Specify the zero-based auto-expand level for the tree. The default is zero, meaning show the connections


setShowPropertySheet

public void setShowPropertySheet(boolean show)
Show the property sheet on the right hand side, to show the properties of the selected object.

Default is false


enableAddMode

public void enableAddMode(IRemoteSelectionAddListener caller)
Enable Add mode. This means the OK button is replaced with an Add button, and the Cancel with a Close button. When Add is pressed, the caller is called back. The dialog is not exited until Close is pressed.

The caller will be called back when any remote object(s) is/are selected to decide whether to enable the Add button. It is also called when Add is pressed.


setMultipleSelectionMode

public void setMultipleSelectionMode(boolean multiple)
Set multiple selection mode. Default is single selection only.

If you set this to true you must use getSelectedObjects()

Further, if you turn this on, it has the side effect of allowing the user to select any remote object. The assumption being if you are prompting for members, say, you also want to allow the user to select a file, with the meaning being that all members within the file are implicitly selected.


addSelectionChangedListener

public void addSelectionChangedListener(ISelectionChangedListener l)
Add a listener to selection change events in the tree


removeSelectionChangedListener

public void removeSelectionChangedListener(ISelectionChangedListener l)
Remove a listener for selection change events


setSelectionValidator

public void setSelectionValidator(IValidatorRemoteSelection selectionValidator)
Specify a validator to use when the user selects a remote file or folder. This allows you to decide if OK should be enabled or not for that remote file or folder.


getSelectedObject

public Object getSelectedObject()
Return first selected object


getSelectedObjects

public Object[] getSelectedObjects()
Return all selected objects.

See Also:
setMultipleSelectionMode(boolean)

getSelectedConnection

public IHost getSelectedConnection()
Return selected connection


getSystemViewForm

public SystemViewForm getSystemViewForm()
Return the embedded System Tree object. Will be null until createContents is called.


getMultipleSelectionMode

public boolean getMultipleSelectionMode()
Return the multiple selection mode state


setMessageLine

public void setMessageLine(ISystemMessageLine msgLine)
Often the message line is null at the time of instantiation, so we have to call this after it is created.


getInitialFocusControl

public Control getInitialFocusControl()
Return control to recieve initial focus


toggleShowPropertySheet

public boolean toggleShowPropertySheet(Shell shell,
                                       Control contents)
Show or hide the property sheet. This is called after the contents are created when the user toggles the Details button.

Parameters:
shell - Use getShell() in your dialog or wizard page
contents - Use getContents() in your dialog or wizard page
Returns:
new state -> true if showing, false if hiding

createContents

public Control createContents(Shell shell,
                              Composite parent)
In this method, we populate the given SWT container with widgets and return the container to the caller.

Parameters:
parent - The parent composite

verify

public boolean verify()
Completes processing of the wizard page or dialog. If this method returns true, the wizard/dialog will close; otherwise, it will stay active.

Returns:
true if no errors

setNameText

protected void setNameText(String text)
Set the hidden name field that enables the OK button


getAdapter

protected ISystemViewElementAdapter getAdapter(Object o)
Returns the implementation of ISystemViewElement for the given object. Returns null if the adapter is not defined or the object is not adaptable.


getRemoteAdapter

protected ISystemRemoteElementAdapter getRemoteAdapter(Object o)
Returns the implementation of ISystemRemoteElement for the given object. Returns null if this object does not adaptable to this.


selectionChanged

public void selectionChanged(SelectionChangedEvent e)
User selected something in the tree.


getFirstSelection

protected Object getFirstSelection(ISelection selection)
Return first item currently selected.


getSelections

protected Object[] getSelections(ISelection selection)
Return all items currently selected.


isPageComplete

public boolean isPageComplete()
This method can be called by the dialog or wizard page host, to decide whether to enable or disable the next, final or ok buttons. It returns true if the minimal information is available and is correct.


setPageComplete

public void setPageComplete()
Inform caller of page-complete status of this form


clearErrorMessage

protected void clearErrorMessage()

setErrorMessage

protected void setErrorMessage(String msg)

setErrorMessage

protected void setErrorMessage(SystemMessage msg)

getQuickFilters

protected SystemFilter[] getQuickFilters()
Build and return array of transient filters to be shown when the user expands a connection


addQuickFilter

protected SystemFilter[] addQuickFilter(SystemFilter newFilter)
Add a filter to the default filter list


createQuickFilter

protected SystemFilterSimple createQuickFilter(String name,
                                               String filterString)
Create a transient filter given the name and filter string


getLiblQuickFilter

protected SystemFilterSimple getLiblQuickFilter()
Create a commonly needed transient filter for *LIBL


createFilterByPrompting

public SystemFilter createFilterByPrompting(SystemFilter filterPrompt,
                                            Shell shell)
                                     throws Exception
Prompt the user to create a new filter as a result of the user expanding a promptable transient filter (one of the ones created above).

Returns:
the filter created by the user or null if they cancelled the prompting
Throws:
Exception

getShell

protected Shell getShell()
Return shell of parent dialog or wizard


doubleClick

public void doubleClick(DoubleClickEvent event)
Triggers a selection changed event and then notifies the caller of the form.

See Also:
IDoubleClickListener

createFilterByPrompting

public ISystemFilter createFilterByPrompting(ISystemFilter filterPrompt,
                                             Shell shell)
                                      throws Exception
Throws:
Exception

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.