Create a MAP Callout Action

Create a Mobile Application Part (MAP) callout action to define callout request parameters for querying subscriber information, such as the subscriber's location or routing number, on an external database, such as a Mobile Number Portability (MNP) database.

About this task

Perform this task to define how to handle queries to an external database using the MAP protocol. For information about defining request parameters for queries to an LDAP server, see the discussion about creating an LDAP callout action.

Procedure

  1. In PreRating, on the Call Out Actions tab, click New Call Out Action.
  2. In Create New PreRating Call Out Action:
    1. In Name, enter a unique name.
      Note: You must specify a name that is unique across all the following types of actions:
      • Announcement details
      • Announcement menu actions
      • Call out actions
      • Data modify actions
    2. (Optional) In Description, enter descriptive information about the item.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation of MATRIXX Engine. External IDs are saved to the pricing configuration file and loaded into the Pricing database.
    4. Click Create.
  3. In Start Date/Time, use the date picker to select the date on which the object becomes active in the Pricing database and is first available for use, or enter the date in the format YYYY-MM-DD. Optionally, enter a time for when the object becomes active. The default start date/time is 2000–01–01 00:00:00. If applicable, the range in which the start date/time must fall is listed. For example:
    • Select a date on or before 2021–12–01.
    • Select a date on or after 2020–01–27.
    • Select a date between 2000–01–02 and 2021–10–04.
    Note: If you are creating a new revision of this object, the start date/time must be after the start date/time of the preceding revision and before the start date/time of the next revision. If you are making a copy of this object, the start date/time is not copied. The new object is the first revision, so it has the default start date/time of 2000–01–01 00:00:00.
  4. In Query Frequency select the frequency with which the query is performed if this PreRating callout action is selected during rating. Select from the following:
    • Initial Only — Performs the query only when the PreRating callout action is first selected.
    • Every Update — Performs the query after every update.
    • Based on Age — Performs the query on update only if the number of seconds since the last query is greater than Age.
  5. (Set only if Query Frequency is set to Based on Age) In Age In Seconds specify the minimum number of seconds between queries.
  6. In Call Out Type, select the MAP callout service for the query. Select one of:
    • map_v2_plus_ati
    • map_v1_sri
    • map_v2_sri
    • map_v2_plus_sri
    • map_v2_plus_interrogate_ss
  7. In Info Query Flags:
    1. If you set the Call Out Type to map_v2_plus_ati and you will not be selecting the Custom query flag, in Preferred Domain, select the preferred signaling network domain to query.
      • Circuit Switched: Typically used for mobile calls.
      • Packet Switched: Used for data.
    2. If you set the Call Out Type to map_v2_plus_interrogate_ss, select the Interrogate Supplementary Service check box.
      Note: The Interrogate Supplementary Service check box is the only check box available for map_v2_plus_interrogate_ss call outs, and is disabled for all other callout types.
    3. To request more than one type of information is returned in the query results, select the check boxes for each type of information.
      For example, to retrieve the subscriber's location information and IMEI, select Ask Subscriber Location and Ask Subscriber IMEI.
    4. If you set the Call Out Type to map_v2_plus_ati and selected Ask Subscriber Location, and you want to request a forced update of the subscriber's location, select Force Current Location.
    5. To use selective updates to customize the callout object after it is in the message, ensure that all the check boxes are unselected, and select Custom.
      Note: Selecting Custom disables all other Info Query Flags fields, including Preferred Domain. To select a different flag, first unselect Custom.
  8. In Query Source, select the subscriber ID type to use in the query. For example, for queries based on the subscriber's IMSI (International Mobile Subscriber Identity) number, select IMSI. Select one of:
    • Called Station ID
    • Calling Station ID
    • Access Number
    • IMSI
    • Subscriber Name
    • Subscriber ID
    • Other
    Note: When Other is selected, the value in the MtxDiamRoMsg OtherSubscriberQuerySource field is used for the source Subscriber ID. You can set the OtherSubscriberQuerySource field value in the following ways:
    • Using a data modify action in the same profile.
    • Using selective updates.
    • Using a system attribute.
    • Through a normalizer's result information.
    If OtherSubscriberQuerySource is not set then the service logic raises an error.
  9. (Optional.) Select Use Query Source For Destination to set the destination subscriber ID to the subscriber ID selected in Query Source.
    When selected, the Global Title Address and Nature of Address fields become disabled. Depending on the selected global title type, other global title fields might also become unavailable.
    Note: When Use Query Source For Destination is selected, MATRIXX Support recommends that you set the Routing Indicator field to route on global title and that you leave the Point Code field blank (not set). When Use Query Source For Destination is selected, you do not need to route on SSN or set the point code, except in rare cases.
  10. (Optional) In Timeout In Milliseconds specify the number of milliseconds that the query waits for a response before timing out.
  11. If you selected the map_v2_plus_ati_interrogate_ss callout type, configure the following fields:
    1. (Required) In SS Code, enter the SS-Code for MAP InterrogateSS queries. You must enter an integer in the range 0 to 255.
    2. In Basic Service, select the type of basic service from the drop-down menu. None is selected by default.
    3. If you selected the bearer service or tele service, in Basic Service Value, specify the service ID. Enter an integer in the range 0 to 255.
    4. If long forward to phone number (Long FTN) is supported, select the Long FTN Supported check box.
  12. In Routing Indicator, select whether to route on global title or the destination subsystem number (SSN).
  13. (Optional) In Point Code, specify the destination point code.
  14. (Optional) In Subsystem Number, specify the SSN.
  15. In Global Title Type, select the type of global title to use in the destination SCCP address or select No Global Title. Select one of:
    • No Global Title (GTI=0000)
    • 1. GTI=0001 — Use digits and nature of address.
    • 2. GTI=0010 — Use digits and translation type.
    • 3. GTI=0011 — Use digits, translation type, and numbering plan.
    • 4. GTI=0100: Use digits, translation type, numbering plan, and nature of address
    Depending on the selected global title type, as defined in the ITU standard Q.713, one or more of the global title configuration fields become available. Configure the global title by entering values for each available field, as follows:
    • Global Title Address — Specify the global title digits to use in the destination SCCP address.
    • Translation Type — Specify a value in the range 0 to 255.
    • Numbering Plan — Specify the global title numbering plan value.
    • Nature of Address — Specify the global title nature of address value.
  16. Click Save.
  17. (Optional) Click New Revision to create a new revision of this PreRating call out action.