Commands Reference, Volume 1

chrsrc Command

Purpose

Changes the persistent attribute values of a resource or resource class.

Syntax

To change the persistent attribute values of a resource or resource class (-c flag), using data entered on the command line:

chrsrc [-h] -s "Selection_string" [-v] [-T] [-V] Resource_class Attr=value...

chrsrc [-h] -r [-v] [-T] [-V] Resource_handle Attr=value...

chrsrc [-h] -c [-v] [-T] [-V] Resource_class Attr=value...

To change the persistent attribute values of a resource or resource class (-c flag), using data predefined in an input file:

chrsrc [-h] -f Resource_data_input_file -s "Selection_string" [-v] [-T] [-V] Resource_class

chrsrc [-h] -f Resource_data_input_file -r [-v] [-T] [-V] Resource_handle

chrsrc [-h] -f Resource_data_input_file -c [-v] [-T] [-V] Resource_class

Description

The chrsrc command changes the persistent attribute values for a resource or resource class.

By default, this command changes the resource persistent attributes. If you wish to change the resource class persistent attributes, specify the -c flag.

Only persistent attributes that do not have a "Read Only" property can be changed. The underlying resource manager that controls the specified resource determines which attributes can be changed by using this command.

Use the -v flag to verify that the attribute names specified by the command line or resource data input file are valid persistent attributes for the specified resource and that these attributes do not have a property of "Read Only". When chrsrc is run with the -v flag, the specified attributes are not changed.

After the chrsrc command is run without the -v flag, if any specified attribute could not be changed, it is noted in an error message. If a particular attribute passes when the chrsrc -v command is run, this does not ensure that the attribute can be changed. The underlying resource manager controls which attributes can be changed.

To change the persistent attributes for a resource, use the -r flag to change just the resource linked with the specified Resource_handle, or use the -s flag to change all the resources that match the specified "Selection_string".

Parameters

Attr=value: Enter one or more attribute value pairs. If the -f flag is specified, Attr=value pair parameters should not be entered on the command line. Attr is any defined persistent attribute name. Use the lsrsrcdef command to get a list of the defined persistent attributes and their data types for the specified resource. The value entered must be the appropriate data type for the specified attribute. For example, if NodeNumber is defined as a uint32 data type, enter a positive numeric value.
Resource_class: A resource class name. Enter the lsrsrcdef command for a list of defined resource class names.
Resource_handle: The specific resource handle that is linked with the resource that you wish to change. Use the lsrsrc command to obtain valid resource handles. The resource handle must be enclosed within double quotation marks. An example is: "0x4017 0x0001 0x00000000 0x0069684c 0x0d4715b0 0xe9635f69".

Flags

-c

Changes the resource class persistent attribute values. By default, the resource persistent attributes are changed. Use this flag if you want to change the resource class persistent attributes.

-f Resource_data_input_file

Specifies the name of the file which contains resource attribute information.

-h

Writes the command's usage statement to standard output.

-r

Changes the specific resource that matches the specified Resource_handle.

-s "Selection_string"

Specifies a selection string. All selection strings must be enclosed within either double or single quotation marks. If the selection string contains double quotation marks, enclose the entire selection string in single quotation marks. For example:

-s 'Name == "testing"'

-s 'Name ?= "test*"'

Only persistent attributes may be listed in a selection string. For information on how to specify selection strings, see "Using Expressions" in the chapter "Using the Monitoring Application" of the RSCT 2.2 Resource Monitoring and Control Guide and Reference.

-T

Writes the command's trace messages to standard error. For your software-service organization's use only.

-v

Verifies that all of the specified attributes are valid persistent attribute names that do not have a Read Only property. The chrsrc command cannot verify that all of the attributes specified on the command line or in the input file can be changed. The underlying resource manager that controls the specified resource determines which attributes can be changed. After this command is run (without the -v flag), any attribute name that could not be changed is included in an error message.

-V

Writes the command's verbose messages to standard output.

Exit Status

0: Command has run successfully.
1: Error occurred with RMC.
2: Error occurred with CLI script.
3: Incorrect flag on command line.
4: Incorrect parameter on command line.
5: Error occurred with RMC that was based on faulty command line input.

Security

This command requires root authority.

Examples

To change the Int32, Uint32 and SD persistent resource attributes in resource class IBM.Foo for the resources that have a Name equal to c175n05, type:
```
chrsrc -s 'Name == "c175n05"' IBM.Foo \
Int32=-9999 Uint32=9999\
SD='["testing 1 2 3",1,{2,4,6}]'
```
To change the Int32, Uint32, SD persistent resource attributes in resource class IBM.Foo for the resource that has a Name starting with c175n, using the resource data input file with the following contents:
```
PersistentResourceAttributes::
resource 1: 
     Int32  = -9999
     Uint32 = 9999
     SD     = ["testing 1 2 3",1,{2,4,6}]
```
type:
```
chrsrc -f /tmp/IBM.Foo.chrsrc\
 -s 'Name ?= "c175n"'  IBM.Foo
```
To change the Name persistent resource attribute for the resource that has a resource handle equal to "0x0001 0x4005 0x35ae868c 0x00000000 0xfeef2948 0x0d80b827", type:
```
chrsrc -r "0x0001 0x4005 0x35ae868c 0x00000000 0xfeef2948 0x0d80b827" Name="c175n05"
    
```

Files

/usr/sbin/rsct/bin/chrsrc

Location of the chrsrc command.

Related Information

The lsrsrc, lsrsrcdef, mkrsrc, rmrsrc commands.

The rmccli General Information file.

The RSCT 2.2 Resource Monitoring and Control Guide and Reference contains more information regarding RMC operations and information on how to use expressions and selection strings.