CICS Transaction Gateway V5 The WebSphere ... - IBM Redbooks

ECI applications
Web Browser
330 CICS Transaction Gateway V5
ECI applications use the facilities of the CICS mirror program to link to the
specified user program, passing a buffer known as the COMMAREA for input and
output. The CICS mirror program (DFHMIRS) invokes the services of the data
conversion program (DFHCCNV) to perform the necessary conversion of the
COMMAREA (Figure A-1).
CICS TG
ECI
z/OS, Linux, AIX, Solaris, Windows
Figure A-1 CICS Transaction Gateway, ECI data conversion
Only if DFHCCNV finds a conversion template in the DFHCNV table that
matches the program name will it perform code page translation for the
COMMAREA associated with the ECI request. Example A-1 shows the DFHCNV
table entry we used for the program ECIPROG.
Example: A-1 DFHCNV entry
Mirror
program
DFHMIRS
CICS TS region
DFHCCNV
CICS
program
DFHCNV TYPE=ENTRY,RTYPE=PC, *
CLINTCP=850,SRVERCP=037, *
RNAME=ECIPROG,USREXIT=NO
DFHCNV TYPE=SELECT,OPTION=DEFAULT
DFHCNV TYPE=FIELD,OFFSET=0,DATATYP=CHARACTER, *
DATALEN=27,LAST=YES
The SRVERCP should represent the EBCDIC code page in which the data is
stored within CICS. The CLINTCP should be the default code page for client
requests, but this can be overridden by information flowed from the CICS
Universal Client, which is determined from the code page of the client machine.
(Note that the CICS TG supplied CicsCpRequest object allows you to determine
the code page used by the CICS Universal Client). The DATALEN should be the
maximum length of the COMMAREA you require to be translated.
C
O
M
M
A
R
E
A