Previous Topic: 2.13.1 Usage GuidelinesNext Topic: 2.13.3 Standard Output


2.13.2 Control Parameters

Relatively few parameters are needed to implement the WEB
Server Resource Planning Sample Application. The control
screens included in the online facility allow you to quickly
enter the required information.
/--------------------------- WEB Server Resource Planning -------------------------------\
|Command ===>                                                                   |
|Enter a ? in any data entry field for more information on valid values.        |
|Composing CAP DB File def.:WS1-WEB Server Resource Planning Sample Application |
|                                                                               |
|Summarization Level                                                            |
|          Primary                 ===> MONTHS  (DAYS/WEEKS/MONTHS)             |
|          Secondary               ===> ZONE    (ZONE/HOUR/DAYNAME)             |
|                                                                               |
|Input File Time-Span              ===> 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)                   ===> ___________________________             |
|                                                                               |
|WEB Server Workload Definition (CAPAPU) ===> WEBNAME (WEBNAME/NONE/EXIT)       |
|          Application unit title ===> ___________________________________      |
|                                                                               |
|Specify extended options          ===> N       (Y/N)                           |
\------------------------------------------------------------------------------/

 Figure 2-13.01.  WEB Server Planning Screen

Figure 2-13.01 shows the WEB Server Planning screen. This is
the main control screen for the WEB Server Resource Planning
Sample Application, and 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 WEBWPR 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 retain in the CAPxxx01 cycle
retained:    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      The number of cycles or versions of the
cycle:       historical 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     The 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 14 units)
ID(s):       that contain the WEBWPR file used with this
             sample application.  If you are not sure where
             the WEBWPR file resides, type a question mark
             (?) in this field to display a listing of the
             valid database unit identifiers for this sample
             application.

WEB Server   The three options for defining workload groups
Workload     (see section 2.13.1, Usage Guidelines).
Definition
(CAPAPU):

Application  The 1- to 40-character name for the CAPAPU data
unit title:  element.  You can use this parameter to describe
             your workload groupings.  This parameter is only
             available if you specify EXIT for the WEB Server
             workload definition (CAPAPU) parameter.

Specify      If you want extended options, specify Y (YES),
extended     and the Extended Options Menu (Figure 2-13.02)
options:     appears.

/---------------------------  Extended Options Menu  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  WEB Server 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 ===> 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-13.02.  WEB Server Planning Extended Options Menu

The extended options available with the WEB Server Resource
Planning Sample Application (Figure 2-13.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
             summarized into a single observation with the
             composite value.

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

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

Specify      You can specify your own SAS statements for
CAPAPU       defining your WEB Server workloads.  Enter Y
derivation   (YES) to display the SAS System Statements
SAS          screen.  Enter R (RESET) to reset any SAS System
statements:  Statements you previously made to a
             user-specified workload grouping. This option is
             available only if you specify EXIT for the WEB
             Server Workload Definition (CAPAPU) parameter on
             the WEB Server Planning screen.

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

Contents     A Yes in this field prints the contents of the
reports      capacity planning database file as part of file
enabled:     updating.
/---------------------------  Common Data Selection  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  WEB Server Resource Planning Sample Application                 |
|                                                                               |
|                                                                               |
|SYSID ===> ____ ____ ____ ____ ____ ____ ____ ____ ____ ____                   |
|           ____ ____ ____ ____ ____                                            |
|                                                                               |
|Zone  ===> _ _ _ _ _ _ _ _ _                                        (1 - 9)    |
|                                                                               |
|Hour  ===> __ - __   __ - __   __ - __   __ - __   __ - __          (0 - 23)   |
|                                                                               |
|Dayname===> _________ _________ _________ _________ _________                  |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-13.03.  Common Data Selection Screen - WEB Server Planning

The Common Data Selection screen (Figure 2-13.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 be included 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 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 WEB Server Planning (Figure 2-13.03).  Leave
             this parameter blank to include data for all
             hours.

Dayname:     Specify up to five daynames to be included in
             the capacity planning database file.  To include
             all days, leave this field blank.  Input the
             first unique characters and the application will
             fill in the rest.  Selection 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 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-13.04.  SAS System Statements Screen - WEB Server Planning Global Data

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