Pathmaker Programming Guide

Generating Custom Servers
Creating Services and Servers
067868 Tandem Computers Incorporated 4–71
If the Pathmaker product does not encounter any errors during generation or
compilation, the message Generation successful is displayed in the Last
Attempted Generation Message field the next time you list the Server Definition screen
even if there were warnings issued.
The server object is locked only at the beginning of server generation. You can use
Enform to check the status of your server generation. The Pathmaker Reference Manual
describes the Enform query, PM21—Pathmaker Server Generation Status—that
Tandem provides for this purpose.
C Server Generation The following additional guidelines apply to Pathmaker server generation for C
custom servers:
You might want to separately compile each of the C services in the server and
correct service errors before compiling a C custom server containing those
services. This approach might save you some time because a server compilation
reports only the first service containing errors.
To determine the cause of a server compilation error caused by a C service
contained in the server, display the second page of the Service Definition screen
for that service.
SQL compilation takes place only for servers, not for services. Consequently,
during the compilation of a C server, you might get SQL errors for a C service
whose separate compilation was successful.
During the generation of a C server that has been previously generated, a
temporary generated source file is created. If the contents of the temporary file
differ from the previous generated source file, the contents of the previous
generated source file are replaced with the contents of the temporary file.
If you are using a MAKE utility, set the Compile field on the Server Definition
screen and the appropriate Service Definition screens to N.
Files Used to Generate a
Server
The Pathmaker product collects information from the following files to generate a
server:
Project catalog
Server skeleton
Custom Source Files
Registered macro or other copy library files (optional)
The Pathmaker product uses information from each of these files to produce the server
source code file. If the Compile field on the Server Definition screen is Y , the
Pathmaker product will then go on to invoke the appropriate programming language
compiler to attempt to compile the source code into object code. If you are generating
a server that accesses NonStop SQL files, the Pathmaker product invokes the
appropriate programming language compiler and the NonStop SQL compiler.
Figure 4-13 illustrates the generation and compilation of a Pathmaker COBOL85
Server that will access a NonStop SQL database.