jimnodecount

Function

This command counts the number of nodes managed by JP1/IM - Manager. This command also outputs a file that contains a list of managed nodes.

This command can be executed regardless of whether JP1/IM - Manager is running.

The nodes that this command can count (as nodes managed by JP1/IM - Manager) are JP1/Base on the host defined in the configuration definition information and remotely monitored hosts.

Note that JP1/Base installed on a host that is not defined in the configuration definition information is not counted as a managed node. JP1/Base on such a host must be counted by the user manually.

To Page Top

Format

jimnodecount[ -h logical-host-name | -m]
            [ -o output-file-name]

To Page Top

Execution permission

In Windows: Administrator permissions

In UNIX: Superuser permissions

To Page Top

Storage directory

In Windows:

Manager-path\bin\

In UNIX:

/opt/jp1imm/bin/

To Page Top

Arguments

-h logical-host-name

If JP1/IM - Manager is operating in a cluster system, use this option to specify which type of host (physical or logical) the nodes to be counted by the jimnodecount command are managed by.

If the -h option is specified, the command counts the nodes managed by the specified logical host.

If the -h option is not specified, the command counts the nodes managed by the logical host specified in the JP1_HOSTNAME environment variable. If no logical host name is specified in that environment variable, the command counts the nodes managed by the physical node.

If JP1/IM - Manager is not operating in a cluster system, you do not need to specify this option.

-m

If JP1/IM - Manager is operating in a cluster system, use this option to specify whether the jimnodecount command counts the total number of nodes managed by the physical host and logical host.

If the -m option is specified, the command counts the number of all managed nodes.

If the -m option is not specified, the command counts the number of nodes managed by the logical host specified in the JP1_HOSTNAME environment variable. If no logical host name is specified in that environment variable, the command counts the number of nodes managed by the physical host.

-o output-file-name

This option specifies the managed-node list file to which a list of managed nodes is to be output. If the specified file already exists, the contents of the existing file are overwritten.

The output file name can be specified as a relative path or absolute path. If a relative path is used to specify the output file name, the directory where the jimnodecount command is executed is used as the base of the relative path. If you specify a file whose name begins with a hyphen (-), to distinguish the file name from an option name, use a relative path that begins with the current directory (for example, ./-foo) or an absolute path. Note that the length of the file name you specify must not exceed 250 bytes including the length of the path.

Network paths cannot be specified as the output file name.

Also note that in Windows, the file name you specify must not include the following character strings:

• Colon (:), question mark (?), double quotation mark ("), left angle bracket (<), right angle bracket (>), and vertical bar(|)

• A string that completely matches one of the following strings (ignoring case): CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, or LPT9

To Page Top

Output format

When you execute the jimnodecount command, the number of managed nodes is output in the format below.

Note that if an error occurs during execution of the command, the number of managed nodes is not output.

number-of-managed-nodes

To Page Top

Note

In a cluster system configuration in which JP1/IM - Managers on multiple logical hosts manage the same host as a managed node, each logical host is counted as a single host by the jimnodecount -m command. In this case, reduce the number of managed nodes appropriately:

To Page Top

Return values

To Page Top

Format of the managed-node list file

The following describes the format of the managed-node list file. The numbers at the beginning of each line (1 to 12) indicate line numbers, which are not output in the actual file.

 1  output-time
 2  The number of managed nodes : number-of-managed-nodes
 3  M  /manager-host-name
 4  B  /manager-host-name/host-name-for-JP1/Base-on-host-defined-in-configuration-definition-information
 5  R  /manager-host-name/name-of-remotely-monitored-host
 6  BR /manager-host-name/host-name-for-JP1/Base-on-remotely-monitored-host-defined-in-configuration-definition-information
 7  B  /manager-host-name/site-manager-host-name
 8  B  /manager-host-name/site-manager-host-name/host-name-for-JP1/Base-on-host-defined-in-configuration-definition-information
 9  R  /manager-host-name/site-manager-host-name/name-of-remotely-monitored-host
10  BR /manager-host-name/site-manager-host-name/host-name-for-JP1/Base-on-remotely-monitored-host-defined-in-configuration-definition-information
11  B  /manager-host-name/relay-manager-host-name
12  B  /manager-host-name/relay-manager-host-name/host-name-for-JP1/Base-on-host-defined-in-configuration-definition-information

Lines 2 to 12 are the managed-node block, which consists of the number of managed nodes on line 2 and the managed-node list on lines 3 to 12.

To Page Top

Description of the elements output to the managed-node list file

output-time

The time that the jimnodecount command was executed and the managed-node list file was output is indicated here.

YYYY/MM/DD hh:mm:ss

(YYYY: year, MM: month, DD: day, hh: hour, mm: minute, ss: second)

Managed-node block

The elements of a managed-node block are as follows:

• The number of managed nodes : number-of-managed-nodes

  The number of managed nodes counted by the command is indicated here.

• Managed-node list

  type-of-managed-node/host-name[/host-name...]

  The strings output for type-of-managed-node are described below.

  Type	Description
  MΔ Δ	Manager host on which the jimnodecount command was executed
  BΔ Δ	JP1/Base on a host that is defined in the configuration definition information and is not the Manager host on which the jimnodecount command was executed
  RΔ Δ	Remotely monitored host
  BΔ	JP1/Base on a remotely monitored host that is defined in the configuration definition information

  Legend: Δ: A single-byte space

The managed-node block output format differs depending on whether the -m option is specified.

If the -m option is not specified:

Only one managed-node block is output.

The following shows an example of the file output if the -m option is not specified.

Integrated manager	Site manager	Agent
Physical host (kanri)	tokyo	jp1ag1
	osaka	rhost1
		jp1ag2

2016/04/28 09:00:00
The number of managed nodes : 6
M  /admin
B  /admin/tokyo
B  /admin/tokyo/jp1ag1
B  /admin/osaka
R  /admin/osaka/rhost1
BR /admin/osaka/jp1ag2

If the -m option is specified:

Multiple managed-node blocks are output. The managed-node block for the physical host is output before the managed-node blocks for logical hosts. The managed-node blocks for logical hosts are output in the ascending order of logical host names.

The following shows an example of the file output if the -m option is specified.

Integrated manager	Site manager	Agent
Physical host (admin)	tokyo	jp1ag1
Logical host (adminL1)	osakaA	jp1ag2
	osakaB	jp1ag3
Logical host (adminL2)	nagoyaA	jp1ag4
Logical host (adminL3)	nagoyaB	jp1ag5

2016/11/26 09:00:00
The number of managed nodes : 3
M  /admin
B  /admin/tokyo
B  /admin/tokyo/jp1ag1
The number of managed nodes : 5
M  /adminL1
B  /adminL1/osakaA
B  /adminL1/osakaA/jp1ag2
B  /adminL1/osakaB
B  /adminL1/osakaB/jp1ag3
KAVB8201-E-or-KAVB8202-E-message-text#
The number of managed nodes : 3
M  /adminL3
B  /adminL3/nagoyaB
B  /adminL3/nagoyaB/jp1ag5

#: Because the command failed to count the number of nodes managed by logical host adminL2, a message (KAVB8201-E or KAVB8202-E) was output. For details about the message, see the JP1/Integrated Management 2 - Manager Messages.

To Page Top