CCNV gate, CONVERT_DATA function

Convert a block of data between a client and server code page.

Input Parameters

SEGMENTED
A binary value that indicates whether the data to be converted is segmented or in a single buffer.
Values for the parameter are:
  • NO
  • YES
CONVERSION_TOKEN
Optional Parameter
A token that represents the server and client code page conversion tables.
SOURCE_BUFFER
Optional Parameter
A 31-bit pointer to the buffer that contains the data to be converted.
SOURCE_BUFFER64
Optional Parameter
A 64-bit pointer to the buffer that contains the data to be converted.
SOURCE_CCSID
Optional Parameter
The Coded Character Set Identifier (CCSID) of the code page used to encode the source data.
TARGET_BUFFER
Optional Parameter
A 31-bit pointer to the buffer that will contain the converted data.
TARGET_BUFFER64
Optional Parameter
A 64-bit pointer to the buffer that will contain the converted data.
TARGET_CCSID
Optional Parameter
The Coded Character Set Identifier (CCSID) of the code page used to encode the target data.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • KEDD_ERROR
  • LMLM_ERROR
  • LOCK_FAILURE
  • LOOP
  • MULTI_ERROR
  • SMAD_ERROR
  • SMGF_ERROR
The following values are returned when RESPONSE is EXCEPTION:
  • ADS_1_OMITTED
  • ADS_2_NOT_SUPP
  • CGCSGID_NOT_SUPP
  • CICS_CCSID_NOT_KNOWN
  • CLIENT_CCSID_NOT_KNOWN
  • CLIENT_CCSID_NOT_SUPP
  • COMBINATION_UNSUPPORTED
  • CONVERSION_NOT_REQUIRED
  • CONVERSION_NOT_SUPP
  • IANA_CCSID_NOT_KNOWN
  • IANA_CCSID_NOT_SUPP
  • IBM_CCSID_NOT_KNOWN
  • INSUFFICIENT_STORAGE
  • INTERNAL_CONVERSION_ERROR
  • SERVER_CCSID_NOT_KNOWN
  • SERVER_CCSID_NOT_SUPP
  • SERVER_UNSUPPORTED
  • SERVICE_NOT_AVAILABLE
  • SOURCE_CCSID_INVALID
  • SOURCE_DATA_INCOMPLETE
  • TARGET_BUFFER_EXHAUSTED
  • TARGET_CCSID_INVALID
  • ZOS_CONVERSION_ERROR
The following values are returned when RESPONSE is INVALID:
  • BINARY_FORMAT_INVALID
  • CNV_ENTRY_TOKEN_INVALID
  • CNV_TABLE_NOT_LOADED
  • CNV_TABLE_NOT_VALID
  • CNV_TABLE_TOKEN_INVALID
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • RESOURCE_TYPE_INVALID
  • CONV_TOKEN_OMITTED
  • SOURCE_CCSID_OMITTED
  • TARGET_CCSID_OMITTED
  • TARGET_INVALID
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
CONVERSION_TOKEN_OUT
Optional Parameter
A token that represents the server and client code page conversion tables.
SUBSTITUTION
Optional Parameter
A binary value that indicates whether substitution characters were present in the input data.
Values for the parameter are:
  • NO
  • YES


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