z/OS TSO/E Programming Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Entering positional operands as lists of ranges

z/OS TSO/E Programming Services
SA32-0973-00

You might want to have some positional operands of your command entered in the form of a list, a range, or a list of ranges. The macro instructions that describe positional operands to the Parse Service Routine, IKJPOSIT, IKJTERM and IKJIDENT, provide a LIST and a RANGE operand. If coded in the macro instruction, they indicate that the positional operands expected can be in the form of a list or a range.
LIST
indicates to the Parse Service Routine that one or more of the same type of positional operands can be entered enclosed in parentheses as follows:
(positional-operand positional-operand …)

If one or more of the items contained in the list are to be entered enclosed in parentheses, both the left and the right parenthesis must be included for each of those items.

The following positional operand types can be used in the form of a list: VALUE, ADDRESS, USERID, UID2PSWD, DSNAME, DSTHING, JOBNAME, CONSTANT, STATEMENT NUMBER, VARIABLE, HEX, CHAR, INTEG, and any positional operands that are not dependent upon delimiters.

RANGE
indicates to the Parse Service Routine that two positional operands are to be entered separated by a colon as follows:
positional-operand:positional-operand

The following positional operand types can be used in the form of a range or a list of ranges: HEX (form X'' only), ADDRESS, VALUE, CONSTANT, STATEMENT NUMBER, VARIABLE, INTEG, and any positional operand that is not dependent upon delimiters.

If the user at the terminal wants to enter an operand that begins with a left parentheses, and you have specified in either the IKJPOSIT or IKJIDENT macro instruction that the operand can be entered as a list or a range, the user must enclose the operand in an extra set of parentheses to obtain the correct result.

For instance, if you have used the IKJPOSIT macro instruction to specify that the DSNAME operand can be entered as a list, and the terminal user wants to enter a dsname of the form:
(membername)/password
The user must enter it as:
((membername)/password)

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014