1. What is CNAI?

CNAI is a file interface to the CNA application, accessed from the command line.
2. What does CNAI do?
CNAI imports and exports cell data to and from CNA.
3. How do you export using CNAI?
By entering a CNAI export command on the command line. The command syntax
for exporting using CNAI is given below:
cnai export valid [options] [where <param> = <value>]
The entries enclosed by square brackets are optional.
Examples of export commands are given below. This is as comprehensive as
possible and should give you an idea of what to use in different situations.
cnai export valid i
Example 1 Export all MOs in all domains along with all parameters
cnai export valid i internal_cell
Example 2 Export all internal cell parameters
cnai export valid i internal_cell=567A,567B
Example 3 Export all internal cell parameters for cells 567A and 567B
cnai export valid i internal_cell BCC,NCC
Example 4 Export the parameters BCC and NCC for all internal cells
cnai export valid i internal_cell=567A,567B BCC,NCC
Example 5 Export the parameters BCC and NCC for internal cells 567A and 567B
cnai export valid i internal_cell BCC,NCC where BSC_NAME=KABSC1A
Example 6 Export the parameters BCC and NCC for all internal cells with
BSC_NAME=KABSC1A
cnai export valid i bsc=B1,B2 ALPHA, CAP i
Example 7 Export parameters ALPHA and CAP for BSC B1 and B2 and all BSC
parameters for all remaining BSCs
cnai export valid i msc,bsc,site,tg
Example 8 Export all parameters for MOs in domains MSCs, BSCs, SITEs and TGs
cnai export valid i msc,bsc P1, P2 i site,tg P3,P4
Example 9 Export parameters P1 and P2 for MOs in domains MSC and BSC and
parameters P3 and P4 for MOs in domains SITE and TG
cnai export valid i bsc ALPHA,CAP where PLMNNAME=NISSE,DTXFUL=5
Example 10 Export parameters ALPHA and CAP where PLMNNAME=NISSE,
DTXFUL=5
4. How do you export to a file using CNAI?
By re-directing the output to a file using the output re-direction character (>). An
example is given below:
cnai export valid i internal_cell > /home/amanyaa/icell.txt
If you want to export to a file, add the part highlighted in yellow to the end of your
CNAI export command. The filepath /home/amanyaa/icell.txt can be changed to
a path of your choice for example /home/tumusip/123.txt.
5. How do you import using CNAI?
By entering a CNAI import command on the command line. The command syntax
for importing using CNAI is given below:
cnai import [user:]area [options] [where <param> = <value>]
The entries enclosed by square brackets are optional.
Examples of export commands are given below. This is as comprehensive as
possible and should give you an idea of what to use in different situations.
cnai import amanyaa:test i < /home/amanyaa/icell.txt
The command above imports the contents of the transport file icell.txt into the
planned area test created by the user amanyaa.
cnai import tumusip:cutover i < /home/tumusip/123.txt
The command above imports the contents of the transport file 123.txt into the
planned area cutover created by the user tumusip.

6. What is a CNAI transport file?
It is a file used both at export and import. The transport file contains operations
on objects and all or a subset of their parameters. At export the transport file
consists of the result of the export. At import the transport file consists of the
objects that should be created or deleted and the object data that should be
changed in CNA.
7. What is the format of a CNAI transport file?
The transport file is stored as a simple text file with the following principal layout:
<header>
<operations>
<footer>

The header part is used to safely identify a CNAI transport file and to provide
information about what functionality to expect from the remaining part of transport
file. All header (and footer) tags start with ...
A few important and mandatory tags are supported:
..cnai required to be the first tag in the transport file. Marks this file as a CNAI
transport file.
..capabilities BASIC required to be the second tag in the transport file.
The next part consists of a series of operations, which in some cases also may
contain additional data. The following operations are supported:
.subnetwork * - sets the current subnetwork. Preconditions: None.
.domain <domain name> - Sets the current domain. Run cnai without
arguments for a complete list of supported domains. Preconditions: A current
subnetwork (.subnetwork) must have been defined prior to the prior to the first
.domain tag.




.set <MO name> - creates the MO if it does not exist and then changes it
according to the values following this tag.
.set KABSC1A:578A
BCC=5
NCC=3
CELL_NAME=578A

Preconditions: A current domain (.domain) must have been prior to the first .set
tag.

.rm <MO name> - Removes the MO. Preconditions: A current domain (.domain)
must have been defined prior to the first .rm tag.

.cp <source MO name> <destination MO name> - This operation first creates
the destination MO if it does not exist. Then the parameter values from the
source MO are copied to the destination MO. Preconditions: A current domain
(.domain) must have been defined prior to the first .cp tag.
.nop A no operation tag. Ignored.
.utctime <UTC time> - The start time of the export in UTC time format.
Automatically generated by cnai export.

8. How do you change parameters of an already defined managed object?
You need to use a .set tag to change parameter settings of a managed object.

..cnai
..capabilities BASIC
.subnetwork *
.domain internal_cell
.set KABSC1A:567A
BCCHNO=125
NCC=2
BCC=4
.set KABSC2B:765B
BSPWRB=47
BSPWRT=47
..end

The transport file above changes the BCCH and BSIC of cell 567A on KABSC1A
and BSPWRB and BSPWRT of cell 765B on KABSC2B.



9. How do you delete an already defined managed object?
You need to use a .rm tag to delete a managed object.

..cnai
..capabilities BASIC
.subnetwork *
.domain internal_cell
.rmKABSC1A:567A
.rm KABSC2B:986C
..end

The above transport file will delete the cells 567A on KABSC1A and 986C on
KABSC2B.

10. How do you copy parameters from one managed object to another
managed object?
You need to use a .cp to copy settings from a source managed object to a
destination managed object.

..cnai
..capabilities BASIC
.subnetwork *
.domain internal_cell
.cp KABSC1A:567A KABSC2B:1020A
.domain overlaid_cell
.cp KABSC1A:567A:567A KABSC07:567AX:567AX
..end

The above transport file copies ALL parameters of the internal cell 567A on
KABSC1A to cell 1020A on KABSC2B. It also copies ALL parameters of the
overlaid cell 567A on KABSC1A to overlaid cell 567AX on KABSC07.

11. How does CNAI express the different managed objects?
Internal cell, External cell
KABSC1A:765A
Overlaid cell
KABSC1A:675A:675A
Channel group
KABSC1A:785A:0 (CHGR0)
KABSC1A:785A:1 (CHGR1)
KABSC1A:785A:2 (CHGR2)
Neighbour relation
KABSC1A:342A:MSBSC07:234B (CELL=342A,CELLR=234B)



12. What domains are used in CNAI?
The domains can be printed by entering the command cnai on the command line.
The domains used in CNAI are: MSC, BSC, RNC, FOREIGN_CELL,
INTERNAL_CELL,UTRAN_CELL,INNER_CELL,OUTER_CELL,PRIORITY_PRO
FILE,SITE,TG,OVERLAID_CELL,CHANNEL_GROUP,NREL,UTRAN_NREL,EX
TERNAL_CELL or UTRAN_EXTERNAL_CELL.