gtpi1m6q | System Installation Support Reference |
A macro cross-reference listing is generated by running the DCRS, SORT, and DREF programs.
DCRS searches, according to specified search options, a single MVS library which must be a partitioned data set containing Basic Assembler Language (BAL) programs in card image format. PL/I program names are checked for exclusion from the report. Note that DCRS is not designed to read macro language or C language.
Three inputs are required by DCRS. The first is the scanning option which has already been discussed. Simply code the desired option onto the PARM parameter of the JCL EXEC statement. The second and third inputs describe the MVS PDS to be scanned. IN and INN are the input DD statements for DCRS. Both IN and INN should be coded with the same PDS name. The duplication is necessary because DCRS opens IN as a sequential data set, so that the directory blocks can be read. INN is opened as a partitioned data set so that the members contents can be read.
The sort program reads in the output data set produced by the DCRS program. Code DCRS's output data set as input on the SORTIN DD statement. On the SYSIN DD statement, pass the instructions that will sort the cards by character, in ascending order, on columns 1-25. The character in column 1 is assumed to be the DCRS scanning category.
The DREF has 2 inputs. First, an optional header can be included in the formatted output. Code the PARM parameter of the JCL EXEC statement with the desired string (as many as 100 characters). The second input is the temporary sequential data set created by the sort program, which contains alphabetically sorted records. Code the name of the data set on the IN DD statement.