Real-Time Signals

Users configure their devices (IP phones, AV conferencing tools, Instant Messaging tools) to connect to a selected Server when they go on-line.

Each user has a unique "XMPP identifier" or "SIP identifier", also called AOR (Address of Record).

For session-less protocols such as SIP, the Server registers the users by remembering their "SIP identifier" and the network (IP) addresses they use.

Each user may have several registrations active if that user has several communication devices in the on-line mode (an office IP Phone, a desktop computer, an instant messaging program on a laptop, etc.)

Registrations allow SIP users to communicate with each other without the knowledge of the network addresses being used, using just the "SIP identifiers" (AORs).

AORs have the same form as E-mail addresses: username@domainName. The CommuniGate Pro user AOR is the full name of the user Account, so the user SIP AOR name is exactly the same as the user E-mail address.

CommuniGate Pro uses the Router component for all Real-Time Communication operations, so Aliases, Forwarders, and other Routing methods work for Real-Time Communications, too.

A Signal is a basic Real-time Task. One Real-time entity can send Signals to some other Real-time entity to start, modify, or stop a communication dialog, to deliver a status update, etc.

The sending entity composes a Request object and sends it to the CommuniGate Pro Signal module. The Signal module processes the Request, optionally sends Requests to other entities, and returns a Response object to the sending entity.

Many CommuniGate Pro modules and components can use Signals:

• The SIP Module server subcomponent receives Requests from external Real-time entities (SIP clients, other SIP Servers) using the SIP protocol. When the Signal Module generates a Response object, the SIP Module sends the response back to the external entity.
• The XMPP Module and XIMSS Module send and receive Signal Requests and Responses, and transfer them between the client application and the CommuniGate Pro Server.
• Internal Real-time Node, such as Real-Time Application nodes (such as PBX applications) can send various Signal requests.
• Automated Processing Rules can use Signals (to send Instant Messages as notifications).

When the Signal Module receives a Request, it calculates the target URI for it. It takes the Request URI (or the first Route URI in the Request Route set), and uses the Router component to detect the Request destination. There are several possible outcomes of this process:

• The Router returned an error code (for example, the Request URI addressed a local Account that does not exist). This error code is returned to the Signal source, and processing stops.
• The Router returned a non-local address (an address in a non-local Domain). The Request is passed to the SIP Module for relaying. The Response returned with the SIP module is passed to the Signal source.
• The Router returned an address of a local internal Real-time Node. The Request is passed to that Node for processing. The Response returned with the Node is passed to the Signal source.
• The Router returned a local Account address, and the Request can be processed with the Signal Module itself. The Request is processed, and the Response is returned to the Signal source. This case includes REGISTER-type Requests and other Requests which URIs target local Domains.
• The Router returned a local address, and the Request cannot be processed with the Signal Module itself. The the Forking process starts with the Request URI as the initial AOR set.
• The Router returned the null address. The OK code is returned to the Signal source without further processing.

The following diagram illustrates the Signal flow inside the CommuniGate Pro Server:

After an address has been processed with the Router, but before it was relayed to a local or a remote entity, Server-wide and Cluster-wide Automated Signal Processing Rules are applied.

The Rules control how the Request is processed: they can direct it to a different destination, or they can reject the Request.

Only the Dialog-initiating Requests are processed with the Automated Rules.

The Signal module maintains the AOR (Address-of-Record) and Contact sets for each Request it processed. The module starts the Forking process by processing addresses in the AOR set.

When a 2xx response is received while processing any AOR, AOR processing stops. If the Request was an INVITE request, all outstanding Requests relayed to other AORs are canceled.

When all AORs have been processed, the module returns the "best" processing result to the Request source.

When an AOR to be processed is Routed to a non-local address, that address is placed into the Contact set.

When an AOR to be processed is Routed to a local Group, all Group members are added to the AOR set.

When an AOR to be processed is Routed to a local Account, all Account active Registrations (registered addresses of the Account user devices) are added to the Contact set.

