(Page 1 of 1 in this chapter) Version

Chapter 3

Configuration and Performance Optimization

3.1 Introduction

3.2 Maximizing Ports For Fax Transmission

3.3 Maximizing Universal Ports

3.4 Supporting All Ports on the Board

3.5 System CPU Load Test Examples

: 3.5.1 AG Board Example
: 3.5.2 QX 2000 Board Example

3.1 Introduction

This chapter explains how to use the AG boards in your system to optimize a NaturalFax application's performance. NaturalFax is supported on the following NMS boards: AG-8/80 AG-8/80 DSP AG-T1 AG-E1 AG-T1 v2 AG-E1 v2 AG Quad E AG Quad T QX 2000 (Windows NT only) AG 2000/200, AG 2000/400 (NaturalFax is not supported on AG 2000/100 hardware.) AG 4000/800, AG 4000/1600, AG 4000/3200, AG 4000/4000 AG-24+, AG-30, AG-48, AG-60
An NMS board's DSP resources can support a combination of IVR, fax transmit, and fax receive operations. IVR operations include basic CT Access telephony functionality such as voice play and record, tone detection, and tone generation. You can control DSP resource allocation for a particular board by editing its configuration in the AG configuration file.
Hardware-related performance is measured by the available: Ports per board Number and type of operations that can be run per port
Use one of the following strategies to make the most efficient use of board resources, as appropriate to the design and purpose of the application: Maximize the number of ports that can run IVR and fax transmit operations. Maximize the number of universal ports on a board. A universal port is a port that can use any combination of IVR or fax functions. If a system is configured for universal ports, the application can use any combination of IVR functions such as voice play, voice record, tone detection, and tone generation with fax transmit or fax receive functions. Alternating between IVR and fax functions within a single phone call is supported in a universal port configuration. Note: Universal port does not include speech vocoding functions in the context of this manual. Support all ports on a board
All of the configurations presented in the following sections have been load tested without echo cancellation, using NMS speech encoding for voice functions. If your application requires a different use of DSP resources (e.g., adding echo cancellation or using different speech encoding), you may achieve different performance results.
Refer to the appropriate sample configuration files, as listed in each table, for detailed comments and specific configuration statements to achieve the desired performance.
In some configurations, a board's DSP resources cannot support an application that uses all the ports on the board; some ports must be left idle. If the number of operations performed exceed the board's ability to support them, an NFXEVN_SESSION_DONE event is returned with the reason CTAERR_OUT_OF_RESOURCES.
Test your application carefully using the number of ports and the functionality that it will use during normal operation to ensure you have sufficient DSP resources and host CPU resources.
If you are using AG hardware, refer to the AG Runtime Configuration and Developer's Manual for further information on ADI service DSP requirements. Refer to Appendix F of this manual for further information on NaturalFax DSP requirements on AG boards.

3.2 Maximizing Ports For Fax Transmission

The following table shows the maximum number of ports that support IVR and fax transmit operations for each AG board. It also lists the appropriate example AG configuration files.
This strategy provides the highest number of ports per board that support fax transmit operations, but all ports may not support all operations. Some of the hardware configurations listed can support only IVR and fax transmit operations and cannot support fax receive operations on any ports. If you need fax receive capability, refer to Section 3.3 and Section 3.4. Maximum Fax Transmit Operations per Board Configuration file for: Board Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 24 IVR and Fax Transmit only agt1fax.cfg None AG-E1 30 IVR and Fax Transmit only None age1fxtx.cfg AG-T1 v2 24 None agt1fax.cfg None AG-E1 v2 30 None None age1fax.cfg AG Dual T, AG Quad T 50 IVR and Fax Transmit only agqtfax.cfg None AG Dual E AG Quad E 50 IVR and Fax Transmit only None agqefax.cfg AG 2000/200 8 None ag2fax.cfg ag2faxa.cfg AG 2000/400 ¹ 16 None ag2fax4.cfg ag2fax4a.cfg AG 4000/800 30 None ag4dpfx.cfg ag4dpfxa.cfg AG 4000/1600 60 None ag4fax.cfg ag4faxa.cfg AG 4000/3200 120 None ag4dfax.cfg ag4dfaxa.cfg QX 2000 4 None Not required Not required AG-24+ 24 IVR and Fax Transmit only ag24fax.cfg ag24faxa.cfg AG-30 30 IVR and Fax Transmit only ag30fax.cfg ag30faxa.cfg AG-48 48 IVR and Fax Transmit only ag48fxtx.cfg ag48fxta.cfg AG-60 50 IVR and Fax Transmit only ag60fxtx.cfg ag60fxta.cfg ¹ The AG 2000/400 board provides DSPs for up to 16 ports of IVR and fax, but only eight line interfaces. Eight additional line interfaces must be provided with additional hardware.

