Valid XHTML 1.0!

GWIA Switches

Last updated: 16 August 2005

Author: Bob Jonkman < bjonkman@sobac.com>

In this page:

There does not seem to be a comprehensive listing of all the startup switches for the Novell GroupWise Internet Access gateway (GWIA), so I've attempted to list them all there. Links should open in a companion window. Please let me know of any errors or omissions..

[Top] Standard GWIA switches

From the Novell Documentation for GroupWise 6.5 Administration Guide Internet Agent Alphabetical List of Switches.

aql
Set outbound address qualification level.
aqor
Place all qualified Domain and Post Office on right of outgoing address.
ari
Additional routing information included in sender's address.
attachmsg
Attaches the message body as an attachment. This is useful for viewing HTML message bodies when using POP3 or IMAP clients (no Advanced Settings tab parameter).
badmsg
Specify handling of undeliverable or corrupt messages.
certfile
Specifies the server certificate file to use. The file must be in Base64/PEM or PFX format. If the file is not in the same directory as the GWIA, specify the full path.
cluster
(NetWare Only) Informs the GWIA that it is running in a Novell Cluster Services environment.
color
Set screen color.
dbchart822
Instructs the GWIA to map inbound non-MIME messages to another character set that you specify. The mapped character set must be an Asian (double-byte) character set.
dhome
SMTP conversion directory.
defaultcharset
Specifies what character set to use if no character set is specified in an incoming message
dia
Disable Internet Addressing
dialpass
Dial-up: password. (Windows Only) Specifies the RAS Security user's password if you are using a Windows NT Remote Access Server (RAS) and the GWIA is not running on the same server as the RAS.
dialuser
Dial-up: userID.
displaylastfirst
Forces the display name format to be Last Name First Name, regardless of the preferred address format.
dsn
Enables Delivery Status Notification (DSN, RFC3461 and RFC3464)
dsnage
specifies the number of days that DSN information about the external sender is retained
etrnhost
Dial-up: ETRN host.
etrnqueue
Dial-up: ETRN queue.
fd822
Foreign domain for non-MIME replies.
fdmime
Foreign domain for MIME replies.
flatfwd
Strips out empty messages when a message is forwarded.
force7bitout
Force the GWIA to use 7-bit encoding and not 8 bit MIME encoding.
forceinbountauth
Forces GWIA to accept connections only from authorized GW UserIDs.
forceoutboundauth
Allows GWIA to send only to hosts listed in gwauth.cfg text file.
fut
Host that will be forwarded undeliverable messages (IP address needs to be surounded by [ ] square brackets ).
group
Expand groups on incoming messages. Contrast keepsendgroups.
help
Displays list of startup switches (no Advanced Settings tab parameter).
hn
Override hostname used in SMTP connection greeting.
home
GWIA home directory (no Advanced Settings tab parameter).
httppassword
Password for HTTP Monitor.
httpport
IP port number for HTTP Monitor (default is 9850).
httprefresh
Page refresh time in seconds for HTTP Monitor (default is 60 seconds).
httpssl
Make secure connections for HTTP Monitor.
httpuser
User name for HTTP Monitor.
imap4
Enable IMAP service.
imapport
TCP/IP port number for IMAP4 service (default is 143).
imapsport
TCP/IP port number for secure IMAP4 service (default is 993).
imapssl
Enable secure IMAP service.
ipa
Default TCP/IP address or DNS name of post office agents.
iso88591is
Map inbound MIME ISO-8859-1 messages to another character set.
it
Number of IMAP4 threads.
keyfile
Private key file to use for secure connections.
keypasswd
Specifies the private key password.
killthreads
Immediately terminate any active send/receive threads when the GWIA restarts.
koi8
Map all outbound MIME messages to the KOI8 (Russian) character set.
ldap
Enable LDAP service.
ldapcntxt
LDAP Context.
ldapipaddr
TCP/IP address for GW authentication.
ldapport
TCP/IP port for GW authentication (default 389 or 636 for secure).
ldappwd
Password for ldapuser
ldaprefcntxt
Limits the directory context in which the secondary (referral) LDAP server searches.
ldaprefurl
LDAP Referral URL.
ldapserverport
Change LDAP TCP/IP listen port (default 389). Linux only.
ldapssl
Use a secure LDAP connection.
ldapthrd
Number of LDAP threads.
ldapuser
User ID with rights to the LDAP directory.
log
Log file directory.
logdays
Number of days before automatic deletion of log files (Log Settings tab).
loglevel
Set logging level (Log Settings tab "Logging Level" parameter doesn't write to gwia.cfg).
logmax
Maximum disk space for log files in KB (Log Settings tab "Max Log Disk Space" doesn't write to gwia.cfg).
maxdeferhours
Number of hours after which the GWIA stops trying to send deferred messages.
mbcount
Mailbomb message count threshold.
mbtime
Mailbomb time threshold.
mh
IP Address of host to relay all outbound messages.
mime
Enable MIME as default for outbound messages.
mono
Set screen to monochrome.
mudas
Maximum undeliverable attachment size in Kbytes.
mv
Specifies a mail view attachment for all inbound Internet messages.
nasoq
Send accounting file only at midnight, not when GWIA quits.
noesmtp
Disables ESMTP support.
noiso2022
Instructs the GWIA to not use ISO-2022 character sets.
nomappriority
Disables conversion of x-priority header to a GW priority message.
nosmp
Disables the NetWare Internet Agent's symmetric multi-processing (SMP) capability (NetWare only)
notfamiliar
Do not include the display name in the From header.
nqpmt
Don't encode the message text if it is 100% US ASCII. This switch works with GWIA 5.2.3 or later (no Advanced Settings tab parameter).
p
SMTP Polling interval for send directory (seconds).
password
Password the GWIA uses to log into a remote server to access the domain database and GWIA directories (Required Parameters tab).
pid
Specifies the process ID for this instance of the GWIA.
pop3
Enable POP3 Service.
popintruderdetect
Enable intruder detection for POP3 connections.
popport
TCP/IP port to use for POP3 (default is 110).
popsport
TCP/IP port to use for secure POP3 (default is 996).
popssl
Enables secure POP3.
pt
Number of threads for POP3 connections.
rbl
Enables Real-time Black List lookups.
rd
Number of SMTP receive threads.
realmailfrom
Instructs the GWIA to use the real user in the Mail From field instead of having auto-forwards come from Postmaster and auto-replies come from Mailer-Daemon.
recv
Receive-only mode.
rejbs
Reject mail if sender's indentity cannot be verified.
rt
Number of inbound conversion threads.
sd
Number of SMTP send threads.
st
Number of outbound conversion threads.
single
Run one send and one receive cycle, then terminate.
smp
Enable SMP (NLM only).
smtp
Enable SMTP Service.
smtphome
SMTP services directory (for third party use).
te
SMTP wait time for connection establishment (minutes).
tg
SMTP wait time for initial greeting (minutes).
tc
SMTP wait time for commands (minutes).
tr
SMTP wait for TCP read (minutes).
td
SMTP wait time for data (minutes).
tt
SMTP wait for connection termination (minutes).
usedialup
Dial-up: use dial connection.
uueaa
UUEncode outbound attachments (non-MIME).
user
Login ID the GWIA uses to log into a remote server to access the domain database and GWIA directories (Required Parameters tab).
work
Temporary file directory for message conversion.
wrap
Line wrap length for message text on outbound mail.
xspam
The new /xspam switch instructs the GWIA to check for the X-Spam-Flag, and if found, to attach this information to the message as it enters your GroupWise system. This improves the efficiency of the Junk Mail Handling feature in the client. See also TID10087971: Handling X-Spam flagged Internet mails.

[Top]Additional GWIA switches from TID10010980: GWIA Switches and Advanced Settings Option

allowunknownrcptinidom
Allow unknown user in an internal idomain to relay messages off of GWIA (6.5 SP4 or later only).
convert
Allow attachment conversion to ASCII
corr
Correlation database directory
ipp
Default TCP/IP port of post office agents (see IPA).
irfouid
(no Advanced Settings tab parameter).
l
Set language (no Advanced Settings tab parameter).
logdiskoff
disables the log file writing feature (no Advanced Settings tab parameter).
mailview
GroupWise view name for incoming messages.
norouting
Disable SMTP message relaying. Prevents spamming from your system (Access Control tab | SMTP Relay).
rt-0
Set receive-only mode.
st-0
Set send-only mode.
[ rt-0 and st-0 appear to be errors in TID 10010980: setting inbound conversion threads to 0 shouldn't restrict outbound capability, nor should restricting outbound conversions threads affect inbound capability. On the other hand, setting rd-0 should set Send Only mode (no Receive threads), and sd-0 should set Receive Only mode (no Send threads) --Bob. ]

[Top] Other GWIA switches

displayfirstlast
Forces the display name format to be "First Name Last Name", regardless of the preferred address format. See TID 10078313: Wrong display name on outbound Internet messages
DontReplaceUnderscore
Use when receiving Undeliverables when replying to a sender that has underscore characters in their email address or when replying to a sender that has the same IDomain name as the GroupWise recipient. This problem has been fixed in at least the 2004-03-09 build of GWIA, but is present again in GW6.5.2 (2004-07-23) and later.
Note, you must use this switch in the gwia.cfg in order for the fix to take place. See TID10094324: Undeliverables when replying to a sender that has underscore characters in their email address.
It may be necessary to remove the switch so email addresses with spaces that get converted to underscores will be able to receive messages returned with underscore.
imip
Enable the GWIA to properly process ical attachments from the internet. Enabled in GW6.5.3. This switch is not supported by Novell; see TID10070007: Does GroupWise GWIA support ICAL?
msstu
Convert spaces to underscores, and underscores to #u#, as well as other character conversions. This conversion did not conform with industry standards so it was dropped with the release of GroupWise 5.5. After updating GWIA to a 5.5 1 level, use the switch /msstu in gwia.cfg file to allow these character conversions. See TID10019477: GWIA not converting space to underscore with GWIA 5.5. Character translations are documented in Character Mapping from GroupWise Addresses to Internet Addresses.
HTTP
xxx
keepsendgroups
assuming 6.5.4 or later. This will tell GWIA to put TO:>distlist@yourdomain.com< in the MIME header instead of expanding every user on the TO: line. (From a message by Morris Blackham on NGWList) See also group

In this page: