Commands Reference, Volume 3

lssensor Command

Purpose

Displays the event sensor commands that have been added to the resource monitoring and control (RMC) subsystem.

Syntax

lssensor [-v | -V] [-a | -n host1[,host2...]] [-A | -h | name1 [name2...]]

Description

The lssensor command displays the properties of the sensor identified by name. If name is omitted, the lssensor command lists the names of all the sensors defined to RMC. This command returns the error messages and exit status of the underlying lsrsrc RMC command.

The lssensor command can be run on the management server or on any node. It operates on the local node where it is run unless the CT_CONTACT environment variable is set. If you want lssensor to run on all of the nodes in a domain, use the CT_MANAGEMENT_SCOPE environment variable. See the Environment variables section for more information.

See the mksensor command for a more complete explanation of RMC sensors.

Flags

-v | -V: Writes the command's verbose messages to standard output. Use this flag to see the underlying RMC command that is being run. This can help to interpret error messages that are displayed.
-a: Lists sensors from all nodes in the domain.
-n host1[,host2...]: Specifies which nodes the sensor should be listed for. By default, sensors on the local node are listed. This flag is only appropriate in a management domain or a peer domain.
-A: Displays all properties of all sensors.
-h: Writes the command's usage statement to standard output.

Parameters

name1 [name2...]: Specifies one or more names of sensors for which to display all properties.

Security

The user needs read permission for the IBM.Sensor resource class in order to run lssensor. Permissions are specified in the access control list (ACL) file on the contacted system. See the RSCT Guide and Reference for details on the ACL file and how to modify it.

Exit Status

0: The command has run successfully.
1: An incorrect combination of and parameters has been entered.

If an error occurs in the RMC layer, the RMC return code will be returned as the exit status.

Environment Variables

CT_CONTACT

When the CT_CONTACT environment variable is set to a host name or IP address, the command contacts the resource monitoring and control (RMC) daemon on the specified host. If this environment variable is not set, the command contacts the RMC daemon on the local system where the command is being run. The resource class or resources that are displayed or modified by the command are located on the system to which the connection is established.

CT_MANAGEMENT_SCOPE

Determines the management scope used for the command's RMC daemon session.

The valid values are:

0: Specifies local scope.
1: Specifies local scope.
2: Specifies peer domain scope.
3: Specifies management domain scope.

If this environment variable is not set, local scope is used.

Examples

To list the names of all of the sensors, enter:
```
lssensor
```
To list the names and properties of all sensors, enter:
```
lssensor -A
```
To list the properties of the sensor called NumLogins, enter:
```
lssensor NumLogins
```

Location

/usr/sbin/rsct/bin/lssensor: Contains the lssensor command

Related Information

Commands: chsensor, lsrsrc, mksensor, rmsensor

Books: see the RSCT Guide and Reference for information about the ACL authorization file