sFILES UTILITY Release Level 1.02.030 This application consists of one runfile: sFiles.run with a command case of 01 Product Name : sFiles Supported On : B24, B26, B27, B28, B38, B39, and all SuperGen hardware Supported OS : BTOS II, CTOS I, CTOS II, CTOS III Description : This program allows the creation of lists of files with a powerful, flexible sorting capability. Directions/Use : This application may be run by executing the /sFiles executive command using the following mandatory and optional fields: File List This parameter is required. This may utilize any CTOS Executive recognized wild cards. @-files may be used and may include wild cards (but not embedded @-files). (Note: the 'Files' wildcard ~ is NOT supported). Multiple sub- parameters may be specified. [Sort (ndvmacse)] This parameter is optional. The default is not to sort the file list. This is described in more detail below. [Print File] This parameter is optional. The default is [vid]. This specifies the destination for the output report. [Names Only?] This parameter is optional. The default is no. If 'yes', the report shows only file names (it may still be sorted on other non-printed items however). This is handy for creating files that can easily be edited and used as @-files to other commands. If 'no', the report shows several details about each file. [Max Files] This parameter is optional. The default is no maximum. This is used to restrict the number of files reported after sorting. This is handy for listing, say, the largest 50 files, or the oldest 100 files. Sort specifications The Sort specification is constructed by concatenating each of the desired key specifiers into a single string. Multiple reports may be created is a single disk-parse in different sort orders by specifying multiple sort orders. The Key specifiers: n File Name d Directory Name v Volume Name m Modify Date a Access Date c Create Date s Size e Extents Key specifiers in lower-case mean "Ascending order" (lower items first). Key specifiers in UPPER-CASE mean "Descending order" (BIGGER items first). Sorts done on 'Name' fields are case insensitive on the data within the field. Examples: [Sort (ndvmacse)] ES This specifies that the report is sorted by Number of Extents (Descending order) as the major key, with Size (also descending) as a minor key. This report shows the most fragmented files first and within each level of fragmentation, the files are in size order. [Sort (ndvmacse)] dSv This specifies that the report is sorted by directory name (Ascending) as the major key, with Size (descending) as a minor key and the volume name (ascending) as the most minor key. [Sort (ndvmacse)] nd dS This specifies that the report is created in two parts, the first is sorted by file name and directory name, the second part is sorted by directory name and Descending file size. Only the first Date specifier is used, any subsequent data specifiers are ignored. The date specifier used also determines which date appears in the report. If no date specifier is given, the Modify date appears in the report. Sample Report: FileId Dir Vol Modified Size Extents sfiles.run Tools2 Sys 01/12/92 11:17 AM 132936 1 DiskBenchmark.run Tools2 Sys 05/04/92 12:08 AM 92160 1 LogComment.run Tools2 Sys 05/04/92 1:09 AM 3333 1 Number of Files = 3, Total Sectors = 447 Restrictions: The maximum number of files reported is limited only by available disk space for the work and sort files. The program creates a work file ".tmp" in the current path. This file can get very large when large numbers of files are reported. COMMAND /sFiles File List [Sort (ndvmacse)] [Print File] [Names Only?] [Max Files]