Reference: Application Settings

Storage:

(Hamster root)\Hamster.ini

asServiceFile = 1

Returns directory and filename of the service program (read-only).

Content: Type: String, Values: (see above), Default: (see above)
Storage: Hamster.ini: [App] ServiceFile
asServiceName = 2

Returns the name of the service program (read-only).

To change the name, the service has to be uninstalled first and the new name has to be set manually in Hamster.ini.

Content: Type: String, Values: (see above), Default: HamsterService
Storage: Hamster.ini: [App] ServiceName
asDisplayName = 3

Name of the service as displayed in the list of installed services.

Content: Type: String, Values: (see above), Default: HamsterService
Storage: Hamster.ini: [App] DisplayName
asDependencies = 4

Sets dependencies for starting the service, i. e. Hamster service is not started until the given ones are ready. Multiple service names have to be separated by a comma.

Content: Type: String, Values: (see above), Default: (empty)
Storage: Hamster.ini: [App] Dependencies
asInteractive = 5

If set to 1, the service is marked as "interactive" whenever it is installed.

Content: Type: Boolean, Values: 0/1, Default: 1
Storage: Hamster.ini: [App] Interactive
asObjectPrefix = 6

If set, the given string is prepended to all named kernel objects used by Hamster.
Situation is a little bit unclear, but Windows XP might need a setting of "\Global\" to share one Hamster between multiple users on the same machine.

Content: Type: String, Values: (see above), Default: (empty)
Storage: Hamster.ini: [App] ObjectPrefix
asServiceVersion = 7

Returns version string of the service program (read-only).

Content: Type: String, Values: "a.b.c.d", Default: (see above)
Storage: Hamster.ini: [App] ServiceVersion
asLogFileMask = 10

Determines the log entry types, that are stored in the log file. Available types are (in hex):

   LOGID_ERROR  = $8000;   // Errors
   LOGID_WARN   = $4000;   // Warnings
   LOGID_SYSTEM = $0800;   // System messages
   LOGID_INFO   = $0080;   // Information
   LOGID_DETAIL = $0040;   // Details
   LOGID_DEBUG  = $0008;   // Debug
   LOGID_STATUS = $0004;   // Current state
   LOGID_FULL   = $0001;   // Full log with all data sent to or received by HService

Each type is represented by a single bit in an unsigned 16 bit integer (uint16). If bits are set, the corresponding log entry types are selected. The bit mask is transferred and stored as a string, giving the bit mask value in hex (e. g.: "C000" = $8000 or $4000 = Errors and Warnings) .

Content: Type: String (Integer as Hex), Values: (see above), Default: C8C0
Storage: Hamster.ini: [Setup] log.file.mask
asLogViewMask = 11

Like asLogFileMask, but determines the log entry types that are automatically transfered to all HControl clients, that are currently connected to HService.

Content: Type: String (Integer as Hex), Values: (like asLogFileMask), Default: C880
Storage: Hamster.ini: [Setup] log.view.mask
asLogTaskMask = 12

Like asLogFileMask, but determines the log entry types that are noted internally for each task.
Note: The only purpose left is the reply for RC server's TASK LIST command, which is used by HamRC. As it doesn't make much sense any more, asLogTaskMask might be removed completely in a future version.

Content: Type: String (Integer as Hex), Values: (like asLogFileMask), Default: C884
Storage: Hamster.ini: [Setup] log.thread.mask=C884
asLogFileMax = 13

Number of log files to keep. A new log file is started whenever HService is started or on day changes.

Content: Type: Integer, Values: 1..MaxInt, Default: 14
Storage: Hamster.ini: [Setup] LogFile.FileMax
asLogViewMax = 14

Maximum number of recent log lines to be buffered in memory. Only lines still available in this buffer are sent to any HControl clients.

Content: Type: Integer, Values: 10..9999, Default: 250
Storage: Hamster.ini: [Setup] LogFile.ViewMax
asLogMSecs = 15

If set to 1, the timestamp noted in logfile entries contains milliseconds.

Content: Type: Boolean, Values: 0/1, Default: 0
Storage: Hamster.ini: [Setup] LogFile.MSecs
asPathStartup = 20

This is just a "virtual", read-only setting. On startup, its value is initialized with the directory from which HService.exe was started - changing it has no effect.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Startup
asPathBase = 21

Root directory, where Hamster's data files are located.

Default value is the startup directory (asPathStartup).

Note: On startup, this setting is always read from the Hamster.ini in the startup directory. If there's an entry for it, all other settings are read from the directory, it is pointing to.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Main
asPathLogs = 22

Directory, where all log files are stored.

Default value is sub-directory "Logs" in root directory (asPathBase).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Logs
asPathServer = 23

Directory, where information about remote servers is stored.

Default value is sub-directory "Server" in root directory (asPathBase).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Server
asPathGroups = 24

Directory, where newsgroups information is stored.

Default value is sub-directory "Groups" in root directory (asPathBase).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Groups
asPathMails = 25

Directory containing the local POP3 mailboxes.

Default value is sub-directory "Mails" in root directory (asPathBase).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Mails
asPathNewsOut = 26

Directory where posted articles are saved until they are posted to remote servers.

Default value is sub-directory "News.Out" in groups directory (asPathGroups).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] News.Out
asPathMailOut = 27

Directory where mails are saved until they are sent to remote servers.

Default value is sub-directory "Mail.Out" in mails directory (asPathMails).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Mail.Out
asPathNewsErr = 28

Directory where articles are stored, that were rejected by remote servers.

Default value is sub-directory "News.Err" in groups directory (asPathGroups).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] News.Err
asPathScripts = 29

Directory containg all scripts (*.hsc), that can be run or are accessible by Remote Control server. If it is different from the root directory, scripts in sub-directories of this directory can be accessed as well.

For historical reasons, this value defaults to the root directory (asPathBase), but recommended setting is (sub-directory) "Scripts".

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Scripts
asPathModules = 30

Directory containing modules (*.hsm), that can be used by scripts and are accessible by Remote Control server.

Default value is the scripts directory (asPathScripts).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Modules
asPathReports = 31

Directory containing reports (*.htm).

Default value is the log directory (asPathLogs).

Note: Value is treated as a sub-directory within root directory (asPathBase), unless it starts with a drive or path separator.

Content: Type: String, Values: (see text), Default: (see text)
Storage: Hamster.ini: [Directories] Reports

 

[www.elbiah.de Hamster Playground Documentation]