|
Performance Toolkit for VMTM
has introduced a set of formatted output collectors. These
collectors place processed report data from Performance Toolkit into a
Discontiguous Shared Segment (DCSS). A new FC MONCOLL SEGOUT
controls the enablement of and population of this DCSS.
This function was provided originally in Performance Toolkit for VM in
z/VM 5.2 as a web download. This function is now delivered in the
normal service stream for Performance Toolkit. This support was
shipped as part of the base Performance Toolkit in z/VM 5.3 and z/VM 5.4.
APAR VM64500 is now available for the z/VM 5.3 edition of
Performance Toolkit and provides support
for Channel Cache, DASD Cache, Spin Locks, and Virtual Disks in
Storage.
The new support is provided in
If you are migrating to the OMEGAMON XE on z/VM and Linux 4.1.2
product, you must apply this PTF to your z/VM system.
This code is included in the base level z/VM 5.4 Performance Toolkit.
APAR VM64337 is now available for both the z/VM 5.2 and z/VM
5.3 editions of Performance Toolkit and provides support
for Channels, LCHANNELS, FCHANNELS and Minidisk Cache.
This APAR includes the previously released VM64299. The new support is
provided in
- PTF UM32233 for z/VM 5.2
- PTF UM32234 for z/VM 5.3
If you are migrating to the OMEGAMON XE on z/VM and Linux 4.1.1 product, you
must apply one of the above PTFs to your z/VM system.
APAR VM64299 is available for both the z/VM 5.2 and z/VM
5.3 editions of Performance Toolkit as follows
- PTF UM32169 for z/VM 5.2 provides the
base function for the formatted output collectors and provides an
update for normalizing Linux data in the formatted output.
- PTF UM32170 for z/VM 5.3 provides the update for normalizing
Linux data and provides support for mixed processor types in the
formatted output.
If you are using OMEGAMON XE on z/VM and Linux and you apply either of
the PTFs for VM64299 to your z/VM system, then you must apply IBM Tivoli
OMEGAMON XE on z/VM and Linux v4.1.0 (4.1.0-TIV-KVL-FP0003). Download
a copy of the fixpack from
IBM Tivoli OMEGAMON XE on z/VM and Linux Product Support
The new PERFOUT DCSS contains all the data provided by the
formatted output collector code. The format of this data is documented
at the following&colon.
Before you install the Performance Toolkit code,
please read through all the instructions.
Before you install the Performance Toolkit code:
- You must have a valid product license for Performance Toolkit for
VM. You must also have ordered and installed the PTF which applies to
your z/VM level. See above.
- You need to be able to LOGON to the Performance Toolkit virtual
machine on your z/VM system.
- If you previously had installed the web download version of the
Performance Toolkit for z/VM 5.2.0, you must remove this local
modification before installing PTF UM32169. To remove the local
modification, you can
- Logon MAINT
- Issue the following commands
VMFSETUP PPF 5VMPTK20 PERFTK (LINK
VMFREM PPF 5VMPTK20 PERFTK MOD PKSEG (UNREC
-reply '2' to message VMFREM2131R to bypass the part
- Continue on with the install steps for PTF UM32169
Refer to the Program Directory for Performance Toolkit for your
z/VM release and follow the instructions for Servicing Performance
Toolkit for VM in Chapter 7. The Program Directories are
After applying the z/VM 5.2 PTF, UM32169, and performing the build
steps, you will see messages from the VMFBLD step which state
VMFBLD2180I There are 1 build requirements remaining
VMFBLD2760I VMFBLD processing completed successfully
This remaining build requirement pertains to the new FCXSEGSZ $EXEC
file delivered with this new function in PTF UM32169 for z/VM 5.2.0.
This $EXEC is the source file for FCXSEGSZ EXEC. Unfortunately, the
new $EXEC source file was not included in a VMSES/E build list when
PTF UM32169 was created. This is corrected in PTF UM32233 for APAR
VM64337. If you are only installing PTF UM32169 now, this
informational message can be ignored or you can remove the manual
build requirement using the instructions at Remove
Manual Build Requirement.
Go to Verify the install
to make sure the Performance Toolkit code was installed properly.
To verify that the install process completed successfully:
- IPL CMS.
- Start Performance Toolkit.
perfkit
- Try to start the formatted output collectors.
fc moncoll segout on perfout
You should receive the message
FCXOMB779E Error locating DCSS, unable to find segment: PERFOUT
as the collector DCSS has not been created yet.
- You can now complete the installation and set up by starting
with the instructions in
Performance Toolkit Support for OMEGAMON XE.
Here are the steps to take if you want to remove the the "MANUAL
UNKNOWN BUILD" for FCXSEGSZ $EX32169 part in Perfkit 5.2 PTF UM32169.
To flag the UNKNOWN MANUAL build as BUILT:
Copy the FCXSEGSZ $EX32169 file from the Delta disk, 5VMPTK20 2D2 disk
or VMSYS:5VMPTK20.PERFTK.DELTA, to the Test build disk or SFS
directory, 5VMPTK20 200 disk or VMSYS:5VMPTK20.PERFTK.TBUILD, as
FCXSEGSZ $EXEC using the following command, where you need to fill in fm1
and fm2:
VMFCOPY FCXSEGSZ $EX32169 fm1 = $EXEC fm2 (PRODID 5VMPKT20%PERFTK OLDDATE REPLACE
Do one of the following VMSES/E procedures to flag the part BUILT in the
SRVBLDS file. You have two choices:
- If you use automated service you can do
VMFUPDAT SRVBLDS PERFTK
Then pick the parts that you want to flag BUILT. Use PF5 to process.
- If you do not use automated service, you can run the following
VMFSIM commands, as documented in the
VMSES/E Introduction and Reference. The first command sets
up the disks. The next two commands perform the actual change and the
last command verifies the other commands worked.
VMFSETUP 5VMPTK20 PERFTK
VMFSIM QUERY 5VMPTK20 SRVBLDS TDATA :STAT MANUAL (FILE UPSTAT
VMFSIM MODIFY 5VMPTK20 SRVBLDS * FILE UPSTAT TDATA :STAT BUILT :PARTID (REPLACE
VMFSIM QUERY 5VMPTK20 SRVBLDS TDATA :BLDLIST UNKNOWN :STAT BUILT
Return to the install step.
|