DEVICE and LINK — SNA LU0 links statement

Start of changeThis device type will not be supported in a future release. It is recommended that you migrate to a later interface type, such as OSA-Express QDIO or HiperSockets™.End of change

Use the DEVICE statement to specify the name of the address space running the SNALINK program and the remote SNA LU name of the 3745 Communications Controller to which an Ethernet or token-ring is attached. These statements are required for NCPROUTE when using NCP V7R3 or earlier.

Use the LINK statement to define the link on the SNA LU type 0 DEVICE statement. Use this method to configure TCP/IP to access the 3745 adapter through SNALINK.

Syntax

Rule: Specify the parameters in the order shown here.

For more information about missing interrupt handler (MIH) considerations with TCP/IP devices, see Missing interrupt handler factors.

Read syntax diagramSkip visual syntax diagram
>>-DEVICE--device_name--SNAIUCV SNALINK--lu_name--proc_name----->

   .-NOAUTORestart-.   
>--+---------------+-------------------------------------------><
   '-AUTORestart---'   

Parameters

device_name
The name of the device. The maximum length is 16 characters. The same name is specified in the LINK statement.
SNAIUCV SNALINK
Specifies that the connection operates as an SNA LU type 0.
lu_name
The logical unit (LU) name of the remote end. The maximum length is eight characters.
proc_name
The name of the SNALINK started procedure that runs on the host end. The maximum length is eight characters.
AUTORESTART | NOAUTORESTART
Controls device failure reactivation behavior.
NOAUTORESTART
For most device failures, specifying NOAUTORESTART indicates that the TCP/IP address space does not attempt to reactivate this device.
AUTORESTART
In the event of a device failure, the TCP/IP address space attempts to reactivate the device. For more information, see Recovering from device failures.

Syntax

Rule: The optional parameters on the LINK statement following the device_name parameter can be specified in any order.

Read syntax diagramSkip visual syntax diagram
>>-LINK--link_name--+-SAMEHOST-+--link_number--device_name------>
                    '-IUCV-----'                             

   .-IFSPEED 56000-------.  .-SECCLASS 255------------.   
>--+---------------------+--+-------------------------+--------->
   +-IFSPEED - ifspeed---+  '-SECCLASS security_class-'   
   '-IFHSPEED - ifhspeed-'                                

   .-NOMONSYSPLEX-.   
>--+--------------+--------------------------------------------><
   '-MONSYSPLEX---'   

Restriction: There must be only one LINK statement for each SNA LU type 0 device statement.

Parameters

link_name
The name of the link. The maximum length is 16 characters.
SAMEHOST
Specifies that the DEVICE for SNA LU type 0 support uses a SAMEHOST connection.

Note on IUCV: The IUCV keyword remains for migration purposes and is identical to SAMEHOST.

link_number
The link_number must be an integer, but its value is ignored. This parameter is included for consistency with LINK statement formats for other device types.
device_name
The device_name must be the same as specified in the DEVICE statement. The maximum length is 16 characters.
IFSPEED ifspeed
An optional estimate of the interface's current bandwidth in bits per second. The minimum value that can be specified for ifspeed is 0; the maximum value is 2147483647. The default is 56000. This value is accessible to SNMP for management queries, but has no effect on operation of the device.
IFHSPEED ifhspeed
An optional estimate of the interface's current bandwidth in one million bits per second units. The minimum value that can be specified for ifhspeed is 0; the maximum value is 2147. The default is 0. This value is accessible to SNMP for management queries, but has no effect on operation of the device.
SECCLASS security_class
Use this parameter to associate a security class for IP filtering with this interface. In order for traffic over the interface to match a filter rule, the filter rule must have the same security class value as the interface or a value of 0. Filter rules can be specified in the TCP/IP profile or in an IP Security policy file read by the Policy Agent. Filter rules can include a security class specification on the IpService statement in an IP Security policy file or on the SECCLASS parameter on the IPSEC statement in the TCP/IP profile.

Valid security classes are identified as a number in the range 1 - 255. The default value is 255. For more information about security class values, see z/OS Communications Server: IP Configuration Guide.

Restriction: The TCP/IP stack ignores this value if IPSECURITY is not specified on the IPCONFIG statement.

MONSYSPLEX | NOMONSYSPLEX
Specifies whether or not sysplex autonomics should monitor the link's status.
NOMONSYSPLEX
Specifies that sysplex autonomics should not monitor the link's status. This is the default value.
MONSYSPLEX
Specifies that sysplex autonomics should monitor the link's status.

Restriction: The MONSYSPLEX attribute is not in effect unless the MONINTERFACE keyword is specified on the GLOBALCONFIG SYSPLEXMONITOR profile statement. The presence of dynamic routes over this link is monitored if the DYNROUTE keyword is also specified on the GLOBALCONFIG SYSPLEXMONITOR profile statement.

Steps for modifying

See Modifying DEVICE and LINK statements for modifying information.

Examples

In this example, SNALU0 is an SNA Link.
DEVICE SNALU0 SNAIUCV SNALINK LU000000 SNALINK
LINK SNA1 SAMEHOST     1 SNALU0

Usage notes

You can specify multiple LU0 DEVICE statements for the same SNALINK started procedure. A single LU0 address space can support multiple SAMEHOST links. A SAMEHOST link is created for each pair of LU0 DEVICE and LINK statements.

However, you must specify a different lu_name for each DEVICE statement. This value is passed to the LU0 application to establish a session with a remote LU of that name.

Related topics