OA47988: NEW FUNCTION: IMPROVE DIAGNOSIS FOR REFUCB FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of D/T2105, D/T2107 for volume         *
  *                 events when the location of a volume         *
  *                 VTOC or the volume serial number have        *
  *                 changed.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function:                           *
  *                      MSGDMO0063E is updated to improve       *
  *                      diagnosis when the system is unable     *
  *                      to refresh an online UCB when the       *
  *                      volume serial has changed or the VTOC   *
  *                      has moved.                              *
  *                      DMO0063E will be issued for these       *
  *                      conditions:                             *
  *                       - REFUCB enabled and VARY ONLINE       *
  *                         fails to update the UCB.             *
  *                       - REFUCB not enabled by the system.    *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The current message DMO0063E as shown,
  
  DMO0063E dddd,vvvvvv,REFUCB FAILED
  
  will be updated to the following format.
  
  DMO0063E dddd,vvvvvv,UCB NOT UPDATED,REFUCB=Y/N,USERS=xxxx
  

Problem conclusion

Temporary fix

Comments

• The updates to DMO0063E message are below. Refer to the
  original DMO0063E message for detail comparison.
  
  z/OS MVS System Messages, Vol 4 (CBD-DMO)
  SA38-0671-00
  
  DMO0063E
  dddd,vvvvvv,UCB NOT UPDATED,REFUCB=Y/N,USERS=xxxx
  
  EXPLANATION:
  Device support software has detected that the VOLSER or VTOC
  location for the volume has changed because of one of the
  following operations:
  
  - DSS COPY
  - DSS RESTORE
  - ICKDSF FLASHCPY
  - ICKDSF REFORMAT NEWVTOC
  
  The UNCONDITIONAL VARY ONLINE that was issued by the Device
  Manager failed. In the message text:
  dddd
      device
  vvvvvv
      volser
  
  REFUCB=
    'Y' means REFUCB feature is currently enabled by the system.
    'N' means REFUCB feature is not enabled by the system.
  
  USERS=
    'xxxx' is number of current users on the volume.
  
  SYSTEM ACTION:(the same as before)
  
  The UCB for the device has NOT been updated to reflect the new
  VOLSER or VTOC location.
  
  OPERATOR RESPONSE:
  
  When DMO0063E is issued with 'REFUCB=N', the location of the
  VTOC or volume serial have not been updated in the UCB.  A
  manual intervention is required to update the UCB by issuing
  a VARY ONLINE command to the device(dddd) associated with the
  volume serial. Ensure that the volume is not in use (USERS=0)
  before attempting the VARY command.
  
  For other conditions, attempt to VARY the device OFFLINE then
  ONLINE.
  
  SYSTEM PROGRAMMER RESPONSE:(the same as before)
  Messages issued by VARY explain the reason for the VARY failure.
  If they do not, issue a F DEVMAN,DUMP and search problem
  reporting data bases for a fix for the error. If no fix exists,
  report the problem to the IBM  Support Center.
  
  ...
  
  
  Reference Documentation :
  - Use operator command 'F DEVMAN,{ENABLE|DISABLE}(REFUCB)'
  to enable or disable the REFUCB function.
  - For more information, see the MODIFY DEVMAN and VARY ONLINE
  commands in z/OS MVS System Commands.
  
  ...
  ROUTING CODE:
  2,6,10
  
  DESCRIPTOR CODE: (the same)
  4
  KEYWORDS: D/T2105 D/T2107
  

APAR Information

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

  OA47116

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

Modules/Macros

• DMOAT002
  

Fix information

• Fixed component name

  DEVICE MGMT SER

• Fixed component ID

  5695DF133

Applicable component levels

• RD10 PSY UA77874

     UP15/07/03 P F507

• R210 PSY UA77875

     UP15/07/03 P F507

• R220 PSY UA77876

     UP15/07/03 P F507

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.