STOP command: Stopping a Horizon or Model 204 SQL link or processgroup

From m204wiki
Jump to navigation Jump to search

Summary

Privileges
User 0, system administrator, system manager
Function
Stops a link or processgroup

Syntax

STOP {LINK | PROCESSGROUP} entityname

Where: entityname is the name specified on the DEFINE LINK or DEFINE PROCESSGROUP command.

Usage notes

The STOP command stops the specified link or processgroup.

Note: The STOP command does not apply to TPROCESS or Transfer Control links or processgroups.

If the STOP command is issued while there are no active users of the specified entity, the entity is completely stopped. Unlike the case with the CLOSE command, internal resources such as buffers and control blocks remain intact. When the TRANSPORT option of the DEFINE LINK command is SNA Communications Server, the SNA Communications Server ACB remains open.

If the STOP command is issued when there are active users of the specified entity, the entity is put in a drain state in which new users are prevented from using the entity. Active users are allowed to continue until their current conversations end.

The following results occur when the entities are in drain state:

  • STOP LINK makes each active session unavailable as soon as the conversation using it ends. This gradually reduces the number of available sessions until no sessions can be used by conversations.

  • STOP PROCESSGROUP resets to zero the RETAIN parameter so that, as each conversation ends, each session is unbound. This command affects only the operational processgroup and not the processgroup definition.

    The STOP PROCESSGROUP command unlocks the processgroup definition, allowing the DEFINE PROCESSGROUP command to be reissued even while the processgroup is in use. STOP PROCESSGROUP may be issued before the processgroup is in use for the first time, since there is no explicit OPEN command for a processgroup.

When the TRANSPORT option of the DEFINE LINK command is SNA Communications Server, the following conditions are true:

  • STOP LINK reduces, as each conversation ends, the specified number of available sessions.

  • STOP PROCESSGROUP resets to zero the RETAIN parameter so that, as each conversation ends, each session is released.

The STOP PROCESSGROUP command unlocks the processgroup definition, allowing a redefinition of the processgroup after its use. The STOP PROCESSGROUP command may be issued before the processgroup is used for the first time, as there is no explicit OPEN command for a processgroup.