Version 4.6.2
 —  Administration  —

Displaying SVC Lists and Target Objects

The databases monitored by Adabas Review are considered to be target objects. The monitored databases and the hub are running on an Adabas SVC or router.

A target object is defined to Adabas Review in a target definition using the ET command. A target definition provides Adabas Review with the essential characteristics of the object to be monitored.

Adabas Review uses the target definition of Adabas targets to generate INPUT cards for the Adabas Review processor. For the Adabas Review hub, you must specify the target ID of the hub.

Adabas Review provides three commands for SVCs and target objects:

Code Function Action
AA Adabas Availability Lists target objects for a particular SVC as well as session statistics.
AH Available Hubs Lists available Adabas Review hubs
ET Edit Target Definitions Used to create target definitions.
LT List Target Definitions Lists existing target definitions.

Note:
SVC information does not appear in BS2000 environments; BS2000 does not use SVCs.

This document covers the following topics:


Reviewing Adabas Nucleus Targets and Session Statistics

The Adabas Availability (AA) subsystem displays available targets associated with an Adabas supervisor call (SVC). Adabas Review maintains a list of possible SVC numbers as part of its target definition subsystem.

This section covers the following topics:

Accessing the SVC List

Start of instruction setTo access a list of all the active Adabas SVCs known to Adabas Review:

Displaying Targets Associated with an SVC or Router

Start of instruction setTo display a list of all targets known to a particular z/OS or z/VSE SVC number or to a BS2000 router:

Displaying Adabas Nucleus Session Statistics

Start of instruction setTo display statistics regarding an Adabas nucleus session:

  1. In z/OS and z/VSE environments, mark an SVC on the Available SVCs screen with an "X", and press ENTER.

    Or:
    In BS2000 environments, enter the AA command from any command line.

    The Available Targets screen appears, listing targets using the SVC for communication. Scroll keys are provided. If more than one screen of objects exists, PF8 (+) scrolls the list forward and PF7 (-) scrolls the list backward.

    Note:
    The list of targets on this screen is the result of a direct query to the SVC and includes inactive targets and non-Adabas databases using that SVC.

  2. Mark an Adabas database target on the Available Targets screen with an "X", and press ENTER.

    If a non-Adabas target is selected, an error message appears.

    If an Adabas target is selected, the Adabas Availability screen appears displaying statistics about the Adabas nucleus session.

    02:53:49                  A D A B A S  -  R E V I E W               2012-04-25 
                                  ADABAS Availability                              
                                                                                   
      Pool / Queue        Length     MaxUsed  MaxPct         Various Statistics    
    +-----------------------------------------------+  +--------------------------+
    ! NAB (Atch Bfr)       65536       31232   47.6 !  ! Dbname         SSW-NATDB !
    ! NC  (Cmd Queue)      38400         192    0.5 !  ! Dbid               15640 !
    ! LFP (Fmat Pool)      12000       11680   97.3 !  ! SVC                  227 !
    ! NH  (HoldQueue)    1400056        2380    0.1 !  ! Commands          147019 !
    ! LI  (ISN Table)      10000           0    0.0 !  ! IOs               105375 !
    ! LQ  (Seq Cmds)     5242880         448    0.0 !  ! Threads                5 !
    ! NU  (UserQueue)      35112        5544   15.7 !  ! Bffr Eff            52.5 !
    ! LWP (WorkPool)     1048576       67912    6.4 !  ! Bffr Flush          1291 !
    +-----------------------------------------------+  ! Fmat Ovwrt            33 !
      Component    Reads      Writes                   ! Fmat Trans            73 !
    +--------------------------------+                 ! Thread Sw         293244 !
    ! Asso          1120        7894 !                 ! Throwbacks             0 !
    ! Data         17683       45039 !                 +--------------------------+
    ! Work             3       33636 !                                           
    +--------------------------------+                                            
                                                                                   
    Command: ______________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                                                  Menu    
    

    The following table describes the statistics shown on this screen:

    Screen Field Displays
    Pool/Queue The names of the Adabas pools and queues.
    Length The length of the associated Adabas pool or queue.
    MaxUsed The maximum amount used of the associated Adabas pool or queue.
    MaxPct The percentage used of the associated Adabas pool or queue.
    Dbname The name of the database.
    Dbid The number of the database.
    SVC The SVC used to communicate with the database (z/OS and z/VSE environments only).
    Commands The number of commands processed against the database.
    IOs The number of I/O operations processed against the database.
    Threads The number of threads in use by the database.
    Bffr Eff The buffer efficiency of the database.
    Bffr Flushes The number of buffer flushes performed by the database.
    Fmat Overwrites The number of format overwrites performed by the database.
    Fmat Trans The number of format translations performed by the database.
    Thread Sw The number of thread switches performed by the database.
    Throwbacks The number of throwbacks performed by the database.
    Component The database component: Asso (Associator), Data (Data Storage), Work (Work area)
    Reads The number of reads performed by the associated database component.
    Writes The number of writes performed by the associated database component.

