Conversion table for initial program verification (IVP)

When running the IVP jobs for CICS® Transaction Server for z/OS®, you need a conversion table.

Figure 1 is a simple example of a conversion table definition. You don't need to code all these macros. You can generate exactly the same conversion table by assembling the special macro, DFHCNV TYPE=IVP.

All the fields are character, so only a single TYPE=SELECT macro is needed. It specifies OPTION=DEFAULT, and has a single TYPE=FIELD macro to define the whole data record.

The TYPE=KEY macro is followed by a single TYPE=FIELD macro, which redefines the first six bytes of the data record.

Figure 1. Conversion table for IVP
   DFHCNV TYPE=INITIAL
   DFHCNV TYPE=ENTRY,RTYPE=FC,RNAME=FILEA,USREXIT=NO
   DFHCNV TYPE=KEY
   DFHCNV TYPE=FIELD,OFFSET=0,DATATYP=CHARACTER,DATALEN=6,LAST=YES
   DFHCNV TYPE=SELECT,OPTION=DEFAULT
   DFHCNV TYPE=FIELD,OFFSET=0,DATATYP=CHARACTER,DATALEN=80,LAST=YES
   DFHCNV TYPE=FINAL
 

Figure 2 shows a typical sequence of DFHCNV macros. The figure is annotated to show the sets of entries that correspond to resource entries, conversion templates, and key templates. (The indentation is to illustrate nesting. When coding the macros, as with all CICS resource definition macros, observe assembler rules.)

Figure 2. Example of DFHCNV macro sequence
The picture shows an example DFHCNV conversion table. The table begins with a DFHCNV TYPE=INITIAL macro and ends with a DFHCNV=FINAL macro. It specifies three resources for which conversion is required—a file, a temporary storage queue, and a transient data queue. The entry for each resource starts with a DFHCNV TYPE=ENTRY macro, on which the RTYPE operand specifies the resource type. Each entry contains one or more conversion templates.The entry for the file contains one key template and three conversion templates. The key template consists of a DFHCNV TYPE=KEY macro and a DFHCNV TYPE=FIELD macro. Each conversion template consists of a DFHCNV TYPE=SELECT macro, followed by one or more DFHCNV TYPE=FIELD macros.The entry for the temporary storage queue contains two conversion templates. Each conversion template consists of a DFHCNV TYPE=SELECT macro, followed by one or more DFHCNV TYPE=FIELD macros.The entry for the transient data queue contains one conversion template, consisting of a DFHCNV TYPE=SELECT macro followed by two DFHCNV TYPE=FIELD macros.


dfht8c0085.html | Timestamp icon Last updated: Sunday, 4 June 2017