Cna Export procedure

mothman@krtuas2> man cna_export

Reformatting page. Please Wait... done

User Commands cna_export(1)

NAME

cna_export - CNA interface export function

SYNOPSIS

cna_export [ AREA = <user:area_name> ] ,

NW = <network> ,

MSC = <msc_obj_spec> , MSC_REF = <msc_param_spec> ,

[BSC = < bsc_obj_spec > , BSC_REF = <bsc_param_spec> ,

[PP = <pp_obj_spec> , PP_REF = <pp_param_spec> ,]

[SITE = <site_obj_spec> , SITE_REF = <site_param_spec> ,

[TG = <tg_obj_spec> , TG_REF = <tg_param_spec> ,]]

[CELL = <cell_obj_spec> , CELL_REF = <cell_param_spec> ,]]

OUTPUT = <transfer_file_name>

[,MNCZEROEXPAND = yes | no]

or

cna_export [ AREA = <user:area_name>] ,

NW = <network> ,

FCELL = <fcell_obj_spec> ,

FCELL_REF = <fcell_param_spec> ,


or

cna_export [ AREA = <user:area_name>] ,

NW = <network> ,

RNC = <rnc_obj_spec> , RNC_REF = <rnc_param_spec> ,

[UCELL= <ucell_obj_spec> , UCELL_REF= <ucell_param_spec> ,]


where <xx_obj_spec> is one of (all | <obj_ref_file>) and

<xx_param_spec> is one of (all | none | < param_ref_file >).

Hint: With long command lines or for convenience, use either

a script or source file.

DESCRIPTION

The cna_export function exports data from the Valid Area or

a Planned Area in CNA to a transfer file stored in the OMC

file system. To be able to export data for a specific CNA

object, it is necessary to specify the superior objects in

the object hierarchy. AREA must not be specified, and then

the Valid Area is default. NW must always be specified and,

for example, to export data for a specific TG it is also

necessary to specify the MSC, BSC and SITE to which the TG

belongs.

The second form of the command is used to export only the

foreign cell data. A foreign cell has no connection to

MSCs, BSCs etc. It is only connected to a specific network

so here it is sufficient to specify the desired NW and FCELL

SunOS 5.10 Last change: 2004-10-22 1


only.

The third form of the command is used to export RNC data and

UTRAN cell data from the Valid Area or a Planned Area in CNA

to a transfer file stored in the OMC file system.

OPTIONS

<MNCZEROEXPAND>

if set to "yes", zero expands the MNC (Mobile Net-

work Code) parameter value to two or three digits

depending on the EXPANDMNC MSC or the MNCDIGITHAND

BSC parameters.

<network> is the name of the network. This name doesn't have

any direct relevance for neither cna_export or

cna_import, nor for cna. Still, the name has to be

given since it's used as a reference for the

specific collection of objects and parameters

exported.

<transfer_file_name>

is the name of the output data file containing CNA

object names and, optionally, their parameters.

The default directory where the transfer file will

be placed:

/var/opt/ericsson/cnai/data/export

See environment variable CNAI_EXPORT_DIR how to

change the directory where the transfer file will

be placed.

<obj_ref_file>

are the names of ASCII coded text files which con-

tains the names of the CNA objects from which data

should be exported. The default directory where

to find these files:

/etc/opt/ericsson/cnai/data

See environment variable CNAI_DATA_DIR how to

change the directory where the reference files can

be found.

<param_ref_file>

is the name of an ASCII coded text file which con-

tains the names of the parameters to be exported

for a CNA object type. The default directory for

the file is:

/etc/opt/ericsson/cnai/data



See environment variable CNAI_DATA_DIR how to

change the directory where the reference files can

be found.

A template file can be used when creating a new

<param_ref_file>. The template files can be found

in /etc/opt/ericsson/cnai/templ directory. Also

see FILES below.

all can be used to specify that all CNA objects (by

name) or all parameters of one type should be

exported.

none can be used to specify that no parameter values

for a CNA object type should be exported.

Note: If an object, for example MSC, is specified in the

command line, then the object reference, in this case

MSC_REF, must be specified as well.

FILES

<report_file>

is created during a job execution and tells

whether the job has succeeded or not. The name of

the report file is:

Export_<user>_<transferfilename>_<num>_report.txt

The default directory where the report file is

placed:

/var/opt/ericsson/cnai/log/reports

See environment variable CNAI_REPORT_FILE_DIR how

to change the directory where the report file is

placed.

There is one for each object type possible to

export, i.e. MSC, BSC, PP, SITE, TG, CELL, FCELL,

RNC and UCELL. Their names are obj_templ.txt and

they contain all parameters possible to export for

the different object types. If an export needs to

be done with a subset of all parameters for an

object type, copy the appropriate template file to

the directory where the <param_ref_file> should be

placed. Then edit the file. To remove names of

parameters which should not be exported, either

delete them or make the line where they are writ-

ten to a comment line (a comment starts with

'//').



ENVIRONMENT

CNAI_DATA_DIR

environment variable that, if set, specifies the

directory where to find the object reference files

and the parameter reference files.

CNAI_EXPORT_DIR


directory where to place the output transfer file.

CNAI_REPORT_FILE_DIR


directory where to place the report file.

SEE ALSO

cna_import(1)

"CNA Interface User Guide, 3/1553-APR 102 56/1A Uen"

"CNA Interface - Interwork Description (IWD),"

"15519-CRA 114 044 Uen"

COPYRIGHT

"Copyright (c) Ericsson AB 1993-2004"


Documents

Cna Export procedure