HPlogo 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