3.9.6 Coverage auto-acquisition functionality
The coverage auto-acquisition functionality enables you to collect coverage information without having to change parameters in the adshexec command.
If you use the environment setting parameters listed below to set the coverage information to be collected, there is no need to specify the -t option for collecting coverage information when you execute batch jobs with the adshexec command.
-
BATCH_CVR parameter: Specifies that the coverage auto-acquisition functionality is to be used.
-
ASC_FILE parameter: Defines the naming rules for accumulation files used by the coverage auto-acquisition functionality.
The following shows an example of specifying the adshexec command:
adshexec job-definition-script-name.ash
This command executes the specified job definition script without having to specify the options (-t and -o) for collecting coverage information.
When the coverage auto-acquisition functionality is used, the -t option cannot be specified in the adshexec command. If the adshexec command is executed with the -t option specified in such a case (such as adshexec -t sample.ash), it will terminate with an error and set return code 1.
You collect the coverage information by specifying #-adsh_conf BATCH_CVR YES in the environment file.
When the coverage function is enabled by the coverage auto-acquisition functionality, the asc files (coverage information files) are output to the current directory in which each command was executed.
If #-adsh_conf ASC_FILE cvr/ver001-* is specified in the environment file, the above command produces the same results as when adshexec -t -o cvr/ver001-job-definition-script-name job-definition-script-name.ash is executed.
If the current directory differs for each command, the asc files are created in various directories. By specifying #-adsh_conf ASC_FILE, you can designate a specific directory to which the asc files are to be output. You can also standardize the asc file names.
For details about the settings in the environment files, see 2.6.11 Enabling coverage information collection without having to specify the option during batch job execution.