TweetFollow Us on Twitter

Segment
Volume Number:2
Issue Number:11
Column Tag:Basic School

Using the Segment Manager from Basic

By Dave Kelly, MacTutor Editorial Board

This month we'll discuss Macintosh memory management (part 2, part 1 was discussed back in the June 1985 MacTutor). While the information back in June 1985 is still valid, there are some other (new?) considerations that I haven't mentioned yet. If you have the June '85 MacTutor go back and review that information as it will be useful here as we talk about it some more. It would also be helpful to read Inside Macintosh Vol. I chapter 3 on Memory Management and Vol II chapter 2 on the Segment Loader.

Now that we have as much memory available as we ever dreamed we might have (remember when it was so great to have 16K RAM?), we need to talk about the best ways to make use of it. In review, please recall that the key to memory management in MS Basic is the CLEAR statement. Even on a Macintosh Plus you should use CLEAR to make the best use of the available memory. The following procedure will help you to quickly set up the memory configuration:

1. Load your program and before running it type PRINT FRE(0) in the command window to determine the amount of memory used by your program listing. Record this number for later use.

2. Run the program. The intent here is to determine the amount of memory that your variables need. For some programs you may not be able to run enough of the program to declare all of the variables. In that case you may have to do some rough guessing here. Either after running your program or sometime during the program (this may be more convenient) you should print FRE(0) again. The difference between this number and the number you recorded in step 1 above is the amount of memory allocated to the data segment that is used for your variables. (FRE(-1) returns the number of bytes not used in the heap; FRE(-2) returns the number of bytes in the stack that have not been used; you may use these if it will help you).

3. Now it's time to guess. Try to decide if the program will ever need more memory than this in the future. If you need to increase the program size later or allocate more variables you will need to allow some space for this. If you are not sure you may want to just add 20% or so more memory to the length of the program. Whatever you decide here will be your data segment memory.

4. Now, if your program uses any Macintosh resources you will need to figure out how much of the heap to use. If you have extra memory like on the Mac plus it never hurts to have extra heap space. In fact, the heap may be more heavily used than the data segment depending on how many controls, or windows, etc. you may be using. Keep in mind also that if any desk accessories are opened they will need some heap space of their own. By printing FRE(-2) it will show the heap memory allocation. If you print FRE(-2) before running the program you will know the amount of heap available to the program. After the program is run and resources are loaded, the amount of heap will decrease. You need to know the difference between the FRE(-2) before and after running the program. Record this number.

5. Now you need to calculate the stack-size to use in the CLEAR statement. Many times it is not even necessary to change the data segment (leave it as large as the memory you have left). The number to use for the stack-size is calculated by stack-size = Total Ram - (data-segment-size + heap-size).

Fig. 1 Output of our Segment Program

Now how do you know when you need to adjust the memory allocation? Ans: Anytime that you notice an unusual amount of disk activity, especially just before displaying controls (edit fields, buttons, menus, windows etc.). It doesn't matter if you have a Mac Plus or not, if you don't adjust your memory properly, then the memory will not be used efficiently. In order to remain compatible with the 512K & 128K Mac, the heap and stack default sizes are the same on the Mac plus. This may explain why so many Mac programs need to read the disk so often even though you may think you have a lot of memory (1Meg really is plenty for Basic!!). Good memory management planning can improve your program tremendously. Another thing to keep in mind is that once the CLEAR statement has been used to change the memory allocation it will remain that way for the next program that you load into memory. A second CLEAR statement will not reallocate the memory properly. It is best to quit to the finder and start all over unless the new program uses the same memory configuration.

So much for MS Basic memory management. The comments above in addition to those in the June '85 MacTutor should give you all you need to handle most of your memory management. Memory management in other languages is handled through use of the Segment Loader. Access to the Segment Loader is not provided in MS Basic. ZBasic provides the SEGMENT and SEGMENT RETURN statements which use the Segment Loader. We'll talk about those in a moment. First a few words about the Segment Loader. The Segment Loader allows you to divide up the code of your application into several parts. When the Finder starts up your application the Segment Loader is called to load in the main segment of your program. Other segments are loaded in automatically as needed. After a segment is no longer needed, your application can call the segment loader to make the segment purgable. This way if you have only a small amount of memory available you may still run a large program. The maximum size of a segment is 32K. Any code that is not used often may be in a separate segment so that it may be swapped in whenever it is needed. Another function of the Segment Loader is in supplying information from the Finder.

