Online Facilities

• Overview

• IOA Features

• Rule Definition Facility

• Pool Definition Facility

• Vault Definition Facility

• Inquiries and Updates

• External Volume Check-In Facility

• Condition and Resource Handling Facility

• Condition and Resource Handling Facility

• IOA Log Facility

• Utilities Under ISPF

Overview

The Online facility is the basic means of communication between the user and Control-M/Tape.

Online definition facilities allow you to view the status of all parameters relating to a specific rule, pool, or vault definition, or a group of rules, pools or vault definitions.

The Inquiry/Update screen allows authorized users to view and modify information concerning all media managed by Control-M/Tape.

The following topics describe the main features available under the Online facility.

IOA Features

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

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.

INCONTROL products can be customized globally, that is, 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 INCONTROL for z/OS Installation 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 this guide where applicable.

Terminal Support

IOA supports the following models of IBM 3270 terminals:

• Model 2 – 24 lines, 80 columns

• Model 4 – 43 lines, 80 columns

• Model 3 – 32 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.

At this time, IOA does not support extended color attributes under COM-PLETE.

Due to ISPF characteristics, color changes cannot occur in adjacent columns but must be separated by an attribute byte without color, that is, black. Therefore, some IOA screens have a different appearance under ISPF than under other online environments, such as native TSO and CICS.

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 criterion.

If a field supports prefixing, this fact is indicated in its description.

Character Masking

If a field supports masking, this fact is indicated in its description.

For fields that support masking, the following masking characters are available:

• * 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 string with an asterisk.

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 2 IOA 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.

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-M/Tape is active at your site, and you are authorized to access all functions and facilities, the following screen is displayed:

Figure 3 IOA Primary Option Menu when Only Control-M/Tape 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
                TR   RULE DEFINITION   CTT Rule Definition
                TP   POOL DEFINITION   CTT Pool Definition
                TV   VAULT DEFINITION  CTT Vault Definition
                TI   INQ/UPD MEDIA DB  CTT Media Database Inquire/Update
                TC   CHECK IN EXT VOL  CTT External Volume Check-In





            COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION            18.05.34 

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 of the same number. For example, to select the LOG option, press PF05/PF17.

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 20.

Table 20 INCONTROL Shared IOA Functions and Facilities

These shared functions and facilities are described in further detail in this chapter.

The following functions (options) are applicable to Control-M/Tape:

Table 21 Control-M/Tape Functions and Facilities

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

Figure 4 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  TSO                     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                OK  KOA RECORDER       
                                                                              
                                                                              
                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   
                BA  RULE ACTIVITY          TC  CHECK IN EXT VOL   
                                                                              
                                                                              
            COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               16.20.21

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-M/Tape with other INCONTROL products are listed below:

Table 22 IOA Primary Option Menu Options

IOA Version Information

Enter INFO (or I) in the OPTION Ffield of the IOA Primary Option menu to display the IOA Version Information window, as illustrated in Figure 5. 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 5 IOA Version Information

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
                OPTION ===>                                               USER        N06

                IOA                        CONTROL-D/V                CONTROL-O
                +----------------------------------------------+
                4  COND-RES   |             IOA VERSION INFORMATION          | EFINITION
                5  LOG        |                                              | ATISTICS
                6  TSO        |   IOA                  Version 6.1.00        | TATUS
                7  MANUAL CON |   IOAGATE              Version 6.1.00        | TION LOG
                8  CALENDAR D |   CONTROL-M            Version 6.1.00        | TION OPTS
                IV  VARIABLE D |   CONTROL-M/RESTART    Version 6.1.00        |  STATUS
                |   CONTROL-M/ANALYZER   Version 6.1.00        | CORDER
                |   CONTROL-M/TAPE       Version 6.1.00        |
                |   CONTROL-D            Version 6.1.00        |
                CONTROL-M & CTM |   CONTROL-V            Version 6.1.00        | ape
                |   CONTROL-O            Version 6.1.00        |
                2  JOB SCHEDU |                                              | EFINITION
                3  ACTIVE ENV |                                              | EFINITION
                C  CMEM DEFIN |   DATE  19.08.01  CPUID  02078D 7060         | DEFINITION
                |   IOA QNAME  IOAR610                         | D MEDIA DB
                |                                              | IN EXT VOL
                +----------------------------------------------+
            COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               17.00.29

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 by the IOA Primary Option menu at your site.

Each transfer control command consists of an equal sign immediately followed by one of the options of the IOA Primary Option menu, which represents the target screen of the transfer. For example, from any screen, enter:

Table 23 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 by 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 24 Basic IOA Screen Areas

Figure 6 IOA Log Screen

FILTER:            ---------------- IOA LOG  -------------------------------(5)
                COMMAND ===>                                                    SCROLL===> CRSR
                SHOW LIMIT ON ==>                                          DATE 291201 - 010102
                DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
                311201 184915 311201 K48      SUB13AI JOB K48RUN1 / OID=005W9 SUBMITTER STARTED
                PROCESSING JOB ON SYSTEM: OS35         
                311201 184915 311201 K48      SUB133I JOB K48RUN1 K48RUN /27255 OID=005W9     
                SUBMITTED FROM LIBRARY (P) K48.LIB.JOB  
                311201 184918 311201 K48      SPY28GI JOB K48RUN1 K48RUN /27255 OID=005W9 TAPE
                DRIVE UNITS USED=00 00                  
                311201 184918 311201 K48      SPY281I JOB K48RUN1 K48RUN /27255 OID=005W9 START
                01365.1849 STOP 01365.1849 CPU 0MIN    
                00.05SEC SRB 0MIN 00.00SEC 0.00 4AOS35  
                311201 184918 311201 K48      SPY254I JOB K48RUN1 K48RUN /27255 OID=005W9     
                SCANNED                                 
                311201 184918 311201 K48      SEL216W JOB K48RUN1 K48RUN /27255 OID=005W9     
                UNEXPLAINED COND CODE 0015 STEP EXEC /  
                311201 184918 311201 K48      SEL214I JOB K48RUN1 K48RUN /27255 OID=005W9 RERUN
                NEEDED                                 
                311201 184918 311201 K48      SEL205I JOB K48RUN1 K48RUN /27255 OID=005W9 RERUN
                IN PROCESS USING MEM K48RUN1           
                311201 184918 311201 K48      SEL286I JOB K48RUN1 K48RUN /27255 OID=005W9     
                WAITING FOR CONFIRMATION                
                CMDS: SHOW, GROUP, CATEGORY, SHPF                                      08.57.11
            

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 25 Common 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 7 PFKey Assignment Window

FILTER:            ---------------- IOA LOG  -------------------------------(5)
                COMMAND ===>                                                    SCROLL===> CRSR
                SHOW LIMIT ON ==>                                          DATE 291201 - 010102
                DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
                311201 184915 311201 K48      SUB13AI JOB K48RUN1 / OID=005W9 SUBMITTER STARTED
                PROCESSING JOB ON SYSTEM: OS35         
                311201 184915 311201 K48      SUB133I JOB K48RUN1 K48RUN /27255 OID=005W9     
                SUBMITTED FROM LIBRARY (P) K48.LIB.JOB  
                311201 184918 311201 K48      SPY28GI JOB K48RUN1 K48RUN /27255 OID=005W9 TAPE
                DRIVE UNITS USED=00 00                  
                311201 184918 311201 K48      SPY281I JOB K48RUN1 K48RUN /27255 OID=005W9 START
                +----------------------------------------------------------------------------+
                |                                                                            |
                |     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 26 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

Scrolling conventions are very similar to the ISPF conventions of IBM. Two basic commands are used for scrolling:  

Table 27 Scrolling Commands

The commands can be entered 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 28 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 entering the amount directly after the scroll command itself, or by entering 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.

• Some screens enable the user to limit the number of lines searched by a FIND command. This is discussed in the relevant screen descriptions.

• In some screens, the FIND command does not detect information that is to the right or left of the information displayed in the monitor. To ensure detection of the desired string, the screen must be displayed in wraparound mode, when available, before executing the FIND command.

Text String Searches

The FIND command can also be used to search for text strings, in which case the command will find 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.

For example,

FIND T'WAIT SCHEDULE'

will find WAIT SCHEDULE, and it will also find wait schedule, and Wait Schedule, and any other case variant.

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 will find 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.

For example,

FIND C'WAIT SCHEDULE'

will find WAIT SCHEDULE, but it will not find wait schedule, or Wait Schedule, or any other case variant.

CANCEL and RESET Commands

CANCEL and RESET commands are entered 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 Rule Definitions in the IOA Edit Environment.

The RESET command (PF04/PF16) can also be used in most windows, for example, the Show Screen Filter 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.

Figure 8 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 
                ENTER END OR PF03/PF15 TO EXIT THE HELP SCREEN                         08.55.40
            

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.

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.

AutoRefresh Mode

Certain INCONTROL screens, as noted in this chapter where appropriate, support AutoRefresh mode. A screen display in AutoRefresh mode is automatically updated periodically with the most current data.

AutoRefresh mode can only be activated under native TSO or under ISPF. AutoRefresh mode is activated by the AUTO command. The format of the command is

AUTO n

where n is any number of seconds from 1 through 99.

The screen is updated when the AUTO command is issued, and then periodically updated according to the interval (in seconds) specified in the AUTO command. A counter at the top of the screen displays the number of times the screen has been refreshed.

Cancelling AutoRefresh Mode

Under native TSO, the recommended method of cancelling AutoRefresh mode is as follows:

• For short interval values – Press Enter. Whenever Enter is pressed, or a command is issued, AutoRefresh mode is automatically cancelled at the end of the current interval.

• For long interval values – Press Attn (PA1) once.

Under ISPF, press Attn (PA1) or Esc once to cancel AutoRefresh mode.

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 29 ISPF Commands that must be defined 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.

For all other ISPF commands, such as UP or DOWN, the key definitions in ISPF are ignored and the PFKey is interpreted according to the definition in the IOA Online facility.

