This topic presents the MTP configuration file parameters:
The following table lists the configurable parameters in the MTP 3 general configuration section. The default values for all timers at the MTP 3 level are shown below in tenths of a second. The default resolution when setting timers in the MTP3 configuration file is in seconds. Use the MTP3_TIMER_RES general parameter to specify if timer values being overridden in the MTP 3 configuration file are in seconds or tenths of a second. A configuration value of zero for a timer disables that timer.
Note: The PC_FORMAT parameter applies to all point codes in the MTP configuration file.
Parameter |
Default |
Valid values |
Description |
PC_FORMAT |
DEFAULT |
DFLT INTL JNTT |
Point code format. DFLT = Point codes are interpreted and displayed as 24-bit 8.8.8 values. INTL = Point codes are interpreted and displayed as 14-bit 3.8.3 values. JNTT = Use for both Japan NTT and TTC networks. Point codes are interpreted and displayed as 16-bit mcode.scode.ucode values with the U-code in the most significant 7 bits, the S-code in the next 4 bits, and the M-code in the least significant 5 bits. |
POINT_CODE |
None |
N/A |
Point code of this node, specified in dotted notation (such as 2.45.76) or a hexadecimal number (such as 0x101). This parameter is required. |
NODE_TYPE |
STP |
STP SP |
Mode of operation. STP = transfer functionality SP = no transfer functionality |
POINT_CODE2 |
None |
N/A |
Alternate point code for this node when supporting both ANSI and ITU-T networks from the same board. Specify the ITU-T point code in the POINT_CODE parameter and the ANSI point code here. |
MTP3_TIMER_RES |
SECONDS |
SECONDS TENTHS |
Whether timer values in the configuration file are specified in seconds or tenths of a second. |
RESTART_REQUIRED |
TRUE |
TRUE/YES FALSE/NO |
If TRUE, full restart procedure is required whenever node becomes accessible. |
VALIDATE_SSF |
TRUE |
TRUE/YES FALSE/NO |
If TRUE, MTP 3 validates incoming MTP 3 signaling network management (SNM) and test (SLTM/SLTA) messages. Messages with an SSF that does not match the value configured for the link on which the message was received are rejected. If FALSE, the SSF is not checked on incoming MTP 3 management or test messages (any SSF value is accepted). MTP 3 does not validate the SSF in any incoming or outgoing user part messages. |
DISABLE_UPU |
FALSE |
TRUE/YES FALSE/NO |
If TRUE, MTP never sends a User Part Unavailable message. |
MAX_LINKS |
4 |
1 through 128 |
Maximum number of physical links (actual maximum depends on TX board model and hardware configuration). |
MAX_USERS |
2 |
1 through 64 |
Maximum number of MTP 3 users (user parts). |
MAX_ROUTES |
32 |
1 through 32767 |
Maximum number of routes. |
MAX_ROUTE_ENTRIES |
1024 |
1 through 32767 |
Maximum number of route instances. Logical maximum is MAX_ROUTES * number of SLS values (16 - ITU, 32 - ANSI), but this number can be decreased. |
MAX_LINK_SETS |
1 |
1 through 16 |
Maximum number of supported linksets. |
MAX_ROUTE_MASKS |
0 |
0 through 8 |
Maximum number of routing masks. If zero, all destination point codes in outgoing messages must exactly match a point code in a route entry. |
ROUTE_MASK |
None |
0x00 through |
Routing mask to be applied to destination point code before matching against routing table entries. Use to reduce the number of routes that must be configured or use if remote destination point codes are not known at configuration time (a database server). You can specify multiple ROUTE_MASKs. They are applied in the order in which they appear in the configuration file. |
TIMER_T15 |
30 |
0 through 65535 |
Time to wait to start or repeat route set congestion test. |
TIMER_T16 |
20 |
0 through 65535 |
Time to wait for route set congestion status update. |
TIMER_T18_ITU |
300 |
1 through 65535 |
ITU restart timer for an STP during which links are restarted and TFA, TFR, and TFP messages are received. |
TIMER_T20_ITU |
600 |
1 through 65535 |
ITU overall restart timer. |
TIMER_T22_ANSI |
300 |
1 through 65535 |
ANSI restart timer at restarting SP waiting for links to become available. |
TIMER_T23_ANSI |
300 |
1 through 65535 |
ANSI restart timer at restarting SP waiting for TRA messages. |
TIMER_T26_ANSI |
130 |
1 through 65535 |
ANSI restart timer at restarting SP waiting to repeat TRW message. |
TIMER_T27_ANSI |
30 |
1 through 65535 |
Minimum duration of unavailability for full restart. |
TIMER_TRTEINST |
18000 |
0 through 65535 |
Internal route instance timer (how long a route instance is valid). Not ANSI T30. |
MTP3_TRACE_DATA |
FALSE |
TRUE FALSE |
If TRUE, start tracing of all data between MTP 2 and MTP 3. |
OPC_ROUTING |
FALSE |
TRUE FALSE |
If TRUE, outbound routing takes into account OPC values, as well as DPC and SLS values. If FALSE, outbound routing takes into account only DPC and SLS values. Refer to Configuring multiple OPC emulation for more information. |
TRANSPARENT_MODE |
FALSE |
TRUE FALSE |
If TRUE, all inbound traffic is passed up to the SIO matching bound application regardless of DPC or OPC values. All outbound traffic is shared across all links regardless of DPC or OPC values. If FALSE, normal routing is in effect. |
END |
N/A |
N/A |
Marks the end of the general parameters section. This parameter is required. |
The following tables list the MTP 3 and MTP 2 configuration parameters applicable to each link:
Note: The application cannot configure HSLs and LSLs at the same time.
Parameter |
Default |
Valid values |
Description |
PORT |
None |
T1 through 128 (TDM) R (remote) |
Tn for T1, E1, H.100, and H.110 (actual maximum depends on TX board model and hardware configuration). R for remote links (links on the other board in a redundant system). |
LINK |
None |
0 through 127 |
Zero-based link number. Use this number to refer to the link in MTPMGR commands. |
LINK_TYPE |
ANSI |
ANSI ITU JNTT JTTC |
MTP 3 protocol variant used on link. |
ADJACENT_DPC |
None |
N/A |
Point code of the node on the other end of the link. Use dotted notation (such as 2.45.76) or a hexadecimal number (such as 0x101). |
OPC |
None |
N/A |
Originating point code. Use for multiple OPC emulation and OPC routing. Refer to Configuring multiple OPC emulation for more information. |
LINK_SET |
1 |
1 through 16 |
Linkset to which this link belongs. |
SSF |
NATIONAL (ANSI) INTERNATIONAL (ITU-T) |
NATIONAL INTERNATIONAL |
Value used in the subservice field (SSF) of the SIO. |
SUB_SERVICE |
2 |
0 through 3 |
Overrides SSF parameter. Use either SUB_SERVICE or the SSF parameter. |
LINK_PRIORITY |
0 |
0 through 3 |
Priority of this link within the link set. |
MESSAGE_SIZE |
272 |
64 through 1024 |
Maximum message length for this link. |
DISABLED |
FALSE |
TRUE FALSE |
If TRUE, link is initially disabled. No attempt is made to align with the remote side without manual intervention. If FALSE, link is initially enabled. It tries to align with the remote side immediately. |
USE_PRIORITY |
TRUE |
TRUE FALSE |
If TRUE, message priorities generated by user parts are inserted into the SIO octet (spare bits) of outgoing messages. If FALSE, the SIO spare bits are set to zero. Usually set to TRUE in ANSI networks and FALSE in ITU-T networks. |
MGNT_MSG_PRIORITY |
3 |
0 through 3 |
Priority to use for MTP3 management messages. |
DPC_LENGTH |
24 (ANSI) 14 (ITU) 16 (JNTT/JTTC) |
14 16 24 |
Number of bits in a point code. |
MAX_SLTM_RETRY |
2 |
0 through 255 |
Maximum times to retry signaling link test messages (SLTM) before disabling the link. A value of zero results in infinite retries. |
HS_LINK |
FALSE |
TRUE FALSE |
Setting this parameter to TRUE, notifies MTP that high speed links are in effect and automatically sets HS_EXT_SEQ to TRUE. Set HS_EXT_SEQ to FALSE for high speed links with normal sequence numbers. Note: Layers 2 and 3 use this parameter. |
HS_EXT_SEQ |
FALSE |
TRUE FALSE |
Setting this parameter to TRUE, notifies MTP that extended sequence numbers are in effect and changes the size of:
Sequence numbers increase from 7 to 12 bits and the length indicator increases from 6 to 8 bits. Setting HS_EXT_SEQ to TRUE automatically sets HS_LINK to TRUE. Normal speed links with extended sequence numbers are not supported. Note: Layers 2 and 3 use this parameter. |
P0QUE_LENGTH |
16 |
2 through 1024 |
Transmit queue length threshold at which the congestion priority is raised to level 0. |
P1QUE_LENGTH |
32 |
(p0Qlen + 2) through 1024 |
Transmit queue length threshold at which the congestion priority is raised to level 1. |
P2QUE_LENGTH |
64 |
(p1Qlen + 2) through 1024 |
Transmit queue length threshold at which the congestion priority is raised to level 2. |
P3QUE_LENGTH |
128 |
(p2Qlen + 2) through 1024 |
Transmit queue length threshold at which the congestion priority is raised to level 3. |
DISCARD_PRIORITY |
0 |
0 through 3 |
Congestion priority at which messages with priority below the current threshold are discarded rather than being queued and risking further congestion escalation. |
LINK_SLC |
0 |
0 through 15 |
Link selection code for signaling link testing. |
LINK_TEST_PATTERN |
TST |
1 through 15 ASCII characters |
Link test pattern for SLTM messages. |
TIMER_T1 |
10 |
0 through 65535 |
Time delay to avoid an out-of-sequence condition on changeover. |
TIMER_T2 |
10 |
0 through 65535 |
Time to wait for changeover acknowledgment. |
TIMER_T3 |
10 |
0 through 65535 |
Time delay to avoid an out-of-sequence condition on changeback. |
TIMER_T4 |
10 |
0 through 65535 |
Time to wait for first changeback acknowledgment (first attempt). |
TIMER_T5 |
10 |
0 through 65535 |
Time to wait for first changeback acknowledgment (second attempt). |
TIMER_T6 |
10 |
0 through 65535 |
Time delay to avoid an out-of-sequence condition on controlled rerouting. |
TIMER_T7 |
20 |
0 through 65535 |
Time to wait for data link connection acknowledgment. |
TIMER_T11 |
600 |
0 through 65535 |
Transfer restricted timer. |
TIMER_T12 |
12 |
0 through 65535 |
Time to wait for uninhibit acknowledgment. |
TIMER_T13 |
10 |
0 through 65535 |
Time to wait for forced uninhibit. |
TIMER_T14 |
30 |
0 through 65535 |
Time to wait for inhibit acknowledgment. |
TIMER_T17 |
10 |
0 through 65535 |
Time delay to avoid oscillation of initial alignment failure and link restart. |
TIMER_T22 |
1100 |
0 through 65535 |
Time to wait to repeat local inhibit test (ANSI T20 value). |
TIMER_T23 |
1100 |
0 through 65535 |
Time to wait to repeat remote inhibit test (ANSI T21 value). |
TIMER_T24 |
40 |
0 through 65535 |
Reserved for future use (not ANSI T24). |
TIMER_T31 |
50 |
0 through 65535 |
Internal BSN requested timer (not ANSI T31). |
TIMER_T32 |
100 |
0 through 65535 |
Time to wait for response to SLTM timer (ANSI T1.111.7 timer T1, not ANSI T32). |
TIMER_T33 |
200 |
0 through 65535 |
Signaling link connection timer (not ANSI T33). |
TIMER_T34 |
600 |
0 through 65535 |
Periodic signaling link test timer (ANSI T1.111.7 timer T2, not ANSI T34). |
TIMER_T40 |
30 |
1 through 65535 |
Time to wait for a bind confirmation from MTP 2 before sending another bind request. |
TIMER_T41 |
30 |
1 through 65535 |
Time to wait for a disconnect confirmation from MTP 2 before sending another disconnect request. |
TIMER_T42 |
30 |
1 through 65535 |
Time to wait for a flow control confirmation from MTP 2 before sending another flow control request. |
TIMER_T43 |
30 |
1 through 65535 |
Time to wait for a status confirmation from MTP 2 before sending another status request. |
TIMER_T44 |
30 |
1 through 65535 |
Time to wait for an unbind confirmation from MTP 2 before sending another unbind request. |
LINK_TRACE_DATA |
FALSE |
TRUE FALSE |
If TRUE, starts tracing of all data between MTP 2 and MTP 3 on this link. |
END |
N/A |
N/A |
Marks the end of this link definition. This parameter is required. |
All layer 2 timer values are specified in tenths of a second (60 = 6 seconds).
Parameter |
Default |
Valid values |
Description |
ERR_TYPE |
NORMAL |
NORMAL PCR |
Error correction method. NORMAL = normal PCR = preventive cyclic retransmission |
HS_LINK |
False |
TRUE FALSE |
Setting this parameter to TRUE, notifies MTP that high speed links are in effect and automatically sets HS_EXT_SEQ to TRUE. Set HS_EXT_SEQ to FALSE for high speed links with normal sequence numbers. Note: Layers 2 and 3 use this parameter. |
HS-EXT_SEQ |
False |
TRUE FALSE |
Setting this parameter to TRUE, notifies MTP that extended sequence numbers are in effect and changes the size of:
Sequence numbers increase from 7 to 12 bits and the length indicator increases from 6 to 8 bits. Setting HS_EXT_SEQ to TRUE automatically sets HS_LINK to TRUE. Normal speed links with extended sequence numbers are not supported. Note: Layers 2 and 3 use this parameter. |
L2_T1 |
130 (ANSI) 400 (ITU-T) |
1 through 65535 |
Timer aligned and ready. |
L2_T2 |
115 (ANSI) 100 (ITU-T) |
1 through 65535 |
Timer not aligned. |
L2_T3 |
115 (ANSI) 15 (ITU-T) |
1 through 65535 |
Timer aligned. |
L2_T4_N |
23 (ANSI) 82 (ITU-T) |
1 through 65535 |
Normal proving period. |
L2_T4_E |
6 (ANSI) 5 (ITU-T) |
1 through 65535 |
Emergency proving period. |
L2_T5 |
1 |
1 through 65535 |
Timer sending busy indications (SIBs). |
L2_T6 |
60 |
1 through 65535 |
Timer remote congestion. |
L2_T7 |
20 |
1 through 65535 |
Timer excessive delay of acknowledgement. |
L2_T10 |
30 |
1 through 65535 |
Amount of time MTP 2 can be isolated from a remote MTP 3 before sending processor outage (SIPO). |
L2_T11 |
20 |
1 through 65535 |
Time to wait for a flow control acknowledgement from MTP 3 before sending another flow control indication. |
L2_T12 |
20 |
1 through 65535 |
Time to wait for a status confirmation from MTP 3 before sending another status indication. |
L2_T13 |
20 |
1 through 65535 |
Time to wait for a disconnect confirmation from MTP 3 before sending another disconnect indication. |
LSSU_LEN |
2 |
1 through 2 |
LSSU length. |
MAX_FRAME |
272 |
64 through 1024 |
Maximum frame length for MSU. |
SUERM_THRESH |
64 |
1 through 255 |
Signal unit error rate monitor threshold (bad frames). |
SUERM_D_RATE |
256 |
1 through 65535 |
Signal unit error rate monitor decrement rate (frames). |
AERM_THRESH_E |
1 |
1 through 255 |
Alignment error rate monitor threshold (emergency alignment). |
AERM_THRESH_N |
4 |
1 through 255 |
Alignment error rate monitor threshold (normal alignment). |
MAX_RTB_MSGS |
127 |
1 through 255 |
Maximum number of MSUs for retransmission (only when using PCR error correction). |
MAX_RTB_OCTETS |
34544 |
1 through 65535 |
Maximum number of MSU octets for retransmission (only when using PCR error correction). |
MAX_PROV_ABORT |
5 |
1 through 255 |
Maximum number of proving failures. |
DATA_ENC |
NRZ |
NRZ NRZI |
Data encoding. |
SHARE_FLAGS |
TRUE |
TRUE FALSE |
If TRUE, allow a single flag to be shared between frames. |
USE_FLAGS |
TRUE |
TRUE FALSE |
If TRUE, use flags between frames. If FALSE, idle between frames. |
MIN_FLAGS |
0 |
0 through 15 |
Minimum number of additional flags between frames (in addition to shared flag). |
ISO_THRESH |
1000 |
1 through 65535 |
Number of messages queued to MTP 3 while isolated that cause MTP 2 to begin processor outage (SIPOs). |
L2_TXQ_THRESH1 |
50 |
1 through 65535 |
Transmission queue length at which the outbound flow control level is raised to one. |
L2_TXQ_THRESH1_A |
20 |
1 through 65535 |
Transmission queue length at which the outbound flow control level is lowered to zero. |
L2_TXQ_THRESH2 |
200 |
1 through 65535 |
Transmission queue length at which the outbound flow control level is raised to two. The subsequent indication causes MTP 3 to cease all transmission to MTP 2 until the flow control level returns to one or zero. |
L2_TXQ_THRESH2_A |
100 |
1 through 65535 |
Transmission queue length at which the outbound flow control level is lowered to one. |
L2_SAP_THRESH |
500 |
1 through 65535 |
Number of messages queued to MTP 3 while inbound flow control is in effect that cause MTP 2 to send busy indications (SIBs). |
L2_SAP_THRESH_A |
100 |
1 through 65535 |
Number of messages queued to MTP 3 while inbound flow control is in effect that cause MTP 2 to stop sending busy indications (SIBs). |
IDLE_FREQ |
0 |
1 through 65535 |
Frequency at which FISUs are sent by the software (in ms). Zero indicates that hardware constantly retransmits duplicate FISUs as is the norm. Switches that process all FISUs in the software (including duplicate FISUs) can use non-zero frequencies. |
RT_FREQ |
0 |
1 through 65535 |
Frequency at which other retransmitted SUs (LSSUs) are sent by the software (in ms). Zero indicates that hardware constantly retransmits duplicate LSSUs as is the norm. Switches that process all FISUs in the software (including duplicate FISUs) can use non-zero frequencies. |
END |
N/A |
N/A |
Marks the end of this link definition. This parameter is required. |
The following table lists the parameters used for defining an NSAP:
Parameter |
Default |
Valid values |
Description |
NSAP |
None |
0 through MAX_USERS - 1 |
NSAP number. This parameter is required. |
LINK_TYPE |
ANSI |
ANSI ITU JNTT JTTC |
MTP 3 protocol variant used by this MTP 3 user part. |
P0QUE_LENGTH |
0 |
2 through 1024 |
Receive queue length threshold at which the congestion priority is raised to level 0. |
P1QUE_LENGTH |
512 |
(p0Qlen + 2) through 1024 |
Receive queue length threshold at which the congestion priority is raised to level 1. |
P2QUE_LENGTH |
768 |
(p1Qlen + 2) through 1024 |
Receive queue length threshold at which the congestion priority is raised to level 2. |
P3QUE_LENGTH |
896 |
(p2Qlen + 2) through 1024 |
Receive queue length threshold at which the congestion priority is raised to level 3. |
DPC_LENGTH |
24 (ANSI) 14 (ITU-T) 16 (JNTT/JTTC) |
14 16 24 |
Number of bits in a point code. |
END |
N/A |
N/A |
Marks the end of this NSAP definition. This parameter is required. |
The following table lists the configurable parameters for an MTP 3 route entry:
Parameter |
Default |
Valid values |
Description |
ROUTE |
None |
0 through MAX_ROUTES |
Route identifier number. This parameter is required. |
DPC |
None |
N/A |
Point code that is the target of the route entry. Use dotted notation (such as 2.45.76) or a hexadecimal number (such as 0x101). |
OPC |
None |
N/A |
Originating point code. Use for multiple OPC emulation and OPC routing. Refer to Configuring multiple OPC emulation for more information. |
SPTYPE |
STP |
SP STP |
Destination signaling point type. |
LINK_TYPE |
ANSI |
ANSI ITU JNTT JTTC |
MTP 3 protocol variant associated with this route. |
SSF |
NATIONAL (ANSI) INTERNATIONAL (ITU-T) |
NATIONAL INTERNATIONAL |
Value for the sub-service field (SSF) to be used in route management messages for this route. |
SUB_SERVICE |
2 |
0 through 3 |
Overrides SSF parameter. Use either SUB_SERVICE or the SSF parameter. |
DIRECTION |
DOWN |
UP DOWN |
Route direction. Up routes result in messages being routed to user parts or applications on this node; Down routes are routes to remote signaling points. |
ADJACENT_ROUTE |
TRUE |
TRUE|YES FALSE|NO |
If TRUE, this is a route to an adjacent signaling point (a signaling point that is directly connected to this node). |
ADJACENT_CLUSTER |
FALSE |
TRUE|YES FALSE|NO |
If TRUE, this is a route to any cluster, enabling use of the cluster variant of route management messages (ANSI only). |
TIMER_T8 |
10 |
0 through 65535 |
Transfer prohibited inhibition timer. |
TIMER_T10 |
450 |
0 through 65535 |
Time to wait to start or repeat periodic route set test. |
TIMER_T19_ITU |
680 |
1 through 65535 |
ITU restart timer to avoid ping-pong of TFP, TFR, or TRA messages. |
TIMER_T21_ITU |
640 |
1 through 65535 |
Overall ITU restart timer at adjacent SP. |
TIMER_T25_ANSI |
320 |
1 through 65535 |
ANSI restart timer at adjacent SP waiting for a TRA message. |
TIMER_T28_ANSI |
300 |
1 through 65535 |
ANSI restart timer at adjacent SP waiting for a TRW message. |
TIMER_T29_ANSI |
630 |
1 through 65535 |
ANSI restart timer started when a TRA is sent in response to an unexpected TRA or TRW. |
TIMER_T30_ANSI |
320 |
1 through 65535 |
ANSI restart timer to limit sending of TFPs and TFRs in response to an unexpected TRA or TRW. |
END |
N/A |
N/A |
Marks the end of this route definition. This parameter is required. |
The following table lists the parameters for defining a linkset:
Parameter |
Default |
Valid values |
Description |
LINK_SET_DESCRIPTOR |
None |
1 through MAX_LINKSETS |
Linkset identifier number; referenced in LINK_SET parameter of each individual link. |
ADJACENT_DPC |
None |
N/A |
Point code of the adjacent SP that terminates this linkset. Use dotted notation (such as 2.45.76) or a hexadecimal number (such as 0x101). |
OPC |
None |
N/A |
Originating point code. Use for multiple OPC emulation and OPC routing. Refer to Configuring multiple OPC emulation for more information. |
MAX_ACTIVE_LINKS |
16 |
1 through 32 |
Target number of links in this linkset to keep active at any given time. |
ROUTE_NUMBER |
None (priority for a route |
0 through MAX_ROUTES |
Route number and optional priority associated with a destination that can be reached through this linkset. As many as 256 route numbers can be specified per linkset. The same route number can be assigned to multiple linksets. The optional priority associated with the route number is relative to other linksets that also contain this route number. |
END |
N/A |
N/A |
Marks the end of this linkset definition. This parameter is required. |