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.


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