Starting Resource Recovery Services (RRS)

Use the START RRS command to start resource recovery services (RRS). To start RRS during system initialization, add a START RRS command to the COMMNDxx parmlib member.

Before you can start RRS, your installation must have defined RRS as a subsystem in the IEFSSNxx parmlib member. For RRS to process requests for resources, system logger must be active.

The name of the cataloged procedure that IBM® supplies in SYS1.SAMPLIB for starting the RRS subsystem is ATRRRS. Your installation should copy SYS1.SAMPLIB(ATRRRS) to SYS1.PROCLIB(RRS). If your installation replaces membername RRS with its own procedure for starting RRS, it should ensure that the name of its procedure matches the name of the subsystem specified in the IEFSSNxx parmlib member it uses. Otherwise, you may receive error messages when you start the subsystem.

You can cold start RRS/MVS when the RRS resource manager data log is empty. Cold start processing clears all active log streams except the RRS archive log, which is never cleared.

When the RRS data log contains resource manager data you can warm start RRS/MVS. Warm start processing restores the status of all incomplete backout or commit requests.

Only one copy of RRS can be running on a system. The system will reject an attempt to start a second RRS, even if you specify a different procedure as the first parameter of the START command.

 
S RRS|membername[,CTMEM=CTnRRSxx][,GNAME=lgrpname][,JOBNAME=jobname]

The parameters are:

RRS|membername: Invokes the RRS procedure and creates the RRS address space. If your installation has created a different procedure for starting RRS, use the member name of your procedure.
CTMEM=CTnRRSxx: Identifies the CTnRRSxx parmlib member that contains the options RRS component trace is to use when RRS starts the trace. If you omit this optional parameter, RRS traces only unexpected events until a time when the TRACE CT command specifies different trace options.
GNAME=lgrpname: Specifies the log group name. A log group is a group of systems that share an RRS workload. Specify a value if your installation has multiple RRS workloads. Otherwise, the name defaults to the sysplex name. If you specify a name, it must be 1-8 characters long. The first character must be alphabetic or one of the national characters ($, #, or @), while the remaining characters may be alphanumeric or $, #, or @.
You can find additional information about RRS logging in z/OS MVS Programming: Resource Recovery.
JOBNAME=jobname: Specifies the subsystem name defined in the IEFSSNxx parmlib member corresponding to RRS. The issuer of FORCE jobname,ARM must use this name to bring RRS down, if that proves necessary. If you omit this parameter, the system uses the started JCL procedure name.

Example:

The following example starts RRS with the CTWRRS01 parmlib member:

START RRS,JOBNAME=RRS,CTMEM=CTWRRS01