Online Facilities

This chapter contains the following topics:

• Overview

• IOA Features

  • IOA Entry Panel

  • General IOA Features

  • IOA Primary Option Menu

  • Multi-Screen Control

  • Fast Exit from the IOA Online Facility

  • Screen Layout

  • Commands and PFKeys

  • Online Help

  • IOA Under ISPF

  • IOA Editor

  • IOA SET Command Panel

  • IOA TSO Command Processor Screen

• Report Decollating Mission Definition Facility

  • Accessing the Report Decollating Mission Definition Facility

  • Creating Members

  • Creating Mission Definitions

  • Performing Operations on Members and Mission Definitions

  • Entry Panel

  • Report Decollating Mission Definition – Job List

  • Report Decollating Mission Definition – Category List

  • Report Decollating Mission Definition Screen

  • Editing Mission Definitions in the Edit Environment

  • Exiting a Recipient/Approval Tree List Screen

  • Ordering Report Decollating Missions

  • Copying Report Decollating Mission Definitions to Another Member

• Migration, Printing, Backup, Restore Mission Definition Facility

  • Accessing the Mission Definition Facility

  • Creating Missions

  • Creating Mission Definitions

  • Performing Operations on Missions and Mission Definitions

  • Entry Panel

  • Migration, Printing, Backup, Restore Mission Definition – Mission List Screen

  • Migration, Printing, Backup, Restore Mission Definition – Category List Screen

  • Migration, Printing, Backup, Restore Mission Definition Screen

  • Editing Mission Definitions in the Edit Environment

  • Exiting the Mission Definition Screen

  • Ordering Missions

  • Copying Migration, Printing, Backup, Restore Mission Definitions to another Member

• Recipient Tree and Approval Tree Definition

  • Entry Panel

  • Recipient/Approval Tree List Screen

  • Recipient Definition Screen

  • Approval Definition Screen

  • Exiting a Recipient/Approval Tree List Screenn

• User Reports (Online Viewing)

  • Using Indexes for Report Retrieval

  • Entry Panel

  • Report Lists

  • Quick Access Panels

  • Values of Index Panel

  • Index Window

  • Subindex Window

  • GIVETO Option – Distributing Reports to Other Users

  • Printing Reports

  • Restoring Reports

  • Notepad Facility

  • Editing (Reformatting) Reports

  • Tag Notes

  • Using the Report Viewing Screen To View AFPDS Reports On 3270 Monitors

  • $SYSDATA Records

• Control-D/Delivery Server

  • Specifying an External Destination

  • Control-D External Destinations Screen

• Tracking and Control – Active Missions Screen

  • Format Commands of the Active Missions Screen

  • Fields of the Active Missions Screen

  • Specifying Retrieval Criteria

  • Options of the Active Missions Screen

  • Why Screen

  • Mission Log Screen

  • Zoom Screens

  • Rerun Option

  • Print Control – Print Plan Screen

  • AutoRefresh Mode

• Control-D Objects Facility

  • Accessing the Control-D Objects Facility

  • Report Cliques

  • Resource Sets

  • Resources

  • Clique Resources

  • Approval Objects

• Condition and Resource Handling Facility

  • IOA Conditions/Resources Screen

  • IOA Manual Conditions Screen

• IOA Log Facility

  • IOA Log Screen

• IOA Calendar Facility

  • Accessing the IOA Calendar Facility

  • Entry Panel

  • Calendar List Screen

  • Year List Screen

  • Copying Years to another Calendar

  • Calendar Definition Screen

  • Exiting the IOA Calendar Facility

• Utilities under ISPF

  • IOA Online Utilities Menu

  • D1: Schedule a Report Decollating Mission

  • D2: Schedule a Printing Mission

  • D3: Schedule a Backup / Migration Mission

  • D4: Schedule a Restore Mission

  • I1: Add, Check, or Delete a Prerequisite Condition

Overview

The Online facility is the basic means of communication between the user and Control-V.

Online mission definition gives users the ability to define and modify parameters for report decollating, printing, backup and restore missions in the Control-V environment.

Online tracking displays the current status of all variables relating to a specific mission, a group of missions or all the missions scheduled under Control-V.

Online control enables authorized users to modify variables relating to a specific mission, a group of missions or all the missions scheduled under Control-V.

This chapter describes the main features of the Online facility.

IOA Features

This section discusses the IOA features common to all INCONTROL products.

IOA Entry Panel

Enter the IOA online facility according to the instructions of your INCONTROL administrator. Upon entering the IOA online facility, the IOA entry panel may be displayed.

Figure 7 IOA Editor Edit Entry Panel

 -----------------------------  IOA ENTRY PANEL  ----------------------------- 
         +-----------------------------------------------------------+
         |                                                           |
         |          USER ID      ===>                                |
         |                                                           |
         |          PASSWORD     ===>                                |
         |                                                           |
         |          NEW PASSWORD ===>          ===>                  |
         |                                                           |
         +-----------------------------------------------------------+
 PLEASE FILL IN USER ID AND PASSWORD AND PRESS ENTER                   18.30.18

Type your user ID and password and press Enter. If you enter a correct user ID and password, the IOA Primary Option menu is displayed.

The IOA Online facility allows three attempts to enter a valid user ID and password combination. After the third unsuccessful attempt, the program is terminated.

To change a password, type the new password twice: Once in the NEW PASSWORD field and once in the confirmation field to the right of the NEW PASSWORD field.

General IOA Features

General IOA features include:

• Customization

• Environment Support

• Terminal Support

• Special Character Usage on Terminals

• Color Support

• Prefixing

• Character Masking

Customization

IOA screens, constants, messages, colors, commands and PFKey definitions can be site-modified to adapt them to local needs. For more information, see the INCONTROL for z/OS Installation Guide for details.

INCONTROL products can be customized globally (for the whole site) using the INCONTROL Installation and Customization Engine (ICE) according to profile variables defined during installation.

In addition, INCONTROL products can be customized to respond differently to individual users if these profile variables are specified in User profile members.

For example, depending on the setting of a variable in a particular User profile member, upon exit from a screen in which changes have been requested, this INCONTROL product may either perform the requested changes automatically or display a confirmation window before performing the changes.

Customization issues are discussed in the IOA administration chapter of the INCONTROL for z/OS Administrator Guide.

Environment Support

The Online facility can be activated under the following environments:

• TSO (native)

• TSO/ISPF

• ROSCOE/ETSO

• CICS

• VTAM

• IMS/DC

• IDMS/DC

• COM-PLETE

Cross memory interfaces to the Online monitor are optional under native TSO, TSO/ISPF, and ROSCOE/ETSO. They are always used under the other environments.

There are slight differences in the operation of the Online facility under the different environments. Special notes are provided in the guide where applicable.

Terminal Support

IOA supports the following models of the IBM 3270 terminals:

• Model 2–24 lines, 80 columns.

• Model 3–32 lines, 80 columns.

• Model 4–43 lines, 80 columns.

• Model 5–27 lines, 132 columns.

IOA adjusts to the screen size in order to use the maximum available data area on the screen.

Special Character Usage on Terminals

In certain cases, special keyboard characters, such as $, #, and @, are assigned special meanings. The characters specified appear on standard American terminals but may not be available on other keyboards. In addition, some special characters on your keyboard may be assigned different hexadecimal values than the ones recognized by IOA. Special keyboard mapping requirements, and a complete discussion of the conventions used in this guide, are shown in Conventions Used in This Guide.

Color Support

When INCONTROL products are activated from a screen with extended seven color support, they make extensive use of the color attributes of the screen. The concept of management by color is emphasized in INCONTROL screens.

Like all screen attributes, the color attribute for each field is defined externally to the program and can be locally modified by the site.

Prefixing

For fields that automatically support prefixing, selection strings are always treated as prefixes. Selection is made if a segment of the text beginning with the first letter (that is, any prefix) matches the selection criteria.

Character Masking

For fields that support masking, mask characters function as follows:

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

• ? represents any one character.

For fields that do not automatically support prefixing, a prefix value can be specified by ending the selection with an * (asterisk).

IOA Primary Option Menu

The IOA Primary Option menu is the primary interface to functions available under the various INCONTROL products. The options displayed in the menu depend on the INCONTROL products installed at the site, and the functions and facilities that have been authorized to you.

If only Control-D and Control-V are installed at your site, and you are authorized to access all functions and facilities, the following screen is displayed:

Figure 8 IOA Primary Option Menu when only Control-V is Installed

---------------------       IOA PRIMARY OPTION MENU       -----------------(1) 
OPTION ===>                                              USER        N22A 
                                                         DATE        19.08.01
                                                                               
                                                                               
                                                                               
   4   COND/RES          IOA Conditions/Resources Display                   
   5   LOG               IOA Log Display                                    
   6   TSO               Enter TSO Command                                  
   7   MANUAL COND       IOA Manual Conditions Display                      
   8   CALENDAR DEF      IOA Calendar Definition                            
  IV   VARIABLE DATABASE IOA Variable Database Definition Facility          
   C   CMEM DEFINITION   CTM Event Manager Rule Definition                  
   A   MISSION STATUS    CTD/V Active Mission Status Display                
   M   MISSION DEF       CTD/V Prt/Bkp/Rst/Mig Mission Definition           
   R   REPORT DEF        CTD/V Rep Decol/Index Mission Definition           
   T   RECIPIENT TREE    CTD Recipient Tree Definition                      
   U   USER REPORTS      CTD/V Reports-Status/Update/View                   
   F   PC PACKET STATUS  CTD File Transfer to CTD/PC                        
  DO   OBJECTS           CTD Objects Facility                               
                                                                            
                                                                               
                                                                               
 COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION              18.12.41

To select an option, type the option number or letters in the OPTION field and press Enter. Alternatively, for a number option, press the PFKey with the same number. For example, to select the LOG option, press PF05.

Certain IOA commands, functions, and facilities (options) are shared by all INCONTROL products. These shared IOA commands, functions and facilities are described later in this chapter, and outlined in Table 10.

Table 10 INCONTROL Shared IOA Functions and Facilities

The following commands, functions, and facilities (options) are applicable to Control-D:

Table 11 Control-V Functions and Facilities

The following IOA Primary Option menu is displayed at sites supporting all currently available INCONTROL products (under ISPF)

When the IOA online facility is activated as an ISPF application, option 6 is displayed as 6 UTILITIES Online Utilities. In this case, option 6 activates the Online utilities under ISPF. When the online facility is not activated under TSO or TSO/ISPF, option 6 is inactive.

Figure 9 IOA Primary Option Menu when all INCONTROL Products are Installed

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N06  
                                                                              
IOA                        CONTROL-D/V                CONTROL-O            
                                                                              
  4  COND-RES                A  MISSION STATUS         OR  RULE DEFINITION 
  5  LOG                     M  MISSION DEF            OM  MSG STATISTICS  
  6  UTILITIES               R  REPORT DEF             OS  RULE STATUS
  7  MANUAL COND             T  RECIPIENT TREE         OL  AUTOMATION LOG  
  8  CALENDAR DEF            U  USER REPORTS           OA  AUTOMATION OPTS 
 IV  VARIABLE DATABASE       F  PC PACKET STATUS       OC  COSMOS STATUS   
                            DO  OBJECTS
                                                                              
                                                                              
CONTROL-M & CTM/Restart    CONTROL-M/Analyzer         CONTROL-M/Tape          
                                                                              
  2  JOB SCHEDULE DEF       BB  BALANCING STATUS       TR  RULE DEFINITION    
  3  ACTIVE ENV.            BM  MISSION DEF            TP  POOL DEFINITION    
  C  CMEM DEFINITION        BV  DB VARIABLE DEF        TV  VAULT DEFINITION   
  W  WORKLOAD MANAGEMENT    BR  RULE DEFINITION        TI  INQ/UPD MEDIA DB   
 JD  JCL VERIFY DEFAULTS    BA  RULE ACTIVITY          TC  CHECK IN EXT VOL   
 JV  JCL VERIFICATION                                                         
 JR  JCL VERIFY RULES                                                         
                                                                              
COMMANDS: X - EXIT, HELP, INFO, SET OR CHOOSE A MENU OPTION            16.08.18

Entering =1 in the command line of any other screen returns you to the IOA Primary Option Menu that is displayed at your site.

For a description of the options for other INCONTROL products, see the user guides of the respective products.

Additional options available on the IOA Primary Option menu when operating Control-D and Control-V with other INCONTROL products are listed in Table 12.

Table 12 IOA Primary Option Menu Options

IOA Version Information

Enter INFO in the OPTION field of the IOA Primary Option menu to display the IOA Version Information window, as illustrated in Figure 10. This window lists the version and level of each INCONTROL product installed at the site, plus the CPU ID and current system date. The IOA Version Information window also identifies the unique IOA QNAME assigned to the site. For further information about the IOA QNAME, see the IOA operational parameters step, the IOAPLEX parameters step, and the adding IOA structures to the CFRM step, all in the INCONTROL for z/OS Installation Guide. Press Enter or END (PF03/PF15) to exit the window and return to the IOA Primary Option menu.

Figure 10 IOA Version Information

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N05
       EssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssN
 IOA   ×            IOA Version  9.0.00  Information and Status           ×
       ×                                                                  ×
   4  C×                           Running Mode Security                  ×
   5  L×    IOA                         9.0     Active                    ×
   6  U×    CDAM                        9.0                               ×
   7  M×    IOAGATE                     9.0                               ×
   8  C×    CONTROL-M                   9.0     Active                    ×
  IV  V×    CONTROL-M/Restart           9.0                               ×
       ×    Control-M JCL Verify        9.0                               ×
       ×    CONTROL-M/Analyzer          9.0     Active                    ×
       ×    CONTROL-M/Tape              9.0     Active                    ×
 Contro×    CONTROL-D                   9.0     Active                    ×
 & Cont×    CONTROL-V                   9.0                               ×
   2  J×    CONTROL-O                   9.0     Active                    ×
   3  A×    IOA QNAME  IOAR900   TRAN-ID            Sec.Prod. RACF        ×
   C  C×    USER-ID    N05       LANGUAGE ENG       OS  z/OS    01.13.00  ×N
  JD  J×    SMF-ID     MVS3      SYSTEM NAME  MVS3                        ×B
  JV  J×    DATE       01.05.14  CPUID 19F037 2827                        ×L
  JR  J×                                                                  ×
       DssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssM
 COMMANDS: X - EXIT, HELP, INFO, SET OR CHOOSE A MENU OPTION            16.24.21

Multi-Screen Control

It is not necessary to return to the IOA Primary Option menu to move from one online facility to another.

To speed up transfer of control between screens of different facilities and to enable you to manage several online facilities at the same time, transfer control commands can be specified. Transfer commands take you directly from your current screen to the requested screen. Transfer commands can be used to reach any screen that can be accessed through the IOA Primary Option menu at your site.

Each transfer control command consists of an equal sign immediately followed by the option on the IOA Primary Option menu. The option identifies the target screen of the transfer. For example, from any screen, specify:

Table 13 IOA Transfer Control Commands

If you use a transfer command to reach another screen, the state of the current screen remains unchanged when you return to it using another transfer command.

The INCONTROL administrator can globally deactivate any or all of the transfer commands.

Fast Exit from the IOA Online Facility

To exit immediately from the IOA Online facility, type =X on the command line and press Enter.

In most cases, the =X command has the same effect as pressing END (PF03/PF15) in all open screens and then entering X (Exit) in the IOA Primary Option menu. Any window, such as the Exit Option window, that would be displayed when exiting an open screen is displayed when the =X command is entered.

However, when the =X command is entered while definition screens such as the Calendar Definition screen are open, changes to the open definition screens are cancelled. Changes currently in definition facility list screens, for example, changes to previously closed definition screens, are not cancelled. Those screens and all other open screens are treated as if END (PF03/PF15) has been entered.

Screen Layout

Most IOA screens are divided into four basic areas. The example used in this section is the IOA Log screen.

Table 14 Basic IOA Screen Areas

Figure 11 IOA Log Screen

FILTER:            ---------------- IOA LOG --------------------------------(5)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 080800 - 080800
DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E -------------------
080800 122330 080800 M24      SCD203I REP PRDKPLW4 ELIGIBLE FOR PROCESSING
080800 122330 080800 M18      SCD203I REP GPLIR17A ELIGIBLE FOR PROCESSING
080800 122330 080800 M24      REP267I PRDKPLW4 PRDKPLW4/JOB04800 DECOLLATION
                                      FROM SPOOL STARTED
080800 122359 080800 M24      REP251I REP PRDKPLW4 PRDKPLW4/JOB04800
                                      DECOLLATION ENDED "OK"
080800 122359 080800 M24      SCD208I REP PRDKPLW4 PROCESSING ENDED "OK"
080800 124634 080800 GENERAL  CTD049I MISSION PROCESSING STARTED
080800 124635 080800 M24A     CTD511I REP PLRPT010 ODATE 080800 PLACED ON
                                      ACTIVE MISSIONS FILE-INVENTORY REPORT
080800 124635 080800 GENERAL  CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
080800 124643 080800 M24      SCD203I REP PLRPT010 ELIGIBLE FOR PROCESSING
080800 124733 080800 M24      REP267I REP PLRPT010 PLRPT010/JOB04838
                                      DECOLLATION FROM SPOOL STARTED
080800 124808 080800 M24      REP251I REP PLRPT010 PLRPT010/JOB04838
                                      DECOLLATION ENDED "OK"
080800 124808 080800 M24      SCD208I REP PLRPT010 PROCESSING ENDED "OK"
080800 163335 080800 M22      CTD659I HOLD OF MISSION INTR0002 ODATE 080800
                                      PERFORMED
CMDS: SHOW, GROUP, CATEGORY, SHPF                                      13.09.29

Commands and PFKeys

Commands are entered by typing a command in the COMMAND field and then pressing Enter, or by pressing a predefined PFKey, or a combination of both.

It is not necessary to enter the full command name; the shortest unique abbreviation of the command is sufficient. If the abbreviation is ambiguous, an appropriate message is displayed in the message area.

IOA commands are flexible; you can change command syntax or provide aliases (synonyms) to suit your site. If you want to add or change a command syntax, consult BMC Customer Support. The examples provided in this chapter exhibit the original command syntax supplied with this INCONTROL product.

PFKey command assignments can be site-customized. It is possible to assign PFKeys differently for each screen. To change PFKey command assignments, see your INCONTROL administrator.

Supplied PFKey definitions are consistent throughout most of the screens. For example: PF08/PF20 is used to scroll down (forward) on all INCONTROL screens where scrolling is possible.

Table 15 Command PFKey Definitions

To see the PFKey assignment of the screen with which you are working, type reserved command SHPF in the command line and press Enter. A window describing the current PFKey assignment appears on the screen. Press Enter again to close the window.

Figure 12 PFKey Assignment Widow

