NAME

attrlist  — A dcecp object that manipulates attribute lists

SYNOPSIS

attrlist add attrlist member attrlist

attrlist getvalues attrlist type typename

attrlist help  [operation|verbose]

attrlist list attrlist

attrlist modify attrlist  [add attribute_type attribute_values][change attribute_type attribute_values] [remove attribute_type attribute_values]

attrlist operations

attrlist remove attrlist member attrlist

Arguments

attrlistA list of one or more dcecp  elements.  An attrlist can be a single character, but usually consists of at least one attribute type and its value, as shown in the following:

{CDS_Convergence medium}

operationThe name of the attrlist  operation for which to display help information. 

Description

The attrlist  object represents an attribute list as returned or accepted by many dcecp  commands.  Use this object to check or manipulate attribute lists so that they can be used by other commands, most commonly in scripts. 

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

attrlist add

Appends one attribute list to another.  The syntax is as follows:

attrlist add attrlist member  attrlist

The add operation returns an attribute list with the attributes specified as the value of the required member  option appended. 

Privileges Required

No special privileges are needed to use the attrlist add  command. 

Examples

dcecp> attrlist add {{a b} {c d}} -member {{e f} {g h}}
{a b} {c d} {e f} {g h}
dcecp>

attrlist getvalues

Returns the values of the attributes named in an attribute list.  The syntax is as follows:

attrlist getvalues attrlist type  typename

The getvalues operation returns the values of all attributes that are both named in the attribute list and of the type specified by the required type  option.  The value can be a single type, but if the attribute appears more than once in the attribute list, the value of each instance is returned on a separate line. 

Privileges Required

No special privileges are needed to use the attrlist getvalues command. 

Examples

dcecp> attrlist getvalues {{a w x} {c y} {a z}] -type a
{w x}
z
dcecp>

This command can be used to filter the output of show  operations.  For example:

dcecp> attrlist getvalues [dir show /.:/hosts] -type CDS_UTS
1994-07-01-10:29:59.265-05:00I0.000/00-00-c0-f7-de-56
dcecp>

With abbreviations, the above command could be entered as follows:

dcecp> at g [dir show /.:/hosts] -t CDS_UTS
1994-07-01-10:29:59.265-05:00I0.000/00-00-c0-f7-de-56
dcecp>

attrlist help

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

attrlist help [operation | verbose ]

Options

verboseDisplays information about the attrlist  object. 

Used without an argument or option, the attrlist help  command returns brief information about each attrlist  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 attrlist  object itself. 

Privileges Required

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

Examples

dcecp> attrlist help
add                 Adds attributes to a list.
getvalues           Returns the values of specified attributes.
list                Returns the attribute types present in a list.
modify              Modifies an attribute list.
remove              Removes attributes from a list.
help                Prints a summary of command-line options.
operations          Returns a list of the valid operations for this command.
dcecp>

attrlist list

Returns a list of attribute type names from an attribute list.  The syntax is as follows:

attrlist list attrlist

The list  operation returns a list of all the attribute type names in the attribute list in the order that they appear in the list. 

Privileges Required

No special privileges are needed to use the attrlist list  command. 

Examples

dcecp> attrlist list {{a b} {c d}}
a c
dcecp>

attrlist modify

Removes and changes attributes and their values in an attribute list.  The syntax is as follows:

attrlist modify attrlist
{[add  attribute_type attribute_values]
 [change  attribute_type attribute_values]
 [remove  attribute_type attribute_values]}

The modify operation returns an attribute list with attributes modified as specified by the add , remove  and change  options.  New attributes can be added, or new values added to existing attributes with add .  Entire attributes or attribute values can be removed with remove .  The change  option removes all values from an existing attribute and replaces them with new values specified. 

Privileges Required

No special privileges are needed to use the attrlist modify  command. 

Examples

dcecp> attrlist modify {{a b} {c d}} -add {{c e}}
{a b} {c d e}
dcecp>
dcecp> attrlist modify {{a b} {c d e}} -remove {{c e}} {a b} {c d}
dcecp>
dcecp> attrlist modify {{a b} {c d e}} -change {{c f}}
{a b} {c f}
dcecp>

attrlist operations

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

attrlist 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 attrlist operations command. 

Examples

dcecp> attrlist operations
add getvalues list modify remove help operations
dcecp>

attrlist remove

Removes attributes and their values from an attribute list.  The syntax is as follows:

attrlist remove attrlist member  attrlist

The remove operation returns an attribute list after removing attribute types (and their values) specified as an argument to the required member  option. 

This command removes entire attributes only; to remove specific values, use the attrlist modify  command. 

Privileges Required

No special privileges are needed to use the attrlist remove command. 

Examples

dcecp> attrlist remove {{a b} {c d} {e f} {g h}} -member {e g}
{a b} {c d}
dcecp>

Related Information

Commands: dcecp(8dce)