GDSX Manual

User Exit Descriptions
Extended General Device Support (GDSX) Manual–134303
9-6
PROCESS^USER^PARAMS
is a pointer to the first byte of the string that contains the user parameter name and
value specified by the USERPARAM command. Offsets within the string are as
follows:
Considerations
•
The USER^INIT^CONFIG^PARAMS, PROCESS^ASSIGNS,
PROCESS^USER^PARAMS, and USER^VERSION user exits are called very early
in the GDSX initialization process. Buffer pools and task and file management
structures have not been initialized. Consequently, within these exits TSCODE-
supported service procedures should not be called, except for the following:
•
During execution of PROCESS^USER^PARAMS, buffers may be allocated from
memory pools, but when this procedure is exited, the buffers are no longer available.
•
The TSCODE-supported FAULT procedure may not be called from this exit,
because the monitor task, which handles the EMS messages, does not exist when
this exit is executing.
Example
Suppose the following command is entered at a TACL prompt before GDSX is started:
> PARAM USERPARAMCODE4 44600HW
where the user parameter name is “CODE4” and its value is 44600HW. When TSCODE
scans the parameter string and finds “USERPARAM,” PROCESS^USER^PARAMS is
called. USCODE is passed the address of the string containing these characters:
14USERPARAMcode4744600HW
and can then process the parameter string.
For another example, see Appendix B for the USKELEX PROCESS^USER^PARAMS
procedure, which defines a table containing two user parameters, USERPARM1 and
USERPARM2.
Byte 0 parm-len , the length in bytes of the user
parameter name
Byte 1 for parm-len User parameter name, any character string
from 1 to 5 bytes long
Byte (parm-len+1) value-len, the length in bytes of the
value of the user parameter
Byte (parm-len +2) for
value-len
Value given to the user parameter name
BIT^MAP INIT[X]LIST
BIT^RESET INIT^SEM
BIT^SET ^SHUTDOWN
BIT^TEST ^TERMINATE