PIMM gate, GENERATE_CONTENT_ID function

Generates a unique content ID value, consisting of a locally unique value based on a timestamp and a supplied domain. The result can be obtained in both content-ID format, <addr-spec>, and in CID format, cid:addr-spec.

Input Parameters

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
Optional parameter
A buffer for the CID URI in the specified CCSID. This should be in the format cid:addr-spec.
CID_DOMAIN_CHARACTER
The 16-byte name of the container in the specified channel that contains the domain name. This string is used as the last part of a content-ID to identify the sysplex within which the locally unique value applies.
CONTENT_ID
Optional parameter
A buffer for the Content-ID in the specified CCSID. The value should be in the format <addr-spec>.

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • OUTPUT_BUFFER_OVERFLOW
  • CCSID_NOT_SUPPORTED
  • INVALID_CHARACTER
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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