IBM Tivoli Netcool/OMNIbus SNMP Writer Gateway: Reference Guide

Note: After the gateway has started, you can use the nco_sql command to
manually issue commands. For more information about the nco_sql command, see
the IBM Tivoli Netcool/OMNIbus Administration Guide (SC23-6371).
Table 8 lists the available startup commands.
Table 8. Startup commands
Command Description Syntax Example
SET PROPERTY Use this command to set the value of a SET PROPERTY SET PROPERTY
property in the properties file.
’string’ TO value ; ’Gate.Reader.Debug’ TO
FALSE ;
GET PROPERTY Use this command to return the value of GET PROPERTY GET PROPERTY
a specified property from the properties
file.
’string’ ;
’Gate.Reader.Debug’ ;
SHOW PROPS Use this command to display the current SHOW PROPS ; SHOW PROPS ;
configuration of the gateway by listing all
properties and their values.
go
GET CONFIG Use this command to display the current
configuration of the gateway by listing all
properties and their values.
Note: GET CONFIG is identical to the
SHOW PROPS command and may be
removed from later versions of the
gateway.
TRANSFER Use this command to initiate a data
transfer operation between tables in two
ObjectServers.
Note: You can use a filter condition to
transfer a partial table. If the target table
does not match the source table, a map
can be specified as part of the transfer
operation. This map must be defined in
the map definition file.
FAILOVER SYNC Use this command to synchronize data
between primary and backup
ObjectServers. The command specifies
which master tables are transferred
during the data transfer operation.
Failover Sync example
GET CONFIG ; GET CONFIG ;
go
TRANSFER FROM
sourcetable TO
targettable [VIA
FILTER filtertext]
[WITH DELETE VIA
delfiltertext]
[USING TRANSFER_MAP
mapname] ;
FAILOVER_SYNC [ ADD
’TABLENAME’ TO |
REMOVE ’TABLENAME’
FROM ] WRITERNAME ;
TRANSFER FROM
’master.names’ TO
’resync.names’ VIA
FILTER ’Name !=
\’nobody\’’ DELETE ;
In this example, all records
with the name nobody are
deleted from the
resync.names table and
replaced with
corresponding records in
the master.names table.
See “Failover Sync
example.”
The following is an example of how to use the FAILOVER SYNC command in the
startup command file:
FAILOVER_SYNC ADD ’master.names’ TO ObjectServerA;
FAILOVER_SYNC ADD ’master.groups’TO ObjectServerA;
FAILOVER_SYNC ADD ’master.members’ TO ObjectServerA;
FAILOVER_SYNC ADD ’master.permissions’ TO ObjectServerA;
FAILOVER_SYNC ADD ’master.profiles’TO ObjectServerA;
FAILOVER_SYNC ADD ’tools.actions’ TO ObjectServerA;
FAILOVER_SYNC ADD ’tools.action_access’ TO ObjectServerA;
FAILOVER_SYNC ADD ’tools.menus’ TO ObjectServerA;
FAILOVER_SYNC ADD ’tools.menu_defs’ TO ObjectServerA;
18 IBM Tivoli Netcool/OMNIbus SNMP Writer Gateway: Reference Guide