|
|
|
Returns the deletion identifier for a non-roll deletable message.
The system supports a class of messages classified as non-roll deletable. Such messages are normally used to communicate important information to the operator and when displayed remain visible until explicitly deleted by the operator or by the system.
Non-roll deletable messages is sourced externally, such as from the Automation Services component of the system when passing messages from the operating system, or from within the system by use of the &WRITE NRD=YES statement in an NCL procedure.
Messages generated by &WRITE NRD=YES are classified as non-roll deletable and remain displayed either until deleted by the operator, by placing the cursor on the message and pressing enter, or until the NCL procedure terminates.
The &NRDDEL statement allows an NCL procedure to delete a non-roll deletable message prior to the termination of the procedure. For example, the procedure can issue the &WRITE NRD=YES statement to advise the operator that recovery for a critical network resource is in progress. On successful recovery the procedure can use the &NRDDEL statement to cause the message to be deleted from the operators screen.
&ZDOMID is a system variable that is set following &WRITE NRD=YES and contains the identifier that must be used on the &NRDDEL statement to indicate which non-roll deletable message is to be deleted.
Example: &ZDOMID
& WRITE NRD=YES DATA=Production IMS system has abended. +
Restart in progress.
&SAVEDOMID=&ZDOMID
.
. -* Processing to restart IMS system
.
&NRDDEL &SAVEDOMID -* Delete earlier message.
&WRITE DATA=Production IMS restarted successfully.
Notes:
The &WRITE statement also supports the NRD=OPER operand which requests that a non-roll deletable message be generated which will not be deleted when the procedure terminates. &ZDOMID is not set for such messages as there is no deletion identifier for this type of message. Messages generated in this manner must be deleted manually by the operator as described above.
The NRDRET command is used by the operator to redisplay non-roll deletable messages deleted manually by positioning of the cursor.
Messages deleted by &NRDDEL cannot be recalled by the NRDRET command.
If multiple non-roll deletable messages are to be written it is the procedures responsibility to save the value of &ZDOMID in a user variable.
The actual format of the value of &ZDOMID depends on the origin of the domain ID. For MVS-generated messages, &ZDOMID contains the MVS-format domain ID for the message (8 hexadecimal characters). If the message originates from &WRITE NRD=YES, the domain ID has the format dddd/nnnnnnnn, where dddd is the domain ID of the originating product region and nnnnnnnn is a 1- to 8-digit hexadecimal number.
Note: For more information, see the NRDRET command description in the Online Help.
| Copyright © 2009 CA. All rights reserved. |
|