object(1m)object(1m)NAMEobject - A dcecp object that manages an object in CDS
SYNOPSISobject 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
Examples of objects are remote procedure call (RPC) server entries,
group entries, profile entries, and so on. The 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
Specifies the class to which an object belongs. Specifies the creation
timestamp of the CDS object. The value is a read-only DTS-style time‐
stamp, which is set by the system. Contains the version number of the
object's class, which allows applications to build in compatibility
with entries created by earlier versions. Specifies the unique identi‐
fier of the object. The read-only identifier is set by the system at
creation time. 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.
OPERATIONSobject create
Creates a new object entry in CDS. The syntax is as follows: object
create object_name_list [-attribute attribute_list [-single]]
Options
Allows you to specify attributes by using an attribute list. See
ATTRIBUTES for more information about object attributes. Specifies
that attributes are single-valued.
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 multi-valued unless the -single option is speci‐
fied, in which case all attributes are single-valued. The -single
option is valid only if the -attribute option is specified. This oper‐
ation 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: 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 suc‐
cess.
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
Displays 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 sum‐
mary 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
Adds one or more new attributes to an object entry. May be used with
the -add option to specify that attributes to be added are single-val‐
ued. 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 all its values, use the -types
option along 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. May be used with the -remove option to remove the
attribute type as well as its values. Invalid without the -remove
option. 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 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 oper‐
ation 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 the object
entry named /.:/Q1_records, follow these steps: 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 Enter the following command to assign the value region2 to the
attribute sales_record of the 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
Indicates whether an attribute is single or multi-valued. Note 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 spec‐
ified 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 con‐
catenated 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.
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).
object(1m)