System Tracing: Difference between revisions

From Color 64 BBS Wiki
Newer edit →
Created page with "<strong>BBS.INIT </strong> The following are breakdown of routines found in BBS.INIT - this is under construction. {| class="wikitable |- |+Lines ! Function ! Additional Notes |- | 20 | ML Initiation | |- | 910-939 | Read user information from Password File | |- | 940 | Pull data from REL file | Used in Password Operations |- | 1170-1180 | New day | |- | 10005 - 10340 | System Initialization / BBS Parameters load | |- | 11310-11590 | Message Index Operations |..."
 
No edit summary
Line 3: Line 3:
The following are breakdown of routines found in BBS.INIT - this is under construction.   
The following are breakdown of routines found in BBS.INIT - this is under construction.   


{| class="wikitable
= bbs.init Overlay =
 
== Overview ==
 
The '''bbs.init''' overlay is the main startup and idle-state overlay for Color 64 BBS. It is the first overlay run when the BBS starts and remains active while the system is waiting for a caller.
 
This overlay is responsible for several core system functions, including:
 
* Loading system parameters
* Starting the BBS
* Managing the idle and waiting-for-call state
* Reading and updating user records
* Daily system maintenance
* Caller log file maintenance
* Scheduled network checks
* Program error handling
* Crash recovery
* Saving system data during shutdown
 
== Routine Summary ==
 
{| class="wikitable sortable"
! Lines
! Function
! Description
 
|-
! colspan="3" | Overlay Control
 
|-
| 5-85
| Overlay Return Control
| Uses the value of OV to determine which routine should run when control returns to bbs.init.
 
|-
| 89-104
| Overlay Selection
| Builds the filename needed when another overlay must be loaded.
 
|-
! colspan="3" | Input and Output
 
|-
| 105-160
| Character Input and Output
| Performs character input, output, carrier detection, and carriage return handling.
 
|-
| 202-280
| Display Text File
| Opens and displays a text file while checking for disk errors.
 
|-
| 300-380
| Read User Input
| Reads a line of text from the caller or local keyboard.
 
|-
| 390-400
| Trim Input
| Removes leading and trailing spaces from entered text.
 
|-
! colspan="3" | Drive and Disk Control
 
|-
|-
|+Lines
| 460-489
! Function
| Select Drive
! Additional Notes
| Selects the configured device, drive, partition, or directory and processes any associated drive commands.
 
|-
| 505-580
| Disk Status
| Reads the disk drive status and reports disk errors.
 
|-
| 710-795
| Get File Size
| Returns the size of a file in Commodore disk blocks.
 
|-
! colspan="3" | User File Control
 
|-
| 910-946
| Load User Record
| Loads a user record from the user file.
 
|-
| 2710-2790
| Update User Record
| Loads, updates, and saves another user's record during Sysop maintenance.
 
|-
| 9450
| Scratch Private User File
| Deletes a private file associated with a user account.
 
|-
! colspan="3" | Caller Log File Control
 
|-
| 8003-8010
| Buffer Caller Log
| Adds text to the caller log buffer.
 
|-
| 8020-8031
| Write Caller Log
| Writes buffered caller log data to disk.
 
|-
| 8032-8033
| Process Drive Commands
| Processes drive commands associated with the caller log drive.
 
|-
| 8034-8035
| Find Command Channel
| Locates or assigns a disk command channel for caller log operations.
 
|-
| 8036-8040
| Caller Log Error
| Reports and records caller log disk errors.
 
|-
|-
| 20
| 8100-8170
| ML Initiation
| Caller Log Utilities
|  
| Displays, manages, or scratches the caller log.
 
|-
|-
| 910-939
! colspan="3" | Time and System Maintenance
| Read user information from Password File
 
|
|-
|-
| 940
| 1110-1180
| Pull data from REL file
| Read Clock and Date
| Used in Password Operations
| Reads the current time and date and detects when a new day begins.
 
|-
|-
| 1170-1180
| 1521-1525
| New day
| Remove Empty Message Base
|  
| Removes an unused message base entry.
 
|-
|-
| 10005 - 10340
| 9810-9826
| System Initialization / BBS Parameters load
| Save Message Index
|  
| Saves the message index and related system variables.
 
|-
|-
| 11310-11590
| 9991-9992
| Message Index Operations
| Log Program Error
|  
| Records BASIC program errors and BREAK conditions.
 
|-
|-
| 12010-12090
| 9999
| BBS Initialized - Launching WFC
| System Shutdown
|
| Saves system information, closes files, restores the environment, and shuts down the BBS.
 
|-
|-
| 12112-12488
! colspan="3" | Printer Support
| Poll Modem and answer call if one is received
 
|
|-
|-
| 12510-12790
| 12900-12920
| Sysop BBS Maintenance Area
| Select Printer Output
|  
| Attempts to redirect local output to the printer.
 
|-
|-
| 12800-12865
| 12930
| Network Maintenance Area
| Restore Screen Output
|  
| Returns local output to the screen.
 
|-
|-
| 12950-12995
! colspan="3" | File Area Support
| Poll Modem
 
| Called by line 12112
|-
|-
| 18500
| 16010-16012
| Initiate Password File Operations
| Select File Directory
|  
| Selects the configured upload or download directory.
 
|-
|-
| 24005 - 24400
! colspan="3" | Caller Log Maintenance
| Date/Time modification
 
|
|-
|-
| 26210-27510
| 28570-28590
| Reset Time Limits
| Check Caller Log Size
| Called by line 12091
| Checks the caller log size and performs maintenance when needed.
 
|-
|-
| 28500-28770
| 28655
| Log Functions
| Load ASCII Support
|  
| Loads the ASCII support module when required during caller log processing.
|}
|}
[[Category:Color 64 BBS]]
[[Category:Color 64 v8.1a]]
[[Category:BBS Overlays]]

