Pathmaker Programming Guide

Generating Custom Servers
Creating Services and Servers
4–70 067868 Tandem Computers Incorporated
Generating Custom
Servers
After you have defined a custom server, you can use the Pathmaker product to
generate source code for the server and compile the source code into object code. You
can generate a server as soon as you have defined it, but you must regenerate it every
time you make any change to it.
During application testing, you might want to define a single service for each server.
After your testing is complete, you might want to package several services into the
same server. The most efficient method of generation is to wait until you define all of
the services that this server will include and specify any parameters that services in
this server will pass to requesters before you generate.
You generate servers from the Server Definition screen by pressing shifted F6. If you
want to generate only source code and not compile that source code, you can change Y
to N on the Compile field of the Server Definition screen.
Server Generation Phases The Pathmaker product generates servers in two phases:
The first phase is completed before returning control to your terminal. In this
phase, the Pathmaker product reads all information in its project catalog about the
server and verifies that the information is valid for generation. For example, in
this phase, the Pathmaker product checks every item in the IPC definition list for
validity, ensuring that each item is either in the DDL dictionary, is a NonStop SQL
table, or is a Pathmaker pseudofield. The Pathmaker product then returns control
to the terminal and continues with phase two.
If the Pathmaker product encounters an error during phase one of server
generation, an error message describing the problem is displayed in the advisory
line of the Server Definition screen. The same message appears in the Last
Attempted Generation Message field the next time you list the Server Definition
screen.
In the second phase of server generation, the Pathmaker product generates the
programming language source code, compiles the server, and enters the results of
the generation (whether successful or unsuccessful) into the project catalog. For
NonStop SQL servers, the compilation stage includes compiling with the
programming language (COBOL or C) compiler and compiling with the
NonStop SQL compiler.
If the Pathmaker product encounters an error during phase two of server
generation, a general error message is displayed in the Last Attempted Generation
Message field of the Server Definition Screen. You must inspect the compiler
listing to find the specific errors encountered during this phase.