LODPTF (Load Program Temporary Fix)

 

+
Search Tips   |   Advanced Search

 

LODPTF Command syntax diagram

 

Purpose

The Load Program Temporary Fix (LODPTF) command loads program temporary fixes (PTFs) for a specified product from a diskette, tape, optical volume, or save file into the product PTF library. Each PTF contains one or more objects, including programs, that can be applied to a product by the Apply Program Temporary Fix (APYPTF) command.

Only the PTFs for a single product, such as Operating System/400, can be loaded at a time. Not all of the PTFs for the specified program must be loaded, because specific PTFs can be selected or omitted and loaded.

Restriction: This command is shipped with public *EXCLUDE authority and the QSRV user profile has private authority to use the command.

 

Required Parameters

LICPGM
Specifies the 7-character identifier of the product for which the PTFs are loaded.

 

Optional Parameters

DEV
Specifies the device from which the PTFs are loaded. The device name must already be known on the system by a device description.

*SERVICE: The PTFs sent from the service support system are loaded.

*SAVF: The PTFs are loaded from a save file. If *SAVF is specified, a save file name must be specified on the SAVF parameter.

diskette-device-name: Specify the name of the diskette device from which the PTFs are loaded.

tape-device-name: Specify the name of the tape device from which the PTFs are loaded.

optical-device-name: Specify the name of the optical device from which the PTFs are loaded.

SEQNBR
Specifies the sequence number on the tape volume where the load operation begins to load the PTF data.

Note: This parameter is valid only if a tape device name is specified on the DEV parameter.

*SEARCH: The tape volume is searched for the first program temporary fix (PTF) file for the specified licensed program.

sequence-number: Specify the sequence number of the PTF file being loaded. This sequence number must exist on the tape. Valid values range from 1 to 16777215.

ENDOPT
Specifies the operation that is automatically performed on the tape or optical volume after the PTF operation ends.

Note: This parameter is valid only if a tape or optical device name is specified on the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.

*REWIND: The tape is automatically rewound, but not unloaded, after the operation has ended.

*LEAVE: The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.

*UNLOAD: The tape is automatically rewound and unloaded after the operations ends. Some optical devices will eject the volume after the operation ends.

PATHID
Specifies the number that identifies a file on the optical volume that contains the PTFs to be loaded. The PTF files for each product and release that exist on the optical media have a path identifier number to allow the files to be processed in a specific order. Only the PTFs from the specified path identifier are loaded on your system.

Note: This parameter is valid only if an optical device name is specified on the DEV parameter.

*FIRST: The optical volume is searched for the first PTF file for the specified product and release, according to the search dependency specified on the SELECT parameter.

  • When a specific PTF identifier is specified on the SELECT parameter, the first occurrence of the specified PTF is loaded.

  • When *ALL is specified on the SELECT parameter, the existing PTF file with the lowest path identifier is loaded.

*SELECT: A list of the PTF files that exist on the optical volume that match the product and release is shown. You can select the specific file from which PTFs are loaded. This value cannot be selected in a batch environment.

path-identifier: Specify the path identifier of the existing PTF file from which to load the PTF data.

SAVF
Specifies the qualified name of the save file from which the PTFs are loaded.

The name of the save file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

save-file-name: Specify the save file name from which the PTFs are loaded.

SELECT
Specifies which of the PTFs for the specified product are loaded. The OMIT parameter cannot be specified if SELECT is specified with PTF numbers.

Note: Permanently removed PTFs will be ignored when SELECT(*ALL) and DEV(*SERVICE) are specified. To load removed PTFs, specify the PTF number on the SELECT parameter.

*ALL: All the PTFs for the specified product are loaded.

PTF-number: Specify the PTF identification numbers (up to 50) of the single PTFs being loaded.

OMIT
Specifies that all PTFs, except those specified in this parameter, are loaded. Specify the PTF numbers of the PTFs that are omitted when the rest are loaded. Up to 50 PTF numbers can be specified. The OMIT parameter cannot be specified if single PTF numbers are specified on the SELECT parameter.

SPRPTF
Specifies which operation is performed for temporarily applied PTFs that are superseded by PTFs encountered by this load operation.

*APYPERM: For the specified product, any PTFs that are temporarily applied and are superseded by PTFs contained on the PTF media, are automatically permanently applied before loading the superseding PTFs. If the superseded PTFs have any prerequisite PTFs, they are also permanently applied by this operation.

