MUP NUMBER: DMQ32A_RT ----------- PRODUCT: DECmessageQ for UNIX -------- UPDATED PRODUCT: DECmessageQ for UNIX 3.2A ---------------- APPRX BLCK SIZE: 7000 ---------------- DIGITAL AV-PNABH-TK Read Before Installing DECmessageQ[TM] for UNIX[R], Version 3.2A DECmessageQ for UNIX, Version 3.2A includes the following key changes and enhancements: o Significant performance enhancements for recoverable messaging DECmessageQ for UNIX, Version 3.2A includes changes that sig- nificantly enhance messaging throughput for recoverable messag- ing. o Support for AT&T[R] UNIX Systems DECmessageQ for UNIX, runs on AT&T 3430 processors under System V UNIX Release 4. o Addition of the DECmessageQ UNIX Client The DECmessageQ for UNIX installation procedure now includes an option for installing the DECmessageQ UNIX Client. The DECmes- sageQ UNIX Client allows applications running in a UNIX en- vironment to send and receive messages to target applications in a networked environment using the DECmessageQ Client Li- brary Server software running on a DECmessageQ server system. The UNIX Client is designed to enable DECmessageQ messaging communications for UNIX applications without requiring the sys- tem resources needed by a DECmessageQ UNIX message server that supports full message routing. o New API Function for Returning Detailed Status DECmessageQ for UNIX contains a new API function called pams_ status_text, which returns a text description and severity level for a selected API return value. To use this new func- tion, you must recompile and relink your applications. For a complete description of the new and changed features con- tained in DECmessageQ for UNIX, Version 3.2A, refer to the DECmes- sageQ Release Notes for UNIX. Digital[TM] recommends that you read the release notes before installing DECmessageQ software. ©Digital Equipment Corporation. 1996. All Rights Reserved. Installation Prerequisites To install DECmessageQ for UNIX, Version 3.2A you must log in with superuser privilege to a system that meets the following minimum requirements: o Hardware: - AT&T 3430 processor running System V UNIX Release 4 - Digital Alpha processor running Digital UNIX - Hewlett-Packard[R] 9000-700/800 processor running HP-UX[R] - IBM[R] RS6000 processor running AIX[R] - Sun Microsystems[R] SPARC[TM] processor running SunOS[TM] or Solaris[R] o Software: - Digital UNIX, Version 3.0 or higher - Hewlett-Packard HP-UX, Version 9.05 or higher - IBM AIX, Version 3.2.4 or higher - Sun Microsystems SunOS, Version 4.1.1 or higher - Sun Microsystems Solaris, Version 2.1 or higher - System V UNIX Release 4, Version 3 or higher) o Disk space requirements Table 1 lists the approximate disk space requirements for in- stalling DECmessageQ software. To determine the disk space needed, add up the total kilobytes required for the subsets you plan to install. The total must be less than the free space on the disk where /usr/kits is located. 2 ___________________________________________________________________ Table_1:__Subset_Sizes_(in_Kilobytes)_on_UNIX_Systems______________ System Develop- Man Release Client /OS_________ment_____Runtime___Pages____Examples__Notes_____CLS____Library AT&T 3430/ 380 4275 88 774 311 479 894 NCR SVR4 Digital/Alpha 960 3636 88 537 311 332 1823 Digital UNIX HP9000- 251 2610 - 438 311 221 487 700/800/ HP-UX IBM 270 3550 143 557 311 328 786 RS6000/AIX Sun 194 5735 143 685 311 349 984 SPARC/ SunOS Sun 315 2766 143 558 311 300 618 SPARC/ Solaris____________________________________________________________ ___________________________________________________________________ Reading the Release Notes Before You Install DECmessageQ for UNIX Digital strongly recommends that you read the DECmessageQ product release notes before installing DECmessageQ. The release notes contain late-breaking information about the release that may be important for you to know before installing DECmessageQ. This section describes how to access the release notes files on Digital UNIX and other UNIX systems. Accessing the Release Notes on Digital UNIX Systems To read the release notes, verify that you have 250 kilobytes of free disk space for copying these files to the target system, and then follow these steps: 1. Log in to the system as superuser, set default to the root directory, and use the setld procedure to install DECmessageQ software using the following commands: # cd / # setld -l /dev/device_name where device_name is the name of the device from which you are installing the media kit. 3 2. Enter Y and press Return when the installation media is mounted and ready to install. Please make sure your installation tape is mounted and on-line. Are you ready (y/n)? y Positioning Tape The DECmessageQ for UNIX installation menu appears as follows: *** Enter Subset Selections *** The subsets listed below are optional: 1) DECmessageQ Development Environmen 2) DECmessageQ Run-Time Environment 3) DECmessageQ Client Library 4) DECmessageQ Client Library Server 5) DECmessageQ Manual Reference Pages 6) DECmessageQ Example Programs 7) DECmessageQ Release Notes 8) All of the Above 9) None of the Above 10) Exit without installing subsets 3. Enter the number of the release notes option and press Return to copy the release notes to a disk file. After copying the DECmessageQ release notes, you can view the ASCII text file or print out the ASCII text or PostScript[R] files using the following directory and file specifications: Digital UNIX Systems: ./usr/kits/DMA32A/release_notes/dmqnotes.ps ./usr/kits/DMA32A/release_notes/dmqnotes.txt Accessing the Release Notes on Other UNIX Systems To read the DECmessageQ release notes on non-Digital UNIX systems, you must copy all of the files from the distribution media to your target system. Refer to the Installation Prerequisites section to ensure that you have enough disk space to copy the files from the distribution media, and then follow these steps: 1. Log in to the system as superuser and set default to a direc- tory with enough disk space to copy the DECmessageQ installa- tion files: # cd /mnt/mydisk 4 2. Copy the installation script files from the distribution media using the tar utility as follows: # tar -xvf /dev/device_name where device_name is the name of the device from which you are installing the media kit. The system displays a list of files as they are installed. For example: x /etc/setld, 59955 bytes 118 tape blocks x output/space, 0 bytes, 0 tape blocks . . . x output/INSTCTRL, 30720 bytes, 60 tape blocks x output/DMQ.image, 88 bytes, 1 tape blocks 3. With the directory default set to the location where the DECmessageQ installation files are stored, use the setld com- mand to install DECmessageQ software as follows: # /etc/setld -l output The DECmessageQ for UNIX installation menu appears as follows: *** Enter Subset Selections *** The subsets listed below are optional: 1) DECmessageQ Development Environmen 2) DECmessageQ Run-Time Environment 3) DECmessageQ Client Library 4) DECmessageQ Client Library Server 5) DECmessageQ Manual Reference Pages 6) DECmessageQ Example Programs 7) DECmessageQ Release Notes 8) All of the Above 9) None of the Above 10) Exit without installing subsets 4. Enter the number of the release notes option and press Return to copy the release notes files to a disk file. After copying the DECmessageQ release notes, you can view the ASCII text file or print out the ASCII text or PostScript files using the following directory and file specifications: ./usr/kits/DMQ32A/release_notes/dmqnotes.ps ./usr/kits/DMQ32A/release_notes/dmqnotes.txt 5 DECmessageQ Feature Reference This section lists DECmessageQ features available on each sup- ported platform. ___________________________________________________________________ Servers Clients Windows OS/2[R], Windows MS-DOS[R], Feature___________UNIX______NT___OpenVMS__Windows___Macintosh[R]_ Network Support TCP/IP TCP/IP TCP/IP TCP/IP DECnet DECnet[TDECnet DECnet DECnet Current Version 3.2A 3.2 3.2A 3.0 2.0 ___________________________________________________________________ ________________________API_Function_Support_______________________ pams_attach_q X X X X X pams_cancel_get . . X . . pams_cancel_ X X X X . select pams_cancel_ X X X X . timer pams_confirm_ X X X X . msg pams_detach_q X X X X . pams_exit X X X X X pams_get_msg X X X X X pams_get_msga . . X . . pams_get_msgw X X X X X pams_locate_q X X X X . pams_put_msg X X X X X pams_set_select X X X X . pams_set_timer X X X X . pams_status_ X X X . . text putil_show_ X X X X . pending 6 ___________________________________________________________________ Servers Clients Windows OS/2[R], Windows MS-DOS[R], Feature___________UNIX______NT___OpenVMS__Windows___Macintosh[R]_ _________Supported_Queue_Types_and_Maximum_Queues_per_Group________ Primary queue X X X X X Secondary queue X X X X . Multireader X X X X . queue Non-FIFO queue X X X X . Response queue X X X X . Max queues per 999 999 999 999 1 group ___________________________________________________________________ __________Supported_Message_Routing_and_Delivery_Features__________ Full routing X X X X . (multihop) Client Library X X X . . Server End routing (0 . . . . X hop) Datagram X X X X X Max Message 32,000 32,000 32,000 32,000 32,000 Size ___________________________________________________________________ ____________________Support_for_Message_Recovery___________________ Store & forward X X X X X file Automatic X X X X . recovery Journal Replay X X . . . Journal Dump X X . . . MRS Sys Mgmt . . X . . Util pams_open_jrn . . X . . pams_read_jrn . . X . . pams_close_jrn . . X . . 7 ___________________________________________________________________ Servers Clients Windows OS/2[R], Windows MS-DOS[R], Feature___________UNIX______NT___OpenVMS__Windows___Macintosh[R]_ __________________Support_for_Message_Broadcasting_________________ Server . . X . . /Distributor Sender/Receiver X X X X X Ethernet multi- . . X . . cast ___________________________________________________________________ ___________________Support_for_Message_Simulation__________________ Capture X . X X X Simulation X . X . . Replay X . X . . Script Verify X . X . . ___________________________________________________________________ ________________Support_for_System_Management_Tools________________ GUI Config . X . X . Utility Monitor Utility X X X . . Management . . X . . Utility ___________________________________________________________________ ___________Support_for_DECmessageQ_Message-Based_Services__________ Link management . . X . . Queue avail- X X X . . ability (all queues) Queue notifica- . . X X . tion Cross-group X X X X . notification Manage MRS . . X . . files DQF transfer . . X . . Broadcast X X X X X registration 8 ___________________________________________________________________ Servers Clients Windows OS/2[R], Windows MS-DOS[R], Feature___________UNIX______NT___OpenVMS__Windows___Macintosh[R]_ _______Support_for_Developer_Tools_and_Programming_Languages_______ Test Utility X X X X . Visual Ba- . X . X . sic[TM] C/C++ X X X X X FORTRAN . . X . . Prelinked . X X X . libraries Ethernet_UCB________._______.________X_________._________._________ AIX, IBM, and OS/2 are registered trademarks of International Business Machines Corporation. AT&T is a registered trademark of American Telephone and Telegraph Company. DECmessageQ, DECnet, Digital, OpenVMS, VAX, and the DIGITAL logo are trademarks of Digital Equipment Corporation. Hewlett-Packard and HP-UX are registered trademarks of Hewlett- Packard Company. Macintosh is a registered trademark of Apple Computer, Inc. PostScript is a registered trademark of Adobe Systems Incorpo- rated. Solaris and Sun Microsystems are registered trademarks, and SunOS is a trademark of Sun Microsystems, Inc. SPARC is a registered trademark of Sparc International, Inc. Windows and MS-DOS are registered trademarks, and Windows NT and Visual Basic are trademarks of Microsoft Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. 9 Copyright Digital Equipment Corporation 1996. All Rights reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor.