HP 3000 Manuals HP 3000 Manuals
Operation
There are two parts to the FSCHECK utility, the program and the message
catalog. The program can reside in any group and account, but the
message catalog must reside in MPEXL.TELESUP. Each version of the program
has a unique message catalog, and the catalog contains a version ID to
prevent the mixing of incompatible programs and catalog versions. If the
message catalog is not in MPEXL.TELESUP, use a file equation to redirect
it to the correct file.
To execute the FSCHECK utility, type FSCHECK at the MPE/iX prompt. You
can also invoke FSCHECK with the MPE/iX RUN command using the INFO
parameter to pass commands. The group and account in FSCHECK that is
being run should have PM, MR, DS, and PH capabilities.
The FSCHECK utility uses the formal file designators FSCHKIN and FSCHKOUT
for input and output respectively. The default input file is $STDINX and
the default output file is $STDLIST, though you can use file equations to
redirect them to other files.
On the following pages, each of the FSCHECK commands is listed in
alphabetical order. String sequences (tokens) in brackets next to the
command name indicate abbreviations for the command.
CHECKDIRC [CD]
The CHECKDIRC command checks the directory on the specified volume set
for internal consistency and makes sure that for each directory entry
there exists an associated file label entry. This command assumes that
all volumes of the identified volume set are mounted and available and
that the system is fully operational.
|Syntax
CHECKDIRC [DEV=] set_name
ALL
[;IGNORE]
[;FIX]
[;LOG=filename]
Parameters
set_name Set_name is the name of the volume set whose
directory is to be checked. The volume set must be
opened (the set's master volume must be mounted in
the MASTER state) as displayed by the DSTAT
command.
ALL All checks the directory on all mounted volume
sets.
IGNORE Ignores errors detected by CHECKDIRC and continues
checking the directories.
FIX Fixes the errors detected by CHECKDIRC and
continues checking the directories. This is the
default option.
filename Filename is the name of a log file on which
CHECKDIRC messages are to be written. If this
parameter is omitted, the output will be displayed
only to $STDLIST.
Example
fscheck:CHECKDIRC ALL Return
CHECKEXTENTS [CE]
The CHECKEXTENTS command checks the extent map for each file label in the
label table for duplicate extent descriptors. Duplicate extent
descriptors are those with overlapping file sector offset.
Syntax
ldev
CHECKEXTENTS [DEV=] set_name
ALL
Parameters
The DEV parameter is optional. If omitted, the default is to check the
extent maps on each mounted volume of the system volume set.
ldev Ldev is a number from 1 to 32767, specifying the
logical device on which the volume is mounted. The
volume must be mounted in the MASTER or MEMBER
state as displayed by the DSTAT command
set_name Set_name is the name of a mounted volume set whose
master volume is mounted in the MASTER state as
determined by the DSTAT command. The extent map
check is performed on each mounted volume of the
set.
ALL ALL checks the extent maps on each volume mounted
in the MASTER or MEMBER state.
Example
fscheck: CHECKEXTENTS ALL return
CHECKLABEL [CL]
The CHECKLABEL command checks the label table(s) on the specified
volume(s) for internal consistency and verifies that each file label
entry has an associated entry in the volume set's directory. It does not
verify the integrity of HFS-syntax files whose file names are blanked out
in the file label.
If neither the CNAME or VNAME parameter is specified, the label table
of each volume in the sytem volume set is checked by default
(MPEXL_SYSTEM_VOLUME_SET).
Syntax
CHECKLABEL [DEV=][ldev]
[set_name]
[ALL]
[;IGNORE]
[;FIX]
[;ASK]
[;LOG=filename]
Parameters
ldev Ldev is a number from 1 to 32,767, specifying the
logical device on which the volume to be checked is
mounted. The volume must be mounted in the master
or member state, as determined by the DSTAT
command.
set_name Set_name is the name of the volume set whose label
tables are to be checked. The volume set must be
opened (the set that is master must be mounted in
the MASTER state, as displayed by the DSTAT
command).
ALL All checks the label tables on each volume mounted
in the MASTER or MEMBER state as determined by the
DSTAT command.
IGNORE Ignore errors detected by CHECKLABEL and continue
checking the labels.
FIX Fixes the errors detected by CHECKLABEL and
continues checking the labels.
ASK ASK prompts the user to choose to fix the errors or
not. This is the default option.
filename Filename is the name of a log file on which
CHECKLABEL messages are to be written. If this
parameter is omitted, the output will be displayed
to $STDLIST.
Example
fscheck: CHECKLABEL ALLReturn
CHECKFILE [CF]
The CHECKFILE command checks the label of the specified file for internal
consistency.
Syntax
CHECKFILE [FILENAME=] filename
Parameters
filename Specifies the name of the file to be checked. The
file name can be an MPE/iX file name of the form
filename[.group][.account] or it can be a
fully-qualified HFS pathname. You may use wildcard
characters that conform to MPE/iX convention, to
specify the file, group, and account names.
Examples
fscheck: CHECKFILE @.PUB.SYS return
fscheck: CHECKFILE /mydir/myfile1 return
CHECKALL [CA]
The CHECKALL command performs the CHECKLABEL, CHECKDIRC, and CHECKEXTENTS
commands consecutively.
Syntax
CHECKALL [DEV=] set_name
ALL
Parameters
The DEV parameter is optional. If omitted, the default is to check the
directory, labels, and extent maps on each mounted volume of the system
volume set.
set_name Set_name is the name of a mounted volume set whose
master volume is mounted in the MASTER state as
determined by the DSTAT command. The label,
directory, and extent map check is performed on
each mounted volume of the set.
ALL ALL checks the labels, directory, and extent maps
on each volume mounted in the MASTER or MEMBER
state.
Example
fscheck: CHECKALL ALL return
DEBUG
The DEBUG command invokes the native mode system.
Syntax
DEBUG
Parameters
None
Example
fscheck: DEBUG return
DISPLAYLABEL [DL]
The DISPLAYLABEL command displays the fully qualified file name and
offset within the label table for each file label entry of the label
table on the specified logical device.
Syntax
DISPLAYLABEL [DEV=] ldev
set_name
ALL
Parameters
DEV= DEV= is an optional keyword for the parameter. If
it is omitted, the default is to display the
contents of the label table for each mounted volume
of the system volume set.
ldev Ldev is a number from 1 to 32,767, specifiying the
logical device on which the volume is mounted. The
volume must be mounted in the master or member
state, as displayed by the DSTAT command.
set_name Set_name is the name of a mounted volume set whose
master volume is mounted in the MASTER state as
displayed by the DSTAT command. For each mounted
volume in the set, the contents of the label table
is displayed.
ALL ALL displays the contents of the label table for
each volume mounted in the MASTER or MEMBER state,
as determined by the DSTAT command.
Example
fscheck: DISPLAYLABEL DEV=1 Return
DISPLAYEXTENTS [DE]
This command displays the extent map for the specified file. For each
extent of the file, it displays the number of sectors in the extent, the
single vector disk sector address (in hex), the file sector offset (in
hex), and the volume set index of the volume on which the extent resides.
Currently the file name must be fully qualified, that is, with the group
and the account names specified.
Syntax
DISPLAYEXTENTS [FILENAME=] filename
Parameters
filename Specifies the name of the file whose extent map you
want displayed. The file name can be an MPE/iX
file name of the form filename[.group][.account] or
it can be a fully-qualified HFS pathname.
Examples
fscheck: DISPLAYEXTENTS NL.PUB.SYS Return
fscheck: DISPLAYEXTENTS /sys/mydir1/myfile Return
DISPLAYLOCKFILE [DLF]
Displays the fully qualified file name of all of the locked files on the
specified volume. Files whose extents contain bad sectors are being
locked.
Syntax
ldev
DISPLAYLOCKFILE [DEV=] set_name
ALL
Parameters
The DEV parameter is optional. If omitted, the default is to display the
locked files on each mounted volume of the system volume set.
ldev Ldev is a number from 1 to 32767, specifying the
logical device on the locked files on the volume to
be displayed, is mounted. The volume must be
mounted in the MASTER or MEMBER state as determined
by the DSTAT command.
set_name Set_name is the name of the volume set whose locked
files are to be displayed. The volume set must be
opened (the set's master must be mounted in the
MASTER state, as determined by the DSTAT command).
ALL ALL displays the locked files on each volume
mounted in the MASTER or MEMBER state as determined
by the DSTAT command.
Example
fscheck: DISPLAYLOCKFILE ALL return
DO
This command re-executes a command from the command line history stack.
It is identical in function to the command DO.
Syntax
DO [CMD=] cmd_id
Parameters
cmd_id Cmd_id identifies a particular command in the
command line history stack. It can be a number
relative to the last command (-n), an absolute
number (n) identifying the particular command, or a
string used to match a particular command in the
stack.
Example
fscheck: DO CMD=-2 Return
EMPTYSLOUGH [ES]
Removes all extents from the slough file without attempting to deallocate
the secondary storage owned by its extents. This command is used for
file corruption work-around when inconsistencies exist between the free
space map and the label table such that there exist extent descriptors
for which the corresponding secondary storage is not permanently
allocated.
Syntax
ldev
EMPTYSLOUGH [DEV=]set_name
ALL
Parameters
The DEV parameter is optional. If omitted, the default is to empty the
slough file on the system volume set.
ldev ldev is a number from 1 to 32,767, specifying the
logical device on which the volume is mounted. The
volume must be mounted in the MASTER state as
displayed by the DSTAT command.
set_name Set_name is the name of a mounted volume set whose
master volume is mounted in the MASTER state as
determined by the DSTAT command.
ALL ALL empties the slough file on each volume set as
mounted in the MASTER state.
Example
fscheck: EMPTYSLOUGH 1return
EXIT [E]
This command terminates the FSCHECK utility and returns to the process
from which it was invoked.
Syntax
EXIT
Parameters
None
Example
fscheck: EXIT Return
EXTENTDISTRIB [ED]
Displays the distribution of extents by extent size or file size on the
specified volume(s). If you choose the EXTENT option, FSCHECK displays
the total number of extents that falls in the extent size range. If you
choose the FILE option, FSCHECK displays the total number of files, and
the average number of extents per file that falls in the file size range.
Syntax
ldev
EXTENTDISTRIB [DEV=]set_name
ALL
[;EXTENT]
[;FILE ]
Parameters
The DEV parameter is optional. If omitted, the default is to display the
extent distribution on each mounted volume of the system volume set.
ldev ldev is a number from 1 to 32,767, specifying the
logical device on which the extent distribution on
the volume to be displayed is mounted. The volume
must be mounted in the MASTER or MEMBER state as
determined by the DSTAT command.
set_name Set_name is the name of the volume set whose extent
distribution are to be displayed. The volume set
must be opened ( the set's master must be mounted
in the MASTER state as displayed by the DSTAT
command.
ALL ALL displays the extent distribution on each volume
mounted in the MASTER or MEMBER state as determined
by the DSTAT command.
EXTENT EXTENT displays the distribution of extent by
extent size. This is the default option.
FILE FILE displays the distribution of extent by file
size.
Example
fscheck: EXTENTDISTRIB ALL return
HELP
This command provides a list of the FSCHECK utility commands and a
description of the function of each.
Syntax
HELP
Parameters
None
Example
HELP Return
LISTREDO
This command displays the contents of the command line history stack,
from the least recently entered command to the most recently entered
command. It is identical in function to the LISTREDO command.
Syntax
LISTREDO
Parameters
None
Example
fscheck: LISTREDO Return
LOG
This command logs the user or program dialog to the specified file, as it
appears to the user.
Syntax
LOG [FILENAME=] filename
Parameters
filename Filename is any valid MPE/iX file name to which the
user has read/write access. It cannot be an
HFS-syntax file. If the file doesn't exist, it
will be created.
Example
fscheck: LOG FILENAME=FSCHKLOG Return
PURGEFILE [PF]
This command purges the specified file.
Syntax
PURGEFILE [FILENAME=]filename
Parameters
filename Specifies the file to be purged. The file
name may be an MPE/iX file of the form
filename[.group[.account]], or it may be a fully
qualified HFS pathname.
Examples
fscheck: PURGEFILE TEMP.PUB.SYS Return
fscheck: PURGEFILE /sys/dir1/myfile Return
REDO
This command edits and re-executes a command from the command line
history stack. It is identical in function to the REDO command.
Syntax
REDO [CMD=] cmd_id
Parameters
cmd_id Cmd_id identifies a particular command in the
command line history stack. It can be a number
relative to the last command (-n), an absolute
number (n) identifying the particular command, or a
string used to match a particular command in the
stack.
Example
fscheck: REDO CMD=5 Return
SYNCACCOUNTING [SA]
This command synchronizes the account and group disk space accounting
with the disk space information found in the file labels of all files on
a specified volume set. For system volume sets containing HFS
directories, disk space accounting is done for the account and group
structure only.
After performing SYNCACCOUNTING, the information reported by the REPORT
command will coincide with the information reported by the LISTF command.
Syntax
SYNCACCOUNTING [DEV=] [set_name] [;QUIET]
Parameters
The DEV parameter is optional. If omitted, the default is to synchronize
the account and group directories of the system volume set.
set_name Set_name is the name of the volume set whose
directories are to be synchronized. The volume set
must be opened. (The set's master volume must be
mounted in the MASTER state as displayed by the
DSTAT command).
QUIET QUIET specifies that the list of accounts and
groups processed should not be displayed on the
$STDLIST device. If ;QUIET is not specified
SYNCACCOUNTING displays a list of accounts and
groups as they are processed. The format of this
list is similar to the output of the REPORT
command. When the disk space accounting is
corrected for a group or account ACCOUNTING
CORRECTED is displayed next to the group or account
entry in the list.
Example
fscheck: SYNCACCOUNTING MPEXL_SYSTEM_VOLUME_SET return
TOTALEXTENTS [TE]
This command displays the total number of sectors occupied by directory
space, special space, permanent file space, spool file space, and new and
temp file space on the specified volume(s).
Syntax
ldev
TOTALEXTENTS [DEV=]set_name
ALL
Parameters
The DEV parameter is optional. If omitted, the default is to display the
extent totals on each mounted volume of the system volume set.
ldev Ldev is a number from 1 to 32,767, specifying the
logical device on which the extent totals on the
volume to be displayed is mounted. The volume must
be mounted in the MASTER or MEMBER state as
determined by the DSTAT command.
set_name Set_name is the name of the volume set whose extent
totals are to be displayed. The volume set must be
opened (the set's master must be mounted in the
MASTER state as displayed by the DSTAT command).
ALL ALL displays the extent totals on each volume
mounted in the MASTER or MEMGER state, as
determined by the DSTAT command.
Example
fscheck: TOTALEXTENTS ALL return
UNLOCKFILE [UF]
MPE/iX locks files whose extents contain bad sectors. This command
unlocks a locked file so that it can be purged or analyzed.
Syntax
UNLOCKFILE [FILENAME=] filename
Parameters
filename Filename is the fully qualified name of the file to
be unlocked.
Example
fscheck: UNLOCKFILE AFILE.BGROUP.CACCT return
USE
This command reads and executes commands contained in the specified file.
Syntax
USE [FILENAME=] filename
Parameters
filename Filename is any valid MPE/iX file name. The file
must already exist, and the user must have read
access.
Example
fscheck: USE FILENAME=FSCHKUSE Return