CONTENTS Title Page Copyright Page Preface Part I LU6.2 Services for VMS Software Installation 1 Preparing to Install LU6.2 Services for VMS 1.1 Prerequisite Software 1.2 License Registration 1.3 Required Privileges 1.4 VMSINSTAL Requirements 1.5 Backing Up Your System Disk 1.6 Creating and Starting Up a DECmessageQ COM Server 2 Installing LU6.2 Services for VMS 2.1 General Information 2.1.1 Accessing the Online Release Notes 2.1.2 Running the Installation Verification Procedure 2.1.3 Reinstalling LU6.2 Services for VMS 2.2 The Installation Procedure 2.3 Sample Installation Session 2.4 Error Recovery 3 After Installing LU6.2 Services for VMS 3.1 Adding the LU6.2 Startup Procedure to the Startup Database 3.2 Generating Symbolic Names for LU6.2 Message Types 3.3 Testing the Installation Part II LU6.2 Port Server Interface 4 LU6.2 Port Server Interface Description 4.1 What Is the LU6.2 Port Server? 4.2 LU6.2 and Advanced Program-to-Program Communications (APPC) 4.3 Application Protocols 4.3.1 Simplex Connections 4.3.2 Duplex Connections 4.3.3 Connection Termination 4.4 Inbound Sessions 4.4.1 Inbound Targets 4.4.1.1 Target Sync Level 4.4.1.2 Nontransparent Inbound Targets 4.4.1.3 Transparent Inbound Targets 4.4.2 Inbound Connections 4.5 Outbound Sessions 4.5.1 Outbound Targets 4.5.1.1 Transparent Outbound Targets 4.5.1.2 Permanent Outbound Targets 4.5.1.3 Target Registration 4.5.2 Outbound Connections 4.6 Connection Management 4.6.1 Sending Data 4.6.2 Changing Direction 4.6.3 Receiving Data 4.6.4 Terminating Connections 4.7 Limits of Operation 4.8 Port Server Messages 4.8.1 Messages Received from DECmessageQ Clients 4.8.2 Messages Sent to DECmessageQ Clients 4.8.3 Port Server Control Messages 4.8.4 Port Server Message Formats 4.8.4.1 REGISTER_TARGET Message 4.8.4.2 CONNECT_REQUEST Message 4.8.4.3 DATA_MESSAGE Message 4.8.4.4 CONNECTION_TERMINATED Message 4.8.4.5 CONNECT_ACCEPT Message 4.8.4.6 CONNECT_REJECT Message 4.8.4.7 CHANGE_DIRECTION Message 5 LU6.2 Port Server Configuration and Management 5.1 Configuring the Port Server 5.1.1 Building the LU_TABLE Configuration File 5.1.2 Building the TARGET_TABLE Configuration File 5.1.3 Instructions for Configuring Targets 5.1.3.1 Configuring Inbound Targets 5.1.3.2 Configuring Outbound Targets 5.2 Defining Logical Names 5.2.1 Logical Names for On-Disk Structure 5.2.2 Logical Names for Port Server Control 5.3 Starting Up and Managing the Port Server 5.3.1 DMQLU62_SERVER_STARTUP.COM Procedure 5.3.2 DMQLU62_SERVER_LOGICALS.COM Procedure 5.3.3 DMQLU62_EVENT_WATCH.EXE Utility 5.3.4 DMQLU62_SERVER_STOP.EXE Utility 6 LU6.2 Port Server Application Programming Interface (API) 6.1 Port Server API Description 6.2 Port Server API Procedure Call Reference Descriptions PORT_CONNECT PORT_RECV PORT_REGISTER PORT_SEND Part III LU6.2 User Callback Interface 7 LU6.2 User Callback Interface Description 7.1 What Is the LU6.2 User Callback? 7.2 Summary of General Use 7.2.1 Inbound Conversations 7.2.2 Outbound Conversations 7.3 User Callback Messages 7.3.1 Messages Sent to the User Callback 7.3.2 Messages Received from the User Callback 7.3.3 User Callback Message Header Description 7.3.4 User Callback Message Formats 7.3.4.1 LU62_DEFINE_LU Message 7.3.4.2 LU62_DEFINE_TP Message 7.3.4.3 LU62_DELETE_LU Message 7.3.4.4 LU62_ALLOCATE Message 7.3.4.5 LU62_ACTIVATE Message 7.3.4.6 LU62_CONNECTED Message 7.3.4.7 LU62_DEALLOCATE Message 7.3.4.8 LU62_ERROR Message 7.3.4.9 LU62_RECV_DATA Message 7.3.4.10 LU62_SEND_DATA Message 7.3.4.11 LU62_SEND_ERROR Message 7.4 Example User Callback Message Flow 7.5 Linking a User-Written Port Server 8 Error Handling 9 Logical Names 10 Notes on IMS Glossary EXAMPLES 2-1 LU6.2 Services for VMS Sample Installation Session 5-1 LU_TABLE Configuration File Format 5-2 TARGET_TABLE Configuration File Format TABLES 4-1 Port Server Operational Limits 4-2 DECmessageQ Client Messages to the Port Server 4-3 Port Server Messages to a DECmessageQ Client 4-4 Messages that Control the Port Server 4-5 REGISTER_TARGET Message Format 4-6 CONNECT_REQUEST Message Format 4-7 DATA_MESSAGE Message Format 4-8 CONNECTION_TERMINATED Message Format 4-9 CONNECT_ACCEPT Message Format 4-10 CONNECT_REJECT Message Format 4-11 CHANGE_DIRECTION Message Format 5-1 LU_TABLE Configuration File Data Items 5-2 TARGET_TABLE Configuration File Data Items 5-3 Data Items for Configuring Inbound Targets 5-4 Data Items for Configuring Outbound Targets 5-5 On-Disk Structure Logical Name Definitions 5-6 Port Server Control Logical Name Definitions 5-7 User Callback Logical Name Definitions 6-1 Port Server API Procedure Calls 7-1 DECmessageQ Client Messages to User Callback 7-2 User Callback Messages to a DECmessageQ Client 7-3 User Callback Message Header Format 7-4 LU62_DEFINE_LU Message Format 7-5 LU62_DEFINE_TP Message Format 7-6 LU62_DELETE_LU Message Format 7-7 LU62_ALLOCATE Message Format 7-8 LU62_ACTIVATE Message Format 7-9 LU62_CONNECTED Message Format 7-10 LU62_DEALLOCATE Message Format 7-11 LU62_ERROR Message Format 7-12 LU62_RECV_DATA Message Format 7-13 LU62_SEND_DATA Message Format 7-14 LU62_SEND_ERROR Message Format 7-15 DECmessageQ Client - User Callback Message Exchange 8-1 User Callback Error Codes 9-1 User Callback Logical Name Definitions