Technical Reference (Appendix)
Technical reference for SS7 protocols and OmniSS7 implementation.
SS7 Protocol Stack
MAP Operation Codes
Opcodes below are the MAP local operation codes per 3GPP TS 29.002. This table covers the operations OmniSS7 generates and/or handles; for the full set of client-triggerable operations and their request parameters, see the MAP Client Guide.
| Operation | Opcode | Purpose |
|---|---|---|
| updateLocation | 2 | Register subscriber location (CS) |
| cancelLocation | 3 | Deregister subscriber from VLR/SGSN |
| provideRoamingNumber | 4 | Request MSRN |
| noteSubscriberDataModified | 5 | Notify gsmSCF of subscriber data change |
| insertSubscriberData | 7 | Push subscriber profile to VLR/SGSN |
| deleteSubscriberData | 8 | Withdraw subscriber data from VLR/SGSN |
| registerSS | 10 | Register a supplementary service (e.g. CFU) |
| eraseSS | 11 | Erase a supplementary service |
| activateSS | 12 | Activate a supplementary service |
| deactivateSS | 13 | Deactivate a supplementary service |
| interrogateSS | 14 | Interrogate supplementary service status |
| registerPassword | 17 | Register an SS password |
| getPassword | 18 | Request an SS password from the subscriber |
| sendRoutingInfo | 22 | Query call routing (SRI) |
| updateGprsLocation | 23 | Register packet-switched (SGSN) location |
| sendRoutingInfoForGprs | 24 | Query GPRS routing toward the GGSN |
| reset | 37 | HLR reset toward VLR/SGSN |
| forwardCheckSS-Indication | 38 | Indicate SS data should be re-checked |
| checkIMEI | 43 | Query EIR for equipment status |
| mt-forwardSM | 44 | Deliver SMS to subscriber (MT) |
| sendRoutingInfoForSM | 45 | Query SMS routing (SRI-for-SM) |
| mo-forwardSM | 46 | Forward SMS from subscriber (MO) |
| reportSM-DeliveryStatus | 47 | Report SMS delivery outcome to HLR |
| sendIdentification | 55 | Retrieve IMSI/auth from previous VLR |
| sendAuthenticationInfo | 56 | Request authentication vectors |
| restoreData | 57 | Restore subscriber data after VLR failure |
| sendIMSI | 58 | Resolve MSISDN to IMSI at the HLR |
| processUnstructuredSS-Request | 59 | Mobile-originated USSD request (inbound) |
| unstructuredSS-Request | 60 | Network-originated USSD request (outbound) |
| unstructuredSS-Notify | 61 | Network-originated USSD notification |
| anyTimeSubscriptionInterrogation | 62 | gsmSCF query of subscription data |
| alertServiceCentre | 64 | Alert SMSc that a subscriber is reachable |
| anyTimeModification | 65 | gsmSCF modification of subscriber data |
| readyForSM | 66 | Notify HLR subscriber is ready for SMS |
| purgeMS | 67 | Purge subscriber record from VLR/SGSN |
| provideSubscriberInfo | 70 | Request subscriber state/location |
| anyTimeInterrogation | 71 | gsmSCF query of subscriber state/location |
| provideSubscriberLocation | 83 | Request location estimate from serving node (LCS) |
| sendRoutingInfoForLCS | 85 | GMLC query for the subscriber's serving node (LCS) |
| subscriberLocationReport | 86 | Serving node reports a location to the GMLC (LCS) |
| noteMM-Event | 89 | Report a mobility-management event to gsmSCF |
TCAP Message Types
- BEGIN - Start transaction
- CONTINUE - Mid-transaction
- END - Final response
- ABORT - Cancel transaction
SCCP Addressing
Global Title Formats
- E.164 - International phone number (e.g., 447712345678)
- E.212 - IMSI format (e.g., 234509876543210)
- E.214 - Point code format
Subsystem Numbers (SSN)
- SSN 6: HLR
- SSN 7: VLR
- SSN 8: MSC/SMSC
- SSN 9: GMLC
- SSN 10: SGSN
SMS TPDU
Message Types
- SMS-DELIVER (MT) - Network to mobile
- SMS-SUBMIT (MO) - Mobile to network
- SMS-STATUS-REPORT - Delivery status
- SMS-COMMAND - Remote command
Character Encodings
- GSM7 - 7-bit GSM alphabet (160 chars per SMS)
- UCS2 - 16-bit Unicode (70 chars per SMS)
- 8-bit - Binary data (140 bytes per SMS)
M3UA States
- DOWN - No SCTP connection
- CONNECTING - SCTP connecting
- ASPUP_SENT - Waiting for ASPUP ACK
- INACTIVE - ASP up but not active
- ASPAC_SENT - Waiting for ASPAC ACK
- ACTIVE - Ready for traffic
Common SS7 Point Codes
Point codes are typically 14-bit (ITU) or 24-bit (ANSI) values.
Example Format (ITU):
- Network: 3 bits
- Cluster: 8 bits
- Member: 3 bits
SCCP Error Codes
- 0 - No translation for address
- 1 - No translation for specific address
- 2 - Subsystem congestion
- 3 - Subsystem failure
- 4 - Unequipped user
- 5 - MTP failure
- 6 - Network congestion
- 7 - Unqualified
- 8 - Error in message transport
MAP Error Codes
| Code | Error | Description |
|---|---|---|
| 1 | unknownSubscriber | Subscriber not in HLR |
| 27 | absentSubscriber | Subscriber not reachable |
| 34 | systemFailure | Network failure |
| 35 | dataMissing | Required data not available |
| 36 | unexpectedDataValue | Invalid parameter value |
Related Documentation
OmniSS7 by Omnitouch Network Services