C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINNT\ADMINNTTITLE.fm March 5, 2010 12:39 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta UniData Administering UniData on Windows Platforms UDT-720-IM-1 C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINNT\ADMINNTTITLE.fm March 5, 2010 12:39 pm Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Notices Edition Publication date: July, 2008 Book number: UDT-720-IM-1 Product version: UniData 7.2 Copyright © Rocket Software, Inc. 1988-2008. 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 Administering UniData on Windows Platforms 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 Administering UniData on Windows Platforms 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 In This Introduction . 1-2 About This Manual . 1-3 Excluded Commands . 1-3 Reserved Characters . 1-4 Case Sensitivity . 1-5 Symbolic Links . 1-6 Phantom Command . 1-6 Dynamic Files . 1-7 Deleting Files. 1-7 PCPERFORM Command . 1-8 Shell Command Differences . 1-8 Use of Semicolon . 1-9 Notes About Terminal Devices and Tape Drives . 1-11 Terminal Devices . 1-11 Tape Devices . 1-11 Printing in UniData for Windows Platforms. 1-13 Chapter 2 Migrating Applications to UniData for Windows Platforms Migrating Applications to UniData for Windows Platforms . 2-3 Process Overview . 2-4 UniData Migration Tools . 2-6 NTMIGRATE File . 2-6 Copy the NTMIGRATE File . 2-7 Create VOC Entry and DICT for NTMIGRATE . 2-7 Set Pointers to NTMIGRATE. 2-8 Compile the UniBasic Tools Programs . 2-8 Special Considerations for UniData SQL. 2-9 Migrating Schema and Dictionaries . 2-9 Migrating privilege Tables. 2-10 :\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\ADMINNT\ADMINNTTOC.fm (bookTOC.template) March 5 2010 12:42 pm NT_SCOUT . 2-12 Output . 2-13 NTMIGRATE.LOC . 2-13 Using NT_SCOUT . 2-13 NT_CATALOG_MAP. 2-17 Output . 2-17 Using NT_CATALOG_MAP . 2-18 TAR2FTP . 2-19 Output . 2-19 Using TAR2FTP . 2-20 convcode, convdata, convidx . 2-24 Purpose . 2-24 Using convcode, convdata, and convidx . 2-24 NT_UPDATE_PATHS. 2-27 Using NT_UPDATE_PATHS . 2-27 NT_RECATALOGGER . 2-29 Using NT_RECATALOGGER . 2-29 SQL_UNIX_2_NT . 2-30 Using SQL_UNIX_2_NT. 2-30 Chapter 3 Managing and Using the UDTelnet Service Introduction . 3-3 Requirements for the UDTelnet Service. 3-3 Overview of Features . 3-5 Configurability . 3-5 Direct Access to UniData . 3-5 Security. 3-5 Secure Sockets Layer . 3-6 Terminal Emulation . 3-6 Integration with UniData Serial Terminal Support . 3-7 Configuring the UDTelnet Service . 3-8 Service Options . 3-10 User Profiles . 3-13 Customizing User Profiles . 3-15 Generated Profiles . 3-18 Starting, Stopping and Pausing UDTelnet. 3-20 Controlling UDTelnet from UniData Admin . 3-20 Controlling UDTelnet from the Control Panel. 3-21 Configuring SSL for Telnet . 3-22 Table of Contents v Chapter 4 Managing and Using the UDSerial Service Introduction . 4-3 Requirements . 4-3 Overview of Features . 4-5 Security . 4-5 Terminal Emulation . 4-5 Logging . 4-6 Integration with UniData Telnet Service . 4-6 Configuring the UniData Terminal Server . 4-7 Service Option . 4-8 Port Configuration . 4-9 Control Keys . 4-12 Modem Options. 4-13 Logon Script. 4-15 Auto Connection . 4-16 Starting and Stopping the UniData Terminal Server. 4-18 Controlling UDSerial from UniAdmin . 4-18 Controlling UDSerial from the Control Panel . 4-19 Chapter 5 UniData and Services UniData and Services . 5-2 What Is a Service? . 5-3 Principal UniData Services . 5-4 Shared Basic Code Server (sbcs) . 5-4 Shared Memory Manager (smm) . 5-5 Clean Up (cleanupd). 5-6 Monitoring UniData Services . 5-7 Log Files . 5-8 Chapter 6 UniData and Memory Windows Platforms and Shared Memory . 6-3 UniData and Shared Memory . 6-4 smm and Shared Memory . 6-4 Learning about Global Pages . 6-10 Learning about Local Control Tables . 6-11 sbcs and Shared Memory . 6-13 Self-Created Segments . 6-13 Chapter 7 Configuring Your UniData System Configuring Your UniData System . 7-2 vi Administering UniData on Windows Platforms Configuration Procedure . 7-3 1. Identify Disk Requirements . 7-3 2. Identify Memory Requirements. 7-3 3. Verify Version Compatibilities . 7-4 4. Check/Reset System-Level Parameters . 7-4 5. Check/Reset UniData Configuration Parameters . 7-4 6. Define Peripherals within UniData . 7-5 7. Create UniData Accounts . 7-5 8. Add Windows Users. 7-6 9. Set Environment Variables . 7-6 10. Review UniData Security . 7-8 11. Convert Data Files. 7-8 12. Review Backup Procedures . 7-9 Chapter 8 Starting, Stopping, and Pausing UniData Normal Operation . 8-3 UniData Log Files . 8-3 Start UniData with startud . 8-4 Stop UniData with stopud. 8-5 Pausing UniData . 8-6 The dbpause Command . 8-6 The dbpause_status Command . 8-7 Resuming Processing . 8-8 Additional Commands. 8-9 Stopping a User Process with stopudt . 8-9 Stopping a User Process with deleteuser . 8-10 Displaying ipc Facilities with ipcstat . 8-11 Stopping UniData with stopud -f. 8-12 Chapter 9 Managing UniData Accounts What Is a UniData Account?. 9-3 Creating a UniData Account. 9-4 Deleting an Account . 9-8 Clearing Space in UniData Accounts . 9-9 CLEAR.ACCOUNT. 9-9 Chapter 10 Managing UniData Security Customizing Permissions . 10-3 Customizing a VOC File . 10-6 Removing Entries . 10-6 Table of Contents vii Customizing UniData . 10-8 Remote Items . 10-10 The SETFILE Command . 10-12 LOGIN and LOGOUT Paragraphs . 10-13 UniData SQL Privileges. 10-16 Field-Level Security for UniQuery . 10-17 Points to Remember about Field-Level Security . 10-17 The QUERY.PRIVILEGE File . 10-18 UniQuery Processing . 10-20 Turning on Field-Level Security . 10-20 Chapter 11 Managing UniData Files UniData Hashed Files . 11-4 Static Hashed Files . 11-5 Dynamic Hashed Files . 11-6 Dynamic Files and Overflow . 11-6 When Dynamic Files Are Created . 11-9 Tips and Constraints for Creating a Dynamic File . 11-10 Dynamic Files and Disk Space . 11-11 Sequentially Hashed Files . 11-17 The over001 File . 11-17 The gmekey File . 11-18 DIR-Type Files . 11-20 Multilevel Directory Files . 11-23 Index Files and Index Log Files . 11-25 Index-Related Files for a Static Hashed File . ..