Application commands quick reference

This quick reference guide lists the commands for starting the applications and utilities that are included with Tivoli Netcool/OMNIbus.

The available applications and utilities are grouped according to their functions.

Main applications
Administration utilities
ObjectServer utilities
Process control utilities
Encryption utilities
Probe utilities
Online help utilities
Other utilities

Main applications

The following commands start the main Tivoli Netcool/OMNIbus applications.

Table 1. Main applications
Command	Description	More information
nco_objserv	Starts an ObjectServer.	Starting an ObjectServer manually ObjectServer properties and command-line options
nco_g_objserv_uni	Starts a unidirectional ObjectServer gateway.	Unidirectional ObjectServer Gateways
nco_g_objserv_bi	Starts a bidirectional ObjectServer gateway.	Bidirectional ObjectServer Gateways
nco_config (Netcool/OMNIbus Administrator)	Starts the Netcool/OMNIbus Administrator graphical user interface (GUI), used to administer ObjectServers and process agents. On Windows operating systems, you can also start the Administrator from the following menu: Start > All Programs > NETCOOL Suite > Administrator	Getting started with Netcool/OMNIbus Administrator Starting Netcool/OMNIbus Administrator Netcool/OMNIbus Administrator properties and command-line options
nco_pad (Process Agent Daemon)	Starts the process agent daemon.	Manually starting process agents Process agent properties and command-line options
nco_aen (Accelerated Event Notification)	Starts the Accelerated Event Notification (AEN) GUI. On Windows operating systems, you can also start the AEN from the following menu: Start > All Programs > NETCOOL Suite > Notifier	Starting the Accelerated Event Notification client
nco_event (Event List)	Starts the event list GUI on UNIX or Linux operating systems.	Starting the event list UNIX event list command-line options
NCOEvent (Event List)	Starts the event list GUI on Windows operating systems. On Windows operating systems, you can also start the event list from the following menu: Start > All Programs > NETCOOL Suite > Event List	Starting the event list Windows event list command-line options
nco_elct (Transient Event List)	Starts the transient event list GUI on UNIX or Linux operating systems.	Starting the transient event list from the command line UNIX command-line options for the transient event list
NCOElct (Transient Event List)	Starts the transient event list GUI on Windows operating systems.	Starting the transient event list from the command line Windows command-line options for the transient event list
nco_icw (Initial Configuration Wizard)	Automates initial configuration tasks, such as creating ObjectServers and gateways.	Initial configuration wizard

Administration utilities

Table 2. Administration utilities
Command	Description	More information
nco (Netcool/OMNIbus Conductor)	Starts the Netcool/OMNIbus Conductor GUI on UNIX and Linux operating systems.	Starting the Conductor About the UNIX Conductor
NCOConductor (Netcool/OMNIbus Conductor)	Starts the Netcool/OMNIbus Conductor GUI on Windows operating systems.	Starting the Conductor Windows Conductor command-line options
nco_bridgeserv	Starts a firewall bridge server.	Starting the firewall bridge server manually Firewall bridge server properties and command-line options
nco_proxyserv	Starts a proxy server.	Starting the proxy server manually Proxy server properties and command-line options
nco_igen	Generates a server communications interfaces file for a specific UNIX or Linux operating system. Interfaces files can also be generated using the Server Editor.	Generating the interfaces file for multiple platforms (UNIX only)
nco_xigen (Servers Editor)	Starts the Server Editor GUI on UNIX and Linux operating systems. There is no command-line utility for starting the Server Editor on Windows operating systems. Instead, use the following menu: Start > All Programs > NETCOOL Suite > System Utilities > Servers Editor	Configuring server communication details in the Server Editor After creating an ObjectServer
nco_id (ObjectServer version tool)	Displays information about your Tivoli Netcool/OMNIbus installation and includes options for basic or detailed output and for writing the information to a HTML file.	Collecting installation details
nco_version	Returns version information about your Tivoli Netcool/OMNIbus installation, including library versions and debug settings. nco_id uses nco_version to collect information about Netcool libraries.	Collecting installation details
nco_install_ospam	Installs the ObjectServer Pluggable Authentication Module (PAM) on UNIX and Linux operating systems.	Setting up an ObjectServer as the central authentication source

