Technical Helpweb

- more articles

Description of SwitchKit negative responses


A Dialogic® SwitchKit® Development Environment (SwitchKit) API message sent to a Dialogic® Converged Services Platform (CSP) or a Dialogic® Multi-Services Platform (MSP) should receive a response indicating either an 0x10 for a positive status or another response.

For a CSP a list of responses can be found here

For an MSP a list of responses can be found in the API reference found on this page by selecting 'response status values'.

These lists do not include Dialogic® SwitchKit® Development Environment (SwitchKit) negative responses (NACKs).  SwitchKit NACKS are different from other negative responses in that they are not initiated by the switch, but by the LLC process communicating with the switch.  They are used for a number of purposes, but the main two are to indicate that the switch did not respond to a message (SK_NO_ACK_FROM_SWITCH 0xf009) or that the message sent was either not formatted correctly or was corrupted due to network issues (SK_BAD_MESSAGE 0xf007).  You will also see SK_BAD_MESSAGE if you send a message to a non-existent node ID.

This is a list of SwitchKit responses:

SK_BAD_PARAM 0xf002: This response is seen when sending a SwitchKit message with some sort of bad parameter for example sending sk_configChannelGroup with an inconfig hunting parameter.

SK_CANCELED    0xf003
: This response is seen when a message is cancelled.  Typically only seen when sending SKC_CancelUserTimer

SK_MTX_ACTIVE 0xf004: This response is seen when sending ActivateMatrix() to an already active matrix/CPU card

SK_OOS_OUTSEIZE 0xf005: This response is seen when sending an SKC_OutseizeControl Message to an out of service channel

SK_BAD_APP_NAME 0xf006: This response is seen when using inter-application messaging and sending a message to a non-existant application name

SK_BAD_MESSAGE 0xf007:  This response is seen when the message initially sent is formatted incorrectly or the node that message was sent to was either unreachable or does not exist.

SK_NO_SEQNUMS 0xf008: This message is seen when the CSP or MSP runs out of sequence numbers and can not respond to a message

SK_NO_ACK_FROM_SWITCH 0xf009: This message is seen when no response is seen from the switch or if the response was lost due to network issues.

SK_BAD_ENGINE_NAME 0xf00a: This message should not be seen, but if it does, it indicates a problem with the connection between SwitchKit and the application sending the message

SK_SWITCHBACK_FAILED 0xf00b: This message is seen when running redundant SwitchKit hosts and the switch back to active does not occur successfully

These responses are also documented in SK_API.h.

Product List

This applies to both Dialogic® Converged Services Platform and Dialogic® Multi-Services Platform when examing either socket or messages.log

Related Documentation

Dialogic® Multi-Services Platform:

http://www.dialogic.com/webhelp/MSP1010/10.2.3/Webhelp_API/API_REF.htm
http://www.dialogic.com/webhelp/MSP1010/10.2.3/WebHelp/MSP.htm

Dialogic® Converged Services Platform:



Feedback

Please rate the usefulness of this page:  
0 - not useful at all
1 - potentially useful
2 - quite useful
3 - very useful
4 - exactly the information I needed     

Please enter a comment about this page:

First published: 22-Jan-2010
Last published: 30-Sep-2011
Open access: Product rule: ; Page rule: Auto

Service Center Logon