If an AOR already exists in the AOR set, it is not added to the AOR set.

If an address already exists in the Contact set, it is not added to the Contact set.

The Signal module checks each address it adds to the Contact set.
If the new Contact address is a Local Node address, the Request is passed to that Node for processing.
If the new Contact address is an external address, the Request is passed to the SIP Module for relaying.

When a local or an external entity returns a redirect-type Response, the module checks the initial AOR (the Request URI).

• If the initial AOR was Routed to a local Account or Group, the addresses specified in the redirect-type Response are added to the AOR set and the Forking process continues.
• If the initial AOR was Routed to a remote address, the redirect-type Response is returned to the Request source.

You can use the WebAdmin Interface to configure the Signal component. Open the Real-Time pages in the Settings realm, then open the Signals page:

Processing

Log Level: Crashes OnlyFailuresMajor & FailuresProblemsLow LevelAll Info

Processors: off123571015305010030010003000other

Object Limit: 301003005001000200050001000030000100000other

Event Limit: 301003005001000200050001000030000other

Log

Use this setting to specify the type of information the Signal component should put in the Server Log. Usually you should use the Failure (unrecoverable problems only), Major (Signal progress reports), or Problems (failures, progress reports, and non-fatal errors) levels.
When you experience problems with the Signal component, you may want to set the Log Level setting to Low-Level or All Info: in this case the signal processing internals will be recorded in the System Log. When the problem is solved, set the Log Level setting to its regular value, otherwise your System Log files will grow in size very quickly.
The Signal component records in the System Log are marked with the SIGNAL tag.

Processors

The Signal component uses several simultaneous processors (threads) to process Signal "tasks". One processor can handle several Signal tasks. If you use many time-consuming Automated Rules, you should allow the component to use more processors for signal processing.

Object Limit

This setting specifies how many Signal "tasks" the component can handle at any given time.
If this limit is exceeded, new Signals are rejected, and an error is returned to the Signal sender.

Event Limit

This setting specifies the critical number of unprocessed events sent to all active Signal "tasks".
If this number is exceeded, the component is overloaded (the component Processors cannot handle events as they appear), new Signals are rejected, and an error is returned to the event sender.

Use the Signal Task panel to configure Signal processing by Signal Tasks.

Signal Task

AOR Limit:	12357101530501003001000other	Time Limit:	5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)other
Active Fork Limit:	12357101530501003001000other		Authenticate all outgoing calls

AOR Limit

This setting limits the number of AORs that can be processed for a single operation. It limits the total number of forks, redirects, etc. for a single request.

Active Fork Limit

This setting limits the number of concurrent forks for a single request.

Time Limit

This setting specifies the default time limit for request processing.

Authenticate all outgoing calls

The CommuniGate Pro Server requires user authentication for certain Requests:

• when requests are sent remotely via SIP, authentication is performed with the SIP module server component
• the XIMSS and XMPP modules send all Signals authenticated, on behalf of the logged-in Account
• the Real-Time Applications send Signals authenticated, on behalf of their current Account (unless the Application has impersonated as "nobody")

This option requires authentication for all calls (initial INVITE requests) send from this Server Account addresses.

When a call-type Signal (an initial INVITE request with audio-video Session Descriptor) is authenticated, the Signal Module performs additional processing of the authenticated Account.

The Signal component can limit the number of "calls" an Account can place over a specified period of time. If more calls are placed, they are rejected without processing.
This limit can be set individually, for each Account, or server/cluster-wide as well as Domain-wide default settings can be used. See the Accounts section for more details.

If the first AOR in the set (the AOR specified in the Request URI) is a local Account address, and the Request is an INVITE request, the Account device registration is retrieved, along with certain Account settings and preferences.

An Account can have Automated Signal Rules, which are retrieved with Account device registrations. These Rules are "mixed" with the Domain-wide Rules specified for the Account Domain and are applied to all requests sent to the Account.