Under ISPF, IOA Option 6 activates the Online Utilities panel, which is 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 data set (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 9.

Figure 9 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 10.

Figure 10 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 30:

Table 30 PFKey Functions Within the IOA Editor Screen

Commands of the IOA Editor Screen

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

Table 31 IOA Editor Command Line Commands

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

Table 32 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 11.

Figure 11 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:

   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:

   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:

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 12 IOA TSO Command Processor Screen

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

TSO commands can also be activated directly from any IOA 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 can be time consuming and inconvenient if an ISPF application or a 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 remains 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.

Rule Definition Facility

The Control-M/Tape Rule Definition facility is composed of a series of screens that enable you to view, create, and modify rule definitions and parameters.

Rules are the main Control-M/Tape entities that manage media at your site. A rule is a user-defined list of instructions (parameters) whose execution is automatically triggered when specified media are accessed. Real-time media management processes and maintenance procedures can be tailored to meet your site’s needs through rule definitions.

Rule Definition

Rule definitions under Control-M/Tape are stored in libraries (partitioned data sets). A library contains rule tables (members), and each table contains rules (criteria) for media management functions. A rule table generally contains rules related to a specific topic, such as backups. Although most sites designate a primary rule definition library, the number of rule definition libraries you can use is unlimited.

rary, the number of rules in a table, and the size of each rule definition, are all calculated dynamically and are not dependent on parameter specification or optional ZAPs.

Accessing the Rule Definition Facility

The Rule Definition facility contains the following screens:

Table 33 Rule Definition Facility Screens

To enter the Online Rule Definition facility, select option TR in the IOA Primary Option menu. The Control-M/Tape Rule Definition Facility entry panel is displayed.

Creating Tables

Tables can be created in any of the following ways:

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

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

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

Fill in the blanks and save the screen entries. The table is created and the rule definition is the first and only definition in the Rule list of the table. As additional rule definitions are created in the table (described below), they are added to the list.

Creating Rule Definitions

Rule definitions can be created using either of two basic methods:

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

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

Performing Operations on Tables and Rules

Many operations can be performed on tables and on the rule definitions in them. These operations are performed using commands and options in the various screens of the Rule Definition facility.

Below is a brief summary of some of the major operations possible within the facility. Additional options and commands are explained following the summary.

Accessing (Editing or Browsing) a Table and its Rules

A table (meaning, the rule definitions in the table) can be browsed or edited.

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

Browsing, however, has advantages:

• Access and exit are quicker than in editing.

• Rule list and rule 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 table (and its rule list and rule definitions), use the BROWSE option in the Table List screen.

Specifying the table name in the entry panel, or using the SELECT option in the Table List screen, provides edit access.

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

Copying a Rule to Another Table

Rules can be copied from one table to another using the COPY option in the Rule List screen. For more information, see Copying Rules to Another Table.

Deleting a Table or a Rule

Unneeded rules can be deleted using the DELETE option in the Rule List screen. For more information, see Options of the Rule List Screen. Unneeded tables can be deleted using the DELETE option in the Table List screen. For more information, see Deleting Rule Table.

Saving Modifications

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

Rule Definition Entry Panel

The Rule Definition Entry Panel is displayed upon entering the Rule Definition facility (option TR in the IOA Primary Option menu).

Figure 13 Rule Definition Entry Panel

------------------ CONTROL-M/Tape RULE DEFINITION ENTRY PANEL -------------(TR)
                COMMAND ===>                                                                  
                                                                               
                                                                               
                                                                               
                SPECIFY LIBRARY, TABLE NAME, RULE NAME                                        
                                                                               
                LIBRARY   ===> CTTP.PROD.RULES                                               
                TABLE     ===>                      (Blank for table selection list)         
                RULE      ===>                      (Blank for rule selection list)          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                AUTOMATIC  RULE  SORTING ===> Y     (Y/N)                                    
                SHOW SCHEDULING CRITERIA ===> Y     (Y/N)                                    
                SHOW RULE DOCUMENTATION  ===> N     (Y/N)                                    
                AUTO-SAVE DOCUMENTATION  ===> N     (Y/N)                                    
                                                                               
                                                                               
                                                                               
                                                                               
                USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           10.08.05
            

To open the desired display

Fill in the LIBRARY, TABLE, and RULE fields.

To display the list of tables in a library

1. Type the library name.

2. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

3. Press Enter.

To display the list of rules of a specific rule

1. Type the library name.

2. Type the table name.

3. Press Enter.

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

To display the details of a specific rule (Rule Definition screen)

1. Type the library name.

2. Type the table name.

3. Type the rule name.

4. Press Enter.

If the table does not exist, or if the rule for the specified table does not exist, the screen for defining a new rule in the table is displayed.

To display the Search window

1. Type the library name.

2. Type the rule name.

3. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

4. Press Enter.

To create a new table

1. Type the library name.

2. Type a new table name.

3. Press Enter

The Rule definition screen, for defining the first rule in the new table, is displayed.

Rule Display Criteria

You can modify the way rules are displayed based on the display criteria you select in the AUTOMATIC RULE SORTING, SHOW SCHEDULING CRITERIA, SHOW RULE DOCUMENTATION, and AUTO-SAVE DOCUMENTATION LIBRARY, TABLE, and RULE fields of the entry panel, as described below:

• Type Y or N in the AUTOMATIC RULE SORTING field to determine whether newly created rules are placed in correct sort order. For more information, see Rule Order.

• Type Y or N in the SHOW SCHEDULING CRITERIA field to determine whether the Basic Scheduling parameters for the rule are displayed when the rule is displayed. For more information, see "Display and Non-Display of Scheduling Criteria" in Commands of the Rule Definition Screen.

• Type Y or N in the SHOW RULE DOMENTATION field to determine whether rule documentation lines are displayed when the rule is displayed. For more information, see Rule Documentation.

• Type Y or N in the AUTO-SAVE DOCUMENTATION field to determine whether changes made to documentation are automatically saved (meaning, without special prompting) when updating the rule. For more information, see Rule Documentation.

Search Window

The Search window allows you to search for the specified rule in tables in the specified library. Tables in which the rule have been found are then displayed in the Rule List screen.

Figure 14 Rule Definition Entry Panel Search Window

----------------- CONTROL-M/TAPE RULE DEFINITION ENTRY PANEL---------------(TR)
                COMMAND ===>



                SPECIFY LIBRARY, TABLE NAME, RULE NAME

                LIBRARY ===> CTT.PROD.RULES
                TABLE      ===>                      (Blank for table selection list)
                RULE       ===>                      (Blank for rule selection list)
                +-------------------------------------------+
                |                                           |
                |    PLEASE SELECT ONE OF THE FOLLOWING:    |
                |                                           |
                |    1  - STOP SEARCH IMMEDIATELY           |
                AUTOMATIC  RULE  SORTING ===>    |    2  - ASK AGAIN AFTER 000010 TABLES     |
                SHOW SCHEDULING CRITERIA ===>    |    3  - UNCONDITIONAL SEARCH              |
                SHOW RULE DOCUMENTATION  ===>    |                                           |
                AUTO-SAVE DOCUMENTATION  ===>    |    NUMBER OF TABLES IN LIBRARY:  000010   |
                |    NUMBER OF SEARCHED TABLES :   000000   |
                |    NUMBER OF SELECTED TABLES:    000000   |
                |                                           |
                +-------------------------------------------+
                USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           18.12.28
            

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

Searches all tables in the specified library.

The search continues uninterrupted unless and until you select option 1 (Stop Search Immediately).

2 – ASK AGAIN AFTER number TABLES

Searches the specified number of tables 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 Rule List is displayed listing those tables.

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

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

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

• Number of selected tables. Lists the cumulative number of tables selected that contain the rule being searched.

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

Table List Screen

The Rule Table List screen displays a list of rule tables (members) in the specified library. You can enter this screen using the entry panel or when returning from the Rule List screen.

By default, only rule table names are listed in the screen. However, if the default has been modified at time of installation, statistical information is displayed with the rule table name (as shown below).

Figure 15 Rule Definition Facility Table List Screen

TABLES OF LIBRARY CTT.PROD.RULES                               ------------(TR)
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
                ACCTBKP           01.01 00/08/08 00/08/08 08:05    70    70     0 M17A
                ACCTVLT           01.01 00/11/10 00/11/10 20:18     9     9     0 M17A
                ACCTRET           01.01 00/08/08 00/08/08 09:17    41    41     0 M43A
                ACCTTAPE          01.01 00/08/08 00/08/08 09:27     5     5     0 M13A
                ADSCRTCH          01.01 00/08/08 00/08/08 08:05   180   180     0 M17A
                ADMBKP            01.01 00/08/08 00/08/08 13:34    14    14     0 M65
                ADMVLT            01.01 00/11/10 00/11/10 21:03    14    14     0 M44A
                ADMRET            01.01 00/11/10 00/11/10 21:09    14    14     0 M44
                ADMTAPE           01.01 00/07/07 00/07/07 18:05     5     5     0 M65
                ADM0001           01.01 00/05/05 00/10/10 13:34     9     9     0 M17A
                ADM0002           01.01 00/05/05 00/10/10 15:31    70    70     0 M72
                CART1200          01.01 00/05/05 00/10/10 00:11     9     9     0 M17A
                CART1300          01.01 00/07/07 00/07/07 15:31    14    14     0 M17A
                MAINT             01.01 00/11/10 00/11/10 13:34    41    41     0 M17A
                MAINTTAP          01.01 00/07/07 00/07/07 00:14     5     5     0 M17A
                MAINTCAR          01.01 00/11/10 00/11/10 11:28    14    14     0 M17A
                ======= >>>>>>>>>>>>>>>> NO MORE TABLES IN THIS LIBRARY <<<<<<<<<<<<<<<<< ====



                OPTIONS:  S SELECT   B BROWSE   D DELETE                               12.48.05
            

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

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

Options of the Rule Table List Screen

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

Table 34 Options of the Table List Screen

Deleting Rule Table

To delete tables, specify option D in the OPT field by the rule table names and press Enter.

The following confirmation window is displayed, in sequence, for each rule table selected for deletion:

Figure 16 Rule Definition Facility Delete Table Confirmation Window

TABLES OF LIBRARY CTT.PROD.RULES                               ------------(TR)
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
                ACCTBKP           01.01 00/08/08 00/08/08 08:05    70    70     0 M17A
                ACCTVLT                +--------------------------+ 9     9     0 M17A
                ACCTRET                |   CONFIRM DELETE OPTION  | 1    41     0 M43A
                D   ACCTTAPE   <-----------|               (Y/N)      | 5     5     0 M13A
                ADSCRTCH               +--------------------------+ 0   180     0 M17A
                ADMBKP            01.01 00/08/08 00/08/08 13:34    14    14     0 M65
                D   ADMVLT            01.01 00/11/10 00/11/10 21:03    14    14     0 M44A
                ADMRET            01.01 00/11/10 00/11/10 21:09    14    14     0 M44
                ADMTAPE           01.01 00/07/07 00/07/07 18:05     5     5     0 M65
                ADM0001           01.01 00/05/05 00/10/10 13:34     9     9     0 M17A
                ADM0002           01.01 00/05/05 00/10/10 15:31    70    70     0 M72
                CART1200          01.01 00/05/05 00/10/10 00:11     9     9     0 M17A
                D   CART1300          01.01 00/07/07 00/07/07 15:31    14    14     0 M17A
                MAINT             01.01 00/11/10 00/11/10 13:34    41    41     0 M17A
                MAINTTAP          01.01 00/07/07 00/07/07 00:14     5     5     0 M17A
                MAINTCAR          01.01 00/11/10 00/11/10 11:28    14    14     0 M17A
                ======= >>>>>>>>>>>>>>>> NO MORE TABLES IN THIS LIBRARY <<<<<<<<<<<<<<<<< ====



                OPTIONS:  S SELECT   B BROWSE   D DELETE                               12.48.00
            

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

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

A message is written to the IOA Log file for each rule table deleted.

Rule List Screen

The Rule List screen displays the list of rules in a specified library. This screen can be entered directly from the Rule Definition entry panel or the Rule Table List screen, or upon exiting from the Rule Definition screen.

Figure 17 Rule Definition Rule List Screen

RULES OF LIBRARY: CTT.PROD.RULES                                TABLE: ADM0002
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  RULE ----------------- DESCRIPTION ---------------------------------------
                ADMCLEAN   CLEAN-UP OF EXPIRED TAPES AND CARTRIDGES
                JOB0012    SET VAULT PATTERN OF JOB0012 VOLUMES
                JOB0013    SET VAULT PATTERN OF JOB0013 VOLUMES
                JOB0099    SET VAULT PATTERN OF JOB0099 VOLUMES
                M38SCRT    SCRATCH OF OUTDATED M38 TAPES
                M43SCRT    SCRATCH OF OUTDATED M43 TAPES
                MODRES     MODIFY RESOURCE COUNT
                MNTCHK     MOUNT CHECK - FORCE CERTAIN CONTROL-M JOBS
                SHOUTSCR   SHOUT ON SCRATCH OF CERTAIN JCL ACCOUNTS
                ======= >>>>>>>>>>>>>>>>> NO MORE RULES IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====









                OPTIONS:  S SELECT   D DELETE   I INSERT   C COPY                      12.48.40
            

The Rule list is displayed either in sorted or unsorted order, depending on the value of the AUTOMATIC RULE SORT field in the Rule Definition entry panel. For more information about rule sorting, see Rule Order.

Use the scrolling PFKeys to scroll the Rule list forward (PF08/PF20) and backward (PF07/PF19).

To exit the Rule List screen, press END (PF03/PF15). For more information see Exiting the Rule List Screen.

Format of the Rule List Screen

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

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

• In DATA format, the rule’s application and group names, taken from the APPL and GROUP fields of the rule definition, are displayed.

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

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

Commands of the Rule List Screen

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

Table 35 Commands of the Rule List Screen

Options of the Rule List Screen

Specify one of the following rule processing options by marking the option to the left of the rule name and pressing Enter:

Table 36 Options of the Rule List Screen

Deleting Rules

To delete rules, specify option D in the OPT field to the left of the rule names and press Enter.

The rule is removed. When you exit the Rule List screen, a confirmation window is displayed:

Figure 18 Delete Rule Confirmation Window

RULES OF LIBRARY: CTT.PROD.RULES                                TABLE: SYSTEM
        COMMAND -----------------------------------------------------------N ===> CRSR
          OPT   R |                  PLEASE SELECT EXIT OPTION             |  --------
                G |                                                        |
                U |     SAVE    CREATE                                     |
                U |                                                        |
                G |     LIBRARY CTT.PROD.RULES                             |
                B |     TABLE   SYSTEM                                     |
                B |                                                        |
                B D----------------------------------------------------------M            
                BACK2A     BACKUP WITH STACKING
     
     
     
     
     
     
                ======= >>>>>>>>>>>>>>>>> NO MORE RULES IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                OPTIONS:  S SELECT   D DELETE   I INSERT   C COPY                      11.09.51
            

Enter Y (Yes) in the SAVE field to delete the rules and exit the screen.

Enter N (No) in the SAVE field to cancel the deletion request and exit the screen.

Copying Rules to Another Table

To copy one or more rules from the current table to another table, specify opinion C (Copy) by the rule names in the Rule List screen and press Enter. The following is displayed:).

Figure 19 Rule List Screen Copy Window

RULES OF LIBRARY: CTTP.PROD.RULES                               TABLE: $DEFRETN
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  RULE ----------------- DESCRIPTION ---------------------------------------
                C   N65        DEFAULT RETENTION FROM TMOOPTXX                               
                DEFRULE    DEFAULT RETENTION FROM TMOOPTXX                               
                ======= >>>>>>>>>>>>>>>>> NO MORE RULES IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====
                                                                               
                E-----------------------------------------------------------N   
                |                                                           |   
                |     SPECIFY DESTINATION LIBRARY, TABLE AND RULE NAME      |   
                |                                                           |   
                |  LIBRARY :  CTTP.PROD.RULES                               |   
                |  TABLE   :                                                |   
                |  RULE    :  N65                                           |   
                |                                                           |   
                |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |   
                D-----------------------------------------------------------M   
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                OPTIONS:  S SELECT   D DELETE   I INSERT   C COPY                      10.58.50
            

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

Table 37 Fields of the Rule List Screen Copy Window

To preform a request, press Enter.

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

Rule Definition Screen

The Rule Definition screen is used to define, display, and modify rule parameters for management of volumes and data sets. This screen can be entered directly from the entry panel or from the Rule List screen. Updating parameters is not permitted in Browse mode.

Rule parameters can fill more than one screen. Therefore, they are organized like a sheet of paper that can be "stretched" to any desired length. Use the scrolling conventions to scroll the rule parameters forward and backward.

The rule parameters are divided into the following basic groups:

• General Parameters (see the RULE NAME through DESCRIPTION fields in Table38 in General Rule Parameters).

• Selection Parameters (see ON DATASET field in Table39 in Selection Parameters: ON Statement).

• Action Parameters (optional, see the DO statements in "Action Parameters: DO Statement" in Action Parameters: DO Statement).

Basic Scheduling Parameters (optional, see the DAYS through CONFCAL fields in Table 41 in Basic Scheduling Parameters).

The groups are separated by a delimiter line.

Figure 20 Rule Definition Screen

RULE: JOB0099  LIB CTT.PROD.RULES                               TABLE: ADM0002
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------
                RULE NAME   JOB0099   GROUP PRODUCTION                MODE PROD (Prod/Test)
                OWNER       M43       SEQUENCE PRIORITY 01 CONTINUE SEARCH Y    (Y/N)      
                DESCRIPTION SET VAULT PATTERN OF JOB0099 VOLUMES                           
                DOCMEM      JOBDOCS   DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
                ON DATASET   = *                                               And/Or/Not  
                ===========================================================================
                DO VAULT     = VAULTA                                                      
                UNTIL     DATE           0101 YEAR 1999                   And/Or    
                VAULT     = VAULTB                                                      
                UNTIL     DATE           0101 YEAR 2000                   And/Or
                VAULT     = MAINLIB                                                     
                UNTIL     DATE           0101 YEAR 2001                   And/Or      
                VAULT     =                                                             
                DO CONDITION = JOB0099_CHANGE_VAULT ODAT +                                 
                AT   CLOSE                                                        
                DO                                                                         
                ===========================================================================
                ===========================================================================
                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                                                    
                ======= >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< ====
                FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    15.49.41
            

Each rule is composed of General parameters, followed by a group of ON statements called an ON block. Only one ON block can exist in each rule definition. The ON block, that is composed of media specifications, is followed by a group of DO statements (a DO block), that is used to specify rule processing instructions and actions to be performed by the rule. For more information about ON and DO block structure, see ON/DO Block Structures.

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

The Rule Definition Screen can be exited in various ways. The most common is to press END (PF03/PF15). For more information see Exiting the Rule Definition Screen.

To implement newly defined or modified rules immediately, it is necessary to reload the Rule definitions using procedure CTTINIT. For more information, see CTTINIT procedure discussion in the Control-M/Tape chapter of the INCONTROL for z/OS Administrator Guide.

Rule parameters are described in detail in Chapter 3, "Rule Parameters." They are described briefly in the following topics.

General Rule Parameters

General rule parameters provide basic information about a rule.

Figure 21 General Parameters

+-----------------------------------------------------------------------------+
                RULE NAME   JOB0099   GROUP PRODUCTION                MODE PROD (Prod/Test)
                OWNER       M43       SEQUENCE PRIORITY 01 CONTINUE SEARCH Y    (Y/N)      
                DESCRIPTION SET VAULT PATTERN OF JOB0099 VOLUMES                           
                DOCMEM      CTTDOCS   DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
            

Table 38 General Parameters

Selection Parameters: ON Statement

Selection parameters specify selection criteria (ON statements) that must be fulfilled before Control-M/Tape performs designated actions.

An ON statement is comprised of the ON field, and its corresponding parameters. The ON DATASET statement is required in each rule definition. If it is not specified, Control-M/Tape automatically adds ON DATASET = * (an unqualified ON DATASET statement) as the last ON statement.

An unlimited number of ON statements can be specified in an ON block, using the And/Or/Not parameter described below.

Character masking (described in Character Masking) can be used in any of the specified criteria described in Table 39, except ON MEDIA and ON VOLSER (if a range is specified)

===========================================================================
                ON DATASET   = *                                            And/Or/Not A
                ON ACCOUNT   = A001                                           And/Or/Not
                ===========================================================================
            

The syntax of the ON statement is

ON selection_criteria

When the selection_criteria of a volume and data set is accessed, they trigger the rule.

To add a selection condition to a rule, type a valid ON parameter in the ON field and press Enter. To delete a specified selection condition, delete the ON parameter keyword and press Enter.

Valid selection criteria options and their abbreviations are:

Table 39 ON Parameter Options

     =====================================================================
                                ON DATASET   = DS303K.INF                                And/Or/Not A
                                ON ACCOUNT   = A001                                      And/Or/Not O
                                ON JOBNAME   = RT*                                       And/Or/Not
                                =====================================================================
                            

Action Parameters: DO Statement

The Control-M/Tape Action parameters (DO parameters) are used to specify processing instructions to be performed by the rule. The actions specified using the DO parameters are performed only after conditions specified in the ON block have been satisfied.

The DO parameter specifies an action to be taken. An unlimited number of DO parameters are permitted. The combination of DO parameters specified in the rule form a DO block.

It is possible to create a rule without specifying any Action parameters. One use for a rule without a DO block is for changing the Control-M/Tape operation mode systematically, without performing other actions.

To specify Action parameters, type the parameter name next to the DO on the Rule Definition screen, and press Enter. Depending on the specified parameter, different subparameters are displayed on the screen.

DOM Actions

The Action parameters are divided into the following categories:

Table 40 Action Parameter Categories

The following are a description and example of each of the DO statement options:

DO ABENDRET – Specifies how long the data set should be retained if an abend or a system crash occurs while creating the data set (meaning, the data set is incomplete or unreliable). Only one DO ABENDRET statement can be specified per rule.

   ===========================================================================
                DO ABENDRET  = CYCLES             0010     PREFIX Y  (Y/N)     And/Or  A  
                DATE           0101 YEAR 2000                   And/Or  A  
                LAST ACCESS        0090                         And/Or     
                DO                                                             
            ===========================================================================

DO BYPASS – Indicates whether Control-M/Tape should bypass tape management activities for the data set.

  ===========================================================================
                DO BYPASS    = YES
                DO
            ===========================================================================

