name - Specifies the name of the process to appear in the header of the GUI.
action - Indicates whether the current parameter should be enabled or disabled (ungrayed or grayed) when the value of the parameter specified in the name attribute matches the regular expression given in the
regex attribute. Valid values are
Enable and
Disable.
name - Indicates the name of the parameter upon which the current parameter is dependent.
regex - Gives the regular expression to match to the value of the name parameter. You can specify a single value or use any regular expression to capture a range of specified values. For example, if you want to ungray a parameter when any value is given for another parameter (other than a blank field), you can specify
regex=".*\S.*".
name - Specifies the name that appears on the tab.
datasetlink - This attribute indicates the name of the parameter with
type="sasdataset" that should be used to provide the list of available
variable names for the current
varlist parameter.
filetypelink - This attribute provides the name of another parameter that contains a regular expression with which to filter a file list for the folder chosen in the current parameter. This attribute can only be used for a parameter with
type="path" that has been given as the
folderlink for a
filelist or
filelist1. Note that you can create a hidden parameter to specify a regular expression to use for the file filter that cannot be changed by other users. Also, the regular expression specified in the
filetypelink parameter is applied to the end of the file name, so
"dat" would include all file names that end in
.dat. However, if you only want files with the extension
.dat included but not the extension
.sas7bdat, then you could specify the regular expression
"\.dat".
folderlink - This attribute can be specified for a parameter with
type="filelist" or
type="filelist1". The value specified for this attribute should be the name of the parameter that contains the path of the folder from which to select files for this list.
hidden - This attribute prevents a widget for the parameter from appearing in the
dialog. The value specified in the
value attribute is used in the
SAS code.
label - This attribute specifies the parameter label that appears in the GUI. It may contain spaces.
maxlength - This attribute specifies the maximum number of characters that a text field widget can contain.
name - This attribute specifies the name of the
macro variable in the
SAS code. The name must match exactly and contain no spaces.
options - This attribute specifies a string of options for the parameter separated by commas. For example, use this attribute to specify the values for
type="list".
required - This attribute indicates whether the parameter must be specified by the user before
Submit is enabled. Valid values are
true and
false. The default value is
false.
rows - This attribute indicates either the number of rows to use for a
textarea or the list(s) of available variables for a SAS data set.
type - This attribute specifies the type of JAVA widget to associate with the parameter. Valid values include:
checkbox - This value allows the user to toggle a binary parameter. Specify the two possible returned values f or the check box parameter using the
options attribute, separated by a comma, which corresponds to checked and unchecked. By default,
options="Yes,No" is used to set these values. An example of
type="checkbox" is shown below:
file - This value displays the
icon that prompts the user for a file. The full path and name (including the file extension) of the selected file is assigned to the macro variable. An example generated by type="file" is as follows:
Note: It is recommended that in cases where the file extension does not clearly identify the input file's type, an additional macro variable (e.g. InputFileType) be used in the
SAS code to allow the user to supply the file type at run time. For example, text files can have one of many extensions:
.txt,
.doc, or no extension.
filelist - This value creates a list of files from which the user can make multiple selections using
Ctrl-
click or
Shift-
click. The parameter containing the folder from which to create the file list must be specified using the
folderlink attribute.
filelist1 - This value creates a list of files from which the user can make a single selection. The parameter containing the folder from which to create the file list must be specified using the
folderlink attribute.
list - This value creates a pre-specified pull-down menu from which the user can select multiple entries using
Ctrl-
click or
Shift-
click. Specify the entries of the menu using the
options attribute, separated by commas. The selected values that are assigned to the macro variable are separated by spaces.
list1 - This value creates a pre-specified pull-down menu from which the user can select one entry using a mouse click. Specify the entries of the menu using the
options attribute, separated by commas. An example generated by
type="list1" is shown below:
path - This value displays the
icon which prompts the user for a folder. The full path of the selected folder is assigned to the macro variable.
radiobuttons - This value displays a set of push buttons, one of which the user must select by clicking. List the values for the buttons using the
options attribute, separated by commas. An example generated by
type="radiobuttons" is shown below:
sasdataset - This value displays the
icon which prompts the user for a SAS data set. You should note that no matter which case is used in the path fields, SAS uses its own case conventions when creating data sets. On Unix, SAS data set names are in lowercase. On Windows, SAS data set names begin with a capital letter and then the rest of the name is lowercase. These conventions override the case that is entered in a parameter field for processes or IEs. You should be aware of this when referencing these output data sets in your
SAS code.
sasvarlist - This value creates a list of SAS variables from which the user can select multiple variables using
Ctrl-
click or
Shift-
click. The SAS data set from which to create the variable list must be specified using the
datasetlinkdependency attribute. An example generated by
type="sasvarlist" is shown below:
sasvarlist1 - This value acts as a
sasvarlist for which only one variable can be selected. The SAS data set from which to create the variable list must be specified using the
datasetlinkdependency attribute.
slider - This value provides a widget to enter integer numbers and scroll them by clicking and moving the mouse. Use the
range tag to set up the slider. An example generated by
type="slider" is shown below:
spinner - The value generates a text field that only allows numeric values according to the
domain,
max, and
min set in the range tag for the parameter.
textarea - This value creates a blocked area for entering text. You can use the
rows attribute to specify the number of rows in the area.
textfield - This value creates a standard text box within which the user can type text, the same as for text-based GUIs.
value - This attribute specifies the default value for the parameter.
domain - This attribute lists the numerical domain of the values. Valid values are
real and
integer. By default, the
domain is set to
real.
max - This attribute specifies the maximum allowable value. By default, the
max is set to 10000.
min - This attribute specifies the minimum allowable value.
ndec - This attribute specifies the number of decimal places to round values that are selected with a slider that has
domain="real". The default value is set to 2.