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 ALL Return |
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
Parameters
Example
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
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 1 Return |
EXIT
[E] |
|
This command terminates the FSCHECK utility and returns to the process from which
it was invoked.
Syntax
Parameters
Example
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
Parameters
Example
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
Parameters
Example
LOG |
|
This command logs the user or program dialog to the specified
file, as it appears to the user.
Syntax
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
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
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
|
Printable version
