Specifies
The OS_Sp call is a companion to the OS_Nq and is used to set system parameters, notably the Panel and the PrinterEd settings. A call is made by loading register pair BC with a reason code and the other registers with values specific to that reason code. Register changes and output specifications are different for each reason code. The OS_Sp interface call is as follows:
RST 20H, DEFB $69 IN: 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
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) 1 Sound 'Y' or 'N'
PA_Bad ($8005) 1 Default bad process size in K PA_Loc ($8006) 1 Country keyboard letter
CL_US = 'A' United states
CL_FR = 'F' France
CL_DE = 'G' Germany
CL_UK = 'U' England
CL_DK = 'D' Denmark
CL_SE = 'S' Sweden
CL_IT = 'I' Italy
CL_SP = 'P' Spain
CL_JP = 'J' Japan (not implemented)
CL_IS = 'C' Iceland (not implemented)
CL_NO = 'N' Norway
CL_CH = 'W' Chweiss
CL_TR = 'T' Turkey (not implemented)
CL_FI = 'L' Finland
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
The format of each highlight sequence is as follows:
PA_On<n> 31 (max) Highlight ON sequence
PA_On<n>+1 31 (max) Highlight OFF sequence
PA_On<n>+2 1 OFF at CR 'Y' or 'N'
PA_On<n>+3 1 Highlight n special character
The printer editor has a facility for overprinting characters, which is most often used to implement underlining on certain printers, by printing a character followed by a backspace and an underline character. The user enter a ? (query), to represent the character being printed, in the ON sequence (the OFF sequence being blank), and this sequence is output for every character with the current character being substituted for the query. Internally the Printer Editor usually represents the current character as an $FF (it will show up like this in the Printer Editor, if a string is installed, updated, and the Printer Editor is KILL'ed and re-entered). However, because it might be necessary to use an $FF in your overprinting sequence, it is possible to change the internal representation of the current character to some other value. If you want to use an overprinting sequense you must set up PA_SP<n> yourself and use your value in the ON string to represent the current character. To implement backspace underlining you might set the ON sequence and special character like this:
PA_ON1 255,8,95 eg. ?, BS, "_"
PA_SP1 255 special highlight character
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
The format of each translation code sequence is as follows:
Symbol (reason code) Size Meaning
PA_Fr<n> (base+0) 31 (max) Translate from character
PA_To<n> (base+1) 31 (max) Translate to sequence
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
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, nut the others are printed as well.
International versions of the machine have an extra page of 28 translations (using the <>ISO command). The reason codes for these translations start at $8080 up to $80B6. Four extra translations (PA_Tr38 to PA_Tr41) have been added since OZ 4.7 porting ISO translations to 32 ($80B8 to $80BE).
The settings do not come into effect until OS_Sp is called with the reason code PA_GFI and A = 0, which installs both the Panel and Printer Editor values. No error checking is done, so make sure the values are valid.
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
SP_Fnm ($8C06) Set current name match