MSGDISP—Displaying a Ready Message

The format of the MSGDISP macro with the RDY parameter is:


>>-+-------+--MSGDISP--RDY--,DCB=addr--+-------------------+---->
   '-label-'                           '-,MF=-+-L--------+-'   
                                              '-(E,addr)-'     

>--+--------------------+--------------------------------------><
   '-,TXT=-+-'msgtxt'-+-'   
           '-addr-----'

RDY

Displays the text supplied in the TXT parameter in positions 2 through 7 while the data set is open. The display is steady (not flashing) and is enclosed in parentheses. The display is also written to the tape pool console (routing code 3, descriptor code 7).

DCB=addr

Specifies the address of a DCB opened to a data set on the mounted volume. If multiple devices are allocated, the message display is directed to the one containing the volume currently in use.

Tip: If multiple devices or multiple volumes are allocated, you can update a message display after an end-of-volume condition by using the EOV user exit specified in a DCB exit list. In the case of a concatenated data set with unlike characteristics, the DCB OPEN exit can also be used to update the display.

addr—RX-type address, A-type address, or (2-12): Specifies the address of the opened DCB. For MF=L, you can only specify an A-type address.

MF=L or (E,addr)

Specifies either the execute or list form of MSGDISP. If this parameter is not specified, the standard form of the macro is used.

L

Specifies the list form of MSGDISP. This generates a parameter list that can be used as input to the execute form. The execute form can modify the parameter list.

(E,addr)

Specifies that the execute form of the macro and an existing parameter list is to be used.

addr—RX-type address, (1), or (2-12): Specifies the address of the parameter list.

TXT='msgtxt' or addr

Specifies up to six characters to display in positions 2 through 7 of the display. If you do not specify TXT, blanks are displayed.

'msgtxt': Specifies the text as a literal. Express® in apostrophes.
addr—RX-type address, A-type address, or (2-12): Specifies the address of an area containing the text to be displayed. For MF=L, you can only specify an A-type address.