library-defined verbs.
A control statement verb cannot be continued to a second record.When COS encounters a verb in a control statement file, i t searches for a match to that verb. First, i t searches the list of system verbs for a match. If the verb is not a system verb, COS searches first for a local dataset, next for a matching program name in the datasets in the library searchlist, and then for a matching system dataset name in the System Directory Table (SDR). If a match for the verb is not found under any of these categories, COS issues a control statement error and aborts the job step.
4-2 SR-0011
a
.
-4.2.1 SYSTEM VERBS
A system verb consists of an althabetic character that can be followed 1 to 7 alphanumeric characters. The system verb requests that COS perform a function. The system verbs are as follows:
*
ACCESS ACQUIRE ADJUST ASSIGN CALL&DATA DELETE DISPOSE DUMP JOB ECHO ELSE ELSEIF ENDIF END LOOP ENDPROC EXIT EXITIF
EXITLOOP FETCH HOLD IF IOAREA JOB
LIBRARY LOOP MEMORY MODE MODIFY NOHOLD
NORERUN OPTION PERMIT PRINT PROC RELEASE
RERUN RESTORE RETIRE RETURN REWIND ROLLJOB
SAVE SET SUBMIT SWITCH TARGET
The Cray Simulator (CSIM) Reference Manual, publication SR-0073, describes the SIMABORT control statement.
4.2.2 LOCAL DATASET NAME VERBS
by
Local dataset name verbs begin with an alphabetic character followed by 1 to 6 alphanumeric characters.t Local dataset name verbs request that COS load and execute an absolute binary program from the first record of the named dataset. If the user job has a dataset with the indicated name, COS loads and executes the program from that dataset.
4.2.3 LIBRARY-DEFINED VERBS
Library-defined verbs consist of 1 to 8 characters. The library-defined verb is either a program or procedure definition residing in a library that is a part of the current library searchlist. (The library
searchlist defines the library and the order in which the libraries are searched by COS. This order can be specified with the LIBRARY statement described in section 7.) A program in a library is an absolute binary program to be loaded and executed. A procedure definition is a group of control statements or data or both to be processed (refer to section 16).
t Alphabetic characters include $, %, @, and the letters A through Z (uppercase and lowercase). Alphanumeric characters include all the alphabetic characters and the digits 0 through 9.
SR-0011 0 4-3
4.2.4 SYSTEM DATASET NAME VERBS
COS searches for a verb that is the name of a system-defined dataset in the SDR. A system-defined dataset name verb begins with an alphabetic character followed by 1 to 6 alphanumeric characters. The SDR is a list of common language processors and utilities known to the system and made available to users at startup. The name of the program (for example, CAL, CFT, or DUMP) is also the name of the dataset containing the absolute binary of the program. The exact list of system dataset name verbs is site-dependent.
4.3 SEPARATORS
A
separator
is a character used as a delimiter in a control statement.It separates the verb from the first parameter, separates parameters from one another, delimits subparameters, terminates verbs and parameters, and separates a keyword from its value in parameters having keyword form.
Table 4-1 shows the control statement separators allowed by COS.
4.4 PARAMETERS
A
parameter
is a control statement argument whose exact requirements are defined by the control statement verb. Parameters are used incontrol statements to specify information to be used by the verb-defined process. Parameters that can be used with COS control statements are either
positional
orkeyword.
For certain verbs, a parameter value can be an expression. Detailed information on the use of expressions is presented later in this section. Parameters are separated by commas.4.4.1 POSITIONAL PARAMETERS
A positional parameter has a precise position relative to the separators in the control statement. Even a null positional parameter must be delimited from the control statement verb or other parameters by a separator.
4-4 SR-0011 0
Table 4-1. Control Statement Separators
Function
Initial separator (comma or open parenthesis)t - Separates the verb from the first parameter Statement terminator (period if initial separator is comma, close parenthesis if initial separator is open parenthesis)t - Signifies end of control statement
Parameter separator (comma) -Indicates the end of one parameter and the beginning of the next Equivalence separator (equal sign) Delimits a parameter keyword from the first parameter value for that key-word. Adjacent equivalence separa-tors are illegal.
Concatenation separator (colon) -Separates multiple parameter values from each other
Continuation character (caret) -Indicates that the control statement consists of more than one 80-character card; may appear anywhere after the initial separator.
Literal string delimiters
(apostrophes)tt - Identifies the beginning and end of a literal string
Parenthesis delimiters (open and close parentheses) - Indicates a group of characters to be treated as one value
(
...
) VERB(keyword=(value:value)t By convention, the comma and period are used as nitial and terminator separators for all control statements except on the JCL block control statements (procedure definition, iterative, and conditional), where paired parentheses are conventional.
I
The formats for a positional parameter follow:
value
Each
valuei
is a string of alphanumeric characters, a literal string, or a null string. Positional parameters are represented by at least onevalue,
unless the value is null. To represent null values, use only the closing comma.Examples of positional parameters:
... ,ABCDE, ...
... ,Pl:P2:P3, ...
VERB() or VERB,. or VERB.
4.4.2 KEYWORD PARAMETERS
The parameter value is ABCDE.
The adjacent parameter separators indicate a null positional parameter.
The parameter consists of multiple values . The positional parameter 1 is null.
A
keyword parameter
is identified by its form rather than by its position in the control statement. The keyword is a string of 1 to 8 alphanumeric characters uniquely identifying the parameter. Parameters of this type can occur in any order but must be placed after all of the positional parameters for the control statement, or they can sometimes be omitted.The formats of keyword parameters are as follows: