HELIOS Base User manual


7 HELIOS Preferences

Note: Usually, almost all preferences for program functions and behavior of the HELIOS products can be set via EtherShare Admin or PCShare Admin. That means that it is not required to modify preferences manually. Nevertheless, in the following the single preferences and their function are described.

The server preferences are stored in a binary file. In the following, the preferences are listed by name, type, and default value. The default value is used by the HELIOS services unless another value is specified.
Not all of the following preferences are set by default, meaning they are not listed in the "prefdump" output, so HELIOS Services will use the given default values. When a different value is set by means of "prefvalue", this will take precedence. To revert back to the default value delete the preference entry.
Exporting, setting/deleting and restoring preferences on the HELIOS host is done via the programs "prefdump", "prefvalue", and "prefrestore". For a detailed description of these programs see 6 "HELIOS utility programs", where you will also find examples.

Important: Make sure that preference keys MUST NOT start or end with a slash (“/”) character!

7.1 AFP Server preference keys
(Requires a restart of the service (see 9.1 "srvutil") to take effect.)
Key: Programs/afpsrv/<preference>
Preference
Type Default (""=empty string)
name
strlist hostname
Specifies the AppleTalk (NVE) name of the File Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
zone
strlist ""
Specifies the name of the AppleTalk zone(s) to which the file server should be allocated. The chosen zone must be one of the local zones that the server is connected to. You can test this with the "zones -l" command.
locks
int 10*Clients
Specifies the number of "region locks" that the server allows simultaneously (if PCShare is installed on the same server it must be allocated the same settings).
The default for this parameter is 10 * sessions, where "sessions" is equal to the number of units (clients) for which you bought your license.
Do not set this preference to an unnecessarily high value because this would increase HELIOS Services' requirement for UNIX system resources.
sessions
int see text
Specifies the maximum number of workstations (clients) that are permitted to work on the file server simultaneously. This value should normally be the same as the total number of Macintosh workstations that are connected to the AppleShare server. The value you choose should be less than or equal to the number of sessions allowed by your software license. The maximum tolerable number of workstations depends on the type of Macintosh applications you mostly use (whether they are file-intensive or client-server applications), on the configuration of your server system, and on its expansion stage.
The default value for sessions is the number of sessions allowed by your software license.
files
int 256
This preference specifies the maximum number of files that can be opened by the file server process simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. To save system resources, do not set this value higher than necessary.
guestid
str ""
Specifies the user name which is automatically allocated to guest users. The name is invisible to guest users, it is solely used to assign an entry for guests in the user list. If this parameter is specified, the file server automatically supports guest access to available volumes. Otherwise, guest access to available volumes is not possible.
The default for guestid is "nobody". The specified guest user must exist on your host. The installation automatically creates the user "nobody" if it does not already exist.
suffixes
str "var/conf/suffixes"
"afpsrv" normally simulates Finder info (such as file type and creator) automatically for files without Macintosh resource. The type of file is determined by inspecting the file's contents. This allows about 20 different icons to be shown for non-Macintosh files.
In the case of files created by MS-DOS applications, the file type is typically indicated by adding a suffix to the file name, the so-called the file name "extension". For example, DOS executable programs have the extension ".COM" or ".EXE" and DOS batch files have the extension ".BAT". Under EtherShare, suitable icons can be displayed for such files by specifying them in the so-called extension mapping table. This is particularly useful in the case of applications such as FrameMaker for Macintosh which are able to directly read documents created by the MS-DOS version without prior conversion. The suffixes parameter allows you to specify the location and name of the extension mapping table.
afppasswd
str "bin/chpasswd"
Specifies the complete path name of the "chpasswd" program, which is used by "afpsrv" to change passwords in the AFP user list. This parameter only needs to be changed if, for administrative reasons, it is necessary to modify EtherShare's default directory system.
localwinsize
int 8
Specifies the maximum number of AppleTalk data packets that are passed from "afpsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. localwinsize can be varied to optimize the data transfer rate.
remotewinsize
int 8
Specifies the maximum number of AppleTalk data packets that are passed from workstations to "afpsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX server is too small. remotewinsize can be varied to optimize the data transfer rate.
minuid
int 0
Specifies the lowest number allowed for user IDs. All users defined in "HELIOSDIR/var/conf/passwd" which have a lower user number than that specified by minuid are not recognized as valid users of EtherShare. This parameter is provided as an additional security feature.
maxuid
int 0 (i.e. )
Specifies the highest number allowed for user IDs. All users defined in "HELIOSDIR/var/conf/passwd" which have a higher user number than that specified by maxuid are not recognized as valid users of EtherShare. This parameter is provided as an additional security feature.
binonly
bool FALSE
"afpsrv" normally simulates Finder info (such as file type and creator) automatically for files without Macintosh resource. The type of file is determined by inspecting the file's contents. This allows about 20 different icons to be shown for non-Macintosh files. Specify binonly if this feature is not required, in which case all non-Macintosh files will be treated as type DATA/UNIX, which means that UNIX text files will then become invisible to most Macintosh text editors.
minpwlen
int 0
The AppleShare selection in the Chooser on the Macintosh accepts passwords of any length from 0 byte to max. 8 bytes. Short passwords may represent a security risk. A password of zero length is equivalent to no password. Specify minpwlen as a numeric value between 0 and 8. To improve security, a meaningful minimum value for this parameter is 5.
savepasswd
bool TRUE
As a time-saving feature when logging on, the AppleShare selection in the Chooser on the Macintosh lets you save your File Server user name and/or user password on the Macintosh's local hard disk.
To improve security, set this flag to FALSE to disable the saving of user passwords in this way, in which case all users have to enter their password manually each time they log on to EtherShare.
findercache
int 2048
The File Server caches Finder information in RAM memory to optimize performance. findercache specifies the number of Finder entries to cache, and thus the amount of RAM needed that should be allocated for this purpose. Higher values require more RAM but lead to a File Server speed improvement for some Finder operations.

Note: Each entry requires about 100 bytes of RAM. The cache is used by only one single "afpsrv" (i.e. client) at a time, since it cannot be shared.

translateany
bool FALSE
This option will cause line end translation for all files of type "TEXT", without regard to creator.
filedatesync
bool FALSE
Whenever you modify a Macintosh file, the changes you make do not necessarily affect both the data file and resource file, and in many cases only the data file is changed. "afpsrv" only checks the modification date of the data file when it needs to display date and time information in the Finder. Accordingly, "afpsrv" is designed to always update ("touch") the modification date of the data file, even if only the resource fork has been modified.
However, "afpsrv" does not normally update the modification date of the resource file if only the data fork has been modified. The modification date of the resource file is usually not important, even to incremental backup procedures, and updating it would waste system resources and slow down the File Server somewhat.
Nonetheless, situations may exist where differences between the modification date of the data and resource files can cause difficulties. Such situations are typically those involving automatic data migration to slower external storage.
Specify the filedatesync flag to cause "afpsrv" to always synchronize the modification date of the resource and data files, even if only the data fork has been modified.
sortdirs
bool FALSE
This parameter sorts the directories coming from the server to the Macintosh clients by name.
dirmode
int 0700 (Octal 700)
This preference specifies the default mode for new directories. The default value given above (0700) specifies the access rights and means that the owner has "Read, Write and Execute" rights for the directory.
groupwriteisowner
bool FALSE
In the Mac OS file system only the owner of a folder or volume can permanently change the folder's layout, e.g. sorting order, icons placement and label settings. This feature has been added to allow workgroups, e.g. users who are all members of the same group, to change layout settings or labels according to the organization of their work.
fakeoffspring
bool TRUE
"afpsrv" will return, by default, the number of offsprings (entries in a subdirectory) as 9999 while enumerating a directory. This option can be turned off by using this flag set to FALSE. Then, the AFP-call "GetFileDirParms" on a directory gives the real number of entries.
This feature is especially useful when folders containing many subfolders, which on their part may contain many files, are in use. The Macintosh Finder, or application program, will request information not only on files in the current folder, but in addition on files in subfolders, although this information is currently not used. Therefore, this option may accelerate the opening and displaying of folders with many subfolders.
There are few Macintosh applications which rely on the exact offspring count. For those, disabling of this parameter may be required.
texttran
bool FALSE
The texttran flag has been added to "afpsrv" in order to turn off the newline translation for all types of text files. texttran set to FALSE will disable line end translation for all files of type "TEXT", without regard to creator.
This feature may be helpful in case Macintosh applications do write binary data into text files.
connectlimit
int 0 (i.e. )
Specifies the time in seconds a Macintosh client is allowed to stay logged-on to "afpsrv".
afpport
int 548
Specifies the port number for the AppleShare IP.
dsiblocksize
int 131072 (128 x 1024)
Specifies the maximum size of AppleShare/IP data packets that are passed via TCP/IP from "afpsrv" to workstations through the network during a transaction.
volstatinterval
int 10
Specifies the time interval in seconds how often "afpsrv" checks the amount of free space on the server.
volcheckinterval
int 10
Specifies (in seconds) how often volstatinterval is communicated to the Macintosh client.
ipaddress
str ""
Specifies the IP address the "afpsrv" program offers to the Macintosh clients for logging in via IP-protocol (if this value remains unspecified, i.e. empty, all IP addresses on all network interfaces are offered).
ipaddresses
str ""
This preference is applied for handling more than one
IP address, and is given out in a string in which the addresses appear comma-separated.
ip
bool TRUE
This flag switches the AppleShare IP on or off, depending on its setting.
ipaccess
str "var/conf/ipaccess"
Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to "afpsrv".
logdenied
bool TRUE
This parameter lets "afpsrv" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.
dsitickletime
int 30
Specifies the time interval in seconds after which "afpsrv" sends a tickle packet to signal that the server is still running.
xferlog
str ""
If specified, the file names of all files edited (written, read, saved, etc.) on EtherShare volumes are recorded and stored sequentially in an "xferlog" file. In general, folder operations (new, move, rename), file moves within a volume, file name changes, and file deletions are not logged. Nor are operations under UNIX or from PC clients. Use this option with care since it causes considerable load on the server. This information is stored in the "xferlog" file in the same format as that used by FTP server log files. Each server entry is composed of a single line, consisting of the fields described in the following table, with the fields separated by spaces. If the "xferlog" str points to the same log file (typically in "/usr/adm") as used by the FTP server daemon (ftpd(8)), and "ftpd" logging is enabled, then both FTP and "afpsrv" file operations can be recorded in the same log.

Note: Make sure an empty "xferlog" file exists at the specified location and set file permissions sufficiently so that "owner", "group", and "others" can write to that file.
current-time
Current local time in the form "DDD MMM dd hh:mm:ss YYYY". Where DDD is the day of the week, MMM the month, dd the day of the month, hh the hour, mm the minutes, ss the seconds, and YYYY the year.
transfer-time
Total time in seconds for the transfer.
remote-host
Remote host name.
file-size
Size of the transferred file in bytes.
filename
Name of the transferred file.
transfer-type
Single character indicating the type of transfer. Can be one of:
a for an ascii transfer
b
for a binary transfer
special-action-flag
One or more single character flags indicating any special action taken. Can be one or more of:
C file was compressed
U file was uncompressed
T file was tar'ed
_ no action was taken

direction
Direction of the transfer.
Can be one of:
o outgoing
i incoming

access-mode
Method by which the user is logged in. Can be one of:
a (anonymous) is for an anony-
mous guest user.
g (guest) is for an passworded
guest user (see the guestgroup
command in ftpaccess).
r (real) is for a local authenti-
cated user.

username
Local username, or if guest, the ID string given.
service-name
Name of the service being logged, usually AFP.
authentication-method
Method of authentication used.
Can be one of:
0 none
1 RFC931 Authentication

authenticated-user-id
User id returned by the authentication method. An * is used if an authenticated user id is not available.
completion-
status

Single character indicating the status of the transfer. Can be one of:
c complete transfer
i incomplete transfer

idletime
int 0 (i.e. )
This preference specifies the time in minutes which a user has at his disposal, idling on the File Server before he gets logged-out by "afpsrv".
idlewarntime
int half the "idletime" value
Is the time in minutes after which the "afpsrv" program gives the user a warning before he is logged-out by the "afpsrv" idletime parameter.
lowdelay
bool FALSE
If set to TRUE the host sends IP-datagrams first to contact other nodes, but the exact behavior depends on the configured queueing discipline. Some high priority levels may require an effective user ID of 0.
7.2 AppleTalk preference keys
Key: Programs/atalkd/<preference>
allmulti
(Linux only!)
bool TRUE
This preference causes an "ifconfig allmulti" command while configuring network interfaces.
if
strlist ""
This preference defines the AppleTalk network settings for the specified hardware network interface. The "if" preference value consists of a list of settings, separated by colons (see7.2.1 "About the "if" and "nif" preferences").
nif
strlist ""
Disables AppleTalk over the specified network interface (see 7.2.1 "About the "if" and "nif" preferences").
7.2.1 About the "if" and "nif" preferences
ifname:netno:snode:zonename
An entry of this type is required for each hardware interface (e.g. Ethernet). ifname is the name of the interface as known to the kernel. netno is the network number in the AppleTalk network. The network number must be specified as a range with a dash (e.g. 10-15); the interface will then automatically be configured by "atalkd" as a Phase II network with this number range.
snode is the starting node number at which "atalkd" starts to look for a free node for the EtherShare host on the AppleTalk network (dynamic node number allocation). By convention, servers in an AppleTalk network have node numbers higher or equal to 128 (EtherShare usually starts at 140). zonename is the name (or a list of names delimited by colon) of the AppleTalk zone for this interface.
Example:
le0:30-35:128:EtherTalk
le1:10-10:128:Zone1
le2:20-20:128:Zone2
The "le0" interface has been allocated the network number range 30-35. Compared to an outdated Phase I network, the maximum number of AppleTalk devices allowed on the network here increases from 254 to (35-30+1) * 254. You must not use the same network number range for more than one hardware interface (see example above).
The "installer" program automatically sets up preference values for the AppleTalk preference keys.

