Invoking ASMXREF on CMS

On CMS you invoke ASMXREF with REXX EXECs.ASMXREF is supplied with the following CMS files:

Table 1. CMS Files Supplied with ASMXREF
File name File type Contents
ASMXSCAN EXEC A REXX EXEC that runs the program ASMXREF.
ASMXRPT EXEC A REXX EXEC that runs the program ASMXREP.
ASMXREF MODULE A program that scans the specified libraries and creates intermediate data files.
ASMXREP MODULE A program that reads the intermediate data files and creates the required reports.
ASMTEST CNTL A sample control file.
ASMTEST DATATOKN A sample token statement (XRFTOKN) file.
ASMTEST EXEC A sample source list file.
ASMTEST DEFAULTS Contains the default ASMXREF options.
ASMTEST DATALANG A sample XRFLANG file that contains:
  • The languages supported byASMXREF and a sample of language-specific exclude verbs.
  • The default tokens used by the TWU and SOR reports.
ASMXSEP EXEC A REXX EXEC that splits the TSP into its component files. For a description of splitting the TSP see Tagged Source Program (TSP).
Take the following steps to run ASMXREF:
  1. Before running ASMXREF make a copy of the following information files:
    • ASMTEST CNTL, the sample control file
    • ASMTEST DATATOKN, the sample token statement (XRFTOKN) file (used only with the TWU and SOR reports where it is optional)
    • ASMTEST EXEC, the sample source list file
    • ASMTEST DEFAULTS, the default options file
    • ASMTEST DATALANG, the sample language (XRFLANG) file
  2. Modify the details in each of these files to suit your ASMXREF run.
  3. Save each of the files with a new file name. They must all have the same file name, but retain the existing file type. For example:
    MYXREF CNTL
    MYXREF DATATOKN
    MYXREF EXEC
    MYXREF DEFAULTS
    MYXREF DATALANG
    Refer to the following sections for details of the information required in each of these files.
  4. Remove the comment characters from the appropriate FILEDEF XRFTOKN statement in the ASMXSCAN EXEC. For details of this statement see ASMXREF Token Statement File.
  5. When the information files have been created, run the ASMXSCAN EXEC to create the intermediate data files.
  6. Run the ASMXRPT EXEC to create each report that you need.

    For details on the format of the EXEC commands and details of the files created by these EXECs, see ASMXSCAN EXEC and ASMXRPT EXEC.