Parameter	Description
`-b` board	Board number to which the MTP 2 configuration is downloaded (default = 1).
`-f` filename	Name and location of the MTP 2 configuration file to be downloaded.

Keyword	Default Value	Range	Description
`LINK`	none	S1-S4, T1-T16	Starts link definition, assigns port to link
`LINK_TYPE`	ANSI	ANSI, ANSI88, or CCITT	Protocol variant
`ERR_TYPE`	NORMAL	NORMAL or PCR	Error correction method: Normal or Preventive Cyclic Retransmission (PCR not fully supported).
`L2_T1`	130 (ANSI) 400 (CCITT)	1..65535	T1 Timer "aligned/ready"
`L2_T2`	115 (ANSI) 100 (CCITT)	1..65535	T2 Timer "not aligned"
`L2_T3`	115 (ANSI) 15 (CCITT)	1..65535	T3 Timer "aligned"
`L2_T5`	1	1..65535	T5 Timer "sending SIB"
`L2_T6`	60	1..65535	T6 Timer "remote congestion"
`L2_T7`	20	1..65535	T7 Timer "excessive delay of acknowledgment"
`L2_T4_N`	23 (ANSI) 82 (CCITT)	1..65535	Normal proving period
`L2_T4_E`	6 (ANSI) 5 (CCITT)	1..65535	Emergency proving period
`LSSU_LEN`	2	1..2	LSSU length
`MAX_FRAME`	272	64..1024	Maximum frame length for MSU
`SUERM_THRESH`	64	1..255	Signal unit error rate monitor threshold (bad frames)
`SUERM_D_RATE`	256	1..65535	Signal unit error rate monitor decrement rate (frames)
`AERM_THRESH_E`	1	1..255	Alignment error rate monitor error rate threshold (emergency alignment)
`AERM_THRESH_N`	4	1..255	Alignment error rate monitor error rate threshold (normal alignment)
`MAX_RTB_MSGS`	30	1..255	Max # of MSUs for retransmission (when using PCR error correction only)
`MAX_RTB_OCTETS`	220	1..65535	Max # of MSUs octets for retransmission (when using PCR error correction only)
`MAX_PROV_ABORT`	5	1..255	Maximum # of proving failures
`BAUD`	56000	4800, 9600, 19200, 28800, 38400, 56000, 64000	Baud rate for serial ports only (in bits per second)
`INT_TYPE`	DTE	DTE or DCE	Interface type for serial ports only
`DATA_ENC`	NRZ	NRZ or NRZI	Data encoding (NRZ or NRZ inverted)
`SHARE_FLAGS`	TRUE	TRUE/FALSE	Allow single flag to be shared between frames
`USE_FLAGS`	TRUE	TRUE/FALSE	Use flags (True) or idles (False) between frames
`MIN_FLAGS`	0	0..15	Minimum number of additional flags between frames (in addition to shared flag)

Command	Description
`STATS` link	Retrieve the statistics for a particular link.
`STATUS` link	Retrieve status information for a particular link.
`MTP2FLOW` `ON` \| `OFF`	Turns MTP 2 flow control on/off.
`BOARD` board	Switches to a new target board.
`Q`	Quits the application.
`?` [COMMAND]	Lists available commands or parameters of a specified command (COMMAND).

(Page 1 of 1 in this chapter) Version

Chapter 4

MTP 2 Sample Applications

4.1 The MTP 2 Configuration Utility

: 4.1.1 Using the MTP 2 Configuration Utility
: 4.1.2 The MTP 2 Configuration File
: 4.1.3 MTP 2 Configuration Parameter Reference
: 4.1.4 Sample Configuration Files

4.2 The MTP 2 Manager Program

: 4.2.1 Using the MTP 2 Manager Program

4.3 The Sample Applications - MTP2APP and MTP2ITU

4.1 The MTP 2 Configuration Utility

The MTP 2 Configuration (mtp2cfg) utility scans the MTP 2 configuration text file (see Section 4.1.2) and downloads the configuration to the MTP 2 task on the TX board.

4.1.1 Using the MTP 2 Configuration Utility

Procedure

