Pathmaker Programming Guide

Coding Custom Services
Creating Services and Servers
4–52 067868 Tandem Computers Incorporated
Using DEFINE Names
The Pathmaker product uses the names you specify in the Define Name column to
create DEFINEs in the server code. The Pathmaker product also creates DEFINE
statements in the target application Pathway configuration file, PATHCNFG, with the
DEFINE names that you supply.
You can refer to these DEFINE names in your Custom Source File code; for example,
you might use a DEFINE name in a DECLARE CURSOR statement.
Creating Tabular Screens
Suppose you want to create a tabular screen with the following fields:
Order Delivery Customer
Number Date Name
_____ ___________ __________________________
_____ ___________ __________________________
_____ ___________ __________________________
_____ ___________ __________________________
_____ ___________ __________________________
_____ ___________ __________________________
Assume that in the NonStop SQL database you have two tables:
Table Name Column Name Screen Label
ORDERS ORDERNUM Order Number
DELIV_DATE Delivery Date
CUSTNUM
CUSTOMER CUSTNAME Customer Name
CUSTNUM
LOCATION
Because you are using columns from more than one table, you probably will find it
easiest to create an Enscribe DDL definition for this screen:
DEF orders-list.
02 orders-list-table OCCURS 6 TIMES.
03 ordernum PIC X(5)
HEADING "Order/Number".
03 deliv-date PIC X(11)
HEADING "Delivery/Date".
03 custname PIC X(26)
HEADING "Customer/Name".
END.
When you define IPC messages for services that operate on this screen, you can use
this DDL definition in the Reply Reference Object column of the IPC Definition screen.
The Pathmaker product generates both request and reply message declarations for the
server from this information.