Skip to content

Impact Analysis Housekeeping (LDS)

This section describes housekeeping jobs that maintain the impact analysis VSAM LDS.

Unload Impact Analysis LDS

Unload the Impact Analysis LDS to sequential files BUNSPACE, CMPSPACE, and RELSPACE.

Sample JCL Member LDSUNLD
Utilities IDCAMS CMNIALU0
Suggested Frequency Daily
SERNET Status The SERNET instance where the LDS is used may be up and the IADS subtask attached. However, the best data integrity is obtained when the SERNET instance is down or the IADS subtask is detached. For details about the ATTACH and DETACH modify commands, see the Modify Commands appendix in the ChangeMan ZMF Installation Guide.
Process Steps ● Delete old flat files (BUNSPACE, CMPSPACE, RELSPACE) with IDCAMS.
● Run unload utility CMNIALU0 to create new flat files.
Comments You can also back up the Impact Analysis LDS with IDCAMS sample job LDSBKUP, and then build your own job to restore the IDCAMS backups.

...

Load Impact Analysis LDS

Restore the Impact Analysis LDS by processing a set of sequential BUNSPACE, CMPSPACE, and RELSPACE files, mapping the impact analysis data space, and then deleting, defining, and loading a new VSAM LDS.

Sample JCL Member LDSUNLD
Utilities CMNIALC0
ICEMAN
IDCAMS
CMNIAIN0
CMNIALB0
CMNIALR0
CMNIALX0
Suggested Frequency On request
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details about the ATTACH and DETACH modify commands, see the Modify Commands appendix in the ChangeMan ZMF Installation Guide.
Process Steps ● Backup impact analysis VSAM LDS using IDCAMS.
● Analyse incoming component and relationship flatfiles using CMNIALC0 and create two temporary files for later use.
● Delete/Define new impact analysis dataspace LDS using IDCAMS.
● Sort twice with ICEMAN dropping duplicates.
● Initialise and structure the new impact analysis dataspace LDS using CMNIAIN0.
● Four further sorts using ICEMAN to create temp files for later use.
● Load using the 4 sort outputs just created, using CMNIALB0.
● Sort the relation file created earlier by CMNIALC0 into sequence and drop duplicates, using ICEMAN.
● Load component name table and relationship table using CMNIALR0.
● Sort relation file using ICEMAN.
● Build the dataspace indexes using CMNIALX0.
● Verify index structures using CMNIAIXC.
Comments If you back up the Impact Analysis LDS with sample IDCAMS job LDSBKUP, you can build an IDCAMS restore job using the VSAM LDS DEFINE statements in the LDSLOAD sample JCL.

...

Note

Also use this job to load the Impact Analysis LDS with the BUNSPACE, CMPSPACE, and RELSPACE files created by the job initiated by the online Impact Analysis Maintenance function and file tailored from skeleton CMN$$IAX.

Back Up Impact Analysis LDS

Create sequential copy of the contents of the impact analysis LDS for records retention and disaster recovery.

Sample JCL Member LDSBKUP
Utilities IDCAMS
Suggested Frequency Daily
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF 8.1 Installation Guide.
Process Steps Uses IDCAMS to REPRO a copy of the impact analysis LDS.
Comments Restoring an IDCAMS backup of the impact analysis LDS creates an exact physical copy of the original file.

...

Restore Impact Analysis LDS

Define impact analysis LDS and populate it from an IDCAMS backup.

Sample JCL Member LDSRESTR
Utilities IDCAMS
Suggested Frequency On request
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF 8.1 Installation Guide.
Process Steps ● Uses IDCAMS to delete and define a new empty impact analysis LDS.
● Uses IDCAMS to REPRO a backup into the newly defined file.
Comments Restoring an IDCAMS backup of the impact analysis LDS creates an exact physical copy of the original file.

...

Reorganize Impact Analysis LDS

Unload the impact analysis LDS into sequential files BUNSPACE, CMPSPACE, and RELSPACE. Perform multiple steps to delete and define the LDS, map a data space and initialize the LDS, load the LDS, and build indexes.

Sample JCL Member LDSREORG
Utilities IDCAMS
CMNIALU0
CMNIALC0
ICEMAN (SORT)
CMNIAIN0
CMNIALB0
CMNIALR0
CMNIALX0
Suggested Frequency The impact analysis LDS should be rebuilt weekly. Run either this job or the housekeeping job that executes program CMNIA000 on a weekly basis.
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF 8.1 Installation Guide.
Process Steps ● First two steps use IDCAMS to delete and then CMNIALU0 to create new flat files BUNSPACE, CMPSPACE and RELSPACE, as per the LDSUNLD job.
● Rest of job same as second step and onwards of the LDSLOAD job under heading Load Impact Analysis LDS above.
Comments Back Up and clear the IALOG file when you reorganize the IADSP file.

