8.3.5 adshcvshow command (displays coverage information)
Syntax
adshcvshow { [ -l n1 [- [n2]] [, n3 [- [n4]]]]...]|-s} asc-file-path-name
Description
This command displays coverage information for the asc file specified in the argument.
Arguments
- -l n1 [- [n2]] [, n3 [- [n4]]]...
Specifies the range of coverage information to be displayed in terms of the line numbers of the job definition script.
Specify a range of line numbers in the format n1 [- [n2]]. n1- denotes the range beginning with line number n1 through the last line. You can specify multiple ranges separated by the comma (,).
n1: Line number of the starting line of the range to be displayed.
n2: Line number of the final line of the range to be displayed.
If this option is not specified, all lines in the job definition script are displayed.
In the specification format for lines, a range is specified with a hyphen (-), and multiple ranges are separated by the comma. If you do not specify a number after the hyphen, the range will extend from the line whose line number is specified before the hyphen through the final line.
- -s
Specifies that the display is to be based on the contents of a job definition script file that is being backed up.
This option is used to determine whether the asc file corresponds to the job definition script file or if there are differences.
- 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 containing the coverage information to be displayed.
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.
|
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 while output was being sent 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 |
The asc file cannot be processed by the command. The asc file was created by a different version. |
19 |
An error occurred during interaction with the OS while command processing was ongoing. |
Notes
An error results if the -s option and -l option are both specified at the same time.
An error results if the line number of the final line is less than the line number of the starting line in a specified range of lines.
If the line number of the starting line is equal to the line number of the final line, the range will consist of only that line.
If the line number of the starting line is greater than the number of lines in the job definition script file, the specification is ignored.
If the line number of the final line is greater than the number of lines in the job definition script file, the final line will be the last line.
Overlapping ranges are interpreted as the sum of the ranges. For example, -l 1-10,5-20 is equivalent to -l 1-20.
An error results if the format of a range is incorrect (example: 1-10-20).
An error results if 0 is specified as a line number.
When the -l option is specified, the lines from Total information and after are not output.
Examples
Display coverage information for lines 1 through 10, line 15, and lines 21 through the final line.
adshcvshow -l 1-10,15,21- JOB_user1.asc
Display coverage information for lines 2 through 8.
adshcvshow -l 2-6,4-8 JOB_user1.asc
If the job definition script file has 9 lines, nothing is displayed.
adshcvshow -l 10-15 JOB_user1.asc
If the job definition script file has 9 lines, coverage information for lines 2 through 4 is displayed.
adshcvshow -l 10-15,2-4 JOB_user1.asc