Copy Program Temporary Fix to Save File (QPZCPYSV) API

The Copy Program Temporary Fix to Save File (QPZCPYSV) API allows you to copy a program temporary fix (PTF) for the selected product from the media and store it in *SERVICE. The PTF can then be displayed, loaded, or copied using the PTF commands.

A save file is created in library QGPL for each PTF that is copied. You can use the Retrieve Program Temporary Fix Information (QPZRTVFX) API to obtain the name of the save file.

If the PTF already exists in *SERVICE, the PTF is not copied.

Cover letters are copied to file QAPZCOVER in library QGPL.

Authorities and Locks

API Public Authority

*EXCLUDE

Device

*USE

Library QGPL

*USE

Lock conflicts may occur if this API is called while another PTF operation is in progress.

Required Parameter Group

Product information

INPUT; CHAR(*)

The information needed to put the PTF into the *SERVICE device.

Product information format name

INPUT; CHAR(8)

The name of the format that describes the product information. The only format name supported is:

PTFV0100

See PTFV0100 Format.

Device name

INPUT; CHAR(10)

The name of the optical device or tape device that contains the PTFs to be copied.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

PTFV0100 Format

The following table describes the format for the product information parameter. The format identifies the product of the PTFs to be copied. For detailed descriptions of the fields, see Field Descriptions.

Offset		Type	Field
Dec	Hex
0	0	BINARY(4)	Length of product information
4	4	CHAR(7)	Product ID
11	B	CHAR(6)	Release
17	11	CHAR(1)	Automatically support product

Field Descriptions

Automatically support product. Indicates that when a PTF for a product currently not supported or installed on the system is found on the media, the product automatically will be marked as supported and the PTF will be copied. If the PTF affects a National Language Version, only the primary language of the system will be supported automatically. You can use the Add or Remove Product Support (QSZSPTPR) API to add support for additional languages.

This field is ignored when *SUPPTD is specified in the product ID field.

0

Do not automatically support the product

1

Automatically support the product

Length of product information. The length of data in the product information format, including this field.

Product ID. The name of the licensed products for which PTFs are to be copied. You can use the following special values for the product ID:

*ALL

PTFs for all products, releases, options, and languages that are either supported or installed on this system are copied from the media.

Caution should be used when specifying this value and indicating automatic support for the product. PTF media frequently contains PTFs for all products available from your service provider. If you specify these values together, all PTFs from the media are copied on to your system.

*SUPPTD

PTFs for all products, releases, options, and languages that are currently supported on this system are copied. PTFs for products that are installed but not supported are not copied.

Release. The version, release, and modification of the product. The release must be in the format VxRyMz. Valid values for x and y are 0 through 9. Valid values for z are 0 through 9 or A through Z. You can use the following special value for the release:

*ALL

PTFs for all releases of the product will be copied.

Error Messages

CPF24B4 E

Severe error while addressing parameter list.

CPF358A E

Release not valid.

CPF35BE E

Product &1 &3 not supported or installed.

CPF35CC E

Library required for building PTFs already exists.

CPF3C1D E

Length specified in parameter &1 not valid.

CPF3C21 E

Format name &1 is not valid.

CPF3C4B E

Value not valid for field &1.

CPF3CF1 E

Error code parameter not valid.

CPF9814 E

Device &1 not found.

CPF9820 E

Not authorized to use library &1.

CPF9825 E

Not authorized to device &1.

CPF9872 E

Program or service program &1 in library &2 ended. Reason code &3.