GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-20
DELETE^[X]ITEM
Considerations
•
When called with a time-period parameter value greater than 0, the ^DELAY
procedure causes the calling task to be suspended. However, the GDSX process
remains active and other tasks can run.
•
This procedure may be called to wait for a period of time after a deadlock or a
failure to obtain buffer space.
DELETE^[X]ITEM
The DELETE^ITEM and DELETE^XITEM procedures delete an item from a linked
list. DELETE^ITEM is intended for use with lists in local memory, while
DELETE^XITEM is intended for use with lists in extended memory.
link-item-address input
is the address of an element to be deleted from the list.
The following condition code settings are valid:
^DEVICEINFO2
This procedure obtains the device type and the physical record length of a file. The file
can be open or closed.
If USCODE is converted, TSCODE receives device information in the D-series system
message format, and so USCODE tasks cannot call this C-series service routine. If a
task within a converted application calls this procedure, file-system error 29 or 560 is
returned. Converted USCODE must instead call ^FILE_GETINFOBYNAME_.
Except for the following consideration, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Considerations
•
Because the working stack images of tasks are swapped to and from an extended
data segment during I/O operations, I/O must be performed to and from global
buffers.
CALL DELETE^[X]ITEM ( link-item-address ); !
i
INT:value (Use with DELETE^ITEM.)
INT(32):value (Use with DELETE^XITEM.)
= CCE indicates that the item was successfully deleted.
< CCG indicates that the item was not found on the list.