func btow

Syntax

   btow (byteaddress [splitstack])

Formal Declaration

   btow:I16 (byteaddress:I16 [splitstack:bool=FALSE])

Parameters

byteaddress

The CM DB-relative byte address which is to be converted into a CM DB-relative word address.

splitstack

If splitstack is FALSE, then byteaddress is assumed to be within the current process's CM stack. The byte address is logically shifted right by one bit. If the result is greater than the current S location, then %100000 is added. This effectively turns on the sign bit. By default, splitstack is FALSE.

If splitstack is TRUE, then byteaddress is assumed to be a data segment (DST) relative offset. The byte address is logically shifted right by one bit. No special test for the current location of S is performed.

Examples

 %cmdebug > dr
 DBDST=%204   DB=%1000    X=%0    STATUS=%100030=(Mitroc CCG 030) PIN=%40
 SDST=%204    DL=%177650  Q=%726  S=%41767   CMPC=SYS %27.253
 CIR=%041601  MAPFLAG=%1  MAPDST=%0

 %cmdebug > wl btow (100002)
 %40001

 %cmdebug > wl btow (177776)
 %177777

 %cmdebug > dr
 DBDST=%204   DB=%70000   X=%0    STATUS=%100030=(Mitroc CCG 030) PIN=%40
 SDST=%204    DL=%110650  Q=%726  S=%1204    CMPC=SYS %27.253
 CIR=%041601  MAPFLAG=%1  MAPDST=%0

 %cmdebug > wl btow (177776)
 %177777

 %cmdebug > wl btow (100002)
 %140001

 %cmdebug > wl btow (40002)
 %120001

Limitations, Restrictions