GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-43
INSERT^[X]ITEM
INSERT^[X]ITEM
The INSERT^ITEM and INSERT^XITEM procedures insert an item into a linked list.
INSERT^ITEM is intended for use with lists in global memory, while INSERT^XITEM
is intended for lists in extended memory.
address1 input
is the address of an element on the list. To make an item addressed by address2 the
first item on the list, address1 should specify the address of the list header.
To make an item addressed by address2 the last item on the list, address1 should
specify the second occurrence of the array that specifies the list header
(list^header[1], which contains the address of the last item on the list).
address2 input
is the address of the element to be added to the list.
ITC^OPENX
This procedure provides a task with an ITC file number, which allows the task to receive
ITC messages from other tasks.
A task that wants to send messages to another task must have the receiving task’s FCB
address. The sending task obtains the FCB of the receiving task by calling
GET^ITC^FCB.
status returned value
INT:value
CALL INSERT^[X]ITEM ( address1 !
i
,address2 ); !
i
INT:value (Use with INSERT^ITEM.)
INT(32):value (Use with INSERT^XITEM.)
INT:value (Use with INSERT^ITEM.)
INT(32):value (Use with INSERT^XITEM.)
status := ITC^OPENX ( tcb-address !
i
,itc-filenum ); !
o