bpxwmigf - Migrate HFS or zFS file systems to zFS

Format

bpxwmigf -query [sourcefs] [-filter active|success|failed]

bpxwmigf -cancel sourcefs

Description

Use the bpxwmigf command to migrate file systems to zFS. Superuser authority is required.

Options

-filter

Filters query results. The -filter option is ignored for a query for a specific migration.

active: Filters for currently active migrations. The results include migrations that are queued, mirroring, mirror complete, swapping, and swap defer.
failed: Filters for failed and canceled migrations.
success: Filters for successful migrations.

-mode rw|ro|asis

The final mount mode for the target zFS file system.

rw: The zFS file system is mounted read/write.
ro: The zFS file system is mounted read-only.
asis: The file system is mounted as is. It is the default.

-parm|-noparm

Specifies the mount parameter options for the target zFS file system. If you do not specify either -parm or -noparm, the mount parameter for the source file system is used if the source is a zFS file system. If the source mount parameter is changed dynamically during migration, the mount parameter for the target file system will not be affected.

-parm

The mount parameter for the target zFS file system after the migration is completed. End of change

-noparm

Clears the mount parameter for the target zFS file system. Following are examples of when you might want to use this option:

You have previously set -parm but then realize that you no longer want a zFS parameter for this particular mount.
If you prefer to specify all command parameters without allowing defaults, you can specify -noparm if you do not want a mount parameter.

-priority priority

Specifies the migration priority 1 - 9 where 1 is the highest priority and 9 is the lowest. To slow down the migration, specify a higher number. Using a higher number reduces the impact to applications that access the migrating file systems or to extend the migration resource over a longer period.

Default: 2

-source source

Where source is the name of the file system to be migrated. End of change

-srename newname|-norename

Specifies whether to rename the source file system to newname.

-srename newname: Renames the source file system to newname.
-nosrename: Does not rename the source file system to newname. It is the default.

-status minutes

Specifies the status update interval during the wait.

-swap|-noswap

Specifies the swap options.

-swap: Performs the swap as soon as the file systems are synchronized.
-noswap: Maintains the file systems in synchronization but the file systems are not swapped until a request with -swap is made. It is the default.

-target target

Where target is the target zFS file system. End of change

-trename|-notrename

Specifies whether to rename the target zFS file system.

-trename: The target zFS file system is renamed after the swap to the source name. -srename must be specified or be already in effect.
-notrename: The target zFS file system is not renamed after the swap.

-trename newtname

The target zFS file system is renamed to newtname after the swap.

-wait minutes

The migration command does not end until the specified number of minutes has elapsed or when the migration completes.

Usage notes

The target zFS file system must be allocated and formatted as a version 5 zFS file system, and not mounted.
The target zFS must be empty before migration can begin. If the target zFS is being reused, it must be reformatted before migration can begin.
To make sure that the proper file system is mounted after a system restart, ensure that the mount statements or mount policies are current after the swap.
Ensure that the mount statements or mount policies will not mount the new file system after a system restart if the migration is canceled.
If the command is canceled or aborted and the migration processing has begun, the migration continues.
The -query option provides information that indicates percent complete, based on the ratio of byte sizes of the target and source.
The migration must be started from the z/OS UNIX-owning system.
If the source file system of the migration is HFS, all systems in the shared file system environment must be at least the z/OS V2R3 level. Otherwise, all systems in the shared file system environment must be at least the z/OS V2R4 level.
Only one mirror at a time can be in progress.
Only one HFS to zFS migration at a time can be performed.
Any number of zFS to zFS migrations can be in mirror-complete state.
The percentage number for the mirroring progress is meaningful only when both the source file system and target system are not compressed.
The File Creation Time is not preserved.
Swapping mounts does not affect child file systems. That is, you can swap out the currently mounted zFS file system with a new zFS file system even though there are mount points within the target file system.

Examples

To start a migration, issue the following command:

bpxwmigf -source omvs.a1234.hfs -target omvs.xyz.zfs -wait 10

After a migration is started, you can override the swap parameters or trigger the swap after a migration is complete but is still unswapped by issuing the following command:
```
bpxwmigf -source omvs.a1234.hfs -mode ro -swap
```
To cancel a current migration, issue the following command:
```
bpxwmigf -cancel OMVS.1234.HFS
```
To query the progress of all current migrations, issue the following command:
```
bpxwmigf -query
```
To wait for status on a migration in progress, issue the following command:
```
bpxwmigf -source omvs.a1234.hfs -wait 10
```

Localization

bpxwmigf uses the following localization environment variables:

LANG
LC_ALL
LC_COLLATE
LC_CTYPE
LC_MESSAGES
NLSPATH

Exit values

0: No errors.
1: Wait completed with noswap.
2: Wait time expired.
3: Wait exit due to canceled or failed migration.
7: Usage error; see the error message.
8: Usage error; see message.
9: Query failed; see message.
12: Cannot access z/OS UNIX.

Messages

Most diagnostics deal with argument syntax and are self-explanatory. For example:

Badly constructed output list at list: Indicates that the list for a -o option did not have the proper syntax.

Portability

An approved POSIX standard does not exist for bpxwmigf.

Related information

None.