IBM Support

PM81411: NOTIFY.CA COMMAND NEEDS TO SUPPORT SETTING LSN, DSSN, LRID AND USID FIELDS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If an actual CA Command is executed, the proper values for the
    LSN, DSSN, LRID and USID fields are recorded, however when the
    DBRC NOTIFY.CA command is used there is no support to provide
    a value for these fields.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMS V13 DBRC users that have a need      *
    *                 to set values for LSN, DSSN, LRID, & USID    *
    *                 for CA record in RECON                       *
    ****************************************************************
    * PROBLEM DESCRIPTION: Provide NOTIFY.CA command support for   *
    *                      LSN, DSSN, LRID, & USID                 *
    ****************************************************************
    * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
    ****************************************************************
    There is a need to be able to set values for LSN, DSSN, LRID,
    and USID fields in change accum record to the RECON data set
    through the usage of DBRC NOTIFY.CA command.  This change will
    make CA record a more complete command instead of using zero
    values for these four fields. In addition, this change will
    include a new CMD flag in CA record whenever a CA is being
    created by a NOTIFY.CA command.
    

Problem conclusion

  • GEN:
    KEYWORDS:
    
    *** END IMS KEYWORDS ***
    Four new parameters, LSN, DSSN, LRID, and USID, have been added
    for the NOTIFY.CA command.
    
    >--NOTIFY.CA--CADSN(name) ...
    
    >--+-------------------+--------+-------------------+--------->
       |      .-,-----.    |        |       .-,-----.   |
       |      V       |    |        |       V       |   |
       '-LSN(-+-value-+-)--'        '-DSSN(-+-value-+-)-'
    
    >--+------------------+--------+-------------------+---------->
       |       .-,-----.   |        |       .-,-----.   |
       |       V       |   |        |       V       |   |
       '-LRID(-+-value-+-)-'        '-USID(-+-value-+-)-'
    
    The code has been changed for DBRC NOTIFY.CA LSN, DSSN, LRID,
    and USID command support.
    
    Macro DSPKWMAC, modules DSPKWTBL, DSPUCA00, DSPURT00, DSPURT30 &
    DSPURX00, along with copy files DSPCHGRC, DSPCM2RC, DSPEXTFM,
    and DSPPPQCA, have been changed.
    
    Module DSPURLB3 has been changed to display CMD flag in the
    RECON listing for a CA record that is being created by an
    external command.
    
    CA
    DSN=CADSN3                                       FILE SEQ=1
    CAGRP=CAGRP3       STOP    = 13.008 11:18:30.026544         *
                       UNIT=3400       VOLS DEF=1    VOLS USED=0
                                       VOLSER=...3
    RUN     = 13.008 11:18:30.559994                             CMD
     DBD=DIVNTZ04 DDN=DBHVSAM1 PURGETIME = 13.008 11:18:25.779996
       CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
       LSN    = 000000000001      DSSN   = 2147483646
       LRID   = FFFFFFFFFFFFFFFF  USID   = 2147483646
     DBD=DIVNTZ04 DDN=DBHVSAM2 PURGETIME = 13.008 11:18:25.779996
       CHANGES ACCUMULATED=YES COMPLETE CA=YES INDOUBT EEQES=NO
       LSN    = 000000000002      DSSN   = 2147483647
       LRID   = CCCCFFFFCCCCFFFF  USID   = 2147483647
    
    
    Module DSPAPQ31 along with macro file DSPAPQCA has been changed
    to provide DBRC API support by setting apqca_EXTCM to the value
    of chgEXTCM in DSPAPQ31. Apqca_EXTCM is the X'04' bit of the
    apqca_flags byte in the DSPAPQCA block.
    
    DSPEXTFM and DSPUCA00 used to be chained using 6 bytes and now
    chained using 8 bytes with the LSN values in the last 6 bytes.
    DSPURT30 expects LSN values to be chained using 8 bytes.
    
    ================================================================
    THE FOLLOWING TEXT DESCRIBES THE DOC CHANGE:
    ================================================================
    
    ZES1309900  Commands, Volume 3: IMS Component and z/OS Commands,
    has been updated to add the following to the NOTIFY.CA command:
    
    NOTIFY.CA COMMAND
    
    Syntax
    
     >--NOTIFY.CA--CADSN(name) ...
    
     >--+-------------------+--------+-------------------+--------->
        |      .-,-----.    |        |       .-,-----.   |
        |      V       |    |        |       V       |   |
        '-LSN(-+-value-+-)--'        '-DSSN(-+-value-+-)-'
    
     >--+------------------+--------+-------------------+---------->
        |       .-,-----.   |        |       .-,-----.   |
        |       V       |   |        |       V       |   |
        '-LRID(-+-value-+-)-'        '-USID(-+-value-+-)-'
    
    
    Keywords
    
     LSN(value)
       Optional keyword you use to specify the lock sequence number
       of the last change accumulated for the DBDS.
    
       The lock sequence number can be one of the following:
    
       * A hexadecimal number
    
         This number is 1 to 12 characters, enclosed in single
         quotation marks and preceded by the letter, X. For
         example: LSN(X'10B9C')
    
       * A decimal number
    
         This number is a decimal number from 0 to (2**48)-1,
         without delimiters. For example: LSN(68508)
    
     DSSN(value)
       Optional keyword you use to specify the data set sequence
       number of the last change accumulated for the DBDS.
    
       The data set sequence number can be as following:
    
       * A decimal number
    
         This number is a decimal number from 0 to (2**32)-1,
         without delimiters. For example: DSSN(68508)
    
     LRID(value)
       Optional keyword you use to specify the last log record ID of
       the last change accumulated for the DBDS.
    
       The last log record ID can be one of the following:
    
       * A hexadecimal number
    
         This number is 1 to 16 characters, enclosed in single
         quotation marks and preceded by the letter, X. For
         example: LRID(X'10B9C')
    
       * A decimal number
    
         This number is a decimal number from 0 to (2**64)-1,
         without delimiters. For example: LRID(68508)
    
     USID(value)
       Optional keyword you use to specify the last update set ID of
       the last change accumulated for the DBDS.
    
       The last update set ID can be as following:
    
       * A decimal number
    
         This number is a decimal number from 0 to (2**32)-1,
         without delimiters. For example: USID(68508)
    
    
    
    ZES1310700  Messages and Codes, Volume 2: Non-DFS Messages,
    has been updated to include four new keywords to MSGDSP0144I as
    following:
    
    DSP0144I
    
    The number of PURGLIST|LSN|USID|LRID|DSSN items specified in the
    NOTIFY command is greater than the number of database data sets
    defined (as group members) in the change accumulation (CAGROUP)
    record. This is not allowed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM81411

  • Reported component name

    IMS V13

  • Reported component ID

    5635A0400

  • Reported release

    300

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2013-01-24

  • Closed date

    2013-03-28

  • Last modified date

    2013-10-06

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

    PM77929

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

    UK93004

Modules/Macros

  • DSPAPQCA DSPAPQ31 DSPCHGRC DSPKWTBL DSPPPQCA
    DSPUCA00 DSPURLB3 DSPURT00 DSPURT30 DSPURX00
    

Fix information

  • Fixed component name

    IMS V13

  • Fixed component ID

    5635A0400

Applicable component levels

  • R300 PSY UK93004

       UP13/04/02 P F304

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020