Pathmaker Programming Guide

Deciding Whether to Modify Files Used for Code Generation
Preparing for Pathmaker Application Development
067868 Tandem Computers Incorporated 2–19
Deciding Whether to
Modify Files Used for
Code Generation
There are several files included with the Pathmaker product that are used, in
conjunction with information in a Pathmaker catalog and with files supplied by
application developers, to generate source code for requesters, servers, C services, and
NonStop SQL data manipulation statements. For most applications, you do not need
to modify these files in any way; however, if you need to, you can make copies of the
files and modify the copies to change the way they generate code.
Some typical reasons for modifying the Pathmaker code generation files include:
Changing error messages to a language other than English
Changing attributes such as the requester TIMEOUT limit
Changing the internal structure for dates from the American standard
(MM/DD/YY) to the European standard (DD/MM/YY)
Changing the host variable declaration for C services
Modifying the C service skeleton to add global declarations
Modifying the macro supplied for SQL I/O operations
Before you decide whether to modify these files, you should create an application
using the files provided with the Pathmaker product. By examining the source code
produced, you can identify the portions of source code that you want to modify.
The next step is to make a copy of the file and examine it to identify the area you must
modify to produce the desired change in the source code produced. Most of the files
are written in the Pathmaker macro language. Any changes you make to these files
must be done using this language.
Modifying Files Used for
Requester Generation
There are several input files that the Pathmaker product uses when generating a
requester. These files have various scopes. For example, some of these files are global;
that is, they are used by every requester of a certain type (TRNS for instance) for every
Pathmaker project. Some of these files affect only requesters generated for a particular
Pathmaker project. Some files are used for only one particular requester. There are
two global files provided with the Pathmaker product that are used to generate
requester code. These are:
A skeleton file used to generate TRNS and DB requesters (REQSKL)
A skeleton file used to generate DB (database) requesters (REQDBSKL).
(REQDBSKL is invoked from REQSKL if the requester type is DB.)
Refer to Section 9, “Advanced Pathmaker Programming Topics,” for more information
about modifying these files and to the Pathmaker Reference Manual for macro language
syntax.
Another file included with the Pathmaker product that is used to generate requesters
is T9154CPY. This file contains sections that are copied into the Environment Division
and Working-Storage Section of requesters and contains attributes such as the
TIMEOUT limit, the TMF restart limit, and attributes for the advisory display line.