Cross References

The Cross References function is used to cross check Entire Operations objects and produce a report from the data found.

This section describes how to generate cross reference reports in online and batch mode.

Related Topic:


Types of Cross Reference Reports

The types of cross references you can select from the Cross References menu are described in the following table.

Report Type Description
Exit Usage Lists user exits defined in your environment.

See also Example of User Exit Usage.

Symbol Table Usage Lists symbol tables used in networks and jobs.

Note:
The cross reference for symbol tables includes the symbol table usage for input conditions and for end-of-job symbol settings.

See also Example of Symbol Table Usage.

JCL Usage Lists JCL files used in networks and jobs.

See also Example of JCL Usage.

Node Usage Lists JCL nodes and execution nodes used in networks.

See also Example of Node Usage.

Symbol Search by Value Lists symbols that match a specified value.

See also Example of Symbol Search by Value.

List Undefined Objects Lists objects that are referenced by other objects which are not defined in your environment.

The missing definition of these objects might lead to errors during network activation.

Note:
JCL is not inspected for undefined symbols.

See also Example of Undefined Objects.

Resource Usage Lists resources used by active jobs.

See also Example of Resource Usage.

Generating Cross Reference Reports Online

This section describes how to generate cross reference reports online.

Report data is evaluated for the current day.

Start of instruction set To generate a cross reference report

  1. From the Main Menu, choose Cross References and press ENTER.

    Or:
    In the Command field of the Main Menu, type Option Code 9 or type XREF (see Direct Commands) and press ENTER.

    Or:
    You can skip this step if you know the number of the report type (for example, 7 for Resource Usage) you want to generate:

    In the Command field of the Main Menu, type Option Code 9.7 and press ENTER.

    A Cross References menu similar to the example below appears:

                                                                                   
     16.04.15                ***** Entire Operations *****                09:59:32 
     Owner EXAMPLE                 Cross References                User ID SAG     
     ------------------------------------------------------------------------------
                                                                                   
          Cross References                                                         
                                                                                   
       1  Exit Usage                                                               
       2  Symbol Table Usage                                                       
       3  JCL Usage                                                                
       4  Node Usage                                                               
       5  Symbol Search by Value                                                   
       6  List Undefined Objects                                                   
       7  Resource Usage                                                           
                                                                                   
                                                                                   
      
                                                                                   
                                                                                   
     Command => ____________________________________________________________       
                                                                                   
                                                                                  
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End                                                   Menu

    The menu displays a list of selectable report types.

  2. Select the type of cross reference for which you want to generate a report and press ENTER.

    Depending on the report type selected, proceed as described in the relevant step for:

    Exit Usage
    Symbol Table Usage
    JCL Usage
    Node Usage
    Symbol Search by Value
    List Undefined Objects
    Resource Usage

  3. Exit Usage: If you select Exit Usage from the Cross References menu and press ENTER, a window similar to the example below opens:

    +-----------------------------------------------+
    !                                               !
    !      Send Output to Printer ?  N (Y/N)        !
    !                                               !
    +-----------------------------------------------+

    Enter Y (Yes) or N (No) and press ENTER. N is the default setting.

    A screen similar to the example below appears:

     08.04.16                ***** Entire Operations *****                17:58:11 
                                     Usage of Exits                                
     ------------------------------------------------------------------------------
     Please mark one or several Types.                                             
                                                                                   
     Cmd  Type                                                                     
                                                                                   
     _    Input Condition Exits                                                    
     _    Resource Master Determination Exits                                      
     _    Master JCL and Natural Programs                                          
     _    End-of-Job Check Exits                                                   
     _    End-of-Job Action Exits                                                  
     _    Symbol Check Exits                                                       
     _    Symbol Prompt Exits                                                      
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
     Command => ____________________________________________________________       
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                      End

    Mark one of the fields to select the cross reference you want to display and press ENTER.

    A report output screen with a list of used user exits appears as shown in Example of User Exit Usage.

    If MORE appears at the top of the report screen, press ENTER to display additional pages of the report.

    Press PF3 to exit the report screen.

  4. Symbol Table Usage: If you select Symbol Table Usage from the Cross References menu and press ENTER, a screen similar to the example below appears:

     30.06.12                ***** Entire Operations *****                14:31:58 
                                                                                   
               Symbol Table Usage                                                  
                                                                                   
     Owner        ==> __________   (Blank for all, * for selection                 
     Symbol Table ==> __________   or * and PF4 to process all                     
                                   matching objects)                               
     Usage in active jobs  ==> N   (Y/N)                                           
                                                                                   
     Destination           ==> 1                                                   
        1 - Screen  2 - Printer  3 - PC  4 - PC-CSV                                
                                                                                   
     Enter------PF3------PF4-------------------------------------------------------
                End      Apply

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press PF4.

    A report output screen with a list of used symbol tables appears as shown Example of Symbol Table Usage.

    If MORE appears at the top of the report screen, press ENTER to display additional pages of the report.

    Press PF3 to exit the report screen.

  5. JCL Usage: If you select JCL Usage from the Cross References menu and press ENTER, a window similar to the example below opens:

    +---------------------------------------------------------------------------+
    !                                                                           !
    !                                JCL Usage                                  !
    !                                                                           !
    !  Enter selection criteria (with * Wildcard) or blank for all              !
    !                                                                           !
    !  File/Natlib    : ______________________________________________________  !
    !  Member         : ________                                                !
    !  JCL Location   : ___                                                     !
    !                                                                           !
    !                                                                           !
    !  Enter------PF3---------------------------------------------------------  !
    !             End                                                           !
    +---------------------------------------------------------------------------+

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press ENTER.

    An additional window similar to the example below opens:

    +--------------------------------------------------------------+
    |                                                              |
    |  JCL Usage                                                   |
    |                                                              |
    |  Owner......: EXAMPLE___    (Blank for all, * for selection  |
    |  Network....: B60-FLOW__     or * and PF4 to process all     |
    |  Version....: __________     matching objects)               |
    |                                                              |
    |                                                              |
    |  Destination: 1                                              |
    |     1 - Screen  2 - Printer  3 - PC  4 - PC-CSV              |
    |                                                              |
    | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9--- |
    |       Help        End   Apply Accpt                          |
    +--------------------------------------------------------------+

    Use the input fields to specify selection criteria for the report to be produced as described in Fields and Columns: Cross References.

    When you are finished, press PF4 or PF5 (see also Confirming Selections in the section Reporting).

    A report output screen with a list of used JCL appears as shown in Example of JCL Usage.

    If MORE appears at the top of the report screen, press ENTER to display additional pages of the report.

    Press PF3 to exit the report screen.

  6. Node Usage: If you select Node Usage from the Cross References menu and press ENTER, a window similar to the example below opens:

    +---------------------------------------------------------------------------+
    !                                                                           !
    !                                Node Usage                                 !
    !                                                                           !
    !  JCL Node        ==> _____     (Blank for all                             !
    !  Execution Node  ==> _____     or * for selection)                        !
    !                                                                           !
    !  Usage in master or active jobs ==> M  ('M' -  Master; 'A' - Active)      !
    !                                                                           !
    !  Enter------PF3---------------------------------------------------------- !
    !             End                                                           !
    !                                                                           !
    !                                                                           !
    +---------------------------------------------------------------------------+

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press ENTER.

    An additional window similar to the example below opens:

    +--------------------------------------------------------------+
    |                                                              |
    |  Node Usage                                                  |
    |                                                              |
    |  Owner......: EXAMPLE___    (Blank for all, * for selection  |
    |  Network....: B60-FLOW__     or * and PF4 to process all     |
    |  Version....: __________     matching objects)               |
    |                                                              |
    |                                                              |
    |  Destination: 1                                              |
    |     1 - Screen  2 - Printer  3 - PC  4 - PC-CSV              |
    |                                                              |
    | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9--- |
    |       Help        End   Apply Accpt                          |
    +--------------------------------------------------------------+

    Enter the required selection criteria. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press PF4 or PF5 (see also Confirming Selections in the section Reporting).

    A report output screen with a list of used nodes appears as shown in Example of Node Usage.

    If MORE appears at the top of the report screen, press ENTER to display additional pages of the report.

    Press PF3 to exit the report screen.

  7. Symbol Search by Value: If you select Symbol Search by Value from the Cross References menu and press ENTER, a screen similar to the example below appears:

                             Symbol Search by Value                           
                                                                              
     Owner        ==> EXAMPLE___            (Blank for all, * for selection   
     Symbol Table ==> __________             or * and PF4 to process all      
     Version      ==> __________             matching objects)                
                                                                              
     Symbol       ==> ________________________________________                
     Mult.value index:  From ==> ___   To ==> *__                             
     Usage in:  Master ==> _  Active ==> _                                    
                                                                              
                                                                              
     Case sensitive ==> _       At position ==> *_ (*,nn,E)                   
                                                                              
     Scan for ==> ____________________________________________________________
                  1...+...10....+...20....+...30....+...40....+...50....+...60
                                                                              
     Destination    ==> 1                                                     
        1 - Screen  2 - Printer  3 - PC  4 - PC-CSV                           
    Enter------------PF3-----PF4-------------------------------------------   
                     End     Apply

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press PF4 (see also Confirming Selections in the section Reporting).

    A report output screen with a list of used symbols appears as shown in Example of Symbol Search by Value.

    If MORE appears at the top of the report screen, press ENTER to display additional pages of the report.

    Press PF3 to exit the report screen.

  8. List Undefined Objects: If you select List Undefined Objects from the Cross References menu and press ENTER, a window similar to the example below opens:

    +---------------------------------------------------------------------------+
    |                                                                           |
    |                  List Undefined Objects                                   |
    |                                                                           |
    |  Mark the referenced object types to be inspected                         |
    |                                                                           |
    |  Symbol        : X              Network     : X                           |
    |  Symbol Table  : X              Job         : X                           |
    |  Resource      : X              Schedule    : X                           |
    |  Calendar      : X                                                        |
    |                                                                           |
    |  Enter------PF3---------------------------------------------------------  |
    |             End                                                           |
    +---------------------------------------------------------------------------+

    All object types for which you can search are selected by default. Deselect the object type(s) you do not require by entering a blank character in the corresponding input field.

    When you are finished, press ENTER.

    An additional window similar to the example below opens:

    +--------------------------------------------------------------+
    |                                                              |
    |    List Undefined Objects                                    |
    |                                                              |
    |  Owner......: __________    (Blank for all, * for selection  |
    |  Network....: __________     or * and PF4 to process all     |
    |  Version....: __________     matching objects)               |
    |                                                              |
    |                                                              |
    |  Destination: 1                                              |
    |     1 - Screen  2 - Printer  3 - PC  4 - PC-CSV              |
    |                                                              |
    | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9--- |
    |       Help        End   Apply Accpt                          |
    +--------------------------------------------------------------+
    

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press PF4 or PF5 (see also Confirming Selections in the section Reporting).

    A report output screen with a list of used undefined objects appears as shown in Example of Undefined Objects.

    Press ENTER to display additional pages of the report (if available), or PF3 to exit the report screen.

  9. Resource Usage: If you select Resource Usage from the Cross References menu and press ENTER, a window similar to the example below opens:

    +------------------------------------------------------+ 
    |                                                      | 
    |  Resource Usage                                      | 
    |                                                      | 
    |  Resource...: ____________________                   | 
    |  (Blank for all, * for selection                     | 
    |   or * and PF4 to process all                        | 
    |   matching objects)                                  | 
    |                                                      | 
    |                                                      | 
    |                                                      | 
    |                                                      | 
    |                                                      | 
    | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8- | 
    |                   End   Apply Accpt                  | 
    +------------------------------------------------------+

    Specify the resource(s) to be checked: for valid input values, see the Resource field in Fields: Cross References.

    When you are finished, press PF4 or PF5 (see also Confirming Selections in the section Reporting).

    An additional window similar to the example below opens:

    +--------------------------------------------------------------+
    |                                                              |
    |  Resource Usage                                              |
    |                                                              |
    |  Owner......: __________    (Blank for all, * for selection  |
    |  Network....: __________     or * and PF4 to process all     |
    |  Version....: __________     matching objects)               |
    |                                                              |
    |                                                              |
    |  Destination: 1                                              |
    |     1 - Screen  2 - Printer  3 - PC  4 - PC-CSV              |
    |                                                              |
    | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9--- |
    |       Help        End   Apply Accpt                          |
    +--------------------------------------------------------------+
    

    Enter the selection criteria required for the report to be produced. For valid input values, see Fields and Columns: Cross References.

    When you are finished, press PF4 or PF5 (see also Confirming Selections in the section Reporting).

    A report output screen with a list of used resources appears as shown in Example of Resource Usage.

    Press ENTER to display additional pages of the report (if available). Press PF11 or PF10 to scroll right or left in the screen.

    Press PF3 to exit the report screen.

