Add or Remove Product Support (QSZSPTPR) API


  Required Parameter Group:


  Default Public Authority: *USE

  Threadsafe: No

The Add or Remove Product Support (QSZSPTPR) API adds or removes support to a product. The action is performed by specifying a product ID, release, option number, and load ID. When you are adding support to a product, you indicate that you want to be able to order and receive program temporary fixes (PTFs) to maintain that product. An information entry is also created for that product.

Removing product support does not remove related PTF save files or PTF information. PTFs for products that are not supported, however, cannot be distributed using the IBM® System Manager for i licensed program.


Authorities and Locks

Product Availability Authority
None

Product Availability Lock
*SHRRD. The product availability object resides in the QUSRSYS library.

Product Definition Authority
None

Product Load Authority
None

Required Parameter Group

Product information
INPUT; CHAR(*)

The product for which support is to be added or removed. For the structure of this parameter, see Format of Product Information Parameter.

Length of product information
INPUT; BINARY(4)

The length of the product information parameter in bytes. The value specified must be at least 53.

Product information format name
INPUT; CHAR(8)

The content and format of the product information. The possible format name is:


Requested action
INPUT; BINARY(4)

The action to be performed against each of the products in the list. Valid values are:


Error code
I/O; CHAR(*)

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


Format of Product Information Parameter

The following table shows the format of the product information parameter. For a description of the fields in this format, see Field Descriptions.



Field Descriptions

Library. The name of the principal or main library of the product to be supported. This value is optional. If support is being removed or no library is specified when adding support, this field should contain blanks.

Load ID. The load ID of the product for which support is being added or removed. Load IDs are 4 characters in length; for example, 2924 is the load ID for an English national language version (NLV).

You can use this special value for the load ID:

Product ID. The 7-character ID for the product for which support is being added or removed.

Product option. The option number of the product for which support is being added or removed. Use 0000 for the base option. Valid values are 0000 through 0099, where each character is a digit.

Registration type. The registration type associated with the product. This value is optional. If the registration type is not specified, this field should contain blanks. Together, the registration type and registration value make up the registration identifier for the product.

The possible values are:

Registration value. The registration value associated with the product. This is a 14-character value. If the registration type is not specified, this field should contain blanks. Together, the registration type and registration value make up the registration ID for the product.

Release. The version, release, and modification level of the product.

Start of change

The release can be passed as one of the following two formats:

End of change

Error Messages



API introduced: V4R4

[ Back to top | Software Product APIs | APIs by category ]