IBM Support

SI71203 - Ship QMGTOOLS library

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

Ship QMGTOOLS library


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

-----------------------------------------------
This contains QMGTOOLS build date of October 11,2019. If
QMGTOOLS is currently installed, verify the build date using
command: CALL QMGTOOLS/QGETVER

Using QMGTOOLS/SYSSNAP when build date is between April 17,2019
and before July 16,2019 is not supported as it may cause
unpredictable errors that may require recovery steps.

For more information about QMGTOOLS, see the following URLs:

https://www.ibm.com/support/pages/qmgtools-must-gather-data-coll
ector-users-guide

https://www.ibm.com/support/pages/mustgather-how-obtain-and-inst
all-qmgtools-and-keep-it-current

CORRECTION FOR APAR SE72229 :
-----------------------------
Using QMGTOOLS/SYSSNAP when build date is between April 17,2019
and before July 16,2019 is not supported as it may cause
unpredictable errors that may require recovery steps.

CIRCUMVENTION FOR APAR SE72229 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


1) This PTF contains the QMGTOOLS library

2) If QMGTOOLS library already exist, do not use any QMGTOOLS
functions to prevent object locks

3) After applying the PTF, a save file, QESMGTSAVF, is created in
library QSYS

4) When this PTF is applied and library QMGTOOLS exist, if QMGTOOLS
is less than the build date of this PTF, an attempt will be made
to clear QMGTOOLS library and restore this build date of QMGTOOLS

5) Once QMGTOOLS is installed, try to update QMGTOOLS to get the
latest version:

a) GO QMGTOOLS/MG

b) choose option 13 (Check IBM for updated QMGTOOLS)

6) If the restore function failed during the apply, see the following
steps

Manual restore of QMGTOOLS
--------------------------
7) Record the QALWOBJRST (allow object restore option) system value
with command: DSPSYSVAL SYSVAL(QALWOBJRST)

8) Change the QALWOBJRST (allow object restore option) system value to
*ALL with command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(*ALL)

9) If QMGTOOLS library exists, clear the library and restore with
command: RSTOBJ OBJ(*ALL) SAVLIB(QMGTOOLS) DEV(*SAVF)
SAVF(QSYS/QESMGTSAVF) MBROPT(*ALL) ALWOBJDIF(*ALL)

10) If QMGTOOLS library does not exist, restore with command:
RSTLIB SAVLIB(QMGTOOLS) DEV(*SAVF) SAVF(QSYS/QESMGTSAVF)
MBROPT(*ALL) ALWOBJDIF(*ALL)

11) Change back the QALWOBJRST system value to the original value with
command: CHGSYSVAL SYSVAL(QALWOBJRST) VALUE(xxxx) where xxxx was
the original value

Once QMGTOOLS is installed, try to update QMGTOOLS to get the latest
version:

a) GO QMGTOOLS/MG

b) choose option 13 (Check IBM for updated QMGTOOLS)

********************************************************************
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 SI54605 :
=================================================

If replacing this PTF in order to get a new QMGTOOLS version, delete
the PTF from the system first before loading and applying.

RMVPTF LICPGM(5770SS1) SELECT(SI54605) RMV(*PERM)
DLTPTF PTF(SI54605)

1) After applying the PTF, a save file, QESMGTSAVF, is created in
library QSYS

2) This save file contains the QMGTOOLS library

3) Record the QALWOBJRST (allow object restore option) system value w/
comamnd: DSPSYSVAL SYSVAL(QALWOBJRST)

4) Change the QALWOBJRST (allow object restore option) system value to
*ALL w/ command:  CHGSYSVAL  SYSVAL(QALWOBJRST) VALUE(*ALL)

5) If QMGTOOLS library exist, clear the library and restore with
command:  RSTOBJ OBJ(*ALL) SAVLIB(QMGTOOLS) DEV(*SAVF)
SAVF(QSYS/QESMGTSAVF) MBROPT(*ALL) ALWOBJDIF(*ALL)

6) If QMGTOOLS library does not exist, restore with command :
RSTLIB SAVLIB(QMGTOOLS) DEV(*SAVF) SAVF(QSYS/QESMGTSAVF)
MBROPT(*ALL) ALWOBJDIF(*ALL)

7) Change back the QALWOBJRST system value to the original value w/
command:  CHGSYSVAL  SYSVAL(QALWOBJRST) VALUE(xxxx) where xxxx was
the original value


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI68645      Ship QMGTOOLS library
   SI55314      QSP-INCORROUT QMGTOOLS SYSSNAP ISSUE STORING IN *IFS
   SI54605      OSP-INCORROUT SHIP QMGTOOLS SAVE LIB

Summary Information

System..............................i
Models..............................
Release.............................V7R2M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE72229
Superseded by:......................
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C0114720


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

Document Information

Modified date:
16 May 2020