Fields and Columns: Cross References

The input fields for specifying selection criteria and output options for the cross reference report to be produced are explained in the following table. The input fields correspond to the columns contained on the report output screen.

Depending on the report type (to be) produced, the following fields and columns are available:

Field/Column Explanation
Owner Name of an owner or a range of names: use an asterisk (*) or a smaller/greater than (< or >) wildcard character to determine a start or an end value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Leave the field blank to select all names.

Network Name of a network or a range of names: use an asterisk (*) or a smaller/greater than (< or >) wildcard character to determine a start or an end value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Leave the field blank to select all names.

Network Version Name of a network version or a range of names: use an asterisk (*) or a smaller/greater than (< or >) wildcard character to determine a start or an end value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Leave the field blank to select all names.

Symbol Table Name of a symbol table or a range of names: use an asterisk (*) or a smaller/greater than (< or >) wildcard character to determine a start or an end value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Leave the field blank to select all names.

Symbol Table Version Version of the specified symbol table.
Destination See Report Output Options in the section Reporting.
Resource Name of a resource.

This can reflect real resources or can describe a fictitious resource.

Enter a resource name or a range of names: use an asterisk (*) or a wildcard character (< or >) to determine a start or an end value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Leave the field blank to select all names.

User Exit Usage reports only:  
Job Name of the job using the user exit.
ExitLib Name of the library that contains the user exit.
Exit Name of the user exit.
Enabled Depending on the type of user exit selected, indicates whether the user exit is enabled (Y) or disabled (N).
BG

