IBM Support

SI59996 - 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  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5770SS1  710  SI47250   00/00    0000
DIST 5770BR1  710  SE52441   NONE     0000 (SEE MRI PTF/FIX LIST BELOW)

MRI PTF/FIX LIST
----------------
APAR SE52441 AFFECTS THESE LANGUAGES.  IF YOU HAVE ANY OF THESE
LANGUAGES INSTALLED, INSTALL THE DISTRIBUTION REQUISITE MRI PTF THAT
CORRESPONDS TO THE LANGUAGE(S) INSTALLED ON YOUR SYSTEM.
-----------------------------------------------------------------
:  FEATURE                                   LICENSED  PTF/FIX  :
:  CODE     LANGUAGE                         PROGRAM   NUMBER   :
:  -------  -------------------------------  --------  -------  :
:  2924     ENGLISH UPPER/LOWER CASE SBCS    5770BR1   SI47215  :
:  2902     ESTONIAN                         5770BR1   SI47496  :
:  2903     LITHUANIAN                       5770BR1   SI47497  :
:  2904     LATVIAN                          5770BR1   SI47498  :
:  2905     VIETNAMESE                       5770BR1   SI47499  :
:  2906     LAO                              5770BR1   SI47500  :
:  2909     BELGIAN ENGLISH                  5770BR1   SI47501  :
:  2911     SLOVENIAN                        5770BR1   SI47502  :
:  2912     CROATIAN                         5770BR1   SI47218  :
:  2913     MACEDONIAN                       5770BR1   SI47503  :
:  2914     SERBIAN                          5770BR1   SI47504  :
:  2922     PORTUGUESE                       5770BR1   SI47219  :
:  2923     DUTCH                            5770BR1   SI47220  :
:  2925     FINNISH                          5770BR1   SI47505  :
:  2926     DANISH                           5770BR1   SI47506  :
:  2928     FRENCH                           5770BR1   SI47221  :
:  2929     GERMAN                           5770BR1   SI47222  :
:  2930     JAPAN LOWER CASE                 5770BR1   SI47223  :
:  2931     SPANISH                          5770BR1   SI47224  :
:  2932     ITALIAN                          5770BR1   SI47507  :
:  2933     NORWEGIAN - BOKMAL               5770BR1   SI47509  :
:  2937     SWEDISH                          5770BR1   SI47510  :
:  2938     ENGLISH UPPER CASE DBCS          5770BR1   SI47225  :
:  2939     SWISS GERMAN                     5770BR1   SI47226  :
:  2940     SWISS FRENCH                     5770BR1   SI47227  :
:  2942     SWISS ITALIAN                    5770BR1   SI47513  :
:  2954     ARABIC                           5770BR1   SI47228  :
:  2956     TURKISH                          5770BR1   SI47514  :
:  2957     GREEK                            5770BR1   SI47515  :
:  2958     ICELANDIC                        5770BR1   SI47516  :
:  2961     HEBREW                           5770BR1   SI47517  :
:  2962     JAPANESE                         5770BR1   SI47229  :
:  2963     BELGIUM DUTCH                    5770BR1   SI47230  :
:  2966     BELGIUM FRENCH                   5770BR1   SI47231  :
:  2972     THAI                             5770BR1   SI47518  :
:  2974     BULGARIAN                        5770BR1   SI47519  :
:  2975     CZECH                            5770BR1   SI47232  :
:  2976     HUNGARIAN                        5770BR1   SI47233  :
:  2978     POLISH LANGUAGE                  5770BR1   SI47234  :
:  2979     RUSSIAN                          5770BR1   SI47235  :
:  2980     BRAZILIAN PORTUGUESE             5770BR1   SI47520  :
:  2981     CANADIAN FRENCH                  5770BR1   SI47236  :
:  2984     ENGLISH UPPER/LOWER CASE DBCS    5770BR1   SI47237  :
:  2986     KOREAN                           5770BR1   SI47238  :
:  2987     TRADITIONAL CHINESE              5770BR1   SI47521  :
:  2989     SIMPLIFIED CHINESE               5770BR1   SI47522  :
:  2992     ROMANIAN                         5770BR1   SI47239  :
:  2994     SLOVAKIAN                        5770BR1   SI47523  :
:  2995     ALBANIAN                         5770BR1   SI47524  :
:  2996     PORTUGUESE MNCS                  5770BR1   SI47240  :
:  2998     FARSI                            5770BR1   SI47539  :
-----------------------------------------------------------------




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.
37. In 7.1, the recovery report (QP1ARCY) indicates to restore
BRMS save files on independent auxiliary storage pools (IASP) in
step 'Recover the BRMS Product and Associated Libraries' before
IASPs have been configured. The save files should be included in
step 'Recover IBM Product Libraries'.

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

