1.3 Bindery Objects

All bindery objects must be assigned the following information:

1.3.1 Object ID

The objectID parameter is a 4-byte number uniquely identifying the object within a particular server bindery and is not recognized by other servers. The NetWare OS (not the application) assigns this number.

1.3.2 Object Type

The objectType parameter is a 2-byte number classifying the object. Do not swap the following values since they are defined the way they are expected by various functions:

Table 1-1 Standard Object Types

C

Pascal

Name

0xFFFF

$FFFF

OT_WILD

0x0000

$0000

OT_UNKNOWN

0x0100

$0100

OT_USER

0x0200

$0200

OT_USER_GROUP

0x0300

$0300

OT_PRINT_QUEUE

0x0400

$0400

OT_FILE_SERVER

0x0500

$0500

OT_JOB_SERVER

0x0600

$0600

OT_GATEWAY

0x0700

$0700

OT_PRINT_SERVER

0x0800

$0800

OT_ARCHIVE_QUEUE

0x0900

$0900

OT_ARCHIVE_SERVER

0x0A00

$0A00

OT_JOB_QUEUE

0x0B00

$0B00

OT_ADMINISTRATION

0x2100

$2100

OT_NAS_SNA_GATEWAY

0x2600

$2600

OT_REMOTE_BRIDGE_SERVER

0x2700

$2700

OT_TCPIP_GATEWAY

1.3.3 Object Name

The objectName parameter is a 48-byte string (including a NULL terminator) containing the name of the object. The name consists of only printable characters and cannot include spaces or any of the following characters:

IMPORTANT:Object names are recorded in uppercase in the bindery.

1.3.4 Object Flags

The objectFlags parameter is a single-byte flag specifying whether the object is static:

A static object exists in a bindery until an application intentionally deletes it. A dynamic object disappears from a server bindery when the server is rebooted.

Objects placed in the bindery by SAP are dynamic. The server closely monitors such objects. The service provider must advertise periodically or the server deletes the object.

1.3.5 Object Security

The object security parameter is a single-byte flag that determines object access. The low-order nibble determines who can read (scan for and find) the object. The high-order nibble determines who can write to the object (add or delete properties). The table below shows the values defined for each nibble.

Table 1-2 Bindery Object Security Levels

Bit

Security Level

Description

0x00

BS_ANY_READ

Anyone can read the object, even users who aren’t logged in.

0x01

BS_LOGGED_READ

Only clients logged in to the server can read the object.

0x02

BS_OBJECT_READ

Only clients logged in to the server with this object’s name, type, and password can read the object.

0x03

BS_SUPER_READ

Only clients with supervisor equivalence can read the object.

0x04

BS_BINDERY_READ

Only the NetWare operating system can read the object.

0x00

BS_ANY_WRITE

Anyone can modify the object, even users who aren’t logged in.

0x10

BS_LOGGED_WRITE

Only clients logged in to the server can modify the object.

0x20

BS_OBJECT_WRITE

Only clients logged in to the server with this object’s name, type, and password can modify the object.

0x30

BS_SUPER_WRITE

Only clients with supervisor equivalence can modify the object.

0x40

BS_BINDERY_WRITE

Only the NetWare operating system can modify the object.

1.3.6 Has-Properties Flag

The hasPropertiesFlag parameter is a single-byte flag indicating whether any properties are associated with the object: