Previous Topic: 2.9.1 Usage GuidelinesNext Topic: 2.9.3 Standard Output


2.9.2 Control Parameters

 
You need relatively few parameters to implement the CICS
Resource Planning Sample Application.  The control screens
included on the online facility allow you to quickly enter
the information required.
/---------------------------  CICS Resource Planning  --------------------------\
|Command ===>                                                                   |
|Enter a ? in any data entry field for more information on valid values.        |
|Composing CAP DB File def.:  CIC - CICS Resource 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)         ===> ___________________________                      |
|                                                                               |
|CICS workload definition (CAPAPU) ===> CICSID (CICSID/NONE/EXIT)               |
|           Application unit title ===> ________________________________________|
|                                                                               |
|                                                                               |
|                                                                               |
|Specify extended options ===> N (Y/N)                                          |
\------------------------------------------------------------------------------/

 Figure 2-9.01.  CICS Planning Screen

Figure 2-9.01 shows the CICS Planning screen, which is the
main control screen for the CICS 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 CICCSU 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      The number of cycles or versions of the
cycles:      historical data that you want to retain.  A new
             cycle is created when the file is updated and
             the existing cycles are aged (for example, Cycle
             01 becomes Cycle 02 and Cycle 02 becomes Cycle
             03).

Forecast     The number of cycles or versions of the forecast
cycles:      data that 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
             becomes Cycle 02 and Cycle 02 becomes Cycle 03).

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

CICS         The three options for defining workload groups
workload     (see Section 2.9.1, Usage Guidelines).
definition
(CAPAPU):

Application  The 1- to 40-character long name for the CAPAPU
unit title:  data element.  You can use this parameter to
             provide a level of documentation for the manner
             in which your workload groupings have been
             defined.  This parameter is only available if
             you specify EXIT for the CICS workload
             definition (CAPAPU) parameter.

Specify      If you want extended options, specify Y (YES),
extended     and the Extended Options Menu shown in Figure
options:     2-9.02 is displayed.

/---------------------------  Extended Options Menu  ---------------------------\
|Command ===>                                                                   |
|                                                                               |
|Inquiry Step:  CICS 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)                     |
|   CAPAPU derivation SAS statements ===> N         (Y/N/R)                     |
|   Notes report enabled             ===> YES       (YES/NO)                    |
|   Contents reports enabled         ===> YES       (YES/NO)                    |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-9.02.  Extended Options Menu - CICS Planning

Seven extended options are available with the CICS Resource
Planning Sample Application, as shown in Figure 2-9.02.
These options are described next.
 
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 the
zones/hours/ capacity planning database file.  The prompt for
daynames     this field changes to zones, hours or daynames
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 daynames to be
             summarized into a single observation with the
             composite value.  Figure 2-9.03 illustrates
             specifying zones, hours, and daynames for
             inclusion in the database.

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-9.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 the SAS System Statements
exit:        screen shown in Figure 2-9.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 CICS workloads.  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.  This option is available only if you
             specify EXIT for the CICS workload definition
             (CAPAPU) parameter on the CICS Planning screen.

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:  CICS Resource Planning Sample Application                       |
|                                                                               |
|                                                                               |
|SYSID ===> ____ ____ ____ ____ ____ ____ ____ ____ ____ ____                   |
|           ____ ____ ____ ____ ____                                            |
|                                                                               |
|Zone  ===> 1 _ _ _ _ _ _ _ _                                        (1 - 9)    |
|                                                                               |
|Hour  ===> __ - __   __ - __   __ - __   __ - __   __ - __          (0 - 23)   |
|                                                                               |
|Dayname===> _________ _________ _________ _________ _________                  |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
|                                                                               |
\------------------------------------------------------------------------------/

 Figure 2-9.03.  Common Data Selection Screen - CICS Planning

The Common Data Selection screen 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 enter 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 CICS Planning screen shown in Figure 2-9.01.
             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.  Leave
             blank to include all days.  Input the first
             unique characters and the capacity planner 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 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-9.04.  SAS System Statements Screen - CICS Planning Global Data Select on

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