The Signal component controls how many "calls" (initial INVITE requests with audio-video Session Descriptors) an Account receives over a specified period of time. If more calls are received, they are rejected without processing.
This limit can be set individually, for each Account, or server/cluster-wide as well as Domain-wide default settings can be used. See the Accounts section for more details.

If a Signal is to be relayed to a remote system, the Signal component directs it to some signaling module.

The Signal target address can be explicitly routed to some module. For example, all domains with the ._xmpp suffix are routed to the XMPP module.

If the Signal target address is not explicitly routed to some module, the Signal component check the target domain name

• If the domain name is an IP address, the Signal is routed to the SIP module.
• If the domain name has SIP SRV records in the DNS, the Signal is routed to the SIP module.
• If the domain name has XMPP SRV records in the DNS, the Signal is routed to the XMPP module.
• In all other cases the Signal is routed to the SIP module.

If a Request is routed to a *nnnn name in any of the local Domains (where nnnn is any sequence starting with a decimal digit), the Request is rerouted to its originator (the Request From: address).

This feature allows users to dial a *nnnn number to request a service from the Server. The Request is routed to the user's own Account, where it starts the Self-Call application. The application provides the requested service using the Request To: address to learn the dialed "service option" number.

Communication devices used by CommuniGate Pro users should register themselves before they can receive Requests from other entities.

Registration Requests require user authentication.

One Account credentials can be used to modify registrations for a different Account, if the authenticated Account has the CanImpersonate access right for the target Account Domain.

To configure the Registrar Service options, open the Real-Time pages in the WebAdmin Settings realm, and select the Signals page.

Services

Registration Time:	Minimal:	1 sec2 sec3 sec5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)other	Default:	1 sec2 sec3 sec5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)other	Maximal:	1 sec2 sec3 sec5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)other
	Random delta:	0 sec3 sec5 sec15 sec30 sec60 sec2 min5 minother
MS RTC:	Integrate with Roster:	DisabledEnabled

Registration: Minimal

Use this option to specify the minimal Registration expiration time period accepted.
If a Registration Request contains a shorter expiration time, the Request is rejected, and the Response sent specifies this minimal accepted time. The entity (usually - a SIP device) can resend the Registration Request with an adjusted expiration time.

Registration: Default

This option value is used when a Registration Request does not specify a Registration expiration time.

Registration: Maximal

Use this option to specify the maximal Registration expiration time period accepted.
If a Registration Request contains a longer expiration time period, the period is shorten to the specified value.

Registration: Random delta

If this option is set to a non-zero value X, the requested Registration expiration time period is decreased by a random value, from 0 to X.
Large sites can use this feature to soften "registration storms", when a large number of devices starts to register at the same time (after a network failure or a maintenance window).
The requested expiration time period is decreased only if it is larger than 2*X and larger than Minimal+X.

Note: the Registrar component supports the SIP gruu (Globally Routable User Agent (UA) URIs) extensions.

The Signal Module supports several Event Packages. When it receives a SUBSCRIBE Request targeting a local Account, it may process the Request itself, without forwarding it to the Account registered entities.
Note: as a workaround for many buggy clients, the Module accepts SUBSCRIBE Requests sent to local Domains (instead of local Accounts). For these requests, the address in the To field is used to replace the domain-type address in the Request URI.

The Signal module maintains "tuple" states for each Account, for each Event Package it supports. The module allows one or several entities to update the "tuples", and it aggregates them into one Account "state information" for the Package. When the aggregated "state information" changes, the module sends NOTIFY requests with the updated state to all subscribed entities.

The Signal module allows external entities to modify "tuples" using PUBLISH requests.

The Signal module allows external entities to modify "tuples" for certain Packages using non-standard SERVICE requests.

The Signal module provides "watcher" packages for all Event Packages. These packages provide the information about current subscribers to the "base" Event packages. "Watcher of watcher" packages are implemented, too.

Unless explicitly specified otherwise, subscription to a Account Event package is available only to the Account owner, to other Accounts with the CanImpersonate Access Right for the Account Domain, and to other Accounts that have the Delegate Account Access Right for this Account.
The same restrictions are applied to subscriptions to all "watcher" packages.

