OA50372: NEW FUNCTION TO ALLOW FAST SUBSEQUENT MIGRATION TO IN-USE ML2 WORM TAPES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• NEW FUNCTION
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the Fast Subsequent Migration       *
  *                 (FSM) feature of DFSMShsm on z/OS V1R13 and  *
  *                 later who direct migration data to WORM      *
  *                 tape media.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Prior to this enhancement, FSM          *
  *                      required that the ML2 volume on which   *
  *                      the data set had been last migrated     *
  *                      not be in use during the time of the    *
  *                      FSM. If the volume was found to be      *
  *                      in use by another HSM function, the     *
  *                      FSM would be failed and a standard      *
  *                      migration to another ML2 tape would     *
  *                      be performed.                           *
  *                                                              *
  *                      Each time a standard migration is       *
  *                      done instead of an FSM with WORM ML2    *
  *                      media, space on the WORM tape is        *
  *                      permanently lost. Allowing FSM's to     *
  *                      complete while an ML2 WORM tape is      *
  *                      in-use will reduce this loss of         *
  *                      tape space.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Prior to this enhancement, FSM
  required that the ML2 volume on which
  the data set had been last migrated
  not be in use during the time of the
  FSM. If the volume was found to be
  in use by another HSM function, the
  FSM would be failed and a standard
  migration to another ML2 tape would
  be performed.
  
  Each time a standard migration is
  done instead of an FSM with WORM ML2
  media, space on the WORM tape is
  permanently lost. Allowing FSM's to
  complete while an ML2 WORM tape is
  in-use will reduce this loss of
  tape space.
  

Problem conclusion

Temporary fix

Comments

• NOTE: This support is intended only for users that write
  DFSMShsm data to IBM WORM media via APAR OA07768.
  
  DFSMShsm has been modified to allow Fast Subsequent Migration
  (FSM) to in-use ML2 WORM tapes written by IBM D/T3592 or
  IBM TS7700 Virtualization Engine family D/T3957 devices when
  the following patch is enabled:
  
    PATCH .MCVT.+287 BITS(......1.)
  
  NOTE: The enabling PTF for this support must be installed
  on all systems that will have an HSM address space active in
  the HSMplex. The patch must be set exactly the same (ON of OFF)
  on all HSM hosts within the HSMplex.
  
  NOTE: This function will only work for ML2 tapes written after
  the support is installed.
  
  Documentation Update:
  =====================
  
  The DFSMShsm Data Areas book will be updated to reflect the
  patchable field in the MCVT that enables this support:
  
  
  Title:        DFSMShsm Data Areas
  Document:     GC14-7504-xx
  Section:      MCVT - Management Communication Vector Table
  Change:
  
    Decimal (Hex) Type       Len Name/Description
    ------- ----- ---------- --- ------------------------------
        646 (286) BITSTRING    2 *
                                 ...
                  .... ...1      MCVTF_NO_CAPTURE_UCB
                                  When set to 1, capture UCB is
                                  disabled if UCB is above the
                                  line. When set to 0, capture
                                  UCB is enabled if UCB is
                                  above the line.
  
  ->              xxxx xx..      *
  
                                  Reserved
  
  
  ->              .... ..1.      MCVTF_FSM2INUSE_WORM
  ->
  ->                              When set to 1, Fast
  ->                              Subsequent Migration can be
  ->                              directed to an in-use WORM
  ->                              ML2 tape.
  
                  .... ...1      MCVTF_TPCOPY_DROP_GPACAT_STABLE
  
                                  Stable copy of the patchable
                                  bit above that does not change
                                  while a tape is copied.
  

APAR Information

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

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

  UA81952 UA81953 UA81954

Modules/Macros

• ARCCPDLV ARCMRCNB ARCMRECN ARCNADDV ARCTCLOS
  ARCWOPEN ARCZRBL
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• RD10 PSY UA81952

     UP16/06/23 P F606

• R210 PSY UA81953

     UP16/06/23 P F606

• R220 PSY UA81954

     UP16/06/23 P F606

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.