Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

MOVE-DISK

&pagelevel(3)&pagelevel

Initializes disks, moves disks from and to pubsets

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Anwendungsbereich:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS                                                                                                         

Function

The MOVE-DISK command provides the following functions for systems support:

  • Reducing a pubset by a single volume, including clearing the volume.

  • Expanding a pubset by a new volume, including automatic adaptation of the pubset-specific volume attributes (with/without PAMKEY, transfer unit (TU), alloaction unit (AU)).

  • Moving a single volume from one pubset to another pubset.

  • Initializing/formatting and clearing a single disk (by using VOLIN and SPACEOPT implicitely).

The command can be used on single-feature pubsets (SF pubsets) and on system-managed pubsets (SM pubsets). The respective pubsets must be imported and the relevant volumes must be attached to the system.

Notes on command processing

  • If necessary, internal processing uses commands that require the privilege SUBSYSTEM-MANAGEMENT and USER-ADMINISTRATION.
  • To clear a volume, the subsystem SPACEOPT is started, if necessary. This assumes that SPACEOPT and the necessary privileges are available.
  • To check the pubset homogeneity (CHECK-PUBSET-MIRROR=*YES) the subsystems POSIX and SHC-OSD are started, if necessary. This assumes that POSIX/SHC-OSD and the necessary privileges are available.
Shared pubset mode:

The command is also supported for shared pubsets, but it can only be entered on the master system. This applies to both, the volume-giving and the volume-receiving pubset.

The command is rejected when entered on a slave system.

Pubset extension with homogeneity check:

The homogeneity check for a pubset to be extended is performed by specifying the operand CHECK-PUBSET-MIRRORS=*YES. This check is performed for the currently supported full replication types (for detailed information, please refer to the "SHC-OSD" manual [37]). Further details on this subject can be found in the description of the MODIFY-PUBSET-PROCESSING command.

VM2000 mode:

The command can be used under VM2000 (monitor/guest system) in the same way as in native mode. The VM2000 administrator must take appropriate precautions when assigning devices to the VMs. For that, please refer to the "VM2000" manual [50].

Format

MOVE-DISK                                                                                                                 


 FROM = *PUBSET(...) / *DISK(...)


*PUBSET(...)



|

  PUBSET = <cat-id 1..4>(...)


| 
<catid 1..4>(...)


| 

|VOLUME-SET = *NONE / <cat-id 1..4>


| ,VOLUME = *LAST / <vsn 6..6> 


|  ,CLEAR-VOLUME-TIME= 300 / <integer 1..65280 seconds>      

*DISK(...)



|

UNIT = <alphanum-name 2..2>/ <x-text 4..4>


| ,OVERWRITE-DISK = *NON-STD / *ANY / <vsn 6..6>       

,TO = *PUBSET(...) / *DISK(...)


*PUBSET(...)



|

PUBSET = <cat-id 1..4(...)



|


<cat-id 1..4(...)



| 

| VOLUME-SET = *NONE / <cat-id 1..4>


|

,VOLUME = *NEXT / <vsn 6..6> 



|

,ALLOCATION-ON-VOLUME = *NOT-RESTRICTED / *NOT-ALLOWED 



|

,CHECK-PUBSET-MIRRORS = *NO / *YES


*DISK(...)



|

NEW-VSN = *NON-STD / <vsn 6..6>(...) 



|
<vsn 6..6>(...)


| 

|FORMAT = *UNCHANGED/ *K / *NK 


| 

|
*NK(...) 


| 

|

|PHYSICAL-BLOCK-SIZE = *2K(...) / *4K(...)  


|  

|

|
*2K(...)  


|  

|

|

|ALLOCATION-UNIT = 6 / 8 / 64


|  

|

|
*4K(...)


|  

|

|

|ALLOCATION-UNIT= 8 / 64 

,DESTROY-OLD-CONTENTS = *NO / *YES(...)


*YES(...)



|

NUMBER-OF-OVERWRITES= *VOLIN-STD /<integer 1...10>


Operands

FROM = *PUBSET(...) / *DISK(...)

Defines whether the device in question is a volume of a pubset or a freely available disk.

FROM = *PUBSET(...)

The device in question is a volume of an SF or SM pubset and is to be removed from it.

The volume is completely cleared during this process. Internally, the following SPACEOPT command is used: /CLEAR-VOLUME VOLUME=<vsn>, PROCESS-OPEN-FILES=*YES.

For restrictions and constraints for CLEAR-VOLUME, please refer to the "SPACEOPT" manual [38].

PUBSET = <cat-id 1..4>(...)
Selects the pubset from which the volume is removed.

VOLUME-SET = *NONE / <cat-id 1..4>
For an SF pubset, *NONE must be specified here.

For an SM pubset, the identifier of the respective volume set must be specified here.

VOLUME = *LAST / <vsn 6..6>
Selects the volume serial number of the volume.

The default value is *LAST, which means the volume with the last assigned VSN (highest disk number within the VSNs).

CLEAR-VOLUME-TIME = 300 / <integer 1..65280 seconds>

Determines the maximum waiting time for the volume to be cleared (implicit SPACEOPT call).

The default value is 300 seconds.

FROM = *DISK(...)

The device in question is a freely available disk which is attached to the system.

UNIT= <alphanum-name 2..2> / <x-text 4..4>
Selects the mnemonic device name (MN) of the disk.

OVERWRITE-DISK = *NON-STD / *ANY / <vsn 6..6>

Controls the internal VOLIN run regarding the disk initialization.

