ARG_VAL( )

The ARG_VAL( ) function returns a specified argument from the command line that invoked the current 4GL application program. It can also return the name of the current program.

ordinal is an integer expression that evaluates to a non-negative whole number no larger than the number of arguments of the program.

This function provides a mechanism for passing values to the 4GL program through the command line that invokes the program. You can design a 4GL program to expect or to allow arguments after the name of the program in the command line.

Use the ARG_VAL( ) function to retrieve individual arguments during program execution. (You can also use the NUM_ARGS( ) function to determine how many arguments follow the program name on the command line.)

If 1 =< ordinal = n, then ARG_VAL(n) returns the nth command-line argument as a character string. The value of ordinal must be between 0 and the value returned by NUM_ARGS ( ), the number of command-line arguments.

The expression ARG_VAL(0) returns the name of the 4GL application program.

Reference

NUM_ARGS( )