Cause and result code lookup
cause_lookupDecode what a telecom cause or result code means for Diameter, GTP, SIP, NAS and other protocols, returning the meaning, spec reference and related codes for a ticket.
Instructions
What a telecom cause or result code means, with the spec reference to quote in a
ticket. No capture is read. protocol is one of diameter, gtpv2, gtpv1, pfcp,
nas_emm, nas_esm, nas_5gmm, nas_5gsm, s1ap, ngap, sip, q850, isup, camel_release,
map, tcap_abort, sccp_return, sgsap, rp, cp, tp_status, http_sbi, dns, tls, icmp,
icmpv6, http, nas. code: 78, "0x4e"; s1ap/ngap
"radioNetwork:21"; icmp "3:13"; http_sbi a cause ("USER_NOT_FOUND"). For Diameter,
application (s6a, s13, gx, gy, rx, cx, sh, swx, s6b, s6c, sgd, t6a, or base)
picks the Experimental-Result-Code meaning: 5001 or 5004 differ between the base
Result-Code and an application. message (a SIP method such as REGISTER or INVITE)
adds the note for that message. Returns name (from tshark's own value strings,
name_source says so, otherwise the server's table), meaning, ref,
typical_causes, related codes and check_next (which tool to run on the
capture); explained: false means only the name is known. Give query instead of
code to list the codes whose name or meaning contains every word ("apn",
"roaming").
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"protocol": "<protocol>"
},
"name": "cause_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | The code: 78, "0x4e", "radioNetwork:21" (s1ap, ngap) or a ProblemDetails cause (http_sbi) | |
| limit | No | Most rows per page | |
| query | No | Words to search the cause names for | |
| offset | No | Rows to skip (next_offset) | |
| output | No | summary: all but rows, plus 3 rows (<8 KB) | rows |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
| columns | No | Row keys to keep (frame keys stay) | |
| message | No | SIP method the code answered (REGISTER, INVITE, ...) | |
| protocol | Yes | diameter, gtpv2, gtpv1, pfcp, nas_emm, nas_esm, s1ap, ngap, sip, q850, map, ... (see the description) | |
| application | No | Diameter application name (s6a, gx, gy, rx, cx, sh, s13, swx) or id | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| avp | No | ||
| ref | No | ||
| also | No | ||
| code | No | ||
| name | No | ||
| note | No | ||
| codes | No | rows with keys: code, name, avp, explained, meaning, protocol | |
| count | No | ||
| error | No | ||
| known | No | ||
| query | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| meaning | No | ||
| message | No | ||
| related | No | ||
| has_more | No | ||
| protocol | No | ||
| returned | No | ||
| explained | No | ||
| by_message | No | ||
| check_next | No | ||
| application | No | ||
| name_source | No | ||
| next_offset | No | ||
| total_found | No | ||
| message_note | No | ||
| other_tables | No | ||
| tshark_field | No | ||
| total_matched | No | ||
| by_application | No | ||
| typical_causes | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| application_note | No | ||
| total_is_lower_bound | No |