Presence

The Signal Module implements a Presence Server. The Module supports the PIDF, CPIM-PIDF and XPIDF Presence Information formats.

The Signal Module provides special processing for the REGISTER requests. If an external entity (a SIP device) indicates support for the SUBSCRIBE method, the module establishes a presence subscription dialog with that entity.
The module then processes all NOTIFY requests sent by that entity to maintain its Presence "tuple" or "segment".

A Presence segment value is a string from a fixed set, listed here starting from the lowest priority value to the highest priority one:

• offline
• away
• out-lunch
• in-meeting
• be-back
• online
• on-phone
• busy

The event aggregated value is a segment value with the highest priority, or offline if no segment exists.

When a NOTIFY request is composed, the aggregated value is converted into a presence document in one of the supported formats.

Subscription to the Event package is available to anyone, subject to the standard subscription approval process.

Message Summary

The Signal Module implements the MWI (Message Waiting Indication) Service. The Module supports the simple-message-summary Information format.

The Server itself maintains the "INBOX" tuple/segment for this Event package. The segment value is set to an array:

• the first element is the number of INBOX messages that have the $Media flag set and do not have the Seen flag set (the number of unread media messages);
• the second element is the number of INBOX messages that have the $Media flag set (the total number of media messages);

The event aggregated value is an array containing the by-element sum of all segment array values.

When a NOTIFY request using the simple-message-summary Information format is composed, the first aggregated array element value is used as the number of new voice messages, and the difference between the second and the first elements is used as the number of old voice messages.
If the first array element value is not zero, the Messages-Waiting element is set to yes, otherwise it is reset to no.

Registration

The Signal Module implements the Registrar Monitoring Service. The Module supports the reginfo+xml Information format, and it can inform network entities (such as SIP clients) about all other entities registered with an Account.

Dialog

The Signal Module implements the Dialog Monitoring Service. The Module supports the dialog-info+xml Information format, and it can inform network entities (such as SIP clients) about all dialogs active with an Account.

Subscription to the Dialog package is available to the Account owner, to other Accounts with the CanControlCalls Domain Access Right, and to other Accounts with the CallControl Access Right granted by with Account owner.

The CommuniGate Pro Server creates Call objects when processing call-starting INVITE requests. Call objects contain information about the calls initiated with these requests.
Call objects are destroyed when these calls are terminated.

If the caller is authenticated, the call status is recorded in the caller Account data, and a CDR record is generated. When a call is completed, an accounting record for this outgoing call is added to the caller call log.

If the call target (callee) is authenticated, the call status is recorded in the callee Account data, and a CDR record is generated. When a call is completed, an accounting record for this incoming call is added to the callee call log.

When the authenticated peer (the caller or the callee) places a call on hold, their Account "Hold Music" preference is used.
If it is not set to disabled, the specified sound file is read from the Account File Storage. If the file name is "*" or if the specified file is not found, the HoldMusic file is read from the Account Domain Real-Time Application Environment.
When the sound file is read, a Media Channel is created and instructed to play the retrieved file to the other peer.

You can use the WebAdmin Interface to configure the Call Manager component. Open the Real-Time pages in the Settings realm, then open the Signals page:

Calls

Log Level:	Crashes OnlyFailuresMajor & FailuresProblemsLow LevelAll Info	Time Limit:	5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)10 day(s)2 week(s)30 day(s)100 day(s)other
Signal Idle Timeout:	5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)other	Media Idle Timeout:	5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)16 hour(s)24 hour(s)other

Log

Use this setting to specify the type of information the Call Manager component should put in the Server Log. Usually you should use the Failure (unrecoverable failures only), Major (failures and major events), or Problems (failures, major events, and non-fatal errors) levels.
The Call Manager component records in the System Log are marked with the DIALOG tag.

Time Limit

