Ptermres() terminates a process leaving a portion of the program's TPA? intact and removing the memory left from GEMDOS's memory list.

49 (0x31)

All GEMDOS versions.

keep is the length (in bytes) of the processes' TPA? to retain in memory after exit. retcode is the code returned on exit.

	move.w	retcode,-(sp)
	move.l	keep,-(sp)
	move.w	#$31,-(sp)
	trap	#1
	addq.l	#8,sp

Ptermres() never returns.

This function is normally used by TSR's to stay resident in memory. Any files opened by the process are closed. Any memory allocated is, however, retained. The value for keep is usually the sum of the length of the basepage (0x100), the length of the TEXT?, DATA?, and BSS? segments of the application, and the length of the stack (StabyloRmv: this is wrong, stack space need not being preserved as it is never used again). It is important to note that the memory retained by this call may not be freed at a later point as it is removed from the GEMDOS memory list altogether.

TSR initialisation code is usually located at the end of the TEXT? segment so that this part of the code can be freed at Ptermres() call. Therefore best practice suggests that code and data needed to stay resident be groupped at the begining of the TEXT? segment. This fine tunning of TSR code and data is achievable with asembly language only.

Pterm0(), Pterm()