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.