OA47487: NEW FUNCTION - TS7700 RELEASE 3.3 SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function:
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: This APAR is part of the full function       *
  *                 support for Release 3.3 of the TS7700        *
  *                 Virtualization Engine D/T3957                *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function Support for Release 3.3    *
  *                      of the TS7700 Virtualization Engine.    *
  ****************************************************************
  * RECOMMENDATION: Install this APAR which brings in the        *
  *                 support for AOM APAR OA47488.                *
  ****************************************************************
  TS7700 Release 3.3 Information:
  -------------------------------
  This APAR was developed as part of the full function support
  for Release 3.3 of the TS7700 Virtualization Engine D/T3957.
  For a full discussion of the TS7700 Release 3.3 enhancements
  refer to the TS7700 Knowledge Center:
  http://www.ibm.com/support/knowledgecenter/STFS69/welcome
  
  Highlights of the TS7700 R3.3 support include:
  1> TS1150 Support in the TS7700
  With Release 3.3 of the TS7700, the TS7740 and TS7720T will be
  able to use the new TS1150 tape drives for their back store
  storage devices.
  .
  2> External Key Management of the Disk Cache
  With Release 3.0 of the TS7700, all configurations began to
  ship with disk cache controllers that supported encryption for
  data at rest within the self encrypting drives. The initial
  disk encryption support provided by the TS7700 used internal
  key management to manage the encryption keys. With Release
  3.3, the TS7700 will support external or internal key
  management for the disk cache. External key management uses
  the IBM Security Key Lifecycle Manager (formerly referred to
  as the Tivoli Key Lifecycle Manager) or the IBM Security Key
  Lifecycle Manager for z/OS.
  .
  Note: neither of the enhancements above requires any specific
  host software support, including this APAR.
  .
  Highlights of the host software RAS-enhancements:
  1> TS7700 Service Preparation Enhancements
  When a TS7700 cluster (distributed library) is to be placed in
  service mode (for hardware or microcode updates), procedure
  states devices associated with that cluster must first be
  varied offline. Using the existing LIBRARY DISPDRV command,
  devices that are currently allocated and mounted can be
  displayed, however there is no way to tell if another cluster
  is involved in that mount (as the primary or secondary tape
  volume cache (TVC) cluster). This support adds a new MOUNTED
  keyword to the existing LIBRARY DISPDRV command which will
  display a view of mounted volumes across a grid.
  .
  As with the existing LIBRARY DISPDRV command, drives are only
  displayed if they have been defined to the IODF and the system
  the command is issued to has been able to communicate to the
  drive to verify its information (the drive could be online or
  offline to verify this). So if the system has connectivity
  to the drive, then it is a candidate for being displayed.
  .
  LIBRARY DISPDRV,library_name,MOUNTED
  LI DD,library_name,M
  .
  LIBRARY DISPDRV,library_name,MOUNTED,ALL
  LI DD,library_name,M,A
  .
  As with the existing LIBRARY DISPDRV command, the L= parameter
  (specifying where to display the results of the inquiry) and
  its options can also be used with the new keywords.
  .
  mounted
    Specifies that status information is displayed for volumes
    that are mounted in the TS7700 Virtualization Engine for the
    specified composite or distributed library. When this
    keyword is specified CBR1230I is displayed rather than
    CBR1220I. Information pertaining to the distributed library
    that owns the device for the mount as well as distributed
    library information associated with the primary and the
    secondary tape volume cache (TVC) is displayed. This keyword
    can only be specified with the library-name option of the
    command and only with a composite or a distributed library
    associated with a TS7700 Virtualization Engine. This is an
    optional keyword.
  all
    Specifies that for a distributed library in a TS7700
    Virtualization Engine, additional drives may be displayed
    that are not owned by the specified distributed library. The
    additional drives are displayed if the distributed library
    specified is the primary or secondary TVC for the mounted
    volume. This option may be useful when a distributed
    library is going into service and can be used to determine
    if the specified distributed library is associated with a
    mount request from another distributed library. This is an
    optional keyword and is only applicable if the mounted
    keyword is also specified. If this keyword is specified with
    the mounted keyword and a composite library is specified,
    this keyword is ignored and the same results are displayed.
  .
  New/Changed Messages:
  ---------------------
  CBR1230I - New message.
  CBR1230I Mounted status:
  DRIVE  COMPLIB   ON  MOUNT   DISTLIB   PRI-TVC   SEC-TVC
  NUM    NAME          VOLUME  NAME      DISTLIB   DISTLIB
  devnum complib   a   mntvol  distlib   pdistlib  sdistlib
  .
  Explanation:
  The operator has entered one of the following commands:
  .
       LIBRARY DISPDRV,library_name,MOUNTED
       LIBRARY DISPDRV,library_name,MOUNTED,ALL
  .
  A display of mounted tape drive status has been requested.
  .
  The fields displayed in each data line of the multi-line
  message are as follows:
  .
  devnum
    The device number of the tape drive.
  .
  complib
    Name of the library in which the tape drive resides.  All
    volumes and drives in a TS7700 configuration are primarily
    associated with the composite library.
  .
  a
    Tape drive status:
      Y
        Online.
      N
        Offline
      P
        Pending Offline.
  .
  mntvol
    Volume serial number of the volume that is currently mounted
    on the tape drive.
  .
  distlib
    Name of the distributed library where the tape drive
    actually resides (also referred to as the owning distributed
    library). This information will only be provided if the
    distributed library that owns the drive is at TS7700 R3.3
    (or higher), otherwise this field contains '--------'.
  .
  pdistlib
    Name of the distributed library that is the primary tape
    volume cache (TVC) for the mounted volume. This could be the
    same distributed library as the owner of the drive or it
    could be a different distributed library if this distributed
    library is acting as the primary TVC. This information will
    only be provided if the distributed library that owns the
    drive is at TS7700 R3.3 (or higher), otherwise this field
    contains '--------'. If a distributed library is returned
    that OAM does not know about, but is known to devices
    services then the distributed library displayed is the 5-CHR
    library sequence number associated with the distributed
    library. If a distributed library is returned that neither
    device services nor OAM knows about then the distributed
    library ID will be displayed as CL0, CL1, CL2, etc.
  .
  sdistlib
    Name of the distributed library that is the secondary tape
    volume cache (TVC) for the mounted volume. The secondary TVC
    is only applicable if the mounted volume is being replicated
    using synchronous mode copy. This information will only be
    provided if the distributed library that owns the drive is
    at TS7700 R3.3 (or higher), otherwise this field contains
    '--------'. If this field is not applicable for the mounted
    volume, this field contains  blanks . If a distributed
    library is returned that OAM does not know about, but is
    known to devices services then the distributed library
    displayed is the 5-CHR library sequence number associated
    with the distributed library. If a distributed library is
    returned that neither device services nor OAM knows about
    then the distributed library will be displayed as CL0,
    CL1, CL2, etc.
  .
  System action: None
  .
  Source: Object Access Method (OAM)
  .
  Routing Code: -
  .
  Descriptor Code: 5,8,9
  

Problem conclusion

Temporary fix

Comments

• See problem summary.
  

APAR Information

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

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

  OA47488 UA78696 UA78697 UA78698

Modules/Macros

• CBRFDTD  CBRFDTD2 CBRSMGM1 CBRSMGU1 HDZ1D10J
  HDZ2210J HDZ2220J
  

Fix information

• Fixed component name

  OBJECT ACCESS M

• Fixed component ID

  5695DF180

Applicable component levels

• RD10 PSY UA78696

     UP15/09/03 P F509

• R210 PSY UA78697

     UP15/09/03 P F509

• R220 PSY UA78698

     UP15/09/03 P F509

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.