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