59.8 IMAP4 Switches

The following optional startup switches that can be used to configure the GWIA’s IMAP4 service:

59.8.1 --imap4

Enables IMAP4 client access to GroupWise mailboxes through the GWIA. See Section 53.2.1, Enabling POP3/IMAP4 Services.

Syntax: --imap4

59.8.2 --imapport

By default, the GWIA listens for IMAP4 connections on port 143. This switch allows you to change the IMAP4 listen port.

Syntax: --imapport port_number

Example: --imapport 144

59.8.3 --imapreadlimit

By default, the GWIA downloads a maximum of 20,000 items at a time. This switch allows you to specify, in thousands, the maximum number of items you want the GWIA to download. For example, specifying 30 indicates 30,000.

Syntax: --imapreadlimit number_of_items

Example: --imapreadlimit 30

59.8.4 --imapreadnew

By default, the GWIA reads items in a folder from the oldest to the newest. As a result, if a folder contains more items than are allowed by the /imapreadlimit setting, users receive the older items but not the newer items. Enable this switch so that the GWIA reads items from the newest to the oldest. This ensures that users receive all their new items in a timely manner.

Syntax: --imapreadnew

59.8.5 --imapsport

By default, the GWIA listens for secure (SSL) IMAP4 connections on port 993. This switch allows you to change the IMAP4 SSL listen port.

Syntax: --imapsport port_number

Example: --imapsport 994

59.8.6 --imapssl

Disables, enables, or requires secure (SSL) connections between IMAP4 clients and the GWIA. See Section 55.4, Securing GWIA Connections with SSL.

Syntax: --IMAP4ssl enabled|disabled|required

Example: --popssl required

Option

Description

enabled

The IMAP4 client determines whether an SSL connection or non-SSL connection is used. By default, the GWIA listens for SSL connections on port 993 and non-SSL connections on port 143. You can use the ‑‑imapsport and ‑‑imapport switches to change these ports.

required

The GWIA forces SSL connections on port 993 and port 143. Non-SSL connections are denied. You can use the ‑‑imapsport and ‑‑imapport switches to change these ports.

disabled

The GWIA listens for connections only on port 143, and the connections are not secure. You can use the ‑‑imapport switch to change this port.

59.8.7 --it

Specifies the maximum number of threads to be used for IMAP4 connections. The default number is 10. You are limited only by the memory resources of your server. See Section 53.2.1, Enabling POP3/IMAP4 Services.

Syntax: --it number_of_threads

Example: --it 15

59.8.8 --noimapversion

Suppresses the GroupWise version and copyright date information that the GWIA typically responds with when contacted by an IMAP client.

Syntax: --noimapversion

59.8.9 --sslit

Specify the maximum number of threads you want the GWIA to use for secure IMAP4 connections. You are limited only by the memory resources of your server. See Section 53.2.1, Enabling POP3/IMAP4 Services.

Syntax: --sslit number_of_threads

Example: --sslit 15