IBM Support

SI71715 - OSP-INCORROUT Collection Services Disk Unmap Counts

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-INCORROUT Collection Services Disk Unmap Counts


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770999  V7R3M0    MF66873   00/00    0000
PRE  5770999  V7R3M0    MF63842   00/00    0000
PRE  5770SS1  V7R3M0    SI62536   00/00    0000



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

-----------------------------------------------
Some external storage boxes support a new feature to unmap disk
space and new performance metrics are available.

CORRECTION FOR APAR SE70692 :
-----------------------------
Two new fields have been added to Collection Services file
QAPMDISK.
DSUNMAPCMD - Unmap write commands.
DSUNMAPBLK - Unmap blocks written.

CIRCUMVENTION FOR APAR SE70692 :
--------------------------------
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 SI70135 :
=================================================

If you are not impacted by the function added, no action is required.

If you need this function, you must follow these instructions to enable
it.

To update the QAPMETH file in libraries where an existing version of
the file already exists, follow these directions after applying or
removing this PTF:

For each existing library you wish to update:

1) If the collection library you are updating is your current
collection library, the CRTPFRDTA job must be ended.

ENDPFRCOL FRCCOLEND(*YES)

2) Rename the existing QAPMETH file to keep as a backup copy.

RNMOBJ OBJ(col-lib/QAPMETH) OBJTYPE(*FILE) NEWOBJ(QAPMETH1)

3) Create a copy of the new QAPMETH file from QSYS into your collection
library.

CRTDUPOBJ OBJ(QAPMETH) FROMLIB(QSYS) OBJTYPE(*FILE) +
TOLIB(col-lib)

4) Copy all existing members from the backup QAPMETH1 file to the new
QAPMETH file in your collection library.

CPYF FROMFILE(col-lib/QAPMETH1) TOFILE(col-lib/QAPMETH) +
FROMMBR(*ALL) TOMBR(*FROMMBR) MBROPT(*REPLACE) FMTOPT(*MAP *DROP)

5) Restart performance data collection if you ended it in step 1 above.
STRPFRCOL

6) Optional: Delete the backup copy.

DLTF FILE(col-lib/QAPMETH1)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI66275 :
=================================================

CIM is the only tool known to have problems processing Collection
Services character fields with CCSID values of 65535 (the problem fixed
by this PTF).  Therefore, if you are not running CIM you probably don't
need to apply this PTF, or you can apply it and not follow any of these
special instructions.

If you need the fix provided in this PTF, you must follow these
instructions to enable it.

To update a set of existing Collection Services database files in a
particular library, follow these directions after applying or removing
this PTF.

For each existing library you wish to update:

1) If the collection library you are updating is your current
collection library, the CRTPFRDTA job must be ended.

ENDPFRCOL FRCCOLEND(*YES)

2) Create the library which will contain the updated files and then
copy the Collection Services "template" files from QSYS to it.

CRTLIB new-library
CRTDUPOBJ OBJ(QAPM*) FROMLIB(QSYS) OBJTYPE(*FILE) TOLIB(new-library)

new-library is the library to contain the updated files.

3) Run the CPYPFRCOL command to copy *CSFILE types.

CPYPFRCOL FROMCOL(*SELECT) FROMLIB(old-library)
TOLIB(new-libary) COLTYPE(*CSFILE) and press enter.

new-library was created in step 2 and will contain the updated files.
old-library is the name of the existing library to be updated.

At the "Select Performance Collection to Copy" screen, select
the desired collection(s) to be copied and hit enter.

4) Run the CPYPFRCOL command again to copy any other collection types
desired.

CPYPFRCOL FROMCOL(*SELECT) FROMLIB(old-library)
TOLIB(new-library) COLTYPE(*CSFILE)  and press F4

old-library is the name of the existing library to be updated.
new-library is the name of an empty library to contain the updated
files.

They can be copied to the same "To library" from step 3 or a
different library.

At the "Copy Performance Collection (CPYPFRCOL)" screen, change
*CSFILE to other values to copy other performance collection types.
Put the cursor in the field displaying *CSFILE and hit F4 to see a list
of valid performance collection types. At the "Select Performance
Collection to Copy" screen, select the desired collection(s) to be
copied and hit enter.

5) If you are updating the current collection library, rename
old-library and new-library that were used in the previous steps.

RNMOBJ OBJ(old-library) OBJTYPE(*LIB) NEWOBJ(backup-library)
RNMOBJ OBJ(new-library) OBJTYPE(*LIB) NEWOBJ(old-library)

Note: You can delete old-library instead of renaming it, but it is
recommended that you rename it and keep it until you are satisfied that
the converted library contains all of the collections needed from
old-library, and you have verified that tools used to access the
converted data are working properly.

6) Restart performance data collection if you ended it in step 1 above.

