A fix is available
APAR status
Closed as new function.
Error description
Bug Fix - Correct errors in BKRBRT validation of BEFORE / AFTER date and time stamp parameters. . . Bug fix - Detect and report unformatted DISKPOOL minidisks . Prior to this change, if a CMSFILE backup encounters a DISKPOOL minidisk which has not been initialized by the CMS "FORMAT" command, job processing may terminate abnormally. This change correctly detects and reports encounters with unformatted DISKPOOL minidisks. . When the CMS "ACCESS" command exits with an error during DISKPOOL minidisk selection, the condition continues to be reported by message 8969E: . BKRJOB8969E Return code <###> attempting to ACCESS <ownerid> <vdev> de <"FM">18,19 . A new message has been added. If ACCESS terminates with return code 100 (indicating the minidisk is not correctly formatted), message 9625W will be displayed: . BKRJOB9625W This minidisk may need to be initialized with the CMS "FORMAT" command. . This code change also detects and reports the case where a DISKPOOL minidisk has been formatted with an unsupported EDF file system block size. If a DISKPOOL minidisk has been initialized at a block size other than 4K (4,096 bytes), message 9626W will be displayed: . BKRJOB9626W <OwnerID> <VDev> is FORMATted with an EDF block size of <####>. BKRJOB9626W DISKPOOL minidisks must use a 4K (4,096 byte) block size BKRJOB9626W for reliable freespace estimation. . Bug fix - In some cases, backup jobs generated using SELECT RDEVVOL or SELECT RDEVVICE fail with an unitialized REXX variable NOVALUE trap when attempting to issue message BKRJOB9536I. . This change ensures that variable content for message BKRJOB9536I is correctly initialized. . . New Function - Resolves a customer requirement that all MDISKs in a backup job will be handled as DASD image backups, rather than shifting to CMS file-level backup when an EDF file system is identified. . A new backup job template variable has been added. Add "Config BKR_Job_Force_EDF_Image = 1" to the job template header section to enable this behavior. . New Message: BKRJOB9627I will be generated when this function is enabled. . BKRJOB9627I BKR_Job_Force_EDF_Image is ENABLED BKRJOB9627I All CMS EDF-format minidisks will be processed as DASD image backups. BKRJOB9627I NOTE: Results of this job cannot be used as the baseline reference for a future incremental backup. . . Usability - Message BKRSTA9562I content changed for clarification . Prior to this change, if BKRSYSTM CONFIG did not define a value for BKR_Startup_TapeManager, line 6 of message 9562I would indicate this condition by reporting... . BKRSTA9562I Tape Manager interface: undefined / not configured . ...during first-stage service virtual machine initialization. . Service virtual machines which require TAPCMD MODULE to be present in order to use IBM Tape Manager for z/VM confirm availability of the client interface routine during second-stage initialization. . This change expands information reported in line 6 of message 9562I. . . Constraint relief: Maximum 3390-A / EAV DASD volume size increased from 262,668 cylinders to 1,182,006 cylinders. . Prior to this change, attempts to perform an ECKD DASD image backup of an EAV 3390 DASD extent fail with this message... . BKRCDD8178E BKRRTRK return code 48 trying to read track 3940035. . This change increases the maximum 3390-A EAV volume size to 1,182,006 cylinders (1TB), the maximum currently supported by z/VM, z/OS, and current-gen storage subsystems. . . New Function - A new message has been added to the end-of-job (EOJ) summary report to document job name and instance, total task count, and maximum task return code encountered during job processing. . BKRJOB9628I <jobname> <instance> summary: Task count <count>, maximum task rc 0. . BKRJOB9628W <jobname> <instance> summary: Task count <count>, maximum task rc <rc>. . When the maximum return code for all tasks is zero (0), message 9628 will be issued with severity code I (Informational). When the maximum return code is greater than 0, message 9628 will be issued with severity code W (Warning).
Local fix
Problem summary
**************************************************************** * PROBLEM DESCRIPTION: Usability; ECKD DASD constraint relief * **************************************************************** Bug Fix - Correct errors in BKRBRT validation of BEFORE / AFTER date and time stamp parameters. Bug fix - Detect and report unformatted DISKPOOL minidisks Prior to this change, if a CMSFILE backup encounters a DISKPOOL minidisk which has not been initialized by the CMS "FORMAT" command, job processing may terminate abnormally. This change correctly detects and reports encounters with unformatted DISKPOOL minidisks. When the CMS "ACCESS" command exits with an error during DISKPOOL minidisk selection, the condition continues to be reported by message 8969E: BKRJOB8969E Return code <###> attempting to ACCESS <ownerid> <vdev> <"FM"> A new message has been added. If ACCESS terminates with return code 100 (indicating the minidisk is not correctly formatted), message 9625W will be displayed: BKRJOB9625W This minidisk may need to be initialized with the CMS "FORMAT" command. This code change also detects and reports the case where a DISKPOOL minidisk has been formatted with an unsupported EDF file system block size. If a DISKPOOL minidisk has been initialized at a block size other than 4K (4,096 bytes), message 9626W will be displayed: BKRJOB9626W <OwnerID> <VDev> is FORMATted with an EDF block size of <####>. BKRJOB9626W DISKPOOL minidisks must use a 4K (4,096 byte) block size BKRJOB9626W for reliable freespace estimation. Bug fix - In some cases, backup jobs generated using SELECT RDEVVOL or SELECT RDEVVICE fail with an uninitialized REXX variable NOVALUE trap when attempting to issue message BKRJOB9536I. This change ensures that variable content for message BKRJOB9536I is correctly initialized. New Function - Resolves a customer requirement that all MDISKs in a backup job will be handled as DASD image backups, rather than shifting to CMS file-level backup when an EDF file system is identified. A new backup job template variable has been added. Add "Config BKR_Job_Force_EDF_Image = 1" to the job template header section to enable this behavior. New Message: BKRJOB9627I will be generated when this function is enabled. BKRJOB9627I BKR_Job_Force_EDF_Image is ENABLED BKRJOB9627I All CMS EDF-format minidisks will be processed as DASD image backups. BKRJOB9627I NOTE: Results of this job cannot be used as the baseline reference for a future incremental backup. Usability - Message BKRSTA9562I content changed for clarification Prior to this change, if BKRSYSTM CONFIG did not define a value for BKR_Startup_TapeManager, line 6 of message 9562I would indicate this condition by reporting... BKRSTA9562I Tape Manager interface: undefined / not configured ...during first-stage service virtual machine initialization. Service virtual machines which require TAPCMD MODULE to be present in order to use IBM Tape Manager for z/VM confirm availability of the client interface routine during second-stage initialization. This change expands information reported in line 6 of message 9562I. Constraint relief: Maximum 3390-A / EAV DASD volume size increased from 262,668 cylinders to 1,182,006 cylinders. Prior to this change, attempts to perform an ECKD DASD image backup of an EAV 3390 DASD extent fail with this message... BKRCDD8178E BKRRTRK return code 48 trying to read track 3940035. This change increases the maximum 3390-A EAV volume size to 1,182,006 cylinders (1TB), the maximum currently supported by z/VM, z/OS, and current-gen storage subsystems. New Function - A new message has been added to the end-of-job (EOJ) summary report to document job name and instance, total task count, and maximum task return code encountered during job processing. BKRJOB9628I <jobname> <instance> summary: Task count <count>, maximum task rc 0. BKRJOB9628W <jobname> <instance> summary: Task count <count>, maximum task rc <rc>. When the maximum return code for all tasks is zero (0), message 9628 will be issued with severity code I (Informational). When the maximum return code is greater than 0, message 9628 will be issued with severity code W (Warning).
Problem conclusion
Temporary fix
Comments
APAR Information
APAR number
PH36382
Reported component name
BACKUP RESTORE
Reported component ID
5697J0600
Reported release
130
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2021-04-16
Closed date
2021-04-16
Last modified date
2021-08-16
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI74967
Modules/Macros
BKRBRT BKRJOBEX BKRSTART BKRUME BKRUMEB DUMPCKD EUMBKRMT EUMDRMNT LOADCKD RELOAD
Fix information
Fixed component name
BACKUP RESTORE
Fixed component ID
5697J0600
Applicable component levels
R130 PSY UI74967
UP21/05/07 P 2105
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.
[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSMR4R","label":"Backup and Restore Manager for z\/VM"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130"}]
Document Information
Modified date:
17 August 2021