Setting default CM batch parameter values by using profiles

You can establish and maintain your own default values for CM batch parameters. Individual invocations of CM batch can override these default values as needed.

About this task

When the Change Management (CM) batch interface is invoked, it reads parameters from the following two files in sequence: PROFPARM DD and then PARMS DD. PROFPARM DD contains the installation default values, and PARMS DD contains the individual invocation overrides. If you do not specify any defaults, the product default values are used.

Procedure

To set the default CM batch parameter values by using profiles:
  • Define the PROFPARM DD in the JCL procedure.
    This parameter profile definition enables a JCL procedure parameter (for example, the SSID or the user-customized JCL procedure parameter) to dynamically determine which data set or data sets to associate with the parameter file in the JCL procedure (PROFPARM DD) .
  • Define the PARMS DD when invoking the JCL procedure.
    Any parameter specified in the PARMS DD file overrides the parameter values in the PROFPARM DD file.

Examples:

The following JCL procedure defines the PROFPARM file and uses the Db2® SSID to determine which parameter profile to use:

//GOCCM   PROC SSID=,PLAN=,SPCUNIT=SYSDA
//PROFPARM  DD DISP=SHR,DSN=USERID.SSID.PARMS(&SSID)
...
//GOCCM   PEND
When the CM batch interface is invoked, the SSID parameter value determines the member name in USERID.SSID.PARMS to use. For example, the following job invokes the JCL procedure:
//DEMO     JOB (&SYSUID,ICE,ICE,ICE),'DEMO',CLASS=B,
//   MSGCLASS=H,MSGLEVEL=(1,1),NOTIFY=&SYSUID,TIME=(,30),
//   REGION=0M
//*
/*JOBPARM S=SY4A
//*
//LSCLIBS JCLLIB ORDER=JCL.PROCLIB
//*
//GOCCM    EXEC GOCCM,SSID=DSNA,PLAN=ADB
//GOCCM.PARMS  DD *
/*
//GOCCM.IMCHG001 DD DISP=SHR,DSN=<DDL OR DELTA CHANGE FILE>
The value of the SSID parameter is DSNA. Therefore, the data set name for the PROFPARM DD in the JCL procedure resolves to the following definition:
//PROFPARM  DD DISP=SHR,DSN=USERID.SSID.PARMS(DSNA)

Any parameter specified in the PARMS DD file overrides the parameter values in the PROFPARM DD file.

You can also define a user-customized JCL procedure parameter that determines an additional profile to use. For example:

//GOCCM   PROC SSID=,PLAN=,SPCUNIT=SYSDA,PROF=EMPTY
//PROFPARM  DD DISP=SHR,DSN=USERID.SSID.PARMS(&SSID)
//          DD DISP=SHR,DSN=USERID.PROF.PARMS(&PROF)
...
//GOCCM   PEND
When the CM batch interface is invoked, the SSID parameter value determines the member name in USERID.SSID.PARMS to use. The PROF parameter value determines the member name in USERID.PROF.PARMS to use. For example, the following job invokes the JCL procedure:
//DEMO     JOB (&SYSUID,ICE,ICE,ICE),'DEMO',CLASS=B,
//   MSGCLASS=H,MSGLEVEL=(1,1),NOTIFY=&SYSUID,TIME=(,30),
//   REGION=0M
//*
/*JOBPARM S=SY4A
//*
//LSCLIBS JCLLIB ORDER=JCL.PROCLIB
//*
//GOCCM    EXEC GOCCM,SSID=DSNA,PLAN=ADB,PROF=LARGE
//GOCCM.PARMS  DD *
/*
//GOCCM.IMCHG001 DD DISP=SHR,DSN=<DDL OR DELTA CHANGE FILE>

The SSID JCL parameter value is DSNA, and the user-defined JCL parameter PROF is LARGE. Therefore, the data set names for the PROFPARM DD in the JCL procedure resolve to the following definition:

//PROFPARM  DD DISP=SHR,DSN=USERID.SSID.PARMS(DSNA)
//          DD DISP=SHR,DSN=USERID.PROF.PARMS(LARGE)

Any parameter specified in the PARMS DD file overrides what is specified in the PROFPARM DD.

Change Management reads the parameters in the following order:
  1. USERID.SSID.PARMS(DSNA)
  2. USERID.PROF.PARMS(LARGE)
  3. The PARMS file
The value that CM uses for a parameter is the last one read.