Parameter ranges

Some commands have parameters that allow you to specify a range of values. The following explains the ranges for parameters with subscripts (nnnn), (nnn), or (n):

(nnnn) - denotes that you may specify a range for the subscript as follows:
nnnn

A specific numeric value.

nnnn-mmmm

A specific numeric range (for example, 1–15 or 15–1 where 15–1 is interpreted as having all the values from 1 to 15). No matter how the range is specified, all members of the range are processed. Descending or ascending specification does not matter.

nnnn-*

A generic numeric range (for example, 3-* denotes a range from 3 to the highest value allowed).

*-mmmm

A generic numeric range (for example, *-3 denotes a range from the highest value allowed to 3).

*

A generic value that denotes all values in a defined range.
(nnn) - denotes that you may specify a range for the subscript in the same way as (nnnn), where (nnn) is 1-255.
(n) - denotes that you may specify a value (0-9) or a generic range (*).

The effect of specifying a range of values on a command is as if the command had been issued for each value in the range in turn. Therefore, issuing a command with a range of values in descending order does not necessarily have the same effect as issuing the same command with the same range of values in ascending order.

For example, issuing the command $TJ(2-5),C=X has the same effect as issuing the commands:

     $TJ(2),C=X
     $TJ(3),C=X
     $TJ(4),C=X
     $TJ(5),C=X

In this case, JES2 places the jobs on the class X queue, and therefore executes in the order of job number 2 , job number 3, job number 4, and finally job number 5.

Issuing the command $TJ(5-2)C=X has the same effect as issuing the commands:

     $TJ(5),C=X
     $TJ(4),C=X
     $TJ(3),C=X
     $TJ(2),C=X

In this case, JES2 places the jobs on the class X queue, and executes in the order of job number 5, job number 4, job number 3, and finally job number 2.

Note: For display commands, you can omit the subscript. If omitted, this denotes a generic value to include all values in a defined range. For example, the command $D MEMBER is equivalent to $D MEMBER(*).

For a description of the allowed ranges for all parameter specifications, see “JES2 Initialization Statement and Parameter Summary Table” in z/OS JES2 Initialization and Tuning Reference, SA32-0992.

Note: Using the ALL parameter on any type of display command that may involve up to 30,000 jobs is not recommended.