EXCLUDE89


Use the EXCLUDE89 command to specify the intervals that should be excluded from the Peak R4HA calculation when BMC AMI Cost Management builds cost models.

When authorized, IBM permits you to use the special Exclude control statement to direct SCRT to exclude the processing of certain data that is reported on in SMF and SCRT89 records. If you have excluded records in your cost data, UIE can implement the EXCLUDE89 command, which has a similar format and performs a similar function when building cost models.

When the EXCLUDE89 command is inserted into the UIE command stream, the corresponding information is written into the VIS file and subsequently stored in the CDB database. During the Model Build process this information is extracted from CDB database and is used to exclude specified intervals from the calculation of Peak R4HA for specified LPARs and MLC products.

You can exclude records for:

  • All LPARs and MLC products
  • A specific list of LPARs and MLC products.

Syntax

EXCLUDE89 CPC=xxxx
     IMAGE_ID=lparName,... | *All
     PRODUCT_ID=productID,...|*ALL
     START=yyyy/mm/dd/hh
     RESUME=yyyy/mm/dd/hh
     ACTIVE=Y|N

Syntax explanation

  • xxxx is the last 4 digits of the CPC serial number.
  • lparName is the LPAR name (not SYSTEM name and not SMFID). A list of comma-separated names can be used. The default value is *ALL
  • productID is the IBM product ID and has the form NNNN-XXX. A list of comma-separated names can be used. The default value is *ALL.
  • Start is the start date and time of the interval to be excluded. The format for this field is yyyy/mm/dd/hh.
  • Resume is the end date and time of the interval to be excluded. The format for this field is yyyy/mm/dd/hh.
  • Active is a value that indicates if the EXCLUDE89 command is active. This is a value of Y or N. The default value is Y.
Warning

Important

It is not possible to delete the EXCLUDE89 command, but it is possible to make it inactive. To do this, you need to insert another EXCLUDE89 command into the UIE JCL with exactly the same parameters, but then specify ACTIVE=N. All inactive EXCLUDE89 commands are ignored by Cost Management.

Rules

  • Parameters CPC, START and RESUME are required.
  • Parameters IMAGE_ID, PRODUCT_ID and ACTIVE are optional. If they are not specified, the default values are used.
  • The EXCLUDE89 command can be repeated any number of times.

Examples

The following example excludes the hours 1000:1100 and 1100:1200 from calculation of Peak R4HA for products 5655-018 and 5697-WSZ on LPARs, LPARA, and LPARB on the CPC with serial number F123:

EXCLUDE89 CPC=F123 IMAGE_ID=LPARA,LPARB
    PRODUCT_ID=5655-018,5697-WSZ
    START=2015/12/02/10
    RESUME=2015/12/02/12
    ACTIVE=Y

The following example excludes the hours 1000:1100 and 1100:1200 from calculation of Peak R4HA for all products on all LPARs on the CPC with serial number FE77:

EXCLUDE89 CPC=FE77 IMAGE_ID=*ALL
    PRODUCT_ID=*ALL
    START=2015/12/02/10
    RESUME=2015/12/02/12
    ACTIVE=Y

 

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

Universal Information Exchange 2.2