OA49373: NEW FUNCTION - TS7700 Release 4.0 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 4.0 of the TS7700        *
  *                 Virtualization Engine D/T3957.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function Support for Release 4.0    *
  *                      of the TS7700 Virtualization Engine.    *
  ****************************************************************
  * RECOMMENDATION: For full support, install this APAR OA49373  *
  *                 (z/OS V2R1 and V2R2). This APAR brings in    *
  *                 the necessary support from all other         *
  *                 components (OA49374 and OA49375).            *
  ****************************************************************
  TS7700 Release 4.0 Information:
  -------------------------------
  This APAR was developed as part of the full function support
  for Release 4.0 of the TS7700 Virtualization Engine D/T3957.
  For a full discussion of the TS7700 Release 4.0 enhancements
  refer to the TS7700 Knowledge Center:
  http://www.ibm.com/support/knowledgecenter/STFS69/welcome
  .
  Highlights of the TS7700 R4.0 support include:
  1> Hardware (server and disk cache) refresh of the TS7700
  Virtualization Engine. With the new hardware, the TS7700
  will report to the host as a 3957 Model VEC and is also
  referred to as a TS7760 or as a TS7760T if physical tape
  is attached for the back store.
  2> Support fo the TS4500 automated tape library has been
  added for its physical tape back store.
  .
  Note: neither of the enhancements above requires any specific
  host software support, including this APAR.
  .
  Highlights of the host software RAS-enhancements:
  1> Security Product resource-name enhancements added for
  the MVS LIBRARY Operator Command
  .
  Today, the MVS.LIBRARY resource-name is checked by the
  consoles component in MVS before control is given to OAM to
  process the LIBRARY command. If a security product profile is
  established for the LIBRARY command (MVS.LIBRARY), UPDATE
  authority is required to issue the command regardless of its
  function.
  .
  This APAR adds security product resource-names for each of
  the LIBRARY functions listed below. The added resource-names
  are an extension of what exists today and is based on the
  first keyword that is specified with the LIBRARY operator
  command.
  .
  The OPERCMDS resource class is used to protect the issuance of
  an operator command and it is where the LIBRARY command
  profiles need to be defined. Each LIBRARY command function can
  now be protected by its own security product profile.
  .
  In summary, the MVS LIBRARY command can be protected with a
  security product profile using the MVS.LIBRARY resource-name
  and UPDATE authority (as exists today), and if more granular
  protection is needed, security product profiles can be
  established for the individual command functions or for groups
  of functions based on whether UPDATE or READ access is needed
  for the specific command. If the security product profile
  that is associated with the command being issued is not
  defined, the command will be honored as it is today.
  .
  Keyword   Authority   Resource Name
            Required
  DISPDRV   READ        MVS.LIBRARY.DISPDRV
  DISABLE   UPDATE      MVS.LIBRARY.DISABLE
  DISPCL    READ        MVS.LIBRARY.DISPCL
  EJECT     UPDATE      MVS.LIBRARY.EJECT
  ENTER     UPDATE      MVS.LIBRARY.ENTER
  EXPORT    UPDATE      MVS.LIBRARY.EXPORT
  IMPORT    UPDATE      MVS.LIBRARY.IMPORT
  LMPOLICY  UPDATE      MVS.LIBRARY.LMPOLICY
  REQUEST   UPDATE      MVS.LIBRARY.REQUEST
  RESET     UPDATE      MVS.LIBRARY.RESET
  SETCL     UPDATE      MVS.LIBRARY.SETCL
  .
  If security product profiles are established and the user
  does not have sufficient access, the following messages are
  issued, as an example:
  .
  IEE345I LIBRARY AUTHORITY INVALID, FAILED BY
  SECURITY PRODUCT
  ICH408I USER(USER1 ) GROUP(SYS1 ) NAME(TEST1)
  MVS.LIBRARY.DISPDRV CL(OPERCMDS)
  INSUFFICIENT ACCESS AUTHORITY
  ACCESS INTENT(READ ) ACCESS ALLOWED(NONE )
  .
  2> Scratch Threshold Enhancements
  Today, when a media type falls below scratch threshold,
  CBR3660A is issued and remains until the number of scratch
  volumes exceeds twice the threshold value (2X + 1). With this
  support, the ability to tune (by percentage above scratch
  threshold) when the CBR3660A message is deleted will be
  provided through the CBROAMxx PARMLIB member (SETTLIB). The
  following is a description of the SCRATCHTHRESHOLDMSG SETTLIB
  PARMLIB keyword:
  .
  SETTLIB SCRATCHTHRESHOLDMSG(percentage)
  An optional parameter that indicates when the CBR3660A message
  will be deleted. The percentage specified can be a value
  between 25% and 100% and indicates the percentage of scratch
  volumes above scratch threshold that is needed before the
  CBR3660A message is deleted. A value from 1% and 24% will be
  treated as 25% and a value of 0 will be treated the same as a
  value of 100% (today's behavior and the default). As exists
  with today's behavior, the CBR3660A message will be deleted
  when the value is exceeded. For example, if the scratch
  threshold value (in a TS7700 Virtualization Engine) is set to
  1000 for MEDIA1 and 5000 for MEDIA2, if the percentage value
  is set to 50%, the CBR3660A message (for MEDIA1) will be
  deleted when the number of MEDIA1 scratch volumes exceeds 1500
  and the CBR3660A message (for MEDIA2) will be deleted when the
  number of MEDIA2 scratch volumes exceeds 7500. Previously (at
  2X or 100%), the CBR3660A message would have been deleted when
  the scratch count exceeded 2000 (for MEDIA1) and 10,000 (for
  MEDIA2). The percentage specified is a global value and
  applies across all libraries and across all media types and
  can be specified for an individual system using the ONLYIF
  SYSNAME statement in the CBROAMxx PARMLIB member. Please note
  the coexistence considerations below when using the new
  SCRATCHTHRESHOLDMSG keyword.
  .
  Before using the new SCRATCHTHRESHOLDMSG keyword, the
  following coexistence considerations apply. If the CBROAMxx
  PARMLIB member is being shared across systems, ensure that the
  new SCRATCHTHRESHOLDMSG keyword is NOT used until all of the
  applicable systems have this support installed or the ONLYIF
  keyword is specified for the system(s) that have the support
  installed. If the appropriate ONLYIF keyword is not specificed
  or the support is not installed on a system, the following
  message will be issued: CBR0302I KEYWORD SCRATCHTHRESHOLDMSG
  INVALID IN A SETTLIB STATEMENT. This is an existing OAM
  message, and as exists with the specification of other invalid
  keywords in the CBROAMxx PARMLIB member, will cause OAM
  initialization to terminate. Otherwise, each system will need
  to have its own copy of the CBROAMxx PARMLIB member (as
  appropriate for the installed maintenance level).
  .
  Since the OAM address space is required to parse the CBROAMxx
  PARMLIB member, the tuning percentage will only be honored if
  the OAM address space had been started, otherwise today's
  logic of 2X+1 to delete the CBR3660A message will be used.
  Updates to the SETTLIB command will require that the OAM
  address space be stopped and restarted to pick up the new
  command setting. The SCRATCHTHRESHOLDMSG value can be
  displayed using the MODIFY OAM,DISPLAY,SETTLIB operator
  command with a scope of GLOBAL or ALL. The existing CBR1075I
  message will be issued when either ALL or GLOBAL is specified.
  As an example:
  CBR1075I GLOBAL value for STHRESHM is 50.
  .
  3> DISPLAY SMS,OAM Enhancements
  The DISPLAY SMS,OAM operator command (CBR1100I) will now
  display the status of the CATEGORY COUNT SCRATCH TRANSITION
  feature. CATEGORY COUNT SCRATCH TRANSITION (ENABLED | OPERATOR
  DISABLED) See APAR OA48240 for more details on this feature.
  By default, if the LIBRARY DISABLE,CATCOUNT command is not
  issued the status line will display as:
  CATEGORY COUNT SCRATCH TRANSITION ENABLED
  .
  4> IEF_ALLC_OFFLN Exit Enhancements
  The IEF_ALLC_OFFLN (Allocated/Offline Device Installation)
  exit is now passed device prioritization information in a
  system-managed tape library environment. This additional
  information can be used to bring tape devices online.
  For more information, see MVS Allocation APAR OA49375.
  .
  5> Added Diagnostic Capabilities
  When the attributes of a volume are changed, the system
  and the sysplex name are now passed to the TS7700
  Virtualization Engine for additional diagnostic capabilities.
  .
  New/Changed Messages:
  ---------------------
  CBR1100I - Changed Message.
  Now displays the status of the CATEGORY COUNT SCRATCH
  TRANSITION function.
  CATEGORY COUNT SCRATCH TRANSITION  ENABLED | OPERATOR
  DISABLED
  .
  CBR1075I - Changed Message.
  Now displays the SCRATCHTHRESHOLDMSG (STHRESHM) value for the
  SETTLIB PARMLIB parameter with a scope of GLOBAL or ALL.
  

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:

  OA49374 OA49375 UA81683 UA81684

Modules/Macros

• CBRBLCTM CBRCPSTL CBRCTOI  CBRCTRP  CBRFDO
  CBRFDSET CBRLTDUS CBRPOVT  CBRSMGM1 CBRSMGU1 IEECB965
  

Fix information

• Fixed component name

  OBJECT ACCESS M

• Fixed component ID

  5695DF180

Applicable component levels

• R210 PSN UA81683

     UP16/05/25 P F605

• R220 PSN UA81684

     UP16/05/25 P F605

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.