This column is only shown for symbol prompt exits. It indicates whether symbol prompting runs in the background:

Y Symbol prompting runs in the background.
N A window prompts the user for input.
B Performs both opens a prompt window and then runs prompting in the background.

See also Specifying User Exits for Symbol Modification.

Type Type of user exit(s) to be selected:

Input condition exits
Resource master determination exits
Master JCL and Natural programs
End-of-Job (EOJ) check exits
End-of-Job (EOJ) action exits
Symbol check exits
Symbol prompt exits

Symbol Table Usage reports only:
Usage in active jobs Jobs to be searched.
Possible values:
N Selects master jobs only (default).
Y Selects both master jobs and active jobs.
JCL Usage reports only:
JCL Location A supported JCL location.

All possible locations are described in List of JCL Locations in the section Job Maintenance.

Leave the field blank to select all locations.

File/Natlib Name of a file or a Natural library, or a range of names: use an asterisk (*) to determine a start value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Note:
The search for names is case-insensitive. Example: ab, aB, Ab, AB are all assumed to be the same.

Member Name of a member or a range of names: use an asterisk (*) to determine a start value (see also Valid Name Specifications in Direct Commands) or open a selection list of names.

Note:
The search for names is case-insensitive. Example: ab, aB, Ab, AB are all assumed to be the same.

