RMM TSO subcommand return codes

The return codes issued by DFSMSrmm are:

0: Subcommand completed normally.
4: Warning. Subcommand completed but some operands could have been ignored or modified. DFSMSrmm sets a reason code.
8: User not authorized.
12: Subcommand ended with an error. DFSMSrmm sets a reason code.
16: Error. The DFSMSrmm subsystem is not active.
20: Error. The data is incomplete or incorrect and the TSO user has set NOPROMPT.
24: The TSO subcommand is not APF authorized.
28: The user pressed the attention key.

The command processor sets the return code values in Register 15 when the RMM TSO command or subcommands ends. You can find the value of the return code issued in the CLIST or REXX procedure environment.

For example, you can code statements, as shown in Figure 1, in a CLIST to test the return code issued by the LISTVOLUME subcommand:

Figure 1. Testing RMM TSO LISTVOLUME subcommand example 1

PROC 0
  RMM LISTVOLUME TEST01 ALL
  SET RMMLC = &LASTCC
  IF &RMMLC = 0 THEN +
     WRITE COMMAND OK
  ELSE +
     WRITE COMMAND FAILED RC = &RMMLC

You can also code REXX statements, as shown in Figure 2, to test the return code issued by the LISTVOLUME subcommand:

Figure 2. Testing RMM TSO LISTVOLUME subcommand example 2

/*REXX*/
  address "TSO" "RMM LISTVOLUME TEST01 ALL"
  if rc = 0 then
     say "command ok"
  else
     say "command failed rc=" rc