Pathmaker Programming Guide

Adding, Modifying, or Deleting Services
Maintaining Pathmaker Applications
067868 Tandem Computers Incorporated 8–13
Adding, Modifying, or
Deleting Services
The Pathmaker product helps you add, modify, or delete services from an installed
application.
Tandem provides three standard Enform queries that report useful information about
services: query PM8, query PM9, and query PM17. Query PM8 lists requesters that
call services. Query PM9 lists services that are used by requesters. Query PM17 lists
DDL records and NonStop SQL tables referred to by services. The Pathmaker Reference
Manual contains detailed information about using Enform to produce these reports.
Adding New Services to
New Servers
Although you can add new custom services to existing servers in an application, there
might be times when you want to add a service and create a new server for it.
The following procedure requires that the requester that will invoke this new service
already exists. If you must add a requester that will invoke this service, refer to
“Adding Requesters” earlier in this section.
This procedure also requires that you have already created the DDL definitions,
records, or NonStop tables that will be used by the service. If you want to add a
record or definition, create a DDL source file and compile it as you would with any
new application. If you want to add a NonStop SQL table, create the table and register
it on the SQL Table Registration screen as you would with any new application.
The following procedure is one way to add a custom service:
1. Run the Pathmaker full screen interface. The Pathmaker Main Menu appears.
2. Define the service.
3. Design and code the service module.
Enter the COBOL or C source code for the service module in the Custom Source
File for this service. See Section 4 for more information about the required sections
and required variables in the Custom Source File.
4. Define the IPC messages.
5. If you are using Enscribe files, use the Logical File Entries screen to specify a
logical file name and access mode for any files used by this service.
If you are using NonStop SQL, use the Logical Files Entries screen to specify host
variable names.
6. Define and generate the server.
7. Assign the server to one or more server classes.
8. Assign the active server class (optional).
9. Regenerate the mapping requester.
10. Modify the requester that will invoke this service.
11. Regenerate the modified requester.
12. Move the SCREEN COBOL and server object code to the production subvolume.