PATH_CONV parameter (defines the details of path conversion)

Format

#-adsh_conf PATH_CONV path-name-1 path-name-2

To Page Top

Description

This parameter defines path names before and after conversion in job definition scripts.

In character strings separated by the path separator defined in the PATH_CONV_ENABLE parameter, a character string's leading part that matches path-name-1 is converted to path-name-2 when the job definition script is executed. This conversion is also performed on the path separator and directory separator defined in the PATH_CONV_ENABLE parameter.

In Windows, the conversion result varies depending on the path conversion rule selected by the PATH_CONV_RULE parameter. For details, see PATH_CONV_RULE parameter (defines a rule for converting file paths) (Windows only).

This parameter is not valid when the PATH_CONV_ENABLE parameter is not defined. If this parameter is defined multiple times, the parameters are searched in the order they are defined in the environment file and the first definition satisfying the conversion condition is applied.

To Page Top

Operands

path-name-1 ~<path name>((1 to 247 bytes))

Specifies the path before conversion. To specify a value containing a space, enclose the value in double quotation marks (").

In Windows, you can specify a path in UNIX for path-name-1. In UNIX, you can specify a path in Windows for path-name-1. If you intend to use \, specify \\ because JP1/Advanced Shell handles \ as an escape character. Note that none of the following characters is permitted:

* ? < > | ` (grave accent mark) $

A path name must contain a directory separator. Use the following for the directory separator:

• In Windows, specify a forward slash (/).

• In UNIX, use two consecutive backslashes (\\).

path-name-2 ~<path name>((1 to 247 bytes))

Specifies the path after conversion. To specify a value containing a space, enclose the value in double quotation marks ("). If you intend to use \, specify \\ because JP1/Advanced Shell handles \ as an escape character. Note that none of the following characters is permitted:

* ? < > | ` (grave accent mark) $

A path name must contain a directory separator. Use the following for the directory separator:

• For execution in Windows, specify two consecutive backslashes (\\).

• For execution in UNIX, use a forward slash (/).

To Page Top

Notes

• If this parameter is defined in both the system environment file and the job environment file, both definitions take effect. However, if the total number of times this parameter is specified in the system environment file and the job environment file combined exceeds 255, an error occurs.

• Conversion by this parameter is performed one line at a time. Therefore, if the part of a job definition script that corresponds to a path name contains an end-of-line character, the correct conversion cannot be performed.

• Character strings in comments are also converted.

• The conversion rules are searched in the order they are defined and only the first rule satisfying the conversion condition is applied.

• If DELETE is specified in the SPOOLJOB_CHILDJOB parameter, no script image is output for a job definition script that is executed as a child job. Therefore, if this parameter is used to convert the path name of a job definition script that is executed as a child job, the conversion results will not be output.

• According to path conversion rule 2, you cannot nest single quotation marks (') inside a range enclosed in double quotation marks ("). If they are specified, they will be subject to path conversion.

To Page Top

Example

• This example uses the PATH_CONV parameter to execute in Windows job definition scripts created for UNIX:

  #-adsh_conf PATH_CONV /home/hitachi "C:\\hitachi"
  #-adsh_conf PATH_CONV_ENABLE / :
  #-adsh_conf PATH_CONV /tmp/jp1as "D:\\jp1as_tmp"
  #-adsh_conf PATH_CONV /tmp "C:\\temp"

• This example uses the PATH_CONV parameter to execute in UNIX job definition scripts created for Windows:

  #-adsh_conf PATH_CONV "C:\\hitachi" /home/hitachi
  #-adsh_conf PATH_CONV_ENABLE \\ ;
  #-adsh_conf PATH_CONV "D:\\jp1as_tmp" /tmp/jp1as
  #-adsh_conf PATH_CONV "C:\\temp" /tmp

To Page Top