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