Utilities

Utilities

This chapter describes the functionality provided in the Utilities option. Using this option, you can display and update your symbolic files (PROTSYM).

When you select option U of the Primary Option Menu, the Utilities Menu displays. This menu consists of three options - one for listing and displaying the contents of the symbolic file, one for adding listings to a symbolic file, and one for defining programs to be excluded from auto-monitoring.

This section contains the following topics:

Display the Contents of the Symbolic File

Add a Program to the PROTSYM File

Exclude Programs from Auto-monitoring

Display the Contents of the Symbolic File

After selecting option 1 from the Utilities Menu, the PROTSYM Member Selection panel displays:

------------- CA InterTest Batch PROTSYM Member Selection ---------------------
COMMAND ===>                                                 SCROLL ===> CUR 
-------------------------------------------------------------------------------
PROTSYM Dsname  ===> 'CAI.PROTSYM'                                   
-------------------------------------------------------------------------------
Cmd  Program   Date       Time       Size Language    Attributes              
     **************************** TOP OF DATA ********************************
     CAMRCOBB  12/03/2014 13:56:01     83 COBOL OS/390                        
     CAMRCOB2  12/03/2014 13:55:47    144 COBOL OS/390                        
     ITBMAIN   08/16/2014 08:46:02     16 COBOL II           
     ITBSUB1   08/06/2014 18:14:59     10 COBOL II           
    ***************************BOTTOM OF DATA ********************************

This panel lists the contents of a given PROTSYM file. From this panel you can enter a valid PROTSYM file in the PROTSYM Dsname field. This displays the contents of this symbolic file. An example is shown in the previous screen. This list displays the program name, the date and time that the program was compiled, the number of records in the PROTSYM that this member is using, the language that was used, and any attributes that the member has.

Using an S line command displays the listing for that particular program.

Add a Program to the PROTSYM File

After selecting option 2 of the Utilities Menu, the PROTSYM Add Program Listings panel displays. Populate a PROTSYM file with one or more listings using this panel.

The PROTSYM Add Program Listings panel contains the following fields:

PROTSYM Dsname

The name of the PROTSYM data set

Listing Dsname

The name of the listing data set

Library Type

The listing library data set type. Specify one of the following:

• PDS–Partitioned Data Set
• SEQ–Sequential Listing File
• PAN–CA-Panvalet Library
• LIB–CA-Librarian Library
• NDV–CA Endevor SCM Library

From Member

The starting member name for the listing data

To Member

The ending member name for the listing data set

View Messages

Identifies the message display options. Specify one of the following:

• ALL–Display all messages
• NONE–Display no messages
• RC–View a single message for each member containing the highest return code

To process just one member, enter the member name in the From Member field. To process a range of members, enter the starting member in the From Member field and the ending member in the To Member. You can also use a prefix ending with an asterisk wildcard to process several members with a common prefix.

You can process a range of members using a batch utility that is described in the member IN25SYMD in the CAMRPROC data set.

Exclude Programs from Auto-monitoring

After selecting option 3 of the Utilities Menu, the Excluded Programs panel displays.

Use this panel to restrict auto-monitoring of programs when wildcarding is used on the Monitor Control panel. Use a single trailing asterisk to define a prefix, if desired. If a program name or wildcarded prefix has been excluded, it can only be monitored by explicitly defining the full name on the Monitor Control panel. To see the list of program names that are already excluded by default, type DEFAULTS on the command line.