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 Product Release can be passed as one
of the following two formats:
- 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, V7R2M0 is version 7, release 2, modification 0.
- vvrrmm
- Where vv are any numeric characters 00 through 35 representing the version of the product, rr are any numeric characters 00 through 35 representing the release of the product, and mm can be 00 through 09 or 0A through 0Z representing the modification of the product. This format must be used if the version or release of the product is greater than 9. For example, 110300 is version 11, release 3, 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