Top of page

Listing and Selecting Adabas Review Hubs

The Adabas Availability (AH) subsystem displays available Adabas Review hubs associated with an Adabas supervisor call (SVC).

This function only displays the available Adabas Review hubs which run on the default SVC that is specified in the ADALNK routine.

Start of instruction setTo access a list of all the Adabas Review hubs:

  1. Enter the AH command on any command line.

    A pop-up screen listing the available hubs on the selected z/OS or z/VSE SVC or BS2000 router appears.

     
                            Available Review Hubs on SVC 237
     
                              Please choose a Review Hub
                      ---------------------------------------------
                      _ 00041       _____        _____        _____
                      _ 00558       _____        _____        _____
                        _____       _____        _____        _____
                        _____       _____        _____        _____
                        _____       _____        _____        _____
                        _____       _____        _____        _____
                        _____       _____        _____        _____
                        _____       _____        _____        _____
     
     
                      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7--
                                        Exit
     

    Note:
    In BS2000 environments, the text "on SVC nnn" does not display.

  2. To select a hub, type any character next to the hub of your choice on the pop-up window and press ENTER. Then press PF3 to exit the pop-up window.

Top of page

Creating a Target Definition

Target definitions are usually edited by the Adabas Review administrator because changes to database targets affect all users of Adabas Review.

Target definitions can be created, edited, listed, and purged. If target information is changed it will not immediately apply to the Adabas Review system. After the new parameter setting is saved into the Adabas Review repository file, it is also written to data sets identified by the RVUAUT1 and RVUAUT2 job control statements. When Adabas Review is next restarted, the new session parameters will apply.

If you are running in hub mode, the target ID of the Adabas Review hub must be specified and the parameter setting will be written to the data sets specified by the Adabas Review hub.

Note:
When using the online interface to maintain target definitions, only one target entry can be specified for each DBID, even if there are multiple SVCs with the same DBID.

Start of instruction setTo access the Edit Target screen:

  1. Enter the ET command on the command line and press ENTER.

    The Edit Target screen appears as shown below:

    02:54:32                  A D A B A S  -  R E V I E W                2009-06-20
                                      Edit Target                         HUB=15690
                                                                                   
                                                                                   
             Database Parameters                 Numeric Delimiters                
        +----------------------------+      +----------------------------------+   
        !    Target DBID .... _____  !      !    Buffers-4K ....... 00200      !   
        !    Target SVC  .... 000    !      !    Buffers-32K ...... 00030      !   
        !    Target Version . 000    !      !    Files (VSE only) . 001        !   
        +----------------------------+      +----------------------------------+   
                                                                                   
                                    Logging Options                                
        +----------------------------------------------------------------------+   
        !    Target Name ..................... ________________                !   
        !    REVIEW Commands ................. Y           (Y or N)            !   
        +----------------------------------------------------------------------+   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Command: ______________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit        Save                                      Menu   

    Note:
    SVC information does not appear on this screen in BS2000 environments; BS2000 does not use SVCs.

    The Edit Target screen displays three categories of input fields:

The Adabas Review intermediate buffer is used as a staging area to pass the command log records between the Adabas Review subtask and the attached Adabas Review processor in local mode, or between the Adabas Review client and server in hub mode. The parameters BUFFERS-4K and BUFFERS-32K in the Adabas Review INPUT statement control the size allocation. The value for these parameters are obtained from the database target definition.

