Entry Panel Fields

This chapter includes the following topics:

Overview

This chapter discusses how selection fields on the entry panel can be used to include only desired reports in your Report lists. In this chapter, you do the following will:

  • Learn what selection criteria are available on the Extended display type of the entry panel.

  • Fill in selection criteria as desired and look at the resulting Report lists.

  • Examine the Default display type entry panel and learn to use the Show Options window in the entry panel.

  • Display the list of available entry panel display types.

Selection Criteria on the Entry Panel

In previous chapters, you selected reports for viewing and printing from the Active User Report list.

The Report list provided with this demonstration has been kept short for reasons of simplicity. However, a typical Active User Report list may be many screens in length. Scrolling through such a Report list looking for a desired report can be very inconvenient. It would be more convenient if the Report list contained only the reports you need.

The entry panel lets you control which reports appear in Report lists by allowing you to specify report selection criteria. Reports are included in the Report list only if they meet the specified criteria.

Additionally, the entry panel enables you to specify various screen display options.

  1. Enter the Online Viewing facility and display the entry panel.

  2. Type DI ? in the COMMAND field and press Enter to open the Display Options window.

  3. Select Option E (All Fields - Control D) by typing S to the left of the option name.

  4. Press Enter to display all fields of the User Reports Entry Panel, as shown below.

    Figure 133 User Reports Entry Panel (Display Type E)

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND/OPTION  ===>                     1. PERMANENT 2. ACTIVE  3. HISTORY
    SELECT BY:
       REPORT NAME  ===>                      Report name, prefix or mask
       USER         ===>                      Recipient name or prefix
       CHILD        ===> N                    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
    SELECT BY STATUS:
       Decollated   ===> Y                    Wait decollation   ===> N
       Wait print   ===> Y                    Restored only      ===> N
       Printed      ===> Y                    Wait restore only  ===> N
       Not printed  ===> Y                    Wait backup only   ===> N
    DISPLAY OPTIONS:
       Bypass panel ===> N                    Show rulers        ===> N
       Display type ===> D                    Show control chars ===> Y
       
       
       
       
    SELECT AN OPTION, FILL IN THE SELECTION CRITERIA, AND PRESS ENTER      08.40.07

In addition to the COMMAND field, in which the desired kind of Report list (Active, History or Permanent) is specified, entry panel fields are divided into the following basic groups:

  • SELECT BY

  • SELECT BY STATUS

  • DISPLAY OPTIONS

SELECT BY Fields

The entry panel SELECT BY fields are shown below. This exercise discusses the REPORT NAME, USER, and JOB NAME fields.

Figure 134 SELECT BY Fields

Copy 
SELECT BY:
   REPORT NAME   ===>                       Report name or prefix or mask
   USER          ===>                       Recipient name or prefix
   CHILD         ===> N                     Y-with children, N-user only
   JOB NAME      ===>                       Job name or prefix or mask
   REMARK / CCs  ===>                       Remark or CC of job
   CATEGORY      ===>                       Site-defined category or mask
   DATE FROM     ===>        TO             Report date
   TIME FROM     ===>        TO             Report time

Table 15 Report Name, User, and Job Name Fields in the Entry Panel

Field

Description

REPORT NAME

Every report has a name. If there is an entry in this field, only reports with names that match the specified name, prefix, or mask are included in the Report list.

USER

All reports are assigned to specific users. If there is an entry in this field, only reports assigned to the specified user (name or prefix) are included in the Report list.

JOB NAME

All reports are generated by jobs. If there is an entry in this field, only reports generated by the specified job (name, prefix, or mask) are included in the Report list.

A prefix is a specified string of characters to be matched against the actual name, beginning with the first character.

Mask characters are symbols that can be used in specified values to represent any characters in the actual values:

  • ? represents any one character

  • * represents any number of adjacent characters (including no characters)

Prefixes are demonstrated in the following steps.