Note: If you see a Programs/atalkd/nif preference entry instead of Programs/atalkd/if this indicates that the configuration has been edited by means of the "netconf" program, and that the interface stated here, has been set to inactive.

To configure the network interfaces use the "netconf" program which is described in the EtherShare manual (except for Mac OS X which uses its own network interface configuration program).
7.3 PCShare preference keys
(Requires a restart of the service (see 9.1 "srvutil") to take effect.)
Key: Programs/pcshare/<preference>
hostname
str hostname
Specifies the SMB name of the File Server. This is the name with which it is known to the network. It corresponds to Windows Server Name in EtherShare Admin's Server Settings configuration window.
guestid
str nobody
Specifies the user name which is automatically allocated to guest users. The name is invisible to the guest users themselves, it is solely used to assign an entry for guests in the user list. The default for guestid is "nobody". This specified guest user must exist on your host. The PCShare installation automatically creates the user "nobody", if it does not already exist.
locks
int 10*Clients
Specifies the number of "region locks" that the server allows simultaneously (if EtherShare is installed on the same server it must be allocated the same settings).
The default for this parameter is 10*sessions, where "sessions" is equal to the number of units (clients) for which you bought your license.
Do not set this preference to an unnecessary high value because this increases PCShare's requirement for UNIX system resources.
files
int 256
This preference specifies the maximum number of files that can be opened by the file server simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. It is normally set by "pcshare" for itself automatically. To save system resources, do not set this value higher than necessary.
The default is the maximum number of open files per process currently allowed by the host or 256, whichever is less.
domainname
str ""
In a Windows environment, this string specifies the name of the domain in which the host is located.
7.4 Desktop Server preference keys
(Requires a restart of the service (compare 9.1 "srvutil") to take effect.)
Key: Programs/desksrv/<preference>
maxdesktop
int 128
Specifies the maximum number of network volumes that can be opened by Macintosh users on the File Server simultaneously.
The default is 128 volumes. Each open volume is only counted once, even if it has been opened by more than one user. The absolute maximum value is 450, but the achievable maximum may be limited by the maximum number of open files for the "desksrv" process allowed by the host. This limit is normally set by "desksrv" for itself automatically. In case of problems, refer to "limit" and "ulimit" in your UNIX documentation for details about how to increase the limit manually for your host.
7.5 Mail Server preference keys
(Requires a restart of the service (compare 9.1 "srvutil") to take effect.)
Key: Programs/mailsrv/<preference>
type
str "MailServer"
This preference is the AppleTalk type of the Mail Server. This is the type with which it is known to the network. type should normally be set to "MailServer".
name
strlist hostname
This preference sets the AppleTalk (NVE) name of the Mail Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
zone
strlist ""
Specifies the name of the AppleTalk zone to which the Mail Server should be allocated. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
spooldir
str "/var/spool/mail"
Specifies the directory path of which all incoming mail is spooled. Outgoing mail is not spooled, since it is passed directly to the UNIX mail system.
mailinterval
int 60
Gives the interval in seconds with which the mail directory is polled for new mail. Usually, you use the "biff" program for mail notification instead, since you get immediate notification this way, and because "biff" needs less system overhead.
The Mail Server only polls for mail at the time interval specified by mailinterval if "biff" has been disabled or is not available for some reason.
officialname
str ""
This preference is a string containing the official name (UNIX mail name) of your host. This is the name which users of other systems need to include in their mail address when they want to reach you. It is made up of a name (e.g. the host name "osiris") and the domain in which the host resides (e.g. "helios.de").
addresses
str "var/conf/addressbook"
Specifies the name and path of a file containing a list of
e-mail addresses. The list can be accessed by and maintained from HELIOS Mail. You can use it to save time when you often mail to the same people.
mailer
str "/usr/sbin/sendmail"
Is the name and path of the UNIX program used to send mail. You should normally use the "sendmail" program for this purpose. In some cases, you may need to use
"/usr/bin/mail" instead. However, you may encounter problems with the mail program, such as lack of 8-bit transparency. You need 8-bit transparency if you want to send mail containing national accented characters such as "umlauts". A character conversion table in the Mail Server allows you to send mail containing "umlauts" to UNIX users, too.
biff
bool TRUE
This switch specifies whether or not to use the UNIX "biff" program for mail notification. "biff" is the preferred method, since it needs less system overhead than polling for mail. However, on some systems "biff" is already used by other programs such as "comsat", and may not be available for use by the Mail Server. In this case, the Mail Server automatically falls back to polling for mail.
If you want to release "biff" from "comsat" for use with
the Mail Server, bracket out the corresponding line in the UNIX configuration file "/etc/inetd.conf" by inserting a
"#" at the start of the line.
Then re-initialize "inetd" with the command "kill -1 xxx", where "xxx" is the process id of the "inetd" process.
Finally, restart the Mail Server with "srvutil". The usage is described in 9.1 "srvutil".

History: "Biff" was the name of a dog belonging to a Berkeley programmer who wrote part of the UNIX mail system. Biff used to bark each time the postman delivered a (conventional paper) letter to the door.

