Audit step

Use the Audit step to audit a ChangeMan ZMF change package.

Required properties

You need to set the following required properties for the Audit step:

Property Description
Name Enter a name for the step. By default, the system uses the command name.
Host Address Enter the TCP/IP host name or the LPAR number of the ChangeMan ZMF subsystem to connect to.
Port ID Enter the TCP/IP port ID for the ChangeMan ZMF subsystem to connect to.
User ID Specify a TSO user ID or SERNET/ChangeMan ZMF trusted user ID that can log in on behalf of other users.
Password Specify the corresponding TSO password or SERNET/ChangeMan ZMF password.
Package Name Enter the name of the ChangeMan ZMF change package.
Scope Appl Change the default list of applications to check relationships for SRC/CPY and LOD/LOD components (SYNCH5 and SYNCH8 conditions). Separate each application with a semicolon (;).
jobCard Specify a job card. Separate multiple job cards with semicolons (;).

Back to top

Optional properties

You can set the following optional properties for the Audit step:

Property Description
Login as User ID Enter the user ID to access ChangeMan ZMF by the trusted user ID.
Login as Current DA User Select this option to access ChangeMan ZMF with the user that is currently logged in to Deployment Automation, even if another user is specified in the Login as User ID field.
Audit Auto Parms Select to use audit auto parameters.
Audit Lite Select to audit only staging libraries rather than both staging and baseline libraries.
Audit Auto Resolve Choose whether you want the Audit step to automatically resolve out-of-sync conditions involving copybooks and load modules:
  • Selected (true): Report out-of-sync conditions and submit recompile and relink jobs to resolve the following conditions: SYNCH2, SYNCH4, SYNCH5, SYNCH7, SYNCH8, SYNCH9, SYNCH15, and SYNCH16.

  • Cleared (false): Only report out-of-sync conditions but do not resolve them.

Audit Include History Select to include audit history.
Audit Format Report Select to format the report by including printer control characters in the output file.
Audit Part as Simple

Select to audit participating ChangeMan ZMF change packages as simple packages.

Use this option to omit cross-package dependencies from the audit of a participating package and follow the rules for simple packages related to baseline libraries.

Audit Part as Primary

Select to audit participating packages as primary packages.

Use this option to include cross-package dependencies from the audit of participating packages. Cross-package dependencies are included for all packages except the previously installed ones.

Audit Part by Dept Choose whether to audit participating packages by department number.
Audit RC Update Restrict to Target Choose whether to restrict the audit return code update to the target package.
Audit Trace Option Choose whether to use the audit trace option.
Include XAP headers Choose whether to include XAP headers.
Suppress Notify Use this option to suppress the batch message.
Lock Package Select this option to lock packages during audit.
User Variable Specify user variables. Separate multiple variables with semicolons (;).
Web Service Timeout Interval

Enter the time interval for the ChangeMan ZMF web service call, in minutes. The default interval is 5 minutes.

Note: If your requests time out, set a longer time interval. Use the timeout option together with filters to limit the amount of returned data.

Ignore Failure Select this option if you want the step to always be considered successful.
Working Directory

Enter an alternative absolute path to the working directory for the step.

To use the default working directory for the process, leave the field empty.

Post Processing Script

Select a custom post-processing script. To run the step's default script, leave the field empty.

To create your custom post-processing script, click Add , and enter script details in the Create Script dialog box.

A post-processing script helps ensure that expected results occur. It runs after a step finishes processing. For details, see Post-processing scripts.

Precondition Enter a JavaScript script to define a condition that must exist before the step can run. The condition resolves to true or false.
Use Impersonation Select this option if you want an agent to run the step as a different user. Specify the impersonation details for a Windows or UNIX/Linux agent, as described in Use impersonation to run processes.
Hint Add a comment to the step. To view the comment, point to the step in the design space.

Back to top

Hidden properties

Set the following hidden properties for the Audit step.

Property Description
Output properties secure rules

Specify properties you want to be treated as secure. Secure properties are stored encrypted, and their values are displayed obscured in the Deployment Automation user interface.

Use regular expressions to select multiple properties. Enter each property name or expression on a new line.

Example: To select all properties with names that start with prop, use this regular expression: prop.*

Polling timeout

Available in versions: 6.3.6 and later

Specify the maximum time that the system waits for the audit to complete, in seconds.

Polling interval

Available in versions: 6.3.6 and later

Specify the time interval between attempts to poll for audit progress, in seconds. The polling interval cannot exceed the polling timeout.

Back to top

See also: