z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Examples of numeric and symbolic subscripts

z/OS JES2 Commands
SA32-0990-00

The following table illustrates how numeric and symbolic subscripts are processed. The table is based on the following initialization statements for system initiators.

To avoid confusion, it is recommended that when both numeric names and symbolic names are allowed, symbolic names (specified using the NAME= parameter) either include at least one alphabetic character or match the numeric value exactly (for example, INIT(1) NAME=1). This example illustrates the confusion that can occurs when this is not done.

Based on these initiator definitions, JES2 interprets the initiator number and its name as follows:
Table 1. JES2 Processing of Initiators
Example Initiator Statements
INIT1  NAME=3
INIT2  NAME=2
INIT3  NAME=1
INIT4  NAME=4A
INIT5  NAME=10
INIT6  NAME=6
INIT7  NAME=7
INIT8  NAME=8
INIT9  NAME=9
INIT10 NAME=10
INIT11 NAME=11
Command Example JES2 Processing Interpretation
$dinit1
$HASP892 INIT(1) NAME=3
Initiator number 1.
$dinit(1)
$HASP892 INIT(3) NAME=1
Initiator with name "1" exists.
$dinit(5)
$HASP892 INIT(5) NAME=10
Initiator with name "5" does not exist, use init number 5.
$dinit'1'
$HASP892 INIT(3) NAME=1
Initiator with name "1".
$dinit3-4
$HASP892 INIT(3) NAME=1
$HASP892 INIT(4) NAME=4A
Initiator in numeric range of 3-4.
$dinit(3-4)
$HASP892 INIT(3) NAME=1
$HASP892 INIT(4) NAME=4A
Initiator in numeric range of 3-4.
$dinit('3'-'4')
$HASP892 INIT(1) NAME=3
Initiator with names in EBCDIC range '3' to '4'.
$dinit(3-4b)
$HASP892 INIT(1) NAME=3
$HASP892 INIT(4) NAME=4A
4b is non-numeric, so initiator in EBCDIC range '3'-'4b'.
$dinit('1'-'2')
$HASP892 INIT(2)  NAME=2
$HASP892 INIT(3)  NAME=1
$HASP892 INIT(5)  NAME=10
$HASP892 INIT(10) NAME=10
$HASP892 INIT(11) NAME=11
All initiators between EBCDIC '1' to '2' in HEX that is 'F1404040' to 'F2404040'.
$dinit('1'-'10')
$HASP892 INIT(3)  NAME=1
$HASP892 INIT(5)  NAME=10
$HASP892 INIT(10) NAME=10
 
All initiators between EBCDIC '1' to '10' in HEX that is 'F1404040' to 'F1F04040'
$dinit(4-*)
$HASP892 INIT(4)  NAME=4A
$HASP892 INIT(5)  NAME=10
$HASP892 INIT(6)  NAME=6
$HASP892 INIT(7)  NAME=7
$HASP892 INIT(8)  NAME=8
$HASP892 INIT(9)  NAME=9
$HASP892 INIT(10) NAME=10
$HASP892 INIT(11) NAME=11
Numeric range (4 is numeric and * represents the maximum numeric value).
$dinit(4a-*)
$HASP892 INIT(4)  NAME=4A
$HASP892 INIT(6)  NAME=6
$HASP892 INIT(7)  NAME=7
$HASP892 INIT(8)  NAME=8
$HASP892 INIT(9)  NAME=9
 
Ascending EBCDIC range '4A' to '*', in HEX that is 'F4C14040' to 'FFFFFFFF'
Note: There are exceptions to the processing results above. When using JES2 Commands for JOB, STC, TSU, or JOBQ, a numeric subscript (JOB(nn)) is always treated as numeric unless enclosed in quotation marks. Also, job names consisting of all numerics are not valid but may occur in error scenarios for example, a job is incorrectly submitted or received from NJE.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014