Node Usage reports only:
JCL Node Name of a JCL node.

Enter an asterisk (*) to select a name from a list.

Execution Node Name of an execution node or a range of names.

Leave the field blank to select all names.

Usage in master or active jobs Jobs to be selected
Possible values:
M Selects master jobs only (default).
A Selects active jobs only.
Symbol Search by Value reports only:
Symbol Symbol for which to search.

Leave the field blank to select all symbols.

Usage in: Master/Active Symbols in which to search.

Mark Master (default) and/or Active with any character to search in master symbols, active symbols, or in both.

Mult. value index: From/To Index range for symbols to which multiple values are assigned.

From: Minimum index value in the range from 1 through 100

To: Maximum index value in the range from 1 through 100 or * for all multiple values available

Default range: 1 to *
At position Position within the symbol value to be searched.
Possible input values:
* Anywhere within the symbol value (default)
nn At the exact position:

nn is any value in the range from 1 through 80

at beginning At the beginning of the symbol value
E At the end of the symbol value
Scan for Scan value.

Searches in a symbol value for a string of up to 60 characters

Case sensitive Mark this option with any character to perform a case-sensitive search.
Undefined Objects reports only:
This report inspects specified objects (symbol, symbol, table, resoure, calendar, network, job and/or schedule) to determine which objects are referenced but not defined in your environment.

