Pathway/XM System Management Manual

PXMCOM Commands

Compaq NonStop™ Pathway/XM System Management Manual—426761-001

11-96

STOP SERVER

This command directs all link managers, such as LINKMON processes, TCP processes,

and LCS processes to return their links to a server class. The server class must be in the

FROZEN state before you issue this command.

server-class

specifies the name of a previously defined and added SERVER object.

GROUP group-name

specifies the name of a set of SERVER objects, each configured as a member of the

specified group. The STOP SERVER command is issued to each SERVER object

associated with this group.

issues the STOP SERVER command to all SERVER objects in a given

Pathway/XM environment that are in the FROZEN state. The PATHMON process

does not report on the servers that it cannot stop.

Considerations

•

A STOP SERVER command completes with a REQUEST PENDING message

when all link managers have not yet returned their links to a stopped or abended

server, or when a server that no longer has links to a link manager has not stopped.

•

A server should be programmed to stop itself (by calling the Guardian STOP

procedure) after receiving a CLOSE message from a link manager. The PATHMON

process calls the STOP procedure for servers that are running, are not associative,

and have never been linked.

Examples

The following command stops the named server class named CLASS-2 (if that class is

in the FROZEN state):

STOP SERVER CLASS-2

The following command stops all the frozen server classes in the group SALES:

STOP SERVER GROUP SALES

STOP SERVER { server-class }

{ GROUP group-name }

{ * }