Begin

  1. Specify the entry panel selection criteria shown below and press Enter.

    Figure 135 Specifying Entry Panel Selection Criteria

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL ----------------(U)
    COMMAND/OPTION  ===>                       1. PERMANENT  2. ACTIVE   3. HISTORY
     
    SELECT BY:
       REPORT NAME   ===> EMP*                  Report name or prefix or mask
       USER          ===> DEMO                  Recipient name or prefix
       CHILD         ===> N                     Y-with children, N-user only
       JOB NAME      ===>                       Job name or prefix or mask
       REMARK / CCs  ===>                       Remark or CC of job
       CATEGORY      ===>                       Site-defined category or mask
       DATE FROM     ===>        TO             Report date
       TIME FROM     ===>        TO             Report time

    The Active User Report list is displayed as follow:

    Figure 136 Active User Report List Screen after Specification of Entry Panel Selection Criteria

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

    By entering EMP* in the REPORT NAME field, only reports with names that begin with EMP are included in the Report list.

    EMP* appears in the REP field and DEMO appears in the USR field in the top line of the screen.

  2. Press the END key (PF03/PF15) to display the entry panel.

  3. Specify additional entry panel selection criteria as follows:

    Figure 137 Further Entry Panel Selection Criteria

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL ----------------(U)
    COMMAND/OPTION  ===>                       1. PERMANENT  2. ACTIVE   3. HISTORY
     
    SELECT BY:
       REPORT NAME   ===> BANK*                 Report name or prefix or mask
       USER          ===> DEMO                  Recipient name or prefix
       CHILD         ===> N                     Y-with children, N-user only
       JOB NAME      ===>                       Job name or prefix or mask
       REMARK / CCs ===>                        Remark or CC of job
       CATEGORY      ===>                       Site-defined category or mask
       DATE FROM     ===>        TO             Report date
       TIME FROM     ===>        TO             Report time

  4. Press Enter.

    The Active User Report list contains one listing.

    Figure 138 Active User Report List after Selection Criteria Specified

    Copy 
    ACTIVE LIST    - JOB          REP BANK*                USR DEMO           (U)
    COMMAND ===>                                                    SCROLL===> CRSR
    O USER     REPORT               ODATE     PAGES    LINES V N STATUS
      DEMO     BANKING REPORT       05/05/00      5      256     Decollated
    ====== >>>>>>>>>>>>>>>   B O T T O M    O F    L I S T   <<<<<<<<<<<<<<< ======

  5. Press the END key (PF03/PF15) to display the entry panel.

Other SELECT BY Fields

Additional entry panel SELECT BY fields are:

Table 16 Additional Entry Panel SELECT BY Fields

Field Description
CHILD

"Children" are other recipients whose reports a user may see. For example, if a sales manager has access to all the reports of the sales staff, the sales staff are considered the "children" of their sales manager. Valid values are:

Child is a Yes or No (Y/N) field:

  • Y (Yes): Include children's reports in the Report list.

  • N (No): Do not include children's reports in the Report list.

The inclusion of children may significantly increase the size of the Report list and therefore impact performance. You should not include children's reports unless you really need them.

The INCONTROL administrator defines which users are the children of other users.
Category

Category is a user-defined classification of reports that enables you to select reports based on the value specified in the CATEGORY field. For example, if your site assigns reports to categories such as DAILY and MONTHLY, you can request to see only MONTHLY reports.

The assignment of reports to categories is the responsibility of the INCONTROL administrator. Ask your INCONTROL administrator about the categories used at your site.
REMARKS/CCs

This selection field is described in depth in Chapter 2 of your user guide and is only mentioned here briefly. REMARKS/CCs allows selection of reports based on job condition codes, end codes, or user remarks. For example, operations personnel may want to request the display of all jobs and reports that ended NOTOK, or that abended.
DATE FROM and TO

When requesting an Active or History User Report list, you can limit reports to the date range specified in the DATE FROM and TO fields. Dates may be specified as follows:

  • mmddyy or ddmmyy format, depending on the standard in use at the site

  • -n where n is the number of preceding days (any value from 0 to 365). A minus sign must precede the integer.

    -3 means three days ago.

