OA56852: NEW FUNCTION: SEARCH SUPPORT FOR EDM AND FOR THE GDPR RELATED OPTIONS FORCEEXPIRE AND DSNEXPIRE(BLOCK)

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• With this APAR functionality will be added to DFSMSrmm to
  improve search capability for features related to the new
  European GDPR regulation, as well as the volume EDM field. New
  parameters will be added to the SEARCHDATASET and SEARCHVOLUME
  DFSMSrmm subcommands.
  .
  Also, a new sample report for the Report Generator would be
  added to list data sets blocked by DSNEXPIRE(BLOCK).  Also,
  DSNEXPIRE(BLOCK) would be improved to prevent blocking volumes
  that are held by EDM, WHILECATALOG, or HOLD.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of DFSMSrmm.                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * With this APAR, the FORCEEXPIRE and                          *
  * NOFORCEEXPIRE options are added to the                       *
  * SEARCHDATASET DFSMSrmm subcommand.                           *
  * The EDM and NOEDM options are added to                       *
  * the SEARCHVOLUME DFSMSrmm subcommand.                        *
  * A new sample report EDGGR16 is added                         *
  * to show data sets blocked by                                 *
  * DSNEXPIRE(BLOCK).                                            *
  * DSNEXPIRE(BLOCK) now prevents blocking                       *
  * data sets held for reasons other than                        *
  * the expiration date and retention date.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the applicable PTF(s).                                 *
  ****************************************************************
  This APAR continues a series of APARs providing functionality
  related to the European GDPR legislation.  It provides support
  for searching data sets that are blocked using the FORCEEXPIRE
  option, as well as for searching volumes that are managed by an
  External Data Manager (EDM).  Searching for data sets with
  FORCEEXPIRE set requires additional authorization and is
  available using the DFSMSrmm command-line interface.  Searching
  for volumes with EDM set is possible using either the
  command-line interface or the ISPF dialog.  In addition, a
  sample report for the Report Generator is provided, showing how
  the Report Generator can be used to view data sets blocked by
  the DSNEXPIRE(BLOCK) option.   DSNEXPIRE(BLOCK) has been updated
  to avoid blocking data sets on volumes that have HOLD set to
  YES, or EDM set to YES, as well as data sets that are held
  because of their catalog status.
  

Problem conclusion

Temporary fix

Comments

