GDSX Manual

User Exit Descriptions
Extended General Device Support (GDSX) Manual–134303
9-9
USER^BACKUP
Considerations
•
The TSCODE-supported FAULT procedure should only be called from the
USER^ATTRIBUTES exit with its noretn parameter equal to 0. See the
description of “FAULT” on page 8-21.
•
USER^ATTRIBUTES is an integer function called only by TSCODE, never by
USCODE. USCODE returns function values to TSCODE with the TAL RETURN
statement. The permissible returned function values are described under the
status variable above.
•
This procedure is called from the monitor task.
•
Pseudo procedures may be called from this procedure.
Example
Here is an example of a STRUCT pointed to by the value in token-value:
STRUCT TOKEN^VALUE;
BEGIN
STRUCT Z^ACCESSNAME;
BEGIN
STRUCT Z^DISC;
BEGIN
STRUCT Z^VOLUME;
BEGIN STRING BYTE [0:7]; END;
STRUCT Z^SUBVOLUME;
BEGIN STRING BYTE [0:7]; END;
STRUCT Z^FILENAME;
BEGIN STRING BYTE [0:7]; END;
END;
END;
INT Z^EXT^SU^SIZE; ! NOT USER MODIFIABLE
INT Z^ASSOC;
INT Z^AUTOSTOP;
INT Z^NOWAIT^DEPTH;
INT Z^SUTYPE;
INT Z^USER^DATA[0:127];
END;
USER^BACKUP
USER^BACKUP allows you to checkpoint global data that is required for successful
takeover in the event of failure.
If GDSX is run as a process pair, at startup time the primary GDSX process checkpoints
the following to the backup process:
•
Config^params^template of configuration parameters
•
File control blocks
•
Task control blocks