Z88 Developers' Notes
Contents   Contents of System Calls

DC_Icl - Invoke new CLI

RST 20H, DEFW $140C
 

IN:

   BHL = null terminated CLI string
     C = length of string
  IX = input stream if BHL=0

OUT:

   Fc = 0,    successful
     Fc = 1, A = RC_ROOM ($07) if no memory or no free handle.

Registers affected after return:

     ..BCDEHL/IXIY same
     AF....../.... different

Notes:

This gives the CLI a string to execute. It is used by BASIC's *CLI command and by the Alarm popdown. Via this call all the CLI facilities can be accessed, though often it will be necessary to use the call to execute a file containing a list of CLI commands.
If IX=':INP' and BHL=0, the call fails without error.

Bugs:

Unreliable if HL points to string in segment 2.

Related calls:

DC_In, Read from CLI
DC_Out, Write to CLI
DC_Prt, Print to CLI
DC_Xin, Examine CLI input
DC_Rbd, Rebind streams
DC_Gen, screen driver SOH call
OS_Cli, CLI interface