Help: Complete UCS API documentation

[Dave Bank]

I'm in a NetWare v6.5 environment and I'm trying to write a Perl program
to make some minor changes to over 1500 user IDs.

I have the eDirectory NDK reference, I've identified the Attributes I need
to alter and how their Values are stored.

I have followed the available example code snippets, and have constructed
a Perl script that successfully logs into eDirectory, can find an
arbitrary object in an arbitrary context, and read arbitrary values from
the object. I have also enumerated the Fields of object Layouts. So far,
so good.

The Problem

I have been unable to find a *comprehensive* listing of all the object
methods available thru Perl2UCS, or documentation as to their calling
parameters and possible return values. The sample bits and pieces to be
found here on Novell Forge are just that - bits and pieces. There is no
cohesive and comprehensive documentation of the UCS API (at least non I
have been able to find).

To make my frustration clear, one code example (from the February 2001
AppNotes) shows creating a Filter object to search eDirectory using, in
part, the methods Dir->{"Filter"} and Filter->AddExpression. One step
involves setting the search scope, and gives a possible value of
"SEARCH_SUBTREE". However, I can find no documentation spelling out what
the other possible values of the Filter Scope are, or how they operate.
This is just one example.

Can anyone point me to a *comprehensive* set of documentation for the UCS
API that spells out its objects, methods and calling parameters?

[Guenter Knauf, DevNet SysOp 32]

Hi David,

Post by Dave Bank
Can anyone point me to a *comprehensive* set of documentation for the UCS
API that spells out its objects, methods and calling parameters?

the problem is that historically Novell Nscript and UCS/UCX where one thing;
only later they made the UCS/UCX components available to other languages...
so take a look here:
http://developer.novell.com/ndk/doc/nscript/index.html
look into NSN part1/2 and you find all components listed there...
the way to use them from Perl you have figured out already, so it shouldnt be
a problem for you to 'translate' to Perl...
also I have some old samples on my site:
http://www.gknw.at/nwperl/perlucx/

HTH, Guenter.

[Dave Bank]

Post by Guenter Knauf, DevNet SysOp 32

Post by Dave Bank
Can anyone point me to a *comprehensive* set of documentation for the UCS
API that spells out its objects, methods and calling parameters?

the problem is that historically Novell Nscript and UCS/UCX where one thing;
only later they made the UCS/UCX components available to other languages...
http://developer.novell.com/ndk/doc/nscript/index.html
look into NSN part1/2 and you find all components listed there...
the way to use them from Perl you have figured out already, so it shouldnt be
a problem for you to 'translate' to Perl...
http://www.gknw.at/nwperl/perlucx/

Guenter,

Thanks for replying. Yes, this is helpful. I see why I've been unable to
find anything - it doesn't exist. That's quite annoying. At the very
least, the Developer's Perl pages should clearly refer readers to the NSN
documentation.

Looking at the first link you provide, the 2nd half of the NSN docs seem
to have what I want. In specific, the NWDir object information is probably
what I need. At first glance, I think its enuf to answer my question.

I appreciate the second link - I hope to glean some ideas. Mostly, tho, I
needed comprehensive documentation.

Any ideas on who @ Novell to contact and bug about the lack of Perl API
docs?