temip_dict_compare(1) — Commands
NAME
temip_dict_compare − TeMIP dictionary comparison tool
SYNOPSIS
temip_dict_compare [-h] [-v] [-p OID] [-L hostname1] [-R hostname2]
[-l pathname1] [-r pathname2] [filename1] [filename2]
PARAMETERS
filename
The filenames are the names of the two dictionary files. If no filename is specified, the filename mcc_fdictionary.dat is assumed for both dictionaries.
FLAGS
−hDisplays help.
−vSets verbose mode. In verbose mode, more descriptive text is displayed for each difference found.
−p
Defines the OID of the node that will be used as the root node for the comparison.
−L
Defines the filename1 host name. The default is the local host.
−R
Defines the filename2 host name. The default is the local host.
−l
Defines the filename1 path. The default is /usr/mcc/mcc_system/en_US.ISO8859-1.
−r
Defines the filename2 path. The default is /usr/mcc/mcc_system/en_US.ISO8859-1.
DESCRIPTION
The temip_dict_compare command performs a semantic comparison of two dictionaries, located on the local system or remote system. If one or both dictionaries are remote, they are first copied onto the local host in the /tmp directory, using rcp. For successful copying, the $HOME/.rhosts must be correctly configured on the remote system. See .rhosts for more informations.
The comparison is semantic, i.e. all definitions and definition values of all the nodes are compared one-to-one, and each difference is displayed to stdout. By default, the comparison starts at the root node of both dictionaries, unless when the -p option is specified. The comparison is made using a depth-first search algorithm. For more information on the TeMIP Framework dictionary structure, refer to the TeMIP Framework System Reference Manual.
The possible semantical differences are listed below:
#1An OID exist in one of the two dictionaries only.
#2For a given OID, a definition exist in one of the two dictionaries only.
#3For a given OID and a given definition, the definition values are different.
In condensed output mode (the default), a single line is displayed for each difference found. In verbose mode (option -v), many lines are displayed for each difference found, and some difference statistics are displayed at the end of the comparison. The difference display has the following format:
condensed mode
diff_type:class [subclass] (OID): name_or_id
verbose mode
------------------------------------------------------------ diff_type:class [subclass] (OID): name_or_id diff_description ------------------------------------------------------------
where:
diff_type
is the difference type found (#1, #2 or #3).
class [subclass]
is the dictionary object name.
(OID)is the dictionary object OID.
name_or_id
is the id of the dictionary object (diff type #1), or the id of the definition (diff type #2), or the label of the definition (diff type #3),
diff_description
is a verbose description of the difference (see examples below).
EXAMPLES
-----------------------------------------------------------------------------
#1:MCC ICONICMAP_PM APPLICATION (1.3.12.2.1011.2.22.1.7.18.500): 502
dictionary object not in file2: NOTIFICATION_PM
-----------------------------------------------------------------------------
#2:MCC ICONICMAP_PM USER_INTERFACE REASSIGN (1.3.12.2.1011.2.22.3.7.18.1009.126
definition not in file1: Symbol
-----------------------------------------------------------------------------
#3:TT_CONTEXT TT_REPORT Status Clear UserID (1.3.12.2.1011.2.22.2.28.6062.126.3
40): Presentation Name
value in file1: Clear UserID
value in file2: Clear UserId
-----------------------------------------------------------------------------
DIAGNOSTICS
MIR error encountered:
An error was encountered during the access to the dictionaries.
You cannot compare a dictionary with itself
The source and destination dictionaries are the same.
Comparison root OID not found in filename1
The given OID (-p option) does not exist in filename1.
FILES
/usr/mcc/mmtoolkit/bin/temip_dict_compare
/usr/mcc/mmtoolkit/bin/temip_dict_cmp