Pathmaker Programming Guide

Generating the Mapping Requester
Finishing and Installing the Application
7–6 067868 Tandem Computers Incorporated
Generating the
Mapping Requester
When a requester invokes a service, SCREEN COBOL requires the SEND statement to
contain a server class name, or to contain a variable that can be resolved to a server
class name. The relationship between services and server classes for a Pathmaker
application is maintained in a special generated requester called the mapping
requester. The mapping requester contains a table that maps the service to its active
server class.
The mapping requester is used at run time to resolve the service name into a server
class name. You must generate a mapping requester for every Pathmaker application
you complete.
To generate the mapping requester, go to the Server Class Mapping screen and press
shifted F6, which generates a source code file and places code in the application’s
SCREEN COBOL object library files:
POBJCOD (Project OBJect CODe)
POBJDIR (Project OBJect DIRectory)
The mapping requester becomes part of the application requester library, although it is
not listed on the Requester Value List screen.
When you generate the mapping requester, the Pathmaker product places the source
code for the mapping requester on the project subvolume in a file named T9154MAP.
You should not modify the mapping requester source code file; however, remapping
services to server classes is easy, because you can regenerate the mapping requester,
thereby updating the application’s POBJ files every time you update the service to
server class mapping. If the application has been moved to the production
environment, you must use the SCREEN COBOL Utility Program (SCUP) to move the
application’s POBJ files to the production subvolume.
You must regenerate the mapping requester any time you change the active server
class of a service.
Note You can change the active server class of a service without directly updating the Server Class Mapping
screen. If the service is in one server and the server is in one server class, the Pathmaker product
assumes the service is active in that server class. If you change the server class for the server, deleting
the old server class, you must regenerate the mapping requester.