Previous Topic Next topic Print topic


arguments_are_initial

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.

Previous Topic Next topic Print topic