Index of /pub/mirrors/ftp.novell.com/forge/ucs

 Name                               Last modified      Size  Description
 Parent Directory                                        -   
 CHANGELOG.html                     28-Feb-2005 02:13  5.9K  
 DEPENDENCIES.html                  18-Feb-2005 19:18  1.5K  
 DOCUMENTATION.html                 24-Jan-2005 00:00  132   
 LICENSE.txt                        02-Dec-2004 00:00   11K  
 README.html                        02-Dec-2004 00:00   18K  
 SAMPLECODE.html                    24-Jan-2005 00:00  132   
 builds/                            27-Aug-2008 02:05    -   

Universal Component System

1.0 Introduction

Universal Component System^® (UCS) helps in developing applications using any scripting language on NetWare^® and any component on the network.

This package contains UCS, the UCX Provider, the Java* Provider, and the Remote ActiveX Provider. Apart from this, it also bundles the Java Extension for UCS and the entire set of UCX components. The extensions for Perl 5.8 for NetWare and Novell^® Script for NetWare (NSN) are available in the packages of the respective languages.

2.0 Configuration

2.1 Testing Your Setup

2.1.1 Accessing UCX Components From Perl

Enter the following command at the server console, to run the DSBROWSE.PL script:

PERL DSBROWSE.PL

This script would list the objects under the root context.

NOTE:  NSN does not use UCS to access UCX components because the UCX components are native to NSN.

2.1.2 Accessing Java From Perl

Run HASH.PL. It should generate the following output:

3.142

Apples

true

2.1.3 Accessing Remote ActiveX Controls From Perl

Run the script calendar.pl, after making changes as mentioned in the sample code. It should display the date and time of the Windows machine.

2.1.4 Accessing Java From NSN

1. Enter the following command at the server console:

   NSNINIT

2. Enter the following command, to invoke the NSN Shell:

   NSNSHELL

3. Enter the following command at the server console to execute the script hash.bas

   hash

2.1.5 Accessing Remote ActiveX Controls From NSN

Run the script calendar.bas, after making changes as mentioned in the sample code. It should display the date and time of the Windows machine.

2.1.6 Accessing UCX Components From Java

Set CWD environment variable to sys:\java\samples\ucs then, enter the following command at the server console to execute dsbrowse.class.

JAVA -NS DSBROWSE

After providing appropriate input (username and password), you should be able to view the list of objects in the default context.

2.2 Java Configuration

For accessing Java classes or JavaBeans* from scripting languages, you must have the Bean (JAR) files in the sys:\java\beans directory and also setup the path for ucs.jar and the Beans in the CLASSPATH variable. The latter is also required for accessing UCS from Java. You could use a NetWare batch file, like the supplied ucs.ncf, to set the CLASSPATH variable.

NOTE:  The setup required for Beans for Novell Services is outside the scope of UCS. Please refer to the corresponding readme or documentation and perform the setup before attempting to use them through UCS.

2.3 Remote ActiveX Provider Setup

The HTTP Listener (ucs2win.exe), that is, the Windows* portion of the Remote ActiveX Provider, is installed in the sys:\public\win32 directory. You need to run it on a Windows (9x/NT) machine. When a script on the server side uses the Remote ActiveX Provider (ucs2rmt.nlm), it communicates with the HTTP Listener to access ActiveX Controls residing on the Windows machine.

The HTTP Listener runs by default on port 80. You could change it in case you are running your Web server on the same port.

3.0 Developing to UCS from C++ and Java

The UCS SDK for C++ is available in the form of header and import files under the sys:\ucs\sdk directory. The UCS Library for Java is packaged in ucs.jar which is available under the sys:\java\lib directory.

Some of the documented interfaces and functions are subject to modification in the future.

4.0 Documentation

4.1 Viewable and Downloadable Documentation

The documentation for UCS can be downloaded or viewed at the NDK documentation site.

We've enabled Start menu documentation entries. After installing the documentation, use the NDK Documents entry on your Start menu to quickly locate and access NDK documentation.

To read or print the documentation, you need Adobe Acrobat Reader 4.0 or later. For a free download, see the Adobe site.

4.2 News Groups

The following news groups are available for discussions.

• News server
• Group: novell.devsup.ucs

5.0 What's New

5.1 Binary String Support

From this release binary strings are supported and hence, Octet String attributes can be used from Perl and PHP.

6.0 Known Defects and Issues

• NSN and Perl scripts using UCS2UCX and UCS2 Perl extensions will not get executed from the server console. These scripts can be executed from the browser.

• UCS2Java (Java* Provider)

  • In UCS2Java provider, complex data types like Date and Array are not fully supported.
  • When the script executes, the control will go to the Java GUI screen if the DISPLAY environment variable is set to the default value (127.0.0.1:0). For the control to go to the Console screen, set the value to 127.0.0.1:1 by entering the following command at the console:

    ENVSET DISPLAY=127.0.0.1:1

  • AWT-based JavaBeans* might cause the script to hang while exiting. This is due to a problem in JNI, which does not allow the VM to unload if threads are still running.
  • Final variables in classes (equivalent to constants) are not currently supported.
  • Java objects cannot be instantiated using constructors with parameters. Only the constructor with no parameters will be called.

• UCS2RMT/UCS2WIN (Remote ActiveX Provider)

  • If some ActiveX Controls are not compliant to the standard, it might cause some problems.

• Java2UCS (Java Extensions)

  • Due to recently incorporated security features in many of the UCX components, many of them will not be fully usable from Java programs using Java2UCS. A solution will be available in the near future.

7.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

All files provided in this release are subject to the Novell Developer License Agreement , which can be found in the license.txt file provided in this download.

Copyright © 2003-2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell is a registered trademark of Novell, Inc. in the United States and other countries.

NetWare is a registered trademark of Novell, Inc. in the United States and other countries.

Universal Component System is a registered trademark of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners.