DIGITAL Software Product Description ________________________________________________________________ PRODUCT NAME: DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DESCRIPTION DECmessageQ for UNIX is the UNIX Operating System implementation of a generic software message queuing bus that provides easy-to-use, efficient task-to-task communications among processes using DECmessageQ on OpenVMS, Digital UNIX[R], HP-UX[TM], AIX[R], MS[R]-Windows[TM], Windows NT[R], Macintosh[R], Solaris[R] and SunOS[TM], NCR UNIX [TM]. A common call interface allows messages to be delivered via local interprocess communications for intra-CPU applications, or via Transmission Control Protocol/Internet Protocol (TCP/IP) and DECnet Digital UNIX, Windows NT and MS-Windows) for inter-CPU applications. Applications can be designed so client applications can be redeployed easily any- where within the DECmessageQ network configuration, whether in a stan- dalone node, a local area network (LAN), or a wide area network (WAN). The DECmessageQ communications implementation is designed for ease- of-use, expandability, and efficiency. Its features include: o High speed local message delivery using local interprocess com- munications o Remote message delivery via TCP/IP or DECnet for OpenVMS, Digital UNIX, Windows NT, and MS-Windows. o Remote message delivery via TCP/IP for HP-UX, SunOS, Solaris, AIX, OS/2 and NCR UNIX . o Fully asynchronous and synchronous receipt of messages o Message sizes up to 32,000 bytes o Priority queuing of messages o Selective reception of messages by queue number or priority o Shared input queues using Multi-Reader Queues (MRQ) o Use of intra-CPU naming through a local naming service March 1996 AE-PNACG-TK DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 o Set of message delivery options o DECmessageQ Runtime UNIX Server implementations for Digital UNIX , HP-UX, AIX, SunOS, Solaris and NCR UNIX o Small footprint DECmessageQ Runtime UNIX Client implementations for Digital UNIX , HP-UX, SunOS, Solaris, AIX and NCR UNIX o A maximum of 999 queues per DECmessageQ Group o A maximum of 32,000 DECmessageQ Groups o User-settable timers with timer expiration delivered via messages placed in the user's primary queue o Utilities for monitoring the network configuration and flow of messages o Dynamic addition of CPUs to the communications network o Message interface for retrieving DECmessageQ configuration in- formation on line o Portable call interface o Connectivity to DECmessageQ implementations on OpenVMS, Digital UNIX, HP-UX, AIX, Windows NT, MS-Windows, Solaris, SunOS, OS/2 and NCR UNIX . DECmessageQ for UNIX can also be used as an integration tool to merge many external events with the message queuing bus. In addition to integrating messages from local processes and remote processes, DECmessageQ also provides facilities for the integration of other events such as: o Timer settings o Simulated messages o Other external events such as special hardware I/O DECmessageQ Queues DECmessageQ for UNIX provides three types of queues. A queue is a memory storage location for DECmessageQ messages. Any process can insert a message into any queue. These queues are accessed directly by DECmessageQ procedures. These procedures are called by user-written applications. DECmessageQ queue types are: 2 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 o Primary Queue (PQ) - Each process that attaches to the message queuing bus is assigned a Primary Queue. This queue is used to receive messages from processes using DECmessageQ. o Secondary Queue (SQ) - Any process may attach to one or more sec- ondary queues. These queues can also be used to receive messages. The order in which queues are scanned for messages is defined by the DECmessageQ selection rules. o Multi-Reader Queue (MRQ) - A Multi-Reader Queue is a single shared queue that can be shared by any number of simultaneous readers. Message Recovery Services (MRS) Message Recovery Services for the DECmessageQ Message Queuing Bus extends data recovery to the level of pending messages. Using Message Recovery Services, the sender is relieved of the responsibility of tracking the progress of a message through its next level of pro- cessing. This functionality can be used both at the client and server sides of the application. Message Recovery Services increase the robustness of DECmessageQ by providing applications with the ability to recover from message de- livery failures due to: o Application program abort o Communication line failure o System crash Some of the application requirements addressed by MRS are: o Sender wishes to insure delivery of messages when the receiving process is available but does not wish to monitor the delivery. o Sender wishes to know that a message is recoverable to avoid the cost of reconstructing it but does not care when it is finally delivered. o Receiver wishes to maintain a journal of all messages received by it for audit trail or reprocessing. Message Recovery Services are primarily implemented by an MRS server, a non-privileged program attached to the DECmessageQ Message Bus. MRS actions are invoked by standard DECmessageQ send and receive mes- sage calls. 3 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 MRS is oriented toward messages, not processes; not all messages sent from or directed to a particular process need to be processed by MRS. This allows applications to selectively incur the additional pro- cessing imposed by MRS for just those messages that are not easily recovered. Message recovery characteristics are set by the sending process. Delivery Options DECmessageQ for UNIX provides the following set of delivery options: o Datagram - A non-recoverable attempt is made to deliver a mes- sage. If the message cannot be delivered to a target, then an er- ror is logged. o Blocking and non-blocking enqueue - The sending process will be notified when the message is written to the target queue. A re- turn status will indicate if the message successfully enqueued to the queue. o Blocking and non-blocking dequeue - The sending process will be notified when the message is read from the target queue. A re- turn status will indicate if the message successfully dequeued from the queue. o Blocking and non-blocking Acknowledge - The sending process will be notified when the target process confirms the message. A re- turn status will indicate if the message was successfully con- firmed by the target. o Blocking and non-blocking Recoverable - The sending process will be notified when the recovery system has accepted the message. A return status will indicate if the message was successfully jour- nalled by the recovery system. o Blocking and non-blocking Recoverable Acknowledge - The sending process will be notified when the target process has confirmed the recoverable message. A return status will indicate if the mes- sage was successfully confirmed by the target process. 4 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DECmessageQ Scripts Facility The DECmessageQ scripts facility provides a general capability to perform message capture, simulation, and replay. o Capture - DECmessageQ scripts can be used to capture messages sent or received from a process. These messages can be displayed on the output device or collected in a disk file. The messages are displayed in an ASCII file using the DECmessageQ scripts syntax. o Simulation - A disk file containing DECmessageQ scripts commands can be used to simulate message traffic to a process. The com- mands use the DECmessageQ scripts syntax. The process will re- ceive these messages after any DECmessageQ queue is scanned for receivable messages. o Replay - A replay is the simulation of messages previously cap- tured. HARDWARE REQUIREMENTS Processors Supported - Alpha Processors for Development and Run-time Only: Alpha: DEC 2000 Model 300S, DEC 2000 Model 500 Digital 2100 A500/600MP Digital AXPvme 64 DEC 3000 Model 300, DEC 3000 Model 300L, DEC 3000 Model 300LX, DEC 3000 Model 300X, DEC 3000 Model 400, DEC 3000 Model 400S, DEC 3000 Model 500, DEC 3000 Model 500S, DEC 3000 Model 500X, DEC 3000 Model 600, DEC 3000 Model 600S, DEC 3000 Model 800, DEC 3000 Model 800S 5 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DEC 4000 Model 600 Alpha Series, DEC 4000 Model 700 AXP Series DEC 7000 Model 600 Alpha Series DEC 10000 Model 600 Alpha Series Processors Supported - HP-UX-Based Processors for Development and Run-time Only: HP-PA "Precision Architecture", HP9000-7xx,HP-9000-Exx, HP9000-Fxx, HP9000-Gxx, HP9000-Hxx, HP9000-Ixx, HP9000-Kxxx, HP9000-Txxx, and HP9000-8xx Family of RISC Processors Processors Supported - AIX-Based Processors for Development and Run- time Only: RS6000-Mxx, RS6000-2xx, RS6000-3xx, RS6000-5xx, RS6000-9xx Family of RISC Processors Processors Supported - SunOS and Solaris Development and Run-Time Only: Sun/SPARC[R] Classic, Sun/SPARC LX, Sun/SPARC 10/xx, Sun/SPARC ELC, Sun/SPARC IPC, Sun/SPARC IPX, Sun/SPARC 2, Sun/SPARC 3xx, Sun/SPARC 4xx, Sun/SPARCserver 6xxMP/xxx, Sun/SPARCserver 1000/xxx, Sun/SPARCcenter 2000 Processors Supported - NCR UNIX Development & Run-Time Only: NCR System 3000 Disk Space Requirements The maximum disk space required for any DECmessageQ for UNIX Server V3.2 product is 18 MB. The maximum dis space required for any DECmesageQ for UNIX Client V3.2 product is 1.8 MB. This value refers to the disk space required on the user file sys- tem. This size is an approximate; actual size may vary depending on the user's system environment, configuration, and software options. 6 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 SOFTWARE REQUIREMENTS For Systems Using Terminals (No DECwindows Interface): o Digital UNIX Operating System Version 3.0 or higher o HP-UX (HP9000-7xx, -8xx) Operating System, Version 9.xx or higher o AIX Operating System Version 3.2 or higher o SunOS Operating System Version 4.1.x or higher o Solaris Operating System Version 2.1 or higher o NCR UNIX Operating System Version 2.03.01 or higher GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the cur- rent version. DISTRIBUTION MEDIA DECmessageQ for SunOS, DECmessageQ for Solaris, DECmessageQ for AIX and DECmessagQ for NCR UNIX : o QICtape DECmessageQ for HP-UX (HP-PA): o 4MM DAT DECmessageQ for Digital UNIX, DECMessageQ for HP-UX (HP9000-7xx, HP9000- 8xx, E,F, G, H, I, K, and T series), DECmessageQ for Solaris, DECmessageQ for AIX: o CD-ROM ORDERING INFORMATION Development Option All DECmessageQ for UNIX Development Options include the base mes- sage queuing software and language compiler binding libraries. Run-Time Only Option 7 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 All DECmessageQ for UNIX Client and Server Run-Time Only Options pro- vide all the facilities of the development versions of DECmessageQ for UNIX except the language compiler binding libraries. The pur- pose of the Run-Time Only version is to support the execution of pre- viously developed applications on a target machine. Program devel- opment is not supported under the Run-Time Only Option. The DECmessageQ for UNIX Runtime only media kits include binaries for both a UNIX Runtime Server and a UNIX Runtime Client, orderable under the part number. Customers can choose which Runtime only bi- naries (Server or Client) they wish to utilize in their DECmessageQ environment. DECmessageQ for UNIX Software Licenses Orderable for Specific UNIX Operating Systems: DECmessageQ for Digital UNIX Development: QL-2W7A*-AA DECmessageQ for Digital UNIX Run-Time Only: QL-2W8A*-AA DECmessageQ for HP-UX, HP-PA Development: (For HP9000-7xx and -8xx Platform Support) QL-2W9A*-AA (Note: Replaces YR-DMQHX-D*) DECmessageQ for HP-UX, HP-PA Run-Time Only: (For HP9000-7xx and -8xx Platform Support) QL-2WAA*-AA (Note: Replaces YR-DMQHX-R*) DECmessageQ for AIX Development: QL-2WBA*-AA (Note: Replaces YR-DMQAX-D*) DECmessageQ for AIX Run-Time Only: QL-2WCA*-AA (Note: Replaces YR-DMQAX-R*) DECmessageQ for SunOS Development: QL-MK9A*-AA 8 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DECmessageQ for SunOS Run-Time Only: QL-MKFA*-AA DECmessageQ for Solaris Development: QL-2WDA*-AA DECmessageQ for Solaris Run-Time Only: QL-2WEA*-AA DECmessageQ for NCR Unic Development: QL-56TA*-AA DECmessageQ for NCR UNIX Run-Time Only: QL-56UA*-AA DECmessageQ for UNIX Software Media Orderable for Specific UNIX Operating Systems: DECmessageQ for Digital UNIX Development: QA-2W7AA-H* DECmessageQ for Digital UNIX Run-Time Only: QA-2W8AA-H* DECmessageQ for HP-UX, HP-PA Development: (For HP9000-7xx and -8xx Platform Support) QA-2W9AA-H* (Note: Replaces YR-DMQHX-DP) DECmessageQ for HP-UX, HP-PA Run-Time Only: (For HP9000-7xx and -8xx Platform Support) QA-2WAAA-H* (Note: Replaces YR-DMQHX-RP) DECmessageQ for AIX Development: QA-2WBAA-H* (Note: Replaces YR-DMQAX-DP) 9 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DECmessageQ for AIX Run-Time Only: QA-2WCAA-H* (Note: Replaces YR-DMQAX-RP) DECmessageQ for SunOS Development: QA-MK9AA-H* DECmessageQ for SunOS Run-Time Only: QA-MKFAA-H* DECmessageQ for Solaris Development: QA-2WDAA-H* DECmessageQ for Solaris Run-Time Only: QA-2WEAA-H* DECmessageQ for NCR UNIX Development: QA-56TAA-H* DECmessageQ for NCR UNIX Run-Time Only: QA-56UAA-H* DECmessageQ for UNIX Software Documentation Order the Same Documentation Kit for all UNIX Products: DECmessageQ for UNIX Systems: QA-MKCAA-GZ DECmessageQ for UNIX Software Product Services Orderable for Specific UNIX Operating Systems: DECmessageQ for Digital UNIX Development: QT-2W7A*-** DECmessageQ for Digital UNIX Run-Time Only: QT-2W8A*-** 10 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 DECmessageQ for HP-UX Development: (For HP9000-7xx and -8xx Platform Support) QT-2W9A*-** DECmessageQ for HP-UX Run-Time Only: (For HP9000-7xx and -8xx Platform Support) QT-2WAA*-** DECmessageQ for AIX Development: QT-2WBA*-** DECmessageQ for AIX Run-Time Only: QT-2WCA*-** DECmessageQ for SunOS Development: QT-MK9A*-** DECmessageQ for SunOS Run-Time Only: QT-MKFA*-** DECmessageQ for Solaris Development: QT-2WDA*-** DECmessageQ for Solaris Run-Time Only: QT-2WEA*-** DECmessageQ for NCR UNIX Development: QT-56TA*-** DECmessageQ for NCR UNIX Run-Time Only: QT-56UA*-** * Denotes variant fields. For additional information on available licenses, services, and media, refer to the appropriate price book. For DECmessageQ HP-UX, HP-PA (HP9000-7xx,8xx Platform) and AIX (RS6000 Platform) Version 2.2 products, purchased under YR-DMQ*X-** part num- bers, call (203) 258-5235 for a free upgrade to the QL-2W*A*-AA Version 3.0 products that include the Message Recovery Services option. A valid Digital Order number and YR-DMQ*X-** part number are required 11 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 to obtain the free upgrade. Layered Product Services ongoing sup- port for these Version 3.0 upgrades must be purchased separately un- der the QT-2W*A*-** part numbers. SOFTWARE LICENSING This software is only furnished only under a license. For more in- formation about Digital's licensing terms and policies, contact your local Digital office. License Management Facility Support The Digital UNIX and ULTRIX layered products support the Digital UNIX and ULTRIX License Management Facilities. License units for these products are allocated on an Unlimited System Use basis. For more information on the License Management Facility, refer to the Software Product Descriptions for the ULTRIX Operating System (SPD 26.40.xx), the Digital UNIX Operating System (SPD 41.87.xx), or the appropriate Operating System documentation. For more information about Digital's licensing terms and policies, contact your local Digital office. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information, contact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase of a license for the product as defined in the Software Warranty Addendum of this SPD. The above information is valid at time of release. Please contact your local Digital office for the most up-to-date information. [R] AIX is a registered trademark of International Business Machines Corporation. [R] HP and HP-UX are registered trademarks of Hewlett-Packard Corporation. [R] Motorola is a registered trademark of Motorola, Inc. [R] Macintosh is a registered trademark of Apple Computer, Inc. 12 DECmessageQ for UNIX[R], Version 3.2 SPD 39.25.06 [R] MS is a registered trademark of Microsoft Corporation. [R] Solaris and Sun are registered trademarks of Sun Microsystems, Inc. [R] SPARC is a registered trademark of Sparc International, Inc. [R] UNIX is a registered trademark of UNIX System Laboratories, Inc., a wholly-owned subsidiary of Novell, Inc. [TM]Windows is a trademark of Microsoft Corporation. [TM]NCR UNIX is a trademark of AT & T. [TM]The DIGITAL Logo, Alpha, DECmessageQ, Digital, OpenVMS, ULTRIX, and VAX are trademarks of Digital Equipment Corporation. The DIGITAL Logo, Alpha, DECmessageQ, Digital, OpenVMS, ULTRIX, and VAX are trademarks of Digital Equipment Corporation.) ©1995 Digital Equipment Corporation. All Rights Reserved. 13