Your ZBasic code will be compiled into code segments (resources of type 'CODE') automatically, no matter if you use the SEGMENT statements or not. When the code reaches a length of about 28K the segment will end and the next segment will be loaded. The SEGMENT RETURN statement marks the end of the CODE segment and returns to the calling routine (cannot be called from the same segment). You should arrange your application such that a segment consists of a subroutine. The routines you decide to separate into segments preferably should be routines which are only used occasionally (example: print routines).

The following example program demonstrates how to "segmentize" your programs. However, because the segments in the example are small (less than 100 bytes), the segment memory swapping is virtually non-existent on a Macintosh plus (and probably all the other size Macs too!). If you really want to try this out, you'll have to write some larger CODE segments and run on a smaller Mac. You can check the segment sizes by choosing the COMPILE option of the ZBasic command menu. The sizes of the segments will be displayed. The remaining memory can be found with the MEM(-1) function. MEM(-1) returns the maximum amount of available memory for the program and variables.

Another part of the Segment Loader is supported by ZBasic with the FINDERINFO function. The FINDERINFO function returns information to your application which tells the application how the application was selected from the Finder. The function returns variables with the number of files selected, the name of the files and volume number, and a message variable indicating if the file should be loaded or printed. This way the files may be printed (or whatever) without going through the full set of initialization routines that your application may have. If no files have been selected then your application should open a new untitled document and continue from there. The syntax is: message%= FINDERINFO (count%, var$[(n)], type%[(n)], volume%[(n)]). The message variable is the result of the FINDERINFO function. If the result is equal to zero then the file should be loaded otherwise the file should be printed. The Count% variable returns the number of files . The variable var$(n) is a string variable or string array with the names of the files which have been selected. The file type of the selected files is stored in a long integer word which must be converted to a string by using the MKI$ statement. The volume% variable is the the disk volume where the file is located.

To get the FINDERINFO function to work, first you must compile your program as an application. There are two or three statements that must be used properly in order to compile the program so that the function will work. First type CREATOR "ffff" where "ffff" is the creator name which will be given to the application. The other statement that must match this one is the DEFOPEN "ffffcccc" statement which sets up the file type ("ffff") and the file creator ("cccc") for the data files created by your application. In the demo program the creator is "DAVE" and the file type is "DATA". The DEFOPEN statement is used in the application program when opening up new data files. Now that the creator is the same for the application as for the data, we need to set the bundle bit with the BUNDLE 1 statement. Type BUNDLE 1 in the command window. Now it is time to compile the program into an application. Select RUN* from the menus to create the application. New data files which are created with the application will now be linked to each other. Selecting one or more data files while in the Finder and selecting PRINT or OPEN will open the application which the data files belong and send info to the application via the FINDERINFO statement. To see the results of this function, you may want to run the demo and create a few sample data files and see what happens when they are selected for printing or to be opened.

If you have problems getting the FINDERINFO information, be sure that you set the creator and bundle bit before compiling the application. You should also be sure to define all the variables in the function before calling it. More information on the Segment Loader is available in Vol 2, Chap. 2 of Inside Macintosh (The Segment Loader chapter).

