IBM Support

SI49719 - BRM-MAINT-INCORROUT Fixes

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

BRM-MAINT-INCORROUT Fixes


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 V6R1 and above, when creating an archive control group,
some defaults are not set to *ARCPCY.
2. In V7R1 and above, the Go button next to the System name
combo box on the Communication tab of the Enterprise Add Node
panel in System Director Navigator for i does not perform any
action. The Go button has been removed.
3. In V5R4 and above, when using the Work with Media using BRM
(WRKMEDBRM) command with OUTPUT(*PRINT) and a generic selection
on the TEXT field, the volume list may be incomplete.
4. In V5R4 and above, when using the Restore Object using BRM
(RSTOBJBRM) command to restore objects that are journaled,
MSGMCH0603 may be posted to the joblog.
5. In V5R4 and above for tape and V6R1 and above for optical,
the DUPMEDBRM TOVOL parameter does not work correctly, it may
fail with MSGBRM1147 or the wrong volumes may be used.
6. In V5R4 and above, when running parallel restores, BRMS may
hang.
7. In V5R4 and above, when using the auto initialization on
expiration function, if a volume that uses retention type
versions is expired, the volume may not be auto initialized.
8. In V5R4 and above, when using the Move Spooled Files using
BRM (MOVSPLFBRM) command to move large number of spooled files,
all the spooled files may not be moved.
9. In V5R4 and above, when running the Work with Saved Objects
(WRKOBJBRM) command to display more than 9999 saved objects and
page up is pressed, message MSGRNX1255 and MSGCPF5021 may be
posted to the joblog.
10. In V6R1 and above, when setting an invalid value for the 'To
media policy' field in the 'Automatic duplication' section of a
media policy, it does not fail as expected.
11. In V7R1, saving or archiving of IFS data is slow.
12. In V5R4 and above, when doing a parallel restore from a tape
sequence greater than 9999, MSGBRM400C is posted to the joblog.

13. In V5R4 and above, when running DUPMEDBRM with VOL(*SCHHST),
MSGMCH6903  may occur if there are too many file sequences to
duplicate.
14. In V5R4 and above, when a save of QUSRBRM with save type
'*QBRM' is older than a save of QUSRBRM with save type '*CUML'
or '*INCR', the 'Recover BRMS Related Media Information' section
in the recovery report may be incorrect.
15. In V5R4 and above, DUPMEDBRM using parameter TOSEQNBR(1) has
been enhanced to check the input volume list for a SAVSYS media
at sequence 1 and duplicate that media first.
16. In V6R1 and above, when using tape devices or tape media
libraries, MSGMCH3402 may occur.
17. In V6R1 and above, when running BRMS functions that use tape
media, BRMS has been has been enhanced to reprocess volumes that
were previously unavailable, after an inquiry message is sent
regarding tape media.
18. In V5R4 and above, on expiring a volume in WRKMEDBRM  via
option 7 and the media class has been set up to initialize on
expiration, if you try to change it to an active date it will
not work.
19. In V5R4 and above, when running STRBKUBRM that unmounts a
UDFS, a MSGCPFA09E may occur and the backup will abort with a
MSGBRM1820.
20. In V6R1 and above, when running STRBKUBRM with media class
overridden by '*SYSPCY', MSGBRM1713 may be posted to the joblog.
21. In V5R4 and above, MSGCPF5257 and MSGRNQ1299 may be posted
to the joblog of QBRMSYNC.
22. In V5R4 and above, Work with Media Information (WRKMEDIBRM)
option 9 on a parallel spoolfile save may cause MSGBRM1334.
23. In V5R4 and above, BRMS may not apply end of media options
(ENDOPT).
24. In V5R4 and above, when doing a parallel save of multiple
libraries, MSGBRM1148 may be sent to the joblog with the
incorrect library name if a library cannot be saved in parallel.
25. In V5R4 and above, Work with Media Information (WRKMEDIBRM)
option 9 on an IFS backup may cause MSGBRM1334 when using
FlashCopy Timestamps.
26. In V6R1 and above, the BRMS GUI client may fail with a
NullPointerException when displaying Global Policy Properties.
27. In V5R4 and above, BRMS is incorrectly adding omits to *IBM
saves when *NOCMTBDY is specified for save-while-active.
28. In V6R1 and above, BRMS has been enhanced to send MSGBRM1483
in addition to MSGCPF4372 for volumes that are not mounted on
tape libraries that have bar code readers.
29. In V5R4 and above, when *IBM is saved with save-while-active
in a backup control group with *NOCMTBDY specified for the
'Pending record changes' field, MSGCPF37AC may be posted to the
joblog.
Note: With this PTF, the 'Pending record changes' value will be
set to the same value as the 'Other pending changes' field.
30. In V5R4 and above, the BRMS GUI client may display an
incorrect value for the 'Disk pool high storage threshold' field
on the 'Global Policy Properties - Retrieval - Advanced' panel.