Note:
We recommend that you view this report in Entire Operations GUI Client which provides a graphical structure that helps interpret the output more easily.

The columns in the GUI report are arranged in hierarchical order of object types from left (superior objects) to right. The corresponding items in the CUI report are arranged in a reverse order (subordinate object first).

Resource Usage reports only:
Type Type of resource
Possible values:
U Not reusable, quantitative
R Reusable, quantitative
N Not quantitative (absolute)
Initial Qty Initial quantity

Total amount of the resource defined to the system

Used Qty Used quantity

Amount of resource currently used by running job

Used by Owner The active job, used by owner
Used by Network The active job, used by network
Run Run job
Job Active job
Start usage Date and time of the allocation

(If this column is not displayed, use PF11 to scroll to the right of the screen.)

See also Date and Time Formats.

Examples of Cross Reference Reports

This section contains examples of all types of reports you can generate with the Cross References function:

Example of User Exit Usage

The following is an example of a cross reference report for Exit Usage:

17-02-12                ***** Entire Operations *****                10:57:21
                            Input Condition Exits                            
                                                                             
Owner      Network    Version    Job        ExitLib  Exit                    
---------- ---------- ---------- ---------- -------- --------                
                                                                             
EXAMPLE    B60-FLOW              JOB-1-TEST SYSEXT   EXT-CXML                
EXAMPLE    E50-USRT              E50-J1-IC  SYSEORU  URD-UIC                 
INCIDENT   I5045008              I50450081  EOR-T531 I5045008                
NATQA5     A                     WILLI1     NOPNET   AAEVIT1                 
NATQA5     NET1432C              JOB-01     NOPNET   N1432X01                
NATQA5     NET2240A              D002       NOPNET   N2240X01                
NATQA5     NET2552A              J001       EOR-T543 ICDUM001                
NATQA5     NET2552B              J001       EOR-T543 ICDUM002                
NATQA5     NET2552C              J001       EOR-T543 ICDUM002                
NOPALL     N2240A                D002       EOR-T543 N2240X01

All user exits of the specified type (here: input condition) and the jobs that reference these exists are listed in the report.

The columns contained in the report are described in Fields and Columns: Cross References.

