RCFBBO JCL requirements
RCF
appends the JCL statements (shown in the following figure) after the last statement read from the RCFBBO member.
// SOUT=b,IMSID=cccccccc,
// RCF2PRM='ddddddddddddddddddddddddd'
//IMSLOGR DD DISP=SHR,DSN=...........
//IMSLOGR0 DD DISP=SHR,DSN=...........
. . .
. . .
//IMSLOGR9 DD DISP=SHR,DSN=...........
//SYSIN DD *
COLDSTART
//
The following table describes the parameters used in the append JCL for RCFBBO:
Parameter | Description |
|---|---|
PSB | specifies the PSB name identified by TSSAFR1 as requiring Batch Backout processing |
BBODYTM | is the string Dyyddd.Thhmm, where yyddd is the current system date in Julian format and hhmm is the current time in 24-hour format |
SOUT | specifies the SOUT parameter from the PARM data of RCF job step |
IMSID | specifies the IMSID parameter from the PARM data of RCF job step In an IMS/VS-XRF environment, the value used will be the RSENAME data found by RCF in the appropriate DFSHSBxx member of the IMS system PROCLIB data set. |
RCF2PRM | specifies the address of the pseudo-ECB for TSSRCF2 to signal TSSRCF1 at completion of the Backout processing, the IMS Subsys ID, the job type B (for Backout) and the PSB name being processed |
IMSLOGRx DD statements are provided for up to the last ten log data sets used during previous session of the IMS/VS system. The parameters BBOLOGP and BBOLOGS in the procedure are set by the user to provide the first part of the data set name for the primary and secondary output logs, respectively. These values must not exceed 22 characters to avoid JCL errors (for example, data set names longer than the MVS maximum of 44 characters).
If a cold start is being performed, the SYSIN control statement COLDSTART is added to the JCL.
The procedure shown logs the Batch Backout changes to data sets with data set names composed of the values of the BBOLOGP and BBOLOGS parameters suffixed by the PSB name and BBODYTM values. These logs must be retained so they can be included in any subsequent recoveries of the databases involved in the backout. For example, if:
- The BBOLOGP value is IMSVS.RCF.
- The PSBs DDAPSB, LONPSB and SAVPSB require Batch Backout processing.
- The current date is 86.210 (29 July, 1986).
- The time is 4:00 PM.
Then, the primary log data set names will be:
IMSVS.RCF.LONPSB.D86210.T1600
IMSVS.RCF.SAVPSB.D86210.T1600
Note the following items about the JCL:
- A job statement must be provided according to user-installation standards.
- IMS/VS at Releases 2.1 and later supports dynamic allocation of databases for Batch Backout.
- The parameters other than the data set names on the IEFRDER and IEFRDER2 DD statements should be changed to conform to the installation standards, as desired.
The IEFRDER2 DD statement and BBOLOGS symbolic parameter should be omitted if the user installation does not do dual logging.
- The DFSVSAMP DD statement must be set to reference the desired IMS/VS VSAM Buffer Pool member in the IMS/VS PROCLIB data set. If you are using the Coupling Facility in a Sysplex environment, this DD statement might be required. Specify the CFNAMES control statement and appropriate parameters. Refer to the IBM IMS System Definition Reference, for the explanation of the CFNAMES control statement.
- All IMSVS. xxxxxxxx data set name must be set to specify the correct data sets for the IMS/VS system being supported by RCF.
- The STEPLIB statement in Step TSSRCF2 must specify the APF-authorized load library containing RCF programs.
- Refer to the IBM IMS/VS Utilities Reference manual and the IMS/VS System Programming Reference manual for further information on the requirements for Batch Backout and the DBBBATCH procedure.
Related topic