Maximum Fax Transmit Operations per Board	Configuration file for:
Board	Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	24	IVR and Fax Transmit only	`agt1fax.cfg`	None
AG-E1	30	IVR and Fax Transmit only	None	`age1fxtx.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None
AG-E1 v2	30	None	None	`age1fax.cfg`
AG Dual T, AG Quad T	50	IVR and Fax Transmit only	`agqtfax.cfg`	None
AG Dual E AG Quad E	50	IVR and Fax Transmit only	None	`agqefax.cfg`
AG 2000/200	8	None	`ag2fax.cfg`	`ag2faxa.cfg`
AG 2000/400 ¹	16	None	`ag2fax4.cfg`	`ag2fax4a.cfg`
AG 4000/800	30	None	`ag4dpfx.cfg`	`ag4dpfxa.cfg`
AG 4000/1600	60	None	`ag4fax.cfg`	`ag4faxa.cfg`
AG 4000/3200	120	None	`ag4dfax.cfg`	`ag4dfaxa.cfg`
QX 2000	4	None	Not required	Not required
AG-24+	24	IVR and Fax Transmit only	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	30	IVR and Fax Transmit only	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	48	IVR and Fax Transmit only	`ag48fxtx.cfg`	`ag48fxta.cfg`
AG-60	50	IVR and Fax Transmit only	`ag60fxtx.cfg`	`ag60fxta.cfg`

3.3 Maximizing Universal Ports

The following table shows the maximum number of universal ports that each board can support. It also lists the appropriate example configuration files.
Universal ports can run any IVR or fax operation. In some configurations, using the maximum number of universal ports does not permit any of remaining ports to be used. Under these conditions, each available port can support all operations, but all ports on the board may not be available. This strategy provides the best functionality per port.
For fax-only applications which do not require any IVR functions, use the universal port configuration files and number of ports/board guidelines in this section. Maximum Universal (Fax and IVR) Ports per Board Configuration file for: Board Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 20 Remaining ports must be unused. agt1fax.cfg None AG-E1 20 Remaining ports must be unused. None age1fax.cfg AG-T1 v2 24 None agt1fax.cfg None AG-E1 v2 30 None None age1fax.cfg AG Dual T AG Quad T 45 Remaining ports must be unused. agqtfax.cfg None AG Dual E AG Quad E 45 Remaining ports must be unused. None agqefax.cfg AG 2000/200 8 None ag2fax.cfg ag2faxa.cfg AG 2000/400 ¹ 16 None ag2fax4.cfg ag2fax4a.cfg AG 4000/800 30 None ag4dpfx.cfg ag4dpfxa.cfg AG 4000/1600 60 None ag4fax.cfg ag4faxa.cfg AG 4000/3200 120 None ag4dfax.cfg ag4dfaxa.cfg QX 2000 4 None Not required Not required AG-24+ 20 Remaining ports must be unused. ag24fax.cfg ag24faxa.cfg AG-30 20 Remaining ports must be unused. ag30fax.cfg ag30faxa.cfg AG-48 40 Remaining ports must be unused. ag48fax.cfg ag48faxa.cfg AG-60 40 Remaining ports must be unused. ag60fax.cfg ag60faxa.cfg ¹ The AG 2000/400 board provides DSPs for up to 16 ports of IVR and fax, but only eight line interfaces. Eight additional line interfaces must be provided with additional hardware.
For example, for an application requiring two full T1 spans running IVR, fax transmit, and fax receive operations, you would need two AG-T1 boards and an AG-8/80 DSP board. The AG-T1 boards each provide 24 telephone channels and DSP resources for 20 ports of fax and IVR operations. The AG-8/80 DSP board provides the DSP resources for 8 additional ports of fax and IVR operations. Another way to support two full T1 spans of IVR and fax functions is to use two AG-T1 v2 boards. Select the appropriate configurations based on your application needs and the available hardware in each system.

Maximum Universal (Fax and IVR) Ports per Board	Configuration file for:
Board	Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	20	Remaining ports must be unused.	`agt1fax.cfg`	None
AG-E1	20	Remaining ports must be unused.	None	`age1fax.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None
AG-E1 v2	30	None	None	`age1fax.cfg`
AG Dual T AG Quad T	45	Remaining ports must be unused.	`agqtfax.cfg`	None
AG Dual E AG Quad E	45	Remaining ports must be unused.	None	`agqefax.cfg`
AG 2000/200	8	None	`ag2fax.cfg`	`ag2faxa.cfg`
AG 2000/400 ¹	16	None	`ag2fax4.cfg`	`ag2fax4a.cfg`
AG 4000/800	30	None	`ag4dpfx.cfg`	`ag4dpfxa.cfg`
AG 4000/1600	60	None	`ag4fax.cfg`	`ag4faxa.cfg`
AG 4000/3200	120	None	`ag4dfax.cfg`	`ag4dfaxa.cfg`
QX 2000	4	None	Not required	Not required
AG-24+	20	Remaining ports must be unused.	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	20	Remaining ports must be unused.	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	40	Remaining ports must be unused.	`ag48fax.cfg`	`ag48faxa.cfg`
AG-60	40	Remaining ports must be unused.	`ag60fax.cfg`	`ag60faxa.cfg`