ObjectServer utilities

Table 3. ObjectServer utilities
Command	Description	More information
nco_dbinit (Database initialization utility)	Creates one or more ObjectServers. This utility replaced nco_new_server in V7.0 of Tivoli Netcool/OMNIbus.	Creating an ObjectServer Properties and command-line options for nco_dbinit
nco_osreport (ObjectServer Report Generator)	Writes the contents of ObjectServer tables to a HTML or XML file. This utility can also be used to export an ObjectServer configuration to a set of SQL files, which can then be used to create the initial contents of a new ObjectServer.	About the nco_osreport utility Command-line options for the nco_osreport command
nco_confpack (Configuration Packager)	Creates and manages configuration packages for transferring configuration objects between ObjectServers, for deploying duplicate ObjectServers, and for backing up ObjectServer configurations.	Exporting and importing configuration data using the nco_confpack utility nco_confpack properties and command-line options
nco_sql (SQL interactive interface)	Starts the SQL interactive interface on UNIX and Linux operating systems. You can use the SQL interactive interface to connect to an ObjectServer and issue SQL commands.	SQL interactive interface SQL interactive interface command-line options
isql (SQL interactive interface)	Starts the SQL interactive interface on Windows operating systems. You can use the SQL interactive interface to connect to an ObjectServer and issue SQL commands.	SQL interactive interface SQL interactive interface command-line options
nco_postmsg	Generates ObjectServer SQL INSERT statements using data input from the command line, from scripts, or from text files. You can use this utility as a replacement for the IBM Tivoli Enterprise Console postemsg utility and the postzmsg utility.	Using nco_postmsg to send alerts to ObjectServers nco_postmsg properties and command-line options
nco_check_store (Checkpoint verification utility)	Verifies that existing checkpoint files are valid. This utility is intended to be used by automations and can be used only to check ObjectServer stores that are not currently in use.	Introduction to checkpointing nco_check_store checkpoint verification utility
nco_store_resize	Changes the hard limit size of the table_store memstore.	Data storage using memstores Changing the table_store memstore soft and hard limits
nco_baroc2sql (BAROC conversion tool)	Converts Tivoli Enterprise Console BAROC (BAsic Recorder of Objects in C) files to ObjectServer SQL files, which you can then import into an ObjectServer.	IBM Tivoli Enterprise Console BAROC data migration

Process control utilities

Table 4. Process control utilities
Command	Description	More information
nco_pa_addentry	Adds a new service or process to a running process agent.	Adding new services or processes (nco_pa_addentry)
nco_pa_start	Starts services and processes that are under process agent control.	Starting a service or process (nco_pa_start)
nco_pa_stop	Stops services and processes that are under process agent control.	Stopping a service or process (nco_pa_stop)
nco_pa_status	Displays the status of services and processes that are under process agent control. For each service, the utility returns a list of defined processes, the status of each process, and the process identifier.	Displaying the status of services and processes (nco_pa_status)
nco_pa_shutdown	Shuts down a process agent. Services and processes under the control of the process agent can be left running if required.	Shutting down a process agent (nco_pa_shutdown)

Encryption utilities

