To request a resource cleanup from the dependency VSAM
files, edit and run the CIUJCLDL job.
Before you run the CIUJCLDL job, modify the following settings:
- 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 cleanup 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 cleanup
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 cleanup 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)
You can enter one of these command groups or both of them.
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.
The number of prefixes is not limited and they may be written
in any order.
- SYSPRINT DD statement
- Specify where to save the report produced by the cleanup utility.
Note: The
cleanup 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