Changing the peer

6.10 z/VM guest

You can change the z/VM® guest that an interface connects to, or the path name used for the connection, or both.

Before you begin

The interface must not be active when changing the peer.

Issue a command of this form:

# echo <peer_id>.<path_name> > /sys/bus/iucv/drivers/netiucv/netiucv<n>/user

where:

<peer_ID>: is the z/VM user ID of the new communication peer. The value must be a valid z/VM user ID.
.<path_name>: identifies an individual path to a peer z/VM guest. This specification is required for setting up multiple paths to the same peer z/VM guest. For setting up a single path to a particular peer z/VM guest, this specification is optional and can be omitted. The path name can be up to 16 characters long. The peer must use the same path name when setting up the peer interface.
<n>: is an index that identifies the IUCV device and the corresponding interface.

The NETIUCV device driver interprets the specification as uppercase.

In this example, LINUX22 is set as the new peer z/VM guest for interface iucv0.
```
# echo linux22 > /sys/bus/iucv/drivers/netiucv/netiucv0/user
```
In this example, LINUX22 is set as the new peer z/VM guest for iucv1 and PATH1 is set as the path name.
```
# echo linux22.path1 > /sys/bus/iucv/drivers/netiucv/netiucv1/user
```