DIGITAL [TM] MAILbus 400 Application Program Interface ----------------------------------- Installing on a Digital UNIX System Revision/Update Information: Version 2.0 This card gives the information you need to install the MAILbus 400 Application Program Interface (API) on a Digital UNIX system. Order Number: AV-Q2MXE-TE Installation Prerequisites Before you install the MAILbus 400[TM] API, do the following (the question mark in subset names is a wildcard character): o Make sure Digital[TM] UNIX[R] Version 3.2, or later, or Digital UNIX Version 4.0, or later is installed on your system. o Back up your system disk. o Register a valid API license, MAILBUS-400-API. Use the Digital UNIX License Management Facility (LMF) to do this; see the Digital UNIX Guide to Software Licensing. o Stop any MAILbus 400 API applications that are running on your system. o Deinstall any API subsets already installed on your system, as follows: # setld -d MTAACLNT14? MTAAMAN14? MTAABASE14? In addition, if you intend to use the MAILbus 400 API remotely over an OSI[R] Transport Service, you need the DNABASE subset from DECnet[TM]/OSI for Digital UNIX Version 3.2A, or later, or from DECnet/OSI for Digital UNIX Version 4.0, or later. Information and Time Required To install the MAILbus 400 API, you need the following information: o The device name for the drive where the CD-ROM will be mounted. o If you are installing the MAILbus 400 API from a RIS server area, the name of the RIS server area. Installing all subsets in the MAILbus 400 API takes approximately 3 minutes. 2 Disk Space Required The following table shows the approximate amount of disk space required (in Kilobytes) for files and softlinks to each of the subsets in /usr and /var. __________________________________________________________ Subset Subset Title Name Space Required /usr /var ---------------------------------------------------------- MAILbus 400 API (Digital MTAACLNT200 7200 kB minimal UNIX) MAILbus 400 MTA Base MTAABASE200 2500 kB minimal (Digital UNIX) MAILbus 400 API Reference MTAAMAN200 190 kB minimal Pages (Digital UNIX) ---------------------------------------------------------- Installing the MAILbus 400 API 1. Log in with superuser privileges and make sure you are in the root directory. For a RIS installation, continue at step 3. 2. Mount the disk, using the device name as follows: # mount -r -d /dev/device_name /mnt 3. Load the subsets as follows: for CD-ROM: # setld -l /mnt/MTAX200/kit for RIS, using the RIS server area: # setld -l ris_area The installation procedure starts and prompts you to specify the subsets that you want to install. To specify more than one of the options offered, enter the number associated with each option, with a space between numbers. You should install MTAACLNT200, MTAABASE200, and MTAAMAN200. If the MAILbus 400 MTA has already been installed, MTAABASE200 will be present on your system and the setld procedure will not offer this option. For further information about installing software on a Digital UNIX system, refer to the Digital UNIX reference pages for setld(8) and lmf(8). Refer to the Guide to the Remote Installation Services for information on using RIS. 3 After the Installation Depending on the subsets you have installed, the MAILbus 400 API installation might have superseded the file /var/mta/mta_api_server_address and saved the existing version as /var/mta/mta_api_server_address.savn, where n is a number. If this has occurred, apply any of your customizations to the new version of /var/mta/mta_api_server_address. After installation, the release notes are kept in /usr/doc/mailbus400_api.release_notes Files Installed The files that should be present on your system after you have installed the MAILbus 400 API subset (MTAACLNT200) are as follows: /usr/include/xds.h /usr/include/xmh_dec_extn.h /usr/include /usr/include/xmhp.h /xdssap.h /usr/include/ximp.h /usr/include/xom.h /usr/include/xmh.h /usr/include/xomi.h /usr/lib/libxapi.a /usr/lib/libxapi_remote.a /usr/examples/mta /usr/examples/mta/mtamail_utils.c /mtamail.c /usr/examples/mta/mtamail_utils.h The files that should be present in /usr/man/man3 after you have installed the MAILbus 400 API Reference Pages subset (MTAAMAN200) are as follows: ma_cancel_submission.3xma ma_close.3xma ma_finish_delivery.3xma ma_open.3xma ma_size.3xma ma_start_delivery.3xma ma_submit.3xma ma_wait.3xma maX_open.3xma mhX_foreign_to_orname.3xmh mhX_orname_to_foreign.3xmh mhX_update_password.3xmh mhX_validate_credentials.3xmmt_close.3xmt mt_finish_transfer_in.3xmt mt_open.3xmt mt_size.3xmt mt_start_transfer_in.3xmt mt_transfer_out.3xmt mt_wait.3xmt mtX_open.3xmt om_copy.3xom 4 om_copy_value.3xom om_create.3xom om_decode.3xom om_delete.3xom om_encode.3xom om_get.3xom om_instance.3xom om_put.3xom om_read.3xom om_remove.3xom om_write.3xom For a listing of the files that should be present on your system after you have installed the MAILbus 400 MTA Base subset (MTAABASE200) refer to MAILbus 400 MTA Tuning and Problem Solving. Copyright Information 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 document 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 1994, 1995, 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DECnet, Digital, MAILbus 400, and the DIGITAL logo. OSI is a registered trademark of CA Management, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively by X/Open Company, Ltd. 5