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 , argument 0 is the trigger name and argument 1 is the name of the main COBOL program.
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:

Service > Settings > Enterprise Server Run-time Configuration > Program Execution > Return trigger executable name as argument zero

Use the Application.config file of the project - right-click the file in Solution Explorer and click Open, then select the Run-time Configuration tab.

Comments:

See the Language Reference for more details of the ACCEPT ... FROM ARGUMENT-NUMBER and ACCEPT ... FROM ARGUMENT-VALUE syntax.

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:

run 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 ) is returned as argument 0 and myapp as argument 1.

Previous Topic Next topic Print topic