30. System calls reference

The following section is a complete reference of all the Z88 operating system calls. Each call is a separate document. This makes it easy to load the files directly into PipeDream for evaluation during software development. This brief list of topics is intended to make it easier to find a system call to perform the required function. The calls are listed in alphabetical order in the main body of "System calls Reference".

Many of the available calls were designed for use by the system and are of no help to the application author. Such calls are marked "(OZ usage)" or "(internal usage)". Some of the more esoteric calls will not work in all segments, where segment 3 is considered to be the most reliable. If you have some very bizarre bugs you may want to suspect a system call is not working to specifications. Where bugs are known about, or strongly suspected, this information is included with the system call specification. Feel free to contact us if you have discovered new information about OZ.

DC (director) calls are very low level, hence only three of the sixteen available are of use to applications. The GN (general) calls are safe in that they are unlikely to corrupt the system, but a little unreliable. OS (operating system) calls are more reliable, but because of their power, they'r easily able to disrupt the system - many are not for application use at all.

Alarms

OS_Alm, alarm manipulation (OZ usage) 
GN_Aab, allocate alarm block 
GN_Alp, process an expired alarm 
GN_Fab, free alarm block 
GN_Lab, link an alarm block into the alarm chain 
GN_Uab, unlink an alarm block from the alarm chain 
OS_Alm, alarm manipulation (OZ usage)

DC_Nam, Name current application
OS_Poll, poll for an application (OZ usage)
DC_Pol, poll for card usage
OS_Ent, enter an application (OZ usage)
DC_Ent, enter new application (low level OZ usage)
OS_Exit, exit an application (OZ usage)
DC_Bye, exiting current application (OZ usage)
OS_Bye, exit application
OS_Stk, stack current process / application (OZ usage)
OS_Use, process card usage (OZ usage)

GN_D16, 16bit unsigned division 
GN_D24, 24bit unsigned division 
GN_Gdn, convert an ASCII string to a binary number 
GN_M16, 16bit unsigned multiplication 
GN_M24, 24bit unsigned multiplication 
GN_Pdn, write number as decimal ASCII string 
FP_     Floating point arithmetic

OS_Mgb, get old bank binding 
OS_Mpb, set (put) new bank binding 
OS_Fc, fast code (bank binding)

GN_Cls, classify a character 
GN_Skc, skip character 
GN_Skd, skip to delimiter 
GN_Skt, skip to value

DC_Icl, invoke new CLI 
DC_In, read from CLI 
DC_Xin, examine CLI input 
DC_Rbd, rebind streams in CLI layer 
OS_Cli, CLI interface (OZ usage)

GN_Cl, close file 
OS_Cl, internal close (OZ usage) 
GN_Flc, close filter 
OS_Mcl, close (free) memory pool 
GN_Wcl, close wildcard handler

GN_Gdt, convert ASCII to internal date 
GN_Dei, convert zoned format date to internal format 
GN_Die, convert internal format date to zoned format 
GN_Gmd, get (read) machine date in internal format 
GN_Pdt, write internal date as ASCII string 
GN_Pmd, put (set) machine date

OS_Dly, fixed time delay

OS_Dor, DOR interface

GN_Err, display system error box 
GN_Esp, return an extended pointer to a system error message 
OS_Erc, get error context 
OS_Erh, set error handler 
OS_Esc, examine special condition

OS_Bhl, copy bytes from extended address 
GN_Cme, compare null-terminated strings, one local, one extended 
GN_Rbe, read byte at extended address 
GN_Wbe, write byte at extended address 
OS_Bde, copy bytes to extended address

GN_Opf, file or stream open 
GN_Cl, close file 
GN_Del, delete a file from memory 
GN_Ren, rename file 
OS_Cl, internal close (OZ usage) 
OS_Del, file delete (OZ usage) 
OS_Frm, file read miscellaneous 
OS_Fwm, file write miscellaneous 
OS_Gb, get byte from file (or device) 
OS_Gbt, get byte from file (or device) with timeout 
OS_Mv, move bytes between stream and memory 
OS_Op, internal open (OZ usage) 
OS_Pb, write byte to file, device 
OS_Pbt, write byte to file, device with timeout 
OS_Ren, file rename (OZ usage)

GN_Esa, read & write to filename segments 
GN_Fcm, produce compressed filename 
GN_Fex, expand a filename 
GN_Opw, open wildcard handler 
GN_Pfs, parse filename segment 
GN_Prs, parse filename 
GN_Wcl, close wildcard handle 
GN_Wfn, fetch next match for wildcard string (handle) 
GN_Wsm, match filename segment to wildcard string

GN_Flo, open a filter 
GN_Flc, close filter 
GN_Flf, flush filter 
GN_Flr, read from filter 
GN_Flw, write character to filter 
GN_Fpb, push back into filter

GN_Sip, system input line routine 
OS_In, wait for character from standard input 
OS_Pur, purge keyboard buffer 
OS_Tin, read character from standard input, with timeout 
OS_Xin, examine input

GN_Xnx, index next entry in a linked list 
GN_Xdl, delete an entry from a linked list 
GN_Xin, insert an entry into a linked list

OS_Sr, save & restore

OS_Off, Switch machine off 
OS_Blp, Bleep generation 
OS_Sr, Page Wait 
OS_Epr, File Eprom manipulation

OS_Bix, bind in extended address 
OS_Box, restore bindings after OS_Bix 
OS_Fc, select fast code (fast bank switching) 
OS_Mal, allocate memory 
OS_Mcl, close memory (free memory pool) 
OS_Mfr, free (previously allocated block) memory 
OS_Mgb, get current bank binding in segment 
OS_Mop, open memory (allocate memory pool) 
OS_Mpb, set new bank binding in segment

GN_Gdn, convert an ASCII string to a binary number 
GN_Pdn, write number as decimal ASCII string

GN_Opf, open file, device 
GN_Flo, open filter 
GN_Opw, open wildcard handler 
OS_Mop, open memory (pool)

GN_Nln, send newline (CR/LF) to standard output 
GN_Soe, write string at extended address to standard output 
GN_Sop, write string to standard output, local memory 
OS_Out, write character to standard output 
OS_Prt, output character to printer

OS_Map, high resolution graphics manipulation 
OS_Sr, save & restore screen file 
OS_Sci, low level screen hardware interface 
OS_Nq, fetch low level window information

OS_Sp, set Panel and PrinterEd values 
OS_Nq, read Panel and PrinterEd values

GN_Gmt, fetch machine time 
GN_Gtm, convert an ASCII string to a time in internal format 
GN_Msc, miscellaneous time operations 
GN_Pmt, put (set) machine time 
GN_Ptm, write internal time as ASCII string 
GN_Sdo, send date and time to standard output 
OS_Dly, delay a given period

GN_Opw, open wildcard handler 
GN_Wcl, close wildcard handle 
GN_Wfn, fetch next match for wildcard string (handle) 
GN_Wsm, match filename segment to wildcard string

Handles

OS_Gth, get tri-handle (OZ usage)
OS_Vth, verify tri-handle (OZ usage)
OS_Fth, free tri-handle (OZ usage)