To run mtp2cfg: From the command line prompt, enter the following: mtp2cfg options where options include: Parameter Description -b board Board number to which the MTP 2 configuration is downloaded (default = 1). -f filename Name and location of the MTP 2 configuration file to be downloaded. The MTP 2 Configuration utility scans the information in the ASCII file (specified with the -f option) and downloads the information to the task on the TX board.

Notes

The following tables show the default assignment of ports to SS7 links for various board hardware configurations. In these tables, the following nomenclature is used:

S1, S2, , Sn refer to ports 1, 2, , n on the serial port adapter pod (V.35 or V.24/RS232).

T1, T2, , T16 refer to the Port1, Port2, , Port16 entries defined in the TDM configuration file for T1/E1/MVIP/H.100/H.110 channel timeslots assigned as SS7 links.

Figure 7. TX 2000 Default Port Assignments

Figure 8. TX 3000 Series Default Port Assignments
The following table shows the default attributes assigned to each link by the MTP 2 task at download time. If the default port assignments and link attributes are correct for your application, you need not run the mtp2cfg program at load time; otherwise, you must create a text configuration file and run the mtp2cfg utility to override these defaults. Attribute Default Value Description LINK_TYPE ANSI (1992) Protocol variant ERR_TYPE Normal Error correction method: Normal TIMER_T1 13.0 seconds T1 Timer "aligned/ready" TIMER_T2 11.5 seconds T2 Timer "not aligned" TIMER_T3 11.5 seconds T3 Timer "aligned" TIMER_T5 0.1 seconds T5 Timer "sending SIB" TIMER_T6 6.0 seconds T6 Timer "remote congestion" TIMER_T7 2.0 seconds T7 Timer "excessive delay of acknowledgment" TIMER_T4_N 2.3 seconds Normal proving period TIMER_T4_E 0.6 seconds Emergency proving period LSSU_LEN 2 LSSU length MAX_FRAME 272 Maximum frame length for MSU SUERM_THRESH 64 Signal unit error rate monitor threshold (bad frames) SUERM_D_RATE 256 Signal unit error rate monitor decrement rate (frames) AERM_THRESH_E 1 Alignment error rate monitor error rate threshold (emergency alignment) AERM_THRESH_N 4 Alignment error rate monitor error rate threshold (normal alignment) MAX_RTB_MSGS 30 Max # of MSUs for retransmission (when using PCR error correction only) MAX_RTB_OCTETS 220 Max # of MSUs octets for retransmission (when using PCR error correction only) MAX_PROV_ABORT 5 Maximum # of proving failures BAUD 56 Kbps Baud rate for serial ports only INT_TYPE DTE Interface type (DCE/DTE) for serial ports DATA_ENC NRZ Data encoding (NRZ/NRZI) SHARE_FLAGS TRUE Allow single flag to be shared between frames USE_FLAGS TRUE Use flags (True) or idles (False) between frames MIN_FLAGS 0 Minimum number of additional flags between frames (in addition to shared flag)

Attribute	Default Value	Description
`LINK_TYPE`	ANSI (1992)	Protocol variant
`ERR_TYPE`	Normal	Error correction method: Normal
`TIMER_T1`	13.0 seconds	T1 Timer "aligned/ready"
`TIMER_T2`	11.5 seconds	T2 Timer "not aligned"
`TIMER_T3`	11.5 seconds	T3 Timer "aligned"
`TIMER_T5`	0.1 seconds	T5 Timer "sending SIB"
`TIMER_T6`	6.0 seconds	T6 Timer "remote congestion"
`TIMER_T7`	2.0 seconds	T7 Timer "excessive delay of acknowledgment"
`TIMER_T4_N`	2.3 seconds	Normal proving period
`TIMER_T4_E`	0.6 seconds	Emergency proving period
`LSSU_LEN`	2	LSSU length
`MAX_FRAME`	272	Maximum frame length for MSU
`SUERM_THRESH`	64	Signal unit error rate monitor threshold (bad frames)
`SUERM_D_RATE`	256	Signal unit error rate monitor decrement rate (frames)
`AERM_THRESH_E`	1	Alignment error rate monitor error rate threshold (emergency alignment)
`AERM_THRESH_N`	4	Alignment error rate monitor error rate threshold (normal alignment)
`MAX_RTB_MSGS`	30	Max # of MSUs for retransmission (when using PCR error correction only)
`MAX_RTB_OCTETS`	220	Max # of MSUs octets for retransmission (when using PCR error correction only)
`MAX_PROV_ABORT`	5	Maximum # of proving failures
`BAUD`	56 Kbps	Baud rate for serial ports only
`INT_TYPE`	`DTE`	Interface type (DCE/DTE) for serial ports
`DATA_ENC`	`NRZ`	Data encoding (NRZ/NRZI)
`SHARE_FLAGS`	`TRUE`	Allow single flag to be shared between frames
`USE_FLAGS`	`TRUE`	Use flags (True) or idles (False) between frames
`MIN_FLAGS`	0	Minimum number of additional flags between frames (in addition to shared flag)

