/sys$common/syshlp/helplib.hlb MAIL Routines, MAIL$MAILFILE_BEGIN, Arguments  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 context

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Mail file context information to be passed to other mail file
    routines. The context argument is the address of a longword that
    contains mail file context information.

    You should specify the value of this argument as 0 in the first
    of a sequence of calls to mail file routines. In the following
    calls, you should specify the mail file context value returned by
    this routine.

 in_item_list

    OpenVMS usage:itmlst_3
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Item list specifying options for the routine. The in_item_list
    argument is the address of a list of item descriptors, each of
    which specifies an option and provides the information needed to
    perform the operation.

    The item list is terminated by a longword value of 0.

    For this routine, there are no input item codes.

 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.

    The only output item code for this routine is the MAIL$_MAILFILE_
    MAIL_DIRECTORY item code. When you specify MAIL$_MAILFILE_
    MAIL_DIRECTORY, MAIL$MAILFILE_BEGIN returns the mail directory
    specification to the caller. 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.

    MAIL$MAILFILE_BEGIN creates and initiates a mail file context for
    calls to other mail file routines.