AM3270 Management Programming Manual

COMMANDS AND RESPONSES

STOP Command

The STOP command terminates the operation of the specified

object. You can stop a line or a subdevice, but not a

process. When the subsystem completes processing the command,

the specified object is placed in the STOPPED summary state.

When you are using the STOP command, the termination is done in

a more orderly fashion than the ABORT command. The subsystem

checks for subdevices currently open before terminating the

connection. If there are subdevices open or there is an AM3270

subdevice connected to a TR3271 subdevice, the subsystem rejects

the command and returns an error.

This command cannot be issued when the line is in the STARTED

summary state with subdevices open or connected, or when the line

is in the DIAG state.

When your management application issues the STOP command for a

line, the subsystem checks for the optional subordinate-modifier

token. If the value of the modifier is ZCOM-VAL-SUB-ONLY, the

subsystem stops only the subdevices attached to the specified

line. If the value of the modifier is ZCOM-VAL-SUB-ALL, the

subsystem stops the subdevices first, then the line. If the

value ZCOM-VAL-SUB-NONE is specified, the subsystem checks that

there are no subdevices open, and then stops the line.

Once the line is stopped, processing cannot continue until the

line is started again.

When your management application issues the STOP command for a

subdevice, the subsystem stops only the named subdevice. Your

management application can specify the SUB modifier with the

value ZCOM-VAL-SUB-NONE. This value causes the subsystem to stop

the named subdevice. The line must be in the STARTED state. If

the value ZCOM-VAL-SUB-ALL or ZCOM-VAL-SUB-ONLY is specified, the

AM3270 subsystem returns an error.

6-109