FILTER:            ---------------- IOA LOG --------------------------------(5) 
COMMAND ===>                                                   SCROLL===> CRSR
 SHOW LIMIT ON ==>                                         DATE 080800 - 080800
 DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
 080800 122330 080800 M24      SCD203I REP PRDKPLW4 ELIGIBLE FOR PROCESSING
 080800 122330 080800 M18      SCD203I REP GPLIR17A ELIGIBLE FOR PROCESSING
 080800 122330 080800 M24      REP267I PRDKPLW4 PRDKPLW4/JOB04800 DECOLLATION
                                       FROM SPOOL STARTED
 080800 122359 080800 M24      REP251I REP PRDKPLW4 PRDKPLW4/JOB04800
                                       DECOLLATION ENDED "OK"
 080800 122359 080800 M24      SCD208I REP PRDKPLW4 PROCESSING ENDED "OK"
 080800 124634 080800 GENERAL  CTD049I MISSION PROCESSING STARTED
 +----------------------------------------------------------------------------+
 |                                                                            |
 |     ENTER ENTER                     PF13  HELP                             |
 |     PF01  HELP                      PF14  SHOW                             |
 |     PF02  SHOW                      PF15  END                              |
 |     PF03  END                       PF16  RESET                            |
 |     PF04  RESET                     PF17  FIND                             |
 |     PF05  FIND                      PF18  =6                               |
 |     PF06  =6                        PF19  UP                               |
 |     PF07  UP                        PF20  DOWN                             |
 |     PF08  DOWN                      PF24  SHPF                             |
 |     PF12  RETRIEVE                                                         |
 +----------------------------------------------------------------------------+

If you type text in the COMMAND field and press a PFKey, the text in the COMMAND field is treated as a subparameter of the command assigned to the PFKey.

Two additional key definitions are:

Table 16 Additional Key Assignments

For information on changing IOA PFKey definitions, see the appendix in the INCONTROL for z/OS Administrator Guide, which deals with modifying IOA Online Facility Commands.

Scrolling Commands

IOA scrolling conventions are very similar to IBM’s ISPF conventions. Two basic commands are used for scrolling:

The commands can be specified by typing the command in the COMMAND field or by pressing the predefined PFKey.

The scrolling amount is determined by the content of the SCROLL field in the right corner of the screen header. Valid scrolling amounts are:

Table 17 Scrolling Amounts in the SCROLL Field

It is only necessary to type the first letter of the new amount in the SCROLL field in order to change the scrolling amount.

A scrolling amount other than that shown in the SCROLL field can be used by specifying the amount directly after the scroll command itself, or by specifying the scroll amount in the COMMAND field and pressing the appropriate scrolling PFKey. The scrolling amount in the SCROLL field remains unchanged.

LOCATE Command

The LOCATE command, and its abbreviation, L, can be used to search for items in the NAME field in all "directory type" screens that contain scrollable data, such as the Calendar List screen. The syntax of the command is

LOCATE string

where string is the search string. Apostrophes (‘single quotes’) or quotation marks ("double quotes") are not required.

The search proceeds from the top of the list to the first item in the list that starts with the specified string. The cursor is positioned on the OPTION field at the beginning of the line containing the string, if found, or on the OPTION field of the alphabetically closest preceding value if the specified value is not found.

FIND Command

The FIND command, and its abbreviation, F, can be used in all screens that contain scrollable data to find and display the next occurrence of a character string. The syntax of the command is

FIND string [fromcol] [tocol] [PREV]

where

• string is the search string
  Mandatory.

• fromcol is the first column in the search range
  Optional.

• tocol is the last column in the search range
  Optional.

PREV is the indicator that the search must move backward, instead of forward, from the current cursor position
Optional.

General Rules

If the string contains blanks, enclose the string with apostrophes (‘single quotes’) or quotation marks ("double quotes"). For example:

FIND 'WAIT SCHEDULE'

The column range searched can be limited by entering fromcol or tocol values, or by entering both fromcol and tocol values.

The search for the string proceeds from the current cursor position forward, or backward if PREV is entered. If the string is found, the cursor is positioned at the start of the string.

To repeat the find, to the next or previous occurrence of the string, press PF05/PF17.

Text String Searches

The FIND command can also be used to search for text strings, in which case the command finds all instances of the string, regardless of whether the characters within the string are lowercase, uppercase, or mixed case. To search for a text string, include the letter T immediately before a quoted string.

FIND T'WAIT SCHEDULE'

Text string searches are the default. If your system default is for text strings, You do not need to include the T if you perform a text string search. Your INCONTROL administrator can change the default to character string. In this case you do not need to include the C if you perform a character string search.

Character String Searches

The FIND command can be used to search for character strings, in which case the command finds all instances of the string, but only where the string contains characters that match the case specified. To search for a character string, include the letter C immediately before a quoted string.

FIND C'WAIT SCHEDULE'

CANCEL and RESET Commands

CANCEL and RESET commands are specified in the COMMAND field.

The CANCEL command cancels changes made in a definition screen, such as the IOA Calendar Definition screen, and exits the screen.

The RESET command (PF04/PF16) cancels Edit environment options specified in a definition screen. It does not cancel changes already made and it does not exit the screen or cancel Edit environment mode. For more information about the Edit environment, see Editing Mission Definitions in the IOA Edit Environment.

The RESET command (PF04/PF16) can also be used in most windows, for example, the IOA Log Show Screen window, to cancel changes and close the window.

Online Help

The following types of online help are available for INCONTROL screens:

Screen help

Provides information about the entire screen. This help is available on all INCONTROL screens and is accessed by pressing the HELP key (PF01/PF13) while the cursor is positioned on the COMMAND field in the screen.

Line-Sensitive help

Provides information about the fields on a particular line on a screen. This help is available on several INCONTROL screens. It is accessed by pressing the HELP key (PF01/PF13) while the cursor is positioned on the desired line of the screen.

If line-sensitive help is not supported in a screen, pressing the HELP key (PF01/PF13) from anywhere in the screen displays the beginning of the Help panel.

Figure 13 IOA Help Screen

  ----------------------------- IOA HELP SCREEN -------------------- (CTMHDT2 )  
  COMMAND ===>                                                  SCROLL===> CRSR
                                                                                
    Calendar List Screen                                                      
    ====================                                                      
                                                                                
    The Calendar List screen displays a list of calendars (members) in the    
    specified library. This screen can be entered directly from the entry     
    panel or upon exiting the Year List screen.                               
                                                                                
    By default, only calendar names are listed in the screen. However, if     
    the default has been modified at time of installation, statistical        
    information is displayed for each calendar name.                          
                                                                                
    Use the scrolling PFKeys to scroll forward (PF08/PF20) and backward       
    (PF07/PF19) on the Calendar List.                                         
                                                                                
    To return to the entry panel, press END (PF03/PF15).                      
                                                                                
                                                                                
    Options of the Calendar List Screen                                       
    -----------------------------------                                       
    To request one of the following options, specify the option in the OPT    

Help can be scrolled using standard scrolling conventions.

To return to the original screen, use the END command (PF03/PF15).

The Help member name appears on the right in the Help screen header. Members containing the Help descriptions can be found in the IOA MSG library.

IOA Under ISPF

The IOA Online facility can be activated as an ISPF application. As such, it can work in ISPF split screen mode like any other ISPF application.

WARNING: Multiple calls to the IOA ISPF interface can be performed in ISPF split screen mode as long as all invocations are for the same IOA environment. Otherwise, the results may be unpredictable.

The command line of the IOA Online facility is controlled by IOA. It is not possible to enter ISPF commands in an IOA screen. Two ISPF commands must be defined to PFKeys:

Table 18 ISPF Command Definitions for PFKeys

The rest of the PFKeys are controlled by IOA PFKey definitions, which are in the IOA PARM library.

It is possible to assign TSO/ISPF commands such as PRINT to PFKeys, or to change PFKey definitions by performing the following steps:

1. Exit from IOA and ISPF to the READY prompt.

2. Type the following command and press Enter:

   Copy

   ISPSTART PANEL(ISR@PRIM) NEWAPPL(CTM)

   This command brings you to ISPF.

3. Type the KEYS command and press Enter. A set of key definitions is displayed.

4. Modify the key definitions as desired and exit from ISPF.

Under ISPF, IOA Option 6 activates the Online Utilities panel, described in IOA Online Utilities Menu. For more information about these utilities, see the INCONTROL for z/OS Utilities Guide.

For more information on changing IOA PFKey definitions, see the appendix in the INCONTROL for z/OS Administrator Guide that deals with modifying IOA Online Facility Commands.

IOA Editor

The IOA Editor enables you to edit members of a partitioned dataset (PDS) using an editor similar to the ISPF editor. Enter EDMEM in the command line of any screen to display the Edit Entry Panel window, as shown in Figure 14.

Figure 14 IOA Editor Edit Entry Panel

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N06     
                                                                              
IOA                          CONTROL-D/V               CONTROL-O               
                                                                               
  4  COND/RES                A  MISSION STATUS         OR  RULE DEFINITION    
  5  +--------------------------------------------------------------+ICS      
  6  |                     EDIT ENTRY PANEL                         |         
  7  |                                                              |LOG      
  8  | LIBRARY ==>                                                  |OPTS     
 IV  |                                                              |US       
     | MEMBER  ==>                                                  |R        
     |                                                              |         
     | FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT|         
CONTR|                                                              |         
     +--------------------------------------------------------------+         
  2  JOB SCHEDULE DEF       BB  BALANCING STATUS       TR  RULE DEFINITION    
  3  ACTIVE ENV.            BM  MISSION DEF            TP  POOL DEFINITION    
  C  CMEM DEFINITION        BV  DB VARIABLE DEF        TV  VAULT DEFINITION   
                            BR  RULE DEFINITION        TI  INQ/UPD MEDIA DB   
                            BA  RULE ACTIVITY          TC  CHECK IN EXT VOL   
                                                                              
                                                                              
COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               19.12.05

To create a new member or edit an existing member, fill in the LIBRARY and MEMBER parameters and press Enter. The IOA Editor screen is opened for editing, as shown in Figure 15.

Figure 15 IOA Editor

----------------------------  I O A   E D I T O R   ------------------- (EDMEM)
COMMAND ===>                                                    SCROLL===> CRSR
ROW     PROD.V610.DEMO(TEST)                                        COL 001 072
                                                                              
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
************************ B O T T O M  O F  D A T A ************************** 
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
OPTIONS:  I INSERT  D DELETE  R REPEAT  C COPY  M MOVE  UC/LC UPPER/LOWER CASE

IOA Editor PFKey Functions

While working within the IOA Editor, PFKeys perform the functions shown in Table 19:

Table 19 PFKey Functions Within the IOA Editor Screen

Commands of the IOA Editor Screen

Table 20 describes editing commands that can be executed by entering the command in the COMMAND line.

Table 20 IOA Editor Command Line Commands

Table 21 describes editing commands that can be executed by entering the command in the leftmost position of the applicable row.

Table 21 IOA Editor Row Commands

IOA SET Command Panel

The IOA SET Command Panel enables you to set and stop TRACE levels, choose the language that is used in online screens and to set a dollar sign representation that will be used in online screens for system variables of type %%$VAR. Enter SET in the command line of any screen to display the SET Command Panel window, as shown in Figure 16.

Figure 16 IOA SET Command Panel

+-----------------------------------------------------------------------------------+
|                        SET Command Panel                                          |
|                                                                                   |
|                                                                                   |
|  TRACE level     , ON  (Trace level 001-512, ON or OFF)                           |
|                                                                                   |
|                                                                                   |
|    LANGUAGE              ENG - English                                            |
|                                      FRA - French                                 |
|                                      GER - German                                 |
|                                      JPN - Japanese                               |
|                                                                                   |
|                                                                                   |
|    SPECIAL CHARACTERS: Dollar     Current representation is "$"(X'5B')            |
|                                                                                   |
|                                                                                   |
| FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT                     |
|                                                                                   |
+-----------------------------------------------------------------------------------+   

The process of setting TRACE levels and turning off a particular TRACE, and the process of setting language preferences for online screens and messages, begins in the SET Command Panel.

Using the SET Command Panel to set and end TRACE levels

Setting the TRACE level can help you monitor certain IOA Online facility and INCONTROL functions, such as security checks.

The following steps explain how to set or turn off a TRACE level:

1. Type a TRACE level number, from 1 through 256, in the TRACE LEVEL field of the SETCommand Panel.

2. In the (Trace level 1-256, ON or OFF) field, type ON to set a TRACE level, or OFF to turn off a TRACE level.

3. Press Enter to confirm the setting, in which case the following message is displayed:

   Copy

   CTMA2AI TRACE LEVEL nnn WAS SET xxx

   where

   • nnn is the TRACE level number

   • xxx indicates whether the TRACE level was set ON or turned OFF

Using the SET Command Panel to set a dollar sign representation

Setting the dollar sign representation influences how System variables are shown in online screens.

The following steps explain how to set the dollar sign representation:

1. Type a $ character in the Dollar field using your keyboard.

2. Press Enter to confirm the setting, in which case the following message is displayed:

   Copy

   CTMA2DI THE NEW DOLLAR REPRESENTATION IS "c"(X'yy')

   where

   • c is $ character you set

   • yy is the EBCDIC hexadecimal code for $

Using the SET Command Panel to set language preferences

Setting the LANGUAGE influences the online screens and messages in subsequent sessions.

The following steps explain how to set language preferences:

1. In the LANGUAGE field, type one of the following sets of characters to select a language preference:

   • ENG, to set English as the preferred language

   • FRA, to set French as the preferred language

   • GER, to set German as the preferred language

   • JPN, to set Japanese as the preferred language

2. Press Enter to confirm the setting, in which case the following message is displayed:

   Copy

   CTMA27I THE NEW LANGUAGE WILL BE USED FROM THE NEXT LOGON TO IOA

IOA TSO Command Processor Screen

The IOA TSO Command Processor screen can be entered only when the IOA Online facility is activated as a TSO application. It cannot be entered when the IOA Online facility is activated as an ISPF application or activated under a non-TSO environment.

The TSO screen enables activation of any TSO command without exiting the IOA Online facility. For example, a typical program activated under the TSO screen is ISPF. Therefore, all ISPF/PDF facilities and functions (such as editing a member or scanning job output) can be activated while you are working under the IOA Online facility.

To activate a TSO command, type the command in the COMMAND field and press Enter.

Figure 17 IOA TSO Command Processor Screen

 -------------------------- IOA TSO COMMAND PROCESSOR ----------------------(6)
 COMMAND ===>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 PLEASE ENTER TSO COMMAND                                              15.32.52

TSO commands can also be activated directly from any online screen by typing TSO in the COMMAND field.

Transfer of Control Between the TSO Application and the IOA Online Facility

You can return to the IOA Online facility from the TSO application by simply exiting the TSO application in a normal manner. However, this method may be time consuming and inconvenient if an ISPF application or similar TSO application is activated.

If the TSO application can issue a TSO command, it is possible to transfer control to the IOA Online facility, and vice versa, without exiting the TSO application.

While working under the TSO application, for example, under ISPF, issue the command:

TSO CTMTTRA {n | =n}

where n is the online screen number. The requested screen is displayed as it was when you transferred from it.

To return to the TSO application, use the =6 command (PF06/PF18). The application remaining in the same state as when you transferred from it.

It is recommended that you simplify transfer between screens by permanently assigning one of your PFKeys under ISPF (or SDSF, and so on) to the command TSO CTMTTRA. Once this key assignment is made, you no longer need to type the full transfer command. Instead, you merely type the IOA option number or code in the COMMAND field and press the assigned PFKey. You are transferred to the desired screen.

Report Decollating Mission Definition Facility

The Control-V Report Decollating Mission Definition facility is composed of a series of screens that enable you to view, create, and modify report decollating missions and parameters.

Report decollating mission definitions under Control-V are stored in libraries (partitioned datasets). A library contains members (also referred to as jobs or report names), and each member contains categories of one or more mission definitions. A member generally contains decollating mission definition categories related to specific topics. When Control-M is installed and a member contains decollating mission definitions that process output from Control-M jobs, the member name should correspond to the jobname as defined in each of its decollating mission definitions. For mission definitions that process output from non-Control-M jobs, there is no such restriction for the member name. Although most sites designate a primary mission definition library, the number of mission definition libraries that you can use is unlimited.

Accessing the Report Decollating Mission Definition Facility

The Report Decollating Mission Definition facility contains the following screens:

Table 22 Report Decollating Mission Definition Facility Screens

To enter the Report Decollating Mission Definition facility, select option R on the IOA Primary Option menu and press Enter. The entry panel is displayed.

Creating Members

Members can be created in any of the following ways:

• By specifying the new member name in the entry panel and pressing Enter.

• By using the SELECT command (described later) to specify the new member name in the Job List screen and pressing Enter.

As a result of using either of the above methods, a skeletal mission definition (that is, one with most fields not filled in) is displayed in the Mission Definition screen.

Fill in the blanks and save the screen entries. The member is created with the specified mission definition. The mission definition is the first and only definition in the Category list for the member. As additional mission definitions are created in the member (described below), they are added to the Category list.

Creating Mission Definitions

Mission definitions can be created using two basic methods:

• A skeletal mission definition can be created by specifying the name of a new mission definition in the entry panel. (The member specified in the entry panel can be either a new member or an existing member.) In this case, virtually all fields of the mission definition are empty.

• A copy of an existing mission definition can be created using the INSERT option (described later) in the Category List screen. In this case, most fields of the new mission definition have the same values as the fields in the copied mission definition.

Performing Operations on Members and Mission Definitions

Many operations can be performed on members and on the mission definitions in them. These operations are performed using commands and options in the various screens of the Report Decollating Mission Definition facility.

Below is a brief summary of some of the major operations possible within the facility. Options and commands that have not yet been explained are explained in detail following the summary.

Accessing (Editing or Browsing) a Member and its Mission Definitions

A member (that is, the mission definitions in the member) can be browsed or edited.

When browsed, the member cannot be modified or updated. When the member is edited, new mission definitions can be added and existing mission definitions can be modified or deleted.

Browsing, however, has advantages:

• Access and exit are quicker than in editing.

• Mission definitions that are in use by another user can be viewed.

• Access for browsing might be granted, even though access for editing might be denied due to site security requirements.

To browse a member (and its category list and mission definitions), use the BROWSE option in the Job List screen.

Specifying the job (member) name in the entry panel or using the SELECT option in the Job List screen provides edit access.

Depending on user profile definitions, if the table requested for editing is in use, either access is granted in Browse mode or access is not granted.

Copying a Mission Definition to Another Member

Mission definitions can be copied from one member to another using the COPY option in the Category List screen. For more information, see Copying Report Decollating Mission Definitions to Another Member.

Deleting a Member or a Mission Definition

Unneeded mission definitions can be deleted via the DELETE option in the Category List screen. For more information, see Options of the Category List Screen. Unneeded members can be deleted via the DELETE option in the Job List screen. For more information, see Deleting Members.

Ordering Multiple Members

More than one member at a time can be ordered at one time. To select multiple members, Tab down to each table in the Job List screen that you want to select and enter the letter "O" next to the desired member. Press Enter. A popup confirmation window appears that asks whether or not you want to view the confirmation window for each member.