• The program has been enchanced with additional searching
  functionality, and an improvement to the way
  DSNEXPIRE(BLOCK) blocks data sets.
  
  The book "DFSMSrmm Managing and Using Removable Media
  (SC23-6873)",  Chapter "Using RMM TSO subcommands"  has
  been updated as  shown:
  
  in the article
  "SEARCHDATASET: Creating a list of data sets":
    >--.------------------.--------.----------------.-------->
  |    '-FORCE(-.-YES-.-)-'        |             (1)|
  |             '-NO--'            |-FORCEEXPIRE----|
  |                                '-NOFORCEEXPIRE--'
  ...
  | NOTES:
  | (1) Can only be specified by a user with CONTROL access to
  |     STGADMIN.EDG.MASTER and UPDATE access to
  |     STGADMIN.EDG.FORCEEXPIRE security resources. Owner
  |     authorization does not apply.
  ...
  | FORCEEXPIRE
  |     Specify the FORCEEXPIRE operand to select data sets
  |     with the FORCEEXPIRE attribute.  FORCEEXPIRE is
  |     used to manually block access to a data set.
  |
  |     When specifying the FORCEEXPIRE keyword, DFSMSrmm
  |     always checks  for the STGADMIN.EDG.FORCEEXPIRE and
  |     STGADMIN.EDG.MASTER  security resources, independent
  |     of the other parameters specified.
  |
  |     UPDATE access to STGADMIN.EDG.FORCEEXPIRE and
  |     CONTROL access to STGADMIN.EDG.MASTER is needed to
  |     complete the search.
  |
  |     FORCEEXPIRE and NOFORCEEXPIRE are mutually exclusive.
  ...
  | NOFORCEEXPIRE
  |     Specify the NOFORCEEXPIRE operand to select data sets
  |     without the FORCEEXPIRE attribute. FORCEEXPIRE is used
  |     to manually block access to a data set.
  |
  |     When specifying the NOFORCEEXPIRE keyword, DFSMSrmm
  |     always checks for the STGADMIN.EDG.FORCEEXPIRE and
  |     STGADMIN.EDG.MASTER security resources, independent
  |     of the other parameters specified.
  |
  |     UPDATE access to STGADMIN.EDG.FORCEEXPIRE and CONTROL
  |     access to  STGADMIN.EDG.MASTER is needed to complete
  |     the search.
  |
  |     FORCEEXPIRE and NOFORCEEXPIRE are mutually exclusive.
  
  
  
  in the article "SEARCHVOLUME: Creating a list of volumes" :
   >--.----------------------------.------.--------.--------->
  |   '--.-DSNCRSYSID-.(system_ID)-'      |-EDM----|
  |      '-DSNSYSID---'                   '-NOEDM--'
  ...
  |EDM
  |  Specify the EDM (External Data Manager) operand to select
  |  volumes with the volume EDM attribute.
  |  The EDM field specifies whether the volume is being
  |  externally managed by the owning application.
  |  This volume attribute prevents volumes from being
  |  prematurely expired by DFSMSrmm.
  |  EDM and NOEDM are mutually exclusive
  ...
  |  NOEDM
  |   Specify the NOEDM operand to select volumes without the
  |   volume EDM attribute.
  |   The EDM field specifies whether the volume is being
  |   externally managed by the owning application. This
  |   volume attribute prevents volumes from being prematurely
  |   expired by DFSMSrmm.
  |
  |   EDM and NOEDM are mutually exclusive.
  
  
  The book "DFSMSrmm Implementation and Customization Guide
  (SC23-6874)" has been updated as shown.
  The Chapter "Authorizing DFSMSrmm users and ensuring
  security", table "Resources you protect with RACF profiles"
  has been changed as follows:
  
    STGADMIN.EDG.FORCE       Changing of information recorded
                             by DFSMSrmm during O/C/EOV
                             processing.
  
                             Adding or deleting data sets on
                             volumes or to use the DELETEVOLUME
                             command.
  
  | STGADMIN.EDG.FORCEEXPIRE Ability to search for data sets
  |                          that were blocked using the
  |                          CHANGEDATASET FORCEEXPIRE
  |                          DFSMSrmm subcommand.
  |                          Ability to undo FORCEEXPIRE using
  |                          the CHANGEDATASET REMOVEEXPIRE
  |                          DFSMSrmm subcommand - however it
  |                          is also possible to use
  |                          REMOVEEXPIRE without access to
  |                          STGADMIN.EDG.FORCEEXPIRE if the
  |                          FORCE option is specified.
  
  Table "Authorized functions" has been changed as follows:
  
    STGADMIN.EDG.FORCE
         Entity not defined  Information previously recorded
                             by DFSMSrmm cannot be changed.
  
         UPDATE              Information previously recorded
                             by DFSMSrmm can be changed based
                             on access to STGADMIN.EDG.MASTER
  
  | STGADMIN.EDG.FORCEEXPIRE
  |      Entity not defined  Not authorized to issue
  |                          RMM SEARCHDATASET FORCEEXPIRE and
  |                          RMM SEARCHDATASET NOFORCEEXPIRE.
  |                          Not authorized to issue
  |                          RMM CHANGEDATASET REMOVEEXPIRE
  |                          without the FORCE parameter.
  |
  |      UPDATE              The following RMM subcommands can
  |                          be issued based on access
  |                          to STGADMIN.EDG.MASTER:
  |                            RMM SEARCHDATASET FORCEEXPIRE
  |                            RMM SEARCHDATASET NOFORCEEXPIRE
  |                            RMM CHANGEDATASET REMOVEEXPIRE
  |                          (without the FORCE parameter
  |                          specified)
  
  Table "Suggested resource access to limit scope of tasks"
   has been changed as follows:
   Resource General Storage System Librarian Inven- Operator
            User    Admin   Programmer       tory
                                             Manage-
                                             ment
                                             Functions
    STGADMIN.EDG.FORCE
             -       U         -      U        -      -
  | STGADMIN.EDG.FORCEEXPIRE
  |          -       -         -      -        -      -
  
  Chapter "Using the parmlib member EDGRMMxx" has
  been updated:
  in the article "OPTION command operands":
   DSNEXPIRE(BLOCK|NONE)
      The DSNEXPIRE option allows to block access to
      data sets that are expired.
    NONE
       Data sets that are no longer retained and which
       have an expiry date in the past are still accessible
       until the volume on which they reside is scratched.
       Data sets modified using the RMM CHANGEDATASET
       subcommand with the FORCEEXPIRE operand are
       not accessible even with DSNEXPIRE(NONE).
    BLOCK
       RMM will block access to data sets that are
       expired and not retained by a Vital Record
       Specification .  Newly created data sets that are
       not VRSELEXCLUDED are not blocked until VRSEL
       housekeeping has a chance to retain them.
  |    Data sets that are retained for the following
  |    reasons are not blocked, even if their expiration
  |    date is in the past: the data set resides on a
  |    volume that has HOLD set to YES, or EDM set to YES,
  |    or the data set is cataloged and has WHILECATALOG
  |    set to ON.
  
       For NL (not labeled) tapes, a data set that is
       expired will be blocked even if the JCL has the wrong
       data set name, as long as the sequence number of
       the data set matches that stored in the RMM CDS.
       BLP (bypass label processing) cannot be used to read or
       write expired data sets when DSNEXPIRE(BLOCK) is set.
  
  
  In the book "DFSMSrmm Reporting (SC23-6875)",
  Chapter "Using the DFSMSrmm report generator", article
  "Sample report definitions" has been changed as follows:
    EDGGR15
         Volume Inventory Including Volume Count
         Type: EDGRXEXT Extended Extract Records
         Usage: List of all volumes and data sets sorted by
         volser and data set sequence number
  | EDGGR16
  |      List of Data Sets blocked by DSNEXPIRE(BLOCK)
  |      Type: EDGRXEXT Extended Extract Records
  |      Usage: List of data sets that are blocked by the
  |      DSNEXPIRE(BLOCK) option, sorted by volser and
  |      data set sequence number
  
  Appendix "DFSMSrmm mapping macros"  has been updated
  as shown.
  
  in the table " Structure RDEXT" :
    613 (265) CHARACTER 5 RDLRED       LASTREF extra days
  | 618 (26A) CHARACTER 1 RDWHILECATON WHILECATALOG=ON Y,N
  | 619 (26B) CHARACTER 1 RDWHILECATUX WHILECATALOG=
  |                                     UntilExpired Y,N
  | 620 (26C) CHARACTER 0 RDRCEND      End of RDEXT
  
  in the table " Structure RVEXT" :
    1096 (448) CHARACTER 9 RVEXRB      EXPDT RetainBy
  | 1105 (451) CHARACTER 1 RVEDM       Volume EDM: Y, N
  | 1106 (452) CHARACTER 0 RVRCEND     End of RVEXT
  
  
  in the table " Structure RXEXT" :
    1760 (6E0) CHARACTER 9 XVEXRB         EXPDT retainby
  | 1769 (6E9) CHARACTER 1 XVEDM          VOLUME EDM - Y/N
  | 1770 (6EA) CHARACTER 1 XDWHILECATON DSN WHILECATALOG
  |                                      ON - Y/N
  | 1771 (6EB) CHARACTER 1 XDWHILECATUX DSN WHILECATALOG
  |                                      UntilExpired- Y/N
  | 1772 (6EC) CHARACTER 0 RXRCEND        End of RXEXT
  

APAR Information

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

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

  UJ01640 UJ01641 UJ01642 UJ01644 UJ01645

Modules/Macros

• EDGRTVOL EDGHT01O EDGRTSCH EDGPT010 EDGDOC   EDGXRP15 EDGXRP35
  EDGRPTD  EDGRRPTE EDGRMMSD EDGRVEXT EDGHSKP  EDGRXEXT EDGSOCE
  EDGRDEXT EDGRMMCD EDGRMMSV EDGHT010 EDGRPTX  EDGXRPTX EDGRFSAR
  EDGAUTH  EDGMTSO  EDGTSO   EDGGR16
  

Fix information

• Fixed component name

  DFSMSRMM

• Fixed component ID

  5695DF186

Applicable component levels

• R23K PSY UJ01642

     UP19/12/24 P F912  

• R22K PSY UJ01645

     UP19/12/25 P F912  

• R240 PSY UJ01641

     UP19/12/24 P F912  

• R230 PSY UJ01640

     UP19/12/24 P F912  

• R220 PSY UJ01644

     UP19/12/25 P F912  

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.