OA40572: NEW FUNCTION - TS7700 RELEASE 3.1 SUPPORT PLUS OTHER MISC SMSTAPE ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: This APAR is part of the full function       *
  *                 support for Release 3.1 of the TS7700        *
  *                 Virtualization Engine D/T3957.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function Support for Release 3.1    *
  *                      of the TS7700 Virtualization Engine.    *
  ****************************************************************
  * RECOMMENDATION: For full support, install this APAR OA40572  *
  *                 (z/OS V1R12, V1R13 and V2R1). This APAR      *
  *                 brings in the necessary support from all     *
  *                 other components.                            *
  ****************************************************************
  TS7700 Release 3.1 Information:
  -------------------------------
  This APAR was developed as part of the full function support for
  Release 3.1 of the TS7700 Virtualization Engine D/T3957 however,
  several of the enhancements are RAS-related and also apply to
  the D/T3584 D/T3494 native tape library and to earlier
  releases of the TS7700.  For a full discussion of the TS7700
  Release 3.1 enhancements refer to the TS7700 Customer
  Information Center
  http://publib.boulder.ibm.com/infocenter/ts7700/cust/index.jsp
  .
  Highlights of the TS7700 R3.1 support include:
  1> 8 Gb Dual-Port FICON adapter support provides support for up
  to eight FICON channels (doubling the previous number of
  channels).  Also included is support for up to 512 logical paths
  per FICON channel (doubling the number of logical paths per
  channel for a maximum of 8 x 512 or 4096 logical paths).
  .
  2> The FlashCopy for Disaster Recovery (DR) test capability is
  provided so that a snapshot of the file system (logical volumes)
  can be captured for DR testing.   The snapshot (point in time
  copy at time zero) is initiated using the MVS operator LIBRARY
  REQUEST command. This new function is supported with the TS7720
  Virtualization Engine and provides support for a read-only copy
  of the flashed logical volumes.   While the DR test is accessing
  the FlashCopy of a logical volume, the production environment
  can continue to mount, modify and replicate the original copy of
  the volume and can also return the volume to scratch.  The DR
  test environment will continue to see the data as it existed
  (when the snapshot was taken) prior to any updates. For
  specifics on setting up and using this support refer to the
  TS7700 Information Center.
  .
  Note: neither of the enhancements above (or any of the other
  TS7700 R3.1 enhancements) requires any specific host software
  support, including this APAR.
  .
  Highlights of the host software RAS-enhancements:
  1> Diagnostic enhancements on the mount command.  With Release
  2.0 of the TS7700, the 8-CHAR system from the CVT (CVTSNAME) is
  passed on the mount request.  Now, the 8-CHAR sysplex name from
  the extended CVT (ECVTSPLX) is also sent to the TS7700.  In
  addition to this, when the first file sequence (scratch or
  private; DISP=NEW) is written to the volume, additional job-
  related information is also passed to the TS7700 (8-CHAR
  program name and the first 17-CHARs of the data set name).
  .
  2> Enhancements to the DISPLAY SMS,LIBRARY command (CBR1110I).
  The maximum number of scratch volumes associated with each media
  type is expanded from 6-digits to 8-digits. Even though we are
  accommodating an 8-digit scratch count value (per media type) in
  the DISPLAY SMS,LIBRARY command output (SCRATCH COUNT), ISMF and
  IDCAMS continues to support a 6-digit value and will truncate
  the left most digit.
  .
  3> Enhancements to the Bulk Volume Information Retrieval (BVIR)
  Interface. With Release 3.0 of the TS7700, the number of volumes
  supported in a TS7700 Virtualization Engine (Grid) was increased
  to 4 million logical volumes (and with backup copies this could
  be 8 million logical volumes). New "Volume Map" options "Volume
  Map Primary" and "Volume Map Secondary" were introduced. Today
  RMM uses the returned BVIR data to generate customizable
  reports.  Sample JCL (EDGJCEXP) is updated to reference the new
   Volume Map Backup  option.  This option should be used (with
  RMM) starting with release 3.0 of the TS7700.
  .
  4> Enhancements to the CBR3710I message.  When OAM invokes the
  LIBSERV macro to send an I/O request to the library, if the
  command fails, the failing return and reason code are included
  in the message.  Now this message also includes the requested
  function type. CBR3710I  LIBSERV failure occurred for library
  library-name.  RC=return-code, RSN=reason-code, REQTYPE=request-
  type.
  .
  5> Enhancements to the IEA430I message,  When I/O to the library
  times out, device services issues a message with the 5-CHAR
  library-ID and the 4-digit device number.  Now this message also
  includes the failing request type and command information.
  IEA439I TAPE LIBRARY(XXXXX),DEVICE(DDDD) FOUR MINUTE I/O
  TIMEOUT, REQTYPE=request-type, CMDCODE=command-code, CMDORDER=
  command-suborder, CMDTYPE=command-type.
  .
  6> Enhancements to cartridge entry recovery processing.  Today
  during cartridge entry processing, an out of synch condition can
  occur between the library and the tape configuration database
  (TCDB), if the I/O request to move the volume out of the insert
  category time outs and is successfully retried. When this
  happens, all of the hosts that are processing the list of
  volumes, think that another host processed the volume.  This
  results in the TCDB volume record not being added or updated
  (and the volume missing from the CBR3610I message). Job
  processing can later fail, if the library selects a scratch
  volume that is  not in the TCDB.  Additional logic is put in
  place to detect the time out and retry condition and if this
  condition is detected, an attempt is made to add (or update) the
  volume record in the TCDB.
  .
  7> Enhancements to device services and OAM on detection of a
  permanent error.  When device services sends a request (MOUNT,
  DEMOUNT, AUDIT, EJECT) to the library, it will check on the
  request every few minutes.  If a permanent error occurs and the
  state of the request cannot be determined, the request can hang
  (for example, in CBRLLACS MOUNT processing).  Logic has been
  added for device services to detect this condition with a unique
  failure back to its caller.  This results in OAM issuing the
  following new messages (as appropriate): CBR4121I Request for
  status volume volser in library library-name failed. CBR3718I
   MOUNT | DEMOUNT | AUDIT | EJECT} completion status for volume
  volser, library library-name, message ID msgid, unable to
  obtain.
  .
  8> Enhancements to the scratch threshold monitoring task.  With
  APAR OA39381, a new scratch threshold monitoring task was added
  (in OAM) so that every 10 minutes, the task would wake-up and
  perform scratch threshold processing.  It was discovered that
  scratch threshold processing was also being performed for the
  distributed tape libraries associated with a virtual tape
  library. Since all volumes and drives are associated with the
  composite library, there is no need to do the extra I/O to the
  distributed libraries of a composite library.  Enhancements are
  made to bypass threshold processing for distributed libraries.
  This support will also reset the scratch counts, associated with
  a distributed library back to zero.
  .
  9> Mount processing enhancements.  Today when a TS7700
  Virtualization Engine is put in write protect mode, a CBRLLACS
  ABEND0B6 can occur on a specific mount.  Now if a scratch or a
  private mount fails this this error, LACS message CBR4126I, will
  be issued instead of the abend.
  .
  10> ABEND0C4 can occur if the CBRLLACS WTO function is passed
  the UCBPTR of a VIO device. The LACS WTO function is enhanced to
  accept a VIO device.
  .
  New/Changed Messages:
  ---------------------
  CBR1110I - Changed message.
  Increased the scratch count per media type from 6 to 8 digits.
  .
  CBR3710I - Changed message.
  CBR3710I  LIBSERV failure occurred for library library-name.
  RC=return-code, RSN=reason-code, REQTYPE=request-type.
  .
  Explanation: The asynchronous operations manager (AOM) LIBSERV
  service failed with return code return-code and reason code
  reason-code during processing in library library-name. The
  return and reason codes are included for diagnostic purposes and
  can be found in the z/OS DFSMSdfp Diagnosis under 'AOM Tape
  Library Return and Reason Codes'. In addition to the failing
  return and reason code, the requested library function to be
  performed, request-type, is also included for diagnostic
  purposes. If the library name is not available at the time of
  the error, the library ID is displayed instead.
  .
  CBR3718I - New message.
  CBR3718I   MOUNT | DEMOUNT | AUDIT | EJECT} completion status
  for volume volser, library library-name, message ID msgid,
  unable to obtain.
  .
  Explanation: A mount, demount, audit, or eject request was
  successfully issued for volume volser in library library-name;
  however, completion status for the request could not be obtained
  from the library.  Several attempts were made to determine the
  status of the request and each I/O attempt failed trying to send
  the status request to the library.  The host is unable to
  determine whether the request completed or not.  The request was
  tracked using library message ID msgid.
  .
  CBR4121I - New message.
  CBR4121I Request for status volume volser in library library-
  name failed.
  .
  Explanation: An error has been detected during Library
  Automation Communication Services (LACS) processing for the
  MOUNT or WAIT function.  The mount request for volume volser was
  successfully sent to library library-name; however, the host did
  not receive completion status for the mount request.  Several
  attempts were made to determine the status of the mount request
  and each I/O attempt failed trying to send the status request to
  the library.  The host is unable to determine whether the
  request completed or not.
  .
  System Action: The LACS request fails with a permanent error
  return code. Messages issued by the caller of LACS are written
  concurrently with this message.
  .
  Operator Response: Resubmit the failing job once the volume has
  been freed from the drive and the I/O issue with the library has
  been resolved.  The LIBRARY DISPDRV command can be used to
  determine if the volume is mounted on the drive, and if it is,
  the MVS UNLOAD command can be used to free the volume from the
  drive.  Otherwise a subsequent allocation for this same volume
  may show that the volume is in use.
  .
  Reference Material:
  -------------------
  Publication updates to the z/OS V2R1 DFSMS OAM Planning,
  Installation, and Storage Administration Guide for Tape
  Libraries - SC23-6867-00 and to the z/OS V2R1 MVS System
  Messages, Vol 4 (CBD-DMO) - SA38-0671-00 will be available at a
  future date.
  http://www.ibm.com/servers/eserver/zseries/zos/bkserv/
  .
  Also refer to the TS7700 Customer Information Center
  http://publib.boulder.ibm.com/infocenter/ts7700/cust/index.jsp
  

Problem conclusion

Temporary fix

Comments

• See problem summary.
  

APAR Information

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

  OA40552

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

  UA90673 UA90674 UA90675

Modules/Macros

• CBRCTCPL CBRCTRP  CBRFDL   CBRFDLMG CBRFDTDX CBRLCTRM CBRLLACS
  CBRLLAPR CBRLLERR CBRLLMT  CBRLTCMG CBRLTDUS CBRLTENT CBRLTLMG
  CBRLTMON CBRLTOSU CBRLTSTR CBRPLCB  CBRRTTWR CBRSMGM1 CBRSMGM3
  CBRSMGM4 CBRSMGU1 CBRSMGU3 CBRSMGU4 CBRSRDBL IEECB965
  

Fix information

• Fixed component name

  OBJECT ACCESS M

• Fixed component ID

  5695DF180

Applicable component levels

• RC10 PSY UA90673

     UP14/01/31 P F401

• RD10 PSY UA90674

     UP14/01/31 P F401

• R210 PSY UA90675

     UP14/01/31 P F401

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.