Command syntax conventions

The command syntax used in this publication involves lowercase characters that have special meanings. For example, the characters v, x, and n in $S Ivvvv[-vvvv] and $E Lnnnn.xxn mean that you may code values for these characters according to the rules depicted in Table 1.

Table 1. Command syntax character meanings
Character	Meaning
a	Alphabetic (A-Z)
c	All EBCDIC characters except ( ) - = ,
n	Numeric (0-9)
m	Numeric (0-9)
h	Hexadecimal (0-9 and A-F)
j	Alphabetic (A-Z) and the special characters $ # @
v	Alphabetic (A-Z) and numeric (0-9)
x	Alphabetic (A-Z), numeric (0-9), and the special characters $ # @

When entering JES2 operator commands, follow the syntax rules in Table 2, unless specifically indicated otherwise.

Table 2. Command Syntax Conventions
Notation	Description	Example
		Book Syntax	Sample Entry
$	The command is a JES2 command. Enter the $ command identifier as shown. (See notes below.)	$S Ivvvv[-vvvv]	$S I3-7
Apostrophes (also referred to as single quotation marks)	Must be entered as shown.	$D MRn[-n],‘message’	$D MR2-33, ‘OK’
Brackets	Enter all, some, or none of the enclosed parameters in any order. Do not enter the brackets	$S I[vvvv[-vvvv] ]	$S I3
Ellipsis (...)	The parameter can be repeated. You cannot enter both unit record and teleprocessing (tp) devices on the same command. Do not enter the ellipsis.	$Z PRTnnnnn[,PRTnnnnn]...	$Z PRT2,PRT3,PRT4
Lower case	A parameter must be substituted. You can enter the parameter in either uppercase or lowercase.	$T LNEn,P=[password]	$T LNE4,P=SECRET or $t lne4,p=secret
Parentheses	Must be entered as shown if more than one value is specified.	$T PRT3,V=(volume, [,volume]...)	$T PRT3,V=(v1,v2)
Single quotation marks (see Apostrophe)	Must be entered as shown.	$D MRn[-n],‘message’	$D MR2-33, ‘OK’
Items in braces- stacked or denoted by an OR symbol (\|)	One and only one of the parameters must be entered unless otherwise noted. Do not enter the braces or the OR symbol.	$D {Jn\|Sn\|Tn} or $D {Jn } {Sn } {Tn }	$D J100
Underscore	The underscored parameter is the system default. If you do not enter any of the parameters, the system will supply the underscored parameter.	$D A [{,JOB\|,STC\|,TSU}]	$D A,STC
Uppercase	The parameter must be spelled as shown. You can enter the parameter in either uppercase or lowercase.	$C A	$C A or $c a
Note: Because your installation establishes the JES2 command identifier, it may be some character other than $. If your installation's command identifier is not specified in your initialization stream by CONCHAR= parameter on the CONDEF statement, the $ is the default.This publication shows the format of a command entered through any console. A command entered through a card reader has a /* (slash asterisk) in card columns 1 and 2 preceding the command identifier. The system recognizes the following hexadecimal representations of the U.S. National characters; @ as X'7C'; $ as X'5B'; and # as X'7B'. In countries other than the U.S., the U.S. National characters represented on terminal keyboards might generate a different hexadecimal representation and cause an error. For example, in some countries the $ character may generate a X'4A'.

This publication uses the full syntax for the LINE and LOGON commands. JES2 accepts LNE for LINE and LGN for LOGON if you prefer to use the shorter syntax for these commands.

This publication may use sysid to denote “system identifier or member name”. Likewise, jobid denotes “job identifier”. A job identifier is the type of job (JOB, TSU, or STC) followed by the job number.