Defining DBRC utility data sets

Use the DBRC Utility Data Sets panel to define, for an HPCA-ID, the data set names that are required by the DBRC utility program.

If the DBRC data sets for the selected HPCA-ID have not been defined in the HPCA-ID/IMS Profile panel, you are prompted to define them.

You can also display the DBRC Utility Data Sets panel by entering the line command T on the HPCA-ID/IMS Profile panel.

For example:

Figure 1. DBRC Utility Data Sets panel

  SETUP               HPCA DBRC Utility Data Sets                  
COMMAND ===> ___________________________________________________
                                                                               
Enter END (PF3) to exit. Enter CAN to exit without processing.                 
                                                                               
HPCA-ID: Q91A                                                                  
                                                                               
DBRC Utility RESLIB DSname. . : 'DBGTOOL.QA.Q91A.RESLIB'                       
                          . . :_________________________________ 
(Leave blank if in LINKLIB)                                                    
                                                                               
DBRC Skeletal Library DSname. : 'DBGTOOL.QA.JCLPDS'                            
                                                                               
Dynamic allocation of RECON Data Sets: N    (Y=yes, N=no)                      
DFSMDA Library DSname . . . . :_________________________________ 
                                                                               
                                                                               
For allocation of RECON Data Sets through JCL:                                 
RECON1 Data Set DSname. . . . : 'DBGTOOL.QA.Q91A.RECON1' 
RECON2 Data Set DSname. . . . : ‘DBGTOOL.QA.Q91A.RECON2' 
RECON3 Data Set DSname. . . . : 'DBGTOOL.QA.Q91A.RECON3'

To cancel the process and the data entries made on this panel, enter the CAN/CANCEL command. The previous ISPF panel is displayed.

To continue processing with the selected HPCA ID enter the END command (typically, PF3).

The CA Group Selection panel displays with a table of CAGROUPs that have been defined in the RECON data sets.

Field descriptions for DBRC Utility Data Sets panel

HPCA-ID: Shows the current IMS HP Change Accumulation Utility ID selected.
DBRC Utility RESLIB dsname: Specify the dsname of the library that contains the DBRC utility program DSPURX00. This library is normally the same as the IMS RESLIB. This field can be left blank to indicate that the dsname is in the LINKLST. If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname.
One additional load library is optionally provided for concatenation to the IMS RESLIB. This second library can be used for locating IMS local exit modules that are not in the same library as the DBRC utility (DSURX00).
DBRC Skeletal Library dsname: Specify the dsname of the library that contains the skeletal JCL members for the DBRC utility program. If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname. This entry is required.
Dynamic allocation option of RECON data sets: Specify whether (Y) or not (N) the RECON data sets are dynamically allocated. If the RECON data sets are to be dynamically allocated, the DFSMDA members for RECON1 and RECON2, must have been created and placed in a data set. Typically, this data set is the same data set that contains the DSPURX00 program. If not, then you must specify the name of the data set that contains the DFSMDA modules.
DFSMDA Library dsname: Specify the dsname of the library that contains the dynamic allocation modules for the RECON data sets defined through the IMS macro DFSMDA. This name is required only if the Dynamic Allocation option is Y and the dynamic allocation modules are not in the DBRC utility program load library.
If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname.
RECON1 Data Set dsname: Specify the dsname of the RECON1 data set. If the Dynamic Allocation option is N, enter the dsname of the RECON1 data set. If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname.
RECON2 Data Set dsname: Specify the dsname of the RECON2 data set. If the Dynamic Allocation option is N, enter the dsname of the RECON2 data set. If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname.
If the Dynamic Allocation option is N, both RECON1 and RECON2 dsnames are required.
RECON3 Data Set dsname: Specify the dsname of the RECON3 data set. This entry is optional. If the Dynamic Allocation option is N, enter the dsname of the RECON3 data set. If the dsname is fully qualified, it must be entered in single quotes. If the name is not enclosed in single quotes, the TSO user ID is prefixed to the entered dsname.