SERVER

CA-GSS/ISERV Commands › GSS Extended Functions › SERVER

SERVER

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

Syntax

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

name: Name of a service.
imod: Name of the IMOD that provides the service.
desc: Description of the service (for display purposes only). Case is preserved.
CANCEL: Cancels the Server IMOD. Avoid this command, because 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. The queued requests are transferred to the new server.
DEFINE: Creates a service name and links it to the IMOD that provides the service. An optional description is 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 no longer is recognized as being related to the service.
DISPLAY: Returns information about all currently defined servers on the stack. The first character of each stack record serves as a delimiter character. The fields that are 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 more requests and does not process requests in the queue.
QUIESCE: Stops accepting more requests but continues processing the requests that are 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 returned information 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.

Example

---------------------- 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