If you choose not to view the confirmation screen before viewing each member (Confirm Y, Ask For Each One N), press Enter.

Saving Modifications

All changes made to a member and its mission definitions are kept in memory until the member is exited. Upon exiting the member, the user can choose to save or cancel the changes. For more information, see Exiting the Mission Definition Screen.

Entry Panel

To open the desired display, fill in Entry Panel fields LIBRARY, JOB, and CATEGORY as described below. Type Y (Yes) or N (No) in the SHOW SCHEDULING CRITERIA field to determine whether scheduling parameters appear when the Report Decollating Mission Definition screen is displayed.

Figure 18 Report Decollating Mission Definition Facility Entry Panel

 ------- CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION ENTRY PANEL -----(R)
 COMMAND ===>
 SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY
  LIBRARY   ===> CTD.PROD.REPORTS
  JOB       ===>                      (Blank for job selection list)
  CATEGORY  ===>                      (Blank for category selection list)
  SHOW SCHEDULING CRITERIA ===> N     (Y/N)
 USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                          13.11.20

Displaying the list of members (jobs) in a library

1. Type the library name.

2. Leave the member (job) name blank or type the member (job) name using mask characters (* and ?).

3. Press Enter.

Displaying the list of mission definitions for a specific member

1. Type the library name.

2. Type the member name.

3. Press Enter.

If the member does not exist, the screen for defining a new mission definition in the member is displayed.

Displaying the details of a specific mission definition (Mission Definition screen)

1. Type the library name

2. Type the job (member) name.

3. Type the mission definition (category) name.

4. Press Enter.

If the member does not exist, or the mission definition for the specified member does not exist, the screen for defining a new mission definition in the member is displayed.

Displaying the Search Window

1. Type the library name.

2. Type the mission definition (category) name.

3. Leave the member name blank or type the member name using mask characters (* or ?).

4. Press Enter.

Creating a new member

1. Type the library name.

2. Specify a new job (member) name.

3. Press Enter.

The Mission Definition screen, for defining the first mission definition in the new member, is displayed.

Search Window

The Search window allows the user to search for the specified mission definitions in members in the specified library. Members in which the mission definition have been found are then displayed in the Job List screen.

Figure 19 Report Decollating Mission Definition Facility Entry Panel Search Window

- CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION FACILITY - ENTRY PANEL--(R)
COMMAND ===>
SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY
   LIBRARY   ===> CTD.PROD.SCHEDULE
   JOB       ===>                     (Blank for job selection list)
   CATEGORY  ===> CTVSAMPLE           (Blank for category selection list)
                                +-------------------------------------------+
                                |                                           |
                                |    PLEASE SELECT ONE OF THE FOLLOWING:    |
                                |                                           |
                                |    1  - STOP SEARCH IMMEDIATELY           |
                                |    2  - ASK AGAIN AFTER 000010 MEMBERS    |
SHOW SCHEDULING CRITERIA ===>   |    3  - UNCONDITIONAL SEARCH              |
                                |                                           |
                                |    NUMBER OF MEMBERS IN LIBRARY: 000015   |
                                |    NUMBER OF SEARCHED MEMBERS:   000000   |
                                |    NUMBER OF SELECTED MEMBERS:   000000   |
                                |                                           |
                                +-------------------------------------------+
USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT                             12.11.54

To close the Search Window without performing any action, press END (PF03/PF15).

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

Performs an uninterrupted search of all tables in the specified library.

The search is stopped immediately when you select option 1.

2 - ASK AGAIN AFTER number MEMBERS

Searches the specified number of members in the specified library, and then pauses. The search number can be modified. Default:10.

• Continue the search by pressing Enter.

• Stop the search by selecting option 1 (Stop Search Immediately).

If any members are found, the Job List is displayed listing those members.

During the search, the following information is displayed at the bottom of the window:

• Number of members in library. Lists the total number of members in the specified library.

• Number of searched members. Lists the cumulative number of members searched. For example, if you perform three searches with a specified number of 10, the figure displayed is 30.

• Number of selected members. Lists the cumulative number of members selected that contain the mission definition being searched.

If any members are selected during the search, the Job List is displayed listing those members. If no members are selected, the Search Window is closed and a message is displayed.

Report Decollating Mission Definition – Job List

The screen displays the list of members in the specified library. This screen can be entered directly from the entry panel or upon exiting the Category List screen.

By default, only member names are listed in the screen. However, if the default has been modified at time of installation, statistical information is displayed for each member name (as shown in Figure 20).

Figure 20 Report Decollating Mission Definition Facility Job List Screen

  LIST OF JOBS LIB: CTD.PROD.REPORTS                           ----------------  
  COMMAND ===>                                                  SCROLL===> CRSR
  OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
       PRDKPL01          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       PRDKPL02          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
       PRDKPLW1          01.01 00/11/24 00/11/24 12:17     9     9     0 M35A
       PRDKPLW2          01.00 00/06/30 00/06/30 09:54    12    12     0 V309
       PRDKPLW3          01.02 00/11/22 00/11/22 11:04     6     6     0 M72
       PRDKPLW4          01.01 00/11/27 00/11/27 13:33     8     8     0 M18C
       PRDLRPT1          01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       PRDLRPT2          01.00 00/04/17 00/04/17 00:50   180   180     0 O01
       PLRPT010          01.00 00/04/17 00/04/17 00:50    41    41     0 O01
       PRODYALT          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
       PRODYHST          01.00 00/04/17 00/04/17 00:50     9     9     0 S07
       PRODYJCL          01.00 00/04/17 00/04/17 00:50    14    14     0 S07
       PRODYRPT          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
       QNTR0001          01.01 00/11/24 00/11/24 12:17     9     9     0 M35A
       QNTR0002          01.00 00/06/30 00/06/30 09:54    12    12     0 V309
       RBDMM4D           01.02 00/11/22 00/11/22 11:04     8     6     0 M72
       RTUPDT            01.01 00/11/27 00/11/27 13:33     8     8     0 M18C
       STPRQV            01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       TRUPDOLV          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       UPLIR17A          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
  OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE         14.39.49

To scroll down the Job list, press PF08/PF20. To scroll up the Job list, press PF07/PF19.

To return to the entry panel, press END (PF03/PF15).

Options of the Job List Screen

To request one of the following options, specify the option in the OPT field to the left of the member names and press Enter:

Table 23 Options of the Job List Screen

Deleting Members

To delete members specify option D in the OPT field to the left of the members to be deleted and press Enter.

The following confirmation window is displayed, in sequence, for each member selected for deletion.

Figure 21 Report Decollating Mission Definition Facility Delete Members Confirmation Window

  LIST OF JOBS LIB: CTD.PROD.REPORTS                           ----------------
  COMMAND ===>                                                  SCROLL===> CRSR
  OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
       ACCTNG01          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       ACCTNG02          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
       ACCTNGW1               +--------------------------+
       ACCTNGW2               |   CONFIRM DELETE OPTION  |
   D   ACCTNGW3   <-----------|               (Y/N)      | 6     6     0 M72
       ACCTNGW4               +--------------------------+ 8     8     0 M18C
       ADMINST1          01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       ADMINST2          01.00 00/04/17 00/04/17 00:50   180   180     0 O01
       PERSNL10          01.00 00/04/17 00/04/17 00:50    41    41     0 O01
   D   PERSNLDK          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
       PERSNLST          01.00 00/04/17 00/04/17 00:50     9     9     0 S07
       PRODTNCL          01.00 00/04/17 00/04/17 00:50    14    14     0 S07
       PRODTNTL          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
   D   RESTOR01          01.01 00/09/25 00/09/25 12:17     9     9     0 M35A
       RESTOR02          01.00 00/06/30 00/06/30 09:54    12    12     0 V309
       SALES4D           01.02 00/09/22 00/09/22 11:04     8     6     0 M72
       SALEST            01.01 00/09/26 00/09/26 13:33     8     8     0 M18C
       SALESV            01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       TRAIN001          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       TRAIN001          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           14.39.49

• Enter Y (Yes) in the window to confirm the delete request.

• Enter N (No) in the window to cancel the delete request.

Report Decollating Mission Definition – Category List

The screen displays the list of mission definitions of a member in a specified library. This screen can be entered directly from the Report Decollating Mission Definition entry panel or the Job List screen, or upon exiting the Mission Definition screen.

Figure 22 Report Decollating Mission Definition – Category List Screen

 CATEGORIES OF LIB CTD.PROD.REPORTS                               JOB: PLRPT010
 COMMAND ===>                                                   SCROLL===> CRSR
 OPT  NAME --------------------------------------------------------------------
      DAILY                  INVENTORY AND EMPLOYEE REPORTS - DAILY
      MONTHLY                INVENTORY AND EMPLOYEE REPORTS - MONTHLY
  ====== >>>>>>>>>>>>>>  NO MORE CATEGORIES FOR THE JOB <<<<<<<<<<<<<<<<< =====
 
 
 
 
 
 
 
 
 
 
 
 
 
 OPTIONS:  S SELECT   D DELETE   I INSERT   O ORDER   F FORCE          13.43.00

Use the scrolling conventions to scroll forward and backward through the Category list.

Format of the Category List Screen

Next to each mission definition name in the Category list, certain information can be displayed. The type and format of this information depends on whether the screen is displayed in DESC format or in STAT format:

• In DESC format, the mission definition’s description, taken from the DESC field of the mission definition, is displayed. Default.

• In STAT format, the mission definition’s ISPF statistical information is displayed.

By default, the Category list is displayed in DESC format. To change formats, use the DESC or STAT commands, described in Table 24.

Commands of the Category List Screen

The following commands can be specified in the COMMAND field of the Category List screen.

Table 24 Commands of the Category List Screen

Options of the Category List Screen

To request one of the following options, specify the option in the OPT field to the left of the mission definition name and press Enter:

Table 25 Options of the Category List Screen

Report Decollating Mission Definition Screen

This screen is used to define, display and modify decollating parameters of the reports of a specific mission definition. This screen can be entered directly from the Report Decollating Mission Definition entry panel or from the Category List screen. Update of parameters is not permitted in Browse mode.

Control-V indexing instructions are included in the decollating parameters.

Decollating parameters take up more than one screen. Use the scrolling conventions to scroll the decollating parameters forward and backward.

For a detailed explanation of the decollating parameters, refer to Decollating Mission Parameters.

To delete a parameter on the screen, simply erase it (press the EOF key or blank it out). If additional operations are required, Control-V issues appropriate instructions.

Report decollating mission parameters are divided into the following basic groups indicated on the following screen:

• General parameters

• Basic Scheduling parameters

• Runtime Scheduling parameters

• Post-processing parameters

• Decollating parameters (including indexing instructions)

The groups are separated by a delimiter line.

The decollating parameters are organized in ON blocks. Each ON block contains decollating instructions for those reports that are defined in the ON statement.

Figure 23 Report Decollating Mission Definition Screen

  ----- CONTROL-D/V CATEGORY DAILY               JOB  M15ACC   ---------- (R.S)
  COMMAND ===>                                                  SCROLL===> CRSR
  +---------------------------------------------------------------------------+
    CATEGORY DAILY                  JOBNAME PLRPT10   GENERIC N  MONITOR 1
    OWNER    M22       TASKTYPE REP GROUP   PL-PRODUCTION        JOBID
    DESC     EMPLOYEE REPORTS
    DESC
    ===========================================================================
    DAYS                                                          DCAL
                                                                       AND/OR
    WDAYS   ALL                                                   WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
    ===========================================================================
    IN PLRPT010-ENDED-OK         0909
    WHEN IN QUEUE Y CLS   TIME FROM      UNTIL      INTERVAL      PRIORITY
    DSN
    ===========================================================================
    OUT
     MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED NOTOK ====
    ===========================================================================
    DEF COPIES 01 LVL    USER UNIDENT              DEST          MAX COPIES 10
    ===========================================================================
    SET        = %%        =                                           C   CS
    ===========================================================================
    ON CLASS      = D         EXTWTR               DEST          FORM
    PRT COPIES    LVL    USER                      DEST          MAX COPIES
        PRINT/CDAM PARMS =
    WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT N CT     AND/OR O
         STRING = E M P L O Y E E S    R E P O R T
    DO INDEX   = EMNUM                M   R   G   LINE +00000 COL 00011 - 00014
          MASK = ####                 RC Y LINE 00002 - 00060 COL 00011 - 00014
    02 SUBINDX = EMPNAME              M   LVL 02  LINE +00000 COL 00016 - 00035
          MASK = *                    RC Y LINE 00002 - 00060 COL 00016 - 00035
    03 SUBINDX = EMPGRADE             M   LVL 03  LINE +00000 COL 00037 - 00040
          MASK = ####                 RC Y LINE 00002 - 00060 COL 00037 - 00040
       SUBINDX =                      M   LVL     LINE        COL       -     
          MASK =                      RC   LINE       -       COL       -     
    ===========================================================================
                              INDEX LEVEL DISPLAY
      EMPNUM / EMPNAME / EMPGRADE
    ===========================================================================
    DO USER    = *                         LVL    LINE        COL 00064 - 00074
                            S N T         SYNONYM =       CONCAT =            
    DO NAME    = EMPLOYEES REPORT                                             
    DO MIGRATE  = MIG005Y
    DO
    WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
         STRING =
  ====== >>>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< ====
  FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH             12.32.12

CAPS Command

By default, all entries of lowercase characters in the Report Decollating Mission Definition screen are converted and saved as uppercase. You can use the CAPS OFF command to enable certain fields to accept and save lowercase entries.

Valid formats of the CAPS command are:

Table 26 CAPS Command Formats

The CAPS OFF command is available only for the following parameters and subparameters:

Table 27 Parameters and Subparameters Accepting Lowercase Values

When you first enter a decollation mission definition screen, the CTOD78I message is displayed with the current CAPS setting. The CTOD78I message is also displayed, with the current ON or OFF status, whenever you enter the CAPS command.

Display and Non-Display of Scheduling Criteria

When N has been entered in the SHOW SCHEDULING CRITERIA field of the Report Decollating Mission Definition entry panel, all General, Basic Scheduling, Runtime Scheduling and Post-processing parameters are hidden except the Category line of the General parameters. The SET lines of Decollating parameters are also hidden.

The Category line is displayed, followed by the decollating parameters.

Figure 24 Non-Display of Scheduling Criteria

 ------- CONTROL-D/V CATEGORY DAILY                JOB  PLRPT010 ---------(R.S)
 COMMAND ===>                                                   SCROLL===> CRSR
 +----------------------------------------------------------------------------+
   CATEGORY DAILY                     JOBNAME PLRPT010 GENERIC   MONITOR      
   ===========================================================================
   DEF COPIES 01 LVL    USER UNIDENT              DEST          MAX COPIES    
   ===========================================================================
   ON CLASS      = D         EXTWTR               DEST          FORM          
   PRT COPIES 01 LVL 20 USER MGT                  DEST          MAX COPIES    
       PRINT/CDAM PARMS =                                                     
   WHEN LINE 00001 - 00014 COL 00014 - 00046 PRINT Y REF NXT N CT N   AND/OR
        STRING = E M P L O Y E E S     R E P O R T                            
   DO NAME     = EMPLOYEES REPORT           
   DO USER    = *                         LVL    LINE        COL 00064 - 00074
                           S N T         SYNONYM =       CONCAT =            
   DO PRINT    = STD                                   MUST   =             
   DO BACKUP   = BKP0007D                                                   
   DO                                                                        
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
      STRING =                                                             
   DO                                                                        
   ===========================================================================
   ON DSN        = DDNAME=PLREP4,PGMSTEP=PLRP0010                            
   PRT COPIES 01 LVL 20 USER MGT                  DEST          MAX COPIES   
 FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH              11.42.50

SCHED Command

Typing SCHED (abbreviated SC) in the command line alternates between the display and non-display of the scheduling parameters (independent of the SHOW SCHEDULING CRITERIA field).

PATH Command

Command PATH can be entered on the command line of the Report Decollating Mission Definition screen to alternately hide or display the Index Level display. When the Index Level screen is displayed, each chain of indexes is listed when it is defined. By default, the Index Level screen is displayed.

The following screen illustrates the definition of four index paths.

Figure 25 Report Decollating Mission Definition Screen – Path Command

  ----- CONTROL-D/V CATEGORY CENSUS5             JOB  N54COPY  ---------- (R.S)
  COMMAND ===>                                                  SCROLL===> CRSR
  +---------------------------------------------------------------------------+
    CATEGORY ACCOUNT                JOBNAME CENSUS5   GENERIC    MONITOR
    ===========================================================================
    DO INDEX   = STATE                M   R   G   LINE +00001 COL 00004 - 00005
          MASK = @                    RC Y LINE 00001 - 00001 COL 00004 - 00005
    02 SUBINDX = COUNTY               M   LVL 02  LINE +00001 COL 00007 - 00025
          MASK =                      RC Y LINE       -       COL       -     
    03 SUBINDX = CITY                 M   LVL 03  LINE +00001 COL 00027 - 00055
          MASK =                      RC Y LINE       -       COL       -     
    04 SUBINDX = ZIPCODE              M   LVL 04  LINE +00001 COL 00031 - 00040
          MASK = #####-####           RC Y LINE 00001 - 00001 COL 00031 - 00040
    04 SUBINDX = STREET               M   LVL 04  LINE +00002 COL 00004 - 00023
          MASK =                      RC Y LINE       -       COL       -     
    05 SUBINDX = BLDG_NO              M   LVL 05  LINE +00002 COL 00025 - 00038
          MASK =                      RC Y LINE       -       COL       -     
    06 SUBINDX = APT_NO               M   LVL 06  LINE +00002 COL 00032 - 00037
          MASK =                      RC Y LINE       -       COL       -     
    ===========================================================================
                              INDEX LEVEL DISPLAY
      STATE / COUNTY / CITY / ZIPCODE
      STATE / COUNTY / CITY / STREET / BLDG_NO / APT_NO
    ===========================================================================
    DO INDEX   = AREACOD              M   R   G   LINE +00004 COL 00004 - 00006
          MASK = ###                  RC Y LINE 00004 - 00004 COL 00004 - 00006
    02 SUBINDX = PHONE                M   LVL 02  LINE +00004 COL 00008 - 00015
          MASK = ###-####             RC Y LINE 00004 - 00004 COL 00008 - 00015
    02 SUBINDX = FAX                  M   LVL 03  LINE +00004 COL 00017 - 00024
          MASK = ###-####             RC Y LINE 00004 - 00004 COL 00017 - 00024
       SUBINDX =                      M   LVL     LINE        COL       -     
          MASK =                      RC   LINE       -       COL       -     
    ===========================================================================
                              INDEX LEVEL DISPLAY
      AREACOD / PHONE
      AREACOD / FAX
    ===========================================================================
  ====== >>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< =====
  FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH             12.32.12

General Parameters

General parameters describe the mission and specify the mission type, owner and group.

