Create PTF Package (CRTPTFPKG)

Parameters

Keyword	Description	Choices	Notes
OUTFILE	Package output file	Qualified object name	Required, Positional 1
	Qualifier 1: Package output file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Package output member	Element list	Optional
	Element 1: Member	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD
SELECT	PTFs to select file	Single values: SUPPTD Other values: Element list*	Optional
	Element 1: File	Qualified object name
	Qualifier 1: File	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
	Element 2: Member	Name, *FIRST
OMIT	PTFs to omit file	Single values: NONE Other values: Element list*	Optional
	Element 1: File	Qualified object name
	Qualifier 1: File	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
	Element 2: Member	Name, *FIRST
SUPERSEDE	Replace Superseded PTFs	NO, YES	Optional
PREREQ	Include prerequisite PTFs	ALL, NONE, *SAMEPRD	Optional
DEV	Device	Character value, *NONE	Optional
VOL	Volume identifier	Character value, *MOUNTED	Optional
SEQNBR	Sequence number	1-16777215, *END	Optional
ENDOPT	End of media option	REWIND, LEAVE, *UNLOAD	Optional
COVER	Cover letter NLV	Character value, *NONE	Optional

Top

Package output file (OUTFILE)

Specifies the physical database file to which the list of PTFs contained in the package is directed. If the output file does not exist, the system creates it.

The name of the 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.

The possible file name value is:

file-name: Specify the name of the file that receives the list of PTFs contained in the package.

Package output member (OUTMBR)

Specifies the name of the database file member to which the list of PTFs contained in the package is directed.

The possible Member Name values are:

*FIRST: The first member in the file receives the list of PTFs contained in the package. If the file does not contain a member, the system creates one.
member-name: Specify the database file member which receives the list. If the member does not exist, it is added.

The possible Add or Replace Records values are:

*REPLACE: The output data replaces any existing records in the specified file member.
*ADD: The output data is added to the end of any existing records in the specified file member.

PTFs to select file (SELECT)

Specifies the database file containing the list from which PTFs are selected.

Note:

If a PTF has had another take its place the most current PTF is selected.

The possible values are:

*SUPPTD: The system generates the list of PTFs from which to select. The list contains all PTFs for all the products supported on the system.

Element 1: File Name

The name of the 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 used 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.
file-name: Specify the name of the file containing the list from which PTFs are selected.

Element 2: File Member

*FIRST: The first member in the file contains the list of PTFs from which to select. If the file does not contain a member, it is created.
member-name: Specify the database file member containing the list of PTFs from which to select. If the member does not exist, it is created.

PTFs to omit file (OMIT)

Specifies the database file which contains the list of PTFs to omit from the package. The PTFs listed in this file that also exist in the file specified on the SELECT parameter are omitted from the package. Only prerequisites and corequisites that are needed on the system are selected.

The possible values are:

*NONE: All PTFs listed in the file specified on the SELECT parameter are included in the package.

Element 1: File Name

The name of the 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.

The possible value for the file name is:

file-name: Specify the name of the file containing the list of PTFs to omit.

Element 2: File Member

*FIRST: The first member in the file contains the list of PTFs to omit. If the file does not contain a member, one is created.
member-name: Specify the database file member containing the list of PTFs to omit. If the member does not exist, it is created.

Replace Superseded PTFs (SUPERSEDE)

Specifies whether superseding PTFs are packaged in place of superseded PTFs.

The possible values are:

*YES: Any superseding PTFs are packaged in place of the superseded PTFs.
*NO: Superseding PTFs are not packaged in place of the superseded PTFs.

Include prerequisite PTFs (PREREQ)

Specifies whether prerequisite PTFs are included in the package. If prerequisite PTFs are included in the package,then corequisite PTFs also are included.

The possible values are:

*ALL: Include all prerequisite and corequisite PTFs in this package.
*NONE: No prerequisites and corequisites are included in the package.
*SAMEPRD: Prerequisites and corequisites that are in the same product as the PTFs are included in the package.

Device (DEV)

Specifies the name of the device to which the PTF package is saved.

The possible values are:

*NONE: Only the package output file is generated.
device-name: Specify the name of the device to which the package is saved.

Sequence number (SEQNBR)

Specifies the sequence number of the data file that receives the saved package.

The possible values are:

*END: The system saves the package after the last sequence number on the tape.
sequence-number: Specify the sequence number of the file. Valid values range from 1 through 16777215.

End of media option (ENDOPT)

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

Note: This parameter is only valid 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:

*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.

Cover letter NLV (COVER)

Specifies the language used to select the cover letters for this PTF package.

The possible values are:

*NONE: Cover letters are not saved.
29xx: Specify the national language version (NLV) of cover letters being saved.

Examples

Before you can use the CRTPTFPKG command, an output file must be created on the service requester by running the Display PTF (DSPPTF) command and directing the output to a file. For the following examples, output file MYOUTF is created by running the following command:

DSPPTF   OUTPUT(MYOUTF)  OUTFILE(MYOUTF)

Example 1: Creating a PTF Package to Tape

CRTPTFPKG   OUTFILE(MYOUTF)  DEV(TAP01)

This command creates a tape with all PTFs that are currently on the service provider but not on the service requester.

Example 2: Creating a PTF Package to Optical

CRTPTFPKG   OUTFILE(MYOUTF)  DEV(OPT01)

This command creates an optical media with all PTFs that are currently on the service provider but not on the service requester.