IV90312: DISTRIBUTION QUEUE SITUATION OR REPORT FAILS WITH CNB7007 ERROR

IBM Tivoli Monitoring : IBM i OS Agent 6.3.0.5-TIV-ITM_IBMi-IF0002
IBM Tivoli Monitoring 6.3.0 Fix Pack 7 (6.3.0-TIV-ITM-FP0007)

APAR status

• Closed as program error.

Error description

• Distribution queue situation or report fails with CNB7007 error
  message. The error does not occur immediately after starting
  the agent. Instead, the error occurs after the agent has been
  running for long time (i.e. several days or weeks) depending on
  the situation interval.
  

Local fix

• Restart the agent.
  

Problem summary

• Distribution queue or history log situations or reports fail
  with CNB7007 error message and the agent job log contains a
  CPF4167 which indicates that the job cannot create any more
  spool files.  The error does not occur immediately after
  starting the agent.  Instead, the error occurs after the agent
  has been running for long time (i.e.  several days or weeks).
  
  In order for this APAR to be properly implemented in your
  environment, a new environment variable.  See the "Install
  Actions" section of the APAR conclusion for more details.
  

Problem conclusion

• The distribution queue and history log monitoring code use
  system commands which generate spool file output.  There is a
  maximum spool file limit associated with each job.  This limit
  is specified using the QMAXSPLF system value. When this limit is
   reached, no further spool files can be created and a CNB7007
  error messge is sent.
  
  Install Actions:
  ----------------
  A new environment variable, KA4_MAXSPLF, has been added to make
  use of a special job level maximum spool file limit which
  overrides the QMAXSPLF system value. This new environment
  variable is available beginning in IBM i 7.1.
  
  The KA4_MAXSPLF environment variable is set in QAUTOTMP/KMSPARM.
  The supported range is between 1000 and 999999.  It can be set
  higher or lower than the QMAXSPLF system value.
  
  For example, set the KA4_MAXSPLF environment variable by adding
  the following line to
  QAUTOTMP/KMSPARM:
  
   KA4_MAXSPLF=99999
  
  The following IBM i PTF's are prerequisites for IBM i 7.1 and
  IBM i 7.2:
  IBM i 7.1 - PTF SI54499, included in cumulative PTF level
  C5317710
  IBM i 7.2 - PTF SI55214, included in cumulative PTF level
  C6127720
  
  For agents running on IBM i 6.1 or earlier, using the
  KA4_MAXSPLF variable will have no effect.  See the circumvention
  section below for alternative work arounds.
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.3.0-TIV-ITM-FP0007
  

Temporary fix

• 1.  Restart the agent periodically.  This will reset the spool
  file count.
  2.  Increase the situation interval.  This will extend the time
  before receiving
  a CNB7007 error message.
  3.  Increase the QMAXSPLF system value.  This will extend the
  time before receiving
  a CNB7007 error message.  Note: Changing this system value will
  apply to all jobs
  on the system.
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  ITM AGENT ISERI

• Fixed component ID

  5724C04A4

Applicable component levels