Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.15.2  Sconfig                                                    TOS

 Name:         »Sconfig« - Configuration of parts of the operating 
               system.

 Opcode:       51

 Syntax:       int32_t Sconfig ( int16_t mode, int32_t flags );

 Description:  The function Sconfig permits the configuration of parts 
               of the operating system. The following apply:

                Parameter  Meaning

                mode       Action
                            0 =     Obtain configuration
                            1 =     Set configuration
                            2 =     Get pointer to DOSVARS structure
                            3 =     Reserved; MagiC 3.00
                            4 =     For WBDAEMON; MagiC 4.01
                            5 =     Reserved; MagiC 4.01
                            6 =     Reserved; MagiC 4.01
                flags      Configuration as bit-vector:
                            Bit-0 =   Path-checking on
                            Bit-1 =   Insert mode for GEMDOS and 
                                      dialog boxes
                            Bit-2 =   Reserved
                            Bit-3 =   Reserved
                            Bit-4 =   Fastload for diskette off
                            Bit-5 =   TOS-compatibility on
                            Bit-6 =   Smart redraw off
                            Bit-7 =   Grow-/Shrinkboxes off
                            Bit-8 =   No pause after TOS programs
                            Bit-9 =   Reserved
                            Bit-10 =  Pulldown menus
                            Bit-11 =  Floppy background operation

               Note: Set bits switch the relevant function on, cleared 
               bits switch in off again.(!nl) Bit 11 is only available 
               as of MagiC 3.0. The setting of the configuration is 
               only possible with TOS-compatibility switched off.

               The function is also present in KAOS, though with a 
               somewhat different assignment of the bit-vector. For 
               mode, KAOS 1.2 only knows the first two subfunctions.

                Bit-0 =   Path-checking on
                Bit-1 =   Disk change simulation in desktop on
                Bit-2 =   Break on; CTRL-C interrogation at every DOS 
                          call
                Bit-3 =   CTRL-C interrogation off; for character- 
                          oriented functions
                Bit-4 =   Fastload for diskette off
                Bit-5 =   TOS-compatibility on (as of KAOS 1.4.2)
                Bit-6 =   Smart redraw off (as of KAOS 1.4.2)
                Bit-7 =   Grow-/shrinkboxes off (as of KAOS 1.4.2)
                Bit-8 =   No pause after TOS programs (as of KAOS 
                          1.4.2)
                Bit-9 =   Reserved (as of KAOS 1.4.2)
                Bit-10 =  Pulldown menus (as of KAOS 1.4.2)
                Bit-11..30 = Reserved (as of KAOS 1.4.2)
                Bit-31 =  Has to be 0, else error! (as of KAOS 1.4.2)

 Return value: The function returns, depending on the parameter mode, 
               the currently valid configuration or a pointer to a 
               DOSVARS structure.

 Availability: As of KAOS Version 1.2, and MagiC Version 1.0.

 Group:        System functions

 See also:     Binding   Sysconf