VOLUTIL


VOLUTIL

     Starts the disk volume utility subsystem.

SYNTAX

     VOLUTIL

PARAMETERS

     NEWSET         sname vname ldev [perm][trans][gen_number][(cname[[,cname]...
SHOWSET [sname] [ CLASSES | VOLUMES | SETINFO | DSTATUS |
STORAGE [;FREE] [;PERM] [;TRANS] |
LABELS [;MPEXL] | STRUCT | MIRROR ]
COPYSET sname from_ldev to_ldev
SETDEFAULTSET [sname]
SHOWDEFAULTSET
NEWCLASS sname:cname [(vname [[,vname]...])]
EXPANDCLASS sname:cname (vname [[,vname]...])
SHOWCLASS [sname:]cname [ VOLUMES | SETS | CLASSINFO | DSTATUS |
STORAGE [;FREE] [;PERM] [;TRANS] |
LABELS [;MPEXL] ]
NEWVOL sname:vname ldev [perm] [trans] [(cname[[,cname]...])]
INITVOL sname:vname ldev
ALTERVOL sname:vname [perm] [trans]
SHOWVOL [sname:]vname [ SETS | CLASSES | VOLINFO | DSTATUS |
STORAGE [;FREE] [;PERM] [;TRANS] |
LABEL [;MPEXL] ]
FORMATVOL ldev
SCRATCHVOL ldev
UNSCRATCHVOL ldev
DSECTORSVOL [sname:]vname | ldev
VERIFYVOL [sname:]vname | ldev
COPYVOL from_ldev to_ldev
SHOWUSAGE [sname:]vname | ldev [sectors][ALL | RESTRICT | NONRESTRICT]
[DETAIL | SUMMARY]
[;PERM] [;FREE] [;TRANS] [;MAX] [;PATH]
CONTIGVOL [sname:]vname | ldev [sectors] [minutes]
[;transientok] [;unrestricted]
NEWMIRRSET sname vname ldevs [perm][trans][gen_number][(cname[[,cname]..
NEWMIRRVOL sname:vname ldevs [perm] [trans] [(cname[[,cname]...])]
REPLACEMIRRVOL sname:vname ldev
SUSPENDMIRRVOL sname:vname ldev
JOINMIRRSET sname [ USER | BACKUP ]
HELP [command_name]
USE filename
LOG filename
REDO [cmd_id]
DO [cmd_id]
LISTREDO
RECOVER [;KEEP | ;NOKEEP]
VERIFY On | Off
EXIT
SHOWSYSLOG sname
ALTERSYSLOG sname size
SHOWCHKPTSTAT sname
ALTERCHKPTSTAT sname ENABLE | DISABLE
SHOWUSERLOG sname
ALTERUSERLOG sname size
SHOWCHKPTPRI sname
ALTERCHKPTPRI sname size


OPERATION

NEWSET

Description:

The NEWSET command is used to create a new volume set and its associated
master volume. The ldev parameter must identify a disc volume that is
mounted in the SCRATCH or UNKNOWN state as displayed by the :DSTAT command.

Syntax:

volutil: NEWSET [SNAME=]sname
[MASTER=]vname
[LDEV=]ldev
[[PERM=]percent_perm] [[TRANS=]percent_trans]
[[GEN=]gen_number]
[[CLASSES=](cname[[,cname]...])]

Example:

volutil: NEWSET sample_set sample_master 24 100 0


SHOWSET

Description:

The SHOWSET command is used to display information about a particular
volume set. The master volume of the volume set must be mounted in the
MASTER state as displayed by the :DSTAT command.

Syntax:

/CLASSES \
|VOLUMES |
|SETINFO |
volutil: SHOWSET [SNAME=]sname [INFO=]|DSTATUS |
|STORAGE [;FREE][;PERM][;TRANS]|
|LABELS [;MPEXL] |
|STRUCT /
\MIRROR /

Example:

volutil: SHOWSET sample_set volumes


COPYSET

Description:

The COPYSET command is used to copy 1 or more volumes of a volume set.
The master volume of the volume set must be copied first. Source volumes
must be mounted in the LONER state and destination volumes must be mounted
in the SCRATCH or UNKNOWN state as displayed by the :DSTAT command.

Syntax:

volutil: COPYSET [SNAME=]sname
[FROM=]from_ldev
[TO=]to_ldev
[[GEN=]gen_number]

Example:

volutil: COPYSET sample_set 2 3


SETDEFAULTSET

Description:

The SETDEFAULTSET command is used to change the current default volume
set. The master volume of the designated volume set must be mounted in
the MASTER state as displayed by the :DSTAT command.

Syntax:

volutil: SETDEFAULTSET [[SNAME=]sname]

Example:

volutil: SETDEFAULTSET sample_set


SHOWDEFAULTSET

Description:

The SHOWDEFAULTSET command displays the current default set.

Syntax:

volutil: SHOWDEFAULTSET

Example:

volutil: SHOWDEFAULTSET


NEWCLASS

Description:

The NEWCLASS command is used to create a new volume class and assign
volumes to it. The master volume of the volume set in which the class is
being created must be mounted in the MASTER state as displayed by the
:DSTAT command.

Syntax:

volutil: NEWCLASS [CNAME=]sname:cname
[[VOLUMES=](vname[[,vname]...])]

Example:

volutil: NEWCLASS sample_set:sample_class (sample_master)


EXPANDCLASS

Description

The EXPANDCLASS command is used to add additional volumes to an existing
volume class. The master volume of the volume set containing the class
being expanded must be mounted in the MASTER state as displayed by the
:DSTAT command.

Syntax:

volutil: EXPANDCLASS [CNAME=]sname:cname
[VOLUMES=](vname[[,vname]...])

Example:

volutil: EXPANDCLASS sample_set:sample_class (sample_member2)


SHOWCLASS

Description:

The SHOWCLASS command is used to display information about a particular
volume class. The master volume of the designated volume set must be
mounted in the MASTER state as displayed by the :DSTAT command.

Syntax:

/VOLUMES
|DSTATUS
volutil: SHOWCLASS [CNAME=][sname:]cname[INFO=]|CLASSINFO
|STORAGE[;FREE][;PERM][;TRAN
\LABELS[;MPEXL]

Example:

volutil: SHOWCLASS sample_set:sample_class volumes


NEWVOL

Description:

The NEWVOL command is used to create and initialize a new member volume.
The master volume of the volume set in which the volume is being created
must be mounted in the MASTER state as displayed by the :DSTAT command.

Syntax:

volutil: NEWVOL [VNAME=]sname:vname
[[LDEV=]ldev]
[[PERM=]percent_perm] [[TRANS=]percent_trans]
[[CLASSES=](cname[[,cname]...])]

Example:

volutil: NEWVOL sample_set:sample_member 25,,,(sample_class)


INITVOL

Description:

The INITVOL command is used to physically initialize a volume that was
previously defined with the NEWVOL command. The master volume of the
volume set in which this volume is a member must be mounted in the MASTER
state as displayed by the :DSTAT command.

Syntax:

volutil: INITVOL [VNAME=]sname:vname
[LDEV=]ldev

Example:

volutil: INITVOL sample_set:sample_member 25


ALTERVOL

Description:

The ALTERVOL command is used to change the permanent and transient space
allocation assignments of a particular volume. The selected volume must
be mounted in the MASTER or MEMBER state as displayed by the :DSTAT
command. Remember these parameters do not represent physical pools, but
maximum limits indicating how large each domain can GROW to.

Syntax:

volutil: ALTERVOL sname:vname [[PERM=]percent_perm] [[TRANS=]percent_trans]

Example:

volutil: ALTERVOL sample_set:sample_vol 100 100


SHOWVOL

Description:

The SHOWVOL command is used to display information about a particular
volume of a volume set. The master volume of the designated volume set
must be mounted in the MASTER state as displayed by the :DSTAT command.

Syntax:

/CLASSES
|DSTATUS
volutil: SHOWVOL [VNAME=][sname:]vname [INFO=]|VOLINFO
|STORAGE [;FREE][;PERM][;TRAN
\LABEL [;MPEXL]

Example:

volutil: SHOWVOL sample_set:sample_member storage


FORMATVOL

Description:

The FORMATVOL command is used to format the media of any volume or disc pac
Formatting of disc media is necessary only when an irrecoverable error has
occurred. The volume must be mounted in the SCRATCH or UNKNOWN state as
displayed by the :DSTAT command.

Syntax:

volutil: FORMATVOL [LDEV=]ldev

Example:

volutil: FORMATVOL 25


SCRATCHVOL

Description:

The SCRATCHVOL command is used to scratch a volume. The volume must be
mounted in the LONER state as displayed by the :DSTAT command.

Syntax:

volutil: SCRATCHVOL [LDEV=]ldev

Example:

volutil: SCRATCHVOL 25


UNSCRATCHVOL

Description:

The UNSCRATCHVOL command is used to unscratch a volume. The volume must
be mounted in the SCRATCH state as displayed by the :DSTAT command.

Syntax:

volutil: UNSCRATCHVOL [LDEV=]ldev

Example:

volutil: UNSCRATCHVOL 25


DSECTORSVOL

Description:

The DSECTORSVOL command allows defective sectors to be processed and
recovered.

Syntax:

volutil: DSECTORSVOL [VOL=] / ldev \
\[sname:]vname/

Example:

volutil: DSECTORSVOL sample_set:sample_member


VERIFYVOL

Description:

The VERIFYVOL command is used to verify disc media to ensure that it can
be read.

Syntax:

volutil: VERIFYVOL [VOL=] / ldev \
\[sname:]vname/

Example:

volutil: VERIFYVOL sample_set:sample_member


COPYVOL

Description:

The COPYVOL command makes a bitwise copy of the contents of the source
volume on the destination volume. The source volume must be mounted in
the LONER, SCRATCH, or UNKNOWN state and the destination volume must be
mounted in the SCRATCH or UNKNOWN state as displayed by the :DSTAT command.

Syntax:

volutil: COPYVOL [FROM=]from_ldev [TO=]to_ldev

Example:

volutil: COPYVOL 15 16


SHOWUSAGE

Description:

The SHOWUSAGE command displays the disc space usage of a volume.
The master volume of the volume set in which this volume is a member
must be mounted in the MASTER state as displayed by the :DSTAT command.

Syntax:

volutil: SHOWUSAGE [VOL=][sname:]vname | ldev
[[CONTIG]=sectors]
[[FILE=]ALL | RESTRICT | NONRESTRICT]
[[FORMAT=]DETAIL | SUMMARY]
[;PERM][;FREE][;TRANS][;MAX][;PATH]

Example:

volutil: SHOWUSAGE sample_set:sample_member 60000 all detail ;max


CONTIGVOL

Description:

The CONTIGVOL command creates contiguous free disk space on a volume.
The master volume of the volume set in which this volume is a member
must be mounted in the MASTER state as displayed by the :DSTAT command.

Syntax:

volutil: CONTIGVOL [VOL=][sname:]vname | ldev
[[SIZE=]sectors]
[[TIMEOUT=]minutes]
[;TRANSIENTOK][;UNRESTRICTED]

Example:

volutil: CONTIGVOL sample_set:sample_member 60000 20 ;unrestricted


WARNING *** Running CONTIGVOL on a busy system may cause *** WARNING
WARNING *** "OUT OF DISK SPACE" errors temporarily on *** WARNING
WARNING *** the specified LDEV/Volume. *** WARNING


NEWMIRRSET

Description:

The NEWMIRRSET command is used to create a new mirrored volume set and its
associated mirrored master volume. The ldevs parameter must identify a
disc volume pair mounted in the SCRATCH or UNKNOWN state as displayed by th
:DSTAT command.

Syntax:

volutil: NEWMIRRSET [SNAME=]sname
[MASTER=]vname
[LDEVS=](ldev,ldev)
[[PERM=]percent_perm] [[TRANS=]percent_trans]
[[GEN=]gen_number]
[[CLASSES=](cname[[,cname]...])]

Example:

volutil: NEWMIRRSET sample_set sample_master (24,25) 100 0


NEWMIRRVOL

Description:

The NEWMIRRVOL command is used to create and initialize a new mirrored
member volume. The volume set in which the volume is being created must be
a mirrored volume set. The master volume must be mounted in the MASTER
state as displayed by the :DSTAT command.

Syntax:

volutil: NEWMIRRVOL [VNAME=]sname:vname
[LDEVS=](ldev,ldev)
[[PERM=]percent_perm] [[TRANS=]percent_trans]
[[CLASSES=](cname[[,cname]...])]

Example:

volutil: NEWMIRRVOL sample_set:sample_member (25,26),,,(sample_class)


REPLACEMIRRVOL

Description:

The REPLACEMIRRVOL command is used either after a partner of a mirrored
pair has suffered a failure and mirroring has been disabled, or after
the SUSPENDMIRRVOL command has suspended mirroring on a pending volume.
This command enables, in the former case, to replace the failed drive
with a volume that must be mounted on the same ldev as the one that
went bad; and in the latter case, to resume mirroring with a volume
that must be mounted in the SCRATCH or UNKNOWN state.

Syntax:

volutil: REPLACEMIRRVOL [VNAME=]sname:vname [LDEV=]ldev

Example:

volutil: REPLACEMIRRVOL sample_set:sample_member 15


SUSPENDMIRRVOL

Description:

The SUSPENDMIRRVOL command is used to bring a mirrored volume to a state
in which it can be accessible WITHOUT its partner being available. The
ldev parameter must identify a disc volume mounted in the PENDING-MD
state as displayed by the :DSTAT command.

Syntax:

volutil: SUSPENDMIRRVOL [VNAME=]sname:vname [LDEV=]ldev

Example:

volutil: SUSPENDMIRRVOL sample_set:sample_member 15


JOINMIRRSET

Description:

The JOINMIRRSET command is used to join user and backup volume sets which
were previously formed through the VSCLOSE <volume set>;SPLIT command into
a mirrored volume set again. It matches corresponding volumes from user
and backup split volume sets to form a mirrored pair, and initiates a
repair from each SOURCE volume to its corresponding user or backup
volume.

Syntax:

volutil: JOINMIRRSET [SNAME=]sname [SOURCE=]|USER |
|BACKUP|

Example:

volutil: JOINMIRRSET sample_set user


HELP

Description:

The HELP command provides on-line help about each Volume Utility command.

Syntax:

volutil: HELP [[COMMAND=]command_name]

Example:

volutil: HELP newset


USE

Description:

The USE command is used to execute Volume Utility commands from an ascii
script file. USE filename opens the specified file, executes all commands
from the file, and then closes the file and returns to interactive user
input. USE commands can be nested.

Syntax:

volutil: USE [FILENAME=]filename.

Example:

volutil: USE cmdfile


LOG

Description:

The LOG command is used to record the human/machine dialog as it appears
to the user on $stdlist. The log file is an exact snapshot of the session
with VOLUTIL. What you see is what get.

Syntax:

volutil: LOG [FILENAME=]filename

Example:

volutil: LOG logfile


REDO

Description:

The REDO command is identical in function to the MPE XL redo command. It
allows a command in the command history stack to be edited and re-executed.

Syntax:

volutil: REDO [CMD=]cmd_id

Example:

volutil: REDO 5


DO

Description:

The DO command is used to re-execute a command from the command history
stack.

Syntax:

volutil: DO [CMD=]cmd_id

Example:

volutil: DO 5


LISTREDO

Description:

The LISTREDO command is used to display the command history stack. The
output order is from the least to the most recent command with absolute
command reference numbers preceeding each command.

Syntax:

volutil: LISTREDO

Example:

volutil: LISTREDO


RECOVER

Description:

The RECOVER command allows files to be recreated from the output tape(s)
produced by DISCUTIL. See the DISCUTIL/RECOVER user's guide for further
details.

Syntax:

volutil: RECOVER [;KEEP|;NOKEEP]

Example:

volutil: RECOVER;KEEP


VERIFY

Description:

The VERIFY command allows the user to turn off the verification response.

Syntax:

volutil: VERIFY ON|OFF

Example:
volutil: VERIFY OFF


EXIT

Description:

The EXIT command is used to terminate Volume Utility an return to the
MPE XL command interpreter.

Syntax:

volutil: EXIT

Example:

volutil: EXIT


SHOWSYSLOG

Description:

The SHOWSYSLOG command is used to display the system log size of the
specified volume set. The selected volume set must be open (i.e) the
master volume of the selected volume set should be in the MASTER state
as displayed by the :DSTAT command. Size is displayed in sectors

Syntax:

volutil: SHOWSYSLOG sname

Example:

volutil: SHOWSYSLOG sample_set


ALTERSYSLOG

Description:

The ALTERSYSLOG command is used to modify the system log size of the
specified volume set. The selected volume set must be open (i.e) the
master volume of the selected volume set should be in the MASTER state
as displayed by the :DSTAT command. The size is specified in sectors.
Default size is about 12Mb. It's suggested not to expand it beyond
a few multiples of this size.

Syntax:

volutil: ALTERSYSLOG sname size

Example:

volutil: ALTERSYSLOG sample_set 20


SHOWCHKPTSTAT

Description:

The SHOWCHKPTSTAT command is used to display the status of XM
checkpoint improvement code for the specified volume set.

Syntax:

volutil: SHOWCHKPTSTAT sname

Example:

volutil: SHOWCHKPTSTAT sample_set


ALTERCHKPTSTAT

Description:

The ALTERCHKPTSTAT command is used to modify the status of the
XM checkpoint improvement code for the specified volume set. The
status can be ENABLE/DISABLE.


Syntax:

volutil: ALTERCHKPTSTAT sname ENABLE|DISABLE

Example:

To enable,
volutil: ALTERCHKPTSTAT sample_set ENABLE|E
or
To disable,
volutil: ALTERCHKPTSTAT sample_set DISABLE|D


SHOWUSERLOG

Description:

The SHOWUSERLOG command is used to display the user log size of the
specified volume set. The selected volume set must be open (i.e) the
master volume of the selected volume set should be in the MASTER state
as displayed by the :DSTAT command. Size is displayed in sectors

Syntax:

volutil: SHOWUSERLOG sname

Example:

volutil: SHOWUSERLOG sample_set


ALTERUSERLOG

Description:

The ALTERUSERLOG command is used to modify the user log size of the
specified volume set. The selected volume set must be open (i.e) the
master volume of the selected volume set should be in the MASTER state
as displayed by the :DSTAT command. The size is specified in sectors.
Default size is about 64MB. It's suggested not to expand it beyond
a few multiples of this size.

Syntax:

volutil: ALTERUSERLOG sname size

Example:

volutil: ALTERUSERLOG sample_set 280000


SHOWCHKPTPRI

Description:

The SHOWCHKPTPRI command is used to display the priority of the
User checkpoint process (checkpointing of transactions on user
files, such as KSAM & Image files), for the given volume set.

Syntax:

volutil: SHOWCHKPTPRI sname

Example:

volutil: SHOWCHKPTPRI sample_set


ALTERCHKPTPRI

Description:

The ALTERCHKPTPRI command is used to modify the priority of the
User checkpoint process for the given volume set. The checkpoint priority
should be in the range of 152 to 255. It is suggested to fix the value
at 200. Priority 0 will reset the checkpoint priority to default which
is C152.

Syntax:

volutil: ALTERCHKPTPRI sname size

Example:

volutil: ALTERCHKPTPRI sample_set 200


EXAMPLE(S)

     -


Commands:

Manuals :