Example of Symbol Table Usage

The following is an example of a cross reference report for Symbol Table Usage:

MORE                                                
 30.06.12    Entire Operations    14:33:11          
             Symbol Table Usage  Page    1          
                                                    
                                                    
   Owner         TESTBED                            
   Symbol Table  NET01                              
                                                    
Owner      Network    Version    Run     Job        
---------- ---------- ---------- ------- ---------- 
TESTBED    NET01                                    
TESTBED    NET01                         COLLECT1   
TESTBED    NET01                         EXE1       
TESTBED    NET01                         EXIT1      
TESTBED    NET01                         EXIT1-CHK  
TESTBED    NET01                         EXIT2      
TESTBED    NET01                         EXIT2-CHK  
TESTBED    NET01                         FIRST      
TESTBED    NET01                         LAST       
TESTBED    NET01                         PRQ-CHK    
TESTBED    NET01                         USR01-DEF  
TESTBED    NET01                         USR02-DEF  
TESTBED    NET01                         USR02-GINV 
TESTBED    NET01                         USR03-DEF

All networks and jobs that use the specified symbol table are listed in the report.

The columns contained in the report are described in Fields and Columns: Cross References.

Example of JCL Usage

The following is an example of a cross reference report for JCL Usage:

MORE                                                                           
06.05.15                       Entire Operations                    Page:     1
Owner: EXAMPLE                     JCL Usage                                   
Network    Version    Job        JCL Location/File/Member                      
---------- ---------- ---------- ----------------------------------------------
B60-FLOW              JOB-01     MAC/EOR-T541/B60-M02                          
B60-FLOW              JOB-012    MAC/EOR-T541/B60-M01                          
B60-FLOW              JOB-013    MAC/EOR-T541/B60-M01                          
B60-FLOW              JOB-014    MAC/EOR-T541/B60-M01                          
B60-FLOW              JOB-019    MAC/EOR-T541/B60-M01                          
B60-FLOW              JOB-02     MAC/EOR-T541/B60-M02                          
B60-FLOW              JOB-03     NAT/EOR-T531/B60-P01                          
B60-FLOW              JOB-04     MAC/EOR-T541/B60-M01                          
B60-FLOW              JOB-06     MAC/EOR-T541/B60-M02

All JCL files and referencing jobs are listed for the specified selection.

The columns contained in the report are described in Fields and Columns: Cross References.

Example of Node Usage

The following is an example of a cross reference report for Node Usage:

MORE                                                                     
 06.05.15               Entire Operations                     13:38:46   
               JCL node and/or Execution node usage          Page    1   
                                                                         
Owner      Network    Version    Job        Job Type   JCL Node Exec.Node
---------- ---------- ---------- ---------- ---------- -------- ---------
EXAMPLE    B60-FLOW              ABC3A      JOB                 N0194    
EXAMPLE    B60-FLOW              JOB-01     JOB        N0194    N0082    
EXAMPLE    B60-FLOW              JOB-012    JOB        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-013    JOB        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-014    JOB        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-015    DUM        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-019    JOB        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-02     JOB        N0194    N0082    
EXAMPLE    B60-FLOW              JOB-03     NAT        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-04     JOB        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-05     DUM        N0194    N0194    
EXAMPLE    B60-FLOW              JOB-06     JOB        N0194    N0194    
EXAMPLE    B60-FLOW              MILE1-TEST JOB                 N0194

All nodes and referencing jobs are listed for the specified selection.

The columns contained in the report are described in Fields and Columns: Cross References.

Example of Symbol Search by Value

The following is an example of a cross reference report for Symbol Search by Value:

MORE                                                                           
 09.05.15                ***** Entire Operations *****                11:38:26 
                          Search Symbol by Value                    Page     1 
                                                                               
                                                                               
