DOM_TOK

DOM_TOK

Delete Operator Message (using token)

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
IMPLEMENTATION
EXAMPLE
RELATED FUNCTIONS

SYNOPSIS

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

DESCRIPTION

The DOM_TOK 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_TOK function to delete the message. The iMsg argument is same as the fullword supplied to the WTO or WTOR functions using the _Wtoken keyword.

RETURN VALUE

There is no return value from the DOM_TOK function.

IMPLEMENTATION

The DOM_TOK function is implemented by the source module L$UWTO .

EXAMPLE

This example uses the DOM_TOK to delete an operator message.

 #include <oswto.h>

 int iMsg;

 WTO("Experiencing storage shortage", 
     _Wtoken 12345, _Wend);
          .
          .
          .
 /* delete msg from console */
 DOM_TOK(12345);

RELATED FUNCTIONS

DOM , WTO , WTOR

Chapter Contents
Previous
Next
Top of Page