Administering Unidata on UNIX Platforms
Total Page:16
File Type:pdf, Size:1020Kb
C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINUNIX\ADMINUNIXTITLE.fm March 5, 2010 1:34 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta UniData Administering UniData on UNIX Platforms UDT-720-ADMU-1 C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINUNIX\ADMINUNIXTITLE.fm March 5, 2010 1:34 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Notices Edition Publication date: July, 2008 Book number: UDT-720-ADMU-1 Product version: UniData 7.2 Copyright © Rocket Software, Inc. 1988-2010. All Rights Reserved. Trademarks The following trademarks appear in this publication: Trademark Trademark Owner Rocket Software™ Rocket Software, Inc. Dynamic Connect® Rocket Software, Inc. RedBack® Rocket Software, Inc. SystemBuilder™ Rocket Software, Inc. UniData® Rocket Software, Inc. UniVerse™ Rocket Software, Inc. U2™ Rocket Software, Inc. U2.NET™ Rocket Software, Inc. U2 Web Development Environment™ Rocket Software, Inc. wIntegrate® Rocket Software, Inc. Microsoft® .NET Microsoft Corporation Microsoft® Office Excel®, Outlook®, Word Microsoft Corporation Windows® Microsoft Corporation Windows® 7 Microsoft Corporation Windows Vista® Microsoft Corporation Java™ and all Java-based trademarks and logos Sun Microsystems, Inc. UNIX® X/Open Company Limited ii SB/XA Getting Started The above trademarks are property of the specified companies in the United States, other countries, or both. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names as designated by the companies who own or market them. License agreement This software and the associated documentation are proprietary and confidential to Rocket Software, Inc., are furnished under license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the copyright notice. This software and any copies thereof may not be provided or otherwise made available to any other person. No title to or ownership of the software and associated documentation is hereby transferred. Any unauthorized use or reproduction of this software or documentation may be subject to civil or criminal liability. The information in the software and documentation is subject to change and should not be construed as a commitment by Rocket Software, Inc. Restricted rights notice for license to the U.S. Government: Use, reproduction, or disclosure is subject to restrictions as stated in the “Rights in Technical Data- General” clause (alternate III), in FAR section 52.222-14. All title and ownership in this computer software remain with Rocket Software, Inc. Note This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this product. Please be aware: Any images or indications reflecting ownership or branding of the product(s) documented herein may or may not reflect the current legal ownership of the intellectual property rights associated with such product(s). All right and title to the product(s) documented herein belong solely to Rocket Software, Inc. and its subsidiaries, notwithstanding any notices (including screen captures) or any other indications to the contrary. Contact information Rocket Software 275 Grove Street Suite 3-410 Newton, MA 02466-2272 USA Tel: (617) 614-4321 Fax: (617) 630-7100 Web Site: www.rocketsoftware.com SB/XA Getting Started iii Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Table of Contents Table of Contents Chapter 1 Introduction Introduction . 1-2 Audience . 1-3 Chapter 2 UniData and UNIX Security UNIX File Permissions . 2-3 Additional UNIX Access Modes . 2-5 UNIX umask . 2-7 UniData Default Permissions . 2-9 UniData Processes and root . 2-10 Chapter 3 UniData and the UNIX File System UniData Directories and Files . 3-3 Files, Pointers, and Links. 3-5 Creating Files. 3-5 Setting a UniData Pointer . 3-5 Setting an Environment Variable . 3-7 Setting a UNIX Link . 3-8 UniData Hashed Files . 3-10 Static Files. 3-10 Dynamic Files . 3-11 Sequentially Hashed Files . 3-13 DIR-Type Files . 3-16 Multilevel Files . 3-16 Multilevel Directory Files . 3-18 Index Files and Index Log Files . 3-19 UniData and tmp Space . 3-21 Changing TMP in the udtconfig File . 3-22 Setting an Environment Variable . 3-22 :\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINUNIX\ADMINUNIXTOC.fm bookTOC template) Chapter 4 UniData and Daemons What Is a Daemon? . 4-3 Principal UniData Daemons . 4-4 Shared Basic Code Server (sbcs) . 4-4 Shared Memory Manager (smm) . 4-5 Clean Up (cleanupd). 4-6 UniRPC Service (unirpcd) . 4-6 sync Daemon . 4-7 Monitoring UniData Daemons . 4-8 showud Command . 4-8 Log Files . 4-8 Chapter 5 UniData and Memory UNIX and Shared Memory . 5-3 UniData and Shared Memory . 5-4 smm and Shared Memory . 5-4 sbcs and Shared Memory . 5-11 Self-Created Segments . 5-11 UniData and the UNIX Kernel . 5-12 Chapter 6 UniData and UNIX ipc Facilities Message Queues . 6-3 UniData and Message Queues. 6-3 Semaphores . 6-5 Chapter 7 UniData and UNIX Devices UNIX Devices: Overview . 7-3 UniData and Terminal Devices . 7-4 UniData and Tape Devices . 7-5 UniData and Printers . 7-6 UniData and Serial Devices . 7-7 Chapter 8 Configuring Your UniData System Configuration Procedure . 8-3 Chapter 9 Starting, Stopping, and Pausing UniData Starting, Stopping, and Pausing UniData . 9-2 Normal Operation . 9-3 UniData Log Files . 9-3 Start UniData with startud . 9-4 Table of Contents v Stop UniData with stopud . 9-5 Pausing UniData . 9-6 The dbpause Command . 9-6 The dbpause_status Command . 9-7 Resuming Processing . 9-8 Additional Commands . 9-9 Listing Processes with showud . 9-10 Stopping a User Process with stopudt . 9-10 Stopping a User Process with deleteuser . 9-11 Displaying ipc Facilities with ipcstat . 9-12 Removing ipc Structures with udipcrm . 9-13 Stopping UniData with stopud -f . 9-13 Chapter 10 Managing UniData Accounts What Is a UniData Account? . 10-3 Creating a UniData Account . 10-4 Saving and Restoring Accounts . 10-8 Deleting an Account . 10-9 Clearing Space in UniData Accounts. 10-10 CLEAR.ACCOUNT . 10-10 Chapter 11 Managing UniData Security Logins and Groups . 11-3 Adding a UNIX User . 11-3 Use Separate Logon IDs . 11-4 User Groups . 11-4 Home Directories . 11-5 Startup Scripts . 11-5 Customizing Permissions . 11-7 Customizing a VOC File . 11-11 Customizing UniData . 11-12 Remote Items . 11-14 The SETFILE Command . 11-16 LOGIN and LOGOUT Paragraphs . 11-17 UniData SQL Privileges. 11-20 Field-Level Security for UniQuery . 11-21 Points to Remember about Field-Level Security . 11-21 The QUERY.PRIVILEGE File . 11-22 Turning on Field-Level Security . 11-24 vi Administering UniData on UNIX Chapter 12 Managing UniData Files UniData Hashed Files . 12-4 Static Hashed Files . 12-5 Dynamic Hashed Files. 12-6 Dynamic Files and Overflow . 12-6 Dynamic Files, Part Files, and Part Tables . 12-9 When Dynamic Files Are Created . 12-12 Tips and Constraints for Creating a Dynamic File . 12-14 When Dynamic Files Expand . 12-15 Management Tools for Dynamic Files . 12-18 Dynamic Files and Disk Space . 12-20 Sequentially Hashed Files . 12-24 File-Handling Commands . 12-28 File Corruption . 12-31 What Causes File Corruption? . 12-31 Preventing File Corruption. 12-31 UniData Detection Tools . 12-33 guide . 12-33 guide_ndx . 12-38 UniData Recovery Tools . 12-40 dumpgroup. 12-40 fixgroup . 12-41 fixfile . 12-42 Detection and Repair Examples . 12-47 How to Use guide . 12-48 Error Messages . 12-51 File Access Messages . 12-51 Block Usage Messages . 12-51 Group Header Messages . 12-52 Header Key Messages . 12-52 Other Header Messages. 12-52 Free Block Messages . 12-54 Long Record Messages . 12-54 Chapter 13 Managing UniData Locks The Global Lock Manager . 13-3 How GLM Works . 13-3 Locking in UniBasic . 13-5 How Locks Work. 13-5 Locking Commands . 13-6 Table of Contents vii Resource Locks . 13-8 Listing Locks . 13-9 LIST.READU . 13-9 Parameters . 13-9 LIST.LOCKS . 13-11 LIST.QUEUE . 13-12 LIST.QUEUE Display. 13-13 Commands for Clearing Locks . 13-17 SUPERCLEAR.LOCKS Command . 13-17 SUPERRELEASE Command . 13-19 Procedure for Clearing Locks . 13-20 Chapter 14 Managing UniData Users Adding Users . 14-3 Every User Needs a Logon ID . 14-3 Create Logon IDs at the UNIX Level . 14-3 Assign Users to Groups . 14-4 Monitoring User Processes . 14-5 UniData Commands . 14-5 Removing User Processes . 14-7 Using TIMEOUT . 14-8 Chapter 15 Managing Printers in UniData UniData and UNIX Spoolers . 15-3 Configuring the Spooler . 15-3 SETOSPRINTER Command . 15-6 Spooling from UniData . 15-7 UniData Printing Commands . ..