CCNV gate, EXTRACT_ADS function
Obtain an application data structure (ADS) for data conversion.
Input Parameters
- ADS_1
- The application data structure to be converted.
- RESOURCE_NAME
- The name of the resource to be converted.
- RESOURCE_TYPE
- The type of resource to be converted.
- Values for the parameter are:
- FC
- IC
- PC
- TD
- TS
- TARGET
- The target code page for the data conversion.
- Values for the parameter are:
- ASCII
- EBCDIC
- ADS_2
- Optional Parameter
- A second application data structure to be converted, used only when RESOURCE_TYPE(FC) is specified.
- BINARY_FORMAT
- Optional Parameter
- The binary format in which numeric data is represented.
- Values for the parameter are:
- BIG_ENDIAN
- LITTLE_ENDIAN
- CNV_ENTRY_TOKEN
- Optional Parameter
- A pointer to a DFHCNV TYPE=ENTRY record.
- CNV_TABLE_TOKEN
- Optional Parameter
- The address at which DFHCNV is loaded.
- SERVER_INDEX
- Optional Parameter
- Specifies the conversion table associated with the SERVER_CCSID parameter.
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.
- CLIENT_CCSID
- Optional Parameter
- The Coded Character Set Identifier (CCSID) of the code page used by the client.
- SERVER_CCSID
- Optional Parameter
- The Coded Character Set Identifier (CCSID) of the code page used by the server.