Control statements

Control statements have the following general format: 
     label      keyword=operand     comment
Where:
label
Is an optional string of non-blank characters. If a given statement does not use a label, the statement must begin with at least one blank. A label of an asterisk is used to designate a comments statement; the remainder of the statement is ignored.
keyword
Is one of the keywords listed in the table "Operand characteristics". The keyword string may be specified in upper, lower, or mixed case. A keyword is separated from its operand by an equal sign, which may in turn, be surrounded by blanks.
operand
Is the value associated with the keyword. See the table "Operand types" for a the description of operand types.
comment
Is any text, separated from the operand by at least one blank.

A statement can contain one, and only one, keyword=operand pair and it cannot be continued across multiple logical records. Blank lines are ignored.

The table "Operand characteristics" describes the general characteristics of the operands for each of the control statement keywords.
  • The Type column indicates the type of operand that must be specified for a given keyword.
  • The AS IS column indicates if the case of the operand is accepted AS IS (that is, the column contains the word Yes) or is converted to Upper Case (that is, the column is blank).
  • The Wild Card column indicates if the operand may be specified using wild card characters. When wildcard characters are allowed in an operand, a question mark (?) is used to represent a single character and an asterisk (*) is used to represent zero or more characters.
  • The Max Length column indicates the maximum length operand which may be specified; this length does not include operand delimiters (that is, surrounding quotes or parentheses).
  • The ARSLOAD column identifies the corresponding ARSLOAD parameter.
  • The Default column indicates the default value for the operand.
Table 1. Operand characteristics
Keyword Type AS IS Wild Card Max Length ARSLOAD Default
APPL Qstring Yes   60 -a null
APPLGROUP Qstring Yes   60 -g null
CAPDSKEEP Boolean         False
DSNPFX String     26   False
ERROPT String     8   Accept
GTRACE Integer     4   null
HALTLIMIT Integer     15   180
JESCLASS String     36   Z
JESNAME String     4   The JES under which ARSYSPIN is executing.
JOBBREAK Boolean         True
LOADPGM String     8   ARSLOAD
MAXDORM Integer     15   120
MAXJESDELAY Integer     15   60
MAXLPP Integer     15   0
MAXSFC Integer     15   100
NOSPINDELAY Boolean     5   False
ODHOST String Yes   128 -h null
ODINSTANCE String Yes   20 -I null
ODUSER String Yes   20 -u null
ODUSERPW String Yes   20 -p null
OUTCC String     8   ASA
OUTSEP Boolean         True
REPORTID String Yes   8   blanks
RSADEXIT Boolean     5 -E False
SELDEST String   Yes 18   null
SELFORM Pstring   Yes 73   null
SELHOLD Boolean         True
SELWTR String   Yes 8   null
STORLIMIT Pstring     32   (NOLIMIT, ABEND)
TEMPPATH String Yes   255 -c null
TEMPUNIT String     8   SYSALLDA
USERSTRING Qstring Yes   128   null
UXnn Pstring     32   No
ZSTRING Qstring Yes   128 -Z null
Table 2. Operand Types
Operand Description
Boolean Indicates the operand must be specified as a boolean.
The following values can be used to indicate a value of True:
  • True, Yes, T, Y, 1
The following values can be used to indicate a value of False:
  • False, No, F, N, 0
Example:

JobBreak=Yes
Integer Indicates the operand must be specified as a series of decimal digits. Example:

MaxDorm=120
Pstring Indicates the operand must be specified as a parenthesized list of comma separated items. Items in the list may be surrounded by blanks, which are ignored. Example:

SelForm=(Form1,Form2)
Qstring Indicates the operand must be specified as a quoted string. All blanks in the string (including leading, trailing and embedded) are considered to be a part of the string. Example:

Appl="My Application"
String Indicates the operand must be specified as a string of characters containing no embedded blanks. Example:

JESname=JES2