Viewing with Control-V

This chapter includes the following topics:

Overview

This chapter is intended for Control-V users only. If you are not a Control-V user, you can skip this chapter.

Control-V is a software product that provides online access to archived reports through indexed data retrieval. This chapter discusses how pages of Control-V-indexed reports can be selected for viewing. In this chapter, you will do the following:

  • Look at Control-V User Reports entry panel display types.
  • Retrieve pages of a report based on index values.
  • Learn about viewing migrated reports.

Control-V Entry Panel Display Types

In Entry Panel Fields you determined which reports appeared in Report lists by specifying report selection criteria in the Control-D User Reports entry panel. The Control-V entry panel is similar, but additionally it enables you to limit the listed reports to those that have or have not migrated to another storage media, and to those that contain specified indexes and index values.

This exercise helps you learn about the Control-V Online Viewing facility and its entry panel fields.

Begin

  1. Enter the Online Viewing facility.

    The User Reports entry panel is displayed.

  2. Type DI A in the COMMAND field and press Enter.

    Display type A (All Fields) of the entry panel is displayed.

    Figure 147 Entry Panel All Fields Display Type

    Copy
    -------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND/OPTION  ===>                      1. PERMANENT 2. ACTIVE/MIG 3. HISTORY
    SELECT BY:
       REPORT NAME  ===>                       Report name, prefix or mask
       USER         ===>                       Recipient name or prefix
       CHILD        ===> Y                     Y-with children
       JOB NAME     ===>                       Job name, prefix or mask
       REMARK/ CCs  ===>                       Remark or CC of job
       CATEGORY     ===>                       Category or mask
       DATE FROM    ===>        TO             Report date or relative day
       TIME FROM    ===>        TO             Report time
       MIGRATED     ===> N                     Include migrated reports
       INDEX        ===>                       Index name, prefix or mask
       VALUE        ===>
    SELECT BY STATUS / DISPLAY OPTIONS:
       Decollated   ===> Y                     Wait decollation   ===> N
       Wait print   ===> Y                     Restored only      ===> N
       Printed      ===> Y                     Wait restore only  ===> N
       Not printed  ===> Y                     Wait backup only   ===> N
       Bypass panel ===> N                     Show rulers        ===> N
       Display type ===> D                     Show control chars ===> Y


    SELECT AN OPTION, FILL IN THE SELECTION CRITERIA, AND PRESS ENTER      14.13.49

    Display type A is analogous to the Control-D display type E (Extended) entry panel, except that it also contains the following Control-V fields:

    Table 19 Control-V Fields in the User Reports Entry Panel

    Field

    Meaning

    MIGRATED

    Control-V reports typically migrate from DASD to cartridge or other less expensive media for long term storage. Reports that have not yet migrated are called "active," but both active and migrated reports can be retrieved for online viewing.

    Valid Values:

    • Y (Yes): Lists both active and migrated reports in the User Report list.
    • N (No): Lists active reports only. Specify O (Only) to list migrated reports only.

    Default: Y

    INDEX

    This field enables you to specify a name, prefix or mask that is to be compared with the name assigned to each main index of a Control-V report. Each report can have from 0 to 9 main indexes. Up to three main indexes can remain disk-resident after a report migrates.

    Mask characters are symbols that can be used to represent any characters in this field.

    • ?: represents any one character.
    • *: represents any number of adjacent characters (including no characters).

    VALUE

    Enables you to specify a value or prefix that is to be compared with the values in a main index. If only one value in a resident index matches this field, that value is used to select report pages or sections for the View and Print commands.

    An abbreviated display type analogous to the Control-D display type D (Default) is available for Control-V. This display type, display type V, contains the Control-V fields just described. It is the default display type for Control-V.

  3. Type DI V in the COMMAND field and press Enter to display the default Control-V entry panel.

    Figure 148 Display Type V: The Default Entry Panel for Control-V

    Copy
    -------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>

        OPTIONS ===>               1. PERMANENT  2. ACTIVE/MIGRATED  3. HISTORY

         REPORT NAME   ===>                       Report name, prefix or mask
         USER          ===>                       Recipient name or prefix
         DATE FROM     ===>        TO             Report date or relative day
         JOBNAME       ===>                       Job name, prefix or mask

         SHOW MIGRATED ===> N                     Include migrated reports

         INDEX         ===>                       Index name, prefix or mask
         VALUE         ===>

         DISPLAY TYPE  ===> D                     BYPASS PANEL ===> N

    SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       12.29.59