31. In V5R4 and above, the Start Maintenance for BRM (STRMNTBRM)
command or Start Recovery for BRM (STRRCYBRM) command may not
end when printing recovery reports.
32. In V5R4 and above, MSGCPF4101 may be posted in the QBRMSYNC
joblog which indicates file QTEMP/SYNTAPOPD was not found.
33. In V6R1 and above, BRMS has added support for Fully
Qualified Domain Names (FQDN) via the Relational Database
support (*RDB).  Please see the BRMS web page for more details
on how to implement.
34. In V6R1 and above, the BRMS GUI client may not sort or
display the correct values for Save History 'Mark for
duplication' and 'Duplicated item' fields.
35. In V6R1 and above, you can now get a retention section on
the PRTRPTBRM command with a TYPE of *CTLGRPSTAT and a CTLGRP
parameter not equal to *NONE. The retention section will start
on a new page and have *RETENTION to start the section with
*FULL and *INCR in the  Start and End Date columns. Under this
will be all the control groups that are in the report and their
current retention for full and incremental saves.
To enable this, the user must create this data area once per
job:
CRTDTAARA DTAARA(QTEMP/Q1ARPTRETN) TYPE(*CHAR)
36. In V6R1 and above, when the Restore Object using BRM
(RSTOBJBRM) command is used to restore objects, the restore may
fail with MSGCPF37C1.
37. In V6R1 and above, when applying the BRMS PTF the QBRMSYNC
job may take a lot of CPU.
38. In V5R4 and above, Display ASP Information using
BRM(DSPASPBRM) may not show sizes for a varied-on IASP.
39. In V5R4 and above, BRMS jobs may be hung in SIGW status.

Enterprise specific fixes for V7R1:
1. In V7R1 and above, if license program 5770TS1 option 1 is not
installed on a system defined as an Enterprise Hub, no errors
are posted to indicate why reports were not sent as email
attachments.
2. In V7R1 and above, when adding a new Enterprise Node, the
output queue properties are not set to valid defaults and a
"Data not valid" error is posted when the radio button is
selected.
3. In V7R1 and above, Enterprise has been enhanced to support
the PRTRPTBRM command in report definitions.
4. In V7R1 and above, when changing a report definition, the
command and parameters may not be saved.
5. In V7R1 and above, when a report definition is run, it may
fail with MSGCPF3303 and MSGBRM8012.
6. In V7R1, the Hub Center panel incorrectly displays the
'Release' as '*NONE' and the 'BRMS Status' as 'Not connected'
when the node is communicating.

CORRECTION FOR APAR 'SE55218' :
-------------------------------
Load and apply this PTF.
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

brower)
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 'SE55218' :
----------------------------------
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.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI46340:
================================================

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
--------------  ------------------------------------------------------------
   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 SE55218
Superseded by:......................View fix details for PTF SI71641
Recompile...........................N
Library.............................QBRM
MRI Feature ........................NONE
Cum Level...........................C3298710


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.

[{"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.1.0"},{"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":""}}]

Document Information

Modified date:
07 June 2013