Script File

The Script File enables the job to execute the Script file specified in Script file that resides in Library or Path in the Special Environment. CTMCL (the Control-M Script interpreter) processes the commands in the script.

The following table describes the Script File parameters for an OS/400 job.

Parameter

Description

Special Environment

Defines the following environment where the job runs:

  • Native: Enables the job to run on the native OS/400 environment.
  • QShell: Enables the job to run on the QShell environment.
  • S/38: Enables the job to run on the System/38 environment.

Script file location

Indicates where the following script file is located:

  • Native (QSYS file system): The script file belongs to a physical file that resides in a QSYS library.
  • IFS (Integrated file system): The file resides in the integrated file system. The file path must start with one of the following characters: /, \, ~ or .
  • Embedded script: The script content is embedded in the Control-M job definition, which is in the "Script" text box. The "Script file name" becomes informational only and does not have to exist on the target system.

Library

(Script file location Native only) Defines the library name. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Script

(Embedded script only) Enables you to type the embedded script.

Script File

Specifies the name of the script file which is executed. When the Script file location is Native (QSYS file system), the value of this field must be specified in one of the following formats:

  • <File>/<Member>
  • <File>/
  • /<Member>

Where File and Member are valid OS/400 object names.

Path

(Script file location IFS only) Defines the path in which the script file resides in. The path name must start with ~, /, \ or period (.).

Overriding path

(Script file location IFS only) Defines the name of an alternate path or directory for the file specified with the Script file parameter.

Overriding library

(Native only) Defines the name of an alternate library or directory for the file specified with the Script file parameter.

Script File's Parameters

Defines a Program, Script file or VT script file, which may expect to receive parameters as input for the execution.

Each parameter must match its type as expected by the Program, Script file or VT script. To modify the parameters, see Parameter display options.

The following types are available:

  • String: Defines any string up to 4000 characters.
  • Decimal - Defines a decimal number with or without decimal point. The value is passed to the program as packed decimal with a length of (15 5), where the value is 15 digits long, of which 5 digits are decimal positions.
  • Hex - Specifies any even number of hexadecimal characters (0-9, a-f, A-F). The value is passed to the program as X'<value>'.

    NOTE:

  • The String is the only valid type to be passed to Script file or VT script file and also to a QShell program
  • A maximum of 99 parameters can be set per job.
  • If you need to include single quote character ('), it must be 2 single quotes ('').

Resolve special values

Indicates whether special values, such as *PGM, *DTAARA, and *FILE, defined in the program's parameters value will be resolved by the script interpreter or prior to submitting a program.

The default value is Yes (checked).

For more details about OS/400 special values see Resolving parameters with special values in the Control-M/Agent for iSeries (AS/400) Administrator guide.

Submission attributes

Enables you to define submission attribute parameters for an OS/400 job. For more information, see Submission Attributes.

Advanced

Enables you to define advanced parameters for an OS/400 job. For more information, see Advanced parameters for OS/400 Job.

Parent Topic

OS/400 job Full parameters