Figure 26 General Parameters

 ------- CONTROL-D/V CATEGORY DAILY               JOB  PLRPT010 ----------(R.S)
 COMMAND ===>                                                   SCROLL===> CRSR
 +----------------------------------------------------------------------------+
   CATEGORY DAILY                     JOBNAME PLRPT010 GENERIC N MONITOR      
   OWNER    M22         TASKTYPE REP  GROUP   PL-PRODUCTION      JOBID
   DESC     INVENTORY AND EMPLOYEE REPORTS - DAILY                           
   DESC                                                                      
   ===========================================================================
   DAYS                                                                      

Table 28 General Parameters

Basic Scheduling Parameters

Control-V Basic Scheduling parameters specify on what dates the mission is activated. The basic scheduling requirements are then checked. If they are satisfied, the mission is placed in the Active Missions file. However, the mission is not activated until its runtime scheduling and message/event criteria have been satisfied.

Using the Basic Scheduling parameters is optional. The SHOW SCHEDULING CRITERIA field of the Report Decollating Mission Definition entry panel manages the display of Basic and Runtime Scheduling parameters on the Report Decollating Mission Definition screen. It is also possible to control this feature from the Report Decollating Mission Definition screen. Type SCHED (or SC) on the command line and press Enter to alternate between display and non-display of the scheduling parameters.

Figure 27 Basic Scheduling Parameters

===========================================================================
DAYS                                                          DCAL
                                                                AND/OR
WDAYS   ALL                                                   WCAL
MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL          SHIFT   RETRO N MAXWAIT 00
MINIMUM          PDS
===========================================================================

Table 29 Basic Scheduling Parameters

Runtime Scheduling Parameters

Runtime Scheduling parameters specify requirements that must be satisfied to execute the mission.

Figure 28 Runtime Scheduling Parameters

MINIMUM          PDS
===========================================================================
IN      PLRPT010-ENDED-OK    ODAT
WHEN IN QUEUE Y CLS   TIME FROM 0100 UNTIL 0630 INTERVAL 001  PRIORITY
DSN                                                         
===========================================================================
OUT

Table 30 Runtime Scheduling Parameters

Post-Processing Parameters

Post-processing parameters specify what to do when the mission finishes processing (OK or NOTOK).

Figure 29 Post-Processing Parameters

DSN
=========================================================================== 
OUT     PLRPT010-DECOLLATED  ODAT +                                         
SHOUT WHEN NOTOK                                TO OPER2            URG R   
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED  N O T O K ====             
SHOUT WHEN                                      TO                  URG     
MSG                                                                        
=========================================================================== 
DEF COPIES    LVL    USER                      DEST          MAX COPIES     

Table 31 Post-Processing Parameters

Decollating Parameters

Decollating parameters specify how to decollate the reports of the job.

Figure 30 Decollating Parameters

MSG                                                                      
=========================================================================== 
DEF COPIES 01 LVL    USER CRDBANK              DEST          MAX COPIES 05  
=========================================================================== 
SET        = %%        =                                           C   CS
===========================================================================
ON CLASS      = D         EXTWTR               DEST          FORM

Default Decollating Parameters

General default decollating parameters for report pages include:

Table 32 Default Decollating Parameters

SET Statement

The SET statement assigns an initial value to a system variable that is used during this decollation process or a regular variable that can be used in this decollation mission.

===========================================================================
DEF COPIES 01 LVL    USER UNIDENT              DEST          MAX COPIES 10  
=========================================================================== 
SET        = %%$MEMORY  =ABOVEBAR                                   C   CS
===========================================================================
ON CLASS      = D         EXTWTR               DEST          FORM

ONM Statement

The ON statement allows the decollation is to be carried out on the following criteria:

Table 33 ON Statement Subparameters

ON CLASS      = D         EXTWTR               DEST          FORM              
PRT COPIES 01 LVL 20 USER MGT                  DEST          MAX COPIES 04
       PRINT/CDAM PARMS =                                                    
   ON SYSOUT     PGMSTEP PLRPT010 PROCSTEP           DDNAME PLRPT4   CLASS
   PRT COPIES 01 LVL 20 USER MGT                  DEST          MAX COPIES 06
   ON SYSLOG                                                                 
   PRT COPIES 01 LVL 90 USER PRODCNTL             DEST          MAX COPIES 05
       PRINT/CDAM PARMS =                                                    

ON Statement Defaults

Each ON statement is followed by printing default parameters that apply to the reports defined under the ON statement.

Table 34 ON Statement Defaults

  ON CLASS      = X         EXTWTR               DEST          FORM
  PRT COPIES 01 LVL 20 USER MGT                  DEST RUR252   MAX COPIES    
      PRINT/CDAM PARMS = PAGEDEF=ARI1,FORMDEF=IBM1                           
      PRINT/CDAM PARMS =                                                     
  WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR               

PRINT/CDAM Parameters

This field overrides default CDAM parameters, such as PREFIX and UNIT.

    PRINT/CDAM PARMS =                                                    
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N   AND/OR 
     STRING = E M P L O Y E E S     R E P O R T                                            
DO NAME    = EMPLOYEES REPORT                              

WHENM Parameter

The WHEN parameter indicates page identification criteria.

Table 35 WHEN Subparameters

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T                           

DOM Options

The following are a description and example of each of the DO action that can be taken when the WHEN condition is fulfilled:

DO USER – Name of the user (recipient) to whom the identified page in the report is sent, or the LINE and COL range in the report where the user name can be found.

    DO USER    = *                         LVL    LINE        COL 00064 - 00074
                            S N T         SYNONYM =       CONCAT =            _

DO INDEX – Defines a main index and optional subindexes for a CDAM file.

    DO INDEX   = EMNUM                M   R   G   LINE +00000 COL 00011 - 00014
          MASK = ####                 RC Y LINE 00002 - 00060 COL 00011 - 00014
    02 SUBINDX = EMPNAME              M   LVL 02  LINE +00000 COL 00016 - 00035
          MASK = *                    RC Y LINE 00002 - 00060 COL 00016 - 00035
    03 SUBINDX = EMPGRADE             M   LVL 03  LINE +00000 COL 00037 - 00040
          MASK = ####                 RC Y LINE 00002 - 00060 COL 00037 - 00040
       SUBINDX =                      M   LVL     LINE        COL       -     
          MASK =                      RC   LINE       -       COL       -     

DO MIGRATE – Specifies the migration mission that migrates this report from DASD to another storage media.

   DO MIGRATE = MIG0007Y
   DO

DO BACKUP – Specifies the backup missions that backs up this sysout.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T
     DO BACKUP   = BKP0031D
     DO
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO PRINT – Specifies the printing missions that should (can) print this report.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T
     DO PRINT    = STD                                   MUST             
     DO
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO NAME – Specifies the report name. The user (recipient) can use the name as a key for retrieving the report.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T                           
     DO NAME     = EMPLOYEES REPORT             
     DO                                                                        
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO COND – Adds and/or deletes prerequisite conditions.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T                         
     DO COND     = EMPLOYEES-FILE-OK    ODAT +                             
     DO                                                                    
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO SET – Assigns a value to a variable that can be used by other decollation parameters.

   WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT   REF NXT   CT     AND/OR
        STRING = %%ACC                                                     
   DO                                                                      
   DO SET     = %%REP     ='REPORT FOR '                              C   CS
   DO SET     = %%REM_M   =NEW                                        C   CS

DO SHOUT – Specifies a message to be sent. Control-V system variables are resolved in the message text.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E M P L O Y E E S     R E P O R T                         
     DO SHOUT    TO U-EMPLOYEES-DEP     URGENCY R                          
      = MONTHLY EMPLOYEES FILE AND REPORTS ARE OK                          
     DO                                                                    
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO CTBRULE – Invokes the Control-M/Analyzer Runtime Environment that performs balancing operations defined in the specified rule on Control-V pages. Available only at sites using Control-M/Analyzer.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = B A N K I N G   R E P O R T
     DO CTBRULE  = BNKRULE  ARG 100000,50000,25000
     DO
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
        STRING =
     DO

DO NOTOK – Generates a NOTOK status if the string specified in the WHEN statement is found.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = ENDED WITH ERRORS                        
     DO NOTOK
     DO
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO REMARK – Specifies a remark to be generated when the string specified in the WHEN statement is found.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E X C E P T I O N S     R E P O R T                        
     DO REMARK   = EXCEPTION                    LINE     COL     -
     DO REMARK2  = EXCEPTION                    LINE     COL     -
     DO REMARK3  = EXCEPTION                    LINE     COL     -

DO LEVEL – Specifies the level of the user (recipient) to whom the identified page in the report is sent. It is recommended not to use DO LEVEL at this stage.

   WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
        STRING = E X C E P T I O N S     R E P O R T                        
     DO LEVEL                                                               
   WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR

DO APPROV – Specifies that the report should be approved.

DO
WHEN LINE 00020 - 00060 COL 00020 - 00024 PRINT   REF NXT   CT     AND/OR
     STRING = TOTAL
DO APPROV  =          HIDDEN Y MULTI   STORE N SLA
DO

Editing Mission Definitions in the Edit Environment

Report decollating mission definition parameters can be edited (moved, copied, deleted, repeated) by performing IOA line editing commands, similar to standard ISPF line commands, from within the Control-V Edit environment.

The EDIT command alternately activates and deactivates the Edit environment of the Report Decollating Mission Definition screen.   

Figure 31 Entering Editing Commands

  ------- CONTROL-D/V CATEGORY DAILY               JOB  *        ---------(R.S)
  COMMAND ===>                                                  SCROLL===> CRSR
  +---------------------------------------------------------------------------+
  __ WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT   REF NXT   CT     AND/OR
  __      STRING =
  __   DO NAME     = PRODUCTION JCL              
  MM   DO USER     = *                     LVL    LINE      COL 00064 - 00074
                              S N T         SYNONYM =       CONCAT =            
  __   DO BACKUP   = BKP0007D
  __   DO SHOUT    TO TSO-001             URGENCY
  MM    = NON-PRODUCTION JCL COMPLETED
  __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
  __      STRING =
  __   DO
  __ =========================================================================
  __ ON CLASS      = B         EXTWTR               DEST          FORM
  __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
  __     PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
  __     PRINT/CDAM PARMS =
  __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
  __      STRING =
  A_   DO NAME     = NON-PRODUCTION JCL           
  __   DO
 FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH              18.47.45

A 2-character line editing command field, marked by underscores, is displayed for each line on the screen.

Editing commands are typed directly onto these underscores.

Specified line editing commands are processed when Enter is pressed.

For more detailed information and examples, see Editing Mission Definitions in the IOA Edit Environment.

Exiting the Report Decollating Mission Definition Screen

Use one of the following commands to exit the Report Decollating Mission Definition screen:

Table 36 Commands for Exiting the Report Decollating Mission Definition Screen

Automatic Syntax Checking

The definition syntax is automatically checked when the Report Decollating Mission Definition screen is exited using the END, NEXTCTG, or PREVCTG command. This includes checking that users specified in DO USER statements are in the Recipient Tree.

If errors are found in the Report Decollating Mission Definition screen an error message is displayed. The errors may then be corrected. If no errors are found, exit to the Category List screen.

CHKUSR Command

The Control-D CHKUSR command checks if the user specified in parameter DO USER is found in the Recipient Tree. Type CHKUSR (or CH) on the COMMAND line and press Enter.

Saving Report Decollating Mission Definitions

Press END (PF03/PF15) to exit the Category List screen. If changes have been made in the Report Decollating Mission Definition facility, an Exit Option window is opened.

Figure 32 The Report Decollating Mission Definition Exit Option Window

CATEGORIES OF LIB CTD.PROD.REPORTS                                JOB: PLRPT010
COMMAN +-----------------------------------------------------------+  ===> CRSR
OPT  N |                 PLEASE SELECT EXIT OPTION                 |  ---------
     D |                                                           |
     M |     SAVE    CREATE                                        |
 ===== |                                                           |  <<< =====
       |     LIBRARY CTD.PROD.REPORTS                              |
       |     JOB     PLRPT010                                      |
       |                                                           |
       +-----------------------------------------------------------+
 
 
 
 
 
 
 
 
 
 
 
 
 
OPTIONS:  S SELECT   D DELETE   I INSERT   O ORDER   F FORCE  C COPY   15.10.46

You must enter Y (Yes) or N (No) in one of the exit options. It is possible to change the name of the library or member (job or report name) in the window. Return to the Job List or to the entry panel, depending on where you were when you entered the Category List screen.

When saving changes using the EXIT option, all of the mission definitions within a member (job) are saved, even if changes were made to only one mission definition.

Canceling Changes

To exit without saving decollating parameter changes, enter the CANCEL command in the Mission Definition screen, or press RESET (PF04/PF16) in the Exit Option window of the Category List screen

Ordering Report Decollating Missions

The Report Decollating Mission Definition screen is used to define decollating and indexing criteria. This definition becomes "active" only after it is ordered. The report decollating mission can be ordered manually, or it can be ordered automatically each day. For further information see the Control-D and Control-V chapter of the INCONTROL for z/OS Administrator Guide. One way to manually order missions is to use options O and F of the Job or Category List screens.

The options can be activated from:

• Job List screen – All report decollating mission definitions in the selected jobs are ordered.

• Category List screen – Only the selected decollating mission definition is ordered.

These options are specified as follows:

Table 37 Options for Ordering Report Decollating Missions

When you use the O and F options, the default confirmation window shown below is opened. If the default has been modified in the User profile, a different confirmation window, requiring double confirmation, is opened:

Figure 33 Order and Force Confirmation Window

  LIST OF JOBS LIB: CTD.PROD.REPORTS                           ----------------
  COMMAND ===>                                                  SCROLL===> CRSR
  OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
       ACCTNG01          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       ACCTNG02          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
       ACCTNGW1               +-------------------------------+  9     0 M35A
       ACCTNGW2               |   CONFIRM     ODATE 000808    |
   O   ACCTNGW3   <-----------|   ASK FOR EACH ONE  Y         |
       ACCTNGW4               +-------------------------------+  8     0 m18C
       ADMINST1          01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       ADMINST2          01.00 00/04/17 00/04/17 00:50   180   180     0 O01
       PERSNL10          01.00 00/04/17 00/04/17 00:50    41    41     0 O01
   O   PERSNLDK          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
       PERSNLST          01.00 00/04/17 00/04/17 00:50     9     9     0 S07
       PRODTNCL          01.00 00/04/17 00/04/17 00:50    14    14     0 S07
       PRODTNTL          01.00 00/04/17 00/04/17 00:50     5     5     0 S07
   O   RESTOR01          01.01 00/09/25 00/09/25 12:17     9     9     0 M35A
       RESTOR02          01.00 00/06/30 00/06/30 09:54    12    12     0 V309
       SALESD            01.02 00/09/22 00/09/22 11:04     8     6     0 M72
       SALEST            01.01 00/09/26 00/09/26 13:33     8     8     0 M18C
       SALESV            01.00 00/04/17 00/04/17 00:50    70    70     0 O01
       TRAIN001          01.00 00/08/08 00/08/08 16:54    18    18     0 M04B
       TRAIN002          01.00 00/08/08 00/08/08 16:54    20    20     0 M04B
  OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE         14.39.49

The specified date can be changed. If you decide not to order the member (job) or mission definition (category), enter N (No) in the CONFIRM field (for CANCEL), and you return to the original screen.

The ASK FOR EACH ONE line is only displayed if more than one Order (or Force) is requested. If you are certain that you want to order or force all indicated members (jobs) or mission definitions (categories), and do not want to change the ODATE for any of the individual members or mission definitions, you can bypass individual confirmations by entering Y (Yes) in the CONFIRM field and N in the ASK FOR EACH ONE field, and pressing Enter. All the members or mission definitions marked O (or F) is ordered.

For each member or mission definition that is successfully scheduled (ordered), the screen in Figure 34 appears.

Figure 34 The Control Report Order Message Screen

 ---------------------- CONTROL-D REPORT ORDER MESSAGES ------------------(R.O)
 COMMAND ===>                                                   SCROLL===> CRSR
 ------------------------------------------------------------------------------
  17.24.36 CTD049I MISSION PROCESSING STARTED
  17.24.39 CTD528I MISSION PRDKPLW4 ODATE 080800 PLACED ON ACTIVE MISSIONS FILE
  17.24.39 CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
  ===== >>>>>>>>>>>>>>>>>>>>  END OF MESSAGE LIST   <<<<<<<<<<<<<<<<<<<<< =====
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 PRESS END TO RETURN. LEFT AND RIGHT TO SEE MORE.                      09.18.06

Use the END command (PF03/PF15) to return to the Job or Category List screen.

Copying Report Decollating Mission Definitions to Another Member

To copy one or more mission definitions from the current member to another member, specify option C (Copy) by the mission names in the Category List screen and press Enter. The following window is displayed:

Figure 35 Window for Copying Decollating Mission Definitions to Another Member

 CATEGORIES OF LIB CTV.PROD.REPORTS                               JOB: PLRPT010
 COMMAND ===>                                                   SCROLL===> CRSR
  OPT  NAME -------------------------------------------------------------------
   C   DAILY                  INVENTORY AND EMPLOYEE REPORTS - DAILY
       MONTHLY                INVENTORY AND EMPLOYEE REPORTS - MONTHLY
                                                                              
                                                                              
                  +-----------------------------------------------------------+
                  |                                                           |
                  |     SPECIFY DESTINATION LIBRARY,MEMBER AND CATEGORY NAME  |
                  |                                                           |
                  |  LIBRARY :  CTV.PROD.REPORTS                              |
                  |  MEMBER  :                                                |
                  |  CATEGORY:  DAILY                                         |
                  |                                                           |
                  |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |
                  +-----------------------------------------------------------+
                                                                               

The window contains the following fields (some fields contain default values that can be modified):

Table 38 Fields in the Window for Copying Mission Definitions to Another Member

To perform a request, press Enter.

To cancel a request, press END (PF03/PF15) or RESET (PF04/PF16).

Migration, Printing, Backup, Restore Mission Definition Facility

The Control-V Migration, Printing, Backup, Restore Mission Definition facility is composed of a series of screens which enable you to view, create, and modify printing, backup and restore mission parameters.

Migration, printing, backup, and restore mission definitions under Control-V are stored in libraries (partitioned datasets). A library contains missions (members), and each mission contains categories of one or more mission definitions. A mission generally contains migration, printing, backup, and restore mission categories related to specific topics. Although most sites designate a primary mission library, the number of mission libraries that you can use is unlimited.

Accessing the Mission Definition Facility

The Migration, Printing, Backup, Restore Mission Definition facility contains the following screens:

Table 39 Printing, Backup, Restore Mission Definition Facility Screens

To create mission definitions via the online facility, select option M on the IOA Primary Option menu. The Mission Definition entry panel is displayed.

Creating Missions

Missions can be created in any of the following ways:

• By specifying the new mission name in the entry panel and pressing Enter.

• By using the SELECT command (described later) to specify the new mission name in the Mission List screen and pressing Enter.

