|
|
|
|
The RJE workstation style file is an ASCII text file, with information stored in readable text format. This enables you to check or modify the workstation definition using a standard text editor.
The file consists of a series of records, each of which defines a set of options for the workstation or for the resources associated with it. The records that can be included are described in more detail in RJE Style File Records.
Each record is defined in the following format:
[record_name] parameter_name = value parameter_name = value . . . parameter_name = value
The record_name must be enclosed in square brackets. It is followed by a series of parameter names and values, each on a separate line.
All the parameters associated with a particular record must be listed after the record_name for that record, and before the record_name for the next record in the file. However, the order of individual parameters within a record is not important (except where this is indicated in the command descriptions later in this chapter). Also, note that SNAP-IX provides defaults for many parameters, so you need not specify every parameter explicitly.
A backslash character ( \ ) at the end of a line indicates that the entry continues on the next line. Space or tab characters can be included preceding the backslash, and will be retained; any space characters following the backslash, or any leading spaces on the next line, are ignored. If the spaces are significant (for example, between parameters in the host logon string), ensure that they are placed before the backslash character. For example:
logon_text = logon applid(jes2) logmode(batchs1) \ data (RMT427,,05604Q)
retains the spaces before the backslash character and is interpreted as follows:
logon_text = logon applid(jes2) logmode(batchs1) data (RMT427,,05604Q)
Each parameter in a record is of a defined type-character string, decimal number, or defined constant. For example, in the define_minor_options record, the temp_directory parameter is a character string, console_log_size is a decimal number, and punch_padding is a defined constant. In the record descriptions later in this chapter, the information given for each individual parameter includes its type.
Following is a description of the parameter types and information about valid entries for each type:
A character string; for example, WKS3. The individual parameter description gives details of the maximum and minimum length of each string. When the string must consist of characters from a particular character set (such as alphanumeric, A-string, or Solaris filename characters), this is noted in the parameter description. Otherwise, you can use any character that can be displayed in your computer's local character set. Character strings are case-sensitive.
A numeric value; for example, 128. The individual parameter description gives details of the maximum and minimum values. Specify numeric values in decimal, not in hexadecimal form.
One of a set of defined values, specified as an ASCII character string without quotation marks; for example, PROGRAM. In some cases, a defined constant parameter can be set to a combination of two or more of the defined values, as indicated in the parameter description; where this is not indicated, only one value can be used.
Defined constants are used for parameters with a fixed set of valid values, such as FILE, DIR, and PROGRAM. The individual parameter description lists the defined values for each parameter. Defined constants are not case-sensitive; you can use either uppercase or lowercase.
Some parameters in style file records, such as the name of the output device you are defining, must always be specified explicitly. For other parameters, SNAP-IX provides default values, so that for a standard setup you do not need to specify every parameter in a record. (However, you may prefer to specify parameters explicitly, to make it easier to check the values that are being used.)
The individual parameter descriptions later in this chapter include information about default values where applicable. If no default value is shown for a parameter, you must specify it explicitly.
Embedded space characters are valid within the description parameter and within the logon_text parameter in the define_workstation_options record, but not within any other parameter value. For example, the character string FORM001 is a valid value for a forms control buffer name, but FORM 01 is not.
SNAP-IX ignores all blank space before or after descriptors, parameter names, or parameter values (that is, any combination of spaces and tabs). It also ignores completely blank lines. You may prefer to add blank lines between records to make the file more readable, but this is not required.
|
|
|
 |
|