DC_Icl, Invoke new CLI

Register parameters

RST 20H, DEFW $140C
IN:
   BHL = null terminated CLI string, B = 0 local
     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.
		   A = RC_FAIL ($16) if stream input is :INP

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.

Bugs

  • Does not work when HL string is in segment 2 (fixed since OZ 5.0)
  • Does not handle B = 0 as local address for segment 2 and 3 (fixed since OZ 5.0)
  • Returns no error when IX stream is :INP (fixed since OZ 5.0)

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