DO CONDITION – Adds or deletes a prerequisite condition. Prerequisite conditions are used to trigger events in other INCONTROL products.

   ===========================================================================
                DO CONDITION = TAPE-MOUNTED         ODAT +                                
                AT   M  (CHeck volumes /Mount /Open / CLose /Abend Close /Keep) 
            ===========================================================================

DO DYNDS – Indicates whether a data set should be dynamically added to the Media Database.

    ===========================================================================
                DO DYNDS     = YES
                DO
            ===========================================================================

DO DYNVOL – Indicates whether a volume should be dynamically added to the Media Database.

    ===========================================================================
                DO DYNVOL    = SPECIFIC REQUEST= Y    NON SPECIFIC REQUEST (SCRATCH)= E
                DO
            ===========================================================================

DO FASTPOS – Indicates whether Control-M/Tape should request Fast Positioning for a tape.

    ===========================================================================
                DO FASTPOS     = YES
                DO
            ===========================================================================

DO FORCEJOB – Force (schedule) a jobs under Control-M.

  ===========================================================================
                DO FORCEJOB  = TABLE   JOBCHECK     JOB PROD032              DATE  ODAT 
                LIBRARY CTM.PROD.SCHEDULE                                  
                AT   A  (CHeck volumes /Mount /Open / CLose /Abend Close /Keep) 
                DO                                                                        
            ==========================================================================

DO LABEL – Determines whether an external label is printed upon creation of the data set. Only one DO LABEL statement can be specified per rule.

   ===========================================================================
                DO LABEL     = Y  (Y/N)                                                    
                DO                                                                         
            ===========================================================================

DO OVERJCL – Indicates whether MVS retention attributes for the data set should be overridden by Control-M/Tape rules.

    ===========================================================================
                DO OVERJCL   = YES
                DO RETENTION = DAYS               00030                        And/Or
                DO
            ===========================================================================

DO OWNER – Assigns an owner to a volume. Only one DO OWNER statement can be specified per rule.

   ===========================================================================
                DO OWNER     = SUPV043                                                    
                DO                                                                        
            ===========================================================================

DO POOL – Indicates the pool from which scratch volumes should be taken. Only one DO POOL statement can be specified per rule.

   ===========================================================================
                DO POOL      = ACCOUNTING                                                 
                DO                                                                        
            ===========================================================================

DO RECREATE – Indicates whether an existing data set should be overwritten by the data set.

    ===========================================================================
                DO RECREATE  = YES
                DO
            ===========================================================================

DO RESOURCE – Modifies the quantity of a Quantitative resource.

   ===========================================================================
                DO RESOURCE  = TAPE1                0001 +                                 
                AT   CL (CHeck volumes /Mount /Open / CLose /Abend Close /Keep) 
            ===========================================================================

DO RETENTION – Specifies how long the data set should be retained. Only one DO RETENTION statement can be specified per rule.

   ===========================================================================
                DO RETENTION = PERMANENT                                       And/Or     
                DO                                                                        
            ===========================================================================

DO SET – Assigns a value to an IOA AutoEdit variable.

   ===========================================================================
                DO SET       = %%TAPEOK=0                                                 
                MEMBER TAPESTAT LIBRARY   CTT.PROD.STATS                               
                AT   A  (CHeck volumes /Mount /Open / CLose /Abend Close /Keep) 
            ===========================================================================

DO SHOUT – Issues a message (to a console, a TSO user ID, the IOA Log, ROSCOE user, or Info/Management).

   ===========================================================================
                DO SHOUT     = TO TSO-MRE           URGENCY  U                            
                MESSAGE   TAPE CLOSE DURING ABEND                                      
                AT   A  (CHeck volumes /Mount /Open / CLose /Abend Close /Keep) 
            ===========================================================================

DO STACK – Enables or disables stacking of data sets on existing volumes. Only one DO STACK statement can be specified per rule.

   ===========================================================================
                DO STACK     = N  (Y/N)   SCOPE VOL                                       
                DO                                                                        
            ===========================================================================

DO STKDEFSZ – Indicates a default size to use for calculating stacking statistics for the data set.

    ===========================================================================
                DO STKDEFSZ  = 0050  OVERRIDE STATISTICS YES
                DO
            ===========================================================================

DO STKGROUP – Indicates a stacking group for the data set.

    ===========================================================================
                DO STKGROUP  = STKGRP1
                DO
            ===========================================================================

DO STKMODE – Indicates a method to be used for stacking the data set.

    ===========================================================================
                DO STACK     = Y  (Y/N)  
                DO STKMODE   = ALL
                DO
            ===========================================================================

DO STKMXLBL – Indicates a maximum number of data sets with which the data set can be stacked on a volume or group of volumes.

   ===========================================================================
                DO STACK     = Y  (Y/N)  
                DO STKMXLBL  = 0005
                DO
            ===========================================================================

DO STKMXVOL – Indicates the maximum number of volumes in a chain on which the data set can be stacked.

   ===========================================================================
                DO STACK     = Y  (Y/N)  
                DO STKMXVOL  = 0002
                DO
            ===========================================================================

DO STKRULE – Indicates a stacking limitation for the data set.

   ===========================================================================
                DO STACK     = Y  (Y/N)
                DO STKRULE   = NOT WITH JOB JOB1
                DSN
                DO STKRULE   = NOT WITH JOB
                DSN DSN1
                DO STKRULE   = NOT WITH JOB JOB2
                DSN DSN2
                DO
            ===========================================================================

DO STKSRCHL – Indicates a maximum number of volumes to consider for stacking the data set.

   ===========================================================================
                DO STACK     = Y  (Y/N)  
                DO STKSRCHL  = 0300
                DO
            ===========================================================================

DO VAULT – Identifies vault names and retention specifications for storing volumes.

   ===========================================================================
                DO VAULT     = VAULTA                      BY BOX  (Y/N)             
                UNTIL     DATE           0101 YEAR 2000                   And/Or     
                VAULT     =                                                            
                ===========================================================================
            DO                                                                        

Basic Scheduling Parameters

Basic Scheduling parameters specify on what dates the rule is a candidate for activation (meaning, load during initialization).

   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                                                     

Table 41 Basic Scheduling Parameters

Editing Definitions in the Edit Environment

Definition parameters can be edited (moved, copied, deleted, or repeated) by performing INCONTROL Line Editing commands, similar to standard ISPF line commands, from within the IOA Edit environment.

The Edit environment of the Rule Definition screen is accessed by typing EDIT in the COMMAND field of a definition screen and pressing Enter.

Figure 22 Entering Editing Commands

 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------+
                __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
                __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
                __ DESCRIPTION
                __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
                __ ===========================================================================
                __ ON DATASET   = BKP.DB*                                         And/Or/Not
                __ ===========================================================================
                __ DO POOL      = DATABASE-BKP
                __ DO RETENTION = DAYS              00060                         And/Or
                __ DO VAULT     = MAINLIB                     BY BOX    (Y/N)     
                __      UNTIL     DAYS               0010                         And/Or
                __    VAULT     = VAULT2
                __      UNTIL     VAULT DAYS         0050                         And/Or
                __    VAULT     = VAULT3
                __      UNTIL     VAULT DAYS         0050                         And/Or
                D_    VAULT     = VAULT4
                __      UNTIL     VAULT DAYS         0050                         And/Or
                __    VAULT     = VAULT5
                __      UNTIL     VAULT DAYS         0050                         And/Or
                __    VAULT     =
                __ ===========================================================================
                __ ===========================================================================
            FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.03.47

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

Editing commands are typed directly onto these underscores.

Specified Line Editing commands are processed when Enter is pressed.

For detailed information about and examples of editing definitions in the Edit environment, see Editing Rule Definitions in the IOA Edit Environment.

Commands of the Rule Definition Screen

The following commands can be specified in the COMMAND field of the Rule Definition screen:

Table 42 Commands of the Rule Definition Screen

Display and Non-Display of Scheduling Criteria

Depending on the value of the SHOW SCHEDULING CRITERIA field in the entry panel, scheduling criteria are either displayed or hidden when you first enter the Rule Definition screen:

• If the SHOW SCHEDULING CRITERIA field is set to Y (Yes), scheduling criteria are displayed upon entry to the Rule Definition screen.

• If the SHOW SCHEDULING CRITERIA field is set to N (No), scheduling criteria are hidden upon entry to the Rule Definition screen.

Specifying the SCHED command (abbreviated SC) in the COMMAND field alternately displays or hides the rule’s scheduling parameters (independent of the Show Scheduling Criteria field).

Below is an example of the Rule Definition screen with scheduling parameters hidden.

Figure 23 Rule Definition Screen with Scheduling Parameters Hidden

 RULE: JOB0099  LIB CTT.PROD.RULES                               TABLE: ADM0002
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------
                RULE NAME   JOB0099   GROUP PRODUCTION                MODE PROD (Prod/Test)
                OWNER       M43       SEQUENCE PRIORITY 01 CONTINUE SEARCH Y    (Y/N)      
                DESCRIPTION SET VAULT PATTERN OF JOB0099 VOLUMES                           
                DOCMEM      JOBDOCS   DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
                ON DATASET   = *                                               And/Or/Not  
                ===========================================================================
                DO VAULT     = VAULTA                                                      
                UNTIL     DATE           0101 YEAR 1999                   And/Or    
                VAULT     = VAULTB                                                      
                UNTIL     DATE           0101 YEAR 2000                   And/Or
                VAULT     = MAINLIB                                                     
                UNTIL     DATE           0101 YEAR 2001                   And/Or      
                VAULT     =                                                             
                DO CONDITION = JOB0099_CHANGE_VAULT ODAT +                                 
                AT   CLOSE                                                        
                DO                                                                         
                ===========================================================================
                ===========================================================================






                ======= >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< ====
            FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    15.49.41

If you are not using the scheduling options of Control-M/Tape, you should work with N as the default.

Scheduling criteria apply to a rule even when they are hidden.

Rule Documentation

This item includes the following topics:

Display and Non-Display of Documentation

Depending on the value of the SHOW RULE DOCUMENTATION field in the entry panel, rule documentation (meaning, DOC lines) is either displayed or hidden when you first enter the Rule Definition screen.

• If the SHOW RULE DOCUMENTATION field is set to Y (Yes), rule documentation is displayed.

• If the SHOW RULE DOCUMENTATION field is set to N (No), rule documentation is hidden.

Specifying the DOC command in the COMMAND field alternately displays or hides the rule’s documentation.

Figure 24 shows an example of the Rule Definition screen with documentation (DOC lines) displayed.

Figure 24 Rule Definition Screen with Documentation (DOC) Lines Displayed

 RULE: JOB0099  LIB CTT.PROD.RULES                               TABLE: ADM0002
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------+
                RULE NAME   JOB0099   GROUP PRODUCTION                MODE PROD (Prod/Test)
                OWNER       M43       SEQUENCE PRIORITY 01 CONTINUE SEARCH Y    (Y/N)      
                DESCRIPTION SET VAULT PATTERN OF JOB0099 VOLUMES                           
                DESCRIPTION                                                                
                DOCMEM      JOBDOCS   DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
                DOC THIS SCREEN SHOWS WHERE THE DOCUMENTATION WILL APPEAR
                DOC WHEN YOU USE THE DOC COMMAND. AS YOU CAN SEE,
                DOC THE LINES FOLLOWING THE DOCUMENTATION WILL BE "PUSHED" DOWNWARD.
                DOC ENTER THE DOC COMMAND AGAIN TO MAKE THIS DOCUMENTATION DISAPPEAR.
                DOC
                ===========================================================================
                ON DATASET   = *                                               And/Or/Not  
                ===========================================================================
                DO VAULT     = VAULTA                                                      
                UNTIL     DATE           0101 YEAR 1999                   And/Or    
                VAULT     = VAULTB                                                      
                UNTIL     DATE           0101 YEAR 2000                   And/Or
                VAULT     = MAINLIB                                                     
                UNTIL     DATE           0101 YEAR 2001                   And/Or      
            FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    15.49.41

Editing Documentation

Documentation can be edited when the DOC lines of the Rule Definition screen are displayed. Modify the DOC lines as desired. When you fill in the last DOC line and press Enter, a new DOC line is displayed.

Rule documentation is written to the member or library specified in the DOCMEM and DOCLIB fields on the Rule Definition screen. Therefore, it is also possible to edit the documentation directly using ISPF edit of the member. This is recommended for extensive documentation, or if complex editing is required.

AutoSave and Saving Documentation

Documentation changes can be saved upon exiting the Rule Definition screen. A Save Documentation window can be displayed (if there are documentation changes) or not displayed, depending on the value of the AUTO-SAVE DOCUMENTATION field in the entry panel.

• If the AUTO-SAVE DOCUMENTATION field was set to Y (Yes), documentation changes are automatically saved and the Save Documentation window is not displayed.

• If the AUTO-SAVE DOCUMENTATION field was set to N (No), documentation changes are not automatically saved and the Save Documentation window is displayed. This window enables you to save or cancel the documentation changes.

Figure 25 Rule Definition Screen Save Documentation Window

 RULE: JOB0099  LIB CTT.PROD.RULES                               TABLE: ADM0002
                COMMAN +-----------------------------------------------------------+  ===> CRSR
                +----- |                                                           |  --------+
                RULE |    SAVE DOCUMENTATION ==> Y      (Y/N)                    |  d/Test)
                USER |                                                           |  )      
                DESC |    LIBRARY CTT.PROD.DOC                                   |       
                DESC |    MEMBER  JOBDOCS                                        |       
                DESC |                                                           |       
                DOCM +-----------------------------------------------------------+         
                ===========================================================================
                DOC THIS SCREEN SHOWS WHERE THE DOCUMENTATION WILL APPEAR ON THE SCREEN
                DOC WHEN YOU USE THE DOC COMMAND. AS YOU CAN SEE,
                DOC THE LINES FOLLOWING THE DOCUMENTATION WILL BE "PUSHED" DOWNWARD.
                DOC ENTER THE DOC COMMAND AGAIN TO MAKE THIS DOCUMENTATION DISAPPEAR.
                DOC
                ===========================================================================
                ON DATASET   = *                                               And/Or/Not  
                ===========================================================================
                DO VAULT     = VAULTA                                                      
                UNTIL     DATE           0101 YEAR 1999                   And/Or    
                VAULT     = VAULTB                                                      
                UNTIL     DATE           0101 YEAR 2000                   And/Or
                VAULT     = MAINLIB                                                     
            FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    15.49.41

You can change the name of the library or member name in the window.

• Enter Y (Yes) in the SAVE DOCUMENTATION field to save the changes.

• Enter N (No) in the SAVE DOCUMENTATION field to cancel the changes.

After you specify Y (Yes) or N (No) and press Enter, the Rule List screen is displayed.

Exiting the Rule Definition Facility

To exit the Rule Definition facility, the following screens must be exited in sequence:

Table 43 Exiting the Rule Definition Facility

Exiting the Rule Definition Screen

Use the following commands to exit the Rule Definition screen:

Table 44 Commands for Exiting the Rule Definition Screen

Exiting the Rule List Screen

Press (PF03/PF15) END to exit the Rule List screen. If changes have been made in the Rule Definition screen and the Rule Definition screen was exited with (PF03/PF15) END, or if the Rule list was resorted, an Exit Option window is opened. Two exit options SAVE and CREATE are displayed.

Figure 26 Rule List Screen Exit Option Window

  RULES OF LIBRARY: CTT.PROD.RULES                                TABLE: AAEDTST1
                COMMAN +-----------------------------------------------------------+  ===> CRSR
                OPT  N |                 PLEASE SELECT EXIT OPTION                 |  ---------
                A |                                                           |
                J |     SAVE    CREATE                                        |
                J |                                                           |
                J |     LIBRARY CTT.PROD.RULES                                |
                M |     TABLE   JOB00012                                      |
                M |                                                           |
                M +-----------------------------------------------------------+
                M          MOUNT CHECK - FORCE CERTAIN CONTROL-M JOBS
                SHOUTSCR   SHOUT ON SCRATCH OF CERTAIN JCL ACCOUNTS
                ======= >>>>>>>>>>>>>>>>> NO MORE RULES IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====
 
 
 
 
 
 
 
 
 
 
            OPTIONS:  S SELECT   D DELETE   I INSERT                               14.24.41

