Overview of INCONTROL Utilities

The following sections provide short descriptions of each utility used in the INCONTROL environment. Unless otherwise noted, all utilities are fully described later in this guide.

Some utilities prefixed by IOA replace corresponding utilities prefixed by CTM, CTD, and/or CTB in previous versions. In such cases, the old utilities are supported for your convenience; however, you should use the IOA utilities.

This chapter includes the following topics:

IOA Utilities

Control-M Utilities

Control-M/Analyzer Utilities

Control-M/JCL Verify Utilities

Control-D and Control-V Utilities

Control-O Utilities

Control-M/Tape Utilities

IOA Utilities

Table 1 IOA Utilities

Utility

Description

IOABLCAL

Builds calendars.

IOACABPR

Forces a disconnect of the CAB control block, a cross-product control block used to anchor information.

IOACCDSL

Lists of all data sets of a specified IOA environment, for cloning or backing up an IOA environment.

IOACCND

Copies or resizes the IOA Conditions file.

IOACCRNM

Adjusts a cloned IOA environment to new parameter values.

IOACLB

Produces XML Calendar Files.

IOACLCND

Cleans the IOA Conditions file.

IOACLVL

Compares levels

IOACMPP

Compares IOA Parameter Files at Different Installations

IOACND

Performs IOA Conditions file or Control-M Resources file adjustments.

IOACPLOG

Copies contents of the IOA Log file to a sequential file or to another Log file.

IOADBF

Allocates and formats an IOA Access Method file’s data and index components.

IOADBIB

Rebuilds index files for various IOA Variable Database data files.

IOADBSR

Sorts the records in an IOA Access Method file’s data component in the same logical order as the records in the associated IOA Access Method file’s index component.

IOADCPY

Recovers an IOA Access Method file from the dual mirror image copy and vice versa.

IOADIG

Verifies the integrity of an IOA Access Method file’s data component structure, and optionally corrects detected errors.

IOADII

Verifies the integrity of an IOA Access Method file’s index component structure.

IOADLD

Loads an IOA Access Method file’s contents from a sequential file previously created by the IOADUL utility.

IOADPT

Prints IOA Access Method file data and index records in SNAP dump format.

IOADUL

Unloads an IOA Access Method file’s data component’s record contents to a sequential file.

IOAFRLOG

Allocates and Formats the IOA Log File

IOAFRNRS

Allocates and Formats the IOA Manual Conditions File

IOAGLV

Manages IOA Global Variables.

IOALDNRS

Creates or loads the IOA Manual Conditions list.

IOALOGI

Builds and rebuilds the Index file for the IOA Log file

IOALOGXC

Activates or deactivates use of the IOA LOG Index file

IOALOGXP

Prints the IOA Log Index file

IOANOTE

Writes a message to the IOA Log file.

IOAOPR

Issues operator commands.

IOAPFSTC

Prints performance statistics reports.

IOAPSCK

Checks password validation for INCONTROL products

IOASDISC

Provides a means to disconnect the IOA subsystem in an emergency.

IOATEST

Simulates various events in the IOA environment.

IOAVCND

For VM/CMS environments. Sets prerequisite conditions in a Control-M monitor running on an NJE-connected MVS machine.

IOAVERFY

Verifies file installation, locates errors, optionally implements corrections and produces status reports for various IOA files.

Control-M Utilities

Table 2 Control-M Utilities

Utility

Description

CTMAESIM

Tests the syntax of AutoEdit control statements.

CTMAPI

Enables application programs to interface with Control-M.

CTMBTBL

Converts tables to SMART Tables.

CTMBLDAE

Builds AutoEdit symbols members using IOA calendars as input.

CTMBLT

Builds Control-M tables.

CTMCAJF

Compresses, cleans or changes the size of the Control-M Active Jobs file.

CTMCRES

Converts the old Condition/Resources file to the current Control-M Resources file.

CTMDSR

