fgl_ws_server_start() (version 1.3)

Creates and starts the Web services server.

Note: This function is valid for backwards compatibility, but is not a preferred way to handle Genero Web Services. See the com package for the preferred classes and methods for handling Web services.

Syntax

fgl_ws_server_start(
   tcpPort VARCHAR )
  1. tcpPort is a string representing either:

    • the socket port number (for a single Web Service server)

    • the host and port value separated by a colon (for a Web Service server connecting to an application server). The value of port is an offset beginning at 6400.

Note: If the FGLAPPSERVER environment variable is set, the tcpPort value is ignored, and replaced by the value of FGLAPPSERVER.

Usage

For development or testing purposes, you may start a Web Service server as a single server where only one request at a time will be able to be processed. For deployment, you may start a Web Service server with an application server able to handle several connections at one time using a load-balancing algorithm. The value of the parameter passed to the function determines which method is used.

Examples:

To start a standalone Web Service server:

 CALL fgl_ws_server_start("8080") # A single Server is listening
                                  # on port number: 8080

To start a Web Service server attempting to connect to an application server:

 CALL fgl_ws_server_start("zeus:5") # The server attempt to connect
                                    # to an application server located
                                    # on host zeus and listening
                                    # on the port number 6405

Possible runtime errors

  • -15504: PORT_ALREADY_USED
  • -15514: PORT_NOT_NUMERIC
  • -15515: NO_AS_FOUND
  • -15516: LICENSE_ERROR