ASC_FILE parameter (defines a naming rule for accumulation files)
- Organization of this page
Format
#-adsh_conf ASC_FILE file-naming-rule
Description
This parameter defines a naming rule for accumulation files used in the coverage auto-acquisition functionality.
Operands
- file-naming-rule
-
Windows: ~<any character string>((1 to 247 bytes))
UNIX: ~<any character string>((1 to 1,023 bytes))
Specifies a path name with a substitution position.
The asterisk (*) specifies the substitution position. The location where the asterisk is specified is replaced with the job definition script name (without the file extension). The search begins at the beginning and substitution occurs at the location of the first asterisk that is detected. Any subsequent asterisks that are specified are not subject to substitution.
If no substitution position is specified, the specified name is used as is as the file name, and no substitution occurs.
If the resulting value is invalid as a path name regardless of whether substitution occurred, an error results. If this parameter is omitted, the file name is determined according to the rules used when the -o option is omitted in the adshexec command.
You must specify the file naming rule in such a manner that the file name obtained after conversion does not exceed the maximum length permitted for the path name of an asc file in the adshexec command. If this maximum length is exceeded, an error will occur during execution of the adshexec command.
Notes
-
If this parameter is defined in both the system environment file and the job environment file, the definition in the job environment file takes effect.
-
This parameter is ignored when the BATCH_CVR parameter's operand value is not YES.
-
Do not use a file name that begins with a dot (.).
-
Do not use reserved device names (such as CON, AUX, and NUL) as file names. (Windows only)
-
Do not use NTFS streams for file names. (Windows only)
Example
-
This example enables the coverage auto-acquisition functionality and defines a naming rule for accumulation files.
#-adsh_conf BATCH_CVR YES #-adsh_conf ASC_FILE ./cvrg/ver001-*
In this example, execution of adshexec sample.ash will be the same as execution of adshexec -t -o ./cvrg/ver001-sample sample.ash.