Professional Documents
Culture Documents
List of Commands EIR
List of Commands EIR
The parameters IMEI and Name of IMEI file are optional. Specify only
one of them.
If Operation type is set to FALSE, IMEI status, Action template ID and
Cause code are not present.
If Action template ID is set to 65535, the action template set for the
specified IMEI is withdrawn.
Parameters
ID
Name
Description
IMEI
IMEI
IMEIFILE
Name of
IMEI file
PROV
information.
STATUS
IMEI
status
ACTIONID
Action
template
ID
REASONCODE Cause
code
WhiteList
BlackList
GreyList
Example
To set the status of the IMEI 77777777123400 to WhiteList with action template
1 and cause code 12, run the following command:
MOD IMEI: IMEI="77777777123400", PROV=TRUE, STATUS=WhiteList,
ACTIONID=1, REASONCODE=12;
Listing the IMEI Status (LST IMEI)
Function
Use this command to query the status information of an IMEI as well as the
information of the action template ID and cause code.
Note
The parameters IMEI and Name of IMEI file are optional. Specify only one of
them.
Parameters
ID
Name
Description
IMEI
IMEI
The parameters Start IMEI and End IMEI serial number specify an IMEI
segment. You must specify both of them or leave both of them blank
based on the actual condition. The end IMEI serial number must be
greater than the last six digits of the first IMEI.
The parameter Operation type is mandatory.
Each IMEI segment can be configured with only one state. The IMEI
segments cannot have any intersection.
If Action template ID is set to 65535, the action template set for the
specified IMEI segment is withdrawn.
If you use the BAT command to run this command in batches, the number
of commands contained in the batch operation file must be smaller than
10,000.
Parameters
ID
Name
Description
BEGINIMEI
Start IMEI
ENDIMEISN
End IMEI
serial
number
IMEIRANGEFILE Name of
Specifies the name of an IMEI segment file.
IMEIRANGE
file
Value: a string of 1 to 16 alphanumeric
characters
The IMEI segment file contains multiple IMEI
segments.
The number of entries contained in the IMEI
segment status file must be smaller than 10,000.
OPTYPE
Operation
type
STATUS
IMEI
segment
status
ACTIONID
Action
template ID
WhiteList
BlackList
GreyList
REASONCODE
Example
To set the status of the IMEI segment ranging from 77777777123400 to
77777777123499 to WhiteList with action template 1 and cause code 12, run
the following command:
MOD IMEIRANGE: BEGINIMEI="77777777123400", ENDIMEISN="123499",
OPTYPE=ADD, STATUS=WhiteList, ACTIONID=1, REASONCODE=12;
Listing the Information of IMEIs and IMEI Segments (LST IMEIRANGE)
Function
Use this command to query information about one or more IMEI segments or
information about the IMEIs in the specified IMEI segmentas well as the
information of the action template ID and cause code.
Note
If the number of queried records exceeds 500, the system prompts you to query
the data by running the LST IMEIDATA command.
Parameters
ID
Name
Description
Specifies the first IMEI of an IMEI segment.
Value: a decimal number of 14 digits
ENDIMEI
End IMEI
OPOBJ
Operation
type
STATUS
WhiteList
BlackList
GreyList
Parameters
ID
Name
Description
Specifies the original status of the IMEIs or IMEI
segments.
Value:
DSTATUS Destination
status
WhiteList
BlackList
GreyList
OPOBJ
Operation
object
WhiteList
BlackList
GreyList
Use this command to query the IMEI data based on the specified conditions. The
results are saved in a text file on the PGW board, and the directory is
/opt/pgw/pgwtmpfile/SYSHLRSN+OPNAME. Here, the default length of
SYSHLRSN is 3 bits. For example, when SYSHLRSN=1, OPNAME=admin,
SYSHLRSN+OPNAME is 001admin.
Note
Parameters
ID
Name
Description
Specifies the information to be queried.
Value:
COND
Query condition
PARA1
Start IMEI
PARA2
End IMEI
STATUS IMEI/IMEI
segment status
RESULT
CountOfIMEIStatus
(Number of IMEIs)
DataOfIMEIStatus
(IMEI value)
WhiteList
BlackList
GreyList
COND
All (all IMEIs)
PARA PARA
1
2
-
End
IMEI
(M)
RangeByIMEIAndSta Start
tus (based on the
IMEI
IMEI segment and
(M)
IMEI status)
CountOfIMEIRangeSta All (all IMEI
tus (Number of IMEIs) segments)
End
IMEI
(M)
Example
STATUS
WhiteList
BlackList
GreyList
WhiteList
BlackList
GreyList
WhiteList
BlackList
GreyList
Example 1:
To query the total number of IMEI records, run the following command:
LST IMEIDATA: RESULT=CountOfIMEIStatus, COND=All;
Example 2:
To query the number of IMEI segments that are in the WhiteList state, run the
following command:
LST IMEIDATA: RESULT=CountOfIMEIRangeStatus, COND=Status,
STATUS=WhiteList;
Binding or Unbinding IMSIs for an IMEI (MOD IMEILOCK)
Function
Use this command to bind or unbind one or more IMSIs for an IMEI. One IMEI
can be bound with multiple IMSIs. The MS identified by the IMEI becomes
unusable if it is inserted with the SIM card identified by any other IMSI.
Note
None.
Parameters
ID
Name
Description
IMEI
IMEI
EIRIMSI IMSI
FILE
PROV
Name of
IMEI/IMSI file
Provide binding
Value:
Example
To bind the IMEI 11111111111111 with the IMSI 460000000000123, run the
following command:
MOD IMEILOCK: IMEI="11111111111111", EIRIMSI="460000000000123",
PROV=TRUE;
Listing IMSIs Bound with an IMEI (LST IMEILOCK)
Function
Use this command to query the IMSIs bound with an IMEI.
Note
The parameters IMEI and Name of IMEI file are optional. Specify only one of
them.
Parameters
ID
Name
Description
IMEI
IMEI
Example
To query the IMSIs bound with the IMEI 11111111111111, run the following
command:
LST IMEILOCK: IMEI="11111111111111";
Name
EIRIMSI IMSI
Description
Represents the international mobile subscriber
identity of a subscriber.
Value: an E.212 format decimal number of 6 to 15
digits
IMEI
IMEI
FILE
PROV
Name of
IMSI/IMEI file
Provide binding
Value:
Example
To bind the IMSI 460000000000010 with the IMEI 11111111111111, run the
following command:
MOD IMSILOCK: EIRIMSI="460000000000010", IMEI="11111111111111",
PROV=TRUE;
Name
Description
EIRIMSI
IMSI
EIRIMSIFILE Name of
IMSI file
Example
To query the IMEIs bound with the IMSI 460000000000010, run the following
command:
LST IMSILOCK: EIRIMSI="460000000000010";
Binding or Unbinding IMEIs for an MSISDN (MOD ISDNIMEILOCK)
Function
Use this command to bind or unbind one or more IMEIs for an MSISDN. One
MSISDN can be bound with multiple IMEIs.
Note
A maximum of 10 IMEIs can be bound to a MSISDN. When more than 10
bounding records are added, the system deletes the earliest records. Specify
either MSISDN and IMEI or Name of MSISDNIMEI file.
Parameters
ID
Name
EIRISDN MSISDN
Description
Mobile subscriber ISDN number.
Value: an E.164 format decimal number of 1 to 15
digits
IMEI
IMEI
FILE
PROV
Name of
MSISDN/IMEI
file
Provide binding
Value:
Example
To bind the MSISDN 111111111111111 with the IMEI 11111111111111, run the
following command:
MOD ISDNIMEILOCK: EIRISDN="111111111111111", IMEI="11111111111111",
PROV=TRUE;
Listing IMEIs Bound with an MSISDN (LST ISDNIMEILOCK)
Function
Use this command to query the IMEIs bound with an MSISDN.
Note
The parameters MSISDN and Name of MSISDN file are optional. Specify only
one of them.
Parameters
ID
Name
Description
EIRISDN
MSISDN
EIRISDNFILE Name of
Specifies the name of an MSISDN file.
MSISDN file
Value: a string of 1 to 16 alphanumeric characters
Example
To query the IMEIs bound with the MSISDN 111111111111111, run the following
command:
LST ISDNIMEILOCK: EIRISDN="111111111111111";
Checking the EIR Data Consistency (CHK EIRCONSY)
Function
Use this command to check whether the IMEI data stored on the nodes of the
memory database is consistent. The system displays the verification results and
synchronizes the IMEI data on the slave nodes with the master node.
Note
Specify only one of the parameters IMEI, IMSI, Name of IMEI file, and
Name of IMSI file.
Number of subscribers cannot be specified together with Name of IMEI
file or Name of IMSI file.
Parameters
ID
Name
Description
IMEI
IMEI
EIRIMSI
IMSI
Name of
IMEI file
EIRIMSIFILE
Name of
IMSI file
Example
To check data consistency for the IMEI 77777777771234, run the following
command:
CHK EIRCONSY: IMEI="77777777771234";
Listing the Dynamic IMEI Data(LST DYNIMEIDATA)
Function
Use this command to query the dynamic data for an IMEI.
Note
The parameters IMEI and Name of IMEI file are optional. Specify only one of
them.
Parameters
ID
Name
Description
IMEI
IMEI
Example
To query the dynamic data for the IMEI 11111111111111, run the following
command:
LST DYNIMEIDATA: IMEI="11111111111111";