object(1m)
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_ClassSpecifies the class to which an object belongs.
CDS_CTSSpecifies 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. This 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_UTSSpecifies 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.
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 multi-valued. 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 \\*C
> {{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] Option
-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. Each attribute in attribute_list has its existing value replaced by the new value given. For multi-valued 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 multi-valued. This is specific to an object, meaning that the same attribute can be single-valued on one object and multi-valued 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 multi-valued. 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(1m), dcecp_clearinghouse(1m), dcecp_directory(1m), dcecp_link(1m),
Hewlett-Packard Company — OSF DCE 1.1/HP DCE 1.5