The CSD cross-referencing program

Use the CICS®-supplied sample CSD cross-referencing program to produce a cross-reference listing of the resource definitions defined in the group or list specified on the EXTRACT command. Run the DFH$CRFA version of the cross-referencing program if you are using assembler, the DFH0CRFC version if you are using COBOL, and the DFH$CRFP version if you are using PL/I.

The CICS-supplied sample CSD cross-referencing program produces a cross-reference listing of objects and keywords on the CSD. The data gathered by the EXTRACT command is passed to the sample program, where it is saved in a cross-reference table. On the final call to this sample program, the contents of the table are printed in collating sequence.

EXTRACT GROUP(group name) OBJECTS USERPROGRAM(program-name)

EXTRACT LIST(list name) OBJECTS USERPROGRAM(program-name)

For this program only, in addition to the EXTRACT command, you must define, in a sequential data set, the objects and keywords for which you want a cross-reference listing. The data set is read by the sample program using the ddname CRFINPT.

CRFINPT is a sequential file containing 80-byte records. Each record contains one object or keyword to be cross-referenced. You can cross-reference any valid resource type or attribute known to CEDA. For example, your CRFINPT file may contain the following entries (one per line):

Note that a maximum of ten entries can be included in the CRFINPT file when using the COBOL sample program, DFH0CRFC.

For each record in the file, a report is produced detailing the different values assigned to the keyword, where they are defined, and where they are used. Note that keyword values longer than 44 characters are truncated.

You should define the DCB subparameters for CRFINPT as DSORG=PS, RECFM=F, LRECL=80, and BLKSIZE=80.