ftam(1) CLIX ftam(1)
NAME
ftam - Transfers files among OSI FTAM hosts or between OSI FTAM and TCP
hosts
SYNOPSIS
ftam [-eghqv?] [-o overwrite_mode] [-u realstore_type]
[-s src_host.[user[.[password]]]] [dest_host.[user[.[password]]]]
[command]
FLAGS
-e Echoes input on command line.
-g Disables the expansion of shell metacharacters. Metacharacters are
the question mark (?), the asterisk (*), the open bracket ([), and
the open brace ({).
-h Enables the displaying of number signs (#) during file transfer.
-o overwrite_mode
Sets the creation override mode for existing files.
-u realstore_type
Specifies the type realstore associated with the source or
destination hosts. The default is UNIX. Specify -u 3 to signify
the type is unknown on both hosts; specify -u 2 when the
destination file type is unknown; and specify -u 1 when the source
file type is unknown.
-q Confirms operations involving data transfer.
[-s src_host.[user[.[password]]]]
Provides the login information to connect to the source host.
[dest_host.[user[.[password]]]]
Provides the login information to connect to the destination host.
-v Enables verbose mode. The ftam command displays data transfer
statistics where applicable.
-? Displays the ftam usage string.
[command]
Invokes a specified ftam command.
DESCRIPTION
The ftam command is the interface to the ISO/OSI standard for File
2/94 - Intergraph Corporation 1
ftam(1) CLIX ftam(1)
Transfer, Access and Management (FTAM) Protocol. This command allows a
user to transfer files to and from network sites. Another Intergraph OSI
product, FTAM/FTP, enables ftam to exchange files with nodes on a TCP
network.
The ftam command has an interactive and a noninteractive mode.
To enter noninteractive mode, you must specify the host and any commands
on the command line. When the command completes, you return to the
operating system prompt.
To enter interactive mode, you key in the ftam command and the host
information, if desired. You will then receive an FTAM> prompt at which
you enter commands.
When using ftam, dest-host is the destination nodename for an address
defined in the local /etc/hosts.ftam file. When you use the osiconfig
command to configure ftam, host addresses are written to the
/etc/hosts.ftam file. The username must reside in the /etc/passwd file on
this host. If the login has a password, the password must be supplied.
If a dot (.) followed by a <Return> is specified after host or user, ftam
prompts for user or password (with echoing disabled), respectively.
Otherwise, the word immediately following the dot is assumed to be the
user and/or the password.
The ftam command requires a login to establish a connection to both a
source and destination system. The user may define the source login using
the -s flag. If the -s flag is not specified, ftam uses the local host,
login name, and the same password as the destination login.
COMMANDS
The OSI ftam commands are:
! command [arg ... ]
Invokes an interactive shell on the local host. If there are
arguments, the first is interpreted as a command to execute; the
remaining arguments are the arguments of the command.
append file1 file2
Appends one or more files on the source system to a file on the
destination system.
sappend file1 file2
Appends one or more files on the destination system to a file on
the source system.
cd [dir]
Changes the working directory on the destination system. If dir is
not provided, the initial working directory as defined in the
user's passwd entry is used.
2 Intergraph Corporation - 2/94
ftam(1) CLIX ftam(1)
scd [dir]
Changes the working directory on the source system. If dir is not
provided, the initial working directory as defined in the user's
passwd entry is used.
cdup Changes the working directory on the destination system to the
parent of the current working directory.
scdup Changes the working directory on the source system to the parent of
the current working directory.
chgrp group file
Changes the group of one or more files on the destination system.
schgrp group file
Changes the group of one or more files on the source system.
close Terminates the connection with the destination system.
sclose Terminates the connection with the source system.
dir [file]
Displays a long directory listing for one or more files on the
destination system. If no file is specified, the current working
directory is assumed.
sdir [file]
Displays a long directory listing for one or more files on the
source system. If no file is specified, the current working
directory is assumed.
exit Terminates the connection with the source and destination system
and exits.
expand file
Echoes one or more filenames on destination system after expansion
of metacharacters.
sexpand file
Echoes one or more filenames on source system after expansion of
metacharacters.
fdir file file
Displays long directory listing for one or more files on the
destination system to a local file.
sfdir file file
Displays long directory listing for one or more files on the source
system to a local file.
fls file file
2/94 - Intergraph Corporation 3
ftam(1) CLIX ftam(1)
Displays a directory listing for one or more files on the
destination system to a local file.
sfls file file
Displays a directory listing for one or more files on the source
system to a local file.
get file [file]
Receives one or more files from the destination system to the
source system. If the file on the source system is not specified,
the current working directory is assumed. The file on the source
system must be a directory when receiving more than one file.
help [command]
Displays an informative message about the meaning of the command.
If no argument is given, displays a list of all ftam commands.
ls [file]
Displays a directory listing for one or more files on the
destination system. If no file is specified, the current working
directory is assumed.
sls [file]
Displays a directory listing for one or more files on the source
system. If no file is specified, the current working directory is
assumed.
mkdir dir
Creates a directory on the destination system.
smkdir dir
Creates a directory on the source system.
mv file file
Moves one or more files from the source system to the destination
system. The file on the destination system must be a directory
when moving more than one file.
smv file file
Moves one or more files from the destination system to the source
system. The file on the source system must be a directory when
moving more than one file.
open host.[user[.[password]]]
Connects to another destination system and, if successful, ends the
current connection.
sopen host.[user[.[password]]]
Connects to another source system and, if successful, ends the
current connection.
4 Intergraph Corporation - 2/94
ftam(1) CLIX ftam(1)
pwd Displays the current working directory on the source and
destination system.
put file [file]
Sends one or more files from the source system to the destination
system. If the file on the destination system is not specified the
current working directory is assumed. The file on the destination
system must be a directory when sending more than one file.
quit Synonym for exit.
receive file [file]
Synonym for get.
rm file
Removes one or more files from the destination system.
srm file
Removes one or more files from the source system.
rename file name
Renames the file on the destination system to name.
srename file name
Renames the file on the source system to name.
send file [file]
Synonym for put.
set [c[variable] [value]]
Sets the value of an ftam variable. If the variable parameter is
not specified, a list of all ftam variables are displayed. If
value is not specified, the current value of the variable is
displayed. If value is a question mark (?), all allowed values of
the variable are displayed. The ftam variables and their values
are:
bell Sets the bell to be sounded after file transfer
command is completed. Allowed values are on/off or
0/1.
hash Sets the number sign (#) to be displayed for each
file data block transfer. Allowed values are
on/off or 0/1.
override mode Sets the creation override mode for existing files.
Allowed values are fail: fail the creation
operation, or delete: create a new file with new
attributes.
query Sets the query mode. Ask the user to confirm any
2/94 - Intergraph Corporation 5
ftam(1) CLIX ftam(1)
operations involving file transfers. Allowed
values are on/off or 0/1.
verbose Sets the verbose mode. The command ftam displays
data transfer statistics where applicable. Allowed
values are on/off or 0/1.
glob Disables the expansion of shell metacharacters.
Metacharacters are a question mark (?), asterisk
(*), open bracket ([), and open brace ({).
srealstore Sets the file type on the source host. Allowed
values are 0/1 or unknown/unix.
realstore Sets the file type on the destination host.
Allowed values are 0/1 or unknown/unix.
status Shows the status of the current connection for the
source and destination system.
? [command] Synonym for help.
EXAMPLES
1. The following example illustrates how to noninteractively connect to
an ISO/OSI node named bart, with username joe and password of ask123.
Because a source system has not been specified, ftam requires that the
username and password on the source system be joe and ask123,
respectively. The append command then appends file1 from the source
node to file2 on node bart:
ftam bart.joe.ask123 append file1 file2
2. The following example session does the same as the previous example,
except the password is not echoed to your screen:
$ ftam bart.joe. append file1 file2
Password:
3. The following example illustrates an interactive session with an OSI
node named bart, with username joe and password ask123:
$ ftam bart.joe.ask123
FTAM>
4. After connecting to node bart in the previous example, the following
example illustrates how to transfer file1 from the source node to node
bart, and then rename the file to file2.dat after it is transferred:
6 Intergraph Corporation - 2/94
ftam(1) CLIX ftam(1)
FTAM> put file1
FTAM> rename file1 file2.dat
5. The following example illustrates a connection to a source system
named bart and a destination system named ingr, with ftam executing on
the local node named adams:
$ ftam -q -s bart.joe. ingr.user.
src password required (bart.joe.):
dest password required (ingr.user.):
FTAM> pwd
source directory on bart: /usr/bart
destinationdirectory on ingr: /usr/ingr
FTAM> expand d*
d1
d12
d3
FTAM> send d* /usr/tmp
put d1 /usr/tmp/d1 (y/n)? [y]: n
put d12 /usr/tmp/d12 (y/n)? [y]:
put d3 /usr/tmp/d3 (y/n)? [y]: n
FTAM> rm /usr/tmp/d12
rm /usr/tmp/d12 (y/n)? [y]:
FTAM> set query off
FTAM> set verbose on
FTAM> send d12 /usr/tmp
Sending /usr/bart/d12 to /usr/tmp/d12
13 bytes sent in 0.13 seconds (0.10 kilobytes/s)
FTAM> set override fail
FTAM> send d12 /usr/tmp
FTAM: Unable to send /usr/bart/d12 to /usr/tmp/d12
FTAM: File already exists.
MAP_FTAM: (176) Invalid overwrite parameter
FTAM> exit
$
6. The following example illustrates using the FTAM/FTP gateway product
on a system named simpson to connect from an OSI source system named
bart to a destination TCP system named ingr:
ftam -s bart.user.passwd simpson.user@ingr.passwd
FILES
/etc/hosts.ftam
Addressing information for ISO/OSI applications.
DIAGNOSTICS
2/94 - Intergraph Corporation 7
ftam(1) CLIX ftam(1)
Error messages are self-explanatory.
CAUTIONS
Including a password on the command line is a security risk. To avoid
this security risk, you should enter the password at the password prompt
when echoing is disabled.
EXIT VALUES
A value of 0 indicates success and a value of 1 indicates a failure.
RELATED INFORMATION
Commands: osiconfig(8), ftp(1)
Intergraph ISO/OSI Administrator's Guide
8 Intergraph Corporation - 2/94