Specifying JCL for starting RMGR
The following figure shows generic JCL for starting RMGR.
Figure 1. RMGR startup JCL
//rmgrname PROC or //rmgrname JOB (ACCT),'RMGR BATCH JOB',MSGCLASS=X,CLASS=Q //* //*----------------------------------------------------* //* RECOVERY MANAGER * //* THIS RMGR CONNECTS TO IMSID IMST * //*----------------------------------------------------* //IRMPROD EXEC PGM=IRMINIT,REGION=0M,TIME=1440 //STEPLIB DD DISP=SHR,DSN=product.LOAD //BMCPSWD DD DISP=SHR,DSN=product.PASSWORD <--(optional) //IRMPRINT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //ABNLIGNR DD DUMMY <--(recommended) //SYSPRINT DD SYSOUT=* //IRMTRACE DD SYSOUT=* <--(may need OUTLIM parm if //* site default too low) //SYSIN DD DISP=SHR,DSN=IRM.SAMP(IRMSYSIN)
Specify the following statements in the startup JCL.
Do not add other statements unless a BMC technical support analyst directs you to do so.
|PROC or JOB|| |
(required) Use the PROC statement if you want to start RMGR as a started task. Use the JOB statement if you want to start RMGR as a batch job. Set the PROC or JOB name to the RMGR name that identifies this RMGR in all RMGR processes and interfaces.
(required) Specify program IRMINIT. A REGION value of 0M is recommended. Set the TIME keyword to the maximum value (1440).
|STEPLIB DD|| |
(required) Identify the BMC product load library that contains the RMGR load modules. This library must be APF authorized.
|BMCPSWD DD|| |
(optional) Identify the library that contains the RMGR CPU authorization table. If you omit this statement, the library that contains the passwords must be in the STEPLIB concatenation or the CPU authorization table must be in the product load library.
|IRMPRINT DD|| |
(required) Specify a valid SYSOUT device to contain the RMGR processing log. The processing log includes startup messages and all messages that were issued after RMGR startup.
|SYSUDUMP DD|| |
(required) Specify a valid SYSOUT device to contain dump information in case of a problem.
|ABNLIGNR DD|| |
(recommended) Include this statement to turn off the Abend-AID product so that a complete dump is produced in case of a problem. During initialization processing, RMGR dynamically allocates the ABNLIGNR DD statement if you omit it.
|SYSPRINT DD|| |
(required) Specify a valid SYSOUT device to contain system messages. This data set also contains GENJCL output.
|IRMTRACE DD|| |
(required) If you omit this statement, RMGR allocates this data set dynamically but sets the TRACE option to NO. Specify a valid SYSOUT device to contain the trace information (control block and task information) that RMGR produces if you include the TRACE keyword in the RMGR startup control statements or issue the RMGR-enhanced modify command with the TRACEON keyword. This data set is empty if tracing is turned off.
If a low limit for SYSOUT lines is set at your installation, you may need to specify the OUTLIM parameter to override that limit.
If you direct this output to a data set other than SYSOUT and this data set is not large enough to contain the trace information, the condition may cause an RMGR abend.
|SYSIN DD|| |
(required) Specify a data set to contain control statements for RMGR startup. You can specify SYSIN DD * to include the control statements in-stream.