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 blockNumber 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. |