Guardian Application Conversion Guide

Opening and Communicating With a High-PIN Server
Converting TAL Applications
3–34 096047 Tandem Computers Incorporated
Convert your requester to open the high-PIN server for its backup process using the
FILE_OPEN_CHKPT_ procedure. To identify the high-PIN server,
FILE_OPEN_CHKPT_ requires the file number returned by the FILE_OPEN_
procedure call in the primary process. The system returns a file-system error (if a file-
system error occurs) in the returned value error and the status of the backup open in
an output parameter, which is the backup^open^status parameter in this example:
error := FILE_OPEN_CHKPT_(server^file^number,
backup^open^status);
If you opened the server using the nowait open option, you must call the AWAITIO[X]
procedure to complete the open. To determine the error and
backup^open^status values, call the FILE_GETINFOLIST_ procedure and check
the items specified by ZSYS^VAL^FINF^LASTERROR and
ZSYS^VAL^FINF^LASTERRORDETAIL, respectively (provided you use the
ZSYSTAL file).
Sending a Request to a High-PIN Server
Your requester might send a request to a high-PIN server using the WRITE[X] or
WRITEREAD[X] procedure:
CALL WRITEREADX (server^file^number,
sbuffer,
write^count,
read^count,
count^read);
Your WRITE[X] or WRITEREAD[X] procedure call should not require any changes to
send a request to a high-PIN server.
Closing a High-PIN Server
Your requester might close the server using the CLOSE procedure:
CALL CLOSE (server^file^number);
You can close a high-PIN server using either the CLOSE or FILE_CLOSE_ procedure:
error := FILE_CLOSE_(server^file^number);
Closing a High-PIN Server for a Backup Requester Process
Your requester might close the server for the backup process using the CHECKCLOSE
procedure:
CALL CHECKCLOSE (server^file^number);
You can close the server for the backup process using either the CLOSE procedure or
the FILE_CLOSE_CHKPT_ procedure:
error := FILE_CLOSE_CHKPT_(server^file^number);