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


Building the GETLINE Parameter Block

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

When the list form of the GETLINE macro instruction expands, it builds a two word GETLINE parameter block (GTPB). The list form of the macro instruction initializes this GTPB according to the operands you have coded in the macro instruction. This initialized block, which you can later modify with the execute form of the macro instruction, indicates to the GETLINE service routine the function you want performed.

You must supply the address of the GTPB to the execute form of the GETLINE macro instruction. For non-reentrant programs you can do this simply by placing a symbolic name in the symbol field of the list form of the macro instruction, and passing this symbolic name to the execute form of the macro instruction as the PARM value. The GETLINE parameter block is defined by the IKJGTPB DSECT, which is provided in SYS1.MACLIB. Table 1 describes the contents of the GTPB.

Table 1. The GETLINE parameter block
Number of bytes Field name Contents or meaning
2   Control flags. These bits describe the requested input line to the GETLINE service routine.
Byte 1:
..0. ....
The input line is a logical line.
..1. ....
The input line is a physical line.
...0 ....
The input line is to be obtained from the current input source indicated by the input stack.
...1 ....
The input line is to be obtained from the terminal.
xx.. xxxx
Reserved bits.
Byte 2:
1... ....
SUBSTACK=YES is specified.
.xxx xxxx
Reserved.
2   GET options field. These bits indicate to the GETLINE service routine which of the options you want to use for GET.
Byte 1:
1... ....
Always set to 1.
...0 ....
WAIT processing has been requested. Control will be returned to the issuer of GETLINE only after an input message has been read.
...1 ....
NOWAIT processing has been requested. Control will be returned to the issuer of the GETLINE macro instruction whether a line of input is available.
.... ..00
EDIT processing has been requested. In addition to the editing provided by ASIS processing, the input buffer is to be filled out with trailing blanks to the next doubleword boundary.
.... ..01
ASIS processing has been requested. (See the ASIS operand of the GETLINE macro instruction description.)
.xx. xx..
Reserved bits.
Byte 2:
xxxx xxxx
Reserved.
4 GTPBIBUF The address of the input buffer. The GETLINE service routine fills this field with the address of the input buffer in which the input line has been placed.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014