Previous Topic: 2.18.1 Usage GuidelinesNext Topic: 2.18.3 Standard Output


2.18.2 Control Parameters

Relatively few parameters are needed to implement the Tape
Data Set Resource Planning Sample Application. The control
screens included in the online facility let you quickly enter
the required information.
/---------------------------  Tape Data Set Planning  --------------------------\
|Command ===>                                                                   |
|                                                                               |
|Composing CAP DB File def.:  TLM - Physical Tape Data Set vs Virtual           |
|Summarization Level                                                            |
|          Primary                ===> MONTHS  (DAYS/WEEKS/MONTHS)              |
|          Secondary              ===> ZONE    (ZONE/HOUR/DAYNAME)              |
|                                                                               |
|Input File Timespan              ===> MONTHS  (DETAIL/DAYS/WEEKS/MONTHS)       |
|                                                                               |
|Amount of data retained          ===> 60      (1-9999 months)                  |
|Age of oldest forecast           ===> 24      (1-9999 months)                  |
|History cycles                   ===> 3       (1-99 cycles)                    |
|Forecast cycles                  ===> 3       (1-99 cycles)                    |
|Database ID (s)                  ===> T                                        |
|                                                                               |
|    First Application Unit (CAPAPU ) ===> TAPELIB  ( Use Extended Options )    |
|   Second Application Unit (CAPAPU2) ===> VOLGROUP ( to re-define CAPAPUs )    |
|                                                                               |
|Specify extended options         ===> N       (Y/N)  ** Specified **           |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-18.01.  Tape Data Set Planning Screen

Figure 2-18.01 shows the Tape Data Set Planning screen, which
is the main control screen for this sample application.  It
contains the following fields:
 
Summariza-   The output summarization corresponds to the
tion level:  combination of the primary and secondary
             summarization levels.  These control how the
             output file is summarized in your capacity
             planning database.

Input file   The timespan (either DETAIL, DAYS, WEEKS or
timespan:    MONTHS) of the AUMGPR and AUMAPP files that you
             want to use as input when creating the capacity
             planning database file.

Amount of    The number of days, weeks, or months of
data         historical data to be retained in the CAPxxx01
retained:    cycle of the capacity planning database file.
             Any historical observations older than what you
             specify for this parameter are dropped from the
             file during the file update.

Age of       The number of days, weeks, or months that you
oldest       want to retain a forecast after it is generated.
forecast:    Any forecast older than what you specify for
             this parameter is dropped when a new forecast is
             generated and saved.

History      Number of cycles or versions of the historical
cycle:       data you want to retain.  A new cycle is created
             when the file is updated and the existing cycles
             aged (for example, Cycle 01 is aged to Cycle 02
             and Cycle 02 becomes Cycle 03).

Forecast     Number of cycles or versions of the forecast
cycle:       data you want to retain.  A new cycle is created
             when you specify forecast aging in one of the
             workload forecasting routines and the existing
             cycles are aged (for example, Cycle 01 is aged
             to Cycle 02 and Cycle 02 becomes Cycle 03).

Database     The database unit identifiers (up to 14 units)
ID(s):       that contain the TMCTMD file to be used with
             this sample application. If you are not sure
             where the TMCTMD file resides, type a question
             mark (?) in this field to display a listing of
             the valid database unit identifiers for this
             sample application.

Specify      If you want extended options, specify Y (YES),
extended     and the Extended Options Menu (Figure 2-17.02)
options:     is displayed.
/---------------------------  Extended Options Menu  -------------------------\
|Command ===>                                                                 |
|                                                                             |
|Inquiry Step:  Tape Data Set Planning                                        |
|                                                                             |
|                                                                             |
|Combine all zones into a composite  ===> Y         (Y/N)                     |
|   Composite zone                   ===> A                                   |
|                                                                             |
|Specify:                                                                     |
|   Common data selection parameters ===> N         (Y/N/R)                   |
|   Global data selection exit       ===> N         (Y/N/R)                   |
|   CAPAPU derivation SAS statements ===> N         (Y/N/R)                   |
|   Notes report enabled             ===> YES       (YES/NO)                  |
|   Contents reports enabled         ===> YES       (YES/NO)                  |
|                                                                             |
\------------------------------------------------------------------------------/

 Figure 2-18.02.  Tape Data Set Planning Extended Options            Menu

The extended options available with the Tape Data Set
Resource Planning Sample Application (Figure 2-18.02) are the
following:
 
