NAME

object  — A dcecp object that manages an object in the DCE Cell Directory Service (CDS)

SYNOPSIS

object create object_name_list  [attribute attribute_list  [single ] ]

object delete object_name_list

object help  [operation | verbose  ]

object modify object_name_list  {add attribute_list | single  | remove attribute_list | types  | change attribute_list }

object operations

object show object_name_list  [schema ]

Arguments

object_name_list
Examples of objects are remote procedure call (RPC) server entries, group entries, profile entries, and so on.

operationThe name of the object  operation for which you want to see help information. 

Description

An object  object represents an entity in CDS that has a name and attributes.  An object identifies a resource such as a host system, a printer, an application, or a file.  Attributes consist of a type and one or more values.  Every object is the child of a CDS directory. 

Attributes

CDS_Class
Specifies the class to which an object belongs.

CDS_CTS
Specifies the creation timestamp of the CDS object. The value is a read-only DTS-style timestamp, which is set by the system.

CDS_ClassVersion
Contains the version number of the object’s class, which allows applications to build in compatibility with entries created by earlier versions.

CDS_ObjectUUID
Specifies the unique identifier of the object. The read-only identifier is set by the system at creation time.

CDS_UTS
Specifies the timestamp of the most recent update to an attribute of the object. The value is a read-only DTS-style timestamp, which is set by the system.

See the OSF DCE Administration Guide for more information about object attributes. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Operations

object create

Creates a new object entry in CDS.  The syntax is as follows:

object create object_name_list [attribute  attribute_list [single ]]

Options

attribute  attribute_list
Allows you to specify attributes by using an attribute list. See Attributes for more information about object attributes. 

singleSpecifies that attribute values are single-valued.  Otherwise, attributes are multivalued.  Valid only with the attribute  option. 

The create  operation creates a new object entry in CDS.  This task is usually done through a client application.  The required object_name_list argument is a list of the full CDS names of the object entries to be created. 

Optionally, you can use the attribute  option to associate one or more attributes (see Attributes) with each object being created.  The attribute values are multivalued unless the single  option is specified, in which case all attributes are single-valued.  The single  option is valid only if the attribute  option is specified.  This operation returns an empty string on success. 

Privileges Required

You must have i (insert) permission to the parent directory. 

Examples

The following command creates an object entry named /.:/sales/east/floor1cp.  The object entry describes a color printer on the first floor of a company’s eastern sales office. 

dcecp> object create /.:/sales/east/floor1cp -attribute \
> {{CDS_Class printer} {CDS_ClassVersion 1.0}}
dcecp>  

object delete

Removes an object entry from CDS.  The syntax is as follows:

object delete object_name_list

The delete  operation removes an object entry from CDS.  The required object_name_list argument is a list of the full CDS names of the object entries to be deleted. This operation returns an empty string on success. 

Privileges Required

You must have d (delete ) permission to the object entry or A (Admin) permission to the directory that stores the object entry. 

Examples

The following command deletes the object entry /.:/sales/east/floor1pr2:

dcecp> object delete /.:/sales/east/floor1pr2
dcecp> 

object help

Returns help information about the object  object and its operations.  The syntax is as follows:

object help [operation | verbose ]

Options

verboseDisplays information about the object  object. 

Used without an argument or option, the object help  command returns brief information about each object  operation.  The optional operation argument is the name of an operation about which you want detailed information.  Alternatively, you can use the verbose  option for more detailed information about the object  object itself. 

Privileges Required

No special privileges are needed to use the object help command. 

Examples

dcecp> object help
create              Creates the named object.
delete              Deletes the named object.
modify              Adds, removes or changes an attribute in the named object.
show                Returns the attributes of an object.
help                Prints a summary of command-line options.
operations          Returns a list of the valid operations for this command.
dcecp> 

object modify

Adds or removes attributes or changes attribute values for object entries in CDS.  The syntax is as follows:

object modify object_name_list
{add  attribute_list [single ] |
remove  attribute_list [types ] |
change  attribute_list}

Options

add  attribute_list
Adds one or more new attributes to an object entry.

singleMay be used with the add  option to specify that attributes to be added are single-valued. 

remove  attribute_list
Eliminates one or more attribute values from an attribute type of an object entry.  For instance, removing a value from an attribute with three values leaves the attribute with two values.  The argument is an attribute list of the following form:

{{attribute value}...{attribute value}}  

To remove an attribute type as well as its values, use the types  option with the remove  option. 

If an attribute is not present, an error is returned.  Fixed CDS attribute types, such as the CDS creation timestamp (CDS_CTS), cannot be removed. 

typesMay be used with the remove  option to remove the attribute type as well as its values.  Invalid without the remove  option. 

change  attribute_list
Changes one attribute value to another for an object entry. The existing value of each attribute in attribute_list is replaced by the new value given.  For multivalued attributes, all existing values are replaced by all the values listed for the attribute in the attribute list.  If an attribute or value is not present, an error is returned. 

The modify operation adds or removes attributes, or changes attribute values for object entries in CDS.  This task is usually done through a client application.  The required object_name_list argument is a list of the full CDS names of the object entries to be modified.  This operation returns an empty string on success. 

Privileges Required

You must have w (write) permission to the object entry. 

Examples

To add the sales_record attribute with a value of region2 to an object entry named /.:/Q1_records, follow these steps:

   1.Read the cds_attributes  file to check that the attribute sales_record is listed, as shown in the following display:

    OID         LABEL           SYNTAX
1.3.22.1.3.66   sales_record    char 

   2.Enter the following command to assign the value region2 to the attribute sales_record of an object entry named /.:/Q1_records. 

dcecp> object modify /.:/Q1_records -add {sales_record region2}
dcecp>

To remove the RPC_CLASS and RPC_CLASS_VERSION attributes:

dcecp> object modify /.:/foo -remove {RPC_CLASS RPC_CLASS_VERSION} -types
dcecp> 

object operations

Returns a list of the operations supported by the object object.  The syntax is as follows:

object operations

The list of available operations is in alphabetical order except for help  and operations, which are listed last. 

Privileges Required

No special privileges are needed to use the object operations command. 

Examples

dcecp> object operations
create delete modify show help operations
dcecp> 

object show

Returns attribute information associated with specified object entries.  The syntax is as follows:

object show object_name_list [schema ]

Options

schemaIndicates whether an attribute is single or multivalued.  Note that the same attribute can be single-valued on one object and multivalued on another object. 

The show  operation displays attribute information associated with specified object entries.  The required object_name_list argument is a list of the full CDS names of the object entries to be examined.  If more than one object is shown, the attributes of all the objects are concatenated into one list.  The order of the returned attributes is the lexical order of the object identifiers (OIDs) of each attribute for each object. 

The schema  option indicates whether an attribute is single-valued or multivalued. 

Privileges Required

You must have r (read) permission to the object entry.     If you specify a wildcard object entry name, you also need r (read) permission to the directory that stores the object entry. 

Examples

dcecp> object show /.:/obj
{RPC_ClassVersion
 {0200}
 {0300}}
{RPC_Group 1234}
{CDS_CTS 1994-07-01-22:06:54.990-05:00I0.000/00-00-c0-f7-de-56}
{CDS_UTS 1994-07-01-22:07:37.248-05:00I0.000/00-00-c0-f7-de-56}
{CDS_Class 0200}
dcecp>  

dcecp> object show /.:/obj -schema
{RPC_ClassVersion multi}
{RPC_Group multi}
{CDS_CTS single}
{CDS_UTS single}
{CDS_Class single}
dcecp> 

Related Information

Commands: dcecp(8dce), clearinghouse(8dce), directory(8dce), link(8dce),