configstk — Configure the AF_UEINT stack
Format
configstk {–s} Configuration_file_name
Description
configstk is used to configure the AF_UEINT stack. This command should initially be run from the /etc/rc script, which is run when z/OS UNIX System Services is initialized. It should also be run each time the AF_UEINT network topology changes after z/OS UNIX services have been initialized.
This command requires superuser authority.
Options
- –s
- Does syntax checking only.
Files
configstk uses
the following file:
- Configuration_file_name
- Specifies the configuration for the AF_UEINT stack. As with any system-wide configuration file, it should have the appropriate permissions set.
This file has two types of specifications,
HOME and GATEWAY. Be careful when modifying the configuration file
to insure that the F_UEINT environment is not corrupted due to user
error.
- HOME ip_address BUFFERS(number) blocking
- This statement is required but you can only specify it once. The
entire statement must be on a single line.
- ip_address
- Defines the single virtual IP address to be used by all RS/6K clients when accessing the z/OS host, independent of how many RS/6K gateways are connected to a given z/OS image. This implementation differs from the standard IP model which defines an IP address per physical adapter.
- number
- Defines the maximum number of 32K page-fixed buffers (in OMVS private memory) that are to be used by the protocol stack. The number specified is be distributed equally among the read and write flows. As new ESCON fibers are added to the configuration, additional IO buffers are required. Thruput decreases and overhead increases if the number specified is too restrictive. You should initially specify a value of 10 times the number of defined gateways for low-to-average use and increase it proportionally as the number of users increase). The maximum number of buffers allocated is the larger of six times the number of active gateways, or the number specified. A decrease in the number is not honored until the next IPL.
- blocking
- Indicates whether the internal blocking algorithm should be activated for outgoing packets. The default is BLOCKING. Specifying NOBLOCKING causes the internal optimization routines, which attempt to group multiple packets into a single blocked I/O, to be bypassed (such as single packet per block written on demand). Specifying BLOCKING minimizes the z/OS overhead and maximizes the ESCON channel bandwidth, but can delay the packet delivery slightly.
- GATEWAY device_number checksum
- At least one of these statements is required and up to 32 can
be specified. The entire statement must be on a single line. This
statement maps the target RS/6K IP addresses to the gateway that will
process the request. The device number to define the gateway must
be the first of an even-odd pair of subchannels (both configured thru
a single ESCON fiber) between
the z/OS image
and the RS/6K gateway. Multiple target IP addresses can be mapped
to a given gateway. A given target IP address can be mapped to at
most one gateway.
- device_number
- Specifies the hexadecimal address of device to be configured. This number must be four hexadecimal digits and must be an even number.
- checksum
- Indicates whether a reliable communications path exists between the communicating applications. Specify CHECKSUM if any portion of the path between the communicating applications is unreliable (such as a LAN). Specify NOCHECKSUM if the entire path is reliable (such as a SP2 fast switch or ESCON).
A list of IP addresses immediately follows this statement, one IP address per line. At least one IP address must be specified for each gateway device. Up to 256 IP addresses can be specified in the configuration file.
Blank lines are permitted and lines beginning with /* are treated as comments.
Examples
/* configure AF_UEINT sockets
/* name the ip address for this node, default to blocking enabled
home 10.32.166.20 buffers(20)
/* configure device 324
gateway 0324 nochecksum
10.34.166.20
10.34.166.24
10.34.166.26
/* configure device b28
gateway 0b28 checksum
10.36.166.20
10.36.166.22
10.36.166.24
10.36.166.26