As a result of using either of the above methods, a skeletal mission definition (that is, one with most fields left blank) is displayed in the Mission Definition screen.

Fill in the blanks and save the screen entries. The mission is created with the specified mission definition. The mission definition is the first and only definition in the Category list for the mission. As additional mission definitions are created in the mission (described below), they are added to the Category list.

Creating Mission Definitions

Mission definitions can be created using two basic methods:

• A skeletal mission definition can be created by specifying the name of a new mission definition (category) in the entry panel. (The mission specified in the entry panel can be either a new mission or an existing mission.) In this case, virtually all fields of the mission definition are empty.

• A copy of an existing mission definition can be created using the INSERT option (described later) in the Category List screen. In this case, most fields of the new mission definition have the same values as the fields in the copied mission definition.

Performing Operations on Missions and Mission Definitions

Many operations can be performed on missions and on the mission definitions in them. These operations are performed using commands and options in the various screens of the Migration, Printing, Backup, Restore Mission Definition facility.

Below is a brief summary of some of the major operations possible within the facility. Additional options and commands that have not yet been explained are explained in detail following the summary.

Accessing (Editing or Browsing) a Mission and its Mission Definitions

A mission (that is, the mission definitions in the mission) can be browsed or edited.

When browsed, the mission cannot be modified or updated. When the mission is edited, new mission definitions can be added and existing mission definitions can be modified or deleted.

Browsing, however, has advantages:

• Access and exit are quicker than in editing.

• Mission definitions that are in use by another user can be viewed.

• Access for browsing might be granted, even though access for editing might be denied due to site security requirements.

To browse a mission (and its category list and mission definitions), use the BROWSE option in the Mission List screen.

Entering the mission name in the entry panel or using the SELECT option in the Mission List screen provides edit access.

Depending on user profile definitions, if the table requested for editing is in use, either access is granted in Browse mode or access is not granted.

Copying a Mission Definition to another Mission

Mission definitions can be copied from one mission to another using the COPY option in the Category List screen. For more information, see Copying Migration, Printing, Backup, Restore Mission Definitions to another Member.

Deleting a Mission or a Mission Definition

Unneeded mission definitions can be deleted using the DELETE option in the Category List screen. For more information, see Options of the Category List Screen. Unneeded missions can be deleted using the DELETE option in the Mission List screen. For more information, see Deleting Missions.

Ordering Multiple Missions

More than one mission at a time can be ordered at one time. To select multiple missions, Tab down to each mission in the Missions List screen that you want to select and enter the letter "O" next to the desired mission. Press Enter. A popup confirmation window is displayed, prompting you to choose whether or not to view the confirmation window for each mission.

If you choose not to view the confirmation screen before viewing each mission (Confirm Y, Ask For Each One N), press Enter.

Saving Modifications

All changes made to a mission and its mission definitions are kept in memory until the mission is exited. Upon exiting the mission, the user can choose to save or cancel the changes. For more information, see Exiting the Mission Definition Screen.

Entry Panel

Figure 36 Printing, Backup, Restore Mission Definition Facility Entry Panel

 --------------- CONTROL-D/V MISSION DEFINITION - ENTRY PANEL --------------(M)
 COMMAND ===>
 
 
 
  SPECIFY LIBRARY, MISSION NAME, CATEGORY
 
    LIBRARY   ===> CTV.PROD.MIGMIS
    MISSION   ===>                      TYPE ==>      (PRT, BKP, RST, MIG)
    CATEGORY  ===>
 
 
 
 
 
 
 
 
 
 
 
 
 
 FOR A NEW MISSION, SPECIFY THE MISSION TYPE                           13.00.49

To open the desired display fill in Entry Panel fields LIBRARY, MISSION, and CATEGORY, as described below.

Displaying the list of missions in a library

1. Type the library name.

2. Leave the mission name blank or type the mission name using mask characters (* and ?).

3. Press Enter.

Displaying the list of mission definitions of a specific mission

1. Type the library name.

2. Type the mission name.

3. Press Enter.

If the mission does not exist, the screen for defining a new mission in the mission is displayed.

Displaying the details of a specific mission definition (Mission Definition screen)

1. Type the library name.

2. Type the mission name.

3. Type the mission definition (category) name.

4. Press Enter.

If the mission does not exist, or the mission definition for the specified mission does not exist, the screen for defining a new mission in the mission is displayed.

Displaying the Search Window

1. Type the library name.

2. Type the mission definition (category) name.

3. Leave the mission name blank or type the member name using mask characters (* and ?).

4. Press Enter.

Creating a new mission

1. Type the library name.

2. Specify a new mission name.

3. Press Enter.

The Mission Definition screen, for defining the first mission in the new mission, is displayed.

Search Window

The Search window allows the user to search for the specified mission definition in members of the specified library. Members in which the mission definition have been found are then displayed in the Mission List screen.

Figure 37 Printing, Backup, Restore Mission Definition Facility Search Window

------------- CONTROL-D/V MISSION DEFINITION - ENTRY PANEL -----------------(M)
COMMAND ===>
SPECIFY LIBRARY, MISSION NAME, CATEGORY
   LIBRARY   ===> CTD.PROD.BKPMIS
   MISSION   ===>                     (Blank for mission selection list)
   CATEGORY  ===> CTDSAMPLE           (Blank for category selection list)
                                +-------------------------------------------+
                                |                                           |
                                |    PLEASE SELECT ONE OF THE FOLLOWING:    |
                                |                                           |
                                |    1  - STOP SEARCH IMMEDIATELY           |
                                |    2  - ASK AGAIN AFTER 000010 MEMBERS    |
                                |    3  - UNCONDITIONAL SEARCH              |
                                |                                           |
                                |    NUMBER OF MEMBERS IN LIBRARY: 000015   |
                                |    NUMBER OF SEARCHED MEMBERS:   000000   |
                                |    NUMBER OF SELECTED MEMBERS:   000000   |
                                |                                           |
                                +-------------------------------------------+
 
 
USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT                             12.11.54

To close the Search Window without performing any action, press END (PF03/PF15).

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

• Performs an uninterrupted search of all members (missions) in the specified library.

• The search is stopped immediately when you select option 1.

2 - ASK AGAIN AFTER number MEMBER

• Searches the specified number of members in the specified library, and then pauses. The search number can be modified. Default:10.

• Continue the search by pressing Enter.

• Stop the search by selecting option 1 (Stop Search Immediately).

If any members are found, the Mission List is displayed listing those members.

During the search, the following information is displayed at the bottom of the window:

• Number of members in library. Lists the total number of members in the specified library.

• Number of searched members. Lists the cumulative number of members searched. For example, if you perform three searches with a specified number of 10, the figure displayed is 30.

• Number of selected members. Lists the cumulative number of members selected that contain the mission definition being searched.

If any members are selected during the search, the Mission List is displayed listing those members. If no members are selected, the Search Window is closed and a message is displayed.

Migration, Printing, Backup, Restore Mission Definition – Mission List Screen

This screen displays a list of missions (members) in the specified library. This screen can be entered directly from the entry panel or upon exiting the Category List screen.

By default, only mission names are listed on the screen. However, if the default has been modified at your site, statistical information may be displayed for each mission name (as shown in Figure 38).

Figure 38 Printing, Backup, Restore Mission Definition – Mission List Screen

  MISSION LIST IN   CTD.PROD.MIGMIS                                ---------(M)
  COMMAND ===>                                                 SCROLL ===> CRSR
  OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
       MIG0009D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       MIG0027D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       MIG0196D          01.01 00/06/30 00/06/30 09:54    15    15     0 PROD
       MIG0200D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       MIG0206D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       MIG0222D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       MIG0257D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       MIG0271D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       MIG0280D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       MIG0297D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       MIG0332D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       MIG0356D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
   ====== >>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<< =======
 
 
 
 
 
 
 
 OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE          15.24.57

To scroll down the Mission list, press PF08/PF20. To scroll up the Mission list, press PF07/PF19. To return to the entry panel, press END (PF03/PF15).

Options of the Mission List Screen

To request one of the following options, specify the option in the OPT field to the left of the mission names and press Enter.

Table 40 Options of the Mission List Screen

Deleting Missions

To delete missions, specify option D in the OPT field to the left of the missions to be deleted and press Enter.

The following confirmation window is displayed, in sequence, for each mission selected for deletion.

Figure 39 Migration, Printing, Backup, Restore Mission Definition Facility Delete Confirmation Window

  MISSION LIST IN   CTD.PROD.BKPMIS                                ---------(M)
  COMMAND ===>                                                 SCROLL ===> CRSR
  OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
       BKP0009D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       BKP0027D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       BKP0196D               +--------------------------+
       BKP0200D               |   CONFIRM DELETE OPTION  |
   D   BKP0206D   <-----------|               (Y/N)      | 5    15     0 PROD
       BKP0222D               +--------------------------+ 7     7     0 PROD
   D   BKP0257D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       BKP0271D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       BKP0280D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
   D   BKP0297D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
       BKP0332D          01.01 00/11/29 00/11/29 12:40    15    15     0 PROD
       BKP0356D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
   ====== >>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<< =======
 
 
 
 
 
  OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE         15.24.57

Enter Y (Yes) in the window to confirm the delete request.

Enter N (No) in the window to cancel the delete request.

Migration, Printing, Backup, Restore Mission Definition – Category List Screen

This screen displays the list of mission definitions in a mission in a specified library. This screen can be entered directly from the Migration, Printing, Backup, Restore Mission Definition entry panel or the Mission List screen, or upon exiting the Mission Definition screen.

Figure 40 Migration, Printing, Backup, Restore Mission Definition – Category List Screen

 CATEGORIES OF LIB CTD.PROD.PRTMIS                             PRT MIS STD
 COMMAND ===>                                                  SCROLL ===> CRSR
 OPT  NAME --------------------------------------------------------------------
      NORTH-COURIER          BUNDLE FOR COURIER TO NORTH BRANCHES
      SOUTH-COURIER          BUNDLE FOR COURIER TO SOUTH BRANCHES
      CENTRAL-COURIER        BUNDLE FOR COURIER TO CENTRAL BRANCHES
  ====== >>>>>>>>>>>>>> NO MORE CATEGORIES IN THE MISSION <<<<<<<<<<<<<<< =====
 
 
 
 
 
 
 
 
 
 OPTIONS:  S SELECT   D DELETE   I INSERT   O ORDER   F FORCE  C COPY  10.16.49

Use the scrolling conventions to scroll forward and backward through the Category list.

Format of the Category List Screen

Next to each mission definition name in the Category list, certain information can be displayed. The type and format of this information depends on whether the screen is displayed in DESC format or in STAT format:

• In DESC format, the mission definition’s description, taken from the DESC field of the mission definition, is displayed. Default.

• In STAT format, the mission definition’s ISPF statistical information is displayed.

By default, the Category list is displayed in DESC format. To change formats, use the DESC or STAT commands, described below.

Commands of the Category List Screen

The following commands can be specified in the COMMAND field of the Category List screen.

Table 41 Commands of the Category List Screen

Options of the Category List Screen

To request one of the following options, specify the option in the OPT field to the left of the mission definition name and press Enter.

Table 42 Options of the Category List Screen

Migration, Printing, Backup, Restore Mission Definition Screen

This screen is used to define, display, and modify mission parameters of a specific mission definition. The screen can be entered directly from the Migration, Printing, Backup, Restore Mission Definition entry panel, or from the Category List screen. Update of parameters is not permitted in Browse mode.

Mission parameters can take up more than one screen. Use the scrolling conventions to scroll the mission parameters forward and backward.

For a detailed explanation of migration, printing, backup and restore mission parameters, see Migration, Printing, Backup and Restore Mission Parameters.

To delete a parameter on the screen, simply erase it (press the EOF key or blank it out). If additional operations are required, Control-V issues appropriate instructions.

Migration, printing, backup and restore mission parameters are divided into six basic groups, as indicated on the following screen:

1. General parameters

2. Bundling parameters (printing missions only)

3. Basic Scheduling parameters

4. Runtime Scheduling parameters

5. Post-processing parameters

6. Mission specific parameters (printing, migration and backup missions only)

The groups are separated by a delimiter line.

Display or Non-Display of Scheduling Criteria

All of the General, Basic Scheduling, Runtime Scheduling and Post-processing parameters are displayed in the Mission Definition screens.

SCHED Command

Typing SCHED (abbreviated SC) in the command line alternately hides or displays the scheduling parameters in the Mission Definition screen.

Migration Mission Definition Screen

Figure 41 Migration Mission Definition Screen

  ---- CONTROL-V CATEGORY MIGSEC             MIG MISSION MIGSEC   --------(M.S)
  COMMAND ===>                                                  SCROLL===> CRSR
  +---------------------------------------------------------------------------+
  ======= >>>>>>>>>>>>>>>>>>> TOP OF CATEGORY PARAMETERS <<<<<<<<<<<<<<<< =====
    CATEGORY MIGCAT                            MISSION MIGSEC
    OWNER    M15A          TASKTYPE MIG        GROUP
    DESC
    ===========================================================================
                          STAGE 01 SCHEDULING PARAMETERS
    DAYS                                                          DCAL
                                                                       AND/OR
    WDAYS                                                         WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
   ===========================================================================
    IN        IN-CARD              ODAT        IN-CARD2             ODAT
    IN
    TIME FROM 0010 TO 1200 NOT LATER THAN 1258 PRIORITY 09
    ===========================================================================
    OUT       OUT-CARD             ODAT +
    SHOUT WHEN NOTOK                                TO OPER2             URGN R
     MSG MIGRATION MISSION MIGSEC STAGE 01 ENDED NOTOK
    ===========================================================================
    RETENTION DAYS 00370          FORCE N        SECONDARY SKELETON  MICSEC
    CENTERA RETENTION CLASS
    ===========================================================================
    STAGE 01 PRIMARY   MEDIA NAME CART     AGE 0001 REFRESH EVERY
             SECONDARY MEDIA NAME                   REFRESH EVERY
    ===========================================================================
                        MIGRATION PATH SCHEDULING PARAMETERS
    DAYS                                                          DCAL
                                                                       AND/OR
    WDAYS                                                         WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
    ===========================================================================
    IN        MSM-IN               ODAT
    TIME FROM 1030 TO 1322 NOT LATER THAN 1458 PRIORITY 09
    ===========================================================================
    OUT       MSMOUT               ODAT +
    SHOUT WHEN NOTOK                                TO OPER2             URGN R
     MSG MIGRATION MISSION MIGSEC STAGE 02 ENDED NOTOK
    ===========================================================================
    STAGE 02 PRIMARY   MEDIA NAME FTK1     AGE 0003 REFRESH EVERY
             FSET            VSET
             SECONDARY MEDIA NAME                   REFRESH EVERY
    STAGE 03 PRIMARY   MEDIA NAME          AGE      REFRESH EVERY
             SECONDARY MEDIA NAME                   REFRESH EVERY
    ===========================================================================
  ====== >>>>>> END OF MIGRATE MISSION PARAMETERS OF THIS CATEGORY <<<<<< =====
  
  PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION  12.12.05

Printing Mission Definition Screen

Figure 42 Printing Mission Definition Screen

  ---- CONTROL-V CATEGORY NORTH-COURIER        PRT MISSION STD    --------(M.S)
  COMMAND ===>                                                  SCROLL===> CRSR
  +---------------------------------------------------------------------------+
    CATEGORY NORTH-COURIER                     MISSION STD        MONITOR
    OWNER    M22        TASKTYPE PRT           GROUP   DAILY-PRT
    BATCH               SKELETON               FREE    CLOSE      TIMEOUT
    OVERRIDE CLASS      DEST                   EXTWTR             FORM
    WRITER OPTION TEST
    DESC     BUNDLE FOR COURIER TO NORTH BRANCHES
    ===========================================================================
    INCLUDE USER NORTH
    EXCLUDE USER
    INCLUDE ODATE
    EXCLUDE ODATE
    SORT PARAMETERS: 1-USER  2-JOB   3-REPORT NAME 4-CATEGORY  5-LEVEL 6-TREE
                     7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
    ENTER SORT SEQ : 6,3,8
    ===========================================================================
    DAYS    ALL                                                   DCAL
                                                                       AND/OR
    WDAYS                                                         WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
    ===========================================================================
    IN
    TIME FROM 0230 TO      NOT LATER THAN 0300 PRIORITY 10
    ON PAGE#               ON LINE#            INTERVAL
    ===========================================================================
    OUT
    SHOUT WHEN NOTOK                                TO OPER3             URGN R
     MSG PRINTING MISSION STD ENDED NOTOK
    PRINTER  PRT1                 DEST                   CHUNKSIZE
    PRINTER                       DEST                   CHUNKSIZE
    ON FORM
     REQUEST
    ===========================================================================
   STORE          BACKUP                MIGRATION
  ====== >>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====
  PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION  09.08.12

Backup Mission Definition Screen

Figure 43 Backup Mission Definition Screen

---- CONTROL-V CATEGORY DAILY                BKP MISSION BKP0031D --------(M.S)
COMMAND ===>                                                   SCROLL===> CRSR
 +----------------------------------------------------------------------------+
   CATEGORY DAILY                             MISSION BKP0031D              
   OWNER    M22           TASKTYPE BKP        GROUP   DAILY-BKP             
   DESC     BACKUP REPORTS FOR 31 DAYS                                      
   DESC                                                                     
   ===========================================================================
   DAYS    ALL                                                   DCAL
                                                                      AND/OR
   WDAYS                                                         WCAL
   MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
   DATES
   CONFCAL          SHIFT   RETRO N MAXWAIT 00
   MINIMUM          PDS
   ===========================================================================
   IN        OP-START-BACKUP-031D ODAT                                     
   TIME FROM      TO      NOT LATER THAN      PRIORITY                      
   ===========================================================================
   # OF DAYS TO KEEP 00031                    # OF GENERATIONS TO KEEP 0000  
   ===========================================================================
   OUT                                                                       
   SHOUT WHEN NOTOK                                TO OPER2             URGN R
    MSG BACKUP MISSION BKP0031D ENDED NOTOK                                  
   SHOUT WHEN                                      TO                   URGN 
    MSG                                                                      
 ====== >>>>>>> END OF BACKUP MISSION PARAMETERS OF THIS CATEGORY <<<<<< ======
 PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION   10.21.10

Restore Mission Definition Screen

Figure 44 Restore Mission Definition Screen

---- CONTROL-V CATEGORY DAILY                RST MISSION RSTADHOC --------(M.S)
COMMAND ===>                                                   SCROLL===> CRSR
 +----------------------------------------------------------------------------+
   CATEGORY DAILY                             MISSION RSTADHOC               
   OWNER    M22           TASKTYPE RST        GROUP   DAILY-RST              
   DESC     AD-HOC RESTORE MISSION                                           
   DESC                                                                      
   ===========================================================================
   DAYS    ALL                                                   DCAL
                                                                      AND/OR
   WDAYS                                                         WCAL
   MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
   DATES
   CONFCAL          SHIFT   RETRO N MAXWAIT 00
   MINIMUM          PDS
   ===========================================================================
   IN        OP-START-RESTORE-ADH ODAT                                       
   TIME FROM      TO      NOT LATER THAN      PRIORITY    INTERVAL           
   ===========================================================================
   OUT                                                                       
   SHOUT WHEN NOTOK                                TO OPER2             URGN R
    MSG RESTORE MISSION RSTADHOC ENDED NOTOK                                 
   SHOUT WHEN                                      TO                   URGN 
 PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION   10.22.31

