Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FilePusrval()                                                            GEMDOS

Syntax

LONG Pursval( val )
LONG val;

Function      Pusrval() reads/modifies a user defined value associated
              with a process.

Opcode        280 (0x118)

Availability  This function is available under all MiNT versions
              integrated with MultiTOS.

Parameters    val specifies the new value of the LONG associated with this
              process. If val is -1 then this value is not changed but
              still returned.

Binding       move.l   val,-(sp)
              move.w   #$118,-(sp)
              trap     #1
              addq.l   #6,sp

Return Value  Pusrval() returns the original value of the user LONG prior
              to the call.

Comments      The user-defined longword set by this call is inherited by
              child processes and may be utilized as desired.