Software Product APIs let you work with software products and program temporary fixes (PTFs) on your system. With these APIs, you can:
- Work with the software license management for a product
- Create and delete product definition and product load objects
- Package one or more product loads for a specified product option
- Retrieve product information about a specific product load
- Create PTFs, retrieve PTF information, and log PTF information
- Retrieve a list of products
For information about packaging and managing software products,
see the System Manager Use, SC41-5321, book.
The steps for packaging a product are the same
whether you use the
System Manager
licensed program commands
or the APIs in this section.
For exit programs, go to Software Product Exit Programs.
The software product APIs are:
- Add License Key Information
(QLZAADDK) allows you to add license key information to the
license repository.
- Add or Remove Product Support (QSZSPTPR) adds or removes support to a product.
- Add Product License Information
(QLZADDLI) adds license information to a product or feature.
- Check Target Release
(QSZCHKTG) verifies that a valid target release value is
specified on a CL command that supports the TGTRLS parameter.
- Copy Program Temporary Fix to Save File
(QPZCPYSV) allows you to copy PTFs for the selected product from the media and store them in
*SERVICE.
- Create Product Definition
(QSZCRTPD) creates a product definition object.
- Create Product Load
(QSZCRTPL) creates a product load object.
- Create Program Temporary Fix
(QPZCRTFX) creates a PTF save file and optionally creates
a PTF cover letter.
- Delete Product Definition
(QSZDLTPD) deletes a product definition object.
- Delete Product Load
(QSZDLTPL) deletes a single product load object.
- Generate CD-ROM Premastering Information
(QLPCDINF, QlpGenCdPremasteringInfo)
generates the distribution set map file. This API also retrieves
information about the files that were saved when the job
was enabled for CD-ROM premastering using
the Hane CD-ROM Premastering State
(QLPCDRST, QlpHaneCdState) API.
- Generate License Key
(QLZAGENK) generates a license key to
enable users to access a product or a feature of a product.
- Generate Program Temporary Fix Name
(QPZGENNM)generates a unique name for PTF save files and cover
letters.
- Handle CD-ROM Premastering State
(QLPCDRST, QlpHaneCdState)
enables and disables the job for CD-ROM premastering.
This API also queries the current CD-ROM premastering job state.
- Install Secondary Language
(QLPISLNG) installs the secondary language
that is specified during interactive mode or
batch mode of installation.
- List Product in a Save File
(QLPLPRDS) generates a list containing product ID, release level,
option, load type, and language ID for all product loads found in a
save file.
- List Program Temporary Fixes
(QpzListPTF) returns a list of PTFs
for the specified product, option, load, and
release.
- Log Program Temporary Fix Information
(QPZLOGFX) logs that a PTF has been received on the system and
can be displayed or loaded from device *SERVICE.
- Package Product Option
(QSZPKGPO) packages one or more product loads for a specified
product option.
- Release License
(QLZARLS) releases a use of the license for the product.
- Request License
(QLZAREQ) requests a use of the license for the product.
- Request Order Assistance
(QMARQSOA) sends a request for order assistance to a service
provider using an ECS connection, and creates a corresponding entry
in the user's order log.
- Retrieve License Information
(QLZARTV) retrieves the license information for a software product.
- Retrieve License Key Information
(QLZARTVK) retrieves the
license key information for the specified product, license terms, and
features for the specified systems from the license repository.
- Retrieve Product Information
(QSZRTVPR) retrieves information about a specific product load for
a software product.
- Retrieve Program Temporary Fix Information
(QPZRTVFX) retrieves basic information about and prerequisites
for a PTF and a list of cover letters for the PTF.
- Select Product
(QSZSLTPR) displays or retrieves a list of products.
|
You may write exit programs that are called by
programs and by program temporary fixes (PTFs).
The software product exit programs include:
- Software Product Functions are specified when creating products that will be restored,
deleted, saved, and checked with CL commands.
- Program Temporary Fix is called when a PTF is temporarily or permanently applied or removed
with the Apply PTF (APYPTF) or Remove PTF (RMVPTF) commands.
- QLPUSER
is called during the automatic installation process and can be
used by central sites when they are
distributing products to remote locations.