4.1.2 The MTP 2 Configuration File

The MTP 2 configuration file is a simple text file with the following general format. LINK <port ID> # link 0 definition PARAMETER_ KEYWORD <value> # comment PARAMETER_ KEYWORD <value> # comment END # end link 0 definition . . . LINK <port ID> # link N definition PARAMETER_ KEYWORD <value> # comment PARAMETER_ KEYWORD <value> # comment END # end link 0 definition
The first link defined in the MTP 2 configuration file is always link 0. The second is always link 1, and so on.

4.1.3 MTP 2 Configuration Parameter Reference

The following table lists the available MTP 2 link configuration parameters, their default values, and allowed range. All parameters are optional (default values shown in the table) except the LINK keyword/port assignment and the terminating END statement. Note: All timer values are in tenths of seconds (130 = 13.0 seconds). Keyword Default Value Range Description LINK none S1-S4, T1-T16 Starts link definition, assigns port to link LINK_TYPE ANSI ANSI, ANSI88, or CCITT Protocol variant ERR_TYPE NORMAL NORMAL or PCR Error correction method: Normal or Preventive Cyclic Retransmission (PCR not fully supported). L2_T1 130 (ANSI) 400 (CCITT) 1..65535 T1 Timer "aligned/ready" L2_T2 115 (ANSI) 100 (CCITT) 1..65535 T2 Timer "not aligned" L2_T3 115 (ANSI) 15 (CCITT) 1..65535 T3 Timer "aligned" L2_T5 1 1..65535 T5 Timer "sending SIB" L2_T6 60 1..65535 T6 Timer "remote congestion" L2_T7 20 1..65535 T7 Timer "excessive delay of acknowledgment" L2_T4_N 23 (ANSI) 82 (CCITT) 1..65535 Normal proving period L2_T4_E 6 (ANSI) 5 (CCITT) 1..65535 Emergency proving period LSSU_LEN 2 1..2 LSSU length MAX_FRAME 272 64..1024 Maximum frame length for MSU SUERM_THRESH 64 1..255 Signal unit error rate monitor threshold (bad frames) SUERM_D_RATE 256 1..65535 Signal unit error rate monitor decrement rate (frames) AERM_THRESH_E 1 1..255 Alignment error rate monitor error rate threshold (emergency alignment) AERM_THRESH_N 4 1..255 Alignment error rate monitor error rate threshold (normal alignment) MAX_RTB_MSGS 30 1..255 Max # of MSUs for retransmission (when using PCR error correction only) MAX_RTB_OCTETS 220 1..65535 Max # of MSUs octets for retransmission (when using PCR error correction only) MAX_PROV_ABORT 5 1..255 Maximum # of proving failures BAUD 56000 4800, 9600, 19200, 28800, 38400, 56000, 64000 Baud rate for serial ports only (in bits per second) INT_TYPE DTE DTE or DCE Interface type for serial ports only DATA_ENC NRZ NRZ or NRZI Data encoding (NRZ or NRZ inverted) SHARE_FLAGS TRUE TRUE/FALSE Allow single flag to be shared between frames USE_FLAGS TRUE TRUE/FALSE Use flags (True) or idles (False) between frames MIN_FLAGS 0 0..15 Minimum number of additional flags between frames (in addition to shared flag)

4.1.4 Sample Configuration Files