WINDOW OFF
REM Segment Loader Example ZBasic 3.02
REM ©MacTutor 1986
REM by Dave Kelly
DIM 31 Name$(5),Vol%(5),Type&(5),Mes$(1)
REM up to 5 files can be selected.
DEFSTR LONG
Count%=2
Message%=FINDERINFO(Count%, Name$(0), Type&(0),    Vol%(0))
X&=MEM(-1)
WINDOW 1,"Segment Sample",(50,100)-(475,300),257
IF Count%<>0 THEN GOSUB "DisplayFINDERINFO"
MENU 1,0,1,"File"
MENU 1,1,1,"Create Data File"
MENU 1,2,1,"Quit"
MENU 2,0,1,"Segments"
MENU 2,1,1,"Main Segment"
MENU 2,2,1,"1st Segment"
MENU 2,3,1,"2nd Segment"
MENU 2,4,1,"3rd Segment"
MENU 2,5,1,"Check memory available and unload unused     segments"
ON MENU GOSUB "Menuevent"
MENU ON
"Loop":
GOTO "Loop"
"Menuevent":
Menunumber=MENU(0)
Menuitem=MENU(1)
MENU
MENU OFF
ON Menunumber GOSUB "Filemenu","Segmenu"
MENU ON
RETURN
"Filemenu":
IF Menuitem=1 THEN "Openfile"
IF Menuitem<>2 THEN RETURN
MENU RESET
END
"Openfile":
DEF OPEN "DATADAVE"
Filename$=FILES$(0,"Create new file as ..." ,"Segment    DATA")
IF Filename$="" THEN RETURN
OPEN O,#1,Filename$
PRINT "New file named ";Filename$;" has been created.":PRINT
PRINT "Quit the program and click on "; Filename$; " to see    how the"
PRINT "FINDERINFO function works.  Select PRINT or OPEN  from the Finder."
PRINT "The FINDERINFO function will indicate what has been     selected."
PRINT "You may want to create multiple data files and try      printing"
PRINT "or opening them to see what happens."
RETURN
"Segmenu":
ON Menuitem GOSUB "Main", "Seg1", "Seg2", "Seg3",  "Memory"
RETURN
"Main":
PRINT "This is part of the main segment"
RETURN
SEGMENT
"Seg1"
PRINT "This is part of the 1st segment"
SEGMENT RETURN
SEGMENT
"Seg2"
PRINT "This is part of the 2nd segment"
SEGMENT RETURN
SEGMENT
"Seg3"
PRINT "This is part of the 3rd segment"
SEGMENT RETURN
SEGMENT
"Memory"
X&=MEM(-1)
PRINT "Memory = ";X&
SEGMENT RETURN
SEGMENT
"DisplayFINDERINFO":
CLS
Mes$(0)="Data file(s) should be loaded"
Mes$(1)="Data file(s) should be printed"
PRINT "Message% = ";Message%;" Therefore... "; Mes$(     Message%)
PRINT "Count%   = ";Count%; "file(s) have been passed to       this application"
PRINT "Filenames are:"
PRINT"Name","Type","Vol"
FOR C=0 TO Count%-1
PRINT Name$(C),MKI$(Type&(C)),Vol%(C)
NEXT C
SEGMENT RETURN
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Skype 8.52.0.138 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
Bookends 13.2.6 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
BusyContacts 1.4.0 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Chromium 77.0.3865.75 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 77.0.3865.75: A list of changes is available... Read more
DiskCatalogMaker 7.5.5 - Catalog your di...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast Finder-like intuitive look and feel Super-fast search algorithm Can compress catalog data for... Read more
Alfred 4.0.4 - Quick launcher for apps a...
Alfred is an award-winning productivity application for OS X. Alfred saves you time when you search for files online or on your Mac. Be more productive with hotkeys, keywords, and file actions at... Read more
A Better Finder Rename 10.45 - File, pho...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
iFinance 4.5.11 - Comprehensively manage...
iFinance allows you to keep track of your income and spending -- from your lunchbreak coffee to your new car -- in the most convenient and fastest way. Clearly arranged transaction lists of all your... Read more
OmniGraffle Pro 7.11.3 - Create diagrams...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
BBEdit 12.6.7 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more

Latest Forum Discussions

See All

Five Nights at Freddy's AR: Special...
Five Nights at Freddy's AR: Special Delivery is a terrifying new nightmare from developer Illumix. Last week, FNAF fans were sent into a frenzy by a short teaser for what we now know to be Special Delivery. Those in the comments were quick to... | Read more »
Rush Rally 3's new live events are...
Last week, Rush Rally 3 got updated with live events, and it’s one of the best things to happen to racing games on mobile. Prior to this update, the game already had multiplayer, but live events are more convenient in the sense that it’s somewhat... | Read more »
Why your free-to-play racer sucks
It’s been this way for a while now, but playing Hot Wheels Infinite Loop really highlights a big issue with free-to-play mobile racing games: They suck. It doesn’t matter if you’re trying going for realism, cart racing, or arcade nonsense, they’re... | Read more »
Steam Link Spotlight - The Banner Saga 3
Steam Link Spotlight is a new feature where we take a look at PC games that play exceptionally well using the Steam Link app. Our last entry talked about Terry Cavanaugh’s incredible Dicey Dungeons. Read about how it’s a great mobile experience... | Read more »
PSA: GRIS has some issues
You may or may not have seen that Devolver Digital just released GRIS on the App Store, but we wanted to do a quick public service announcement to say that you might not want to hop on buying it just yet. The puzzle platformer has come to small... | Read more »
Explore the world around you in new matc...
Got a hankering for a fresh-feeling Match-3 puzzle game that offers a unique twist? You might find exactly what you’re looking for with What a Wonderful World, a new spin on the classic mobile genre which merges entertaining puzzles with global... | Read more »
Combo Quest (Games)
Combo Quest 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: Combo Quest is an epic, time tap role-playing adventure. In this unique masterpiece, you are a knight on a heroic quest to retrieve... | Read more »
Hero Emblems (Games)
Hero Emblems 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: ** 25% OFF for a limited time to celebrate the release ** ** Note for iPhone 6 user: If it doesn't run fullscreen on your device... | Read more »
Puzzle Blitz (Games)
Puzzle Blitz 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Puzzle Blitz is a frantic puzzle solving race against the clock! Solve as many puzzles as you can, before time runs out! You have... | Read more »
Sky Patrol (Games)
Sky Patrol 1.0.1 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.1 (iTunes) Description: 'Strategic Twist On The Classic Shooter Genre' - Indie Game Mag... | Read more »

