Progress
Version 9
Product Update Bulletin


ENABLE-CONNECTIONS( ) Method

Specifies the TCP/IP port that Progress should use to listen for new connections. Once called, Progress will automatically listen for and accept 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.

Table D–4 describes each socket connection parameter, which can be included in this string.

Table D–4: Socket Connection Parameters
Parameter
Description
-S socket-port
The TCP/IP port number that Progress 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 Progress 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.

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.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095