DFSMSrmm REXX variables

This topic contains information you can use to create your own REXX execs or procedures to use with DFSMSrmm.

To get the TSO subcommands to return information as REXX variables, you must set the REXX variable SYSAUTH.EDGDATE to a valid abbreviation of a DATEFORM value.

To get REXX variables for the date and time returned in a selected time zone, other than the system local time zone, you must set the REXX variable SYSAUTH.EDGTZ to a valid time zone offset. Default values are returned in local time.

The REXX variable SYSAUTH.EDGTZ has the same format as the value for the TZ subcommand operand:

TZ({+|-}HH[:MM[:SS]])

Specifies the time zone offset when date and time values are specified. The format is {+|-}HH[:MM[:SS]] where:

+|- is the offset direction. Specify + to indicate that the offset is East of the zero median (UT). Specify - to indicate that the offset is West of the zero median (UT). The offset direction is required.
HH is hours
MM is minutes
SS is seconds
An optional colon (:) separates hours from optional minutes and optional seconds.
You can specify a time in the range between 00:00:00 to 15:00:00 for HH:MM:SS. MM and SS value range is 00 to 59.

See z/OS DFSMSrmm Implementation and Customization Guide for information on SYSAUTH.EDGTZ and setting up DFSMSrmm common time support.

All commands set EDG@RC if REXX special variable, RC, is 4, 12, or 20.

When you specify the NOLIST and CLIST operands on a SEARCH subcommand, DFSMSrmm skips the creation of REXX variables for matching resources, except for the EDG@RC special REXX variable.

Some stem variables use the stem value of 0 to indicate the number of items returned by the command for that variable.

Multiple resources stem variables

In some cases, such as EDG@VOL (for SEARCHVOLUME), the .0 stem variable indicates that multiple resources meet the search criteria. For example, if you issue the RMM SEARCHVOLUME subcommand, EDG@VOL.0 might contain 2, indicating that two volumes met the search criteria. EDG@VOL.1 contains the first volume serial number, and EDG@VOL.2 contains the second volume serial number. These variables are listed as "Multiple resources" stem variables in Table 1.

Another example of a multiple resource stem variable is EDG@DSN (for SEARCHDATASET). If you issue the RMM SEARCHDATASET subcommand, EDG@DSN.0 will contain the number of returned resources, which is the number of data sets that met the search criteria. EDG@DSN.1 will contain the data set name for the first data set found and EDG@VOL.1 will contain the volser for the first data set found.

Note: For SEARCHDATASET, only EDG@DSN.0 will contain the number of found data sets.

If you want to see what data is provided in the variables that a subcommand returns, you can use a REXX exec like this to list each variable and the returned output (you will need to adjust the sysauth.edgdate value to suit your environment):

/* REXX */
   sysauth.edgdate = ’AMERICAN’
   "RMM SD OWNER(*)"
   say ’edg@dsn.0 =’ edg@dsn.0
   do i=1 to edg@dsn.0
     say ’edg@dsn.’i ’ =’ edg@dsn.i
     say ’edg@vol.’i ’ =’ edg@vol.i
     say ’edg@own.’i ’ =’ edg@own.i
     say ’edg@cdt.’i ’ =’ edg@cdt.i
     say ’edg@file.’i ’ =’ edg@file.i
   end

The output will look like this:

edg@dsn.0 = 2
   edg@dsn.1 = BERNDS.DATA.SET1
   edg@vol.1 = ELW120
   edg@own.1 = D008210
   edg@cdt.1 = 06/26/2013
   edg@file.1 = 1
   edg@dsn.2 = BERNDS.DATA.SET2
   edg@vol.2 = ELW120
   edg@own.2 = D008210
   edg@cdt.2 = 06/27/2013
   edg@file.2 = 2

Multiple values stem variables

In other cases, such as EDG@VOL (for LISTPRODUCT), the .0 stem variable indicates how many of some repeatable value exist for a single resource. For example, if you issue the RMM LISTPRODUCT subcommand, EDGVOL.0 might contain 5, indicating that five volume serial numbers are associated with the listed product. EDG@VOL.1 contains the first volume serial number, and EDG@VOL.2 contains the second volume serial number, and so on. These variables are listed as "Multiple values" stem variables in Table 1.

Double stem variables

Some variables like EDG@LDMN return information in a double stem variable. For example, if you issue the RMM LISTCONTROL LOCDEF subcommand, EDG@LDMN.1.0 variable contains the number of media names that are used for the first location. EDG@LDMN.1.1 contains the first media name, EDG@LDMN.1.2 the second media name. EDG@LDMN.2.0 variable contains the number of media names used for the second location, EDG@LDMN.2.1 contains the first media name, EDG@LDMN.2.2 the second media name. These variables are listed as "double stem" variables in Table 1.