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, does not handle B = 0 as local for segment 3, 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