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.