COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

display-device
can be a file-system file name or (in the Guardian environment) a DEFINE name. Its
value designates a terminal, line printer, process, existing entry-sequenced disk file, or
operator console to which unqualified DISPLAY statements are to deliver output. If you
omit display-device, unqualified DISPLAY statements deliver output to the home
terminal (unless PARAM EXECUTION-LOG specifies a different device).
program-parameter-list
program-parameter
is a parameter of the program that is to be run.
Example 157 RUN Commands
RUN PROG1
RUN RUNUNIT /IN $TERM1/
RUN MYPROG /OUT =CHECKS-PRINTER/
Usage Considerations:
• Effect of Commands on Run-Time Environment
Certain run-time commands establish an environment in which the running process operates.
For example, the ASSIGN command stores logical file assignments, the PARAM command
stores string values and associates them with parameter names, the CLEAR command clears
assignments and parameter values, and a group of commands handle DEFINEs.
When a process begins executing, it obtains the current ASSIGN and PARAM values from
the Guardian environment, and can act on the information they contain. See ASSIGN
Command and PARAM Command. For additional information on TACL run-time commands,
see the TACL Reference Manual or the Guardian User’s Guide.
If no run-time commands are specified, the file-control entries in the program are used to
associate the COBOL file names with file-system file names, and all external switches but one
are set to OFF. The only exception is the NONSTOP parameter, which defaults to ON if the
program was compiled with the NONSTOP directive in the Guardian environment.
• When Commands Take Effect
Commands take effect when encountered and can be overridden by subsequent commands.
Keywords, file names, and numbers cannot be continued from one line to the next.
• COMMENT Run-Time Command
A COMMENT run-time command is available to include documentation in the TACL command
stream.
ASSIGN Command
This section applies to programs that were not compiled with the ENV LIBRARY or UL directive.
Programs compiled with the ENV LIBRARY or UL directive ignore ASSIGN commands.
NOTE: ASSIGN commands for files in a DLL are ignored.
The ASSIGN command creates an ASSIGN message in your current run-time environment. A
process can use the information in an ASSIGN message to override the file-system file name, or
582 Program Execution