Managing Changes by using the CM batch interface

The Change Management (CM) batch interface is a JCL procedure that you can use to create, customize, and reuse batch jobs when managing changes in Db2® Admin Tool Change Management. You can import, analyze, run, and recover changes by submitting batch jobs without using the Change Management ISPF panels.

Before you begin

Before invoking the CM batch interface, take the following actions:

Before you can run any Db2 for z/OS® online utilities in CM batch, you must have one of the following Db2 stored procedures set up and available:
- DSNUTILV (for Db2 12 for z/OS or later )
- DSNUTILU (for prior versions of Db2 for z/OS)
By default, CM batch uses these stored procedures to run utilities. You can change that behavior by using the CM batch parameter use_dsnutil_sp.
Optionally configure the CM batch interface by taking one or more of the following actions:
- Defining your own JCL symbols as parameters to the CM batch interface
- Customizing the Change Management (CM) batch interface JCL procedure name

About this task

The CM batch interface can be used to manage a change that was created with the Db2 Admin Tool panels. Likewise, a change that was imported using the CM batch interface can be managed using Db2 Admin Tool panels.

Specifically, the following Change Management functions are supported by the CM batch interface:

Run compare (invokes IBM® Db2 Object Comparison Tool for z/OS to generate a delta change file that can be managed by Db2 Admin Tool Change Management)
Import a mask
Import an ignore
Import a change (equivalent to using register change in the Db2 Admin Tool panels), including importing one or more DDL or delta change files into a single change
Analyze a change (using the automatic base version method)
Analyze a multi-target change
Build a run job
Run a change
Recover a change

Restriction: The following Change Management functions are not supported in the CM batch interface:

Report changes
Import a version file
Import a version scope
Analyze a change (using the user-defined or existing base version method)

Procedure

To perform CM functions by using the CM batch interface:

Invoke the JCL procedure to enable the CM batch interface.
The default CM batch interface JCL procedure name is GOCCM.
Example:
```
//CMBATCH  EXEC GOCCM,SSID=DSNA,PLAN=ADB
```
You can use the same JCL procedure for single or multiple Db2 subsystems.
Call any of the supported CM functions. More than one of these functions can be performed in a single call to the CM batch interface, except for the "recover change" function, which cannot be performed with any other action.
Specify CM batch interface parameters as needed.
For more information about parameters, including syntax, see Parameters for CM batch interface. For a complete list of parameters, see CM batch parameter definitions.
If you use the CM batch interface to import a DDL file, the first line of the DDL file must be a simple SQL comment. A simple SQL comment starts with two dash symbols (--). Otherwise, import change errors might occur.

Example

For examples of invoking the CM batch interface, see Examples: Invoking the Change Management (CM) batch interface for various actions.