The following table provides more detailed information about the input fields on the Edit Target screen. Default values are underlined.

Database Parameters

Field Value Description
Target DBID (required) nnnnn The database ID of the target object. There is no default value.
Target SVC (required in z/OS and z/VSE environments) nnn | 000 The number of the SVC used to communicate with the target. This is not relevant in BS2000 environments.
Target Version nnn | 000 The version, release, and system maintenance level of the target. For example, for Adabas version 7.4 SP1, this field would contain the value 741.

Numeric Delimiters

Field Value Description
Buffers-4K nnnn Defines the number of buffer pool entries that have a length of 4096 or less. This parameter is usually specified along with the BUFFERS-32K parameter. The minimum value is 124.
Buffers-32K nnnn Defines the number of buffer pool entries that have a length of 4097 or greater. This parameter is usually specified along with the BUFFERS-4K parameter. The minimum value is 15.
Files (z/VSE only) nnn | 001 Specifies the number of command log files to be processed (used for GENCARD).

Logging Options

Field Value Description
Target Name name The name you use to identify the target database.
Review Commands Y | N Indicates whether commands issued by Adabas Review should be included in the command processing for all reports.

Note:
In hub mode, this then applies for all databases running with this hub.

REVIEW-COMMANDS=NO indicates that special Adabas commands for Adabas Review (for example V4 commands) are not used for accounting and monitoring. To suppress RC commands issued from the SYSREVDB application as well, set the Natural profile ADAPRM parameter ON (ADAPRM=ON).

REVIEW-COMMANDS=YES indicates that these commands are used for accounting and monitoring.

Note:
Some fields might not be available for the commands supported by Adabas Review online system (V4 commands), especially when running in a hub environment. These fields include TP monitor fields, Natural fields, duration fields and buffer fields.

Top of page

Listing Target Definitions

The List Target Definitions (LT) command displays the existing target definitions that were created using the Edit Target (ET) command.

Start of instruction setTo display a list of target definitions

  1. Enter the code LT on the command line and press ENTER.

    The Target Definitions screen appears, similar to the one shown below:

    02:55:24                  A D A B A S  -  R E V I E W                2009-06-20
                                  Target Definitions                      HUB=15690
                                                                                   
                                                                         Review    
      Sel  DBID     Target Name                    Ver       SVC        Commands   
    +-----------------------------------------------------------------------------+
    ! __   00000    DEFAULT TARGET                 813       227           Y      !
    ! __   15650    DATABASE-15650                 813       227           Y      !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    !                                                                             !
    +-----------------------------------------------------------------------------+
                                                                                   
                                                                                   
    Command: ______________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                     -     +                      Menu   

    Note:
    SVC information does not appear on this screen in BS2000 environments; BS2000 does not use SVCs.

The fields on the Target Definitions screen describe the targets as they are defined to the system. The following table describes the fields:

Field Description
DBID The database ID of the target object.
Target Name The name assigned to the target by the user.
Ver The version, revision, and system maintenance level of the target.
SVC The number of the SVC used to communicate with the target. SVC information is not displayed and is not relevant in BS2000 environments.
Review Commands Local mode only. Indicates whether the Adabas Review command processor includes commands issued by the Adabas Review online system in its reports. This is used if the Adabas Review processor is running as an Adabas subtask; that is, not in batch.

You may edit or purge target definitions from the Target Definitions screen.

Start of instruction set To display the commands available for use from this screen

  1. Enter a ? on the selection line preceding a target definition and press ENTER.

Top of page

Editing an Existing Target Definition

Start of instruction setTo edit an existing target definition:

  1. Enter the ET command on the selection line preceding the target definition and press ENTER.

    The Edit Target screen for that particular target is displayed.

  2. Modify the definition by typing over the existing information.

  3. Either press PF5 or enter SAVE on the command line and press ENTER.

Top of page

Deleting a Target Definition

Target definitions may be deleted by using the PURGE command.

Start of instruction setTo delete a target definition

  1. Enter the PT command on the selection line preceding the target definition and press ENTER.

  2. Depending on your user profile, you may or may not be prompted to confirm the purge request.

Top of page