Hitachi

JP1 Version 12 JP1/Base User's Guide


jbsgetopinfo

Organization of this page

Function

The jbsgetopinfo command collects operating information, converts it to the definition file format, and outputs to the standard output. Definitions for forwarding events, log file traps, the SSL communication settings, and event log traps can be collected as operating information.

Format

jbsgetopinfo [-h logical-host-name | event-service-name]
             [-o operating-information-name, ...]
             [-i ID-number | -a monitoring-target-name]

Required execution permission

In Windows: Administrators (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 permission

Command directory

In Windows:

installation-folder\bin\

In UNIX:

/opt/jp1base/bin/

Arguments

-h logical-host-name

Specify the name of the logical host name or event service name from which you want to collect operating information. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed.

-o operating-information-name, ...

Specify the name of the operating information you want to collect. If you omit this option, the system assumes that all of the operating information names are specified. When multiple operating information names are specified, separate the names with commas.

You can specify any of the following operating information names.

  • forward

    Outputs definitions in the forwarding settings file in use. For details on the forwarding settings file, see Forwarding settings file in 16. Definition Files.

  • logtrap

    Outputs definitions in the action definition file for log file trapping in use among all log file traps started by the jevlogstart command and by JP1/AJS log file monitoring jobs. If you specify a logical host or an event service with the -h option, operating information of a physical host is collected. For details about the format of the action definition file for log file trapping, see Action definition file for log file trapping in 16. Definition Files.

  • evttrap

    Outputs definitions in the action definition file for event log trapping in use. If you specify a logical host or an event service with the -h option, operating information of a physical host is collected. evttrap is only for Windows. For details on the format of an action definition file for event log trapping, see Action definition file for event log trapping (Windows only) in 16. Definition Files.

  • SSL

    Outputs definitions in the SSL communication definition file in use. For details on the format of the SSL communication definition file, see SSL communication definition file in 16. Definition Files.

-i ID-number |-a monitoring-target-name

This option is valid only when logtrap is specified as an operating information name. For ID-number, specify the ID number of the log file trap that you want to collect operating information. For monitoring-target-name, specify a monitoring target name of the log file trap that you want to collect operating information. Specify either ID-number or monitoring-target-name. If logtrap is specified as an operating information name and this option is omitted, definitions of all the active log file traps are collected.

Notes

Return values

0

Normal end

1

Invalid argument

2

No operating information

248

The operating information file is corrupted.

249

The specified logical host name does not exist.

250

The reloaded settings have not been reflected.

251

Other user is now accessing.

252

No execution permission

253

UAC error

254

Insufficient memory

255

Other error

Output format

The following shows the output format of the setup information. Definitions are output in the order in which they appear in the SSL communication definition model file.

The operating information (SSL) is displayed for a physical host name, logical host name, or event service name.

<Process-name#1>
"ENABLE"#2="value-specified-for-ENABLE-label"
"SSLPROTOCOL"#3="value-specified-for-SSLPROTOCOL-label"
"CACERTIFICATEFILE"#3="value-specified-for-CACERTIFICATEFILE-label"
"CERTIFICATEFILE"#3="value-specified-for-CERTIFICATEFILE-label"
"PRIVATEKEYFILE"#3="value-specified-for-PRIVATEKEYFILE-label"
"SSLCIPHERS"#3="value-specified-for-SSLCIPHERS-label"
"BASESSL"#4="0" or "1"
#1

The names of the processes to be controlled are output. They are displayed in the following order:

<jbssessionmgr>: Authentication server

<jbsroute>: Configuration management

<jcocmd>: Command execution

<jbsplugind>: Plug-in service

<jbscomd>: Inter-process communication

<jevservice>: Event service

#2

This information is always output.

#3

This information is output only when both ENABLE and BASESSL are set to 1. When the name of the parameter is not defined, a null character is output.

#4

This information is output only when ENABLE is set to 1. dword:00000001 is output when SSL is enabled, and dword:00000000 is output when SSL is disabled.

Example

The following shows an example of output.

[Figure]