[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

IOCINFO (Identify Device) x25sioctl X.25 Device Handler Operation

Purpose

Returns I/O character information for an X.25 device.

Description

The IOCINFO x25sioctl operation returns I/O character information for an X.25 device. The parameter block for this operation is defined in the /usr/include/sys/definfo.h file by the devinfo structure. This structure contains the following fields:

devtype Identifies the type of device. This is set to the DD_X25 value (defined as the ASCII character x).
flags Undefined for X.25 devices.
devsubtype Undefined for X.25 devices.

In addition to the above members, the /usr/include/sys/devinfo.h file also contains an x25 structure (found in the /usr/include/sys/x25user.h file). This structure defines the X.25 device and contains the following members:

support_level Identifies a support level of 1980 or 1984.
nua Contains a null-terminated ASCII string that represents the network-user address.
subscription_facilities_supported
                          Contains device-dependent information.
network_id Specifies the identification code for the network. The range and default value for this code is defined by the device configuration.
max_tx_packet_size Specifies the maximum size of a transmitted data packet. This packet is encoded in the manner of the ISO 8208 definition.
max_rx_packet_size Specifies the maximum size of a received data packet. This packet is encoded in the manner of the ISO 8208 definition.
default_svc_tx_packet_size Specifies the default transmit packet size for a switched virtual circuit (SVC). This packet is encoded in the manner of the ISO 8208 definition.
default_svc_rx_packet_size Specifies the default received packet size for an SVC. This packet is encoded in the manner of the ISO 8208 definition.

Permanent Virtual Circuit (PVC) Packets

PVC packet sizes are configured on a per-PVC basis. To determine the packet size on a PVC you can use either of the following operations:

Execution Environment

The IOCINFO operation can be called from the process environment only.

Return Values

A return code of -1 indicates an unsuccessful operation. The kernel sets the errno global variable to the following value:

EFAULT Indicates an invalid address.

Implementation Specifics

The IOCINFO operation functions with an X.25 Interface Co-Processor/2 that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.

Related Information

The CIO_QUERY x25sioctl X.25 Device Handler Operation, CIO_START x25sioctl X.25 Device Handler Operation, X25_QUERY_SESSION x25sioctl X.25 Device Handler Operation.

[ Previous | Next | Contents | Search ]