GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-76
^SETPARAM
length input
is the length in bytes of the SCF object name to be set. If the task is converted,
the 16-word buffer must contain a name in external format. If the name is less
than 32 characters, the remaining buffer space must be filled with spaces.
If the task is unconverted, this parameter is not supplied. The length of the object
name is always assumed to be 24 bytes.
The following condition code settings are valid:
^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
INT:value (Use when the task is converted)
= CCE indicates that the operation was successful.
< CCL indicates that the object name cannot be changed, or the proposed name is
invalid. This code is returned if the task is converted and the length parameter is
not supplied, or is less than 1 or greater than 32. (If the task is unconverted, this
parameter is not supplied.)
> CCG does not return from this procedure.