Pathmaker Programming Guide

Modifying Requesters
Advanced Pathmaker Programming Topics
9–2 067868 Tandem Computers Incorporated
You can edit the Environment Division and Working-Storage Section stored in the
T9154CPY file. There is one T9154CPY file associated with each Pathmaker
project. Changes to T9154CPY affect every requester generated for one Pathmaker
project.
You can copy and make minor edits to the requester skeleton stored on the same
subvolume as the object files for this version of the Pathmaker product. The
requester skeleton is written in the Pathmaker macro language.
Caution The requester skeleton is likely to change from one release of the Pathmaker product to the next. To
avoid maintenance problems for requesters generated using a modified requester skeleton, you should
surround all changes you make to the requester skeleton with comments that are easy to locate. You
must reapply any changes to the requester skeleton in later releases of the product. Tandem does not
assume responsibility for changes made to the skeleton.
Table 9-1 summarizes the contents of the files used to modify requesters and the types
of changes that can be made to the files. The rest of this subsection discusses each of
the files in detail, with examples of how they can be modified.
Table 9-1. Files Used to Modify Requesters
File Contents Comments
Requester Copy
Library
Section names for merging
SCREEN COBOL code with the
code generated by the requester
skeleton at specific places.
You can add custom code to any of these
sections. Most changes to a requester
should be made using this file.
User-Conversion
Procedures
TAL code for input or output
editing of a data field.
You must write and maintain the user-
conversion procedure. You can associate
the procedure with a specific data field on
the application screen from within the
Pathmaker product.
T9154CPY Sections of SCREEN COBOL
Working-Storage items and
Environment Division items that
are copied in when generating a
requester.
You can change some values. Changes to
T9154CPY affect every requester
generated for one Pathmaker project.
REQSKL Skeleton file used as a
framework for generating a
requester.
You can edit this file slightly if changes do
not affect the flow of logic in the skeleton.
Changes to the skeleton affect every
requester that is generated using the
modified skeleton.
REQDBSKL Sections of requester skeleton
code that only pertain to DB
requesters.
Changes to the skeleton affect every DB
requester that is generated using the
modified skeleton. If you change
REQDBSKL, you must change REQSKL to
invoke the modified version of REQDBSKL.