IBM Support

SE64328 - BRM-MAINT-INCORROUT FIXES-JUNE 2016

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 APAR (Authorized Program Analysis Report)

Abstract

BRM-MAINT-INCORROUT FIXES-JUNE 2016

Error Description

Please load and apply the BRMS 2016 June PTF.                  

Problem Summary

It is important to keep all systems in a BRMS network at the    
same level of BRMS PTFs.                                        
Fixes included in this PTF may reference enhancements. More    
information on these enhancements can be found on the BRMS web  
page:                                                          
www.ibm.com/developerworks/ibmi/brms                            
Additionally also review the media web page:                    
www.ibm.com/developerworks/ibmi/media                          
                                                               
Fixes in this PTF:                                              
1. In 7.1 and later, when the Start Backup using BRM (STRBKUBRM)
command is used to save data to parallel media,  message        
MSGBRM1148 may be sent and incorrectly contain sequence number  
0000.                                                          
2. In 7.1 and later, the Add Media to BRM (ADDMEDBRM) command  
may incorrectly fail with MSGBRM9999.                          
3. N/A.                                                        
4. In 7.1 and later, when the Add Media to BRM (ADDMEDBRM)      
command is used to add a non-labelled tape to the BRMS media    
inventory and *YES is specified for the Initialize media (INZ)  
parameter, the command incorrectly fails with message          
MSGBRM1694.                                                    
5. In 7.1 and later, when the Initialize BRMS (INZBRM) command  
is run with *RUNPRDINZ specified for the Option (OPTION)        
parameter after a prior run of INZBRM OPTION(*RUNPRDINZ) failed,
BRMS may lose data.                                            
6. In 7.1 and later, the Save Library using BRM (SAVLIBBRM)    
command may incorrectly fail with message MSGCPF3711, MSGCPF38AA
or MSGCPD0071.                                                  
7. In 7.2 and later, when the Work with Media Information      
(WRKMEDIBRM) command is run and option 9=Work with saved objects
is specified for a *SAVSPLF saved item, and then Option        
7=Specify object is specified to restore spooled file objects,  
the option may fail with message MSGCPF3C81.                    
8. In 7.1 and later, BRMS APIs set the Bytes Available field    
incorrectly in the QusEC_t error code structure when an API ends
in error.                                                      
9. In 7.1 and later, when the Start Backup using BRM (STRBKUBRM)
command is used to save detached journal receivers using        
*ALLDTCRCV, it may fail with message MSGCPF9820 or MSGCPF9802.  
10. In 7.1 and later, when the Remove Media Volumes from BRM    
(RMVMEDBRM) command is used to remove media which does not exist
in the BRMS inventory, it will fail with message MSGBRM1147 and
the volume name in the message will be blank.                  
11. In 7.1 and later, steps "Recovery Operating System" and    
"Verify System Information" in the recovery report (QP1ARCY)    
have been enhanced to include information about system values  
from the saved system.                                          
12. In 7.1 and later, when the Start Recovery using BRM        
(STRRCYBRM) command is run with *APYJRNCHG specified for the    
(OPTION) parameter and *RESTORE specified for the (ACTION)      
parameter and there are more than 3250 saved journal objects,  
the command fails with message MSGRNQ0100.                      
13. In 7.1 and later, the Work with Control Groups (WRKCTLGBRM)
command does not display *IBM control group entry omits that    
were added using the BRMS GUI client.                          
14. In 7.1 and later, when incremental backups are run with    
*INCR specified for Incremental type, the backup may use an    
incorrect reference date and time.                              
15. In 7.1 and later, when the Start Recovery using BRM        
(STRRCYBRM) command is run with *APYJRNCHG specified for the    
(OPTION) parameter and *RESTORE specified for the (ACTION)      
parameter and more than 300 of the saved objects were journaled,
the command fails with message MSGCPD0046.                      
16. In 7.1 and later, the Start Maintenance for BRM (STRMNTBRM)
command may not expire volumes when expected.                  
17. In 7.1 and later, during an upgrade from release 7.1 to 7.1
or later when the Initialize BRMS (INZBRM) command is run with  
*RUNPRDINZ specified for the Option (OPTION) parameter, it may  
fail with message MSGMCH3601.                                  
18. In 7.1 and later, when the Save Save Files using BRM        
(SAVSAVFBRM) command is run and the save file is in use by      
another job, the save fails with message MSGCPF9899 instead of  
message MSGCPF3218.                                            
19. In 7.1 and later, when a user that has operator functional  
authority runs the Work Media Information (WRKMEDIBRM) command  
and specifies option 9=Work with saved objects saved objects and
then specifies option 4=Remove, the remove operation does not  
fail as expected.                                              
20. In 7.1 and later, when a library is restored using the BRMS
GUI client, the restore may incorrectly fail with message      
MSGSQL0104 or message MSGCPF6708.                              
21. In 7.1 and later, when the Work with Media Information      
(WRKMEDIBRM) command is run and then option 7=Restore is used to
restore from tape media, the restore may loop with message      
MSGCPF410B.                                                    
22. In 7.1 and later, when the Work with Media Information      
(WRKMEDIBRM) command is run with *LAST specified for Entries to
be displayed first (START) parameter and then options are      
specified for the Opt field and the Page Up key is pressed, the
options that were specified may be lost.                        
23. In 7.1 and later, the BRMS flight recorder files in        
integrated file system (IFS) directory '/tmp/BRMS' are          
incorrectly eligible to be archived.                            
24. In 7.1 and later, restores from Tivoli Storage Manager (TSM)
may fail with messages MSGCPFB8C7 and MSGCPD0014.              
25. N/A.                                                        
26. In 7.1 and later, when libraries are saved with object      
detail and the FlashCopy time is set, the saves may take a long
time to complete.                                              
27. In 7.1 and later, when the Work with Saved Spooled Files    
(WRKSPLFBRM) command is run and there are more than 9999 spooled
files and then F16=Select all for recovery is pressed, the      
selection fails with message MSGBRM3C90.                        
28. In 7.1 and later, when the Save Save Files using BRM        
(SAVSAVFBRM) command is run, it may incorrectly fail with      
message MSGBRM1499.                                            
29. In 7.1 and later, the BRMS GUI client Save Size column in  
the Backup Status table displays numbers in the wrong format.  
30. In 7.1 and later, when the Start Backup using BRM          
(STRBKUBRM) command is run for a control group that contains an
*ALLUSR entry and indicates to save to parallel tape media, the
QUSRBRM library may not be included in the backup.              
31. In 7.1 and later, when the Work with Control Groups        
(WRKCTLGBRM) command is run, option 2 is selected to Edit      
entries and a new control group entry is added, the default    
values for the Parallel Type, Private Authorities, and Encrypt  
fields may be incorrect.                                        
32. N/A                                                        
33. In 7.1 and later, if saves create parallel media sets and  
span volumes, restores from the media sets may fail with one of
several different messages, for example MSGCPF387C, MSGBRM3015,
MSGCPF3780, MSGCPA6798, etc and the recovery report (QP1ARCY)  
may be missing volumes. Once this PTF has been applied, running
Start Maintenance using BRM (STRMNTBRM) will correct existing  
save information or the following command can be run to correct
existing save information:                                      
        CALL PGM(QBRM/Q1AOLD) PARM('CLEANHS   ' 'FIXPRLSPAN')  
