z/VM: CP Commands and Utilities Reference - z/VM - IBM

formatted, and asking you if you want to continue. If the cylinders or pages are
incorrect, you can reply NO, and the disk remains unchanged. If they are
correct, you can reply YES, and processing continues.
If the starting cylinder is not 0, CPFMTXA first verifies the DASD before
prompting you with the cylinder range to be formatted. When formatting a
portion of a DASD (anything other than cylinder 0) you must specify the existing
label for that DASD. You cannot change the label during the format of a DASD
unless cylinder 0 is included in the range of cylinders to format.
5. If you enter the CPFMTXA command without the LABEL or ALLOCATE options,
it is assumed that you want to format the entire DASD.
For example, suppose you enter CPFMTXA 192 TEST1
CPFMTXA assumes that you want to format the entire device. All cylinders or
pages are formatted, and all cylinders or pages are initially allocated as PERM
space. Then you are prompted to update the DASD allocation, and the volume
on 192 is labeled TEST1.
Suppose, however, that you enter cpfmtxa 192 test2 0.3
CPFMTXA formats cylinders or pages 0, 1, and 2. Since you formatted cylinder
or page 0, all cylinders or pages are to be initially allocated as PERM space.
Then you are prompted to update the DASD allocation, and the volume on 192
is labeled TEST2.
If you enter cpfmtxa 192 test3 1-3 CPFMTXA first checks to see if the volume
ID on 192 is TEST3. If it is not, you receive an error message indicating what
the correct label is, and CPFMTXA processing terminates. If volid is TEST3,
CPFMTXA formats cylinders or pages 1, 2, and 3, and you are prompted to
update the DASD allocation. Since you did not format cylinder or page 0, the
label is not written, and the cylinders or pages are not initially allocated as
PERM.
6. DRCT, PAGE, PARM, PERM, SPOL, and TDSK are allocation types. You may
use these entries in any order. Each entry in turn overlays the allocation record,
and any space not reallocated remains the same.
Note: Special care should be exercised in this area, especially when cylinder 0
or pages 0-3 are being reformatted. If, for example, new directory
cylinders or pages are allocated, the allocation record is overwritten,
effectively destroying any pointers to the active directory and rendering it
inaccessible. If an allocation entry overlays a previous cylinder or page
allotment, the previous cylinder or page space allotment is truncated to
the beginning of the next cylinder or page allotment. For example,
assume that the following is the current allocation of a vdev:
CYLINDER ALLOCATION CURRENTLY IS AS FOLLOWS:
TYPE START END TOTAL
.................................
PERM 0 0 1
PARM 1 29 29
PERM 30 554 525
and you enter the following allocation data:
parm 20-49
tdsk 50-100
drct 100-200
spol 150-500
page 400.50
The actual output follows:
CYLINDER ALLOCATION CURRENTLY IS AS FOLLOWS:
TYPE START END TOTAL
................................
CPFMTXA
Chapter 3. CP Utilities 1787