The DCMS Cross Reference Facility (XREF) is a self-maintaining information repository and query system that provides instantaneous access to comprehensive where-used information captured from your JCL and source program libraries.
The XREF Online Query allows analysts to perform error-free change impact analysis in seconds rather than hours or days. XREF eliminates the need for long running, inaccurate and difficult-to-interpret library scans.
XREF is a valuable tool for day-to-day analysis of your mainframe environment. It is indispensable when attempting to accurately decommission obsolete application components.
The product installer performs an initial load of the database, identifying the site libraries. XREF analyzes each member and builds a database of relevant information. The database is then kept current of library updates by using one of these techniques:
- The XREF Monitor, executed as a scheduled job or run continuously as a started task. It inspects the defined libraries periodically and identifies members that have been added, deleted or modified. The database is updated only as needed.
- Insert an XREF utility step to your automated change control process to update the database as production changes are being made. This provides up-to-the-minute accuracy.
The XREF Online Query provides precise, accurate and instantaneous answers to hundreds of questions, such as:
- Which Jobs/Proc's execute program FAPP120?
- Where is PROC GAPP090 executed?
- I need to expand a dataset. Which jobs, procs and programs use it?
- Which programs reference my DB2 table?
- Which jobs use PARMLIB member CURRDATE?
- Which programs call sub-program GETDATE?
- Which programs reference CICS map MAP001?
- Where is copybook GAPCMAST used?
- Which PROCs are executed in job GAPJ0190?
- Which programs are executed in job GAPJ1090?
- Which datasets are referenced in job GAPJ1090?
- Which jobs use JCL INCLUDE member CARIMAST?
- Which programs update the Billing Master file?
- Which programs will I have to compile and rebind before I can implement the Accounts Payable DB2 Table changes?
- Which datasets will be required for the upcoming disaster recovery test?
- Which datasets are used by jobs beginning with HAP*?
- Where do the load modules used in the JOB123 reside?
- Which object modules (CSECTs or subroutines) are linked to a particular load module?
- Where is a particular subroutine hard-linked to another program?
The XREF Online Query Facility presents information in two views:
Standard and Extended. A PF key permits the user to quickly switch from one view to the other.
- The Standard query shows each of the elements used by a given member in alphabetic sequence. Only one instance of an element is presented
even if it is used multiple times in the same member. When accessing by
element name, XREF shows all the members that reference the element at least once.
For example: Using a Standard query to determine which jobs and proc's reference a particular dataset would provide a list of all of the members in alphabetical sequence.
- The Extended query shows all references to a given element
name and presents each in the order it appears in the member. Each
instance shows additional relevant detail information such as stepname, program and DDname. When accessing by element
name, XREF shows each referencing member alphabetically and each instance as it appears in that member.
For example: Using an Extended query to determine which jobs and proc's reference a particular dataset would provide a list of all of the members containing the dataset name in alphabetical sequence along with the relevant stepname, program name and DDname.
- Wildcard Characters can be used to search for elements using partial names.
- XREF supports an unlimited number of libraries in PDS, PDS/E, CA-Librarian and CA-Panvalet library formats.
- The XREF batch print utility is provided, enabling you to produce the database information in hard-copy format.
- XREF provides the ability to use parallel databases. Up to 39 XREF databases can be defined, permitting separation of the data by company, division, department, application, etc.
XREF recognizes and cross-references library members of the following languages:
- COBOL – Determines file usage, called programs, CICS transactions and CICS maps.
- Assembler (BAL) – Determines file usage, called programs, CICS transactions and CICS maps.
- CA-Easytrieve – Determines file usage and called programs.
- SQL –When embedded within the above program types is analyzed to show the use of tables, databases and indices.
- MVS JCL – Procedures/Includes are expanded and symbolics are resolved to determine DSNs, executed programs and procedures and other JCL-related information.
XREF is available for any processor that supports the
z/OS operating system environment. The package consists
of batch and online components. The online components execute in the TSO/ISPF
environment. The DCMS proprietary DBMS is VSAM based and does not require DB/2.
The XREF installation package consists of programs, ISPF panels,
messages, skeleton JCL and complete documentation. Installation and customization
can easily be completed in a single day. Simply identify the libraries that contain your Jobs, Proc's and source programs to XREF. XREF will then take an inventory of all the modules and their relationships and build the initial database. From that point on XREF automatically updates the database whenever a member is updated on one of the defined libraries.
The XREF system can be downloaded directly from
the DCMS website
for a no
cost, no obligation trial.
The XREF license is renewable on a per processor
|| Describes the installation and components included with the Cross Reference System. Its intended use is for XREF Administrators.
|| Describes the day-to-day usage of the Cross Reference System. Its intended use is for general users of the XREF system.
|| Used by the installer when migrating to a new XREF release.