MODIFY PFA, UPDATE

Purpose

Use the MODIFY pfa,UPDATE (f pfa,update) command to read configuration files that an individual check supports and store the values for future PFA processing.

You must use the MODIFY pfa,update command before changes made to check-specific configuration files are used by PFA processing.

Format

UPDATE
{
[CHECKS [,filters] [,ALL] [,EXCLUDED_JOBS]] [,INCLUDED_JOBS]]
|
[filters [,ALL] [,EXCLUDED_JOBS] [,INCLUDED_JOBS]]
}

Parameters

CHECKS
CHECKS reads the configuration file requested for every check that supports that configuration file. This parameter is optional.
filters
Filters specify which check or checks you want to take an action against. This parameter is optional. You can specify the wildcard character * for filters in the last position of the filter. An asterisk (*) represents any string having a length of zero or more characters.
Filters must be specified in one of the following formats: 
CHECKS,CHECK=(check_name)
or
CHECK(check_name)
check_name specifies the 1- through 32-character check name.
ALL
PFA reads the EXCLUDED_JOBS and INCLUDED_JOBS files and updates its internal configuration to use the values in these files. See the Restriction: under INCLUDED_JOBS

You can optionally add exclusions and inclusions. For details, see Configure supervised learning.

EXCLUDED_JOBS
PFA reads the EXCLUDED_JOBS file and updates its internal configuration to use the values in this file. You can optionally add exclusions. For details, see Configure supervised learning.
INCLUDED_JOBS
PFA reads the INCLUDED_JOBS file and updates its internal configuration to use the values in this file. You can optionally add inclusions. For details, see Configure supervised learning.
Restriction: The following checks do not support dynamically updating INCLUDED_JOBS. For these checks, the INCLUDED_JOBS file must contain the address spaces you want to include when you start PFA. If you want to change the INCLUDED_JOBS file after PFA is started, you must stop PFA, update the file, and then restart PFA.
  • PFA_ENQUEUE_REQUEST_RATE
  • PFA_MESSAGE_ARRIVAL_RATE
  • PFA_SMF_ARRIVAL_RATE

Defaults

  • CHECKS – all checks are updated.
  • ALL – is the default value.

Processing

For each check specified that supports EXCLUDED_JOBS or INCLUDED_JOBS, the EXCLUDED_JOBS file and the INCLUDED_JOBS file (if either or both exist for the check) is read from the checks’ /config directory and stored in memory for the PFA address space to use in its processing.

Usage

Use this command when PFA configuration needs to be updated, but the update is not a part of the IBM® Health Checker for z/OS® configuration and parameters.

Restrictions

None.

Authorization

The user running the MODIFY PFA,UPDATE command must be authorized to read the EXCLUDED_JOBS file and/or the INCLUDED_JOBS file for the check.

Flags

None.

Error conditions

None.

Messages

  • AIR024I
  • AIR025I
  • AIR027I
  • AIR028I
  • AIR029I
  • AIR030I
  • AIR031I
  • AIR059I
  • AIR060I
  • AIR061I
  • AIR062I

For the complete message text, see the topic on AIR messages in z/OS MVS System Messages, Vol 1 (ABA-AOM).

Version

All releases beginning with z/OS V1R12. Updated to support INCLUDED_JOBS in z/OS V2R2.

Examples

  • f pfa,update or f pfa,update,ALL
    • Reads the EXCLUDED_JOBS file (if it exists) and the INCLUDED_JOBS file (if it exists) for every check that supports it and stores the new values to use for future processing.
  • f pfa,update,checks,EXCLUDED_JOBS
    • Reads the EXCLUDED_JOBS file (if it exists) for every check that supports it and stores the new values to use for future processing.
  • f pfa,update,checks,INCLUDED_JOBS
    • Reads the INCLUDED_JOBS file (if it exists) for every check that supports it and stores the new values to use for future processing.
  • f pfa,update,check(pfa_j*)
    • Reads the EXCLUDED_JOBS file (if it exists) and the INCLUDED_JOBS file (if it exists) for every check that starts with “pfa_m” and that supports it and stores the new values to use for future processing.
  • f pfa,update,check(pfa_j*),EXCLUDED_JOBS
    • Reads the EXCLUDED_JOBS file (if it exists) for every check that starts with “pfa_m” and that supports it and stores the new values to use for future processing.
  • f pfa,update,check(pfa_j*),INCLUDED_JOBS
    • Reads the INCLUDED_JOBS file (if it exists) for every check that starts with “pfa_m” and that supports it and stores the new values to use for future processing.

Context

  • Load module: AIRAMPVT
  • Entry Point: AIRA1INI