contents.gifindex.gifprev1.gifnext1.gif

C$RUN Routine

ACUCOBOL-GT for Windows supports an alternate method for running other programs. This is through the library routine C$RUN. This library routine works identically to the SYSTEM library routine, except that the calling program does not wait for the called program to finish. Instead, both programs run in parallel.

Usage

CALL "C$RUN"
   USING COMMAND-LINE,
   GIVING STATUS-VAL

Parameters

COMMAND-LINE PIC X(n)

Contains the operating system command line to execute.

STATUS-VAL Any numeric data item

Returns "0" if successful or "-1" if not.

Description

C$RUN sets STATUS-VAL to "-1" if the call fails or to "0" if it succeeds. Note that C$RUN is implemented only under the Windows 3.1, Windows 95, and Windows NT versions of ACUCOBOL-GT. On other systems, it always returns "-1".