Load Program Temporary Fix (LODPTF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Load Program Temporary Fix (LODPTF) command loads program temporary fixes (PTFs) for a specified product from a tape, optical device, 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 can be loaded at one time. Specific PTFs can be selected or omitted when loading PTFs for the specified product. PTFs that are currently applied are not loaded.
Restrictions:
- To use this command, you must be signed on as QSRV, or have all object (*ALLOBJ) special authority.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LICPGM | Product | Character value | Required, Positional 1 |
| DEV | Device | Name, *SERVICE, *SAVF | Optional |
| SELECT | PTF numbers to select | Single values: *ALL Other values (up to 50 repetitions): Character value |
Optional |
| OMIT | PTF numbers to omit | Values (up to 50 repetitions): Character value | Optional |
| SPRPTF | Superseded PTFs | *APYPERM, *NOAPY | Optional |
| RLS | Release | Character value, *ONLY | Optional |
| SEQNBR | Sequence number | 1-16777215, *SEARCH | Optional |
| ENDOPT | End of media option | *REWIND, *LEAVE, *UNLOAD | Optional |
| PATHID | Path identifier | 1-9999, *FIRST, *SELECT | Optional |
| SAVF | Save file | Qualified object name | Optional |
| Qualifier 1: Save file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| COVER | Copy PTF cover letter | *SRVATT, *YES, *NO, *ONLY | Optional |
| CPYSAVF | Copy PTF save file | *SRVATT, *YES, *NO | Optional |
| Top |
Product (LICPGM)
Specifies the 7-character identifier of the product for which the PTFs are loaded.
This is a required parameter.
| Top |
Device (DEV)
Specifies the device from which the PTFs are loaded. The device name must be known on the system by a device description.
- *SERVICE
- The PTFs that were sent from the service support system are loaded.
- *SAVF
- The PTFs are loaded from a save file. If *SAVF is specified, a value for the Save file (SAVF) parameter is required.
- name
- Specify the name of the tape or optical device that is used to load the PTFs.
| Top |
PTF numbers to select (SELECT)
Specifies which of the PTFs for the specified product are loaded. The PTF numbers to omit (OMIT) parameter cannot be specified if single PTF numbers are specified for this parameter.
Note: Permanently removed and Damaged PTFs are ignored when SELECT(*ALL) and DEV(*SERVICE) are specified. To load a Permanently removed or Damaged PTF, specify the PTF number on this parameter.
Single values
- *ALL
- All the PTFs for the specified product are loaded.
Other values (up to 50 repetitions)
- character-value
- Specify the PTF identification numbers of the single PTFs that are loaded.
| Top |
PTF numbers to omit (OMIT)
Specifies that all PTFs except for those specified in this parameter are loaded. A maximum of 50 PTF numbers can be specified.
Note: The OMIT parameter cannot be specified if single PTF numbers are specified on the PTF numbers to select (SELECT) parameter.
- character-value
- Specify the PTF identification numbers of the single PTFs that are omitted (not loaded).
| Top |
Superseded PTFs (SPRPTF)
Specifies the operation that is performed for temporarily applied PTFs that are being superseded by PTFs encountered by this load operation. The parameter also specifies the operation performed for temporarily applied PTFs that are technology refresh requisite (*TRREQ) PTFs for PTFs being loaded.
- *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. Any temporarily applied technology refresh requisite (*TRREQ) PTFs for the PTFs being loaded, are automatically permanently applied before loading the dependent PTFs. If the superseded or technology refresh requisite (*TRREQ) 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 being superseded must be permanently applied (APYPTF command) or removed (RMVPTF command) before the LODPTF command can be processed again.
The load operation stops if any technology refresh requisite (*TRREQ) PTFs for PTFs being loaded are temporarily applied. The technology refresh requisite (*TRREQ) PTFs must be permanently applied (APYPTF command) before the LODPTF command can be processed again.
| Top |
Release (RLS)
Specifies the release level of the PTFs being loaded.
- *ONLY
- This value is valid only 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.
- character-value
- Specify the release level in one of the following formats:
- VxRyMz, 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.
- vvrrmm, where version vv and release rr must be a number from 00 through 35, and modification mm must be a number from 00 through 09 or a letter from 0A through 0Z. The leading zeros are required. This format must be used if the version or release of the product is greater than 9.
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.
| Top |
Sequence number (SEQNBR)
Specifies the sequence number on the tape volume where the load operation begins to load the PTF data. This parameter is valid only if a tape device name is specified on the Device (DEV) parameter.
- *SEARCH
- The tape volume is searched for the first PTF file for the specified product. The first PTF file found is loaded.
- 1-16777215
- Specify the sequence number of the PTF file being loaded. This sequence number must exist on the tape.
| Top |
End of media option (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 operation ends. Some optical devices will eject the volume after the operation ends.
| Top |
Path identifier (PATHID)
Specifies the number that identifies a file on the optical media 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 media 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 media 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.
- 1-9999
- Specify the path identifier number of the existing PTF file from which to load the PTF data.
| Top |
Save file (SAVF)
Specifies the save file from which the PTFs are loaded. This parameter is valid only if *SAVF is specified on the Device (DEV) parameter.
Qualifier 1: Save file
- name
- Specify the name of the save file from which the PTFs are loaded.
Qualifier 2: Library
- *LIBL
- All libraries in the library list for the current thread are searched until the first match is found.
- *CURLIB
- The current library for the job is used to locate the save file. If no library is specified as the current library for the job, the QGPL library is used.
- name
- Specify the name of the library where the save file is located.
| Top |
Copy PTF cover letter (COVER)
Specifies whether to copy the cover letter for the PTF into a physical file. This parameter is valid only when a tape or optical device name is specified on the Device (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 PTF is not loaded. If the SEQNBR parameter is specified, it must contain the sequence number of the file that contains the PTF.
- *SRVATT
- Use the Copy PTFs (CPYPTF) service attribute to determine if the cover letter for the PTF should be copied into a physical file. The Display Service Attributes (DSPSRVA) command displays information about how the system is set up. This includes whether PTF save files and cover letters will be copied into *SERVICE when PTFs are loaded. The Change Service Attributes (CHGSRVA) command can be used to change the CPYPTF service attribute.
| Top |
Copy PTF save file (CPYSAVF)
Specifies whether to copy PTF save files into *SERVICE when PTFs are loaded. PTF save files must be in *SERVICE when distributing PTFs to other systems or when using the Save System Information (SAVSYSINF) command. This parameter is valid only when a tape or optical device name is specified on the Device (DEV) parameter.
- *SRVATT
- Use the Copy PTFs (CPYPTF) service attribute to determine if PTF save files will be copied into *SERVICE when PTFs are loaded. The Display Service Attributes (DSPSRVA) command displays information about how the system is set up. This includes whether PTF save files and cover letters will be copied into *SERVICE when PTFs are loaded. The Change Service Attributes (CHGSRVA) command can be used to change the CPYPTF service attribute.
- *YES
- PTF save files that do not already exist are copied into *SERVICE when PTFs are loaded.
- *NO
- PTF save files are not copied into *SERVICE when PTFs are loaded.
| Top |
Examples
Example 1: Omitting PTFs
LODPTF LICPGM(57xxSS1) OMIT(SI00003 SI00008 SI00014)
This command loads all of the PTFs from the service support system (*SERVICE) for the product 57xxSS1 except SI00003, SI00008, and SI00014. The Apply Program Temporary Fix (APYPTF) command can then be used to apply these PTFs to the 57xxSS1 product.
Example 2: Selecting PTFs
LODPTF LICPGM(57xxSS1) 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 57xxSS1 product.
| Top |
Error messages
*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.
- CPF35CC
- Library required for PTF operation already exists.
- CPF35CF
- PTF &1-&2 not applied.
- CPF35C1
- LODPTF ended. No more storage available.
- CPF35C9
- PTF &1-&2 &4 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 path identifier.
- CPF354C
- Cannot process PTF files on optical 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 &5 not loaded.
- CPF3598
- PTF function already in process.
- CPF36BE
- PTFs not loaded, technology refresh requisite error.
- CPF3606
- Product &1 &3 not installed.
- CPF361D
- Apply order of PTFs cannot be determined.
- CPF3612
- Library &1 not found.
- CPF3616
- No PTFs loaded.
- CPF3619
- PTFs for release &4 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 &3.
- CPF6602
- PTF &1-&2 &4 not found.
- CPF8191
- Product definition &4 in &9 damaged.
- CPF8193
- Product load object &4 in &9 damaged.
| Top |