34. In 7.1 and later, if the BRMS GUI client is used to enter a
mixed case password for an Enterprise node, connections to the  
node will fail with message MSGCPF9190.                        
35. In 7.1 and later, when the Work with Control Groups        
(WRKCTLGBRM) command is run and a control group entry fails with
message MSGCPF387A, the control group ends abnormally instead of
continuing to the next control group entry.                    
36. In 7.1 and later, when the Work with Control Groups        
(WRKCTLGBRM) command is run, option 2 is selected to Edit      
entries and a new control group entry is added, omits from      
existing entries may be applied to the new entry and/or removed
from the existing entry.                                        

Problem Conclusion

Load and apply this PTF.                                        
                                                               
Note: When loading BRMS PTFs, the system needs to be out of    
FlashCopy mode for the PTF to apply.                            
To verify the FlashCopy status of a system is *END, enter the  
following command:                                              
   CALL PGM(QBRM/Q1AOLD) PARM('FLSSYSSTS ' '*DISPLAY')          
                                                               
After the BRMS PTF is installed, do the following to enable the
BRMS plug-in for the IBM Systems Director Navigator for i5/OS  
(web browser) or System i Navigator windows client.            
                                                               
  Enable the BRMS plug-in for the IBM Systems Director Navigator
  for i5/OS.                                                    
  ==== V6R1 and newer only:                                    
  Note:  ending the http admin servers may affect other non-BRMS
  users.                                                        
  From System i:                                                
    1. Enter the command to end the http admin servers:        
      ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)                  
    2. Wait for the http admin server jobs to end or terminate  
  them.                                                        
      Use command:  WRKACTJOB SBS(QHTTPSVR)                    
    3. Restart the http admin servers:                          
      STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)                  
                                                               
                                                               
