Pathmaker Programming Guide

Adding, Modifying, or Deleting Requesters
Maintaining Pathmaker Applications
8–10 067868 Tandem Computers Incorporated
You must alter the Pathway configuration file, PATHSVRS, when you add a DB
requester. Rename your PATHSVRS file and either rename or purge the other
application generated installation files. Then exit from the Pathmaker full screen
interface and regenerate PATHSVRS. See Step 10 under “Packaging Services into
New Servers” earlier in this section for more detailed information about
regenerating PATHSVRS.
Applications that use DB requesters have one of two servers for all the DB requesters
in the application: the standard server for Enscribe files (DBSERVER) and the standard
server for NonStop SQL tables (SQLGS).
DBSERVER can have two server classes. If any of the files associated with a DB
requester is audited, the Pathmaker product creates a server class that runs with TMF
auditing turned on; this server class is named TMF-DB-SERV-nnn. If any of the files
associated with a DB requester is nonaudited, the Pathmaker product creates a server
class that runs with TMF auditing turned off; this server class is named
DB-SERVER-nnn. You indicate that a file should be audited by using the AUDIT
clause in the DDL record declaration for the file. If you mix audited files and
nonaudited files in a single DB requester, the Pathmaker product creates both server
classes for DBSERVER.
When you add a DB requester to the application, the server class configuration for
DBSERVER or SQLGS in PATHSVRS must be altered to add a file assignment for the
file or files associated with the new DB requester. Model your new ASSIGN or
DEFINE on the entries that were previously generated by the Pathmaker product. If
the file is audited, add the file to the TMF-DB-SERV-nnn server class. If the file is
nonaudited, add the file to the DB-SERVER-nnn server class.
The standard server for NonStop SQL tables has one server class: SQL-SERVER-nnn.
You should always add SQL tables to the SQL-SERVER-nnn server class.
In addition, you might need to increase the values of a subset of the Pathway and TCP
parameters in the PATHCNFG file and PATHTCPS file. The Pathway System
Management Guide fully describes these parameters and commands for altering them.
Adding REG Requesters
You can add REG requesters to an installed application as well as to an application still
in the testing environment. REG requesters are written and compiled outside of the
Pathmaker environment; therefore, you only need to complete the Requester
Definition screen to add the requester. The Pathmaker product does not generate REG
requesters; REG requesters are coded and compiled entirely outside of this Pathmaker
project. However, if you plan to call the REG requester from an existing Pathmaker
requester, you must modify and regenerate the existing Pathmaker requester.
If you regenerate any of the existing requesters and if the application is installed in a
production environment, you must use SCUP to move the SCREEN COBOL code to
the application’s SCREEN COBOL object library files (POBJCOD, POBJDIR, and
POBJSYM).