64 IBM z/VM and Linux on IBM System z: Virtualization Cookbook for Red Hat Enterprise Linux 4
5.1 Applying a program temporary fix
You might determine that you need to apply a specific fix or PTF to your system.
For example, an APAR called VM63895 was opened to address the problems reported with
virtual network interface card (NIC) support. There are three known symptoms that the APAR
Linux guests can lose connectivity after shutdown -r now (or any device reset).
Using an external security manager (ESM) to authorize a virtual local area network
(VLAN) list may lead to an FRF002 abend.
Virtual Hipersockets NIC configured with "VLAN nnn", exploiting Set Global VLAN ID, did
not filter inbound frames.
The APAR was assigned the following PTF numbers:
z/VM 5.1.0 VM63895 UM31612
z/VM 5.2.0 VM63895 UM31613
There are more details on the Web at:
Therefore, for z/VM 5.2, apply PTF UM31613.
Following is an example of how you can apply the PTF. Check to make sure that you have
not applied the PTF previously. Perform the following steps:
1. Log in to MAINT and issue the vmfsetup command to set up minidisks for TCP/IP and link
to them, as Example 5-1 shows.
Example 5-1 vmfsetup on MAINT
==> vmfsetup zvm cp (link
VMFSET2760I VMFSETUP processing started for ZVM CP
VMFUTL2205I Minidisk|Directory Assignments:
String Mode Stat Vdev Label/Directory
VMFUTL2205I LOCALMOD E R/W 2C4 MNT2C4
VMFUTL2205I LOCALSAM F R/W 2C2 MNT2C2
VMFSET2760I VMFSETUP processing completed successfully
2. Use the vminfo command to query the software inventory files. Move the Tab key to ZVM
and type s to select it on the PPF Field panel, as Example 5-2 shows.
Example 5-2 Using VMFINFO to find the ZVM file
PPF Fileid - Help
Product parameter files (PPFs) define the environment and key variables
required to process the queries. The following is a list of all PPFs
found on all accessed disks. Select one to continue. The View function
can be used to examine one or more PPFs.
Important: We strongly recommend that you apply this PTF. If you do not, examples of
cloning Linux in Chapter 9, “Cloning Linux” on page 113 fails due to network connectivity
Chapter 5. Servicing z/VM 65
Type a "V" next to one or more PPFs to view their contents, or type an
"S" next to one PPF to select.
Options: S - select V - view
Option PPF Fileid
_ $5654260 PPF D1
_ SEGBLD PPF D2
_ SERVP2P PPF D1
_ UCENG PPF D2
s ZVM PPF D2
_ 4OSASF40 PPF D1
3. Because the description of the PTF cites a component name of virtual machine (VM)
control program (CP), select CP on the component name panel.
4. Select PTFs/APARs on the VMFINFO main panel.
5. Type in the PTF number UM31613 in the PTF number field, then select Status of PTF on
the PTF/APAR queries panel, as Example 5-3 shows.
Example 5-3 PTF/APAR queries panel
Enter a PTF or APAR number and type an option code. Then press Enter.
PPF fileid ...... ZVM PPF D
Component name .. CP Setup ... NO
Product ID .....: 5VMCPR20 System .. VM
PTF number ...... UM31613
APAR number .....
Options: S - select
s Status of PTF
_ Requisites/supersedes of PTF
_ Dependencies/superseding of PTF
_ User memo of PTF
_ Serviceable parts included by PTF
_ Abstract of APAR(s)
6. If the PTF has not been successfully applied, you see the message No data found in, as
Example 5-4 shows.
Example 5-4 PTF not applied message
Query Output - PTF Status
PPF fileid .....: ZVM PPF D
Component name .: CP Setup ..: NO
Product ID .....: 5VMCPR10 System .: VM
WN:VMFSIP2481W No entries match search arguments
WN: TDATA :PTF UM31198
WN: in table 5VMCPR10 SRVRECS J
No data found