# Running nmsv5tool in integrated mode

Before running nmsv5tool, you must configure and boot a CG board, connect its E1 trunks, and compile the nmsv5tool and aimv5 executables.

To run nmsv5tool integrated with Aztek AV5:

Step | Action
1 | Start nmsv5tool, entering the following command at the prompt: nmsv5tool nmsv5tool initializes the AV5 library. The AV5 library starts internal tasks including the AIM task, which makes it possible for the aimv5 utility to communicate with the Aztek AV5 stack. nmsv5tool displays a main menu of available options. These options directly correspond to functions in the NMS V5 library. These options are the same options that appear if you run in standalone mode, except that NMS_V5PhSendData and NMS_V5SendSA7Bit do not appear in integrated mode. Refer to nmsv5tool options. Note: nmsv5tool calls NMS_V5PhSendData and NMS_V5SendSA7Bit. The AV5 stack calls V5PhDataRequest, V5SetSA7ToOne, and V5SetSA7ToZero. nmsv5tool passes all HDLC data received from the IDT side, as well as any HDLC transmit and receive errors, to the AV5 stack by using the AV5PhDataIndication function. nmsv5tool also sends E1 status reports to the AV5 library by calling the AV5 library function V5E1Status.
2 | Start the aimv5 utility by entering the following command: aim hostname where hostname is the host name of the machine where nmsv5tool is running. nmsv5tool displays the following message: Aztek_waitconnect: AIM socket connected on port 5200, file descriptor 648
3 | Enter options to execute functions from the NMS V5 library. When necessary, nmsv5tool prompts you to enter associated arguments or parameters for the specified function. Enter options at the aimv5 menu for controlling AV5 stack.
4 | To exit nmsv5tool, enter q.

## Example: nmsv5tool in integrated mode

This example shows the nmsv5tool options used to perform the following tasks while integrated with the V5 library:

- Initialize the NMS V5 library.

- Provision an interface (interface 0) with two HDLC channels on a CG board using both the NMS V5 and AV5 libraries.

- Start the provisioned interface.

This example creates the following parameter mapping between the Aztek AV5 and NMS V5 libraries:

Aztek AV5 library parameters | NMS V5 library parameters
E1=0 CChannel=16 | boardNb=0, trunkNb=0, trunkNb=16
E1=1 CChannel=16 | boardNb=0, trunkNb=1, trunkNb=16

To perform these tasks:

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

nmsv5tool

2. Start aimv5, by entering the following command at the prompt:

aimv5

3. Enter option 1 to initialize the library at the nmsv5tool command line.

nmsv5tool displays the following:

NMS_V5Initialize: Result=NMSV5_SUCCESS

4. Enter option 4 to provision the interface.

nmsv5tool requests the following additional information:

Prompt | Response
Enter interfaceId: | 0
Enter ChannelRxBufferSize (Min=260): | 260
Add a new E1? (y/n): | y
Aztek E1 (0-15): | 0
NMS boardNb: | 0
NMS trunkNb: | 0
Add a new E1? (y/n): | y
Aztek E1 (0-15): | 1
NMS boardNb: | 0
NMS trunkNb: | 1
Add a new E1? (y/n): | n
Add a new channel? (y/n): | y
Aztek E1 (0-15): | 0
Aztek C-Channel (15,16,or 31): | 16
NMS boardNb: | 0
NMS trunkNb: | 0
NMS timeslotNb | 16
Add a new channel? (y/n): | y
Aztek E1 (0-15): | 1
Aztek C-Channel (15,16,or 31): | 16
NMS boardNb: | 0
NMS trunkNb: | 1
NMS timeslotNb | 16
Add a new channel? (y/n): | n

When the interface is provisioned, nmsv5tool displays the following message:

Result=NMSGRV5_SUCCESS

5. Enter option 11 to start the interface.

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

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

nmsv5tool displays the following configuration information:

19:31:46E1Status Function InterfaceId=0 Status: LOS=0 LOF=0 AIS=0
RAI=0 CRCErr=0 FEBE=0 N_SA7_0=0 N_SA7_1=1
NMS: boardNb=0 trunkNb=0
V5PhDataIndication AztecReturn=0x30
19:31:46E1Status Function InterfaceId=0 Status: LOS=0 LOF=0 AIS=0
RAI=0 CRCErr=0 FEBE=0 N_SA7_0=0 N_SA7_1=1
NMS: boardNb=0 trunkNb=1
V5PhDataIndication AztecReturn=0x30

nmsv5tool displays the following message:

Result=NMSV5_SUCCESS

7. Enter options from the nmsv5tool and aimv5 program menus to execute NMS V5 and AV5 library functions.

8. Exit nmsv5tool by entering q.

9. Exit the aimv5 utility.