ue.007a User Exit/BASIC Program


Command ue.007a User Exit/BASIC Program
Applicable release versions: AP 6.1
Category BASIC Program (486)
Description updates a binary item from a Pick/BASIC program.
The file in which the item is stored is referenced by the last open or last file access preceding the call. See the examples below.

Item-id of the binary item.

Since a Pick/BASIC program cannot handle segment marks (decimal 255) characters, a special encoding scheme is used. A segment mark is replaced by the special two character sequence 'DLE _', where DLE is a 'data link escape' character (decimal 16) and '_' the underscore character. The following special sequences are replaced at file time:
DLE DLE Replaced by one DLE.
DLE _ Replaced by one segment mark.
DLE XX Replaced by one or more segment marks, where 'XX' is the number of segment marks from 1 to 126, plus 128 (hex x'80'). For example, DLE x'81' is replaced by one segment mark, DLE x'A3' is replaced by x'A3'-x'80'=x'23'=35 segment marks.

Item body size, in decimal. The size does not include the special DLE escape sequences, but it should includes the number of segment marks after decompression. In other words, it is the size as if the item body was not encoded with DLE sequences. If the size is not large enough, additional overflow is allocated to hold the binary item, but this space is not contiguous in the Virtual space, which may have some impact on performance while accessing the binary item.

Return code:
>0 Number of frames allocated to hold the binary item.
-1 Not enough overflow.
-2 Illegal DLE sequence.
-3 Illegal file reference.
Syntax code=oconv(size^item.id^item.body,"u007A")
equ DLE to char(16)

open "dict","object" to fd
code=oconv(2:AM:'test':AM:x, "u007a")

Write a binary item 'test' containing the TWO characters (in hex) 
x'01ff' in the dict of the file 'object'. 'code' 
returns 1 frame allocated. 

equ DLE to char(16)

read dummy from fd,'' else dummy=''
code=oconv(33:AM:'test':AM:x, "u007a")

Write a binary item 'test' containing 32 consecutive segment marks, 
followed by one DLE, in a file described by the file descriptor 'fd'. 
Note how the read of a dummy (possibly non existent) item is used to 
'reference' the file.