ftcattr(1C) FTAM 3.00 ftcattr(1C)
NAME
ftcattr - FTAM change file attributes program
SYNOPSIS
ftcattr [ [ options ] ftam-file-spec ]
DESCRIPTION
Ftcattr changes FTAM file attributes. Not every filestore
supports every FTAM attribute. Some responders may accept a
change attribute request without actually updating file
attribute information. Lack of an error message may not
indicate that a request was successful. If you want, you
can verify attribute modification with ftrattr(1C).
If you invoke ftcattr without arguments, you are prompted
for the target file specification, new filename, and new
access control. Null responses are ignored.
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
Licensed material--property of copyright holder(s) Page 1
ftcattr(1C) FTAM 3.00 ftcattr(1C)
association timeout is not set.
-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.
-n filename New filename. The Revision 3.00 FTAM for
AViiON Systems responder renames the file
relative to its current directory unless the
new filename starts with a backslash, '/'.
Note that you cannot rename files across file
systems.
-a acl New access control list. Of the form
identity#action-list[#identity#action-list][ ... ]
Identity is a system dependent name, often a
logon name. You form action-list by
combining 0 or more of the following two-
letter strings (see examples):
Rd - read
In - insert
Rp - replace
Er - erase
Ex - expand
Ra - read attributes
Ca - change attributes
Df - delete file
The Revision 3.00 FTAM for AViiON Systems
responder recognizes identities "OWNER",
"GROUP", and "OTHER" and uses them to set the
DG/UX owner, group, and other file mode bits.
The ftam man page more fully describes the
access control attribute.
-s num Future file size. Partially supported by the
Revision 3.00 FTAM for AViiON Systems
responder.
-yi|yd File availability. Indicates whether a file
Licensed material--property of copyright holder(s) Page 2
ftcattr(1C) FTAM 3.00 ftcattr(1C)
can be accessed immediately or some delay can
be expected before access.
-yi Immediate.
-yd Deferred.
-q string New legal qualification. Partially supported
by the Revision 3.00 FTAM for AViiON Systems
responder. Note that this attribute is not
sufficiently defined in either the base
standard or in regional agreements to be
useful at this time.
NOTE: The following options operate only on files on the
local filestore. Ftcattr(1C) allows you to change the
values of these attributes so that you can set them to non-
Data-General-default values. These options are provided
primarily to facilitate interoperability with other FTAM
implementations.
-c FTAM-1|FTAM-2|FTAM-3
Contents type of the file. Set the FTAM
contents type of the local target file to the
specified value. You cannot specify the
NBS-9 contents type with this option nor can
you change the contents type of NBS-9 files
with ftcattr. The Revision 3.00 FTAM for
AViiON Systems responder default value is
FTAM-3. See IS0 8571-2, Annex B, for a
description of the FTAM document types and
parameters.
-m RdInRpErExRaCaDf
Permitted actions. Specification of a
permitted action on the command line sets
that permitted action on the file.
-u IA5String|22|
GraphicString|25|
VisibleString|26
GeneralString|27|
Universal Class document type parameter,
identifies the file character set. Revision
3.00 FTAM for AViiON Systems supports
IA5String, GraphicString, VisibleString, and
GeneralString for FTAM-1 files, GraphicString
and VisibleString for FTAM-2 files; the
universal class parameter is not defined for
Licensed material--property of copyright holder(s) Page 3
ftcattr(1C) FTAM 3.00 ftcattr(1C)
FTAM-3 and NBS-9 files. Ftcattr(1C) accepts
minimally unique strings for the arguments to
this option. You can also specify the
appropriate Universal Class Number as an
argument: 22 (IA5String), 25
(GraphicString), 26 (VisibleString), and 27
(GeneralString). Note that unless you have
specific reasons for changing these values,
you should allow the defaults set by Revision
3.00 FTAM for AViiON Systems to remain in
effect.
-x max-string-length
Maximum string length document type
parameter. Note that while the Revision 3.00
FTAM for AViiON Systems responder does not
place limits on this parameter, Phase 2 OIW
agreements specify that responders may refuse
FTAM-1 and FTAM-2 documents with this
parameter set to values above 134 and FTAM-3
documents with this parameter set to values
above 512. To set a file's max-string-length
to unbounded, specify the value -1 as the
max-string-length value.
-g variable|fixed|not-significant
String significance document type parameter.
Revision 3.00 FTAM for AViiON Systems
supports values of variable, fixed, and not-
significant for documents whose universal
class is GraphicString or VisibleString.
Documents whose universal class is IA5String
or GeneralString must have string
significance of not-significant or fixed.
FTAM-3 documents can have string significance
of fixed or not-significant.
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
Licensed material--property of copyright holder(s) Page 4
ftcattr(1C) FTAM 3.00 ftcattr(1C)
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
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
% ftcattr -a OWNER#rdex#GROUP#rd foo.c
Modify the access control attribute of the file foo.c in the
current working directory. Grant the Read and Expand file
actions to the initiator identity OWNER. Grant the Read
file action to the initiator identity GROUP.
% ftcattr -n new-name -a fred#RdCaDf#john#Rd afs#ofile#fred#passwd
Rename the file ofile on the remote filestore afs to new-
name. Modify the access control attribute so that the
initiator identity fred is granted the Read, Change
Attributes and Delete File file actions, and the initiator
identity john is granted the Read file action. The
initiator identity fred and password passwd for filestore
Licensed material--property of copyright holder(s) Page 5
ftcattr(1C) FTAM 3.00 ftcattr(1C)
afs are taken from the command line.
% ftcattr -c FTAM-2 -x 256 -g not -u GraphicString myfile
Change the contents type of the file myfile in the current
working directory to FTAM-2. Set its maximum string length
to 256, its string significance to not significant and its
universal class to GraphicString.
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
(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), ftfs(1C), ftls(1C), ftmv(1C),
ftrattr(1C), ftrm(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 6