[Back to NETWORK SWAG index] [Back to Main SWAG index] [Original]
TenTools is a set of utility functions implemented in Turbo Pascal 5.5
which allows easy access to the 10Net network, including the Net Use
function (and Device Cancel function) which is actually implemented through
the DOS $5F (Redirect Device) function call (using Int $21).
All of the functions have been used in programs. Some have been tested more
rigorously than others. This set of tools is being released to the public
domain for usage as you deem possible. I hope they will be of some use to
someone. Before using any functions, PLEASE read all you can first. These
functions have been used on 10Net Plus and work fine. I'm rushing to make
these tools available as I'm soon changing companies!
To use Tentools, the user needs only to "USE" it as a TPU and make
calls to its procedures. Certain steps need to be made to use certain
functions. These steps are explained here:
#1 "USING NETWORK DEVICES"
To use devices (or mount drives) at a Superstation on the network,
first of all the Superstation must be on the network and the local node
must also be "Loaded" with network software. Next, the local user must
"Login" to the Superstation. Once logged into the Superstation, the user
can check on what devices are available ("GetDevices"). Finally, the user
can either "NetUse" the device(s) needed or, if the device is a drive
letter, it can be "Mounted" as a local drive letter. This sequence is
summarized below:
TenTools Function/Procedure Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Attaching:
LOADED Am I on the Network?
NODES Is Superstation available?
LOGIN Attach to Superstation.
GETDEVICES What devices are available?
NETUSE (or MOUNT) Attach to device(s).
Detaching:
UNUSE (or UNMOUNT) Detach from a device.
LOGOFF Detach from a Superstation.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#2 "SENDING CHAT MESSAGES"
To send a 10net Chat message to another node, you don't need to be
attached to the node in any way. Both nodes need to be on the network.
The Chat sequence can be started with the Function "CHAT". For more
information on using Chat, refer to the 10Net manual.
Using Chat from within TURBO Pascal allows you to send a message to
node when a process is finished, or to make them aware that your status
on the network is changing from within your program.
TenTools Function/Procedure Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CHAT Sends a message to another node.
#3 "SENDING/RECEIVING RECORDS"
There is a set of functions available in the 10Net $6F function calls
that allows the user to send and receive "Inter-application" messages.
These messages are limited to 457 bytes each. To make it simpler to use
this function, the toolbox contains a set of expanded Send/Receive
functions, TBSEND and TBRECEIVE. Using these functions, one can send
records of almost any size, limited more by the amount of memory available
than anything else. Read the documentation of each procedure for an in-
depth explanation of how to use them.
One thing to keep in mind when using TBSEND and TBRECEIVE is that
the "Profile" of those workstations/superstations that use Sends and
Receives should include a line to set SBUFFERS=n , where n can be from
8 to 255 (30 or more is recommended here) and DATAGRM=23 (the maximum).
This sets the number of Small Buffers that Sends and Receives use, as
well as maximizing the number of Outstanding Receive Datagrams at 10Net
initialization.
A second thing to remember is that buffers MUST BE allocated for
these functions. This is done with the Tentools function TENCONFIG.
Read the documentation at the TENCONFIG function before using it.
Finally, before using sends and receives on the network, the user
should be aware that Sends directed to a NODENAME that is no longer on
the network will go through a timeout delay waiting for an acknowledgement
that never arrives. To avoid this delay, the user can set up a sender and
receiver on different CB Channels, and messages can be sent using the
CB channel number instead of the NODENAME. Sends on CB Channels require
no acknowledgement. This has its advantages and its disadvantages. While
the timeout delay is avoided, you might still have to develop your own
check for what records were received. TBSEND/TBRECEIVE has an optional
parameter that can be used for record checking, the TRANSACTIONID. There
is also a parameter to use to distinguish between communication functions
or groups, TRANSACTIONTYPE. (There is another variable, ResponseType,
which is not yet completely implemented in this release.)
TenTools Function/Procedure Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TENCONFIG Allocates buffers for records.
TBSEND Sends an InterApp Message.
TBRECEIVE Receives an InterApp Message.
SETWAIT Sets maximum wait time for
TBReceive messages.
SETCBCHANNEL Sets a CBChannel to receive on.
#4 STATUS/INFORMATIONAL FUNCTIONS
There are many informational functions that provide the user with
status, configuration, counts, and other information on the network. Those
provided within TenTools are listed below:
TenTools Function/Procedure Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
STATUS Returns a block of status data from a
node if it is on the network.
LOADED Am I on the network?
NODENAME Returns the local Nodename.
NODES Returns a list of Nodes on the network.
MOUNTLIST What am I mounted to?
LOGLIST Who am I logged to?
MOUNTSAVAIL How many total mounts can I make?
GETDEVICES What devices are at a node?
#5 OTHER FUNCTIONS AVAILABLE
The other functions that are available in TenTools are listed below:
TenTools Function/Procedure Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TIMESTAMP/STAMPAGE Timestamp utilities (used internally)
GETREMOTEMEMORY Grab a block of memory from a remote
node.
SETCBCHANNEL Sets the Channel to listen for.
GETTABLEDATA Used internally; see 10Net Programmer's
Reference Manual for details.
GET10TIME Returns the date/time from a remote
node.
SETUSERNAME Changes the local Username.
SUBMIT Submits a commandline to a Superstation
if Submit Permit is on at Superstation.
SETSPOOL Initiates a "template" for a print
spool.
OPENSPOOL Opens an initiated spool.
CLOSESPOOL Closes/prints an initiated spool.
_____________________________________________________________________________
<10Net><10Net><10Net><10Net><10Net><10Net><10Net><10Net><10Net><10Net><10Net>
-----------------------------------------------------------------------------
What follows is an alphabetical listing of the functions/procedures available
in TenTools and their descriptions:
Function Chat(NodeID : S12; VAR DBuffer {:String[n]} ) : Word;
{ The DBuffer should be a Turbo Pascal String (length indicator in byte 0)
The string should be no more than 100 bytes long. This function sends a
10Net Chat message to the NodeID specified. }
Function CloseSpool : Word;
{ Calls to CloseSpool, after a spool has been started through OpenSpool and
some print has been "sent to the printer", will cause the Spoolfile to
close and printing to begin if the Print Permit is ON at the location
where the printer is mounted.
"Sending print to the printer" is done in the usual manner, from within
programs, by "Typing and Piping" (TYPE>LPT1 <filename>), by Copying from a
file to the printer, etc.}
Function GetDevices(ServerID : S12;
VAR Device : DeviceArray;
VAR DeviceCount : Integer): Word;
{ Returns a list of devices through the Variable parameter Devices (which is
defined as Array[1..25] of S8). Uses the Get/Set/Delete/Get User Shared
Device (Int-$6F,Service-$15) function call.
}
Function GetRemoteMemory(NodeID : S12; VAR DBuffer; VAR DLength : Integer;
RemSeg,RemOfs : Word) : Word;
{Copy a section of memory from a remote node to DBuffer
( maximum of 470 bytes ) }
Function GetTableData(VAR TableBuffer : GetTableDataRec): Word;
{A function which gets the 10Net TableData from a Remote Node}
Function Get10Time(NodeName : S15 ;VAR TenTime : DateTimeRec) : Word;
{Returns the Date and Time in a DateTimeRec Record from the Node Requested)
}
Function Loaded : Boolean;
{ Is 10Net Loaded? }
Function Login(ServerID : S12;PW10Net : S8): Word;
{ Logs into the requested server. }
Function LogList(VAR Logins : LogArray;VAR TableEntries : Integer): Word;
{Returns a list of nodes that the local station is logged into. LogArray
is a TYPE defined as Array[0..19] of String[12] and can be used in the
calling program. }
Function Logoff(ServerID : S12): Word;
{ Logs off the requested server. }
Function Mount(ServerID : S12; LocalDevice,RemoteDevice : Char) : Word;
{ For Drive mounting, mounts drive REMOTEDRIVE at SERVERID as LOCALDRIVE
locally; for printer mounting, use "1" for LPT1, etc. }
Function MountList(VAR MountTable : DriveArray;VAR PrintTable : PrintArray;VAR TableEntries : Integer): Word;
{Returns a mountlist of type DriveTable (with TableEntries as a count of
actual table entries returned), and PrintTable of Printer reassignments.
The caller must specify a maximum tablesize by setting table entries before
calling. Returns with a value of 0 if it worked without any hitches, and the
value of a 10net error if there is any problem. Will return with a value of
$FFFF if not loaded. Will return names of Devices if any are currently
"NetUsed".}
Function MountsAvail : Integer;
{How many total Mounts is the local station configured for?}
Function NetUse(ServerID : S12; LocalDrive : Char; RemoteDevice : String;NetUsePassWord : S8) : Word;
{ Attaches to a Device at a Remote Server. The RemoteDevice can be an ALIAS }
Function NODEName : S12;
{Returns the current nodename }
Function Nodes(VAR NodeBuffer;VAR MaxNodes : Integer;
SuperstationsOnly : Boolean) : Word;
{ A call to this function should be made with NODEBUFFER being an
Array[1..MaxNodes] of S12. MaxNodes being the largest number of nodes you
expect to see on the network. If the Returncode of NODES is 0, MaxNodes will
have the actual number of nodenames returned and the array will be filled
with their names. SuperstationsOnly is a boolean which allows nodes to be
called to list only superstations. }
Function OpenSpool(NewSpoolname : S12) : Word;
{Once SetSpool has "configured" your spool, calls to OpenSpool will
create a new spoolfile with the optional Newspoolname, or with a name
automatically set by 10Net if NewSpoolName=''. }
Function Receive(VAR DBuffer; Secs : Word; VAR Available : Integer; VAR CBMessage : Boolean): Word;
{Receive a data packet on the network in the structure below:
data bytes
=====================
SenderNodeID : 12
Len : 2
Data : (Len)
Available is set to the number of packets available INCLUDING the
current message. Receives data sent through the SEND function, which is
limited to data structures of length 470 or less. TBSend and TBReceive
(which use Send and Receive) can be used for larger structures.
}
Function Send(NodeID : S12; VAR DBuffer; DLength :Integer): Word;
{Send a data packet on the network to NODEID ( or on a CB Channel if
NODEID is CB##, limited to 470 byte packets. Used within the Toolbox to
accomplish TBSend, which allows large records to be sent.}
Procedure SetCBChannel(CBChannel : Byte);
{ This procedure will set your "Listening" Channel to the CBCHANNEL (1
through 40 are available) specified. TBSends to this CBChannel from other
nodes will be available here through TBReceive. TBSends to other CBChannels
will not be seen here. TBSends directed specifically to this node will also
be seen here, of course.
The advantages of CB messaging are that many nodes can be setup to
receive messages on a particular channel, and the sender will not be held
up waiting for a network handshake to tell him that his Send was Received.
}
Function SetSpool(Printer : Byte; SpoolName : S12; Notification : NotifySet; RDays : Byte): Word;
{ When SetSpool is first called, it merely sets up a "Template" for
subsequent calls to OpenSpool and CloseSpool. You must be logged into the
Superstation where you want to spool and be mounted to a printer and a
drive on that Superstation. SetSpool will determine where the Printer
(1,2, or 3 for your local LPT1:,LPT2:, or LPT3:) is mounted and a drive
letter that you are mounted to. }
Procedure SetUserName(UName : S8);
{Changes the Username in the Network Table and in the Global variable
USERNAME}
Function SetWait(WaitLimit : Integer): Word;
{ Changes the maximum seconds to wait for receive packets in the same record,
Defaults to 30. Used in conjunction with TBReceive.}
Function StampAge(StartTime : Real): LongInt;
{ Returns the difference in seconds between the currenttime and the
"Starttime" timestamp.}
Function Status(NodeName : S15; VAR SBlock : StatusBlock): Word;
{ Returns a Block of Status information from the Nodename requested if
that node is on the network.}
Function Submit(ServerID : S12; CommandLine : String): Word;
{ If the local User is LOGGED INTO the node SERVERID, and the submit permit
is ON at ServerID, and ServerID is currently at a DOS prompt, then the
Commandline will be SUBMITTED to ServerID. If it is not currently at a DOS
prompt, it will be SUBMITTED when it reaches a DOS prompt. }
Function TBReceive( VAR SenderID: S12; {Sending NodeID : String12 }
VAR DBuffer; {Variable (record) to receive }
VAR DLength : Integer; {Maximum length record to receive}
VAR TransactionID : TID; {See description of TBSend }
VAR TransType : Integer; {See description of TBSend }
VAR Available : Integer; {Number of records available
including the one passed back }
VAR CB : Boolean) {Was this a CB transmission? }
: Word; {Return code indicates a 10Net error($XXFF)
or an error in a passed parameter ($FFXX)}
Function TBSend(NodeID : S12; {Node to send to }
VAR DBuffer; {The data record }
DLength : Integer; {Length (bytes) of data }
TransactionID : TID; {Tag to identify record (6 bytes)}
TransType : Integer; {Transaction Type - (external to
this toolbox) an integer type used
to maintain that one is receiving
only the correct type of records.}
ResponseType : Byte { Not Implemented yet...
How is the TBReceive to act-
0 - no immediate response
1 - Acknowledge when total message received
2 - Acknowledge each packet }
) : Word;
{ TBSend will send a large interapplication message (DBuffer) of length
DLENGTH across the network. The TransactionID is user defineable and can be
used to acknowledge the receipt or processing of a record to the originator.
TransType, optional, can be used to identify the type of processing required
of a record. The data in DBuffer can be of any structure.
The message is effectively broken into packets, and sent with a
"packet marker" to assist in its reconstruction when received. Unique
Transaction IDs is essential for records larger than 457 bytes to maintain
unique record identity. Packet Data consists of a PRec (see data Type
definitions) and 457 bytes of the DataRec.
The network provides handshaking with Sends and Receives if they are
directed to a particular node. If CB# is used instead, there is no
handshaking provided. If a node is specified, and it is not currently
available or its 10Net SBuffers buffering is full, the sending node will
be stuck waiting for a timeout or until the receiver or buffer space appears.
For this reason, in some applications which can't be held up waiting, it is
wise to use CB channel communication. (See the "SetCBChannel" function for a
discussion of its usage.)
}
Function TenConfig(MaxSendRec,MaxRecvRec : Integer; {Size of largest records
to send/receive}
MaxRecs : Integer) {Maximum number of Records to recv}
: Word;
{ This function allows the user to dynamically change the size of the
buffers being used by TBSend and TBReceive to optimize usage.
MaxSendRec is the size of the largest TBSEND record
MaxRecvRec is the size of the largest TBRECEIVE record
MaxRecs is the number of TBReceive records to buffer
}
Function TimeStamp : Real;
{Returns a timestamp of 6 bytes ordered, Year,Month,Day,Hour(24),Minute,
Second }
Function UnMount(LocalDrive : Char) : Word;
{ Unmounts previously mounted drive or printer }
Function UnUse(LocalDrive : Char) : Word;
{ Detaches from a shared device at a remote server. The attachment was made
through a Net Use (or NetUse), and the local drive letter is all that is
needed to detach}
Function UpCase8(Str_8 : S8): S8;
{Expands and "Upcases" an 8 character string}
Function UpCase12(Str_12 : S12): S12;
{Expands and "Upcases" a 12 character string}
[Back to NETWORK SWAG index] [Back to Main SWAG index] [Original]