Documentation Comments
Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.
Reality V15.0 ()
User Exit Conversions (DataBasic) (m6187ad_.htm)
This topic contains a list of user exits which can be used in an ICONV or OCONV intrinsic function to perform special processing. The need for most of these user exits has been eliminated by the addition of elements to the SYSTEM intrinsic function and ASSIGN statement.
| User Exit | Purpose/Comments | Input | Output | Alternative |
|---|---|---|---|---|
| U307A | Causes terminal to sleep until the specified time. | Time (in 24-hour format) | Time (in internal format) | RQM or SLEEP statement. |
| U407A | Causes terminal to sleep until the specified number of seconds has elapsed. | Number of seconds to sleep | Number of seconds to sleep | RQM or SLEEP statement. |
| U50BB |
Returns the port number and account name. (Similar to TCL WHO command. Note: In some MultiValue modes, different information is returned by this user exit and additional functionality is available. See U50BB below for details. |
Ignored | Port number and account name | SYSTEM(18) returns the port number.SYSTEM(19) returns the account name. |
| U00E0 | Whether or not the executing program is cataloged. | Ignored | 1 if cataloged; otherwise 0 | SYSTEM(20) |
| U10DD | Get system serial number. | Ignored | System serial number | SYSTEM(22)<1> |
| U10E0 | Returns the options specified on the input line at run-time in alphabetic order with commas removed. Numeric options are excluded. ICONV only. | Ignored | Options | SYSTEM(15) |
| U20E0 | Returns the TCL command line. The verb, redundant blanks, and options are removed. The remaining blanks are replaced with attribute marks. Not valid if the program is run from a Proc. | Ignored | TCL command line | SYSTEM(60) is directly equivalent to this user exit. However, the SENTENCE function provides greater flexibility and should be preferred. |
| U30E0 | Whether or not there is an active select list. | Ignored | 1 if there is an active select list; otherwise, 0 | SYSTEM(11) |
| U40E0 | Toggles printing of warning messages at run-time (toggles the S option of the RUN command). | Ignored | None | |
| U60E0 | Returns current setting of the terminal page width. | Ignored | Page width in characters | SYSTEM(2) |
| U70E0 | Sets the terminal echo ON (similar to the TCL NOHUSH command). | Ignored | None | ECHO ON |
| U80E0 | Sets the terminal echo OFF (similar to the TCL HUSH command). | Ignored | None | ECHO OFF |
| U90E0 | Converts dollars to RAND; that is, converts dollar signs ($) to 'R' or to a specified character (appended to the user exit code), commas to full stops and full stops to commas. | Value to convert | Converted value | CONVERT(value,"$,.","R.,") |
When called from DataBasic with ICONV or OCONV, the information returned by user exit U50BB depends on the MultiValue mode set with the $OPTIONS statement, as follows:
| MultiValue Mode | Information Returned |
|---|---|
| D3 | portNumber userId accountName |
| MVENTERPRISE, MVBASE | portNumber accountName |
| R83, AP, PICK | portNumber accountName userId |
In other MultiValue modes, U50BB behaves as on Reality.
In addition, in the modes listed above, the information returned depends on the input. If the input passed to the user exit has the following format:
{[A||P||U]}{%portNumber}
the output is as follows:
A Return only the account name.
P Return only the port number.
U Return only the user-id.
%portNumberReturn information about the specified port.
For example:
$OPTIONS D3
PRINT ICONV("A%403", "U50BB")
returns the current account for port 403.