MPE/iX System Utilities Reference > Chapter 9 FSCHECK

Operation

	MPE documents
	Complete PDF
	Table of Contents
	Index

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


          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 1  Return

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

Chapter 9 FSCHECK

Chapter 10 I7DB8CNV

Operation

MPE documents

CHECKDIRC [CD]

CHECKEXTENTS [CE]

CHECKLABEL [CL]

CHECKFILE [CF]

CHECKALL [CA]

DEBUG

DISPLAYLABEL [DL]

DISPLAYEXTENTS [DE]

DISPLAYLOCKFILE [DLF]

DO

EMPTYSLOUGH [ES]

EXIT [E]

EXTENTDISTRIB [ED]

HELP

LISTREDO

LOG

PURGEFILE [PF]

REDO

SYNCACCOUNTING [SA]

TOTALEXTENTS [TE]

UNLOCKFILE [UF]

USE