Affects the COBOL command line arguments returned from the syntax ACCEPT ... FROM ARGUMENT-NUMBER and ACCEPT ... FROM ARGUMENT-VALUE.
Restriction: These tunables are supported for native COBOL only.
Syntax:
>>-----set arguments_are_initial=-.-TRUE-.-----------><
+-FALSE+
Parameters:
TRUE
|
The COBOL command line arguments are the same as the initial ones passed to the run-unit by the operating system. When using a trigger, such as
run
(Windows) or
cobrun
(UNIX), argument 0 is the trigger name and argument 1 is the name of the main COBOL program.
Set this tunable to TRUE for compatibility with Micro Focus Object COBOL Developer Suite V4.1 for UNIX and earlier.
|
FALSE
|
The COBOL command line arguments do not contain any trigger name. Instead, argument 0 is always the name of the main COBOL program.
When set to FALSE this tunable gives consistent results no matter how your application is packaged.
|
Properties:
Default:
|
FALSE
|
IDE equivalent:
|
Project > Properties >
Program Execution
Command Line Handling
> Return trigger executable name as argument zero
Service Interfaces > Properties
> Enterprise Server Run-time Configuration > Program Execution > Return trigger executable name as argument zero
|
Comments:
See the
Language Reference for more details of the ACCEPT ... FROM ARGUMENT-NUMBER and ACCEPT ... FROM ARGUMENT-VALUE syntax.
For details on building
UNIX
applications, see
Building COBOL applications if using the IDE, or
Compiling and Linking from the Command Line if using the command line/shell prompt.
If you are using a system executable to start your application, argument 0 is always the name of the executable (which, by default, is also the name of the main COBOL program), irrespective of the setting of this tunable.
For example, the command line:
myapp arg1 arg2
always returns myapp as argument 0, whereas the command line:
Windows:
run myapp arg1 arg2
UNIX:
cobrun myapp arg1 arg2
returns myapp as argument 0 when this tunable is set to FALSE; when the tunable is set to TRUE the trigger name (
run
(Windows) or
cobrun
(UNIX)) is returned as argument 0 and myapp as argument 1.