Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
LotusScript® Language
Welcome to the LotusScript® Language section of Domino® Designer Help.
Beyond Core LotusScript®
This chapter discusses the role that LotusScript® plays with IBM® products, your operating environment, other programs, and interactive user applications.
LS2J: Connecting with Java™
Using LotusScript® and LS2J, you can access Java™ classes, giving you a powerful cross-platform extension to LotusScript. Developers can access Java in LotusScript programs as a set of predefined LotusScript objects. This set of objects allow LotusScript to use already created Java classes that are available in script libraries or found using the classpath.
Using LS2J
To use LS2J from within Notes®, your LotusScript® code must include this line:

IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
- Accessibility and keyboard shortcuts
  Accessibility features assist users who have a disability, such as restricted mobility or limited vision, to use information technology content successfully.
- Application Design
  Welcome to the Application Design section of Domino® Designer Help.
- Application Management
  Welcome to the Application Management section of Domino® Designer Help.
- Domino® Query Language
  Domino Query Language (DQL) is a facility running in Domino core allowing for a terse shorthand syntax for finding documents according to a wide variety of complexity of terms. It leverages existing design elements without the need to write detailed code to access them.
- Composite Applications - Design and Management
  Composite applications are a key element in a service-oriented architecture (SOA) and contextual collaboration strategy. The ability to create and edit composite applications lets you easily integrate different types of components and technologies.
- DB2® Access views
  Domino® Designer includes two types of design elements to assist you in managing data contained in DB2® enabled Notes® databases:
- Programming Overview and User Interface
  This section contains general guidelines and examples that show where to use Java, LotusScript, and the formula language.
- Formula Language
  This section documents the formula language.
- LotusScript® Language
  Welcome to the LotusScript® Language section of Domino® Designer Help.
  - Introduction to LotusScript®
    This chapter introduces LotusScript® and describes, in general terms, how to use the script editor to write and modify scripts, how to compile scripts, and how to use the debugger to locate problems in the logic of your applications.
  - Script and Statement Construction Rules
    This chapter describes the rules for writing the basic elements of a script in the LotusScript® language.
  - Data Types, Constants, and Variables
    This chapter provides information about LotusScript® constants and variables and the data types of the values that they can represent.
  - Expressions and Operators
    This chapter describes the set of LotusScript® operators, how they may be combined with operands to form expressions, and how those expressions are evaluated.
  - Procedures: Functions, Subs, and Properties
  - File Handling
    This chapter describes file handling in the LotusScript® language.
  - Error Processing
    This chapter describes error processing in the LotusScript® language.
  - User-Defined Data Types and Classes
    This chapter describes two kinds of custom data structures that you can define in LotusScript®. Each can hold data of different types in a single data structure.
  - Managing Flow in Scripts
    The flow of execution of a script generally follows the sequence of statements in the script. This chapter describes the behavior of particular statements that alter the flow of execution.
  - Managing Asynchronous Web Agents in Domino®
    This chapter describes how to use multiple threads and synchronization to manage HTTP agents with Domino®.
  - Beyond Core LotusScript®
    This chapter discusses the role that LotusScript® plays with IBM® products, your operating environment, other programs, and interactive user applications.
    - IBM® software environments
      IBM® software provides the environment in which you create, debug, and run LotusScript® modules. IBM software applications that work with LotusScript supply their own application programming interface (API), which lets you use product functionality and create and manipulate product objects from within a LotusScript program. A IBM software API is effectively an extension to the LotusScript language that is available when you are running that product.
    - Interacting with the user
      IBM® products lend themselves to building interactive applications, applications that incorporate user input and prompt the user to perform particular tasks. While each individual IBM software application provides its own user interface for interacting with scripts, LotusScript® supplies some fundamental tools that you can use with any IBM software.
    - Interacting with other programs
      LotusScript® provides a number of functions and statements that you can use to interact with other programs and the operating system. You can also use Object Linking and Embedding (OLE) to incorporate functionality and data from other Windows™ applications into your LotusScript applications.
    - Calling external C language functions
      LotusScript® allows you to call external C language functions. You implement external C functions inside a named library module that generally contains several C functions. With Windows™, this is a Dynamic Link Library (DLL). All Windows users have access to the libraries in the Windows application programming interface (API).
    - LS2J: Connecting with Java™
      Using LotusScript® and LS2J, you can access Java™ classes, giving you a powerful cross-platform extension to LotusScript. Developers can access Java in LotusScript programs as a set of predefined LotusScript objects. This set of objects allow LotusScript to use already created Java classes that are available in script libraries or found using the classpath.
      - About LS2J
        LS2J is the interface that allows data to transfer from the Java™ data type to the LotusScript® data type and allows LotusScript to execute Java object methods. LS2J allows LotusScript to create Java objects as if they are native to the LotusScript environment.
      - System requirements
        LS2J is implemented on all Domino® platforms. Your system must meet the following requirements:
      - Using LS2J
        To use LS2J from within Notes®, your LotusScript® code must include this line:
        Using Script Libraries with LS2J
        This demonstrates how you might create your own Java™ Script Library and include it in your LotusScript® application using LS2J.
        Invoking a method in a Java™ object
        There are two ways to invoke a method in a Java™ object.
        Error handling with LS2J
        While using LS2J, LotusScript® returns error messages when things go wrong. However, these messages may be misunderstood without additional accurate information.
        LS2J limitations
        There are a few limitations with LS2J:
      - LS2J classes
        LS2J introduces the concept of a Java™ object reference. Similar to an OLE object reference, it is not a predefined class; rather, it represents a runtime instance of a Java object. Its properties and methods are determined at run time.
      - Data type mappings
        LotusScript® provides mapping for Java™ basic data types and Java reference types.
      - LS2J extended example
        This sample code demonstrates calling Java™ methods within LotusScript® using LS2J. Immediately following this example the code is modified slightly to demonstrate handling situations where there is a syntax discrepancy between Java and LotusScript.
  - LotusScript® Language Reference
    This chapter describes the use of statements, built-in functions, subs, data types, and directives in the LotusScript® language.
  - Language and Script Limits
    This appendix describes LotusScript® language limits of several kinds: for example, the legal ranges in data representation, the limits on numerical specifications within statements, and the maximum number of different kinds of elements that can be defined in a script.
  - Platform Differences
    The LotusScript® language and functionality on the UNIX™ platform, the Macintosh platform, and the OS/400® platform differ in various ways from the language and functionality described in the rest of this language reference. This appendix describes the differences.
  - LotusScript/REXX Integration
    This appendix provides an overview of REXX integration in the LotusScript® language.
  - LotusScript® Aliases
    This appendix lists the LotusScript® aliases and their equivalent text.
  - MIME Charset Names
  - Compile-time Error Messages
    This chapter describes the compile-time error messages in the LotusScript® language.
  - Run-time Error Messages
    This chapter describes the run-time error messages in the LotusScript® language.