STRPFRCOL



The instructions above are based on only those files and file
relationships shipped with the operating system. It is your
responsibility to handle any additional files, tables, and access paths
that are dependent on files replaced by this PTF. You can determine if
any additional dependencies exist by examining the output of the
following command:

DSPDBR FILE(your-lib/*ALL)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI65226 :
=================================================

If you are not impacted by the function added, no action is required.

If you need this function, you must follow these instructions to enable
it.

To update the QAPMDISK file in libraries where an existing version of
the file already exists, follow these directions after applying or
removing this PTF:

For each existing library you wish to update:
1) If the collection library you are updating is your current
collection library, the CRTPFRDTA job must be ended.
ENDPFRCOL FRCCOLEND(*YES)

2) Move each of the following files, if it exists, to a backup library.
Note: migrating logical file members will not work if you just rename.
MOVOBJ OBJ(col-lib/QAPMDISK) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX1) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX2) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX3) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX4) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX5) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX6) OBJTYPE(*FILE) TOLIB(your-backup)

3) Create a copy of the new QAPMDISK file from QSYS into your
collection library.
CRTDUPOBJ OBJ(QAPMDISK) FROMLIB(QSYS) OBJTYPE(*FILE) +
TOLIB(col-lib)

4) Grant users in the QPMCCDATA authorization list access to the new
file.
GRTOBJAUT OBJ(col-lib/QAPMDISK) OBJTYPE(*FILE) AUTL(QPMCCDATA)

5) Copy all existing members from the original QAPMDISK file in your
backup library to the new file in the collection library.
CPYF FROMFILE(your-backup/QAPMDISK) TOFILE(col-lib/QAPMDISK) +
FROMMBR(*ALL) TOMBR(*FROMMBR) MBROPT(*REPLACE) FMTOPT(*MAP *DROP)

6) Create a copy of each of the following QAPMDKIX1, QAPMDKIX2,
QAPMDKIX3, QAPMDKIX4, QAPMDKIX5, and QAPMDKIX6 logical files that you
moved in step 2 in your collection library. This will remap the
based-on physical file to QAPMDISK in the collection library and copy
all the logical file members.
CRTDUPOBJ OBJ(QAPMDKIX1) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX2) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX3) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX4) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX5) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX6) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)

Note: you should delete your saved logical files in the backup library.
These logical files are still based on the QAPMDISK file in your
collection library and will prevent normal deletion of existing
collections.

7) Restart performance data collection if you ended it in step 1 above.
STRPFRCOL

The instructions above are based on only those files and file
relationships shipped with the operating system. It is your
responsibility to handle any additional files, tables, and access paths
that are dependent on files replaced by this PTF. You can determine if
any additional dependencies exist by examining the output of the
following command:
DSPDBR FILE(your-lib/QAPMDISK)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI60258 :
=================================================

After applying or removing this PTF, the Collection Services collector
job (QYPSPFRCOL) must be ended and restarted for the change to take
effect.

1. To end Collection Services, enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

2. To start Collection Services, enter the following on the command
line:
STRPFRCOL

Before restarting Collection Services, you should consider other
functions that may be using data provided by Collection Services. Such
functions may be impacted when Collection Services is ended. Error
messages may be produced and the affected functions may need to be
restarted.

Examples of functions that are dependent on Collection Services include
Management Central monitors and applications that use the performance
collector APIs QPMWKCOL and QPMLPFRD. If applications are using the
performance collector APIs, you will find server jobs QPMASERV and
QPMACLCT active on your system.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI63080 :
=================================================

After applying or removing this PTF the Collection Services must be
cycled for the change to take effect.

1. To cycle Collection Services enter the following on the command
line:
STRPFRCOL CYCCOL(*YES)


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI70135      OSP-INCORROUT Collection Services QAPMETH ETLLSP Line Speed
   SI66275      OSP-INCORROUT Incorrect CCSIDs Collection Services files
   SI65226      OSP-DISK New Collection Services free space map data
   SI62537      OSP-INCORROUT QAPMLPARH fields HPCYCL and HPINST incorrect
   SI60258      OSP-INCORROUT QAPMSYSVP is limited to 128 processors
   SI63080      OSP-INCORROUT System Monitor Disk Read and Write Counts

Summary Information

System..............................  i
Models..............................  
Release.............................  V7R3M0
Licensed Program....................  5770SS1
APAR Fixed..........................  View details for APAR SE70692
Superseded by:......................  View fix details for PTF SI80282
Recompile...........................  N
Library.............................  QSYS
MRI Feature ........................  NONE
Cum Level...........................  C0128730


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, 2022 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":"BU058","label":"IBM Infrastructure w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0","Product":{"code":"SWG60","label":"IBM i"},"Component":"5770SS1","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
01 July 2022