DIGITAL TP Desktop Connector
for ACMS
Client Application Programming Guide

Appendix A
Appendix A	Sample Application Code
Appendix B
Appendix B	Tools
Index
Index
Examples
2-1	NO I/O Task Actions for TP Desktop Connector Users
2-2	I/O Task Actions for TP Desktop Connector Users
3-1	Desktop-Only I/O Task and Task Group Definitions
4-1	Compression Call Option Type
4-2	Portable API Task Call Passing Four Workspaces
4-3	Record Layout
4-4	AVERTZ Reserve Task Exchange Steps
4-5	Signing In the User
4-6	Login Program
4-7	Passing Three Workspaces
4-8	Passing Unidirectional Workspaces
4-9	TRANSCEIVE Presentation Procedure
4-10	GETSITE Application-Specific Presentation Procedure
4-11	Linking to the DOS TP Desktop Connector Client Services
5-1	Nonblocking Service Call and Completion Routine
5-2	Setting Up Polling
5-3	AVERTZ Session Context
5-4	Context Passed to Desktop Client Program
5-5	Call Context Returned with Presentation Procedure
5-6	Session Context Handling for the User Interface
5-7	Nonblocking Presentation Procedure Pseudocode
5-8	Presentation Procedure Completion Pseudocode
5-9	Sample Windows Makefile
5-10	Passing the Function Handle
5-11	Registering Function Pointers
6-1	Nonblocking Service Call and Completion Routine
6-2	Setting Up Polling Using a Timer Event
6-3	AVERTZ Session Context
6-4	Context Passed to Desktop Client Program
6-5	Call Context Returned with Presentation Procedure
6-6	Session Context Handling for the User Interface
6-7	Nonblocking Presentation Procedure Pseudocode
6-8	Presentation Procedure Completion Pseudocode
6-9	OpenVMS to RISC Structure Byte Copy
6-10	RISC to OpenVMS Structure Byte Copy
7-1	Visual Basic Sample
7-2	ACMSDI_TDMS_READ_EXCH Sample
7-3	ACMSDI_TDMS_WRITE_EXCH Sample
7-4	ACMSDI_RECV_EXCH Sample
7-5	ACMSDI_REQUEST_EXCH Sample
7-6	ACMSDI_SEND_EXCH Sample
7-7	ACMSDI_TRCV_EXCH Sample
7-8	Sending Forms Records
7-9	Receiving Forms
7-10	TDMS Sample
7-11	Creation of a Call Identifier
8-1	Initializing the Data Access Manager
8-2	Calling ACMSInitPack
8-3	Calling DBInit
8-4	Calling ACMSLogon
8-5	Calling DBSend and DBExec
8-6	Calling ACMSSendItem, ACMSSendWorkspace, and ACMSExec
8-7	Unidirectional Workspaces with HyperCard XFCNs
8-8	Handling DBState Status on Task Completion
8-9	Calling ACMSState
8-10	Calling DBGetItem
8-11	Calling ACMSGetWorkspace
8-12	Calling DBEnd
8-13	Calling ACMSEnd
8-14	Calling DBGetErr
8-15	Calling ACMSGetErr
8-16	Acquiring a Keyword with DBGetItem
8-17	Alternate Method for Sending Nonworkspace items
8-18	Acquiring Nonworkspace Data Using a Header Record
8-19	Setting Currency on a Workspace
8-20	Linking the Macintosh Desktop Client Program
8-21	VR_RESERVE_RES_DETAILS_TASK Definition
Figures
1-1	TP Desktop Components
1-2	TP Desktop Configuration
1-3	TP Desktop-Oriented Components
1-4	Desktop Client Program Processing Phases
2-1	Using a Queued Task with TP Desktop Connector
2-2	Application Node Failover Configuration
2-3	Submitter Node Failover Configuration
3-1	Task Debugger Session
4-1	Processing of Presentation Procedures
4-2	CDD Directory Structure
4-3	Version-Checking Processing
4-4	TP Desktop Connector Sample Components
4-5	Processing Flow for DOS Sample Desktop Client Program
4-6	Sample Presentation Procedures
5-1	Event-Driven Desktop Client Program Processing
5-2	TP Desktop Connector Sample Components for Microsoft Windows
6-1	Event-Driven Desktop Client Program Processing
6-2	TP Desktop Connector Sample Components for X Windows
6-3	User Selects a Task
6-4	Nonblocking Service
6-5	I/O Processing for a Nonblocking Service / Part 1
6-6	I/O Processing for a Nonblocking Service / Part 2
8-1	Data Access Manager and ACMS System Interaction
8-2	Using the DECnet Tool on Macintosh
8-3	Using the AppleTalk-DECnet Tool on Macintosh
8-4	Nonworkspace Data
8-5	HyperCard Desktop Client Program
Tables
1-1	Transports for OpenVMS VAX Systems
1-2	Transports for OpenVMS Alpha Systems
2-1	Design Issues
3-1	Gateway Communication Keywords
4-1	Language and Oracle CDD Data-Type Equivalents
4-2	Status Codes Returned Due to Serialization Violations
4-3	Portable API Access Types
5-1	Debugging Tools for Windows Clients
5-2	Maximum Lengths for Environmental Variables
7-1	Values Returned from acmsdi_poll
7-2	Forced Nonblocking Sample Files
8-1	Macintosh and Oracle CDD Data Types
8-2	MacToVms Data Types
8-3	VmsToMac Data Types
8-4	DBState Success Statuses
8-5	DBGetErr Information
8-6	Desktop Constrained Transmissions
8-7	Message Types
8-8	Keywords
8-9	Messages Sent to the Back End
8-10	Messages Received from the Back End
8-11	Desktop Application Roles
1	A TP Desktop Connector API Directories
2	A DIGITAL TP Desktop Connector Directories
1	B Development Tools and Files
2	B Runtime Tools
3	B General Samples