Affects the COBOL command line arguments returned from the syntax ACCEPT ... FROM ARGUMENT-NUMBER and ACCEPT ... FROM ARGUMENT-VALUE.
>>-----set arguments_are_initial=---.-TRUE-.------------->< +-FALSE+
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 cobrun,
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. |
Default: | FALSE |
IDE equivalent: | Project > Properties > Comand Line Handling > Return trigger executable name as argument zero |
See the COBOL Language Reference for more details of the ACCEPT ... FROM ARGUMENT-NUMBER and ACCEPT ... FROM ARGUMENT-VALUE syntax. For details on packaging applications, see the chapter Packaging Applications in your User's Guide.
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:
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 (cobrun) is returned as argument 0 and myapp as argument 1.