3.4 Supporting All Ports on the Board

The following table shows the configurations for supporting all ports on a board. It also lists the appropriate example AG configuration files.
In some configurations, fax operations are only allowed on a subset of the ports. This strategy provides the highest number of available ports per board, but each port may not support all operations. Supporting All Ports per Board Configuration file for: Board Ports Restrictions mu-law A-law AG-8/80 8 None ag8fax.cfg ag8faxa.cfg AG-T1 15 9 IVR, Fax Transmit, Fax Receive IVR only agt1fax.cfg None. AG-E1 4 26 IVR, Fax Transmit, Fax Receive IVR only None. age1fax.cfg AG-T1 v2 24 None agt1fax.cfg None. AG-E1 v2 30 None None. age1fax.cfg AG 2000/200 8 None ag2fax.cfg ag2faxa.cfg AG 2000/400 ¹ 16 None ag2fax4.cfg ag2fax4a.cfg AG 4000/800 30 None ag4dpfx.cfg ag4dpfxa.cfg AG 4000/1600 72 None ag4fax.cfg ag4faxa.cfg AG 4000/3200 120 None ag4dfax.cfg ag4dfaxa.cfg QX 2000 4 None. Not required. Not required. AG-24+ 15 9 IVR, Fax Transmit, Fax Receive IVR only ag24fax.cfg ag24faxa.cfg AG-30 4 26 IVR, Fax Transmit, Fax Receive IVR only ag30fax.cfg ag30faxa.cfg AG-48 30 18 IVR, Fax Transmit, Fax Receive IVR only ag48fax.cfg ag48faxa.cfg AG-60 8 52 IVR, Fax Transmit, Fax Receive IVR only ag60ivf.cfg ag60ivfa.cfg ¹ The AG 2000/400 board provides DSPs for up to 16 ports of IVR and fax, but only eight line interfaces. Eight additional line interfaces must be provided with additional hardware.
For example, for an application supporting a full T1 span, your application may use any combination of IVR and fax functions on the first 15 ports on the AG-T1 board. Your application must restrict the remaining 9 ports to use only IVR functions to ensure that enough DSP resources are available for each port.
On an AG-T1 v2 board, your application can use any combination of IVR and fax functions on all 24 ports without any restrictions.

Supporting All Ports per Board	Configuration file for:
Board	Ports	Restrictions	mu-law	A-law
AG-8/80	8	None	`ag8fax.cfg`	`ag8faxa.cfg`
AG-T1	15 9	IVR, Fax Transmit, Fax Receive IVR only	`agt1fax.cfg`	None.
AG-E1	4 26	IVR, Fax Transmit, Fax Receive IVR only	None.	`age1fax.cfg`
AG-T1 v2	24	None	`agt1fax.cfg`	None.
AG-E1 v2	30	None	None.	`age1fax.cfg`
AG 2000/200	8	None	`ag2fax.cfg`	`ag2faxa.cfg`
AG 2000/400 ¹	16	None	`ag2fax4.cfg`	`ag2fax4a.cfg`
AG 4000/800	30	None	`ag4dpfx.cfg`	`ag4dpfxa.cfg`
AG 4000/1600	72	None	`ag4fax.cfg`	`ag4faxa.cfg`
AG 4000/3200	120	None	`ag4dfax.cfg`	`ag4dfaxa.cfg`
QX 2000	4	None.	Not required.	Not required.
AG-24+	15 9	IVR, Fax Transmit, Fax Receive IVR only	`ag24fax.cfg`	`ag24faxa.cfg`
AG-30	4 26	IVR, Fax Transmit, Fax Receive IVR only	`ag30fax.cfg`	`ag30faxa.cfg`
AG-48	30 18	IVR, Fax Transmit, Fax Receive IVR only	`ag48fax.cfg`	`ag48faxa.cfg`
AG-60	8 52	IVR, Fax Transmit, Fax Receive IVR only	`ag60ivf.cfg`	`ag60ivfa.cfg`