General Parameters

General parameters describe the mission and specify the mission type, owner, and group.

Figure 45 General Parameters

 ---- CONTROL-V CATEGORY NORTH-COURIER         PRT MISSION STD     -------(M.S)
 COMMAND ===>                                                   SCROLL===> CRSR
 +----------------------------------------------------------------------------+
   CATEGORY DAILY                                MISSION STD      MONITOR
   OWNER M22              TASKTYPE PRT           GROUP   DAILY-PRT
   BATCH                  SKELETON               FREE    CLOSE    TIMEOUT
   OVERRIDE CLASS         DEST                   EXTWTR           FORM
   DESC     BUNDLE FOR COURIER TO NORTH BRANCHES
   DESC
 ==============================================================================

Table 43 General Parameters

Bundling Parameters (Printing Missions Only)

Bundling parameters determine who receives the bundle, the original scheduling date, and the sequence of reports in the bundle.

Figure 46 Bundling Parameters

 ===========================================================================
 INCLUDE USER NORTH
 INCLUDE USER
 EXCLUDE USER BR129
 EXCLUDE USER
 INCLUDE ODATE 010321
 INCLUDE ODATE
 EXCLUDE ODATE
 SORT PARAMETERS: 1-USER  2-JOB   3-REPORT NAME 4-CATEGORY  5-LEVEL 6-TREE
                  7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
 ENTER SORT SEQ : 6,3,8
 ===========================================================================

Table 44 Bundling Parameters

Basic Scheduling Parameters

Basic Scheduling parameters specify the day and time to execute the mission.

Figure 47 Basic Scheduling Parameters

 DAYS                                                          DCAL
                                                               AND/OR
 WDAYS   ALL                                                   WCAL
 MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
 DATES
 CONFCAL          SHIFT   RETRO N MAXWAIT 00
 MINIMUM          PDS
 ===========================================================================

Table 45 Basic Scheduling Parameter

Basic Scheduling parameters are defined separately for stage 01 migration and for subsequent migration stages. For more information, see Basic Scheduling Parameters..

Runtime Scheduling Parameters

Runtime Scheduling parameters specify requirements that must be satisfied to execute the mission.

Figure 48 Runtime Scheduling Parameters

   MINIMUM                PDS                                                  
   ===========================================================================
   IN        PROD-REPORTS-READY   ODAT
   TIME FROM 0230 TO      NOT LATER THAN 0300 PRIORITY 10                     
   ON PAGE#               ON LINE#            INTERVAL                        
   ===========================================================================
   OUT                                                                        

Table 46 Runtime Scheduling Parameters

Post-Processing Parameters

Post-processing parameters specify what to do when the mission finishes processing (OK or NOTOK).

Figure 49 Post-Processing Parameters

ON PAGE#               ON LINE#            INTERVAL                         
=========================================================================== 
OUT       NORTH-BUNDLE-PRINTED ODAT +                                       
SHOUT WHEN NOTOK                                TO OPER2             URGN R 
 MSG PRINTING MISSION STD - NORTH COURIER - ENDED NOTOK                     
SHOUT WHEN                                      TO                   URGN   
 MSG                                                                        

Table 47 Post-Processing Parameters

Mission Specific Parameters

Mission specific parameters are listed below by type of mission and function. These parameters are only displayed in the mission definition screen for the appropriate type of mission.

Printing Missions

These parameters specify values that affect the execution of printing missions.

Figure 50 Printing Mission Parameters

MSG PRINTER  PRT1                 DEST NODE9 U1234       CHUNKSIZE
 ON FORM
REQUEST
=========================================================================== 
 STORE        BACKUP               MIGRATE                                   

Table 48 Printing Mission Parameters

Batch Printing Parameters

These parameters enable a printing mission to be run as a batch job.

Figure 51 Batch Printing Parameters

  CATEGORY                                      MISSION            MONITOR
  OWNER               TASKTYPE               GROUP
  BATCH               SKELETON               FREE                  TIMEOUT
  OVERRIDE CLASS      DEST                   EXTWTR                FORM
  WRITER OPTION
  DESC

Table 49 Batch Printing Parameters

Override Values for Printing Missions

The values specified in these parameters supersede the corresponding values obtained during the decollation process for all reports printed by this mission.

Table 50 Override Values for Printing Missions

Migration Missions

These parameters specify values that affect the execution of migration missions.

Figure 52 Migration Missions in the Migration, Printing, Backup, Restore Mission Definition Screen

    ===========================================================================
                          STAGE 01 SCHEDULING PARAMETERS
    DAYS                                                          DCAL
                                                                       AND/OR
    WDAYS                                                         WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
    ...
    ===========================================================================
    RETENTION DAYS 00355          FORCE          SECONDARY SKELETON  MICLIM
    CENTERA RETENTION CLASS
    ===========================================================================
    STAGE 01 PRIMARY   MEDIA NAME OSS      AGE 0030 REFRESH EVERY 0183
             PREFIX
             SECONDARY MEDIA NAME CART              REFRESH EVERY 1460
    ===========================================================================
                        MIGRATION PATH SCHEDULING PARAMETERS
    DAYS                                                          DCAL
                                                                       AND/OR
    WDAYS   0,6                                                   WCAL
    MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCAL          SHIFT   RETRO N MAXWAIT 00
    MINIMUM          PDS
    ===========================================================================
    ...
    STAGE 02 PRIMARY   MEDIA NAME FTK2     AGE 0365 REFRESH EVERY 1460
             FSET            VSET
             SECONDARY MEDIA NAME                   REFRESH EVERY
    ===========================================================================

Table 51 Migration Mission Parameters

Backup Missions

These parameters specify values that affect the execution of backup missions.

Figure 53 Backup Mission Parameters

 TIME FROM      TO      NOT LATER THAN      PRIORITY                         
=========================================================================== 
# OF DAYS TO KEEP 00031                     # OF GENERATIONS TO KEEP  
=========================================================================== 
OUT                                                                         

Table 52 Backup Mission Parameters

Editing Mission Definitions in the Edit Environment

Mission definition parameters can be edited (moved, copied, deleted, repeated) from within the Control-V Edit environment by performing IOA line editing commands, similar to standard ISPF line commands.

The EDIT command alternately activates and deactivates the Edit environment of the Mission Definition screen.

Figure 54 Entering Edit Commands

---- CONTROL-V CATEGORY DAILY                PRT MISSION DELPRT   --------(M.S)
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
__ CATEGORY DAILY                             MISSION STDPRT     MONITOR
__ OWNER    M51        TASKTYPE PRT           GROUP
__ BATCH    N          SKELETON               FREE    CLOSE      TIMEOUT 10
__ OVERRIDE CLASS      DEST                   EXTWTR             FORM
__ DESC     PRINTING MISSION FOR ALL STANDARD FORM REPORTS
__ DESC
__ ===========================================================================
MM INCLUDE USER N44
__ INCLUDE USER N45
MM INCLUDE USER N46
A_ INCLUDE USER N43
__ EXCLUDE USER
__ INCLUDE ODATE
__ EXCLUDE ODATE
__ SORT PARAMETERS: 1-USER  2-JOB   3-REPORT NAME 4-CATEGORY  5-LEVEL 6-TREE
__                  7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
__ ENTER SORT SEQ : 1
__ ===========================================================================
__ DAYS    ALL                                                   DCAL
__                                                                    AND/OR
__ WDAYS                                                         WCAL
__ MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION    13.47.47

A 2-character line editing command field, marked by underscores, is displayed for each line on the screen.

Editing commands are typed directly onto these underscores.

Specified line editing commands are processed when Enter is pressed.

For more information about and examples of editing mission definition parameters in the Edit environment, see Editing Mission Definitions in the IOA Edit Environment.

Exiting the Mission Definition Screen

Use one of the following commands to exit the Mission Definition screen:

Table 53 Exiting the Mission Definition Screen Commands

Automatic Syntax Checking

The definition syntax is automatically checked when the Mission Definition screen is exited using the END, NEXTCTG or PREVCTG command. If errors are found in the Mission Definition screen, an error message is displayed. The errors may then be corrected. If no errors are found, exit to the Category List screen.

Saving Mission Definitions

Press END (PF03/PF15) to exit the Category List screen. If changes have been made in the Mission Definition facility, an Exit Option window is opened.

Figure 55 Saving Mission Definition Screen

CATEGORIES OF LIB CTV.PROD.RSTMIS                              RST MIS RSTADHOC
COMMAN +-----------------------------------------------------------+  ===> CRSR
OPT  N |                 PLEASE SELECT EXIT OPTION                 |  ---------
     D |                                                           |
 ===== |     SAVE    CREATE                                        |  <<< =====
       |                                                           |
       |     LIBRARY CTD.PROD.RSTMIS                               |
       |     MISSION RSTADHOC                                      |
       |                                                           |
       +-----------------------------------------------------------+
 
 
 
 
 
 
 
 
 
 
 
 
 
OPTIONS:  S SELECT   D DELETE   I INSERT   O ORDER   F FORCE           11.03.53

Enter Y (Yes) or N (No) in one of the exit options. It is possible to change the name of the library or mission in the window. You are returned to the Mission List screen or to the entry panel, depending on where you where when the Category List screen was entered.

When saving changes using the EXIT option, all of the mission definitions within a mission are saved, even if changes were made to only one mission definition.

Canceling Changes

To exit without saving mission definition parameter changes, enter the CANCEL command in the Mission Definition screen, or press RESET (PF04/PF16) in the Exit Option window of the Category List Screen.

Ordering Missions

The Mission Definition screens are used to define migration, printing, backup and restore mission criteria. A definition becomes "active" only after it is ordered. The report decollating mission can be ordered manually, or it can be ordered automatically each day. For further information see the Control-D and Control-V chapter of the INCONTROL for z/OS Administrator Guide. One way to manually order one or more missions is by using options O and F of the Mission List or Category List screens.

The options can be activated from:

• Mission List Screen: All mission definitions in the selected mission are ordered.

• Category List Screen: Only the selected mission definition is ordered.

These options are specified as follows:

Table 54 Options for Ordering Missions

When you use the O or F option, a default confirmation window is opened. (If the default has been modified in the User profile, a different confirmation window, requiring double confirmation, is opened.)

Figure 56 Order and Force Confirmation Window

MISSION LIST IN   CTV.PROD.BKPMIS                             --------------(M)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
     BKP0009D          01.01 00/06/29 00/06/29 12:40    15    15     0 PROD
     BKP0027D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
     BKP0196D               +-------------------------------+  5     0 PROD
     BKP0200D               |   CONFIRM     ODATE 080800    |
 O   BKP0206D   <-----------|   ASK FOR EACH ONE  Y         |
     BKP0222D               +-------------------------------+  7     0 PROD
     BKP0257D          01.01 00/06/29 00/06/29 12:40    15    15     0 PROD
 O   BKP0271D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
     BKP0280D          01.01 00/06/29 00/06/29 12:40    15    15     0 PROD
 O   BKP0297D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
     BKP0332D          01.01 00/06/29 00/06/29 12:40    15    15     0 PROD
     BKP0356D          01.00 00/06/30 00/06/30 09:54     7     7     0 PROD
 ===== >>>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<<<< ======
 
 
 
 
 
 
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           14.39.49

The specified date can be changed. If you decide not to order the mission or mission definition, enter N in the CONFIRM field (for CANCEL).

The ASK FOR EACH ONE line is only displayed if more than one Order (or Force) is requested. If you are certain that you want to order or force all indicated missions or mission definitions, and do not want to change the ODATE for any of the individual missions or mission definitions, you can bypass individual confirmations by entering Y in the CONFIRM field and N in the ASK FOR EACH ONE field, and pressing Enter. All the missions or mission definitions marked O (or F) are ordered.

For each mission or mission definition that is successfully scheduled (ordered), the following messages are displayed:

Figure 57 Control-D Mission Order Message Window

------------------------ CONTROL-D MISSION ORDER MESSAGES ----------------(M.O)
COMMAND ===>                                                    SCROLL===> CRSR
17.24.36 CTD049I MISSION PROCESSING STARTED
17.24.39 CTD528I MISSION BKP0007D ODATE 080800 PLACED ON ACTIVE MISSIONS FILE -
17.24.39 CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
====== >>>>>>>>>>>>>>>>       END OF MESSAGE LIST      <<<<<<<<<<<<<<<<< =====
 
PRESS END TO RETURN, LEFT AND RIGHT TO SEE MORE.

Use the END command (PF03/PF15) to return to the Mission or Category List screen.

Copying Migration, Printing, Backup, Restore Mission Definitions to another Member

To copy one or more mission definitions from the current member to another member (mission), specify option C (Copy) by the mission names in the Category List screen and press Enter. The window in Figure 58 is displayed.

Figure 58 Window for Copying Mission Definitions to another Mission

CATEGORIES OF LIB: CTV.PROD.RSTMIS                              PRT MIS STD
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
 C   PRINTJOB1         01.01 00/06/29 00/06/29 12:40    15    15     0 PROD
                                                                             
                                                                             
                                                                             
                                                                             
               +-----------------------------------------------------------+
               |                                                           |
               |     SPECIFY DESTINATION LIBRARY,MEMBER AND CATEGORY NAME  |
               |                                                           |
               |  LIBRARY :  CTV.PROD.RSTMIS                               |
               |  MEMBER  :                                                |
               |  CATEGORY:  PRINTJOB                                      |
               |                                                           |
               |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |
               +-----------------------------------------------------------+
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           14.39.49

The window contains the following fields (some fields contain default values that can be modified):

Table 55 Fields in the Window for Copying Mission Definitions to another Mission

To perform a copy request, press Enter.

To cancel a request, press END (PF03/PF15) or RESET (PF04/PF16).

Recipient Tree and Approval Tree Definition

The Control-D/V Recipient/Approval Tree Definition facility provides a series of screens that enable you to create, view, and modify a user Recipient Tree and an Approval Tree.

These trees can contain up to 15 levels of recipients or approvals. Each level is identified by a user defined 2-character code and a full name. Levels are installation defined. For more information, see Defining the Recipient Tree and the INCONTROL for z/OS Installation Guide: Installing.

• The Recipient Tree is stored as a member in a library (partitioned dataset). It can contain an unlimited number of report recipients.
  For information about loading the RecipientTree, see the Control-D and Control-V chapter of the INCONTROL for z/OS Administrator Guide.

• The Approval Tree is comprised of Approval names. Each Approval name represents one or more users that can approve reports from Control-D/WebAccess Server.

  Defined Approval names are relevant when assigning a report for approval using one of the following methods:

  • Inclusion of the DO APPROV parameter during the decollation process (see DO APPROV: Decollating Parameter (Decollating Mission)).

  • Adding reports for approval in Control-D/WebAccess Server (see the Control-D/WebAccess Server User Guide).

  • Configuring Approval fields in a Permanent User File (see Table 73: Additional Info Fields in the Default (D) Display Type, in User Report List Display Types).

Entry Panel

To enter the Recipient/Approval Tree facility, select option T on the IOA Primary Option menu. The IOA Recipient/Approval Tree entry panel is displayed.

Figure 59 Recipient/Approval Tree Facility Entry Panel

  ---------------- IOA RECIPIENT/APPROVAL TREE - ENTRY PANEL -----------------(T)
   COMMAND ===>
   SPECIFY LIBRARY NAME AND MEMBER (TREE) NAME
      LIBRARY ===> CTD.PROD.PARM
      MEMBER  ===> CTDTREE                      BROWSE   (Y/N)
           LEVEL 10       OPERATIONS            ===>
                 15       PRESIDENT             ===>
                 20       REGNL-MGMT            ===>
                 25       BRANCH                ===>
                 30       BRANCH-DEPT           ===>
                 50       DIVISION              ===>
                 55       DEPARTMENT            ===>
                 60       SECTION               ===>
                 80       WORKERS               ===>
                 90       CD-Control            ===>
                 95       OP-USER               ===>
 
 
 
 FOR DIRECT ACCESS, FILL IN RECIPIENT NAME IN APPROPRIATE LEVEL       17.29.25

In this example entry panel, the CTDTREE member is specified. The CTDTREE member is a sample Recipient Tree that is provided during product installation. A sample Approval Tree is also provided, in a member named CTDAPRV.

Displaying a Recipient Tree or Approval Tree

Specify the desired Recipient Tree or Approval Tree by typing the library name and member (tree) name. The content of the member that you specify determines the display in the next screen, whether a Recipient Tree or an Approval Tree.

The following sample members are provided:

• CTDTREE: sample Recipient Tree member.

• CTDAPRV: sample Approval Tree member, which contains a root-level element named CDAPPROV.

Select the desired display mode (Edit or Browse) by entering Y or N in the BROWSE field:

• Y (Yes): The tree is displayed in Browse mode. Updates are not permitted but the CHKTREE command (described later) is permitted.

• N (No): The tree is displayed in Edit mode. Updates are permitted. Default.

If a specific recipient or Approval is desired, type its name (or prefix) next to the appropriate level.

Press Enter.

Recipient/Approval Tree List Screen

Depending on the type of member that you specified in the entry panel, this screen displays a tree with a list of either recipients or Approval names.

For ease of identification, each successive level of the tree is indented from the previous level.

The Recipient/Approval Tree may require more than one screen. Use the scrolling PFKeys to scroll the tree forward and backward.

The following figures show two separate examples of a Recipient Tree List Screen and an Approval Tree List screen. Note that the root-level element in an Approval Tree is always named CDAPPROV.

If the tree is displayed in Browse mode, a message indicating this is displayed at the top of the screen.

Figure 60 Recipient Tree List Screen

--------------------- CONTROL-D RECIPIENT/APPROVAL TREE --------------------(T)
COMMAND ===>                                                    SCROLL===> CRSR
LEVELS  ===> 10 Y 15 Y 20 Y 25 Y 30 Y 50 Y 55 Y 60 Y 80 Y 90 Y
     10 CDTREE    CONTROL-D RECIPIENT TREE SAMPLE
     20 MGT      MANAGEMENT DEPARTMENT
     55 MKT      MARKETING DEPARTMENT
     55 DEV      DEVELOPMENT DEPARTMENT
     55 PROD     PRODUCTION DEPARTMENT
     55 WAREHSE  WAREHOUSE
     25 BR129    THE NORTH COUNTY BRANCH
     30 BR129LO  THE LOANS DEPARTMENT
     30 BR129FC  THE FOREIGN CURRENCY DEPARTMENT
     30 BR129SA  THE SAVINGS DEPARTMENT
     55 BMIAMI   THE CONTROL-D USER
     90 PRODCNTL PRODUCTION Control USER
     90 UNIDENT  UNIDENTIFIED REPORTS
     90 NULL     IDENTIFIED REPORTS NOT NEEDED