Using Index Values to Select Active Report Pages

You can use Control-V index values to select specific pages for report viewing. To do this, first request only active (not yet migrated or "unmigrated") reports from the entry panel.

Begin

  1. Enter DEMO in the USER field. Enter N in the SHOW MIGRATED field. Set DISPLAY TYPE to D and BYPASS PANEL to N (their default values), as shown in the following screen.

    Figure 149 User Reports Entry Panel with Default Settings

    Copy
    -------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>


        OPTIONS ===>               1. PERMANENT  2. ACTIVE/MIGRATED  3. HISTORY


         REPORT NAME   ===>                       Report name, prefix or mask
         USER          ===> DEMO                  Recipient name or prefix
         DATE FROM     ===>        TO             Report date or relative day
         JOBNAME       ===>                       Job name, prefix or mask

         SHOW MIGRATED ===> N                     Include migrated reports

         INDEX         ===>                       Index name, prefix or mask
         VALUE         ===>


         DISPLAY TYPE  ===> D                     BYPASS PANEL ===> N




    SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       15.21.18
  2. Press Enter to display the following Active User Report List.

    Figure 150 Active User Report List with Default Settings

    Copy
    ACTIVE LIST    <D> JOB          REP                      USR DEMO     CHILD (U)
     COMMAND ===>                                                    SCROLL===> CRSR
     O USER     REPORT               ODATE     PAGES    LINES V N STATUS
       DEMO     INVENTORY REPORT     05/05/00      9      357 0   Decollated
       DEMO     EMPLOYEES-MANAGEMENT 05/05/00      1       18 0   Decollated
       DEMO     EMPLOYEES-MARKETING  05/05/00      3      131 0   Decollated
       DEMO     EMPLOYEES-DEVELOPMEN 05/05/00      1       10 0   Decollated
       DEMO     EMPLOYEES-PRODUCTION 05/05/00      3      169 0   Decollated
       DEMO     BANKING REPORT       05/05/00      5      256 0   Decollated
    ====== >>>>>>>>>>>>>>>   B O T T O M    O F    L I S T   <<<<<<<<<<<<<<< ======












    P PRINT     V VIEW     U UPDATE     I INSERT     A ADD INFO     E EDIT        
    X INDEX     N NOTE     G GIVETO     D DELETE     Q QUICK ACCESS       11.14.10

Displaying the Index Window in the Report List Screen

You can now use the Inventory report to see how to view report pages based on index values.

Begin by displaying the main indexes of the Inventory report. To do this, specify Option X (Index) in the report list.

Begin

  1. Type X in OPTION field to the left of INVENTORY report and press Enter to display the Index Window for the Inventory report.

    Figure 151 Index Window of the Active User Report List Screen

    Copy
    ACTIVE LIST    <D> JOB          REP                      USR DEMO     CHILD (U) 
     COMMAND ===>                                                    SCROLL===> CRSR
     O USER     REPORT               ODATE     PAGES    LINES V N STATUS           
     X DEMO     INVENTORY REPORT     05/05/00      9      357 0   Decollated       
       DEMO     +-------------------------------------------------------+ ed       
       DEMO     |                                                       | ed       
       DEMO     |  MAIN INDEXES                                         | ed       
       DEMO     |  REPORT INVENTORY REPORT                              | ed       
       DEMO     |  O INDEX                      MEDIA     RESIDENT      | ed       
     ====== >>> |    WAREHOUSE                  DISK         Y          | <<< ======
                |    ITEM-DESC                  DISK         Y          |
                |                                                       |
                |                                                       |
                |                                                       |
                |                                                       |
                |                                                       |
                |                                                       |
                |                                                       |
                |  USE S TO SELECT AN INDEX   Q FOR QUICK ACCESS PANEL  |
                +-------------------------------------------------------+


    P PRINT     V VIEW     U UPDATE     I INSERT     A ADD INFO     E EDIT        
    X INDEX     N NOTE     G GIVETO     D DELETE     Q QUICK ACCESS       14.00.32