Table 5. Encryption utilities
Command	Description	More information
nco_crypt	Encrypts plain text login passwords using the Data Encryption Standard (DES), for use by Tivoli Netcool/OMNIbus probes and gateways. When running Tivoli Netcool/OMNIbus in FIPS 140-2 mode, use nco_aes_crypt for encrypting passwords in probe and gateway properties files.	Configuration requirements for connecting V7.2 or earlier clients to V7.2.1 or later servers in FIPS 140–2 mode
nco_aes_crypt	Encrypts and decrypts string values or data in a file using the Advanced Encryption Standard (AES). It requires a key file that is generated using the nco_keygen utility.	Setting up property value encryption Encrypting a string value with the key nco_aes_crypt command-line options
nco_g_crypt	Encrypts plain text login passwords using DES encryption, for use by Tivoli Netcool/OMNIbus probes and gateways. When running Tivoli Netcool/OMNIbus in FIPS 140-2 mode, use nco_aes_crypt for encrypting passwords in probe and gateway properties files.	Running the ObjectServer in secure mode
nco_pa_crypt	Encrypts plain text login passwords on UNIX and Linux operating systems, for use in the process agent configuration file. When running Tivoli Netcool/OMNIbus in FIPS 140-2 mode, use nco_aes_crypt for encrypting passwords in the process agent configuration file.	Process control security Defining routing hosts in the process agent configuration file
nco_sql_crypt	Encrypts plain text login passwords on UNIX and Linux operating systems, for use by the SQL interactive interface (nco_sql). When running Tivoli Netcool/OMNIbus in FIPS 140-2 mode, use nco_aes_crypt for encrypting passwords in the SQL interactive interface properties file.	Encrypting passwords in scripts
nco_get_login_token	nco_sql, when run in secure mode, uses nco_get_login_token to generate a single-use, fixed-lifetime login token.	SQL interactive interface Command-line options for starting the SQL interactive interface
nco_keygen	Generates AES encryption keys and stores them in key files.	Setting up property value encryption
nc_gskcmd	Manages SSL certificates and key databases on Tivoli Netcool/OMNIbus deployments that run in FIPS 140-2 mode, or in networks with Java-based clients that require encrypted communications.	Creating a key database using nc_gskcmd nc_gskcmd command-line options
nc_ikeyman	Starts the iKeyman SSL certificate management and key database GUI. iKeyman must not be used on Tivoli Netcool/OMNIbus deployments that run in FIPS 140-2 mode, or in networks with Java-based clients that require encrypted communications.	Creating a key database using iKeyman Managing digital certificates

Probe utilities

Table 6. Probe and gateway utilities
Command	Description	More information
nco_http	Connects to probes that have a HTTP or HTTPS interface and issues HTTP requests.	Sending remote requests to probes (nco_http)
nco_probereloadrules	Remotely reloads a probe rules file without restarting the probe.	Reloading rules files (nco_probereloadrules)
nco_setprobeprop	Remotely updates the value of a probe property.	Sending property updates to probes (nco_setprobeprop)
nco_probeeventfactory	Remotely generates an event on a probe.	Generating events with probes (nco_probeeventfactory)
nco_mibmanager	Starts the Tivoli Netcool/OMNIbus MIB Manager GUI. MIB Manager parses SNMP management information base (MIB) files and generates Netcool rules files for use with the SNMP Probe.	Netcool MIB Manager
nco_rules_util (Probe Rules Utility)	You can use the Probe Rules Utility command-line tool to help manage probe rules files that are stored in a central repository or file system.	Probe Rules Utility

Online help utilities

Table 7. Online help utilities
Command	Description	More information
IC_start	Starts the IBM Eclipse Help System (IEHS) local server.	Configuring and running online help
IC_end	Stops the IEHS local server.	Configuring and running online help
help_end	Stops the IEHS local server when it is running in stand-alone mode.	Configuring and running online help

Other utilities

Table 8. Other utilities
Command	Description	More information
nco_mail	A wrapper script that uses sendmail to send e-mails. It is used by the mail_on_critical trigger.	Automation examples CREATE PROCEDURE (external procedures)
nco_functions	A file that can be called from shell scripts to provide useful functions for the Tivoli Netcool/OMNIbus environment.	Installation directory structure
nco_run	A run script that ensures the environment is set up and the correct binary is executed.	Installation directory structure
nco_message	Opens a dialog box on the screen with a message. The following is an example usage: `./nco_message -title "ObjectServer Status" -message "The ObjectServer is responding to pings" -type info`	Exporting MIB data
nco_ping	Pings a Tivoli Netcool/OMNIbus server to check its availability. For example, it can be used to verify that an ObjectServer or a gateway is running.
nco_xcheck	Checks that the $DISPLAY environment variable is set to a functioning X11 server on UNIX and Linux operating systems.	Troubleshooting display issues (UNIX and Linux)