jcoview (Windows only)

Function

This command opens a JP1/IM - View window.

The window to be opened depends on the option specifications, as shown below:

• Starting the Login window for JP1/IM - View

  When any option other than -p or -e is specified or no option is specified, the Login window opens.

  -c option is specified: The Central Console check box is selected in the Login window.

  -s option is specified: The Central Scope check box is selected in the Login window.

  -h option is specified: A value is entered in Host to connect in the Login window.

  -u option is specified: A value is entered in User name in the Login window.

• Opening the Event Console window and the Monitoring Tree window of JP1/IM - View

  When the -h, -u, or -p option is specified, the Event Console window and the Monitoring Tree window open. To open the Event Console window and the Monitoring Tree window, you must specify the -h, -u, or -p option.

  -c option is specified: The Event Console window opens.

  -s option is specified: The Monitoring Tree window opens.

  Neither the -c nor the -s option is specified: The Event Console window opens.

• Opening the Monitoring Tree (Editing) window of JP1/IM - View

  When the -e option is specified, the Monitoring Tree (Editing) window opens.

To Page Top

Format

jcoview [[[-c] [-s]]
         [-h connection-target-host-name] [-u user-name] [-p password]
         | -e]

To Page Top

Execution permission

None

To Page Top

Storage directory

View-path\bin\

To Page Top

Arguments

-c

Specifies that the Event Console window is to open.

If the password (-p option) is omitted, the Login window opens with the Central Console check box selected. This option cannot be specified together with the -e option.

This option is optional.

If the -h, -u, and -p options are specified and none of the -c, -s, and -e options is specified, the command assumes that the -c option is specified.

-s

Specifies that the Monitoring Tree window is to open.

If the password (-p option) is omitted, the Login window opens with the Central Scope check box selected. This option cannot be specified together with the -e option.

This option is optional.

-h connection-target-host-name

Specifies the name of the connection-target host. For the host name, from 1 to 255 bytes of characters are permitted. You can specify only a host where JP1/IM - Manager is running.

For the connection-target host name, you can specify the following:

• Host name defined on the host where the command is used

• Host name whose address can be resolved on the host where the command is used

• IP address

  Only addresses in IPv4 address format can be specified. Addresses in IPv6 address format cannot be specified.

This option is optional, but if you specify the -p option, you must also specify this option.

-u user-name

Specifies the name of a JP1 user that has been registered in the authentication server. For the JP1 user name, from 1 to 31 alphanumeric characters are permitted (for alphabetic characters, only lowercase letters are permitted).

This option is optional, but if you specify the -p option, you must also specify this option.

-p password

Specifies the specified user's password. For the password, from 6 to 32 alphanumeric characters are permitted. Alphabetic characters are case sensitive.

If you specify this option, you must also specify the -h and -u options.

This option is optional.

-e

Specifies that the Monitoring Tree (Editing) window is to open.

When you specify this option, you must not specify any other options.

This option is optional.

Important

• If you attempt to start JP1/IM - View by executing the jcoview command with an incorrect argument specified, the login window appears after either of the following messages is output:

  - KAVB0104-E Failed to authenticate the user.

  - KAVB1210-E A communication error occurred while establishing a connection.

  Cannot convert the host name into an IP address. Confirm the host name.

  Host name: <host-name>, Port number: <port-number>

  Details: <detail-information>

  In the login window displayed in this status, you may be unable to select the input fields even with the mouse to enter information in them. If this problem occurs, click the taskbar button for a program other than JP1/IM - View, and then click the login window.

• If the program jcoview.exe is executed from a command prompt where the code page is set to a value other than 932, the characters displayed on the screen might be garbled.

• If the program jcoview.exe is executed from a command prompt where the code page is set to a value other than 936, the characters displayed on the screen might be garbled.

To Page Top

Return values

To Page Top

Example 1

Start JP1/IM - View and open the Login window:

jcoview

To Page Top

Example 2

Start JP1/IM - View and display the Login window with host set in Host to connect and jp1admin set in User name:

jcoview -h host -u jp1admin

To Page Top

Example 3

Start JP1/IM - View, log in by specifying jp1admin as the user name, jp1admin as the password, and host as the connection-target host, and then open the Event Console window:

jcoview -h host -u jp1admin -p jp1admin

To Page Top

Example 4

Start JP1/IM - View, log in by specifying jp1admin as the user name, jp1admin as the password, and host as the connection-target host, and then open the Monitoring Tree window:

jcoview -s -h host -u jp1admin -p jp1admin

To Page Top

Example 5

Start JP1/IM - View, log in by specifying jp1admin as the user name, jp1admin as the password, and host as the connection-target host, and then open the Event Console window and the Monitoring Tree window:

jcoview -c -s -h host -u jp1admin -p jp1admin

To Page Top

Example 6

Start JP1/IM - View and open the Monitoring Tree (Editing) window:

jcoview -e

To Page Top

Example 7

You can create a command shortcut, such as for Examples 2 and 3, for each host and each user.

To Page Top