Setting up your z/VM guest virtual machine for IUCV

6.10 z/VM guest

You must specify suitable IUCV statements for your z/VM® guest virtual machine.

For details and for general IUCV setup information for z/VM guest virtual machines, see z/VM: CP Programming Services, SC24-6272 and z/VM: CP Planning and Administration, SC24-6271.

Granting IUCV authorizations

Use the IUCV statement to grant the necessary authorizations.

IUCV ALLOW: allows any other z/VM virtual machine to establish a communication path with this z/VM virtual machine. With this statement, no further authorization is required in the z/VM virtual machine that initiates the communication.
IUCV ANY: allows this z/VM guest virtual machine to establish a communication path with any other z/VM guest virtual machine.
IUCV <user ID>: allows this z/VM guest virtual machine to establish a communication path to the z/VM guest virtual machine with the z/VM user ID <user ID>.

You can specify multiple IUCV statements. To any of these IUCV statements you can append the MSGLIMIT <limit> parameter. <limit> specifies the maximum number of outstanding messages that are allowed for each connection that is authorized by the statement. If no value is specified for MSGLIMIT, AF_IUCV requests 65 535, which is the maximum that is supported by IUCV.

Setting a connection limit

Use the OPTION statement to limit the number of concurrent connections.

OPTION MAXCONN <maxno>: <maxno> specifies the maximum number of IUCV connections that are allowed for this virtual machine. The default is 64. The maximum is 65 535.

Example

These sample statements allow any z/VM guest virtual machine to connect to your z/VM guest virtual machine with a maximum of 10 000 outstanding messages for each incoming connection. Your z/VM guest virtual machine is permitted to connect to all other z/VM guest virtual machines. The total number of connections for your z/VM guest virtual machine cannot exceed 100.

IUCV ALLOW MSGLIMIT 10000
IUCV ANY
OPTION MAXCONN 100