Pathmaker Programming Guide

Coding Custom Services
Creating Services and Servers
4–44 067868 Tandem Computers Incorporated
Guidelines for Custom
Source Files
The following points are guidelines for using a Custom Source File:
A Custom Source File with the required section headings must exist before a
successful generation of a server containing this service can be completed.
For COBOL85 services, the Procedure Division of a Custom Source File cannot
begin with a paragraph name; the Pathmaker product automatically creates a
paragraph name in the server for the first section of each service’s Procedure
Division named T9154-USER-CODE.
A Custom Source File can be shared by more than one service.
One Custom Source File file per service is recommended during application
development.
For COBOL85 services, all Working-Storage field names must be unique within a
service. Do not use names that begin with T9154-.
You can use Pathmaker macro language INVOKE statements within your Custom
Source File to include code you have written in a macro. The contents of an
invoked macro appear in the generated source file for the service.
You can use COPY statements within your Custom Source File to copy code from
your own copy libraries. The contents of a copied file do not appear until
compilation. You do not need to specify these copy library file names to the
Pathmaker product; however, creating registered macros to contain the copy
library code is preferable. See “Registered Macros” in Section 2 for information
about creating a registered macro.
For COBOL85 services, when you refer to IPC parameters in the Procedure
Division of your Custom Source File, you must qualify the IPC data item name by
either T9154-REQUEST or T9154-REPLY:
T9154-REQUEST For items that are in the IPC request message.
T9154-REPLY For items that are in the IPC reply message.
For example, assume you created a service named PLACE-ORDER and that you
included an item named QTY-ORDERED in the reply message when you defined
IPCs for this service. You want to return a value for QTY-ORDERED to the
requester. The COBOL85 statement in PLACE-ORDER would look like this:
MOVE TOTAL-QUANTITY TO QTY-ORDERED OF T9154-REPLY
For C services, when you refer to IPC parameters in your Custom Source File, you
must qualify the IPC data item name by either request-> or reply->.
request-> For items that are in the IPC request message.
reply-> For items that are in the IPC reply message.