Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileSHEL_WRITE(mode,gr,cr,tail$,cmd$)

mode, gr, cr: iexp
tail$, cmd$: sexp

This function informs the AES that another application is to be started after
the current one has terminated. In contrast to Pexec() (GEMDOS 75), however,
the current program does not remain resident in memory.

Returns 0 if an error occurred.

    mode  - 0: Back to the Desktop.
            1: Load new program.
    gr    - 0: TOS program.
            1: Graphics application.
    cr    - 0: Not GEM application.
            1: GEM application.
    tail$ - Command line string.
    cmd$  - Name of next application.

Example:

    ~SHEL_WRITE(1,1,1,"","GFABASIC.PRG")

--> After running this, quitting BASIC and returning to the Desktop will
    result in BASIC being restarted.

Memo: The built in command SHEL_WRITE() has parameters tail$ and cmd$
      swapped when compared to other AES manuals. However it does work. The
      information about the command itself is not very accurate. One should
      consult additional documentation for the proper use of this call.

shel_write()+