Adds an engine to an existing engine group or, if the group does not exist, creates an engine group and adds the engine.
sp_addengine engine_number, engine_group [, instance_id]
is the number of the engine you are adding to the group. Legal values are between 0 and a maximum equal to the number of configured online engines minus one.
is the name of the engine group to which you are adding the engine. If engine_group does not exist, Adaptive Server creates it and adds the engine to it. Engine group names must conform to the rules for identifiers. For details, see Chapter 4, “Expressions, Identifiers, and Wildcard Characters” in Reference Manual: Building Blocks.
in cluster environments – ID of the instance to which you are adding an engine or engine group.
If no engine group is called DS_GROUP, this statement establishes the group. If DS_GROUP already exists, this statement adds engine number 2 to that group:
sp_addengine 2, DS_GROUP
Adds engine number 5 to instance ID 8:
sp_addengine 5, 8
sp_addengine creates a new engine group if the value of engine_group does not already exist.
If sp_cluster set system_view is set to cluster, you can add an engine or engine group to any instance in the cluster. If system_view is set to instance, you can add and engine or engine group only to a local instance.
The engine groups ANYENGINE and LASTONLINE are predefined. ANYENGINE includes all existing engines. LASTONLINE specifies the engine with highest engine number. A System Administrator can create additional engine groups. You cannot modify predefined engine groups.
As soon as you use sp_bindexeclass to bind applications or logins to an execution class associated with engine_group, the associated process may start running on engine_number.
Prior to making engine affinity assignments, study the environment and consider the number of non-preferred applications and the number of Adaptive Server engines available. See the Performance and Tuning Guide for more information about non-preferred applications.
Only a System Administrator can execute sp_addengine.
Values in event and extrainfo columns from the sysaudits table are:
Event |
Audit option |
Command or access audited |
Information in extrainfo |
|---|---|---|---|
38 |
exec_procedure |
Execution of a procedure |
|
System procedures sp_addexeclass, sp_bindexeclass, sp_clearpsexe, sp_dropengine, sp_setpsexe, sp_showcontrolinfo, sp_showexeclass, sp_showpsexe, sp_unbindexeclass
