setRcvLevel()

The function sets the receive debug level for messages.

Synopsis

int setRcvLevel(int level, string msgFilter = "all", string manFilter = "all")

Parameters

Parameter Description
level The receive level for messages. See -rcv level.
msgFilter The optional msgFilter corresponds to the command line option -rcvFilterMsg.
manFilter

The optional manFilter corresponds to the command line option -rcvFilterMan.

Return value

The function returns 0 if it was executed successfully and -1 if an error occurred (e.g. an unknown manager name).

Errors

Missing/incorrect arguments.

Description

The function sets the receive debug level for messages (corresponds to the command line option -rcv level). For more information about the different message categories - see chapter Message Diagnostics.

Note: Note that calling setRcvLevel() adds the manager/message filters to the already active filters. If you do not want to filter messages/managers, do not specify the optional arguments or pass "all" as a filter option.

The function setRcvLevel() sets the level to 2 and the function getRcvLevel() returns it.

main()
{
  int i;
  i = setRcvLevel(2);
  int recLevel = getRcvLevel();
  DebugN("The set receive level:", recLevel);
}

Assignment

Administration of managers, modules and panels

Availability

CTRL