SORTFILE: file reporting by user ID

Description

Lists disk files by owner ID, with selections for user ID, volume, and file type. Sums disk usage by user. Can be used to monitor disk usage and encourage users to clean up excess files.

Categories

Disk Management

Related files

SORTFILE: Object file for program.

User Instructions

The purpose of SORTFILE is to assist the system administrator in managing disk storage by producing listings of files usage sorted by owner ID. These listings can assist in getting users to realize the cost of their file usage and encourage better housekeeping.

The OPTIONS screen allows the user to select the range of user IDs to be searched for. Valid options are: ALL, which lists all files by user ID; USERLIST, which lists only files for current users; SELECT, which lists files for specific users entered on the ID#LIST screen; and UNLISTED, which only lists files owned by non-current users.

Following the list type choice are screens to select the VOLUMES and file TYPES and to enter an identifying header for the report. At the conclusion of the report, the user may exit, re-run the utility, or display the print file from the last run.

The report produced by SORTFILE includes the file name and location, record size, count, and type, file class, modification history, and the amount of disk space used and allocated. The report is sorted by user ID, with a page break at every change and the sum of disk blocks used and allocated.

Programmer Instructions

SORTFILE is ideally suited for automated usage, as all of its screens are GETPARMs. Since the workstation does not display progress of the search, SORTFILE may also be used in background procedures.

OPTIONS     Press (RETURN) to continue, PF(16) to exit
            program.

  LISTTYPE  ALL         Listing option.  Select ALL,
                        USERLIST, SELECT, or UNLISTED.  (See
                        User Instructions (above) for further
                        information on these options.)

ID#LIST     Optional; appears only if LISTTYPE/=/SELECT on
            the OPTIONS screen.  Enter information and press
            (RETURN) to continue, PF(01) to return to the
            OPTIONS screen, or PF(03) to delete an ID from
            list.  This screen may be repeated as many times
            as necessary to enter all applicable user IDs.

  USERID    (blank)     The user ID to be added to the list.
                        Leave blank to end input.

VOLUMES     Enter information and press (RETURN) to continue,
            PF(02) to select all volumes, or PF(01) to return
            to the ID#LIST screen.  (Individual volumes may
            be selected only when the program is run
            interactively.  Under program control use PF(02)
            to select all volumes.

TYPES       Enter information and press (RETURN) to continue,
            PF(02) to select all types, or PF(01) to return
            to the VOLUMES screen.  (Individual file types
            may be selected only when the program is run
            interactively.  Under program control, use PF(02)
            to select all types.)

MESSAGE     Enter information and press (RETURN) to continue,
            or press PF(01) to return to the TYPES screen.

  PART1     (blank)     Identifying headers for the report.
  PART2     (blank)     Up to 66 characters may be entered on
                        each line.

EOJ         Press PF(01) to run again, PF(14) to display
            listing from last run, or PF(16) to exit program.

Example of use

Run periodically to monitor disk usage by user and help encourage disk maintenance.

Comments

The UNLISTED option can help secure the system by identifying files left by users that have recently departed the organization.