Input_Item_Codes

 

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 998 characters long.

   Specify a value from 0 to 998 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.