PicLan - Networking for Pick

(C) Copyright 1990-1998 Modular Software Corporation. All rights reserved.

Version - February 28, 1998

   Goto:  Table of Contents   Index
Chapter:  1 2 3 4 5 6 7 8 9 10 11 12 13 14

14: UPBOARD DOS Functions

This section deals with the PicLan for UPBOARD implementation only.
The PL-UPBRD.EXE DOS executable program is used to make DOS network device drivers available to the UPBOARD Pick Operating System. It must be executed in place of the UPBOARD.EXE program that is supplied with the UPBOARD operating system. Actually, the PL-UPBRD.EXE program is a small driver that then shells the original UPBOARD.EXE program. The format of the PL-UPBRD.EXE program is:

    PL-UPBRD {PicLan options} UPBOARD {UPBOARD options}
UPBOARD options include /ex for extended memory, etc. They are described in the UPBOARD documentation.

PicLan PL-UPBRD.EXE options are used primarily to setup network connection control blocks and buffers. Each PicLan connection, whether a terminal session or a file-transfer or printing function, requires a connection control block and connection buffer space. Connection buffer space is further divided into inbound and outbound buffer space. The PL-UPBRD.EXE program defaults to the following space allocations:

These default values will produce good performance for systems with up to 8 terminal users (attaching to 8 ports) and up to 3 file transfer and remote printer concurrent users. If your installation is larger than this, you will need to specify the following options when you execute the PL-UPBRD.EXE program.

/mt=## MaxTerm - Change the number of terminal connection control blocks to the number specified. Minimum is 1 and maximum is 128.

/mx=## MaxXfr - Change the number of transfer connection control blocks to the number specified. Minimum is 1 and maximum is 128.

A maximum of 256 total control blocks is allowed.

When you establish a connection control block with these options, the PL-UPBRD.EXE program will allocate space (memory) for the control block, and will also allocate buffer space for that control block to utilize. Within the 640K DOS memory area, a number of program must load and allocate memory. These program include:

It is possible (even likely) that allocating the maximum number of connection control blocks within PicLan will use up enough memory that the UPBOARD.EXE program will not have enough room to run. Even if you reduce the number of connections somewhat, the UPBOARD.EXE program may not have enough memory to run efficiently (when the UPBOARD.EXE program is low on memory, it cannot allocate and use as much extended or expanded memory disk cache). If is for these reasons that you should conserve DOS memory. You should take the following steps when you are executing with large numbers of PicLan connections with the Sanyo/Icon UPBOARD:

If you are running low on memory, the UPBOARD may allocate less disk cache buffer memory than you would expect. If you think this is the case, try running the UPBOARD.EXE program without the PL-UPBRD.EXE driver and see how much disk cache memory is utilized. If the amounts differ, consider the following guidelines:

If you believe that you are still running into memory problems, you may wish to configure your system to make the maximum amount of DOS memory available to PL-UPBRD.EXE and UPBOARD.EXE.

Unfortunately, all of these suggestions are not compatible or practical with all systems so you may have to experiment with them to find the mix that works best. Remember, the UPBOARD implementation is a DOS program on the host PC first, and you can use most DOS memory enhancement methods with good success. Also remember that you have a host PC that has more hardware installed into it than the norm, so you must be careful to configure memory management software so that it recognizes the hardware that you have added (network cards and co-processor board) and does not conflict with the hardware's memory addressing (shared board memory).

14.1: Using Expanded / Extended Memory

The PL-UPBRD.EXE program can optionally use Expanded or Extended memory for PicLan control block and communications buffers. The advantages of using this type of memory are:

Disadvantages to using Expanded or Extended memory are:

If you wish the PL-UPBRD.EXE program to allocate it's communications buffer and control block memory in expanded memory, add one of the following command-line options to the PL-UBPRD.EXE command:

/exp - Use Expanded Memory

/ext - Use Extended Memory

It is highly recommended that use of Expanded or Extended memory be thoroughly tested on your installation before allowing live users to use the system.

   Goto:  Table of Contents   Index
Chapter:  1 2 3 4 5 6 7 8 9 10 11 12 13 14