Connection URL Syntax Explained

The Connection Setup dialog box enables you to create URLs that can be distributed to your end-users; they can then paste the URL into their browsers to run your application.

The following example URL connects to your application. See the table beneath it for a breakdown of the syntax:

http://127.0.0.1:3000?hostgw=127.0.0.1&portgw=8009&alias=calc&aliasArgs=%20sum&showvirkey=n&theme=ThemeFX

These are the available URL parameters:

Syntax Description
http://<IP>:<PORT> Set <IP> and <PORT> to the IP or hostname and port of your web server.
?hostgw=<gateway-addr>&portgw=<gateway-port>

Set <gateway-addr> to the IP address or hostname of the gateway.

Set <gateway-port> to the port of the gateway. This defaults to 8009 if omitted.

&alias=<alias-name>

Set <alias-name> to the alias of your COBOL application, as configured in AcuConnect.

&aliasArgs=<args>

To pass arguments to the COBOL application, use &aliasArgs and set <args> to the arguments required to run the COBOL application specified; for example &aliasArgs=%20abc%20def.

In the example above %20 inserts the spaces required in between the alias name and the specified arguments.

&alias=<alias-name>%20value%20value This is an alternative method to using &aliasArgs. You can append the arguments directly after the alias declaration.
&runtimeArgs=<args>

Set <args> to the runtime arguments required to run your COBOL application. This is optional.

&enable_log={y|n}

Set y or n to enable/disable logging. This is optional, and can be omitted completely to disable logging. You should only enable logging when requested to by Micro Focus.

&showvirkey={y|n}

Set y or n to enable/disable the mobile virtual keyboard when connecting on a mobile device. This is enabled by default, but has no effect if you are not connecting on a mobile device.

&theme=<theme-name>

Set <theme-name> to the name of a theme associated with the current Gateway service.