OS/400 VT

Control-M Virtual Terminal (also known as Screen Scraper) enables the execution of 5250 Interactive session operator actions from interactive menus and screen dialogs as a Control-M batch job. The interactive job then becomes part of your batch stream and can be executed by using all the Control-M scheduling criteria. You can access OS/400 VT from the job palette in the Planning domain or from the What to Run in OS/400 Full in the Job 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 Virtual Terminal (VT) parameters.

Parameter

Description

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

(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 type script.

VT Script file

Specifies the name of a script file containing the virtual terminal instructions to be executed.

Member

(Native) Specifies the member name that contains the script file inside the script file, when the script location is "Native". Up to 10 characters, valid OS/400 Object name, or one of the special values: *FIRST

Virtual Terminal'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.

Print Screen images

Choose which screen images are printed into the job's output. System default, No Yes, Input only, output only, Job PRTKEYFMT.

Spooled files handling

Specifies the name of the spooled file handling profile to be processed when the job ends.

Terminal attributes

Defines the Virtual terminal parameters.

Work station type

Defines the type of workstation to use. Select the Work Station type from a list of work station types. Default: *BASE

Keyboard language

Defines the keyboard language type for the virtual terminal. Specify 3 characters valid keyboard language type or *SYSVAL to use the default system value.

For more information about supported languages, see IBM iSeries globalization documentation.

Character set

Defines the graphic character set for the virtual terminal. Specify a valid character set number.

For more information about supported graphic character set, see the IBM iSeries globalization documentation

Values:

  • Any number between 1 and 32767
  • *SYSVAL: Use the graphic character set obtained from the QCHRID system value.
  • *KBDTYPE: Enables you to use the keyboard language type.

Code page

Defines the code page for the virtual terminal. Specifies a valid code page number.

For more information about code page, see the IBM iSeries globalization documentation

Values:

  • Any number between 1 and 32767
  • Default: *DFT - Use the Code page obtained from the QCHRID system value

Initiation information

Defines the initiation information for the VT terminal.

User profile

Defines the user profile that is used to log in to the terminal. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Password

Specify the log in password, use the owner's authentication repository or set to use the password program.

Device name

Name of display device. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Current library

The current library of the sign on process. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Program

Defines the sign in program name. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Menu

Defines the sign on menu. Up to 10 characters, valid OS/400 Object name, or one of the special values from the drop down list.

Bypass job

Enables the job not to run. The following message is generated:

Job was bypassed

Skip validity check for this job

Enables you to skip validity checks for all fields.

Parent Topic

OS/400 job Full parameters