FNADDR command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The FNADDR command is used to determine the location in the [[Model 204]] load module
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>
of a specified $function, or the location of the [[Fast/Unload]] load module, if the
 
The <var>FNADDR</var> command is used to determine the location in the Model 204 load module
of a specified $function, or the location of the Fast/Unload load module, if the
[[Fast/Unload User Language Interface]] is active.
[[Fast/Unload User Language Interface]] is active.
===FNADDR command syntax===
===FNADDR command syntax===
  FNADDR funcname | LOADMOD loadModName | + hexFuncNumber
<p class="syntax">FNADDR <span class="term">funcname</span> | LOADMOD <span class="term">loadModName</span> | + <span class="term">hexFuncNumber</span> </p>
The function name specified after FNADDR should not include the initial leading dollar sign (or pound in England).
 
For example, this finds the location of the $SUBSTR function:
The function name specified after <var>FNADDR</var> should not include the initial leading dollar sign (or pound in England).
<pre>
For example, this finds the location of the <var>$Substr</var> function:
    FNADDR SUBSTR
<p class="code">FNADDR SUBSTR
</pre>
</p>


This command is mostly useful for diagnosis of [[Model 204]] internals problems, especially
This command is mostly useful for diagnosis of Model 204 internals problems, especially
those related to $functions.
those related to $functions.
It can also be useful in determining whether a particular $function is local,
It can also be useful in determining whether a particular $function is local,
a Sirius $function, or part of the [[Model 204]] base.
a former Sirius $function, or part of the Model 204 base.


If <b><i>LOADMOD</i></b> is specified, it is followed by the name of the load module to
If <var>LOADMOD</var> is specified, it is followed by the name of the load module to
locate.
locate.
Currently, the only load module name supported is FUNLOAD, so the following
Currently, the only load module name supported is <code>FUNLOAD</code>, so the following
command can be used for diagnosis by Sirius Software when the ''Fast/Unload User Language Interface'' is active:
command can be used for diagnosis when the <var class="product">Fast/Unload User Language Interface</var> is active:
<pre>
<p class="code">FNADDR LOADMOD FUNLOAD
    FNADDR LOADMOD FUNLOAD
</p>
</pre>


If <b><i>+ hexFuncNumber</i></b>. is specified, the number is that used in QTBL for
If <code><i>+ hexFuncNumber</i></code>. is specified, the number is that used in QTBL for
invocations of the $function.
invocations of the $function.
The FNADDR command is available in [[Sirius Mods]] version 6.2 and later.
The LOADMOD qualifier of FNADDR is available in <var class="product">Sirius Mods</var> version 6.8 and later.
The hex function number form of FNADDR is available in Sirius Mods version 7.2 and later.
<!-- FTREXC - DEPRECATED -->
<!-- FTREXC - DEPRECATED -->
<!-- FTRINC - DEPRECATED -->
<!-- FTRINC - DEPRECATED -->

Latest revision as of 15:24, 17 March 2016

Note: This is a Sirius Mods-only command prior to Version 7.5 of Model 204.

The FNADDR command is used to determine the location in the Model 204 load module of a specified $function, or the location of the Fast/Unload load module, if the Fast/Unload User Language Interface is active.

FNADDR command syntax

FNADDR funcname | LOADMOD loadModName | + hexFuncNumber

The function name specified after FNADDR should not include the initial leading dollar sign (or pound in England). For example, this finds the location of the $Substr function:

FNADDR SUBSTR

This command is mostly useful for diagnosis of Model 204 internals problems, especially those related to $functions. It can also be useful in determining whether a particular $function is local, a former Sirius $function, or part of the Model 204 base.

If LOADMOD is specified, it is followed by the name of the load module to locate. Currently, the only load module name supported is FUNLOAD, so the following command can be used for diagnosis when the Fast/Unload User Language Interface is active:

FNADDR LOADMOD FUNLOAD

If + hexFuncNumber. is specified, the number is that used in QTBL for invocations of the $function.