Contents | < Browse | Browse >
* There are three ways of starting ZShell:
  1. The easiest way:
     Start the file called "ZShell" from Workbench or CLI/Shell.
  2. Put the file called "ZShell" in the C: directory and
     start the file called "ZSH" from Workbench or CLI/Shell.
  3. A bit complicated and only for starting from Workbench:
     Make a startup script (see below) or an empty file with a PROJECT
     icon. Change the default tool to "ZSH" or "ZShell" (better ZSH,
     but put ZShell in C: ) with the right path. Doubleclicking on
     this project icon will start ZShell and execute its script.
     You can also shift-doubleclick a startup script with ZSH/ZShell.

(You can rename "ZSH" as what you like, but do not rename "ZShell").
The first way is recommended for having a quick glance at ZShell,
but if you use ZShell sometimes, the second way is better.
Why ? Because "ZSH" is about 800 Bytes long and starts the ZShell-
resident if possible. So loading "ZShell" is only necessary the first
time you use ZShell after booting up.

* If starting from CLI/Shell you can specify the name of a script file
  (see  EXECUTE ) as an argument which will be executed after starting.
  Precede the name with "-s". If there is no name given, ZShell will try
  to execute S:ZStart . After "-w" you can specify a window-description.
  See  NEWCLI  for more details, it is exactly the same.
  eg.     ZSH -sram:hello     {will try to execute ram:hello}
          ZShell              {will try to execute S:ZStart}
          ZSH -sram:hello "-wCON:10/10/90/90/Hi there" {opens this window}

  All CLI-Options:
  -Sname (Script): Start script named "name"
  -Wdesc (Window): Open window with window-description "desc"
  -Ccmd (Command): Start command named "cmd"
  -D     (Detach): Creates its own process (must be last option)
  -N      (Noraw): Switches off the internal command-line-editing
  -R (not Resident): Testing-stuff (must be first option and lowercase)

* If starting from Workbench you can specify the window-description
  and the startup script (default S:ZStart , see above) with ToolTypes:
  eg.     WINDOW=con:20/50/400/100/Moin
          SCRIPT=ram:hello
          WINDOW=             {this would not open a window}
  Make sure that WINDOW and SCRIPT are in capital letters.
  (You can edit the ToolTypes by selecting an icon and then choosing
  "Information" from the Workbench-Menu.)

  All ToolTypes:
  SCRIPT=name : Start script named "name"
  WINDOW=desc : Open window with window-description "desc"
  COMMAND=cmd : Start command named "cmd"
  NORAW=      : Switches off the internal command-line-editing
  ICONNAME=name : Specify name of the icon for  iconifying  (OS2.0+)
  XPOS=number : Give the position of the icon (OS2.0+)
  YPOS=number : Give the position of the icon (OS2.0+)
  ICONIFY=    : Start in iconifyed mode (OS2.0+)

* NOTE1: If you start ZShell from the Workbench-Menu "Execute Command",
  you can close the window after ending ZShell with CTRL- .
* NOTE2: ZShell and ZSH are PURE (see  RESIDENT , PROTECT ).