INGVSTRT

Purpose

The INGVSTRT command allows an automation procedure to start a virtual operator station task (VOST).

Parameters

mode

This is a positional parameter that defines the mode that command operates in. It is required only if command starts with SYNC or ASYNC. It clarifies whether command operates synchronously (the default) or asynchronously (it terminates but leaves the VOST active).

It has the following values, which must be followed by a comma:

SYNC

Use SYNC as a positional parameter if command operates synchronously. This is the default.

ASYNC

Use ASYNC if command operates asynchronously, that is, it terminates and leaves the VOST active. This prevents message ING156I from being issued.

command

The command, including all parameters, to be executed in the VOST. This can be mixed-case and can also be a REXX CLIST.

Restrictions and Limitations

The INGVSTRT command can be called only by another automation procedure or by a command processor. The AOCQRY command must be invoked first to set the necessary task global variables. In particular, the SUBSJOB variable must be set. Its content is used as the attach name of the VOST.

The ATTACH command is used to start the VOST and therefore the restrictions of the attach command also apply to the command that is specified with INGVSTRT.

Return Codes

0

VOST started successfully.

4

Invalid parameters were specified.

6

Environment check failed.

8

ATTACH command failed.

Messages

AOF010I WRONG NUMBER OF PARAMETERS ENTERED
ING151I ATTACH OF name SUCCESSFUL
ING152I ATTACH OF name FAILED WITH RC=rc
ING155I ENVIRONMENT CHECK FAILED FOR command. REASON=rs

Usage

Use INGVSTRT as the start command for an APL of type NONMVS.

Consider using INGVSTOP as a stop command and INGVMON as a monitor routine. (See INGVSTOP and INGVMON).