Return Status Values Expected From Presentation Procedures - Compaq TP Desktop Connector AA–PVNFG–TE Client Services Reference Manual

Tp desktop connector for acms
Table of Contents

Advertisement

Table 3–1 (Cont.) Summary of Portable API Presentation Procedures
Customer-Supplied Procedure
acmsdi_request
acmsdi_send
acmsdi_transceive
acmsdi_write_msg
See Compaq TP Desktop Connector for ACMS Client Application
Programming Guide for a description of sample client presentation procedures.

3.1.1 Return Status Values Expected from Presentation Procedures

The presentation procedure routines must return a long integer containing any
valid OpenVMS status value, including DECforms, TDMS, and application-
defined values. Return status values for nonblocking presentation procedures
are returned using the acmsdi_complete_pp routine. The status value is passed
to the ACMS Application Execution Controller (EXC) as the completion status
for the exchange step. The EXC attempts to interpret the value as a standard
OpenVMS status value. Unless the task definition for the exchange step
specifies CONTINUE ON FAILURE, the EXC cancels the task for an error
status returned.
The TP Desktop Connector kit provides include files that specify the return
status values for DECforms and TDMS: FORMS.H and TDMS.H. If the
return status values change, you can regenerate the include files with the
command procedures, MAKE_FORMS_H.COM and MAKE_TDMS_H.COM, in
the ACMSDI$EXAMPLES directory.
To handle errors, specify the exception-handler syntax in the task definition.
To have a single ACMS application support both DECforms terminals and
graphical desktop systems, code the task definition to check for a DECforms
error status value.
3–2 Portable API Presentation Procedures
Description
Services a TDMS Request exchange, which displays
a form and transfers data between a form and the
application program.
Services a DECforms send request, which sends
data from the application program to the form.
Services a DECforms transceive request, which
combines the actions of a send and a receive.
Services a TDMS Write exchange, which displays
the text sent from the form's message field or the
ACMS task.

Advertisement

Table of Contents
loading

Table of Contents