PQ14635: A JOB CANNOT BE TRACKED BY THE OPC OS/400 TRACKER IF ITS MESSAGE QUEUE FILLS UP AND NOWRAP IS SPECIFIED FOR JOBMSGQFL.

APAR status

• Closed as documentation error.

Error description

• Add to the section "The submittor task(EQQSUBMIT)" on page 52 of
  the OPC Tracker Agent for OS/400 Installation and Operation
  manual, SH19-4238-00:  The EQQ4JOBD (job description) supplied
  with the QEQQ library defaults to the system value (*SYSVALUE)
  for the JOBMSQFL (job message queue full) parameter.  If the
  system value QJOBMSGQFL is set to NOWRAP, the OS/400 tracker is
  unable to track a job to completion if the job's message queue
  fills up.  The job will stop with an end code of 30, but the OPC
  controller will still show the job as being active.  Consider
  setting the JOBMSGFL parameter in EQQ4JOBD to "WRAP" to avoid
  this problem.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All the OPC customers who use the            *
  *                 OS/400 Tracker.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the job message queue of the       *
  *                      submittor task of the OS/400 Tracker    *
  *                      fills up, the job will end if the job   *
  *                      message queue cannot wrap to the start  *
  *                      of the message queue itself, that is    *
  *                      if the related job description has      *
  *                      the JOBMSQFL (Job message queue full    *
  *                      action) parameter set to *NOWRAP.       *
  *                      In the case of the submittor job        *
  *                      ending, a severity 30 message is        *
  *                      issued, but no information is returned  *
  *                      to the OPC controller, so the OPC       *
  *                      controller will still show the job      *
  *                      as being active.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The OPC Tracker Agent for OS/400 manual, SH19-4485-00,needs
  an update on the Appendix A, in the paragraph reporting a
  technical description of the submittor task.
  This update will inform the customer about a potentially
  erroneous situation that can be generated for the submittor
  task when, for any reason, its job message queue fills up
  without the possibility to wrap to the start of the message
  queue itself.
  Also, the document update will indicate what kind of action
  could be done updating some parameters of the submittor
  job description.
  

Problem conclusion

• - - -
   THE FOLLOWING OPC/ESA PUBLICATIONS WILL BE UPDATED:
                           - - -
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  OPC/ESA OPC Tracker Agent for OS/400                  |
  |        Installation and Operation      SH19-4485-00          |
  |                                                              |
  |PAGE: 54                                                      |
  |APPENDIX A      TOPIC: OS/400 Tracker structure               |
  |PARAGRAPH: The submittor task (EQQSUBMIT)                     |
  |ACTION: ADD the following text at the end of the paragraph    |
  |        as a sub-paragraph titled                             |
  |        "Submittor job message queue considerations"          |
  |Some considerations can be done in relation to the submittor  |
  |job message queue. The submittor task is executed under       |
  |the EQQ4JOBD job description, supplied with the tracker code. |
  |Two parameters of EQQ4JOBD are related to the job message     |
  |queue, the "Job message queue maximum size" (JOBMSGQMX) and   |
  |the "Job message queue full action" (JOBMSGQFL). Both them    |
  |are supplied set to their system values, that are QJOBMSGQMX  |
  |for JOBMSGQMX and QJOBMSGQFL for JOBMSGQFL, so these system   |
  |values are used any time a submittor job is started.          |
  |The system values allow the OS/400 Tracker run fine on a      |
  |large range of situations. Anyway, in some cases, the system  |
  |values could be not the best choice: this is the case of      |
  |a submittor job message queue that fills up frequently or     |
  |fills up without the possibility to wrap to the start of      |
  |the message queue itself. The customer can, in this kind of   |
  |situations, consider to change the JOBMSGQMX and the JOBMSGQFL|
  |parameters in the EQQ4JOBD job description.                   |
  |As first action, the customer can increase as necessary the   |
  |value set for the "Job message queue maximum size" and, if    |
  |he verifies that the job message queue will in any case fill  |
  |up, he will need to set the JOBMSGQFL parameter to the *NOWRAP|
  |value. The <CHGJOBD JOBD(tracker-library/EQQ4JOBD)> OS/400    |
  |command can be used to change the EQQ4JOBD job description.   |
  |The <WRKSYSVAL SYSVAL(system-value-name)> OS/400 command can  |
  |be used to work with the above referred QJOBMSGQMX and        |
  |QJOBMSGQFL job message queue system values.                   |
  +--------------------------------------------------------------+
  

Temporary fix

Comments

APAR Information

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

  PQ14692

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

Fix information

Applicable component levels