- LotusScript/COM/OLE Classes
- Java/CORBA Classes
  This section documents the Java/CORBA classes.
- Lotus® Connectors
  Lotus® Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
- Javadoc™ for Domino® Designer related APIs
  As part of providing additional Java™ reference documentation, Domino® Designer ships with a help plugin that contains Javadoc™ for additional Domino Designer related APIs.

Using LS2J

To use LS2J from within Notes®, your LotusScript® code must include this line:

Uselsx "*javacon"

This loads the LS2J Dynamic Link Library (DLL) on Win32 and registers all the Application Data Types (ADTs). LotusScript® provides a JavaSession ADT to be used as an instance to connect with the JVM.

This statement:

Set mySession = New JavaSession

creates a new Java™ session. If the JVM has not been started, one is created at this time.

It is up to the LotusScript® client to load the LSX. The environment determines how the Java™ Virtual Machine (JVM) is set up and the limits on how LotusScript® can access the Java™ data.

LotusScript® locates the Java™ class files in two ways:

In the Script Libraries that the user specified through the USE statement.
On the file system as specified in the Notes®.ini variables JavaUserClasses and JavaUserClassesExt.

The value of JavaUserClasses is a semicolon-separated list of specifications, which can refer to JAR files, ZIP files, or CLASS file folders. For example;

JavaUserClasses = c:\LSI\test\java;c:\javautils\jdbcdrivers.jar; ... ;<specification_n>

The JavaUserClasses value string is limited to 255 characters. If you have a longer string, use JavaUserClassesExt. JavaUserClassesExt takes a comma-separated list of tags, each of which is set to a specification. For example:

JavaUserClassesExt = jdbc,string 
jdbc=c:\javautils\jdbcdrivers.jar 
string=c:\javautils\stringlib.jar

In the Notes® environment, LotusScript® locates Java™ classes and uses them as if they were LotusScript® objects. For example, if you have a set of common classes that are written in Java™, you may use those classes in LotusScript® without modification.