You can change the name of the library or the name of the rule in the window.

To save changes to all modified rules and return to the Rule Table List screen, enter Y (Yes) in the SAVE field if the table name exists in the specified library, or enter Y (Yes) in the CREATE field to create a new table name in the specified library.

To cancel the changes to all modified rules and return to the Rule Table List screen, enter N (No) in one of the exit options.

Press RESET (PF04/PF16) in the Exit Option window to cancel the exit operation and remain in the Rule List screen.

To save changes made to parameters in the rule table, the entire table must be saved by entering Y in one of the exit options of the Rule Table List screen.

Pool Definition Facility

Control-M/Tape Online Pool Definition screens enable you to view, create and modify pool definitions.

Pools are logical groups to which media are assigned (for example, a pool can be defined for each department in your organization). Pools can help in the accounting of media per department, in departmental security, and in managing multi-platform media. Pools can be particularly useful for allocating and budgeting removable media by department. Scratch volumes are generally allocated on a pool basis. Control-M/Tape tracks the number of scratch volumes per pool so that a scratch volume is always available when needed.

Pool definitions are stored in libraries (partitioned data sets). A library contains pool tables (members), and each table contains specifications for one or more pool definitions. Most sites designate a primary pool definition library (the default is member $$POOL in the PARM library).

Accessing the Pool Definition Facility

The Pool Definition facility contains the following screens:

Table 45 Pool Definition Facility Screens

To enter the Online Pool Definition facility, select option TP in the IOA Primary Option menu. The entry panel is displayed.

Creating Tables

Tables can be created in any of the following ways:

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

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

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

Fill in the blanks and save the screen entries. The table is created and the pool definition is the first and only definition in the Pool list of the table. As additional pool definitions are created in the table (described below), they are added to the list.

Creating Pool Definitions

Pool definitions can be created using either of two basic methods:

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

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

Performing Operations on Tables and Pools

Many operations can be performed on tables and on the pool definitions in them. These operations are performed using commands and options in the various screens of the Pool Definition facility.

Following is a brief summary of some of the major operations possible within the facility. Additional options and commands are explained following the summary.

Accessing (Editing or Browsing) a Table and its Pools

A table (meaning, the pool definitions in the table) can be browsed or edited.

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

Browsing, however, has advantages:

• Access and exit are quicker than in editing.

• A pool list and rule 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 table (and its pool list and pool definitions), use the BROWSE option in the Table List screen.

Specifying the table name in the entry panel, or using the SELECT option in the Table List screen, provides edit access.

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

Copying a Pool to Another Table

Pools can be copied from one table to another using the COPY option in the Pool List screen. For more information, see Copying Pool Definitions to Another Table.

Deleting a Table or a Pool

Unneeded rules can be deleted using the DELETE option in the Pool List screen. For more information, see Options of the Pool List Screen. Unneeded tables can be deleted using the DELETE option in the Table List screen. For more information, see Deleting Pool Tables.

Saving Modifications

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

Pool Definition Entry Panel

Figure 27 Pool Definition Entry Panel

 ------------------ CONTROL-M/Tape POOL DEFINITION ENTRY PANEL -------------(TP)
                COMMAND ===>                                                                  
                                                                               
                                                                               
                                                                               
                SPECIFY LIBRARY, TABLE NAME, POOL NAME                                        
                                                                               
                LIBRARY   ===> CTTP.PROD.PARM                                                
                TABLE     ===>                      (Blank for table selection list)         
                POOL      ===>                      (Blank for pool selection list)          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
            USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           14.34.11

To open the desired display

Fill in entry panel fields LIBRARY, TABLE, and POOL as described below to open the desired display.   

To display the list of tables in a library

1. Type the library name.

2. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

3. Press Enter.

To display the list of rules of a specific pool

1. Type the library name.

2. Type the table name.

3. Press Enter.

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

To display the details of a specific pool (Pool Definition screen)

1. Type the library name.

2. Type the table name.

3. Type the pool name.

4. Press Enter.

If the table does not exist, or if the pool for the specified table does not exist, the screen for defining a new pool in the table is displayed.

Pool Table List Screen

The Pool Table List screen displays a list of pool tables (members) in the specified library. This screen can be entered directly from the entry panel or upon exiting from the Pool List screen.

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

Figure 28 Rule Definition Facility Table List Screen

 TABLES OF LIBRARY CTT.PROD.PARM                                ------------(TP)
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
                $$POOL            01.01 00/03/03 00/03/03 09:11    41    41     0 M43A
                $$VAULT           01.01 00/03/03 00/03/03 11:11    70    70     0 M43A
                ======= >>>>>>>>>>>>>>>> NO MORE TABLES IN THIS LIBRARY <<<<<<<<<<<<<<<<< ====

















            OPTIONS:  S SELECT   B BROWSE   D DELETE                               14.43.14

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

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

Options of the Pool Table List Screen

To select one of the following options, specify the option in the OPT field to the left of the pool table name, and press Enter:

Table 46 Options of the Table List Screen

Deleting Pool Tables

To delete pool tables, specify option D by the pool table names and press Enter.

The following confirmation window is displayed, in sequence, for each pool table selected for deletion:

Figure 29 Pool Definition Facility Delete Table Confirmation Window

 TABLES OF LIBRARY CTT.PROD.PARM                                ------------(TP)
                COMMAND ===>                +--------------------------+        SCROLL===> CRSR
                OPT  NAME ---               |   CONFIRM DELETE OPTION  | E  INIT   MOD   ID
                D   $$POOL     <-----------|               (Y/N)      | 1    41     0 M43A
                $$VAULT                +--------------------------+ 0    70     0 M43A
                ======= >>>>>>>>>>>>>>>> NO MORE TABLES IN THIS LIBRARY <<<<<<<<<<<<<<<<< ====












            OPTIONS:  S SELECT   B BROWSE   D DELETE                               14.43.14

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

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

A message is written to the IOA Log for each pool table deleted.

Pool List Screen

This screen displays the List of pools in a pool table in a specified library. This screen can be entered directly from the entry panel or the Pool Table List screen, or upon exiting from the Pool Definition screen.

Figure 30 Pool Definition Rule List Screen

 POOLS OF LIBRARY: CTT.PROD.PARM                                 TABLE: $$POOL
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  POOL ----------------- DESCRIPTION ---------------------------------------
                ACCT         ACCOUNTING DEPARTMENT TAPES
                ADMIN1       ADMINISTRATIVE TAPES FOR PERSONNEL
                ADMIN2       ADMINISTRATIVE TAPES FOR PAYROLL
                BACKUP1      DAILY BACKUP TAPE
                BACKUP2      MONTHLY BACKUP TAPE
                MANAGERS     MANAGERS SCHEDULES TAPES
                MARKETING    MARKETING DEPARTMENT TAPES
                MIS1         TAPES BELONGING TO MIS DEPARTMENT PROGRAMMERS
                MIS2         TAPES BELONGING TO MIS DEPARTMENT CONSULTANTS
                MIS3         TAPES BELONGING TO MIS DEPARTMENT ANALYSTS
                PERSONEL     TAPES FOR PERSONNEL DEPARTMENT
                QUALCONT     QUALITY CONTROL TAPE
                SECRETARIES  TAPES CONTAINING FILES USED BY SECRETARIES
                ======= >>>>>>>>>>>>>>>>> NO MORE POOLS IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====






            OPTIONS:  S SELECT   D DELETE   I INSERT                               12.48.43

Standard scrolling conventions are supported in this screen.

To exit to the Pool List screen, press END (PF03/PF15). For more information see Exiting the Pool List Screen.

Format of the Pool List Screen

Next to each pool name in the Pool 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 pool’s description, taken from the DESC field of the pool definition, is displayed. Default.

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

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

Commands of the Pool List Screen

The following commands can be specified in the COMMAND field of the Pool List screen:

Table 47 Commands of the Pool List Screen

Options of the Pool List Screen

Specify one of the following pool processing options by marking the option to the left of the pool name and pressing Enter:

Table 48 Options of the Pool List Screen

Pool Definition Screen

The Pool Definition screen is used to define, display and modify pool parameters. Pool parameters specify logical groups of volumes. This screen can be entered directly from the entry panel or from the Pool List screen. Update of parameters is not permitted in Browse mode.

The pool parameters may fill more than one screen.

Figure 31 Pool Definition Screen

--------------- POOL BACKUP1                    TABLE  $$POOL   ---------(TP.S)
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------+

                POOL NAME   BACKUP1                                     OWNER  DP1        
                DESCRIPTION BACKUP POOL FOR DIVISION ONE                                   
                DESCRIPTION                                                                
                ===========================================================================
                VOLUMES     FROM  BKP1*     TO                                             
                FROM  CA0001    TO  CA1000                                     
                FROM  TP1000    TO  TP1545                                     
                FROM  TP2000    TO  TP2545                                     
                FROM            TO                                             
                ======= >>>>>>>>>>>>>>> END OF POOL DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====









            FILL IN POOL DEFINITION. CMDS: EDIT, SHPF                               12.58.05

The pool parameters are divided into the following basic groups:

• General Pool parameters

• Volume Range list

The groups are separated by a delimiter line.

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

The Pool Definition screen can also be edited using ISPF-like editing commands (such as copy, move, repeat, after, before) in the Control-M/Tape Edit environment. For additional information, see Editing Rule Definitions in the IOA Edit Environment.

Pool definitions are automatically saved in a PDS member (a Pool table) that can be edited using a standard editor such as the ISPF Edit facility. Pools originally defined using a standard editor can also be displayed and edited in the Online Pool Definition screen. The pool table name is defined at time of installation (Default: $$POOL).

The Pool Definition screen can be exited in various ways. The most common is to press END (PF03/PF15). For more information, see Exiting the Pool Definition Facility.

To immediately implement newly defined or modified Pool definitions, reload them through procedure CTTINIT. For more information, see "Procedure CTTINIT" in the Control-M/Tape chapter of the INCONTROL for z/OS Administrator Guide.

General Pool Parameters

General Pool parameters provide basic information about a pool.

Table 49 General Parameters

 POOL NAME   BACKUP1                                     OWNER  DP1        
                DESCRIPTION BACKUP POOL FOR DIVISION ONE                                   
             DESCRIPTION                                          

Volume Range List

The Volume Range list specifies the volumes that are allocated to the pool.

Table 50 Volume Range List

   VOLUMES     FROM  BKP1*     TO                                              
                FROM  CA0001    TO  CA1000                                      
                FROM  TP1000    TO  TP1545                                      
                FROM  TP2000    TO  TP2545                                      
            FROM            TO                                              

Commands of the Pool Definition Screen

EDIT Command

The EDIT command alternately activates or deactivates the Edit environment of the Pool Definition screen. The Edit environment provides ISPF-like line editing commands for this screen. For additional information, see Editing Rule Definitions in the IOA Edit Environment.

Exiting the Pool Definition Facility

To exit the Pool Definition facility, the following screens must be exited in sequence:

Table 51 Pool Definition Facility Exit Screens

Exiting the Pool Definition Screen

Use the following commands to exit the Pool Definition screen:

Table 52 Pool Definition Exit Screen

Exiting the Pool List Screen

Press (PF03/PF15) END to exit the Pool List screen. If changes have been made in the Pool Definition screen and the Pool Definition screen was exited with (PF03/PF15) END, an Exit Option window is opened.

It is possible to change the name of the library or the name of the pool in the window.

Figure 32 Pool List Screen Exit Option Window

 POOLS OF LIBRARY: CTT.PROD.PARM                                 TABLE:   $$POOL
                COMMAN +-----------------------------------------------------------+  ===> CRSR
                OPT  N |                 PLEASE SELECT EXIT OPTION                 |  ---------
                A |                                                           |
                A |     SAVE Y  CREATE                                        |
                B |                                                           |
                B |     LIBRARY CTT.PROD.PARM                                 |
                M |     TABLE   $$POOL                                        |
                M |                                                           |
                M +-----------------------------------------------------------+
                M
                MIS3
                PERSONNEL
                QUALCONT
                SECRETARIES
                ======= >>>>>>>>>>>>>>>>> NO MORE POOLS IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====







            OPTIONS:  S SELECT   D DELETE   I INSERT                               12.48.45

• To save the changes to all modified pools and return to the Pool Table List screen, enter Y (Yes) in the SAVE field if the table name exists in the specified library, or enter Y (Yes) in the CREATE field to create a new table name in the specified library.

• To cancel the changes to all modified pools and return to the Pool Table List screen, enter N (No) in one of the exit options.

• Press RESET (PF04/PF16) in the Exit Option window to cancel the exit operation, and remain in the Pool List screen.

• To save changes made to pool parameters in the pool table, the entire table must be saved by entering Y in one of the exit options of the Pool List screen.

Copying Pool Definitions to Another Table

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

Figure 33 Pool List Screen Copy Window

POOLS OF LIBRARY CTT.PROD.PARM                                   POOL: PLRPT010
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ---------------------------------------------------------------------
                C   POOL1                  SCRATCH POOL1
                POOL2                  SCRATCH POOL2
                                                                             
                                                                             
                +-----------------------------------------------------------+
                |                                                           |
                |     SPECIFY DESTINATION LIBRARY,TABLE AND RULE NAME       |
                |                                                           |
                |  LIBRARY :   CTM.PROD.POOLS                               |
                |  TABLE :                                                  |
                |  POOL :      POOL1                                        |
                |                                                           |
                |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |
                +-----------------------------------------------------------+
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
            OPTIONS:  S SELECT   D DELETE   I INSERT                               12.48.45

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

Table 53 Fields of the Pool List Screen Copy Window

To perform a request, press Enter.

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

Vault Definition Facility

Control-M/Tape Vault Definition screens enable you to view, create, and modify vault definitions.

Vaults are locations in which removable media can be stored as an alternative to the active library. A vault definition defines the vault name, location, and optionally the capacity of the vault.

Vault definitions are stored in libraries (partitioned data sets). A library contains vault tables (members), and each table contains specifications for one or more vault definitions. Most sites designate a primary vault definition library (the default is $$VAULT in the PARM library), but the number of vault definition libraries that you can use is unlimited.

Vault definitions are also stored in the Control-M/Tape Media Database. Modifications to existing Vault Definitions are only incorporated after a run of vault management utility CTTVTM. For more information about utility CTTVTM, see the INCONTROL for z/OS Utilities Guide.

Vault Definition Entry Panel

Figure 34 Vault Definition Entry Panel

 ----------------- CONTROL-M/Tape VAULT DEFINITION ENTRY PANEL -------------(TV)
                COMMAND ===>



                SPECIFY LIBRARY, TABLE NAME, VAULT NAME

                LIBRARY   ===> CTT.PROD.PARM
                TABLE     ===>                      (Blank for table selection list)
                VAULT     ===>                      (Blank for vault selection list)







                SHOW VAULT DOCUMENTATION ===> N     (Y/N)
                AUTO-SAVE DOCUMENTATION  ===> N     (Y/N)




            USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           11.51.11

Fill in entry panel fields LIBRARY, TABLE, and VAULT as described below to open the desired display:

• Type Y or N in the SHOW VAULT DOMENTATION field to determine whether vault documentation lines are displayed when the vault is displayed. For more information, see Vault Documentation.

• Type Y or N in the AUTO-SAVE DOCUMENTATION field to determine whether changes made to documentation are automatically saved (meaning, without special prompting) when updating the rule. For more information, see Rule Documentation.

• To display the list of tables in a library, do the following:

  1. Type the library name.

  2. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

  3. Press Enter.

• To display the list of vaults of a specific rule, do the following:

  1. Type the library name.

  2. Type the table name.

  3. Press Enter.

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

• To display the details of a specific vault (Vault Definition screen), do the following:

  1. Type the library name.

  2. Type the table name.

  3. Type the vault name.

  4. Press Enter.

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

Vault Table List Screen

The Vault Table List screen displays a list of vault tables (members) in the specified library. You can enter this screen through the entry panel or when exiting the Vault List screen.

By default, only vault table names are listed in the screen. However, if the default has been modified at time of installation, statistical information is displayed with the vault table name, as shown in Figure 142.

