Z88 Developers' Notes
Contents   Contents of System Calls

OS_Sp, specify

RST 20H, DEFB $69

IN:

     IX = argument
     BC = reason code
     HL = pointer to data
     A = length (size) of data
OUT, if call succeeded:
     Fc = 0
OUT, if call failed:
     Fc = 1
     A = return code:
          RC_BAD ($04), incorrect reason code or parameter
          RC_UNK ($03), unknown request
Related calls:
OS_Nq, enquire (read system parameters)

The following is the list of reason codes for manipulating the Panel and Printer Editor. Please refer to OS_Nq for other system resources that may be only be read.
 

System Values

Symbol (reason code)Size      Meaning
PA_Gfi ($8000)      0         Install changed settings
PA_Mct ($8001)      1         Timeout in minutes
PA_Rep ($8002)      1         Repeat rate
PA_Kcl ($8003)      1         Keyclick 'Y' or 'N'
PA_Snd ($8004)                Sound 'Y' or 'N'
PA_Bad ($8005)      1         Default bad process size in K


Application values
Symbol (reason code)Size      Meaning
PA_Iov ($8010)      1         Insert/Overtype 'I' or 'O'
PA_Dat ($8011)      1         Date format 'E' or 'A' (European, American)
PA_Map ($8012)      1         PipeDream map 'Y' or 'N'
PA_Msz ($8013)      1         Map size in pixels
PA_Dir ($8014)      12        Default directory
PA_Dev ($8015)      16        Default device


Serial port values
Symbol (reason code)Size      Meaning
PA_Txb ($8016)      2 (or 1)  Transmit baud rate - binary
PA_Rxb ($8017)      2 (or 1)  Receive baud rate - binary
PA_Xon ($8018)      1         Xon/Xoff 'Y' or 'N'
PA_Par ($8019)      1         Parity 'O', 'E', 'M', 'S' or 'N'
Printer Editor values (highlights & translation tables)
Symbol (reason code)Size      Meaning
PA_Ptr ($8020)      9         Printer name
PA_Alf ($8021)      1         Allow Linefeed, 'Y' or 'N'
PA_Pon ($8022)      31 (max)  Printer On sequence
PA_Pof ($8023)      31 (max)  Printer Off sequence
PA_Eop ($8024)      31 (max)  End of page sequence

PA_Mip ($8025)      31 (max)  HMI prefix sequence
PA_Mis ($8026)      31 (max)  HMI suffix sequence
PA_Mio ($8027)      31 (max)  HMI offset sequence


Highlight bases
PA_On1 ($8028)                Underline
PA_On2 ($802C)                Bold
PA_On3 ($8030)                Extended sequence
PA_On4 ($8034)                Italics
PA_On5 ($8038)                Subscript
PA_On6 ($803C)                Superscript
PA_On7 ($8040)                Alternate font
PA_On8 ($8044)                User Defined

Translations
Symbol (reason code)Size      Meaning
PA_Tr1 ($8048)                Row 1, Entry A
PA_Tr2 ($804A)                B
PA_Tr3 ($804C)                C
PA_Tr4 ($804E)                Row 2, Entry A
PA_Tr5 ($8050)                B
PA_Tr6 ($8052)                C
PA_Tr7 ($8054)                Row 3, Entry A
PA_Tr8 ($8056)                B
PA_Tr9 ($8058)                C

ISO translations 1 - 28 (International Z88 versions):
Symbol (reason code)Size      Meaning
PA_Tr10 ($8080)               Row 1, Entry 1 (ISO 1)
PA_Tr11 ($8082)               2 (ISO 2)
PA_Tr12 ($8084)               3 (ISO 3)
PA_Tr13 ($8086)               4
PA_Tr14 ($8088)               5
PA_Tr15 ($808A)               6
PA_Tr16 ($808C)               7
PA_Tr17 ($808E)               Row 2, Entry 1
PA_Tr18 ($8090)               2
PA_Tr19 ($8092)               3
PA_Tr20 ($8094)               4
PA_Tr21 ($8096)               5
PA_Tr22 ($8098)               6
PA_Tr23 ($809A)               7
PA_Tr24 ($809C)               Row 3, Entry 1
PA_Tr25 ($809E)               2
PA_Tr26 ($80A0)               3
PA_Tr27 ($80A2)               4
PA_Tr28 ($80A4)               5
PA_Tr29 ($80A6)               6
PA_Tr30 ($80A8)               7
PA_Tr31 ($80AA)               Row 4, Entry 1
PA_Tr32 ($80AC)               2
PA_Tr33 ($80AE)               3
PA_Tr34 ($80B0)               4
PA_Tr35 ($80B2)               5
PA_Tr36 ($80B4)               6
PA_Tr37 ($80B6)               7 (ISO 28)
PA_Fr<n> will normally be one character long. If there are more characters in this sequence then the first character is replaced by the translation string, but the others are printed as well.

In addition to the Panel and Printer Editor, the following parameters can be set. They expect HL to point to a null-terminated string:

SP_Dev ($8C00)                Set current device
SP_Dir ($8C03)                Set current directory
                              Note: Use always a '/' in front of the path name,
                              otherwise OS_Nq can crash when reading the
                              parameter.
SP_Fnm ($8C06)                Set current name match