Expanding Control-M Files

The following Control‑M files can be expanded using the Installation and Customization Engine (ICE):

Resources file (RES)
Jobs Dependency Network file (GRF)
Statistics file (STAT)
Dual Active Jobs file
History Jobs file (HST)
Journaling file
Journaling conditions file
Active Jobs file (AJF) (For the procedure, see the Control-M file customization section in the INCONTROL for z/OS Installation Guide: Customizing.)

Perform the following steps to expand Control‑M files:

Close all monitors and IOA activities. For example, to shut down the Control‑M monitor, issue operator command P CONTROLM.
Rename the old file (that you want to expand).
Using ICE, select Customization. Enter CTM in the Product field, select Product Customization, and then select major step 2, "Customize CONTROL-M Dataset Parameters." Perform the minor steps in order for each file you want to expand.
Perform minor step 1, "Customization Instructions," which provides an overview of the process.

Perform minor step 2, "Control‑M Dataset Parameters," which lets you specify values for ICE to use to calculate the appropriate file size. During this step, specify a question mark (?) in any parameter field for help.

Modify only the parameters relevant for the files you want to expand. The following parameters can be changed using this step:

Table 91 Parameters for Expanding Various Control-M File

Parameter	Description	Relevant Files
AJFSIZE	Number of records in Active Jobs File Located: Major Step 1 "CTMPARM Post-Installation"; Minor Step 2 "CKP Parameters"	Active Jobs file, Dual Active Jobs file, and AJF for Journaling
AJFTYPE	Type of AJF file (BASIC, LARGE, or EXTENDED)	Active Jobs file, Dual Active Jobs file, and AJF for Journaling
CNDREC#	Number of records in the Journaling Conditions file Note: This is the same parameter that controls the number of records in the IOA Conditions file.	Condition file for Journaling
CNDREC#		Condition file for Journaling
RESBQNT#	Max # of different resources defined	Resources file
RESQNT#	# of records for QUANTITIVE resources	Resources file
RESCNTL#	# of records for Control resources	Resources file
HSTSIZE	Number of records in History AJF	History Jobs file
HSTTYPE	Type of HST file (BASIC, LARGE, or EXTENDED)	History Jobs file
JNLPSIZ	Primary space (cyl) for journaling file	Journaling file
JNLSSIZ	Second. space (cyl) for journaling file	Journaling file
GRFSIZE	Space (cyl) for GRF file	Jobs Dependency Network file
STTPSIZ	Primary space (cyl) for Statistics file	Statistics file
STTSSIZ	Secondary pace (cyl) for Statistics file	Statistics file

Perform minor step 3, "Save Parameters into Product Libraries," to save the parameter values that you specified in minor step 2.

Minor steps 4 through 10 are jobs that perform the expansion. Perform only those steps relevant to the files you want to expand.

Table 92 Jobs for Expanding Various Control-M Files

Job	Files	Job Description
FORMCKP in the Control‑M INSTALL library	Active Jobs file and Dual Active Jobs file	This job allocates and formats a new Active Jobs file (AJF) with the new size. If the journaling feature is being utilized, you must also expand the AJF for Journaling file.
FORMGRF in the Control‑M INSTALL library	Jobs Dependency Network file	This job allocates and formats a new Jobs Dependency Network (GRF) file with the new size.
FORMHST in the Control‑M INSTALL library	History Jobs file	This job allocates and formats a new History Jobs file (HST) with the new size.
FORMJAJF in the Control‑M INSTALL library	AJF for Journaling file	This job allocates and formats a new AJF for Journaling file with the new size.
FORMJCND in the Control‑M INSTALL library	Conditions file for Journaling	This job allocates and formats a new Conditions file for Journaling with the new size.
FORMJRES in the Control-M INSTALL library	Resources file for Journaling	This job allocates and formats a new Resource file for Journaling with the new size.
FORMJRNL in the Control‑M INSTALL library	Journaling file	This job allocates and formats a new journaling file with the new size.
FORMRES in the Control‑M INSTALL library	Resources file	This job allocates and formats a new Resources file (RES) with the new size.
FORMSTT in the Control‑M INSTALL library	Statistics file	This job allocates and formats a new Statistics (STAT) file with the new size. If it is anticipated that the Statistics file will grow to be very large (over 4G bytes) then the STATFILE should be defined with Extended Addressability capability. Extended format data sets are system-managed and the mechanism for requesting extended format is through the SMS data class DSNTYPE=EXT parameter and subparameters R (required) or P (preferred). The storage administrator can specify R to ensure the data set is extended. The storage administrator must also set the extended addressability attribute to Y to request extended addressability. See the IBM DFSMS: Using Data Sets manual for further details. After allocation, check the LISTCAT output for the Extended addressability indicator, EXT-ADDR, in the Attributes group to ensure that extended addressability is in affect.

Copy the old files into the new ones according to the instructions below:

Table 93 Copy Methods for Expanding Various Control-M Files

Files	Copy Method
Active Jobs file, Dual Active Jobs file, and AJF for Journaling file	Copy using utility CTMCAJF. For information about the CTMCAJF utility, see the INCONTROL for z/OS Utilities Guide.
Resources file	Copy using utility CTMCRES. For information about the CTMCRES utility, see the INCONTROL for z/OS Utilities Guide.
History Jobs file	Copy using utility CTMHCOP. For information about the CTMHCOP utility, see the INCONTROL for z/OS Utilities Guide.
Journaling file	Copy the old journaling file into the new file using a standard IBM copying utility.
Conditions file for Journaling	Copy using the IOACCND utility. For information about the IOACCND utility, see the INCONTROL for z/OS Utilities Guide.
Resources file for Journaling	Copy using the IOACRES utility. For information about the CTMCRES utility, see the INCONTROL for z/OS Utilities Guide.
Statistics file	Copy the old STAT file into the new file using IDCAMS REPRO.

Start the monitors by issuing the following operator command:

S CONTROLM

Parent Topic

Basic Administrative Functions