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

    The TPU$TPU routine invokes DECTPU and is equivalent to the DCL
    command EDIT/TPU.

    Format

      TPU$TPU  command

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 - Argument

 command

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor
    Command string. Note that the verb is TPU instead of EDIT/TPU.
    The command argument is the address for a descriptor of a command
    line.

3 - Description

    This routine takes the command string specified and passes it to
    the editor. DECTPU uses the information from this command string
    for initialization purposes, just as though you had entered the
    command at the DCL level.

    Using the simplified callable interface does not set TPU$CLOSE_
    SECTION. This feature lets you make multiple calls to TPU$TPU
    without requiring you to open and close the section file on each
    call.

    If your application parses information that is not related to the
    operation of DECTPU, make sure the application obtains and uses
    all non-DECTPU parse information before the application calls
    TPU$TPU. This is because TPU$TPU destroys all parse information
    obtained and stored before TPU$TPU was called.

4 - Condition Values Returned

    This routine returns any condition value returned by
    TPU$INITIALIZE, TPU$EXECUTE_INIFILE, TPU$CONTROL, and
    TPU$CLEANUP.