DIGITAL TP Desktop Connector
for ACMS
Client Application Programming Guide

Chapter 5
5	Using Portable API Extensions for Microsoft Windows
5.1	Event-Driven Processing
5.2	Guidelines for Developing Windows Desktop Client Programs
5.3	AVERTZ Sample Desktop Client Program for Microsoft Windows
5.3.1	AVERTZ Components for Microsoft Windows
5.3.2	AVERTZ Component Processing Flow
5.4	Writing Client Procedures Using Nonblocking Services
5.4.1	Calling Nonblocking Services
5.4.2	Setting Up Polling
5.4.3	Establishing Session Context
5.4.4	Writing a Call to Other Nonblocking Services
5.4.5	Canceling Active Tasks
5.5	Writing Nonblocking Presentation Procedures
5.6	Writing Memory Allocation Routines
5.7	Building and Debugging Windows Desktop Client Programs
5.7.1	Building a Windows 95 or Windows NT Client Application
5.7.2	Maximum Lengths for Environmental Variables
5.8	Using TP Desktop Connector DLLs in Windows Version 3.1 Applications
5.8.1	Guidelines for Using DLLs
5.9	Debugging the Nonblocking Desktop Client Program with Tasks
5.9.1	Using a Debugger to Step Through the Microsoft Windows Sample Application
Chapter 6
6	Using Portable API Extensions for OSF/Motif
6.1	Event-Driven Processing
6.2	Guidelines for Developing X Windows Desktop Client Programs
6.3	AVERTZ Sample Desktop Client Program for X Windows
6.3.1	AVERTZ Components for X Windows
6.3.2	AVERTZ Component Processing Flow
6.4	Writing Client Procedures Using Nonblocking Services
6.4.1	Calling Nonblocking Services
6.4.2	Setting Up Polling
6.4.3	Establishing Session Context
6.4.4	Writing a Call to Other Nonblocking Services
6.5	Canceling Tasks
6.6	Writing Nonblocking Presentation Procedures
6.7	Special Handling of Workspaces for RISC Client Applications
6.8	Writing Memory Allocation Routines
6.9	Building and Debugging Motif Desktop Client Programs
6.9.1	Debugging the Nonblocking Desktop Client Program with Tasks
6.9.2	Using a Debugger to Step Through the Motif Sample Application
Chapter 7
7	Forced Nonblocking Extension to the Portable API
7.1	Benefits of Forced Nonblocking
7.2	Portable API Extensions for Forced Nonblocking
7.3	Forced Nonblocking Programming Considerations
7.3.1	Establishing a Forced Nonblocking Session
7.3.2	Canceling a Task from a Forced Nonblocking Session
7.3.3	Polling for Messages
7.3.4	Obtaining Completion Arguments
7.4	Forced Nonblocking Exchange Step Handling
7.4.1	Enable Exchange Arguments
7.4.2	TDMS Read Exchange Step Arguments
7.4.3	TDMS Write Exchange Step Arguments
7.4.4	Receiving Exchange Arguments
7.4.5	Requesting Exchange Step Arguments
7.4.6	Send Exchange Step Arguments
7.4.7	Transceive Exchange Step Arguments
7.5	Sending and Receiving Forms Records and Workspaces
7.5.1	Receiving Send Forms Records and Control Text
7.5.2	Sending Receive Forms Records and Control Text
7.5.3	Sending and Receiving TDMS Request Workspaces
7.6	Forced Nonblocking Flow of Control
7.6.1	Structures Declared in Client Application Memory
7.6.2	Differences Between Standard and Forced Nonblocking
7.7	Forced Nonblocking Sample Application
7.7.1	Starting the Forced Nonblocking Sample
7.7.2	The Main Form
7.7.3	Starting and Stopping Polling
7.7.4	Forced Nonblocking Sample Sign In
7.7.5	Calling the ACMS Task from Sample
7.7.6	Forced Nonblocking Exchange Steps
7.7.6.1	Forced Nonblocking Enable Exchange Step
7.7.6.2	Transceive, Send and, Receive Exchange Steps
7.7.7	Task Completion
7.7.8	Signing Out
7.7.9	Cancelling the Task
Chapter 8
8	Developing Macintosh Desktop Client Programs
8.1	Guidelines for Developing Macintosh Desktop Client Programs
8.1.1	Data Access Manager
8.1.2	Desktop Client Program Processing Flow
8.1.3	TP Desktop Connector Services for Macintosh
8.1.4	Restrictions
8.1.5	Data Conversion and Data Types
8.1.6	Routine for Data Conversion, _ByteSwap
8.1.7	Date Format Conversion Routines
8.1.7.1	MACToVMSTime
8.1.7.2	VMSToMACTime
8.1.8	Macintosh Data Type Conversion Package
8.1.8.1	Data Conversion Module Description
8.1.8.2	MacToVms Function Description
8.1.8.3	VmsToMac Function Description
8.1.8.4	Locating and Using the Data Type Conversion Module
8.1.9	Communication Tools Supported by TP Desktop Connector
8.1.10	Unidirectional Workspaces
8.1.11	Checking Software Versions
8.2	Implementing Macintosh Desktop Client Programs
8.2.1	Readying the Data Access Manager
8.2.2	Starting a Session
8.2.2.1	Sharing Sessions Across Client Programs and HyperCard Applications
8.2.2.2	Macintosh Handling of Password Expiring Messages
8.2.2.3	Starting a Session Following Program Termination
8.2.3	Calling a Task
8.2.3.1	Using Unidirectional Workspaces
8.2.4	Receiving Information from a Task
8.2.4.1	Checking for a Message
8.2.4.2	Receiving Task Results
8.2.5	Ending an Active Session
8.2.6	Getting Error Information
8.2.7	Canceling Active Tasks on the Macintosh System
8.2.8	Deleting Orphaned Sessions
8.3	Exchange Step Support and Other Advanced Features
8.3.1	DAM Constraints
8.3.2	Message Types
8.3.3	Keyword Acquisition
8.3.3.1	CALLTASK
8.3.3.2	Keywords that Identify Messages Sent from the Back End
8.3.3.3	Keyword Acquisition Using DBGetItem
8.3.4	Nonworkspace Data Items
8.3.4.1	Sending Nonworkspace Data
8.3.4.2	Alternate Method for Sending Nonworkspace Data
8.3.4.3	Acquiring Nonworkspace Data
8.3.5	Workspace Data
8.3.5.1	Sending Workspace Data
8.3.5.2	Acquiring Workspace Data
8.3.5.3	Workspaces in Request Messages
8.4	Building the Presentation Code
8.5	Debugging the Presentation Code
8.6	TP Desktop Connector Samples for Macintosh
8.6.1	C Language Sample
8.6.2	HyperCard Samples
8.6.2.1	HyperCard TP Desktop Connector Toolkit
8.6.2.2	4th Dimension Sample and External Functions
8.6.2.3	Sample XFCN Routines
8.6.3	AVERTZ Sample for Macintosh