SWITCHDB

Syntax

  U16         O-P       U16V
  logindex := SWITCHDB (index);

Functional Return

logindex

16-bit unsigned integer (assigned functional return)

Returns the logical index of the data segment indicated by the previous DB register setting, allowing this setting to be restored later. If the previous DB setting indicated the stack, a zero is returned.

Parameters

index

16-bit unsigned integer by value (required)

Passes the logical index of the data segment where the DB register is to be switched (obtained through the GETDSEG intrinsic). The value specified is checked to ensure that the process has acquired access to the segment previously. For an extra data segment, a positive, nonzero integer must be specified. To switch to the stack segment, a zero must be specified.

Condition Codes

Related Information