Finding Symbol Tables Associated with Jobs and Networks

You can list all symbol tables available for use in a job or a network, and list all symbol tables already used by a job or a network.

This document covers the following topics:


Listing Usable Symbol Tables

You can list all symbol tables that can be used by a job or a network.

Start of instruction setTo list symbol tables available for a job or network

  1. In the object workspace, select a job or a network instance.

  2. Open the context menu and choose Usable Symbol Tables.

    A Usable Symbol Tables window similar to the example of an active job below opens:

    graphics/UsableSymbolTables.png

    This window lists all symbol tables which can be used by the current object (network, job master, job active). The example above lists the symbol tables that can be used by the active job J07.

    The columns in the window are explained in Columns: Usable Symbol Tables.

The symbol tables are listed in descending hierarchical order, that is, the topmost symbol table is used first during symbol replacement.

For information on all types of symbol tables available and the search order that applies when replacing symbols, see Symbol Table Types and Symbol Search Order.

This section covers the following topics:

Columns: Usable Symbol Tables

The columns contained in the Usable Symbol Tables window are described in the following table:

Column Description
Type Type of the symbol table: see Symbol Table Types and Symbol Search Order.
Owner Owner of the symbol table.
Symbol Table Name of the symbol table.
Version Version of the symbol table.
Network For active job networks only.

Active network which uses the symbol table.

Version For active job networks only

Version of the active network which uses the symbol table.

Run For active job networks only.

Run number of the active job network.

Listing Jobs and Networks that Use a Symbol Table Master

You can list all jobs and networks that use a symbol table master. This is required, for example, if you cannot delete a symbol table because it still uses one or more jobs. You then need to find these jobs and change their symbol table settings or delete the jobs.

Note:
This function only shows the references of a network or job to a master symbol table if it has been explicitly defined. You can use the cross-reference function Symbol Table Usage (see Generating Cross-Reference Reports Online) to get a list of all references to a master symbol table including the references contained in input conditions and End-of-Job actions.

Start of instruction setTo list of jobs and networks that use a symbol table master

  • In the object workspace, select a Symbol Table Master instance and select Where used from the context menu.

    A Where used Symbol Table Master window similar to the example below opens:

    graphics/whereused_symboltablemaster.png

    The window lists all networks and jobs that use the selected symbol table master (here: EXAM-TABLE) of the specified owner (here: SAGTEST).

    All symbol table versions defined for the selected symbol table are listed.

    The columns in the window are explained in Fields and Columns: Symbol Table Usage.

Start of instruction setTo open a list of jobs and networks that use an active symbol table

This section covers the following topics:

Columns: Symbol Table Usage

The columns contained in the Where used Symbol Table Master or Active Usage Symbol Table Active window are explained in the following table:

Column Description
Network  Name and version of the job network.
Job  Name of the job that uses the symbol table.

A dash (-) or a blank indicates that the symbol table is specified in the network definition.

Type Indicates whether a job master or job active, or a network master/version or network active uses the symbol table.

For possible column entries, see the Symbol Table Type table column described in Symbol Table Types and Symbol Search Order.

Run  If the symbol table is used by an active job, this field displays the job's run number.
SymTab Version Named version (if defined) or reserved name of the symbol table.

For possible column entries, see Reserved Version Names for Symbol Tables.