Price Scanner via MacPrices.net

Save $150-$250 on 10.2″ WiFi + Cellular iPads...
Verizon is offering $150-$250 discounts on Apple’s new 10.2″ WiFi + Cellular iPad with service. Buy the iPad itself and save $150. Save $250 on the purchase of an iPad along with an iPhone. The fine... Read more
Apple continues to offer 13″ 2.3GHz Dual-Core...
Apple has Certified Refurbished 2017 13″ 2.3GHz Dual-Core non-Touch Bar MacBook Pros available starting at $1019. An standard Apple one-year warranty is included with each model, outer cases are new... Read more
Apple restocks 2018 MacBook Airs, Certified R...
Apple has restocked Certified Refurbished 2018 13″ MacBook Airs starting at only $849. Each MacBook features a new outer case, comes with a standard Apple one-year warranty, and is shipped free. The... Read more
Sunday Sale! 2019 27″ 5K 6-Core iMacs for $20...
B&H Photo has the new 2019 27″ 5K 6-Core iMacs on stock today and on sale for up to $250 off Apple’s MSRP. Overnight shipping is free to many locations in the US. These are the same iMacs sold by... Read more
Weekend Sale! 2019 13″ MacBook Airs for $200...
Amazon has new 2019 13″ MacBook Airs on sale for $200 off Apple’s MSRP, with prices starting at $899, each including free shipping. Be sure to select Amazon as the seller during checkout, rather than... Read more
2019 15″ MacBook Pros now on sale for $350-$4...
B&H Photo has Apple’s 2019 15″ 6-Core and 8-Core MacBook Pros on sale today for $350-$400 off MSRP, starting at $2049, with free overnight shipping available to many addresses in the US: – 2019... Read more
Buy one Apple Watch Series 5 at Verizon, get...
Buy one Apple Watch Series 5 at Verizon, and get a second Watch for 50% off. Plus save $10 on your first month of service. The fine print: “Buy Apple Watch, get another up to 50% off on us. Plus $10... Read more
Sprint offers 64GB iPhone 11 for free to new...
Sprint will include the 64GB iPhone 11 for free for new customers with an eligible trade-in in of the iPhone 7 or newer through September 19, 2019. The fine print: “iPhone 11 64GB $0/mo. iPhone 11... Read more
Verizon offers new iPhone 11 models for up to...
Verizon is offering Apple’s new iPhone 11 models for $500 off MSRP to new customers with an eligible trade-in (see list below). Discount is applied via monthly bill credits over 24 months. Verizon is... Read more
AT&T offers free $300 reward card + free...
AT&T Wireless will include a second free 64GB iPhone 11 with the purchase of one eligible iPhone at full price. They will also include a free $300 rewards card. The fine print: “Buy an elig.... Read more

Jobs Board

Student Employment (Blue *Apple* Cafe) Spri...
Student Employment (Blue Apple Cafe) Spring 2019 Penn State University Campus/Location: Penn State Brandywine Campus City: Media, PA Date Announced: 12/20/2018 Date Read more
Best Buy *Apple* Computing Master - Best Bu...
**732359BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000171-Winchester Road-Store **Job Description:** Read more
*Apple* Mobile Master - Best Buy (United Sta...
**732324BR** **Job Title:** Apple Mobile Master **Job Category:** Store Associates **Location Number:** 000013-Fargo-Store **Job Description:** **What does a Best Read more
Best Buy *Apple* Computing Master - Best Bu...
**732455BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000449-Auburn Hills-Store **Job Description:** **What does a Read more
*Apple* Mobility Pro - Best Buy (United Stat...
**732490BR** **Job Title:** Apple Mobility Pro **Job Category:** Store Associates **Location Number:** 000449-Auburn Hills-Store **Job Description:** At Best Buy, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.