CONTENTS Title Page Copyright Page Preface 1 Installing DECmessageQ for MS-DOS 1.1 Checking the Media Software Distribution Kit 1.2 Before You Begin 1.2.1 Release Notes 1.2.2 Preinstallation Tasks 1.2.3 Prerequisite Hardware 1.2.4 Prerequisite Software 1.3 The Installation Procedure 1.4 Error Recovery 1.5 Installing DECmessageQ Support for Microsoft Windows 2 Configuring DECmessageQ for MS-DOS 2.1 MS-DOS Configuration File 2.2 Using the DECmessageQ for MS-DOS Configuration Utility 2.3 Configuring Your Files with DMQWIN 2.3.1 Configuring Message Recovery Services 2.3.2 Saving your Configuration 2.4 Testing Your Files Using DMQWIN 2.5 Using the DECmessageQ Event Watcher 3 Using DECmessageQ for MS-DOS 3.1 Subset of DECmessageQ Communication Functions for MS-DOS 3.2 Subset of DECmessageQ Services for MS-DOS 3.3 Addressing 3.4 Include Files 3.5 Message Recovery Services 3.5.1 MRS Message Handling 3.5.2 Link Recovery Actions 3.5.3 Limitations 3.6 Building Images 3.6.1 Building MS-DOS Images 3.6.2 Building Microsoft Windows Images 3.7 Supported Calls 3.8 Unsupported Calls 3.9 MS-DOS Specific Calls 4 Troubleshooting 4.1 Link Failover 4.2 Return Codes A Files Provided in the DECmessageQ for MS-DOS Kit B Sample Installation of DECmessageQ for MS-DOS C DECmessageQ Configuration File Line Items D Files Needed to Run a DECmessageQ Application E DECmessageQ for MS-DOS Call Reference putil_print_status putil_status DmqWinInit EXAMPLES 3-1 Compiling and Linking a DECmessageQ for MS-DOS Application Using Microsoft C 3-2 Compiling and Linking a DECmessageQ for MS-DOS Application Using BORLAND C++ 3-3 Building a DECmessageQ for Microsoft Windows Application Using Microsoft C 3-4 Building a DECmessageQ for Microsoft Windows Application Using BORLAND C++ B-1 Sample INSTALL.BAT Procedure FIGURES 2-1 DECmessageQ Configuration File 2-2 Program Manager Window 2-3 DECmessageQ for Microsoft Windows Window 2-4 DECmessageQ for Microsoft Windows File Menu 2-5 Select DMQ Configuration File Window 2-6 Edit Menu 2-7 DMQ Network Link Configuration Window 2-8 DMQ MRS Configuration Window 2-9 DMQ Logging and Tracing Options Window 2-10 Save DMQ Config As... Window 2-11 Test Menu 2-12 Last Message Received Window 2-13 DMQ Send/Receive Parameters Window 2-14 Message to Send Window 2-15 Other Menu 2-16 DECmessageQ Return Status Window 2-17 DECmessageQ Event Watcher Window 2-18 Event Logging Available Window 2-19 Event Logging Available Window 3-1 DECmessageQ Address Specification 3-2 DECmessageQ Group Configuration Example TABLES 3-1 MS-DOS Equivalent C Include Files 3-2 DECmessageQ MRS Delivery Modes for MS-DOS 3-3 MRS Link Recovery Actions 3-4 Library Files 3-5 Supported Calls 3-6 DECmessageQ for MS-DOS Specific Calls 3-7 Microsoft Windows Specific Call 4-1 DECmessageQ for MS-DOS Specific Return Codes A-1 Files Included in the DECmessageQ for MS-DOS Kit C-1 Line Items in the DECmessageQ Configuration File D-1 Run-Time Files