A sample ANSI configuration file for a 2 link configuration is shown below. For illustration, the sample configuration file shown below (and those with the distribution software) show all relevant parameters listed, even those for which the default values are not changed. A more typical configuration file would list only those parameters whose values are being changed from the defaults. # #--- MTP2 link parameters #=========================== # Link 0 - serial (v.35) #=========================== LINK S1 # V.35 Serial Port 1 LINK_TYPE ANSI ERR_TYPE NORMAL L2_T1 130 L2_T2 115 L2_T3 115 L2_T4_N 23 L2_T4_E 6 L2_T5 1 L2_T6 60 L2_T7 20 LSSU_LEN 2 MAX_FRAME 272 SUERM_D_RATE 256 SUERM_THRESH 64 AERM_THRESH_N 4 AERM_THRESH_E 1 MAX_PROV_ABORT 5 #--- MTP1 link parameters BAUD 64000 INT_TYPE DCE DATA_ENC NRZ USE_FLAGS TRUE MIN_FLAGS 0 SHARE_FLAGS TRUE END #======================================== # Link 1 - TDM (from T1/E1 daughter card #======================================== LINK T1 # Port1 from TDM cfg file LINK_TYPE ANSI ERR_TYPE NORMAL L2_T1 130 L2_T2 115 L2_T3 115 L2_T4_N 23 L2_T4_E 6 L2_T5 1 L2_T6 60 L2_T7 20 LSSU_LEN 2 MAX_FRAME 272 SUERM_D_RATE 256 SUERM_THRESH 64 AERM_THRESH_N 4 AERM_THRESH_E 1 MAX_PROV_ABORT 5 #--- MTP1 link parameters USE_FLAGS TRUE MIN_FLAGS 0 SHARE_FLAGS TRUE END

4.2 The MTP 2 Manager Program

After downloading the MTP 2 configuration to the TX board with mtp2cfg, run the MTP 2 Manager (mtp2mgr) program to monitor the status of the MTP 2 layer. The MTP 2 Manager provides a command line interface from which statistics can be viewed.

4.2.1 Using the MTP 2 Manager Program

Name

mtp2mgr

Purpose

Monitors and manages the status of the MTP 2 layer.

Usage

mtp2mgr -b board

Prerequisites

Requires a single computer with a TX 2000, TX 3000, TX 3220, or TX 3220C board installed, in addition to the following software: · Windows NT 4.0, Intel Solaris 2.6 or 7, SPARC Solaris 2.6 or 7 · Natural Access 1999-4 or later

Procedure

To run mtp2mgr: From the command line prompt, enter the following: mtp2mgr -b board where board is the TX board number to open. The mtp2mgr program supports the following commands: Command Description STATS link Retrieve the statistics for a particular link. STATUS link Retrieve status information for a particular link. MTP2FLOW ON | OFF Turns MTP 2 flow control on/off. BOARD board Switches to a new target board. Q Quits the application. ? [COMMAND] Lists available commands or parameters of a specified command (COMMAND).

Notes

Here are sample outputs from mtp2mgr sessions:

mtp2mgr[1]>stats link 0 Level 2 Stats: inService = 0 lclBusy = 0 s1FailAll = 0 s1FailAb = 0 s1FailAck = 0 s1FailErr = 0 s1FailCong = 0 s1FailAlign = 0 s1NSUErr = 0 s1NegAck = 0 nRetrans = 0 Msg: Rx Tx Msg: Rx Tx ---- -- -- ---- -- -- SIF/SIO 0 0 MSU 0 0 LSSU* 0 0 FISU* 0 0 * These counts do not include frames filtered by the firmware.
A description of each of the statistics follows:

Statistic

Description

inService

