OS/400 Program

OS/400 Program enables the job to execute the program specified Program that resides in Library or Path on the Special environment.

You can access the OS/400 Program either from the job palette in the Planning domain or select Program from the What to run field in OS/400 Full Properties Pane in Control-M. For more details about OS/400 parameters, see OS/400 job Full parameters.

The following table describes the OS/400 program parameters.

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.

Library

Defines the library name where the program resides. Up to 10 characters.

S/38 Environment: Up to 8 characters.

Path

(Qshell only) Defines the path where the QShell program resides. The path name must start with ~, /, \ or period (.).

Program

Defines the program name to be executed in the specified special environment.

Overriding path

(Qshell only) Defines the name of an alternate path or directory for the program specified in the Program parameter.

Overriding library

Defines the name of an alternate library or directory for the program specified in the program parameter.

Program'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: Defines 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