Appendix A. Other_Vendor Built-In Functions

 

Available Built-In Functions:

Id

DLL

Description

OV_FILE_DIALOG

997

U_BIF997

Presents standard File dialog.

OV_FILE_SERVICE

992

U_BIF992

Requests a file/directory service.

OV_INDEXED_SPACE

989

U_BIF989

Creates and manages an indexed space.

OV_MESSAGE_BOX

998

U_BIF998

Presents a message box.

OV_PASTE_CLIPBOARD

996

U_BIF996

Pastes information from the clipboard.

OV_POST_CLIPBOARD

995

U_BIF995

Posts information to the clipboard.

OV_QUERY_SYS_INFO

993

U_BIF993

Query LANSA system information.

OV_SLEEP

986

U_BIF986

Pauses the program for milliseconds.

OV_SOUND_ALARM

999

U_BIF999

Sounds an alarm.

OV_SYSTEM_SERVICE

991

U_BIF991

Requests a system service.

 

 

Disclaimer

These Built-In functions are provided as working examples and demonstrations for your use (with all source code). No warranty is expressed or implied in this provision.

Your attention is drawn to the following disclaimer that is included in the source code of all other vendor and user defined Built-In functions :

      /* ================================================================= */

      /* ========== USER DEFINED BUILTIN FUNCTION DEFINITION ============= */

      /* ================================================================= */

      /*                                                                   */

      /* This is a sample of how a user defined builtin function may be    */

      /* defined. It is provided as an example only. No warranty of any    */

      /* kind is expressed or implied. The programmer copying this code    */

      /* is responsible for the implementation and maintenance of this     */

      /* function, both initially and at all times in the future.          */

      /*                                                                   */

      /* User defined builtin functions are a powefull facility. However,  */

      /* you should note that YOU are responsible for any impact the       */

      /* use of a user defined builtin function has on the performance,    */

      /* security, integrity, portability and maintainability of your      */

      /* applications.                                                     */

      /*                                                                   */

      /* N.B. In general, do not use MessageBox api or any other           */

      /* operating system-specific api that requires user input if the BIF */

      /* is expected to work in Server environments, like LANSA for Web.   */

      /* There is a version of MessageBox available within LANSA that DOES */

      /* work in server environments - X_PDF_PromptYesNoCancel &           */

      /* X_PDF_PromptYesNo.  See x_pdfpro.h for prototypes                 */

      /*                                                                   */

      /* Note that MessageBox has been allowed in User Defined BIFs, unlike*/

      /* the rest of LANSA, so it is up to you, the developer, to ensure   */

      /* any use of it is valid. (x_glodef.h automatically allows it if    */

      /*U_BIF_FUNCTION is defined).                                       */

      /* ================================================================= */

 

Support, Questions?

Any problems you have with these Built-In Functions, or questions that your have about their use, can be directed through your LANSA distributor who will pass the details directly to LANSA Support. Please indicate clearly that the problem or question relates to an "Other Vendor" Built-In function so that LANSA support can pass the details on to the vendor who supplied the Built-In function.