passwd
bool TRUE
When you installed the HELIOS software, a new address book was automatically created as the empty UNIX text file "addressbook" in "HELIOSDIR/var/conf". You can add new addresses to the list with the New Address... function of HELIOS Mail. When you use the address book, normally you will also see all users of your UNIX host, including root, in addition to users you have included manually with the New Address... function. Specify FALSE to turn off this feature, in which case the address book will only show users who have been included manually.
autologin
bool TRUE
If you check Save name in the HELIOS Mail login window, HELIOS Mail makes a note of your name, and the zone and name of the Mail Server you want to use. Next time you start HELIOS Mail, you only need to enter your password. Furthermore, if you log on first to the EtherShare File Server on the same host, you will not have to enter your name and password for either the Mail Server or the "Mail Notification Feature" anymore. This is convenient, but presents a security risk if you leave your Macintosh unattended with volumes mounted - even if you have quit HELIOS Mail, others can start it again and have access to your mailbox without needing to type in any password. Specify FALSE to force HELIOS Mail to ask for a password each time it is started. This is similar to deactivate the Save name box in the HELIOS Mail login window, but applies to all HELIOS Mail users on that host. In this case do not forget to always deselect Save password in the same window.
localwinsize
int 8
Specifies the maximum number of data packets that are passed from "mailsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. This flag can be varied to optimize the data transfer rate.
remotewinsize
int 8
Specifies the maximum number of data packets that are passed from workstations to "mailsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. This flag can be varied to optimize the data transfer rate.
port
int 2001
This preference is used for configuring the mail port.
vacation
str "/usr/bin/vacation"
Specifies the path of the UNIX vacation program. It is required if you want to make use of HELIOS Mail's vacation message option. For details about the vacation program and the ".vacation.msg" file, see the respective UNIX man pages.
7.6 PAP Server preference keys
(Requires a restart of the service (compare 9.1 "srvutil") to take effect.)
Key: Programs/papsrv/<preference>
zone
strlist ""
Specifies the name of the AppleTalk zone(s) to which the PAP-Server should be allocated. Thus it determines the zone in which the Print Server can be seen in the Chooser. The chosen zone must be one of the local zones that the server is connected to. We strongly recommend to test this using the UNIX program "zones -l".
tcpport
int 2007
Address of the master TCP port. All active TCP printers (printers with active tcpname and TCPPublish flag) can be reached via this port.
If the port number is set to "0" the master TCP port is deactivated.
scopes
str ""
Specifies a list, separated by commas, which comprises the defined zones on the server.
7.7 Terminal Server preference keys
(Requires a restart of the service (compare 9.1 "srvutil") to take effect.)
Key: Programs/termsrv/<preference>
type
str "UNIXTerminal"
This preference specifies the AppleTalk type of the Terminal Server. This is the type with which it is known to the network. type should normally be set to "UNIXTerminal". The same type must be set in the "Connection Settings" window of the HELIOS Terminal program.
name
strlist hostname
name specifies the AppleTalk (NVE) name of the Terminal Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
zone
strlist ""
Specifies the name of the AppleTalk zone(s) to which the Terminal Server should be allocated. This parameter determines the zone in which the Terminal Server can be seen in the Chooser of the HELIOS Terminal program. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
banner
str "\r\n\r\nADSP Terminal
Server on host
%n\r\n\r\n(C) 1990-2000
Helios Software
GmbH\r\n\r\n"
This preference specifies a string which is output to each Macintosh terminal whenever a connection is made and before the login itself is started. For example, you can use this parameter to output a company trademark.
term
str "vt100"
Specifies the name of the terminal emulation. This name
is written by "termsrv" to the UNIX environment variable "TERM" on starting a new connection. In the standard UNIX configuration, the VT100 emulation (i.e. a definition of terminal control codes) is defined in each of the files "termcap" and "terminfo". If you change term to specify another emulation, you must ensure that the new emulation definition has been added to both files. Whereas many programs refer to the "termcap" file, an entry is also required in "terminfo", since, under Solaris 2, some programs refer to "terminfo" (like the editor program vi) instead of "termcap". Note that the standard UNIX VT100 emulation is a subset of the VT320 emulation provided in HELIOS Terminal.
localwinsize
int 8
Specifies the maximum number of data packets that are passed from "termsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. The value of localwinsize can be varied to optimize the data transfer rate.
remotewinsize
int 8
Specifies the maximum number of data packets that are passed from workstations to "termsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. The value of remotewinsize can be varied to optimize the data transfer rate.
7.8 Administration Server preference keys
(Requires a restart of the service (compare 9.1 "srvutil") to take effect.)
Key: Programs/admsrv/<preference>
name
strlist hostname
This preference sets the AppleTalk (NVE) name of the Admin Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
zone
strlist ""
Specifies the name of the AppleTalk zone(s) to which the Admin Server should be allocated. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
sessions
int see text
Specifies the maximum number of workstations (clients) that are permitted to work on the Admin Server simultaneously. This value can be the same as the total number of workstations that are connected to the AppleTalk network, but is usually smaller than that.
The default value for sessions is the number of sessions allowed by your software license.
ypdir
str ""
Specifies the name and path of the file in which the user, optional AFP user and group data for the NIS ("Yellow Pages") system are stored.
protected
bool FALSE
This flag - if set to TRUE - is specified to protect (lock) all configuration data. Then, merely maintaining spool queues is possible.
fontdir
str "var/spool/psfonts"
Specifies the path of the host directory which contains the server font list "FontDirectory". The fonts themselves are contained in the file's subdirectories, arranged alphabetically.
sysadmgroup
str "SysAdm"
EtherShare Admin allows users with sufficient permissions to configure the EtherShare system from any Macintosh workstation on the network in a convenient and secure way. For example, it can be used to set up users, groups, volumes, and printers, and re-schedule print jobs. Normally, only the system administrator is allowed to make any changes. Non-privileged users can inspect the configuration and the print job queue, but cannot change anything except delete their own print jobs.
Members of the special "system administrators" group can also use EtherShare Admin to make any changes they like, including printer configuration, and sending AFP messages with Lists/Active Users/Message/Message To All... to all AppleShare users logged-on to the EtherShare server. However, these group members are not allowed to modify any information on users with an ID less than 100 (Note that the system administrator has a user ID of 0!). The sysadmgroup parameter specifies the name of the special "system administrators" group.
queadmgroup
str "QueAdm"
Members of the special "queue administrators" group can use EtherShare Admin to manipulate print jobs and queue configurations from a Macintosh workstation. Thus, they have even more privileges than members of the "printer administrators" group that is described above. Queue administrators are allowed to:
The queadmgroup parameter specifies the name of the special "queue administrators" group.
prnadmgroup
str "PrnAdm"
Members of the special "printer administrators" group
can use EtherShare Admin to manipulate print jobs from
a Macintosh workstation, i.e. they are allowed to:
The prnadmgroup parameter specifies the name of the special "printer administrators" group.
savepasswd
bool TRUE
As a time-saving feature when logging on, the AppleShare selection in the Macintosh Chooser lets you save your File Server user name and/or user password on the Macintosh's local hard disk.
To improve security, specify the flag to disable the saving of user passwords in this way, in which case all users have to enter their password manually each time they log on to EtherShare Admin.
admport
int 2004
Specifies the TCP port number of the Admin server.
ip
bool TRUE
This flag switches the TCP/IP on or off, depending on its setting.
ipaccess
str "var/conf/ipaccess"
Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to "admsrv".
logdenied
bool TRUE
This parameter lets "admsrv" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.
7.9 Volume preference keys
(Changes only take effect if the volume is mounted anew.)
Key: Volumes/<UNIX directory>/<preference>
AFPName
str ""
Sets the Macintosh AFP volume name. The setting reflects that of the AFP Name: field in EtherShare Admin's Volumes: configuration window.
SMBName
str ""
Sets the PCShare SMB volume name. The setting reflects that of the SMB Name: field in EtherShare Admin's Volumes: configuration window.
Password
str ""
Specifies the volume password (currently only supported on Mac). The setting reflects that of the Password: field in EtherShare Admin's Volumes: configuration window.
Removable
bool FALSE
Only set this flag to TRUE for removable media attached to the host which are normally changed while the host is running (e.g. MO drives). Do not apply this setting for local volumes. The setting reflects that of the checkbox Exchangeable in EtherShare Admin's Volumes: configuration window.
Readonly
bool FALSE
This flag must be set to TRUE when the underlying physical media is write protected (e.g. CD-ROM). Then, there is
- for all users - only read access to the specific volume. The setting reflects that of the checkbox Read Only in EtherShare Admin's Volumes: configuration window.
UnixLocks
bool FALSE
This option specifies how the server handles cross-platform record locking between clients and UNIX applications.
UnixShare
bool FALSE
This option specifies how the server handles cross-platform file locking between clients and UNIX applications.
AFPPublish
bool TRUE
With this flag set to TRUE, the particular volume is published for Macintosh clients. The setting reflects that of the checkbox Macintosh visible in EtherShare Admin's Volumes: configuration window.
Guest
bool TRUE
With this flag set to TRUE, guest access is allowed on the particular volume. The setting reflects that of the checkbox Guest Access in EtherShare Admin's Volumes: configuration window.
UTF8
bool TRUE
This flag makes the host use the Unicode character set encoding on the specific volume. This provides a correct cross-platform file name display (particularly if the names contain special characters, such as "umlauts" between Macintosh clients, PC clients, and UNIX servers. The setting reflects that of the checkbox Unicode/UTF-8 in EtherShare Admin's Volumes: configuration window.
HideDotFiles
bool FALSE
This option has been added to the HELIOS server products in order to show files which start with a dot (".") as "hidden". The setting reflects that of the checkbox Hide "dot files" in EtherShare Admin's Volumes: configuration window.
Close
bool FALSE
This flag specifies how the file server reacts to a file close command from a PCShare client. close disables the file descriptor caching, so files are closed immediately as soon as the file close command is received. The setting reflects that of the checkbox Close Option in EtherShare Admin's Volumes: configuration window.
Groups
strlist ""
Specifies a list of groups which are allowed access to this particular volume. The setting reflects the entries in the Groups: field in EtherShare Admin's Volumes: configuration window.
IPAccess
str ""
Specifies the file name of the IP access list that makes the particular volume visible for clients which have one of the IP numbers on the IP access list.
AFPCharset
str MacRoman
If the UTF8 flag is set the charset flag is used to translate and encode file names to the "MacRoman" or "SJIS" character set. The setting reflects that of the AFP Charset: pop-up menu in EtherShare Admin's Volumes: configuration window.
SMBCharset
str PC850
If the UTF8 flag is set the charset flag is used to translate and encode file names to the "PC850" or "SJIS" character set. The setting reflects that of the SMB Charset: pop-up menu in EtherShare Admin's Volumes: configuration window.
closedirs
bool FALSE
This flag specifies how the file server reacts to a directory close command from the PCShare client. closedirs disables the directory descriptor caching, so directories are closed immediately as soon as the directory close command is received.
mandatory
bool TRUE
This flag specifies whether or not the server allows record locking between multiple PCShare clients.
compatdeny
bool TRUE
This flag specifies how the server reacts if a PCShare client opens a file for reading or writing without indicating how (and whether) the file can be simultaneously opened by other programs. Normally, if a file is opened for reading, other users can only open the file for reading ("deny other write"). Furthermore, if a file is opened for reading and writing, other users cannot open the file at all ("deny other all").
7.10 Printer preference keys
Key: Printers/<printer queue>/<preference>
All preferences in this section may also be set globally:
Key: Global/Printers/<preference>
7.10.1 Spooler/Input settings
afpsessionsonly
bool FALSE
This preference is used for enhanced user authentication on PAP and TCP queues. If set to TRUE, only users that have an open AFP volume (and are therefore authenticated to the AFP Server) can print to this queue. But this authentication only works if the queue and the AFP connection use the same address space. Newer Mac OS versions ( 9) use AppleTalk via TCP/IP, so these connections can only be used by TCP queues. Holding down the option key while you log on to the AFP Server under Mac OS 9, you connect to AFP via AppleTalk. This can be used to authenticate for PAP queues.
Groups
strlist ""
Specifies a list of groups, separated by a comma.
If a TCP/IP or PAP printer queue is set to afpsessionsonly = TRUE only users which are authenticated by the AFP Server and are specified by the Groups preference, can use this printer.
If the queue is an SMB printer queue it will only be visible to members of the specified groups.
fontdir
str "var/spool/psfonts"
Specifies the path of the host directory which contains the server font list "FontDirectory". The fonts are contained in subdirectories of the file, arranged alphabetically.
dictdir
str "var/spool/dicts"
Specifies the path containing PostScript dictionaries and printer "prep" files, such as "AppleDict..." and "HeliosDict...". You can specify an alternative path here if one of your printers is not fully compatible to the Apple LaserWriter and needs other dictionaries and/or "prep" files. Normally, all PostScript printers share the same files.
holdq
str "None"
Specifies a hold queue out of the already installed printer queues. It corresponds to Hold Queue: in EtherShare Admin's Printers: configuration window.
errorq
str "None"
Specifies an error queue out of the already installed printer queues. It corresponds to Error Queue: in EtherShare Admin's Printers: configuration window.
SMBExportName
str ""
Specifies the PCShare export name of the particular printer. It corresponds to SMB Name: in EtherShare Admin's Printers: configuration window.
SMBExportSpec
str ""
Specifies the path of the UNIX command which is used to issue print jobs.
tcpport
int see text
Specifies the address of a specific TCP port for this printer in order to allow easy access for remote printing through a Firewall. If this preference is missing the printer can only be reached via master TCP port. There is no default value for this preference.
tcpname
str ""
Specifies the name under which the TCP printer is registered by SLP, and under which this printer can be reached via the master TCP port. It corresponds to TCP Name: in EtherShare Admin's Printers: configuration window.
papname
str ""
This preference sets the AppleTalk (NVE) name of the PAP-Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional. It corresponds to PAP Name: in EtherShare Admin's Printers: configuration window.
authenticate
bool FALSE
This switch determines whether printing to a LaserWriter queue is password-protected or not. In case the flag is set to TRUE, user name and password have to be entered before printing. This setting affects all LaserWriter printer queues on the same server. The setting reflects that of the checkbox Require Authentication in EtherShare Admin's Printers: configuration window.
PAPPublish
bool TRUE
Specifies if the particular printer is published for PAP clients, i.e. for Macintosh clients. The setting reflects that
of the checkbox Macintosh - PAP in EtherShare Admin's Printers: configuration window.
SMBPublish
bool TRUE
Specifies if the particular printer is published for SMB clients, i.e. for Windows clients. The setting reflects that of the checkbox Windows - SMB in EtherShare Admin's Printers: configuration window.
TCPPublish
bool TRUE
Specifies if the particular printer is published for TCP clients. The setting reflects that of the checkbox TCP Printer in EtherShare Admin's Printers: configuration window.
tcpscopes
str ""
This preference specifies a comma-separated list of scopes under which the printer is registered via SLP. Otherwise, the scopes preference is taken either from "papsrv" or - if not even available - from the local "slpsrv".
type
str "LaserWriter"
This preference is the AppleTalk type of the printer with which it is known to the network. This preference should normally be set to "LaserWriter", "ImageWriter" etc., since only then it will be recognized by the standard Macintosh Chooser extensions on the workstations. If the workstations are provided with a later version of the LaserWriter program, which also allows other printer types, a different type can be specified here if necessary.
zone
str ""
Specifies the name of the AppleTalk zone(s) to which the printer should be allocated. Thus, it determines the zone in which the Print Server can be seen in the Chooser. The chosen zone must be one of the local zones that the server is connected to. We strongly recommend to test this using the UNIX program "zones -l".
lpr
str ""
Specifies the path (including the file name) of an alternative "lpr" program to the one normally used by "papsrv". The lpr parameter can be used to specify another "lpr" program which is different from the one normally selected by "papsrv". You should use this parameter if you have developed your own custom "lpr" program. You can also use this option to specify a shell script.
filter
str ""
Specifies the path (including file name) of a custom filter program which is called in a pipe with the "standard input" connected to the print job and the "standard output" connected to "lpr". The job will already be resolved if the resolve preference is set to TRUE.
filter may be used in conjunction with the standard EtherShare interface programs.
filtercmd
str ""
Specifies the path (including file name) of a custom filter program which is called as follows:
path -Pprintername spoolfile
The "filtercmd" program can then process the file (which is not resolved) as required. The output file should appear under the same name ("spoolfile") given in the argument - "papsrv" will wait until the custom filter program has finished before processing the job further. Compared to the filter parameter, filtercmd can be used for example to add a header (e.g. a PostScript init) or a trailer to the file without having to process the whole file. Use filter instead if you need to parse the entire file, e.g. for font names or job information.
filtercmd may be used in conjunction with the standard EtherShare interface programs.
resolve
bool TRUE
The resolve switch causes "papsrv" to "resolve" all print jobs for the specified printer queue before they are sent to "lpr", i.e. "papsrv" incorporates all required font, dictionary groups and OPI image information into the jobs in advance, and resolves "%%Include..." references. This is needed whenever you want to use printers that cannot be driven directly by the printer interface programs supplied with EtherShare. But be aware that if you use the resolve switch you will need substantially more spooling space on the local server.
Usually, print job resolving is done on-the-fly, by the specified interface program, such as "papif", and jobs queued in the printer's spool directory are not yet resolved. This design approach saves spooling storage, particularly if you are using ImageServer.
The resolve switch causes the "papsrv" to call the pseudointerface program "HELIOSDIR/bin/psresolve", which compares the fonts needed by the document with the printer's resident font list ("FONTS" file in the printer's spool directory), and with the list of available server fonts in
"HELIOSDIR/var/spool/psfonts/FontDirectory". Thus, this is more intelligent than choosing Postscript Job from the application's print dialog - the latter always includes all document fonts, regardless if needed or not.
You should use the resolve switch to prepare print job files for printing offline or with a printer or typesetter whose hardware interface is not supported by EtherShare, but you must not use resolve in conjunction with the standard EtherShare interface programs, because all references will be included twice and the job will fail.
The resolve switch must be specified in each "papsrv" entry for which job resolving is desired.
Be aware that if the job then gets printed on a different host and/or printer, it will not contain all required fonts if it has been resolved with an inappropriate "FONTS" file.
foreground
bool TRUE
The "papsrv" induces Apple's LaserWriter printer driver to spool the jobs directly to the selected EtherShare queue by default.
7.10.2 Output driver settings
IfType
str ""
Specifies the printer connection type for a particular printer, e.g. AppleTalk, TCP, Create PDF, Windows Printer, etc. The setting reflects that of the Connection: field in EtherShare Admin's Printers: configuration window.
mail
bool TRUE
Determines whether printer errors are reported back to the originator of the print job through HELIOS Mail. Even if you specify FALSE, printer errors are still recorded in the printer log file, and many types of errors are also written to the system messages file, allowing you to view them later with EtherShare Admin or an editor program such as vi.
watchtime
int 10
Specifies the time interval in seconds with which the printer interface program interrogates the printer's status channel. As a diagnostic aid, you can use the UNIX "lpq" program to check the status of each spooled printer. "lpq" returns the status messages that you normally see in the dialog box of the LaserWriter driver for locally connected AppleTalk printers.
The Print Server does not return such status messages to the workstations - it only returns them to the "Print jobs" window in EtherShare Admin. The watchtime parameter has been provided because the PostScript processors of some printers time out in certain unusual situations if you check the printer's status channel for extended periods of time.
chargebanner
bool TRUE
This switch causes the printer's page count to include the number of banner pages in the total amount of pages.
bannerlast
bool FALSE
This preference determines that the banner page is ouput after the print job has been terminated on the printer.
bannerfirst
bool TRUE
Causes the printer to output a banner page before the print job (compare bannerlast above).
magic
bool FALSE
PostScript printers normally cannot accept print jobs consisting of "flat" ASCII data. They require the print job to be in PostScript format. ASCII print data can be manually converted to PostScript with the "pstext" utility. In addition to this, the interface programs of the Print Server are also able to automatically detect whether a particular job is in PostScript or ASCII format, by scanning the start of the job for the "signature" string "%!PS-Adobe". If this string is missing, the job is assumed to be non-PostScript, and is converted to PostScript automatically before printing.
ctrld
bool FALSE
This flag determines whether the "Ctrl-D" character should be used to indicate "end-of-print-job". This is necessary if the printer is connected to TCP/IP through a terminal server and a serial interface.
clientmessages
bool TRUE
This flag determines whether printer status messages are reported to the AFP-client (or PCShare client, respectively). These messages pop up as display messages and report e.g. paper jams, misfed paper, and other printer-related errors.
spoolspool
bool FALSE
This flag determines whether a spooled print job is "marked" with the information that it has already been spooled. If is set to TRUE, a spooled print job is not recognized as already spooled, thus setting this preference to TRUE is only meaningful for the first spooler in line of a chained EtherShare queue.
ignoreresolveopts
bool FALSE
The parameter ignoreresolveopts, when set, makes a second EtherShare spooler ignore all remarks on resolved references from a prior spooling process. If you merely want a spooler to ignore single references, e.g. references regarding included fonts etc., you may set one or more of the following flags:
ignoreprocset-resolveopt
bool FALSE
With the ignoreprocsetresolveopt flag set, the next (second) EtherShare spooler ignores information about included procsets only.
ignorefontresolveopt
bool FALSE
With the ignorefontresolveopt flag set, the next (second) EtherShare spooler ignores information about included fonts only.
ignoreinclude-resolveopt
bool FALSE
With the ignoreincluderesolveopt flag set, the next (second) EtherShare spooler ignores information about included EPSF files only.
ignoreopiresolveopt
bool FALSE
With the ignoreopiresolveopt flag set, the next (second) EtherShare spooler ignores information about resolved OPI-references only.
rsslimit
int 0
The preference rsslimit (resident set size limit) is determined by the maximum number of kB a printer interface program can utilize as memory. If this parameter is not set, the memory administration is up to your system settings.
nice
int 0
The priority of a printer interface program - compared to other executable programs on the Print Server - can be altered. The UNIX parameter nice lets you increase/reduce the priority, and therefore the speed of a program. The higher the priority of a program, the less "nice" its behavior towards other applications. The values are as follows:
value for nice > 0 slower / "nicer" towards other
applications
value for nice < 0 faster / less "nice" towards other
applications
extendedinfo
bool TRUE
The printer log files ("printer.acct.x") contain information about printing time/date, document name, user, fonts, and more. With this flag set to TRUE, the range of information for each print job is increased by e.g. an OPI image replacement list and the total number of bytes printed.
facility
str ""
facility is a string that ought to be set by the system administrator only, since its use requires advanced knowledge on UNIX programming. For further reference see the UNIX manual pages "syslogd(1)".
7.10.3 More "papif" preference keys
entity
str ""
entity is the NVE name:type@zone of the printer (e.g. printer1:LaserWriter@HELIOS) with which it is known
to the AppleTalk network. This name is not the same as the AppleTalk name of the printer queue. Note that if print jobs are sent from workstations directly to the printer, they bypass the printer queue, and thus do not gain the advantages of spooling, "prep" file management, etc.
This parameter reflects the settings from EtherShare Admin's Type:, Zone:, and Name: pop-up menus.
localwinsize
int 8
Specifies the maximum number of data packets that are passed from "papif" to the printer through the network during a transaction. The number of packets may need to be limited if the buffer size in the printer is too small. This preference can be varied to optimize the data transfer rate.
remotewinsize
int 8
Specifies the maximum number of data packets that are passed from the printer to "papif" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. This preference can be varied to optimize the data transfer rate.
7.10.4 More "tcpif" preference keys
host
str ""
(EtherShare Admin option Host Name:)
Specifies the Internet number of the printer in the TCP/IP network (or of the printer's terminal server, if any).
service
int ""
(EtherShare Admin option Port:)
This preference specifies the service port number (also called the service code), which specifies the process within host which is responsible for the printer. The port number is between 1 and 65535.
rprinter
str ""
Specifies the name of the remote printer on the remote host, as stated in the "HELIOSDIR/var/conf/printcap" file.
tcpresolve
bool TRUE
(EtherShare Admin option PostScript Printer)
When a print job is processed, and the flag is set to FALSE, the print job remains "untouched" and is passed on without any changes.
statusport
bool TRUE
Specifies whether a separate communications channel for status messages with the address <port+1> is provided.
7.10.5 More "shmif" preference keys
key
str ""
(EtherShare Admin option Key File:)
Specifies the path (including file name) of the Shared Memory "key" file. The file must already exist. The RIP must be configured with the same path.
The RIP and the "Shared Memory" interface program use the key file's "inode" to create a unique numeric key, and do not modify or write to the file in any other way. Accordingly, any existing file (such as "/bin/ls") can be used for this purpose. See the description of "ftok" in your UNIX documentation for related information.
7.10.6 More "diskif" preference keys
diskresolve
bool TRUE
(EtherShare Admin option PostScript Printer)
Specifies if any resolving is done within a PostScript job. When a print job is processed to a "Print To Disk" queue, and the switch is set to FALSE, the print job remains "untouched" and is passed on without any changes.
pssuffix
bool TRUE
This flag determines whether the suffix ".ps" is appended to the processed print job file. In case the switch is set to FALSE the file name extension ".ps" is omitted.
prefix
str ""
(EtherShare Admin option Name Prefix:)
Specifies whether files which come from a specific printer queue are "marked" with a prefix before their original file name. This may be quite reasonable when several
"Print To Disk" queues print to the same destination.
dir
str ""
(EtherShare Admin option UNIX Directory:)
Specifies the (absolute) UNIX path of the directory, where the processed print job is stored. The file name results from the print job title with the typically appended suffix ".ps".
If dir points to UNIX FIFO (named "pipe") rather than pointing to a directory, the processed print data are written to that "pipe" directly.
If dir starts with a pipe character ("|") the whole string following "|" is recognized as a UNIX command line, and the processed print data are piped into the executed program.
notifyprog
str ""
(EtherShare Admin option Notify Program:)
This parameter will only be recognized if dir is specified as well. notifyprog is called as soon as "diskif" has successfully resolved the print job.
E.g.: notifyprog=/usr/local/bin/disknotify
"diskif" exports the following environment variables during the program call:
HELIOSDIR=
<environment variable for the HELIOS install path>
HELIOS_JOBFOR=
<user name (if available) of print job creator>
HELIOS_JOBUSER=
<user name (if available) as known to "lpd">

HELIOS_JOBHOST=
<name (if available) of server which hosts the printer queue>

HELIOS_JOBTITLE=
<print job title (if available)>

HELIOS_PRINTERNAME=
<logical (UNIX) name of the printer queue>

HELIOS_JOBPAGES=
<expected number of pages. This value may differ slightly from the actual number>

HELIOS_JOBSIZE=
<expected print job size (in bytes). The stated value is often smaller than the actual size>

HELIOS_DFFILE=
<name of created PostScript file.>

compression
str ""
(EtherShare Admin option Compression:)
Determines the compression type. You can choose from different types of compressing: Compress and ZIP. None means that there is no file compression applied at all.
diskuserdir
bool FALSE
(EtherShare Admin option Create folder for each user)
Specifies if the PostScript files are stored in a folder
per user.
7.10.7 More "holdif" preference keys
jobholdtime
int 0 (i.e. )
(EtherShare Admin option Hold Time:)
Determines the time a processed print job remains in a
hold/error queue. If jobholdtime is set to 0, the print job perpetually remains in the hold/error queue. This parameter is compulsory, i.e. it has to be set with a certain value.
7.10.8 More "balanceif" preference keys
printers
strlist ""
(EtherShare Admin option Printers:)
A string which contains, separated by commas and without any spaces, the logical (UNIX) printer names of those devices which form a printer group for balancing print loads.
7.10.9 More "pdfif" preference keys
distillhost
str ""
(EtherShare Admin option Host Name:)
This preference specifies the host name of the machine where the CreatePDF Server/Acrobat Distiller is installed.
distillservice
int 2005
Specifies the TCP port number of the Create PDF Server.
distillprefix
str ""
(EtherShare Admin option Name Prefix:)
This parameter will only be recognized if distilldir is specified as well. With "string", you can define a file name prefix for all PDF files that are sent to the selected directory. This can help you classify your PDF files if you have several "Create PDF" queues and save all PDF files into the same directory.
distilldir
str ""
(EtherShare Admin option UNIX Directory:)
This preference specifies the path of the directory where the generated PDF files are saved.
createpdf
bool TRUE
This preference determines if a PDF file is created at all.
distillnotifyprog
str ""
(EtherShare Admin option Notify Program:)
This parameter will only be recognized if distilldir is specified as well. With this preference the path of the "distillnotify" program is specified.
E.g.: distillnotifyprog=/usr/local/bin/crpdfnotify
"pdfif" exports the following environment variables during the program call:
HELIOSDIR=
<environment variable for the HELIOS install path>
HELIOS_JOBFOR=
<user name (if available) of print job creator>
HELIOS_JOBUSER=
<user name (if available) as known to "lpd">

HELIOS_JOBHOST=
<name (if available) of server which hosts the printer queue>

HELIOS_JOBTITLE=
<print job title (if available)>

HELIOS_PRINTERNAME=
<logical (UNIX) name of the printer queue>

HELIOS_JOBPAGES=
<expected number of pages. This value may differ slightly from the actual number>

HELIOS_JOBSIZE=
<expected print job size (in bytes). The stated value is often smaller than the actual size>

HELIOS_VFFILE=
<name of created PDF file>

distillresolve
bool TRUE
Specifies if any resolving is done within a PostScript job. When a print job is processed to a "Create PDF" queue, and the switch is set to FALSE, the print job remains "untouched" and is passed on without any changes.
userdir
bool FALSE
(EtherShare Admin option Create folder for each user)
Specifies if the PDF files are stored in a folder per user.
writesize
int 128*1024
Specifies the TCP write buffer size in bytes.
readsize
int 128*1024
Specifies the TCP read buffer size in bytes.
keepepsfsize
bool TRUE
If set to TRUE, this preference determines that the PDF page size is taken automatically from the BoundingBox if the job is an EPSF file rather than a PostScript file. This preference is only meaningful if distillresolve is set to TRUE as well.
7.10.10 More "timeif" preference keys
printtimes
strlist ""
(EtherShare Admin option Start printing to hold queue on:)
With this preference a list of so-called "time spec" strings for a time queue can be defined. This type of printer queue immediately forwards the jobs to the hold queue during the specified date/time. Outside the defined times the jobs remain in the time queue until the next date/time specification is reached.
Usage:
[!]Duration/StartTime[,StartTime...][/DayOfWeek[,-DayOfWeek...]
||DayOfMonth[,-DayOfMonth...][/Month[,-Month...]]]

Consider the following for the single specifications:
Duration Hours:Minutes required
StartTime Hour:Minute required
DayOfWeek Sun-Sat optional
DayOfMonth 1-31 optional
Month 1-12 optional
An "!" character (exclamation mark) before the following specifications negates the entry, i.e. date/time in which the time queue must not forward jobs to the hold queue.
Example:
3:0/15:0/Tue,Wed,Sat,Sun
In the above given example, print jobs are immediately forwarded to the hold queue on Tuesdays, Wednesdays, Saturdays and Sundays from 15.001 for 3 hours (and
0 minutes).
Of course, you can specify a set of several "time spec" strings in order to obtain several modes of operation from the same time queue.

Note: By means of EtherShare Admin you can only define one "time spec" string at a time.

Note: Entries in this preference specify when a print job
is forwarded to the hold queue. Therefore, setting printtimes is only meaningful if a hold queue is already set.

7.10.11 More "cloneif" preference keys
clones
strlist ""
(EtherShare Admin option Duplicate to Printers:)
Specifies a comma-separated list of printer queues to which print jobs are cloned (duplicated) from the original queue.
7.10.12 More "smbif" preference keys
SMBPrinterHost
str ""
(EtherShare Admin option Computer Name:)
Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.
SMBPrinterUser
str ""
(EtherShare Admin option User Name:)
Specifies the name of the user who has shared the printer.
SMBPrinterPasswd
str ""
(EtherShare Admin option Password:)
Specifies the (encrypted) user password.
SMBPrinterName
str ""
(EtherShare Admin option Printer Name:)
Specifies the name under which the printer is shared.
SMBPrinterResolve
bool TRUE
(EtherShare Admin option PostScript Printer)
If a file is sent to a Windows printer queue, with this option set to FALSE, the print job remains "untouched" and is passed on without any changes.
postscript
bool TRUE
(EtherShare Admin option PostScript Printer)
If a file is sent to a TCP, Remote LPR, Print To Disk, or Windows printer queue, with this option set to FALSE, the print job remains "untouched" and is passed on without any changes. For this preference, the key must be extended to "Printers/<printer queue>/pcfilter/postscript".
7.11 Service Controller preference keys
(Requires a restart of the service (see 9.1 "srvutil") to take effect.)
Key: Services/<my_service>/<preference>
ExecPath
str ""
Specifies the path to the server executable. ExecPath can be either an absolute path (starting with "/") or a relative path. A relative path is interpreted relative to the HELIOS installation directory (e.g.: "/usr/local/helios").
Enabled
bool TRUE
Specifies whether the service is to be started by the command "srvutil start all".
DependsOn
strlist ""
Specifies a list of services that <my_service> depends on. If <my_service> depends on <your_service> then <my_service> will always be started after <your_service> is started, and it will be stopped before <your_service> is stopped.
OptdependsOn
strlist ""
Specifies a list of services that <my_service> optionally depends on. The only difference to DependsOn is that optional dependencies are ignored if the specified service is not installed.
The next three preferences control the automatic restart feature of the HELIOS Service Controller:
RestartDelay
int 10
Specifies the time in seconds that the HELIOS Service Controller waits before it restarts a service.
RestartLimit
int 10
Specifies the maximum number of restarts for a service before it is disabled.
RestartReset
int 60
Specifies the time in seconds during which the HELIOS Service Controller tries to restart a service (according to the value specified in the RestartLimit preference) before resetting the counter to "0".
7.12 SLP Server preference keys
(Requires a restart of the service (see 9.1 "srvutil") to take effect.)
Key: Programs/slpsrv/<preference>
isDA
bool (no default)
Specifies whether the server works as a Directory Agent.
If this preference is not set, and more than one network interface is configured, then the server becomes a Directory Agent (8 "Service Location Protocol (SLP)"). The setting reflects that of the SLP Directory Agent: buttons in EtherShare Admin's Server Settings configuration window
(Lists > Server Preferences).
useScopes
str ""
This preference contains the scopes which this server uses for SLP registrations. The setting reflects that of the SLP Scopes: field in EtherShare Admin's Server Settings configuration window (Lists > Server Preferences).

Important: If a Directory Agent is active and a Service Agent uses the scope that is NOT supported by a Directory Agent, its registrations are not available.

1
Note that for "StartTime" the 24-hour code must be used!


© 2002 HELIOS Software GmbH