The TPU$EXECUTE_INIFILE routine allows you to execute a user- written initialization file. This routine must be executed after the editor is initialized and before any other commands are processed. Format TPU$EXECUTE_INIFILE
1 – Returns
OpenVMS usage:cond_value type: longword (unsigned) access: write only mechanism: by value Longword condition value. Most utility routines return a condition value in R0. Condition values that this routine can return are listed under Condition Values Returned.
2 – Arguments
None.
3 – Description
Calling the TPU$EXECUTE_INIFILE routine causes DECTPU to perform the following steps: 1. The command file is read into a buffer. The default is TPU$COMMAND.TPU. If you specified a file on the command line that cannot be found, an error message is displayed and the routine is aborted. 2. If you specified the /DEBUG qualifier on the command line, the DEBUG file is read into a buffer. The default is SYS$SHARE:TPU$DEBUG.TPU. 3. The DEBUG file is compiled and executed (if available). 4. TPU$INIT_PROCEDURE is executed (if available). 5. The Command buffer is compiled and executed (if available). 6. TPU$INIT_POSTPROCEDURE is executed (if available). NOTE If you call this routine after calling TPU$CLEANUP, you must set the flags TPU$_EXECUTEPROCEDURE and TPU$_EXECUTEFILE. Otherwise, the initialization file does not execute.
4 – Condition Values Returned
TPU$_SUCCESS Normal successful completion. TPU$_COMPILEFAIL The compilation of the initialization file was unsuccessful. TPU$_EXECUTEFAIL The execution of the statements in the initialization file was unsuccessful. TPU$_EXITING A result of EXIT. If the default condition handler is being used, the session is terminated. TPU$_FAILURE General code for all other errors. TPU$_QUITTING A result of QUIT. If the default condition handler is being used, the session is terminated.