HP 3000 Manuals

SWITCHDB [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

SWITCHDB 

CM callable only.

Switches the DB register pointer.  Privileged mode (PM) capability is
required.

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 

CCE (2)               Request granted.

CCG (0)               Not returned.

CCL (1)               Request denied.  An illegal data segment was
                      specified.

Related Information 

Intrinsics            GETDSEG

Commands              None

Manuals               Introduction to MPE XL for MPE V Programmers 
                      (30367-90005)



MPE/iX 5.0 Documentation