Editing your existing DFHTCT source

The first step in migrating your DFHTCT macros to the CSD file is to assemble the source. If your TCT is large, you might find it most convenient to assemble small segments of the source individually.

Each resource definition on the CSD file must belong to a CSD group. DFHCSDUP MIGRATE places all definitions in groups as it processes them.

You probably already have good reasons for grouping resources. For example, you might like to group TERMINAL definitions according to the physical location of the terminals, or according to the department or function of the people using them.

You can specify the names to be given to groups of definitions generated from your DFHTCT macros. You do this by adding special macro instructions to the table source. The rules for group names are given in the description of the GROUP attribute isee Terminal definition attributes). The form of each macro instruction is:
DFHTCT TYPE=GROUP,GROUP=xxxxxxxx            (up to 8 characters)

All definitions following a particular TYPE=GROUP macro statement are migrated into the named group in the CSD file. A new TYPE=GROUP statement overrides all previous ones.

If you do not insert such macros into your deck, the whole table is migrated into the same group on the CSD file. That group is, by default, named TCTxx, a substring of your table's name, DFHTCTxx.

It is better to create many small groups for your TERMINALs than one vast group. Aim to have no more than 100 resource definitions in any one group. (See How many resource definitions should a group contain?.)

You must include ACCMETH=VTAM® in your DFHTCT TYPE=INITIAL macro. This is to enable the necessary VTAM control blocks, for example the ACB, to be built as part of the TCT. Note that the default for the ACCMETH= operand is ACCMETH=NONVTAM.

Some information from the TYPE=INITIAL macro is not migrated, because it is now specified using the DFHSIT macro. For further guidance on this, see the CICS® System Definition Guide.