Integrator C Series API

Link between Calls, Mediachannels and Diagnostics in Status

In the C-series we have split the information you can get about each call into several parts:
  • Calls: The basic call info like remote site number and name etc.
  • Media Channels: Information about the media channels like Audio, Video and Data per call
  • Diagnostics:Advanced MediaChannel information.
We will now look at how they are linked together:

Calls

Lets first look at the Call Information. 
xstatus  call
*s Call 14 Status: Connected
*s Call 14 Direction: Outgoing
*s Call 14 Protocol: "h323"
*s Call 14 CallType: Video
*s Call 14 RemoteNumber: "david.bruun-lie@tandberg.com"
*s Call 14 CallbackNumber: "H323:david.bruun-lie@tandberg.com"
*s Call 14 DisplayName: "david.bruun-lie@tandberg.com"
*s Call 14 TransmitCallRate: 1920
*s Call 14 ReceiveCallRate: 1920
*s Call 14 Encryption Type: "None"
*s Call 14 PlacedOnHold: False
*s Call 14 Duration: 10049
** end
This shows that I have one call and the CallId is 14. The different parts should be pretty self explanatory (we hope) I can then take the callId that we found (14) and look at the media channels part of the API to get which channels this call has:

Media Channels

xstatus MediaChannels
*s MediaChannels Call 14 IncomingAudioChannel 167 Encryption Status: Off
*s MediaChannels Call 14 IncomingAudioChannel 167 Audio Protocol: AACLD
*s MediaChannels Call 14 IncomingAudioChannel 167 Audio Mute: False
*s MediaChannels Call 14 IncomingAudioChannel 167 Audio Channels: 1
*s MediaChannels Call 14 IncomingVideoChannel 170 Encryption Status: Off
*s MediaChannels Call 14 IncomingVideoChannel 170 ChannelRole: Main
*s MediaChannels Call 14 IncomingVideoChannel 170 Video Protocol: H264
*s MediaChannels Call 14 IncomingVideoChannel 170 Video FrameRate: 30
*s MediaChannels Call 14 IncomingVideoChannel 170 Video ResolutionX: 1280
*s MediaChannels Call 14 IncomingVideoChannel 170 Video ResolutionY: 720
*s MediaChannels Call 14 IncomingVideoChannel 173 Encryption Status: Off
*s MediaChannels Call 14 IncomingVideoChannel 173 ChannelRole: Presentation
*s MediaChannels Call 14 IncomingVideoChannel 173 Video Protocol: Off
*s MediaChannels Call 14 IncomingVideoChannel 173 Video FrameRate: 0
*s MediaChannels Call 14 IncomingVideoChannel 173 Video ResolutionX: 0
*s MediaChannels Call 14 IncomingVideoChannel 173 Video ResolutionY: 0
*s MediaChannels Call 14 OutgoingAudioChannel 168 Encryption Status: Off
*s MediaChannels Call 14 OutgoingAudioChannel 168 Audio Protocol: AACLD
*s MediaChannels Call 14 OutgoingAudioChannel 168 Audio Channels: 1
*s MediaChannels Call 14 OutgoingVideoChannel 171 Encryption Status: Off
*s MediaChannels Call 14 OutgoingVideoChannel 171 ChannelRole: Main
*s MediaChannels Call 14 OutgoingVideoChannel 171 Video Protocol: Off
*s MediaChannels Call 14 OutgoingVideoChannel 171 Video FrameRate: 0
*s MediaChannels Call 14 OutgoingVideoChannel 171 Video ResolutionX: 0
*s MediaChannels Call 14 OutgoingVideoChannel 171 Video ResolutionY: 0
*s MediaChannels Call 14 OutgoingVideoChannel 174 Encryption Status: Off
*s MediaChannels Call 14 OutgoingVideoChannel 174 ChannelRole: Presentation
*s MediaChannels Call 14 OutgoingVideoChannel 174 Video Protocol: H264
*s MediaChannels Call 14 OutgoingVideoChannel 174 Video FrameRate: 30
*s MediaChannels Call 14 OutgoingVideoChannel 174 Video ResolutionX: 1280
*s MediaChannels Call 14 OutgoingVideoChannel 174 Video ResolutionY: 720
** end
This shows that Call 14 has:
  • 1 incoming audio channel with id 167
  • 1 incoming video channel with id 170. Its channel role is "Main"
  • 1 incoming video channel with id 173. Its channel role is "Presentation"
  • 1 outgoing audio channel with id 168
  • 1 outgoing video channel with id 171. Its channel role is "Main"
  • 1 outgoing video channel with id 174. Its channel role is "Presentation"
