link modify

link modify link_name_list -add attribute_list | -remove attribute_list | -change attribute_list

Options

-add attribute_list
Adds one or more new attributes to a soft link or adds values to existing attributes when values are not already present. Add an attribute type with no value by specifying an attribute type with no value.

-remove attribute_list
Removes an entire attribute or merely some attribute values from a soft link. The value of this option is an attribute list. If only the attribute type is specified, after the option, then the entire attribute is removed. If an attribute type and value are specified, then only that value is removed. If an attribute or value is not present, an error is returned.

-change attribute_list
Changes one attribute value to another for a soft link. The value of this option is an attribute list. Each attribute in the list has its existing value replaced by the new value given in the attribute list. 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.

Description
The link modify operation can be used to change two attributes of a soft link: CDS_LinkTarget and CDS_LinkTimeout. The argument is a list of names of soft links to be operated on. The operation takes the -add, -remove, and -change options to specify an attribute list to describe the changes. All the changes are performed on each soft link named in the argument. This operation returns an empty string on success.

Privileges Required
You must have w (write) permission to the link object.

Examples
The following example sets the link expiration time to 1995 and the extension time to ten days and zero hours.

dcecp> link modify /.:/depts/emergency -change {
> {CDS_LinkTimeout
> {expiration 1995}
> {extension +10-0:0:0}}}
dcecp>