3.5 System CPU Load Test Examples

The following tables provide examples of host CPU loading. Use this information to estimate how a fax application will affect your host system's resources. The percentage of CPU resources used will vary from the statistics presented here depending on the image size, format, and resolution of the documents used in your fax application, your host system's configuration, and according to any other processing that occurs during NaturalFax processing.

3.5.1 AG Board Example

The following statistics were taken from tests performed on a system with AG boards and a Pentium II 300 MHz with 64 MB of RAM. Conversion Enabled indicates that all ports were performing on-the-fly conversions. ECM Enabled indicates that all ports were using Error Correction Mode: Total Number of Ports Number of Transmit Ports Number of Receive Ports Conversion Enabled ECM Enabled System CPU Usage 60 30 30 No No 12 % 60 30 30 Yes No 20 % 60 30 30 No Yes 13 % 60 30 30 Yes Yes 21 % 90 45 45 No No 17 % 90 45 45 Yes No 28% 90 45 45 No Yes 18% 90 45 45 Yes Yes 30 % 120 60 60 No No 20 % 120 60 60 Yes No 34 % 120 60 60 No Yes 24 % 120 60 60 Yes Yes 38 %

Total Number of Ports	Number of Transmit Ports	Number of Receive Ports	Conversion Enabled	ECM Enabled	System CPU Usage
60	30	30	No	No	12 %
60	30	30	Yes	No	20 %
60	30	30	No	Yes	13 %
60	30	30	Yes	Yes	21 %
90	45	45	No	No	17 %
90	45	45	Yes	No	28%
90	45	45	No	Yes	18%
90	45	45	Yes	Yes	30 %
120	60	60	No	No	20 %
120	60	60	Yes	No	34 %
120	60	60	No	Yes	24 %
120	60	60	Yes	Yes	38 %

3.5.2 QX 2000 Board Example

The following table presents the host load test results from QX 2000-based systems with a Pentium 200 MHz processor with 64 MB of RAM:

Number of Ports

Number of Transmit Ports

Number of Receive Ports

Modem

Rate

Conversion Enabled

ECM Enabled

System CPU Usage

4

2

2

V.29

9.6

No

No

1.1 %

4

2

2

V.29

9.6

Yes **

Yes

2.5 %

4

2

2

V.17

14.4

No

No

2 %

4

2

2

V.17

14.4

Yes *

Yes

3.7 %

4

2

2

V.17

14.4

Yes **

Yes

4 %

32

16

16

V.17

14.4

No

No

28.5 %

32

16

16

V.29

9.6

No

Yes

21.5 %

32

16

16

V.29

9.6

No

Yes

21.5 %

32

16

16

V.29

9.6

Yes *

No

37.8 %

32

16

16

V.17

14,4

Yes *

No

53 %

32

16

16

V.29

9.6

Yes *

Yes

36 %

32

16

16

V.29

9.6

Yes **

Yes

56 %

* Conversions from A3 to A4, Low to SuperHigh, 1D to 2D
** Conversions from A3 to A4, Low to SuperHigh, 1D to MMR

Number of Ports	Number of Transmit Ports	Number of Receive Ports	Modem	Rate	Conversion Enabled	ECM Enabled	System CPU Usage
4	2	2	V.29	9.6	No	No	1.1 %
4	2	2	V.29	9.6	Yes **	Yes	2.5 %
4	2	2	V.17	14.4	No	No	2 %
4	2	2	V.17	14.4	Yes *	Yes	3.7 %
4	2	2	V.17	14.4	Yes **	Yes	4 %
32	16	16	V.17	14.4	No	No	28.5 %
32	16	16	V.29	9.6	No	Yes	21.5 %
32	16	16	V.29	9.6	No	Yes	21.5 %
32	16	16	V.29	9.6	Yes *	No	37.8 %
32	16	16	V.17	14,4	Yes *	No	53 %
32	16	16	V.29	9.6	Yes *	Yes	36 %
32	16	16	V.29	9.6	Yes **	Yes	56 %

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com