We can see that we have two incoming Video Channels. This is what is being sent from the far end system - one for the main video and one for secondary video, also known as presentation channel, h.239 or duo video. If the remote site does not support h.239 then you would only see one incoming video channel. The H.239 channel is typically used for sending presentations like powerpoints, images or DVD content. If you are not seing any OutgoingVideoChannels is probably because you don't have a camera connected to the codec and therefore no video to send. If you are not seing an IncomingVideoChannel is probably because the remote site does not have a camera connected to the codec and therefore no video to send. We can then take the CallId and the MediaChannel Id's and look at the diagnostics part for each channel if I need even more information about the channels (for debug and statistics purposes):

Diagnostics

xstatus Diagnostics
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 Packets: 520185
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 LastIntervalReceived: 250
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 Bytes: 165897538
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 ChannelRate: 127000
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 Netstat 1 MaxJitter: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery ProtectionPackets MediaPacketsCovered: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery ProtectionPackets Received: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery ProtectionPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery ProtectionPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Received: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Recovered: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets ConsecutiveLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics ZeroLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics OneLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics TwoLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics ThreeLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics FourLost: 0
*s Diagnostics Call 14 Channels IncomingAudioChannel 167 PacketRecovery MediaPackets Statistics MoreThanFourLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 Packets: 1869348
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 LastIntervalReceived: 717
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 Bytes: -1963033108
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 ChannelRate: 1793000
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 Netstat 1 MaxJitter: 1
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery ProtectionPackets MediaPacketsCovered: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery ProtectionPackets Received: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery ProtectionPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery ProtectionPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Received: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Recovered: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets ConsecutiveLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics ZeroLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics OneLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics TwoLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics ThreeLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics FourLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 170 PacketRecovery MediaPackets Statistics MoreThanFourLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 Packets: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 LastIntervalReceived: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 Bytes: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 ChannelRate: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 Netstat 1 MaxJitter: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery ProtectionPackets MediaPacketsCovered: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery ProtectionPackets Received: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery ProtectionPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery ProtectionPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Received: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Recovered: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets ConsecutiveLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics ZeroLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics OneLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics TwoLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics ThreeLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics FourLost: 0
*s Diagnostics Call 14 Channels IncomingVideoChannel 173 PacketRecovery MediaPackets Statistics MoreThanFourLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 Packets: 1
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 LastIntervalReceived: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 Bytes: 111
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 ChannelRate: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 Netstat 1 MaxJitter: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery ProtectionPackets MediaPacketsCovered: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery ProtectionPackets Received: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery ProtectionPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery ProtectionPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Received: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Lost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets OutOfOrder: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Recovered: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets ConsecutiveLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics ZeroLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics OneLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics TwoLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics ThreeLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics FourLost: 0
*s Diagnostics Call 14 Channels IncomingDataChannel 175 PacketRecovery MediaPackets Statistics MoreThanFourLost: 0
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 Packets: 520257
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 LastIntervalReceived: 150
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 Bytes: 165920235
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 ChannelRate: 127000
*s Diagnostics Call 14 Channels OutgoingAudioChannel 168 Netstat 1 MaxJitter: 0
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 Packets: 31707
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 LastIntervalReceived: 1260
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 Bytes: 33843652
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 ChannelRate: 1792000
*s Diagnostics Call 14 Channels OutgoingVideoChannel 174 Netstat 1 MaxJitter: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 Jitter: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 Packets: 6
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 Loss: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 LastIntervalLost: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 LastIntervalReceived: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 Drop: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 Bytes: 350
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 ChannelRate: 0
*s Diagnostics Call 14 Channels OutgoingDataChannel 176 Netstat 1 MaxJitter: 0
** end
The IncomingDataChannel and OutgoingDataChannel should not be mistaken for being H.239/Presentation channels. The data channels are for transmitting Camera Control code, S-String, T-string messages etc.
If you should find errors or have suggestions for content or improvements of these guides, please give us feedback on our forum.