====== >>>>>>>>>>>>>>>>>>>>>>>> END OF TREE >>>>><<<<<<<<<<<<<<<<<<<<<< ======

OPTIONS:  D DELETE   I INSERT   S SELECT   P SEE/HIDE PARENT         17.29.39

The following example Approval Tree contains single-level Approvals. For examples of Approval Trees that contain multi-level Approvals, see Multi-level Approvals in Approval Trees.

Figure 61 Approval Tree List Screen

--------------------- CONTROL-D RECIPIENT/APPROVAL TREE --------------------(T)
COMMAND ===>                                                    SCROLL ===>CRSR
LEVELS  ===> 10 Y 15 Y 20 Y 25 Y 30 Y 40 Y 50 Y 55 Y 60 Y 80 Y
    10 CDAPPROV CTD APPROVAL TREE
    15 APP1     APPROVAL PROCESS1
    15 APP21    APPROVAL PROCESS
    15 APP22    APPROVAL PROCESS
    15 DOC      APPROVAL PROCESS1
    15 APP23    APPROVAL PROCESS
    15 APRV2    APPROVAL PROCESS
    15 APRV1    APPROVAL PROCESS
    15 APPOVAL3 APPROVAL PROCESS
    15 MANUAL   APPROVAL PROCESS
    15 REGULAR  APPROVAL PROCESS
    
=====>>>>>>>>>>>>>>>>>>>>> END OF TREE >>>>>>>><<<<<<<<<<<<<<<<<<<<<<= = = = = =
OPTIONS: D DELETE   I INSERT        S SELECT       P SEE/HIDE PARENT     10.45.19

Recipient Tree Parameters

The following parameters are displayed for each recipient. This information can be updated here or in the Recipient Definition screen, which is described in Recipient Definition Screen.

LEVELS  ===> 10 Y 15 Y 20 Y 25 Y 30 Y 50 Y 55 Y 60 Y 80 Y 90 Y
    10 CDTREE    CONTROL-D RECIPIENT TREE SAMPLE
                55 MKT      MARKETING DEPARTMENT
                        PARENT: MGT       LEVEL: 20

Table 56 Parameters of the Recipient Tree

Approval Tree Parameters

The following parameters are displayed for each Approval. This information can be updated here or in the Approval Definition screen, which is described in Approval Definition Screen.

LEVELS  ===> 10 Y 15 Y 20 Y 25 Y 30 Y 40 Y 50 Y 55 Y 60 Y 80 Y
    10 CDAPPROV CTD APPROVAL TREE
                15 APP1     APPROVAL PROCESS1
                        PARENT: CDAPPROV      LEVEL: 10

Table 57 Parameters of the Approval Tree

Multi-level Approvals in Approval Trees

You can implement two modes of Multi Approval, that is,approval by multiple groups of users — Multi-level Approval and Parallel Approval.

For Multi-level Approval, the administrator defines each successive Approval name as a child of the previous one. Each individual Approval name represents a separate group of authorized users.

Approval is performed sequentially -- each approver approves the report only after all preceding (parent) approvers have completed the Approval process.

Figure 62 Example of Multi-level Approval Definition

15 MSTAPP        MULTISTAGE APPROVAL STEP 1 (AUTHORIZE …)
PARENT: CDAPPROV  LEVEL: 10
20 MSTAPP2  MULTISTAGE APPROVAL STEP 2 (AUTHORIZE …)
PARENT: MSTAPP         LEVEL: 15
25 MSTAPP3  MULTISTAGE APPROVAL STEP 3 (AUTHORIZE …)
PARENT: MSTAPP2        LEVEL: 20

For Parallel Approval, the administrator defines multiple Approval names as children of the main Approval entity. Each of the child Approval names represents a separate group of authorized users. However, the main (parent) Approval entity is not associated with any users.

The report is available for approval at the same time by all child approvers, in parallel.

Figure 63 Example of Parallel Approval Definition

15 PARAPP        PARALLEL APPROVAL HEADER (NO AUTHORIZE)
PARENT: CDAPPROV  LEVEL: 10
20 PAR1          1-ST PARALLEL APPROVAL (AUTHORIZE …)
PARENT: PARAPP         LEVEL: 15
20 PAR2          2-ND PARALLEL APPROVAL (AUTHORIZE …)
PARENT: PARAPP         LEVEL: 15
20 PAR3          3-RD PARALLEL APPROVAL (AUTHORIZE …)
PARENT: PARAPP         LEVEL: 15

For further information, see Assigning approval to multiple groups in the INCONTROL for z/OS Administrator Guide.

Options of the Recipient/Approval Tree List Screen

To request one of the following options, specify the option in the field to the left of the recipient name or Approval name, and press Enter.

Table 58 Options of the Recipient/Approval Tree List Screen

Commands of the Recipient/Approval Tree List Screen

Table 59 Recipient/Approval Tree List Screen Commands

Recipient Definition Screen

The Recipient Definition screen is accessed by specifying option S for the selected recipient in the Recipient Tree List screen. This screen enables you to see and update information about a recipient.

Figure 64 Recipient Definition Screen

----------------------- CONTROL-D RECIPIENT DEFINITION -------------------(T.S)
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
  RECIPIENT  PROD      RECIPIENT LEVEL 55   PARENT MGT        PARENT LEVEL 20
  DESC       PRODUCTION DEPARTMENT                                          
  DESC                                                                       
  ===========================================================================
  SYNONYM    PRODUCTION                                                      
  SYNONYM                                                                    
  AUTHORIZE            $SYSDATA                                              
  ADDRESS                                                                    
  ===========================================================================
  INDEX    Y           USER BANNER Y                    REPORT BANNER Y      
  DEF DEST                                                                   
  ===========================================================================
                         P C   P A R A M E T E R S                          
   AUTHORIZED Y
   PC PATH                                                                  
   PC RETAIN 006       (days)       MF RETAIN 006       (days)              
   MAX SIZE  00056000  (lines)      TRANSMIT FROM 0300 TO 0600  (hhmm)       
======= >>>>>>>>>>>> END OF RECIPIENT DEFINITION PARAMETERS <<<<<<<<<<<< ======
FILL IN RECIPIENT DEFINITION.                                          17.45.40

Exit the Recipient Definition screen by pressing the END key (PF03/PF15).

This screen displays the following parameters for the selected recipient:

Table 60 Recipient Definition Screen Required Fields

Table 61 Recipient Definition Screen Optional Fields

Table 61a Recipient Definition Screen PC Download Parameters

Approval Definition Screen

The Approval Definition screen is accessed by specifying option S for the selected Approval in the Approval Tree List screen. This screen enables you to see and update information about an Approval.

Figure 65 Approval Definition Screen

--------------------------CONTROL-D APPROVAL DEFINITION-------------------------(T.S)
COMMAND ===>                                                          SCROLL===> CRSR
+-----------------------------------------------------------------------------------+
APPROVAL FINACE    APPROVAL  LEVEL 15     PARENT CTDAPRV               PARENT LEVEL 10
DESC 2 CTD APPROVAL
DESC
=====================================================================================
AUTHORIZE  CTDWEB
AUTHORIZE  M
AUTHORIZE  Q
AUTHORIZE  K
AUTHORIZE
=====================================================================================
=====>>>>>>>>>>>>>>>>>>>>> END OF APPROVAL DEFINITION PARAMETERS <<<<<<<<<<<<<======
  
FILL IN APPROVAL DEFINITION

Exit the Approval Definition screen by pressing the END key (PF03/PF15).

This screen displays the following parameters for the selected Approval:

Table 62 Approval Definition Screen Required Fields

Table 62a Approval Definition Screen Optional Fields

DESC      FINANCE APPROVAL PROCESS
DESC      [email protected]
DESC      [email protected]

Exiting a Recipient/Approval Tree List Screen

Press END (PF03/PF15) to exit the Recipient/Approval Tree. The Exit Option window is opened.

Figure 65a Recipient/Approval Tree List Screen Exit Option Window

 --------------------- CONTROL-D RECIPIENT/APPROVAL TREE --------------------(T)
 COMMAN  +--------------------------------------------------------+ LL===> CRSR
 LEVELS  |           PLEASE SELECT EXIT OPTION                    |
     10  |                                                        |
         |   SAVE    CREATE                                       |
         |                                                        |
         |   CHECK Y                                              |
         |                                                        |
         |   LIBRARY CTD.PROD.PARM                                |
         |   MEMBER  CTDTREE                                      |
         |                                                        |
         +--------------------------------------------------------+
             30 BR129FC  THE FOREIGN CURRENCY DEPARTMENT
             30 BR129SA  THE SAVINGS DEPARTMENT
                 55 BMIAMI   THE CONTROL-D USER
                       90 PRODCNTL PRODUCTION Control USER
                       90 UNIDENT  UNIDENTIFIED REPORTS
                       90 NULL     IDENTIFIED REPORTS NOT NEEDED
 ====== >>>>>>>>>>>>>>>>>>>>>>>> END OF TREE >>>>><<<<<<<<<<<<<<<<<<<<<< ======
 OPTIONS:  D DELETE   I INSERT   S SELECT   P SEE/HIDE PARENT          15.32.55

Enter Y or N in either the SAVE or CREATE field. It is possible to change the name of the library or the name of the tree (member) in the Exit Option window. If you enter N in either field, no changes are made and you return to the entry panel.

The CHECK field indicates whether or not to check the syntax of the Recipient/Approval Tree.

• Y (Yes): Check or sort the tree before it is saved.

• N (No): Save the tree without performing a check or sort.

Default: Y

Syntax Checking

If you respond Y to save or create a new tree and Y to check the syntax, the syntax of the tree is checked.

• If there are no errors in the tree, the tree is automatically sorted by hierarchy and saved (or created). You are returned to the entry panel.

• If errors exist, the Recipient/Approval Tree List screen disappears and appropriate messages are displayed on a Message List screen. If the messages span more than one screen, you can scroll the list forward and backward. Press END (PF03/P15) to return to the Recipient/Approval Tree List screen. Correct the errors and exit from the screen.

RESET Command

If you have entered an Exit Option window but you do not want to exit the Recipient/Approval Tree screen, press RESET (PF04/PF16). You are returned to the Recipient/Approval Tree List screen without saving the tree.

CANCEL Command

To exit the Recipient/Approval Tree List screen without checking the tree syntax and without opening an Exit Option window, type CANCEL on the command line and press Enter. Any modifications to the tree are not saved and you return to the entry panel is displayed.

User Reports (Online Viewing)

To enter the User Reports facility, select option U on the IOA Primary Option menu. The Control-V User Reports entry panel is displayed.

User Reports facility screens enable the Control-V user to:

• Display a list of reports based on index values, report status and other criteria.

• Retrieve pages or sections of a report via index values.

• Display a list of indexes available for a report.

• View report index values and the number of times each value occurs.

• View, edit and print report pages or sections.

• Request immediate printing or reprinting of report pages.

• Change various report printing parameters including destination, form, output print class, and number of copies to print.

• Cancel the scheduled printing of a report.

• Edit (reformat) a report so that it looks different from the original when viewed or printed.

• Delete a report.

• Designate new recipients for a report.

• Add notes or messages to a report.

• Authorize other users to view a report.

Indexes play a central role in retrieving reports for online viewing and immediate printing. Report indexes enable users to determine if desired information is available and to retrieve only the desired information for online viewing or printing.

The process of online report retrieval via index values is discussed on the following pages.

Using Indexes for Report Retrieval

The User Reports facility provides online screens that enable the user to perform the following functions:

• Identify the report from which pages should be retrieved.

  • User Report List: Facilitates using all the available functions provided by the User Reports facility.

  • Quick Access Report List: Facilitates using the Quick Access Method (described below) for report retrieval.

    An index name and index values can be used as report selection criteria.

• Identify the indexes to be used for retrieval.

  • User Reports Entry Panel: Provides a field for a main index name.

  • Index Window: Lists main indexes that have been defined for a report.

  • Subindex Window: Lists subindexes that exist for any specified value in a higher level index.

  • Quick Access Panel: Displays a complete index path.

• Specify a value for the selected indexes.

  • User Reports Entry Entry Panel: Provides fields for a main index and its value.

  • Values of Index Panel: Displays an alphabetized list of available values.

  • Quick Access Panel: Provides a value field for each index in an index path.

• Specify viewing or immediate printing for the selected report pages.

  • User Report List: Provides options for viewing or printing.

  • Values of Index Panel: Provides options for viewing or printing (if accessed via an Index or Subindex window).

  • Quick Access Panels: Provides commands for viewing or printing.

The following diagram shows how these online screens are used to retrieve report pages. A description of the diagram follows.

Report Access using Index Values

Figure 66 Report Access Using Index Values

Each arrow in the diagram points from an option or command to the screen displayed when that option or command is executed. (The dashed line indicates a shortcut that bypasses the Quick Access Report list if only one report had been listed, or that bypasses the Index Window if only one index had been listed.) Available options:

Table 63 Quick Access Panel Options

There are three basic methods of specifying index values for report retrieval:

Table 64 Methods for Specifying Index Values for Report Retrieval

These methods are described below.

Quick Access Method

Retrieval via the Quick Access Method is especially useful when the index hierarchy has many levels and when the user is familiar with the reports and indexes available.

The Quick Access Method utilizes Quick Access panels that can be accessed from the User Reports entry panel, from any Report list, or from the Index window (described in the following section). Quick Access panels allow the user to quickly display the available index paths for a report, select the required index path, and specify index values that are used for report retrieval. Each index path is displayed in a separate Quick Access panel. The user can display each Quick Access panel until the required path is displayed.

Once the required path is displayed in a Quick Access panel, the user specifies the values to be used for retrieval.

If the required values are known, the user can specify them in the Quick Access panel to view or print the selected report pages. When retrieving a report section via a migrated index, provide as many values as possible to improve performance.

If the required values are not known, specifying a prefix or asterisk displays the Values of Index panel with possible values from which to choose. When the user selects a value, the value is automatically inserted in the Quick Access panel. The selected report pages or sections can then be viewed or printed.

Index / Subindex Window Method

Retrieval via the Index / Subindex Window Method is especially useful when the index hierarchy does not have many levels. Index and Subindex windows list the available main indexes and subindexes.

These windows can only be accessed from the User Report list. The user proceeds from level to level in the index hierarchy, examines the available index names and values, and specifies index values until the retrieval criteria are specified.

Through the User Report list, the main indexes for the selected report can be displayed in the Index window.

Once the user has reviewed the main indexes in the Index window and selected the desired main index, the user can proceed in either of two ways:

• Display the Quick Access panels. From this point, retrieval continues as described in "Quick Access Method" above.

• Display the values for the selected main index in the Values of Index panel.

Once a value has been specified in the Values of Index panel, the user can proceed in one of two ways:

• View or initiate immediate printing of the report pages pointed to by the specified index value.

• Display the Subindex window that lists the next level of subindexes available under the specified higher index value.

In the Subindex window, the user selects the next lower index level and enters its Values of Index panel to specify the desired value for the selected subindex. The specified value can be used in one of the two ways outlined above.

Each time the user displays the Subindex window, the index names listed in it and the values displayed by the Values of Index panel are for the next lower level index in an index path.

Hit List Method

A "Hit List" is a list of reports selected according to:

• an index name or mask, and

• (optionally) an index value or prefix that are specified as part of the report selection criteria.

The determination of which reports are listed in the User Report list or Quick Access Report list occurs in stages:

1. In the first stage, reports are filtered by report attributes specified in the User Reports entry panel (such as report name, user ID, report date range) and the Show Options window (such as report status).

2. In the second stage, reports are filtered by main index name or mask. If the selection criteria contain a main index name or mask without an index value or prefix, reports are selected if they contain the specified index.

3. In the third stage, reports are filtered by index value or prefix.

   • If the selection criteria contain an index value or prefix for a nonresident main index, reports are selected if they contain the specified index. Nonresident indexes are not searched for index values.

   • If the selection criteria contain an index value or prefix for a resident main index, reports are selected if they contain pages or sections pointed to by the specified index values.

It is often possible to bypass Index windows and Quick Access panels when accessing reports that qualify as a Hit List based on an index value or prefix. For example:

• If a single index value was retrieved by Hit List filtering, only the report sections indexed by this value are printed or viewed without the need for additional filtering via an Index window or Values of Index panel.

• If only one index satisfies the retrieval criteria, the Index window is bypassed when accessing the index.

• If only one report is retrieved, the Quick Access Report list is bypassed when using the Quick Access method.

After retrieving reports that qualify as a Hit List, the user can:

• Use regular commands and options, such as View and Print, which access only the retrieved sections of the report.

• Use Quick Access panels. From this point, retrieval continues as described in "Quick Access Method" above (see Report Access using Index Values ).

• Display the indexes and values as described in "Index/Subindex Window Method" above (see Report Access using Index Values). Only indexes that match the Hit List index retrieval criteria are accessed.

Retrieval Considerations

The following information can be helpful when deciding how to retrieve indexed reports:

• In general, the Quick Access Method is more efficient in terms of the time and resources required for retrieval. This is especially true if some or all of the required indexes have migrated and are no longer on DASD.

• Each Index and Subindex window provides the maximum information about indexes available at the next level in an index path but these windows provide no information about other index levels. Each Quick Access panel provides the maximum information about one index path but that panel provides no information about other index paths.

• When viewing or printing reports, there are advantages if all the selected reports have the same nonresident main index, or have the same DASD-resident main index and contain exactly the same main index value or prefix. For more information, see Hit List Method.

• If a user’s access to Control-V is limited to Direct Online Viewing (DOLV) and BYPASS PANEL is set to Q in the User Reports entry panel, the first screen displayed is the Quick Access Report list (if the user has several reports), or the Quick Access panels (if the user has only one report).

Job Archiving Retrieval

A Job Archiving facility is available for a special JOBSDSN1 decollation and consolidation process that creates one large index of the archived jobs. Display type J facilitates the retrieval and viewing of production job SYSOUTs. For more information, see User Reports Entry Panel (Display Type J).

Entry Panel

Selecting option U on the IOA Primary Option menu displays the User Reports entry panel unless the panel is bypassed as described below.

The User Reports entry panel is the main user interface to Control-V information about reports. The OPTIONS field of the entry panel allows you to specify the kind of Report list you want to display:

• Permanent: An inventory of reports processed by Control-V.

• Active/Migrated: Recently or soon to be processed reports and/or reports that migrated from DASD to various storage devices.

• History: Reports backed up on tape or cartridge.

Default: Active/Migrated

The other fields enable you to specify the criteria used to select the reports that are displayed. A list of all reports that conform to the specified criteria is displayed on the User Report list or Quick Access Report list.

The default Control-V security mechanism enables each user to see and update only their reports and the reports of their subordinates in the Recipient Tree.

There are three display types for the Control-D/V User Reports entry panel: V (Default panel), A (All fields), and J (Job display).

The fields in display types V, A, and J are described later in this chapter.

