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 V11 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:
================================================================
SC19243200 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).
GC18971302 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.