Z88 Developers' Notes
Contents   Contents of System Calls

OS_Stk, stack file current process

RST 20H, DEFW $F806
 

IN:  -
OUT, if call successful:
     Fc = 0
     BHL = pointer to stacked process
OUT, if call failed:
     Fc = 1
          A = RC_ROOM, no room to stack process information
Registers changed after return:
     ...CDE../IXIY same
     AFB...HL/.... different
Notes:
     Internal operating system usage.
     A stacked process environment consists of:
          stack pointer       SP
          stack frame         at [SP;ST.END]
          registers           part of stack
          static workspace    part of stack
          handles             part of stack
          segment registers   described by USRSG0/1/2
          windows
          map(s)
          return PC           RESUME (in OS_In)

     InterLogic comment: We believe that ST.END is the top address before
     the safe workspace of the application. However, we have not verified
     this.

Bugs:
     -

Related system calls:
OS_Poll, poll for an application
DC_Pol, poll for card usage
OS_Ent, enter an application
DC_Ent, enter new application
DC_Nam, name current application
OS_Exit, exit an application
OS_Bye, exit application
DC_Bye, exiting current application
OS_Use, process card usage