Parameters
- CNDB=
- Specifies the address of console destination block which contains the command issuer data (console identifier, console name, command and response token (CART)). When you specify a console identifier of 0 in the CNDB, the issuer receives master command authority. Entries in the hardcopy log for the command have the name INTERNAL associated with them. IF CNDB= is not specified, the default dummy CNDB (with console id 0) is used. R0 is used for the CNDB address.
- TEXT=
- Specifies the address of the message. The first byte of the message must contain the text length, in the range from 1 to 126. R0 may not be used to specify TEXT=.
- PREFIX=
- YES
- Specifies that an 8-byte prefix is to be displayed before the message. The prefix must immediately precede the message. (The one-byte message length field that precedes the message text is considered part of the message.)
- NO
- Specifies that the name of the DSP issuing the macro will be displayed at the beginning of the message.
- MSG=
- Specifies whether the message is to be displayed on the specified console. In either case, the message will appear on the log.
- ASYNCH=
- Specifies whether the command is to be processed asynchronously
or synchronously. If ASYNCH=NO is specified, the caller will not receive
control back until the command is issued. If ASYNCH=YES is specified
(or invoked by default), the caller will receive control back immediately.
ASYNCH=NO is required to ensure that a group of commands (for example,
commands submitted through a DISKRDR member) are processed in FIFO
order.Note: Some JES3 commands, including modify job commands such as *F J=jobname,CL=class, typically do not get processed immediately, even if the ASYNCH=NO option is specified. This expected delay occurs because jobs require scheduling and prioritization. Therefore, a command might only have been queued or partially processed when control returns to the caller.
- CHK=
- Specifies whether console authority checking is required for the message. If you specify CHK=YES, the TOKEN= parameter must also be coded.
- TOKEN=
- Specifies the address of the operator command security token associated with the specified console id. One way you can obtain this token's value is by issuing the IATXSEC macro, specifying REQUEST=VERIFYX. See IATXSEC (Security Authorization Services) for more information about coding the IATXSEC macro. R0 and R1 may not be used to specify TOKEN=.
- 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.