----------------------------------------------------------------
  ------------------------------------                          
                                                               
  Enable the BRMS plug-in for System i Navigator Windows/OS    
  client.                                                      
  ==== Pre-V6R1:                                                
  1) Close the System i Navigator application.                  
  2) On the client/PC, uninstall the BRMS plug-in using the    
Client                                                          
                                                               
      Access Express "Selective Setup" utility:  from the      
Windows                                                        
      "Start", select                                          
      "Programs->IBM iSeries Access for Windows->Selective      
Setup".                                                        
                                                               
      Follow the instructions on the dialogs to uninstall the  
BRMS                                                            
                                                               
      plug-in.  Notes:                                          
      a) On the second dialog, select the radio button "Ignore.
I'm                                                            
        only going to UN-install components".                  
      b) On the next screen, "Component Selection", open the    
        System i Navigator folder; a list of all installed      
        System i Navigator components and plug-ins is displayed.
      c) Deselect the BRMS plug-in to uninstall it (if you do  
not                                                            
        see the BRMS plug-in, it was not properly installed);  
        reboot the PC if requested.                            
  3) Start System i Navigator.                                  
  4) Use the System i Navigator "Install Options->Install      
Plug-in"                                                        
      action. This action is available from the main iSeries    
      Navigator "File" menu and the "My Connections" folder    
      context/pop-up menu.  When prompted for the iSeries system
      to install from, select the iSeries that has the new BRMS
      PTF installed.                                            
                                                               
  === V6R1 and newer:                                          
  1) Close the System i Navigator application.                  
  2) Open a Windows Command Prompt screen.                      
  3) Enter the following command:                              
      cwbinplg /REMOVE=IBM.BRMSPlugin                          
  4) On the client/PC, start the iSeries Navigator.            
  5) Use the System i Navigator "Install Options->Install      
Plug-in"                                                        
      action. This action is available from the main System i  
      Navigator "File" menu and the "My Connections" folder    
      context/pop-up menu.  When prompted for the iSeries system
      to install from, select the iSeries that has the new BRMS
      PTF installed.                                            

Temporary Fix

Comments

Circumvention


PTFs Available

R710 SI59996 PTF Cover Letter   6320
R720 SI59998 PTF Cover Letter   6306
R730 SI59997 PTF Cover Letter   6299

Affected Modules

         
         

Affected Publications

Summary Information

Status............................................ CLOSED UR1
HIPER........................................... No
Component.................................. 5770BR100
Failing Module.......................... RCHMGR
Reported Release................... R710
Duplicate Of..............................




System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0"},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15Q","label":"APARs - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0;V7R2M0;V7R3M0;V9R9M9","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 December 2016