GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-75
^SETPARAM
^SETPARAM
This procedure is used to set and fetch various values such as the station characteristics
of network addresses. The operation can be performed in a nowait manner by use of the
nowait-tag parameter and in that case is completed by a call to AWAITIO[X].
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Considerations
•
Because the working stack images of tasks are swapped to and from an extended
data segment during I/O operations, I/O must be performed to and from global
buffers.
•
When calling ^SETPARAM in nowaited mode with PROCNOWAIT configuration
parameter set to 1, USCODE must call AWAITIOX to complete the I/O.
•
When calling ^SETPARAM in nowaited mode with PROCNOWAIT configuration
parameter set to 0, TSCODE calls AWAITIOX to complete the I/O.
^SHUTDOWN
This procedure stops the primary and backup GDSX processes after all outstanding task
I/Os from or to external openers have been completed and all external openers have been
closed or terminated. However, SCF is the exceptional case among external openers.
You can issue SCF commands against GDSX during and after the shutdown process.
Considerations
•
When ^SHUTDOWN is called, all active LINEs and SUs are queried to determine
whether they have external openers. If no external openers exist, then the primary
and backup GDSX processes are stopped and an EMS event message is generated
indicating that a shutdown occurred. The message is as follows:
STATUS *1002* GDS NORMAL SHUTDOWN
If there are external openers, the tasks are allowed to complete current I/Os from or
to the openers, and the tasks continue to exist until all external openers are closed, or
until SCF ABORT LINE and/or ABORT SU commands are issued. In the interim,
an EMS event message notifies you that a shutdown is in progress (pending) and
that the GDSX process will be stopped only after all external openers are closed or
terminated. The message is as follows:
STATUS *1006* GDS SHUTDOWN PENDING
During this interval all new open attempts against the GDSX process are rejected,
except those from SCF.
CALL ^SHUTDOWN