You can see that the INVENTORY REPORT is an indexed report with two main indexes: WAREHOUSE and ITEM-DESC. You can select one of these main indexes, and display its values.

Displaying the Values of Index Panel

Assume that you are interested in a specific item (RIVET D. 0.5 BCR), and want to retrieve only those report pages that contain that item. You must therefore select the ITEM-DESC main index and display its values.

Begin

  1. In the Index window, enter S in the OPTION field (the entry column under the O) to the left of ITEM-DESC.

  2. Press Enter to display the Values of Index panel for the ITEM-DESC index.

    Figure 152 ITEM-DESC Index Values of Index Panel

    Copy
    VALUES OF INDEX: ITEM-DESC                                              (U.S.X)
     COMMAND ===>                                                    SCROLL===> CRSR
     O VALUE                                                # OF SECTIONS
     ALUMINUM BAR 1"                                            00000003
     ALUMINUM BAR 2.5"                                          00000003
     ALUMINUM BAR 2"                                            00000003
     ALUMINUM BAR 7"                                            00000003
     ANTI STATIC WICK                                           00000002
     BOLT 1/16                                                  00000003
     BOLT 1/32                                                  00000003
     BOLT 1/8                                                   00000003
     BOLT 5/32                                                  00000003
     COLISION LIGHT L.                                          00000002
     COLISION LIGHT R.                                          00000002
     ELECT. BOX ACF-RL                                          00000001
     ELECT. BOX ACF-R2                                          00000001
     ELECT. BOX WCF-LL                                          00000002
     ELECT. BOX WCF-RL                                          00000002
     ELECT. BUNDL EL/1A                                         00000003
     ELECT. BUNDL EL/2A                                         00000003
     ELECT. BUNDL EL/3A                                         00000003
     ELECT. BUNDL EL/5A                                         00000003
     ELECT. BUNDL EL/7A                                         00000003
    OPTIONS:    V -VIEW    P -PRINT   X -SUBINDEXES                        14.09.43
  3. Press the PF08/PF20 key twice to scroll down until the value RIVET D. 0.5 BCR is visible.

    Figure 153 After Scrolling Down

    Copy
    VALUES OF INDEX: ITEM-DESC                                              (U.S.X)
     COMMAND ===>                                                    SCROLL===> CRSR
     O VALUE                                                # OF SECTIONS
       LEFT WING                                                  00000003
       MAIN LANDING GEAR                                          00000001
       MAIN WHEEL                                                 00000001
       METAL O RING 0.1                                           00000003
       METAL O RING 2.2                                           00000003
       METAL O RING 2.7                                           00000003
       NITRIC ACID 10%                                            00000003
       NITRIC ACID 15%                                            00000003
       NOSE LANDING GEAR                                          00000001
       NOSE WHEEL                                                 00000001
       NUT 1/16                                                   00000003
       NUT 1/32                                                   00000003
       NUT 1/8                                                    00000003
       NUT 5/32                                                   00000003
       OIL DX-2W3                                                 00000003
       RIGHT WING                                                 00000003
       RIVET D. 0.5 BCR                                           00000002
       RIVET D. 0.1 ACP                                           00000003
       RIVET D. 0.1 ACR                                           00000003
       RIVET D. 0.1 BCR                                           00000002
    OPTIONS:    V -VIEW    P -PRINT   X -SUBINDEXES                        14.24.38
  4. Enter V (View) in the OPTION field to the left of RIVET D. 0.5 BCR and press Enter.

    Inventory report data, beginning with the first page that contains item RIVET D. 0.5 BCR, is displayed. The first occurrence is in Warehouse 1002. This item is highlighted wherever it occurs in the report.

    Figure 154 Highlighting of Selected Item

    Copy
    ------------- CONTROL-D/V REPORT VIEWING   NOTES    0 NDX: ITEM-DESC
     COMMAND ===>                                                   SCROLL ===> CRSR
     USR DEMO     REP INVENTORY REPORT     JB JDEMO    00839 DT 050500 RUL
    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
    DATE:   05.05.00
    UPDATE: 05.05.00
                                     INVENTORY REPORT
                                     ----------------

    WAREHOUSE NO: 1002       DEPARTMENT:  100  -  WINGS ASSEMBLY SHOP
                  ----                    ---------------------------

    ITEM NO.      DESCRIPTION          SHELF   QNTY   QNTY       QNTY       QNTY IN
                                        LIFE    UNIT   AVAIL      ORDER      PROCESS
    -----------   ----------------     -----   ----   -------    -------    -------

    1233-781-21   RIVET D. 0.1 ACR     NONE    KG      100.00     250.00

    1233-781-22   RIVET D. 0.1 BCR     NONE    KG       10.00      50.00

    1233-781-25   RIVET D. 0.5 ACR     NONE    KG      500.00     500.00

    1233-781-26   RIVET D. O.5 BCR     NONE    KG       25.00      25.00
     CMDS: FIND str (PREV), EDIT, RULER on/off/name, VALUE, N n P p        11.11.15
  5. Press the PF08/PF20 key to find the next occurrence (in Warehouse 1003).

    Figure 155 Finding Next Occurrence

    Copy
    ------------- CONTROL-D/V REPORT VIEWING   NOTES    0 NDX: WAREHOUSE
     COMMAND ===>                                                   SCROLL ===> CRSR
     USR DEMO     REP INVENTORY REPORT     JB JDEMO    00839 DT 050500 RUL
    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
    DATE:   05.05.00
    UPDATE: 05.05.00
                                     INVENTORY REPORT
                                     ----------------

    WAREHOUSE NO: 1003       DEPARTMENT:  100  -  TAIL  ASSEMBLY SHOP
                  ----                    ---------------------------

    ITEM NO.      DESCRIPTION          SHELF   QNTY   QNTY       QNTY       QNTY IN
                                       LIFE    UNIT   AVAIL      ORDER      PROCESS
    -----------   ----------------     -----   ----   -------    -------    -------

    1233-781-21   RIVET D. 0.1 ACR     NONE    KG      100.00     250.00

    1233-781-22   RIVET D. 0.1 BCR     NONE    KG       10.00      50.00

    1233-781-25   RIVET D. 0.5 ACR     NONE    KG      500.00     500.00

    1233-781-26   RIVET D. O.5 BCR     NONE    KG       25.00      25.00
     CMDS: FIND str (PREV), EDIT, RULER on/off/name, VALUE, N n P p        10.53.49
  6. Press PF03/PF15 twice to redisplay the Active User Report List.