This setting specifies a time limit for Calls. When this limit is exceeded, the Call object is removed. Keep this limit high enough to avoid call interruptions.

Signal Idle Timeout, Media Idle Timeout

If there is no signal sent within a Call for the specified period of time, and, if a Media Proxy is associated with that Call, there no media data to relay for the specified period of time, a call termination (BYE) request is sent to both sides of the call, and the Call object is removed. Keep these limits high enough to avoid call interruptions when a call is placed on hold.

Account Call Logs

The Account Call Logs are stored as text files in the Account File Storage.

These files have the following format:

2_dd-mmm hh:mm:ss_direction_peer_callId_callTime_alertTime_errorCode[_programName]

where:

_

is the tabulation symbol (symbol code is 0x09)

2

record format version

dd

2-digit month day number

mmm

3-letter month name

hh, mm, ss

2-digit numbers for the call termination hour (00..23), minute (00..59), second (00..59)

direction

1-letter call direction: I - incoming, O - outgoing

peer

E-mail address of the call peer:
  <username@domainName>
or
  "real name" <username@domainName>

callId

call Call-ID string.

callTime

call duration (in seconds). The time between the moment the call connected and the moment the call disconnected. If this call has not succeeded, this field is empty.

alertTime

call alerting time (in seconds). The time between the moment the call started and the moment the call connected or (if the call has not succeeded) the moment the call failed.

errorCode

a string with the error code for the call attempt failure or the call disconnect reason. If the call has completed without an error, this field is empty.

programName

this optional field contains the name of the Real-Time Application that handled this call.

Call Detail Records (CDRs)

The Signal module can generate Call Detail Records for INVITE and BYE transactions it processes. It can also generate Call Detail Records for completed calls using the information in the Call objects.

CDRs can be generated and stored in special supplementary Log files.

Monitoring

Record Call CDRs

Record INVITE/BYE CDRs

Record Call CDRs

Select this option to generate CDR Log files for Calls (Call objects).

Record INVITE/BYE CDRs

Select this option to generate CDR Log files for INVITE and BYE requests.

When the External CDR Processor Helper application is enabled, the Signal Module generates all types of CDRs and sends them to that application.

CDR data text for INVITE/BYE requests has the following format (the tabulation symbol is used as the field separator):

01 NNN-method dialog-identifier parties network-addresses flags

where:

01

the CDR format version number

NNN

the transaction result code (numeric)

Method

the transaction operation/method (INVITE, BYE).

dialog-identifier

the transaction Call-ID field, the From field tag parameter, the To field tag parameter, enclosed in the < and > symbols.
Note: If a call is terminated by the callee, the fromTag of the BYE transaction is the toTag of the INVITE transaction and vice versa.

parties

the transaction From and To field URIs addresses, enclosed in the < and > symbols.

network-addresses

the network (IP) address the transaction request and responses were received from, enclosed in the [ and ] symbols.

flags

optional fields separated with tabulation symbols:

[auth:accountName]

this element is added if the transaction request is authenticated. The accountName is the name of the authenticated CommuniGate Pro Account.

[redir:accountName]

this element is added if the transaction request was redirected from a local Account. The accountName is the name of that CommuniGate Pro Account.

[billing:billingData]

this element is added if the transaction request has a P-Billing-Id field. The billingData string is the field content.

[referred:referredby]

this element is added if the transaction request has a Referred-By field. The referredby string is the field content.

CDR data text for calls has the following format (the tabulation symbol is used as the field separator):

02 callType accountName alertTime connectTime reason dialog-identifier ["fromName"] <from> ["toName"] <to>[[toProgramName]] flags

where:

02

the CDR format version number

callType

the call type (INP, OUT).

accountName

the full Account name (accountName@domainName).

alertTime

the time period (in seconds) between the time the call was initiated and the time the call was accepted or rejected.

connectTime

the time period (in seconds) between the time the call was accepted and the time the call was terminated. If the call was not accepted, this field contains the - (minus) symbol.

reason

the reason the call was rejected or terminated.

dialog-identifier

