CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Programming with the DEC/MAP Application Interface

  1.1     Application Entities

  1.2     The Association
    1.2.1      The Application Context
    1.2.2      The Presentation Context
    1.2.3      Addressing an Application

  1.3     Initiating an Association

  1.4     Receiving an Association Request

  1.5     Accepting, Negotiating, and Rejecting an Association Request

  1.6     Exchanging Data
    1.6.1      Sending Data
    1.6.2      Receiving Data

  1.7     Synchronizing and Resynchronizing Transmissions
    1.7.1      Initializing Synchronization
    1.7.2      Requesting Resynchronization
    1.7.3      Receiving and Responding to a Resynchronization Request

  1.8     Ending an Association
    1.8.1      Initiating a Release

  1.9     Initiating an Abort
    1.9.1      Receiving Release and Abort Indication
    1.9.2      Responding to a Release Indication

  2      MAPI Features

  2.1     Synchronous and Asynchronous Operation
    2.1.1      Synchronous Procedure Calls (MAP$MAPIW)
    2.1.2      Asynchronous Procedure Calls (MAP$MAPI)

  2.2     Returning Status Information
    2.2.1      Register R0
    2.2.2      MAPI Status Block

  2.3     Item Lists

  2.4     MAPI Data Descriptors
    2.4.1      Transferring Data on an Association with a User-Negotiated Presentation Context
    2.4.2      Transferring Data on an Association with the Predefined MAPI Presentation Context

  2.5     MAPI SAS Name Descriptor

  2.6     Active and Passive AEs
    2.6.1      Active AEs
    2.6.2      Passive AEs

  2.7     Receiving Character Strings

  2.8     Privileges, Quotas, and Restrictions

  2.9     MAPI Definition Files

  2.10    Linking an Application with MAPI

  2.11    Local Loopback During MAPI Program Development

  3      Documentation Format

  3.1     Procedure Call Format Section

  3.2     Returns Section

  3.3     Argument Definitions Section
    3.3.1      Data Type Entry
    3.3.2      Argument Access Entry
      3.3.2.1      Read-Only Access
      3.3.2.2      Write-Only Access
      3.3.2.3      Modify Access
    3.3.3      Passing Mechanism Entry

  3.4     Usage Notes Section

  4      Procedure-Calling Formats and Arguments

  MAPI$_A_INDICATION

  MAPI$_ABORT

  MAPI$_ASC_ACCEPT

  MAPI$_ASC_REJECT

  MAPI$_ASSOCIATE

  MAPI$_LISTEN

  MAPI$_P_INDICATION

  MAPI$_RELEASE

  MAPI$_REL_ACCEPT

  MAPI$_REL_REJECT

  MAPI$_RESYNCHRONIZE

  MAPI$_RESYNC_REPLY

  MAPI$_TRANSFER

  A   MAPI Programming Examples

  A.1     Initialize Request

  A.2     Receive Request

  B   MAPI Messages

  B.1     Returned Function Codes
    B.1.1     Success Code
    B.1.2     Error Codes
    B.1.3     Informational Codes
    B.1.4     Fatal Codes

  B.2     VMS Completion Codes

  B.3     VOTS Status Codes

  C   MAP Directory Services Name-to-Address Resolution Procedure

  MAP$MDS_READ_AE

  C.1     MDS Messages
    C.1.1      Error Severity Level
    C.1.2      Remote Operations Service Elements (ROSE) Protocol Errors
    C.1.3      Remote Errors
    C.1.4      Warning Severity Level
    C.1.5      Success Message
    C.1.6      Informational Messages
    C.1.7      Fatal Severity Level

  FIGURES

  1-1        Requesting an Association

  1-2        Receiving an Association Request

  1-3        Accepting an Association Request

  1-4        Rejecting an Association Request

  1-5        Sending Data

  1-6        Receiving Data

  1-7        Initiating a Resynchronization Request

  1-8        Receiving a Resynchronization Request

  1-9        Requesting an Association Release

  1-10       Receiving Release and Abort Indications

  2-1        MAPI Status Block

  2-2        VMS Item Descriptor

  2-3        Item List Example

  2-4        MAPI Data Descriptor

  2-5        SAS Name Descriptor