Using Quick Access Panels

Before learning how to use the Quick Access panels for this report, examine the report’s index structure and hierarchies, as illustrated below:

Figure 156 Index Structure and Hierarchies of Example Report

Copy
   WAREHOUSE           ITEM-DESC 
   /       \               |
  /         \              |
 /           \             |
ITEM-NUM  ITEM-DESC    WAREHOUSE

WAREHOUSE is a main index, with subindexes to ITEM-NUM (item number) and ITEM-DESC (item description). Thus, for any warehouse, you can link to any item in that warehouse by its number or description.

ITEM-DESC is also a main index, with the subindex WAREHOUSE. Thus for any named item (that is, item description) you can link to the warehouses that contain that item.

The Quick Access panel displays a main index and beneath it one of its subindexes.

Begin

  1. Type Q (Quick Access) in the OPTION field to the left of the INVENTORY report and press Enter to display the first Quick Access panel.

    Figure 157 Quick Access Panel

    Copy
    --------------------------  CONTROL-V QUICK ACCESS  ----------------------(U.Q)
    COMMAND ===>                                                 USER ===> M21


    REPORT NAME:  INVENTORY REPORT
    JOB NAME:     JDEMO
    DATE:         05/05/00

    INDEX                    VALUE    (PLEASE FILL IN ALL KNOWN VALUES)

    WAREHOUSE            -

    ITEM-NUM             -









    CMDS: END , ENTER , NEXT , PREV , PRINT , RETURN , SHPF                12.39.24

    This Quick Access Panel contains the WAREHOUSE => ITEM-NUMindex path, where WAREHOUSE is the main index. This panel can be used to view report pages containing the parts that are stored in the specified warehouses and whose item number matches the value or prefix specified in the ITEM-NUM field.

  2. Type NEXT in the COMMAND line and press Enter, or press PF11/PF23, to display the next Quick Access panel.

    Figure 158 NEXT Quick Access Panel (1)

    Copy
    --------------------------  CONTROL-V QUICK ACCESS  ----------------------(U.Q)
    COMMAND ===>                                                 USER ===> M21    


    REPORT NAME:  INVENTORY REPORT                                                
    JOB NAME:     M21                                                             
    DATE:         05/05/00                                                        

       INDEX                    VALUE    (PLEASE FILL IN ALL KNOWN VALUES)        

       WAREHOUSE            -                                                     

       ITEM-DESC            -










    CMDS: END , ENTER , NEXT , PREV , PRINT , RETURN , SHPF                12.46.3

    This Quick Access panel contains the WAREHOUSE => ITEM-DESC index path. This panel can be used to view report pages containing the parts that are stored in a warehouse that matches the value or prefix specified in the WAREHOUSE field and whose description matches the ITEM-DESC field.

  3. Repeat the previous operation to display the next Quick Access panel.

    Figure 159 NEXT Quick Access Panel (2)

    Copy
    --------------------------  CONTROL-V QUICK ACCESS  ----------------------(U.Q)
    COMMAND ===>                                                 USER ===> M21    


    REPORT NAME:  INVENTORY REPORT                                                
    JOB NAME:     JDEMO
    DATE:         05/05/00                                                        

       INDEX                    VALUE    (PLEASE FILL IN ALL KNOWN VALUES)        

       ITEM-DESC            -                                                     

       WAREHOUSE            -










    CMDS: END , ENTER , NEXT , PREV , PRINT , RETURN , SHPF                12.49.47

    This Quick Access panel contains the ITEM-DESC => WAREHOUSEindex path. This panel can be used to view report pages containing the parts whose description matches the value or prefix specified in the ITEM-DESC field and that are stored in the specified warehouse.

  4. Repeat the previous operation again.

    The same Quick Access panel remains displayed, but the following message is displayed at the top of the panel:

    Copy
    CTVG45E THERE IS NO NEXT INDEX

    This means that the panel containing index path ITEM-DESC=> WAREHOUSE is the last Quick Access panel for this report.

    Figure 160 NO NEXT INDEX Message

    Copy
    CTVG45E THERE IS NO NEXT INDEX     -V QUICK ACCESS  ----------------------(U.Q)
     COMMAND ===>                                                 USER ===> N44
     
     REPORT NAME:  INVENTORY REPORT

     JOB NAME:     JDEMO

     DATE:         05/05/00


                            INDEX                    VALUE    (PLEASE FILL IN ALL KNOWN VALUES)



                            ITEM-DESC            -



                            WAREHOUSE            -

    This panel contains the index path you are going to use to once again locate the two occurrences of RIVET D. 0.5 BCR.

  5. Type the value RIVET for the ITEM-DESC index and press Enter to display the following Values of Index panel:

    Figure 161 Values of Index Panel before Item Selected

    Copy
    VALUES OF INDEX: ITEM-DESC                                              (U.Q.X)
    COMMAND ===>                                                    SCROLL===> CRSR
    O VALUE
      RIVET D. O.5 BCR
      RIVET D. 0.1 ACP
      RIVET D. 0.1 ACR
      RIVET D. 0.1 BCR
      RIVET D. 0.5 ACR
      RIVET D. 0.7 ACR
      RIVET D. 0.7 BCR
      RUBBER O RING
      RUBBER RING D. 2.2
      RUBBER RING D. 2.7
      TAIL
      WASHER D. 0.1
      WASHER D. 0.5
      WASHER D. 0.7
      WING TIP - LEFT
      WING TIP - RIGHT
    ======== >>>>>>>>>>>>>>> NO MORE VALUES FOR THIS INDEX <<<<<<<<<<<<<<< ========

    USE S TO SELECT A VALUE AND PRESS PF3 TO RETURN                        15.18.38
  6. Enter S (Select) in the OPTION field to the left of RIVET D. O.5 BCR and press PF03/PF15.

    The Quick Access Panel that now contains the selected index value, RIVET D. O.5 BCR, is displayed.

    Figure 162 Values of Index Panel Showing Selected Item

    Copy
    --------------------------  CONTROL-V QUICK ACCESS  ----------------------(U.Q)
    COMMAND ===>                                                 USER ===> N44


    REPORT NAME:  INVENTORY REPORT
    JOB NAME:     JDEMO
    DATE:         05/05/00


       INDEX                    VALUE    (PLEASE FILL IN ALL KNOWN VALUES)

       ITEM-DESC            - RIVET D. O.5 BCR

       WAREHOUSE            -



    CMDS: END , ENTER , NEXT , PREV , PRINT , RETURN , SHPF                11.24.16
  7. Press Enter to display INVENTORY REPORT data beginning with the first page that contains item RIVETD.O.5BCR.

    As before, the first occurrence is in Warehouse 1002. This item is highlighted wherever it occurs in the report.

  8. Press PF08/PF20 to find the other occurrence in Warehouse1003.

  9. Press PF03/PF15 three times to return to the User Reports entry panel.

  10. Press PF03/PF15 again to return to the IOA Primary Option menu.

