Accept Software Agreement (QLPACAGR) API


  Required Parameter Group:

1 Product ID Input Char(7)
2 Product release Input Char(6)
3 Product option Input Char(4)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Accept Software Agreement (QLPACAGR) API records the acceptance of the software agreement for a product. It is assumed that the caller of this API has previously displayed and obtained acceptance for the terms of the agreement.

This API cannot be used to accept the Licensed Internal Code or the IBM® i *Base software agreements.


Authorities and Locks

Public API authority
*USE authority to RSTLICPGM command.

Required Parameter Group

Product ID
INPUT; CHAR(7)

The 7-character ID of the product for which the software agreement is being accepted. The product ID must be in the format nxxxxxx, where n is any numeric character 0 through 9, and x is any numeric character 0 through 9 or uppercase letter A through Z.

Product release
INPUT; CHAR(6)

The version, release, and modification level of the product for which the software agreement is being accepted. The release must be in the format VxRyMz, where x is any numeric character 0 through 9, y is any numeric character 0 through 9, and z is any numeric character 0 through 9 or uppercase letter A through Z. For example, V5R2M0 is version 5, release 2, modification 0.

Product option
INPUT; CHAR(4)

The option number of the product for which the software agreement is being accepted. Use 0000 for the base option. Valid values are 0000 through 0099, where each character is a digit.

Error code
I/O; CHAR(*)

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


Error Messages

Message ID Error Message Text
CPF358A E Release not valid.
CPF3DDD E Unable to accept software agreement.
CPF3DDE E Product identifier &1 option &2 not allowed.
CPF3DDF E Product option &2 not valid.
CPF3DEF E Product identifier &1 not valid.
CPF3DF3 E Not authorized to accept software agreement.
CPF24B4 E Severe error while addressing parameter list.
CPF3CF1 E Error code parameter not valid.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V5R2

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