Guardian Application Conversion Guide

Opening and Communicating With a High-PIN Server
Converting C Applications
5–18 096047 Tandem Computers Incorporated
Communicating With a
High-PIN Server
A requester can open and communicate with a high-PIN named server by opening the
server using the OPEN procedure. However, you must convert your requester to open
the server using the FILE_OPEN_ procedure if the server:
Is unnamed
Is on a remote D-series system and has a six-character name (a dollar sign and five
alphanumeric characters)
Figure 5-4 shows the processes involved in converting this part of a typical
application. The steps in this subsection apply to the requester process $REQ.
Figure 5-4. Converting a C Requester to Communicate With a High-PIN Server
$SRV
$REQ
C Requester
Process
Server
Process
TACL
This subsection discusses converting the following operations:
Opening and closing the high-PIN server
Opening and closing the high-PIN server for a backup process
Sending requests to the high-PIN server
Opening a High-PIN Server
Your requester might open the server using the OPEN procedure:
short server_name[12] = "$SRV ";
...
c_code = OPEN (server_name,
server_file_number,
nowait_depth,
sync_depth);
Convert your requester to open the high-PIN server using the FILE_OPEN_
procedure. The FILE_OPEN_ procedure requires a variable-length string for the
server file-name input parameter rather than the 12-word internal-format file name.