VMLINK Linking Behaviors
These tables show how VMLINK will behave in linking and accessing minidisks depending on the status of the minidisk when the VMLINK command is issued.
| No link to the disk | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Link in Read mode and access | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Link at vdev in Read mode and access | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and link this disk at that vdev Read mode and access disk | Same result with RR or READ |
| VMLINK with specified file mode range | Link in Read mode and access in range | Same result with RR or READ |
| VMLINK with specified single file mode | Link in Read mode and access at mode. This will release whatever was at that file mode | Same result with RR or READ |
| VMLINK <DET> | No R/O to detach message | Same result with RR or READ |
| VMLINK <REL> | No action | Same result with RR or READ |
| VMLINK with (WRITE option | Link in Write mode and access | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Link at vdev in Write mode and access | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and link this disk at that vdev Write mode and access disk | Same result with M |
| VMLINK with specified file mode range and (WRITE option | Link in Write mode and access in range | Same result with M |
| VMLINK with specified single file mode and (WRITE option | Link in Write mode and access at mode. This will release whatever was at that file mode | Same result with M |
| VMLINK <DET> | No R/W to detach message | Same result with M |
| VMLINK <REL> | No action | Same result with M |
| Already linked in READ (not accessed) | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Keep existing Link and access disk | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Detach existing link, link at requested vdev and access disk | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done, unless vdev requested is where it is already linked | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev and access disk | Same result with RR or READ |
| VMLINK with specified file mode range | Keep existing link and access in range | Same result with RR or READ |
| VMLINK with specified single file mode | Keep existing link and access at mode. This will release whatever was at that file mode | Same result with RR or READ |
| VMLINK <DET> | Detach current disk | Same result with RR or READ |
| VMLINK <REL> | No action | Same result with RR or READ |
| VMLINK with (WRITE option | Link in Write mode and access. Leaves Read link as is | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Link at vdev in Write mode and access. Leaves Read link as is | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and link this disk at that vdev Write mode and access disk. Leaves Read link as is. | Same result with M, unless vdev of Read link is the one forced |
| VMLINK with specified file mode range and (WRITE option | Link in Write mode and access in range. Leaves Read link as is | Same result with M, unless vdev of Read link is the one forced |
| VMLINK with specified single file mode and (WRITE option | Link in Write mode and access at mode. This will release whatever was at that file mode. Leaves Read link as is. | Same result with M, unless vdev of Read link is the one forced |
| VMLINK <DET> | No R/W to detach message | Same result with M, unless vdev of Read link is the one forced |
| VMLINK <REL> | No action | Same result with M, unless vdev of Read link is the one forced |
| Already linked in READ (accessed too) | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Keep existing Link and existing access | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Detach existing link, link at requested vdev and access disk | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done, unless vdev requested is where it is already linked | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev and access disk | Same result with RR or READ |
| VMLINK with specified file mode range | Keep existing link and existing access if in range, otherwise reaccess disk in range | Same result with RR or READ |
| VMLINK with specified single file mode | Keep existing link and access at mode. This will release whatever was at that file mode | Same result with RR or READ |
| VMLINK <DET> | Detach current disk | Same result with RR or READ |
| VMLINK <REL> | Release disk but keep link | Same result with RR or READ |
| VMLINK with (WRITE option | Link in Write mode and access. Leaves Read link as is | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Link at vdev in Write mode and access. Leaves Read link as is | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and link this disk at that vdev Write mode and access disk. Leaves Read link as is | Same result with M, unless vdev of Read link is the one forced |
| VMLINK with specified file mode range and (WRITE option | Link in Write mode and access in range. Leaves Read link as is | Same result with M, unless vdev of Read link is the one forced |
| VMLINK with specified single file mode and (WRITE option | Link in Write mode and access at mode. This will release whatever was at that file mode. Leaves Read link as is. | Same result with M, unless vdev of Read link is the one forced |
| VMLINK <DET> | No R/W to detach message | Same result with M, unless vdev of Read link is the one forced |
| VMLINK <REL> | No action | Same result with M, unless vdev of Read link is the one forced |
| Already linked in WRITE (not accessed) | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Link in Read mode and access. Leaves Write link as is | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Link at vdev in Read mode and access. Leaves Write link as is | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and link this disk at that vdev Read mode and access disk. Leaves Write link as is. | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified file mode range | Link in Read mode and access in range. Leaves Write link as is | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified single file mode | Link in Read mode and access at mode. This will release whatever was at that file mode. Leaves Write link as is. | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <DET> | No R/O to detach message | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <REL> | No action | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with (WRITE option | Keep existing Write Link and access disk | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Detach existing link, link at requested vdev in Write mode and access disk | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done, unless vdev requested is where it is already linked | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev in Write mode and access disk | Same result with M |
| VMLINK with specified file mode range and (WRITE option | Keep existing link and access in range | Same result with M |
| VMLINK with specified single file mode and (WRITE option | Keep existing link and access at mode. This will release whatever was at that file mode | Same result with M |
| VMLINK <DET> | Detach current disk | Same result with M |
| VMLINK <REL> | No action | Same result with M |
| Already linked in WRITE (accessed too) | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Link in Read mode and access. Leaves Write link as is | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Link at vdev in Read mode and access. Leaves Write link as is | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and link this disk at that vdev Read mode and access disk. Leaves Write link as is. | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified file mode range | Link in Read mode and access in range. Leaves Write link as is | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified single file mode | Link in Read mode and access at mode. This will release whatever was at that file mode. Leaves Write link as is. | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <DET> | No R/O to detach message | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <REL> | No action | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with (WRITE option | Keep existing Write Link and existing access | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Detach existing link, link at requested vdev in Write mode and access disk | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done, unless vdev requested is where it is already linked | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev in Write mode and access disk | Same result with M |
| VMLINK with specified file mode range and (WRITE option | Keep existing link and existing access if in range, otherwise reaccess disk in range | Same result with M |
| VMLINK with specified single file mode and (WRITE option | Keep existing link and access at mode. This will release whatever was at that file mode | Same result with M |
| VMLINK <DET> | Detach current disk | Same result with M |
| VMLINK <REL> | Release disk but keep link | Same result with M |
| Already linked multiple times (both Read and Write) | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Use one of the already existing Read links and access. Detaches all other Read links. Leaves Write links as is. | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Link at vdev in Read mode and access. Detaches all other Read links. Leaves Write links as is | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done. Unless vdev requested is where a Read link already is. | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev. Link disk at requested vdev and access disk. Detach all other Read links. Leaves Write links as is. | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified file mode range | Use existing Read link and access in range. Detach all other Read links. Leaves Write links as is | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with specified single file mode | Use existing Read link and access at mode. This releases whatever was a that mode. Detach all other Read links. Leaves Write links as is | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <DET> | Detaches all Read links | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK <REL> | Releases any access Read links | Same result with RR or READ, unless vdev of Write link is the one forced |
| VMLINK with (WRITE option | Use existing Write Link and access the disk. Detach all other Write links. Leave Read links as is. | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Link is Write mode at vdev requested and access disk. Detach all other Write links. Leaves Read links as is. | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done, unless vdev requested is where it is already linked in either Read/Write mode. | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev in Write mode and access disk Detach all other Write links. Leaves Read links as is. | Same result with M, unless vdev of Write link is the one forced |
| VMLINK with specified file mode range and (WRITE option | Keep existing link and existing access if in range, otherwise reaccess disk in range. Detach all other Write links. Leaves Read links as is. | Same result with M, unless vdev of Write link is the one forced |
| VMLINK with specified single file mode and (WRITE option | Keep existing link and access at mode. This will release whatever was at that file mode Detach all other Write links. Leaves Read links as is. | Same result with M, unless vdev of Write link is the one forced |
| VMLINK <DET> | Detaches all Write links | Same result with M, unless vdev of Write link is the one forced |
| VMLINK <REL> | Releases any accessed Write links | Same result with M, unless vdev of Write link is the one forced |
| Already linked but directory has moved | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Link in Read mode and access | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Link at vdev in Read mode and access. | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done. | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev. Link disk at requested vdev Read mode and access disk. | Same result with RR or READ |
| VMLINK with specified file mode range | Link in Read mode access in range. | Same result with RR or READ |
| VMLINK with specified single file mode | Link in Read mode and access at mode. This releases whatever was at that mode. | Same result with RR or READ |
| VMLINK <DET> | No R/O link to detach | Same result with RR or READ |
| VMLINK <REL> | No action | Same result with RR or READ |
| VMLINK with (WRITE option | Link in Write mode and access | Same result with M |
| VMLINK with vdev specified (a free one) and (WRITE option | Link at vdev in Write mode and access | Same result with M |
| VMLINK with vdev specified (one in use) and (WRITE option | Error message, no link done | Same result with M |
| VMLINK with vdev specified (one in use) with FORCE and WRITE options | Detach current disk at vdev and link this disk at that vdev Write mode and access disk | Same result with M |
| VMLINK with specified file mode range and (WRITE option | Link in Write mode and access in range | Same result with M |
| VMLINK with specified single file mode and (WRITE option | Link in Write mode and access at mode. This will release whatever was at that file mode | Same result with M |
| VMLINK <DET> | No R/W to detach message | Same result with M |
| VMLINK <REL> | No action | Same result with M |
| Already linked but no longer have authority to it | Action | Notes |
|---|---|---|
| VMLINK with no options or linking details | Keep existing Link and access disk | Same result with RR or READ |
| VMLINK with vdev specified (a free one) | Detach existing link, link at requested vdev FAILS because no longer have authority. Old link is now gone. | Same result with RR or READ |
| VMLINK with vdev specified (one in use) | Error message, no link done, unless vdev requested is where it is already linked | Same result with RR or READ |
| VMLINK with vdev specified (one in use) with FORCE option | Detach current disk at vdev and detach current link to disk. Link disk at requested vdev FAILS because no longer have authority. | Same result with RR or READ |
| VMLINK with specified file mode range | Keep existing link and access in range | Same result with RR or READ |
| VMLINK with specified single file mode | Keep existing link and access at mode. This will release whatever was at that file mode | Same result with RR or READ |
| VMLINK <DET> | Detach current disk | Same result with RR or READ |
| VMLINK <REL> | Release disk if accessed otherwise no action | Same result with RR or READ |