[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

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]

OR

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]

OR

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

To Display Information about a Specific NIM Object

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

OR

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 (AIX 4.2 or later)

lsnim -g | -m [ -a Attribute | -cClass | -L | -l | -sSubclass | -tType] GroupObjectName

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:

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:

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.
-l Displays detailed information.
-L Displays information about resources that can be accessed by a client machine.
-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.

AIX 4.2 or later Flags


-g Displays long listing of group object with state information for individual members.
-m Applies other flags specified to group members.

Security

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

Examples

  1. To display a list of NIM object classes, enter:

    lsnim -p
    
  2. To display a list of NIM subclasses, enter:

    lsnim -p -S
    
  3. To display the list of NIM object types for the machines object class, enter:

    lsnim -p -c machines
    
  4. To display help information about NIM object types for the machines object class, enter:

    lsnim -P -c machines
    
  5. To display detailed information about the NIM attributes named lpp_source and Rstate, enter:

    lsnim -p -a lpp_source -a Rstate
    
  6. To display the operations which can be performed on the paging object type, enter:

    lsnim -p -t paging -O
    
  7. 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
    
  8. To display information about all customized objects of the diskless object type, enter:

    lsnim -t diskless
    
  9. To display all customized objects in the networks object class, enter:

    lsnim -c networks
    
  10. To display detailed information about a NIM object named altoid, enter:

    lsnim -l altoid
    
  11. To display the relationship between an object named altoid and all NIM resources, enter:

    lsnim -c resources altoid
    
  12. To display a list of operations that can be applied to altoid, enter:

    lsnim -O altoid
    
  13. To display a list of resources available to altoid, enter:

    lsnim -L altoid
    

AIX 4.2 or later Examples

  1. To display the members of the machine group MacGrp1 with state and group exclusion status, enter:

    lsnim -g MacGrp1
    
  2. To display basic information about the members of the resource group ResGrp1, enter:

    lsnim -m ResGrp1
    
  3. To display a long listing of members of the machine group MacGrp1, with any hidden NIM internal information, enter:

    lsnim -m -Fl MacGrp1
    
  4. To display all members of machine group MacGrp1 which has a spot allocated, enter:

    lsnim  -ma spot MacGrp1
    

File


/etc/niminfo Contains variables used by NIM.

Related Information

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

The .info file.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]