POWER7 information

lssvc command

Purpose

Lists the available agents and services.

Syntax

lssvc [AgentName]

Description

The lssvc command lists all the available agents and services that can be managed by the Virtual I/O Server command-line interface. If an agent name or service name is passed to the lssvc command, a list of attributes with their configured values is displayed. These agents and services are managed by the cfgsvc, startsvc, and stopsvc commands.

Agent or service names

The following agents can be managed by the Virtual I/O Server.

Agent	Description
DIRECTOR_agent	Lists the attributes and values for the IBM® Systems Director agent.
ITM_premium ITM_cec	Lists the attributes and values for the IBM Tivoli® Monitoring agents.
TSM_base	Lists the attributes and values for the IBM Tivoli Storage Manager agent.
ITUAM_base	Lists the attributes and values for the IBM Tivoli Usage and Accounting Manager agent.
TPC	Lists the attributes and values for the TotalStorage Productivity Center agent.
perfmgr	Does not have attributes that the user can set. See the postprocesssvc command for more information about working with this agent.
ipsec_tunnel	Lists the secure tunnels that are created on the system. If none are created, the message No tunnels created is displayed.
ILMT	Lists the IBM License Metric Tool (ILMT) server that is configured and the agent status on Virtual I/O Server.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

To list available agents, type the command as follows:
```
lssvc
```

To list values of attributes by agent name, type one or more of the commands as follows:

lssvc ITM_premium

lssvc ITUAM_base

lssvc TSM_base

These commands produce the output as follows:

 	$lssvc ITM_premium
		HOSTNAME:tems_server
		MANAGING_SYSTEM:hmc_console
		RESTART_ON_REBOOT:TRUE

 	$lssvc ITUAM_base
		ACCT_DATA0:
		ACCT_DATA1:
		ISYSTEM:
		IPROCESS:

 	$lssvc TSM_base
		SERVERNAME:
		SERVERIP:
		NODENAME:

To list the mandatory attributes (for IBM TotalStorage Productivity Center) with their configured values, type the command as follows:
```
$lssvc TPC
```
This command produce the output as follows:
```
 	$lssvc TPC
		A:
		S:
		devAuth:
		caPass:
```

To list the status of ipsec tunnels on the Virtual I/O Server, type the command as follows:

$lssvc ipsec_tunnel

This command produces the output similar as follows:

Phase   Tun Id      Status      Local Id     Remote Id      
1       1           Dormant     N/A          4.3.2.1
2       1           Dormant     1.2.3.4      4.3.2.1

ILMT

To list ILMT details, type the command as follows:
```
$lssvc ILMT
```
This command produces the output as follows:
```
Server: 1.2.3.4
Agent Status: active
```

Related Information

The cfgsvc command, the startsvc command, the stopsvc command, and the postprocesssvc command.

For more information about the various agents, see the following information:

Send feedback Rate this page

Last updated: Wed, June 03, 2015