convManIdToInt()
Returns an integer that corresponds to the ManagerIdentifier.
Synopsis
int convManIdToInt(char manType, char manNum [, int sysNum [, char replica]]);
Parameters
| Parameter | Meaning |
| manType | Type of manager |
| manNum | Number of the manager |
| sysNum | System number. Per default the system number is 0 and not explicitly the own system number. In non-distributed systems the system number is 1. |
| replica | Replica. In non-redundant systems the replica is 1. |
Return Value
In the event of an error -1, otherwise the manager identifier.
Description
Returns the manager identifier, according to manType, manNum, sysNum and replica. The system number and replica are optional parameters. Application , for example, for restarting a manager with _Managers.Exit. The function includes the manager type number (T), the manager number (N), the replica (R) and system (S) in an int as follows:
RRSSTTNN
Note that the manager identifier returned by the convManIdToInt under 3.1 is compatible to the manager identifier under 3.5.
The manType is evaluated from the constants (for example, API_MAN). The following constants are defined in Control for the manager type:
| NO_MAN | ASCII_MAN |
| API_MAN | CTRL_MAN |
| DB_MAN | DEVICE_MAN |
| DDE_MAN | DIST_MAN |
| DRIVER_MAN | EVENT_MAN |
| REDU_MAN | UI_MAN |
Example
You can use the convManIdToInt as follows with two parameters (Manager type and Manager number).
| main()
{ int manID; dyn_char managers; managers = makeDynChar(UI_MAN); // Manager type constant manID = convManIdToInt(UI_MAN, 1); /* Function call with two parameters. The return value is an integer that corresponds to the manager identifier */ DebugN(manID); } |
You can pass also the parameters system number and replica to the function.
| main()
{ int manID,sys; char rep; dyn_char managers; managers = makeDynChar(UI_MAN); sys = getSystemId("System1:"); //Returns the system ID of the own system rep = 2; //Replica number manID = convManIdToInt(UI_MAN, 1,sys,rep); /* Function call with all parameters */ DebugN(manID); //Integer that corresponds to the manager identifier } |
Assignment
Administration of managers..., User administration
Availability
CTRL
