Previous Topic: 2.16.1 Usage GuidelinesNext Topic: 2.16.3 Standard Output


2.16.2 Control Parameters

 
You need relatively few parameters to implement the VAX/VMS
CPU Resource Planning Sample Application. The control screens
included in the online facility allow you to quickly enter
the information required.
/-------------------------  VAX/VMS CPU Resource Planning ----------------------\
|Command ===>                                                                   |
|Enter a ? in any data entry field for more information on valid values.        |
|Composing CAP DB File def.:  VAU - VAX/VMS Planning Sample Application         |
|                                                                               |
|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-16.01   VAX/VMS CPU Planning Control Screen

Figure 2-16.01 shows the VAX/VMS CPU Planning screen, which
is the main control screen for the VAX/VMS CPU Resource
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 DEMMOD and DEMSPR files used as
             as input to 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
cycles:      data you want to retain.  A new cycle is created
             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
cycles:      data you wish 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 14 units)
ID(s):       that contain the DEMMOD and DEMSPR files to be
             used with this sample application. If you are
             not sure where the DEMMOD and DEMSPR 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, specify Y (YES),
Extended     and the Extended Options Menu shown in Figure
Options:     2-16.02 is displayed.
/---------------------------  Extended Options Menu  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  VAX/VMS CPU Resource 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)                     |
|   CPU time adjustment parameters   ===> Y         (Y/N/R)                     |
|   Notes report enabled             ===> YES       (YES/NO)                    |
|   Contents reports enabled         ===> YES       (YES/NO)                    |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-16.02.  VAX/VMS CPU Planning Extended Options Menu

The extended options available with the VAX/VMS CPU
Planning Sample Application 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 shown in Figure
             2-16.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 file(s).  Enter Y
selection    (YES) to display SAS System Statements screen
exit:        shown in Figure 2-16.04.  Enter R (RESET) to
             reset any selections you previously made to the
             default of no user-specified data selection.

Specify CPU  Specify the parameters to use for CPU time
time         adjustment (normalization), if you desire this
adjustment   optional feature.  Enter Y (YES) to display the
parameters:  CPU Time Adjustment Parameters screen shown in
             Figure 2-16.05.  Enter R (RESET) to reset any
             selections you previously made to CPU time
             adjustment.
 
             This option is not available if you specify the
             composite SYSID option on this screen shown in
             Figure 2-16.02.

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 planning file as part of file updating.
enabled:
/---------------------------  Common Data Selection  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  VAX/VMS Planning Sample Application                             |
|                                                                               |
|                                                                               |
|SYSID ===> ____ ____ ____ ____ ____ ____ ____ ____ ____ ____                   |
|           ____ ____ ____ ____ ____                                            |
|                                                                               |
|Zone  ===> _ _ _ _ _ _ _ _ _                                        (1 - 9)    |
|                                                                               |
|Hour  ===> __ - __   __ - __   __ - __   __ - __   __ - __          (0 - 23)   |
|                                                                               |
|Dayname===> _________ _________ _________ _________ _________                  |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-16.03.  Common Data Selection Screen - VAX/VMS CPU Planning

The Common Data Selection screen shown in Figure 2-16.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:        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.  This
             parameter is valid only if you specify the
             DETAIL, DAYS, or WEEKS timespan on the VAX/VMS
             CPU Planning screen shown in Figure 2-16.01
             Leave this parameter blank to include data for
             all hours.

Dayname:     Specify up to five daynames to include 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-16.04.  SAS System Statements Screen - VAX/VMS CPU Planning Global Data Selection

The SAS System Statements screen shown in Figure 2-16.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.
/-----------------------  CPU Time Adjustment Parameters  ----------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry step:  VAX/VMS CPU Resource Planning Sample Application                |
|                                                                               |
|                                                                               |
|Base CPU model                         ===> VAX-8350____                       |
|Base CPU VUP rating                    ===> 2.3___                             |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-16.05.  CPU Time Adjustment Parameters Screen

The information on the CPU Time Adjustment Parameters screen
shown in Figure 2-16.05 is required only if you choose CPU
time normalization for the VAX/VMS CPU Resource Planning
Sample Application.
 
Base CPU     The 10-character identifier for the base VAX
model:       system.   Any name is acceptable in this field.
             Do not use embedded blanks or equal signs (=) in
             this value.  For example, if you want to
             normalize your actual CPU time values to the
             equivalent of a VAX 8350, then type VAX-8350 in
             this field.

Base CPU     The relative performance (VUP) rating for the
VUP rating:  base processor. The value must be a real number
             greater than 0 (zero).  You can use
             vendor-supplied values for the factor, or use a
             factor based on your own evaluations. For
             example, if you specify a VAX-8350 as the base
             CPU model, then type 2.3 in this field.