Configure Geographic Mirror (CFGGEOMIR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Configure Geographic Mirror (CFGGEOMIR) command when used with the *CREATE action will perform the configuration steps necessary to take an existing standalone independent auxiliary storage pool (ASP) and create a geographic mirror copy.
If specified, upon successfully creating of a mirror copy, ASP copy descriptions will be created if they do not already exist and an ASP session will be started.
If geographic mirroring is already configured and additional sites exist in the cluster resource group recovery domain, this command will create an additional mirror copy of the independent ASP.
This command will initiate the configuration and then display the progress status of the configuration. The status of the configuration process may also be viewed using the Display ASP Status (DSPASPSTS) command on the mirror copy node.
When this command is called with the *DELETE action, if an ASP session is started, the session will be suspended, then ended, the copy description for the ASP copy being deleted will also be deleted.
Restrictions:
- You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
- You must have (*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, also can be used to change the list of users who are allowed to work with disk units.
- An independent auxiliary storage pool must already exist.
- The node owning the independent auxiliary storage pool must be in a cluster device domain.
- The node owning the independent auxiliary storage pool must be in the recovery domain of a device cluster resource group.
- The auxiliary storage pool must be a configuration object in the device cluster resource group.
- The intended owner of the mirror copy must also exist in the cluster device domain and the recovery domain of the cluster resource group.
- The intended production and mirror nodes must be defined with different sites in the device cluster resource group.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ASPDEV | ASP device | Name | Required, Positional 1 |
| ACTION | Action | *CREATE, *DELETE | Required, Positional 2 |
| SRCSITE | Source site | Name, * | Optional |
| TGTSITE | Target site | Name, * | Optional |
| SSN | Session | Single values: *NONE Other values: Qualified job name |
Optional |
| Qualifier 1: Session | Name | ||
| Qualifier 2: Source ASP copy description | Name | ||
| Qualifier 3: Target ASP copy description | Name | ||
| DELIVERY | Transmission delivery | *SYNC, *ASYNC | Optional |
| UNITS | Disk units | Single values: *SELECT Other values (up to 300 repetitions): Simple name |
Optional |
| CONFIRM | Confirm | *YES, *NO | Optional |
| CLUSTER | Cluster | Name, * | Optional |
| CRG | Cluster resource group | Name, * | Optional |
| MODE | Mirroring mode | *SYNC, *ASYNC | Optional |
| PRIORITY | Synchronization priority | *HIGH, *MEDIUM, *LOW | Optional |
| SSPTIMO | Suspend timeout | 60-3600, 120 | Optional |
| TRACKSPACE | Tracking space | 0-100, 100 | Optional |
| Top |
ASP device (ASPDEV)
Specifies the name of the existing independent ASP.
This is a required parameter.
- name
- Specify the name of the existing independent ASP.
| Top |
Action (ACTION)
Specifies the desired action to be taken on the independent ASP.
This is a required parameter.
- *CREATE
- A mirror copy of the independent ASP will be created.
- *DELETE
- The mirror copy of the independent ASP will be deleted.
| Top |
Source site (SRCSITE)
Specifies the name of the cluster resource group site that identifies the source of the mirror copy.
- *
- If only two sites exist in the cluster resource group recovery domain, this special value will indicate the named site of the primary node.
If more than two named sites exist in the cluster resource group recovery domain, the command will fail indicating the user is required to specify a named site.
- name
- Specify the site name within the cluster resource group of the node that owns the source ASP copy.
| Top |
Target site (TGTSITE)
Specifies the name of the cluster resource group site that identifies where action will be performed.
- *
- If only two sites exist in the cluster resource group recovery domain, this special value will indicate the named site that is different than the site where the primary node is defined.
If more than two named sites exist in the cluster resource group recovery domain, the command will fail indicating the user is required to specify a named site.
- name
- Specify the site name within the cluster resource group where the action is to be performed.
| Top |
Session (SSN)
Specifies the name of the session to be started after the mirror copy of the ASP is created.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *NONE
- If this special value is selected, a session will not be started as a result of running this command. A session can be started at a later time using the Start ASP Session (STRASPSSN) command.
- name
- Specify the name for the ASP session.
Element 1: Source ASP copy description
Specify the name of the source ASP copy description to be used to start the session. This parameter can be specified even if *NONE is specified for the session name. In either case, the copy description will be created if it does not already exist for the the ASP device. If an ASP copy description does already exist for the ASP device by a different name, another copy description will not be created.
- name
- Specify the name of the source ASP copy description.
Element 2: Target ASP copy description
Specify the name of the target ASP copy description to be used to start the session. This parameter can be specified even if *NONE is specified for the session name. In either case, the copy description will be created if it does not already exist for the the ASP device. If an ASP copy description does already exist for the ASP device by a different name, another copy description will not be created.
- name
- Specify the name of the target ASP copy description.
| Top |
Transmission delivery (DELIVERY)
Specifies the type of delivery to the mirror system. This parameter refers to the type of communication to the mirror system. This parameter can be changed at a later time using the Change ASP Session (CHGASPSSN) command.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *SYNC
- The mirroring uses synchronous communication between the production and mirror copy systems. This delivery method is best for low latency environments.
- *ASYNC
- The mirroring uses asynchronous communication between the production and mirror copy systems. This delivery method is best for high latency environments and will consume more system resources on the production copy node than *SYNC delivery.
| Top |
Disk units (UNITS)
Specifies the disk units to be used to create the mirror copy of the independent ASP. Disk units can be entered manually, or if *SELECT is specified, the user will be prompted to select from a list of non-configured disk units. The total capacity of the mirror copy needs to be 95% or greater of the production copy.
This parameter is only used 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.
| Top |
Confirm (CONFIRM)
Specifies whether the request should be confirmed before the mirror copy is deleted.
This parameter is only used when the ACTION parameter is set to *DELETE.
- *YES
- A confirmation panel is displayed when the CFGGEOMIR command is issued in an interactive job. An inquiry message is sent to QSYSOPR when the CFGGEOMIR command is issued in an non-interactive job.
- *NO
- There is no confirmation before the mirror copy is deleted.
| Top |
Cluster (CLUSTER)
Specifies the cluster in which the geographic mirror is to be configured.
- *
- The cluster that has previously been configured on this system is used.
- name
- Specify the name of the cluster in which the geographic mirror is to be configured.
| Top |
Cluster resource group (CRG)
Specifies the cluster resource group in which the ASP device is configured.
- *
- The cluster resource group that has the specified ASP device configured will be used.
If the ASP device is not a unique name in the cluster and the name of the cluster resource group cannot be determined with a matter of certainty, the command will fail indicating a named cluster resource group is required.
- name
- Specify the name of the cluster resource group in which the ASP device is configured.
| Top |
Mirroring mode (MODE)
Specifies the mirroring mode for the mirror system. This parameter refers to the way the data is written to the target system after it arrives. This parameter can be changed at a later time using the Change ASP Session (CHGASPSSN) command.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *SYNC
- The mirroring uses synchronous writes to save the data to disk on the mirror copy. Synchronous mode is the only mode that allows the mirror copy to be upgraded to a production copy and used after a crash of the mirror copy node. This mode is best for most environments.
- *ASYNC
- The mirroring uses asynchronous writes to save the data to disk on the mirror copy. This mode is best for environments where the mirror copy node is significantly slower than the production copy node.
| Top |
Synchronization priority (PRIORITY)
Specifies the geographic mirroring synchronization priority. This parameter designates the priority at which the synchronization process occurs. Using a higher priority may impact system runtime performance depending on your system configuration. Using a higher priority assumes that returning the mirror to a synchronized state takes priority over runtime performance. This parameter can be changed at a later time using the Change ASP Session (CHGASPSSN) command.
This parameter is only used when the ACTION parameter is set to *CREATE.
- *HIGH
- Use high priority. This priority completes synchronization as quickly as possible, but consumes the most resources.
- *MEDIUM
- Use medium priority. This priority provides a balance between resource usage and time to synchronization completion.
- *LOW
- Use low priority. This priority uses the fewest resources, but synchronization will take longer to complete.
| Top |
Suspend timeout (SSPTIMO)
Specifies the number of seconds to wait for a response before suspending the mirror due to a lack of response.
For example, if communication is interrupted due to a network outage, when delivery is set to *SYNC, this is the length of time that the system will suspend writes to the production and mirror copy before suspending the mirror and continue writes to the production copy.
In the same example, if delivery was set to *ASYNC, this value would indicate the length of time that the system will suspend writes to the mirror copy before suspending the mirror. In this example, the production will not be waiting for the writes to continue, however during this timeout period the mirror copy writes will be buffered on the production side which may cause performance degradation.
This parameter can be changed at a later time using the Change ASP Session (CHGASPSSN) command.
This parameter is only used when the ACTION parameter is set to *CREATE.
- 120
- The suspend timeout value will be set to 120 seconds.
- 60-3600
- Specify the number of seconds to wait before suspending.
| Top |
Tracking space (TRACKSPACE)
Specifies the percent of the maximum assignable tracking space to use. The maximum assignable tracking space is one percent of the total space within an independent auxiliary storage pool. For example, a 100 gigabyte independent auxiliary storage pool has a maximum tracking space of 1 gigabyte. A value of 5 for this parameter, when the total size of the independent auxiliary storage pool is 100 gigabytes, would reserve approximately 50 megabytes for tracking changes.
The amount of tracking space used does not equal the amount of changed data. Only the address of the changed memory is tracked. If the tracking space becomes exhausted, changes will no longer be tracked and a full synchronization will be required to return the mirror to a synchronized status.
This parameter is only used when the ACTION parameter is set to *CREATE.
- 100
- The amount of tracking space will be set to 100 percent of the allowed value. This means one percent of the independent ASP will be reserved for tracking changes.
- 0-100
- Specify the percent of the maximum assignable tracking space to reserve for tracking changes.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- CPF0F04
- Operation canceled by user.
- CPF9814
- Device &1 not found.
- CPF9825
- Not authorized to device &1.
- CPF9899
- Error occurred during processing of command.
- CPFBB02
- Cluster &1 does not exist.
- CPFBB0A
- Cluster node &1 in cluster &2 not active.
- CPFBB0F
- Cluster resource group &1 does not exist in cluster &2.
- CPFBB26
- Cluster Resource Services not active or not responding.
- CPFBB2E
- Job submission failed for cluster resource group &1 in cluster &2.
- HAE002B
- &1 command failed.
- HAE2028
- Unable to complete the geographic mirroring configuration request.
- HAE2029
- Unable to complete the geographic mirroring configuration request.
| Top |