Pathmaker Programming Guide

Coding Custom Services
Creating Services and Servers
4–30 067868 Tandem Computers Incorporated
If reply->header.reply_code is equal to REPLY_LONG, the reply-with-data message is
returned to the requester. If reply->header.reply_code is equal to REPLY_SHORT, 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 reply->header.advisory_text. You can set reply->header.reply_size to
the actual size of the reply data if it is less than the total size of the reply message
elements.
The data portion of the IPC reply with data message is created by the Pathmaker
product using the list of reference objects you entered on the IPC Definition screen in
the reply portion of the screen.
If a reply-with-data is selected, the requester that invoked this service redisplays the
current screen, including the advisory line and all data fields, to show any updated
data fields returned in the message. If an advisory-only reply is selected, the requester
that invoked this service only redisplays the advisory line. In both cases, the requester
then loops to accept further input from the screen.
Note Be sure to explicitly set T9154-REPLY-FLAG or reply->header.reply_code to the value you want in your
service. The Pathmaker product initializes this flag to a value that is used to detect services that were not
completed.
If T9154-REQUEST-CODE or request->header.request_code contains an invalid value,
the service returns Invalid service code . If no value is moved to T9154-REPLY-
CODE or reply->header.reply_code, the service returns Service processing not
complete . If an invalid value is moved to the T9154-REPLY-CODE or
reply->header.reply_code field, an advisory reply is returned and Service Logic
Error is displayed.
The Pathmaker product sets T9154-REPLY-FLAG to T9154-RETURN-ADVISORY-
ONLY whenever a file operation ends in an error condition in a COBOL85 service.
The Pathmaker product interprets encountering an end-of-file as an error condition.
You should set T9154-REPLY-FLAG to T9154-RETURN-SERVICE-REPLY or
reply->header.reply_code to REPLY_LONG after reading a file if you want to return
data after reaching the end of the file.