Attributes

• "atalk-map"

• "atalk-password"

• "atalk-per-session-dids"

• "atalk-text-conv"

• "description"

• "filename-case"

• "meter"

• "path"

• "protect"

• "share-access"

• "share-passwd"

• "template-only"

• "umask"

atalk-map

This attribute specifies the name the AppleTalk realm file service uses for the volume map, to map the UNIX file name suffixes in a volume to Macintosh types and owners. You must use a genuine AppleTalk map name, not an AppleTalk map template.

Usage:

tnvolume -M -v volume -a atalk-map=map-name

atalk-password

This attribute specifies the AppleTalk password of a volume. The password applies only to the AppleTalk realm. Enter the value for the atalk-password string in plain text. You may use the following values for AppleTalk passwords: #, "", and password--the actual password.

For the "read" (-R) option, this attribute indicates the status of the AppleTalk volume password. If you cannot determine the status of the password because of access restrictions, this attribute has the value "?". It has the value "x" if the volume has an AppleTalk password, "#" if the password denies all access, and ""--the null string--if the volume has no password.

For the "add" (-A) option, this attribute specifies the AppleTalk password to apply to the volume. The "#" value denies all access. If you do not specify this attribute, or if you specify the string as "null" or "", clients can access the volume without passwords.

For the "modify" (-M) option, this attribute allows you to remove the atalk-password attribute by setting it to null or "". The volume then becomes accessible to clients without passwords.

Usage:

tnvolume -M -v volume -a atalk-password=password

atalk-per-session-dids

This attribute determines AppleTalk directory ID persistence. If you set this attribute to off, the default, AppleTalk directory IDs persistently associate themselves with directories in the volume. If you set this attribute to on, each directory ID remains only for the duration of a single client session; subsequently, features that depend on persistent IDs, such as the Macintosh O/S alias facility, do not function across successive file service sessions.

The host system requires a modest amount of overhead to maintain and manage a permanent database of directory IDs. For some volumes, especially extremely large ones like those residing on "infinite" storage devices, this overhead becomes excessive.

Usage:

tnvolume -M -v volume
 	-a atalk-per-session-dids={on|off}

atalk-text-conv

This attribute applies text file mapping to files in the volume.

Usage:

tnvolume -M -v volume -a atalk-text-conv={on|off}

description

This attribute specifies a textual description of the volume. It has no default. If your description includes symbols, enclose it in quotes. If possible, the system shows this string to clients through browsing interfaces and to administrators through administrative interfaces.

Usage:

tnvolume -M -v volume -a description=string

filename-case

This attribute controls the way file services handle the distinction between upper- and lower-case letters in file names in the volume. If you set this attribute to lower, file services handle names by translating them internally to lower-case file names. This simplifies file searches by name and results in an efficient implementation of the case-insensitivity expected by clients. Clients see file names in mixed case, but can use either case for any letters when supplying file names themselves. This file name handling can cause problems for UNIX applications that expect files to have the mixed-case names as supplied by clients.

If you set this attribute to preserve, file services look up names in their standard form in a shadow-attribute file. This allows file services to store files under UNIX in the same case-pattern used by the client, and still provide true case-insensitivity with reasonable efficiency.

If you do not define this attribute, or if you set it to default, you achieve the same effect as if you set it to preserve.

Usage:

tnvolume -M -v volume
 	-a filename-case={lower|preserve|default}

meter

This attribute controls metering. If you set it to on, UNIX records, in an event log, user attachments to the volume in all realms. You can analyze this log to derive current and historical access statistics.

Usage:

tnvolume -M -v volume -a meter={on|off}

path

This attribute specifies the absolute path of the UNIX directory that serves as the virtual root of the volume. Choose from the following strings:

%USER%	The name of user.
%GROUP%	The user's primary group name.
%CLIENT%	The name of the NetBIOS client. For the NetWare and AppleTalk realms, %CLIENT% has the same meaning as %USER%.
%HOME%	The user's home directory.
%SYSTEM%	The system name.
%REALM%	The realm name (NW, NB, or AT).
%SERVICE%	The file service name.
%%	An actual percent sign.

One volume's directory may lie within another volume. A volume cannot, however, coincide with or lie within a protected volume (see the "protect""protect attribute). Since a volume generally reveals its path only when a file attaches to it, this limitation applies, in part, during attachment.

Usage:

tnvolume -M -v volume -a path=pathname

protect

This attribute specifies the number of clients that can simultaneously access the volume. It refuses access to additional clients. Attachments count cumulatively for all realms, and a count of 0 denies all access to the volume. If the volume lies within another volume, it appears empty when a client tries to access it through the volume in which it lies. No volumes may coincide with or lie within a protected volume. This attribute helps administrators comply with software licenses. It does not support escape sequences for its path.

Usage:

tnvolume -M -v volume -a protect=limit

share-access

This attribute determines share-mode access to the volume in the LM-NT-OS/2 realm. For share mode volumes, a separate, per-volume password, rather than the UNIX user identity, controls access. This attribute defaults to off, which means clients can only access the volume through user-level security mode services. With this attribute on, clients may access the volume through share-level security mode services.

Usage:

tnvolume -M -v volume -a share-access={on|off}

share-passwd

This attribute specifies the share-mode password for a volume in the LM-NT-OS/2 realm, if you set share-access to on. Enter the value for password-string in plain text. You may use the following values for AppleTalk passwords: # (special value to deny access), "" (password checked and access allowed), and password (the actual password).

For the "read" (-R) option, this attribute indicates the status of the share-mode password. If you cannot determine the status of the password because of access restrictions, this attribute has the value "?". It has the value "x" if the volume has an share-mode password, "#" if the password denies all access, and ""--the null string--if the volume has no password.

For the "add" (-A) option, this attribute specifies the share-mode password to apply to the volume, in plain text. The "#" value indicates that the password should deny access in share mode. If you do not specify this attribute, or if you specify the string as "null" or "", clients can access the volume in share mode without passwords.

For the "modify" (-M) option, this attribute allows you to remove the share-password attribute by setting it to null or "". The volume then becomes accessible in share mode to clients without passwords.

Usage:

tnvolume -M -v volume -a share-passwd=password-string

template-only

This attribute causes the volume to behave only as a template. If you set it to on, TAS treats the object as a real object, but it has no effect on the runtime behavior of the system. The TAS installation program creates templates with conventional names reflecting the objects. It assigns default values to templates for the creation of new objects. When you set this attribute to off, the object becomes real.

Usage:

tnvolume -M -v volume -a template-only={on|off}

umask

This attribute designates the UNIX umask value for accessing the volume. Without this attribute, UNIX uses the umask of the file service when accessing the volume and can potentially override umask entries in a user's personal profile, in $HOME/.profile.file.

Usage:

tnvolume -M -v volume -a umask=value