INGVSTOP

Purpose

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

Syntax

Parameters

DETACH: Specifies that the VOST is to be stopped with the DETACH command.
FORCE: Specifies that the VOST is to be stopped with the STOP FORCE command.
TASK: Specifies that the VOST is to be stopped with the STOP TASK command.
IMMED: Specifies that the VOST is to be stopped with the STOP IMMED command.
UNCOND: Specifies that the VOST is to be stopped with the STOP UNCOND command.

Restrictions and Limitations

The INGVSTOP 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.

Note that the VOST may be still active for a certain time after INGVSTOP has ended with RC=0.

Return Codes

0: Stopping of the VOST was initiated successfully.
4: Invalid parameters were specified.
6: Environment check failed.
8: DETACH or STOP command failed.

Messages

The following messages are issued by INGVSTOP:

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

Usage

Use INGVSTOP as a stop command of a NONMVS type APL.

Consider using INGVSTRT as a start command and INGVMON as a monitor routine. (See INGVSTRT and INGVMON).

Note: It is not recommended to use STOP IMMED because the target task may lose storage or other resources.

You are strongly urged never to use STOP UNCOND because it destroys important task control information in NetView. You might not be able to restart NetView until the next IPL of MVS.

Examples

To stop a VOST using the DETACH command, enter the following as a stop command in the VOST management APL:

INGVSTOP DETACH