Figure 35 Vault Definition Facility Table List Screen

  TABLES OF LIBRARY CTT.PROD.PARM                                ------------(TV)
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ------VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
                $$POOL     01.09 00/05/24 00/06/09 11:48   198    25     0 M09
                $$VAULT    01.05 00/06/08 00/06/13 15:39   864    40     0 M17A
                ======= >>>>>>>>>>>>>>>> NO MORE TABLES IN THIS LIBRARY <<<<<<<<<<<<<<<<< ====















            OPTIONS:  S SELECT   B BROWSE   D DELETE                               15.07.31

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

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

Options of the Vault Table List Screen

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

Table 55 Options of the Table List Screen

Deleting Vault Tables

To delete vault tables, specify D to the left of the vault table names and press Enter.

The following confirmation window is displayed, in sequence, for each vault table selected for deletion:

Figure 36 Vault Definition Facility Delete Table Confirmation Window

  TABLES OF LIBRARY CTT.PROD.PARM                                ------------(TV)
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ---               +--------------------------+ E  INIT   MOD   ID
                $$POOL                 |  CONFIRM DELETE OPTION   |      0 M09
                D   $$VAULT    <-----------|              (Y/N)       |      0 M17A
                ======= >>>>>>>>>>>>>>>> NO +--------------------------+ <<<<<<<<<<<<<<<< ====

















            OPTIONS:  S SELECT   B BROWSE   D DELETE                               15.07.31

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

• Specify N (No) to cancel the delete request.

A message is written to the IOA Log file for each vault table that is deleted.

Vault List Screen

The screen displays the list of vaults in a specified table. This screen can be entered directly from the entry panel or the Vault Table List screen, or upon exiting from the Vault Definition screen.

Figure 37 Vault Definition Rule List Screen

  VAULTS OF LIBRARY CTT.PROD.PARM                                 TABLE: $$VAULT
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  VAULT ---------------- DESCRIPTION ---------------------------------------
                VAULT_01   FOR DIVISION 1 MEDIA.
                VAULT_02   FOR DIVISION 2 MEDIA.
                VAULT_03   FOR DIVISION 3 MEDIA.
                VAULT_04   FOR DIVISION 4 MEDIA.
                ======= >>>>>>>>>>>>>>>>> NO MORE VAULTS IN THIS TABLE <<<<<<<<<<<<<<<<<< ====















            OPTIONS:  S SELECT   D DELETE   I INSERT   C COPY                      15.26.04

Standard scrolling conventions are supported on the Vault List.

To exit to the Vault List screen, press END (PF03/PF15). For more information, see Exiting the Vault List Screen.

Format of the Vault List Screen

Next to each vault name in the Vault 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 vault’s description, taken from the DESC field of the vault definition, is displayed. Default.

In STAT format, the ISPF-like statistical information about the vault is displayed.

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

Commands of the Vault List Screen

The following commands can be specified in the COMMAND field of the Vault List screen:

Table 56 Commands of the Vault List Screen

Options of the Vault List Screen

Specify one of the following vault processing options by marking the option to the left of the vault name and pressing Enter:

Table 57 Options of the Vault List Screen

Vault Definition Screen

The Vault Definition screen is used to define, display, and modify parameters of a vault. This screen can be entered directly from the entry panel or from the Vault List screen. Update of parameters is not permitted in Browse mode.

The vault parameters can take up more than one screen.

Figure 38 Vault Definition Screen

  VAULT MAINLIB  LIB CTT.PROD.VAULTS                              TABLE: $$VAULT
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------+
                VAULT NAME  MAINLIB                                                       
                LOCAL       Y                                                             
                ===========================================================================
                DESC        BACK UP SITE                                                  
                DESC                                                                      
                OWNER       NMZ                                                           
                ADDRESS     1234 MAIN STREET                                              
                ADDRESS                                                                   
                PHONE       609-555-2684                                                  
                SCHEDULE    DAILY PROCESSING                                              
                SCHEDULE                                                                  
                DOCMEM  CTTDOCS    DOCLIB CTT.PROD.DOC                                 
                ============================= GLOBAL CAPACITY ==============================
                CAPACITY 00003000  TYPE SLOT   MEDIA CART           
                00000100  TYPE BOX    MEDIA TAPE      BOX ID BXA    BOX SIZE 000020
                00000045  TYPE BOX    MEDIA 3490      BOX ID BXB    BOX SIZE 000075
                00000500  TYPE SLOT   MEDIA 3490                               
                TYPE          MEDIA                                
                ======= >>>>>>>>>>>>>> END OF VAULT DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====
 
            FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        19.55.58

Vault parameters are divided into the following basic groups shown on the following screen:

• General Vault Parameters
• Global Capacity Parameters

The groups are separated by a delimiter line.

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

The Vault Definition screen can also be edited using ISPF-like editing commands (such as copy, move, repeat, after, and before) in the IOA Edit environment. For additional information, see Editing Rule Definitions in the IOA Edit Environment.

The vault definition is automatically saved to a PDS member that can be edited using a standard editor such as ISPF Edit facility. Vaults originally defined using a standard editor can also be displayed and edited in the Vault Definition screen. The name of the PDS member that contains default vault definitions is $$VAULT.

The Vault Definition screen can be exited in various ways. The most common is to press END (PF03/PF15). For more information, see Exiting the Vault Definition Screen.

Newly-defined or modified Vault definitions become effective only after the next run of utility CTTVTM.

General Vault Parameters

General Vault parameters provide basic information about a vault.

Figure 39 General Vault Parameters

  VAULT NAME  VAULT_01                                                        
                LOCAL       Y                                                              
                ===========================================================================
                DESC        FOR DIVISION 1 MEDIA.                                          
                DESC                                                                       
                OWNER       M43                                                            
                ADDRESS     1234 MAIN STREET                                               
                ADDRESS                                                                    
                PHONE       609-555-2684                                                   
                SCHEDULE    DAILY PROCESSING                                               
                SCHEDULE                                                                   
            DOCMEM  CTTDOCS       DOCLIB CTT.PROD.DOC                                  

Table 58 General Vault Parameters

Global Capacity Parameters

Global Capacity parameters provide information about the capacity of the vault.

Figure 40 Global Capacity Parameters

============================= GLOBAL CAPACITY ==============================
                CAPACITY 00003000  TYPE SLOT  MEDIA CART
                00000100  TYPE BOX   MEDIA TAPE      BOX ID BXA    BOX SIZE 000020
            TYPE       MEDIA                                        

Table 59 Global Capacity Parameters

Commands of the Vault Definition Screen

The following commands can be specified in the COMMAND field of the Vault Definition screen:

Table 60 Commands of the Vault Definition Screen

Vault Documentation

This item includes the following topics.

Display and Non-Display of Documentation

Depending on the value of the SHOW VAULT DOCUMENTATION field in the entry panel, vault documentation (meaning, DOC lines) is either displayed or hidden when you first enter the Vault Definition screen:

• If the SHOW VAULT DOCUMENTATION field is set to Y (Yes), vault documentation is displayed.
• If the SHOW VAULT DOCUMENTATION field is set to N (No), vault documentation is hidden.

Specifying the DOC command in the COMMAND field alternately displays or hides the vault’s documentation.

The following is an example of the Vault Definition screen with documentation (DOC lines) displayed.

The DOC command alternately displays or hides documentation lines (independent of the SHOW VAULT DOCUMENTATION field).

Figure 41 Vault Definition Screen with Documentation

  VAULT VAULT_01 LIB CTT.PROD.VAULTS                              TABLE: $$VAULT
                COMMAND ===>                                                    SCROLL===> CRSR
                +-----------------------------------------------------------------------------+
                VAULT NAME  VAULT_01                                                       
                LOCAL       Y                                                              
                ===========================================================================
                DESC        FOR DIVISION 1 MEDIA.                                          
                DESC                                                                       
                OWNER       M43                                                            
                ADDRESS     1234 MAIN STREET                                               
                ADDRESS                                                                    
                PHONE       609-555-2684                                                   
                SCHEDULE    DAILY PROCESSING                                               
                SCHEDULE                                                                   
                DOCMEM  CTTDOCS       DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
                DOC THIS SCREEN SHOWS WHERE THE DOCUMENTATION WILL APPEAR ON THE SCREEN    
                DOC WHEN YOU USE THE DOC COMMAND. AS YOU CAN SEE, THE LINES FOLLOWING      
                DOC THE DOCUMENTATION WILL BE "PUSHED" DOWNWARD. ENTER THE DOC COMMAND 
                DOC AGAIN TO MAKE THIS DOCUMENTATION DISAPPEAR.       
                DOC                                                             
                ============================== GLOBAL CAPACITY ==============================
                CAPACITY 00001000      TYPE   SLOT     MEDIA 3400 
            FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        09.00.26       

Editing Documentation

Documentation can be edited when the DOC lines of the Vault Definition screen are displayed. Modify the DOC lines as desired. When you fill in the last DOC line and press Enter, a new DOC line is displayed.

Vault documentation is written to the member or library specified in the DOCMEM and DOCLIB fields in the Vault Definition screen. Therefore, it is also possible to edit the documentation directly through ISPF edit of the member; this is recommended for extensive documentation, or if complex editing is required.

AutoSave and Saving Documentation

Documentation changes can be saved upon exiting the Vault Definition screen. When there are documentation changes, a Save Documentation window can be displayed depending on the value of the AUTO-SAVE DOCUMENTATION field in the entry panel:

• If the AUTO-SAVE DOCUMENTATION field was set to Y (Yes), documentation changes are automatically saved and the Save Documentation window is not displayed.
• If the AUTO-SAVE DOCUMENTATION field was set to N (No), documentation changes are not automatically saved, and the Save Documentation window is displayed as shown below. This window enables you to save or cancel the documentation changes.

Figure 42 Vault Definition Save Documentation Window

 VAULT VAULT_01 LIB CTT.PROD.VAULTS                              TABLE: $$VAULT
                COMMAN +-----------------------------------------------------------+  ===> CRSR
                +----- |                                                           | --------+
                VAUL  |   SAVE DOCUMENTATION ==> Y      (Y/N)                     |      
                LOCA  |                                                           |      
                ====  |   LIBRARY CTT.PROD.DOCS                                   | =======
                DESC  |   MEMBER  CTTDOCS                                         |      
                DESC  |                                                           |      
                OWNE  +-----------------------------------------------------------+         
                ADDRESS                                                                    
                PHONE       609-555-2684                                                   
                SCHEDULE    DAILY PROCESSING                                               
                SCHEDULE                                                                   
                DOCMEM  CTTDOCS       DOCLIB CTT.PROD.DOC                                  
                ===========================================================================
                DOC THIS SCREEN SHOWS WHERE THE DOCUMENTATION WILL APPEAR ON THE SCREEN    
                DOC WHEN YOU USE THE DOC COMMAND. AS YOU CAN SEE, THE LINES FOLLOWING      
                DOC THE DOCUMENTATION WILL BE "PUSHED" DOWNWARD. ENTER THE DOC COMMAND 
                DOC AGAIN TO MAKE THIS DOCUMENTATION DISAPPEAR.       
                DOC                                                             
                ============================== GLOBAL CAPACITY ==============================
                CAPACITY 00001000      TYPE   SLOT     MEDIA 3400
            FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        09.00.26

You can change the name of the library or member in the window.

• Enter Y (Yes) in the SAVE DOCUMENTATION field to save the changes.
• Enter N (No) in the SAVE DOCUMENTATION field to cancel the changes.

After specifying Y or N, the Vault List screen is displayed.

Exiting the Vault Definition Facility

To exit the Vault Definition facility, the following screens must be exited in sequence:

Table 61 Exiting the Vault Definition Facility Screen

Exiting the Vault Definition Screen

Use the following commands to exit the Vault Definition screen:

Table 62 Commands for Exiting the Vault Definition Screen

Exiting the Vault List Screen

Press END (PF03/PF15) to exit the Vault List screen. If changes have been made in the Vault Definition screen and the Vault Definition screen was exited with END (PF03/PF15), an Exit Option window is opened.  

Figure 43 Vault List Screen Exit Option Window

  VAULTS OF LIBRARY CTT.PROD.PARM                                 TABLE: $$VAULT
                COMMAN +-----------------------------------------------------------+  ===> CRSR
                OPT  N |                PLEASE SELECT EXIT OPTION                  |  ---------
                $ |                                                           |
                $ |    SAVE Y  CREATE                                         |
                ===== |                                                           |  <<<< ====
                |    LIBRARY CTT.PROD.PARM                                  |
                |    TABLE   $$VAULT                                        |
                |                                                           |
                +-----------------------------------------------------------+













            OPTIONS:  S SELECT   D DELETE   I INSERT                               11.14.37

It is possible to change the name of the library or the name of the vault in the window.

• To save the changes to all modified vaults and return to the Vault Table List screen, enter Y (Yes) in the SAVE field if the table name exists in the specified library, or enter Y (Yes) in the CREATE field to create a new table name in the specified library.
• To cancel the changes to all modified vaults and return to the Vault Table List screen, enter N (No) in one of the exit options.
• Press RESET (PF04/PF16) in the Exit Option window to cancel the exit operation, and remain in the Vault List screen.
• To save changes made to vault parameters in the vault table, the entire table must be saved by entering Y in one of the exit options of the Vault List screen.

Copying Vault Definitions to Another Table

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

Figure 44 Window for Copying Vaults to Another Table

VAULTS OF LIBRARY CTT.PROD.PARM                                 VAULT: PLRPT010
                COMMAND ===>                                                    SCROLL===> CRSR
                OPT  NAME ---------------------------------------------------------------------
                C   VAULT1                 MAIN LIBRARY
                VAULT2                 BACKUP LIBRARY
                                                                             
                                                                             
                +-----------------------------------------------------------+
                |                                                           |
                |     SPECIFY DESTINATION LIBRARY,TABLE AND RULE NAME       |
                |                                                           |
                |  LIBRARY :   CTM.PROD.VAULTS                              |
                |  TABLE :                                                  |
                |  VAULT :     POOL1                                        |
                |                                                           |
                |  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 63 Fields in the Window for Copying Vaults to Another Table

• To perform a request, press Enter.

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

Inquiries and Updates

The Media Database list describes volumes and data sets that are selected according to selection criteria specified in the Inquire/Update entry panel.

The information displayed in the Media Database list is obtained from volume and data set records in the Media Database.

The Media Database list is displayed in the Media Database List screen. From this screen, you can perform the following operations on the Media Database list:

• Request additional information for any volume or data set.

• List all data sets on a given volume, or all volumes where a specific data set resides.

• List all volumes of a multi-volume chain to which a specific volume belongs.

• Update displayed information.

• Expire a volume or data set.

• Extend the expiration date of a volume or data set.

• Unscratch a volume or data set.

• Check out a volume.

• Reenter a volume that was checked out.

• Recall a volume from a vault.

• Send a volume to a vault.

• Indicate that a volume was cleaned.

• Print labels.

• Delete or Undelete a volume.

To enter the Inquire/Update screen, specify option TI (INQ/UPD MEDIA DB) in the IOA Primary Option menu. The Inquire/Update entry panel is displayed.

Inquire/Update Entry Panel

The Inquire/Update entry panel is the main user interface to Control-M/Tape removable media management information.

Figure 45 Inquire/Update Entry Panel

 ----------------  CONTROL-M/Tape - INQUIRE/UPDATE ENTRY PANEL  ------------(TI)
                COMMAND ==>                                                                   
                SELECT BY:                                                                    
                MEDIA        ===>                        Media type                        
                DSNAME       ===>                                                          
                VOLSER       ===>          TO            Volser/Mask                       
                SL-NAME      ===> *        TO            SL-Name/Mask                      
                POOL         ===>                        Pool name/Mask                    
                LOCATION     ===>                        Location name/Mask                
                                                                               
                SELECT BY DATE:                                                               
                CREATE FROM  ===>          TO            Creation date range               
                EXPIRE FROM  ===>          TO            Expiration date range             
                ACCESS FROM  ===>          TO            Last access date range            
                                                                               
                SELECT BY STATUS:                                                             
                ACTIVE       ===> Y                      VAULTED only ===> N               
                SCRATCH      ===> Y                      EXTERNAL     ===> Y               
                EDM CONTROL  ===> Y                      ATL/VTS only ===> N               
                                                         WORM only    ===> N               
                DISPLAY OPTIONS:                                                              
                DISPLAY TYPE ===> V                      RECORD TYPE  ===>                 
                                                                               
                                                                               
            FILL IN THE SELECTION CRITERIA, AND PRESS ENTER                       16.01.59

