CA-GSS/ISERV Commands › CA-GSS/ISERVE Operator Commands › SERVER

Previous Topic: SCHEDULE

Next Topic: SET EDITOR

SERVER

Use the SERVER command to control the Server IMOD Facility. This facility is described in detail in the CA‑GSS for z/OS IMOD Guide.

Syntax

Use this format for the SERVER command.

SERVER {CANCEL name}
       {CYCLE name}
       {DEFINE name imod desc}
       {DELETE name}
       {DISPLAY}
       {HOLD name}
       {PAUSE name}
       {QUIESCE name}
       {RESET name}
       {RESUME name}
       {START name}
       {STATUS name}
       {STOP name}
       {TERMINATE name}

Parameters

The SERVER command takes these parameters.

name

Name of a service.

imod

Name of the IMOD that will provide the service.

desc

Description of the service (for display purposes only). Case is preserved.

CANCEL

Cancels the Server IMOD. This command should be avoided since the current request (and all queued requests) is abandoned and the requesting IMODs are not notified.

CYCLE

Cancels the current Server IMOD and starts a new server. Queued requests are transferred to the new server.

DEFINE

Creates a new service name and links it to the IMOD that will provide the service. An optional description will be displayed during later informational commands.

DELETE

Deletes an existing service. The currently executing service IMOD task, if any, is not terminated or disturbed in any way. However, it will no longer be recognized as being related to the service.

DISPLAY

Returns information on all currently defined servers on the stack. The first character of each stack record serves as a delimiter character. The fields returned are (in order): Service, IMOD name, IMOD task ID (if running), and Description.

HOLD

Continues to queue requests without processing requests in the queue.

PAUSE

Stops accepting additional requests and does not process requests already in the queue.

QUIESCE

Stops accepting additional requests but continues processing those that are already queued.

RESET

Deletes all unprocessed requests. No processing is performed and the requestors are not notified.

RESUME

Cancels the effects of any outstanding HOLD, PAUSE, or QUIESCE.

START

Starts the named service. Any specified options are passed to the Server IMOD in the argument string, following the service name.

STATUS

Returns the status of a particular server IMOD on the stack. The information returned is formatted for display purposes.

STOP

Performs a QUIESCE operation and then a TERMINATE operation when all queued requests have been completed.

TERMINATE

Terminates processing immediately. Any unprocessed requests are ignored.

Examples

---------------------- CA‑GSS/ISERVE Control Panel ---------    ROW 1 TO 1 OF 1
==> server define stepsum stepsum CA‑SYSVIEW Stepsum Server            => PAGE
Target node: *                ssid: *    Host node: B1EWF               ssid EWF
================================================================================
Success