Owner      Symbol Table Symbol                MV F Network      Run Symbol Valu
---------- ------------ -------------------- --- - ---------- ----- -----------
EXAMPLE    ADMIN        CLASS                    A                  G          
EXAMPLE    ADMIN        DATE                     D                  19970207   
EXAMPLE    ADMIN        LOWER                    L                             
EXAMPLE    ADMIN        MSGCLASS                 A                  X          
EXAMPLE    ADMIN        MULT                   1 A                  1          
EXAMPLE    ADMIN        MULT                   2 A                  2          
EXAMPLE    ADMIN        MULT                   3 A                  3          
EXAMPLE    ADMIN        MULT                   4 A                  4          
EXAMPLE    ADMIN        MULT                   5 A                  5          
EXAMPLE    ADMIN        MULT                   6 A                  6          
EXAMPLE    ADMIN        MULT                   7 A                  7          
EXAMPLE    ADMIN        MULT                   8 A                  8          
EXAMPLE    ADMIN        MULT                   9 A                  9          
EXAMPLE    ADMIN        MULT                  10 A                  10         
EXAMPLE    ADMIN        NUMBER                   N                  7          
EXAMPLE    ADMIN        UPPER                    U                             
EXAMPLE    EX-ST-COMN   CLASS                    A                  G          
EXAMPLE    EX-ST-COMN   CLASS-K                  A                  K

All symbols defined in the specified symbol table are listed in the report.

The columns contained in the report are described in Fields and Columns: Cross References.

Example of Undefined Objects

The following is an example of a cross reference report for List Undefined Objects:

26.04.16                      Entire Operations                       11:58:20
                           List Undefined Objects                             
                                                                              
  Network : NM-2, OW-SAG referenced by                                             
  Master Job : JM-1B NM-1B, OW-SAG                                                  
  Condition : EXT-1                                                           
                                                                              
  Symbol : TEST1 ,OW-SAG referenced by                                           
  Master Job : JM-1B NM-1B, OW-SAG                                                  
  EOJ Checking : --

All objects that are referenced but not defined in your environment are listed in the report.

In the example above, the following undefined objects are found for the owner OW-SAG:

  • The network NM-2 is referenced in the input condition EXT-1 of the job JM-1B in the network NM-1B.

  • The symbol TEST1 is referenced in the EOJ checking of the job JM-1B in the network NM-1B.

The fields contained in the report are described in Fields and Columns: Cross References.

Example of Resource Usage

The following is an example of a cross reference report for Resource Usage:

                                                Entire Operations: Resource Usa
-------------------------------------------------------------------------------
                           Initial       Used     used by                      
 Resource          Type        Qty        Qty Owner      Network      Run Job  
 BOA-RES              R      20.00       5.00 XSETABO1   IMPXP2      2635 JOB2 
 BOA-RES              R      20.00       5.00 XSETABO1   IMPXP2      2636 JOB2 
 BOA-RES              R      20.00       5.00 XSETABO1   IMPXP2      2638 JOB2 
 BOA-RES              R      20.00       5.00 XSETABO1   IMPXP2      2639 JOB2 
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21864 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21865 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21866 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21867 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21868 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21869 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21870 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21871 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21872 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21873 J03-K
 DEA1-KEEP-01         R     100.00       3.00 SN         RES-DEA1   21874 J03-K
 NPR-INSTALL          R       1.00       1.00 NOPALL     N2029D        85 J00-D
 ************************************ m o r e *********************************
                                                                               
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                  End                           Down        Left  Right Menu

All resources and referencing active jobs are listed for the specified selection.

The columns contained in the report are described in Fields and Columns: Cross References.

Generating Cross Reference Reports in Batch

This section describes how to generate cross reference reports in batch mode.

User Exit Cross Reference Reports in Batch

Start of instruction setTo produce the user cross reference report in batch

  • Run XRUR---P in a standard batch Natural job with LFILEs 131 and 216 assigned and printer file 1 correctly defined.

The program has no input parameters.

Symbol Table Cross Reference Reports in Batch

