VMS Help MAIL Routines, MAIL$SEND_ADD_BODYPART, Input Item Codes  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 MAIL$_SEND_DEFAULT_NAME

    MAIL$_SEND_DEFAULT_NAME specifies the default file specification
    of a text file to be opened. The buffer address field of the item
    descriptor points to a buffer that contains a character string 0
    to 255 characters long.

    Specify a value from 0 to 255 in the buffer length field of the
    item descriptor.

 MAIL$_SEND_FID

    MAIL$_SEND_FID specifies the file identifier of the text file
    to be opened. The buffer address field of the item descriptor
    points to a buffer that contains the file identifier. To identify
    a file using a file identifier, you must also specify the device
    identifier for the file. Specify the device identifier using the
    MAIL$_SEND_DEFAULT_NAME item code. More information about using
    a file ID for specifying files can be found in OpenVMS Record
    Management Services Reference Manual. Note that the MAIL$_SEND_
    FID item code and the MAIL$_SEND_FILENAME item code are mutually
    exclusive.

 MAIL$_SEND_FILENAME

    MAIL$_SEND_FILENAME specifies the input file specification of
    the text file to be opened. The buffer address field of the item
    descriptor points to a buffer that receives a character string
    0 to 255 characters long. Note that the MAIL$_SEND_FILENAME item
    code and the MAIL$_SEND_FID item code are mutually exclusive.

    Specify a value from 0 to 255 in the buffer length field of the
    item descriptor.

 MAIL$_SEND_RECORD

    MAIL$_SEND_RECORD specifies a descriptor of a text record to be
    added to the body of the message. The buffer address field of
    the item descriptor points to a buffer that receives a character
    string 0 to 255 characters long.

    Specify a value from 0 to 255 in the buffer length field of the
    item descriptor.

    When creating a message, do not specify MAIL$_SEND_RECORD in the
    same call (or series of calls) to MAIL$SEND_ADD_BODYPART with the
    following item codes:

    o  MAIL$_SEND_FID

    o  MAIL$_SEND_FILENAME

                                   NOTE

       Do not use the MAIL$_SEND_RECORD item code with the
       MAIL$SEND_ADD_BODYPART routine called from a detached
       process. The routine creates a temporary file in SYS$SCRATCH
       that is inaccessible to the detached process.

 out_item_list

    OpenVMS usage:itmlst_3
    type:         longword
    access:       write only
    mechanism:    by reference
    Item list specifying the information you want the routine to
    return. The out_item_list argument is the address of a list of
    item descriptors, each of which describes an item of information.
    The list of item descriptors is terminated by longword value of
    0.