Step 2. Modify Symbolic Parameters in JCL Procedures

Configuring Your Product › Activate the CA Disk System › CA Disk Parameter Library (PARMLIB) › Step 2. Modify Symbolic Parameters in JCL Procedures

Step 2. Modify Symbolic Parameters in JCL Procedures

Modify each JCL procedure manually using ISPF edit or any other editor. Two utilities are provided in the Installation library that lets you edit globally the JCL procedures. The following utilities and macros are available:

PROCUNLD

To unload the procedures into a sequential file in IEBUPDTE format, use PROCUNLD against your procedure library. To modify and change the procedures, use ISPF edit or another editor. For example, to change the first and second-level qualifiers of your CA Disk target libraries, you can use the following ISPF edit command:

CHANGE CA.DISK TO SYS2.CA.DISK ALL

You can also use the PROCLIB Customization Wizard – the CUSTPROC Edit Macro which helps you customize the unloaded Proclib.

PROCRELD

To reload the tailored procedures in your target procedure library, use PROCRELD against your procedure library.

CUSTPROC

To make a mass change of the sequential file the PROCUNLD utility produces, use CUSTPROC. CUSTPROC, also named the CA Disk PROCLIB Customization Wizard, is in the DMSCLIB library that SMP/E loaded. To use the CLIST as an Edit Macro, include it in a library in your SYSPROC concatenation. If you load the CLIST before installing the DMSCLIB data set, copy CUSTPROC into the //SYSPROC concatenation. The Wizard also requires the use of several panels in the CA Disk Panel Library. You can include the library in your default Panel library concatenation. You can also supply it when the Wizard requests the library name.

To invoke the Wizard, enter CUSTPROC in the command line of an active edit session of the procedures that PROCUNLD unloads. The Wizard displays an ISPF panel. Type values in the fields to replace the current values for the following fields:

Symbolic parameters Q=, P=, S=, W=
Default steplibs and Parmlibs
CA Datacom/AD Library names and the symbolic parameters DCUS=, DCAI=
The names are used as the prefixes to the Datacom CUSLIB and CAILIB data sets.
Whether you want the Datacom libraries included as part of the standard STEPLIB concatenation.
Enter the names of FILES data sets, or databases, that you want to use as your MFILES concatenation.
The data sets are added automatically to the appropriate procedures. To access fields that are not displayed on the screen, vertically scroll the panel.

Rules for PROCLIB Customization Wizard

Observe the following about the PROCLIB Customization Wizard:

PROCLIB members that are not part of the standard CA Disk installation will be excluded (from the ISPF EDIT Exclude command) and will not be updated. At the end of the customization they will still be excluded but the Wizard doesn’t delete them.
The ISPF panel that contains the parameters specifications is larger than a full screen and it may be necessary to scroll down to enter all of the necessary values.
Within the updated procedures where steps execute programs that are neither CA Disk programs nor Datacom programs (such as SORT, for example), neither the STEPLIB nor the PARMLIB data set concatenations will be changed. Thus if SORT requires a STEPLIB the STEPLIB in the SORT step will be unchanged.
ALL of the supported symbolic parameters in the procedures will be changed to the same value – the value that you enter on the parameter panel – regardless of the value that is currently in the procedures. If you want some procedures to have a different value for W=, for example, it is necessary to perform additional customization on those procedures after you have run the customization Wizard.
CUSLIB and CAILIB have the default values &DCUS..CUSLIB and &DCAI..CAILIB. It may cause JCL errors in some procedures if you change the value of the names so that they do not include the &DCUS and &DCAI symbolic parameters and requires you to manually modify any procedures that use &DCUS or &DCAI to remove the symbolic parameter.
The option to include the Datacom libraries should be selected only after CA Datacom/AD has been installed and customized for CA Disk. You will receive JCL errors using the customized procedures if the libraries do not exist at the time the job is run. If you have not yet installed Datacom, or if you plan to NOT use Datacom databases as FILES, the option should be unselected. The Customization Wizard can be rerun in the future against the already customized procedures if your needs change in the future. Any procedures that had additional manual customization to change any of the supported parameters to different values may require that customization to be redone.
The names entered into the STEPLIB Library Names should only be CA Disk library names. Specifically the Datacom library names should not be entered in here.
The STEPLIBS for programs that are supported will be updated based on which libraries they need. Most of the Datacom programs require only the Datacom libraries. Some of the CA Disk programs do not need the Datacom libraries because they do not reference the FILES datasets so the STEPLIB will only contain CA Disk libraries.
The names entered into the PARMLIB Library Names should be the customized library names to be used in the procedures.
The names in the MFILES Data Set Names should be the names of the FILES data sets that you want to be searched, and in the order that you want them searched, for procedures that support MFILES.
If the MFILES data set concatenation is in the supported procedures it is replaced with the data sets you have specified, or removed if you have not specified any FILES data set names. If the MFILES data set concatenation is not defined in the supported procedures and the MFILES data set names are specified, the MFILES concatenation is inserted immediately after the last data set in the step.

Type CANCEL in the command field and press the Enter key if you decide that you do not want to proceed with the customization at this time. If you press the END key, you will be prompted to confirm you are leaving the dialog.

Once you have filled in the fields with the values you desire, type GO and press the Enter key. That will start scanning the procedures and make the requested changes. The following is a sample illustration of a filled in panel.

SETUP ------------------ PROCLIB Customization Wizard -------------- CA Disk --

Command ===>

Enter GO to start processing or CANCEL to exit without making changes.

More: +

PROC Parameters:

Q= . . . . . CAI.DISK

P= . . . . . CAI.DISK.CCUWJCL

DCUS= . . . CAI.DISK.ADRRSPNN

DCAI= . . . CAI.DISK.ADRRSPNN

       S= . . . . . *                 W= . . . . . SYSDA

CA Datacom/AD Library Names:

CUSLIB . . . &DCUS..CUSLIB

CAILIB . . . &DCAI..CAILIB

Enter "/" to select option

/ Include CA Datacom/AD Libraries in STEPLIB Concatenation

STEPLIB Library Names:

. . . &Q..LOADLIB

. . .

PARMLIB Library Names:

. . . &Q..CCTUPARM

. . .

MFILES Data Set Names:

. . . &Q..FILES1

. . . &Q..FILES2

. . . &Q..FILES3

. . .