BASIC User Exits

User exits allow calling direct system code from a BASIC oconv or iconv function. Many of the functions performed by user exits can be achieved by using the system() function or the execute statement with the appropriate TCL command or BASIC statement.

The following BASIC user exits are presented:

u$pl.mon.data User Exit

Returns monitor information.

u000e User Exit

Gets the name of the current account.

u0003 User Exit

Returns the TCL command invoking the FlashBASIC or BASIC program.

u0004 User Exit

Returns term settings in dynamic array format.

u0005 User Exit

Clears the type-ahead buffer.

u0010 User Exit

Creates a phantom process.

u0011 User Exit

Gets the port number of the scheduler process.

u001c User Exit

Gets the number of attributes (elements) after a matread.

u001e User Exit

Returns the checksum of a string.

u001f User Exit

Returns the last shutdown status.

u0033 User Exit

Converts a decimal number into a Roman numeral.

u0039 User Exit

Reads an absolute disk sector. This user exit provides more information than u14a.

u005b User Exit

Obtains and manipulates external strings, allowing the caller (likely non-FlashBASIC) to store data without writing to a file or storing it in BASIC string space.

u007a User Exit

Updates a binary item from a FlashBASIC or BASIC program.

u0079 User Exit

Returns the where status for the specified PCB (Process Control Block) FID, and its return stack information.

u0089 User Exit

Converts a hexadecimal number (in a string) to a binary number.

u009d User Exit

Encodes or decodes a string of characters.

u009e User Exit

Replaces all occurrences of a specified string found in a specified string with the text in another specified string.

u009f User Exit

Converts a binary number to a hexadecimal number (32-bit limit).

u00b9 User Exit

Returns a soundex value for a specified string.

u00ba User Exit

Performs BIOS INT 10 calls to change the video screen attributes on the console.

u014a User Exit

Reads an absolute disk sector.

u014b User Exit

Writes an absolute disk sector.

u017e User Exit

Allows output of any character to the terminal or spooler.

u01b6 User Exit

Converts a numeric expression to the number of units as defined by the TCL set-units, set-dozens, set-decimal, or set-thousands commands.

u0209 User Exit

Returns only alphabetical and numeric characters.

u0358 User Exit

Allows character input combined with an eoi (end-of-input) character.

u0c User Exit

Encrypts a password.

u1072 User Exit

Returns a dynamic array, sorted in ascending order.

u10b9 User Exit

Converts American currency punctuation ($1,000.00) to international punctuation (#1.000,00)

u11b6 User Exit

Converts a unit expression to a numeric value as defined by the TCL set-units, set-dozens, set-decimal, or set-thousands commands.

u1209 User Exit

Breaks a single line of text into multiple lines of text with each line being no longer than the a specified number of characters.

u1a User Exit

Returns the tape block size.

u1f User Exit

Returns a string of digits indicating the boot status.

u20b9 User Exit

Converts international currency punctuation (#1.000,00) to American punctuation ($1,000.00).

u21 User Exit

Converts upper case to lower case.

u2117 User Exit

Returns information about the current process.

u21a3 User Exit

Opens a file, or reads the next attribute from a file.

u21b6 User Exit

Returns a numeric value representative of the current unit setting defined by the TCL set-units, set-dozens, set-decimal, or set-thousands commands.

u22 User Exit

Converts lower case to upper case.

u222d User Exit

Retrieves the CC pointer item information from binary items.

u28 User Exit

Returns the number of saves that have occurred since the last full restore.

u3060 User Exit

Encrypts a character string. The result is always an 8-character hexadecimal string.

u3079 User Exit

Returns the PCB FID of the current process, or returns the port number of the current process.

u307a User Exit

Suspends processing until a specified time.

u3090 User Exit

Aborts a FlashBASIC or BASIC program.

u313c User Exit

Returns the diskette drive type and density selected.

u352e User Exit

Retrieves statistical information about the use of buffers by the D3 monitor.

u3b User Exit

Returns information about the port.

u3f User Exit

Converts an ASCII hexadecimal-format string to binary, and sends it to the printer.

u4070 User Exit

Directs all subsequent output to the terminal. This is the same as the BASIC printer off statement.

u407a User Exit

Sets a port to sleep for a specified number of seconds. This is the same as the BASIC sleep statement.

u4117 User Exit

Returns the PCB (Process Control Block) in hexadecimal for the current process.

u413c User Exit

Sets the format type to the given format media.

u4209 User Exit

Parses the input into discrete words.

u47 User Exit

Writes a string in ASCII or hexadecimal to a specific location in a frame.

u48 User Exit

Reads a specific location of a frame and returns the content.

u50bb User Exit

Returns the port number, user-ID, and current account for this process, just like the TCL who command.

u5117 User Exit

Returns the PCB in hexadecimal for port 0.

u5e User Exit

Clears the internal BASIC heading and footing so that subsequent heading and footing statements display properly at the top of the next page.

u60ba User Exit

Flushes all memory to disk, and shuts down the D3 system.

u60bb User Exit

Returns the user-ID and account name of the current process.

u6193 User Exit

Removes all but the last three characters from the data passed from the variable.

u63 User Exit

Sets/clears privilege bits.

u65 User Exit

Returns the estimated number of items in the most recently referenced file.

u6d User Exit

Sends shutdown message.

u7000 User Exit

Returns the size of an item.

u70ba User Exit

Forces the system to restart.

u71 User Exit

Sets the HAForceCheck option programmatically.

u7193 User Exit

Converts the American date format (mm/dd/yy) to international format (dd/mm/yy).

u8194 User Exit

Returns the number of items selected by the most previous select.

u83 User Exit

Sets a group lock.

u84 User Exit

Clears a group lock from the group lock table.

u86 User Exit

Sets the root fid of the index.

u90 User Exit

Returns the file of files number for the file most previously referenced in the FlashBASIC or BASIC program.

u90e3 User Exit

Flips the parity bit on the input.

u91 User Exit

Reads and writes D3 shell variables.

u9116 User Exit

Logs on a given port.

u92 User Exit

Follows the links of a frame.

u98 User Exit

Retrieves the links for the specified fid.

ua116 User Exit

Logs of the specified port.

ub070 User Exit

Returns the absolute value of a variable, stripping the leading -, if any.

ub0ba User Exit

Reads one string of memory.

uc0ba User Exit

Writes a value into a memory address.

ud0ba User Exit

Reads a character byte from a serial port.

ue0ba User Exit

Writes a character byte out to a serial port.

uf070 User Exit

Starts and stops multiuser mode, and returns information about the number of serial ports, PIBs, phantom PIBs, licensed users, users logged on, and the maximum number of users that can log on.

xsuex User Exit

Obtains and manipulates external strings, allowing the caller (likely non-FlashBASIC) to store data without writing to a file or storing it in BASIC string space.