# Running nms303tool in integrated mode

Before running nms303tool, make sure you have configured and booted a CG board, connected T1 trunks to the peer side of the GR303 interface, and compiled the nms303tool and aim303 executables.

To run nms303tool integrated with Aztek Access303 or Exchange303:

Step | Action
1 | Start nms303tool by entering the following command at the prompt: nms303tool nms303tool initializes the Access303 or Exchange303 library. Access303 starts internal tasks including AimTaskAr303, which makes it possible for nms303tool to communicate with the Aztek aim303 utility. aim303 is a part of the Aztek software and should be used with nms303tool integration tests. nms303tool displays a main menu of available options. These options directly correspond to functions in the NMS GR303 library. These options are the same options that appear if you run in standalone mode, except that NMS_GR303PhSendData is not available in integrated mode. See nms303tool options. Note: nms303tool calls NMS_GR303PhSendData internally when the Access303 or Exchange303 library calls Ar303PhDataRequest. All HDLC data received from the IDT or RDT side, as well as any HDLC transmit or receive errors, are passed to the Access303 or Exchange303 stack through Ar303PhDataIndication.
2 | Start the aim303 utility by entering the following command: aim303 hostname where hostname is the host name of the machine where nms303tool is running. nms303tool displays the following message: AR303AimTask: Menu Socket Connected on port 4200
3 | Enter options to execute functions from the NMS GR303 library. When necessary, nms303tool prompts you to enter associated arguments or parameters for the specified function. Enter options at the aim303 menu (for controlling Access303 or Exchange303 stack).
4 | To exit nms303tool, enter q.

## Example: nms303tool in integrated mode

The following example shows how to use nms303tool in integrated mode to:

- Initialize the NMS GR303 library.

- Provision and start an interface (interface 0) with four HDLC channels on a CG board.

This example creates the following parameter mapping between the Aztek Access303 and NMS GR303 libraries:

Aztek AV5 library parameters | NMS V5 library parameters
DS1=1, DS0=24 | boardNb=0, trunkNb=0, timeslotNb=24
DS1=1, DS0=12 | boardNb=0, trunkNb=0, timeslotNb=12
DS1=2, DS0=24 | boardNb=0, trunkNb=1, timeslotNb=24
DS1=2, DS0=12 | boardNb=0, trunkNb=1, timeslotNb=12

To perform these tasks:

1. Start nms303tool by entering the following command at the prompt:

nms303tool

2. Start aim303 by entering the following command at the prompt:

aim303tool hostname

where hostname specifies the system where the NMS GR303 library is running.

3. Enter option 1 to initialize the library.

nms303tool displays the following message:

NMS_GR303Initialize: Result=NMSGR303_SUCCESS

4. Enter option 4 to provision the interface.

nms303tool requests the following additional information:

Prompt | Response
Enter interfaceId: | 0
Enter ChannelRxBufferSize (Min=260): | 260
Add a new channel? (y/n): | y
Aztek DS1 (1-128): | 1
Aztek DS0 (12 = EOC, 24 = TMC): | 12
NMS boardNb: | 0
NMS trunkNb: | 0
NMS timeslotNb | 12
Add a new channel? (y/n): | y
Aztek DS1 (1-128): | 1
Aztek DS0 (12 = EOC, 24 = TMC): | 24
NMS boardNb: | 0
NMS trunkNb: | 0
NMS timeslotNb | 24
Add a new channel? (y/n): | y
Aztek DS1 (1-128): | 2
Aztek DS0 (12 = EOC, 24 = TMC): | 24
NMS boardNb: | 0
NMS trunkNb: | 1
NMS timeslotNb | 24
Add a new channel? (y/n): | y
Aztek DS1 (1-128): | 2
Aztek DS0 (12 = EOC, 24 = TMC): | 12
NMS boardNb: | 0
NMS trunkNb: | 1
NMS timeslotNb | 12

The following message displays when the interface is provisioned:

Result=NMSGR303_SUCCESS

5. Enter option 7 to start the interface.

nms303tool prompts you to enter the interface ID of the interface to start.

6. Enter the interface ID of the provisioned interface (0).

The following message displays:

Result=NMSGR303_SUCCESS

7. Enter option p to display the configuration of interface 0.

nms303tool displays configuration information for interface 0:

InterfaceId=0:
NMS: boardNb=24 trunkNb=0 timeslotNb=24
NMS: boardNb=12 trunkNb=0 timeslotNb=12
NMS: boardNb=24 trunkNb=1 timeslotNb=24
NMS: boardNb=12 trunkNb=1 timeslotNb=12

8. Enter options from the nms303tool and aim303 program menus to execute NMS GR303 and Access303 library functions.

9. Exit nms303tool by entering q.

10. Exit the aim303 utility.