To construct messages, the TEXT parameter is used with either the DSN, ERRID, or APPEND parameter. The address of the combined text is returned in register 1. To route a message, only the ROUTE parameter is used.

TEXT=

Specifies the address of the message. The first byte of the message must contain the length of the text. If coded, then the ROUTE parameter may not be coded. (If the TEXT= parameter is specified, this macro will use register 2.)

ROUTE=

Specifies the address of a 2-word parameter list, which is defined as follows: The first word contains the address of the unit, and the second word contains the address of the volume serial number. If ROUTE is coded, then no parameters, except NORMAL, may be coded.

DSN=

Specifies the address of a data set name. The first byte of the data set name must contain the length of the data set name. The DSN parameter on the SETPARAM initialization statement will be used to determine how much of the data set name should be appended. If coded, then the ERRID and APPEND parameters may not be coded.

ERRID=

Specifies the address of an 8-byte (2-word) area. This area contains the length of the error message to be added in the first byte of the first word, and the address of the error message in the second word. The remainder of the first word must be zeros.

If ERRID is specified, the DSN and APPEND parameters may not be specified.

APPEND=

Specifies the address of the text to be appended to TEXT. The first byte of the text must contain the length of the text. If APPEND is coded, then the DSN and ERRID parameters may not be coded.

NORMAL=

This parameter specifies that after the macro processing routine executes, the issuing program can resume execution at an instruction other than the instruction that immediately follows the macro.