The amount of time (in 1/10's of a second) that the link has been in service (aligned).

lclBusy

The amount of time (in 1/10's of a second) that the link has been in congestion.

slFailAb

The number of bad sequence numbers in received frames.

slFailAck

The number of times an acknowledgment was not received within the T7 timeout.

slFailErr

The number of link failures due to the SUERM threshold being reached.

slFailCong

The number of link failures due to the T5 congestion timer expiring.

slFailAlign

The number of alignment failures due to T2 expiration.

slFailAll

The total number of link failures due to the above link failure reasons.

slNSUErr

Not used.

slNegAck

The number of negative acknowledgments received.

nRetrans

The number of retransmissions performed.

SIF/SIO Tx

The number of SIO frames sent during alignment (normal error checking).

SIF/SIO Rx

The number of SIO frames received during alignment (both normal and PCR error checking).

MSU Tx/Rx

The number of message signal units transmitted and received.

LSSU Tx/Rx

The number of LSSU's transmitted and received. Counts do not include frames filtered by the firmware.

FISU Tx/Rx

The number of FISU's transmitted and received. Counts do not include frames filtered by the firmware.

mtp2mgr[1]>status link 0 MTP2 Board 1, Link 0: High lvl state = DISABLED Frames out = 0 Frames dropped = 0 Low lvl state = POWER_OFF ---- Current Link (0) Layer 2 configuration ---- maxFrmLen = 272 cfmType = 0 congDisc = 0 errType = NORMAL 1ssuLen = 2 SUERMD rate = 256 SUERM Thrsh = 64 AERM Thrsh N = 4 AERM Thrsh E = 1 Max RTB Msg = 30 Max RTB Oct = 220 Max Prov Abt = 5 L2 t1 = 130 L2 t2 = 120 L2 t3 = 120 L2 t4 norm = 23 L2 t4 emrg = 6 L2 t5 = 1 L2 t6 = 59 L2 t7 = 20
A description of the status fields is provided:
High lvl state is one of the following: Field Description UNBOUND Initial state CONFIGURED Link has been configured. Still unbound. DISABLED Upper layer (MTP 3) has bound but not connected. ENABLED Upper layer (MTP 3) has bound and connected successfully to a peer MTP 2.
Low lvl state is one of the following: Field Description UNUSED Default to unused. OUT_OF_SERVICE Link out of service INITIAL_ALIGNMENT Link in initial alignment ALIGNED_READY Link aligned and ready ALIGNED_NOT_READY Link aligning and not ready PROC_OUT Processor outage detected IN_SERVICE Link in service - data state IDLE Link idling - data state NOT_ALIGNED Link not yet aligned IS_ALIGNED Link is aligned PROVING Link is in initial proving phase LOCAL_PROC_OUT Local processor outage - level 3 REMOTE_PROC_OUT Remote processor outage - level 3 BOTH_PROC_OUT Both processors outage - level 3 MONITORING Link monitoring CONGESTION Link congested - level 2 POWER_OFF Power off state
Frames out Number of frames outstanding to layer 1 (transmission not yet complete by layer 1).
Frames dropped Number of transmitted frames dropped due to level 1 transmit errors.

Statistic	Description
`inService`	The amount of time (in 1/10's of a second) that the link has been in service (aligned).
`lclBusy`	The amount of time (in 1/10's of a second) that the link has been in congestion.
`slFailAb`	The number of bad sequence numbers in received frames.
`slFailAck`	The number of times an acknowledgment was not received within the T7 timeout.
`slFailErr`	The number of link failures due to the SUERM threshold being reached.
`slFailCong`	The number of link failures due to the T5 congestion timer expiring.
`slFailAlign`	The number of alignment failures due to T2 expiration.
`slFailAll`	The total number of link failures due to the above link failure reasons.
`slNSUErr`	Not used.
`slNegAck`	The number of negative acknowledgments received.
`nRetrans`	The number of retransmissions performed.
`SIF/SIO Tx`	The number of SIO frames sent during alignment (normal error checking).
`SIF/SIO Rx`	The number of SIO frames received during alignment (both normal and PCR error checking).
`MSU Tx/Rx`	The number of message signal units transmitted and received.
`LSSU Tx/Rx`	The number of LSSU's transmitted and received. Counts do not include frames filtered by the firmware.
`FISU Tx/Rx`	The number of FISU's transmitted and received. Counts do not include frames filtered by the firmware.

Field	Description
`UNBOUND`	Initial state
`CONFIGURED`	Link has been configured. Still unbound.
`DISABLED`	Upper layer (MTP 3) has bound but not connected.
`ENABLED`	Upper layer (MTP 3) has bound and connected successfully to a peer MTP 2.

Field	Description
`UNUSED`	Default to unused.
`OUT_OF_SERVICE`	Link out of service
`INITIAL_ALIGNMENT`	Link in initial alignment
`ALIGNED_READY`	Link aligned and ready
`ALIGNED_NOT_READY`	Link aligning and not ready
`PROC_OUT`	Processor outage detected
`IN_SERVICE`	Link in service - data state
`IDLE`	Link idling - data state
`NOT_ALIGNED`	Link not yet aligned
`IS_ALIGNED`	Link is aligned
`PROVING`	Link is in initial proving phase
`LOCAL_PROC_OUT`	Local processor outage - level 3
`REMOTE_PROC_OUT`	Remote processor outage - level 3
`BOTH_PROC_OUT`	Both processors outage - level 3
`MONITORING`	Link monitoring
`CONGESTION`	Link congested - level 2
`POWER_OFF`	Power off state

4.3 The Sample Applications - MTP2APP and MTP2ITU

There are sample applications included on the release disk that illustrate use of the MTP 2 stand alone task. Both programs exercise the MTP 2 task on the TX board. mtp2app is for ANSI links, and mtp2itu is for ITU-T links.
There are several command line parameters for the sample applications. Parameter Description Default ITU Default ANSI -s sio Service Information Octet for sent SLTM's 0xB1 0xB2 -b board board number 1 1 -o opc Local point code 1 1.1.1 -d dpc Adjacent point code 2 1.1.2
At startup, the sample applications attempt to bind to links 0 through 3. If some of these fail, the programs will still execute properly on the available links. The programs start in monitor mode, printing out to the screen whenever an MTP 2 event is received. In monitor mode, if a SLTM is received, a SLTA is transmitted automatically. Also in monitor mode, if links 0 and 1 are connected and a disconnect indication is received for one of those links, then a changeover is performed automatically to the other link.
In order to enter command mode in these programs, hit <enter> to display the following prompt:
Command?>
Hit <enter> again to exit command mode and enter back into monitor mode. Both applications support identical commands:

Command

Description

connect link

Connect normal mode: levels 1+2.

econn link

Connect emergency mode: levels 1+2.

powconn link

Place link in power-on state.

disconn link

Disconnect the link.

send link

Send an SLTM on the link.

status link [start | end | up | down]

Set status conditions on specified link. Options include:
· start - Start emergency state
· end - End emergency state
· up - Local processor up
· down - Local processor down

flow link [ on | off ]

Turn MTP 2 flow control for specified link on/off.

Q

Quit the MTP 2 sample application.

?

List the commands supported.

Command?>connect 0 Link 0:Connecting Link 0:Disconnect Indication received - reason 2 Command?>connect 0 Link 0:Connecting Link 0:Connect Confirmation received Link 0:Received SLTM, sending SLTA in response Link 0:Data Confirmation received acking 1 messages Command?>send 0 Link 0:Sending a SLTM Link 0:Data Confirmation received acking 1 messages Link 0:Received a correct SLTA Command?>q
The sample applications attempt to bind with four links. If you have less than four links defined, the following alarm will be visible in txalarm output: <12/05/1997 15:51:58> mtp 1 13191 Internal Error [4] Note: The application will still execute properly on the existing links.

Parameter	Description	Default ITU	Default ANSI
`-s` sio	Service Information Octet for sent SLTM's	0xB1	0xB2
`-b` board	board number	1	1
`-o` opc	Local point code	1	1.1.1
`-d` dpc	Adjacent point code	2	1.1.2

Command	Description
`connect` link	Connect normal mode: levels 1+2.
`econn` link	Connect emergency mode: levels 1+2.
`powconn` link	Place link in power-on state.
`disconn` link	Disconnect the link.
`send` link	Send an SLTM on the link.
`status` link [`start` \| `end` \| `up` \| `down`]	Set status conditions on specified link. Options include: · `start` - Start emergency state · `end` - End emergency state · `up` - Local processor up · `down` - Local processor down
`flow` link [ `on` \| `off` ]	Turn MTP 2 flow control for specified link on/off.
`Q`	Quit the MTP 2 sample application.
`?`	List the commands supported.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com