Modifying a clean up utility job
To request a resource clean up from the dependency VSAM files, edit and run the CIUJCLDL job.
- JOB accounting parameters
- Modify the JOB card statement to meet your site standards.
- STEPLIB DD statement
- Specify the name of the CICS® IA load library in which you have installed the clean up utility program, CIUDEL.
- CIUINT1 DD statement
- Specify the name of the CICS dependency data file for the
chosen region.
Each dependency data file has a header record, which specifies the APPLID of the CICS region that creates the record. The clean up utility checks the correspondence between the APPLID of the region and the APPLID recorded in the control record file, CIUCNTL, and proceeds only if they match.
If the dependency data files and the control record file are shared by multiple regions, they contain a header record for each of the monitored regions.
- CIUINT2 DD statement
- Specify the name of the DB2® dependency data file for the chosen region.
- CIUINT3 DD statement
- Specify the name of the MQ dependency data file for the chosen region.
- CIUINT4 DD statement
- Specify the name of the IMS™ dependency data file for the chosen region.
- CIUINT5 DD statement
- For the chosen region, specify the name of the CICS dependency data file in which you want to store the dependency resources with the names that are longer than 32 bytes.
- CIUINT6 DD statement
- Specify the resource detail data file for the chosen region.
- CIUCNTL DD statement
- Specify the name of your CICS IA VSAM control file for the chosen CICS region.
- APPLID DD statement
- Specify the APPLID DD statement as follows:
- Enter a region VTAM® APPLID, if you want to clean up the dependency data from a particular region.
- Select ALL, if you want to clean up the data from all the regions in the dependency data files.
Leaving the field blank also causes clean up the data from all the regions.
- REPTYPE
- Specify the type of command for which you want to clean up the
dependency data.Note: You can specify only CICS commands.
- CMDGRPS DD statement
- Specify the CICS command
groups for which you want to clean up the dependency data. Note: This statement is effective only if you have specified CICS commands as a REPTYPE.
You can specify the CICS command groups directly from the commands selected to be monitored by the Collector.
The following command groups are supported:- TS commands (READQ TS, WRITEQ TS, DELETEQ TS)
- TC commands (ENQ, DEQ)
Note: Make sure that there is no prefixes superposition, when using more than one command group. - PRFGRPS DD statement
- Specify the resource prefixes as follows:
- Each prefix must be written in a separate string.
- The maximum length of a prefix is 32 symbols.
- The first symbol of a prefix must not be blank, because it indicates the end of a prefix.
- The empty string indicates the end of a file.
- The empty file means that all the records for the specified command group must be deleted.
- The ALL prefix in the first and the only string also means that all the records for the specified command group must be deleted.
- SYSPRINT DD statement
- Specify where to save the report produced by the clean up utility.Note: The clean up utility requires correct access to the CICS IA VSAM files. Make sure that the CICS IA Collector is stopped and the VSAM files are unavailable for batch update processing. If necessary, close the VSAM files with the CEMT SET FILE transaction.
The output report consists of a list of the selected command groups and a report about the deleted records. For an example of the output report, see Figure 1.
Figure 1. Example clean up utility reportGenerated by CICS Transaction Inter-dependency Utility on 2012/10/20 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 510 --LIST OF CICS COMMAND GROUPS-- Command Group Deletion ---------------------- TS Yes 2011/01/20 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 320 DELETED RECORDS REPORT FOR APPLID: IYDZZ22B FROM CICS RESOURCE FILE Command Group Prefix Amount --------------------------------------------------------------- ENQ_CMDG XXXXXXXXXXXXXXXX 12 TSQ_CMDG YYYYYYYY 18 TSQ_CMDG ZZZZ 18 2011/01/20 - CICS INTERDEPENDENCY ANALYZER (CIU) - Version 320 DELETED RECORDS REPORT FOR APPLID: IYDZZ22B FROM FROM RESOURCE DETAIL FILE Command Group Prefix Amount --------------------------------------------------------------- TSQ_CMDG YYYYYYYY 3 TSQ_CMDG ZZZZ 3