emergency location

manage emergency location data.

Format

• [-v] [-V] -c [--bssid s --location-id]
• [-v] [-V] -c --customer m [--callback-number]
• [--customer-id]
• [-v] [-V] -c --location-id [--callback-number]
• [--info] [--customer-id]
• [-v] [-V] -c -d m --location-id
• [-v] [-V] -c -l m --location-id
• [-v] [-V] -e --bssid s
• [-v] [-V] -e --customer m
• [-v] [-V] -e --location-id m
• [-v] [-V] -e -d m
• [-v] [-V] -e -l m
• [-v] [-V] -i --bssid s --location-id
• [-v] [-V] -i --customer m --customer-id
• [--callback-number]
• [-v] [-V] -i --file [-f]
• [-v] [-V] -i location-id [--info]
• [--callback-number] [--customer-id]
• [-v] [-V] -i -d m --location-id
• [-v] [-V] -i -l m --location-id
• [-v] [-V] -p [--bssid S] [±s] [-f]
• [-v] [-V] -p [--customer M] [±s] [-f]
• [-v] [-V] -p [--location-id M] [±s] [-f]
• [-v] [-V] -p [-d M [±s] [-f]
• [-v] [-V] -p [-l M [±s] [-f]

Function

The command is used to change, erase, initiate, and print emergency location data used at emergency calls.

The Caller's Emergency location ID is used to find the callers emergency information at an emergency call.

A directory number can be assigned a location ID.

A BSSID (Basic Service Set Identifiers) can be assigned a location ID.

The BSSID can be a MAC address of a SIP phone or other network device.

A LIM can be assigned a location ID, LIM 0 is the system default location.

The LIM location ID will be used if the directory number of the caller has not been assigned with a location ID, or when BSSID is not assigned with a location ID.

When a LIM has not been assigned with a location ID the system default (LIM = 0) location ID will be used.

With the location-id the data related to location-id is fetched (CustomerId, CallbackNumber and info).

Note: The location-id must be assigned before it can be assigned to a Dir, BSSID or Lim.

If no location ID is found a search is made on the customer group assigned to the caller to find customer ID and optionally a call back number.

There are 5 tables used for storing emergency location data. It is accessed by BSSID, Dir, LIM, Location ID or customer group number.

Parameters

• --bssid

  The BSSID (Basic Service Set Identifiers) is the MAC address of a phone, wireless access point (WAP) or another network device. It is generated by combining the 24-bit Organization Unique Identifier (the manufacturer’s identity) and the manufacturer’s assigned 24-bit identifier for the radio chipset in the WAP.

  The BSSID is converted and stored in lower case letters.

  Accepted argument length is 1 to 20 characters.

  The switch requires an argument.

• --callback-number

  Phone number to be used as the callback number to send to the Public Safety Answering Point.

  If parameter is entered with no value in change command the parameter is cleared.

  Accepted argument length is 1 to 22 digits.

  The switch takes an optional argument. The argument is single-valued.

• --c, --change

  Change some settings. That is, reconfiguration of an item (or several items).

  The switch takes no arguments.

• --customer

  Customer number for the extension. Customer 0 is the default customer of the exchange. Argument must be an integer in the range 0 to 50000. For print operations the default is function dependent, for all other operations the default is 0 (zero).

  The switch requires an argument.

• --customer-id

  Identifier of the customer sending the emergency call.

  If parameter is entered with no value in change command the parameter is cleared.

  Accepted argument length is 1 to 50 characters.

  The switch takes an optional argument. The argument is single-valued.

• -d, --dir

  Directory number for an extension. The number must belong to a number series for extensions. Accepted argument length is 2 to 20 digits.

  The switch requires an argument.

• -e, --erase

  Erase some settings. That is, deconfiguration of an item (or several items).

  The switch requires an argument.

• --file

  File name. Accepted argument length is 2 to 100 characters.

  The switch requires an argument. The argument is single-valued.

• -f, --format

  Select a format for the printout.

  Available formats are:

  • DEF - print default format or default import format
  • ALT - print alternative format
  • CSV - print comma-separated format
  • LOCATIONID - import location-id data from file in csv format (default at import)

  Possible values are: 'ALT', 'CSV', 'DEF', 'LOCATIONID'.

  Default if switch is not given is 'DEF'.

  The switch requires an argument. The argument is single-valued.

• --info

  Information string. If parameter is entered with no value in change command the parameter is cleared.

  Accepted argument length is 1 to 250 characters.

  The 'narrow' string will be converted to ISO 10646-UCS-4 (Unicode) 'wide' string. In this conversion, the 'narrow' string can hold 'quoted' unicode numbers of unicode characters. A quote character is used to switch between narrow text mode and unicode number mode in the input 'narrow' string. In unicode number mode, the numbers are according to ISO 10646-UCS-4 see for instance http://std.dkuug.dk/JTC1/SC2/WG2/

  In unicode number mode, the numbers are separated by space ' ', or by semicolon ';'. The numbers in unicode number mode are decimal or hexadecimal. (Hexadecimal numbers must begin with 0x.) The default quote character is the percent sign '%', but that can be changed using the environment variable $_MD_UNICODE_QUOTE_CHAR. To input the quote character itself, the unicode number for the quote character must be given in unicode number mode. (To input '%' if '%' is quote character, insert '%37%'.)

  Example: To input the fictitious German company name 'Üßü-GmbH' (transcribed as Uessue-GmbH), with correct German characters, without a German keyboard, the input would be '%0xdc 0xdf 0xfc%-GmbH'.

  The switch takes an optional argument. The argument is single-valued.

• -i, --initiate

  Initiate some settings. That is, make initial configuration of an item (or several items).

  The switch takes no arguments.

• -l, --lim

  Lim number.

  Lim 0 is default for system.

  Accepted argument is 0 to 124.

  The switch requires an argument.

• --location-id

  States the 'location identity', that is, a building, room or radio cell reference.

  Accepted argument length is 1 to 100 characters.

  The switch requires an argument.

• -p, --print

  Print all or some settings, that is, print configuration of an item, several items, or all items.

  The switch takes no arguments.

• -s, +s, --sort, ++sort

  Specify sorting criteria for printout. If no sorting is specified, the printout is unsorted. If sort switch is given without arguments, the printout will be sorted on -s and --sort specify ascending sort order. +s and ++sort specify descending sort order. Possible values are: '', 'BSSID', 'CALLBACK', 'CUST', 'CUSTOMERID', 'DIR', 'LIM', 'LOCATIONID'.

  The switch takes an optional argument. The argument is single-valued.

• -v, --verbose

  Turn on verbose output (that is,. progress information) to standard error.

  The switch takes no arguments.

• -V, --verbose-to-syslog

  Turn on verbose logging to syslog (usually to /var/log/messages).

  The switch takes no arguments.

Examples

• Initiate customer group number 5 with customer ID 8ae5df2b-93e9-4e4c-bdd0-74316e36eae6.

  emergency_location -i --customer 5 --customer-id 8ae5df2b-93e9-4e4c-bdd0-74316e36eae6

• Initiate location ID 6135555554 with the callback number 04687232300 and info '10 Main St, Ottawa'.

  emergency_location -i --location-id 6135555554 --callback-number 04687232300 -info '10 Main St, Ottawa'

• Initiate location ID 6135555555 with callback number 04687232301, customer ID 9ae5df2b-83e9-4e4c-bdd0-74316e36eae6 and info '10 Main St, Ottawa'.

  emergency_location -i --location-id 6135555555 --callback-number 04687232301 --customer-id 9ae5df2b-83e9-4e4c-bdd0-74316e36eae6 --info '10 Main St, Ottawa'

• For a SIP phone with MAC de-ad-ba-ad-be-ef initiate a BSSID deadbaadbeef with location ID 6135555556.

  emergency_location -i --bssid deadbaadbeef --location-id 6135555556

• For an analogue phone with directory number 20713 initiate location ID 6135555554.

  emergency_location -i -d 20713 --location-id 6135555554

• Initiate the default location ID for the system to 6135555550.

  emergency_location -i --lim 0 --location-id 6135555550

• Initiate location ID 6135555551 to LIM 4.

  emergency_location -i --lim 4 --location-id 6135555551

• Change the customer ID for customer group number 5 to 55e5df2b-93e9-4e4c-bdd0-74316e36eae6.

  emergency_location -c --customer 5 --customer-id 55e5df2b-93e9-4e4c-bdd0-74316e36eae6

• Change the callback number for location ID 6135555550 to 04687232301.

  emergency_location -c --location-id 6135555550 --callback-number 04687232301

• Remove the callback number for location ID 6135555550.

  emergency_location -c --location-id 6135555550 --callback-number

• Change the location ID for BssId de-ad-ba-ad-be-ef to 6135555550.

  emergency_location -c --bssid de-ad-ba-ad-be-ef --location-id 6135555550

• Change the location ID for directory 20713 to 6135555554.

  emergency_location -c -d 20713 --location-id 6135555554

• Change the location ID for LIM 5 to 6135555514.

  emergency_location -c --lim 5 --location-id 6135555514

• Erase the data for customer group 5.

  emergency_location -e --customer 5

• Erase the assigned location ID for BSSID deadbaadbeef.

  emergency_location -e --bssid deadbaadbeef

• Erase the assigned location ID for directory number 20713.

  emergency_location -e -d 20713

• Erase the location ID 6135555520.

  emergency_location -e --location-id 6135555520

• Erase the location ID assigned to LIM 3.

  emergency_location -e --lim 3

• Print customer group data for customer group number 5.

  emergency_location -p --customer 5

• Print all location ID in the system.

  emergency_location -p --location-id all

• Print BSSID deadbaadbeef

  emergency_location -p --bssid deadbaadbeef

• Print location ID assigned to LIM 5

  emergency_location -p --lim 5

• Print location ID assigned to directory number 27617.

  emergency_location -p --dir 27617

• Export all location ID and locations data to file /tmp/locationId_data.csv format.

  emergency_location -p --location-id all --format CSV > /tmp/locationId_data.csv

• Import new location ID data from a csv file /tmp/locationId_data.csv.

  emergency_location -i --file /tmp/locationId_data.csv --format LOCATIONID