PI29467: DFS2610 ISSUED DURING RESTART WHEN THE QFIX PROCESS DISCARDS AN INVALID OUTPUT MESSAGE GENERATED FROM A /DIS STATUS COMMAND.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During a warm start of the system, the QFIX process detects and
  discards the output from a /DIS STATUS command generated much
  earlier, but never dequeued. QFIX discovers that all segments
  generated for STOPPED CLASSes are missing the first-in-segment
  bit MSGX1FST. As a result, the entire message is discarded, the
  3A, 3B, 3C and 3D log records are written, and message DFS2610
  is issued. The command output displays properly so this is only
  a problem if the message is still queued at restart.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users who issue the /DISPLAY STATUS      *
  *                 command.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: The customer got a DFS2610 message      *
  *                      which was issued after restart.  This   *
  *                      message was issued as a result of an    *
  *                      invalid output message generated from   *
  *                      /DISPLAY STATUS command.                *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  During a warm start of the system, the QFIX process detects and
  discards the output from a /DIS STATUS CLASS command generated
  much earlier, but never dequeued.  QFIX process discovers that
  all segments generated for STOPPED CLASSes are missing the
  first-in-segment bit MSGX1FST. As a result, the entire message
  is discarded, the 3A, 3B, 3C and 3D log records are written, and
  message DFS2610 is issued. The command output displays properly
  so this is only a problem if the message is still queued at
  restart.
  
  Additional Keywords: CMDDIS msgDFS2610
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  To address this issue code was added to the following module.
  
  ************
  * DFSIDP10 *
  ************
  
  To fix the reported error of moving in seven bytes of the
  class number into the command output buffer.  The code will now
  move in correct amount for the class of four bytes. When fixing
  this issue a second issue was found where the command output
  buffer was being built with the incorrect number of blanks
  between the resource CLASS and the status word. The DISPLAY
  macro states the resource should be followed by seven blanks.
  Because the code reset register 3 was reset to point to
  an earlier offset in the command output buffer( SPADRWQ )
  and because we moved 7 bytes in for the class number the
  command output buffer had ony two blank characters between
  the resource ( CLASS number )  and status ( STOPPED ).
  
  By moving in only 4 bytes to the command output buffer and
  by ensuring that the status is preceeded in command output
  buffer by seven blanks the output now matches the DISPLAY
  macro.
  
  **********************
  * Publication Change *
  **********************
  
  DOCUMENTATION CHANGE FOR APAR PI29467
  THIS MAINTENANCE IS BEING HELD SO YOU WILL BE
  AWARE OF DOCUMENTATION CHANGE TO MANUAL(S):
  SC19300900
  -
  THE FOLLOWING TEXT DESCRIBES THE DOC CHANGE:
  -
  ===========
  DOC Change:
  ===========
  Commands, Volume 1: IMS Commands A-M
  SC19300900
  
  The command output for the /DISPLAY STATUS CLASS command had an
  invalid offset between the resource ( CLASS ) and the state
  ( STOPPED ).  There should be seven blanks between the resource
  and state.  Please include the new format, which is shown below,
  in the examples section of this manual for the /DISPLAY STATUS
  command section.
  
  Old Format
  
  R 50,/DISPLAY STATUS CLASS
  IEE600I REPLY TO 50 IS;/DISPLAY STATUS CLASS
  DFS000I     **CLASS*****        IMS1
  DFS000I      255  STOPPED   IMS1
  DFS000I     *15306/171349*   IMS1
  51 DFS996I *IMS READY*  IMS1
  
  New Format
  
  R 24,/DISPLAY STATUS CLASS
  IEE600I REPLY TO 24 IS;/DISPLAY STATUS CLASS
  DFS000I     **CLASS*****        IMS1
  DFS000I      255       STOPPED   IMS1
  DFS000I     *15306/163251*   IMS1
  25 DFS996I *IMS READY*  IMS1
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  PI51754 UI33251

Modules/Macros

•    DFSIDP10
  

Fix information

• Fixed component name

  IMS V12

• Fixed component ID

  5635A0300

Applicable component levels

• R200 PSY UI33251

     UP15/11/26 P F511 Ž

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.