IUCONFIG(1c,C)              AIX TCP/IP User's Guide              IUCONFIG(1c,C)



-------------------------------------------------------------------------------
iuconfig



PURPOSE

Configure network interface parameters for IUCV connections.

SYNTAX



                        +-------------------------------------...
                        |
iuconfig -- interface --+- dest_vmid -- userw1 -- userw2 ---+
                        |                                   |-...
                        +- pvm -- dest_nodeid -- dest_vmid -+



          ...-------------------------------+
                                            |
              +--------------+  +---------+ |--|
          ...-|              |--|         |-+
              + buffer=bsize +  + queue=n +



DESCRIPTION

The iuconfig command is used to configure connections between AIX/370 machines.
The connection can be made either through a direct Inter-User Communication
Vehicle (IUCV) connection, or through the VM/Pass-Through Facility (PVM).

When using a direct IUCV connection, vmid must be the VM user ID of the
destination AIX/370 guest.  The two user data words may be any string as long
as they are same and are the same as the user data words specified on the
remote AIX/370 local host.  The user data words are used to distinguish the
path.  Each of vmid, userw1, and userw2 may be up to 8 characters in length.

When connecting through PVM facility, you must supply the node ID of the
destination system, and the VM user ID of the destination AIX/370 guest.

Since PVM supports 32768 bytes only when the target PVM node is running VM/SP
Release 4 or above and PVM 4.2004 PLC 4445 or above, the default maximum
transmission unit for network IUCV interface is 4096 bytes.  This default can
be overridden by the buffer=bsize option described below.

The following parameters may be set by iuconfig:





Processed October 29, 1990      IUCONFIG(1c,C)                                1






IUCONFIG(1c,C)              AIX TCP/IP User's Guide              IUCONFIG(1c,C)



buffer=bsize   Set the maximum transmission unit for the interface to bsize
               kilobytes.  The default value for n is 2 (double buffering).

queue=n        Use single (queue=1), double (queue=2), or triple (queue=3)
               buffering.  The default value for n is 2 (double buffering).

The iuconfig command, when used alone with an interface name, displays the
status of the IUCV connection.

The ifconfig or netconfig command must be used to assign an IP address to the
network IUCV interface after the iuconfig command is used to make an IUCV
connection.

The iuconfig command may be placed in the script
/local/local.init.dir/Sing12multi to establish an IUCV connection automatically
when the system boots.

DIAGNOSTICS

Messages indicating that the specified interface does not exist, the requested
address is unknown, or that a non-privileged user tried to alter an interface's
configuration are provided.

RELATED INFORMATION

In this book:
"ifconfig"
"netconfig"



























Processed October 29, 1990      IUCONFIG(1c,C)                                2