DIGITAL [TM] MAILbus 400 Application Program Interface ------------------------------------- Installing on an OpenVMS Alpha System Revision/Update Information: Version 2.0 This card contains the information you need to install the MAILbus 400 Application Program Interface (API) on an OpenVMS Alpha system. Order Number: AV-QEFYB-TE Installation Prerequisites Before you install the MAILbus 400[TM] API, do the following: o Ensure the following software is installed on your system: - OpenVMS[TM] Alpha Version 6.1, or later, or OpenVMS Alpha Version 7.0, or later. - DECnet[TM]/OSI[R] for OpenVMS Alpha, Version 6.3 or later, or Version 7.0, or later. o Ensure you have access to the SYSTEM account. o Ensure no one is using the system where you install the API. o Back up your system disk using the OpenVMS Backup utility. o Register a valid API license, MAILBUS-400-API. Use the OpenVMS License Management Facility (LMF) to do this. You cannot install the MAILbus 400 API unless you have registered a valid license. o Stop any MAILbus 400 API applications that are running on your system. See the OpenVMS system management documentation for information about the OpenVMS Backup utility and the OpenVMS License Management Facility. Information Required To install the MAILbus 400 API, you need to know the name of the device from which the installation kit will be loaded. Time Required The time it takes to install the MAILbus 400 API depends on the resources available on your system. The installation takes approximately 1 minute on a DEC[TM] 2000 Model 300. 2 Disk Space Required The MAILbus 400 API requires approximately 4600 blocks of free disk space during installation, and 4300 blocks on the SYSTEM disk after installation. Installing the MAILbus 400 API From the SYSTEM account on the node, or cluster, where you want to install the MAILbus 400 API, complete the following steps: 1. Mount the CD-ROM as follows: MOUNT device-name: volume-label where device-name and volume-label are as specified in the OpenVMS Alpha Layered Products Compact Disk User's Guide. The API files are located on the CD-ROM in the directory named MTA020. 2. Install the API using the following command: @SYS$UPDATE:VMSINSTAL MTA020 device-name:[MTA020] OPTIONS N The installation procedure starts and prompts you to select the components you want to install. Select both the MAILbus 400 API and the MAILbus 400 MTA Base component. After the Installation Depending on the subsets you have installed, the MAILbus 400 API installation might have superseded the files MTA$CLIENT_STARTUP.COM and MTA$CREATE_CLIENT_CLNS_TEMPLATE.NCL. Check if this has occurred, and if so, apply any of your customizations to the new versions of the files. Files Installed The following files are provided with the MAILbus 400 API: SYS$COMMON:[SYSLIB] XDS.H XDSSAP.H XIMP.H XMH.H XMHP.H XMH_DEC_EXTN.H XOM.H XOMI.H 3 SYS$COMMON:[SYSHLP.EXAMPLES] MTAMAIL.C MTAMAIL_UTILS.C MTAMAIL_UTILS.H For a listing of the files that should be present on your system after you have installed the MAILbus 400 MTA Base subset refer to MAILbus 400 MTA Tuning and Problem Solving. Release Notes After installation, the MAILbus 400 API Release Notes for OpenVMS Alpha are kept in SYS$COMMON:[SYSHLP]MAILBUS400_API.RELEASE_NOTES. Copyright Information Second Printing, March 1996 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. © Digital Equipment Corporation 1995 and 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DECnet, Digital, MAILbus 400, OpenVMS, and the DIGITAL logo. OSI is a registered trademark of CA Management, Inc. 4