OSI/MHS SCF Reference Manual

OSI/MHS SCF Commands

OSI /MHS SCF Reference Manual—424828-001

2-202

STOP GROUP Command

The STOP GROUP command terminates the activity of the GROUP object. Upon

successful completion of the STOP command, configured objects are left in the

STOPPED state and process objects are deleted. This is a sensitive command.

OUT file-spec

directs any SCF output generated for this command to the specified file.

[\psystem.]$proc.#class.[\gsystem.]group

is the name of the GROUP object you want to stop.

SEL [ NOT ] state

directs the command only at objects in the specified state or not in the specified

state. Valid values for state are: DEFINED, STARTING, STARTED,

STOPPING, STOPPED, and SUSPENDED. States are described in Section 1,

Introduction.

FORCED | MAX

are power modifiers you can specify with the STOP GROUP command.

The FORCED power modifier specifies that when you issue the STOP GROUP

command, the processes within the specified group stop themselves after safestoring

their message queues on disk. The current messages are not finished until the

relevant object is restarted. FORCED is the default value and should be used in

most cases.

The MAX power modifier specifies that the manager process stops all processes

within the specified group. MAX should be used only if FORCED fails to work.

Considerations

For an MS group, FORCED causes the MS group to delete redundant PDUs from its

PDU stores. These are PDUs containing incomplete MS operations that result from

process failures. Typically, there are few such PDUs. If MAX is specified for an MS

group, the deletion of redundant PDUs is not performed.

Example

This command terminates the activity of GROUP object $ZMHS.#MS.MSGRP1:

STOP GROUP $ZMHS.#MS.MSGRP1, FORCED

STOP [ / OUT file-spec / ]

GROUP [\psystem.]$proc.#class.[\gsystem.]group

[ , SEL [ NOT ] state ] [ , { FORCED | MAX } ]