Roaming attach check
roaming_attach_checkDiagnose why a roaming subscriber fails to attach or obtain a bearer by grouping attach and PDN steps into timed attempts and checking subscription, routing, and access restrictions.
Instructions
Why can this roamer not attach or get a bearer. Collects the subscriber's
attach and PDN steps (S6a AIR/AIA and ULR/ULA, MAP sendAuthenticationInfo,
updateLocation and updateGprsLocation for 2G/3G, GTPv2-C Create Session and Modify
Bearer, Gx CCR-I/CCA-I, PFCP Session Establishment) and groups them into attempts
in time order. Each attempt gives visited_plmn (ULR Visited-PLMN-Id, GTPv2 Serving
Network or the MAP peer GT), roaming, access (RAT, TAI, ECGI), steps with
result, code, ref and frames, the ULA subscription digest (carried from an
earlier attempt when this one has no ULA), the Create Session request (APN, PDN
type, selection mode, RAT, serving network, flags, APN-AMBR), checks (APN
subscribed, PDN type allowed, home routing or local breakout from the APN operator
identifier against VPLMN-Dynamic-Address-Allowed, RAT against
Access-Restriction-Data, ODB, AMBR), first_failure and a one-sentence verdict.
home_plmn ("MCC-MNC") overrides the home network read from the IMSI (needed for
multi-IMSI SIMs and MVNO ranges; otherwise the MNC length follows the MCC).
Content-free: no authentication vectors, SMS or USSD text are read or returned.
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": {
"path": "<path>",
"imsi": "<imsi>"
},
"name": "roaming_attach_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| imsi | Yes | IMSI, 6 to 15 digits | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| msisdn | No | MSISDN (E.164 digits, no +) | |
| 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) | |
| home_plmn | No | Home PLMN as MCC-MNC, such as 001-01 (default: from the IMSI) | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| imsi | No | ||
| count | No | ||
| error | No | ||
| offset | No | ||
| passes | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| verdict | No | ||
| attempts | No | rows with keys: time, visited_plmn, visited_source, roaming, access, steps, subscription, subscription_frame, subscription_from_earlier_attempt, request, checks, first_failure, verdict | |
| has_more | No | ||
| returned | No | ||
| home_plmn | No | ||
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| home_plmn_source | No | ||
| total_is_lower_bound | No |