Configure Activation Engine (QAENGCFG) API

Required Parameter Group:

1	Activation request	Input	Char(1)
2	Error code	I/O	Char(*)

Default Public Authority: *EXCLUDE

Threadsafe: No

The Configure Activation Engine (QAENGCFG) API allows for enabling or disabling the activation engine. This API is used for setting the configuration for use when deploying new partitions using captured images from IBM^® Director VMControl.

Authorities and Locks

This API is shipped with *EXCLUDE public authority.

To use this API you must:

be explicitly authorized to the API, or call the API from a program that adopts enough authority to call the API and have *IOSYSCFG special authority.

Required Parameter Group

Activation request

INPUT; CHAR(1)

The input value for the configuration request. Possible values are:

0	Disables the activation engine.
1	Enable the activation engine. This should be done before the partition image is captured.

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
CPF9821 E	Not authorized to program &1 in library &2.
CPF24B4 E	Severe error while addressing parameter list.
CPF3C36 E	Number of parameters, &1 entered for this API was not valid.
CPF3C4B E	Value not valid for field &1.
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.
CPFB0CE E	&1 special authority is required.

API introduced: V7R1

[ Back to top | >Configuration APIs | APIs by category ]