IBM Support

PTFs: FAQs / Question and Answers

Technote (troubleshooting)


Problem(Abstract)

This document will provide Frequently Asked Questions (FAQs) concerning Individual, Group, and Cumulative PTFs.

Resolving the problem

Q1: What is a PTF? What is a Cumulative package?


A1: A PTF is a temporary solution to or bypass of a problem diagnosed by IBM as resulting from a defect in a current, unaltered release of a licensed program. A cumulative (Cumulative) PTF package contains PTFs that affect the general system population for a specific release.

Q2: If I have two different Cumulative PTF packages, do I have to install both of them?

A2: Because Cumulative PTFs are cumulative, only the most current cumulative package must be installed.

Q3: What is the difference between the A side and the B side?

A3: A and B side concepts are relative to LIC and not to the operating system or LPP PTFs. When a new system is shipped or when the operating system is upgraded to a new release, the A side and B side match. When LIC PTFs are temporarily applied, they are applied to the B side. If you have temporarily applied LIC PTFs and you are running on the A side, you will not be running with the PTFs.

Previous to V3R1M0, you had to be running on the A side to apply PTFs to the B side. When GO PTF, Option 8 is used to apply LIC PTFs, the system determines if you are running on the A side or the B side. If you are running on the A side, the LIC PTFs are applied immediately. The system is IPLed to the B side to apply the rest of the PTFs. If you are running on the B side, the system does a partial IPL to the A side to apply the LIC PTFs. The system is IPLed back to the B side to apply the rest of the PTFs.

Starting at V3R1M0, immediate LIC PTFs can be applied to the B side while you are running on the B side. If you are on the B side and you use GO PTF Option 8, Automatic IPL Y to apply immediate LIC PTFs, the system IPLs to the B side to apply the PTFs. The system does not IPL to the A side. Delayed LIC PTFs in V3R1 and beyond function the same way all LIC PTFs functioned before V3R1M0. Permanently applying LIC PTFs puts the PTF on the A side. Once the PTF is permanently applied, it cannot be removed.

Q4: I forgot to do CHGMSGQ QSYSOPR *BREAK SEV(70). Now I have a message that needs a reply. How do I respond?

A4: A system request is required to reply to the message(s). Once the system request menu is up, Option 6 allows the ability to respond to the messages requiring a response.

Q5: My Cumulative package did not install. How do I determine what is wrong?

A5: First, determine if the failure occurred during the load or apply phase of the cumulative package installation. If the system did not IPL, the failure may have occurred during the load phase. Do a help on the failure message. Then, press PF10 from the message details panel to view the messages in the joblog. Look for all escape messages that indicate what the problem is. Fix these errors, and try the request again.

If the system IPLed and the PTFs did not apply, start by looking at the history log. On the operating system command line, type GO LICPGM, and select Option 50 to display the log for messages.

o Look for a message indicating if the IPL was normal or abnormal. PTFs are not always applied during an abnormal IPL.
o If Perform Automatic IPL was not selected on the Installation options for the PTFs panel, verify that the power down system command (PWRDWNSYS) was done with RESTART(*YES) and the keylock position was at normal. If RESTART(*NO) was used, the system does not automatically IPL to the A side to apply LIC PTFs.
o Look for any messages that indicate that there was a failure during the IPL. If failure messages are found, go to the SCPF joblog to find the detailed messages indicating the cause of the problem. To find the SCPF joblog, use the WRKJOB SCPF command. You may get a list of jobs. If you just did the IPL, choose the first one that is not active. Look at the spooled file for that job. The detailed error messages can be found in this joblog. Find the error messages, and try to determine what caused the error. If you can, fix the problem, and then re-IPL the system to apply the remaining PTFs. If you cannot fix the problem, have the information in the joblog available when you call the Rochester Support Center.
Q6: I was trying to load a PTF, and I got message CPA3576 indicating that my Master Program Temporary Fix Index (MPTFI) may be damaged. What should I do?

