Commands Reference, Volume 3

lsnim Command

Purpose

Displays information about the Network Installation Management (NIM) environment.

Syntax

To Display a List of Supported NIM Classes, Subclasses, or Types

lsnim { -p| -P} [ -cClass| -S]

To Display Predefined NIM Information

lsnim { -p| -P} [ -cClass| -sSubclass| -tType] [ -l| -O] [ -Z]

lsnim { -p| -P}[ -a Attribute ] . . . [ -Z]

To Display Attributes Required for an Operation

lsnim -tType -qOperation

To Display Information about All Customized NIM Objects

lsnim [ -cClass| -sSubclass| -tType] [ -l| -O] [ -Z]

lsnim [ -aAttribute ] . . . [ -Z]

To Display Information about a Specific NIM Object

lsnim[ -l | -O| -a Attribute . . . ][ -Z] ObjectName

lsnim[ -qOperation] ObjectName

To Display Information about Resources Available to a Specific NIM Machine

lsnim -L [ -sSubclass| -tType]ObjectName

To Display Information about NIM Groups

Description

The lsnim command displays information about the NIM environment. This information is divided into two basic categories: predefined and customized.

Predefined information consists of values that are preset by NIM and cannot be modified by the user. Examples of predefined information include:

The types of objects supported by NIM
The classes and subclasses into which NIM organizes objects
The operations that can be performed on NIM objects
The attributes that can be entered by the user

In general, NIM uses this information to make decisions during operations. Predefined information can be displayed by using the -p or -P flag. The -p flag displays default values while the -P flag displays help information.

Customized information consists of values that you enter or modify. This information represents the physical environment in which NIM operates. Related pieces of customized information are grouped together to form objects, which are organized in the NIM database by object type and class. Some examples of object types include diskless, paging, and standalone. Two examples of object classes are machines and network.

For example, a standalone workstation that is part of the NIM environment is represented by a unique object. This object is classified by NIM as a standalonemachines object, where standalone represents the object type and machines represents the object class. Entering the lsnim command on the command line without any flags displays information on all customized objects.

You can also use the lsnim command to display relationships between customized objects. Choose an object to anchor on (specified by the Objectname parameter) and then select the desired relationship with the -c, -s, or -t flag. The information displayed then depends upon the type and class of the anchored object. For example, if you select an object of type spot, the type of relationships that can be displayed are:

Machines that use the Shared Product Object Tree (SPOT) resource.
Networks that can access the SPOT resource.

When not displaying relationships, the lsnim command provides flags that can be used to filter the output that it would normally display. The -a, -c, -O, -s, or -t flag can be used to restrict the amount of information which is displayed.

Flags

-a Attribute	Filters displayed information based on the specified attribute name. The possible attributes are: Operation subclass type class
-c Class	Specifies a NIM object class. When this flag is used without the Objectname parameter, it filters the displayed information so only information about objects in that class is displayed.
-g	Displays long listing of group object with state information for individual members.
-l	Displays detailed information.
-L	Displays information about resources that can be accessed by a client machine.
-m	Applies other flags specified to group members.
-O	Lists the operations NIM supports.
-p	Displays predefined information using default values.
-P	Displays help information for predefined data.
-q Operation	Lists the attributes required for the specified operation.
-S	Displays a list of NIM subclasses.
-s Subclass	Specifies a NIM subclass. When this flag is used without the ObjectName parameter, it filters the displayed information so only information about objects in that subclass is displayed.
-t Type	Specifies a NIM object type. When this flag is used without the Objectname parameter, it filters the displayed information so only information about objects of that type is displayed.
-Z	Displays information in colon-separated format.

Security

Access Control: You must have root authority to run the lsnim command.

Examples

To display a list of NIM object classes, enter:
```
lsnim -p
```
To display a list of NIM subclasses, enter:
```
lsnim -p -S
```
To display the list of NIM object types for the machines object class, enter:
```
lsnim -p -c machines
```
To display help information about NIM object types for the machines object class, enter:
```
lsnim -P -c machines
```
To display detailed information about the NIM attributes named lpp_source and Rstate, enter:
```
lsnim -p -a lpp_source -a Rstate
```
To display the operations which can be performed on the paging object type, enter:
```
lsnim -p -t paging -O
```
To display the information required to perform a bos_inst operation on an object of the standalone object type, enter:
```
lsnim -t standalone -q bos_inst
```
To display information about all customized objects of the diskless object type, enter:
```
lsnim -t diskless
```
To display all customized objects in the networks object class, enter:
```
lsnim -c networks
```
To display detailed information about a NIM object named altoid, enter:
```
lsnim -l altoid
```
To display the relationship between an object named altoid and all NIM resources, enter:
```
lsnim -c resources altoid
```
To display a list of operations that can be applied to altoid, enter:
```
lsnim -O altoid
```
To display a list of resources available to altoid, enter:
```
lsnim -L altoid
```
To display the members of the machine group MacGrp1 with state and group exclusion status, enter:
```
lsnim -g MacGrp1
```
To display basic information about the members of the resource group ResGrp1, enter:
```
lsnim -m ResGrp1
```
To display a long listing of members of the machine group MacGrp1, with any hidden NIM internal information, enter:
```
lsnim -m -Fl MacGrp1
```
To display all members of machine group MacGrp1 which has a spot allocated, enter:
```
lsnim  -ma spot MacGrp1
```

Files

/etc/niminfo

Contains variables used by NIM.

Related Information

The nim command, nimclient command, nimconfig command, niminit command.

The .info file.