NGL commands


NGL provides several commands to control the NGL agents.

NGL console commands

NGL supports console commands to stop, start, or refresh the NGL agents for a specific NGL product instance identifier (PIID).

The following table lists the commands that are available for the NGL. In this table, the dbcssid value indicates the DBC subsystem ID under which the NGL is running, and the piid value indicates the NGL piid.

Command

Description

/dbcssid NGL,STOP,piid

Stops the NGL agent for the specified piid.

/dbcssid NGL,START,piid

Starts the NGL agent for the specified piid.

/dbcssid NGL,REFRESH,piid

Stops and then starts the NGL agent for the specified piid.

/dbcssid NGL,DUMP,piid

Takes a dump of the NGL address space and any connected client address spaces.

Important

Use when BMC Support directs you to do so.

/dbcssid NGL,CMD,piid,LIST LOGSET {logsetName}

Lists all active logsets and provides status information such as logfile time span and record count information.

logsetName is optional. If logsetName is omitted, all logsets are displayed.

/dbcssid NGL,CMD,piid,DISPLAY LOGSET logsetName

Displays the defined logset characteristics to NGL.

logsetName is required.

Important

For DOM users, this information should match the output group definition in the option set.

/dbcssid NGL,CMD,piid,STATUS LOGSET {logsetName}

Displays insert and retrieval statistics for a logset.

logsetName is optional. If logset_name is omitted, all logsets are displayed.

Important

For information, see Data Collector STATUS command.

/dbcssid NGL,CMD,piid,ARCHIVE LOGSET logsetName{logfileName}

Use ARCHIVE with logfileName to archive a logfile if NGLARCH has failed and the logfile requires another archive.

logsetName is required. logfileName is optional. If logfileName is included in the ARCHIVE command, the named logfile is archived.

/dcbssid NGL,CMD,piid DISPLAY REGISTRY USAGE

Displays all NGL registries in use by this DBC.

Some products include options that you can use to configure NGL for use with that product. For additional information about using NGL with a particular product or solution, see your production documentation.


Data Collector STATUS command

The Data Collector STATUS command returns the status of active output groups. The command can be issued only from the system operator console.

The minimum command entry is STATUS which returns the status on each active output group. The additional parameters allow STATUS to provide status on a particular output group and also list statistics for all or a particular output group.

SYNTAX of the STATUS command

GUID-C97C6893-EB5C-411D-A24C-751E432EAD39-low.png

Parameter

Description

DCssid

Data Collector ID

LOGSET

LOGSET returns read and write statistics for an output group

LOGSTAT

LOGSTAT returns a one line status of an output group

Output_group_name

Specifies which output group details to be displayed

The output_group_name is in following template: DBCssid followed by the letter L followed by the output group number.

For example: DC01L001 for data collector DC01 and output group 001

Example

  • DCO1 STATUS

    Returns the output group status for all output groups

  •  DC01 STATUS  DC01L001

    Returns the status for output group 001 from data collector DC01

  • DC01 STATUS LOGSTAT

    Returns the status for all output groups (same as STATUS without parameters)

  • DC01 STATUS LOGSET

    Returns statistics for all output groups

  • SDC01 STATUS LOGSTAT DC01L001

    Returns the status for output group 001 from data collector DC01

  • DC01 STATUS LOGSET DC01L001

    Returns statistics for output group 001 from data collector DC01


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*