...

Forward Recover Impact Analysis LDS from Backup

Forward recover an impact analysis LDS from a previous backup by applying IALOG records with more recent timestamps.

Sample JCL Member LDSFWDR
Utilities CMNIALF0
Suggested Frequency On request
SERNET Status Either the target ZMF (that is, Sernet) must be down or the IADS subtask must be detached.
Process Steps Uses CMNIALF0 to do the forward recovery.
Comments By default, program CMNIALF0 applies all transactions in the IALOG dataset with timestamps later than the last save time recorded in the IADSP LDS. This behavior can be overridden by supplying FROM= or TO= values in the PARM= field.

...

Back Up And Clear Impact Analysis Log File

When you execute the procedure in Unload Impact Analysis LDS to establish a restore point for the impact analysis LDS, you should clear the impact analysis log file that is used for forward recovery.

Sample JCL Member LDSLOGR
Utilities IDCAMS
CMNIALP0
Suggested Frequency Schedule at the same time as the impact analysis LDS unload.
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF 8.1 Installation Guide.
Process Steps ● Copy the current QSAM impact analysis log file to a backup using IDCAMS.
● Allocate and initialize a new QSAM log file using CMNIALP0.
Comments Run this job when you run housekeeping jobs to back up or reorganize the impact analysis LDS.

...

Load Db2 Tables With Data From Impact Analysis LDS

Unload the impact analysis LDS into sequential files BUNSPACE, CMPSPACE, and RELSPACE. Perform multiple steps to load the impact analysis data to Db2 tables CMNBASE and CMNBUN and build indexes. This housekeeping job is intended for customers who created their own processes that use Db2 tables CMNBASE and CMNBUN. These Db2 tables are not used in ChangeMan ZMF.

Do not confuse this process with using Db2 to host the I/A information. This job is for those customers who are already using the default LDS/dataspace mechanism who want to also extract the data to a Db2 table. The tables suggested here are not the same as those that can be used as the primary data source for the I/A information.

Sample JCL Member LDSUNLD
LDS2DB2
Utilities IDCAMS
CMNIALD0
DSNUPROC
Suggested Frequency As needed.
SERNET Status The SERNET instance where the LDS is used may be up and the IADS subtask attached. However, the best data integrity is obtained when the SERNET instance is down or the IADS subtask is detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF 8.1 Installation Guide.
Process Steps ● Delete the IATABLE, BUNDB2 and RELDB2 datasets using IDCAMS.
● Define and initialize BUNDB2 and RELDB2 datasets using CMNIALD0.
● Allocate a new IATABLE and load the reformatted files into Db2 tables using DSNUPRO3.
Comments Do not use the BUNSPACE, CMPSPACE, and RELSPACE files output from program CMNIA000 as input to the Db2 table load process. Instead, use files unloaded from the impact analysis LDS as described here.

...

Synchronize Impact Analysis Data

Extract impact analysis data from the ChangeMan ZMF package master and component master files to create sequential files BUNSPACE, CMPSPACE, and RELSPACE. Perform multiple steps to delete and define the LDS, map a data space and initialize the LDS, load the LDS, and build indexes

Sample JCL Member IMPACT LDSLOAD
Utilities CMNIA000
CMNIALC0
ICEMAN
CMNIAIN0
CMNIALB0
CMNIALR0
CMNIALX0
Suggested Frequency On request whenever one of these occurs: Library types or baseline libraries are changed in application administration. The Impact Analysis Dataspace Index Integrity Report in the baseline ripple CMN30 job indicates a problem with the LDS indexes.
SERNET Status The SERNET instance where the LDS is used must be down or the IADS subtask must be detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF Installation Guide.
Process Steps ● Impact job: Delete BUNSPACE, CMPSPACE and RELSPACE using IEFBR14.
● Build BUNSPACE, CMPSPACE and RELSPACE using CMNIA000.
● LDSLOAD job - refer to heading Load Impact Analysis LDS above.
Comments Program CMNIA000 parses a component for relationships only if the component has never been baselined in a change package.

...

Check Impact Analysis LDS Indexes

Validate the indexes in the impact analysis LDS.

Sample JCL Member LDSIXCHK
Utilities CMNIAIXC
Suggested Frequency On request
SERNET Status The SERNET instance where the LDS is used may be up and the IADS subtask attached. However, the best data integrity is obtained when the SERNET instance is down or the IADS subtask is detached. For details and cautions about the ATTACH and DETACH commands, see the ChangeMan ZMF Installation Guide.
Process Steps Check integrity of the indexes using CMNIAIXC.
Comments Support may ask you to run this job to help diagnose issues with impact analysis. The Impact Analysis Dataspace Index Integrity Report is written to DD statement CMNIADSX.

...