Automated Recovery Facility › Rules for Coding ARF Action Statements › AM - Issue a Message

AM - Issue a Message

Statement Identifier

AM

Purpose

Execution of the AM action statement causes a message to be issued to the MVS console or to a specified TSO user.

Format

The following are the allowable keywords:

CM=

The data following the CM= specifies the communications mode for the message. The following are the acceptable values of CM=:

T

Send the message to the user whose TSO ID is specified using the U= keyword. The message is not retained if the specified TSO user is not logged on.

L

Send the message to the user whose TSO ID is specified using the U= keyword. If the specified TSO user is not logged on, the message will be retained and can be displayed in the next TSO session.

C

Send the message to the MVS console.

H

Send the message to the MVS console and highlight them.

U=

The data following the U= names the TSO user that is to receive the message. This value is required if CM=T or CM=L. It is invalid for any other value of CM. This keyword can also be coded as USER=.

M=

The data following the M= specifies the text of a message that is to be issued. If the text contains commas or keywords (x=y), enclose the entire text string in parentheses. The maximum length is 60 characters.

Examples

The example illustrates the use of the AM action statement to send the message "HELLO THERE!" to a TSO user.

AM,CM=T,U=TSOUSER1,M=HELLO THERE!

The example illustrates the use of the AM action statement to send the message "HELLO CONSOLE!" to the MVS console.

AM,CM=C,M=HELLO CONSOLE!