Previous Topic: Special ConsiderationsNext Topic: Contacting Technical Support


Utilities

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

After choosing option U of the Primary Option Menu, you will see the Utilities Menu. 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.

---------------------- CA InterTest™ Batch UTILITIES MENU --------------------- OPTION ===> Symbolic Utilities: 1 DISPLAY - List/Display PROTSYM File Contents 2 ADD - Add a Program Listing to a PROTSYM File Preferences: 3 EXCLUDE - Exclude Programs From "Auto-Monitoring" X EXIT - Return to Primary Option Menu PFkeys: HELP - Tutorial END - Exit

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/2001 13:56:01 83 COBOL OS/390 CAMRCOB2 12/03/2001 13:55:47 144 COBOL OS/390 ITBMAIN 08/16/2001 08:46:02 16 COBOL II ITBSUB1 08/06/2001 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:

--------------- CA InterTest™ Batch PROTSYM Add Program Listings --------------  COMMAND ===>  -------------------------------------------------------------------------------                                                                              Use this panel to add program listings to a symbolic file using the            listing post-processor.                                                                                                                                  PROTSYM Dsname    ===> 'CAI.PROTSYM'                                                                                                              Listing Dsname    ===> 'CAI.LIST'                                               Library Type   ===> PDS   (PDS, SEQ, LIB, PAN, or NDV)                                                                                                 From Member       ===> TESTPGM                                               To Member       ===>                                                                                                                                  View Messages     ===> ALL   (ALL, NONE, RC)                                                                                                            Press ENTER to add program listings to the PROTSYM file or END  to cancel      this operation.                                                            

From this panel you can populate a PROTSYM file with one or more listings. Enter the name of a symbolic file in the PROTSYM Dsname field. Enter the listing data set that you wish to add to the PROTSYM file in the Listing Dsname field. For the Library Type field, enter PDS for a partitioned data set, SEQ for a sequential file, LIB for a CA Librarian file, PAN for a CA Panvalet file, or NDV for a CA Endevor SCM file.

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.

Use the View Messages field to specify what type of feedback you would like after the PROTSYM file is updated. Enter ALL to receive all messages that the post-processor produces, enter RC to view just the return code from the post-processor, or enter NONE to view no messages from this run.

In addition, a batch utility exists to process a range of members. For more information on using this utility, see the member IN25SYMD in the CAIPROC data set.

Exclude Programs from Auto-monitoring

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

---------------- CA InterTest™ Batch EXCLUDED PROGRAMS Panel ------------------- OPTION ===> Enter program names that should be excluded from "automatic" monitoring. Programs listed here may only be monitored by specifying their full names explicitly on the Monitor Control Panel. ---------------------------- Excluded Programs -------------------------------- ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> -------------------------------- Notes -------------------------------------- 1 Use a single trailing asterisk "*" to define a prefix. 2 Some common names may already be excluded by your installation defaults. Type DEFAULTS on the command line and press ENTER to view these names.

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:

-------------- CA InterTest™ Batch EXCLUDED PROGRAM DEFAULTS ------------------- COMMAND ===> The following names have been excluded from auto-monitoring by your installation: ==> CAO*, CEE*, DFS*, DSN*, IBM*, IEF*, IEW*, IKJ*, ILB*, IGG*, ==> IGZ* ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==>

To have a program added to the default list, contact your installer.