Eiconcard Connections for Linux Contents Previous Next

Advanced Eiconcard Services Configuration

This section describes the advanced Eiconcard Services Configuration. Configurable parameters for both the Eiconcard Streams Device Driver and the Eiconcard Advanced Driver are explained, followed by the steps required to change the parameters.

 
Eiconcard Streams Device Driver Parameters

 
Maximum Clone Devices

The Maximum Clone Devices parameter defines the number of Eiconcard virtual devices that may be opened concurrently. While typical applications use a single device, some require several. This value is not directly related to the number of network circuits, such as virtual circuits on an X.25 network. An application may use a device that does not correspond to a network circuit. Therefore, the number of devices must be higher than the number of circuits.

 
Total Request Buffers Allocated

The Total Request Buffers Allocated parameter defines the number of request buffers to be allocated for the Eiconcard Streams Device Driver. Request buffers are used to transfer commands between the Eiconcard Driver and the Eiconcard.

By default, the Eiconcard Streams Device Driver has a total of 128 request buffers enabled. Each request buffer requires 20 bytes. Once allocated, the memory configured for the Eiconcard Streams Device Driver is never returned to the system. Approximately 2560 bytes of memory is reserved for 128 request buffers. The value you should configure for this parameter depends on:

The number of simultaneous sessions on the Eiconcard.
System memory available.
The volume of traffic on the Eiconcard.
How many Eiconcards are installed in the system.

In high-stress environments (for example, when you also have Eicon Routing Services running on your system), it may be appropriate to configure additional request buffers per Eiconcard, provided you have sufficient memory in your system.

For Eiconcard Connections for Linux, the number of request buffers configured for the Eiconcard Streams Device Driver is automatically increased during the configuration of the Host PAD and Terminal PAD drivers.

 
Load/Self-test Timeout Period

The Load/Self-test Timeout Period parameter is the maximum time in seconds that the load/self-test procedure is permitted to take before assuming that a system hardware or software failure has occurred.

 
Eicon Character-Compatibility Driver Parameters

 
Total Request Buffers Allocated

As with the Eiconcard Streams Device Driver, the Total Request Buffers Allocated parameter defines the number of request buffers to be allocated for the Eicon Character-Compatibility Driver. Request buffers are used to transfer commands between the Eicon Character-Compatibility Driver and the intermediary Eiconcard Streams Device Driver.

The Eicon Character-Compatibility Driver has a total of 128 request buffers enabled at installation. Each request buffer requires 20 bytes. Once allocated, the memory configured for the Eicon Character-Compatibility Driver is never returned to the system. Approximately 2560 bytes of memory is reserved for 128 request buffers. The value you should configure for this parameter depends on:

The number of simultaneous sessions on the Eiconcard.
How much memory your system has.
The volume of traffic on the Eiconcard.
How many Eiconcards are installed in the system.

In high-stress environments (for example, when you also have several third-party applications running on your system), it may be appropriate to configure additional request buffers per Eiconcard, provided you have sufficient memory in your system.

Other Eicon drivers, such as the Eicon Host PAD driver, may add more buffers to this number. This means that the actual number of reserved buffers may be larger than the value previously configured for this driver.

Note: Buffer Requirements for X.25 Development Tools: Each function call request from the X.25 programming library requires at least four request buffers. Therefore, with a default of 128 request buffers, you can make 32 concurrent requests from the X.25 programming library.

 
Total Data Buffers Allocated

By default, 128 data buffers are reserved for the Eicon Character-Compatibility Driver. If you modify this value, make sure that the value you specify is greater than or equal to the number of request buffers. The Eicon Character-Compatibility Driver reserves 256 bytes per buffer at initialization.

Given that the data buffers are reserved for the Eicon Character-Compatibility Driver, you may want to specify a lower value if, for example, you are not using the Development Tools and are using less than 32 Host PAD devices. The Eicon Host PAD driver may also add buffers to the value specified for the Eicon Character-Compatibility Driver. Therefore, the total number of reserved data buffers may be larger than the value previously configured for this driver.

Note: Data buffers are also used by X.25 Development Tools requests. For example, with an X.25 application, an x25send( ) or x25recv( ) that uses a 4K buffer to send or receive data requires 16 data buffers; 4096 bytes (16 x 256) are used in this case.

 
Watchdog Wake Up Period

This parameter serves to monitor the Eicon Character-Compatibility Driver's usage of resources. A watchdog task is activated periodically to clean up requests that belong to defunct processes and release their resources. By default, this occurs every 30 seconds.

 
Eiconcard Advanced Driver Options Configuration

To configure the Eiconcard Advanced Driver Options, run eiconcfg, and follow these steps:

1. Select the Eiconcard Services Driver Configuration option.
2. Select option 2, Configure Advanced Driver Options. The current Eiconcard Streams Device Driver configuration is displayed.
3. You are prompted to enter y if you wish to change the configuration.
4. Select option 1, Change Eiconcard Streams Device Driver Configuration, or option 2 Change Eicon Character-Compatibility Driver Configuration.
5. Enter the parameters as prompted or press Enter to accept the default values. If you enter h, help information will be displayed for the related parameter.
6. After you specify a value for the last parameter, enter q to quit or b to go back to the previous screen if you are configuring other options within eiconcfg.

 

Eiconcard Connections for Linux Contents Previous Next

Copyright (c) 2001 Eicon Networks