jevfwstat

Organization of this page

Function
Format
Required execution permission
Command directory
Argument
Note
Return values
Example

Function

The jevfwstat command displays JP1 event forwarding suppression status for each condition for the suppression of event-forwarding (suppress).

To Page Top

Format

jevfwstat [-h event-server-name]

To Page Top

Required execution permission

In Windows: Administrators privileges (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)

In UNIX: Superuser or JP1/Base administrator privileges

To Page Top

Command directory

In Windows: installation-folder\bin\
In UNIX: /opt/jp1base/bin/

To Page Top

Argument

-h event-server-name

Specify an event server name on which you want to check the JP1 event forwarding status. Specify the event server name as a character string of no more than 128 bytes.

If you omit this option, the event server name is assumed as a host name in the following order of priority:

The logical host name specified in the JP1_HOSTNAME environment variable
The local host name, if an asterisk (*) or the local host name (physical host name returned by the hostname command) has priority in the server parameter of the event server index file (index)
The FQDN name, if an at mark (@) or FQDN name has priority in the server parameter of the event server index file (index)
The local host name (physical host name returned by the hostname command)

To Page Top

Note

You cannot execute multiple instances of the jevfwstat command at the same time. If you attempt to execute the jevfwstat command when another user is executing the same command, the message KAJP1352-E is output and the command execution fails.

To Page Top

Return values

`0`	Normal end
`1`	Argument error
`2`	Event server is not running.
`3`	Another user is executing the command.
`255`	Other error

To Page Top

Example

The following shows an example of the output:

KAJP1350-I The status of the threshold-based suppression of event-forwarding for agent01 will be checked.
ID          C  Forwarded Suppressed LastModified        BaseTime Detection
----------- - ---------- ---------- ------------------- -------- ---------
log1        F          8          0 None                11:37:10       0/1
log2        S        136       1274 2014/05/22 11:33:42 11:37:02       1/2
log3        F        309        520 2014/05/22 11:33:12 11:37:12       2/3

The following table describes meaning of the headers.

Header	Description
`ID`	Identifier specified for the condition for the suppression of event-forwarding (`suppress`)
`C`	`S` is output when event forwarding is in suppressed status, and `F` is output when in forwarded status (suppression-stopped status).
`Forwarded`^#	The number of JP1 events that were forwarded.
`Suppressed`^#	The number of JP1 events that were suppressed from being forwarded.
`LastModified`	The most recent time at when the suppression status has changed.
`BaseTime`	The time used as the base for the current unit time.
`Detection`	Output differs depending on whether event forwarding is in suppressed status (the `C` value is `S`) or forwarded status (the `C` value is `F`). Suppressed status (the `C` value is `S`): `n/m` `n`: The number of unit times in which the threshold was not exceeded `m`: The number of unit times that the system determines that the large numbers of events have converged Forwarded status (the `C` value is `F`): `n/m` `n`: The number of unit times in which the threshold was exceeded `m`: The number of unit times that the system determines that a large number of events has occurred

#: If you reload the event service (by executing the jevreload command) or restart the system, each value will default to 0.

To Page Top