NEARCALL - call an operator that is in the same segment.

Usage:

nearcall  ROUTINE,SYMREF=>type

Where:

ROUTINE

is the name of the routine you want to call.

SYMREF=>type

is an optional argument indicating whether you want to create a SYMREF for the named ROUTINE. Possible forms are:

SYMREF=>no

does not create a SYMREF.

SYMDEF=>yes

creates a primary SYMREF. This is the default, if you do not specify any SYMREF=>type argument.

SYMDEF=>secondary

creates a secondary SYMREF.

If you specify any other value in the "type" position, "nearcall" does not create a SYMREF. Note that the "type" keywords are case-sensitive and must be specified in lowercase.

Description:

"nearcall" calls an operator that is in the same segment as the calling routine. It generates an appropriate SYMREF to the specified routine, unless you specify SYMREF=>no. Then "nearcall" calls the routine with a TSX1 instruction.

When an operator is called with "nearcall", the operator should return with "nearret".

It is up to the programmer to ensure that the function being called by "nearcall" is in the same segment as the "nearcall" operator.

Notes:

The functions "nearcall", "nearret", and "nentry" are not part of the EASEE standard. They are only appropriate in a restricted set of circumstances, e.g. for specialized library use.

See Also:

expl runtime macro nearret

expl runtime macro nentry

Copyright © 1996, Thinkage Ltd.