Change Device Desc (ASP) (CHGDEVASP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Device Description (ASP) (CHGDEVASP) command changes the device description for an auxiliary storage pool (ASP) device.
More information about independent disk pools, see the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DEVD | Device description | Name | Required, Key, Positional 1 |
| RSRCNAME | Resource name | Name, *SAME | Optional |
| RDB | Relational database | Name, *SAME, *GEN | Optional |
| MSGQ | Message queue | Single values: *SAME, *SYSOPR Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
Device description (DEVD)
Specifies the name of the device description.
This is a required parameter.
| Top |
Resource name (RSRCNAME)
Specifies the resource name that identifies the auxiliary storage pool (ASP) by which a collection of disks is known.
- *SAME
- The value does not change.
- resource-name
- Specify the name that identifies the ASP by which a collection of disks is known.
| Top |
Relational database (RDB)
Specifies the relational database (RDB) name to associate with the auxiliary storage pool (ASP) device.
- *SAME
- The value does not change.
- *GEN
- The RDB name will be generated by the operating system after a successful vary on of the device. If the device is the primary ASP of an ASP group, the RDB name will be the same as the device name. If the ASP device is a secondary ASP, or a user-defined file system (UDFS) ASP, the RDB name will be set to blanks.
- relational-database-name
- Specify the RDB name to associate with the ASP device. The specified RDB name will not be used if the ASP device description is a secondary ASP or UDFS ASP. If the ASP device description is the primary ASP of an ASP group, when the ASP group is varied on, the specified RDB name will become the name by which the relational database is known on this system and other systems which connect to this system.
| Top |
Message queue (MSGQ)
Specifies the message queue to which operational messages for this device are sent.
The possible qualified names are:
- *SAME
- The value does not change.
- *SYSOPR
- Messages are sent to the QSYSOPR message queue in QSYS.
- message-queue-name
- Specify the name of the message queue to which operational messages are sent.
Qualifier 2: Library
- *LIBL
- All libraries in the job's library list are searched until the first match is found.
- *CURLIB
- The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
- library-name
- Specify the name of the library to be searched.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
- *SAME
- The text (if any) does not change.
- *BLANK
- No text is specified.
- character-value
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Examples
CHGDEVASP DEVD(WAREHOUSE) RSRCNAME(WAREHOUSE2)
This command changes the device description to an ASP resource that is known as WAREHOUSE2.
| Top |
| Top |