FFAPI: What Files FFAPI Accesses in the PC Mail Database

Last reviewed: October 20, 1997
Article ID: Q85058
3.00 MS-DOS kb3rdparty

The information in this article applies to:

  • Microsoft Mail Software Development Kit: FFAPI for Gateways and Applications, version 3.0

SUMMARY

This article provides a brief outline of what files FFAPI uses to extract and submit mail.

In the information below:

  • GET refers to APPGET.EXE and GTWGET.EXE.
  • PUT refers to APPPUT.EXE and GTWPUT.EXE.

MORE INFORMATION

GET File Access

  1. Extracting mail items from a user's mailbag:

          Filename            Description
          --------            -----------
    
          ACCESS2.GLB         Verify user ID and get user MBG filename
          ACCESS.GLB
          MASTER.GLB          Determine what the network type is.
          C850SORT.GLB        Get sort information.
          Mail file           Creates or replaces mail file.
          User KEY file       Gets pointers to mail items in MBG file.
          User MBG file       Gets header and MAI filenames.
          MAI file            Read MAI file.
          User KEY file       Mark mail items as read.
          MAI file            Read MAI file.
          Mail file           Build output file from MAI file.
    
    

  2. Extracting mail items from a user's mailbag, with attachments:

          Filename            Description
          --------            -----------
    
          ACCESS2.GLB         Verify user ID and get user MBG filename.
          ACCESS.GLB
          MASTER.GLB          Determine what the network type is.
          C850SORT.GLB        Get sort information.
          MAIL FILE           Creates or replaces mail file.
          User KEY file       Gets pointers to mail items in MBG file.
          User MBG file       Gets header and MAI and ATT filenames.
          MAI file            Read MAI file.
          ATT file            Read ATT file.
          Mail file           Build output file from MAI file.
    
    

PUT File Access

  1. Submitting mail items to a user's mailbag:

          Filename            Description
          --------            -----------
    
          Open mail file      Verify input file exists.
          ACCESS2.GLB         Verify admin ID/password.
          ACCESS.GLB
          MASTER.GLB          Check network type.
          C850SORT.GLB        Get sort information.
          ACCESS2.GLB
          GROUP.GLB           Get group information.
          NETWORK.GLB         Get network information.
          Read from mail file
          CONTROL.GLB         Get unique filename.
          Create and write
             to MAI file      Writes mail message.
          Create and write
             to P1 file       Creates envelope file with address.
          INQUEUE.KEY         Creates pointer to record in MBG file.
          INQUEUE.MBG         Writes header for P1 file.
          INQUEUE.KEY
          Mail file
          INQUEUE.MBG
          INQUEUE.KEY         Get pointer to unprocessed mail.
          INQUEUE.MBG         Get P1 and MAI filename.
          P1 file
          MAI file
          User KEY file       Gets pointer to record in MBG file.
          User MBG file       Writes header for MAI file.
          User KEY file       Updates pointer.
          Delete P1 file
          Close INQUEUE.KEY
          Close MAI file
          Close INQUEUE.MBG
          Close mail file
          Delete mail file
    
    

  2. Submitting mail items to user's mailbag, with attachments:

          Filename            Description
          --------            -----------
    
          Open mail file      Verify input file exists.
          ACCESS2.GLB         Verify admin ID/password.
          ACCESS.GLB
          MASTER.GLB          Check network type.
          C850SORT.GLB        Get sort information.
          ACCESS2.GLB
          GROUP.GLB           Get group information.
          NETWORK.GLB         Get network information.
          Read from mail file
          CONTROL.GLB         Get unique filename.
          Create and write
             to MAI file      Writes mail message.
          Create and write
             ATT file         Create file for attachment.
          Create and write
             to P1 file       Creates envelope file with address.
          INQUEUE.KEY         Creates pointer to record in MBG file.
          INQUEUE.MBG         Writes header for P1 file.
          INQUEUE.KEY
          Mail file
          INQUEUE.MBG
          INQUEUE.KEY         Get pointer to unprocessed mail.
          INQUEUE.MBG         Get P1 and MAI filename.
          P1 file
          MAI file
          User KEY file       Gets pointer to record in MBG file.
          User MBG file       Writes header for MAI file, adds ATT and
                                 MAI filenames.
          User KEY file       Updates pointer.
          Delete P1 file
          Close INQUEUE.KEY
          Close MAI file
          Close INQUEUE.MBG
          Close mail file
          Delete mail file
    
    

Remote FFAPI File Access

  1. Extracting mail items from the user's outbox.

          Filename         Description
          --------         -----------
    
          CONNECT.GLB      Asynch connection information.
          ACCESS.GLB       Verify user ID/password.
          C850SORT.GLB     Get sort information.
          Mail file        Open file.
          INBOX.KEY        Get pointer to unread mail item.
          INBOX.MBG        Get header and MAI filename.
          MAI file         Open MAI file.
          ATT file         Open attachment.
          INBOX.KEY        Mark mail item as read.
          MAI file
    
    

  2. Submitting mail items to the user's inbox.

          Filename         Description
          --------         -----------
    
          CONNECT.GLB
          ACCESS.GLB
          C850SORT.GLB
          GROUP.GLB
          NETWORK.GLB
          Mail file
          CONTROL.MAI      Get unique filename.
          Create MAI file
          INBOX.KEY        Get pointer to MBG items.
          INBOX.MBG        Write header and MAI filename.
          INBOX.KEY        Update pointer to MBG items.
    


Additional reference words: 3.00 2.1a 2.1c pcmail files
KBCategory: kb3rdparty
KBSubcategory: MailGWFFAPI


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: October 20, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.