Viewing Migrated Reports

When you specify Option V to view a report that has migrated to optical disk or cartridge, a message indicating that data retrieval is in progress may be displayed.

If you access Control-V with the TSO or ISPF interface, you may receive the message shown in the following window.

Figure 163 "Data Being Retrieved" Message

Copy
------------- CONTROL-D/V REPORT VIEWING   NOTES        PAGE        OF
 COMMAND ===>                                                   SCROLL ===> CRSR
 USR DEMO     REP BANKING REPORT       JB N50BKRPT 09687 DT 050500 RUL
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
                  +-------------------------------+
                  ¦                               ¦
                  ¦  Data is being retrieved      ¦
                  ¦  from external storage        ¦
                  ¦  Please wait                  ¦
                  ¦                               ¦
                  +-------------------------------+











                    
 CMDS: FIND str (PREV), EDIT, RULER on/off/name, VALUE, N n P p
  1. If you receive this message, wait for the report to be displayed.

    If you use the IOA Online monitor to access Control-V with other interfaces, you may receive a slightly different message (see bolding):

    Copy
    Data is being retrieved
    from external storage
    Please press ENTER and wait
  2. Press Enter each time this message is displayed.

You have completed this guide. You should now be able to use many of the Control-D and Control-V Online Viewing facilities to your advantage.