A6: Message CPA3576 is issued as a general error message and does not necessarily mean that the MPTFI has been damaged. Do not answer D to this message. Always answer with C unless directed otherwise by service support. Display your joblog to see what other errors are in the joblog. This is your clue as to what really went wrong. Correct any errors, and try your request again. If this does not solve the problem, have the information in the joblog available when you call the IBM Rochester Support Center.

Q7: I want to send multiple PTFs to another system. How can I load them all with one command instead of having to specify each PTF save file on the LODPTF command?

A7: One option is to use the Send Network File ( SNDNETF) command to send the PTF save files to the other system. On the remote system, use the QPZGENNM API to generate a valid save file name for the PTF save file. Create a save file in QGPL by that name and receive the PTF into that save file. Use the QPZLOGFX API to log the PTF into *SERVICE. Once this has been done, the PTF is recognized by the system for any PTF functions like LODPTF DEV(*SERVICE). Refer to the iSeries Information Center for further information on these APIs.

Note: At R540 and above, if all *SAVFs get send to the target system, the UPDPTFINF command can be used to get the serviceable attributes recognized by the system

A second option is the Send PTF ( SNDPTF) command to send the PTF save files. The SNDPTF command sends the PTFs, loads them, and sets them for apply with a single command on the remote system. The command is available with the System Manager/400 Licensed Program Product (LPP).

A third option is to use FTP to send the *SAVFs among the systems. Then, as with the SNDNETF command above, the APIs are required to get the PTFs put back into *SERVICE.

A fourth option is when using Virtual Image Catalog to load/apply PTFs, all .bin file images will reside in a single Integrated File System directory. That Integrated File System directory can be saved into a *SAVF and then moved over to the other systems using FTP or the SNDNETF command and then restored into the target Integrated File System. Once restored on the target a new image catalog can be built off of that directory to load and apply PTFs.

Lastly, iSeries Navigator can be used. To use Management Central, refer to Rochester Support Center knowledgebase document New, Management Central PTF/Fix Send Function, for more information. To link to document New immediately, click here . Within iSeries Navigator, a user can drag and drop the .bin file images between the Integrated File System on the source system and the Integrated File System on the target system. Once the .bin files reside on the target, the Virtual Image Catalog can be used to load or apply PTFs.

Q8: What does it mean when a PTF has an action required?

A8: This was a new concept in V3R1M0. Some PTFs that were previously delayed PTFs can now be applied immediately, However, some additional steps are required to make them active. These additional steps are described in the cover letter. The following types of action required PTFs exist: updateable and non-updateable.

Updateable action required PTFs are shipped with an action exit program to verify the actions required to make the PTF active have been done. The action exit program is called by the Display PTF ( DSPPTF) command to list the actions that are necessary to make the PTF active and to verify if the actions have been completed. The exit program is called when the details for the PTF are displayed using Option 5 on the Display PTF Status panel or when you select *ACTRQD PTFs on the DSPPTF command. At this time, the status of the PTF is updated if the actions are complete. The status of the PTF changes from Temporarily applied - PND to Temporarily applied after all required actions have been completed.

Non-updateable action required PTFs do not have an exit program to verify the actions have been done. These PTFs remain in a status of Temporarily applied - ACN until the next IPL. During the IPL, the status of the PTF changes to Temporarily applied.

It is important to note that any dependent PTFs cannot be applied until the pre-requisite PTF indicates that its actions are complete.

Q9: What is iSeries 400 ALERT?

A9: iSeries 400 ALERT is a service that proactively notifies customers of critical software and hardware problems and PTFs that may help avoid system interruptions and expensive down time. Notices tailored to the user's release and cumulative PTF level are sent by facsimile or mail to the user's site. Weekly reports include notification of: Contact you marketing representative for more information on this service offering.

For a free type of alert service, go to Subscription Service for System i5 at thie website:
https://www-947.ibm.com/systems/support/myview/subscription/css.wss/subscriptions?methodName=listAvailableSubscriptions

Q10: How do I generate a listing of my PTFs?

A10: To generate a list of the PTFs applied to your system, on the operating system command line type in the following:

