ftmv(1C) FTAM 3.00 ftmv(1C)
NAME
ftmv - FTAM file move program
SYNOPSIS
ftmv [ [ options ] src-ftam-file-spec dst-ftam-file-spec ]
DESCRIPTION
Ftmv moves a file from one filestore to another. If the
transfer is successful, the source file is deleted.
Otherwise, the source file is the same as before the
transfer attempt.
If you invoke ftmv without arguments, you are prompted for
the source and destination file specifications.
You may group options behind the - character provided that
not more than one option takes the next word as an argument.
-v1|v2|v3 Verbosity level. Print network event
information. Default is no network event
reporting.
-v1 Connection level. Report the creation and
termination of connections to local and
remote filestores as they occur.
-v2 PDU (packet) identification level. Identify
request and response PDUs as they are sent or
received. Connection information is also
printed.
-v3 PDU dump level. Print a textual
representation of each PDU that is sent or
received. A large amount of useful
information is printed. Connection
information and packet identification are
also printed.
-z num Specify an association timeout value. Num is
the maximum number of seconds to wait for a
network event to complete before returning an
error. Making the association timeout small
prevents unnecessary delays when there are
communications problems. If this option is
not specified or if num equals zero,
associations do not timeout.
Lower layers of the protocol stack may
timeout network events even if an FTAM
association timeout is not set.
Licensed material--property of copyright holder(s) Page 1
ftmv(1C) FTAM 3.00 ftmv(1C)
-i Prompt for missing filestore information. If
the ftam-file-spec does not specify the
initiator identity and/or password for a
remote filestore, prompt the user for the
missing information. The password is not
echoed.
-w Prompt for FTAM file passwords. Most FTAM
responders do not support file passwords.
This option prompts for all eight FTAM file
passwords and is independent of the FTAM
operation specified.
-f1|f2|f3|fg Transfer the source file as a particular
contents type. The source file must be on
the local filestore. Revision 3.00 FTAM for
AViiON Systems temporarily overrides the
current values of the file's contents type
attributes and uses the specified contents
type with default document type parameters.
-f1 Transfer the source file as an unstructured
text file (FTAM-1 file).
-f2 Transfer the source file as a sequential text
file (FTAM-2 file).
-f3 Transfer the source file as an unstructured
binary file (FTAM-3 file).
-fg Make a 'best guess' of the source file
contents type. Ftmv examines the first 128
bytes of the source file. If it finds non-
text characters, it transfers the file as an
FTAM-3 file; otherwise, it transfers the file
as an FTAM-1 file.
CAUTION Using the -f option can have unforeseen
consequences. If a binary (FTAM-3) file is
transferred as a text file, the contents of
the destination file may not be as expected
since the transfer of FTAM-1 files involves
interpretation of carriage-returns and new-
lines. Transferring a text file (FTAM-1) as
a binary file (FTAM-3) results in the
contents of the destination file being
exactly the same as the source file since
FTAM-3 files are transferred without
interpretation of file contents.
-dd|dr|da This option indicates the action to perform
Licensed material--property of copyright holder(s) Page 2
ftmv(1C) FTAM 3.00 ftmv(1C)
upon the destination file.
-dd Delete the destination file if it exists. If
this option is not specified, an error is
returned if the destination file already
exists.
-dr Delete the destination file if the source
file is more recent than the destination
file. If the destination file does not exist,
it is created.
-da Append the source file to the destination
file. If the destination file does not exist,
an error is returned and the move operation
is not performed.
-p create-file-password
Specify the create-file-password for the
destination filestore. The create file
password may be required by some FTAM
responders before they allow creation of
files in their filestore.
An ftam-file-spec may refer to either a file on the local
file system or to a file on a virtual filestore. You
specify a file using the following syntax:
local-filename
or
filestore#filename[#initiator-identity[#password]]
where braces, [ ], indicate optional fields.
The FTAM for AViiON Systems user interface delimits fields
in an ftam-file-spec with the pound character (#). If you
want the pound character to be a part of a field value (a
filename that contains a pound character for example),
precede the pound character with a backslash (\). To
include the backslash character itself in a field value, use
two backslashes (\\). Take into account that the pound and
backslash characters are also significant under most DG/UX
shells.
Filestore is the name of an FTAM service provider whose
presentation service access point (PSAP) is maintained by
the OSI/P for AViiON Systems software. The initiator-
identity and password are used to control access to the
virtual filestore. Each FTAM responder treats filename in
an operating system specific way. The Filename section of
Licensed material--property of copyright holder(s) Page 3
ftmv(1C) FTAM 3.00 ftmv(1C)
the ftam man page describes the FTAM for AViiON Systems
specific interpretation.
You may store initiator identities and passwords for
frequently used filestores in the filestore database file,
.ftamdb, located in your home directory. If you include a
filestore in an FTAM file specification and you do not give
an initiator identity and password on the command line, the
initiator resolves them by searching .ftamdb. Use the
utility ftfs(1C) to update this file. If the filestore does
not exist in .ftamdb, initiator-identity and password are
set to NULL.
When you use prompt mode, the initiator does not search
.ftamdb. To indicate NULL for a field value, press just
NEWLINE at the prompt. You are not prompted for initiator
identity and password if you enter just NEWLINE at the
filestore prompt since a NULL filestore means local
filestore. Initiator identity and password are not used for
local requests.
EXAMPLES
% ftmv srcfs#/usr/dgf/foo#frogger#flies foo-new
Move the file /usr/dgf/foo from filestore srcfs to foo-new
on the local filestore in the current working directory.
The initiator identity frogger and password flies for
filestore srcfs are taken from the command line.
% ftmv srcfs#/usr/dgf/foo#honey#bee dstfs#/foo-mv
Move the file /usr/dgf/foo from filestore srcfs to foo-mv on
filestore dstfs. The initiator identity honey and password
bee for srcfs are specified on the command line. The
initiator identity and password for dstfs are obtained from
$HOME/.ftamdb.
FILES
$HOME/.ftamdb
FTAM attribute files
Note that Revision 3.00 FTAM for AViiON Systems stores FTAM
attribute information for a file in either system space
Licensed material--property of copyright holder(s) Page 4
ftmv(1C) FTAM 3.00 ftmv(1C)
(where supported by the revision of DG/UX(TM) on the system)
or in a separate file located in the same directory as the
FTAM file. The attribute file has a name of the form
.ftam.filename where filename is the name of the file
associated with the attributes.
SEE ALSO
ftam(1C), ftcp(1C), ftls(1C), ftfs(1C), ftrm(1C),
ftcattr(1C), ftrattr(1C).
"Using FTAM for AViiON(R) Systems".
BUGS
The FTAM for AViiON Systems executables use the '#'
character as a delimiter in the source and destination file
specifications. Some command processors use this character
as the delete character. This can cause the FTAM for AViiON
Systems executables to receive incorrect command lines from
the command interpreter. Use the appropriate escape
character for your processor to ensure that the '#'
character gets passed to the program.
Licensed material--property of copyright holder(s) Page 5