FTAM(1C)

NAME
ftam - interactive ftam initiator

SYNOPSIS
ftam [options] [host] [command arguments ...]

DESCRIPTION
The ftam program implements the initiator side of the File Transfer, Access, and Management (FTAM) service.

Currently, implementations for Berkeley and AT&T UNIX exist. Supported are: the no-recovery FTAM-QoS; any of the transfer, management, and transfer and management service classes; the kernel, read, write, limited file management, enhanced file management, and grouping functional units; and, the kernel and storage attribute groups. Only three document types are supported as of this writing: unstructured text files (FTAM-1), unstructured binary files (FTAM-3), and filedirectory files (NIST-9).

Typing INTR at the top-level does nothing, but typing it twice in a row at the top-level terminates ftam; typing INTR during additional prompting causes ftam to abort the command; typing INTR during file transfer causes the transfer to be aborted.

On start-up, ftam will read a file called .ftamrc in the user's home directory. This file, if present, contains user-preference commands.

COMMANDS

append source destination
    Appends to a file in the filestore.

cd [dir]
    Changes the working directory on the virtual filestore. This requires the realstore variable to be set appropriately.

chgrp group file ...
    Changes the account attribute of the named files.

close
    Terminates the association with the virtual filestore.

dir [file]
    Prints a long directory listing.

echo file ...
    Simply echoes any arguments. Useful for seeing how globbed expressions will evaluate.

fdir stream [file]
    Prints a long directory listing to a file or program. If “stream” starts with a vertical bar “|”, then the named program is invoked; otherwise the named file is written.

fls stream [file]
    Prints a directory listing to a file or program. If “stream” starts with a vertical bar “|”, then the named program is invoked; otherwise the named file is written.

get source destination
    Retrieves a file.

help [command]
    Prints help information. For detailed information, try “help ?”.

lcd [file]
    Changes the working directory on the local system.

ls [file]
    Prints a directory listing.

mkdir dir ...
    Creates a directory.

mv source destination
    Renames a file.

open host user [account]
    Associates with the virtual filestore. The host parameter can be a full ISODE style presentation address, the name of an entity from the isoentites file, or if the dase service is used, an OSI directory name.

put source destination
    Stores a file.

pwd Prints the working directories.

quit
    Terminates the association with the virtual filestore and exits.

rm file ...
    Deletes a file.

set variable value
    Displays or changes variables. For detailed information, try “set ?”.

status
    Shows the current status.

VARIABLES

bell
    Rings the bell after each command terminates. Useful for long file transfers when you want to attend to other matters and be notified when you can type another command. Boolean (values: on or off).

concurrency
    Requests concurrency control for transfers. Values: off; on.

debug
    This enables voluminous output during file transfers, among other things. Boolean.

glob
    This enables the expansion of shell meta-characters. Operations which perform globbing require the realstore variable to be set appropriately. Boolean.

hash
    This enables the printing of hash marks during file transfers. Values: off; on; total.

override
    This sets the creation override mode for files being written to the virtual filestore. Values: fail, the creation operation; select, use the existing file with its old contents and attributes (i.e., the put command acts like the append command); write, zero-truncate if it already exists, and use the existing file with its old attributes; delete, if it already exists, then create a new file with new attributes. This defaults to “write”.

qualifier
    This sets the “qualifier” portion of the service which ftam will associate with. It is needed when using the current implementation of the MITRE FTAM/FTP gateway. This defaults to “filestore”.

query
    This determines if ftam should ask the user to confirm operations involving globbing that expand to more than one filename. Boolean. This defaults to “on”.

realstore
    Sets the type of remote realstore associated with the virtual filestore. This is used to help ftam act friendlier to the user! Values: unix, unknown. Note well: the concept of a realstore is contrary to the notion of open systems as it is an N*M (not N+M) method.

trace
    This enables the tracing of FTAM PDUs. Boolean.

tracefile
    This defines the file where tracing information is appended. Note that the pathname of this file is interpreted relatively to the ISODE logging area. To have tracing information written to a file in the current directory, start the filename with “./”.

type
    This defines the file transfer mode to use. Values: default, binary, text.

verbose
    This enables printing of informative diagnostics during operation. Boolean.

watch
    This enables watch mode, something in between debug mode (too voluminous), and verbose mode (not informative enough). Boolean.

userdn
    This defines the Distinguished Name to be used when binding to the Directory for AE-lookup. DN-string.

xsapfile
    This defines the file where xPDU tracing information is appended. Value: any filename, or “-” for the diagnostic output.

xsaplevel
    This enables tracing of the x module. Values: none, fatal, exceptions, notice, pdus, trace, debug, and all.

OPTIONS

-a acct
    Sets the account to be used on the virtual filestore.

-c mode
    Sets concurrency.

-d  Sets debug.

-f  Inhibits reading of the user's .ftamrc on startup.

-h  Sets hash.

-o mode
    Sets override.

-t  Sets trace.

-u user
    Sets the initiator identity to be used on the virtual filestore.

-v  Sets verbose (default for interactive use).

-w  Sets watch.

FILES
isodocuments	ISODE FTAM document types database
isoentities	ISODE entities database
$HOME/.ftamrc	runcom file

SEE ALSO
libftam(3n), ftamd(8c),
The ISO Development Environment: User's Manual,
ISO 8571: Information Processing Systems -- File Transfer, Access, and Management

DIAGNOSTICS
All obvious.

AUTHOR
Marshall T. Rose
This program is based heavily on the ftp(1c) program supplied with Berkeley UNIX.