The entry panel allows you to specify selection criteria and display options for volumes and data sets. Fill in the selection criteria and display options, and press Enter. A list of all volumes and data sets that conform to the selection criteria is displayed in the Media Database list in the Media Database List screen.

The entry panel enables you to request different combinations of information. For example, you can list data set information, volume information, volume information for the selected data sets, and data set information for selected volumes. For additional information, see "DISPLAY OPTIONS" in Fields of the Inquire/Update Entry Panel.

Press END (PF03/PF15) to exit the entry panel to the IOA Option menu.

Fields of the Inquire/Update Entry Panel

From the entry panel you can specify any of the following selection criteria to control which volumes and data sets appear in the list:

SELECT BY

Table 64 Inquire/Update Entry Panel SELECT BY Selection Criteria

SELECT BY DATE

Table 65 Inquire/Update Entry Panel SELECT BY DATE Selection Criteria

SELECT BY STATUS

Only volumes and data sets that meet the selected status criteria are displayed:

Table 66 Inquire/Update Entry Panel SELECT BY STATUS Selection Criteria

DISPLAY OPTIONS

Table 67 Inquire/Update DISPLAY OPTIONS

The records are displayed in the format specified by field DISPLAY TYPE (see above).

A blank value for the RECORD TYPE field is recommended because:

• When Control-M/Tape anticipates the desired record type, it is guaranteed that the volumes and data sets are listed in a logical, meaningful order.

• The record type also determines the search method used by Control-M/Tape when listing the volumes and data sets. Leaving the RECORD TYPE field blank ensures that Control-M/Tape uses the optimal search method for a faster response time and best performance.

Control-M/Tape automatically selects an appropriate record type depending on the display type. The automatically selected record type can be overridden through a value specified in the RECORD TYPE field. This field should only be used when a sophisticated display is needed.

Display of Date Fields

Date fields are displayed with either 2-character or 4-character years, depending on the value of the IOA profile parameter PDATELTH.

Media Database List Screen

The Media Database list displays the list of volumes and/or data sets that meet the selection criteria.

Information for the Media Database List screen is obtained from the following types of records in the Media Database:

Table 68 Media Database Record Types

Volumes that are part of a group of volumes (meaning, when a data set spans multiple volumes) are displayed with an asterisk suffix.

Header Line

The Media Database list has a header line at the top of the screen indicating display types specified in the entry panel.

  DATABASE LIST < B / DV > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
            O VOLSER/DATASET NAME                            CR-DATE   RETENTION     STATUS

Table 69 Media Database List Header Line Display Types

Display Types and Fields

For each kind of Media Database list, a number of predefined display types are available.

While in the Media Database List screen, the display type can be changed through the DISPLAY command. Format of the command is:

DISPLAY x

where x is the identifying letter for the desired type. DISPLAY can be abbreviated to DI.

DI D

Predefined values are:

• D – Data set format.

• V – Volume format.

• B – Format that lists both volumes and data sets.

• S – System programmer format.

These display types, and the fields they contain, are described in the following topics.

Display Type V (Volume)

Figure 46 through Figure 49 show examples of display type V (Volume) for record type specifications D, V, DV, and VD. This display type presents volume and data set information in volume format. Fields are discussed below.

Figure 46 Inquire/Update Display Type V (Volume), Record Type V (Volume)

 DATABASE LIST < V / V  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
                BSTK01           3490       21/11/01   22/11/00   0000 MAINLIB  EDM Control 
                BSTK03           3490       15/07/01   22/11/00   0000 MAINLIB  Scratch     
                CTTCTT           TAPE         ***      16/07/01   0000 MAINLIB  Scratch     
                DFP001           CART       15/07/01              0000 MAINLIB  Scratch     
                EXT003           3590       07/11/01              0000 MAINLIB  Ext-Scratch 
                FD3726           3490       15/07/01   22/11/00   0000 MAINLIB  Scratch     
                FD3861           3490       15/07/01   22/11/00   0000 MAINLIB  Scratch     
                L14789           CARTL        ***                 0000 MAINLIB  Scratch     
                TI0001           3490       15/07/01   22/11/00   0000 MAINLIB  Scratch     
            UE0277           3490       15/07/01   22/11/00   0000 MAINLIB  Scratch

Figure 47 Inquire/Update Display Type V (Volume), Record Type D (Data Set)

 DATABASE LIST < V / D  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O ---DATASET NAME----------------------------- FILE NUMBER        DS STATUS   
                K27.TEST.LBI                                        0001        Active      
                K27.TEST.T005                                       0005        Scratch     
                K28.TEST.T001                                       0001        Active      
                LIXT01                                              0001        Scratch     
                LIXT02                                              0002        Scratch     
                LIXT03                                              0003        Active      
                M04.JOB1                                            0001        Scratch     
                M04.JOB2                                            0001        Scratch     
                M04.JOB3                                            0001        Scratch     
            N65.CHECK.VAULT.AB1                                 0001        Active      

Figure 48 Inquire/Update Display Type V (Volume), Record Type VD (Volume/Data Set)

 DATABASE LIST < V / VD > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER    VOLSEQ MEDIA      RETENTION  L-ACCESS  FILES LOCATION ---STATUS----
                AAAAA5*      001 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB1                                           0001        Scratch     
                M04.JOB5                                           0001        Scratch     
                AAAAA6           3490         ***                 0001 MAINLIB  Pend-Vault  
                AAAAA7*      002 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB2                                           0001        Scratch     
                AAAAA8*      003 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB3                                           0001        Scratch     
                AAAAA9*      004 3490         ***                 0000 MAINLIB  Scratch     
            M04.JOB4                                           0001        Scratch    

Figure 49 Inquire/Update Display Type V (Volume), Record Type DV (Data Set/Volume)

 DATABASE LIST < V / DV > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O ---DATASET NAME----------------------------- FILE NUMBER        DS STATUS   
                M04.JOB1                                            0001        Scratch     
                AAAAA5*     001 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB2                                            0001        Scratch     
                AAAAA7*     002 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB3                                            0001        Scratch     
                AAAAA8*     003 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB4                                            0001        Scratch     
                AAAAA9*     004 3490         ***                 0000 MAINLIB  Scratch     
                M04.JOB5                                            0001        Scratch     
            AAAAA5*     001 3490         ***                 0000 MAINLIB  Scratch     

Table 70 Fields in Display Type V (Volume) for Volume Records

Table 71 Fields in Display Type V (Volume) for Data Set Records

Display Type D (Data Set)

Figure 50 through Figure 53 show examples of display type D (Data set) for record type specifications D, V, DV, and VD. This display type presents volume and data set information in data set format. Fields of this display type are discussed on the following page.

Figure 50 Inquire/Update Display Type D (Data Set), Record Type V (Volume)

 DATABASE LIST < D / V  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER     VOLSEQ                                                           
                AAAAA3                                 Files: 0000                          
                AAAAA4                                 Files: 0000                          
                AAAAA5*      001                       Files: 0000                          
                AAAAA6                                 Files: 0001                          
                AAAAA7*      002                       Files: 0000                          
                BSTK01                                 Files: 0000                          
                BSTK03                                 Files: 0000                          
                CTTCTT                                 Files: 0000                          
                DFP001                                 Files: 0000                          
            EXT003                                 Files: 0000                          

Figure 51 Inquire/Update Display Type D (Data Set), Record Type D (Data Set)

 DATABASE LIST < D / D  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    
                M04.ALL                                        UUUUU7  CATALOG    Active    
                M04.ALL                                        UUUUU9  03/02/02   Active    
                M04.ALL.O                                      UUUU11  03/02/02   Active    
                M04.JOB1                                       AAAAA5  CATALOG    Scratch   
                M04.JOB2                                       AAAAA7  CATALOG    Scratch   
                M04.JOB3                                       AAAAA8  CATALOG    Scratch   
                M04.JOB4                                       AAAAA9  CATALOG    Scratch   
                M04.JOB5                                       BBBB10  29/11/01   Scratch   
                M04.JOB5                                       AAAAA5  CATALOG    Scratch   
            M04.OOO                                        UUUUU6  CATALOG    Active    

Figure 52 Inquire/Update Display Type D (Data Set), Record Type VD (Volume/Data Set)

 DATABASE LIST < D / VD > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER     VOLSEQ                                                           
                AAAAA3                                 Files: 0000                          
                AAAAA4                                 Files: 0000                          
                AAAAA5*      001                       Files: 0000                          
                M04.JOB1                                      AAAAA5  CATALOG    Scratch   
                M04.JOB5                                      AAAAA5  CATALOG    Scratch   
                AAAAA6                                 Files: 0001                          
                BBBB03                                 Files: 0001                          
                K28.TEST.T001                                 BBBB03  06/12/01   Active    
                BBBB04                                 Files: 0001                          
            K27.TEST.LBI                                  BBBB04  14/11/01   Active    

Figure 53 Inquire/Update Display Type D (Data Set), Record Type DV (Data Set/Volume)

 DATABASE LIST < D / DV > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O ---DATASET NAME-----------------------------   VOLSER  RETENTION  STATUS    
                K27.TEST.LBI                                   BABA04  14/11/01   Active    
                BABA04                                Files: 0001                          
                M04.ALL                                        UUUUU7  CATALOG    Active    
                UUUUU7                                Files: 0001                          
                M04.ALL                                        UUUUU9  03/02/02   Active    
                UUUUU9                                Files: 0001                          
                M04.ALL                                        UUUUU9  03/02/02   Active    
                UUUUU9                                Files: 0001                          
                M04.ALL.O                                      UUUU11  03/02/02   Active    
            UUUU11*     001                       Files: 0001                          

Table 72 Fields in Display Type D (Data Set) for Data Set Records

Table 73 Fields in Display Type D (Data Set) for Volume Records

Display Type B (Both)

Figure 54 through Figure 57 show examples of display type B (Both) for record type specifications D, V, DV, and VD. This display type presents volume and data set information in a format for both volumes and data sets. Fields are discussed on the following page.

Figure 54 Inquire/Update Display Type B (Both), Record Type V (Volume)

 DATABASE LIST < B / V  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                AAAAA3                                                    21/11/01   EDM-Expo
                AAAAA4                                                    04/12/01   Act-Expo
                AAAAA5*      001                                            ***      Scratch
                AAAAA6                                                      ***      Pend-Vau
                AAAAA7*      002                                            ***      Scratch
                AAAAA8*      003                                            ***      Scratch
                AAAAA9*      004                                            ***      Scratch
                BSTK01                                                    21/11/01   EDM Cont
                BSTK03                                                    15/07/01   Scratch
            CTTCTT                                                      ***      Scratch

Figure 55 Inquire/Update Display Type B (Both), Record Type D (Data Set)

 DATABASE LIST < B / D  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                K27.TEST.LBI                                   30/08/01   14/11/01   Active 
                K27.TEST.T005                                  23/01/01   07/12/01   Active 
                K28.TEST.T001                                  01/02/01   06/12/01   Active 
                LIXT01                                         19/11/01   21/11/01   Scratch
                LIXT01                                         03/12/01   CATALOG    Active 
                LIXT02                                         19/11/01   21/11/01   Scratch
                LIXT03                                         19/11/01   21/11/01   Scratch
                M04.ALL                                        04/12/01   CATALOG    Active 
                M04.ALL                                        05/12/01   03/02/02   Active 
            M04.ALL.JOB9                                   05/12/01   PERMANENT  Active 

Figure 56 Inquire/Update Display Type B (Both), Record Type VD (Volume/Data Set)

 DATABASE LIST < B / VD > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                AAAAA3                                                    21/11/01   EDM-Expo
                AAAAA4                                                    04/12/01   Act-Expo
                AAAAA5*      001                                            ***      Scratch
                M04.JOB1                                      02/08/01   CATALOG    Scratch
                M04.JOB5                                      02/08/01   CATALOG    Scratch
                AAAAA6                                                      ***      Pend-Vau
                BBBB03                                                    06/12/01   Act-ATL
                K28.TEST.T001                                 01/02/01   06/12/01   Active 
                BBBB04                                                    14/11/01   Act-Out
            K27.TEST.LBI                                  30/08/01   14/11/01   Active 

Figure 57 Inquire/Update Display Type B (Both), Record Type DV (Data Set/Volume)

 DATABASE LIST < B / DV > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                K27.TEST.LBI                                   30/08/01   14/11/01   Active 
                BABA04                                                   14/11/01   Act-Out
                K28.TEST.T001                                  01/02/01   06/12/01   Active 
                BABA03                                                   06/12/01   Act-ATL
                LIXT01                                         03/12/01   CATALOG    Active 
                RETEN                                                      ***      Ext-Acti
                M04.ALL                                        04/12/01   CATALOG    Active 
                UUUUU7                                                     ***      Ext-Acti
                M04.ALL                                        05/12/01   03/02/02   Active 
            UUUUU9                                                   03/02/02   Ext-Acti

Table 74 Fields in Display Type B (Both) for Volume and/or Data Set Records

Display Type S (System Programmer)

Figure 58 through Figure 61 show examples of display type S (System Programmer) for record type specifications D, V, DV, and VD. This display type displays the same volume and data set information (in the same format) as display type B. This display type differs from display type B in that when additional information is requested (discussed in this chapter), this display type adds additional information fields that are relevant only to system programmers. Fields are discussed on the following page.

Figure 58 Inquire/Update Display Type S (System Programmer), Record Type V (Volume)

 DATABASE LIST < S / V  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                AAAAA3                                                    21/11/01   EDM-Expo
                AAAAA4                                                    04/12/01   Act-Expo
                AAAAA5*      001                                            ***      Scratch
                AAAAA6                                                      ***      Pend-Vau
                AAAAA7*      002                                            ***      Scratch
                AAAAA8*      003                                            ***      Scratch
                AAAAA9*      004                                            ***      Scratch
                BSTK01                                                    21/11/01   EDM Cont
                BSTK03                                                    15/07/01   Scratch
            CTTCTT                                                      ***      Scratch

Figure 59 Inquire/Update Display Type S (System Programmer), Record Type D (Data Set)

 DATABASE LIST < S / D  > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                K27.TEST.LBI                                   30/08/01   14/11/01   Active 
                K27.TEST.T005                                  23/01/01   07/12/01   Active 
                K28.TEST.T001                                  01/02/01   06/12/01   Active 
                LIXT01                                         19/11/01   21/11/01   Scratch
                LIXT01                                         03/12/01   CATALOG    Active 
                LIXT02                                         19/11/01   21/11/01   Scratch
                LIXT03                                         19/11/01   21/11/01   Scratch
                M04.ALL                                        04/12/01   CATALOG    Active 
                M04.ALL                                        05/12/01   03/02/02   Active 
            M04.ALL.JOB9                                   05/12/01   PERMANENT  Active 

Figure 60 Inquire/Update Display Type S (System Programmer), Record Type VD (Volume/Data Set)

 DATABASE LIST < S / VD > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                AAAAA3                                                    21/11/01   EDM-Expo
                AAAAA4                                                    04/12/01   Act-Expo
                AAAAA5*      001                                            ***      Scratch
                M04.JOB1                                      02/08/01   CATALOG    Scratch
                M04.JOB5                                      02/08/01   CATALOG    Scratch
                AAAAA6                                                      ***      Pend-Vau
                BSTK01                                                    21/11/01   EDM Cont
                BSTK03                                                    15/07/01   Scratch
                CTTCTT                                                      ***      Scratch
            DFP001                                                    15/07/01   Scratch

Figure 61 Inquire/Update Display TypeS (System Programmer), Record Type DV (Data Set/Volume)

 DATABASE LIST < S / DV > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS 
                K27.TEST.LBI                                   30/08/01   14/11/01   Active 
                BABA04                                                   14/11/01   Act-Out
                K28.TEST.T001                                  01/02/01   06/12/01   Active 
                BABA03                                                   06/12/01   Act-ATL
                LIXT01                                         03/12/01   CATALOG    Active 
                RETEN                                                      ***      Ext-Acti
                M04.ALL                                        04/12/01   CATALOG    Active 
                UUUUU7                                                     ***      Ext-Acti
                M04.ALL                                        05/12/01   03/02/02   Active 
            UUUUU9                                                   03/02/02   Ext-Acti

