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


The parameter control entry built by IKJIDENT

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

The IKJIDENT macro instruction generates the variable-length parameter control entry (PCE) shown in Table 1.

Table 1. The parameter control entry built by IKJIDENT
Number of bytes Field name Contents or meaning
2   Flags. These flags are set to indicate which options were specified in the IKJIDENT macro instruction.
Byte 1:
100. ....
This is an IKJIDENT PCE.
...1 ....
PROMPT
.... 1...
DEFAULT
.... .1..
This is an extended format PCE. If the VALIDCK parameter is specified, the length of the field containing the address of the validity checking routine is four bytes.
.... ..1.
HELP
.... ...1
VALIDCK
Byte 2:
1... ....
LIST
.1.. ....
ASIS
..1. ....
RANGE
...0 0000
Reserved
2   Length of the parameter control entry. This field contains a hexadecimal number representing the number of bytes in this IKJIDENT PCE.
2   Contains a hexadecimal offset from the beginning of the parameter descriptor list to the related parameter descriptor entry built by the Parse Service Routine.
1   A flag field indicating the options coded on the IKJIDENT macro instruction.
1... ....
ASTERISK
.1.. ....
MAXLNTH
..1. ....
PTBYPS
...1 ....
Integer
.... 1...
Character
.... .1..
Hexadecimal
.... ..00
Reserved
1   This field contains a hexadecimal number indicating the character type restriction on the first character of the character string described by the IKJIDENT macro instruction.
HEX
Acceptable characters
 
 
X'0'
Any (except blank, comma, tab, semicolon)
X'1'
Alphabetic or one of the special characters $, #, @
X'2'
Numeric
X'3'
Alphabetic, numeric, or one of the special characters $, #, @
X'4'
Alphabetic
X'5'
Alphabetic or numeric
1   This field contains a hexadecimal number indicating the character type restriction on the other characters of the character string described by the IKJIDENT macro instruction.
HEX
Acceptable characters
 
 
0
Any (except blank, comma, tab, semicolon)
1
Alphabetic or one of the special characters $, #, @
2
Numeric
3
Alphabetic, numeric, or one of the special characters $, #, @
4
Alphabetic
5
Alphabetic or numeric
2   This field contains a hexadecimal number representing the length of the parameter type segment. This figure includes the length of this field, the length of the message segment offset field, and the length of the parameter type field supplied on the IKJIDENT macro instruction.
2   This field contains the message segment offset. It is set to X'0012'.
Variable   This field contains the field supplied as the parameter type operand of the IKJIDENT macro instruction.
1   This field contains a hexadecimal number representing the maximum number of characters the string can contain. This field is present only if the MAXLNTH operand was coded on the IKJIDENT macro instruction.
1   This field contains the length minus one of the defaults or prompting information supplied on the IKJIDENT macro instruction. This field and the next are present only if DEFAULT or PROMPT were specified on the IKJIDENT macro instruction.
Variable   This field contains the prompting or default information supplied on the IKJIDENT macro instruction.
2   This field contains a hexadecimal figure representing the length in bytes of all the PCE fields used for second-level messages. The figure includes the length of this field. The fields are present only if HELP is specified on the IKJIDENT macro instruction.
1   This field contains a hexadecimal number representing the number of second-level messages specified by HELP on this IKJIDENT PCE.
2   This field contains a hexadecimal number representing the length of this HELP segment. The figure includes the length of this field, the message segment offset field, and the length of the information. These fields are repeated for each second-level message specified by HELP on the IKJIDENT macro instruction.
2   This field contains the message segment offset. It is set to X'0000'.
Variable   This field contains one second-level message supplied on the IKJIDENT macro instruction specified by HELP. This field and the two preceding ones are repeated for each second-level message supplied on the IKJIDENT macro instruction; these fields do not appear if no second-level message data was supplied.
3 or 4   This field contains the address of a validity checking routine if VALIDCK was specified on the IKJIDENT macro. If the "extended format PCE" bit is on in the IKJIDENT PCE, the address is four bytes long; if the bit is off, the address is three bytes long. This field is not present if VALIDCK was not specified.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014