All BRMS jobs must be ended 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)

All BRMS activity must be stopped while this ptf is

being applied and users must signoff and on again

before using BRMS after the ptf is applied.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI60599      BRM-RECOVERY-THREADS-MSGCPF3878C BRMS RESTORE FROM PARALLEL
   SI58958      BRM-MAINT-INCORROUT Fixes-March 2016
   SI57830      BRM-MAINT-INCORROUT Fixes-Dec 2015
   SI57979      BRM PROBLEM REMOVING SYSTEM FROM BRMS NETWORK
   SI57979      BRM-MEDIA-LOOP WHEN APPENDING SAVES TO DUPLICATE MEDIA USING
   SI57213      BRM-MAINT-INCORROUT Fixes-Sept 2015
   SI56275      BRM-MAINT-INCORROUT  Fixes
   SI55621      BRM-MAINT-INCORROUT  Fixes
   SI54786      BRM-MAINT-INCORROUT  Fixes
   SI53305      BRM-MAINT-INCORROUT  Fixes
   SI52670      BRM-MAINT-INCORROUT  Fixes
   SI51667      BRM-MAINT-INCORROUT  Fixes
   SI51029      BRM-MAINT-INCORROUT  Fixes
   SI50292      BRM-MAINT-INCORROUT  Fixes
   SI50292      BRM-MAINT-INCORROUT  Fixes
   SI50292      BRM-MAINT-INCORROUT  Fixes
   SI49719      BRM-MAINT-INCORROUT  Fixes
   SI48969      BRM-MAINT-INCORROUT  Fixes
   SI47935      BRM-MAINT-INCORROUT  Fixes
   SI47039      BRM-MAINT-INCORROUT  Fixes
   SI46340      BRM-MAINT-INCORROUT  Fixes
   SI45327      BRM-MAINT-INCORROUT  Fixes
   SI44710      BRM-MAINT-INCORROUT  Fixes
   SI43868      BRM-MAINT-INCORROUT  Fixes
   SI42925      BRM-MAINT-INCORROUT  Fixes
   SI42066      BRM-MAINT-INCORROUT  Fixes
   SI42449      BRM-BACKUP-INCORROUT OWNERSHIP OF MEDIA IS CHANGED AFTER BAC
   SI41206      BRM-MAINT-INCORROUT  Fixes
   SI40005      BRM-MAINT-INCORROUT  Fixes
   SI40005      BRM-MAINT-INCORROUT  Fixes
   SI38740      BRM-MAINT-INCORROUT  Fixes
   SI38740      BRM-MAINT-INCORROUT  Fixes
   SI37987      BRM-MAINT-INCORROUT  Fixes
   SI37264      BRM-MAINT-INCORROUT  Fixes
   SI37264      BRM-MAINT-INCORROUT LARGE AMOUNT OF RECORDS PUT INTO QA1ANET
   SI35676      BRM-BACKUP-MSGBRM400F WHEN RUNNING A CONTROL GROUP WITH A *S
   SI35676      BRM-MAINT-INCORROUT  Fixes
   SI35676      BRM-MAINT-INCORROUT  Fixes
   SI35676      BRM-MAINT-INCORROUT  Fixes
   SI35676      BRM-MAINT-INCORROUT  Client Fixes

Summary Information

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


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 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"},"Product":{"code":"SG15V","label":"PTF Cover Letters - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG16D","label":"PTF Cover Letters - IBM i 7.1 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
16 June 2016