8.3.4 adshcvmerg command (merges coverage information)
Syntax
adshcvmerg -o output-asc-file-path-name base-asc-file-path-name merge-asc-file-path-name
Description
This command merges coverage information from a base asc file and a merge asc file, and then outputs the merged contents to an output asc file.
A command error results if the input files to be merged are the same file. Whether the input files are the same is determined by whether they have the same file name, including the absolute path name. It is not based on whether the contents of the input files are the same.
Arguments
In Windows, arguments are not case sensitive; in UNIX, arguments are case sensitive.
- -o output-asc-file-path-name
Windows: ~<path name>((1 to 229 bytes))
UNIX: ~<path name>((1 to 1,005 bytes))
Specifies the path name of the output file to which the merge results are to be output.
- base-asc-file-path-name
Windows: ~<path name>((1 to 229 bytes))
UNIX: ~<path name>((1 to 1,005 bytes))
Specifies the path name of the base asc file.
- merge-asc-file-path-name
Windows: ~<path name>((1 to 229 bytes))
UNIX: ~<path name>((1 to 1,005 bytes))
Specifies the path name of the asc file to be merged with the base asc file.
Return codes
Return code |
Meaning |
---|---|
0 |
Normal termination |
1 |
The end of the file was detected in the middle of reading an asc file. The asc file is corrupted. |
2 |
An error occurred during unlocking of a file. |
3 |
There is an error in a command line specification. |
4 |
There is an error in an environment variable setting.
|
5 |
Different job definition scripts were used for the following:
|
6 |
An error occurred during opening of a file.
|
7 |
An error occurred during locking of a file. |
8 |
An error occurred while the name of a file was being changed. |
9 |
An error occurred during file input or output. |
10 |
A memory shortage occurred. |
11 |
An error occurred during message output processing. |
12 |
An error occurred during processing of output to the standard error output. |
13 |
An inconsistency in internal processing was detected. |
14 |
An error was detected in the data format of an asc file. The asc file is invalid. |
15 |
An error occurred during acquisition of the date and time. |
16 |
An error occurred during acquisition of the job definition script file information. |
17 |
An asc file cannot be processed by the command. An asc file was created by a different version. |
19 |
An error occurred during interaction with the OS while command processing was ongoing. |
Notes
Merging is possible only when the same job definition script was used to collect the coverage information for the base asc file and the merge asc file. If different job definition scripts were used, a command error results.
A command error results if you specify the base asc file or the merge asc file for the output asc file. The output asc file must be different from the base asc file and the merge asc file.
A command error results if you specify the same file as the base asc file and the merge asc file.
Whether the files specified as the base asc file and the merge asc file are the same is determined by the absolute path names of the specified files. They are considered the same file if their absolute path names are identical.
Example
Merge the coverage information in JOB_user1.asc and JOB_user2.asc and send the output to JOB_user3.asc.
adshcvmerg -o JOB_user3.asc JOB_user1.asc JOB_user2.asc