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