DSPPTF LICPGM(*ALL) SELECT(*ALL) RLS(*ALL) OUTPUT(*PRINT)

Press the Enter key. Then, type the following:

WRKSPLF

Press the Enter key. You can then display or print as needed.

Q11: What is the command used to order PTFs electronically?

A11: To order individual PTFs, on the operating system command line type the following:

SNDPTFORD PTFID(nnnnnnn)

where nnnnnnn is the number of the PTF you want to order. Press the Enter key. You can order up to 20 PTFs simultaneously.

Q12: How do I order cumulative PTF packages electronically?

A12: To order cumulative PTF packages, on the operating system command line type the following:

SNDPTFORD PTFID(SF99VRM)

press the Enter key. The last three digits indicate the version, release, and modification level of the operating system.

Q13: What is PSP information?

A13: PSP stands for Preventive Service Planning. It is a collection of information used when installing a licensed program, cumulative PTF package, or hardware. PSP information should be reviewed before installing a licensed program, a cumulative PTF package, or hardware.

Q14: How do I order the PSP information for the current cumulative PTF package?

A14: To order the PSP information for the current cumulative PTF package, on the operating system command line type the following:

SNDPTFORD PTFID(SF98VRM)

Press the Enter key. The last 3 digits indicate the version, release, and modification level of the operating system.

Q15: How can I determine what the current Cumulative PTF is and when the next one is scheduled for release?

A15: SF98VRM gives the current Cumulative PTF number and also mentions the target date for the next scheduled Cumulative PTF.

Q16: Can I order a new Cumulative PTF before it is actually available?

A16: The Cumulative PTF must be available before it can be ordered.

Q 17: How can I tell what PTFs I have installed on my system?

A17: Use the Display PTF ( DSPPTF) command, and specify the product ID. If you do not know the product ID, on the operating system command line type DSPPTF, and press the Enter key. This brings up the first product. Every time you press the Enter key, it takes you to the next product installed on your system.

Q18: How can I tell what Cumulative PTF Package is on my system?

A18: On the operating system command line, type DSPPTF LICPGM(57xx999) and verify what the first TLnXXXX number is. Or, type DSPPTF LICPGM(57xxSS1), and verify that the first TCnXXXX or TAnXXXX number is. XXXX represents the first 4 numbers of the Cumulative tape package identifier. The TL number stands for the HIPER VLIC PTFs on the Cumulative package, TC represents the operating system PTFs on the Cumulative package, and TA represents the HIPER operating system PTFs on the Cumulative package. The n represents some number based on the current year. For example, Cumulative PTF C7002540 – Breaks down to TL07002, TC07002, and TA07002.

Q19: How can I find out what PTFs are on the Cumulative PTF that I received?

A19: Load the Cumulative package into the optical drive (OPTXX). Then, do the following:
1. On the operating system command line type the following command, and press the Enter key: WRKOPTVOL
2. Select Option 11 to Work with object links.
3. Locate the README file.
4. Type 5 to display.
5. Locate the PKGLIST.TXT.
6. Type 5 to display.
This provides a summary listing of the PTFs contained within the package. While this is a listing of the PTFs contained within the package, it is not a complete listing. Pre-req and Co-req PTFs are not included in the PTF listing.

Q20: How do I print PSP information that I have downloaded?

A20: On the operating system command line, type the following:

CPYF FROMFILE(QGPL/QAPZCOVER) TOFILE(QGPL/QPRINT) FRMMBR(QSF98XXX)

Press the Enter key.

Q21: How can I print a cover letter for the PTF I have downloaded?

A21: On the operating system command line, type the following:

DSPPTF LICPGM(57xxYYY) SELECT(SIXXXXX) COVERONLY(*YES) OUTPUT(*PRINT)

Then, run the WRKSPLF command. You can display or print the cover letter.

Q22: Where are the cover letters for PTFs stored on my system?

A22: They are stored in a file called QAPZCOVER in QGPL.

Q23: How can I get QAPZCOVER back on my system if I accidentally deleted it.

A23: You can run the RSTOBJ command from a previous backup or you can re-create it. To re-create QAPZCOVER, On the operating system command LINE, type the following:

