! ! File name: TCPIP$POP.CONF ! Product: VSI TCP/IP Services for OpenVMS ! Version: V6.0-24 ! ! Copyright 2015, 2024 VMS Software, Inc. and Hewlett Packard ! Enterprise Development L.P. ! ! POP server configuration file ! ! ! DESCRIPTION: ! ! This is a template for the TCPIP$POP.CONF file. The TCPIP$POP.CONF file ! holds POP configurable fields. The real TCPIP$POP.CONF file must reside ! in the TCPIP$POP default directory (SYS$SYSDEVICE:[TCPIP$POP]. ! ! HP TCP/IP Services for OpenVMS Version 5.7 onwards, all the POP Server ! configuration fields, except the POP tracing logical names, supported ! in TCPIP$POP.CONF file. ! ! NOTES: ! ! 1. Do not modify this file. It exists for documentation purposes and ! will be updated periodically in the TCP/IP Services kit. ! ! 2. The field names for each supported field are listed below. Each one ! is preceded by three exclamation points. If you want to create an ! initial TCPIP$POP.CONF without the comments from this file do: ! ! $ SEARCH /OUT=SYS$SYSDEVICE:[TCPIP$POP]TCPIP$POP.CONF - ! $_ SYS$SYSDEVICE:[TCPIP$POP]TCPIP$POP_CONF.TEMPLATE ! ! Search for three !'s ! ! 3. This template file contains examples of each supported field; it ! does not document the purpose of the fields, their defaults, their ! syntax or the way they interact. ! ! 4. Regarding defaults note that all fields that require a default have ! one built into POP which means that configurations which require all ! the defaults need not even have an TCPIP$POP.CONF file. ! ! Refer to the HP TCP/IP Services for OpenVMS Management guide for more ! information POP Server configuration fields. ! ! ! CONFIGURATION: ! ! Examples for supported fields: ! !!!Link-Idle-Timeout: 0 00:00:00.00 !! Determines the length of time the server allows a link to a POP client to !! remain idle, where time is specified in OpenVMS delta time. A POP link !! remains active until it is released by the POP client. !! If not defined, the POP server does not set a link idle value. ! ! !!!No-Inetd-Server: TRUE ! ! !!!Ignore-Mail11-Headers: TRUE !! If set to TRUE, the POP server ignores the OpenVMS message headers when !! the OpenVMS Mail "From:" field contains an SMTP address, which indicates !! that the message has come from SMTP. ! ! !!!Personal-Name: TRUE !! If set to TRUE, the POP server provides the POP clients with the message !! header "From:" field that includes the sender's personal name, if one !! appeared in the sender's "From:" field. ! ! !!!Purge-Reclaim: TRUE !! If set to TRUE, the POP server performs a PURGE/RECLAIM command action !! after it deletes messages. ! ! !!!Send-ID-Headers: FALSE !! If set to TRUE, the POP server sends X-POP3-Server and X-POP3-ID headers !! for each mail message. If not defined, the ID headers are not sent for !! any mail from an SMTP address ! ! !!!Dis-User-Pass: FALSE !! Disables the client USER and PASS commands and sends a failure message to !! the POP client on receipt of either command. ! ! !!!Trace: FALSE !! If set to TRUE, the POP server records all messages sent to and received !! from the POP client in a log file. ! ! !!!Leave-In-Newmail: FALSE !! If set to TRUE, mail that has been read by the client but not deleted !! remains in the NEWMAIL folder. Allows users to access mail from different !! systems and determine when to move or delete the mail from the POP server. !! If not defined, mail that has been read but not deleted is moved to the !! MAIL folder. ! ! !!!No-SYSACM-User-Pass: FALSE !! Added to support the Username and Password authentication on the ACME !! agents. The ACME agents can be VMS native authentication extensions or !! any other Agents such as LDAP, which can authenticate the VMS user !! externally. When you configure the POP to make use of POP external !! authentication, you must ensure that the ACME agents are up and running. !! No-SYSACM-User-Pass can be assigned with 0 or 1 as follows: !! No-SYSACM-User-Pass: !! Where: is either: !! 0 / FALSE: POP Server uses SYS$ACM system service for username and !! password authentication. !! OR !! 1 / TRUE : POP Server does not use SYS$ACM system service for username !! and password authentication. !! By default, the No-SYSACM-User-Pass is set to TRUE, that is, the POP !! server is configured to use the native VMS authentication using SYS$GETUAI. ! ! !!!Use-Mail-Folder: FALSE !! If set to TRUE, moves all mail to the MAIL folder and displays this folder !! instead of the NEWMAIL folder. ! ! !!!Fast-Scan: TRUE !! If set to TRUE, the POP server estimates the number of bytes for the size !! of the mail message based on the number of lines in the message instead of !! counting the exact number of bytes. Setting this logical may improve !! performance. ! ! !!!Disable-Cleartext: TRUE !! If set to TRUE, the POP server process does not serve incoming connections !! to the cleartext POP port (port 110). It will respond to any client that !! tries to connect with a !!failure message. ! ! !!!Disable-SSL: TRUE !! If set to TRUE, the POP server process does not serve incoming connections !! to the Secure POP port (port 995). The POP server does not listen on port !! 995. Clients trying to connect have their connections rejected. ! ! !!!Log-Level: THREAD !! Defines the type of messages logged by the POP server: !! !! ERROR - Logs only error messages. !! INFORMATIONAL (default) - Logs informational messages and error messages. !! THREAD - Logs information about client and server interactions as well !! as informational and error messages. !! DEBUG - Logs full diagnostic information. This is used for problem !! diagnosis. ! ! !!!SYSACM-Timeout: 60 ! ! !!!Message-Maximum: 25 !! Defines the maximum number of mail messages that a single client can !! download per connection, where n is a number from 0 to 65,535. If not !! defined, the POP server uses the default value of 0 (no maximum). ! ! !!!Message-Size : 4 !! Available starting with TCPIP 5.7 ECO5 release. !! Defines the maximum size of each mail message a client can download, !! where n is specified in megabytes. If not defined, the POP server uses !! default value of 0 (no maximum). ! ! !!!SNDBUF: 1024 !! Allows you to increase or decrease the size of the TCP flow control !! buffer. Sets the SO_SNDBUF socket option to a specific number; n is the !! number 512 or greater. If not defined, the POP server uses the value !! specified in the SHOW PROTOCOL/PARAMETERS command. ! ! !!!Maximum-Threads: 15 !! Allows you to define the number of process threads that POP can activate. !! The default is 15. If you set this to 1, the POP server becomes !! single threaded. ! ! !!!Security: FRIENDLY !! Defines a level of security for the POP server. Determines the timing and !! text of error messages sent from the POP server to the POP client when !! authorization errors occur (for example, when an invalid user name or !! password is sent): !! !! FRIENDLY (default) !! The error messages provide information about a particular error. For !! example, if a password is incorrect, the client receives the following !! error message: !! -ERR password supplied for "jones" is incorrect !! !! SECURE !! One error message is sent in response to all authorization errors !! except when an invalid user name is specified. For example: !! Access to user account "jones" denied !! !! When the POP server receives an invalid user name, it replies to the !! POP client with a +OK message. !! After the POP client sends the password, the POP server sends the -ERR !! access denied message. This method prevents an unauthorized user from !! knowing whether the access was denied because of an incorrect user !! name or password. ! ! !!!DECnet-Rewrite: GENERIC !! Determines how the POP server rebuilds a simple DECnet address (of the !! form node::user) in the OpenVMS Mail "From:" field when it sends the mail !! to the POP client; value is one of the following: !! !! GENERIC - Simple DECnet addresses are changed to the SMTP address format. !! NONE - Simple DECnet addresses are sent unmodified to the POP client. !! TRANSFORM (default) - The POP server attempts to transform the DECnet !! address into an SMTP address by translating the !! DECnet node name to a TCP/IP host name. ! ! !!!Quoted-DECnet-Rewrite: GENERIC !! Determines how the POP server rebuilds a DECnet address that contains !! quotation marks (an address of the form node::"user@host") in the OpenVMS !! Mail "From:" field when it sends the message to the POP client; value is one !! of the following: !! !! GENERIC - DECnet addresses that contain quotation marks are changed to !! the SMTP address format. !! NONE - DECnet addresses that contain quotation marks are sent !! unmodified to the POP client. !! TRANSFORM - (default) The POP server uses the text within the quotation !! marks in the "From:" field it sends to the POP server. ! ! !!!Cert-File: SSL111$CERTS:SERVER.CRT !! Specifies the name of the certificate file that POP uses for SSL. !! If not defined, the default is SSL111$CERTS:SERVER.CRT ! ! !!!Key-File: SSL111$KEY:SERVER.KEY !! Specifies the name of the key file that POP uses for SSL. !! If not defined, the default is SSL111$KEY:SERVER.KEY. !