Staging Versions Housekeeping

This section describes housekeeping jobs that maintain the three staging versions VSAM master files.

Back Up Staging Versions VSAM Files

Copy four staging versions VSAM files to QSAM.


Sample JCL Member	SVBKUP
Utilities	IDCAMS
Suggested Frequency	Daily
SERNET Status	The SERNET instance where the VSAM files are used should be down or the SSV 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	REPROs all four staging VSAM files (CMNSVSM, CMNSVOM, CMNSVDM and CMNSVAM) using IDCAMS.

...

Restore Staging Versions Master

Delete, define, and load four staging versions masters from QSAM backup files.


Sample JCL Member	SVRSTOR
Utilities	IDCAMS
Suggested Frequency	On request.
SERNET Status	The SERNET instance where the VSAM files are used must be down or the SSV 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	Deletes all four staging VSAM files (CMNSVSM, CMNSVOM, CMNSVDM and CMNSVAM) and redefines all, then REPROs all back from QSAM using IDCAMS.

...

Reorganize Staging Versions VSAM Files

Copy three staging versions VSAM files to QSAM, create new VSAM files, then restore the VSAM files from QSAM.


Sample JCL Member	Combine SVBKUP and SVRSTOR
Utilities	IDCAMS
Suggested Frequency	Weekly
SERNET Status	The SERNET instance where the VSAM files are used must be down.
Process Steps	See the SVBKUP and SVRSTOR jobs above.

...

Delete Staging Versions Members

Delete Staging Version members that are no longer needed from the Delta Master.

The Delta Master is a VSAM data set that stores ChangeMan ZMF staging versions. When a developer saves a staging version, a delta member of the changes is added to the Delta Master.

When ChangeMan ZMF ages and deletes staging libraries as specified in application administration, it automatically deletes staging versions associated with those staging libraries. The purpose of this job is to:

Delete staging versions that belong to change packages that are never installed.
Reduce the number of staging versions saved from packages that have an extended lifecycle.
Reduce the number of staging versions for package components that have many saved staging versions.


Sample JCL Member	SVMAINT
Utilities	HPSMAINT IDCAMS
Suggested Frequency	Weekly
SERNET Status	The SERNET instance where the Staging Versions VSAM files are used must be down.
Process Steps	● Define new GDG levels for (CMNSVSM, CMNSVOM and CMNSVDM) and REPRO current files (CMNSVSM, CMNSVOM, CMNSVDM) into those using IDCAMS. ● Delete (or archive) staging versions from the Delta Master using HPSMAINT.

...

Synchronize Staging Versions Masters

Analyze three staging versions VSAM files for discrepancies and report problems. Make corrections to synchronize the three files.


Sample JCL Member	SVINTEG
Utilities	HPSINTEG
Suggested Frequency	Weekly
SERNET Status	The SERNET instance where the VSAM file is used must be down or the SSV subtask must be detached. For details about the ATTACH and DETACH commands, see the ChangeMan ZMF Installation Guide.
Process Steps	● Job runs with a COND of (4,NE) - the first step normally runs in SIMULATE mode, and produces a RC NE 4 in that mode, so following steps don’t run. ● If the SIMULATE parm is removed then if any discrepancies are found and corrected then the next step run and if it finds no further errors, that will result in a RC of zero which will stop execution, and the third pass could be executed if not.
Comments	Program HPSINTEG is executed three times in this sample: With execution parameter SIMULATE to report conditions that should be repaired. Without execution parameter SIMULATE to repair inconsistencies. Without execution parameter SIMULATE to repair inconsistencies because some repairs may create new inconsistencies.

...