Configuring a HiperSockets device for AF_IUCV addressing

Ubuntu 22.04 LTS LPAR mode z/VM guest

Use the hsuid attribute of a HiperSockets device in layer 3 mode to identify it to the AF_IUCV addressing family support.

Before you begin

  • Support for AF_IUCV based connections through real HiperSockets requires Completion Queue Support.
  • The device must be set up for AF_IUCV addressing.

Procedure

To set an identifier, issue a command of this form: 
# chzdev qeth 0.0.a007 hsuid=<value>
This setting persists across re-boots. For more details, see Persistent device configuration.
To apply this setting to the running system only, use the chzdev command with the -a option or the sysfs attribute hsuid:
# echo <value> > /sys/bus/ccwgroup/drivers/qeth/0.0.a007/hsuid
The identifier is case-sensitive and must adhere to these rules:
  • It must be 1 - 8 characters.
  • It must be unique across your environment.
  • It must not match any z/VM® user ID in your environment. The AF_IUCV addressing family support also supports z/VM IUCV connections.

Example

In this example, MYHOST01 is set as the identifier for a HiperSockets device with bus ID 0.0.a007. 
# chzdev qeth 0.0.a007 hsuid=MYHOST01
Or, for the running configuration only using sysfs:
# echo MYHOST01 > /sys/bus/ccwgroup/drivers/qeth/0.0.a007/hsuid