qdosmsq:traps:trap_1:nthg

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

qdosmsq:traps:trap_1:nthg [2010/11/06 13:57] (current)
george.gwilt created
Line 1: Line 1:
 +====== SMS_NTHG ======
 +This trap scans the Thing list. The Trap cannot be used in the QDOS and SMSQ/E operating systems. Look at the Notes [[lthg|here]] for a solution.
 +^Call Parameters^^Return Parameters^^
 +|D0.B|$2B|D0.L|Error code.|
 +|A0.L|Pointer to Thing name/0|A0.L|Preserved.|
 +|A1.L|Unused.|A1.L|Pointer to next Thing linkage.|
 +
 +===== Errors =====
 +
 +|ERR_NF|Thing not found.|
 +
 +
 +
 +===== Notes =====
 +  * All registers not shown above are not used on entry and are preserved on exit.
 +  * If A0 is zero, the Trap finds the first Thing in the list. Otherwise it finds the next Thing in the list after the name to which A0 points.
 +  * On a successful return A1.L points to the linkage block of the next Thing. That Thing's name will be at $2A(A1). Setting that address in A0 and reentering the Trap allows the whole list to be scanned.
  
  • qdosmsq/traps/trap_1/nthg.txt
  • Last modified: 2010/11/06 13:57
  • by george.gwilt