






                Get Property v1.4 for Novell Netware 3.x.


              By K.F.Soft, Denmark, Copyright October 1994.







Usage of this program is free. The program may not be sold. It can be 
distributed in the original ZIP-file at no charge.
GetProp is distributed as is, without any express or implied warranty.
Portions of GetProp Copyright (C) 1983-1990 Novell Inc. All rights reserved.

If you decide to use this program please send me a little note with the 
following information:
  Type of organization.
  Number of servers.
  Number of users.
  Number of workstations.
Thanks in advance!

Comments, bugs and suggestions to kf@mmf.ruc.dk
                            Purpose

Gets the content of Netware bindery properties into DOS environment 
variables. Should only be used with string properties (names etc.).


                            Syntax

GETPROP options objectname propertyname[(ix)] [var]
GETPROP options [servername/]objectname:propertyname[(ix)] [var]
GETPROP options [servername/]objectname !OI [var]
GETPROP options [servername/]objectname !ON [var]

Options
/Q    Quiet mode. Nothing will be displayed.

/O:x  Object type. Both object type numbers and abbreviations can
      be used for the x parameter. See below for the possible values. 
      If no object type is given, user type is assumed.

servername   if the object is on another server than the current one 
             the server parameter can be used to select the server.

objectname   is the name of the object owning the property. 
             A - refers to the currently logged in object.
             Instead of the object name you can use the object ID in
             hex notation preceding it with \x, ie. \x68000003

propertyName is the name of the property to be read
             A number ix inside () after the propertyname indicates that 
             the property is a string array. ix is the number of the 
             string referred to. A string array can consist of up to 20 
             strings with a total length of 980 bytes (including zero's).
             !ON as propertyname tells SetProperty to read the objects 
             name to an environment variable.
             !OI as propertyname tells SetProperty to read the objects 
             ID to an environment variable.

The value of the property will be written to an environment variable 
with the same name as the propertyname (or OID or ONAME) or to a
variable with the name var if this parameter is given.

The different object types are :
  No Abbreviation  Description
   1 us            User
   2 ug            User group
   3 pq            Print queue
   5 js            Job Server
   6 gw            Gateway
   7 ps            Print server
   8 aq            Archive queue
   9 as            Archive server
  10 jq            Job queue
  11 ad            Administration

                            Examples

GETPROP /o:ug EVERYONE IDENTIFICATION
        Stores the full name (IDENTIFICATION) for group (OT=2) EVERYONE 
        to the environment variable IDENTIFICATION.

GETPROP - M
        Stores an environment variable M with the value of the property 
        m for the current logged in user.

GETPROP S1/MIKE:MAIL_OPTIONS(1)
        Stores the Charon & Mercury forward address for user MIKE
        on server S1 in the environment variable MAIL_OPTIONS.

GETPROP S2/- !OI USER_ID
        Stores the Object ID for the current user on server S2 in the
        variable OID.

GETPROP \x68000003 !ON ONAME
        Stores the object name of the object with bindery ID 68000003h
        in the variable ONAME.
