DOM

DOM

Delete Operator Message

Portability SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
EXAMPLE
RELATED FUNCTIONS

SYNOPSIS

#include <oswto.h>
void DOM(int iMsg);

DESCRIPTION

The DOM function implements the functionality of the OS/390 assembler DOM macro. This function is used to delete an operator message 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 function to delete the message. The iMsg argument is returned as a fullword from the WTO or WTOR function, which has been coded with the _Wmsgid keyword.

RETURN VALUE

There is no return value from the DOM function.

EXAMPLE

This example uses the DOM function to delete an operator message.

 #include <oswto.h>

 int iMsg;

 WTO("Experiencing storage shortage", 
     _Wmsgid &iMsg, _Wend);
          .
          .
          .
 /* delete msg from console */
 DOM(iMsg);

RELATED FUNCTIONS

DOM_TOK , WTO , WTOR

Chapter Contents
Previous
Next
Top of Page