Restriction: This command is supported for native COBOL only.
To run dynamically loadable programs (that is, callable shared objects or .gnt files or .int files) use the command cobrun (or cobrun_t for multi-threaded programs) as follows:
cobrun [switch-param] program-name [program-param]
where:
-
switch-param
- One or more programmable and run-time switches that control events in a program at run time. Your application supplier will tell you which switches to specify.
-
program-name
- The name of a dynamically loadable program.
If you do not specify an explicit filename extension in the
cobrun command, and multiple versions exist, then by default:
- The callable shared object version is run in preference to the .gnt file
- The .gnt file is run in preference to the .int file.
If program-name does not contain an explicit path the directories specified by $COBPATH, and in the case of a callable shared object, the directories specified by $LD_LIBRARY_PATH, or $LIBPATH are searched.
-
program-parameters
- One or more parameters that are required by the program. Each parameter is a string, separated from adjoining parameters by one or more spaces.
If any of the parameters contain an equal sign, the equal sign is mapped to parentheses as these have a special meaning to UNIX, whereas the equal sign does not. These parameters can be read by the program in a number of ways.
Comments:
UNIX only: use
cobrun in conjunction with the effective working mode to run in a 32-bit or 64-bit environment; alternatively, use
cobrun32 or
cobrun64 to directly invoke those environments.