A fix is available
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:
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