#-adsh_file_temp command (assigns and postprocesses a temporary file)

Format

#-adsh_file_temp file-environment-variable [ -id temporary-file-identifier]
                  [-chk {create|exist}]
                  [-normal {del|keep}]

To Page Top

Description

This command assigns a file to be used temporarily in a job definition script and specifies its postprocessing. A maximum of 4,095 temporary files can be assigned. For details about how to use the #-adsh_file_temp command to create temporary files, see 5.9.2 Allocating temporary files and performing postprocessing.

To Page Top

Arguments

file-environment-variable

~<environment variable name>((1 to 31 bytes))

Specifies the name of a file environment variable that is being defined. This will serve as the key for identifying the temporary file you are assigning to it

In Windows, if ENABLE is specified in the VAR_ENV_NAME_LOWERCASE environment setting parameter, lowercase letters can be specified. If DISABLE is specified, lowercase letters cannot be specified.

-id temporary-file-identifier

~<symbolic name>((1 to 31 bytes))

Specifies an identifier for the temporary file, so that a temporary file created in a job step can be used in subsequent job steps. This argument can be omitted if you will not be using the assigned temporary file in any subsequent job step. This argument cannot be used to make assignments outside of the job's job steps.

The temporary file identifier must be unique among the temporary files that are created within the job. You cannot specify an identifier that is already in use for a temporary file created in another job step. However, you can specify the identifier of a file that was deleted during postprocessing in a previous job step.

-chk{create|exist}

Specifies whether to create a new temporary file or to assign an existing temporary file. If this specification is omitted, create is assumed.

• create

  Create a new temporary file. JP1/Advanced Shell will generate a file name and create a file whose size is zero bytes.

• exist

  Assign an existing temporary file that was created in a previous job step. You cannot use this specification to assign a file that was not created in a job step of the current job. When this option is specified, the id option and a temporary file identifier must also be specified.

-normal{del|keep}

Specifies the post-processing that is to be performed on the temporary file. If this specification is omitted, del is assumed.

• del

  After the applicable job or job step has completed, delete the assigned temporary file.

• keep

  After the applicable job step has completed, do not delete the assigned temporary file. The temporary file can be used again subsequently only in the current job's job steps. When this option is specified, the id option and a temporary file identifier must also be specified.

To Page Top

Return codes

To Page Top