Configure Device ASP (CFGDEVASP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Configure Device ASP (CFGDEVASP) command is used to create or delete an independent auxiliary storage pool (ASP). It is also used to prepare a partition to accept disk units which represent independent ASPs from other partitions.
The independent ASP provides the ability to group disk units together that can then be taken off-line or brought on-line independent of the system ASP.
This command when used with the *CREATE action will do the following:
- Create the independent ASP using the specified non-configured disk units.
- Create an ASP device description by the same name if one does not already exist.
This command will initiate the configuration and then display the progress status of the configuration. The configuration status may also be viewed using the Display ASP Status (DSPASPSTS) CL command.
This command when used with the *DELETE action will do the following:
- Delete the independent ASP.
- Delete the ASP device description if it was created by this command.
This command when used with the *PREPARE action will do the following:
- Modify the disk configuration for the partition to remove all previous independent ASP configurations.
- Prepare the partition to accept disk units which represent an independent ASP.
This step must be performed and the partition must be IPLed before the disk units which represent an independent ASP are assigned to this partition from another location.
Restrictions:
- You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
- You must have service (*SERVICE) special authority, or must be authorized to the Service Disk Units function of the IBM i operating system through IBM i Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_QYAS_SERVICE_DISKMGMT may also be used to change the list of users who are allowed to work with disk units.
- A maximum of 300 disk units may be entered in the UNITS field. This restriction does not apply when using the special value *SELECT. Additional disk units may be added to the ASP at a later time using the Work with disk units option in System Service Tools (SST) or Dedicated Service Tools (DST).
- The *PREPARE option can only be used if there are no independent ASPs in existence on the partition. If independent ASPs exist on the partition, they must be deleted (with the *DELETE option) prior to using the *PREPARE option.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ASPDEV | ASP device | Name, *ALL | Required, Positional 1 |
| ACTION | Action | *CREATE, *DELETE, *PREPARE | Required, Positional 2 |
| TYPE | ASP type | *PRIMARY, *SECONDARY, *UDFS | Optional, Positional 3 |
| PRIASPDEV | Primary ASP device | Name | Optional, Positional 4 |
| PROTECT | Protection | *NO, *YES | Optional |
| ENCRYPT | Encryption | *NO, *YES | Optional |
| UNITS | Disk units | Single values: *SELECT Other values (up to 300 repetitions): Simple name |
Optional |
| CONFIRM | Confirm | *YES, *NO | Optional |
| Top |
ASP device (ASPDEV)
Specifies the name of the independent ASP which will be created or deleted.
This is a required parameter.
- name
- Specify the name of the independent ASP to create or delete.
- *ALL
- Indicates that the action will be performed for all independent ASPs in the partition. When the Action parameter has a value of *PREPARE, the ASPDEV parameter must be *ALL. When the Action parameter is *CREATE or *DELETE, ASPDEV(*ALL) is not allowed.
| Top |
Action (ACTION)
Specifies the desired action to be taken for the independent ASP.
This is a required parameter.
- *CREATE
- The independent ASP will be created.
- *DELETE
- The independent ASP will be deleted.
- *PREPARE
- The disk configuration for the partition will be modified to remove all previous independent ASP configurations. The partition is therefore prepared to accept disk units which represent an independent ASP. This step must be performed and the partition must be IPLed before the disk units which represent an independent ASP are assigned to this partition from another location.
| Top |
ASP type (TYPE)
Specifies the type of independent ASP which will be created.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *PRIMARY
- A primary ASP will be created. A primary ASP may contain directories and libraries and may have secondary ASPs associated with it. A primary ASP defines a new database name space.
- *SECONDARY
- A secondary ASP will be created. A secondary ASP must be associated with an existing primary ASP with which it shares the database name space.
- *UDFS
- A user-defined ASP will be created. A user-defined file system ASP may only contain user-defined file systems.
| Top |
Primary ASP device (PRIASPDEV)
Specifies the name of the primary ASP that the secondary ASP will be associated. This parameter is only valid when the TYPE parameter is set to *SECONDARY.
- name
- Specify the name of the primary ASP.
| Top |
Protection (PROTECT)
Specifies whether or not you plan to protect the data in the independent ASP. If *NO is selected, all eligible non-configured disk units are available for selection. If *YES is selected, only disk units available to be mirrored or disk units currently parity protected are available for selection.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *NO
- Disk unit selection will not be limited to disk units capable of mirroring and parity protected units. All eligible disk units will be available for selection.
- *YES
- Disk unit selection will be limited to disk units capable of mirroring and disk units that are parity protected.
| Top |
Encryption (ENCRYPT)
Specifies whether or not the independent ASP will be encrypted. Disk encryption may also be enabled or disabled at a later time. If this independent ASP will be used in a clustered environment, you must set the master key manually on each system within the device domain.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *NO
- Disk encryption will not be enabled for the independent ASP.
- *YES
- Disk encryption will be enabled for the independent ASP.
| Top |
Disk units (UNITS)
Specifies the disk units to be used to create the independent ASP. A maximum of 300 disk units may be entered in the UNITS field. This restriction does not apply when using the special value *SELECT. Additional disk units may be added to the ASP at a later time using the Work with disk units option in System Service Tools (SST) or Dedicated Service Tools (DST).
This parameter is only required when the ACTION parameter is set to *CREATE.
- *SELECT
- The user will be prompted to select from a list of non-configured disk units. This special value is not allowed when run in batch mode.
- name
- Specify the ten character disk unit identifier.
| Top |
Confirm (CONFIRM)
Specifies whether the request should be confirmed before the independent ASP is deleted.
This parameter is only used when the ACTION parameter is set to *DELETE or *PREPARE.
- *YES
- A confirmation panel is displayed when the command is issued in an interactive job. An inquiry message is sent to QSYSOPR when the command is issued in an non-interactive job.
- *NO
- No confirmation is done prior to performing the requested action.
| Top |
Examples
Example 1: Creating an Independent Auxiliary Storage Pool
CFGDEVASP ASPDEV(IASP001) ACTION(*CREATE) UNITS(DD005 DD006)
This command will create a new Independent Auxiliary Storage Pool named IASP001 containing two disk units, DD005 and DD006. The type will be Primary, unless a type other than the default is specified.
Example 2: Creating a Secondary Independent Auxiliary Storage Pool
CFGDEVASP ASPDEV(IASP002) ACTION(*CREATE) TYPE(*SECONDARY)
PRIASPDEV(IASP001) UNITS(DD007 DD008)
This command will create a new Secondary Independent Auxiliary Storage Pool named IASP002. This ASP contains two disk units DD007 and DD008 and has a primary IASP of IASP001.
Example 3: Deleting an Indepenent Auxiliary Storage Pool.
CFGDEVASP ASPDEV(IASP001) ACTION(*DELETE)
This command will delete the Independent ASP named IASP001. If the corresponding device description was created by CFGDEVASP then the device description will also be deleted if it still exists.
Example 4: Preparing the system for an Independent ASP to be assigned to it
CFGDEVASP ASPDEV(*ALL) ACTION(*PREPARE)
This command will prepare the partition to remove all previous Independent ASP configurations. The partition is therefore prepared to accept disk units which represent an Independent ASP. This command must be run and the partition must be IPLed before the disk units which represent an Independent ASP are assigned to this partition from another location.
| Top |
Error messages
*ESCAPE Messages
- CPF222E
- &1 special authority is required.
- CPFAF0B
- Device &1 was not found
- CPDAC40
- *SELECT is valid only in interactive mode.
- CPFBA58
- A disk management operation session is currently in use.
- CPF0F04
- Operation canceled by user.
- CPF9899
- Error occurred during processing of command.
*DIAG Messages
- CPDB8E5
- PRIASPDEV parameter only valid when TYPE is *SECONDARY.
- CPDB8E6
- PRIASPDEV parameter cannot have the same value as ASPDEV.
- CPDB8E7
- PRIASPDEV is required when TYPE is *SECONDARY.
| Top |