Command-line arguments

ARGUMENT-VALUE

GnuCOBOL exposes command-line arguments through ACCEPT. ARGUMENT-NUMBER returns how many arguments there are, and ARGUMENT-VALUE returns the argument at the position in WS-N:

ACCEPT WS-COUNT FROM ARGUMENT-NUMBER. MOVE 1 TO WS-N. ACCEPT WS-ARG FROM ARGUMENT-VALUE.

ARGUMENT-NUMBER

Loop over the arguments from 1 to the count, moving the position into WS-N before each ACCEPT. GnuCOBOL also stores the raw command line in the special register COMMAND-LINE for custom parsing:

01 WS-COUNT PIC 9(4). 01 WS-N PIC 9(4). 01 WS-N-OUT PIC Z(3)9. 01 WS-ARG PIC X(20).

ACCEPT WS-COUNT FROM ARGUMENT-NUMBER. PERFORM VARYING WS-N FROM 1 BY 1 UNTIL WS-N > WS-COUNT ACCEPT WS-ARG FROM ARGUMENT-VALUE MOVE WS-N TO WS-N-OUT DISPLAY "Arg " FUNCTION TRIM(WS-N-OUT) ": " FUNCTION TRIM(WS-ARG) END-PERFORM.

./args one two

Arg 1: one Arg 2: two

Environment variables

ACCEPT FROM ENVIRONMENT reads a variable from the process environment, which is the cleanest way to pass configuration to a batch program without editing its source:

ACCEPT WS-PATH FROM ENVIRONMENT "PAYROLL-DIR".

The code on this page was run with GnuCOBOL 3.2.0 on Alpine Linux 3.24.3 (x86_64) in a Docker container.

Article author: Arthur Isaev