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


Subfields associated with keyword operands

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

A keyword operand can have a subfield of operands associated with it. A subfield contains positional and/or keyword operands, and must be enclosed in parentheses directly following its associated keyword operand.

Separators can appear between a keyword operand and the opening parenthesis of its subfield. In addition, separators can appear after the closing parenthesis of a subfield and the following keyword operand. In the following example, posn1 and kywd2 are operands in the subfield of keyword1:
keyword1(posn1 kywd2)
The same syntax rules that apply to commands apply within keyword subfields.
  • Keyword operands must follow positional operands.
  • Enclosing right parenthesis can be eliminated if the subfield ends at the end of a logical line.
  • The subfield cannot contain unbalanced right parentheses.

If a user enters a keyword with a subfield in which there is a required operand, but does not enter the subfield, the Parse Service Routine prompts for the required operand. The terminal user must not include the subfield parentheses when he enters the required operand.

If a subfield has a positional operand that can be entered as a list, and if this is the only operand in the subfield, the list must be enclosed by the same parentheses that enclose the subfield, such as:
keyword(item1 item2 item3)

where item1, item2, and item3 are members of a list.

If a subfield has as its first operand a positional operand that can be entered as a list, and there are additional operands in the subfield, a separate set of parentheses is required to enclose the list, such as:
keyword((item1 item2 item3) param)

where item1, item2, and item3 are members of a list, and param is an operand not included in the list.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014