1 Subject: PRIMOS Release: 23.4 Date: March 26, 1993 1. New Functionality + _________________ 1.1 Extended Memory for the 5000 Series + ___________________________________ At Rev 23.4, you can increase the main memory of system models 5310, 5320, 5330 and 5340 from 128 MB to 512 MB. Before using this extended memory, check with your service representative to ensure you have received and installed all applicable hardware and microcode updates. 1.2 Online FIX_DISK + _______________ PRIMOS Rev. 23.4 supports Online FIX_DISK. Online FIX_DISK is the ability to check and repair, if necessary, a disk partition when the disk partition is online. That is, FIX_DISK can be run without shutting down the disk partition. Online FIX_DISK is part of the PRIMOS 23.4 FIX_DISK version. The -ONLINE command line option tells FIX_DISK that the disk partition is online and to do an Online check or repair. The following FIX_DISK command line options are NOT supported by Online FIX_DISK: -COMMAND_DEVICE (-COMDEV) -CONVERT_19 -CONVERT_20 -CONVERT_21 -CONVERT_22.1 -INTELLIGENT_CONTROLLER (-IC) -ALL_CONTROLLER (-AC) -DBS -UFD_COMPRESSION (-CMPR) -AUTO_TRUNCATION (-AT) Note: The command device is checked/repaired online by just specifying the physical device number (PDEV) of the command device without the -Command_Device option. 1 The -PARTIAL command line option for FIX_DISK is released at 23.4. -PARTIAL takes a pathname as an argument. The pathname is specified without the name of the disk partition. When -PARTIAL is specified to FIX_DISK, the traversal of the file system on the disk partition is traversed until the file system object pointed to by the pathname is found. If the file system object is a file, then just the file is checked and repaired, if needed and requested. If the file system object is a directory then that complete sub-tree is checked and repaired, if needed and requested. Online Fix_Disk will NOT add a bad spot if it belongs to a directory, a ufd or a Segment Directory. The following FIX_DISK command line options are NOT supported with the -PARTIAL command line option: -UFD_COMPRESSION (-CMPR) -ADD_BADSPOT -CONVERT_19 -CONVERT_20 -CONVERT_21 -CONVERT_22.1 -DBS (-IC/-AC) -SECTOR (-ODI/-RDI) -MIN_EXTENT_SIZE -MAX_EXTENT_SIZE Previous versions of FIX_DISK output one of two messages about the state the disk partition. Disk not properly shutdown. Full fix disk will be run. The quota system may be incorrect. FIX_DISK now outputs more informative messages. The important information for either cases above is that the file system may be incorrect! The first case is that the last time the disk partition was not shutdown. Fix_Disk will now output the following messages for the first case. Disk not properly shutdown. The file system may be incorrect. When the disk is online, it follows that the disk is NOT shutdown! The 1 second case occurs when the disk partition was added without being fixed. Inconsistency between the On-Disk RAT and file system objects is significantly more important than directory quotas. Fix_Disk will now output the following messages for the second case. The file system may be incorrect. The disk was previously not shutdown properly. Previous versions of FIX_DISK output one of three messages about the state of the On-Disk RAT. "DSKRAT OK" "DSKRAT MISMATCH!" "DSKRAT UPDATED!" FIX_DISK now outputs additional messages when the On-Disk RAT is inconsistent. These messages will be output, when appropriate, whether the disk is online or assigned. The new messages are: "There are free (orphaned) records in the DSKRAT." "There are free (orphaned) records in the DSKRAT and/or there were files truncated or deleted by Fix_Disk." "In use records were missing from the DSKRAT!" If free (orphaned) records are the only reason that the On-Disk RAT is inconsistent, there were no other file system errors reported by FIX_DISK, and FIX_DISK was run without the -FIX option, i.e. the On-Disk RAT was not updated, then FIX_DISK needs to only be rerun with the -Fix option when the administrator is concerned about the disk partition becoming full. However, in use records missing from the On-Disk RAT is a serious problem and the disk partition should be repaired. Please note: When FIX_DISK was run with compression requested (-UFD_COMPRESSION (-CMPR)), the message: "There are free (orphaned) records in the DSKRAT and/or there were files truncated or deleted by Fix_Disk." can be a result of orphaned records that were generated through UFD compression. When FIX_DISK truncates or deletes files, FIX_DISK will identify those files. It is important to review the output from FIX_DISK to check for these messages. For further information please refer to the Operators Guide to File System Maintenance, UPD9300-6LA. 1.3 CPL Enhancement + _______________ The performance of CPL has been improved; CPL programs that primarily 1 execute active functions and CPL directives will benefit most. Small CPL programs that simply execute Primos commands or run non-CPL programs will benefit little. 1.4 New MATCH Utility + _________________ MATCH is a program that searches for text strings within files. It can be invoked from the command line by typing: MATCH string [-option],... If you type the word MATCH and press return, it prompts you for a search string plus any additional options. You can also invoke Help for MATCH by entering MATCH -Help at the command line. MATCH is aware of three types of files: ASCII, Binary, and PrimeWORD. PrimeWORD files are displayed as Muse files. MATCH has over a dozen options, and is capable of extended wildcarding. Both these features make MATCH a powerful tool. In the following example, MATCH displays the filenames and text lines within each file that match the requested string: MATCH 23.4 + __________ [MATCH Rev. 23.4 Copyright (c) 1993, Computervision Corporation] Warning: FILE.RPA assumed to be a binary file File: MATCH_DOCUMENTATION 1: This file documents MATCH at PRIMOS REV. 23.4 File: SPOOLER_DOC 3: This file documents SPOOLER at PRIMOS Rev. 23.4 File: ONLINE 2: This file documents the Online FIX_DISK program at PRIMOS Rev. 23.4 File: CONFIG_USERS.DOC 1: This file documents CONFIG_USERS at PRIMOS Rev. 23.4 MATCH Options MATCH has many options which allow a user to specify, in great detail, a string of information for the program to find. Many options can be combined. An option can be invoked by entering the option word, or the first letter of the option word. The following is a list of MATCH options: -ALLBINARY -A Searches all files as if they were binary files, i.e. with no space compression or newlines. Files that actually appear to be binary are 1 not searched if you also include the -NOBINARIES option. -BRIEF -B Does not print a warning if an unexpected file type is found (for example, if the file X.BIN appears to be ASCII). -CASEDEPENDENT -C Only matches in a case-dependent fashion. -DEEPWILD -D Applies the supplied wildcarding criteria to files and segdirs at the current and lower levels. UFDs are always searched. If you use the -D option without the -LEVELS option, it has no effect. -FILES