The entry panel default display (V) is illustrated below.

Figure 67 User Reports Entry Panel

 ------------------ 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 ===> Y               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

In the entry panel and Show Options window, the default 1-character equivalents for YES and NO are Y and N. installation parameters $USRYES and $USRNO in member $$FRM of the IOA MSG library can be used to set different 1-character equivalents for YES and NO.

Changing Entry Panel Display Types

While in the Control-D/V User Reports entry panel, the entry panel display type can be changed through the DISPLAY command. Format of the command is:

DISPLAY x

where x is a one letter code which identifies the desired display type. DISPLAY can be abbreviated to DI.

DI A

User Reports Entry Panel Fields (Display Type V)

Specify any of the following selection criteria to control which reports are displayed in User Report lists. The symbol C indicates that the field allows character masking.

Table 65 User Reports Entry Panel Fields (Display Type V)

Show Options Window

Type SHOW on the command line of the User Reports entry panel (display V) or the User Report list. Press Enter to display a Show Options window that contains additional criteria for limiting the reports displayed in the User Report list. The Show Options window is illustrated below:

Figure 68 User Reports Show Option window

------------------ CONTROL-D/V  -  USER REPORTS ENTRY PANEL ----------------(U)
COMMAND ===>   +--------------------------------------------------------------+
              |                  PLEASE SELECT SHOW OPTIONS                  |
              |                                                              |
    OPTIONS = |  CHILD        ===> Y                    Y-with children      |
              |  REMARK / CCs ===>                      Remark or CC of job  |
              |  USER REMARK2 ===>                      Remark2/prefix/mask  |
     REPORT N |       REMARK3 ===>                      Remark3/prefix/mask  |
     USER     |  CATEGORY     ===>                      Category or mask     |
     DATE FRO |  TIME FROM    ===>        TO            Report time          |
     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        07.52.01

Show Options Window Fields

Table 66 Show Options Window - Selection Criteria

Table 67 User Reports Show Option Window – Select by Status Parameters

Table 68 User Reports Show Option Window – Display Option

Bypassing the Entry Panel

When you enter Y (Yes) in the BYPASS PANEL field on the entry panel, the User Report List screen is displayed whenever you enter the User Reports facility. The User Report list is discussed in User Reports (Online Viewing).

You can enter Q (Quick Access) in the BYPASS PANEL field on the entry panel to display the Quick Access Report list or Quick Access panel whenever you enter the User Reports facility. The Quick Access Report list or Quick Access panel are discussed in Quick Access Report List.

When bypassing the entry panel, the last selection values previously set in the entry panel are applied to the User Report list.

Reaccessing the Entry Panel

After you have set the BYPASS PANEL field to Y, you can access the entry panel by pressing the END key (PF03/PF15) from a Report List screen.

After you have set the BYPASS PANEL field to Q, you can access the entry panel by using the RETURN command from the Quick Access Report list or pressing the RETURN key (PF04/PF16) from the Quick Access Panel.

To access the entry panel the next time you enter the User Reports facility, set the value of the BYPASS PANEL field to N or V. For more information, see the description of the BYPASS PANEL field in Table 65.

User Reports Entry Panel (Display Type A)

Display type A of the User Reports entry panel combines the options and fields in display type V of the User Reports entry panel with the fields in the Show Options window for display type V. Display type A functionality is identical to the combined functionality of display type V and its Show Options window.

To obtain display type A, type DISPLAY (or its abbreviation DI) followed by a space and the letter A on the command line of the User Reports entry panel and press Enter. Display U of the Control-D/V User Reports entry panel is illustrated below:

Figure 69 User Reports Entry Panel (Display Type A)

-------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL  ---------------(U)
COMMAND/OPTION  ===>                      1. PERMANENT 2. ACTIVE/MIG 3. HISTORY
SELECT BY:
   REPORT NAME  ===>                     
   USER         ===>                      Recipient name or prefix
   CHILD        ===> Y                    Y-with children
   JOB NAME     ===>                      Job name, prefix or mask
   REMARK/ CCs  ===>                      Remark or CC of job
   USER REMARK2 ===>                      Remark2, prefix or mask
        REMARK3 ===>                      Remark3, prefix or mask
   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      08.40.07

The description and usage of each field is identical to that of display type V. For complete information about each field see User Reports Entry Panel Fields (Display Type V)).

To obtain display type V (or J), type DISPLAY (or its abbreviation DI) followed by a space and the letter V (or J) on the command line of the User Reports entry panel and press Enter. Display V (or J) of the Control-D/V User Reports entry panel is displayed.

User Reports Entry Panel (Display Type J)

Display J of the Control-D/V User Reports entry panel facilitates access to reports produced by the Job Archiving facility. For more information about this facility, see the Control-D and Control-V chapter of the INCONTROL for z/OS Administrator Guide.

Display J of the User Reports entry panel is illustrated below.

Figure 70 User Reports Entry Panel (Display Type J)

-------------------- 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          ===> PRODJCL                 Recipient name or prefix
      CHILD         ===> Y                       Y-with children
      CATEGORY      ===>                         Category or mask
      DATE FROM     ===>        TO               Report date or relative day
      SHOW MIGRATED ===> Y                       Include migrated reports
 INDEX VALUE SELECTION:
      JOBNAME       ===>                         Job name, prefix or mask
      JOBID         ===>                         Job number, prefix or mask
      CCs           ===>                         CC of job
      TIME FROM     ===>        TO               Report time
      SYSTEM ID     ===>                         SMF ID, prefix or mask
 DISPLAY OPTIONS:
      BYPASS PANEL  ===> N                       SHOW RULERS        ===> N
      DISPLAY TYPE  ===> J ( EXPANDED ==> Y  )   SHOW CONTROL CHARS ===> Y

The entry panel is divided into the following sections:

Table 69 User Reports Entry Panel Sections

INDEX VALUE SELECTION contains criteria used to select one of the following:

• Original reports created by the generic mission

• Reports with the jobname ARCHIVE created as part of the consolidation process.

The INDEX VALUE criteria are used to make a search of the JOBNAME index to select the matching entries. The JOBNAME field is used both as a report selection criterion and as an argument to the index content search.

When the display is set to J in the User Reports entry panel, the Active and History Report List display defaults to J. For more information see "Display Type J (Job)" in User Report List Display Types.

For entries that belong to either group, the user can enter line command X to receive a list of JOBNAMEs that are included in the entry. If only one entry would be displayed, the index value list of the JOBNAME index is displayed.

The index value list has a single value for entries before consolidation, and multiple values for entries after consolidation. The user can use line command V to view the full output of the job, or line command X to see entries in the DDNAMES subindex for the selected job.

To obtain display J, type DISPLAY (or its abbreviation DI) followed by a space and the letter J on the command line of the User Reports entry panel and press Enter.

To display the list of jobname records for both consolidated and unconsolidated reports, type Y in the EXPANDED field and press Enter. This option avoids the additional steps of first displaying the report list of consolidated and unconsolidated reports, and then typing X in the OPTION field to see the jobname records for the specific report. For an example of a display of jobname records, see Index Window.

The description and usage of each field is identical to that of display V. For complete information about each field, see User Reports Entry Panel Fields (Display Type V)).

Index Value Selection

The parameters in this chapter specify consolidated index value search arguments.

Table 70 Consolidated Index Value Search Arguments

To obtain display V or A, type DISPLAY (or its abbreviation DI) followed by a space and the letter V or A on the command line of the User Reports entry panel and press Enter. The requested display of the Control-D/V User Reports entry panel is displayed.

Entry Panel Options: Kinds of Report Lists

Select one of the following kinds of Report lists by entering the appropriate option number in the OPTION field:

1. Permanent Report List: A list of all reports that the user can receive at any time. Modifications to the data on this list (such as the migration schedule) are valid for every subsequent execution of the report until modified in the future.

2. Active/Migrated Report List: A list of reports that recently have been or soon will be decollated, and/or reports that have migrated to various storage devices. The SHOW MIGRATED field in the User Reports entry panel determines whether the list contains only reports that have migrated, only reports that have not migrated, or both.

3. History Report List: A list of all reports that are currently backed up on tape or cartridge. The list is used to request a restore of lost reports. The length of time for which reports are backed up is determined by the INCONTROL administrator.

If you do not specify an option number and simply press Enter, the default is option 2, the Active/Migrated Report list.

Figure 71 User Reports Report Lists

Report Lists

Report lists display a list of reports available for processing (viewing, printing, restoring, and so on).

There are two types of Report lists:

• User Report List: Various display types are available.

• Quick Access Report List: The display type cannot be changed.

Header Line

The header line at the top of the screen indicates the User Report list display type (or Q to designate the Quick Access Report list) and the main selection criteria values specified in the entry panel.

ACTIVE LIST  <A>   JOB PRDRPT01 REP SALARY REPORT       USR MGT       CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR

Table 71 User Report List Header Line

Quick Access Report list – The display type cannot be changed.

Sort Order

Reports that match User Reports entry panel and Show Options window selection criteria are sorted in the following order:

User ID, job name or report name (depending on an installation parameter value), Active/Migrated status (if parameter Show Migrated is set to Y), and decollation date and time.

The INCONTROL administrator can modify this default sort order for any user by modifying parameter SUS2SRTI in the User profile member. In addition, the SORT command (described later in this chapter) enables the user to change the order of the reports displayed in the User Report list.

Additional Info (Option A)

Entering A (Additional Info) in the OPTION field of a listed report alternately displays and hides additional information about the selected report.

Use this option to show a full report name if its length is longer than 20 characters.

User Report List Display Types

The User Report list is displayed when the BYPASS PANEL field of the User Reports entry panel is set to Y or N. The various display types are discussed on the following pages. Display types can be changed via the DISPLAY command that is described in Commands of the User Report List.

Display Type D (Default)

Below are examples of Default display types of Permanent, History and Active User Report lists intended for use by the INCONTROL administrator and operations personnel. Fields labeled below are discussed on the next page.

Figure 72 User Report List Display Type D (Default) – Permanent List

PERMANENT LIST <D> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT NAME   more+  JOB      COP FORM C DEST    UDEST        WTR
  MGT      EMPLOYEES REPORT     PREMPLR2 DFT STD  X RMT2
  MGT      BANKING REPORT       M22RPTS  000 STD  X RMT2
  MKT      EMPLOYEES REPORT     PREMPLR2 DFT STD  X

Figure 73 User Report List Display Type D (Default) – History List

HISTORY LIST   <D> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT        more + ODATE     PAGES    LINES   STATUS
  MGT      BANKING REPORT       08/08/00     40     1839   Wait restore
  MKT      EMPLOYEES REPORT     08/08/00    328    14361   Backed up

Figure 74 User Report List Display Type D (Default) – Active List

ACTIVE LIST    <D> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT       more +  ODATE     PAGES    LINES V N STATUS
  DEV      EMPLOYEES REPORT     08/08/00      2       91 V A Printed
  DEV      EMPLOYEES REPORT     08/08/00      1       10 V   Wait Print
  MGT      EMPLOYEES REPORT     08/08/00      1       27     Printed
  MGT      EMPLOYEES REPORT     08/08/00      1       18   G Wait Print
  MGT      BANKING REPORT       08/08/00     23     1062     Decollated
  MGT      BANKING REPORT       08/08/00      5      256 V T Decollated
  MKT      EMPLOYEES REPORT     08/08/00      3      131     Printed
  MKT      EMPLOYEES REPORT     08/08/00    286    10864     Wait Print
  PROD     INVENTORY REPORT     08/08/00     97     4127 V   Printed
  PROD     INVENTORY REPORT     08/08/00     10      426     Wait Print
  PROD     EMPLOYEES REPORT     08/08/00      8      369 V T Printed
  PROD     EMPLOYEES REPORT     08/08/00      3      169     Wait Print
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======
 P PRINT     V VIEW     U UPDATE     I INSERT     A ADD INFO     E EDIT
 X INDEX     N NOTE     G GIVETO     D DELETE     Q QUICK ACCESS       08.02.09

Table 72 Fields in the Default (D) Display Type

Display Type D – Additional Info

Below are examples of the Additional Info option specified in the Default display type of the Permanent, History and Active User Report lists. Fields labeled below are discussed on the next page.

Figure 75 User Report List Display Type D – Additional Info – Permanent List

PERMANENT LIST  JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT NAME   more + JOB      COP FORM C DEST    UDEST        WTR
  MGT      EMPLOYEES REPORT     PREMPLR2 DFT STD  X RMT2
     REPORT NAME: EMPLOYEES REPORT
     From User       :
     Additional Users: DP-MGR
     Print Missions  : STD
     Category:  AFP                                                  
     Pagedef: A       Formdef:         Output:           Chars: **** 
     Approval: Y   Name: APRV1   Hidden:Y  Store:    SLA: 10
  MGT      BANKING REPORT       M22RPTS  000 STD  X RMT2

Figure 76 User Report List Display Type D – Additional Info – History List

HISTORY LIST   <D> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT      more +   ODATE     PAGES    LINES STATUS
  MGT      BANKING REPORT       08/08/00     40     1839 Wait restore
    Report name: BANKING REPORT
    Run: 08/08/00 12:57 - 13:03     Decollated: 08/08/00 13:04
    Copies: 001 Form: STD           Class: X          
    Remarks: C0000
    Dest  :                         WTR:  
    Category: CREATED              Fromuser:          Job: JOBABC         JN: 0372934
    Approval          StatAp           Hidden      Init_Hidden   Multi        SLA
                    Type            Waiting

Figure 77 User Report List Display Type D – Additional Info – Active List

ACTIVE LIST    <D> JOB          REP                      USR VENA     CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O USER     REPORT        more + ODATE     PAGES    LINES V N STATUS
  MGT      BANKING REPORT       08/11/15     66     1304 *   Wait print-Wait bk
    Report name: BANKING REPORT
    Run:          00:00 - 00:00     Decollated: 08/11/15 14:20
    Copies: 001  Form: STD          Class: E
    Remarks: TXTOK1
    Dest  :                         WTR:
    Category: AEGON3               Fromuser:          Job: K56CMD   JN: 0033821
    Additional Users:

    Approval APP1     StatAp Wait Appr Hidden   Init_Hidden   Multi   SLA 963
                      Type            Waiting

Table 73 Additional Info Fields in the Default (D) Display Type

For a description of the Pagedef, Formdef, Output, and Chars fields, see "Display Type U – Additional Info".

Display Type U (User)

Below are examples of User display type for the Permanent, Active and History User Report lists. Since only the end user’s own reports are displayed, this display type does not include the USER field. Fields labeled below are discussed on next page.

Figure 78 User Report List Display Type U (User) – Permanent List

PERMANENT LIST <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT NAME  more +  COP FORM C DEST     UDEST    WTR     FROMUSER
  EMPLOYEES REPORT     DFT STD  X RMT2
  BANKING REPORT       000 STD  X RMT2
  INVENTORY REPORT     000 STD  X

Figure 79 User Report List Display Type U (User) – History List

HISTORY LIST   <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT       more +  ODATE     PAGES    LINES V COP STATUS            REMARK
  EMPLOYEES REPORT     08/08/00      1       18   001 Wait restore
  BANKING REPORT       08/08/00      9      558   001 Backed up
  BANKING REPORT       08/08/00      5      256   001 Backed up

Figure 80 User Report List Display Type U (User) – Active List

ACTIVE LIST    <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT       more +  ODATE     PAGES    LINES V COP STATUS            REMARK
  EMPLOYEES REPORT     08/08/00      1       18   001 Wait print
  BANKING REPORT       08/08/00      5      256   001 Decollated
  INVENTORY REPORT     08/08/00    519    23838 3 001 Wait print
  GENERAL LEDGER       08/08/00    220     8354   002 Printed
  ANNUAL REPORT        08/08/00  24385   998704   001 Decollated
  SALARY REPORT        08/08/00    104     4116   001 Printed
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======
  P PRINT     V VIEW     U UPDATE     I INSERT     A ADD INFO     E EDIT
  X INDEX     N NOTE     G GIVETO     D DELETE     Q QUICK ACCESS      08.02.09

Table 74 Fields in the User (U) Display Type

Display Type U – Additional Info

When using option A with display type U, the following Additional Info fields are displayed on the screen. Fields labeled below are discussed on the next page.

Figure 81 User Report List Display Type U – Additional Info – Permanent List

PERMANENT LIST <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT NAME   more + COP FORM C DEST     UDEST    WTR     FROMUSER
  EMPLOYEES REPORT     DFT STD  X RMT2
     REPORT NAME: EMPLOYEES REPORT
     Additional Users:
   
     Print Missions: STD
     Category:  DAILY                User: MGT      Job: PREMPLR2
     Pagedef: A       Formdef:         Output:           Chars: **** 
     Approval: Y   Name:     Hidden:Y  Store:    SLA:
  BANKING REPORT       000 STD  X RMT2
  INVENTORY REPORT     000 STD  X

Figure 82 User Report List Display Type U – Additional Info – History List

HISTORY LIST   <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT        more + ODATE     PAGES    LINES   COP STATUS            REMARK
  EMPLOYEES REPORT     08/08/00      1       18   001 Wait restore
    REPORT NAME: EMPLOYEES REPORT
    Run: 08/08/00 21:19 - 21:34        Decollated: 08/08/00 21:35
    Form: STD         Class: X       
    Remarks: C000
    Dest:                              WTR:  
    Category: CREATED                 Fromuser: 
    Additional Users: 
    Approval:   StatAp:    Hidden:   Init_Hidden:      Multi             SLA:
                Type      Waiting 
  BANKING REPORT       08/08/00      9      458   001  Backed up
  BANKING REPORT       08/08/00      5      256   001  Backed up
  INVENTORY REPORT     08/08/00    519    23838   001  Backed up

Figure 83 User Report List Display Type U – Additional Info – Active List

ACTIVE LIST    <U> JOB          REP                      USR MGT      CHILD (U)
COMMAND ===>                                                    SCROLL===> CRSR
O REPORT        more + ODATE     PAGES    LINES V COP STATUS            REMARK
  EMPLOYEES REPORT     08/08/00      1       18   001 Wait print
    REPORT NAME: EMPLOYEES REPORT
    Run:          00:00 - 00:00        Decollated: 08/08/00 11:06
    Form: STD  Class: D               
    Remarks: C0000
    Dest:                              WTR:
    Category: DAILY3               Fromuser:          Job: M22RPTS  JN: 0033821
    Additional Users:                                                          
    Approval APP1     StatAp Wait Appr Hidden   Init_Hidden   Multi   SLA   
                      Type            Waiting                                  
  BANKING REPORT       08/08/00      5      256   001 Decollated
  INVENTORY REPORT     08/08/00    519    23838   001 Wait print
  GENERAL LEDGER       08/08/00    220     8354   002 Printed
  ANNUAL REPORT        08/08/00  24385   998704   001 Decollated
  SALARY REPORT        08/08/00    104     4116   001 Printed
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======
  
 V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO   13.16.13

Table 75 Additional Info Fields in the User (U) Display Type