Previous Topic: 2.7.1 Usage GuidelinesNext Topic: 2.7.3 Standard Output


2.7.2 Control Parameters

 
Relatively few parameters are needed to implement the z/VM
Processor Usage Planning Sample Application. The control
screens included in the online facility allow you to quickly
enter the required information.

/-------------------------  z/VM Processor Usage Planning ----------------------\
|Command ===>                                                                   |
|Enter a ? in any data entry field for more information on valid values.        |
|Composing CAP DB File def.:  ZVM - z/VM Processor Usage Plan. Sample Appl.     |
|                                                                               |
|Summarization Level                                                            |
|          Primary        ===> MONTHS  (DAYS/WEEKS/MONTHS)                      |
|          Secondary      ===> ZONE    (ZONE/HOUR/DAYNAME)                      |
|                                                                               |
|Input File Time-Span     ===> DETAIL  (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)                            |
|                                                                               |
|Data base ID (s)         ===> ___________________________                      |
|                                                                               |
|                                                                               |
|                                                                               |
|Specify extended options ===> Y (Y/N)                                          |
\------------------------------------------------------------------------------/

 Figure 2-7.01.  z/VM Planning Screen
Figure 2-7.01 shows the z/VM Processor Usage Planning screen,
which is the main control screen for the z/VM Processor Usage
Planning 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 VMXSGP File 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 identifier(s) (up to fourteen
ID(s):       units) that contain the VMXSGP File to be used
             with this sample application. If you are not
             sure where the VMXSGP files reside, 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, enter Y (YES), and
Extended     the Extended Options Menu (Figure 2-7.02) is
Options:     displayed.

/---------------------------  Extended Options Menu  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  z/VM Processor Usage Planning Sample Application                |
|                                                                               |
|                                                                               |
|Combine all SYSIDs into a composite ===> N         (Y/N)                       |
|   Composite SYSID                  ===> ____                                  |
|                                                                               |
|Combine all zones into a composite  ===> N         (Y/N)                       |
|   Composite zone                   ===> _________                             |
|                                                                               |
|Specify:                                                                       |
|   Common data selection parameters ===> Y         (Y/N/R)                     |
|   Global data selection exit       ===> Y         (Y/N/R)                     |
|   Notes report enabled             ===> YES       (YES/NO)                    |
|   Contents reports enabled         ===> YES       (YES/NO)                    |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-7.02.  z/VM Planning Extended Options Menu

The extended options available with the z/VM Processor Usage
Planning Sample Application (Figure 2-7.02) are:
 
Combine all  You can combine SYSIDs in the capacity planning
SYSIDs into  database file. Enter Y (YES) if you want data
a composite: for all of the SYSIDs to be summarized into a
             single observation with the Composite SYSID
             value.

Combine all  You can combine zones, hours, and daynames in
zones/hours/ the capacity planning database file. The prompt
daynames     for this field changes to zones, hours or
into a       daynames depending on what you specify for the
composite:   summary level parameter. Enter Y (YES) if you
             want all of the zones, hours, and daynames to be
             summarized into a single observation with the
             composite value.

Specify      Specify the SYSIDs and zones, hours or daynames
common data  to be used for data selection from the CA MICS
selection    input file(s). Enter Y (YES) to display the
parameters:  Common Data Selection screen (Figure 2-7.03).
             Enter R (RESET) to reset any selections you
             previously made to SYSID and zone, hour or
             dayname.

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

Notes        If you have entered notes associated with the
report       capacity planning file definition, a Yes in this
enabled      field prints the note as part of file updating.

Contents     A Yes in this field prints the contents of the
reports:     capacity planner database file as part of file
enabled:     updating.

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

 Figure 2-7.03.  Common Data Selection Screen - z/VM Planning

The Common Data Selection screen (Figure 2-7.03) allows you
to 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:        You can specify up to nine zones to be included
             in the capacity planning database file.  Leave
             this parameter blank to include data for all
             zones.

Hour:        You can specify up to five hours, or hour
             ranges to be included in the capacity planning
             database file. Selection of this parameter
             is valid only if you specify the DETAIL, DAYS,
             or WEEKS timespan on the z/VM Planning screen
             (Figure 2-7.01). Leave this parameter blank to
             include data for all hours. Singular hour
             values must be entered to the left of the dash.

Dayname:     You can specify up to five daynames to be
             included in the capacity planning database file.
             Leave blank to include all days. Input the first
             unique characters and the application will fill
             in the rest. Specification of 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 Processor Usage Planning  |
|=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-7.04. SAS System Statements Screen-z/VM Planning Global Data Selection

The SAS System Statements screen (Figure 2-7.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
field protected from modification.
 
Note:  This is a PDF/EDIT screen. All PDF/EDIT commands are
       available.