PK08740: VARIOUS ENHANCEMENTS TO NAME SWAP PROCESSING.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR delivers various enhancements to address requirements
  MR0425026140, MR0823043817 and MR0823042318.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel      *
  *                 Reorganization for z/OS Version 3 Release 1  *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following new    *
  *                      functions:                              *
  *                      1. The disposition of the old original  *
  *                         data set can be selected by coding   *
  *                         the DISPOLDDS control statement.     *
  *                      2. The IDCAMS commands for manual name  *
  *                         swapping for secondary indexes can   *
  *                         be generated by coding the           *
  *                         SINDEXSUF=YES control statement.     *
  *                      3. The IDCAMS command stream for manual *
  *                         name swapping can be printed in a    *
  *                         separate data set by coding the      *
  *                         HPSGSWAP DD statement. The data set  *
  *                         can be used as the SYSIN for a       *
  *                         succeeding IDCAMS job step.          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  For details of each function, see the documentation in the
  COMMENTS section of this APAR.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS Version 3 Release 1 User's
  Guide (SC18-9228-00) will be changed as follows. The line that
  is added or modified is marked by a vertical bar ("|") on the
  left side of the line.
                             * * *
  Chapter 2. IMS Parallel Reorganization Driver
  2.6 JCL Requirements
  2.6.2 DD Statements
  The following entry is added to Table 2, "DD Statements and
  Record Format for the IPR Driver:"
    +--------------------------------------------------+
    | DDNAME   | Use    | Format            | Need     |
    +----------+--------+-------------------+----------+
  | | HPSGSWAP | Output | LRECL=80,RECFM=FB | Optional |
    +--------------------------------------------------+
  2.6.2.1 DD Names Common to All Processing Options
  | HPSGSWAP DD
  |    Defines the optional output data set that contains the
  |    IDCAMS command stream for data set name swapping. The
  |    command stream is produced only when manual name swapping
  |    is necessary. The data set is intended to be used as the
  |    SYSIN data set for the manual name swapping. No command
  |    stream is produced if the automated name swapping is
  |    performed.
  |
  2.7 Control Statements
  2.7.2 Control Statements for Reorganization Manager
  The following entries are added to Table 4, "Control Statements
  for Reorganization Manager:"
  | Keyword: DISPOLDDS
  | Acceptable Values: DELETE, NEWSHADOW, or TEMPNAME
  | Default: TEMPNAME
  | Description: Specifies the disposition of the original data
  |              sets after a successful reorganization.
  |              See "DISPOLDDS Control Statement."
  | Keyword: SINDEXSUF
  | Acceptable Value: YES or NO
  | Default: NO
  | Description: Specifies whether or not each shadow index name
  |              is assumed to be the original name plus a suffix.
  |              See "SINDEXSUF Control Statement."
  |
  2.7.8.8 DELOLDDS Control Statement
      ...
    If DELOLDDS=NO is specified, no data sets are deleted.
  |
  | If DISPOLDDS control statement is specified, the DELOLDDS
  | control statement is not allowed.
  |
  2.7.8.x DISPOLDDS Control Statement <<<new section>>>
  | The DISPOLDDS control statement specifies the disposition of
  | the original data sets after a successful reorganization.
  |
  | This control statement is optional. If you do not explicitly
  | specify this control statement, DISPOLDDS=TEMPNAME will be
  | used unless the default was changed by the installation
  | default option table. See Notes below.
  |
  |                  _TEMPNAME__
  | >>__DISPOLDDS=__|_DELETE____|__________________________><
  |                 |_NEWSHADOW_|
  |
  | If NAMESWAP=YES is specified, the old original data sets are
  | renamed to the temporary data set names first. If
  | DISPOLDDS=TEMPNAME is specified, the old data sets remain with
  | those temporary names. If DISPOLDDS=DELETE is specified, those
  | old data sets are deleted. If DISPOLDDS=NEWSHADOW is
  | specified, those temporary data sets are renamed to the shadow
  | names.
  |
  | DISPOLDDS=DELETE is allowed only when NAMESWAP=YES is
  | specified. Both DISPOLDDS=TEMPNAME and DISPOLDDS=NEWSHADOW can
  | be specified independent of NAMESWAP. If NAMESWAP=NO and
  | DISPOLDDS=NEWSHADOW are specified, a sequence of IDCAMS
  | commands for renaming the temporary data set names to the
  | shadow data set names are generated for use in manual name
  | swapping.
  |
  | The DISPOLDDS control statement and the DELOLDDS control
  | statement are mutually exclusive. DISPOLDDS=TEMPNAME has the
  | same meaning as DELOLDDS=NO, and DISPOLDDS=DELETE has the
  | same meaning as DELOLDDS=YES.
  |
  | Notes:
  | 1. The DISPOLDDS control statement is a functional replacement
  |    of the DELOLDDS control statement.
  | 2. The default value of the DISPOLDDS control statement can
  |    be changed. For details, see "Setting Installation
  |    Default Options."
  |
  2.7.8.x SINDEXSUF Control Statement <<<new section>>>
  | The SINDEXSUF control statement specifies whether or not the
  | name of each shadow secondary index is assumed to be the
  | original name plus a suffix.
  |
  | This control statement is optional. If you do not explicitly
  | specify this control statement, SINDEXSUF=NO will be used.
  |
  |                  _NO__
  | >>__SINDEXSUF=__|_YES_|__________________________________><
  |
  | SINDEXSUF=YES becomes effective, if all of the following
  | conditions are met:
  |  - DBRC is inactive
  |  - DYNALLOC=(xxx,xxx,NO) is specified.
  |  - INDEXBLD=YES,NEW is specified.
  |
  | If SINDEXSUF=YES is specified, it will be assumed that each
  | shadow secondary index has the data set name of the original
  | index plus a suffix and the IDCAMS control statements for
  | renaming shadow indexes to those original names are produced.
  | If SINDEXSUF=NO is specified, IPR Driver cannot know the name
  | of the original indexes under the above conditions; thus, no
  | IDCAMS control statement for renaming the shadow indexes to
  | the original name is produced.
  |
  | Note:
  |  - The default value of the SINDEXSUF control statement can be
  |    changed. For details, see "Setting Installation Default
  |    Options."
  |
  2.8 Reports and Statistics
  2.8.2 HPSOUT2 Data Set
  2.8.2.4 Data Set Information Report
     ...
     Figure 26 is an example of a Data Set Information report for
     a non-HALDB.
     ...
     DD NAME
  |     DD name for the data set or one of the following keywords:
  |     *ORG-(C), *ORG-(D), and *ORG-(I).
  |
  |     If INDEXBLD=YES,NEW is specified, the cluster name of the
  |     original secondary indexes and its component names are
  |     also printed in the Data Set Information report. The DD
  |     NAME field is filled with *ORG-(C) for the original
  |     cluster, *ORG-(D) for its data component, and *ORG-(I) for
  |     its index component. Those lines are not printed if DBRC
  |     is not active and SINDEXSUF=YES is not specified.
  |
     DATA SET NAME(S)
        Data set name for the data set. For a VSAM data set, both
        the cluster name and the component names are printed.
  |
  |     Note: If INDEXBLD=YES,NEW is specified and the original
  |     secondary index data set does not exist, the VSAM
  |     component names of the shadow index are printed as the
  |     component names of the original secondary index. This is
  |     because, in this case, only the cluster name of shadow
  |     secondary index is to be renamed to the original names by
  |     the name swap processing and the component names are not
  |     changed.
  |
     Figure 27 is an example of a Data Set Information report for
     a HALDB.
     ...
  2.9.2 Manual Name Swapping
    2. Create IDCAMS ALTER statements to swap the database data
       set names.
        You should refer to the sample ALTER commands written in
  |  HPSOUT2 data set. If you have specified the HPSGSWAP DD
  |  statement, the same command stream is written in the data set
  |  specified on the DD statement. The data set specified on the
  |  HPSGSWAP DD statement is intended to be used as the SYSIN for
  |  IDCAMS. You can use the command stream without change, or you
  |  can modify it to suit to your requirement. For a sample
  |  command stream, see "IDCAMS Command Stream for Name Swapping
  |  Report."
        For VSAM data sets, you must rename the cluster and
     component names together.
  6.2 Creating an Installation Default Option Table (HPSCOPTI)
    Defaults for the following options can be changed by creating
    an HPSCOPTI:
    - DECODEDBD option for the IPR Driver
    - DECODESXD option for the IPR Driver
  | - DISPOLDDS option for the IPR Driver
  | - SINDEXSUF option for the IPR Driver
        ...
  |
  6.4 How to Code HPSCOPT Macro Statements
    The option block H and I will be added for HPSCOPT DRIVER
    statement:
  |  H:
  |                   _TEMPNAME__
  |  >>__DISPOLDDS=__|_DELETE____|____________________________><
  |                  |_NEWSHADOW_|
  |
  |  I:
  |                   _NO__
  |  >>__SINDEXSUF=__|_YES_|__________________________________><
  |
  E.3 Messages
  E.3.2 HPSG Messages
     HPSG0212E n-th OPERAND MUST BE text
     Explanation: The n-th operand of the control statement must
     be specified as indicated by the string text. Text is one of
     the following:
     - EITHER YES OR NO
       ...
     - EITHER NO OR 'CATALOG_NAME'
  |  - ONE OF DELETE, NEWSHADOW, AND TEMPNAME
     Where, 'CATALOG_NAME' means the catalog name enclosed with
     apostrophes.
     ...
     HPSG0311I DATA SET FOR ORIGINAL SECONDARY INDEX: dbdname
               NOT FOUND
     Explanation: The original secondary index database dbdname
     data set is not found. If NAMESWAP=YES is specified, only the
     cluster name of the data set is renamed. If NAMESWAP=NO is
     specified, the IDCAMS command stream for renaming only the
     cluster name for the data set is generated in the IDCAMS
  |  Command Stream for Name Swapping report. For the VSAM
  |  component names printed in the Data Set Information report
  |  for the original index, see "Data Set Information Report"
  |  in topic 2.8.2.4.
     System Action: The IPR Driver continues processing.
     Programmer Response: If necessary, rename the component
     names. For details, see "Manual Name Swapping" in topic
     2.9.2. If you do not need to rename the component names,
     ignore this message.
  *
  |  HPSG0397E S-INDEX DATA SET NAME IS NOT SUFFIXED:
  |            DDNAME=ddname
  |  Explanation: The data set name specified for the DDNAME
  |  ddname is not suffixed. The cluster name of the shadow
  |  secondary index must be the name of the original secondary
  |  index plus a suffix if SINDEXSUF=YES is specified and the
  |  following conditions are met:
  |   - DBRC is inactive
  |   - DYNALLOC=(xxx,xxx,NO) is specified
  |   - INDEXBLD=YES,NEW is specified
  |  In other words, SINDEXSUF=YES is specified under the above
  |  conditions, the cluster name of the original secondary index
  |  is assumed to be the cluster name of the shadow secondary
  |  index without the last qualifier.
  |  System Action: The IPR Driver ends with a return code of 8.
  |  Programmer Response: First, check if the cluster name
  |  specified on the DD statement for ddname is correct. If you
  |  want to produce the command stream for the name swapping of
  |  secondary indexes, change the cluster name of the shadow
  |  secondary index so that the cluster name of the shadow
  |  secondary index will be the cluster name of the original
  |  secondary index with a last qualifier. If you do not need to
  |  produce the command stream for the name swapping of secondary
  |  indexes, remove the SINDEXSUF=YES control statement.
  

APAR Information

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

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

  UK05771

Modules/Macros

• HPSCOPT  HPSCOPTD HPSGCM00 HPSGCM20 HPSGCSC1
  HPSGGIOB HPSGGIO0 HPSGGRMB HPSGGRM0 HPSGMSGT HPSGRA00 HPSGRA10
  HPSGRM00 HPSGRS10 HPSGRS20 HPSGSTMT
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R310 PSY UK05771

     UP05/07/29 P F507

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.