nimquery Command

Purpose

Query a system in the Network installation management (NIM) environment for system information and create client objects in the environment.

Syntax

nimquery{{ -a host=hostname [-a name=client obj[-d] [-a hmc=obj name[-d] [-a cec=obj name [-a bcmm=obj name [-a ivm=obj name} [-p] [-q] [-v]

Description

The nimquery command queries a machine for system information when using the -a host parameter. The information is used for defining a new client object in the NIM environment. System information is provided from systems that use the NIM service handler (nimsh).

The nimquery command can also be used to query logical partitions (LPARs) , central electronics complex (CEC) and blades information when pointing to a Hardware Management Console (HMC) , CEC, Integrated Virtualization Manager (IVM) or Blade Center Management Module (BCMM) object. To do so, the openssh.base.client must be installed on the NIM master.

Flags

Item	Description
-a	Assigns the following parameter attribute=value pairs.
-d	Defines a new client object (requires the name attribute when -a host is used).
-p	Enables print format.
-q	Shows an attribute list for nimquery command.
-v	Enables verbose debug output during command execution.

Parameters

Item	Description
host=hostname	Specifies the host name of the system to query. This attribute is required.
name=client_obj	Specifies the name to assign the client object when creating a new definition in the NIM database.
hmc=objname	Specifies the object name of the HMC system to query. This attribute is required.
cec=objname	Specifies the object name of the CEC system to query. This attribute is required.
ivm=objname	Specifies the object name of the IVM system to query. This attribute is required.
bcmm=objname	Specifies the object name of the BCMM system to query. This attribute is required.

Exit Status

0: Returns zero on success.

Security

You must have root authority to run the nimquery command.

Examples

To query machine buckey for system information, type:
```
nimquery -a host=buckey
```
To query machine buckey for system information and to provide detailed output information, type:
```
 nimquery -a host=buckey -p
```
To define machine buckey.austin.ibm.com using name client6 as the NIM object name, type:
```
nimquery -a name=client6 -a host=buckey -d
```
To query Management Module bcmm2 for blade system information, type:
```
nimquery -a bcmm=bcmm2
```
To define CEC objects managed by HMC hmc1, type:
```
nimquery -a hmc=hmc1 -d
```
To query LPARs attached to cec1 buckey for system information, type:
```
nimquery -a cec=cec1
```

Files

Item	Description
/usr/sbin/nimquery	The location of nimquery command.