Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
DOM — Delete operator message z/OS MVS Programming: Assembler Services Reference ABE-HSP SA23-1369-00 |
|||||||||||||||||||||||||||||||||||||||||||||||||||
DescriptionThe DOM macro deletes an operator message or group of messages from the display screen of the operator's console. It can also prevent messages from ever appearing on any operator's console. When a program no longer requires that a message be displayed, it can issue the DOM macro to delete the message. Depending on the timing of the DOM relative to the WTO(R), the message may or may not be displayed. If the message is being displayed, it is removed when space is required for other messages. When a WTO or WTOR macro is issued, the system assigns an identification number to the message and returns this number (24 bits right-justified) to the issuing program in general register 1. When you no longer need this message displayed, issue the DOM macro using the identification number that was returned in general register 1. EnvironmentThe requirements for the caller are:
Programming requirementsNone. RestrictionsIf you are deleting messages by lists of DOM IDs, you cannot delete more than 60 at a time. Register informationInput register informationBefore issuing the DOM macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register. Output register informationWhen control returns to the caller, the GPRs contain:
Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control. Performance implicationsNone. SyntaxThe DOM macro is written as follows:
ParametersThe parameters are explained as follows:
Note: For any DOM keywords that allow a register specification, the value must be right-justified in the register and the remaining bytes within the register must be zero. Example 1Delete an operator message whose message id is in register 1.
Example 2Delete a number of operator messages. The COUNT parameter indicates
how many messages are to be deleted.
Example 3Delete all messages issued with a particular token.
|
Copyright IBM Corporation 1990, 2014
|