IBM Support

SI59997 - BRM-MAINT-INCORROUT Fixes-June 2016

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

BRM-MAINT-INCORROUT Fixes-June 2016


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
NONE



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.


APAR Error Description / Circumvention

-------------------------------------------------
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.

CORRECTION FOR APAR 'SE64328' :
-------------------------------
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.

CIRCUMVENTION FOR APAR 'SE64328' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

Please end all BRMS jobs before applying 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)


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI60601      BRM-RECOVERY-THREADS-MSGCPF3878C BRMS RESTORE FROM PARALLEL
   SI57903      BRM-MAINT-INCORROUT Fixes-March 2016
   SI57903      BRM-MAINT-INCORROUT Fixes-Dec 2015

Summary Information

System..............................i
Models..............................
Release.............................V7R3M0
Licensed Program...............5770BR1
APAR Fixed..........................View details for APAR SE64328
Superseded by:......................View fix details for PTF SI75083
Recompile...........................N
Library.............................QBRM
MRI Feature ........................NONE
Cum Level...........................C6299730


IBM 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, 2018, 2019, 2020, 2021 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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3","Product":{"code":"SG15V","label":"PTF Cover Letters - IBM i General"},"Component":"5770BR1","Edition":""},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3","Product":{"code":"SG16H","label":"PTF Cover Letters - IBM i 7.3"},"Component":"5770BR1","Edition":""}]

Document Information

Modified date:
14 April 2021