The following is a list of parameters available in the safmqconf configruation file for the safmq server. If the file specifed by SAFMQ_CFG or via the command line cannot be found, safmq attempts to locate the file in either "/etc" in case of a unix system or in the "%SystemRoot%" directory aka. the "widnows" directory.
- port:9000
- Specifies the clear-text listening port for the safmq server, queries will be served from this port
The default, if not defined, is 9000- address: *
- Specifies the clear-text listening network address. This is useful to limit the available interfaces in multi homed systems. Values are seperated by semi-colons, with colons seperating addresses from ports. If a port is not specified, the default port, set by the "port" parameter, will be used instead. An asterisk "*" indicates all local interfaces.
Example:localhost:9000;192.168.1.1;*:9009;192.168.1.1
The default, if not defined, is *- queue_dir: ./queues
- Specifies the location of the queue data.
The default, if not defined, is ./queues- config_dir: ./queues
- Specifies the location of the safmq security configuration files.
The default, if not defined, is ./queues- ssl_port:9001
- Specifies the secure sockets layer listening port for secure communications
The default, if not defined, is 9001- ssl_address: *
- Specifies the secure sockets layer listening network address. This is useful to limit the available interfaces in multi homed systems. Values are seperated by semi-colons, with colons seperating addresses from ports. If a port is not specified, the default, port set by the "port" parameter, will be used instead. An asterisk "*" indicates all local interfaces.
Example:localhost:9001;*:9002;192.168.1.1
The default, if not defined, is *- ssl_cert:
- Spedifies the location of the ANSI X509 servercertificate file in PEM format
Thre is no default value.- ssl_key:
- Spedifies the location of the ANSI X509 privagte key file in PEM format
Thre is no default value.- ssl_ca:
- Spedifies the location of certificate authority file or directory
Thre is no default value.- ssl_client_cert:
- Spedifies the location of the ANSI X509 client certificate file in PEM format
Thre is no default value
Note: can be the same as the ssl_cert if the server should use its server certificate when acting as a client.- ssl_client_key:
- Spedifies the location of the ANSI X509 client privagte key file in PEM format
Thre is no default value
Note: can be the same as the ssl_cert if the server should use its server private key when acting as a client.- enable_forwarding: no
- Enables the safmq server to forward messages to other message queue servers when requested to do so by the client.
The default, if not dfined, is no, other values include yes.- accept_forwards: no
- Enables the safmq server to accept forwarded messages from other message queue servers.
The default, if not dfined, is no, other values include yes. max_file_size: 41943040- maximum size in bytes of queue storage files defaults to 40MB if not set
- file_handle_cache_size: 50
- Number of file handles to keep open to improve file access performance, defaults to 50 if not set
- startup_log
- startup events
- shutdown_log
- shutdown events
- signon_log
- ogs each login attempt w/ failures
- user_log
- logs user create,delete,acl
- group_log
- logs group create,delete,acl,user add,user delete
- queue_log
- logs queue create,delete,acl
- message_log
- logs ttl events
- forward_log
- logs forwarding errors
- info_log
- logs informational status messages
Notes on Logging:
Log events may be sent to 1 of 5 places
Log file names may include "strftime" escapes to have date based log file names. These escapes include but are not limited to:
- The first NONE causes the event to not be recorded
- The second SYSTEM_LOG causes the event to be sent to the system logger, syslog on Unix systems and the NT Event Logger on Windows NT derived systems
- The third allows log entries to be published to a file with strftime escape codes for time-based log file naming
- The foruth location STDERR writes log events to stream #2 the standard-error output stream.
- The last location STDOUT writes log events to stream #1 the standard-output stream.
%Y -- 4 digit year
%y -- 2 digit year
%m -- 2 digit month
%d -- 2 digit day
%H -- 2 digit 24-hour time of day
%M -- 2 digit minute of hour
%S -- 2 digit second in the hour
%a -- Abbreviated weekday name
%b -- Abbreviated month name
%U -- Week of year (00-53)
%j -- Day of year (001-366)
example: new log file every day with 4 digit year
/var/log/safmq.%Y%m%d.log c:\logs\safmq_%Y%m%d.logexample: new log file monthly
/var/log/safmq.%Y.%b.log c:\logs\safmq_%Y_%b.logUsing the special names NONE, STDOUT, STDERR or SYSTEM_LOG causes log data to be written to the special loations listed above.
Table of Contents Hierarchy of classes