Request License (QLZAREQ) API

The Request License (QLZAREQ) API requests the use of a product that has been packaged for licensed use. Multiple uses of a product may be requested with a single call to this API. The request causes the usage count to be compared with the usage limit. The uses are assigned to the name that is specified in the license user parameter. The uses remain assigned to the license user until they are released (see

Note: It is suggested that before a Request License (QLZAREQ) is done, the application retrieves the product information handle using the Retrieve License Information API (QLZARTV). The application should then compare this handle with the handle passed back at Add Product License Information time. It should compare the two values before the Request is done. If the handles do not match, the product has been tampered with. This process helps to ensure asset protection.

Authorities and Locks

Public API Authority

*EXCLUDE

Required Parameter Group

Product identification

INPUT; CHAR(*)

Information that uniquely identifies the product or feature whose licensed use is requested. The structure of this information is determined by the name of the format.

Product identification format name

INPUT; CHAR(8)

The name of the format that describes the product identification.

The only format name supported is:

LICP0100

This format identifies the product ID, release level, and feature whose use is requested. See LICP0100 Format.

License user

INPUT; CHAR(*)

The name to which use of the license product is assigned and tracked.

License user format name

INPUT; CHAR(8)

The name of the format that describes the license user information.

The formats supported are:

LICL0100	This format identifies the license user to be requested. See LICL0100 Format.
LICL0200	This format identifies the license user being requested and the multiple uses (number of uses) for each license user. See LICL0200 Format.

Error code

I/O; CHAR(*)

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

LICP0100 Format

For a detailed description of the fields in this table, see Field Descriptions.

LICL0100 Format

For a detailed description of the field in this table, see Field Descriptions.

LICL0200 Format

For a detailed description of the fields in this table, see Field Descriptions.

Field Descriptions

Feature. The feature of the product. Valid values for the feature are 5001 through 9999.

Length of additional license user information. The length of the additional license user information. Set this field to 0 if there is no additional license user information.

License user. The license user being requested. For registered use, specify the nonblank name you want assigned as the license user. For concurrent use, specify *JOB. For processor use, specify *PROCESSOR.

License user handle. This value is passed in by the vendor at the time of the Request License (QLZAREQ) API call. When the vendor wants to release the user, this handle must be specified on the Release License (QLZARLS) API call. This value many be any eight character field, including blanks. If the value specified on the release call does not match the value initially specified on the request call, the license user is not released. This field is never displayed or output through any license management interfaces and is only known to the vendor application.

Length of license user. The length of the license user field. This may be a value 1 through 80. This value may only change within the same license term if there are no current users at the time the change request is made. To conserve space, use the smallest value necessary for this length.

Number of uses requested. The number of license uses being requested for this license user. This value must be between 1 and 999 999. If this field is not specified, the number of uses requested is 1.

Offset to additional license user information. The offset from the beginning of the license user information to the additional information for the first license user. Specify 0 for this field if there is no additional information for the license user.

Offset to license user. The offset from the beginning of the license user information to the first license user.

Product ID. The product ID of the product or feature whose licensed use is requested.

Release level. The version, release, and modification level of the product or feature. The release level must be a valid special value, or the release level must be in the format VxRyMz. Valid values for x and y are 0 through 9. Valid values for z are 0 through 9 and A through Z.

The valid special value is:

Reserved. Reserved for future use. This field must be set to hexadecimal zeros.

Error Messages