Auditing a Package
The audit function ensures the synchronization of components in an active change package with:
-
The staging and baseline libraries of those components.
-
The staging and baseline libraries of components in other participating packages.
-
The staging and baseline libraries of components in other applications.
Refer to the ChangeMan ZMF User’s Guide for more information about the audit function. The ChangeMan ZDD audit function uses a wizard interface with the following pages:
| Page | Description |
|---|---|
| Audit - Package | The first page displayed. Allows you to select options that determine the focus and scope of the audit. |
| Audit - Applications | Displayed only if you selected Specify Application Scope on the Audit - Package page. Allows you to select other applications to be included in the audit. |
| Audit - User Options | Displayed only if user options are specified in the AUDIT member of ZDDOPTS. Allows you to update the options for this audit. |
Steps to Audit a Package
Right-click an application folder, the Packages folder, or a package in DEV status to display the popup menu. Point to ZDD Network and then click Audit Package.
The first page displayed is the Audit - Package page.
Audit Options Page
On the Audit Options page you select options that determine the focus and scope of the audit. The default options selected are those that you last selected on this page.
The fields on the Audit - Package page are described below.
Package
If you invoke the audit function from a package folder, the package ID and title are displayed and cannot be changed. If you invoke the audit function from an application folder or the Packages folder, the drop-down list displays all packages in DEV status for the application. Select a package from the list.
General Options:
| Field / Box | Description |
|---|---|
| Audit staging libraries only | This option indicates whether you want to check for out-of-sync conditions in the package’s staging libraries only, or in the staging and baseline libraries. Select this option to check only the staging libraries. If you do not select this option, the staging and baseline libraries will be checked. |
| Auto resolve out- of-syncs | Audit accesses the impact-analysis table to obtain the relationships between source programs and copybooks, and the relationships of statically link-edited called load modules to the composite load modules that call them. This option indicates if you want audit to resolve out-of-sync conditions involving copybooks and load modules automatically. Select this option to report out-of-sync conditions and submit recompile and relink jobs to resolve SYNCH2, SYNCH4, SYNCH5, SYNCH7, SYNCH8, SYNCH9, SYNCH15, and SYNCH16 conditions. If you do not select this option, out-of-sync conditions will be reported but not resolved. |
| Include history records | This option allows you to include or exclude history records in the audit report. Select this option to extract component history for each staged component and include it in the audit report. (Component history shows other packages that contain the staged component). If you do not select this option, history information will not be processed when generating the audit report. |
| Format report for printing | This option allows you to customize the appearance of the audit report. Select this option to format the audit report for printing. The first character is an ASA printer-spacing control character that controls the vertical printer motion. If you do not select this option, the audit report will be formatted for browsing. The text starts in column one and blank lines separate the header and sections of the audit report. |
| Specify application scope | This option allows you to include additional application libraries in the audit. Select this option to display the Audit - Applications dialog box where you may select additional applications to include in the audit. See Applications Page for a description of this dialog box. If you do not select this option, the default mix of applications will be included in the audit. The applications included by default depend on the type of package being audited, and are as follows: Only the application associated with a simple package, or with a participating package that is being audited as a simple or primary package (Audit as simple package or Audit as primary package is selected). The applications associated with all participating packages if the package being audited is a: – Complex or super package. – Participating package that is not being audited as a simple or primary package. |
| Lock package | This option allows you to lock the package during the audit. When the audit job finishes, the package will automatically be unlocked. If the audit job fails for some reason and does not complete, the package can be unlocked manually using the Reset Audit Lock command. |
| Reset lock | Resets the package audit lock before submitting the audit job. |
| Show user variables | Displays the Other Options page which allows you to set user variables. |
Participating Packages
The following four options are available only if the Package field identifies a participating package.
| Field / Box | Description |
|---|---|
| Audit as simple package | This option specifies whether to audit the package as a simple package or not: Select this option to audit the specified participating package as a simple package. Only the staging and baseline libraries associated with this package are considered in the audit. If you select this option, you may not select any of the other Participating Packages options. If you do not select this option, the libraries of the other participating packages are included in the audit. |
| Audit as primary package | This option specifies whether to audit the package as a primary package or not: Select this option to audit the libraries of all participating packages in the audit, but report out-of-sync conditions only in the target participating package and update the audit return code for only the target participating package. The text Primary Package Processing appears in the header of each section of the audit report to indicate that you have requested that the target participating package be audited as a primary package. If you do not select this option, the audit includes the libraries of all participating packages, reports out-of-sync conditions in all participating packages, and updates the audit return-code for all participating packages. |
| Audit by department number | Select this option to exclude the participating packages that have a department number that differs from the department number of the target participating package. If you select this option, you may not select the Audit as simple package or Audit as primary package options. If you do not select this option, all participating packages are included in the audit regardless of the department number associated with the target participating package. |
| Update only this package return code | Select this option to update the return code for only the target participating package. If you do not select this option, the return code is updated for all participating packages included in the audit. If the Package field identifies a complex or super package, the return code for the target complex or super package is also updated and is set to the highest return code issued for the participating packages. |
Other Options
| Field / Box | Description |
|---|---|
| Cross-application headers | If numerous application:libtype combinations share the same baseline library, this field enables you to specify the number of application:libtype combinations that are printed in the heading of an audit report section. Select one of the following from the drop-down box: None Suppress all appl:libtype combinations. Top line Print only the first line of appl:libtype combinations. Full List all appl:libtype combinations. Up to six appl:libtype combinations are printed on each line. For example, if the same baseline library is shared among 300 applications, then a Full setting for this field prints 50 lines of appl:libtype combinations in the heading of a report section. This field enables you to control the number of heading lines that are printed if a large number of appl:libtype lines are undesirable. |
| Job card | Default values are displayed initially. If you change the values, they will be stored in your registry and used as the defaults in the future. Each time this dialog displays, the last character of the jobname is incremented alphabetically. If the \&SYSUID parameter in the Notify field is not overridden, the user ID is automatically substituted. |
How to Proceed
You will see either a Next button or a Finish button. If you did not select Specify application scope and there are no user options specified in the AUDIT member of ZDDOPTS, click the Finish button to submit the audit job; otherwise click the Next button to display the next page.
Applications Page
The Applications page displays only if you selected Specify application scope on the Audit Options page. The applications listed are those that have been filtered for the ChangeMan instance (using the Filters page of the properties sheet for the ChangeMan instance).
The default applications selected are determined by:
-
The level of the package that you are auditing (simple, participating, complex/super).
-
Options you selected on the Audit - Package page.
How to Proceed
Select any additional applications to be included in this audit. You may also deselect any default applications, except for the application to which the package is defined.
You will see either a Next button or a Finish button. If there are no user options specified in the AUDIT member of ZDDOPTS, click the Finish button to submit the audit job; otherwise click the Next button to display the next page.
Other Options Page
The Other Options page is displayed only when there are customer-defined options specified in the AUDIT member of ZDDOPTS.
How to Proceed
Update the options as needed for this audit, following the validation rules specified in the AUDIT member of ZDDOPTS.
Click the Finish button to submit the audit job.
Viewing the Audit Report
See Viewing Output for ChangeMan ZMF Jobs for information on viewing job output through ChangeMan ZDD.
Resetting the Audit Pending Lock
You can reset the audit pending lock as follows:
Right click on a package, or the Packages folder, and select ZDD Network → Reset audit lock from the popup menu.
The Reset Audit Lock dialog box will display.