Detects SYSOUT actions with an indeterminate end status due to abnormal termination of the Control-M monitor when Control-M runs in multi-SPY mode.

CTMDSRN

Executes scripts on distributed system platforms and saves the results in a file on the mainframe.

CTMEVRT

Retrieves lost DSNEVENTs from SMF.

CTMEVEX

Executes the actions of DSNEVENTs retrieved from SMF.

CTMHCLN

Performs special maintenance functions on the History Jobs file.

CTMHCOP

Copies the History Jobs file to a new History Jobs file.

CTMJNM

Prints the daily job counts.

CTMJOB

Orders jobs into the Active Jobs file.

CTMJSA

Accumulates job statistical data in the Control-M Job Statistics file.

CTMMAJF

Merges Active Job files.

CTMMHST

Merges Jobs History files.

CTMRAFL

Provides job flow information about the jobs in the Active Jobs file.

CTMRCAL

Creates calendars for each job defined in the Control-M showing the actual execution dates of the job.

CTMRELRS

Releases resources from a job step.

CTMRES

Allocates and formats the Control-M Resources file.

CTMRFLW

Provides report of job flow information about jobs in tables.

CTMRNSC

Provides a summary report of each job that has executed within specified time range.

CTMROGR

Provides graph of job workloads for planning or adjustment.

CTMRPFL

Provides job flow information report for jobs in a table.

CTMRPLN

Provides a list of all jobs that are planned for a specified range of dates.

CTMRSTR

Restores the Active Jobs file.

CTMSIM

Activates the Simulation and Forecasting facility, described in the simulating forecasting facility chapter of the Control-M for z/OS User Guide.

CTMSLC

Facilitates the removal of old job scheduling definitions from the schedule library.

CTMTAPUL

Produces a Tape Pull list, described in the simulating forecasting facility chapter of the Control-M for z/OS User Guide.

CTMTBUPD

Updates Control-M table or job scheduling definition parameters in batch mode.

CTMTLB

Produces XML and CTMBLT Utility Files.

CTMWLI

Enables you to initialize and copy the Workload Optimization Load-Index file (WLI file).

CTMXRF

Produces a variety of cross reference reports.

CTMRJDS

Provides a cross reference report, by data set, of jobs that access the data set.

Applicable to Control-M/Restart.

FORMCKP

Allocates, formats, and resizes a Control-M Active Jobs file.

FORMHST

Allocates and formats the Control-M History Jobs file.

FORMRES

Allocates and formats the Control-M Resources file.

Control-M/Analyzer Utilities

Table 3 Control-M/Analyzer Database, Table and Variable File Handling Utilities

Utility

Description

CTBDBCP

Copies the contents of a specified source file to a specified target file. All relevant aspects of the file are copied, including (pointers to) variable definitions, variable generations, and table information.

CTBDBVCP

Copies a specified variable or table of variables to another set of variable or table files.

CTBDBVDL

Deletes a variable or a table of variables from variable or table files.

CTBDBVIG

Checks the integrity of variable or table data files.

CTBDBVCG

Changes the number of generations of a Database variable.

Table 4 Control-M/Analyzer Report and Rule Activity File Handling Utilities

Utility

Description

CTBJAFCP

Copies invocation and report entries to other Rule Activity and Report files.

CTBJAFDL

Deletes unnecessary entries from the Rule Activity and Report files.

CTBJAFIG

Checks the integrity of Rule Activity and Report data files.

Table 5 Control-M/Analyzer Active Balancing File Utilities

Utility

Description

CTBABI

Initializes the Active Balancing file after creation.

CTBFRM

Compresses the Active Balancing file (usually on a daily basis as part of the New Day procedure).

Table 6 IOA Access Method File Utilities

Utility

Description

CTBDBIB

Rebuilds the indexes of specified Control-M/Analyzer data files.

CTBDBST

Replaced by the IOADPT utility, described in Table 15 in Table 15 Scheduling Calendars.

For more information about IOA Access Method utilities (IOADBF, IOADCPY, IOADIG, IOADII, and IOADPT), see IOA Utilities .

