CONTENTS Title Page Copyright Page Preface Part I Using DECmessageQ LU6.2 Services 1 Introducing DECmessageQ LU6.2 Services DECmessageQ LU6.2 Services Basic Terms and Concepts What is DECmessageQ LU6.2 Services What is a SNA LU6.2 Session What is APPC DECmessageQ LU6.2 Services Application Components SNA APPC/LU6.2 Fundamentals Logical Unit Type 6.2 Overview Inbound and Outbound Conversations Using the LU6.2 Port Server for Applications Connections Writing Your Own Port Server 2 Developing Applications Using DECmessageQ LU6.2 Services Applications Development Overview Inbound Applications Outbound Applications Hybrid Applications Target Registration Structure of DECmessageQ LU6.2 Services Applications Simple Linear Conversations State Machines Overview of State/Event/Action Table Inbound State/Event/Action Listing Outbound State/Event/Action Listing Development Checklist Step 1: Define the Application Boundaries Step 2: Identify the Communicating Partners Step 3: Design the Application Conversations Step 4: Develop the Applications Step 5: Define the Communications Environment Step 6: Test the Applications Developing a Sample Application 3 Configuring the LU6.2 Port Server Port Server Functions Port Server Limits of Operation Configuring the Port Server Building the LU Configuration File Building the Target Configuration File Configuring Inbound and Outbound Connections Configuring Inbound Connections Configuring Outbound Connections Defining Logical Names Logical Names for On-Disk Structure Logical Names for Port Server Control Managing the LU6.2 Port Server Starting Port Servers Using DMQLU62_CONTROL to Manage Port Servers Using Character Cell Interface Using Windows Interface Watching Events Defining logical names with DMQLU62_SERVER_LOGICALS.COM Stopping LU6.2 Port Servers LU6.2 Port Server Messages Part II Reference Information 4 Port Server Messages Port Server Control Messages ADD_LU ADD_TARGET SHUTDOWN Using DECmessageQ Messages for Program Development CHANGE_DIRECTION CONNECT_ACCEPT CONNECT_REJECT CONNECT_REQUEST CONNECTION_TERMINATED DATA_MESSAGE REGISTER_TARGET Example of Port Server Messages Used for Client Communications 5 LU6.2 Port Server Application Programming Interface PORT_CONNECT PORT_RECV PORT_REGISTER PORT_SEND 6 LU6.2 User Callback Services LU6.2 User Callback Overview Using LU6.2 User Callback Interface Multithreading Services Inbound Conversations Outbound Conversations Example of User Callback Message Flow APPC User Callback Messages LU62_ACTIVATE LU62_ALLOCATE LU62_CONFIRMED LU62_CONFIRM_RECV LU62_CONFIRM_REQ LU62_CONFIRM_SEND LU62_CONNECTED LU62_DEALLOCATE LU62_DEALLOCATED LU62_DEFINE_LU LU62_DEFINE_TP LU62_DELETE_LU LU62_ERROR LU62_INIT LU62_OK_TO_SEND LU62_RECV_DATA LU62_REQ_CONFIRM LU62_REQ_TO_SEND LU62_SEND_CONFIRM LU62_SEND_DATA LU62_SEND_ERROR Part III Appendixes A Installing DECmessageQ LU6.2 Services Preparing to Install LU6.2 Services for OpenVMS Prerequisite Software Creating and Starting Up a DECmessageQ COM Server License Registration Required Privileges VMSINSTAL Requirements Backing Up Your System Disk Instructions for Installing LU6.2 Services General Information The Installation Procedure Step 1: Log in to a Privileged Account Step 2: Invoke VMSINSTAL Step 3: Select a Release Notes Option Step 4: Respond to the SNA-APPC-LU6.2 Licensing Prompt Step 5: Respond to the DMQ-LU6.2 Licensing Prompt Step 6: Respond to Purge Files and IVP Prompts Step 7: Specify the Location of the LU6.2 Directory Tree Step 8: Specify the Queue Number for the LU6.2 User Callback Step 9: Specify the queue number for the LU6.2 Port Server Step 10: Specify Whether to Add LU6.2 Message Structures Step 11: Specify Whether to Add LU6.2 Definitions to This Group Step 12: Read Informational Messages Step 13: End the Installation Procedure Error Recovery Postinstallation Tasks Adding the LU6.2 Startup Procedure to the Startup Database Generating Symbolic Names for LU6.2 Message Types Testing the Installation Step 1: Define a Logical Unit Step 2: Allocate a Conversation Step 3: Send Data Step 4. Request Confirmation and Go to Receive Step 5: Deallocate a Conversation. Reinstalling LU6.2 Services for OpenVMS Sample VAX Installation Session Sample Alpha Installation Session B Installed Files C LU6.2 User Callback Interface Logical Names and Error Codes User Callback Logical Names Linking a User-Written Port Server Error Handling D Notes on IMS E Sample DMQ$TYPCLS.TXT File F Examples of DECmessageQ LU6.2 Inbound and Outbound Applications Sample Inbound Application Sample Outbound Application G Examples of CICS Inbound and Outbound Applications Sample CICS Inbound Application Sample CICS Outbound Application