object(1m)																object(1m)

NAME

       object - A dcecp object that manages an object in 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

       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
       timestamp, which is set by the system.  Contains the version number of the object's class, which allows applications to build  in  compati-
       bility  with  entries  created by earlier versions.  Specifies the unique identifier 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.

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

       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 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: 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

       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 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

       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-
       valued.	 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
       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  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 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.

       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)