Log One or More Terminals

Log Function › Log One or More Terminals

Log One or More Terminals

You have the option of logging a test stream on the terminal on which you are operating CA Verify, on another terminal, or on multiple terminals.

Follow these steps:

If you specify T on the Log Options Menu or L.T on the Primary Options Menu, CA Verify for CICS displays the Single Terminal Log menu. You can also display this menu typing XTCA L.T when you invoke CA Verify for CICS from CICS.
```
 --------------------------  SINGLE TERMINAL LOG  --------      --------13:45:18
 ENTER COMMAND ===>                                                           L1
                                                                                
 LOG TEST STREAM AS:                                                            
   DDNAME      ===> TCADS                                                       
   APPLICATION ===>                                                         
   MEMBER      ===>                                                     
   VERSION     ===> 001                                                         
                                                                                
 DESCRIPTION ===>                            
             ===>                                                               
             ===>                                                               
                                                                                
 STOP OPTION                     ===> man  (MAN, PF__, PA_, OR CLEAR)           
 PROCESS WITH RULES              ===> N    (Y/N)                               
 TEST STREAM PROTECTION          ===>      (R-READ W-WRITE P-PRINT)             
 LOG INPUT SCREENS ONLY          ===> N    (Y/N)                               
 EXTEND TEST STREAM              ===> N    (Y/N)                    
                                                                                
                                                                               
 RULESET NAME:                                                                  
                                                                                
                                                                                
 F1-HELP     F3-END     F4-RETURN                                              
```
VSE User Note:

Test streams under MVS specify ddname fields, while test streams under VSE specify FILENAME fields. VSE users should substitute FILENAME for ddname wherever ddname occurs in this guide.

Default values, specified when CA Verify for CICS is installed, will appear for the following fields: ddname, Application, Version, Stop Option, and Extend Test Stream.

The ddname, Application, Member, Version, and Description fields are required to identify the test stream.

DDNAME

The ddname of the file to which the test stream will be logged. Specify one to eight alphanumeric or national characters. The first character cannot be numeric. This file must be allocated in the JCL for CICS.

APPLICATION

The group to which the test stream belongs; e.g., an application, department, project, etc. Specify one to eight alphanumeric or national characters. The first character cannot be numeric.

MEMBER

The specific test stream; e.g., a screen or program. Specify one to eight alphanumeric or national characters. The first character cannot be numeric.

VERSION

The test stream version when multiple versions of the test stream have the same name. Specify one to three numeric characters.

DESCRIPTION

The comments that describe the test stream. Specify up to three lines of information. You may want to use this field to document files which must be restored when the test stream is run. This field is ignored when the Extend Test Stream option is Y.

STOP OPTION
The option which will terminate logging:

MAN

Logging terminates when you manually stop logging in one of two ways:
- Clear your screen and type XTCA STOP
- Use the Inquiry function to display a list of all active logging and select the logging you wish to terminate. See the Inquiry function chapter for more details.
  Only the person who invoked logging or a security administrator can terminate logging using the Inquiry function.
  
  Note: The MAN option can always be used to stop logging even if you select another Stop option.
PFxx/Pax

Logging terminates when you press the specified PF or PA key.

CLEAR

Logging terminates when you clear your screen.
PROCESS WITH RULES

This field allows you to apply a ruleset to this logging session. If Y is typed in this field, a list of available rulesets will appear when you press Enter. These rulesets contain rules that specify user IDs, terminals, or transaction IDs that are to be included or excluded from the test stream. If you do not wish to apply a ruleset to this logging session, leave N as the default.

Note: L.T Only applies transaction rule actions; terminal and user rule actions are ignored.

TEST STREAM PROTECTION

Sets protection options for the test stream. Valid options are:

R

Read: the test stream cannot be browsed, edited, run, appended to, inserted into, or merged into another test stream by anyone except its owner or a security administrator. If the test stream is copied or renamed, read protection is extended to the new test stream.

W

Write: the test stream cannot be extended, replaced (during the Run function), edited, renamed, deleted, appended to, inserted or merged into another test stream, nor can its directory be updated, by anyone except its owner or a security administrator.

P

Print: the test stream cannot be printed. You can use any combination of options. For example., RW, WP, RWP. To change the protection option, use the Utilities Update Directory function.

Note: A read-protected Autsign (automated signon and signoff) test stream can be invoked by any user for Autsign purposes; it cannot be read in any other way except by its owner or a security administrator. For information about Autsign test streams, see the Installation Guide.

LOG INPUT SCREENS ONLY

Type Y to log just input screens; otherwise, leave N as the default. Use Y with caution, because it means there will be no output screens to compare during a Run. Selecting Y also diminishes the usefulness of CA Verify for CICS as a regression testing tool, and makes problem determination difficult if the application does not perform as expected. However, when you have a completely predictable test stream, logging just the input screens can reduce the size of the test stream.

EXTEND TEST STREAM
Type Y to append additional logging to an existing test stream (identified in the ddname, Application, Member, and Version fields); otherwise, leave N as the default.

If you extend a test stream, the current logging should be compatible with the existing test stream as follows:
- The current terminal should be the same type as the terminal originally used to create the test stream
- The existing test stream should end with a clear screen. If not, use the Online Utilities to copy the existing test stream. You can then truncate the copied version after a clear screen.
RULESET NAME

Displays the name of the ruleset selected. A name only appears if you have selected Y for Process With Rules and have selected a ruleset.