CRTPF FILE(QGPL/QAPZCOVER) RCDLEN(80) FILETYPE(*DATA) +
LVLCHK(*NO) MBR(*NONE) MAXMBRS(*NOMAX) AUT(*USE) +
TEXT('PTF COVER LETTERS')

Press the Enter key. Then, on the operating system command line type the following:

CHGOBJOWN OBJ(QGPL/QAPZCOVER) OBJTYPE(*FILE) NEWOWN(QSYS)

Press the Enter key. Then, on the operating system command line type the following:

GRTOBJAUT OBJ(QGPL/QAPZCOVER) OBJTYPE(*FILE) +
USER(QSYS QSRVBAS) AUT(*ALL)

Press the Enter key.

Q24: What is the difference between an immediate PTF and a delayed PTF?

A24: An immediate PTF can be applied without doing an IPL if the licensed program it affects is not in use. An IPL is required to apply delayed PTFs. In some cases, there may be an action pending status until a special instruction is done or an IPL. In some cases, MF PTFs can be applied immediately while on the B side of the operating system.

Q25: Do I have to load the PTF before I can apply it?

A25: The PTF must be loaded or the apply does not work.

Q26: I just received some PTFs via the ECS line. How do I apply them?

A26: To apply the PTFs, do the following:
1. On the operating system command line type the following: GO PTF
2. Select Option 8 from the menu to install fix package.
3. Specify *SERVICE for the device.
4. Specify Y or N for the IPL depending if you can IPL at the time.
5. Specify 1 for all PTFs.
6. Specify N for other options unless you do not want to load all that have been downloaded electronically. This ensures all pre-req and co-req checking is done for the successful load and apply of the PTFs. However, if N is specified for the IPL, PTFs do not get applied until the IPL has been issued. The IPL should be done with the following command:

PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B)
Q27: How do I remove a PTF that is temporarily applied to my system?

A27: If it is an immediate LIC PTF (MFxxxxx), an IPL will be needed to remove the PTF unless the system is running on the A side. LIC PTFs can only be removed *PERM. Message CPD35A6, Licensed Internal Code PTFs cannot be temporarily removed, will be logged if a LIC PTF is attempted to be removed *TEMP. To remove a temp applied LIC PTF when the system is running on the B side, type the following:

RMVPTF LICPGM(57xx999) SELECT(MFXXXXX) RMV(*PERM) DELAYED(*YES) RMVDEP(*YES)

This command marks the LIC PTF and its dependants to be removed at the next IPL of the system.

Note: Message CPD35BD, Immediate operation not allowed for MFxxxxx, will be logged if you attempt to remove a LIC PTF immediately when the system is running on the B side.

If it is an immediate SIxxxxx PTF, on the operating system command line type the following:

RMVPTF LICPGM(57xxYYY) SELECT(SIXXXXX) RMV(*TEMP) RMVDEP(*YES)

which puts it in a Not Applied Status. We can then issue the above RMVPTF command again with RMV(*PERM) so the fix is completely removed from the system. If a savf or cover letter exists on the system for this PTF, use the DLTPTF command to delete the savf and cover letter. If it is a delayed PTF, specify DELAYED(*YES) so it is removed on the next IPL.

Q28: Does the system have to be restricted to load PTFs?

A28: We can load a PTF and mark it to be applied on the next IPL unless it is an immediate PTF which we can apply if no one is using that product.

Q29: What is the procedure to get PTFs on my system?

A29: On the operating system command line, type GO PTF. Select Option 8 to load any PTFs you have to be applied. Or, you can do a LODPTF and APYPTF for each PTF. This must be done for each product.

Q30: If I order one PTF, why do I sometimes receive more than the one that I order?

A30: The prereq and coreq PTFs are sent along also to make sure we have everything we need to get the full effect of the PTF. The cover letter mentions these PTF numbers.

Q31: How do I remove a damaged PTF from my system?

