The R Command

This topic describes the R command, the syntax, and parameters.

Use the R command to specify a message that ATAM is to automatically respond to and the reply that is to be issued. The R operator command is similar to the W operator command, but does not require a unit name or device ID. See also The W Command.

Table 1. Syntax and parameters for R command
Item Description
Syntax 
R=msgid,reply,offset[,J=jobname]
R=msgid,I=nnn
R=msgid,A=nnn
Parameters msgid

This parameter is the message number that you wish to monitor. The maximum number of characters allowed for the "msgid" is 11.

reply

This parameter is the exact reply that ATAM is to issue. The reply text must match what is in the message being acted upon (quotes do not count as part of the reply text). The maximum number of characters allowed for the reply is 11.

offset

This parameter is the location (offset), starting with the first character in the message ID, where ATAM can find the matching reply text. The offset number must be in the range of 1 - 127.

For the "R" command, the location does not have to be exact. ATAM will begin scanning at the specified offset and continue until the end of the message to try and match the text. The offset to the matching string in the message is required so that ATAM will not issue invalid responses. An example is provided in the next section.

J=

Optionally, add this parameter to assign response behavior to a specific job name. This is useful for situations where different jobs require different responses to a WTOR. For example, relative to ATAM processing, HSM may need a CANCEL response to the IEF238D WTOR, while all other jobs need a WAIT response. Without the "J" parameter, the MSGID response applies to all jobs.

The next table contains additional parameters for this command.

Table 2. Parameters for R command (continued)
Item Description
Parameters (continued) 
I=nnn
Use the "I" parameter to inactivate a specific MSGID from ATAM WTOR scanning. When the MSGID is inactivated, ATAM continues to detect the WTOR, but ATAM either no longer responds to it or suspends ATAM VARY processing (e.g. ATH085I message) while the WTOR is outstanding. The nnn variable is the three-digit number assigned to the MSGID when added to ATAM. The number can be found by displaying the active MSGID list using the following command: 
F ATAM,W
ATH057I WTOR QUEUE SCANNING IS ACTIVE     
ATH073I ID    STATUS MESSAGE   REPLY TEXT   OFFSET UNIT JOBNAME
ATH051I 003   ACTIVE ATH101D   W                81   N         
ATH051I 002   ACTIVE IEF433D   NOHOLD           17   N         
ATH051I 001 INACTIVE IEF238D   WAIT             17   N

You must specify the MSGID and ID number when you specify the "R" command with the "I" parameter. For example, to inactivate ATH101D, which has an ID of 003, you would enter the following command:

F ATAM,R=ATH101D,I=003
A=nnn
Use the "A" parameter to activate a specific MSGID that has previously been inactivated. The nnn variable is the three-digit number (ID) assigned to the MSGID when added to ATAM. The ID number can be found by displaying the active MSGID list using the following command: 
F ATAM,W
ATH057I WTOR QUEUE SCANNING IS ACTIVE     
ATH073I ID    STATUS MESSAGE   REPLY TEXT   OFFSET UNIT JOBNAME
ATH051I 003   ACTIVE ATH101D   W                81   N         
ATH051I 002   ACTIVE IEF433D   NOHOLD           17   N         
ATH051I 001 INACTIVE IEF238D   WAIT             17   N

You must specify the MSGID and ID number when you specify the "R" command with the "A" parameter. For example, to re-activate ATH101D, which has an ID of 003, you would enter the following command:

F ATAM,R=ATH101D,A=003

Refer to Example #1 for a sample of how to use the "R" command with its parameters.