Revision as of 16:32, 22 July 2026

BBS.INIT

The following are breakdown of routines found in BBS.INIT - this is under construction.

bbs.init Overlay

Overview

The bbs.init overlay is the main startup and idle-state overlay for Color 64 BBS. It is the first overlay run when the BBS starts and remains active while the system is waiting for a caller.

This overlay is responsible for several core system functions, including:

  • Loading system parameters
  • Starting the BBS
  • Managing the idle and waiting-for-call state
  • Reading and updating user records
  • Daily system maintenance
  • Caller log file maintenance
  • Scheduled network checks
  • Program error handling
  • Crash recovery
  • Saving system data during shutdown

Routine Summary

Lines Function Description
Overlay Control
5-85 Overlay Return Control Uses the value of OV to determine which routine should run when control returns to bbs.init.
89-104 Overlay Selection Builds the filename needed when another overlay must be loaded.
Input and Output
105-160 Character Input and Output Performs character input, output, carrier detection, and carriage return handling.
202-280 Display Text File Opens and displays a text file while checking for disk errors.
300-380 Read User Input Reads a line of text from the caller or local keyboard.
390-400 Trim Input Removes leading and trailing spaces from entered text.
Drive and Disk Control
460-489 Select Drive Selects the configured device, drive, partition, or directory and processes any associated drive commands.
505-580 Disk Status Reads the disk drive status and reports disk errors.
710-795 Get File Size Returns the size of a file in Commodore disk blocks.
User File Control
910-946 Load User Record Loads a user record from the user file.
2710-2790 Update User Record Loads, updates, and saves another user's record during Sysop maintenance.
9450 Scratch Private User File Deletes a private file associated with a user account.
Caller Log File Control
8003-8010 Buffer Caller Log Adds text to the caller log buffer.
8020-8031 Write Caller Log Writes buffered caller log data to disk.
8032-8033 Process Drive Commands Processes drive commands associated with the caller log drive.
8034-8035 Find Command Channel Locates or assigns a disk command channel for caller log operations.
8036-8040 Caller Log Error Reports and records caller log disk errors.
8100-8170 Caller Log Utilities Displays, manages, or scratches the caller log.
Time and System Maintenance
1110-1180 Read Clock and Date Reads the current time and date and detects when a new day begins.
1521-1525 Remove Empty Message Base Removes an unused message base entry.
9810-9826 Save Message Index Saves the message index and related system variables.
9991-9992 Log Program Error Records BASIC program errors and BREAK conditions.
9999 System Shutdown Saves system information, closes files, restores the environment, and shuts down the BBS.
Printer Support
12900-12920 Select Printer Output Attempts to redirect local output to the printer.
12930 Restore Screen Output Returns local output to the screen.
File Area Support
16010-16012 Select File Directory Selects the configured upload or download directory.
Caller Log Maintenance
28570-28590 Check Caller Log Size Checks the caller log size and performs maintenance when needed.
28655 Load ASCII Support Loads the ASCII support module when required during caller log processing.
Retrieved from "https://www.color64wiki.itchybutt.org/index.php?title=System_Tracing&oldid=954"