Specifying a FROM date without a TO date implies that the FROM date and TO date are the same.
TIME FROM and TO

When requesting an Active or History User Report list, you can limit reports to the time range specified in the TIME FROM and TO fields. Time format is hhmm using a 24-hour clock.

SELECT BY STATUS Fields

In Report List Screens, you learned the meanings of the various report statuses. The SELECT BY STATUS fields of the User Reports Entry Panel (Display Type E) enable you to select reports based on status.

Figure 139 SELECT BY STATUS Fields

Copy 
SELECT BY STATUS:
   Decollated    ===> Y                       Wait decollation    ===> N
   Wait print    ===> Y                       Restored only       ===> N
   Printed       ===> Y                       Wait restore only   ===> N
   Not printed   ===> Y                       Wait backup only    ===> N

Only reports that meet the specified report status criteria are displayed:

Table 17 Report Status Selection Criteria in the User Reports Entry Panel

Status

Which Reports Are Selected

Decollated

(Active User Report list)

Reports that have been processed by Control-D and are available for Online viewing, but are not printed unless specially requested by the Print option.

Wait print

(Active User Report list

Reports that have not yet been, but will be, printed.

Printed

(Active User Report list

Reports that have already been printed.

Not printed

(Active User Report list)

Reports that are scheduled for printing but will not be printed or will be only partially printed.

Wait decollation

(Active User Report list)

Reports not yet processed by Control-D.

Restored only

(Active and History User Report lists)

Reports that have been restored.

Wait restore only

(History User Report list

Reports for which restore requests have been made but that have not yet been restored.

Wait backup only

(Active User Report list)

Reports waiting to be backed up (that is, reports not yet deleted because they have not yet been backed up).

DISPLAY OPTIONS

Figure 140 Display Options Entry Panel

Copy 
DISPLAY OPTIONS:
   Bypass panel  ===> N                     Show rulers        ===> N
   Display type  ===> D                     Show control chars ===> Y

The User Reports Entry Panel (Display Type E) contains Display Option fields and their default values. You can change these values.

Changes to Display Option values not only affect the current Control-D session, they become the new defaults. They are stored when you exit Control-D, and are retrieved the next time you enter Control-D.

The following table describes Display Options.

Table 18 Display Options in the User Reports Entry Panel

Option

Description

Bypass Panel

By specifying Y (Yes) in this field, the entry panel will thereafter be bypassed when you re-enter the Online Viewing facility. Instead, the Active User Report List screen will be displayed according to the criteria that you specified on the entry panel at the time you requested the bypass.

The bypass may be cancelled by exiting the Report List screen to the entry panel using the Return key (PF04/PF16), and changing the value of the Bypass Panel field to N.

Display Type

Determines the display type that appears when the Report list is first displayed. After the Active User Report list is active, you can switch display types by using the DISPLAY command, discussed in Report List Screens.

Show Rulers

This Y/N field determines whether rulers are listed with their reports in the Active User Report list. Once the Active User Report List is displayed you can alternately display and hide the list of rulers by using the RULER command. This is discussed in Report List Screens.

Show Control Chars

This Y/N field determines whether printing control characters are shown in the Report Viewing Screen. When the Active User Report list is displayed, you can alternately display and hide printing control characters by using the SHOWCC command. For more information, see Chapter 2 of your user guide.

You can display the Active User Report list and include rulers in the list. You can also request that the entry panel be bypassed the next time you enter the Online Viewing facility.

Begin

  1. Fill in the SELECT BY fields and DISPLAY OPTIONS on the entry panel as follows:

    Figure 141 Completing SELECT BY Fields and DISPLAY Options

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND/OPTION  ===>                     1. PERMANENT 2. ACTIVE  3. HISTORY
    SELECT BY:
       CREPORT NAME  ===>                      Report name, prefix or mask
       USER         ===> DEMO                  Recipient name or prefix
       CHILD        ===> N                     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
    SELECT BY STATUS:
       Decollated    ===> Y                       Wait decollation    ===> N
       Wait print    ===> Y                       Restored only       ===> N
       Printed       ===> Y                       Wait restore only   ===> N
       Not printed   ===> Y                       Wait backup only    ===> N
    DISPLAY OPTIONS:
       Bypass panel ===> Y                     Show rulers        ===> Y
       Display type ===> D                     Show control chars ===> Y
       
       
       
       SELECT AN OPTION, FILL IN THE SELECTION CRITERIA, AND PRESS ENTER      08.40.07

  2. Press Enter to display the Active User Report list.

    Figure 142 After Completing SELECT BY Fields and DISPLAY Options

    Copy 
    ACTIVE LIST    <D> JOB          REP                      USR DEMO           (U)
    COMMAND ===>                                                    SCROLL===> CRSR
    O USER     REPORT               ODATE     PAGES    LINES V N STATUS
      DEMO     INVENTORY REPORT     05/05/00      9      427 V   Decollated
      DEMO     EMPLOYEES-MANAGMENT  05/05/00      1       18     Decollated
      DEMO     EMPLOYEES-MARKETING  05/05/00      3      131 V T Decollated
      DEMO     EMPLOYEES-DEVELOPMEN 05/05/00      1       10     Decollated
      DEMO     EMPLOYEES-PRODUCTION 05/05/00      3      169     Decollated
      DEMO     BANKING REPORT       05/05/00      5      256     Decollated
      DEMO     EMPLOYEES-MARKETING  05/05/00 VIEW RULER=DEFAULT
      DEMO     EMPLOYEES-MARKETING  05/05/00 VIEW RULER=COLOR40
      DEMO     EMPLOYEES-MARKETING  05/05/00 VIEW RULER=OFN08
      DEMO     EMPLOYEES-MARKETING  05/05/00 VIEW RULER=INSUR1
      DEMO     INVENTORY REPORT     05/05/00 VIEW RULER=ORDER1
      DEMO     EMPLOYEES-MARKETING  05/05/00 PRINT RULER=INSUR1
    ====== >>>>>>>>>>>>>>>   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       10.24.32

    Note that the display type is displayed with rulers following the list of reports.

  3. Press the RETURN key (PF04/PF16) to display the entry panel.

  4. Type =X in the COMMAND field and press Enter to exit the Online Viewing facility. You will see the effect of the entry panel bypass when you return to the Online Viewing Facility.

    You are back in your normal operating environment.

  5. Re-enter the Online Viewing facility.

    The entry panel has been bypassed. The Active User Report list is displayed with the same criteria as when you last exited (Default display type and rulers are displayed).

  6. Press the END key (PF03/PF15) to display the entry panel.

Using the Default Display Type Entry Panel

You can now reset the default settings of the entry panel, and then switch over to the Default display type of the entry panel.

Begin

  1. Fill in the Display options as shown below.

    Figure 143 Resetting Default Settings of Entry Panel

    Copy 
    DISPLAY OPTIONS:
       Bypass panel  ===> N                     Show rulers         ===> Y
       Display type  ===> D                     Show control chars  ===> Y

  2. Type DI D in the COMMAND field at the top of the page to display the Default display type of the entry panel.

    Figure 144 Default Display Type Entry Panel

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>
     
     
        OPTIONS ===>               1. PERMANENT  2. ACTIVE     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
     
     
     
     
     
     
     
     
         DISPLAY TYPE  ===> D                     BYPASS PANEL ===> N
     
     
     
    SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       14.17.17

    The Default display type is an abbreviated version of the Extended display type. It contains only those fields from the Extended display type that you are most likely to change when selecting reports for viewing.

    The advantage of the Default display type is that it is less cluttered and therefore easier to work with. In general, the Default display type is more widely used than the Extended display type, and Control-D users are encouraged to use this display type instead of the Extended display type. Display types more relevant to Control-V are listed later in this chapter, and are discussed in Viewing with Control-V.

Using the Show Options Window

If you find that you want to alter the value of a field that does not appear in the Default display type, you do not have to change display types. Instead, you can display the missing fields in the Show Options window.

You can call up the Show Options window and change a value, by following these steps:

Begin

  1. Type SH on the command line and press Enter to display the Show Options window of the Entry Panel. This window displays all the fields from the Extended display type that do not appear in the Default display type.

    Figure 145 Show Option Window of the Default User Reports Entry Panel

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>  +--------------------------------------------------------------+
                  |                                                              |
                  |                  PLEASE SELECT SHOW OPTIONS                  |
        OPTIONS = |                                                              |
                  |  CHILD        ===> Y                    Y-with children      |
                  |  REMARK / CCs ===>                      Remark or CC of job  |
         REPORT N |  CATEGORY     ===>                      Category or mask     |
         USER     |  TIME FROM    ===>        TO            Report time          |
         DATE FRO |                                                              |
         JOBNAME  |  SELECT BY STATUS:                                           |
                  |                                                              |
                  |  DECOLLATED   ===> Y      WAIT DECOLLATION   ===> N          |
                  |  WAIT PRINT   ===> Y      RESTORED ONLY      ===> N          |
                  |  PRINTED      ===> Y      WAIT RESTORE ONLY  ===> N          |
                  |  NOT PRINTED  ===> Y      WAIT BACKUP ONLY   ===> N          |
                  |                                                              |
                  |  DISPLAY OPTIONS:                                            |
                  |                                                              |
         DISPLAY  |  SHOW RULERS  ===> N      SHOW CONTROL CHARS ===> Y          |
                  |                                                              |
                  +--------------------------------------------------------------+
     
    SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       09.26.20

  2. Change the value in the SHOW RULERS field from Y (Yes) to N (No), and press Enter.

The Show Options window closes. If you were to change display types to E (Extended), the SHOW RULERS field would now contain the value N. If you were to enter the Active User Report List screen, rulers would not be displayed.

Displaying the List of Entry Panel Display Types

Begin

  1. Type DI ? in the COMMAND field to display the Display Option window.

    Figure 146 Entry Panel Display Options Window

    Copy 
    -------------------- CONTROL-D  -  USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>
     
     
        OPTION  ===>               1. PERMANENT  2. ACTIVE     3. HISTORY
     
        +-------------------------------+
        |        DISPLAY OPTIONS        |         Report name, prefix or mask
        | CMD ==>           SCROLL CRSR |         Recipient name or prefix
        |  O ID DESCRIPTION             |         Report date or relative day
        |    D  Default    - Control-D  |         Job name, prefix or mask
        |    E  All fields - Control-D  |         Include migrated reports
        |    F  All fields - Control-D  |         Index name, prefix or mask
        |    V  Default    - Control-V  |
        |    A  All fields - Control-V  |
        |    J  Job Archiving           |
        | =======>>> BOTTOM <<<======== |
        |                               |
        |                               |         BYPASS PANEL ===> N
      DI|                               |
        |                               |
        | SELECT OPTION                 |
        +-------------------------------+
    SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       14.20.28

    Several display types that you have not used are available, including display options for Control-V users. If you are a Control-V user, you will be looking at those options in Viewing with Control-V.

    This entry panel display type list should not be confused with the list of display types you requested in the Report List screen in Report List Screens.

    You can select an option from the window by requesting it in the option field of the window. And you can always request one of these options by specifying it in a DISPLAY command in the COMMAND field of the entry panel.

  2. Press the END key (PF03/PF15) to exit the Display Option window.

    The window is closed.

  3. Type =X in the COMMAND field to exit the Online Viewing facility and return to your normal operating environment.

    The next time you enter the Online Viewing facility, the entry panel will be displayed.

Viewing with Control-V is intended for Control-V users only. If Control-V is not installed at your site, or if you will not use Control-V, then you have completed this guide. You should now be able to use many of the Control-D Online Viewing facilities to your advantage.