TcpLink 3000 CS		INAC Computer Innovative Netzwerkanwendungen

Benutzerhandbuch TcpLink 3000 CS in englischer Sprache

Chapter 5

Sending/Archiving Files

This chapter describes how you can sent files to a TCP/IP network, or how to archive them on magnetic devices. The command syntax is identical for either case. Whether the data are sent to the network or to an archive depends on the contents of the data destination file described earlier.

5.1 Sending/Archiving from the ADAKOS command line

From the ADAKOS command line, files of an arbitrary type may be sent or archived using the TCP program: DISNMR data files, DISNMR parameter files, AU programs, text files etc. TCP can be started from ADAKOS regions 1 or 2. It requires about 40K of the ASPECT memory. If DISNMR is active in ADAKOS region 1, TCP can be started from region 2 by switching temporarily to region 2 using the ADAKOS toggle CTRL/X.

The general syntax for sending/archiving files is

TCP S <file specification>, or TCP <data destination file>:S <file specification>.

The following tables present examples that give you a feeling how to use TCP.

Command	Operation
`TCP S DATA.001`	Send file from disk D1
`TCP S DATA.001=D2`	Send file from disk D2
`TCP S DATA.001 =D2`	Send file from disk D2 (note: space before =D2 allowed)
`TCP S DATA.SER =D2`	Send file from disk D2
`TCP S DATA??*.001`	Send selected files from disk D1 (according to `ADAKOS` wildcard conventions)
`TCP S *. =D2`	Send all files from disk D2
`TCP S DATA.001 =F1`	illegal (note: only disk devices are supported)

These commands will use the default destination (host computer or archive). Remember that the default destination after installation of TCP is the floppy drive connected to you unit. You may change the default according to your needs. The procedure is described later in the section Changing/printing default configuration parameters. The destination name needs therefore not be specified explicitely. This is the preferred way of initiating data transfers to one particular destination. If you have to send data to different hosts or archives, the transfer commands are entered in the following way:

Examples:

Command	Operation
`TCP SUN:S DATA.001`	Send file from disk D1, use 'SUN.TCP'
`TCP INDIGO:S DATA.001=D2`	Send file from disk D2, use 'INDIGO.TCP'

These examples indicate that the command option 'S' is preceded by the name of a data destination file, followed by a ':'. The destination is no longer the default one, but read from sun.tcp or indigo.tcp, or whatever you have chosen.

5.2 Handling of lower and upper case letters

On the ASPECT keyboard you can enter commands in upper and lower case letters.

Whether you type TCP S DATA.SER, or tcp s dat.ser, or TCP s DATA.ser, does not play a role and is equivalent. The command is accepted and executed. The file is stored on the host computer in upper case letters DATA.SER.

Beware, however, when fetching files from a host computer. UNIX systems consider dat.ser, DATA.SER, DATA.ser,... as different files that can reside on disk at the same time. The command tcp g dat.ser will not fetch the file dat.ser from the host, but instead DATA.SER if it exists. Otherwise an error message is issued. The convention in this program is that when sending files they are always stored with upper case letters on the host, and when fetching files from a host the file on the host must have all letters in its name in upper case. This avoids conflicts when transferrring files back and forth between ASPECT and host because ADAKOS can only handle upper case.

5.3 Sending/Archiving from the DISNMR command line

On the DISNMRcommand line, a transfer is initiated by the command

PASC TCP .

Further arguments cannot be specified on the command line. Nevertheless you have the full power of TCP also available in DISNMR. A description follows later in the section Changing/printing default configuration parameters. By default, TCP is configures in such a way that it sends the current DISNMR data set to the default destination. This is the file that was defined by the last DISNMR RE command.

The following table summarizes some important cases.

Command	Operation
`RE DATA.001` `PASC TCP`	define data file send it
`RE DATA.002=D2` `PASC TCP`	data file resides on D2 send it
`DU=D2` `RE DATA.002` `PASC TCP=D1`	set default disk to D2 define data filename on D2 send it (assuming TCP only available on D1)
`DU=D2` `RE DATA.SER` `PASC TCP=D1`	set default disk to D2 define data filename on D2 send it (assuming TCP only available on D1)

5.4 Sending/Archiving from a DISNMR AU program

The DISNMR command PASC TCP described in the previous section may be embedded in AU programs for automatic network transfers or archiving. This section provides some examples.

Example 1:

RF DATA.001 ; define data file RE DATA PASC TCP ; send it (take it from current disk DU) EXIT

Example 2:

RE DATA.SER ; define data file PASC TCP ; send it (take it from current disk DU) EXIT

Example 3:

RF DATA.002=D2 ; define data file RE DATA=D2 PASC TCP ; send it (take it from disk D2) EXIT

Files that are defined in an AU program via the RE @ command may also be transferred by a subsequent PASC TCP command.