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

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

UI, CTRL, DP