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

java.lang.Object
  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:

• Set the parent folder as the root folder
• Pre-expand the parent folder
• Pre-select the given file or folder after expansion

If there is no parent, then we were given a root. In which case we will

• Force setRestrictFolders to false
• Pre-expand the root drives (Windows) or root files (Unix)
• Pre-select the given root drive (Windows only)

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:

• Set the connection as the default connection
• Add a filter for the parent library
• Pre-expand the library filter
• Pre-select the library after expansion

setPreSelection

public void setPreSelection(IHost connection,
                            String libraryName,
                            String objectName)

Set an object to preselect. This will:

• Set the connection as the default connection
• Add a filter for the contents of the given library, honoring the object types for this selection type
• Pre-expand the parent library filter
• Pre-select the given object after expansion

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