Adding EXCLUDE89 commands to a Model Builder Task


You can specify the EXCLUDE89 command in a Model Builder Task, so that certain intervals are excluded from the Peak R4HA calculation for selected MLC products and LPARs.

Error
Warning

When you specify an EXCLUDE89 command in a Model Builder Task, Cost Analyzer ignores all previous EXCLUDE89 commands that were added to the UIE JCL for any other intervals. To maintain the correct cost data in the cost models, all of the previous EXCLUDE89 commands from the UIE JCL must be added to the Model Builder Task.

 

  1. From the Cost Analyzer console, click Administration Tools.
  2. In the Administration Tools window, click Manage Model Builder Tasks.The Manage Model Builder Tasks dialog opens, listing all of the tasks that have been defined:

    GUID-0ADB746E-DEAD-4AB0-BEDF-D74173BE21DD-low.png

    From the dialog, select the Model Builder Task that you want to add an EXCLUDE89 command to, and then click Modify.

    The Modify Model Build Task dialog is displayed as shown in the following figure:

    GUID-D88B99F2-31EE-4B30-9333-7F221D47684F-low.png

  3. Click Advanced Options and then select the EXCLUDE89 Commands tab.The Advanced Options dialog displays as shown in the following figure:

    GUID-2B13570C-F12D-4BE6-8BA2-468675311086-low.png

  4. In the dialog, enter the command as follows:

     EXCLUDE89 CPC=<xxxx> [IMAGE_ID=<lparname>,... | *ALL]
    [PRODUCT_ID=<productid>,...|*ALL]
    START=<yyyy m d h>
    RESUME=<yyyy m d h>
    [ACTIVE=Y|N]

    The following table defines the parameters:

     

    Parameter

    Description

    CPC=XXXX

    (required) CPC serial number

    XXXX can either be the full or partial CPC serial number. The partial CPC serial number is the last four hex digits of the full CPC serial number.

    IMAGE_ID=lparName,... | *ALL

    (optional) One or more LPAR names, separated by commas

    If not specified, the default is *ALL.

    Warning

    Example

    The following examples show valid syntax:

    IMAGE_ID=LPARA,LPARB

    or

    IMAGE_ID=*ALL
    Warning

    Note

    The LPAR name is not the SYSTEM name or the SMFID.

    PRODUCT_ID=productID,...|*ALL

    (optional) One or more IBM product numbers, separated by commas

    The IBM product number is typically a seven-digit number in the format of NNNN-XXX. If not specified, the default is *ALL.

    Warning

    Example

    For z/OS Version 1, you would enter:

    PRODUCT_ID=5694-A01

    START=yyyy/mm/dd/hh

    (required) Starting date of excluded period

    RESUME=yyyy/mm/dd/hh

    (required) Ending date of the excluded period

    ACTIVE=Y | N

    (optional) Indicates the command is active or should be ignored

    If not specified, the default is Yes.

    This parameter is included for complete compatibility with UIE command syntax.

    Warning

    Note

    The following rules apply to the EXCLUDE89 command:

    • The command syntax for parameters and variables is not case sensitive.
    • For the excluded intervals, Cost Analyzer saves the LPAR activity in the cost model and considers that activity when calculating the Peak R4HA of LPARs or MLC Products that are not specified in the command. All Planning tool plans also take this activity into account. The EXCLUDE89 command affects only baseline cost calculation in the Planning tool.
    • The EXCLUDE command has slightly different syntax rules from the EXCLUDE89 command. If you use EXCLUDE as the command (instead of EXCLUDE89), then you need to put multiple product IDs or LPAR names into parentheses.

      The differences are necessary so that the syntax matches the EXCLUDE command syntax in SCRT.

  5. When finished, click Accept.The Advanced Options dialog closes.
  6. In the Modify Model Build Task dialog, click Modify Task.The EXCLUDE89 command is added to the Model Builder Task.
  7. In the Manage Model Builder Tasks dialog, click Save Changes to save the Model Builder Task to the server.After the next scheduled run of the Model Builder Task, cost data for the specified interval and MLC product will be excluded in the cost models.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Cost Analyzer for zEnterprise 2.3