Pathmaker Programming Guide

Modifying Requester/Server Pairs
Advanced Pathmaker Programming Topics
067868 Tandem Computers Incorporated 9–59
If you need to know the cursor position before sending a request to the service, or if
you have used an OCCURS clause to list multiple instances of a single data item, you
can use the Pathmaker paragraph 0900-BUILD-CURSOR-POSITION.
You can also use @CURSOR-POSITION with a point field to detect the cursor position
by a list of protected fields.
@LOGICAL-TERMINAL. The @LOGICAL-TERMINAL pseudofield contains the logical
terminal name.
You can use @LOGICAL-TERMINAL to display the Pathway terminal name on the
application screen. If you are running the application in a development environment
and are using the RUN PROGRAM feature rather than a dedicated terminal, the
Pathway terminal name can be a different name every time you run the application.
Knowing the Pathway terminal name is useful when you are debugging an
application.
@PHYSICAL-TERMINAL. The @PHYSICAL-TERMINAL pseudofield contains the
physical terminal name. You cannot display the physical terminal name, but you can
send it to a service.
You could use @PHYSICAL-TERMINAL for:
Handling security if terminals in certain locations cannot have access to certain
screens
Error reporting
Tracking changes by recording who made the change
Using Reason Codes
(T9154-REASON-CODE)
You can use the T9154-REASON-CODE variable to return additional error information
or other information to the requester from the service.
Suppose that you created a requester that accesses both a customer information table
and an order information table. To update this requester, you need to supply both a
customer ID number and an order ID number. Suppose that, if either of the ID
numbers are invalid, you want to return an advisory reply; you need to know which
ID number was invalid so that you can place the cursor in the data entry field for the
end user.
You could use T9154-REASON-CODE to return this information to the requester and a
post-function key section in the requester copy library to place the cursor in the
appropriate data entry field.