Modifying a cleanup utility job

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 report
Generated 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

Concept Concept

Feedback


Timestamp icon Last updated: Friday, 22 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///modifyingcleanupjob.html