Previous Topic: Log One or More TerminalsNext Topic: Initiate Logging on Your Terminal


Logging Your Terminal

If you specify T on the Log Options Menu or L.T on the Primary Options Menu, CA Verify for VTAM displays the Single Terminal Log menu.

 --------------------------  SINGLE TERMINAL LOG  ----------------------13:45:18  ENTER COMMAND ===>                                                           L1                                                                                   LOG TEST STREAM AS:                                                                DDNAME      ===> TCADS                                                           APPLICATION ===>                                                             MEMBER      ===>                                                         VERSION     ===> 001                                                                                                                                            DESCRIPTION ===>                                          ===>                                                                             ===>                                                                                                                                                  STOP OPTION                     ===> DISC (DISC, 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)                                    VIRTUAL TERMINAL                ===>      (TO USE A SPECIFIC VIRTUAL TERMINAL)                                                                                                  RULESET NAME:                                                                                                                                                                                                                                      F1-HELP     F3-END     F4-RETURN                                              

Default values, specified when CA Verify for VTAM 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; for example, an application, department, project, and so on. Specify one to eight alphanumeric or national characters. The first character cannot be numeric.

MEMBER

The specific test stream; for example, 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:

DISC

Logging terminates when the session is disconnected. This is the default; it can be overridden by modifying the options module.

DISC prevents multiple session test streams because logging terminates when you disconnect from the first session.

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 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 application 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. See the Installation Guide for information about Autsign test streams.

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 VTAM 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:

VIRTUAL TERMINAL

Specify a specific or generic virtual terminal name. Use = as a generic character to replace any character. For example, if you specify VTERM==, CA Verify for VTAM will use any virtual terminal beginning with the characters VTERM followed by up to two characters; for example, VTERM6, VTERM01, VTERM02,and so on.

Assigning a virtual terminal is important if the application you are logging has terminal name or other terminal characteristic dependencies. The virtual terminal specification will be saved with the test stream so that CA Verify for VTAM can use the same assignment when the test stream is run. A generic specification is recommended to avoid conflicts when test streams specifying the same virtual terminal are run concurrently.

You can change the virtual terminal assignment by editing the test stream.

Leave this option blank if it doesn't matter which virtual terminal is used for logging. In this case, CA Verify for VTAM will use a virtual terminal specified at installation.

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.