4 Messaging Manager Action and Error Codes
This chapter explains how to configure the reject action error codes.
This chapter contains the following topics.
Action and Error Codes
The Action and Error Codes configuration allows error codes to be mapped to release causes, and vice versa, and to identify the default release cause for the Reject action (the Discard and Accept actions have permanent, fixed cause values).
Accessing Messaging Manager Action and Error Codes
Follow these steps to open the Messaging Manager Action and Error Codes screen.
-
Select the Services menu from the SMS main screen.
-
Select Messaging Manager.
-
Select Action and Error Codes.
Result: You see the Messaging Manager Action and Error Codes screen.
For more information about:
-
The screen's content and how to enter configuration information, see the other topics in this chapter.
-
How all the information works together to create the Messaging Manager configuration, see Configuration Scenarios.
-
Logging into the Service Management System screen, see SMS User's Guide.
Release Cause and Error Mappings panels
Each protocol-specific tab (that is, all the tabs except for the Global tab) have two panels:
-
Release Cause Mappings panel at the top
-
Error Mappings panel at the bottom
Each panel has its own set of New, Edit and Delete buttons in the top right of the panel. These buttons enable you to work with the records in the corresponding panel.
Global Action and Error Codes
The Global tab displays the global list of action and error codes which define ACS Release Cause values and corresponding error types which may be mapped to protocol-specific error codes.
Topics:
Global tab
Here is an example Global tab.
Description of the illustration mmactionerrorcodesglobal_4-1-2.jpg
Global fields
This table describes the content of each editable column.
Field | Description |
---|---|
ACS Release Cause |
The release cause value posted to Messaging Manager by ACS. Note: The maximum allowed value is 118. Higher values are internal system defaults that cannot be changed. |
Error Type | The type of error this cause number represents. Values are Permanent, Transient, Abort. |
Description | What the error cause number represents. |
Is Default |
Indicates if the cause is the default for the Reject, Discard, or Accept actions. Note: You are able to modify only the default Reject action. The other actions are predefined. |
Path Fail |
Whether or not the error code causes a bypass of retires on the current path. The default for:
|
Adding Global Release Cause
Follow these steps to add a Global Release Cause.
-
From the Global tab screen, click New.
Result: The New Release Cause screen opens.
See Global fields for a description of each field.
-
In the ACS Release Cause field, enter the release cause number.
Note: Must be a unique number, less than 118.
-
Enter the description for the release cause in the Description field.
-
Select the type of error for this release cause from the Error Type drop down list.
-
Select the Path Failure check box if you wish this release cause to be a path failure.
-
Select the default action for this release cause from the This is the default action for drop down list.
Note: Select the Reject option if this release cause is to be used as the new global reject action cause. For everything else, select null option.
-
Click Save to save the new release cause record in the configuration database.
Related topic
Editing Global Release Cause
Follow these steps to edit a global error code.
-
In the table on the Global tab, select the ACS release cause to edit.
-
From the Global tab screen, click Edit.
Result: The Edit Release Cause 'Code_Number' screen opens.
-
Change the fields as required. See Global fields for a description of each field.
-
Click Save to save the release cause record in the configuration database.
Related topic
Deleting Global Release Cause
Follow these steps to delete a Global Release Cause.
-
In the table on the Global tab, select the ACS release cause to delete.
-
Click Delete.
Result: The Delete Release Cause 'Cause_Number' screen opens.
-
Click Delete to delete the record from the configuration database.
Note: To delete this code, it must have already been removed from the protocols.
Related topic
SMPP
The SMPP tab defines, for this protocol, the:
-
Error codes returned to the caller for each ACS release cause
-
ACS release cause for each error code
Topics:
SMPP fields
This table describes the content of each column.
Field | Description |
---|---|
SMPP Command Status |
The status code to map against the ACS release cause. Note: Must be a unique release code for this protocol. |
ACS Release Cause |
The release cause number used by Messaging Manager to pass back to ACS. Note: This is defined on the Global tab. |
Error Type |
The type of error the ACS release cause number represents. Note: This is defined on the Global tab. |
EMI
The EMI tab defines, for this protocol, the:
-
Error codes returned to the caller for each ACS release cause
-
ACS release cause for each error code
Topics:
EMI fields
This table describes the content of each column.
Field | Description |
---|---|
Context | The circumstances in which this mapping will be applied. |
EMI Error Code |
The error code to map against the ACS release cause. Note: Must be a unique release code for this protocol. |
ACS Release Cause |
The release cause number used by Messaging Manager to pass back to ACS. Note: This is defined on the Global tab. |
Error Type |
The type of error the ACS release cause number represents. Note: This is defined on the Global tab. |
MAP
The MAP tab defines, for this protocol, the:
-
Error codes returned to the caller for each ACS release cause
-
ACS release cause for each error code
Topics:
MAP fields
This table describes the content of each column.
Field | Description |
---|---|
GSM Error Code |
The GSM MAP error code to map against the ACS release cause. Note: Must be a unique release code for this protocol. |
CauseCode/Access Denied Reason | The cause value for an SM Delivery Failure. |
ACS Release Cause |
The release cause number used by Messaging Manager to pass back to ACS. Note: This is defined on the Global tab. |
Error Type |
The type of error the ACS release cause number represents. Note: This is defined on the Global tab. |
IS-41
The IS-41 tab defines, for this protocol, the:
-
Error codes returned to the caller for each ACS release cause
-
ACS release cause for each error code
Topics:
IS-41 fields
This table describes the content of each editable column.
Field | Description |
---|---|
Context | The circumstances in which this mapping will be applied. |
IS-41 SMS Cause Code |
The cause code for an IS-41 error (SMDPP, or SMS Request) to map against the ACS Release Cause. Note: Must be a unique release code for this protocol. |
Cause Value | Not used for IS-41 |
ACS Release Cause | The release cause number used by MM to pass back to ACS. |
Error Type | The type of error this Release Cause number represents. |
SIP
The SIP tab defines, for this protocol, the:
-
Error codes returned to the caller for each ACS release cause
-
ACS release cause for each error code
Topics:
SIP fields
This table describes the content of each column.
Field | Description |
---|---|
SIP Status |
The status code to map against the ACS release cause. Note: Must be a unique release code for this protocol. |
SIP Command Status | The status code to map against the ACS release cause. |
ACS Release Cause |
The release cause number used by Messaging Manager to pass back to ACS. Note: This is defined on the Global tab. |
Error Type |
The type of error the ACS release cause number represents. Note: This is defined on the Global tab. |
Release Cause Mapping
The names of the fields, except the release cause field, on the following screens, are different, depending on the protocol selected.
Topics:
Adding release cause mapping - IP
Adding release cause mapping - MAP, IS-41
Editing release cause mapping - IP
Adding release cause mapping - IP
In this example the SMPP protocol has been used. Apart from the different error code names, the add procedure is identical for the following protocols:
-
SMPP
-
EMI
-
SIP
Follow these steps to add a release mapping to a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to add the release mapping to.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The top table on the tab displays the release cause mappings.
-
To the right of Release Cause Mappings label at the top of the release cause mappings panel, click New....
Result: The New Release Cause Mapping screen opens.
Note: The New Release Cause Mapping screen for the EMI protocol also has a Context field not shown in this screen shot. For more information, see EMI fields.
-
If you are creating an EMI release cause mapping, enter a context into the Context field.
-
From the ACS Release Cause drop down list, select the global release cause number to map with.
Result: The error type and description of the release cause are displayed below the fields. For more information about how to configure what text displays here, see Global fields.
Description of the illustration mmxnewreleasecausemappingsmppcrop_4-1-1.jpg -
Enter the protocol error code to map to in the bottom field. The name of the field varies according to the protocol:
Protocol Field name More information SMPP SMPP command status See SMPP fields. EMI EMI error code See EMI fields. SIP SIP Status See SIP fields. Note: Must be a unique release code for this protocol.
-
Click Save to save the new release cause mapping record in the configuration database.
Related topic
Adding release cause mapping - MAP, IS-41
In this example the MAP protocol has been used. Apart from the different error code names, the add procedure is identical for the following protocols:
-
MAP
-
IS-41
Follow these steps to add a release mapping to a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to add the release mapping to.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The top table on the tab displays the release cause mappings.
Description of the illustration mmxactionerrorcodesmap_rel_cause_ex_4-0.jpg -
To the right of Release Cause Mappings, click New.
Result: The New Release Cause Mapping screen opens.
-
Select the global release cause number to map with from the ACS Release Cause drop down list.
Result: The error type and description of the release cause are displayed below the fields. Refer to Global fields.
Description of the illustration mmxnewreleasecausemappingmapex_3-2.jpg -
Enter the protocol error codes to map to in the bottom fields. The names of the fields vary according to the protocol:
-
MAP - see MAP fields.
-
IS-41 - see IS-41 fields.
-
-
Note: Must be a unique release code for this protocol.
-
Click Save to save the cause mapping record in the configuration database.
Related topic
Editing release cause mapping - IP
In this example the EMI protocol has been used. Apart from the different error code names, the edit procedure is identical for the following protocols:
-
SMPP
-
EMI
-
SIP
Follow these steps to edit a release mapping for a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to edit the release mapping for.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The top table on the tab displays the release cause mappings.
-
In the Release Cause Mappings table on the tab, select the record to edit.
-
To the right of Release Cause Mappings label at the top of the release cause mappings panel, click Edit....
Result: The Edit Release Cause Mapping screen opens.
-
Change the text in the field, if required. The name of the field varies according to the protocol:
-
SMPP - SMPP command status. See SMPP fields.
-
EMI - EMI error code. See EMI fields.
-
SIP - SIP Status. See SIP fields.
-
-
Click Save to save the cause mapping record in the configuration database.
Related topic
Editing release cause mapping - MAP, IS-41
In this example the MAP protocol has been used. Apart from the different error code names, the edit procedure is identical for the following protocols:
-
MAP
-
IS-41
Follow these steps to edit a release mapping for a protocol.
-
From the Action and Error Codes screen, click the required <protocol> tab to edit the release mapping for.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The top table on the tab displays the release cause mappings.
Description of the illustration mmxactionerrorcodesmap_rel_cause_ex_4-0.jpg -
In the Release Cause Mappings table on the tab, select the record to edit.
-
To the right of Release Cause Mappings, click Edit.
Result: The Edit Release Cause Mapping screen opens.
-
Change the text in the fields, if required. The names of the fields vary according to the protocol:
-
MAP - see MAP fields.
-
IS-41 - see IS-41 fields.
-
-
Click Save to save the cause mapping record in the configuration database.
Related topic
Deleting release cause mapping
In this example the EMI protocol has been used. The delete release mapping procedure is identical for all protocols.
Follow these steps to delete a release mapping from a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to delete the release cause mapping from.
Result: The Protocol tab shows all the release cause and error code mappings currently defined for the protocol. The top table on the tab displays the release cause mappings.
Description of the illustration mmxactionerrorcodesemireleasecausemappingsex_4-0.jpg -
In the Release Cause Mappings table on the tab, select the record to delete.
-
To the right of Release Cause Mappings, click Delete.
Result: The Delete Release Cause Mapping 'Cause_Number' screen opens.
-
Click Delete to delete the record from the configuration database.
Note: This does not delete the error code, just the release mapping.
Related topic
Error Mapping
The names of the fields, except the release cause field, on the following screens, are different, depending on the protocol selected.
Topics:
Adding error mapping - MAP, IS-41
Adding error mapping - IP
In this example the EMI protocol has been used. Apart from the different error code names, the add procedure is identical for the following protocols:
-
SMPP
-
EMI
-
SIP
Follow these steps to add an error mapping to a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to add the release mapping to.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The bottom table on the tab displays the error mappings
Description of the illustration mmxactionerrorcodesemi_error_ex_4-0.jpg -
To the right of Error Mappings, click New.
Result: The New Error Mapping screen opens.
-
Enter the protocol error code to map to in the top field. The name of the field varies according to the protocol:
Protocol Field name More information SMPP SMPP command status See SMPP fields. EMI EMI error code See EMI fields. SIP SIP Status See SIP fields. Note: Must be a unique release code for this protocol. Select the global release cause to map with from the ACS Release Cause drop down list.
-
Result: The error type and description of the release cause are displayed below the fields. Refer to Global fields.
Description of the illustration mmxnewerrormappingexreleasecause_3-2.jpg -
Click Save to save the new release mapping record in the configuration database.
Related topic
Adding error mapping - MAP, IS-41
In this example the MAP protocol has been used. Apart from the different error code names, the add procedure is identical for the following protocols:
-
MAP
-
IS-41
Follow these steps to add an error mapping to a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to add the release mapping to.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The bottom table on the tab displays the error mappings.
Description of the illustration mmxactionerrorcodesmap_error_ex_4-0.jpg -
To the right of Error Mappings, click New.
Result: The New Error Mapping screen opens.
-
Enter the protocol error codes to map to in the top two fields. The names of the fields vary according to the protocol:
-
MAP - see MAP fields.
-
IS-41 - see IS-41 fields.
Note: Must be a unique release code for this protocol.
-
-
Select the global release cause to map to from the ACS Release Cause drop down list.
Result: The error type and description of the release cause are displayed below the field. Refer to Global fields.
Description of the illustration mmxnewerrormappingexreleasecause_3-2.jpg -
Click Save to save the error mapping record in the configuration database.
Related topic
Editing error mapping - IP
In this example the EMI protocol has been used. Apart from the different error code names, the edit procedure is identical for the following protocols:
-
SMPP
-
EMI
-
SIP
Follow these steps to edit a release mapping for a protocol.
-
From the Action and Error Codes screen, click the required <protocol> tab to edit the release mapping for.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The bottom table on the tab displays the error mappings
Description of the illustration mmxactionerrorcodesemi_error_ex_4-0.jpg -
In the Error Mappings table on the tab, select the record to edit.
-
To the right of Error Mappings, click Edit.
Result: The Edit Error Mapping screen opens.
Note: The name of the field varies according to the protocol:
Protocol Field name More information SMPP SMPP command status See SMPP fields. EMI EMI error code See EMI fields. SIP SIP Status See SIP fields. -
Change the ACS Release Cause, if required.
-
Click Save to save the error mapping record in the configuration database.
Related topic
Editing error mapping - MAP, IS-41
In this example the MAP protocol has been used. Apart from the different error code names, the edit procedure is identical for the following protocols:
-
MAP
-
IS-41
Follow these steps to edit a release mapping for a protocol.
-
From the Action and Error Codes screen, click the required <protocol> tab to edit the release mapping for.
Result: The Protocol tab shows all the release cause and error mappings currently defined for the protocol. The bottom table on the tab displays the error mappings
Description of the illustration mmxactionerrorcodesmap_error_ex_4-0.jpg -
In the Error Mappings table on the tab, select the record to edit.
-
To the right of Error Mappings, click Edit.
Result: The Edit Error Mapping screen opens.
Note: The names of the top two fields vary according to the protocol:
-
MAP - see MAP fields.
-
IS-41 - see IS-41 fields.
-
-
Change the ACS Release Cause, if required.
-
Click Save to save the error mapping record in the configuration database.
Related topic
Deleting error mapping
In this example the EMI protocol has been used. The delete error mapping procedure is identical for all protocols.
Follow these steps to delete an error mapping from a protocol.
-
From the Action and Error Codes screen, click the required protocol tab to delete the release cause mapping from.
Result: The Protocol tab shows all the release cause and error code mappings currently defined for the protocol. The bottom table on the tab displays the error mappings
Description of the illustration mmxactionerrorcodesemi_error_ex_4-0.jpg -
In the Error Mappings table on the tab, select the record to delete.
-
To the right of Error Mappings, click Delete.
Result: The Delete Error Mapping 'Cause_Number' screen opens.\
-
Click Delete to delete the record from the configuration database.
Note: This does not delete the error code, just the error mapping.
Related topic