Please enable JavaScript to view this site.

A-Shell Reference

Navigation: Subroutines > MIAMEX

MX_GETERSATZ

Scroll Prev Top Next More

xcall MIAMEX, MX_GETERSATZ, ersatz, dev, proj, prog, status

MX_GETERSATZ (MIAMEX 11) is used to obtain information about the defined ERSATZ devices.

Note that a short-cut is available to reset to the first ERSATZ device. If the ersatz parameter is a null string, then information on the first ERSATZ device will be returned; it is not necessary to go around a loop waiting for a returned status of one.

Parameters

ersatz (String, 6+)

the ERSATZ device name

dev (String, 6+)  [out]

the real device

proj and prog  (B,2)  [out]

the project and programmer number respectively. See the decryption of these parameters under MIAMEX 19 for notes on decimal vs. octal and backwards compatibility with the old octal PPN system which was upgraded to decimal in A-Shell 5.1.897.

status  (F,6)  [out]

a value of one is returned if the end of the ERSATZ list is reached, in which case the rest of the parameters do not contain valid data. On the next call, information on the first ERSATZ device will be returned, and then the second, and so on. In these cases the value of status will be zero.