/
Process Management and OZ information

Process Management and OZ information

Dec 11, 2017

The following codes use/return system handles:

NQ_Ain

NQ_Ain ($8600), Application enquiry (system use only)
IN: BC = NQ_Ain IX = application handle from OS_Poll OUT, if call successful: Fc = 0 BHL = pointer to application name (null-terminated) BDE = pointer to application DOR A = CLI-related attributes C = preferred code letter. OUT, if call failed: Fc = 1 A = RC_HAND Registers changed after return: ......../IXIY same AFBCDEHL/.... different

Notes

CLI-related attributes refer to Application Type Byte 1 in application DOR.

 

NQ_Khn

NQ_Khn ($8603), Read keyboard handle
IN: BC = NQ_Khn OUT: IX = keyboard handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":INP" device instead.

 

NQ_Shn

NQ_Shn ($8606), Read screen handle
IN: BC = NQ_Shn OUT: IX = screen handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":SCR" device instead.

 

NQ_Phn

NQ_Phn ($8609), Read printer indirected handle
IN: BC = NQ_Phn OUT: IX = printer indirected handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

 

NQ_Nhn

NQ_Nhn ($860C), Read null handle
IN: BC = NQ_Hhn OUT: IX = null handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":NUL" device instead

 

NQ_Wai

NQ_Wai ($860F), Who am I? (system use only)
IN: BC = NQ_Wai OUT: IX = static process handle C = dynamic process handle (PID) B = 0 Registers changed after return: A...DEHL/..IY same .FBC..../IX.. different

Notes

  • Static process handle is unique to each application. It follows slot number and application order in slot (1-31 for internal slot, 32-63 for slot 1, 64-95 for slot 2, 96-127 for slot 3, 128-255 for installed applications). Index handle is always 1, Pipedream handle is 3...

  • Dynamic process handle (PID equivalent) is unique to each suspended or running process (range 2-127, Index PID is always number 1).

NQ_Com

NQ_Com ($8612), Read comms handle
IN: BC = NQ_Com OUT: IX = comms handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":COM" device instead.

 

NQ_Ihn

NQ_Ihn ($8615), Read IN handle
IN: BC = NQ_Ihn OUT: IX = IN handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":INP" device instead.

 

NQ_Ohn

NQ_Ohn ($8618), Read OUT handle
IN: BC = NQ_Ohn OUT: IX = OUT handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

Notes

Use ":OUT" device instead.

 

NQ_Rhn

NQ_Rhn ($861B), Read direct printer handle
IN: BC = NQ_Rhn OUT: IX = printer direct handle Registers changed after return: A.BCDEHL/..IY same .F....../IX.. different

 

NQ_Voz

NQ_Voz ($861E), Application verifies running OZ version (OZ V4.5 and newer)
IN: A = OZ version required (for example $45 for OZ V4.5) BC = NQ_Voz OUT, if call successful: Fc = 0 Running OZ is equal to or higher than specified version OUT, if call reported incompatible OZ ROM: Fc = 1 A = RC_VOZ ($38), OZ version not compatible Registers changed after return: A.BCDEHL/IXIY same .F....../.... different

Notes:

If OS_Nq, NQ_Voz is used on OZ ROM's earlier than V4.5, a standard "Internal Error" popup window is displayed to prompt the user to press ESC (the NQ_Voz doesnt exist).

For OZ V5.0 and later, the "OZ version not compatible" message is displayed as a fatal error using a OS_BYE with A unchanged if Fc = 1.

NQ_Roz

NQ_Roz ($8621), Read OZ revision number (OZ V4.5 and newer)
IN: - OUT: DEBC = OZ revision number Registers changed after return: AF....HL/IXIY same ..BCDE../.... different

Notes:

Used by system information page in Index.

 

NQ_Btl

NQ_Btl ($8624), Read battery status (OZ V4.5 and newer)
IN: - OUT: Fz = 0, Battery is good Fz = 1, Battery is low Registers changed after return: A.BCDEHL/IXIY same .F....../.... different

Notes:

Battery low condition is set when under 4.2V. Coma state is entered by NMI when battery voltage falls under 3.2V.

This call is used by system information page in Index.

web analytics