Parameters for CM batch interface

The Change Management (CM) batch interface includes a list of parameters that enable you to control various aspects of managing changes, including what action the CM batch interface performs when called.

These parameters enable you to customize various aspects of managing a change, such as:

Prefixes for data sets that are dynamically created by the CM batch interface
The name of the PDS to store work statement list (WSL) files
The name of the PDS to store JCL run jobs for running changes
The default "change owner" name to use when creating a new change
The default "change name" to use when creating a new change
Analyze reporting options
Admin templates
Utility options
Requirement: To specify values for utility options, you must set the USE_UTILITY_OPTIONS parameter to Y. Otherwise, default values are used.

For a full list of CM batch interface parameters, see CM batch parameter definitions.

Action parameters

You can use the following parameters to control what action the CM batch interface performs.

Table 1. Action parameters for CM batch interface
Action	Parameter name
Run compare	ACTION_COMPARE
Analyze a change	ACTION_ANALYZE_CHANGE
Build a run job	ACTION_BUILD_RUN_JOB
Generate DDL	ACTION_GENERATE_DDL_FROM_BASE_VERSION
Generate a base version	ACTION_GENERATE_BASE_VERSION
Generate JCL from a WSL	ACTION_GENERATE_JCL_FROM_WSL
Generate a WSL	ACTION_GENERATE_WSL
Run a WSL	ACTION_RUN_WSL
Import a change	ACTION_IMPORT_CHANGE
Export changes into a delta change file	ACTION_EXPORT_CHANGE
Import an ignore	ACTION_IMPORT_IGNORE
Import a mask	ACTION_IMPORT_MASK
Delete a mask	ACTION_DELETE_MASK
Run a change	ACTION_RUN_CHANGE
Cancel a change	ACTION_CANCEL_CHANGE
Delete a change	ACTION_DELETE_CHANGE
Recover a change	ACTION_RECOVER_CHANGE
Convert a WSL to ISPF table format	ACTION_CONVERT_TO_ISPF_WSL
Convert a WSL to a readable data set	ACTION_CONVERT_TO_READ_WSL

Parameter syntax

Use the following syntax rules when specifying CM batch parameters:

Use of quotation marks: Enclose the value of the parameter in single quotation marks, as follows:
```
parameter_name = 'parameter_value'
```
When specifying the fully qualified PDS name, enclose the PDS name in double quotation marks within single quotation marks. For example, when the WSL PDS is named HLQ.BATCH.WSL specify the following:
```
PDS_FOR_WSL='''HLQ.BATCH.WSL'''
```
Use of uppercase and lowercase: Most parameter values are not case sensitive. However, the following parameter values are case sensitive:
- symbol parameters
- parameters related to data set names
- parameters related to an object owner, name, or comment
Defining a user symbol: When defining a user specified symbol by using the symbol_name and symbol_value parameters, the symbol name must begin with an ampersand (&) and end with a period (.). A semi-colon must be specified immediately after the symbol value, as follows:
```
symbol_name = '&TASK#.' symbol_value = 'ABC';
```
Specifying a fully qualified data set name: When specifying a fully qualified data set name, you can either use two single quotation marks to represent one single quotation mark, or wrap the parameter value in double quotation marks.
For example, the following specification results in a WSL data set name of WALDO1.WALDO2.WSL:
```
prefix_for_data_sets = 'WALDO1'
pds_for_wsl = 'WALDO2.WSL'
```
If you want the WSL data set name to be WALDO2.WSL, specify one of the following:
- ```
prefix_for_data_sets = 'WALDO2'
pds_for_wsl = 'WSL'
```
- ```
prefix_for_data_sets = 'WALDO1'
pds_for_wsl = '''WALDO2.WSL'''
```

Db2 Admin Tool data set templates

You can use Db2 Admin Tool data set templates to override the default values for some data sets that are used to process a change.

To do so, use the admin_dataset_type parameter to specify the type of data set whose attributes you want to overwrite. For a list of possible data set types that you can specify, see ADMIN_DATASET_TYPE.

After the admin_dataset_type parameter, specify one or more of the following data set template parameters to override certain data set attributes:

admin_dataset_bufno
admin_dataset_dataclas
admin_dataset_device_unit
admin_dataset_dir
admin_dataset_dsn
admin_dataset_dsntype
admin_dataset_expdt
aadmin_dataset_maxvol
admin_dataset_mgmtclas
admin_dataset_retpd
admin_dataset_space_priqty
admin_dataset_space_secqty
admin_dataset_space_type
admin_dataset_storclas
admin_dataset_type
admin_dataset_volume

End the group of parameters (admin_dataset_type and the other data set template parameters) with a semicolon ( ; ), as shown in the following example:

admin_dataset_type = 'CHG'
admin_dataset_dsn = 'CHG.T&TIME.'
admin_dataset_space_priqty = '20';

You can specify multiple groups of these parameters. Each group is separated by a semicolon.