Pathmaker Programming Guide

Registering Servers Not Created With Pathmaker
Creating Services and Servers
067868 Tandem Computers Incorporated 4–75
The steps for creating a registered service are as follows:
1. Define and add a registered service to a Pathmaker project catalog using the
Service Definition screen. On this screen, fill in the Service Name and TMF? fields,
enter REG in the Service Type field, and then press F1 to add the service.
2. Specify the components of the IPC request message and reply message for the
service using the IPC Definition screen. (This is a recommended, but not required,
step for Pathway requester/server applications.)
3. For services using Enscribe files, specify the COBOL logical file names, related
DDL record names, and the open mode to be used for each file using the Logical
File Entries screen. This information is used by the Pathmaker product for
creating Pathway configuration files for the registered server containing this
registered service.
4. For services using NonStop SQL tables, specify the host variable name associated
with each table on the Logical File Entries screen. This information is used by the
Pathmaker product for creating Pathway configuration files for the registered
server containing this registered service.
Defining a Registered
Server
After you have created all the registered services for one server not created with the
Pathmaker product, you should package those services together into one Pathmaker
registered server. Registered services cannot be combined with any other type of
Pathmaker service. The steps to create a Pathmaker server containing registered
services are as follows:
1. Define and add a registered server to a Pathmaker project catalog using the Server
Definition screen. On this screen fill in the Server Name (any name you choose)
and the Object File field (which must contain the actual name of the server object
file). It is also recommended that you fill in the description field. Then press F1 to
add the server.
2. Designate the registered services that are to be packaged into this server using the
Service Assignment screen. For a client/transaction server application, this step is
required. Although not required for a Pathway requester/server application,
completing this step provides valuable documentation about a registered server.
Writing Requester Code to
Access a Registered
Service
A server not created with the Pathmaker product can be invoked from a Pathway
requester created with the Pathmaker product whether or not the server has been
registered. To allow a requester to invoke a server not created with the Pathmaker
product, you should perform the following steps:
1. On the Function Key Assignments screen for the requester, specify USER in the
Action field of the function key that will invoke the server. Leave the
Requester/Service Name field blank. Update the screen.
2. In the Requester Copy Library for this requester, add code to invoke the server not
created with the Pathmaker product (SCREEN COBOL SEND) in the paragraph
associated with the function key specified in Step 1. You specify whether the
entire server will be performed or only a portion of the server will be used.