attrlist(1m) Open Software Foundation attrlist(1m)
NAME [Toc] [Back]
attrlist - A dcecp task object that manipulates attribute lists
SYNOPSIS [Toc] [Back]
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 [Toc] [Back]
attrlist A 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}
operation The name of the attrlist operation for which to display help
information.
DESCRIPTION [Toc] [Back]
The attrlist task 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.
OPERATIONS [Toc] [Back]
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.
Hewlett-Packard Company - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
attrlist(1m) Open Software Foundation attrlist(1m)
Privileges Required [Toc] [Back]
No special privileges are needed to use the attrlist add command.
Examples [Toc] [Back]
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 [Toc] [Back]
No special privileges are needed to use the attrlist getvalues
command.
Examples [Toc] [Back]
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>
Hewlett-Packard Company - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
attrlist(1m) Open Software Foundation attrlist(1m)
attrlist help
Returns help information about the attrlist task object and its
operations. The syntax is as follows:
attrlist help [operation | -verbose]
Options [Toc] [Back]
-verbose Displays information about the attrlist task 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 task object itself.
Privileges Required [Toc] [Back]
No special privileges are needed to use the attrlist help command.
Examples [Toc] [Back]
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 [Toc] [Back]
No special privileges are needed to use the attrlist list command.
Hewlett-Packard Company - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
attrlist(1m) Open Software Foundation attrlist(1m)
Examples [Toc] [Back]
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 the input
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 [Toc] [Back]
No special privileges are needed to use the attrlist modify command.
Examples [Toc] [Back]
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 task
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.
Hewlett-Packard Company - 4 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
attrlist(1m) Open Software Foundation attrlist(1m)
Privileges Required [Toc] [Back]
No special privileges are needed to use the attrlist operations
command.
Examples [Toc] [Back]
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 [Toc] [Back]
No special privileges are needed to use the attrlist remove command.
Examples [Toc] [Back]
dcecp> attrlist remove {{a b} {c d} {e f} {g h}} -member {e g}
{a b} {c d}
dcecp>
RELATED INFORMATION [Toc] [Back]
Commands: dcecp(1m).
Hewlett-Packard Company - 5 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96 [ Back ] |