Start of instruction setTo produce the symbol table cross reference report in batch

  • Run XRSYT--P in a standard batch Natural job with LFILEs 131 and 216 assigned and printer file 1 correctly defined.

    Syntax:

    XRSYT--P
    owner-name,symbol-table-name,symbol-table-version,active-job

The program does 1 input:

  • Owner, Symbol Table, Symbol Table Version, Active Jobs

The following examples assume the Natural parameters IM=D, ID=,:

XRSYT--P
PROD,ABC*,*,M

This will produce a list of master symbol tables of owner PROD with names starting with ABC.

JCL Cross Reference Reports in Batch

Start of instruction setTo produce the JCL cross reference report in batch

  • Run XRJCL--P in a standard batch Natural job with LFILEs 131 and 216 assigned and printer file 1 correctly defined.

Syntax:

XRJCL--P
file/natlib,member,jcl-location
owner-name,network-name,network-version

The program does 2 inputs:

  1. File/Natlib, Member, JCL Location

  2. Owner, Network, Network Version (for future use)

The following examples assume the Natural parameters IM=D, ID=,:

Example 1:

XRJCL--P
PROD1.JOBLIB,IEB*
SYS*,W,*

This will produce a list of all jobs in networks with names less than W under owners beginning with SYS that use JCL members beginning with IEB in data set PROD1.JOBLIB.

Example 2:

XRJCL--P
SYS*,*,NAT
*,*,*

This will produce a list of all jobs which use JCL in Natural libraries beginning with SYS.

Node Cross Reference Reports in Batch

Start of instruction setTo produce the node cross reference report in batch

  • Run XRNDU--P in a standard batch Natural job with LFILEs 131 and 216 assigned and printer file 1 correctly defined.

Syntax:

XRNDU--P
jcl-node,execution-node,master/active-jobs
owner-name,network-name,network-version

The program does 2 inputs:

  1. JCL Node, Execution Node, active Jobs Master/Active

  2. Owner, Network, Network Version

The following examples assume the Natural parameters IM=D, ID=,:

Example:

XRNDU--P
517,517,M
SYS*,W,*

This will produce a list of master jobs in networks with names less than W under owners beginning with SYS that use JCL node 517 and execution node 517.

Undefined Objects Reports in Batch

Note that a version name (void) might occur for an object, if no version usage is defined for the object that is valid on the determination date. The default value of the determination date is the start of the users Entire Operations session.

Start of instruction setTo list undefined objects in batch

  • Run XRNDF—P in a standard batch Natural job

Syntax:

XRNDF—P

Specification of the object types to be inspected:

P-CHECK-SYMBOL ‘X’ = search for undefined symbols.
P-CHECK-SYMTAB ‘X’ = search for undefined symbol tables.
P-CHECK-NETWORK ‘X’ = search for undefined networks.
P-CHECK-JOB ‘X’ = search for undefined jobs.
P-CHECK-RESOURCE ‘X’ = search for undefined resources.
P-CHECK-SCHEDULE ‘X’ = search for undefined schedules.
Field Explanation
Owner Owner name. *, > and < wildcards are allowed. Use * for all owners.
Network Network name. *, > and < wildcards are allowed. Use * for all networks.
Network Version Network Version name. *, > and < wildcards are allowed. Use * for all network versions.

Resource Usage Reports in Batch

Start of instruction setTo produce the resource usage cross reference listing in batch

  • Run XRRES--P in a standard batch Natural job with LFILEs 131 and 216 assigned and printer file 1 correctly defined.

Syntax:

XRRES--P 
Resource-name
owner-name,network-name,network-version

The program does two inputs:

  1. Resource

  2. Owner, Network, Network Version

The following examples assume the Natural parameters IM=D, ID=,:

XRRES--P
RES*
PROD,ABC*,*

This will produce a list of all jobs of owner PROD with names starting with ABC using a resource beginning with RES.