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. Note: 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. Note: 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. Note: 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
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 |
Failed to execute the [panel] macro.