A fix is available
APAR status
Closed as program error.
Error description
This update includes the following enhancements and fixes to the DFSMShsm Conversion Assist feature: . 1. Support for FDR/ABR has been added. This includes a JCL to import the FDR data set list into a pair of CIF datasets, and a JCL template that is used to generate FDR restore commands. . 2. The HSM commands generated by DCA can now be forced to include the WAIT parameter. This causes the commands to be executed synchronously one after another. As a side effect, the overall conversion time increases. A new parameter has been added to the ConvParm panel to control the addition of the WAIT keyword to HSM commands. . 3. It is now possible to specify the TARGET parameter for BACKDS commands. The value can be changed on the ConvParm panel, the parameter named Target Device for Backups. . 4. If a backup had an expiration date in the original data management system, the BACKDS command for that dataset receives an additional parameter, RETAINDAYS, that sets the expiration date to the same value as it was in the original system. The value is computed automatically based off the expiration date and back-up date taken from CIF. . 5. DCA relies on the ability of HSM to re-order backup versions according to the date and time specified in the BACKDS commands. Unfortunately this automatic reordering is limited by a certain number of backup versions for a specific data set. Upon reaching the limit, all the subsequent backup versions that have the RETAINDAYS parameter must be backed up in the oldest-to-newest order. RETAINDAYS is used whenever the corresponding version in the source DMS have an expiration date set. . Starting with this update, DCA automatically detects the data sets whose backups cannot be reordered automatically by HSM, and performs synchronous back-up (using HSEND WAIT) of those versions in the oldest-to-newest order. This slows down the conversion of certain data sets, but allows to convert all the retained versions correctly. The data sets that are within limits are converted as usual. . 6. A new panel, Advanced Parameters, has been added to the Conversion menu. This panel contains the parameters that normally need not be changed. . 7. The JCL template ARHJCCA1 had an incorrect backreference *.RCLxx.SYSPRINT. The backreference would fail the JCL execution because the step RCLxx invokes a procedure. The backreference has been modified to refer to the step CLNxx. . 8. The old version of the program ARHCIFCA relied on the volume serial to determine what datasets are "archives" and what are "backups". The updated version additionally checks for the device type. . 9. The program ARHCIFCA now issues some informational/status messages during the work. This allows to track the progress and also provides some statistical information about the CIF datasets. . 10. When the final page of the CA restore job log contains only a report header without actually restored items, the parsing process will fall into an incorrect state and try to read more from the log even though the end of log has been reached. Then it will cause a read error and a subsequent abend. . Now the parsing process has been improved to handle such a situation correctly. . 11. The HSM Monitor (step HSMxx in the conversion JCLs) now waits until all the submitted HSM commands have been executed. . 12. Support for MCBR records has been added to the program MXH35000. A MCBR is a record in BCDS. It is used by HSM when there are retained backup copies (having an expiration date) that do not fit in a single MCB record. Before this update, the backup copies registered in MCBRs would have been reported as "failed". Starting with this update, the status of such backups is reported correctly. . 13. The patch described in APAR OA45878 has been added to the HSMPatch panel. . 14. The messages documentation has been updated to reflect all recent changes.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Users. * **************************************************************** * PROBLEM DESCRIPTION: This update includes the following * * enhancements and fixes to the DFSMShsm * * Conversion Assist feature: * * * * 1. Support for FDR/ABR has been added. * * This includes a JCL to import the FDR * * data set list into a pair of CIF * * datasets, and a JCL template that is * * used to generate FDR restore commands. * * * * 2. The HSM commands generated by DCA * * can now be forced to include the WAIT * * parameter. This causes the commands to * * be executed synchronously one after * * another. As a side effect, the overall * * conversion time increases. A new * * parameter has been added to the * * ConvParm panel to control the addition * * of the WAIT keyword to HSM commands. * * * * 3. It is now possible to specify the * * TARGET parameter for BACKDS commands. * * The value can be changed on the * * ConvParm panel, the parameter named * * Target Device for Backups. * * * * 4. If a backup had an expiration date * * in the original data management * * system, the BACKDS command for that * * dataset receives an additional * * parameter, RETAINDAYS, that sets the * * expiration date to the same value as * * it was in the original system. The * * value is computed automatically based * * off the expiration date and back-up * * date taken from CIF. * * * * 5. DCA relies on the ability of HSM to * * re-order backup versions according to * * the date and time specified in the * * BACKDS commands. Unfortunately this * * automatic reordering is limited by a * * certain number of backup versions for * * a specific data set. Upon reaching the * * limit, all the subsequent backup * * versions that have the RETAINDAYS * * parameter must be backed up in the * * oldest-to-newest order. RETAINDAYS is * * used whenever the corresponding * * version in the source DMS have an * * expiration date set. * * * * Starting with this update, DCA * * automatically detects the data sets * * whose backups cannot be reordered * * automatically by HSM, and performs * * synchronous back-up (using HSEND WAIT) * * of those versions in the * * oldest-to-newest order. This slows * * down the conversion of certain data * * sets, but allows to convert all the * * retained versions correctly. The data * * sets that are within limits are * * converted as usual. * * * * 6. A new panel, Advanced Parameters, * * has been added to the Conversion menu. * * This panel contains the parameters * * that normally need not be changed. * * * * 7. The JCL template ARHJCCA1 had an * * incorrect backreference * * *.RCLxx.SYSPRINT. The backreference * * would fail the JCL execution because * * the step RCLxx invokes a procedure. * * The backreference has been modified * * to refer to the step CLNxx. * * * * 8. The old version of the program * * ARHCIFCA relied on the volume serial * * to determine what datasets are * * "archives" and what are "backups". * * The updated version additionally * * checks for the device type. * * * * 9. The program ARHCIFCA now issues * * some informational/status messages * * during the work. This allows to track * * the progress and also provides some * * statistical information about the CIF * * datasets. * * * * 10. When the final page of the CA * * restore job log contains only a report * * header without actually restored * * items, the parsing process will fall * * into an incorrect state and try to * * read more from the log even though the * * end of log has been reached. Then it * * will cause a read error and a * * subsequent abend. * * * * Now the parsing process has been * * improved to handle such a situation * * correctly. * * * * 11. The HSM Monitor (step HSMxx in * * the conversion JCLs) now waits until * * all the submitted HSM commands have * * been executed. * * * * 12. Support for MCBR records has been * * added to the program MXH35000. A MCBR * * is a record in BCDS. It is used by * * HSM when there are retained backup * * copies (having an expiration date) * * that do not fit in a single MCB * * record. Before this update, the backup * * copies registered in MCBRs would have * * been reported as "failed". Starting * * with this update, the status of such * * backups is reported correctly. * * * * 13. The patch described in APAR * * OA45878 has been added to the * * HSMPatch panel. * * * * 14. The messages documentation has * * been updated to reflect all recent * * changes. * **************************************************************** * RECOMMENDATION: * ****************************************************************
Problem conclusion
Temporary fix
Comments
APAR Information
APAR number
PI73860
Reported component name
TIV ADV RPT-TEP
Reported component ID
5698A9801
Reported release
260
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-12-15
Closed date
2016-12-22
Last modified date
2017-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI43521
Modules/Macros
ARHAC050 ARHAC051 ARHAC052 ARHAC053 ARHAC060 ARHAC061 ARHAC062 ARHAC067 ARHAC068 ARHAC069 ARHAC071 ARHAI025 ARHAM002 ARHAR014 ARHAU008 ARHAU009 ARHCACMN ARHCARCL ARHCIFCA ARHCIFFD ARHC50 ARHC51 ARHC52 ARHC53 ARHC54 ARHC56 ARHC61 ARHC62 ARHC63 ARHC65 ARHC68 ARHC69 ARHC70 ARHDC0 ARHJCCA1 ARHJCFD1 ARHJCIF1 ARHJCIF2 ARHMCALC ARHMCCMN ARHMCCSI ARHMCQSM ARHMCUTL ARHMONTR ARHRCLCA ARHRCLFD ARH35000 ARH35025 HARH260J
Fix information
Fixed component name
TIV ADV RPT DFS
Fixed component ID
5698A9800
Applicable component levels
R260 PSY UI43521
UP17/01/04 P F701
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"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"260","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 February 2017