Table 7 Miscellaneous Utilities

Utility

Description

CTBCMP

Checks syntax of rule definitions.

CTBVXRF

Produces a report that cross-references Control-M/Analyzer Database variables and the rules by which they are created and accessed.

Control-M/JCL Verify Utilities

Table 7a Control-M/JCL Verify Utilities

Utility

Description

CTJENR

Performs reformatting and enforcement of JCL jobs.

CTJMRFLW

Validates JCL job work flows through the verification of the job order and dependencies.

CTJPLAN

Verifies JCL jobs that are scheduled for submission.

CTJVER

Verifies JCL jobs before submission.

Control-D and Control-V Utilities

Table 8 Control-D and Control-V Utilities

Utility

Description

BKPRESET

Resets the Backup Mission Status.

CTDAMUTI

Copies, moves and deletes CDAM files, described in CDAM Maintenance Utility CTDAMUTI in the CDAM chapter of the Control-D and Control-V User Guide.

CTDAPRV

Analyzes and updates reports approval status.

CTDAUTR

Creates a list of recipients and reports authorized for a specific User ID.

CTDBLXRP

Deletes and rebuilds all print control records.

CTDCAMF

Compresses or changes the size of the Active Missions file.

CTDCATF

Compresses or changes the size of the Active Transfer file.

CTDCA2P

Copies new report or user entries from the Active User Report List file to the Permanent User Report List file.

CTDCCFRS

Creates and/or updates a CCF Resources file according to resources extracted from a XEROX printer tape.

CTDCCU

Identifies CDAM files not referenced by the Active User Report List file and optionally deletes them.

CTDCLHST

Cleans History User Report List file - replaced.

CTDCP2A

Copies empty report or user entries from the Permanent User Report List file to the Active User Report List file.

CTDDBSTB

Generates a statistical report showing how values in Control-D User file record fields are distributed.

CTDDELRD

Moves report entries from the Active to the Migrated and/or History Report List file and erases their compressed data sets from DASD storage.

CTDDELRP

Moves report entries from the Active to the Migrated and/or History Report List file and erases their compressed data sets from DASD storage.

CTDDIB

Rebuilds a Control-D User Report List file’s index component.

CTDDIG

Checks the integrity of Active, Permanent, History and Migration User Report List files.

CTDDIP

Deletes pages from CDAM files and deletes index values from index files and the DB2 Global Indexes database.

CTDFRESL

Allocates the CTD RESLIB with correct RECFM and LRECL.

CTDFRPGC

Formats the Page Counter (PGC) file.

CTDNRC

Propagates the category to note and ruler records.

CTDNREOR

Translates Notepad records to new format.

CTDREPUS

Analyzes Control-D report usage.

CTDRETC

Provides retention control of Control-D reports.

CTDRSD

Deletes orphan resource records.

CTDRSTMS

Performs a restore request for a large number of previously backed up or migrated reports.

CTDSMFRP

Produces a paper usage report for defined users.

CTDUFANX

Activates or deactivates a Control-D User file’s alternative index components and prints the component’s definitions.

CTDUFEXP

Transfers data between Control-D repositories.

CTDUFMDV

Separates the Migrated User Report List file to different partitions.

CTDUFMPR

Reorganizes Migrated User Report List file (MUF) partitions in place.

CTDUFPRT

Prints data from Control-D user files.

CTDUFUPD

Updates Active, Migration, History, or Permanent User files.

CTDULD

Copies records from a sequential file to the current Active, Permanent, History or Migrated User Report List file.

CTDUPBKP

Updates backup information in User Report List files (Active, Migration, History, or Permanent).

CTDUPMIS

Generate a list of decollation mission definitions and updates fields in decollation missions.

CTDUPTR

Globally updates the Control-D recipient tree.

CTVACDB

Verifies ACD data.

CTVCLMIG

Cleans entries from the Migrated User Report List file and erases or uncatalogs their CDAM data sets.

