Pathmaker Programming Guide

Coding Custom Services
Creating Services and Servers
067868 Tandem Computers Incorporated 4–29
Custom Source File Required Variables
Five Pathmaker variables must be manipulated in the T9PR- service-name section of
your Custom Source File for a COBOL85 service and in the processing function for a C
service. These variables for a COBOL85 service are:
T9154-REPLY-FLAG
T9154-ADVISORY-MSG-TEXT
T9154-TMF-ABORT-FLAG
T9154-ADVISORY-MSG-SEVERITY
T9154-REASON-CODE
These variables for a C service are:
reply->header.reply_code
reply->header.advisory_text
reply->header.tmf_abort_flag
reply->header.advisory_severity
reply->header.reason_code
These Pathmaker variables are described in the following pages.
Note Comments about how to use the required variables are provided in each Custom Source File that the
Pathmaker product creates.
T9154-REPLY-FLAG or reply->header.reply_code. A custom service can return one of two
types of IPC reply messages to the requester. The first type of IPC reply message
contains a message and data, and the second type of IPC reply message is advisory
only and contains only a message.
This flag indicates whether you want a reply with data or an advisory reply returned
to the requester. For a COBOL85 service, set the value of T9154-REPLY-FLAG by
moving into it one of the following two values:
T9154-RETURN-SERVICE-REPLY
T9154-RETURN-ADVISORY-ONLY
T9154-RETURN-SERVICE-REPLY is a constant defined by Pathmaker equal to 1.
T9154-RETURN-ADVISORY-ONLY is a constant defined by Pathmaker equal to 999.
If T9154-REPLY-FLAG is equal to T9154-RETURN-SERVICE-REPLY, the reply-with-
data message is returned to the requester. If T9154-REPLY-FLAG is equal to T9154-
RETURN-ADVISORY-ONLY, the advisory-only message is returned to the requester.
An advisory message is always a part of the IPC reply. You must supply the text of
the message in T9154-ADVISORY-MSG-TEXT.
For a C service, set the value of reply->header.reply_code to one of the following two
values:
REPLY_LONG
REPLY_SHORT