Pathmaker Programming Guide

Creating and Customizing a Pathmaker Project
Preparing for Pathmaker Application Development
067868 Tandem Computers Incorporated 2–23
Adding User-Supplied
Functions
The Pathmaker full screen interface supplies a function key on the Main Menu that
you can set up to provide application developers with direct access to other Tandem
processes from within the Pathmaker full screen interface.
To use a user-supplied function, you must write a requester and a server that function
outside of the Pathmaker product. The requester acts as an interface to the process or
processes that you want to be available from the Pathmaker full screen interface. The
server starts the processes requested by the requester. For example, you could write a
menu requester that allows Pathmaker users to start PS MAIL (6530) or run a test
application. A single server can be used to start either of these processes.
Any parameter passing between your requester and its companion server is handled
within your own programs; however, you must also:
Include a specific data structure in your requester that is passed between the
Pathmaker Main Menu and your requester.
Name your requester PM-USER-SUPPLIED.
Figure 2-1 shows the data structure that you must include in the Linkage Section of
your requester.
Figure 2-1. Linkage for User-Supplied Functions
01 USER-EXTRA-LINKAGE
02 U-PROJECT-NAME PIC X(30).
02 U-WORK-VOLUME PIC X(16).
02 U-TERMINAL-ID PIC X(24).
02 U-USERID-NAME.
03 GROUP-NAME PIC X(8).
03 USER-NAME PIC X(8).
02 U-ADVISORY-MSG.
03 SEVERITY PIC X.
88 NORMAL-ADVISORY Value is "N".
88 WARNING-ADVISORY Value is "W".
88 ERROR-ADVISORY Value is "E".
03 MSG-TEXT PIC X(70).
All fields in this data structure are maintained by the Pathmaker full screen interface
except U-ADVISORY-MSG. You must move the severity code and text that you want
the Pathmaker full screen interface to display to U-ADVISORY-MSG in your requester
before returning.
Use SCUP (the SCREEN COBOL Utility Program) to add the new requester to the
POBJ files in the Pathmaker object (release) subvolume for the project.
See the Tandem publication, Pathway SCREEN COBOL Reference Manual for more
information on using SCUP.