Pathmaker Programming Guide

Defining a Custom Service
Creating Services and Servers
4–18 067868 Tandem Computers Incorporated
Defining a Custom
Service
A custom service can be defined by using either the Pathmaker full screen interface or
PMADL. The steps for creating a custom service using the Pathmaker full screen
interface are as follows:
1. Define and add a service to a Pathmaker project catalog by using the Service
Definition screen.
Using the first page of the screen, follow these steps:
a. Name and describe the service.
b. Specify a file name for the Custom Source File.
c. Designate a programming language (COBOL or C).
d. Specify whether this service is to be used to update files audited by TMF and
if NonStop SQL is to be used.
e. For C services only, use the second page of the Service Definition screen to
specify the names of the generated source file and the object file.
f. Add the service.
2. Specify the components of the IPC request message that this service expects to
receive and the components of the IPC reply message(s) that this service expects to
send back on the IPC Definition screen. (The components can be DDL definitions
or records or NonStop SQL table objects only.)
3. For services using Enscribe files, specify the logical file names, the related DDL
record names, and the open mode to be used for each file on the Logical Files
Entries screen.
4. For services using NonStop SQL tables, specify the host variable name you want
associated with each table and the SQL table object name from the SQL Table
Registration screen on the Logical Files Entries screen.
5. For COBOL85 services using NonStop SQL tables, specify information about
database access operations on single NonStop SQL tables or views on the SQL
Operations screen and the Operation Attributes screen. (This step is only
necessary if you want the product to generate SQL data manipulation language
statements for you.)
6. Use TEDIT to write code for the service and add it to a Custom Source File
(formerly called a Transaction Copy Library) that the Pathmaker product has
already created.
7. For services written in C, optionally generate and compile the service by using the
second page of the Service Definition screen.