Working with Aliases

Programs can be run in the Application Server through aliases. An alias is a logical name used client side to identify a specific program run with a specific configuration file.

In order to activate such feature, the following property must be set in the server side configuration:

iscobol.as.use_aliases=true

Aliases are defined in the server side configuration with properties in the format:

iscobol.as.alias.<alias_name>=<PROGRAM_NAME>,<configuration_file>

For example, the following server configuration file defines two aliases

•	the first alias runs the program MAIN with the default configuration

•	the second alias runs the program TEST with the configuration file /usr/test/config1.properties

iscobol.as.use_aliases=true iscobol.as.alias.menu=MAIN iscobol.as.alias.test_alias=TEST,/usr/test/config1.properties

On the client side the isCOBOL Client specifies the alias name instead of the program name in its command-line. For example, if a client wants to run the TEST program with the /usr/test/config1.properties configuration file, it will just run:

iscclient -hostname my-server TEST_ALIAS

The effect will be the same as running the equivalent more complex command:

iscclient -hostname my-server -c /usr/test/config1.properties TEST

Note - The alias name on the client command-line is case insensitive, it means that the following commands are all valid and produce the same effect:

•	iscclient -hostname my-server TEST_ALIAS

•	iscclient -hostname my-server test_alias

•	iscclient -hostname my-server Test_Alias

Aliases for isCOBOL Client options

When iscobol.as.use_aliases=true, the following aliases must be defined in order to make all the isCOBOL Client options work correctly:

iscobol.as.alias.asa$gadmin=ASA$GADMIN iscobol.as.alias.asa$gpanel=ASA$GPANEL