PIMM gate, GET_ATTACHMENT function

Retrieves the container names for the headers and body of the binary attachment with the specified Content-ID or CID.

Input Parameters

ATTACHMENTS_CONTAINER
The 16-byte name of the container in the specified channel that contains the binary attachments list.
CCSID
The fullword binary CCSID value. This is used for header value input and output parameters such as CONTENT_ID.
CHANNEL_NAME
Optional parameter
The 16-byte name of the channel for all referenced containers. If this parameter is omitted, then the current channel is assumed.
CID
A buffer for the CID URI in the specified CCSID. This should be in the format cid:addr-spec. Either CID or CONTENT_ID can be used as input.
CONTENT_ID
A buffer for the Content-ID in the specified CCSID. The value should be in the format <addr-spec>. Either CID or CONTENT_ID can be used as input.

Output Parameters

BODY_CONTAINER
The 16-byte name of the body container in the specified channel. This is a container of DATATYPE(BIT), as it contains a binary attachment.
HEADERS_CONTAINER
The 16-byte name of the headers container in the specified channel. This is a container of DATATYPE(CHAR) that contains the MIME headers.
REASON
The following values are returned when RESPONSE is EXCEPTION:
  • CHANNEL_NOT_FOUND
  • CCSID_NOT_SUPPORTED
  • CONTAINER_NOT_FOUND
  • CONTAINER_CCSID_ERROR
  • CONTAINER_WRONG_TYPE
  • ATTACHMENT_NOT_FOUND
  • INVALID_CHARACTER
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_PIMMget_attachment.html | Timestamp icon Last updated: Monday, 5 June 2017