Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : ENABLE-CONNECTIONS( ) method
 

ENABLE-CONNECTIONS( ) method

Specifies the TCP/IP port that the AVM uses to listen for new connections. Once called, the AVM automatically listens for and accepts new connections for the specified port.
Return type: LOGICAL
Applies to: Server socket object handle

Syntax

ENABLE-CONNECTIONS ( connection-parms )
connection-parms
A character string expression that contains a space-separated list of one or more socket connection parameters.
The following table describes the socket connection parameters you can include in this string.
Table 77. Socket connection parameters
Parameter
Description
-S socket-port
The TCP/IP port number that the AVM should listen to and accept connections on. You can specify either an explicit port number or a TCP service name. If you use a TCP service name, the method uses the port number associated with that name in the TCP/IP services file.
-pf filename
Optional. A text file containing any of the socket connection parameters described in this table. If this file contains any other OpenEdge startup parameters, this method ignores them.
-qsize backlog
Optional. The length of the pending-connection queue—that is, the maximum number of connection requests you want the server to queue while it processes the connections already accepted. If the queue is full when a connection request is received, it is refused.The default length of the queue depends on the platform.
Note: On some platforms, the value you supply for backlog is modified by addition, subtraction, multiplication, division, or some combination of these, and it is this modified value that becomes the maximum length of the queue. For more information, see the documentation for your platform.
-ssl
If specified, the connection is SSL-based.
Note: Be sure you need SSL before using this option. SSL incurs more or less heavy performance penalties, depending on resources and load.
-keyalias aliasname
Sets the alias name of the Public[/Private] key and digital certificate to use within the keystore. If not specified, the default default_server key alias is used.
-keyaliaspasswd encpwd
Sets the password to use in accessing the Public[/Private] key and digital certificate. Always specify a -keyaliaspassword when the -keyalias option is used. The default password only exists when using the default_server server certificate.
-nosessioncache
If specified, caching for the SSL client session is disabled.
-sessiontimeout [seconds]
The maximum amount of time, in seconds, that the server waits before it rejects a SSL client's request to resume a session. The default value is 180 seconds.
Neither an AppServer nor a WebSpeed agent can act as a socket server, since they are already listening on a port. ENABLE-CONNECTIONS is only valid from batch clients, GUI clients and character clients. This method will generate an error if it is called from an invalid application. This method will also generate an error if it is called multiple times without the DISABLE-CONNECTION( ) method being called in between.
Note: Connections to an SSL-enabled server socket require the management of public keys on the client (SSL client) and private keys on the server (SSL server). For ABL sockets, the SSL client is the ABL session initiating the SSL connection on a socket object and the SSL server is the ABL session enabling SSL connections on a server socket object. For information on using SSL to secure an ABL socket connection, see the sections on sockets in OpenEdge Development: Programming Interfaces. For more information on SSL and managing private key and digital certificate stores for OpenEdge SSL clients and servers, see OpenEdge® Getting Started: Core Business Services - Security and Auditing.