Toolkit Feature Cross-Reference Facility

Edit online

The High Level Assembler Toolkit Feature Cross-Reference Facility (ASMXREF) supports your maintenance tasks by scanning assembler language source, macro definitions, and copy files for symbols, macro calls, and user-specified tokens. For details on ASMXREF see Using the Cross-Reference Facility.

You can use ASMXREF for identifying fields of application importance such as DATE, TIME, and YYMMDD. You can use an arbitrary match anything character (sometimes called a wildcard character) to create generic tokens such as "YY*"; the scan then searches for occurrences of the token with any other characters allowed in the position of the arbitrary character. You may also specify tokens to be excluded from a generic search, so that an exclude token such as SUMMER rejects matches of SUMMER when the include token is *MM*.

ASMXREF scans source code, in the following languages, for user-specified and default tokens:
  • Assembler
  • C
  • C++
  • COBOL
  • FORTRAN
  • PL/I
  • REXX
ASMXREF provides several reports:
Control Flow (CF) Report
The CF report tabulates all intermodule program references as a function of member or entry point name, and lists them in the order of the members referring to the subject entry point or the entry point names referred by the subject member.
Lines of Code (LOC) Report
Provides a count, arranged by part and by component, of the number of source lines and comments in the part, and the shipped source instructions (SSI), which are the number of instructions within each part scanned, both executable and non-executable, that are not spaces or comments. As well, the report shows the changed source instructions (CSI), which are the number of unique SSI that have been modified in each part categorized by added, changed, deleted, moved, and so on. In addition, the LOC Report provides a summary report of CSI arranged by programmer.
Lines of OO Code (LOOC) Report
Provides, for C++, the Lines of Code (LOC) per Class and per Object, and Objects per Class.
Macro Where Used (MWU) Report
Lists all macros invoked and all segments copied, including the type and frequency of the invocation or reference.
Symbol Where Used (SWU) Report
Lists all symbols referenced within the source members, and the type of reference. These symbols can be variables or macros.
Spreadsheet Oriented (SOR) Report
A comma-delimited file suitable for input into a standard spreadsheet application. It shows for each module scanned the number of lines of code, the number of occurrences of each token, and the total number of token matches. This information helps you identify the critical modules in an application and estimate the effort required for modifications.
Token Where Used (TWU) Report
Contains similar information to the SOR report, but in an easily readable format.

Before ASMXREF generates the TWU report, it creates a Tagged Source Program (TSP). This program contains special inserted comment statements where tokens are found, so that subsequent assembly of the tagged file helps you track important variables during control-flow analysis using ASMPUT, see Toolkit Feature Program Understanding Tool.