HPlogo MPE/iX System Utilities Reference Manual > Chapter 9 FSCHECK

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

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

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

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
  fscheck:  CHECKFILE /mydir/myfile1

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

DEBUG

The DEBUG command invokes the native mode system.

Syntax 

  DEBUG
Parameters
None
Example 

  fscheck:  DEBUG

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

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
  fscheck: DISPLAYEXTENTS /sys/mydir1/myfile

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

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

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

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

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 and 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

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

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

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

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
  fscheck: PURGEFILE /sys/dir1/myfile

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

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

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

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

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



Chapter 9 FSCHECK

Chapter 10 I7DB8CNV