Parameter list (DFHUVNDS)

The DFHUNVDS DSECT maps the parameter list passed to DFHUCNV in the COMMAREA.

If a parameter is zero, no data is available. If you do not create a conversion template for the resource, DFHUCNV is invoked, but only the following fields in the parameter list contain data:
  • UNVRSTP
  • UNVRNMP
  • UNVDIRP
  • UNVOVLY

Figure 1. DFHUNVDS—DSECT that maps the parameter list passed to DFHUCNV
DFHUNVDS DSECT
UNVRSTP  DS    AL4                 PTR-TO-RESOURCE TYPE
UNVRNMP  DS    AL4                 PTR-TO-RESOURCE NAME
UNVDIRP  DS    AL4                 PTR-TO-CONVERSION DIRECTIVE
CNVRQATE EQU   X'02'               REQUEST ASCII TO EBCDIC
CNVRPETA EQU   X'04'               RESPONSE EBCDIC TO ASCII
UNVDTMP  DS    AL4                 PTR-TO-DATA CONV TEMPLATE
UNVDLNP  DS    AL4                 PTR-TO-DATA TEMPLATE LENGTH
UNVKTMP  DS    AL4                 PTR-TO-KEY CONV TEMPLATE
UNVKLNP  DS    AL4                 PTR-TO-KEY TEMPLATE LENGTH
UNVATEP  DS    AL4                 PTR-TO-ASCII/EBCDIC TRANS TABLE
UNVETAP  DS    AL4                 PTR-TO-EBCDIC/ASCII TRANS TABLE

UNVATED  DS    AL4                 PTR-TO-DBCS ASCII/EBCDIC T.TABLE
UNVETAD  DS    AL4                 PTR-TO-DBCS EBCDIC/ASCII T.TABLE
UNVOVLY  DS    0H                  OVERLAY SECTION
         ORG   UNVOVLY             TS REQUEST OVERLAY
UNVTSDP  DS    AL4                 PTR-TO-TS DATA
UNVTSLNP DS    AL4                 PTR-TO-TS DATA LENGTH
         ORG   UNVOVLY             TD REQUEST OVERLAY
UNVTDDP  DS    AL4                 PTR-TO-TD DATA
UNVTDLNP DS    AL4                 PTR-TO-TD DATA LENGTH
         ORG   UNVOVLY             IC REQUEST OVERLAY
UNVICDP  DS    AL4                 PTR-TO-IC DATA
UNVICLNP DS    AL4                 PTR-TO-IC DATA LENGTH
         ORG   UNVOVLY             PC REQUEST OVERLAY
UNVPCDP  DS    AL4                 PTR-TO-PC DATA
UNVPCLNP DS    AL4                 PTR-TO-PC DATA LENGTH
         ORG   UNVOVLY             FC REQUEST OVERLAY
UNVFCDP  DS    AL4                 PTR-TO-FC DATA
UNVFCLNP DS    AL4                 PTR-TO-FC DATA LENGTH
UNVFCKP  DS    AL4                 PTR-TO-FC KEY
UNVFCKLP DS    AL4                 PTR-TO-FC KEY  LENGTH
         ORG   ,
UNVMRTNE DS    A                   PTR-TO-MBCS TRANSLATION ROUTINE
UNVCLIDP DS    AL4                 A "client" CCSID
*                                    (for example, 00819)
UNVSRIDP DS    AL4                 A "server" CCSID
*                                    (for example, 00285)

The following is a detailed description of the parameters:

UNVRSTP
Points to a one-byte resource type that indicates the resource being referenced by this request. The meanings of the resource types are defined in DSECT DFHCNVDS. The resource types are FC, IC, TS, TD, and PC.
UNVRNMP
Points to an eight-character field containing the resource name, padded with blanks if necessary. These may be:
  • For an FC request, an eight-byte file name
  • For a TS request, an eight-byte TS queue name
  • For a TD request, a four-byte TD queue name
  • For an IC request, a four-byte transaction name
  • For a PC request, an eight-byte program name.
UNVDIRP
Points to a one-byte field that shows what conversion is required:
  • CNVRQATE (X'02') indicates a request needing conversion from client encoding to server encoding.
  • CNVRPETA (X'04') indicates a response needing conversion from server encoding to client encoding.
UNVDTMP
Points to the start of the conversion template found by CICS to match this resource. If UNVDTMP is zero no template was found.
UNVDLNP
Points to a field that gives the length of the conversion template. The field is:
  • A fullword for CICS® Transaction Server for z/OS®
  • A half-word for all other platforms.
UNVKTMP (file control requests only)
Points to the start of the template found by CICS for the key part of the request or response. If UNVKTMP is zero, either there is no key template or the record is accessed by relative record number or relative byte address.
UNVKLNP (file control requests only)
Points to a field that gives the length of the key conversion template. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
UNVATEP
Points to a 256-byte SBCS translation table used for converting character data from client encoding to server encoding.
UNVETAP
Points to a 256-byte SBCS translation table used for converting character data from server encoding to client encoding.
UNVATED
Points to a DBCS translation table used for converting character data from client encoding to server encoding.
UNVETAD
Points to a DBCS translation table used for converting character data from server encoding to client encoding.

The overlay section depends on resource type:

TS requests:
UNVTSDP
Points to the start of the TS record being read or written. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
UNVTSLNP
Points to a field that gives the length of the TS record.
TD requests:
UNVTDDP
Points to the start of the TD record being read or written.
UNVTDLNP
Points to a field that gives the length of the TD record. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
IC requests:
UNVICDP
Points to the “from” area of an IC START request.
UNVICLNP
Points to a field that gives the length of the “from” area. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
PC requests:
UNVPCDP
Points to the start of the COMMAREA being supplied.
UNVPCLNP
Points to a field that gives the length of the COMMAREA. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
FC requests:
UNVFCDP
Points to the start of the file control record being read or written.
UNVFCLNP
Points to a field that gives the length of the file control record. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
UNVFCKP
Points to the start of the key for the file control record being read or written.
UNVFCKLP
Points to a field that gives the length of the key. The field is:
  • A fullword for CICS Transaction Server for z/OS
  • A half-word for all other platforms.
UNVMRTNE
Points to a translation routine that must be used for translations to or from an MBCS code page. The relevant client code pages are 954, 964, and 970.
The routine expects Register 1 to point to a structure defined by the DFHUNVM DSECT: 
DFHUNVM DSECT
UNVMTABP  DS    AL4            Set to value in UNVATED or UNVETAD
UNVMINP   DS    AL4            Address of source data
INVMINL   DS    FL4            Length of source data
UNVMOUTP  DS    AL4            Address of target buffer
UNVMOUTL  DS    FL4            Length of target buffer
UNVCLIDP
Points to a fullword field that gives the IBM-defined CCSID, for example 00819, corresponding to the “client” code page.
UNVSRIDP
Points to a fullword field that gives the IBM-defined CCSID, for example 00285, corresponding to the “server” code page.