Table 75 Fields in Display Type S (System Programmer) for Volume and/or Data Set Records

Additional Information Option and Fields

Specifying A (Additional Info) in the OPTION field of any volume or data set listed in the Media Database list alternately displays or hides additional information about the selected volume or data set.

The set of Additional Info fields displayed depends on whether you specified A on a volume line or on a data set line. For a volume line, fields relating to volume information are displayed. For a data set line, fields relating to data set information are displayed.

For display type S, Additional Info fields relevant to system programmers are displayed along with the standard Additional Info fields for the current line.

Descriptions of Additional Info fields are provided in the following topics for:

• Volume Additional Info fields for all display types

• Data set Additional Info fields for all display types

• Volume Additional Info fields unique to display type S

• Data set Additional Info fields unique to display type S

Additional Info for Volumes

Figure 62 Additional Information for Volumes Display

DATABASE LIST < V / V > ------------------------------------------------ (TI)
                COMMAND ===>                                                  SCROLL===> CRSR
                O VOLSER   VOLSEQ MEDIA      RETENTION L-ACCESS FILES LOCATION ---STATUS-----
                K02002      002 REEL       06/06/00             001 MAINLIB   Vaulted
                GENERAL INFORMATION:
                Media Desc:     REEL-TAPE               Unit Name:       TAPE
                SL-Name:        K02002                  Pool Name:       $$NOPOOL
                Location:       MAINLIB                 Owner:           M27A
                Description:                            Vendor Name:
                Label Type:     NL                      Density:         3490
                Capacity Used:  00800KB 100%            Ret-Dataset:     0001
                Data Uncomp:    00800MB                 Physical vol:
                Use Count:      00000                   EXCP Count:      00000000
                Last Access:                            By Job:
                Last Modified:  06/06/01                By User: M27A
                Move Date:                              Return Date:
                Check-In Date:  05/05/01                Clean Date:
                Scratch Date:                           Last Label:
                ATL Interface:                          Tape Library:
                Stk Group:
                MULTI-VOLUME:
                Volume Seq:     002                     First Volume:    KO2001
                Next Volume:                            Prev Volume:     KO2001
                I/O ERRORS:
                Read Temp:      002                     Read Perm:       000
                Write Temp:     000                     Write Perm:      000
                VAULTING INFORMATION:                   V-Dataset:       001
                Slot Num:       000                     Return Date:
                Box Id
                Vault Name:     VAULT1                  Entry Date:      06/06/01
                Retention:      VLT DAYS 0010
                ----------------------------- END OF RECORD --------------------------------
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                            18.01.59

Additional Info Fields for Volumes

The Additional Info fields for volumes are divided into the following categories:

• General Information — General information about the volume

• Multi-volume Information — Information about volumes that are part of a chain

• I/O Errors — Total number of I/O errors for this volume.

• Vaulting Information — Information about the vault pattern of the volume.

Table 76 Additional Info Fields for Volumes – General Information Fields

Table 77 Additional Info Fields for Volumes – Multi-Volume Information Fields

Table 78 Additional Info Fields for Volumes– I/O Errors Fields

Table 79 Additional Info Fields for Volumes– Vaulting Information Fields

Additional Info for Data Sets

