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

 MAIL$_SEND_PERS_NAME   MAIL$_SEND_NO_PERS_NAME

    Note that you must specify only one of these item codes. An error
    is generated if you specify both item codes. MAIL$_SEND_PERS_
    NAME specifies the personal name text to be used in the message
    header. The buffer address field of the item descriptor points
    to a buffer that contains a character string 0 to 127 characters
    long.

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

    The Boolean item code MAIL$_SEND_NO_PERS_NAME specifies that no
    personal name string be used during message construction.

    Specify the value 0 in the buffer length and buffer address
    fields of the item descriptor.

 MAIL$_SEND_SIGFILE   MAIL$_SEND_NO_SIGFILE

    Note that you must specify only one of these item codes. An
    error is generated if you specify both item codes. MAIL$_
    SEND_SIGFILE specifies the full OpenVMS file specification
    of the signature file to be used in the message. The default
    file specification used for a signature file is the user mail
    directory specification and .SIG as the file type. 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.

    The Boolean item code MAIL$_SEND_NO_SIGFILE specifies that no
    signature file be used during message construction.

    Specify the value 0 in the buffer length and buffer address
    fields of the item descriptor.

 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.