Combine all  You can combine zones, hours, and days in the
zones/hours/ capacity planning database file.  The prompt for
daynames     this field changes to zones, hours, or days,
into a       depending on what you specify for the summary-
composite:   level parameter.  Enter Y (YES) if you want all
             of the zones, hours, and days to be summarized
             into a single observation with the composite
             value. By default this option is set to Y.

Specify      Specify the SYSIDs and zones, hours or days to
common data  be used for data selection from the CA MICS
selection    input files. Enter Y (YES) to display the
parameters:  Common Data Selection screen (Figure 2-17.03).
             Enter R (RESET) to reset any selections you
             previously made to SYSID and ZONE, HOUR, or
             DAYNAME.

Specify      You can use your own SAS statements to select
global data  data from the CA MICS input files.  Enter Y
selection    (YES) to display the SAS System Statements
exit:        screen (Figure 2-17.04).  Enter R (RESET) to
             reset any selections you previously made to the
             default of no user-specified data selection.

Specify      You can use your own SAS statements for defining
CAPAPU       your application units. Enter Y (YES) to display
derivation   the SAS System Statements screen.  Enter R
SAS          (RESET) to reset any SAS System Statements you
statements:  previously made to a user-specified workload
             grouping.

Notes        A YES in this field prints any notes associated
report       with the capacity planning file definition as
enabled:     part of file updating.

Contents     A YES in this field prints the contents of the
reports      capacity planning file as part of file updating.
enabled:

/---------------------------  Common Data Selection  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  Workload Planning Sample Application                            |
|                                                                               |
|                                                                               |
|SYSID ===> ____ ____ ____ ____ ____ ____ ____ ____ ____ ____                   |
|           ____ ____ ____ ____ ____                                            |
|                                                                               |
|Zone  ===> _ _ _ _ _ _ _ _ _                                        (1 - 9)    |
|                                                                               |
|Hour  ===> __ - __   __ - __   __ - __   __ - __   __ - __          (0 - 23)   |
|                                                                               |
|Dayname===> _________ _________ _________ _________ _________                  |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-18.03.  Common Data Selection Screen - Tape Data Set Planning

The Common Data Selection screen (Figure 2-17.03) lets you
define the following data selection criteria:
 
SYSID:       The SYSIDs that you want to include in your
             capacity planning database file.  You can
             specify a maximum of 15 one to four-character
             SYSIDs.  Leave this parameter blank to include
             data for all SYSIDs.

Zone:        Specify up to nine zones to include in the
             capacity planning database file.  Leave this
             parameter blank to include data for all zones.

Hour:        Specify the five hours or hour ranges to include
             in the capacity planning database file.
             Selection of this parameter is valid only if you
             specify the DETAIL, DAYS, or WEEKS timespan on
             the Tape Data Set Resource screen (Figure
             2-18.01).  Leave this parameter blank to include
             data for all hours.

Dayname:     Specify up to five days to be included in
             the capacity planning database file.  Leave this
             parameter blank to include all days.  Input the
             first unique characters and the application will
             fill in the rest. This parameter is only valid
             when the input timespan is DETAIL or DAYS.
/--------------------------  SAS System Statements  ---------- COLUMNS 001 072--\
|Command ===>                                                  Scroll ===> PAGE |
|                                                                               |
|SAS Statements for the SELECT Macro                                            |
|-------------------------------------------------------------------------------|
|****** ***************************** TOP OF DATA ******************************|
|==MSG> SPECIFY SAS STATEMENTS TO SUBSET THE CAPACITY PLANNING DATA BASE FILE.  |
|=NOTE= %MACRO SELECT; <=== PLEASE DO NOT PLACE LINES BEFORE THIS LINE.         |
|000001                                                                         |
|000002                                                                         |
|000003                                                                         |
|000004                                                                         |
|000005                                                                         |
|000006                                                                         |
|000007                                                                         |
|000008                                                                         |
|000009                                                                         |
|000010                                                                         |
|=NOTE= %MEND SELECT; <=== PLEASE DO NOT PLACE LINES AFTER THIS LINE.           |
|****** **************************** BOTTOM OF DATA ****************************|
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-18.04.  SAS System Statements Screen - Tape Data Set Planning Global Data

The SAS System Statements screen (Figure 2-17.04) lets you
define your own data selection logic.  You can code any valid
SAS statements as described in the SAS manuals.  The %MACRO
SELECT and %MEND SELECT statements are already provided and
are field-protected to prevent modification.
 
Note:  This is a PDF/EDIT screen.  All the PDF/EDIT commands
are available.