Figure 63 Additional Info for Data Sets Display

 DATABASE LIST < D / D  > ------------------------------------------------  (TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O ---DATASET NAME-----------------------------   VOLSER RETENTION   STATUS
                DSN230.DB2P.IMAGCOPY.A1SAVLK                   005169  10/10/00   Active
                GENERAL INFORMATION:                                                 
                Sequence #:     0005                    # of Volumes:   001          
                Rec Format:     FB                      Rec Length:     00460        
                Block Size:     0000009200              Block Count:    000004       
                Comp Size:      00028KB-001%            Tape Format:    128TRACK     
                Uncomp Size:    00036KB                                              
                Use Count:      00001                   EXCP Count:     00000004     
                Modified:       06/12/01                By User:        M04          
                Job Account:                                                         
                Stk Group:      RETENTION INFORMATION:                               
                Source:         INST PARM                                            
                Retention:      DATE       08/08/00                                  
                CREATION INFORMATION:                                                
                Date:           06/06/00                Time:           03:58        
                Job Name:       MM20DBP                 Step Name:      DSNTIUT      
                PGM Name:                               DD Name:                     
                UCB Addr:                               CPU ID:                      
                Created By:                             JCL EXPDT:                   
                SMS MGMTCLS:                                                         
                LAST READ INFORMATION:                                               
                Date:           06/06/00                Time:           04:00        
                Job Name:       MM20DBP                 Step Name:      DSNTIUT      
                PGM Name:                               DD Name:                     
                UCB Addr:                               CPU ID:                      
                LAST WRITE INFORMATION:                                              
                Date:           06/06/00                Time:           04:02        
                Job Name:       MM20DBP                 Step Name:      DSNTIUT      
                PGM Name:                               DD Name:                     
                UCB Addr:                               CPU ID:                      
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                       18.29.45

The Additional Info fields for data sets are divided into the following categories:

• General Information — General Information about the data set

• Retention Information — Information about data set retention.

• Creation Information — Information about the creation of the data set.

• Last Read Information —Information about the last time the data set was read.

• Last Write Information — Information about the last time the data set was written.

Table 80 Additional Info Fields for Fields – General Information Fields

Table 81 Additional Info Fields for Fields – Retention Information Fields

Table 82 Additional Info Fields for Fields – Creation Information Fields

Table 83 Additional Info Fields for Fields – Last Read Information Fields

Table 84 Additional Info Fields for Fields – Last Write Information Fields

Additional Info for Display Type S

The System Programmer display type (S) displays more Additional Info fields than the other display types. In fact, an entire category of fields (Status Information) is added before the General Information category. The screens and field descriptions of Additional Info fields for both volumes and data sets for display type S are described on the following pages.

Figure 64 Additional Info for Volumes – Display Type S

 DATABASE LIST < S / V  > -------------------------------------------------  (TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS
                WORK02*                                                   11/10/00   Active
                STATUS INFORMATION:                                                   
                Status 1:       80                      Status 2:       00            
                Status 3:       00                      Status 4:       00            
                Record RBA:     00000105                                              
                GENERAL INFORMATION:                                                  
                Media Desc:     CARTRIDGE               Unit Name:      3490          
                SL-Name:        WORK02                  Pool Name:      $$NOPOOL      
                Location:       MAINLIB                 Owner:          M27A          
                Description:    THIS IS A TEST VOL      Vendor Name:    CTT           
                Label Type:     SL                      Tape Format:    128TRACK      
                Capacity Used:  00800KB 100%            Ret-Dataset:    0001          
                Data Uncomp:    00800MB                 Physical vol:                 
                Use Count:      00000                   EXCP Count:     00000000      
                Last Access:    04/04/00                By Job:         JOB1          
                Last Modified:  03/03/00                By User:        M27A          
                Move Date:      02/02/00                Return Date:                  
                Check-In Date:                          Clean Date:     02/02/00      
                Scratch Date:   01/01/00                Last Label:     001           
                In-Use Date:                            Job Used:                     
                User Field:                             Files:                        
                ATL Interface:                          Tape Library:                 
                Block ID:       00000000                Block ID LABEL: 0000          
                Stk Group:                                                            
                MULTI-VOLUME:                                                              
                Volume Seq:     002                     First Volume:   WORK01        
                Next Volume:    WORK03                  Prev Volume:    WORK01        
                I/O ERRORS:                                                           
                Read Temp:      011                     Read Perm:      013           
                Write Temp:     000                     Write Perm:     000           
                VAULTING INFORMATION:                   V-Dataset:      001           
                Slot Num:       002                     DSname Pref LTH 000           
                Box ID:                                 Return Date:                  
                Vault Name:     VAULT1                  Entry Date:                   
                Retention       CYCLE      0003                                       
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                            15.42.13

Table 85 Additional Information Fields for Volumes - Display Type S

Figure 65 Additional Info for Data Sets – Display Type S

  DATABASE LIST < S / D  > ------------------------------------------------  (TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                            CR-DATE    EX-DATE    STATUS
                M21.FILE1                                     01/01/00   08/08/00   Active
                STATUS INFORMATION:                                                   
                Status 1:       80                      Status 2:       00            
                Status 3        00                      Last Action     W             
                Record RBA:     00001708                                              
                GENERAL INFORMATION:                                                  
                Sequence #:     0005                    # of Volumes:   001           
                Rec Format:     FB                      Rec Length:     00460         
                Block Size:     0000009200              Block Count:    000004        
                Comp Size:      00028KB-001%            Tape Format:    256TRACK      
                Uncomp Size:    00036KB                                               
                Use Count:      00001                   EXCP Count:     00000004      
                Modified:       06/12/01                By User:        M04           
                User Field:                             DSname Pref LTH 044           
                Stk Group:                              Block ID        00000000      
                RETENTION INFORMATION:                                                
                Source:                                                               
                Retention:                                                            
                CREATION INFORMATION:                                                 
                Date:           01/01/00                Time:           17:45         
                Job Name:       JOB1                    Step Name:      STEP1         
                PGM Name:       PGM1                    DD Name:        DDNAME1       
                UCB Addr:       280                     CPU ID:                       
                Created By:                             JCL EXPDT:                    
                Step CC:                                SMS MGMTCLS:                  
                Job Account:                                                          
                LAST READ INFORMATION:                                                
                Date:           05/05/00                Time:           17:45         
                Job Name:       JOB1                    Step Name:      STEP1         
                PGM Name:       PGM1                    DD Name:        DDNAME1       
                UCB Addr:       280                     CPU ID:                       
                Step CC:                                                              
                LAST WRITE INFORMATION:                                               
                Date:           06/06/00                Time:           17:49         
                Job Name:       JOB1                    Step Name:      STEP1         
                PGM Name:       PGM1                    DD Name:        DDNAME1       
                UCB Addr:       280                     CPU ID:                       
                Step CC:                                                              
                ----------------------------- END OF RECORD --------------------------------
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           15.43.06

Table 86 Additional Info Fields for Data Sets – Display Type S

Statuses of Volumes and Data Sets

The STATUS field indicates the current volume and data set status. The following statuses may appear:

Table 87 Statuses of Volumes and Data Sets

Search Control Window

When a database list is requested, Control-M/Tape tries to fill the entire screen display with selected records. If Control-M/Tape has searched a specified threshold number of database records without filling the screen, and more records remain to be searched, Control-M/Tape interrupts the search and displays the Search Control window. This window enables the user to specify what Control-M/Tape should do next.

The default threshold number for searched records is initially specified in the IOA Global profile.

The Search Control window displays the number of records that have been searched or selected, and allows you to specify whether Control-M/Tape should

• stop searching the remaining records and display the records already selected

• continue searching the Media Database list, pausing periodically (after a user-specified number of records have been searched) to allow the search to be stopped, if desired

• search until the entire screen is filled (an unconditional search)

You can change the number of records Control-M/Tape searches by specifying a new number in the window, or by requesting that your INCONTROL administrator edit the IOA Global profile directly and change the value specified for profile parameter SINSLMT.

Figure 66 Search Control Window

  DATABASE LIST < V / D  > ------------------------------------------------  (TI)
                COMMAND ===>   +----------------------------------------------+ SCROLL===> CRSR
                O ---DATASET N |                                              |   DS STATUS
                DSN230.DB2P. |    NUMBER OF REJECTED RECORDS:   001001      |   Active
                ====== >>>>>>> |    NUMBER OF SELECTED RECORDS:   000004      |<<<<<<<<< ======
                |                                              |
                |    PLEASE SELECT ONE OF THE FOLLOWING:       |
                |                                              |
                |    1 - STOP SEARCH IMMEDIATELY               |
                |    2 - ASK AGAIN AFTER 001000 RECORDS        |
                |    3 - UNCONDITIONAL SEARCH                  |
                |                                              |
                +----------------------------------------------+










            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                            14.39.39

The following fields are displayed:

Table 88 Fields of the Search Control WIndow

The following options are available:

1 – STOP SEARCH IMMEDIATELY

Search is terminated. Records that have been selected until this option was issued are displayed.

2 – ASK AGAIN AFTER number RECORDS

Search is resumed until the specified number of records has been searched. At this point, the Search Control window is displayed again, allowing the user to continue or cancel the search.

3 – UNCONDITIONAL SEARCH

Search is resumed until the entire screen is filled or until all the records in the Media Database have been searched.

Commands of the Media Database List Screen

Use the FIND command to search for a specified string in the Media Database list.

Use the END command (PF03/PF15) to exit the Media Database list and return to the entry panel.

Use the =X command to exit the entire IOA Online facility. You are then returned to your normal operating environment.

Commands specific to the Media Database List include:

Table 89 Commands of the Media Database List Screen

DISPLAY x

DISPLAY V

SORT field [order]

Show Option Window

The Show Option window allows you to specify criteria to determine which volumes is included in the display. To open the window, specify the SHOW command in the COMMAND field of the Media Database List screen, or press PF02. Change criteria by making the desired changes in the appropriate fields. When all the desired changes have been typed in, press Enter.

Figure 67 Media Database List Screen Option Window

 DATABASE LIST < V / V  > ------------------------------------------------  (TI)
                COMMAND ===>   +--------------------------------------------------------------+
                O VOLSER    VO |                   PLEASE SELECT SHOW OPTION                  |
                V00001       |   VOLUME FIELDS:                                             |
                V00002       |                                                              |
                V00003       |   L-ACCESS JOB                     FILE NUM                  |
                V00004       |   USAGE PERCENT                    MOVE DATE                 |
                V00005       |   USE COUNT                        OWNER                     |
                ====== >>>>>>> |   EXCP COUNT                       TAPE LIB                  |
                +--------------------------------------------------------------+












            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                             19.29.54

The following selection criteria are available:

Table 90 Selection Criteria of the Show Option Window

Displaying Line Options

The OPT command alternatively displays or removes the list of Media Database List options at the bottom of the screen.   

For a description of these options, see Options of the Media Database List Screen.

Figure 68 Displaying Line Options in the Media Database List Screen

 DATABASE LIST < B / VD > ------------------------------------------------  (TI)
 COMMAND ===>                                                    SCROLL===> CRSR
 O VOLSER/DATASET NAME                            CR-DATE   RETENTION   STATUS
   RKL006                                                               Active
    AFILE                                         01/01/23   CYCL 003   Active
    AFILE                                         01/01/23   CYCL 003   Active
   RKL007                                                               Active
    AFILE                                         01/01/23   CYCL 003   Active
    AFILE                                         **/**/**   CYCL 003   Active
   VER001                                                    06/06/23   Pend-Scr
    ACC.RS.TE.FF.ACC18.A.RCC70V00                 01/01/23   06/06/23   Pend-Scr
   VER003                                                    12/12/23   Act-Worm
    ACC.YEARND.MOVE.TSSBAC.FILECHEK.KEE23V00      01/01/23   12/12/23   Active
   VER004                                                    12/12/23   EDM Cont
    ACC.YEARND.MOVE.TSSBAC.FILECHEK.KEE23V00      01/01/23   12/12/23   EDM Cont
   VER005                                                    02/02/23   Vaulted
    ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005       01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0559V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0558V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0557V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0556V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0555V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0554V00               01/01/23   02/02/23   Active
    ACC.YEARND.BAL.AX.RASD.G0553V00               01/01/23   02/02/23   Active
 A ADD INFO  S DS/VOL LIST  U UPDATE  E EXPIRE  X EXTEND  G GROUP   P PRINT
 O CHECKOUT  B BACK-IN-LIB  V VAULT   R RECALL  D DELETE  C CLEAN      19.36.23

Options of the Media Database List Screen

Table 91 Options of the Media Database List Screen

Volume Update Panel

Option U (Update) can be used to manually update the Media Database with changes to volume and data set records.

Specify option U in the Option field to the left of the record to be updated. Depending on whether the record is a volume or a data set record, the Volume Update panel or the Dataset Update panel is displayed. These update panels are discussed below.

The Volume Update panel is displayed when option U is specified for a volume record in screen TI.

Figure 69 Volume Update Panel

                            VOLUME UPDATE PANEL                          (TI.UV)
 COMMAND ===>                                                    SCROLL===> CRSR
                -------------------------------------------------------------------------------
   VOLSER       B00001                             STATUS      Ext-Active
   GENERAL INFORMATION:
   SL-NAME      B00001                             OWNER
   MEDIA TYPE   3490                               MEDIA DESC  CARTRIDGE
   DESCRIPTION  CHECKED IN MANUALLY                VENDOR NAME
   STK GROUP
   RETENTION & LOCATION INFORMATION:
   RETENTION    PERMANENT                          RET-DATASET 001
   LOCATION     MAINLIB                            MOVE DATE
   CHECKIN DATE 020400                             RETURN DATE
   ATL INTR                                        TAPE LIBR
   USAGE INFORMATION:
   ACTIVE DS#   001                                LAST LABEL  001
   CAPACITY USD 00000 (MB)000%                     EXCP COUNT  00000000
   DATA UNCOMP  00800(MB)
   LAST ACCESS                                     BY JOB
   CLEAN COUNT  00000                              CLEAN DATE
   USER INFORMATION:
   USER FIELD
   ========================= VAULTING INFORMATION ============================
   V-DATASET    000                                SLOT NUM    000000
   VAULT NAME                                      ENTRY DATE
     RETENTION                                                   And/Or
                                                                 And/Or
   VAULT NAME                                      ENTRY DATE
     RETENTION                                                   And/Or
                                                                 And/Or
   VAULT NAME                                      ENTRY DATE
     RETENTION                                                   And/Or
                                                                 And/Or

   ========= >>>>>>>>>>>>>>> E N D  O F  R E C O R D <<<<<<<<<<<<<<< =========

Fields of the Volume Update Panel

The fields of the Volume Update panel are described below.

Fields that cannot be updated are protected. On color monitors, values that can be updated appear in yellow, and those that cannot appear in blue. (On monochrome monitors, all values are displayed with the same visual attributes.)

By default, date values are specified in the site standard 6-character format (for example, mmddyy). However, if 8 is specified for IOA profile variable PDATELTH, date values are specified in the site standard eight character format (for example, mmddyyyy). Time values must be specified in hhmm format.

A change of value in certain fields can affect the values in dependent fields. In such cases, the changed value and dependent values are displayed in red (on color monitors, until Enter is pressed) and, in certain instances, dependent values are automatically changed.

For example, when the value in field MEDIA TYPE is changed from 3490 to TAPE, that field and fields MEDIA DESC, CAPACITY USED and SLOT NUM appear in red, and the value in field MEDIA DESC is automatically changed from CARTRIDGE to REEL-TAPE.

Such dependencies, when they occur, are indicated in the field descriptions that follow.

Table 92 Fields of the Volume Update Panel

Exiting the Volume Update Panel

To exit from the Volume Update panel to screen TI, press (PF03/PF15) END, or type CANCEL in the COMMAND field (to cancel the changes).

If changes have been made in the Volume Update panel and you exit by pressing (PF03/PF15) END, screen TI is displayed with the following confirmation window:

Figure 70 Volume Update Panel Exit Confirmation Window

 DATABASE LIST < B / VD > ------------------------------------------------  (TI)
 COMMAND ===>                                                    SCROLL===> CRSR
 O VOLSER/DATASET NAME                           CR-DATE    RETENTION   STATUS
   RKL006                                                               Active
    AFILE                                        01/01/00    CYCL 003   Active
    AFILE                +----------------------+01/01/00    CYCL 003   Active
   U RKL007         <----- |   CONFIRM     (Y/N)  |                       Active
    AFILE                +----------------------+01/01/00    CYCL 003   Active
    AFILE                                        **/**/**    CYCL 003   Active
   VER001                                                    06/06/00   Pend-Scr
    ACC.RS.TE.FF.ACC18.A.RCC70V00                01/01/00    06/06/00   Pend-Scr
   VER003                                                    12/12/00   Active
    ACC.YEARND.MOVE.TSSBAC.FILECHEK.KEE23V00     01/01/00    12/12/00   Active
   VER005                                                    06/06/00   Vaulted
    ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005      01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0559V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0558V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0557V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0556V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0555V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0554V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0553V00              01/01/00    12/12/00   Active
    ACC.YEARND.BAL.AX.RASD.G0552V00              01/01/00    12/12/00   Active
 USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           11.05.09

• Enter Y (Yes) and the update is performed.

• Enter N (No) and the update is not performed.

Dataset Update Panel

The Dataset Update panel is displayed when option U is specified for a data set record in screen TI.

Figure 71 Dataset Update Panel

                            DATASET UPDATE PANEL                         (TI.UD)
 COMMAND ===>                                                    SCROLL===> CRSR
 -------------------------------------------------------------------------------
   DATASET      FILE1                                        STATUS Active  
   GENERAL INFORMATION:                                                     
   VOLSER       DDD001                           SEQUENCE #  001            
   REC FORMAT   F                                REC LENGTH  01024          
   BLOCK SIZE   01024                            BLOCK COUNT 001001         
   COMP SIZE    00001 (MB)                       TAPE FORMAT 256TRACK       
   UNCOMP SIZE  00001 (MB)                                                  
   USE COUNT    00000                            EXCP COUNT  00000          
   CREATION INFORMATION:                                                    
   DATE                                          TIME        0000           
   JOB NAME                                      STEP NAME                  
   PGM NAME                                      DD NAME                    
   CREATED BY                                    SMS MGMTCLS                
   UCB ADDR     0000                             CPU ID                     
   JCL EXPDT    00000000                                                    
   JOB ACCOUNT                                                              
   RETENTION INFORMATION:                                                   
   RETENTION    CATALOG                                          And/Or     
                                                                 And/Or     
   USER INFORMATION:                                                        
   USER FIELD                                                               
                                                                    17.41.09

Fields of the Dataset Update Panel

The fields of the Dataset Update panel are described below.

fields that cannot be updated are protected. On color monitors, values that can be updated appear in yellow and those that cannot be updated appear in blue. (On monochrome monitors, all values are displayed with the same visual attributes.)

By default, date values are specified in the site standard 6-character format (for example, mmddyy). However, if eight has been specified for IOA profile variable PDATELTH, date values are specified in the site standard 8-character format (for example, mmddyyyy). Time values must be specified in hhmm format.

Table 93 Fields of the Dataset Update Panel

Exiting the Dataset Update Panel

To exit the Dataset Update panel to screen TI, press END (PF03/PF15), or enter CANCEL in the COMMAND field (to cancel the changes).

If changes have been made in the Dataset Update panel and you exit by pressing END (PF03/PF15), screen TI is displayed with the following confirmation window:

Figure 72 Dataset Update Panel Exit Confirmation Window

DATABASE LIST < B / VD > ------------------------------------------------  (TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET NAME                           CR-DATE    RETENTION   STATUS
                RKL006                                                               Active
                AFILE                                        01/01/00    CYCL 003   Active
                AFILE                +----------------------+01/01/00    CYCL 003   Active
                U RKL007         <----- |   CONFIRM     (Y/N)  |                       Active
                AFILE                +----------------------+01/01/00    CYCL 003   Active
                AFILE                                        **/**/**    CYCL 003   Active
                VER001                                                    06/06/00   Pend-Scr
                ACC.RS.TE.FF.ACC18.A.RCC70V00                01/01/00    06/06/00   Pend-Scr
                VER003                                                    12/12/00   Active
                ACC.YEARND.MOVE.TSSBAC.FILECHEK.KEE23V00     01/01/00    12/12/00   Active
                VER005                                                    06/06/00   Vaulted
                ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005      01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0559V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0558V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0557V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0556V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0555V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0554V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0553V00              01/01/00    12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0552V00              01/01/00    12/12/00   Active
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           11.05.09

Enter Y (Yes) and the update is performed.

Enter N (No) and the update is not performed.

Expiring Volumes and Data Sets

Option E (Expire) can be used to expire volumes (that have not been vaulted) or data sets. Specifying this option opens a confirmation window.

Immediate or deferred expiration can be requested. Deferred expiration changes the status of the volume or data set to Pend-Scratch, and the volume or data set is erased when retention management is performed during the New Day procedure.

Expiring a Volume

When specifying Option E for a volume, the following window is opened:

Figure 73 Expire Volume Window

  DATABASE LIST <         +----------------------------------------+---------(TI)
                COMMAND ===>            |    Volume contains 0001 datasets       |ROLL===> CRSR
                O VOLSER/DATASET        |    They will be expired automatically  |ON   STATUS
                E RKL006         <----- |    IMMEDIATE EXPIRATION  N (Y/N)       |     Active
                AFILE                |    CONFIRM                 (Y/N)       |03   Active
                AFILE                +----------------------------------------+03   Active
                RKL007                                                               Active
                AFILE                                         01/01/00   CYCL 003   Active
                AFILE                                         **/**/**   CYCL 003   Active
                VER001                                                    06/06/00   Pend-Scr
                ACC.RS.TE.FF.ACC18.A.RCC70V00                 01/01/00   06/06/00   Pend-Scr
                VER003                                                    12/12/00   Active
                ACC.YEARND.MOVE.TSSBAC.FILECHK.KEE23V00       01/01/00   12/12/00   Active
                VER005                                                    08/08/00   Vaulted
                ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005       01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0559V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0558V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0557V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0556V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0555V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0554V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0553V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0552V00               01/01/00   08/08/00   Active
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           17.10.06

Fill in the window as follows:

Table 94 Fields of the Expire Volume Window

Expiring a Data Set

When specifying Option E for a data set, the following window is opened:

Figure 74 Expire Dataset Window

  DATABASE LIST < B / VD > --------------------------------------------------(TI)
                COMMAND ===>                                                    SCROLL===> CRSR
                COMMAND ===>                                                    SCROLL===> CRSR
                O VOLSER/DATASET        +------------------------------+    RETENTION  STATUS
                RKL006                |   IMMED EXPIRATION  N (Y/N)  |               Active
                E  AFILE         <----- |            CONFIRM    (Y/N)  |4   CYCL 003   Active
                AFILE                +------------------------------+4   CYCL 003   Active
                RKL007                                                               Active
                AFILE                                         01/01/00   CYCL 003   Active
                AFILE                                         **/**/**   CYCL 003   Active
                VER001                                                    06/06/00   Pend-Scr
                ACC.RS.TE.FF.ACC18.A.RCC70V00                 01/01/00   06/06/00   Pend-Scr
                VER003                                                    12/12/00   Active
                ACC.YEARND.MOVE.TSSBAC.FILECHK.KEE23V00       01/01/00   12/12/00   Active
                VER005                                                    08/08/00   Vaulted
                ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005       01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0559V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0558V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0557V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0556V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0555V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0554V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0553V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0552V00               01/01/00   08/08/00   Active
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           17.10.06

Fill in the window as follows:

Table 95 Fields of the Expire Dataset Window

Extending the Retention Period of Data Sets and Volumes

To extend the retention period of a data set or volume by a number of days, specify option X (Extend). If you want to set an expiration date to a specific date, use the Inquiry/Update entry panel. For more information about the Inquiry/Update panel, see Inquiries and Updates.

Active Data Sets and Volumes

An active data set or volume is one whose Status is either Active or Pending Scratch. When you extend the retention period of an active data set or volume, Control-M/Tape treats specific and non-specific expiration dates differently.

Specific Expiration Dates

The following applies to an active data set and volume that have specific expiration dates.

When you extend the retention period of a data set, Control-M/Tape compares the volume’s expiration date to the new expiration date of the data set. If the volume expiration date is earlier, Control-M/Tape sets the volume expiration date to that of the data set.

Extending the Retention Period of Data Sets

When you extend the retention period of an active volume that has a specific expiration date, Control-M/Tape:

• Adds the number of days that you specify to the retention period of all active data sets on the volume, and changes statuses of Pending Scratch to Active.

• Leaves scratched data sets unchanged.

If the volume’s status is Pending Scratch, Control-M/Tape changes the status to Active.

This makes extending the retention period of a volume a convenient way to extend the retention period of all active data sets on the volume.

Extending the Retention Period of Volumes

You can extend the retention period of an active external volume just as you would a regular volume. In addition, you can extend the retention period of an external volume that has no data sets.

Non-specific Expiration Dates

You cannot extend the retention period of a data set whose expiration date is non-specific.

If an active volume with a non-specific expiration date contains any data sets with specific expiration dates, you can use the Extend option on the volume. In this case, Control-M/Tape:

Adds the number of days that you specify to the expiration dates of active data sets that have specific expiration dates, and changes any Pending Scratch statuses to Active.

• Does not modify data sets with non-specific expiration dates.

• Does not modify scratch data sets.

• Does not modify the volume’s expiration date; it remains non-specific.

Scratch Data Sets and Volumes

When you use the Extend option on a scratch data set on a scratch volume, Control-M/Tape modifies all data sets and volumes in the chain. In this case, Control-M/Tape unscratches all data sets and volumes and sets their retention periods to the current date plus the number of days that you specify.

Similarly, when you use the Extend option on a scratch volume, Control-M/Tape unscratches all data sets and volumes in the chain, and sets their retention periods to the current date plus the number of days that you specify.

You can use the Extend option on an external scratch volume just as you would on a regular scratch volume.

To directly extend a volume’s expiration date, specify option X on that volume’s record.

Specifying option X for either a volume or a data set record opens up the following window:

Figure 75 Extending the Retention Period of Data Sets and Volumes (Option X) Confirmation Window

  DATABASE LIST < B / VD > --------------------------------------------------(TI)
                COMMAND ===>            +---------------------------------+     SCROLL===> CRSR
                O VOLSER/DATASET        |    Extend retention data        | ETENTION   STATUS
                RKL006                |    NUMBER OF DAYS:  0000        |            Active
                X  AFILE         <----- |    CONFIRM               (Y/N)  | CYCL 003   Active
                AFILE                +---------------------------------+ CYCL 003   Active
                RKL007                                                               Active
                AFILE                                         01/01/00   CYCL 003   Active
                AFILE                                         **/**/**   CYCL 003   Active
                VER001                                                    06/06/00   Pend-Scr
                ACC.RS.TE.FF.ACC18.A.RCC70V00                 01/01/00   06/06/00   Pend-Scr
                VER003                                                    12/12/00   Active
                ACC.YEARND.MOVE.TSSBAC.FILECHK.KEE23V00       01/01/00   12/12/00   Active
                VER005                                                    12/12/00   Vaulted
                ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005       01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0559V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0558V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0557V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0556V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0555V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0554V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0553V00               01/01/00   12/12/00   Active
                ACC.YEARND.BAL.AX.RASD.G0552V00               01/01/00   12/12/00   Active
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           17.10.06

Fill in the confirmation window as follows and press Enter.

Table 96 Fields of the Option Extend (X) Confirmation Window

Checking Out Volumes for Borrowing

Option O enables you to check out the specified volumes for borrowing. Specifying this option opens the Check Out confirmation window.

Figure 76 Checking Out Volumes for Borrowing (Option O) Confirmation Window

  DATABASE LIST <         +---------------------------------+----------------(TI)
                COMMAND ===>            | OUT LOCATION:          GROUP   (Y/N)  |==> CRSR
                O VOLSER/DATASET        | RETURN  DATE:                         |N  STATUS
                O RKL006         <----- | CONFIRM           (Y/N)               |      Active
                AFILE                +---------------------------------------+003   Active
                AFILE                                         01/01/00   CYCL 003   Active
                RKL007                                                               Active
                AFILE                                         01/01/00   CYCL 003   Active
                AFILE                                         **/**/**   CYCL 003   Active
                VER001                                                    06/06/00   Pend-Scr
                ACC.RS.TE.FF.ACC18.A.RCC70V00                 01/01/00   06/06/00   Pend-Scr
                VER003                                                    12/12/00   Active
                ACC.YEARND.MOVE.TSSBAC.FILECHK.KEE23V00       01/01/00   12/12/00   Active
                VER005                                                    08/08/00   Vaulted
                ACC.YEARND.BAL.AX.RSSN.V3322276.BAT3005       01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0559V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0558V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0557V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0556V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0555V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0554V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0553V00               01/01/00   08/08/00   Active
                ACC.YEARND.BAL.AX.RASD.G0552V00               01/01/00   08/08/00   Active
            USE OPT COMMAND TO DISPLAY/HIDE OPTION LIST                           17.10.06