A31: Because nothing can be done with the PTF while in a damaged status, the PTF must be reloaded with the LODPTF. Then, a RMVPTF can be done to remove it or a LODPTF can be done to apply it again.

Q32: I have just loaded PTFs on my system. How can I verify if they are set to be applied on the next IPL?

A32: Use the DSPPTF command, and verify the IPL action. If it is N, the PTF has not been marked to be applied. If you look at the general information of the PTF the unattended IPL action should say apply temporarily.

Q33: How should I issue my IPL to apply my PTFs?

A33: On the operating system command line, type the following:

PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B)

Q34: I have loaded my PTF and have to apply it delayed. What command do I use?

A34: On the operating system command line, type the following:

APYPTF LICPGM(57xxYYY) SELECT(SIXXXXX) DELAYED(*YES)

Q35: How do I know which side I am running on?

A35: On the operating system command line, type the following:

DSPPTF

Verify what the IPL source at the top of the screen is. The control panel does not say what side you are on but what the next IPL will be.

Q36: What is a superseded PTF?

A36: A superseded PTF is one that has never been installed on the system, however, it is shown as superseded because the changes from this PTF have been included in a new PTF that has been installed on the system. If the PTF had been temporarily applied and we install the new PTF, it automatically permanently applies the old PTF so the code from the new PTF is used, and the new PTF is now in a temporarily applied status.

Q37: I was doing a SAVSYS, and I received message CPI35C3 MPTFI for licensed internal code not saved due to error in the QSYSOPR message queue. What does that mean, and what do I need to do to recover?

A37: This message is sent whenever the information about LIC PTFs is not saved during a SAVSYS. If the system is restored using these SAVSYS tapes, the information about the LIC PTFs installed on the system is missing. This could cause installation errors when future cumulative PTF packages are installed. The typical error that occurs is a CPF7206 Service function ended abnormally. Completion code 'FFFF'x qualifier 000000000000000B'X. This indicates an attempt was made to apply a PTF to a module that already has a PTF temporarily applied to it. You can determine why the CPI35C5 was issued and correct the error. Then, redo the SAVSYS. Or, when you reinstall the system, you can re-slip LIC from PID media and reapply the PTFs that were previously applied to the system.

Q38: Where can I find more information on PTFs?

A38: PTF information can be found on the iSeries Information Center under the topics: OS/400 and related software, Maintain and manage OS/400 and related software, Use software fixes.

Q39: What is the command WRKPTFGRP for?

A3 9: The Work with PTF Groups display shows you a list of PTF groups on the system. A PTF group consists of a list of program temporary fixes (PTFs) defined for the purpose of managing those PTFs as one entity. A PTF group can identify other PTF groups, called related PTF groups. The PTFs in the PTF group as well as the PTFs in all related PTF groups are used to determine the overall status of the PTF group. Starting at V6R1M0, this command can be formatted to show what previous levels of the groups have been installed on the system. The number of levels displayed is controlled by the CHGSRVA command's 'PTF group levels' parameter.

Q40: What is the function of the UPDPTFINF command?

A40: The Update Program Temporary Fix Information ( UPDPTFINF) command updates PTF information for all PTF save files in library QGPL. It was first introduced at V5R4M0. By running this command, the *SERVICE flag is turned on for those PTFs and from there you can run the GO PTF Option 8 menu selection and specify *SERVICE for the device to load and mark the associated PTFs. You can also run the DLTPTF command and safely remove the save files and cover letters for those PTFs. This is very useful when Fix Central brings down a number of save files for PTFs that are for different releases than what the system is at.

Q41: What is DSPFMWSTS used for?

A41: The Display Firmware Status ( DSPFMWSTS) command displays information for the current server firmware.


Cross reference information
Segment Product Component Platform Version Edition
Operating System IBM i 7.2
Operating System IBM i 7.1
Operating System IBM i 6.1
Operating System IBM i 7.3

Historical Number

446641321

Document information

More support for: IBM i
Save/Restore

Software version: 5.4.5, 6.1.1, 7.1, 7.2, 7.3

Operating system(s): IBM i

Reference #: N1018906

Modified date: 29 March 2013