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:
Control-M JCL Verify Utilities
Control-D and Control-V 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.