Commands Reference, Volume 3

lsconn Command

Purpose

Displays the connections a given device, or kind of device, can accept.

Syntax

lsconn { -p ParentName | [ -c ParentClass ] [ -s ParentSubclass ] [ -t ParentType ] } { -l ChildName | -k ChildConnectionKey } [ -f File ] [ -F Format ] [ -h ] [ -H ]

The lsconn command, when used with the -p ParentName flag, displays the connection locations on the parent device to which the device specified by the -l ChildName flag can be connected, or to which devices of the connection type specified by the -k ChildConnectionKey flag can be connected. If the -k and -l flags are not used, the lsconn command displays information as to where a child device can be connected on the specified parent.

If the -p ParentName flag is not used, you must use a combination of one or all of the -c ParentClass, -s ParentSubclass, and -t ParentType flags to uniquely identify the predefined parent device.

You can display the default output, which is the connection location (or connection location and connection key if no child is specified), from the Predefined Connection object class. If you do not display the default, you can display the output in a user-specified format where the Format parameter is a quoted list of column names separated by nonalphanumeric characters or white space using the -F Format flag. You can insert headers above the columns using the -H flag.

You can supply the flags either on the command line or from the specified File parameter.

Flags

-c ParentClass	Specifies the class name of a possible parent device in the Predefined Devices object class. This flag cannot be used with the -p flag.
-f File	Reads the needed flags from the File parameter.
-F Format	Formats the output in a user-specified format where the Format parameter is a quoted list of column names from the Predefined Connection object class separated and possibly terminated by nonalphanumeric characters or white space. Using white space as the separator, the lsconn command displays the output in aligned columns.
-H	Displays headers above the column output.
-h	Displays the command usage message.
-k ChildConnectionKey	Specifies the connection key that identifies the subclass of the child device. This flag cannot be used with the -l flag.
-l ChildName	Specifies the logical name of a possible child device. This flag cannot be used with the -k flag.
-p ParentName	Specifies the parent device's logical name from the Customized Devices object class. This flag cannot be used with the -c, -s, or -t flag.
-s ParentSubclass	Specifies the subclass of a possible parent device in the Predefined Devices object class. This flag cannot be used with the -p flag.
-t ParentType	Specifies the device type of a possible parent device from the Predefined Devices object class. This flag cannot be used with the -p flag.

Examples

To list all possible connection locations on the 8-port asynchronous adapter sa3 that will accept an RS-232 device connection, enter:
lsconn -p sa3 -k rs232
The system displays a message similar to the following:
```
0
1
2
3
4
5
6
7
```
To list all possible connection locations on the standard I/O parallel port adapter that will accept the parallel printer lp3, enter:
lsconn -p ppa0 -k lp3
The system displays a message similar to the following:
```
p
```
To list all possible connection locations and connection types on the 8-port asynchronous adapter sa3, enter:
lsconn -p sa3
The system displays a message similar to the following:
```
0       rs232
1       rs232
2       rs232
3       rs232
4       rs232
5       rs232
6       rs232
7       rs232
```

Files

/usr/sbin/lsconn

Specifies the command file.

Related Information

The chdev command, lsattr command, lsdev command, lsparent command, mkdev command, rmdev command.

Devices Overview for System Management in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices provides information about adding, changing, moving, and removing devices.