Use this system macro to find the address of a symbolic line number entry
in the symbolic line status table (STSTL).
Format
- label
- A symbolic name can be assigned to the macro statement.
- REG=Rx
- A general register (R0-R7) containing an input symbolic line
number.
- ERR=label
- This is an error return label that is defined within the user
program. A branch to this label will occur if the symbolic line number
is not found.
- SPO
- Storage protect option.
- R
- Allows you only to read the SLST entry. This is the default
option.
- W
- Allows you to write to the SLST entry.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- R14 are R15 are reserved for use by this macro and cannot be used as the
general input register.
- The input register must contain a valid symbolic line number.
- An error routine must be defined within the user program, to handle the
error return for a line number that is not valid.
Return Conditions
- If the line number specified is valid, control is returned to the next
sequential instruction (NSI). The general register used as input will
point to the proper entry in the SLST table. The USING statement for
the SLSTL DSECT will have been issued.
- If the line number is not valid, control is returned to the label
specified on the ERR parameter.
- The contents of R14 and R15 are unknown. The contents of R0 through
R9 (other than the input register) are preserved across this macro
call.
- If the line number is valid, the Write option (SPO=W) will set the storage
key to allow modifications of the SLST table.
Programming Considerations
- This macro can be run on any I-stream.
- The storage requirements depend on the SPO parameter. If the Read
(R) option is specified, 34 bytes are required. For the Write (W)
option, only 30 bytes are required.
- If the program had issued a USING statement for the SLSTL DSECT prior to
using this macro, and the register is not the same as specified in the macro
call, DROP the register specified by the PLNSC macro and reissue the USING
statement for the previous SLSTL DSECT.
Examples
None.