OVERWRITE-DISK = *NON-STD

The disk is only reinitialized if it is a non-standard disk.

OVERWRITE-DISK = *ANY

The disk is to be reinitialized in any case.

OVERWRITE-DISK = <vsn 6..6>

The disk is only reinitialized if it contains the specified VSN.

TO = *PUBSET(...) / *DISK(...)

Determines whether the device specified in the FROM operand is assigned to a pubset as an additional volume or to the system as a freely available disk.

TO = *PUBSET(...)
The device specified in the FROM operand is assigned to an SF or SM pubset as an additional volume.

PUBSET = <cat-id 1..4>(...)
Determines the pubset to which the volume is assigned.

VOLUME-SET = *NONE / <cat-id 1..4>
For an SF pubset, *NONE must be specified here.

For an SM pubset, the identifier of the respective volume set must be specified here.

VOLUME = *NEXT / <vsn 6..6> 
Detrmines the volume serial number of the volume.

The default value is *NEXT, which means the next free VSN is used. 

ALLOCATION-ON-VOLUME = *NOT-RESTRICTED / *NOT-ALLOWED
Determines whether storage space can be allocated on the volume.

See also the corresponding operand of the MODIFY-PUBSET-PROCESSING command.

CHECK-PUBSET-MIRRORS = *NO / *YES
Determines whether the homogeneity of the pubset is to be checked. A pubset is homogeneous when all volumes of the pubset have the same mirroring properties.

See also the corresponding operand of the MODIFY-PUBSET-PROCESSING command.

TO = *DISK(...)
The disk specified in the operand FROM is reinitialized (internal VOLIN run) and assigned to the system as a freely available disk.

Note the restrictions of VOLIN regarding archive number (VSN) and volume properties (format). For that, please refer to the "Utility Routines manual" [9], chapter VOLIN. 

NEW-VSN = *NON-STD / <vsn 6..6>(...)

Determines the formatting and the volume serial number of the disk.

NEW-VSN = *NON-STD

The disk is initialized as non-standard disk.

NEW-VSN =<vsn 6..6>(...)

The disk is initialized with the given VSN.

FORMAT = *UNCHANGED / *K / *NK

Determines the formatting of the disk.

FORMAT = *K

The disk is initialized with the K format.

FORMAT = NK(PHYSICAL-BLOCK-SIZE=*2K(ALLOCATION-UNIT=6/8/64)

The disk is initialized with the NK format and a physical block size (TU) of 2 KB and the respective allocation unit (AU).

FORMAT = NK(PHYSICAL-BLOCK-SIZE=*4K(ALLOCATION-UNIT=8/64)

The disk is initialized with the NK format and a physical block size (TU) of 4 KB and the respective allocation unit (AU).

DESTROY-OLD-CONTENTS = *NO / *YES(...)

Determines whether the user data of the disk should be deleted during the VOLIN run.

DESTROY-OLD-CONTENTS =*YES(...)

The user data of the disk should be deleted during the VOLIN run.

NUMBER-OF-OVERWRITES = *VOLIN-STD / <integer 1..10>

Determines how often the user data should be overwritten during the VOLIN run.


Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command successfully processed


1

CMD0202

Command syntax error


32

DMS3699

Internal error occurred


64

DMS3631

Unexpected return code of an internally used command


64

DMS3634

Maximal number of volumes reached for pubset/volset


64

DMS3635

Required subsystem not available


64

DMS3642

Invalid disk status of volume


64DMS3660FROM- and TO-disk are both NON-STD

 64 DMS3661Pubset not available

 64 DMS3666FROM- and TO-pubset must be different

 64DMS3667Invalid volset specification for pubset

 64 DMS3668Invalid specification of volres for pubset 

 64 DMS3669Specified FROM-volume not found

 64 DMS3670Invalid TO-volume specified 

 64 DMS3671Specified FROM-volume could not be cleared

 64 DMS3677Initialialization of FROM-disk rejected 

 64 DMS3679Error at VOLIN run

64 DMS3683Disk not attached or not available

 64 DMS3685FROM-pubset/volset consists of one volume only

 64 DMS3686Pubset is a shared pubset but own host is not master

Examples:

  • Reducing a pubset by a single volume (taking the last VSN) and returning this volume to the system as a NON-STD disk. The volume is cleared implicitly and any existing user data are overwritten during the VOLIN run.
/MOVE-DISK
   FROM=*PUBSET(PUBSET=<fr-catid>[(VOL-SET=<fr-vs-catid>)],CLEAR-VOL-TIME=<cvt>,VOL=*LAST)
  ,TO=*DISK(NEW-VSN=*NON-STD),DESTROY-OLD-CONTENTS=YES(NUM-OF-OVERWRITES=*VOLIN-STD)
  • Expanding a pubset by a new volume (using the next free VSN).
/MOVE-DISK
   FROM=*DISK(UNIT=F-<mn>) 
  ,TO=*PUBSET(PUBSET=<to-catid>[(VOL-SET=<to-vs-catid>)],VOL=*NEXT)
  • Moving a single volume from one pubset (taking the last VSN) to another pubset (using the next free VSN).
/MOVE-DISK
   FROM=*PUBSET(PUBSET=<fr-catid>[(VOL-SET=<fr-vs-catid>)],VOL=*LAST) 
  ,TO=*PUBSET(PUBSET=<to-catid>[(VOL-SET=<to-vs-catid>)],VOL=*NEXT)



Powered by Atlassian Confluence and Scroll Viewport.