smcd - Display information about SMC-D link groups and devices

6.10 LPAR mode z/VM guest KVM guest

SMC-D connections are based on ISM devices, see Internal shared memory device driver.

Where:

Generic options

These options are available for all subcommands.

show: depending on the subcommand, displays information about link groups, devices, statistics, the system enterprise ID (EID), or user defined EIDs. This is the default option.
-h or --help: displays help information for the specified subcommand. To view the man page, enter man smcd.

linkgroup options

The linkgroup subcommand displays information about SMC-D link groups and links.

all: displays information about all link groups. This is the default.
<LG-ID>: limits the information to the specified link group.

device options

The device subcommand displays information about SMC-D devices.

all: displays information about all SMC-D devices. This is the default.

stats options

The stats subcommand displays statistics for SMC-D.

-d or --details: displays detailed SMC-D statistics.
-a or --absolute: ignores any counter resets and displays statistics beginning with smc module load.
reset: displays the current statistics and resets all SMC-D statistics counters to zero.
json: displays the current statistics in JSON format.

seid options

The seid subcommand controls the system EID.

enable: uses the system EID for your Linux® instance.

disable: does not use the system EID for your Linux instance. At least one user defined EID must exists. A disabled system EID is automatically enabled when the last user defined EID entry is deleted.

ueid options

the ueid subcommand manages user defined EIDs.

add <ueid>: add a user defined EID.
For <ueid>, specify up 32 uppercase alphabetic (A-Z) characters, numerals (0-9), hyphens (-), and dots (.). The first character must be alphanumeric, and dots must not be consecutive.
del <ueid>: delete the specified user defined EID.
flush: delete all user defined EIDs.

-v or --version

displays version information.

Output columns for linkgroup and device

In the output table, the columns headers have the following meanings:

FID

Function ID of the PCI device.

Type

Type of the underlying PCI device. For SMC-D connections, the type is ISM.

PCI-ID

ID of the PCI device.

PCHID

Physical channel ID of the PCI device.

InUse

Shows whether the ISM device is in use. The value can be:

Yes: At least one link group runs on the ISM device.
No: No link group runs on the ISM device.

#LGs

Number of link groups on the device.

PNET-ID

PNET ID of the device. A leading asterisk (*) means that the PNET ID is set by the user. For example, *NET1.

Output of stats

For the output of the stats sub-command, see Obtaining statistics for SMC connections.

Examples

To display all SMC-D devices, issue:

# smcd device 
FID   Type PCI-ID        PCHID  InUse #LGs  PNET-ID
02e1  ISM  0002:00:00.0  07c2   No       0  NET1

The same output results with the command: smcd device show all.

To show SMC-D statistics:
```
# smcd stats
```
To show detailed SMC-D statistics and reset SMC-D statistics counters:
```
# smcd -d stats reset
```
To ignore any counter resets and show detailed SMC-D statistics since module load in JSON format:
```
# smcd -da stats json
```
To show all user defined EIDs.
```
# smcd ueid
BUILDING-19
BUILDING-04
```

To show the system EID.

# smcd seid IBM-SYSZ-ISMSEID000000002E488561 [enabled]

To disable the system EID.
```
# smcd seid disable
```