VMS Help DECTPU, TPU$EXECUTE_INIFILE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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.