| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Install Program Temporary Fix (INSPTF) command allows the user to load and apply PTFs for multiple products with a single command. PTF groups will be copied to the system when they do not already exist on the system or when the level of the PTF group on the media is higher than the level of the PTF group that exists on the system. If LICPGM(*ALL) is specified, any special handling PTFs listed in PTF groups on the media will be used during the install.
The OMIT and HIPER parameters are supplied to allow the user of the INSPTF command to be more selective. These parameters apply only to the PTF loading activity. Any PTF already loaded on the system will be applied.
The INSTYP parameter controls the apply of the PTFs. Using the different special values allows immediate and delayed apply combinations as well as starting an IPL.
INSPTF does not support loading PTFs from tape for products that have multiple releases of the base option installed on the system. If PTFs for such a product exist on the tape, the INSPTF will not load those PTFs and will return an error.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LICPGM | Product description | Values (up to 300 repetitions): Element list | Required, Positional 1 |
| Element 1: Product | Character value, *ALL | ||
| Element 2: Release | Character value, *ONLY | ||
| DEV | Device | Name, *SERVICE, *NONE | Optional |
| INSTYP | PTF apply type | *SRVATT, *DLYIPL, *DLYALL, *IMMONLY, *IMMDLY | Optional |
| OMIT | PTF omit list | Values (up to 50 repetitions): Element list | Optional |
| Element 1: Product | Character value | ||
| Element 2: PTF identifier | Character value | ||
| Element 3: Release | Character value, *ONLY | ||
| HIPER | HIPER PTFs only | *YES, *NO | Optional |
| ENDOPT | End of media option | *REWIND, *LEAVE, *UNLOAD | Optional |
| RESTART | Restart type | *IPLA, *SYS, *FULL | Optional |
| PMTMED | Prompt for media | *SNGVOLSET, *MLTVOLSET, *MLTSRV | Optional |
| CPYPTF | Copy PTFs | *SRVATT, *YES, *NO | Optional |
| Top |
Specifies the product ID, version, release, and modification level of the products for which PTFs should be installed.
The possible values are:
The possible Licensed Program value is:
The possible Release Level of the Licensed Program values are:
| Top |
Specifies the device from which the PTFs are loaded. The device name must already be known on the system by a device description.
The possible values are:
| Top |
Specifies the type of install to perform.
The possible values are:
Attention:
The service attribute is shipped with *DLYIPL as the default. Use the Change Service Attributes (CHGSRVA) command to change the default.
| Top |
Specifies the product ID, version, release, modification level, and PTF ID for PTFs that should not be loaded. The current state of the PTF is not checked before being passed to LODPTF. If the PTF is already loaded it is applied. A maximum of 50 PTFs can be omitted.
The possible Licensed-Program value is:
The possible PTF-Number values is:
The possible Release Level values are:
| Top |
Specifies whether only high-impact pervasive (HIPER) PTFs should be loaded when installing from a media.
Note: This parameter is ignored if DEV(*SERVICE) is specified. This is valid only when installing IBM cumulative/preventive PTF packages.
The possible values are:
| Top |
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.
The possible values are:
| Top |
Specifies the point from which the initial program load (IPL) restarts when the PTF apply type (INSTYP) parameter indicates an IPL will be performed.
Note: This is valid only when INSTYP(*DLYIPL) is specified or when INSTYP(*SRVATT) is specified and the PTF install type (PTFINSTYP) service attribute is set to *DLYIPL.
The possible values are:
The operating system is always restarted. The hardware is restarted only if a PTF that requires a restart is applied. Other hardware functions, such as some configuration changes, that occur during a *FULL IPL are not processed.
*SYS can result in a shorter IPL time than if you specify *FULL.
| Top |
Specifies whether the user will be prompted for additional PTF volume sets and load PTFs from *SERVICE after loading PTFs from a device.
Note: This parameter is ignored if DEV(*SERVICE) or DEV(*NONE) is specified.
The possible values are:
| Top |
Specifies whether to copy PTF save files and cover letters 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.
Note: This parameter is ignored if DEV(*SERVICE) or DEV(*NONE) is specified.
| Top |
Example 1: Omitting PTFs
INSPTF LICPGM((*ALL)) DEV(*SERVICE) INSTYP(*IMMDLY)
OMIT((5722999 MF12345 V5R4M0) (5722SS1 SI12345 V5R4M0))
This command will load all PTFs that are in *SERVICE for all products installed on the system except MF12345 and SI12345. It will then apply all PTFs in loaded status that can be applied immediately and mark the rest for delayed apply.
Example 2: Installing HIPER only
INSPTF LICPGM((5722PT1 V5R4M0)) DEV(TAP01) INSTYP(*IMMONLY)
HIPER(*YES)
This command will search the media for PTFs for the V5R4M0 Performance Tools product in the HIPER section. Each PTF that can be applied immediately will be. Delayed PTFs will be loaded, but not marked for apply.
Example 3: Installing Only Immediate PTFs
INSPTF LICPGM((*ALL)) DEV(TAP01) INSTYP(*IMMONLY)
ENDOPT(*LEAVE)
This command will load all PTFs for the products that are installed on the system, from the device TAP01. All PTFs in loaded status on the system that can be applied immediately will be. No delayed PTFs will be set for apply.
| Top |
*ESCAPE Messages
| Top |