| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Program Temporary Fix (CRTPTF) command creates a temporary fix for a product that you have developed. The product must be created and installed before using this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| PTF | PTF identifier | Character value | Required, Positional 1 |
| LICPGM | Product | Character value | Required, Positional 2 |
| RLS | Release level | Character value | Required, Positional 3 |
| OPTION | Option | 1-99, *BASE | Optional |
| LODID | Load ID | Character value, *CODEDFT | Optional |
| PTFOBJ | PTF objects | Single values: *NONE Other values (up to 300 repetitions): Element list |
Optional |
| Element 1: Object name | Name | ||
| Element 2: Object type | Character value | ||
| OBJLIB | Object libraries | Element list | Optional |
| Element 1: Development library | Name, *CURLIB | ||
| Element 2: Primary library | Name, *PRINCIPAL | ||
| PTFDOC | PTF documents | Single values: *NONE Other values (up to 300 repetitions): Element list |
Optional |
| Element 1: Document | Character value | ||
| Element 2: Folder | Character value | ||
| DIROBJ | Objects in a directory | Single values: *NONE Other values (up to 30 repetitions): Element list |
Optional |
| Element 1: Product Directory | Path name | ||
| Element 2: Development Directory | Path name, *PRDDIR | ||
| Element 3: Object | Values (up to 100 repetitions): Character value | ||
| COVER | Cover letters | Single values: *NONE Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Source cover letter file | Qualified object name | ||
| Qualifier 1: Source cover letter file | Name | ||
| Qualifier 2: Library | Name, *LIBL | ||
| Element 2: Source cover letter member | Name | ||
| Element 3: National language version | Character value | ||
| PREREQ | Prerequisite PTFs | Single values: *NONE Other values (up to 300 repetitions): Character value |
Optional |
| COREQ | Corequisite PTFs | Single values: *NONE Other values (up to 300 repetitions): Character value |
Optional |
| EXITPGM | PTF exit programs | Single values: *NONE Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Program | Qualified object name | ||
| Qualifier 1: Program | Name | ||
| Qualifier 2: Library | Name, *CURLIB | ||
| Element 2: Run option | *BOTH, *APPLY, *REMOVE, *PREAPY, *PRERMV, *PREBTH | ||
| Element 3: Type | *PTF, *OBJLST | ||
| Element 4: User data | Character value, *NONE | ||
| TGTRLS | Target release | Character value, *CURRENT, *PRV | Optional |
| Top |
Specifies the identifier (ID) of the PTF being created. The PTF ID must be in the valid range for the specified product and release.
| Top |
| Top |
Specifies the version, release, and modification level of the product the PTF is being created for.
| Top |
Specifies whether the PTF is for the base product or an option of the base product.
The possible values are:
| Top |
Specifies the load ID for the PTF being created.
The possible values are:
| Top |
Specifies the objects to be contained in the PTF. The objects must be listed with their associated object type. They must exist in the development library specified and the primary library specified on the OBJLIB parameter. A maximum of 300 objects can be specified.
The possible values are:
The possible PTF object name values are:
The possible PTF object type values are:
| Top |
Specifies the development library and primary library for this PTF.
The possible development library values are:
The possible primary library values are:
| Top |
Specifies the documents to be contained in the PTF. A maximum of 300 documents can be specified.
The possible values are:
The possible PTF document name values are:
The possible PTF folder name values are:
| Top |
Specifies the product directory that the PTF is for, the development directory where the PTF is found, and the names of objects in the development directory that are included in the PTF.
Up to 30 repetitions are permitted. A product directory, a development directory, and at least one object name must be specified unless DIROBJ(*NONE) is specified.
The following restrictions exist when you are assigning directory names:
A backslash (\) in the directory name is always converted to a forward slash (/). A trailing slash is always ignored. Imbedded blanks and the following characters are not allowed in a directory name:
If the leading slash (/) is omitted, one will be assumed, and the inclusion of this leading slash must not cause the directory name to exceed the maximum directory name length of 240 characters. The directory name may indicate a directory that is nested in other directories, for example, /A/B/C. The maximum directory name length includes all slashes and all nested directory names.
The possible single value is:
Element 1: Product Directory Name
Element 2: Development Directory Name
Element 3: Object Name
A given object name must be specified no more than once.
Objects names are limited to a maximum of 255 characters.
| Top |
Specifies the file containing the source text for the PTF cover letter. A member is added to the PTF cover letter file QAPZCOVER in library QGPL. The source text data, PTF language, the data that takes the place of the data, and the requisite information is copied to the member. A maximum of 50 cover letters can be specified.
The possible single value is:
The possible value for the cover letter member is:
The possible library values are:
The possible value for the cover letter file is:
The possible cover letter language value is:
| Top |
Specifies a list of PTFs that must be applied before applying the current PTF. If these PTFs are not applied, the current PTF will not function. A maximum of 300 prerequisites and corequisites combined can be specified.
The possible values are:
| Top |
Specifies a list of accompanying PTFs that are required to enable the new PTF. The current PTF is not applied unless all accompanying PTFs listed are also applied. A maximum of 300 prerequisites and corequisites combined can be specified.
The possible values are:
| Top |
Specifies the exit programs to be to be called during the PTF apply or remove operation. A maximum of 50 exit programs can be specified.
The possible single value is:
The possible program name values are:
The possible library values are:
The possible run option values are:
The possible type values are:
The possible user data values are:
| Top |
Specifies the earliest release of the operating system on which you intend to load and apply the PTF.
| Top |
Example 1: Creating a PTF
CRTPTF PTF(1X00001) LICPGM(1X12345) RLS(V5R2M0)
OPTION(*BASE) LODID(*CODEDFT) PTFOBJ((X00PGM01 *PGM))
OBJLIB(PTFDEVLIB *PRINCIPAL)
This command creates PTF 1X00001 for release V5R2M0 of product 1X12345. The PTF is created using program X00PGM01 in library PTFDEVLIB. When applied, this PTF replaces program X00PGM01 in the principal product library of the *BASE option code load. This PTF is created to be loaded and applied on the current release of the operating system or any later release.
Example 2: Creating a PTF with a Document
CRTPTF PTF(1X00002) LICPGM(1X12345) RLS(V5R2M0)
OPTION(*BASE) LODID(*CODEDFT)
PTFDOC((X00DOC.001 X00FLR.001))
This command creates PTF 1X00002 for release V5R2M0 of product 1X12345. The PTF is created using document X00DOC.001 in folder X00FLR.001/QP. Notice that the document is taken from folder X00FLR.001/QP. Create PTF adds "/QP" to the end of the folder specified when searching for the document to be included. When applied, this PTF replaces document X00DOC.001 in folder X00FLR.001 of the *BASE option code load.
Example 3: Creating a PTF with a Cover Letter
CRTPTF PTF(1X00003) LICPGM(1X12345) RLS(V5R2M0)
OPTION(*BASE) LODID(*CODEDFT)
COVER((PTFDEVLIB/PTFCVRLTRF PTF1X00003 2924))
EXITPGM((EXTPGMLIB/QPZ1X00003 *BOTH *PTF))
This command creates PTF 1X00003 for release V5R2M0 of product 1X12345. The cover letter for the PTF is created using source text from file PTFCVRLTRF in library PTFDEVLIB member PTF1X00003. The cover letter is created for National Language Version (NLV) 2924. The *PTF value specified on the exit program parameter causes program QPZ1X00003 to be saved with the PTF as a temporary object. Temporary objects are deleted when the PTF is permanently applied or removed. Note the temporary object naming convention is used for the exit program. Ensure that any temporary object names used are unique for this product release to avoid over writing other PTFs. The *BOTH value causes this exit program to be called during both apply and remove processing. Temporary objects are identified by QPZ1 at the beginning of the name.
Example 4: Creating a PTF for a Previous Release
CRTPTF PTF(1X00004) LICPGM(1X12345) RLS(V5R3M0)
OPTION(*BASE) LODID(*CODEDFT)
PTFOBJ((X00PGM02 *PGM))
OBJLIB(PTFDEVLIB *PRINCIPAL) TGTRLS(V5R3M0)
This command creates PTF 1X00004 for release V5R3M0 of product 1X12345. The PTF is created using program X00PGM02 in library PTFDEVLIB. When applied, this PTF replaces program X00PGM02 in the principal product library of the *BASE option code load. This PTF is created to be loaded and applied on release V5R3M0 of the operating system or any later release.
| Top |
*ESCAPE Messages
| Top |