CA Dynam for VSE User Guide

Disk File Maintenance Utilities
PARTIAL
Optional parameter for SD files only. Controls the alteration of disk files that
have multiple extents existing on multiple volumes. If either VOL= or POOL=
is specified for a file residing on multiple volumes, the ALTER will not complete
without the PARTIAL parameter. PARTIAL allows ALTER to complete even if
only a portion of the file resides on the specified volumes. If you omit
PARTIAL, only complete files will be altered (unless PARTIAL(NO) is defined in
the DYNAM/D option record).
PARTIAL has no effect when used with the CATALOG parameter.
Disk File Without|ALTER With |ALTER
Description PARTIAL|(Y/N) PARTIAL|(Y/N)
---------------- -------+------ -------+------
Single extent VOL= | Y VOL= | Y
single volume POOL= | Y POOL= | Y
| |
Multiple extents VOL= | Y VOL= | Y
single volume POOL= | Y POOL= | Y
| |
Multiple extents VOL= | N VOL= | Y
multiple volumes POOL= | N POOL= | Y
Y
N
ALTER executes.
ALTER does not execute; message CADD595 is displayed.
RENAME='new-file'
Optional parameter. Redefines the file ID currently in the VTOC. The new file
ID must be enclosed within apostrophes. Do not specify RENAME= when using
a generic file ID; it could create duplicate file IDs in a VTOC.
Note: Error messages CADD566 and CADD567 are produced when DSFON is
specified and a file is found that has an expiration date of 2099/366 (PERM) or
is a data-secured file. The operator can respond with IGNORE, CANCEL or
BYPASS to these messages. For more information, see the Message Guide.
Examples:
Alter the expiration date of a file to 2099/366.
ALTER '==.WORK.FILE' VOL=WRKPAC PERM
Alter a file that resides in the pool DYNPAC to be expired.
ALTER 'OLD.TRANSACTIONS' POOL=DYNPAC EXPDATE=89/001
Alter all files on the pack WORK01 to be expired.
ALTER '*' VOL=WORK01 EXPDATE=89/001
Rename a file in the pool POOL02.
Chapter 5: Supporting Disk File Management 5–15