the call Call-ID field, the From field tag parameter, the To field tag parameter, enclosed in the < and > symbols.

from, to

the transaction From and To field URIs.

fromName, toName

the transaction From and To field "real names". These fields are optional. If present, these field values are enclosed into the quotation mark (")symbols.

toProgramName

optional - the name of the PBX Application that has accepted the call.

flags

the same as used with version 01 records.

The CommuniGate Pro Server dynamically creates, runs, and removes Real-Time Nodes.

A Node is an internal CommuniGate Pro Server object that can receive Signal Requests and produce Responses for those Requests. A Node can also send Requests and process Responses.

Various CommuniGate Pro components and modules use Nodes to implement Signaling functions:

• The Real-Time Application component creates a Node for each "call leg".
• The XIMSS session manager creates a Node for each XIMSS "call leg".
• The Presence subcomponent creates a Node and uses it to manage Presence Event Subscriptions for those devices that cannot proactively update their Presence state.

You can use the WebAdmin Interface to configure the Nodes component. Open the Real-Time pages in the Settings realm, then open the Nodes page:

Processing

Log Level: Crashes OnlyFailuresMajor & FailuresProblemsLow LevelAll Info

Processors: off123571015305010030010003000other

Object Limit: 50100300500100020005000100002000050000other

Event Limit: 50100300500100020005000100002000050000other

Log

Use this setting to specify the type of information the Local Nodes component should put in the Server Log. Usually you should use the Failure (unrecoverable failures only), Major (failures and major events), or Problems (failures, major events, and non-fatal errors) levels. When you experience problems with the Local Nodes component, you may want to set the Log Level setting to Low-Level or All Info: in this case the Node processing internals will be recorded in the System Log. When the problem is solved, set the Log Level setting to its regular value, otherwise your System Log files will grow in size very quickly.
The Local Nodes component records in the System Log are marked with the NODE tag.

Processors

The Local Nodes component uses several simultaneous processors (threads) to process Nodes. One processor can handle several Nodes tasks.
If you use many Nodes implementing time-consuming operations (complex Real-Time Applications, etc.) you should allow the component to use more processors.

Object Limit

This setting specifies how many Nodes the component can handle at the same time. If this limit is exceeded, attempts to create new Nodes result in an error.

Event Limit

This setting specifies the critical number of unprocessed events (sent to all active Nodes). If this number is exceeded, the component is overloaded (the component Processors cannot handle events as they appear), and attempts to create new Nodes result in an error.

The Server creates special Local Nodes called Call Legs. Each Call Leg terminates signaling for one phone call. Each PBX Task is a Call Leg, and each XIMSS session can create one or more Call Legs to handle phone calls initiated or accepted by the XIMSS session user.

The settings in the Call Legs panel are applied to all types of Call Legs:

Call Legs

Session Expiration:	Minimal:	1 sec2 sec3 sec5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)other	Default:	1 sec2 sec3 sec5 sec10 sec15 sec20 sec30 sec40 sec60 sec90 sec2 min3 min5 min10 min15 min20 min30 min40 min60 min2 hour(s)3 hour(s)4 hour(s)6 hour(s)10 hour(s)12 hour(s)24 hour(s)2 day(s)3 day(s)7 day(s)other
Hop Limit:		12351015203040607090100other

Session-Expiration

Use this setting to specify how often the parties should exchange the INVITE (or OPTION) requests to verify that the call has not been broken.

Hop Limit

Use this setting to specify the Max-Forwards field value for the requests sent with Call Legs.

The Signal tasks can receive "events" from other CommuniGate Pro components, such as CG/PL tasks and XIMSS client sessions. To send an event, the sender should obtain a signal handle.

A Signal task accepts the following events:

decline

This event causes the Signal task to cancel Signal Request processing and to reject it with the 603 Declined error code.

fork

This event data should be a string or an array of strings. The Signal Request is forked to the URIs specified with these strings.

redirect

Same as fork, but all currently "forked" Requests are canceled.