2.2 PROC INPUTS AND OUTPUTS

2.2.1 General

The inputs for both procedures and processes consist of the following:

• The values of the parameters defined by the PARM commands in the PDF.

• The values of parameter qualifiers.

• The values of global variables that have been referenced in the PDF. This includes variables that are explicitly referenced by the REFGBL command and the following implicitly referenced globals:

  $RUNTYPE flag indicating batch, asynchronous or synchronous

  $SESSION - the session identification

  $SWITCH - the programmer-settable debug switch

  $SFI - the success/fail indicator

  $SKEY - the status key.

  See Section 3.3.2 for a discussion of global variables and these implicitly referenced variables.

• Local variables declared in the PDF and the following implicit local variables:

  _PROC - The name of the proc.

  _SUBCMD - The active subcommand.

  _STDOUT - Standard output file name.

  _ONFAIL - Command to be executed upon error.

  See Section 3.3.2.7.2 for a discussion of implicit locals.

The outputs of a proc are:

• Updated values of referenced globals.

  A process may update a referenced global variable using the XQ package (Section 3.1 of the "TAE Command Language (TCL) Runtime Services, Volume 2: FORTRAN") the q_ package (Section 3.9 in the "TAE Command Language (TCL) Runtime Services, Volume 1: C") the Vm_ package (in "TAE Plus Programmer's Manual" and "TAE Plus C Reference Manual"), the Tae_vm package (Appendix C of the "TAE Plus Ada Reference Manual"), or the TaeVar class in the "TAE Plus C++ Programmer's Manual".

  A procedure may update a global using the LET command.

• Values for the status key global, $SKEY, and the success/fail indicator global, $SFI.

  A process sets these variables upon process exit (through subroutine XZEXIT) and a procedure sets these variables using the LET or RETURN commands.

• Updated values for those variables that have been associated with parameters of type NAME (described in Section 2.3.2).

  A process sets these parameters through the XQ, q_ Vm_, tae_vm or TaeVar packages. A procedure sets these variables using the LET command.

2.2.2 Standard Output

The "standard output" is the file or device that receives outputs that are, in interactive mode, usually written to the terminal. The standard output is used for:

• the output of the DISPLAY, SHOW, and WRITE commands;

• one of the destinations for messages written by TAE (messages are also written to the terminal if $RUNTYPE is "SYNCHRONOUS");

• one of the destinations for the PUTMSG command and for the XMPUT, or m_msg subroutine.

The standard output device varies as follows:

1. The interactive session, after the logan sequence, always starts with the standard output assigned to the user's terminal.

2. The initial standard output for a proc invoked for batch execution is a "LOG" type file with the same name as the proc.

   The listing of the VMS DCL commands which activate TAE and the output of DCL commands executed under TAE are lost by default for a batched proc. If the TCL command "SWITCH 2" is executed prior to the submission of a proc to batch, two files, proc.TML, and proc.SPL, are produced in addition to the standard log file. See Appendix A.2.7.3 for details.

3. The initial standard output for a proc invoked for asynchronous execution is a "LOG" type file with the same name as the job.

4. The command qualifier STDOUT may be used to change the standard output upon proc invocation. This assignment is retained for the duration of the proc's execution; if the proc invokes another proc with another standard output assignment, then the assignments are nested.