*NOAPY: The load operation stops when temporarily applied PTFs are being superseded by PTFs contained on the PTF medium. The temporarily applied PTFs that are superseded must be permanently applied (APYPTF command) or removed (RMVPTF command) before the LODPTF command can be processed again.

COVER
Specifies whether to copy the cover letter for the PTF into a physical file.

Note: This parameter is valid only when a tape device name or optical device name is specified on the DEV parameter.

*YES: After the PTF is loaded, the cover letter is copied into a physical file.

*NO: The cover letter is not copied into a physical file.

*ONLY: The cover letter is copied into a physical file but the PTF is not loaded. If the SEQNBR parameter is specified, it must contain the sequence number of the file that contains the PTF.

RLS
Specifies the release level of the PTFs being loaded.

*ONLY: This value is only valid when one release of the product's base option is installed on the system. PTFs for all installed options of the product will be loaded regardless of the release-level of the option.

release-level: Specify the release level in VxRyMz format, where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.

If the release-level specified is the release-level of the base option of the product, PTFs for all installed options of the product are loaded regardless of the release-level of the option.

If the release-level specified is not the release-level of the base option of the product, only PTFs for the options installed at that release-level are loaded.

Example for LODPTF

Example 1: Omitting PTFs 

LODPTF   LICPGM(5722SS1)
  OMIT(SI00003 SI00008 SI00014)

This command loads all of the PTFs from the service support system (*SERVICE) for the product 5722SS1 except SI00003, SI00008, and SI00014. The Apply Program Temporary Fix (APYPTF) command can then be used to apply these PTFs to the 5722SS1 product.

Example 2: Selecting PTFs 

LODPTF   LICPGM(5722SS1) DEV(OPT01)
  SELECT(SI00009 SI00010)

This command loads the PTFs named SI00009 and SI00010 from the optical device named OPT01. The Apply Program Temporary Fix (APYPTF) command can then be used to apply these PTFs to the 5722SS1 product.

Error messages for LODPTF

*ESCAPE Messages

CPF35AA
Licensed internal code PTF &2 already applied.
CPF35AB
Licensed Internal Code fix &2 not applied.
CPF35AE
Duplicate PTF &1 found.
CPF35A0
Cannot allocate library &1.
CPF35A1
Wrong copy of Licensed Internal Code in use.
CPF35A2
Required hardware changes not installed for PTF &2.
CPF35A3
Licensed Internal Code fix &2 not temporarily applied.
CPF35A5
Licensed Internal Code fix &2 not permanently applied.
CPF35A6
Language option &1 not installed for licensed program.
CPF35A8
No PTFs to be loaded.
CPF35A9
Error occurred while processing Licensed Internal Code fix.
CPF35CF
PTF &1-&2 not applied.
CPF35C1
LODPTF ended. No more storage available.
CPF35C9
PTF &1-&2 &3 not valid.
CPF35EB
Multiple releases of product &1 installed.
CPF35E3
Interface error detected.
CPF35FA
PTF &1-&2 not applied.
CPF35F4
Error occurred during cover letter processing.
CPF35F6
MPTFI for library &1 deleted and created.
CPF354A
Cannot specify *SELECT for the CD-ROM path identifier.
CPF354C
Cannot process PTF files on CD-ROM volume.
CPF354D
Device &1 not allowed.
CPF354E
No file selected.
CPF354F
Required PTF file cannot be processed.
CPF355B
Multiple releases for product &1 found on media.
CPF355C
No PTFs found in path identifier &1.
CPF3558
Cannot allocate &1 in &3 type *&2.
CPF3564
PTF &1-&2 damaged.
CPF358A
Release not valid.
CPF3586
List of PTFs not correct.
CPF3587
PTFs not loaded.
CPF3590
PTF &1-&2 &3 not loaded.
CPF3598
PTF function already in process.
CPF3606
Product &1 &2 not installed.
CPF361D
Apply order of PTFs cannot be determined.
CPF3612
Library &1 not found.
CPF3616
No PTFs loaded.
CPF3619
PTFs for release &1 found on device.
CPF3657
PTFs not loaded because error occurred.
CPF3693
Service function ended because error occurred.
CPF3924
PTF not loaded.
CPF3931
Required programs not found. PTF incomplete.
CPF3945
Records of PTF activity for licensed program are deleted.
CPF3992
No PTFs exist on save/restore media for licensed program &1 &2.
CPF6602
PTF &1-&2 &3 not found.
CPF8191
Product definition &4 in &9 damaged.
CPF8193
Product load object &4 in &9 damaged.