CTVDELI

Deletes unneeded index files from disk based on user-specified selection tables.

CTVGICL

Removes report entries that no longer exist in Active or Migrated user files.

CTVGICHK

Checks the integrity of index values of Control-V reports in the Global Index database.

CTVJAR

Consolidates reports that are created by Job Archiving.

CTVSCTT

Creates a list of CDAM and Index files migrated to tape.

CTVUNMIG

Reads a migrated CDAM file and recreates the original CDAM file on DASD.

CTVUPGDB

Updates all index values of an index file in the Global Index database.

CTVUPINV

Globally updates subscription records in the Permanent User File.

MIGRESET

Resets the Migration Mission Status.

RSTRESET

Resets the Restore Mission Status.

For more information about IOA Access Method utilities (IOADBF, IOADBSR, IOADCOPY, IOACPY, IOADIG, IOADII, IOADLD, IOADPT, and IOADUL), see IOA Utilities.

Control-O Utilities

Table 9 Control-O Utilities

Utility

Description

CTOALOCP

Backs up the Automation log.

CTOCSF

Copies the Message Statistics file.

CTOCTA

Lists programs running in an address space.

CTOCTI

Generates input for the COSMOS SYSIMAGE facility.

CTORSTM

Produces reports on message statistics.

CTOMVDSC

Emergency ON MVALERT Disconnect.

CTOOEDSC

Emergency USS Support Disconnect.

CTOSMDSC

Forces a disconnect of ON SMS support in emergency situations.

CTOTEST

Simulates messages or commands to trigger Control-O rules.

For more information about IOA Access Method utilities (IOADBF, IOADBSR, IOADCOPY, IOACPY, IOADIG, IOADII, IOADLD, IOADPT, and IOADUL), see IOA Utilities.

Control-M/Tape Utilities

Table 10 Control-M/Tape Trace Utilities

Utility

Description

CTTACP

Copies the Trace file.

CTTAFR

Formats and initializes the Trace file.

CTTCTRC

Allocates and formats the Trace file.

CTTRSM

Recovers Tape Activity from SMF records.

CTTTRB

Synchronizes the Trace file and the Media Database backup process.

Table 11 Control-M/Tape Stacking Utilities

Utility

Description

CTTDBIB

Rebuilds indexes of the Stacking database.

CTTGVL

Provides a user interface to the Stacking facility.

CTTSBD

Performs data set stacking in batch mode.

CTTSCA

Detects data set contentions.

CTTSTK

Builds and updates the Stacking Database.

CTTSTKR

Generates Stacking Statistics reports.

Table 12 Control-M/Tape Media Database Utilities

Utility

Description

CTTBIX

Rebuilds the index of the Media Database.

CTTDLD

Adds non-scratch volumes, adds and deletes scratch volumes and converts from other tape management systems.

CTTIDB

Checks the integrity of the Media Database.

CTTMER

Merges records from an extract file (created by the CTTSPL utility) into the Media Database.

CTTMUP

Performs manual update of the Control-M/Tape Repository.

CTTRCV

Recovers Media Database contents using the Trace file.

CTTSPL

Copies or moves (splits) specified records from the Media Database.

CTTSYNC

Synchronizes the automated tape libraries with the Control-M/Tape Media Database.

Table 13 Control-M/Tape Daily Management Utilities

Utility

Description

CTTRTM

Performs retention management.

CTTVTM

Performs vault management.

Table 14 Control-M/Tape Miscellaneous Utilities

Utility

Description

CTTRPT

Generates reports from extracted Media Database information.

CTTTPI

Initializes tapes, erases tapes and produces a detailed report of the logical and physical contents of a volume.

CTTRLPT

Smulates the application of rules to dataset records in the Media Database.

For more information about IOA Access Method utilities (IOADBF, IOADBSR, IOADCOPY, IOACPY, IOADIG, IOADII, IOADLD, IOADPT, and IOADUL), see IOA Utilities.