home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 14 Text / 14-Text.zip / netwseb.zip / A3AA3MST.INF (.txt)
OS/2 Help File  |  1999-03-19  |  580KB  |  17,612 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Edition Notice ΓòÉΓòÉΓòÉ
  3.  
  4. Note  Before using this information and the product it supports, read the 
  5.       general information under Notices. 
  6.  
  7. First Edition 
  8.  
  9. This edition applies to the first edition of OS/2 Warp Server for e-business 
  10. and to any subsequent releases and modifications until otherwise indicated in 
  11. new editions. 
  12.  
  13.  
  14. ΓòÉΓòÉΓòÉ 2. About This Book ΓòÉΓòÉΓòÉ
  15.  
  16. This book contains information about network administration tasks you can 
  17. accomplish using OS/2 Warp Server for e-business. 
  18.  
  19. The information in this book includes the following: 
  20.  
  21.      Using the graphical user interfaces (GUIs) 
  22.  
  23.      Handling network administrator tasks 
  24.  
  25.      Setting up and backing up a domain 
  26.  
  27.      Managing users and groups 
  28.  
  29.      Sharing network resources with aliases and netnames 
  30.  
  31.      Defining access control profiles 
  32.  
  33.      Limiting directory space accessed by users 
  34.  
  35.      Managing WorkSpace On-Demand, OS/2, DOS, and Microsoft Windows 
  36.       applications 
  37.  
  38.      Printing on the network 
  39.  
  40.      Managing network services, statistics, and audit and error logs 
  41.  
  42.      Managing Local Security on 386 HPFS servers 
  43.  
  44.      Using Fault Tolerance 
  45.  
  46.      Replicating files 
  47.  
  48.      Using remote initial program load (remote IPL) 
  49.  
  50.      Using the Uninterruptible Power Supply (UPS) service 
  51.  
  52.      Using the OS/2 Warp Server or LAN Server directory structure 
  53.  
  54.      Using User Profile Management (UPM) procedures 
  55.  
  56.  The appendixes contain information on directory structures and utilities. 
  57.  
  58.  Notes: 
  59.  
  60.    1. Many administrator tasks can be performed through the command line. 
  61.       Information about network commands is provided in the Command Reference. 
  62.  
  63.    2. Information on user tasks is provided in the OS/2 File and Print Client 
  64.       Guide. 
  65.  
  66.    3. Other books contain complementary information.  For more information, see 
  67.       Prerequisite Books and  Related Books. 
  68.  
  69.  For more information about this book, see the following topics: 
  70.  
  71.      Who Should Use This Book 
  72.  
  73.      How This Book Is Organized 
  74.  
  75.      Conventions 
  76.  
  77.      Online Books and Other Information 
  78.  
  79.      Prerequisite Books 
  80.  
  81.      Related Books 
  82.  
  83.      Note About 386 HPFS 
  84.  
  85.  
  86. ΓòÉΓòÉΓòÉ 2.1. Who Should Use This Book ΓòÉΓòÉΓòÉ
  87.  
  88. This book is a reference for the OS/2 Warp Server or LAN Server network 
  89. administrator.  The network administrator is responsible for installing, 
  90. managing, controlling, and configuring a network.  The network administrator 
  91. also defines resources to be shared and user access to the shared resources. 
  92.  
  93. Additional users of this book include OS/2 Warp Server users who have been 
  94. given one or more administrative privileges for a server running OS/2 Warp 
  95. Server or LAN Server. 
  96.  
  97. Before you begin the tasks in this book, you should plan your network, install 
  98. the appropriate OS/2 Warp Server or LAN Server components on the clients and 
  99. servers in your network, and make sure that your DOS workstations have one of 
  100. the appropriate DOS versions installed.  Refer to Quick Beginnings for more 
  101. information. 
  102.  
  103.  
  104. ΓòÉΓòÉΓòÉ 2.2. How This Book Is Organized ΓòÉΓòÉΓòÉ
  105.  
  106. This book contains the following chapters and appendixes: 
  107.  
  108.      Using OS/2 Warp Server for e-business: Overview provides an overview of 
  109.       the network administrator-only tasks and the graphical user interface 
  110.       (GUI) used to do those tasks.  This chapter also discusses getting help 
  111.       from the GUI and the command-line interface. 
  112.  
  113.      Setting Up the Domain outlines the steps for setting up your domain and 
  114.       describes setting the time and date, defining servers, backing up the 
  115.       domain control database, and printing the domain definition. 
  116.  
  117.      OS/2 Warp Server Personally Safe n Sound (PSnS) describes OS/2 Warp 
  118.       Server Backup/Restore and provides some references for more information. 
  119.  
  120.      Managing Users and Groups describes adding, updating, and deleting users 
  121.       and groups from the domain. 
  122.  
  123.      Sharing Network Resources describes sharing and managing network 
  124.       resources, including files, printers, and serial devices.  This chapter 
  125.       also discusses using aliases and netnames to share resources. 
  126.  
  127.      Defining Access Control Profiles discusses the access control system and 
  128.       creating, changing, and deleting user access to resources. 
  129.  
  130.      Limiting Space within Directories on 386 HPFS Servers discusses the 
  131.       management of disk space on servers.  You can apply limits to a directory 
  132.       tree to control its size and to limit space available to users. 
  133.  
  134.      Managing OS/2, DOS, WorkSpace On-Demand, and Windows Applications 
  135.       discusses creating, updating, and deleting shared OS/2 and DOS 
  136.       applications, and preparing for running remote programs. 
  137.  
  138.      Managing Windows Applications for DOS LAN Services discusses how to 
  139.       provide network services to users of DOS LAN Services Windows. 
  140.  
  141.      Network Printing discusses how to set up and manage network print spooler 
  142.       queues, define separator pages, and attach printers to the network. 
  143.  
  144.      Managing the Network describes common network management activities, such 
  145.       as stopping and starting network services, managing serial device queues, 
  146.       and closing open files and active sessions.  It discusses auditing, 
  147.       setting server and client parameters, and error logging, and includes a 
  148.       brief description of the network management tool First Failure Support 
  149.       Technology/2 (FFST/2). 
  150.  
  151.      Managing Local Security on 386 HPFS discusses Local Security for the 386 
  152.       HPFS.  It provides guidelines and considerations for Local Security. 
  153.  
  154.      Using Fault Tolerance describes how to configure and manage the Fault 
  155.       Tolerance system for hard disks. It also discusses error monitoring for 
  156.       the Fault Tolerance system. 
  157.  
  158.      Replicating Files describes using the Replicator service to copy files 
  159.       from a server to one or more servers or clients. 
  160.  
  161.      Installing and Configuring Remote IPL describes installing Remote IPL 
  162.       with the RIPLINST utility and configuring DHCP Boot. 
  163.  
  164.      Managing Remote IPL describes creating, customizing, and deleting remote 
  165.       IPL workstations. 
  166.  
  167.      The Uninterruptible Power Supply Service describes support for the 
  168.       Uninterruptible Power Supply (UPS) service. 
  169.  
  170.      Directory Structure describes the LAN directory structure for clients, 
  171.       servers, and domain controllers. 
  172.  
  173.      User Profile Management describes the use of User Profile Management to 
  174.       add, update, and delete users and groups from the domain. 
  175.  
  176.      OS/2 Warp Server Interoperability identifies how the various versions of 
  177.       OS/2 Warp Server, LAN Server, and PCLP work together. 
  178.  
  179.      DHCP RIPL Bootstrap Messages identifies the Remote IPL error messages 
  180.       (and help for them) supported by ROM BIOS. 
  181.  
  182.  This book also contains an index. 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 2.3. Conventions ΓòÉΓòÉΓòÉ
  186.  
  187. This book includes several usability aids and conventions to help you find and 
  188. identify the information you need.  The following sections describe these 
  189. usability aids and conventions: 
  190.  
  191.      Double-Byte Character Set (DBCS) Information 
  192.  
  193.      Notes 
  194.  
  195.      Attention Notes 
  196.  
  197.      Highlighting Conventions 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 2.3.1. Double-Byte Character Set (DBCS) Information ΓòÉΓòÉΓòÉ
  201.  
  202. OS/2 Warp Server and LAN Server run on both single-byte character set (SBCS) 
  203. systems and double-byte character set (DBCS) systems.  SBCS is a graphic 
  204. character set in which each character occupies 1 byte. DBCS is a graphic 
  205. character set in which each character occupies 2 bytes.  Languages, such as 
  206. Japanese, Chinese, and Korean, that contain more symbols than can be 
  207. represented by 256 code combinations require double-byte character sets. 
  208.  
  209. DBCS information is included throughout this book. Restrictions for DBCS 
  210. systems are indicated by the following: 
  211.  
  212. DBCS Note  The preceding access control profiles do not propagate to DBCS 
  213.            systems. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 2.3.2. Notes ΓòÉΓòÉΓòÉ
  217.  
  218. Notes provide important information that can affect the operation of the 
  219. product or the completion of the task, as shown in the following example: 
  220.  
  221. Note:  If you later add more users to the group, you must repeat this procedure 
  222.        to add the application for the new users. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 2.3.3. Attention Notes ΓòÉΓòÉΓòÉ
  226.  
  227. Attention notes indicate situations where you can lose data or damage software 
  228. or hardware if certain procedures are not followed, as shown in the following 
  229. example: 
  230.  
  231. Attention  If you have applications running on the Desktop and do not perform a 
  232.            shutdown procedure before you turn off your computer, you may lose 
  233.            data. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 2.3.4. Highlighting Conventions ΓòÉΓòÉΓòÉ
  237.  
  238. Below are the highlighting conventions used throughout this book and the things 
  239. they are used to identify: 
  240.  
  241.  CAPITAL LETTERS 
  242.  
  243.                Commands 
  244.  
  245.                Directory names 
  246.  
  247.                File names 
  248.  
  249.  Bold      Controls (when used in procedures), for example: 
  250.  
  251.                Menu bar choices 
  252.  
  253.                Radio buttons 
  254.  
  255.                Push buttons 
  256.  
  257.                List boxes 
  258.  
  259.                Check boxes 
  260.  
  261.                Entry fields 
  262.  
  263.                Read-only text fields 
  264.  
  265.  Italics 
  266.  
  267.                Book and diskette titles 
  268.  
  269.                Variable names and values 
  270.  
  271.                Technical terms when introduced 
  272.  
  273.                Words of emphasis 
  274.  
  275.  Monospace 
  276.  
  277.                Coding examples 
  278.  
  279.                Special characters 
  280.  
  281.                Text reader must type 
  282.  
  283.                Text displayed on the computer screen 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 2.4. Online Books and Other Information ΓòÉΓòÉΓòÉ
  287.  
  288. Many OS/2 Warp Server books are shipped in online form with the product. You 
  289. can view the books from a CD-ROM drive, install them on your hard disk, or view 
  290. them remotely (if they are installed on a server in the domain).  After 
  291. installation, you can access online books and troubleshooting information from 
  292. the Assistance Center.  See Quick Beginnings for a list of OS/2 Warp Server for 
  293. e-business books. 
  294.  
  295. Note:  You can print sections of the online books by using the Print function 
  296.        on the menu bar while viewing the books. Also, many books are shipped in 
  297.        PostScript and Adobe format; these can be printed. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 2.5. Prerequisite Books ΓòÉΓòÉΓòÉ
  301.  
  302. Quick Beginnings: Installing OS/2 Warp Server for e-business is a prerequisite 
  303. for using this book. This book is also referred to as Installation. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 2.6. Related Books ΓòÉΓòÉΓòÉ
  307.  
  308. The following books are helpful for the user whose system is connected to a 
  309. local area network (LAN): 
  310.  
  311.      OS/2 File and Print Client Guide 
  312.  
  313.      DLS and Windows User's Guide 
  314.  
  315.  The following books are also helpful for network administrators: 
  316.  
  317.      OS/2 Warp Server for e-business Performance Tuning 
  318.  
  319.      OS/2 Warp Server for e-business Serviceability and Troubleshooting Guide 
  320.  
  321.      OS/2 Warp Server for e-business Command Reference 
  322.  
  323.      OS/2 Warp Server for e-business Programming Guide and Reference 
  324.  
  325.      MPTS Configuration Guide 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 2.7. Note About 386 HPFS ΓòÉΓòÉΓòÉ
  329.  
  330. In the previous release of OS/2 Warp Server, two different levels of servers 
  331. (Entry and Advanced) were offered. The Advanced Level Server included both HPFS 
  332. and 386 HPFS. In this release, 386 HPFS is available if you are upgrading from 
  333. an Advanced Level Server. However, if you don't already have the Advanced Level 
  334. Server and you're interested in some of the features offered only through 386 
  335. HPFS (such as local security), 386 HPFS is available for an additional fee. See 
  336. Limiting Space within Directories on 386 HPFS Servers, Managing Local Security 
  337. on 386 HPFS, and Using Fault Tolerance to read about some of the features of 
  338. 386 HPFS. 
  339.  
  340.  
  341. ΓòÉΓòÉΓòÉ 3. Using OS/2 Warp Server for e-business: Overview ΓòÉΓòÉΓòÉ
  342.  
  343. This chapter briefly describes the network administrator tasks you can perform 
  344. using OS/2 Warp Server for e-business and introduces the LAN Server 
  345. Administration interface. 
  346.  
  347. For more information, see the following topics: 
  348.  
  349.      Network Administrator Tasks 
  350.  
  351.      Graphical User Interfaces and Icons 
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ 3.1. Network Administrator Tasks ΓòÉΓòÉΓòÉ
  355.  
  356. The following list is an overview of the network administrator tasks: 
  357.  
  358.      Setting up a domain with a domain controller, backup domain controllers, 
  359.       additional servers, and remote IPL servers 
  360.  
  361.      Performing domain controller database (DCDB) backup on your domain 
  362.       controllers 
  363.  
  364.      Adding, deleting, and updating users, groups, and network applications 
  365.  
  366.      Defining access permissions to resources for users and groups 
  367.  
  368.      Starting and stopping the sharing of directories, printers, and serial 
  369.       devices 
  370.  
  371.      Configuring and managing Fault Tolerance for your network 
  372.  
  373.      Setting up remote IPL from a server for a DOS or an OS/2 requester 
  374.  
  375.      Controlling and accessing servers from any server or requester on the 
  376.       network running OS/2 Warp Server. 
  377.  
  378.      Scheduling tasks to run at designated times on a server 
  379.  
  380.      Limiting the directory space available to users 
  381.  
  382.      Viewing the network status and network statistics 
  383.  
  384.  Users can perform a subset of these tasks. For information on user tasks, 
  385.  refer to the OS/2 File and Print Client Guide or the DLS and Windows User's 
  386.  Guide. 
  387.  
  388.  For problem determination tasks, refer to the Serviceability and 
  389.  Troubleshooting Guide. For performance tuning tasks, refer to Performance 
  390.  Tuning. 
  391.  
  392.  You can perform network administrator tasks from either LAN Server 
  393.  Administration or the command-line interface. For information on the 
  394.  command-line commands, refer to the Command Reference . 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ 3.2. Graphical User Interfaces and Icons ΓòÉΓòÉΓòÉ
  398.  
  399. The following list describes each GUI and its functions: 
  400.  
  401.   Icon      Function
  402.  
  403.            Logon: allows you to perform domain logon and local logon (for 
  404.            subsystems requiring local verification).  OS/2 Warp Server does not 
  405.            require local logon. 
  406.  
  407.             Logoff: allows you to log off the domain.  Make sure all network 
  408.            applications are closed before logging off. 
  409.  
  410.             LAN Server Administration: allows you to administer a network 
  411.            running OS/2 Warp Server.  The interface replaces the full-screen 
  412.            interface used in previous versions of LAN Server. Enhancements from 
  413.            the full-screen interface include the ability to drag and drop some 
  414.            objects, the ability to manage user and group definitions, and the 
  415.            ability to limit directory sizes on users' home directories. 
  416.            National Language Support (NLS) characters entered by using ALT+ 
  417.            number on the keyboard cannot be used on notebook pages in this GUI. 
  418.            (This is a Presentation Manager restriction.) Administration of 
  419.            NLS-specific names must be done using a workstation configured for 
  420.            the appropriate language (keyboard and country code). 
  421.  
  422.             Audit Log: records OS/2 Warp Server events and user-defined events 
  423.  
  424.             Error Log: records OS/2 Warp Server errors, showing the error 
  425.            messages and help text 
  426.  
  427.             Tuning Assistant GUI: provides automatic tuning and configuration 
  428.            of your network 
  429.  
  430.             Network Messaging GUI: provides the interface for sending and 
  431.            receiving network messages 
  432.  
  433.             Network DDE and Clipboard GUI: provides the ability to cut and 
  434.            paste data into other applications on the network using dynamic data 
  435.            exchange (DDE) and Clipboard functions 
  436.  
  437.             Installation/Configuration GUI: The OS/2 Warp Server 
  438.            Installation/Configuration program.  Use this to reinstall or remove 
  439.            OS/2 Warp Server from the local workstation.  You can also create 
  440.            response files (for CID install) from this interface. 
  441.  
  442.             Start Server GUI: starts the Server service on the workstation. 
  443.  
  444.             MPTS GUI: configures PROTOCOL.INI file parameters for the protocols 
  445.            and NDIS drivers on the workstation.  Refer to the online MPTS/2 
  446.            books in the  LAN Server Books icon for information about using this 
  447.            MPTS/2 interface. 
  448.  
  449.             FFST/2 GUI: provides FFST/2 interface which can be used by other 
  450.            network management products. 
  451.  
  452.             Fault Tolerance Setup GUI: provides the FTSETUP utility to set up 
  453.            Fault Tolerance on the network for the first time. 
  454.  
  455.             Fault Tolerance Administration GUI: provides the FTADMIN utility to 
  456.            manage Fault Tolerance on the network. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 4. Setting Up the Domain ΓòÉΓòÉΓòÉ
  460.  
  461. Before you can do anything on a network, you must set up one or more domains. A 
  462. domain is a set of servers that allocates shared network resources within a 
  463. single logical system. After the network is defined, periodically back up the 
  464. files describing the current domain to minimize loss that can be caused by 
  465. hard-disk damage. 
  466.  
  467. For more information, see the following topics: 
  468.  
  469.      Setting Up the Domain 
  470.  
  471.      Starting the Domain Controller 
  472.  
  473.      Starting OS/2 Warp Server on Your Workstation 
  474.  
  475.      Stopping OS/2 Warp Server on Your Workstation 
  476.  
  477.      Logging On 
  478.  
  479.      Logging Off 
  480.  
  481.      Starting and Stopping LAN Server Administration 
  482.  
  483.      Defining Servers 
  484.  
  485.      Displaying and Printing the Domain Definition 
  486.  
  487.      Time and Date Considerations 
  488.  
  489.      Backing Up and Restoring the Domain Control Database 
  490.  
  491.      Identifying Server Problems 
  492.  
  493.  
  494. ΓòÉΓòÉΓòÉ 4.1. Setting Up the Domain ΓòÉΓòÉΓòÉ
  495.  
  496. You can set up your domain only after you have: 
  497.  
  498.      Used the instructions in Quick Beginnings or Quick Beginnings to complete 
  499.       the installation of OS/2 Warp Server on the domain controller (required), 
  500.       backup domain controllers (optional), and servers (optional), and run the 
  501.       Migration Utility, if necessary. 
  502.  
  503.      Created spooler queues on the appropriate servers through the printer 
  504.       objects. This step is necessary only if you have printers. 
  505.  
  506.  The following order is suggested for setting up your domain: 
  507.  
  508.    1. (required) Install the software on all servers in the domain. 
  509.  
  510.    2. (required) Log on to the domain controller using your administrator user 
  511.       ID and password.  If you have not created an administrator user ID, the 
  512.       default ID is USERID and the default password is PASSWORD. 
  513.  
  514.    3. Define additional servers on the domain.  See  Defining Servers. 
  515.  
  516.    4. (optional here) Start additional servers. 
  517.  
  518.    5. (optional) Because users can log on, disable user logon while you set up 
  519.       the domain by pausing the NetLogon service at the domain controller, 
  520.       either through the LAN Server Administration or by typing: 
  521.  
  522.             NET PAUSE NetLogon
  523.        See  Managing Network Services for LAN Server Administration 
  524.       instructions or refer to the Command Reference for the NET PAUSE 
  525.       description. 
  526.  
  527.    6. (required) Define users and groups. See  Managing Users and Groups. 
  528.  
  529.    7. (optional) Define shared resources (directories, printers, and serial 
  530.       devices) and their aliases.  See  Sharing Network Resources. 
  531.  
  532.    8. (required) Define access control profiles for the resources. See 
  533.       Defining Access Control Profiles. 
  534.  
  535.    9. (optional) Install and define public applications to be shared on the 
  536.       appropriate servers. See  Managing OS/2, DOS, WorkSpace On-Demand, and 
  537.       Windows Applications. 
  538.  
  539.   10. (optional) Create and define images, and then define remote IPL 
  540.       workstations to the domain. See  Installing and Configuring Remote IPL. 
  541.  
  542.   11. (optional) Assign resources to be made available to users during logon 
  543.       (logon assignments).  See  Managing Users and Groups. 
  544.  
  545.   12. (recommended; required if you did step 4) Establish a plan to back up the 
  546.       domain controller database (DCDB) regularly.  See  Backing Up and 
  547.       Restoring the Domain Control Database. 
  548.  
  549.   13. If user logon was disabled at step 5, enable the logon by typing: 
  550.  
  551.             NET CONTINUE SERVER
  552.  
  553.   14. (recommended) Print your domain definition for archival purposes. See 
  554.       Displaying and Printing the Domain Definition. 
  555.  
  556.  
  557. ΓòÉΓòÉΓòÉ 4.2. Starting the Domain Controller ΓòÉΓòÉΓòÉ
  558.  
  559. The  domain controller is the primary server in a domain. 
  560.  
  561. The Server service is started automatically unless you specify otherwise. If 
  562. during installation you did not choose to start the Server service 
  563. automatically, you can start it by opening Start Server. You can also start it 
  564. by typing  NET START SERVER at the command line. 
  565.  
  566.  
  567. ΓòÉΓòÉΓòÉ 4.3. Starting OS/2 Warp Server on Your Workstation ΓòÉΓòÉΓòÉ
  568.  
  569. You must start the domain controller to allow users to log on to the domain. 
  570. The users at the requester workstations cannot access LAN resources unless the 
  571. domain controller and associated servers are running.  OS/2 Warp Server is 
  572. configured to start automatically when the workstation starts. 
  573.  
  574. To start OS/2 Warp Server on a workstation: 
  575.  
  576.    1. Open  Start Server or Start Requester. 
  577.  
  578.  You can also start OS/2 Warp Server by using the NET START command at the OS/2 
  579.  command prompt.  For the NET START syntax, see the Command Reference. 
  580.  
  581.  
  582. ΓòÉΓòÉΓòÉ 4.4. Stopping OS/2 Warp Server on Your Workstation ΓòÉΓòÉΓòÉ
  583.  
  584. You can stop individual services on your workstation or you can stop OS/2 Warp 
  585. Server.  For information about stopping individual services, such as the Peer 
  586. service, refer to  Guidelines for Stopping and Pausing Network Services. 
  587.  
  588. When you stop OS/2 Warp Server, other users cannot access the resources on your 
  589. workstation.  If you do not want to stop sharing your resources, do not stop 
  590. OS/2 Warp Server.  If you are preparing to leave work for the day, you can 
  591. simply lock up your workstation instead of stopping OS/2 Warp Server  or 
  592. shutting down and turning off your workstation.  For more information about 
  593. Lockup, refer to the OS/2 Desktop Guide . 
  594.  
  595. Before you stop OS/2 Warp Server, check to see if anyone is connected to your 
  596. resources.  Notify these people that you are going to stop OS/2 Warp Server  so 
  597. that they can finish working with the resources before they are disconnected. 
  598. You can use Network Messaging to send a message to all users who have open 
  599. files or active sessions to tell them you are going to stop OS/2 Warp Server on 
  600. your workstation. 
  601.  
  602. To stop OS/2 Warp Server: 
  603.  
  604.    1. Open  LAN Server Administration. 
  605.  
  606.    2. Select  OK at the IBM logo screen and log on if prompted to do so. 
  607.  
  608.    3. Open  Local Workstation. 
  609.  
  610.    4. Open  Services. 
  611.  
  612.    5. Select the  Server service. 
  613.  
  614.    6. Press mouse button 2 to display the menu. 
  615.  
  616.    7. Select  Stop. 
  617.  
  618.  Note:  If you are going to turn off your workstation or restart it, you first 
  619.         must select  Shut down from the Desktop.  For more information about 
  620.         Shut down, refer to the OS/2 Desktop Guide . 
  621.  
  622.  You can also stop OS/2 Warp Server by using the NET STOP command at the 
  623.  command line.  For the NET STOP syntax, see the Command Reference . 
  624.  
  625.  
  626. ΓòÉΓòÉΓòÉ 4.5. Logging On ΓòÉΓòÉΓòÉ
  627.  
  628. Logging on identifies you to the local workstation and allows you to gain
  629. access to resources on the network.  If you are not logged on, you cannot
  630. connect to shared resources on your network.
  631.  
  632.        Note:  Use the User ID and password that you created during installation of OS/2 Warp
  633.               Server the first time you log on.
  634.  
  635.   To log on:
  636.  
  637.          1. Open  Logon.  The OS/2 Warp Server Logon window is displayed.
  638.  
  639.          2. In the  User ID field, type your user ID and press Tab.
  640.  
  641.          3. In the  Password field, type your password if you have one.  If
  642.             a password is required and you do not supply it, you receive an error message.
  643.              The password is not displayed on the screen as you type it.
  644.  
  645.          4. If you want to log on to a domain other than the domain listed in the
  646.             Domain field, type the new domain name in the Domain
  647.             field.
  648.  
  649.          5. Select  OK.
  650.  
  651.   You can also log on by using the LOGON command at the OS/2 command prompt.
  652.    For the LOGON syntax, see the
  653.   Command Reference.
  654.  
  655.  
  656. ΓòÉΓòÉΓòÉ 4.6. Logging Off ΓòÉΓòÉΓòÉ
  657.  
  658. Logging off disconnects you from resources on the network and prevents you
  659. from making new connections to resources. Logging off OS/2 Warp Server does
  660. not stop OS/2 Warp Server on your workstation.  If your workstation is a
  661. server or peer workstation, other users can continue to access your shared
  662. resources until you stop the Peer service (peer workstation only), stop
  663. sharing the resources, or turn off your workstation.
  664.  
  665.        Note:  If you are running any network applications when you log off, OS/2 Warp Server
  666.               prompts you to determine if you want to stop the applications. If you do not
  667.               want to stop the applications, your logoff request is canceled.
  668.  
  669.   To log off:
  670.  
  671.          1. Open  Logoff.
  672.  
  673.          2. A window is displayed that lists all of the sessions to which you are
  674.             currently logged on.  You can select each local OS/2 session to be logged off
  675.             or select  Log off All to log off all active sessions.
  676.  
  677.             If you are logged on only to an OS/2 Warp Server or LAN Server domain, you
  678.             probably have only one session displayed to log off.  If you have logged on to
  679.             database manager in addition to logging on to OS/2 Warp Server, you have
  680.             multiple sessions to log off.
  681.  
  682.          Note:
  683.  
  684.   If you are going to turn off your workstation or restart it, you must first
  685.   select  Shut down  from the Desktop.  For more information about
  686.   Shut down, refer to the
  687.  
  688.   OS/2 Desktop Guide.
  689.  
  690.   Do not shut down your workstation if other users are connected to your
  691.   resources.  Shutting down your workstation stops all active sessions.  If you
  692.   are leaving your workstation, you can use the Lockup utility rather than shut
  693.   down.  Lockup locks your keyboard and mouse until you enter your keyboard
  694.   password.  While Lockup is in effect, all of your sessions can continue to
  695.   run.  For more information about Lockup, refer to the
  696.  
  697.   OS/2 Desktop Guide.
  698.  
  699.   You can also log off by using the LOGOFF command at the command line. For the
  700.   LOGOFF syntax, see the
  701.   Command Reference.
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 4.7. Starting and Stopping LAN Server Administration ΓòÉΓòÉΓòÉ
  705.  
  706. You must start the domain controller to allow other servers to start and to
  707. allow users to log on to the domain.  The users at the requester workstations
  708. cannot access LAN resources unless the domain controller and associated
  709. servers are running.  Refer to Starting OS/2 Warp Server on Your Workstation for more information.
  710.  
  711. To start LAN Server Administration:
  712.  
  713.          1. Open LAN Server Administration.
  714.  
  715.          2. Select  OK at the IBM logo screen and log on if prompted to do
  716.             so.
  717.  
  718.   You can also use the NETGUI command to start the GUI.  Enter the following
  719.   at an OS/2 command prompt:
  720.  
  721.   NETGUI
  722.  
  723.  Refer to  Stopping OS/2 Warp Server on Your Workstation for information about 
  724.  stopping the GUI. 
  725.  
  726.  
  727. ΓòÉΓòÉΓòÉ 4.8. Defining Servers ΓòÉΓòÉΓòÉ
  728.  
  729. When you install OS/2 Warp Server or LAN Server on a workstation and define 
  730. that workstation as the domain controller, that domain controller is the only 
  731. workstation defined to the domain. You must then define any other servers to 
  732. belong to this domain. 
  733.  
  734.  Servers own resources and respond to requests from users on the network to use 
  735. those resources.  A server definition includes the server machine ID, a brief 
  736. description of the server, and the domain to which the server belongs. 
  737.  
  738. Peer workstations are requesters that share their resources with requesters and 
  739. other servers on the LAN.  In this respect, peer workstations function as a 
  740. limited type of server.  Peer workstations are not defined to the domain 
  741. controller.  They can be administered locally using the Shared Resources and 
  742. Network Connections notebook and the Network User Account notebook (for more 
  743. information, see the  OS/2 File and Print Client Guide). They can be 
  744. administered remotely using the command line (for more information, see the 
  745. Command Reference). 
  746.  
  747. When you define additional servers to the domain, make sure that all requesters 
  748. are configured with enough NetBIOS sessions to allow session establishment with 
  749. all servers in the domain.  Refer to Quick Beginnings for more information on 
  750. configuring NetBIOS parameters. 
  751.  
  752. When you define a workstation as an additional server, the system automatically 
  753. creates a user ID identical to the server machine ID and places it in the 
  754. SERVERS group.  The descriptive text for this ID is System ID - Server.  If you 
  755. delete this user ID, you remove that server from the domain. 
  756.  
  757. System-generated IDs are treated as any other user IDs defined to the domain. 
  758. User Profile Management, OS/2 Warp Server, and LAN Server windows display 
  759. system-generated IDs as user IDs.  System IDs for additional servers are 
  760. automatically placed in the group named SERVERS. 
  761.  
  762. Do not delete access control profiles or change access permissions assigned to 
  763. the system-generated IDs. 
  764.  
  765. User definitions are stored in a file called NET.ACC.  Users have a single user 
  766. definition on the multiple servers in a domain. OS/2 Warp Server and LAN Server 
  767. provide this capability by keeping the copies of the NET.ACC file in 
  768. synchronization with each other.  The master copy of the NET.ACC file is kept 
  769. on the domain controller, and copies of it are on the additional servers.  The 
  770. NetLogon service keeps all the NET.ACC user definitions in the files in 
  771. synchronization.  The NET.ACC file determines which file is the master and 
  772. which is a copy.  The primary role indicates the master copy, and all other 
  773. roles except the stand-alone role indicate a copy. 
  774.  
  775. For more information, see the following topics: 
  776.  
  777.      Defining Server Roles in a Domain 
  778.  
  779.      Domain Logons 
  780.  
  781.      Multiple Logons 
  782.  
  783.      Logging a Domain Controller onto Another Domain 
  784.  
  785.      Backing Up the NET.ACC File 
  786.  
  787.      Initializing the NET.ACC File 
  788.  
  789.      Creating Server Definitions 
  790.  
  791.      Updating Server Definitions 
  792.  
  793.      Deleting Server Definitions 
  794.  
  795.      Implementing Support for Multiple Server Names 
  796.  
  797.  
  798. ΓòÉΓòÉΓòÉ 4.8.1. Defining Server Roles in a Domain ΓòÉΓòÉΓòÉ
  799.  
  800. Servers in a domain must run the NetLogon service to keep the server's copy of 
  801. the user definitions in synchronization with the domain controller.  The 
  802. NetLogon service is installed with OS/2 Warp Server or LAN Server.  Each server 
  803. has a defined role, and each role causes the NetLogon service to treat the 
  804. server differently.  The roles are as follows: 
  805.  
  806.      Primary (domain controller) -  This server is specified as the domain 
  807.       controller when OS/2 Warp Server or LAN Server is installed. 
  808.  
  809.       Note:  To change the role of an additional server or backup domain 
  810.              controller to Primary, you must reinstall the server as a domain 
  811.              controller. 
  812.  
  813.       Only one server per domain can be the primary domain controller.  The 
  814.       domain controller handles network logon requests and contains the master 
  815.       file that holds the user and group definitions.  Updates to this file are 
  816.       made at the domain controller and then copied to all servers on the 
  817.       domain. 
  818.  
  819.      Member (additional server) -  These servers are specified as additional 
  820.       servers when OS/2 Warp Server  or LAN Server  is installed. 
  821.  
  822.       Multiple member servers can be defined on a domain.  Each receives a copy 
  823.       of the user and group definitions file from the domain controller when 
  824.       updates are made.  Members cannot handle network logon requests, but they 
  825.       can provide users the resources for logon assignments and applications. 
  826.  
  827.      Backup (backup domain controllers) - Servers in a domain can be defined 
  828.       as backup domain controllers. 
  829.  
  830.       Multiple backup domain controllers can be defined on a domain.  Each 
  831.       receives a copy of the user and group definitions file from the domain 
  832.       controller when updates are made.  If the DCDB Replicator service is 
  833.       running, a full copy of the DCDB is replicated on each.  Backup domain 
  834.       controllers can handle network logon requests. 
  835.  
  836.       If the primary domain controller fails, the backup domain controller does 
  837.       not automatically take the primary role, but it handles command-line and 
  838.       OS/2 Warp Server Administration logon requests.  If the domain controller 
  839.       fails and the backup domain controller serves logon requests, all 
  840.       resources with aliases should still be available, except those on the 
  841.       domain controller. 
  842.  
  843.      Stand-alone server - A stand-alone server is a server that is not defined 
  844.       as part of a domain. 
  845.  
  846.       Workstations that are configured to run the Peer service also have the 
  847.       Role of server field set to  Stand-alone.  A workstation designated as a 
  848.       stand-alone server does not respond to logon authorization requests. 
  849.  
  850.  You can change a server's role with the NET ACCOUNTS command.  For more 
  851.  information about the NET ACCOUNTS command, see the Command Reference . 
  852.  
  853.  Additional installation and configuration can be required to complete a role 
  854.  change.  For example, if you want to change an additional server to a domain 
  855.  controller or backup domain controller, use the OS/2 Warp Server installation 
  856.  program to change the configuration of the additional server into one for a 
  857.  domain controller or backup domain controller.  The installation program 
  858.  installs a new DCDB at the additional server. 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ 4.8.2. Domain Logons ΓòÉΓòÉΓòÉ
  862.  
  863. Domain logons are handled by a server whose domain role is either backup or 
  864. domain controller.  As a backup domain controller, this type of server can 
  865. validate user logon assignments and alias resolution like a domain controller. 
  866.  
  867. Whether the domain controller  or the backup server handles a network logon 
  868. request is determined by the value specified in the logon server field in the 
  869. user account information.  If the logon-server value specified is any 
  870. (default), the first backup or domain controller  server that answers the user 
  871. request for logon handles the logon. 
  872.  
  873. The first server that answers can be influenced by relative position on the 
  874. network with regard to the workstation or speed of the processor on the server. 
  875. If the domain controller is the preferred server to validate logons, issue the 
  876. NET USER command with the value of the logonserver parameter set to NULL.  The 
  877. NULL value causes the domain controller to handle the domain logon requests 
  878. unless busy or unavailable.  If the domain controller is busy or unavailable, 
  879. any backup server in the domain handles logons.  For information on how to 
  880. change this value, see the Command Reference. 
  881.  
  882.  
  883. ΓòÉΓòÉΓòÉ 4.8.3. Multiple Logons ΓòÉΓòÉΓòÉ
  884.  
  885. A single user ID can log on to multiple requesters at a time.  Use the same 
  886. user ID and the same password on the same site token ring. You can log on 
  887. multiple times to access resources available to you. You can log on to every 
  888. machine in the domain including the domain controller without logging off of 
  889. any machine.  This capability is enabled by default. 
  890.  
  891.  
  892. ΓòÉΓòÉΓòÉ 4.8.4. Logging a Domain Controller onto Another Domain ΓòÉΓòÉΓòÉ
  893.  
  894. If an administrator logs a domain controller onto another domain, a user with 
  895. Administrator authority can remotely issue NET ADMIN commands that will affect 
  896. the other domain, rather than the logon domain. 
  897.  
  898. Thus, to prevent unexpected side effects and for security reasons, do not leave 
  899. servers logged on to other domains with Administrator authority. 
  900.  
  901.  
  902. ΓòÉΓòÉΓòÉ 4.8.5. Backing Up the NET.ACC File ΓòÉΓòÉΓòÉ
  903.  
  904. If you have not made a backup copy of the NET.ACC file  on each server in 
  905. C:\IBMLAN\ACCOUNTS, do so now.  For more information, refer to  Using the 
  906. BACKACC Utility to Back Up the NET.ACC File.  The NET.ACC file contains 
  907. information that is different for each server and that is not copied using the 
  908. NetLogon service. (The NetLogon service copies only user and group 
  909. definitions.) 
  910.  
  911. If the NET.ACC file is lost or damaged on a server, do the following: 
  912.  
  913.    1. Configure so that OS/2 Warp Server does not start at reboot. Copy the 
  914.       backup NET.ACC file (unique to that server) to the server.  This copy 
  915.       contains necessary workstation-unique information. 
  916.  
  917.    2. Start the server again on the LAN.  Because the server is running the 
  918.       NetLogon service, the domain controller copies its NET.ACC file to the 
  919.       server. This operation copies the user and group definitions back into 
  920.       the file. 
  921.  
  922.  Note:  If the passwords become unsynchronized, refer to  Resynchronizing 
  923.         Passwords with the NetLogon Service. 
  924.  
  925.  For more information on the NetLogon service parameters, refer to Performance 
  926.  Tuning.  For more information on backing up the NET.ACC file, see  Backing Up 
  927.  and Restoring the Domain Control Database. 
  928.  
  929.  
  930. ΓòÉΓòÉΓòÉ 4.8.6. Initializing the NET.ACC File ΓòÉΓòÉΓòÉ
  931.  
  932. The following procedure describes how to initialize the NET.ACC file. You might 
  933. need to do this if a new NET.ACC file is installed on an additional server or 
  934. if the NetLogon Service fails to start. 
  935.  
  936. At the server with the new NET.ACC file or where the NetLogon Service is 
  937. failing, log on as an administrator and perform the following steps. 
  938.  
  939. To initialize the NET.ACC file: 
  940.  
  941.    1. Make a note of the current role of the server. 
  942.  
  943.    2. Temporarily change the role of the server to PRIMARY with the following 
  944.       command: 
  945.  
  946.             NET ACCOUNTS /ROLE:PRIMARY
  947.  
  948.    3. Add the group account SERVERS to the accounts database (NET.ACC) with the 
  949.       following command: 
  950.  
  951.             NET GROUP SERVERS /ADD
  952.  
  953.    4. Add the server as a user account in the accounts database with the 
  954.       following command: 
  955.  
  956.             NET USER servername /ADD /PRIV:USER /ACTIVE:NO /EXPIRES:NEVER /PASSWORDREQ:NO
  957.  
  958.    5. If the server is to be the domain controller (PRIMARY), perform the 
  959.       following steps: 
  960.  
  961.         a. Set the server's account password to NULL with the following 
  962.            command: 
  963.  
  964.                       NET USER servername ""
  965.  
  966.            where  servername is the name of your server. 
  967.  
  968.         b. Add the GUEST ID to the accounts database with the following 
  969.            command: 
  970.  
  971.                       NET USER GUEST /ADD /PRIV:GUEST /PASSWORDREQ:NO
  972.  
  973.    6. Add the server to the SERVERS group in the accounts database with the 
  974.       following command: 
  975.  
  976.             NET GROUP SERVERS servername /ADD
  977.  
  978.       where  servername is the name of your server. 
  979.  
  980.    7. Restore the server's original role with one of the following commands: 
  981.  
  982.             NET ACCOUNTS /ROLE:MEMBER
  983.  
  984.       or 
  985.  
  986.             NET ACCOUNTS /ROLE:BACKUP
  987.  
  988.  
  989. ΓòÉΓòÉΓòÉ 4.8.7. Creating Server Definitions ΓòÉΓòÉΓòÉ
  990.  
  991. The procedures to define a server to the domain are different for OS/2 servers 
  992. and Microsoft Windows NT servers. Use the appropriate procedure from below. 
  993.  
  994. To create a definition for an OS/2 server: 
  995.  
  996.    1. Open  LAN Server Administration. 
  997.  
  998.    2. Open the appropriate domain object. 
  999.  
  1000.    3. Open  Defined Servers. 
  1001.  
  1002.    4. Drag the  Server Template to an open area in the Defined Servers folder. 
  1003.  
  1004.       The Defined Server - Create notebook is displayed. 
  1005.  
  1006.    5. Complete the Identity page. 
  1007.  
  1008.    6. Select  Create. 
  1009.  
  1010.   To create a definition for a Microsoft Windows NT server: 
  1011.  
  1012.  Adding a Windows NT server to the OS/2 Warp Server domain is a two-step 
  1013.  process. You must first install the IBM Networks User Account Manager service 
  1014.  on the Windows NT server and then define the NT server as an additional server 
  1015.  on the OS/2 Warp Server domain. 
  1016.  
  1017.    1. To install the IBM Networks User Account Manager service on the Windows 
  1018.       NT server: 
  1019.  
  1020.         a. Click on Start, point to Settings, and select Control Panel. 
  1021.  
  1022.         b. Open Network. 
  1023.  
  1024.         c. Click on the Services tab, and then click on Add. 
  1025.  
  1026.            The Network notebook is displayed. 
  1027.  
  1028.         d. Click on Have Disk and insert the OS/2 Warp Server CD-ROM. 
  1029.  
  1030.         e. Type the directory path to the IBM Networks User Account Manager 
  1031.            installation files, then click on Ok. 
  1032.  
  1033.            The OEM option window is displayed. 
  1034.  
  1035.            Note:  You can install the IBM Networks User Account Manager from a 
  1036.                   local or shared network drive (for example, a:\ or 
  1037.                   d:\IBMINT), from a UNC network path (for example, 
  1038.                   \\DEPT_SREVER\IBMNT), or from the OS/2 Warp Server CD-ROM. 
  1039.  
  1040.         f. Click on IBM Networks User Account Manager and then on Ok to copy 
  1041.            the files. After this is complete, the Properties notebook is 
  1042.            displayed. 
  1043.  
  1044.         g. In the Persistent Users box add the names of persistent users. 
  1045.  
  1046.         h. In the Persistent Localgroups box add the names of persistent 
  1047.            localgroup aliases. 
  1048.  
  1049.            Note:  Persistent Users and Localgroups are those managed solely by 
  1050.                   the Windows NT server and are not synchronized by the OS/2 
  1051.                   Warp Server domain controller. 
  1052.  
  1053.         i. Click on Ok. 
  1054.  
  1055.            The Network notebook is displayed. 
  1056.  
  1057.         j. Click on the Identification tab and then click on Change. 
  1058.  
  1059.         k. Select Workgroup and type the name of the OS/2 Warp Server domain. 
  1060.  
  1061.         l. Click on Ok and then on Close. 
  1062.  
  1063.         m. On the Network Setting Change window, click on Yes to restart your 
  1064.            Windows NT system. 
  1065.  
  1066.    2. To define the Windows NT server in the OS/2 Warp Server domain: 
  1067.  
  1068.       Define the Windows NT server in the same manner as an OS/2 server. See To 
  1069.       create a definition for an OS/2 server for the procedure. 
  1070.  
  1071.  
  1072. ΓòÉΓòÉΓòÉ 4.8.8. Updating Server Definitions ΓòÉΓòÉΓòÉ
  1073.  
  1074. You can update server definitions. 
  1075.  
  1076. To update a server definition: 
  1077.  
  1078.    1. Open  LAN Server Administration. 
  1079.  
  1080.    2. Open the appropriate domain object. 
  1081.  
  1082.    3. Open  Defined Servers. 
  1083.  
  1084.    4. With mouse button 2, select the appropriate server object. 
  1085.  
  1086.    5. Select  Properties. 
  1087.  
  1088.       The notebook of the selected server is displayed. 
  1089.  
  1090.    6. Check all the properties for each page, and update the definitions to 
  1091.       meet your needs. 
  1092.  
  1093.    7. Select  Set or  Apply. 
  1094.  
  1095.    8. Select  Object. 
  1096.  
  1097.       The following menu selections contain additional properties or displays: 
  1098.  
  1099.           Selections that you can view, modify, or refresh 
  1100.  
  1101.              -  Open files 
  1102.  
  1103.              -  Active sessions 
  1104.  
  1105.           Selections that you can view, refresh, clear, or print 
  1106.  
  1107.              -  Statistics (for servers and requesters) 
  1108.  
  1109.           Selection that you can view, share, change, refresh, and manage 
  1110.  
  1111.              -  Current shares 
  1112.  
  1113.           Selection that you can add, change, or delete 
  1114.  
  1115.              -  Current assignments 
  1116.  
  1117.    9. Select these items one at a time, and view or change the properties as 
  1118.       required. 
  1119.  
  1120.   10. Select  Close. 
  1121.  
  1122.  
  1123. ΓòÉΓòÉΓòÉ 4.8.9. Deleting Server Definitions ΓòÉΓòÉΓòÉ
  1124.  
  1125. Before deleting a server definition, you should first delete any aliases and 
  1126. home directories associated with the server.  For more information on deleting 
  1127. aliases, see  Determining the Server on Which a Resource Resides and Deleting 
  1128. an Alias. 
  1129.  
  1130. Again the procedures for deleting a server definition are different for OS/2 
  1131. servers and Windows NT servers. Use the appropriate procedure from below. 
  1132.  
  1133. To delete an OS/2 server definition from the domain: 
  1134.  
  1135.    1. Open  LAN Server Administration. 
  1136.  
  1137.    2. Open the appropriate domain object. 
  1138.  
  1139.    3. Open  Defined Servers. 
  1140.  
  1141.    4. Select the server object that you want to delete. 
  1142.  
  1143.    5. Press mouse button 2, and select  Delete from the pop-up menu. 
  1144.  
  1145.  To delete a Windows NT server definition from the domain: 
  1146.  
  1147.    1. Delete the IBM Networks User Account Manager Service from the Windows NT 
  1148.       server: 
  1149.  
  1150.         a. Click on Start, point to Settings, and select Control Panel. 
  1151.  
  1152.         b. Open Network and select Services. 
  1153.  
  1154.         c. Select IBM Networks User Account from the Network Services list. 
  1155.  
  1156.         d. Select Remove and click on Yes. 
  1157.  
  1158.         e. Click on Close. 
  1159.  
  1160.         f. Restart your system. 
  1161.  
  1162.    2. Delete the Windows NT server definition from the domain. 
  1163.  
  1164.       Delete the NT server in the same manner as an OS/2 server. See To delete 
  1165.       an OS/2 server definition from the domain for the procedure. 
  1166.  
  1167.       Attention  Deleting the server definition is critical, even if you are 
  1168.                  planning on immediately re-installing the IBM Networks User 
  1169.                  Account Manager service. Failing to delete the server 
  1170.                  definition causes the domain controller and the Windows NT 
  1171.                  server to be out of synch. 
  1172.  
  1173.  
  1174. ΓòÉΓòÉΓòÉ 4.8.10. Implementing Support for Multiple Server Names ΓòÉΓòÉΓòÉ
  1175.  
  1176. OS/2 Warp Server supports multiple server names. The machine name located in 
  1177. the server's IBMLAN.INI COMPUTERNAME= field is considered the primary server 
  1178. name. Additional server names, also known as secondary names, can be added to 
  1179. allow a server to respond to and service requests for these servers. 
  1180.  
  1181. The ability to support multiple server names allows the following: 
  1182.  
  1183.      Merging or migrating servers from older hardware to faster, more powerful 
  1184.       server hardware without reconfiguring aliases or server names in the 
  1185.       domain 
  1186.  
  1187.      Temporarily offering resources (such as printer shares) for a server that 
  1188.       is unavailable, because of failure or maintenance 
  1189.  
  1190.      Support for products that might require the feature for supporting 
  1191.       automatic server failover 
  1192.  
  1193.  There are many options available for adding and managing secondary server 
  1194.  names: 
  1195.  
  1196.      Through the Network API (see NetServerNameAdd and NetServerDel in the 
  1197.       OS/2 Programming Guide and Reference Addendum) 
  1198.  
  1199.      Through the command line (see NET CONFIG SERVER /OTHSRVNAMES in the 
  1200.       Command Reference) 
  1201.  
  1202.      Through the OTHSRVNAMES= parameter in the IBMLAN.INI 
  1203.  
  1204.      Through the /OTHSRVNAMES option to NET START SERVER (see the Command 
  1205.       Reference ) 
  1206.  
  1207.  
  1208. ΓòÉΓòÉΓòÉ 4.8.10.1. Example: Setting one printer server to temporarily replace another ΓòÉΓòÉΓòÉ
  1209.  
  1210. In this example, PRTSRV9 is scheduled for hardware maintenance, so PRTSRV7 will 
  1211. be switched to cover printing requests for PRTSRV9. To do this, you must switch 
  1212. the printers and create queues. 
  1213.  
  1214.    1. At the command line, type 
  1215.  
  1216.             NET CONFIG SERVER /OTHSRVNAMES:PRTSRV9
  1217.  
  1218.    2. To switch the printers, physically switch the printer cable from one 
  1219.       server to another. 
  1220.  
  1221.    3. To create the printer queue, use the printer template and create a new 
  1222.       queue with the same properties as the original queue. 
  1223.  
  1224.    4. Restart the printer shares by typing 
  1225.  
  1226.             NET STOP LSSERVER
  1227.             NET START LSSERVER
  1228.  
  1229.  
  1230. ΓòÉΓòÉΓòÉ 4.9. Displaying and Printing the Domain Definition ΓòÉΓòÉΓòÉ
  1231.  
  1232. Using LAN Server Administration, you can display the domain definition or print 
  1233. it for reference or record-keeping purposes.  The domain definition has the 
  1234. following sections: 
  1235.  
  1236.      Users 
  1237.  
  1238.      Groups 
  1239.  
  1240.      Aliases 
  1241.  
  1242.      Public Applications 
  1243.  
  1244.      Defined Servers 
  1245.  
  1246.  You can also use the NET ADMIN command to run the DSPDOMDF utility, which 
  1247.  displays and prints domain-related information.  Run the DSPDOMDF utility at a 
  1248.  primary or backup server because this utility uses account information from 
  1249.  the local accounts database (NET.ACC). 
  1250.  
  1251.  For more information, see the following topics: 
  1252.  
  1253.      Displaying Server Information 
  1254.  
  1255.      Printing Domain Information 
  1256.  
  1257.  
  1258. ΓòÉΓòÉΓòÉ 4.9.1. Displaying Server Information ΓòÉΓòÉΓòÉ
  1259.  
  1260. You can display information about a remote server using the OS/2 Warp Server 
  1261. Administration. 
  1262.  
  1263. To display information about a remote server: 
  1264.  
  1265.    1. Open  LAN Server Administration. 
  1266.  
  1267.    2. Open the appropriate domain object. 
  1268.  
  1269.    3. Open  Defined Servers. 
  1270.  
  1271.    4. With mouse button 2, select the appropriate server object. 
  1272.  
  1273.    5. Select  Properties. 
  1274.  
  1275.       The notebook of the selected server is displayed. 
  1276.  
  1277.    6. Review all the pages as desired for information about this server. 
  1278.  
  1279.  You can also display information about a remote server by typing: 
  1280.  
  1281.   NET ADMIN \\rmtsrv /C "DSPDOMDF"
  1282.  where  rmtsrv is your remote server. 
  1283.  
  1284.  
  1285. ΓòÉΓòÉΓòÉ 4.9.2. Printing Domain Information ΓòÉΓòÉΓòÉ
  1286.  
  1287. Use the following procedure to print out information about domain definitions. 
  1288. You must perform this procedure on a local server defined in the domain for 
  1289. which you are printing the information. 
  1290.  
  1291. To print domain definitions: 
  1292.  
  1293.    1. Open  LAN Server Administration. 
  1294.  
  1295.    2. With mouse button 2, select the appropriate domain object 
  1296.  
  1297.    3. From the pop-up menu, select  Print definitions. 
  1298.  
  1299.       The domain definition is printed on the local printer. 
  1300.  
  1301.  You can also print domain information by redirecting the output of the NET 
  1302.  ADMIN command to a file or a device by typing: 
  1303.  
  1304.   NET ADMIN \\rmtsrv /C "DSPDOMDF"
  1305.  
  1306.  where  rmtsrv is your remote server and then typing: 
  1307.  
  1308.   DSPDOMDF > lpt1
  1309.  
  1310.  where  lpt1 is the file or device, such as a printer. 
  1311.  
  1312.  
  1313. ΓòÉΓòÉΓòÉ 4.10. Time and Date Considerations ΓòÉΓòÉΓòÉ
  1314.  
  1315. During server startup, the date and time on the server are synchronized with 
  1316. the date and time on the domain controller. With the Timesource service, you 
  1317. can designate a server as a reliable source of the time and date for 
  1318. synchronization of other workstations in the domain. 
  1319.  
  1320. For more information, see the following topics: 
  1321.  
  1322.      Designating a Server as a Date and Time Source 
  1323.  
  1324.      Setting the Date and Time 
  1325.  
  1326.  
  1327. ΓòÉΓòÉΓòÉ 4.10.1. Designating a Server as a Date and Time Source ΓòÉΓòÉΓòÉ
  1328.  
  1329. Use the following procedure to identify a server as the source for time and 
  1330. date across a domain. 
  1331.  
  1332. To designate a server as a date and time source: 
  1333.  
  1334.    1. Open  LAN Server Administration. 
  1335.  
  1336.    2. Open the appropriate domain object. 
  1337.  
  1338.    3. Open  Defined Servers. 
  1339.  
  1340.    4. Open the appropriate server object. 
  1341.  
  1342.    5. Open  Services. 
  1343.  
  1344.       The details view of the Services container is displayed so that you can 
  1345.       view the current status of all installed services. 
  1346.  
  1347.    6. If you want to view the properties of the Timesource service, open its 
  1348.       icon. 
  1349.  
  1350.    7. After you have viewed the properties, close the notebook. 
  1351.  
  1352.    8. With mouse button 2, select  Timesource Service. 
  1353.  
  1354.    9. From the pop-up menu, select  Start. 
  1355.  
  1356.       The Start Service window is displayed. 
  1357.  
  1358.   10. Select  Start. 
  1359.  
  1360.  
  1361. ΓòÉΓòÉΓòÉ 4.10.2. Setting the Date and Time ΓòÉΓòÉΓòÉ
  1362.  
  1363. You can set the time and date on the domain controller from a server or any 
  1364. requester by using the NET TIME command.  Changes are passed automatically to 
  1365. all servers in the domain.  Requester clocks are updated when the next user 
  1366. logs on.  Date and time changes stay in effect until you start your workstation 
  1367. again.  For example, to set the date on DOMAIN1 to September 23, 1995, and the 
  1368. time to 19:30, type: 
  1369.  
  1370. NET TIME /DATE:O9-23-95 /TIME:19:30 /DOMAIN:DOMAIN1
  1371.  
  1372. For more information about the NET TIME command, refer to the Command Reference 
  1373. . 
  1374.  
  1375.  
  1376. ΓòÉΓòÉΓòÉ 4.11. Backing Up and Restoring the Domain Control Database ΓòÉΓòÉΓòÉ
  1377.  
  1378. The  domain controller database (DCDB) resides in the \IBMLAN\DCDB directory on 
  1379. the domain controller. The DCDB contains files that describe the current 
  1380. domain.  For more information on the structure and contents of the \IBMLAN\DCDB 
  1381. directory, see Directory Structure. 
  1382.  
  1383. The following information describes suggested procedures to: 
  1384.  
  1385.      Back up the OS/2 Warp Server domain controller database, including the 
  1386.       NET.ACC file. 
  1387.  
  1388.      Configure an additional server as the temporary domain controller after 
  1389.       failure of the original domain controller. 
  1390.  
  1391.      Restore the domain definitions from the temporary domain controller to 
  1392.       the original domain controller. 
  1393.  
  1394.  These backup and restore procedures apply only to the domain definitions 
  1395.  contained in the domain controller database subdirectory (the information 
  1396.  listed in  Displaying and Printing the Domain Definition).  These procedures 
  1397.  assume that other procedures are used, as required, to back up and restore 
  1398.  application files and user data files.  In the event of domain controller 
  1399.  failure, restore the required application files and data files before 
  1400.  restoring the domain controller database. 
  1401.  
  1402.  The following pages describe these two scenarios: 
  1403.  
  1404.      Using the DCDB Replicator  service (DCDBREPL) on the domain controller 
  1405.       and a backup domain controller to back up and restore the \IBMLAN\DCDB 
  1406.       directory tree, and the BACKACC and RESTACC utilities to back up and 
  1407.       restore the access control profiles.  The domain controller and backup 
  1408.       domain controller are defined during the OS/2 Warp Server or LAN Server 
  1409.       installation/configuration program. 
  1410.  
  1411.      Using the XCOPY command and the OS/2 Warp Server AT command to back up 
  1412.       and restore the appropriate files.  This action involves a domain 
  1413.       controller and an additional server. 
  1414.  
  1415.  These two scenarios assume that: 
  1416.  
  1417.      The NetLogon service is started at server startup. 
  1418.  
  1419.      The domain controller machine ID is DCSERV. 
  1420.  
  1421.      The administrator ID LANBKID is set up so that when the ID is logged on, 
  1422.       the Z drive is assigned to the directory above the IBMLAN subdirectory on 
  1423.       the additional server. 
  1424.  
  1425.  For more information, see the following topics: 
  1426.  
  1427.      Using the BACKACC Utility to Back Up the NET.ACC File 
  1428.  
  1429.      Using the DCDB Replicator  Service to Back Up the DCDB 
  1430.  
  1431.      Copying Files to Back Up the DCDB 
  1432.  
  1433.      Activating the Backup Domain Controller 
  1434.  
  1435.      Recovering After Domain Controller Failure 
  1436.  
  1437.      Restoring Files to the Original Domain Controller 
  1438.  
  1439.      Allowing Adequate NET.ACC Synchronization Time 
  1440.  
  1441.  
  1442. ΓòÉΓòÉΓòÉ 4.11.1. Using the BACKACC Utility to Back Up the NET.ACC File ΓòÉΓòÉΓòÉ
  1443.  
  1444. Note: 
  1445.  
  1446. In order to run the BACKACC utility on a machine installed with Local Security, 
  1447. you must: 
  1448.  
  1449.      Be logged on locally as an administrator 
  1450.  
  1451.      Have access to the \IBMLAN\ACCOUNTS subdirectory 
  1452.  
  1453.      Have access to the root directory of your current drive 
  1454.  
  1455.  For a complete backup of the DCDB, you must back up the NET.ACC file and any 
  1456.  access control profiles associated with 386 HPFS drives. (The NET.ACC file 
  1457.  contains user and group information and access control profiles.)  The 
  1458.  NetLogon service automatically copies the user and group information to all 
  1459.  servers in the domain.  The NET.ACC file also contains server-specific access 
  1460.  control information for file allocation table (FAT) drives, pipes, printers, 
  1461.  and serial devices that is not copied to the other servers in the domain. 
  1462.  (The 386 HPFS  drive store their access control profiles as an integral part 
  1463.  of their file systems.)  These access control profiles are unique to each 
  1464.  server.  The NET.ACC file is kept open by the server and cannot be copied 
  1465.  while the server is running. 
  1466.  
  1467.  Because the NET.ACC file cannot be copied, you must use the BACKACC utility to 
  1468.  back up the NET.ACC file and the access control information for both 386 HPFS 
  1469.  and FAT drives.  The RESTACC utility restores the access control information 
  1470.  for the drives.  Restore the NET.ACC file by using the procedure on page 
  1471.  Restoring Files to the Original Domain Controller. 
  1472.  
  1473.  You can create a backup of the NET.ACC file at each startup to protect the 
  1474.  user and group IDs defined within User Profile Management.  To create a backup 
  1475.  at startup, add the following statement to the STARTUP.CMD file: 
  1476.  
  1477.   BACKACC /S
  1478.  
  1479.  This command saves a copy of the current NET.ACC file at the next system 
  1480.  startup. 
  1481.  
  1482.  Note:  The BACKACC utility does not require you to stop the server. 
  1483.  
  1484.  You can use the AT command to schedule periodic backups.  For example, for FAT 
  1485.  drives: 
  1486.  
  1487.   AT 23:00 /E:M,W,F BACKACC
  1488.  
  1489.  For 386 HPFS drives: 
  1490.  
  1491.   AT 23:00 /E:M,W,F BACKACC C:\ /A /S
  1492.  
  1493.  If you want to back up multiple drives, issue the BACKACC command specifying 
  1494.  the drive letter for each drive.  See Command Reference for more information 
  1495.  about using the BACKACC utility. 
  1496.  
  1497.  
  1498. ΓòÉΓòÉΓòÉ 4.11.2. Using the DCDB Replicator  Service to Back Up the DCDB ΓòÉΓòÉΓòÉ
  1499.  
  1500. The following process sets up the DCDB Replicator  service on the domain 
  1501. controller and the backup domain controller. DCDB Replicator  service 
  1502. parameters are described in Performance Tuning. 
  1503.  
  1504. If large files that change frequently are replicated often (that is, the 
  1505. interval,  pulse, and  guardtime parameter values are low), then the number of 
  1506. file I/O operations can decrease performance.  You can improve this possible 
  1507. decrease in performance if you replicate the files less frequently (that is, 
  1508. increase the interval and  pulse parameter values). 
  1509.  
  1510. This scenario uses a special version of the Replicator service-the DCDB 
  1511. Replicator  service-to back up the files in the DCDB subdirectory.  Parameters 
  1512. that would have to be set manually to perform this task using the Replicator 
  1513. service are automatically set by the DCDB Replicator  service. These parameter 
  1514. settings free the Replicator service for other tasks. 
  1515.  
  1516. To set up the DCDB Replicator  service to back up the DCDB subdirectory tree: 
  1517.  
  1518.    1. On the domain controller, create the REPL.INI file in each first-level 
  1519.       subdirectory of the IBMLAN\DCDB directory with the following contents: 
  1520.  
  1521.             extent = tree
  1522.             integrity = file
  1523.  
  1524.    2. To maintain IPL images at the domain controller and have the copies at 
  1525.       the additional servers updated periodically, do not create (or remove, if 
  1526.       already created) the USERLOCK. xxx file.  The DCDB Replicator  service 
  1527.       automatically excludes the IMAGES subdirectory.  (The USERLOCK. xxx  file 
  1528.       works only in a first-level subdirectory beyond the export path and only 
  1529.       if the  integrity parameter value equals TREE.) 
  1530.  
  1531.       Note:  If the Remote IPL service is installed on the backup domain 
  1532.              controller, the IMAGES subdirectory is not replicated from the 
  1533.              domain controller.  The NO_SYNC.RP$ file is placed in the IMAGES 
  1534.              subdirectory.  See  Replicating Files more information about this 
  1535.              file. 
  1536.  
  1537.    3. Make sure that the DCDB Replicator  section (DCDBREPL) of the IBMLAN.INI 
  1538.       file of the domain controller includes the following settings: 
  1539.  
  1540.  
  1541.             interval = 5
  1542.             guardtime = 2
  1543.             pulse = 3
  1544.             random = 60
  1545.  
  1546.    4. Add DCDBREPL to the  srvservices parameter as another service to be 
  1547.       started at server startup, if it is not already there. 
  1548.  
  1549.    5. Make sure that the DCDB Replicator  (DCDBREPL) section of the IBMLAN.INI 
  1550.       file of the backup domain controller includes the following: 
  1551.  
  1552.             tryuser = yes
  1553.             logon = userid
  1554.             password = password
  1555.  
  1556.       The  userid and  password must belong to a user with administrator 
  1557.       authority for the DCDB Replicator  service to function when no one is 
  1558.       logged on to the backup domain controller.  Administrator authority is 
  1559.       required for the backup domain controller to read DCDB information on the 
  1560.       domain controller. 
  1561.  
  1562.    6. Add DCDBREPL to the  srvservices parameter as another service to be 
  1563.       started at server startup on domain controllers and backup domain 
  1564.       controllers, if it is not already there. 
  1565.  
  1566.    7. The DCDB Replicator  service is automatically installed on domain 
  1567.       controllers and backupdomain controllers.  For an additional server, you 
  1568.       must install the DCDB Replicator  service. 
  1569.  
  1570.    8. Make sure the following subdirectories exist on the backupdomain 
  1571.       controller: 
  1572.  
  1573.             C:\IBMLAN\DCDB\USERS
  1574.             C:\IBMLAN\DCDB\DEVICES
  1575.             C:\IBMLAN\DCDB\PRINTERS
  1576.             C:\IBMLAN\DCDB\APPS
  1577.             C:\IBMLAN\DCDB\FILES
  1578.             C:\IBMLAN\DCDB\LISTS
  1579.             C:\IBMLAN\DCDB\DATA
  1580.  
  1581.       If OS/2 Warp Server is installed on a drive other than drive C, these 
  1582.       paths should reflect the drive where OS/2 Warp Server is installed. 
  1583.  
  1584.    9. The DCDB Replicator  service starts either when the servers are started 
  1585.       or when the service is explicitly started on both the domain controller 
  1586.       and the backup domain controller.  To begin replication of files, start 
  1587.       the DCDB Replicator  (DCDBREPL) service from an OS/2 command prompt with 
  1588.       a NET START DCDBREPL command at both servers. 
  1589.  
  1590.       If the service is already started, replication does not occur.  To begin 
  1591.       replicating, you must first stop and then restart the service from an 
  1592.       OS/2 command prompt by typing: 
  1593.  
  1594.             NET STOP DCDBREPL
  1595.             NET START DCDBREPL
  1596.  
  1597.  
  1598. ΓòÉΓòÉΓòÉ 4.11.3. Copying Files to Back Up the DCDB ΓòÉΓòÉΓòÉ
  1599.  
  1600. The following process is an alternative to using the DCDB Replicator  service. 
  1601. It results in running a command file that copies files from the domain 
  1602. controller to an additional server on a scheduled basis. 
  1603.  
  1604. The command file does the following: 
  1605.  
  1606.    1. Logs on an administrator ID (LANBKID).  A logon assignment of drive Z is 
  1607.       made for LANBKID to the root directory of the additional server. 
  1608.  
  1609.    2. Issues XCOPY commands to copy the required files. 
  1610.  
  1611.    3. Logs off the administrator ID. 
  1612.  
  1613.  Because the administrator ID and password are part of the command file, you 
  1614.  must update the password in the command file.  Place the command file in a 
  1615.  secure directory (that is, a directory that is not accessible by other user 
  1616.  IDs).  For performance reasons, schedule this command file to run at times of 
  1617.  low network use. 
  1618.  
  1619.  To set up a command file: 
  1620.  
  1621.    1. At the domain controller, create a command file containing the following 
  1622.       commands.  In this example, the file is BACKIT.CMD, and it is stored in 
  1623.       the NETPROG subdirectory. 
  1624.  
  1625.             C:\MUGLIB\LOGON LANBKID /P:password
  1626.             C:\OS2\XCOPY C:\IBMLAN\DCDB\USERS Z:\IBMLAN\DCDB\USERS /S /E
  1627.             C:\OS2\XCOPY C:\IBMLAN\DCDB\DEVICES Z:\IBMLAN\DCDB\DEVICES /S /E
  1628.             C:\OS2\XCOPY C:\IBMLAN\DCDB\PRINTERS Z:\IBMLAN\DCDB\PRINTERS /S /E
  1629.             C:\OS2\XCOPY C:\IBMLAN\DCDB\APPS Z:\IBMLAN\DCDB\APPS /S /E
  1630.             C:\OS2\XCOPY C:\IBMLAN\DCDB\FILES Z:\IBMLAN\DCDB\FILES /S /E
  1631.             C:\OS2\XCOPY C:\IBMLAN\DCDB\LISTS Z:\IBMLAN\DCDB\LISTS /S /E
  1632.             C:\OS2\XCOPY C:\IBMLAN\DCDB\DATA Z:\IBMLAN\DCDB\DATA /S /E
  1633.             C:\MUGLIB\LOGOFF
  1634.  
  1635.       Note:  The  /S parameter copies nonempty subdirectories within the path; 
  1636.              /E copies empty subdirectories with the /S parameter.  If the OS/2 
  1637.              program or subdirectory \MUGLIB is installed on a drive other than 
  1638.              C, these paths should reflect the drive where those products are 
  1639.              installed. 
  1640.  
  1641.    2. Schedule the running of this command file using the OS/2 Warp Server AT 
  1642.       command.  This command may be included in a command file.  For more 
  1643.       information and the syntax of the AT command, refer to the Command 
  1644.       Reference. 
  1645.  
  1646.       For example, type: 
  1647.  
  1648.             AT 01:00 /E:M,T,W,TH,F  C:\IBMLAN\NETPROG\BACKIT
  1649.  
  1650.       This example command copies the files at 1 a.m., Monday through Friday. 
  1651.  
  1652.       Note:  You can specify only one time value at a time with the AT command. 
  1653.              For example, you could not specify both 01:00 and 12:00. 
  1654.  
  1655.  The files in the specified DCDB subdirectories are copied to the additional 
  1656.  server at the time specified by the AT command.  No user is likely to be 
  1657.  logged on at the scheduled backup time.  The Replicator service is available 
  1658.  to replicate other files on the domain controller. 
  1659.  
  1660.  
  1661. ΓòÉΓòÉΓòÉ 4.11.4. Activating the Backup Domain Controller ΓòÉΓòÉΓòÉ
  1662.  
  1663. If you have not properly activated your backup domain controller, your users 
  1664. may get errors when logging on, or your domain control database (DCDB) may not 
  1665. be properly replicated to the backup domain controller. To activate the backup 
  1666. domain controller, complete these steps: 
  1667.  
  1668.    1. Define a user ID at the domain controller with the correct authorizations 
  1669.       and log onto the domain controller at the backup domain controller with 
  1670.       that user ID.  For example, a user ID with administrator authority would 
  1671.       allow DCDB replication at the backup domain controller. 
  1672.  
  1673.       Read (R) and Attribute (A) access permissions are required to replicate 
  1674.       the data under the DCDB directory.  Refer to Defining Access Control 
  1675.       Profiles  for more information regarding specific authorizations to 
  1676.       support DCDB replication. 
  1677.  
  1678.    2. Start the DCDBREPL service on both the domain controller and the backup 
  1679.       domain controller. 
  1680.  
  1681.       The DCDBREPL service is started automatically on the backup domain 
  1682.       controller and must be selected to start on the domain controller. The 
  1683.       backup domain controller is not activated until DCDBREPL is started on 
  1684.       the domain controller.  To start the DCDBREPL service at the domain 
  1685.       controller, complete one of the following steps: 
  1686.  
  1687.           Select the  DCDB Replicator on install option on the Server Services 
  1688.            panel. 
  1689.  
  1690.           Start the DCDBREPL service automatically when the server is started 
  1691.            by adding DCDBREPL to the SRVSERVICES line in IBMLAN.INI; for 
  1692.            example: 
  1693.  
  1694.                       SRVSERVICES = NetLogon,LSSERVER,DCDBREPL
  1695.  
  1696.           Add the following to STARTUP.CMD: 
  1697.  
  1698.                       NET START DCDBREPL
  1699.  
  1700.           Start the DCDBREPL service with the following command: 
  1701.  
  1702.                       NET START DCDBREPL
  1703.  
  1704.  
  1705. ΓòÉΓòÉΓòÉ 4.11.5. Recovering After Domain Controller Failure ΓòÉΓòÉΓòÉ
  1706.  
  1707. The following procedure configures an additional server as the temporary domain 
  1708. controller after the original domain controller fails.  If your domain 
  1709. controller fails and you have a backup domain controller, your domain continues 
  1710. to operate properly, except for resources on the domain controller itself and 
  1711. some logon assignments such as home directories.  If the primary domain 
  1712. controller must be down for an extended period, you can change the role of the 
  1713. backup to primary. This change allows users to get their logon assignments and 
  1714. the administrator to define new aliases or users. 
  1715.  
  1716. To configure an additional server as a domain controller: 
  1717.  
  1718.    1. Stop the NetLogon service at the additional server, either from the OS/2 
  1719.       Warp Server Administration or at the command line.  At the command 
  1720.       prompt, type: 
  1721.  
  1722.             NET STOP NetLogon
  1723.  
  1724.    2. Change the role of the additional server to Primary, so it can serve as a 
  1725.       temporary domain controller.  At the command prompt, type: 
  1726.  
  1727.             NET ACCOUNTS /ROLE:PRIMARY
  1728.  
  1729.    3. Restart the NetLogon service at the additional server.  At the command 
  1730.       prompt, type: 
  1731.  
  1732.             NET START NetLogon
  1733.  
  1734.       Until the role is explicitly changed by another NET ACCOUNTS command, 
  1735.       this server automatically starts up as the domain controller. 
  1736.  
  1737.       Note: 
  1738.  
  1739.       If the service is already started, replication does not occur.  To begin 
  1740.       replicating, you must first stop and then restart the service from an 
  1741.       OS/2 command prompt by typing: 
  1742.  
  1743.             NET STOP DCDBREPL
  1744.             NET START DCDBREPL
  1745.  
  1746.       The following step is not necessary if the DCDB Replicator service backed 
  1747.       up the DCDB. 
  1748.  
  1749.    4. When the server starts, it creates the proper access control profiles 
  1750.       needed for the subdirectories in the \IBMLAN\DCDB directory, unless the 
  1751.       access control profiles already exist.  However, the server does not 
  1752.       create access control profiles for individual user directories 
  1753.       (\IBMLAN\DCDB\USERS\ userid). 
  1754.  
  1755.       Using LAN Server Administration, create access control profiles for each 
  1756.       user directory (\IBMLAN\DCDB\USERS\ userid).  Give users full access 
  1757.       (RWCXDAP) to their user directories.  For more information about creating 
  1758.       access control profiles, see  Creating an Access Control Profile. 
  1759.  
  1760.  Users can log on to the domain but cannot access resources (printers, files, 
  1761.  applications, serial devices, and home directories) on the original domain 
  1762.  controller. 
  1763.  
  1764.  
  1765. ΓòÉΓòÉΓòÉ 4.11.6. Restoring Files to the Original Domain Controller ΓòÉΓòÉΓòÉ
  1766.  
  1767. The following procedure restores the files to the original domain controller 
  1768. from the temporary domain controller.  The temporary domain controller can be 
  1769. any additional server or backup domain controller if you have configured one. 
  1770. If you have a backup domain controller, the DCDB information should already 
  1771. have been copied from the original domain controller using the DCDB Replicator 
  1772. service.  Make sure that all users are logged off before beginning. 
  1773.  
  1774. This procedure does the following: 
  1775.  
  1776.      Makes the original domain controller a server (with a role of Member) in 
  1777.       addition to the temporary domain controller 
  1778.  
  1779.      Restores the NET.ACC file on the original domain controller, which causes 
  1780.       the user and group definitions to be copied to the originaldomain 
  1781.       controller 
  1782.  
  1783.      Restores default or backup 386 HPFS access control profiles on the 
  1784.       original domain controller. (See the Command Reference for more 
  1785.       information.) 
  1786.  
  1787.      Copies the DCDB information from the temporary domain controller to the 
  1788.       original domain controller 
  1789.  
  1790.      Changes the temporary domain controller role to Member 
  1791.  
  1792.      Changes the original domain controller role to Primary 
  1793.  
  1794.  To restore files to the domain controller: 
  1795.  
  1796.    1. Restore the NET.ACC file on the original domain controller by restoring 
  1797.       the NET.ACC file to the proper directory. 
  1798.  
  1799.       In addition to OS/2 Warp Server and its components (including User 
  1800.       Profile Management), database manager and other program functions use the 
  1801.       NET.ACC file.  The NET.ACC file cannot be restored when these functions 
  1802.       are active. For example, if any type of logon is issued before running a 
  1803.       OS/2 Warp Server function, the NET.ACC file remains open and locked for 
  1804.       the duration of the workstation session. 
  1805.  
  1806.       In these cases, you must ensure that all autostart services are disabled 
  1807.       before you can restore the NET.ACC file.  To disable all autostart 
  1808.       services: 
  1809.  
  1810.         a. Copy and rename your STARTUP.CMD file (for example, STARTUP.BAK). 
  1811.  
  1812.         b. Remove programs from the Startup folder. 
  1813.  
  1814.         c. Comment out RUN statements in your CONFIG.SYS file that run OS/2 
  1815.            Warp Server, User Profile Management, or other programs that use the 
  1816.            NET.ACC file. 
  1817.  
  1818.         d. Close any running programs. 
  1819.  
  1820.            After you have disabled the autostart services, restore the NET.ACC 
  1821.            file as follows: 
  1822.  
  1823.         e. If you have Local Security started, disable it by removing 
  1824.            C:\IBMLAN\NETPROG\SECURESH.EXE 
  1825.  
  1826.            from the PROTSHELL statement in the CONFIG.SYS file. 
  1827.  
  1828.         f. Restart the system. 
  1829.  
  1830.         g. Replace the NET.ACC file with the backup copy. At the command prompt 
  1831.            on the original domain controller, type: 
  1832.  
  1833.                       COPY C:\IBMLAN\ACCOUNTS\NETACC.BKP C:\IBMLAN\ACCOUNTS\NET.ACC
  1834.  
  1835.         h. If you have 386 HPFS drives, use the RESTACC utility to restore the 
  1836.            access control profiles that you previously backed up using the 
  1837.            BACKACC utility.  For example: 
  1838.  
  1839.                       RESTACC C:\ /S
  1840.  
  1841.            If you have multiple 386 HPFS drives to restore, issue the RESTACC 
  1842.            command specifying the drive letter for each drive.  See the Command 
  1843.            Reference for more information. 
  1844.  
  1845.         i. Reestablish your autostart services. 
  1846.  
  1847.         j. Reestablish local security by changing the PROTSHELL= statement in 
  1848.            the CONFIG.SYS file to: 
  1849.  
  1850.                       PROTSHELL=C:\IBMLAN\NETPROG\SECURESH.EXE C:\OS2\PMSHELL.EXE
  1851.  
  1852.         k. Restart your workstation and log on again as an administrator. 
  1853.  
  1854.    2. Change the role of the original domain controller to Member.  At the 
  1855.       command prompt, type: 
  1856.  
  1857.             NET ACCOUNTS /ROLE:MEMBER
  1858.  
  1859.    3. Start the original domain controller.  At the command prompt, type: 
  1860.  
  1861.             NET START SERVER
  1862.  
  1863.    4. Copy the user and group accounts information on the temporary domain 
  1864.       controller to the original domain controller.  At the command prompt on 
  1865.       the original domain controller, type: 
  1866.  
  1867.             NET STOP NetLogon
  1868.             NET START NetLogon /UPDATE:Y
  1869.  
  1870.       These commands update the user and group accounts information to start 
  1871.       within 60 seconds.  Wait a few minutes for this copy process to be 
  1872.       completed ( depending upon the size of your domain and the number of 
  1873.       users in the domain) before continuing to the following step. 
  1874.  
  1875.    5. Log on at the original domain controller with the user and administrator 
  1876.       ID. For example, at the command prompt on the original domain controller, 
  1877.       type: 
  1878.  
  1879.             LOGON LANBKID /P:password
  1880.  
  1881.       If you do not plan to use the DCDB Replicator service to restore your 
  1882.       DCDB, you can also log on through User Profile Management using the 
  1883.       following command: 
  1884.  
  1885.             NET USE Z: \\SRVRNAME\C$
  1886.       where Z: is the root drive of the additional server and C is the drive 
  1887.       where OS/2 Warp Server resides. 
  1888.  
  1889.    6. After logging on, either use the DCDB Replicator service or issue the 
  1890.       following commands to restore the files from the temporarydomain 
  1891.       controller: 
  1892.  
  1893.             XCOPY Z:\IBMLAN\DCDB C:\IMBLAN\DCDB /S /E
  1894.  
  1895.    7. Log off.  At the command prompt on the original domain controller, type: 
  1896.  
  1897.             LOGOFF
  1898.  
  1899.       You can also log off through User Profile Management. 
  1900.  
  1901.    8. Change the role of the original domain controller to Primary.  At the 
  1902.       command prompt on the domain controller, type: 
  1903.  
  1904.             NET STOP NetLogon
  1905.             NET ACCOUNTS /ROLE:PRIMARY
  1906.  
  1907.    9. Change the role of the temporary domain controller to Member, or, if your 
  1908.       temporary domain controller was a backup domain controller, to Backup. 
  1909.       At the command prompt on the temporary domain controller, type: 
  1910.  
  1911.             NET STOP NetLogon
  1912.             NET ACCOUNTS /ROLE:MEMBER
  1913.  
  1914.       Until the role is explicitly changed by another NET ACCOUNTS command, 
  1915.       this server automatically starts up as an additional server. 
  1916.  
  1917.   10. Stop and restart the Server service on both the original and temporary 
  1918.       domain controllers.  At the command prompt on both workstations, type: 
  1919.  
  1920.             NET STOP SERVER
  1921.             NET START SERVER
  1922.  
  1923.   11. If the DCDB Replicator service is already started, replication does not 
  1924.       occur.  To begin replicating, you must first stop and then restart the 
  1925.       service from an OS/2 command prompt by typing: 
  1926.  
  1927.             NET STOP DCDBREPL
  1928.             NET START DCDBREPL
  1929.  
  1930.  Users can log on to the domain and access resources (printers, files, 
  1931.  applications, serial devices, and home directories) on the domain controller. 
  1932.  Users who are logged on to the domain when you change the role of the servers 
  1933.  must log off and log back on after the servers are restarted. 
  1934.  
  1935.  
  1936. ΓòÉΓòÉΓòÉ 4.11.7. Allowing Adequate NET.ACC Synchronization Time ΓòÉΓòÉΓòÉ
  1937.  
  1938. When additional servers or backup domain controllers are synchronized with the 
  1939. domain controller, no messages are displayed to indicate when synchronization 
  1940. has completed.  Therefore, it is important to allow adequate NET.ACC 
  1941. synchronization time during certain procedures. Otherwise, you may encounter 
  1942. unexpected or undesired results. 
  1943.  
  1944. For example, if you are using a REXX command file to set up the accounts and 
  1945. shared resources, you need to be aware of the propagation time.  For example, 
  1946. if you define an alias for a resource on a remote workstation and then 
  1947. immediately try to define the access profile for that resource, the operation 
  1948. will fail with a message telling you resource not found because the NET.ACC 
  1949. which contains the definition for that alias has not been replicated to the 
  1950. additional servers yet. 
  1951.  
  1952. Another situation where synchronization is important is during disaster 
  1953. recovery.  For example, if you use a backup domain controller during primary 
  1954. domain controller failure, the time you allow for NET.ACC synchronization is 
  1955. critical to successful recovery.  If the backup domain controller is promoted 
  1956. to a primary role because of a long downtime on the failed domain controller, 
  1957. the main NET.ACC file now resides on the temporary domain controller. 
  1958.  
  1959. Eventually, when you switch the roles back (once the domain controller is 
  1960. repaired), the domain controller needs to come up as a member first in order to 
  1961. copy the NET.ACC.  At this point, if you prematurely restore the original 
  1962. roles, the NET.ACC can end up in an incomplete state, and it would be very 
  1963. difficult to recover the lost information. Be sure to allow enough time for 
  1964. NET.ACC replication on the domain controller before changing servers back to 
  1965. their original roles. 
  1966.  
  1967.  
  1968. ΓòÉΓòÉΓòÉ 4.12. Identifying Server Problems ΓòÉΓòÉΓòÉ
  1969.  
  1970. Use the following procedure to identify a problem with your server. If the hard 
  1971. disk does not start the system, start it from OS/2 installation diskettes. 
  1972. Insert the  OS/2 Install Diskette and then insert Diskette 1  when prompted to 
  1973. do so.  Press Esc from the first window, and make any necessary changes to the 
  1974. files on the hard disk.  If you need more information, refer to the 
  1975. Serviceability and Troubleshooting Guide. 
  1976.  
  1977. To identify where a problem is occurring on a server: 
  1978.  
  1979.    1. Make sure that the PATH, LIBPATH, and DPATH statements in the CONFIG.SYS 
  1980.       file are intact. 
  1981.  
  1982.    2. Rename the STARTUP.CMD file.  This action removes all automatic start 
  1983.       actions.  See Restoring files to the domain controller for more 
  1984.       information about disabling the autostart features of OS/2 Warp Server. 
  1985.  
  1986.    3. Try to start the server. 
  1987.  
  1988.       If the system starts, go to step  10. 
  1989.  
  1990.       If the system does not start, the problem is in the CONFIG.SYS file. Go 
  1991.       to the following step. 
  1992.  
  1993.    4. Disable the NETWKSTA.200 line by adding REM at the start of the line: 
  1994.  
  1995.             REM IFS=C:\IBMLAN\NETPROG\NETWKSTA.200 /I:C:\IBMLAN
  1996.  
  1997.       If you can start the system now, the NETWKSTA.200 line contains an error. 
  1998.       This line reads the Networks and Requester sections of the IBMLAN.INI 
  1999.       file. Go to the following step. 
  2000.  
  2001.    5. Check for an error on the NET1 line or for a workstation name that is not 
  2002.       valid in the Requester section.  Be sure that the X1, X2, and X3 values 
  2003.       are adequate for your network.  For more information on calculating these 
  2004.       resources for your network, refer to Quick Beginnings.  For more 
  2005.       information about the IBMLAN.INI file and the NETWKSTA.200 line, refer to 
  2006.       Performance Tuning . 
  2007.  
  2008.       If the system still does not start, go to step  6. 
  2009.  
  2010.    6. Disable the following LAN drivers by adding REM at the start of the lines 
  2011.       in the CONFIG.SYS file that include the LAN drivers: 
  2012.  
  2013.           ELNKII.OS2 
  2014.  
  2015.           ELNKMC.OS2 
  2016.  
  2017.           IBMNET.OS2 
  2018.  
  2019.           IBMNETA.OS2 
  2020.  
  2021.           IBMTOK.OS2 
  2022.  
  2023.           IBMTRBM.OS2 
  2024.  
  2025.           LANDD.OS2 
  2026.  
  2027.           MACWDAT.OS2 
  2028.  
  2029.           MACWDMC.OS2 
  2030.  
  2031.           NETBEUI.OS2 
  2032.  
  2033.           UBNEIPC.OS2 
  2034.  
  2035.           UBNEIPS.OS2 
  2036.  
  2037.           MACETH.OS2 
  2038.  
  2039.           IBMXLN.OS2 
  2040.  
  2041.       If you can start the system now, the problem is either in the LAN 
  2042.       hardware or in the PROTOCOL.INI file. 
  2043.  
  2044.       If you cannot start the system, the problem lies in the OS/2 program, not 
  2045.       in the server.  Go to the following step. 
  2046.  
  2047.    7. Enable the NETWKSTA.200 line by removing REM at the start of the line: 
  2048.  
  2049.             IFS=C:\IBMLAN\NETPROG\NETWKSTA.200 /I:C:\IBMLAN
  2050.  
  2051.    8. Use the OS/2 installation diskette to copy the OS2.INI and OS2SYS.INI 
  2052.       files from backup or from another workstation. 
  2053.  
  2054.       If the LAN drivers and NETWKSTA.200 file initialize properly, go to the 
  2055.       following step. 
  2056.  
  2057.    9. At the command prompt, type: 
  2058.  
  2059.             NET START REQUESTER
  2060.  
  2061.       If the Requester service does not start, start other OS/2 Warp Server or 
  2062.       LAN Server services in the IBMLAN.INI file by typing each of the 
  2063.       following commands, one at a time: 
  2064.  
  2065.             NET START REQUESTER /WRKS:
  2066.             NET START LSCLIENT
  2067.             NET START service
  2068.       where  service is any other service in the wrkservices parameter of the 
  2069.       IBMLAN.INI file. 
  2070.  
  2071.       Make a note of any error messages that are displayed, and refer to the 
  2072.       ERROR.TXT file for more information. 
  2073.  
  2074.       If the Requester service starts, continue with step  10. 
  2075.  
  2076.   10. At the command prompt, type: 
  2077.  
  2078.             NET START SERVER
  2079.  
  2080.       If the Server service does not start, start other OS/2 Warp Server or LAN 
  2081.       Server services in the IBMLAN.INI file by typing each of the following 
  2082.       commands, one at a time: 
  2083.  
  2084.             NET START SERVER /SRVS:
  2085.             NET START LSSERVER
  2086.             NET START service
  2087.             NET START NetLogon
  2088.       where  service is any other service in the srvservices parameter of the 
  2089.       IBMLAN.INI file. 
  2090.  
  2091.       Make a note of any error messages that are displayed, and refer to the 
  2092.       ERROR.TXT file for more information. 
  2093.  
  2094.       If the  NET START NetLogon command is unsuccessful, the problem is 
  2095.       probably caused by the NET.ACC file.  See Restoring files to the domain 
  2096.       controller for instructions on restoring the NET.ACC file. 
  2097.  
  2098.  For more information, see the following topic: 
  2099.  
  2100.      Resynchronizing Passwords with the NetLogon Service 
  2101.  
  2102.  
  2103. ΓòÉΓòÉΓòÉ 4.12.1. Resynchronizing Passwords with the NetLogon Service ΓòÉΓòÉΓòÉ
  2104.  
  2105. The server user IDs and passwords validate the identity of servers that receive 
  2106. copies of the NET.ACC file.  Passwords can become unsynchronized when you use 
  2107. the NetLogon service if you: 
  2108.  
  2109.      Reinstall a default or backup NET.ACC file onto an additional or backup 
  2110.       server 
  2111.  
  2112.      Reinstall a default or backup NET.ACC file onto the domain controller 
  2113.  
  2114.      Inadvertently change an additional or backup server's password on the 
  2115.       domain controller without the new password being replicated to the 
  2116.       additional or backup server before the next time NetLogon uses it 
  2117.  
  2118.      Change passwords as a network error occurs during normal server operation 
  2119.  
  2120.      Shut down an additional or backup server while the domain controller 
  2121.       continues to run 
  2122.  
  2123.  This procedure describes how to resynchronize an additional server's password 
  2124.  with the domain controller.  You work at the domain controller initially, and 
  2125.  finish at the additional server (unless the additional server is a Windows NT 
  2126.  server, in which case you work only at the domain controller). Solutions to 
  2127.  Resynchronization Problems provides steps for solving problems if the 
  2128.  resynchronization fails. 
  2129.  
  2130.  To resynchronize passwords with the NetLogon service: 
  2131.  
  2132.  At the domain controller: 
  2133.  
  2134.    1. Open  LAN Server Administration. 
  2135.  
  2136.    2. Open the appropriate domain object. 
  2137.  
  2138.    3. Open  Defined Servers. 
  2139.  
  2140.       Ensure that there is an object for the additional server. 
  2141.  
  2142.    4. If the additional server does not exist: 
  2143.  
  2144.         a. Drag the  Server Template to an open area in the Defined Servers 
  2145.            folder. 
  2146.  
  2147.            The Defined Server - Create notebook is displayed. 
  2148.  
  2149.         b. Complete the Identity page. 
  2150.  
  2151.         c. Select  Create. 
  2152.  
  2153.    5. Open the appropriate server. 
  2154.  
  2155.    6. Open  Services. 
  2156.  
  2157.    7. With mouse button 2, select  NetLogon Service. 
  2158.  
  2159.    8. Select  Start.  The NetLogon service starts. 
  2160.  
  2161.  At the additional server: 
  2162.  
  2163.    1. Enter the following command at the OS/2 prompt: 
  2164.  
  2165.             NET START SERVER
  2166.  
  2167.       The additional server attempts to start.  If it fails to start, continue 
  2168.       with the next step to resynchronize the additional server's internal 
  2169.       password with the domain controller. 
  2170.  
  2171.    2. Enter the following command: 
  2172.  
  2173.             LOGON USERID /P:PASSWORD
  2174.  
  2175.       This command uses the default user ID and password to log you on to the 
  2176.       domain. 
  2177.  
  2178.    3. Enter the following command: 
  2179.  
  2180.             NET STOP SERVER
  2181.  
  2182.       This command stops all server services. 
  2183.  
  2184.    4. Enter the following command: 
  2185.  
  2186.             NET USER servername newpasswd
  2187.  
  2188.       where: 
  2189.  
  2190.       servername               Is the name of the failing additional server. 
  2191.  
  2192.       newpasswd                Is the new password for the additional server. 
  2193.  
  2194.       This command sets the additional server's password on the domain 
  2195.       controller. 
  2196.  
  2197.    5. Enter the following command: 
  2198.  
  2199.             NET ACCOUNTS /ROLE:STANDALONE
  2200.  
  2201.       This command sets the additional server's role to stand-alone. 
  2202.  
  2203.    6. Enter the following command: 
  2204.  
  2205.             NET USER servername newpasswd
  2206.  
  2207.       where: 
  2208.  
  2209.       servername               Is the same name you entered in step  4. 
  2210.  
  2211.       newpasswd                Is the same new password you entered in step 4. 
  2212.  
  2213.       This command sets the additional server's password locally. 
  2214.  
  2215.    7. Enter one of the following commands, according to your need: 
  2216.  
  2217.             NET ACCOUNTS /ROLE:MEMBER
  2218.  
  2219.       or 
  2220.  
  2221.             NET ACCOUNTS /ROLE:BACKUP
  2222.  
  2223.       The command you enter resets the additional server's role to either 
  2224.       member or backup. 
  2225.  
  2226.    8. Enter the following command: 
  2227.  
  2228.             NET START SERVER
  2229.  
  2230.       The NetLogon service starts the additional server.  The server's internal 
  2231.       password is synchronized with the domain controller. 
  2232.  
  2233.  For more information, see Solutions to Resynchronization Problems. 
  2234.  
  2235.  
  2236. ΓòÉΓòÉΓòÉ 4.12.1.1. Solutions to Resynchronization Problems ΓòÉΓòÉΓòÉ
  2237.  
  2238. This section provides two possible solutions if the resynchronization procedure 
  2239. fails to start the additional server: 
  2240.  
  2241.      Resynchronization Problems - Solution A 
  2242.  
  2243.      Resynchronization Problems - Solution B 
  2244.  
  2245.  
  2246. ΓòÉΓòÉΓòÉ 4.12.1.1.1. Resynchronization Problems - Solution A ΓòÉΓòÉΓòÉ
  2247.  
  2248. Complete the next procedure if any of these statements about your 
  2249. resynchronization attempt are true: 
  2250.  
  2251.      The default user ID in step  2 (at the additional server) does not exist. 
  2252.  
  2253.      The default password in step  2 (at the additional server) does not 
  2254.       exist. 
  2255.  
  2256.      A command in the resynchronization procedure produces an Access Denied 
  2257.       message. 
  2258.  
  2259.  Perform the following steps at the OS/2 prompt on the additional server: 
  2260.  
  2261.    1. Enter the following command: 
  2262.  
  2263.             LOGON userid /P:passwd
  2264.  
  2265.       where: 
  2266.  
  2267.       userid                   Is a valid user ID on the domain controller. 
  2268.  
  2269.       passwd                   Is a valid password on the domain controller. 
  2270.  
  2271.       This command logs you on the domain controller with an existing 
  2272.       administrator ID. 
  2273.  
  2274.    2. Enter the following command: 
  2275.  
  2276.             NET USER newuseridnewpasswd /ACTIVE:YES /ADD /PRIVILEGE:USER
  2277.  
  2278.       where: 
  2279.  
  2280.       newuserid                Is a new user ID. 
  2281.  
  2282.       newpasswd                Is a new password. 
  2283.  
  2284.       This command adds a new administrator ID on the domain controller. 
  2285.  
  2286.    3. Enter the following command: 
  2287.  
  2288.             NET ACCOUNTS /ROLE:STANDALONE
  2289.  
  2290.       This command sets the additional server's role to stand-alone. 
  2291.  
  2292.    4. Enter the following command: 
  2293.  
  2294.             LOGON userid /P:passwd /L
  2295.  
  2296.       where: 
  2297.  
  2298.       userid                   Is a valid user ID on the additional server. 
  2299.  
  2300.       passwd                   Is a valid password on the additional server. 
  2301.  
  2302.       This command logs you on the additional server with an existing ID. 
  2303.  
  2304.    5. Enter the following command: 
  2305.  
  2306.             NET USER newuseridnewpasswd /ACTIVE:YES /ADD /PRIVILEGE:ADMIN
  2307.  
  2308.       where: 
  2309.  
  2310.       newuserid                Is the same new user ID you entered in step  2 
  2311.                                of this solution procedure. 
  2312.  
  2313.       newpasswd                Is the same new password you entered in step 
  2314.                                2of this solution procedure. 
  2315.  
  2316.       This command adds a new administrator ID on the additional server. 
  2317.  
  2318.    6. Enter one of the following commands, according to your need: 
  2319.  
  2320.             NET ACCOUNTS /ROLE:MEMBER
  2321.  
  2322.       or 
  2323.  
  2324.             NET ACCOUNTS /ROLE:BACKUP
  2325.  
  2326.       The command you enter resets the additional server's role to either 
  2327.       member or backup. 
  2328.  
  2329.    7. Using the new administrator ID you created in this solution procedure, 
  2330.       repeat the second half of the procedure in Resynchronizing Passwords with 
  2331.       the NetLogon Service, starting with  At the additional server, step 1. 
  2332.  
  2333.  
  2334. ΓòÉΓòÉΓòÉ 4.12.1.1.2. Resynchronization Problems - Solution B ΓòÉΓòÉΓòÉ
  2335.  
  2336. Complete the next procedure if the NetLogon service fails to start for any 
  2337. reason.  This solution removes the additional server from the Servers group, 
  2338. deletes the user ID, and adds the server again as a new member. 
  2339.  
  2340. Perform the following steps at the OS/2 prompt on the additional server: 
  2341.  
  2342.    1. Enter the following command: 
  2343.  
  2344.             NET STOP REQ
  2345.  
  2346.       This command stops all services. 
  2347.  
  2348.    2. Enter the following command: 
  2349.  
  2350.             NET START REQ
  2351.  
  2352.       This command starts only the requester service. 
  2353.  
  2354.    3. Enter the following command: 
  2355.  
  2356.             LOGON USERID /P:PASSWORD
  2357.  
  2358.       This command uses the default user ID and password to log you on to the 
  2359.       domain. 
  2360.  
  2361.    4. Enter the following command: 
  2362.  
  2363.             NET GROUP SERVERS servername /D
  2364.  
  2365.       where  servername is the name of the failing additional server. 
  2366.  
  2367.       This command removes the server from the group. 
  2368.  
  2369.    5. Enter the following command: 
  2370.  
  2371.             NET USER servername /D
  2372.  
  2373.       where  servername is the name of the failing additional server. 
  2374.  
  2375.       This command deletes the additional server's machine ID. 
  2376.  
  2377.    6. Enter the following command: 
  2378.  
  2379.             NET USER servernamepasswd /ADD
  2380.  
  2381.       where: 
  2382.  
  2383.       servername               Is either the original name or a new name for 
  2384.                                the additional server. 
  2385.  
  2386.       passwd                   Is either the original password or a new 
  2387.                                password for the additional server. 
  2388.  
  2389.       This command redefines the server. 
  2390.  
  2391.    7. Enter the following command: 
  2392.  
  2393.             NET GROUP SERVERS servername /ADD
  2394.  
  2395.       where  servername is the name of the additional server. 
  2396.  
  2397.       This command adds the server to the group. 
  2398.  
  2399.    8. Enter the following command: 
  2400.  
  2401.             NET START SERVER
  2402.  
  2403.       The NetLogon service starts the additional server.  The server's internal 
  2404.       password is synchronized with the domain controller. 
  2405.  
  2406.       If the NetLogon service still does not start, repeat the second half of 
  2407.       the procedure in  Resynchronizing Passwords with the NetLogon Service, 
  2408.       starting with  At the additional server, step 1. 
  2409.  
  2410.  
  2411. ΓòÉΓòÉΓòÉ 5. Using the Logical Volume Manager ΓòÉΓòÉΓòÉ
  2412.  
  2413. The Logical Volume Manager (LVM) allows you to create and manage volumes on the 
  2414. hard disks in your system. LVM components are initially installed and 
  2415. configured during the OS/2 Warp Server for e-business installation process. For 
  2416. a detailed discussion of LVM, including information about using it during 
  2417. installation, see Quick Beginnings. 
  2418.  
  2419. LVM provides both physical and logical views of the system. The physical view 
  2420. shows how the hard disks are configured. The logical view displays the volumes 
  2421. currently configured on the system. You can switch between the two views by 
  2422. selecting View from the toolbar and choosing the view you want. 
  2423.  
  2424.  
  2425. ΓòÉΓòÉΓòÉ 5.1. Physical View ΓòÉΓòÉΓòÉ
  2426.  
  2427. The physical view of LVM allows you to create and manage partitions on the hard 
  2428. disks in your system. This view has two windows to show how the disks are 
  2429. partitioned and the volumes that are associated with them. This view displays 
  2430. the partitions present on each hard disk, allowing you to create and manage 
  2431. individual partitions. When you select a partition, the details of that 
  2432. partition or the volume associated with that partition are displayed in the 
  2433. lower window. 
  2434.  
  2435. The physical view includes the following information: 
  2436.  
  2437.  Logical Volume      The name that has been assigned to the volume. A volume 
  2438.                      consists of one or more partitions. It is assigned a drive 
  2439.                      letter and is treated as if it were a single, contiguous 
  2440.                      partition. You can specify the name with the Create Volume 
  2441.                      option, and you can change the name with the Set/Change 
  2442.                      Name on Volume option. 
  2443.  
  2444.  Partition Name      The name that has been assigned to the partition. You can 
  2445.                      specify this name with the Create Partition option. 
  2446.  
  2447.  File System         Indicates the type of file system on the volume. Any 
  2448.                      volumes that have not been formatted will not have a file 
  2449.                      type indicated. 
  2450.  
  2451.  Size                Indicates the size, in megabytes (MB), of the volume. 
  2452.  
  2453.  Drive Linking       Indicates if drives are linked together to create volumes. 
  2454.  
  2455.  
  2456. ΓòÉΓòÉΓòÉ 5.2. Logical View ΓòÉΓòÉΓòÉ
  2457.  
  2458. The logical view displays the volumes, their size, the unused portion size, and 
  2459. the volume name, and it indicates if the volume is linked. You can use this 
  2460. view to create, delete, and name volumes. 
  2461.  
  2462. The logical view includes the following information: 
  2463.  
  2464.  Volume Name         The name that has been assigned to the volume. A volume 
  2465.                      consists of one or more partitions. It is assigned a drive 
  2466.                      letter and is treated as if it were a single, contiguous 
  2467.                      partition. You can specify the name with the Create Volume 
  2468.                      option, and you can change the name with the Set/Change 
  2469.                      Name of Volume option. 
  2470.  
  2471.  Size                Indicates the size, in megabytes (MB), of the volume. 
  2472.  
  2473.  % Used              Indicates the amount of space used on a volume. 
  2474.  
  2475.  Unused (MB)         Indicates the usable free space, in megabytes (MB). 
  2476.  
  2477.  File System         Indicates the type of file system on the volume. Any 
  2478.                      volumes that have not been formatted will not have a file 
  2479.                      type indicated. 
  2480.  
  2481.  Drive Linking       Indicates if drives are linked together to create volumes. 
  2482.  
  2483.  You can perform the following tasks with LVM: 
  2484.  
  2485.      Create compatibility volumes (partitions), which can be seen by previous 
  2486.       versions of OS/2 and other operating systems 
  2487.  
  2488.      Create logical volumes that span physical disks 
  2489.  
  2490.      Expand logical volumes (for JFS only) 
  2491.  
  2492.      Delete compatibility volumes (partitions) 
  2493.  
  2494.      Delete logical volumes 
  2495.  LVM can also be used after installation to perform additional configuration, 
  2496.  if necessary. 
  2497.  
  2498.  
  2499. ΓòÉΓòÉΓòÉ 5.3. Creating a Volume ΓòÉΓòÉΓòÉ
  2500.  
  2501. Use Create Volume to create a volume. A volume consists of one or more disk 
  2502. partitions. Each volume is then assigned a drive letter. Currently, volumes 
  2503. have drive letters assigned to them, but partitions do not. You can create two 
  2504. types of volumes: 
  2505.  
  2506.      Bootable Volume 
  2507.  
  2508.      Nonbootable Volume 
  2509.  
  2510.  
  2511. ΓòÉΓòÉΓòÉ 5.3.1. Creating a Bootable Volume ΓòÉΓòÉΓòÉ
  2512.  
  2513. A bootable volume is a volume that can be used to boot an operating system. 
  2514. Only compatibility volumes are bootable. 
  2515.  
  2516. To create a bootable volume: 
  2517.  
  2518.    1. Select Volume from the toolbar. 
  2519.  
  2520.    2. Select Create Volume. 
  2521.  
  2522.    3. Select Create Bootable Volume. 
  2523.  
  2524.    4. Select the partition or free space to create the volume from. 
  2525.  
  2526.    5. Type the new volume name in the space provided. 
  2527.  
  2528.    6. Choose the new drive letter associated with the volume and press OK. The 
  2529.       new volume name and drive letter is now displayed. 
  2530.  
  2531.  
  2532. ΓòÉΓòÉΓòÉ 5.3.2. Creating a Nonbootable Volume ΓòÉΓòÉΓòÉ
  2533.  
  2534. A nonbootable volume is a volume that cannot be used to boot an operating 
  2535. system. It can be a compatibility volume or an LVM volume. 
  2536.  
  2537. To create a nonbootable volume: 
  2538.  
  2539.    1. Select Volume from the toolbar. 
  2540.  
  2541.    2. Select Create Volume. 
  2542.  
  2543.    3. Select Create Nonbootable Volume. 
  2544.  
  2545.    4. Select Create Compatibility Volume if you want the volume to be accessed 
  2546.       by other operating systems and previous versions of OS/2. Otherwise, 
  2547.       select Create LVM Volume if you want the volume to span multiple disks, 
  2548.       support Bad Block Relocation, or eventually be expanded. 
  2549.  
  2550.    5. Select the partition(s) or free space to create the volume from. 
  2551.  
  2552.    6. Type the new volume name in the space provided. 
  2553.  
  2554.    7. Choose the new drive letter and press OK. The new volume name and drive 
  2555.       letter are now displayed. 
  2556.  Changes are effective when you save the changes and exit LVM. The system will 
  2557.  then attempt to add the new volume without rebooting; however, if the Disk 
  2558.  Device Manager has exhausted its resources, the system will need to reboot to 
  2559.  make the changes effective. 
  2560.  
  2561.  
  2562. ΓòÉΓòÉΓòÉ 5.4. Changing a Drive Letter Assigned to a Volume ΓòÉΓòÉΓòÉ
  2563.  
  2564. Use Change Drive Letter Assigned to a Volume to change the drive letter 
  2565. associated with an existing volume. The new drive letter association will then 
  2566. remain unchanged until you change the drive letter again or delete the volume. 
  2567.  
  2568. Note:  Changing the drive letter assigned to a volume can have unforeseen 
  2569.        effects. As a minimum, the drive letter currently assigned to the volume 
  2570.        must not appear in any path, dpath, or libpath statements in your 
  2571.        CONFIG.SYS file. Furthermore, the drive letter should not be referenced 
  2572.        in any of the .INI files on the system. If these conditions are not met, 
  2573.        your system may not boot properly, and some programs may not run 
  2574.        correctly. 
  2575.  
  2576.  To change the drive letter assigned to a volume: 
  2577.  
  2578.    1. Select Volume from the toolbar. 
  2579.  
  2580.    2. Select Change Drive Letter Assigned to a Volume. 
  2581.  
  2582.    3. Select the volume that you want to modify. 
  2583.  
  2584.    4. Choose the new drive letter and press OK. The new drive letter is now 
  2585.       displayed. 
  2586.  
  2587.  Note:  You can also change the drive letter by selecting the volume and using 
  2588.         the right mouse button. 
  2589.  
  2590.  When the changes are saved, the system will attempt to change the driver 
  2591.  letter assignment without rebooting; however, if the file system cannot be 
  2592.  unmounted, or if the Disk Device Manager has exhausted its resources, the 
  2593.  system will need to reboot to make the changes effective. 
  2594.  
  2595.  Note:  This choice can also be used to make the volume visible to OS/2 after 
  2596.         you have hidden it using Hide the Volume from OS/2. 
  2597.  
  2598.  
  2599. ΓòÉΓòÉΓòÉ 5.5. Expanding a Volume ΓòÉΓòÉΓòÉ
  2600.  
  2601. Use Expand the Volume to expand an LVM volume. 
  2602.  
  2603. Note:  You must be using the Journaled File System (JFS) to be able to expand a 
  2604.        volume. Currently, FAT and HPFS file systems cannot make use of extra 
  2605.        space. For these file types, you must reformat the volume. JFS uses the 
  2606.        EXTENDFS utility to allow it to use the extra space. See the Command 
  2607.        Reference for more information. 
  2608.  
  2609.  To expand a volume: 
  2610.  
  2611.    1. Select Volume from the toolbar. 
  2612.  
  2613.    2. Select Expand Volume. 
  2614.  
  2615.    3. Select the volume you want to expand. 
  2616.  
  2617.  A window is displayed, allowing you to specify volume options. 
  2618.  
  2619.    4. Make your selections in the window and press OK to activate your choices. 
  2620.  
  2621.  
  2622. ΓòÉΓòÉΓòÉ 5.6. Setting or Changing a Volume Name ΓòÉΓòÉΓòÉ
  2623.  
  2624. Use Set/Change the Volume Name to set or change the name of a volume. The 
  2625. volume name on the Boot Manager Startup menu is also changed, if applicable. 
  2626. The names you assign to volumes remain unchanged through rebooting and hardware 
  2627. changes, and they always identify the same area on the disk. Volume names can 
  2628. be up to 20 characters long, can be entered in mixed case, and can contain 
  2629. spaces. 
  2630.  
  2631. To set or change a volume name: 
  2632.  
  2633.    1. Select Volume from the toolbar. 
  2634.  
  2635.    2. Select Set/Change Name on Volume. 
  2636.  
  2637.    3. Select the volume you want to change. 
  2638.  
  2639.    4. Type the volume name in the space provided and press OK. The new volume 
  2640.       name is now displayed. 
  2641.  
  2642.  Note:  You can also set or change the volume name by selecting the volume and 
  2643.         using the right mouse button. 
  2644.  
  2645.  
  2646. ΓòÉΓòÉΓòÉ 5.7. Deleting a Volume ΓòÉΓòÉΓòÉ
  2647.  
  2648. Use Delete Volume to delete volumes. All partition structures associated with 
  2649. the volume will be removed from the associated hard disk(s). 
  2650.  
  2651. To delete a volume: 
  2652.  
  2653.    1. Select Volume from the toolbar. 
  2654.  
  2655.    2. Select Delete Volume. 
  2656.  
  2657.    3. Select the volume you want to delete. 
  2658.  
  2659.    4. Press OK to delete the volume. 
  2660.  
  2661.  Note:  You can also delete the volume name by selecting the volume and using 
  2662.         the right mouse button. 
  2663.  
  2664.  
  2665. ΓòÉΓòÉΓòÉ 5.8. Hiding a Volume from OS/2 ΓòÉΓòÉΓòÉ
  2666.  
  2667. Use Hide the Volume from OS/2 to make a volume invisible to OS/2. 
  2668.  
  2669. To hide a volume from OS/2: 
  2670.  
  2671.    1. Select Volume from the toolbar. 
  2672.  
  2673.    2. Select Hide the Volume from OS/2. 
  2674.  
  2675.    3. Select the volume you want to hide. 
  2676.  
  2677.    4. Press OK to hide the volume. 
  2678.  
  2679.  Note:  Use Change Drive Letter Assigned to a Volume to make the volume visible 
  2680.         to OS/2 again. 
  2681.  
  2682.  
  2683. ΓòÉΓòÉΓòÉ 5.9. Unhiding a Volume from OS/2 ΓòÉΓòÉΓòÉ
  2684.  
  2685. Use Change Drive Letter Assigned to a Volume to make a volume visible to OS/2. 
  2686.  
  2687. To change the drive letter assigned to a volume: 
  2688.  
  2689.    1. Select Volume from the toolbar. 
  2690.  
  2691.    2. Select Change Drive Letter Assigned to a Volume. 
  2692.  
  2693.    3. Select the volume that you want to modify. 
  2694.  
  2695.    4. Choose the new drive letter and press OK. The new drive letter is now 
  2696.       displayed. 
  2697.  
  2698.  Note:  You can also change the drive letter by selecting the volume and using 
  2699.         the right mouse button. 
  2700.  
  2701.  When the changes are saved, the system will attempt to change the driver 
  2702.  letter assignment without rebooting; however, if the file system cannot be 
  2703.  unmounted, or if the Disk Device Manager has exhausted its resources, the 
  2704.  system will need to reboot to make the changes effective. 
  2705.  
  2706.  
  2707. ΓòÉΓòÉΓòÉ 5.10. Creating a Partition ΓòÉΓòÉΓòÉ
  2708.  
  2709. Use Create Partition to create a new partition. You can create partitions for 
  2710. other operating systems that do not recognize LVM volumes or linked volumes. 
  2711. You can also use this option to create a partition of a specific size and to 
  2712. allocate it from the beginning or end or free space. 
  2713.  
  2714. Note:  Partitions no longer have drive letters associated with them. You must 
  2715.        create a volume to assign a drive letter. 
  2716.  
  2717.  To create a partition: 
  2718.  
  2719.    1. Select Partition from the toolbar. 
  2720.  
  2721.    2. Select Create Partition. 
  2722.  
  2723.    3. Select the disk to create the partition from. 
  2724.  
  2725.  A window is displayed, specifying free space and size for the partition. 
  2726.  
  2727.    4. Press OK to activate your choices. 
  2728.  
  2729.  Note:  You can also create a partition by using the right mouse button to 
  2730.         select the free space you want to create the partition from. 
  2731.  
  2732.  
  2733. ΓòÉΓòÉΓòÉ 5.11. Deleting a Partition ΓòÉΓòÉΓòÉ
  2734.  
  2735. Use Delete Partition to delete a partition. You cannot delete a partition that 
  2736. is part of a volume. 
  2737.  
  2738. To delete a partition: 
  2739.  
  2740.    1. Select Partition from the toolbar. 
  2741.  
  2742.    2. Select Delete Partition. 
  2743.  
  2744.    3. Select the partition you want to delete. 
  2745.  
  2746.  A window is displayed, confirming your choices. 
  2747.  
  2748.    4. Press OK to activate your choices. 
  2749.  
  2750.  Note:  You can also create a partition by using the right mouse button to 
  2751.         select the partition you want to delete. 
  2752.  
  2753.  
  2754. ΓòÉΓòÉΓòÉ 5.12. Committing Changes ΓòÉΓòÉΓòÉ
  2755.  
  2756. Use Commit Changes to commit any changes you have made up to this point. A 
  2757. window will display to confirm that you want to commit the changes. Once you 
  2758. press OK, the changes cannot be undone. 
  2759.  
  2760. To commit changes: 
  2761.  
  2762.    1. Select Tools from the toolbar. 
  2763.  
  2764.    2. Select Commit Changes. 
  2765.  
  2766.    3. Press OK to commit the changes. 
  2767.  Changes are effective when you save the changes and exit LVM. The system will 
  2768.  then attempt to add the new volume without rebooting; however, if the Disk 
  2769.  Device Manager has exhausted its resources, the system will need to reboot to 
  2770.  make the changes effective. 
  2771.  
  2772.  
  2773. ΓòÉΓòÉΓòÉ 6. OS/2 Warp Server Personally Safe n Sound (PSnS) ΓòÉΓòÉΓòÉ
  2774.  
  2775. OS/2 Warp Server Personally Safe n Sound (PSnS) is a powerful backup utility 
  2776. that lets you safe-guard your OS/2 system against loss of data. It allows you 
  2777. to set up a Backup Strategy for each activity you perform on your machine. The 
  2778. strategy, once employed, provides protection against all of the likely causes 
  2779. of data-loss: user errors, hardware malfunctions, malicious damage and 
  2780. disasters. 
  2781.  
  2782. For more information about using PSnS, see the OS/2 Warp Server Backup/Restore 
  2783. User's Guide and the other online books that come with it. Also, additional 
  2784. information is available on the Internet at 
  2785. http://www.software.ibm.com/os/warp/warp-server. 
  2786.  
  2787.  
  2788. ΓòÉΓòÉΓòÉ 7. Managing Users and Groups ΓòÉΓòÉΓòÉ
  2789.  
  2790. This chapter discusses how you can manage users and groups through LAN Server 
  2791. Administration. If you want to manage users and groups through User Profile 
  2792. Management as in previous versions of OS/2 Warp Server and LAN Server, refer to 
  2793. User Profile Management. 
  2794.  
  2795. Notes: 
  2796.  
  2797.    1. If you are running other subsystems such as database manager or 
  2798.       Communications Manager, you may need to use the User Profile Management 
  2799.       interface to perform your user and group management functions.  To 
  2800.       accessUser Profile Management, open  UPM Services located on your 
  2801.       desktop. 
  2802.  
  2803.    2. In addition to the normal  domain logon which is required for all users, 
  2804.       LAN Server Administration provides a  local logon facility for users who 
  2805.       need to log on locally to their workstation.  Users who have subsystems 
  2806.       such as database manager may need to log on locally to access databases 
  2807.       on their workstation.  If you do not run subsystems requiring local 
  2808.       logon, you can bypass the local logon option. 
  2809.   You can perform more user and group management functions with LAN Server 
  2810.  Administration than with User Profile Management. Some of the functions 
  2811.  available only from LAN Server Administration are: 
  2812.  
  2813.      The capability to define up to 16,000 users per domain 
  2814.  
  2815.      User and group ID cloning 
  2816.  
  2817.       Cloning saves time by allowing you to use your mouse to take existing 
  2818.       user and group objects and make clones (copies) that can be renamed and 
  2819.       changed as required. 
  2820.  
  2821.      Drag and drop enablement for logon assignments, user and group 
  2822.       definitions 
  2823.  
  2824.       You can drag and drop aliases onto user and group objects to create logon 
  2825.       assignments automatically.  In addition, you can drag and drop user 
  2826.       accounts into groups, or groups into user accounts, to update a user or 
  2827.       group definition automatically. 
  2828.  
  2829.      The ability to define home directories for users 
  2830.  
  2831.       You can specify home directories on a server for a user's personal use. 
  2832.  
  2833.      The ability to set directory limits on users 
  2834.  
  2835.       You can set size limits on home directories. Alerts are sent to the users 
  2836.       when the space used is nearing the limit. 
  2837.  
  2838.  You must define new users to the network so they can log on and access network 
  2839.  resources. You can also define groups for access and messaging purposes. This 
  2840.  chapter describes how to define and manage users and groups and how to create 
  2841.  guest accounts. 
  2842.  
  2843.  The following tasks for managing users are discussed: 
  2844.  
  2845.      Adding a user 
  2846.  
  2847.      Cloning a user 
  2848.  
  2849.      Deleting a user 
  2850.  
  2851.      Updating user passwords and password requirements 
  2852.  
  2853.      Granting and revoking operator privileges 
  2854.  
  2855.      Updating user account information 
  2856.  
  2857.      Updating user logon conditions 
  2858.  
  2859.      Adding a user to a group 
  2860.  
  2861.      Removing a user from a group 
  2862.  
  2863.      Updating logon assignments 
  2864.  
  2865.      Updating public applications on user's program starters 
  2866.  
  2867.      Assigning a home directory 
  2868.  
  2869.      Setting a user password expiration period for the domain 
  2870.  
  2871.      Creating a logon profile 
  2872.  
  2873.  The following tasks for managing groups are discussed: 
  2874.  
  2875.      Adding a group 
  2876.  
  2877.      Cloning a group 
  2878.  
  2879.      Viewing a group 
  2880.  
  2881.      Updating a group 
  2882.  
  2883.      Deleting a group 
  2884.  
  2885.      Adding and removing users from groups 
  2886.  
  2887.  For more information, see the following topics: 
  2888.  
  2889.      Domain User and Group Definitions 
  2890.  
  2891.      User ID and Group ID Management 
  2892.  
  2893.      Managing Users 
  2894.  
  2895.      Managing Groups 
  2896.  
  2897.      Creating Guest Accounts 
  2898.  
  2899.      Creating a Logon Profile 
  2900.  
  2901.  
  2902. ΓòÉΓòÉΓòÉ 7.1. Domain User and Group Definitions ΓòÉΓòÉΓòÉ
  2903.  
  2904. OS/2 Warp Server and LAN Server allow the user and group definitions file 
  2905. (created and updated through LAN Server Administration or User Profile 
  2906. Management) to be centralized.  This file is named NET.ACC and is maintained on 
  2907. the domain controller.  Whenever a change is made to the user and group 
  2908. definitions, the changes are sent from the domain controller to all servers 
  2909. that are running the NetLogon service in the domain.  The NetLogon service 
  2910. allows a server (except for Windows NT servers, which use a different version 
  2911. of the NetLogon service, IBMlogon) to receive changes to the user and group 
  2912. definitions file (NET.ACC). 
  2913.  
  2914. When the user and group definitions file is updated, the NET.ACC file is not 
  2915. immediately replicated at the additional servers on the domain. The time it 
  2916. takes to update depends on when the update was made in relation to the value 
  2917. specified with the  pulse parameter in the NetLogon section of the IBMLAN.INI 
  2918. file. This value indicates how often (in seconds) changes to the NET.ACC file 
  2919. are replicated to the additional servers. OS/2 Warp Server and LAN Server 
  2920. provide a feature called forwarded authentication that allows a defined user 
  2921. with a changed password to access resources on additional servers even if the 
  2922. NET.ACC changes have not reached the additional servers. Forwarded 
  2923. authentication is not available for new users. 
  2924.  
  2925. You can log on to a domain and make changes to user and group definitions from 
  2926. any workstation on the network. The changes are made to the master copy at the 
  2927. domain controller, and changes are sent to all servers that are running the 
  2928. NetLogon service. 
  2929.  
  2930. Note:  LAN clients do not get copies of the NET.ACC file changes. Therefore, if 
  2931.        user and group definitions are needed locally for an application (such 
  2932.        as database manager), users must also be defined on the LAN Requester 
  2933.        workstation through User Profile Management for the database manager 
  2934.        requirements. 
  2935.  
  2936.  OS/2 Warp Server and LAN Server also allow users with Accounts operator 
  2937.  privilege to manage users and groups.  Accounts operators can create new 
  2938.  users, modify user accounts, and manage group definitions.  However, they 
  2939.  cannot create or manage administrators or other operators. See  Granting and 
  2940.  Revoking Operator Privileges for more information. 
  2941.  
  2942.  
  2943. ΓòÉΓòÉΓòÉ 7.2. User ID and Group ID Management ΓòÉΓòÉΓòÉ
  2944.  
  2945. LAN Server Administration provides the following processes to manage user and 
  2946. group IDs on the network. User Profile Management is used for user ID 
  2947. validation.  Each installation of the User Profile Management is local to the 
  2948. particular workstation where it is installed, and it validates users who access 
  2949. controlled data or use programs that reside on that particular workstation. 
  2950.  
  2951. Note:  Local logons are used only when you have other subsystems (such as 
  2952.        database manager) that require validation for access to local databases. 
  2953.        If you are running only OS/2 Warp Server or LAN Server, you can bypass 
  2954.        the local logon window. 
  2955.  
  2956.  For more information, see the following topics: 
  2957.  
  2958.      Password and ID Character Restrictions 
  2959.  
  2960.      National Language Support Restrictions 
  2961.  
  2962.  
  2963. ΓòÉΓòÉΓòÉ 7.2.1. Password and ID Character Restrictions ΓòÉΓòÉΓòÉ
  2964.  
  2965. OS/2 Warp Server and LAN Server can use either of two character sets: 
  2966.  
  2967.  expanded 
  2968.                      This character set can be used with High Performance File 
  2969.                      Systems (HPFS) and Journaling File System (JFS). 
  2970.  
  2971.  minimal 
  2972.                      This character set must be used with file allocation table 
  2973.                      (FAT) file systems and can be used with HPFS and JFS. 
  2974.  
  2975.  Note:  National Language Support users should see  National Language Support 
  2976.         Restrictions. 
  2977.  
  2978.  The character set on HPFS and JFS can be changed by issuing the UPMCSET 
  2979.  command: UPMCSET /x, where  x is either M for minimal set or E for expanded 
  2980.  set. 
  2981.  
  2982.  Rules for Both Character Sets 
  2983.  
  2984.      Characters are converted to uppercase no matter how they are entered. 
  2985.  
  2986.      User IDs and Group IDs cannot have the following values: 
  2987.  
  2988.         -  ADMINS 
  2989.  
  2990.         -  GROUPID 
  2991.  
  2992.         -  GUESTS 
  2993.  
  2994.         -  LOCAL 
  2995.  
  2996.         -  PUBLIC 
  2997.  
  2998.         -  RPLGROUP 
  2999.  
  3000.         -  SERVERS 
  3001.  
  3002.         -  SYSASID 
  3003.  
  3004.         -  USERS 
  3005.  
  3006.      User IDs and Group IDs cannot begin with any of the following: 
  3007.  
  3008.         -  IBM 
  3009.  
  3010.         -  SQL 
  3011.  
  3012.         -  SYS 
  3013.  
  3014.  Rules for Expanded Character Set 
  3015.  
  3016.      The number of characters (bytes) in each identifier can range as follows: 
  3017.  
  3018.       user ID                  1 - 20 
  3019.  
  3020.       group ID                 1 - 20 
  3021.  
  3022.       domain name              1 - 15 
  3023.  
  3024.       machine ID               1 - 15 
  3025.  
  3026.       password                 0 - 14 
  3027.  
  3028.       Notes: 
  3029.  
  3030.         1. The actual minimum length for a password is set by the network 
  3031.            administrator through the Policy page of the domain notebook.  The 
  3032.            network administrator also controls the number of passwords saved to 
  3033.            prevent reuse, as well as the minimum amount of time that must pass 
  3034.            before a user can change the password again. 
  3035.  
  3036.         2. If a home directory is to be assigned to a user ID, the maximum 
  3037.            length of the user ID can be 12 characters.  The home directory is a 
  3038.            shared network resource with the same name as the user account and 
  3039.            cannot exceed 12 characters. 
  3040.  
  3041.      The following characters can be used: 
  3042.  
  3043.         -  Upper or lowercase letters A to Z or any valid accented letter 
  3044.  
  3045.         -  Digits 0 to 9 
  3046.  
  3047.         -  Any special character that can be entered from the keyboard except 
  3048.            for following characters: 
  3049.  
  3050.                        " / \ [ ] ; : | < > + = , ? *
  3051.  
  3052.  Rules for Minimal Character Set 
  3053.  
  3054.      The number of characters (bytes) in each identifier can range as follows: 
  3055.  
  3056.       user ID                  1 - 8 
  3057.  
  3058.       group ID                 1 - 8 
  3059.  
  3060.       domain name              1 - 8 
  3061.  
  3062.       machine ID               1 - 8 
  3063.  
  3064.       password                 0 - 8 
  3065.  
  3066.       Note:  By default, passwords are 4 to 8 characters in length. 
  3067.  
  3068.      The following characters can be used: 
  3069.  
  3070.         -  Upper or lowercase letters A to Z 
  3071.  
  3072.         -  Digits 0 to 9 
  3073.  
  3074.         -  Special characters #, @ or $ 
  3075.  
  3076.  Notes: 
  3077.  
  3078.    1. Other subsystems using the same user ID as OS/2 Warp Server and LAN 
  3079.       Server may not necessarily have the same character limitations. Make sure 
  3080.       your user ID does not violate the limitations of those subsystems. 
  3081.  
  3082.    2. The logon process may be unable to log on or access resources if the code 
  3083.       page or country code of the system differs from those specified when the 
  3084.       identifier was created.  The user is responsible for ensuring the 
  3085.       expanded character set is used only when the code page and country code 
  3086.       of the system are not changed. 
  3087.  
  3088.  
  3089. ΓòÉΓòÉΓòÉ 7.2.2. National Language Support Restrictions ΓòÉΓòÉΓòÉ
  3090.  
  3091. National Language Support (NLS) users at DOS LAN Services cannot necessarily 
  3092. use all characters included in the User Profile Management expanded character 
  3093. set. Follow the DOS guidelines for acceptable accented characters, except for 
  3094. those in the following list. 
  3095.  
  3096.  COUNTRY or LANGUAGE PERMITTED CHARACTERS 
  3097.  
  3098.  France (FR)         A - Z, 1 - 9, and nonalphabetics 
  3099.  
  3100.  Canadian French (CF) A - Z, 1 - 9, and nonalphabetics 
  3101.  
  3102.  Portugal (PO)       A - Z, 1 - 9, ╨╡, and nonalphabetics 
  3103.  
  3104.  Spain (SP)          A - Z, 1 - 9, ╨╡, ╨É, and nonalphabetics 
  3105.  
  3106.  Latin America (LA)  A - Z, 1 - 9, ╨╡, and nonalphabetics 
  3107.  
  3108.  Japan               A - Z, 1 - 9, nonalphabetics, Kanji, Hiragana, and 
  3109.                      Katakana 
  3110.  
  3111.  Korea               A - Z, 1 - 9, nonalphabetics, Hanja, and Hangeul 
  3112.  
  3113.  Taiwan              A - Z, 1 - 9, nonalphabetics, and Hanzi 
  3114.  
  3115.  
  3116. ΓòÉΓòÉΓòÉ 7.3. Managing Users ΓòÉΓòÉΓòÉ
  3117.  
  3118. This section describes the basics of managing users: adding, cloning, deleting, 
  3119. and updating. If you are managing users in WorkSpace On-Demand 1.0 or 2.0 and 
  3120. want more information on these specific clients, please refer to the WorkSpace 
  3121. On-Demand 2.0 Administrator's Guide. 
  3122.  
  3123. For the following procedures, you are making changes to the user and group 
  3124. definitions file (NET.ACC) for the one or more domains that you are managing. 
  3125.  
  3126. Note:  For Windows NT servers there are persistent users and localgroups, which 
  3127.        are managed solely by the Windows NT server. To add or update these 
  3128.        definitions, follow steps a through h of the directions for creating a 
  3129.        Windows NT server definition. All other users and localgroups for the NT 
  3130.        Server should be administered on the domain controller to prevent the NT 
  3131.        server from being out of synch with the domain controller. 
  3132.  
  3133.  For more information, see the following topics: 
  3134.  
  3135.      Adding a User 
  3136.  
  3137.      Cloning a User 
  3138.  
  3139.      Deleting a User 
  3140.  
  3141.      Granting and Revoking Operator Privileges 
  3142.  
  3143.      Updating User Account Information 
  3144.  
  3145.      Adding and Updating Logon Assignments 
  3146.  
  3147.      Assigning Public Applications to Users 
  3148.  
  3149.      Assigning a Home Directory 
  3150.  
  3151.      Deleting a Home Directory 
  3152.  
  3153.      Setting a User Password Expiration Period for a Domain 
  3154.  
  3155.  
  3156. ΓòÉΓòÉΓòÉ 7.3.1. Adding a User ΓòÉΓòÉΓòÉ
  3157.  
  3158. You must add a user to the domain before that user can access the network. You 
  3159. can add approximately 16,000 users for each domain using LAN Server 
  3160. Administration. 
  3161.  
  3162. Note:  You can use the NET USER command to define about 1800 users on a domain. 
  3163.        If you use User Profile Management to view user definitions, you can 
  3164.        only see approximately 1260 users on each domain. 
  3165.  
  3166.  To add a user: 
  3167.  
  3168.    1. Open  LAN Server Administration. 
  3169.  
  3170.    2. Open the appropriate domain object. 
  3171.  
  3172.    3. Open  User Accounts. 
  3173.  
  3174.       The User Accounts folder is displayed. 
  3175.  
  3176.    4. Drag a copy of the  Template to a convenient location in the folder. 
  3177.  
  3178.       The User Account - Create notebook is displayed. 
  3179.  
  3180.    5. Complete the required fields, indicated by an asterisk (*), and modify 
  3181.       any other fields as needed. 
  3182.  
  3183.    6. Select the  Password tab. 
  3184.  
  3185.       The first Password page is displayed. 
  3186.  
  3187.    7. Select  Change password to change the password. 
  3188.  
  3189.    8. Type the new password in the  New password field. 
  3190.  
  3191.       Note:  For security purposes, the password is displayed as asterisks (*) 
  3192.              when you type it. 
  3193.  
  3194.    9. Type the new password again in the  Confirmation field. 
  3195.  
  3196.   10. Select the folded page corner to continue to the second Password page. 
  3197.  
  3198.   11. Complete the remaining fields on this page as desired. 
  3199.  
  3200.   12. Complete the fields on other pages as desired. 
  3201.  
  3202.   13. Select  Create. 
  3203.  
  3204.  
  3205. ΓòÉΓòÉΓòÉ 7.3.2. Cloning a User ΓòÉΓòÉΓòÉ
  3206.  
  3207. Cloning allows you to save time when creating new users, by copying an existing 
  3208. user account object, renaming it, and modifying it as needed. 
  3209.  
  3210. To clone a user: 
  3211.  
  3212.    1. Open  LAN Server Administration. 
  3213.  
  3214.    2. Open the appropriate domain object. 
  3215.  
  3216.    3. Open  User Accounts. 
  3217.  
  3218.       The User Accounts folder is displayed. 
  3219.  
  3220.    4. With mouse button 2, select the user account you want to clone. 
  3221.  
  3222.    5. From the pop-up menu, select  Create another. 
  3223.  
  3224.       The User Account - Create notebook is displayed. 
  3225.  
  3226.    6. Type the new user account name in the  User account name field. 
  3227.  
  3228.    7. Select the  Password tab. 
  3229.  
  3230.       The first Password page is displayed. 
  3231.  
  3232.    8. Select  Change password to change the password. 
  3233.  
  3234.    9. Type the new password in the  New password field. 
  3235.  
  3236.       Note:  For security purposes, the password is displayed as asterisks (*) 
  3237.              when you type it. 
  3238.  
  3239.   10. Type the new password again in the  Confirmation field. 
  3240.  
  3241.   11. Select the folded page corner to continue to the second Password page. 
  3242.  
  3243.   12. Complete the remaining fields on this page as desired. 
  3244.  
  3245.   13. Change any other fields at this time. 
  3246.  
  3247.   14. Select  Create to create the new user ID.  The new user ID inherits all 
  3248.       the properties of the original user account. 
  3249.  
  3250.  
  3251. ΓòÉΓòÉΓòÉ 7.3.3. Deleting a User ΓòÉΓòÉΓòÉ
  3252.  
  3253. You can remove a user from the domain by deleting the user's user account. When 
  3254. you delete a user account, the following occurs: 
  3255.  
  3256.      The user account is removed from the list of users. 
  3257.  
  3258.      The user account is removed from all groups. 
  3259.  
  3260.      The user loses access to network resources. 
  3261.  
  3262.  The directory path and the contents of the home directory for the user ID (if 
  3263.  one exists) and its access control profile are not deleted. For more 
  3264.  information on deleting the home directory, see Deleting a Home Directory. For 
  3265.  more information on deleting the access control profile, see  Deleting an 
  3266.  Access Control Profile. 
  3267.  
  3268.  Attention  Do not delete system IDs for existing servers. 
  3269.  
  3270.  To delete a user: 
  3271.  
  3272.    1. Open  LAN Server Administration. 
  3273.  
  3274.    2. Open the appropriate domain object. 
  3275.  
  3276.    3. Open  User Accounts. 
  3277.  
  3278.       The User Accounts folder is displayed. 
  3279.  
  3280.    4. Select the user account object you want to delete. 
  3281.  
  3282.    5. Press mouse button 2, and select  Delete. 
  3283.  
  3284.    6. Select  Delete on the confirmation window. 
  3285.  
  3286.  
  3287. ΓòÉΓòÉΓòÉ 7.3.4. Granting and Revoking Operator Privileges ΓòÉΓòÉΓòÉ
  3288.  
  3289. A user with operator privileges has certain administrative capabilities but is 
  3290. not a full administrator.  A user may have one or more of the following types 
  3291. of operator privilege: 
  3292.  
  3293.  Accounts            Can manage users and groups in the domain.  The user can 
  3294.                      add, modify, or delete users and groups from either the 
  3295.                      command line or LAN Server Administration.  The user 
  3296.                      cannot create or modify user accounts that have 
  3297.                      administrator or any operator privilege. 
  3298.  
  3299.  Print               Can manage printer queues and print jobs.  The user can 
  3300.                      create, modify, or delete printers or queues on servers in 
  3301.                      the domain, either from the command line or with LAN 
  3302.                      Server Administration.  The user can also share printer 
  3303.                      queues and manage remote jobs on shared queues. 
  3304.  
  3305.  COMM                Can manage serial devices.  The user can share serial 
  3306.                      devices and manage remote jobs on shared serial devices 
  3307.                      from either the command line or LAN Server Administration. 
  3308.  
  3309.  Server              Can manage aliases and other shared resources and view 
  3310.                      network status. The user can create, modify, or delete 
  3311.                      aliases or other shared resources from either the command 
  3312.                      line or LAN Server Administration. 
  3313.  
  3314.  A system administrator can use either the command line or LAN Server 
  3315.  Administration to change operator privileges for users. See the Command 
  3316.  Reference for more information about using the NET USER command to change 
  3317.  operator privileges from the command line. 
  3318.  
  3319.  To change a user's operator privileges: 
  3320.  
  3321.    1. Open  LAN Server Administration. 
  3322.  
  3323.    2. Open the domain object. 
  3324.  
  3325.    3. Open  User Accounts. 
  3326.  
  3327.       The User Accounts folder is displayed. 
  3328.  
  3329.    4. Open the user account for which you want to change privileges. 
  3330.  
  3331.       The first page of the notebook is displayed. 
  3332.  
  3333.    5. Select the  Privileges tab. 
  3334.  
  3335.       The Privilege page is displayed. 
  3336.  
  3337.    6. Select the  User button. 
  3338.  
  3339.       This choice denies administrator permissions to the user. 
  3340.  
  3341.    7. Select a  Special privileges check box for each privilege you want to 
  3342.       grant to the user. 
  3343.  
  3344.       Deselect the check box to revoke the privilege. 
  3345.  
  3346.    8. Select  Set or  Apply. 
  3347.  
  3348.  
  3349. ΓòÉΓòÉΓòÉ 7.3.5. Updating User Account Information ΓòÉΓòÉΓòÉ
  3350.  
  3351. You can make updates to user account information through LAN Server 
  3352. Administration. The following information can be updated: 
  3353.  
  3354.      User type (user, user with operator privilege, or administrator) 
  3355.  
  3356.      Optional description about the user account 
  3357.  
  3358.      Password 
  3359.  
  3360.      Password options 
  3361.  
  3362.      Home directory 
  3363.  
  3364.      Logon workstation 
  3365.  
  3366.      Logon authority (whether the user can log on to the domain) 
  3367.  
  3368.      Group memberships (such as adding a user to a group and deleting a user 
  3369.       from a group) 
  3370.  
  3371.      Logon assignments 
  3372.  
  3373.      Public applications 
  3374.  
  3375.  These tasks can be done through LAN Server Administration. 
  3376.  
  3377.  For more information, see the following topics: 
  3378.  
  3379.      Updating the User Account Description Field 
  3380.  
  3381.      Updating a User's Password and Password Requirements 
  3382.  
  3383.      Adding and Updating Group Memberships for a User 
  3384.  
  3385.      Updating Logon Conditions for a User Account 
  3386.  
  3387.  
  3388. ΓòÉΓòÉΓòÉ 7.3.5.1. Updating the User Account Description Field ΓòÉΓòÉΓòÉ
  3389.  
  3390. Use the following procedure to update user description fields. 
  3391.  
  3392. To update a user account description: 
  3393.  
  3394.    1. Open  LAN Server Administration. 
  3395.  
  3396.    2. Open the domain object. 
  3397.  
  3398.    3. Open  User Accounts. 
  3399.  
  3400.       The User Accounts folder is displayed. 
  3401.  
  3402.    4. Open the user account for which you want to update the user account 
  3403.       description. 
  3404.  
  3405.       The User Account notebook is displayed. 
  3406.  
  3407.    5. On the Identity page, update the description. 
  3408.  
  3409.    6. Select  Set or  Apply. 
  3410.  
  3411.  
  3412. ΓòÉΓòÉΓòÉ 7.3.5.2. Updating a User's Password and Password Requirements ΓòÉΓòÉΓòÉ
  3413.  
  3414. An administrator can change any password in the domain.  Users can change only 
  3415. their own passwords. 
  3416.  
  3417. Use the following procedure to reset a user's password and specify other 
  3418. password restrictions. 
  3419.  
  3420. To reset or change a user password: 
  3421.  
  3422.    1. Open  LAN Server Administration. 
  3423.  
  3424.    2. Open the domain object. 
  3425.  
  3426.    3. Open  User Accounts. 
  3427.  
  3428.       The User Accounts folder is displayed. 
  3429.  
  3430.    4. Open the user account for which you want to update the password. 
  3431.  
  3432.       The User Account notebook is displayed. 
  3433.  
  3434.    5. Select the  Password tab. 
  3435.  
  3436.       The first Password page is displayed. 
  3437.  
  3438.    6. Select  Change password to change the password. 
  3439.  
  3440.    7. Select  Expire password if you want the user to change the password at 
  3441.       next logon. 
  3442.  
  3443.    8. Type the new password in the  New password field. 
  3444.  
  3445.       Note:  For security purposes, the password is displayed as asterisks (*) 
  3446.              when you type it. 
  3447.  
  3448.    9. Type the new password again in the confirmation field. 
  3449.  
  3450.   10. Select the folded page corner to continue to the second Password page. 
  3451.  
  3452.   11. Complete the remaining fields on this page as desired. 
  3453.  
  3454.   12. Select  Set or  Apply. 
  3455.  
  3456.  See the NET USER command in the Command Reference for information on using the 
  3457.  command-line interface to change password requirements. 
  3458.  
  3459.  
  3460. ΓòÉΓòÉΓòÉ 7.3.5.3. Adding and Updating Group Memberships for a User ΓòÉΓòÉΓòÉ
  3461.  
  3462. Once you have defined a user, you can add that user to one or more groups. You 
  3463. can also remove a user from a group. 
  3464.  
  3465. To add or update group memberships for a user: 
  3466.  
  3467.    1. Open  LAN Server Administration. 
  3468.  
  3469.    2. Open the domain object. 
  3470.  
  3471.    3. Open  User Accounts. 
  3472.  
  3473.       The User Accounts folder is displayed. 
  3474.  
  3475.    4. Open the user account for which you want to update the group memberships. 
  3476.  
  3477.       The User Account notebook is displayed. 
  3478.  
  3479.    5. Select the  Groups tab. 
  3480.  
  3481.       The Groups page is displayed. 
  3482.  
  3483.    6. To add this user to a group: 
  3484.  
  3485.         a. Select  Add from the Groups page. 
  3486.  
  3487.            The list of available groups is displayed in the Add User to Groups 
  3488.            window. 
  3489.  
  3490.         b. Select one or more groups to add this user to, and select  Add. 
  3491.  
  3492.    7. To remove this user from a group, highlight one or more groups from the 
  3493.       list and select Remove. 
  3494.  
  3495.    8. Select  Set or  Apply. 
  3496.  
  3497.  Note:  You can perform the same task using drag and drop methods. You can drag 
  3498.         and drop user accounts onto group objects or, alternatively, drag and 
  3499.         drop group objects onto user accounts. When dropped, the group and user 
  3500.         account definitions are automatically updated. 
  3501.  
  3502.  
  3503. ΓòÉΓòÉΓòÉ 7.3.5.4. Updating Logon Conditions for a User Account ΓòÉΓòÉΓòÉ
  3504.  
  3505. After you have defined a user, you can update logon conditions for the user 
  3506. account.  You can set logon conditions such as: 
  3507.  
  3508.      Deleting or disabling the user account 
  3509.  
  3510.      Specifying whether the user account has an expiration date and time, and 
  3511.       if so, what they are 
  3512.  
  3513.      Specifying workstations that the user account can log on to. 
  3514.  
  3515.  To specify logon conditions for a user: 
  3516.  
  3517.    1. Open  LAN Server Administration. 
  3518.  
  3519.    2. Open the domain object. 
  3520.  
  3521.    3. Open  User Accounts. 
  3522.  
  3523.       The User Accounts folder is displayed. 
  3524.  
  3525.    4. Open the user account for which you want to update logon conditions. 
  3526.  
  3527.       The User Account notebook is displayed. 
  3528.  
  3529.    5. Select the  Account Info tab. 
  3530.  
  3531.       The first Account Info page is displayed. 
  3532.  
  3533.    6. Complete any required fields (indicated by an asterisk *) and any other 
  3534.       fields as needed. 
  3535.  
  3536.    7. Select the folded page corner to continue to the second Account page. 
  3537.  
  3538.    8. Complete any remaining fields on this page as desired. 
  3539.  
  3540.    9. Select  Set or  Apply. 
  3541.  
  3542.  
  3543. ΓòÉΓòÉΓòÉ 7.4. Adding and Updating Logon Assignments ΓòÉΓòÉΓòÉ
  3544.  
  3545. You can define logon assignments for a user. Logon assignments give the user 
  3546. access to network resources by assigning resources to logical drives or ports 
  3547. each time a user logs on. The logon assignments remain in effect until changed. 
  3548. Both you and a user can change that user's logon assignments. 
  3549.  
  3550. An alias must be defined for a resource before a resource can be defined as a 
  3551. logon assignment. See  Sharing Network Resources for more information on 
  3552. defining aliases. 
  3553.  
  3554. Before making logon assignments, you should create aliases for the shared 
  3555. resources you intend to define as logon assignments. You should also create an 
  3556. access control profile for that alias. See  Creating an Alias for more 
  3557. information. 
  3558.  
  3559. You can add and update logon assignments either using the Assignments page of a 
  3560. user account notebook or using drag and drop methods. You can drag multiple 
  3561. users or groups onto alias objects in the appropriate Resource Definitions 
  3562. folder.  The logon assignment to the alias is created when you drop the user or 
  3563. group onto the alias. 
  3564.  
  3565. Alternatively, you can drag the alias object onto a user or group ID object. If 
  3566. you do not have an access control profile set up for the alias, you are 
  3567. prompted to create one during the drag and drop procedure.  You can also remove 
  3568. logon assignments with the drag and drop method. 
  3569.  
  3570. You can also update a user's logon assignments from the command line with the 
  3571. NET USER command.  For more information, see the Command Reference . 
  3572.  
  3573. To add or update a user's logon assignments: 
  3574.  
  3575.    1. Open  LAN Server Administration. 
  3576.  
  3577.    2. Open the appropriate domain. 
  3578.  
  3579.    3. Open  User Accounts. 
  3580.  
  3581.       The User Accounts folder is displayed. 
  3582.  
  3583.    4. Open the user account object for which you want to update logon 
  3584.       assignments. 
  3585.  
  3586.       The User Account notebook is displayed. 
  3587.  
  3588.    5. Select the  Assignments tab. 
  3589.  
  3590.       The Assignments page is displayed. 
  3591.  
  3592.    6. If you want to change or remove a logon assignment, first select it from 
  3593.       the list. 
  3594.  
  3595.    7. Select one of the following: 
  3596.  
  3597.           Add to add a new logon assignment 
  3598.  
  3599.           Change to change the selected logon assignment 
  3600.  
  3601.           Remove to remove the selected logon assignment 
  3602.  
  3603.       The Logon Assignments window is displayed if you selected either Add or 
  3604.       Change. 
  3605.  
  3606.    8. Complete the selections in this window, and select OK. 
  3607.  
  3608.    9. Select  Set or  Apply. 
  3609.  
  3610.  To add or update logon assignments with drag and drop: 
  3611.  
  3612.    1. Open  LAN Server Administration. 
  3613.  
  3614.    2. Open the appropriate domain object. 
  3615.  
  3616.    3. Open one of the following objects that contains the user account or group 
  3617.       for which you want to add or update logon assignments: 
  3618.  
  3619.           User Accounts 
  3620.  
  3621.           Groups 
  3622.  
  3623.    4. Open the appropriate Resource Definitions folder, which is also located 
  3624.       in the domain container.  For example, to add a directory as a logon 
  3625.       assignment, open  Directory Resource Definitions. 
  3626.  
  3627.       All the available aliases in the domain are displayed. 
  3628.  
  3629.    5. Drag and drop the user account or group object onto the alias object to 
  3630.       create or update a logon assignment. 
  3631.  
  3632.       The Grant Access to a Resource window is displayed to allow you to grant 
  3633.       access. 
  3634.  
  3635.       Note:  You can select multiple users or groups for drag and drop by 
  3636.              pressing and holding the Ctrl key while selecting them. You can 
  3637.              also drag alias objects onto user account or group objects. 
  3638.  
  3639.    6. If you want to add or change access permissions for the users, select the 
  3640.       permissions you want to grant and indicate whether you are adding or 
  3641.       replacing the permissions and then select  Set. 
  3642.  
  3643.       If you do not want to add or change permissions, select Continue. 
  3644.  
  3645.       The Administer Logon Assignments window is displayed. 
  3646.  
  3647.    7. Complete the window to add, update, or remove the logon assignment. 
  3648.  
  3649.           To add or update a logon assignment: 
  3650.  
  3651.              a. Select  Add assignment. 
  3652.  
  3653.              b. Select or type a drive letter or LPT or COM port for the logon 
  3654.                 assignment and then select other options as needed.  The 
  3655.                 options are: 
  3656.  
  3657.                   -  Replace conflicting device assignments to replace any 
  3658.                      resource already assigned to the specified drive or port. 
  3659.  
  3660.                   -  Replace existing logon assignments to replace redundant 
  3661.                      assignments to the resource you selected. 
  3662.  
  3663.              c. Select  OK. 
  3664.  
  3665.                 The Status window is displayed indicating the logon assignment 
  3666.                 has been added. 
  3667.  
  3668.              d. From the Status window, select  OK. 
  3669.  
  3670.           To remove a logon assignment: 
  3671.  
  3672.              a. Select Remove assignment. 
  3673.  
  3674.              b. Select  OK. 
  3675.  
  3676.                 The Status window is displayed indicating the logon assignment 
  3677.                 has been removed. 
  3678.  
  3679.              c. From the Status window, select  OK. 
  3680.  
  3681.  
  3682. ΓòÉΓòÉΓòÉ 7.5. Assigning Public Applications to Users ΓòÉΓòÉΓòÉ
  3683.  
  3684. You can make public applications available to users by assigning the 
  3685. applications to a program starter, which varies depending on the operating 
  3686. system. 
  3687.  
  3688. For brevity, this chapter uses  program starter as a general term to indicate 
  3689. where a user starts public applications. The program starter for OS/2 users is 
  3690. the Network Applications folder. The program starter for DOS users depends on 
  3691. whether they run Windows with DOS LAN Services (DLS). 
  3692.  
  3693. For DLS machines with Windows, the program starter is the LAN Applications 
  3694. list, which is in the Application Installation window. For DLS machines without 
  3695. Windows, the program starter is the Run Applications window. 
  3696.  
  3697. When a user logs on at a DOS client, the program starter includes any DOS 
  3698. applications, but no OS/2 applications, assigned to the user. 
  3699.  
  3700. You can also remove public applications from a user's program starter. 
  3701.  
  3702. See  Managing OS/2, DOS, WorkSpace On-Demand, and Windows Applications for 
  3703. information on defining applications. 
  3704.  
  3705. Note:  These instructions are for updating one or more user's program starter 
  3706.        while you are working with a specific user's details. To add 
  3707.        applications to or delete applications from several or all users' 
  3708.        program starters, see  Managing OS/2, DOS, WorkSpace On-Demand, and 
  3709.        Windows Applications. 
  3710.  
  3711.  Adding applications to program starters makes it convenient for users to use 
  3712.  their applications. 
  3713.  
  3714.  To add OS/2 or DOS applications to users' program starters: 
  3715.  
  3716.    1. Open  LAN Server Administration. 
  3717.  
  3718.    2. Open the appropriate domain object. 
  3719.  
  3720.    3. Open one of the following objects that contains the user account or 
  3721.       group: 
  3722.  
  3723.           User Accounts 
  3724.  
  3725.           Groups 
  3726.  
  3727.    4. Open  Public Application Definitions, which is also located in the domain 
  3728.       collection. 
  3729.  
  3730.    5. Drag one or more user accounts or group objects to the public application 
  3731.       object. 
  3732.  
  3733.       The Add Public Application window is displayed to allow you to add this 
  3734.       public application to the user or group when they log on.  This window 
  3735.       has no properties. 
  3736.  
  3737.    6. Select  OK. 
  3738.  
  3739.    7. Select  OK in the confirmation window. 
  3740.  
  3741.  
  3742. ΓòÉΓòÉΓòÉ 7.6. Assigning a Home Directory ΓòÉΓòÉΓòÉ
  3743.  
  3744. A  home directory is an optional directory resource on a server assigned to one 
  3745. or more users. Only an administrator can assign a home directory to a user or 
  3746. change the drive assignment or path to a user's home directory. 
  3747.  
  3748. When a home directory is assigned to or created for a user through LAN Server 
  3749. Administration, the user is connected to the home directory as a logon 
  3750. assignment.  An access control profile granting all permissions to that user is 
  3751. automatically created. (The access control profile is not propagated to 
  3752. existing subdirectories.) 
  3753.  
  3754. If you want other users to share the same home directory, you can either modify 
  3755. the access control profile or create home directories for other users, 
  3756. specifying the same drive and path. 
  3757.  
  3758. You can perform this task through either LAN Server Administration or the 
  3759. command-line interface. If you use the command-line interface to create a home 
  3760. directory, neither the access control profile nor the home directory is 
  3761. automatically created.  You must create the access control profile and the home 
  3762. directory separately. For information about creating home directories using the 
  3763. NET USER command, refer to the Command Reference. 
  3764.  
  3765. To create a home directory or update the home directory's drive assignment: 
  3766.  
  3767.    1. Open  LAN Server Administration. 
  3768.  
  3769.    2. Open the domain object. 
  3770.  
  3771.    3. Open  User Accounts. 
  3772.  
  3773.       The User Accounts folder is displayed. 
  3774.  
  3775.    4. Open the user account for which you want to assign or update the home 
  3776.       directory. 
  3777.  
  3778.       The User Account notebook is displayed. 
  3779.  
  3780.    5. Select the  Home Directory tab. 
  3781.  
  3782.       The Home Directory page is displayed. 
  3783.  
  3784.    6. Complete the fields in this page. 
  3785.  
  3786.       Note:  For users at DOS LAN Services workstations, you cannot specify Z 
  3787.              as the drive assignment to the home directory. If a DOS LAN 
  3788.              Services workstation requires remote IPL, you cannot specify Y or 
  3789.              Z as drive assignments. These logical drives are reserved by OS/2 
  3790.              Warp Server and LAN Server. 
  3791.  
  3792.    7. Select  Set or  Apply. 
  3793.  
  3794.  Note:  The CHKSTOR utility only provides information about how much space 
  3795.         users are using from their home directories. It does not prevent them 
  3796.         from exceeding the limit.  If you want to enforce size limitations for 
  3797.         users, you can use the command line or LAN Server Administration to set 
  3798.         directory limits. For information on how to set limits on the size of 
  3799.         directories and set up alerts that notify selected user IDs when 
  3800.         various directories are nearing maximum capacity and when they are 
  3801.         full, refer to Limiting Space within Directories on 386 HPFS Servers. 
  3802.  
  3803.  
  3804. ΓòÉΓòÉΓòÉ 7.7. Deleting a Home Directory ΓòÉΓòÉΓòÉ
  3805.  
  3806. You can remove a user's home directory assignment without deleting the 
  3807. directory itself.  Only the assignment prevents the directory from being 
  3808. assigned to the user at logon.  Use this procedure if the home directory or its 
  3809. subdirectories are still needed by other users. For example, if the directory 
  3810. is a home directory for several users, removing just the home directory 
  3811. assignment for one user does not affect home directory access for the remaining 
  3812. users. 
  3813.  
  3814. Alternatively, you can remove both the user's home directory assignment and the 
  3815. directory itself.  The directory cannot be deleted through LAN Server 
  3816. Administration but can be deleted through the command line interface. Any files 
  3817. or subdirectories contained in the home directory are also deleted. 
  3818.  
  3819. To remove a user's home directory assignment without deleting the directory 
  3820. itself: 
  3821.  
  3822.    1. Open  LAN Server Administration. 
  3823.  
  3824.    2. Open the domain object. 
  3825.  
  3826.    3. Open  User Accounts. 
  3827.  
  3828.       The User Accounts folder is displayed. 
  3829.  
  3830.    4. Select the user account for which you want to remove the home directory 
  3831.       assignment. 
  3832.  
  3833.       The User Account notebook is displayed. 
  3834.  
  3835.    5. Select the  Home Directory tab. 
  3836.  
  3837.       The Home Directory page is displayed. 
  3838.  
  3839.    6. Select  No home directory. 
  3840.  
  3841.       The link to the directory is broken, but the directory is not deleted. 
  3842.  
  3843.    7. Select  Set or  Apply. 
  3844.  
  3845.  For information on how to use the command-line interface to remove a user's 
  3846.  home directory assignment without deleting the directory itself, see the NET 
  3847.  USER command in the Command Reference. 
  3848.  
  3849.  
  3850. ΓòÉΓòÉΓòÉ 7.8. Setting a User Password Expiration Period for a Domain ΓòÉΓòÉΓòÉ
  3851.  
  3852. OS/2 Warp Server and LAN Server allow you to set the duration for which user's 
  3853. passwords are valid. You can set this duration for all users who are defined in 
  3854. the domain by using LAN Server Administration. 
  3855.  
  3856. To set a user's password expiration period: 
  3857.  
  3858.    1. Open  LAN Server Administration. 
  3859.  
  3860.    2. With mouse button 2, select the domain object for which you want to set 
  3861.       the password expiration period. 
  3862.  
  3863.    3. From the pop-up menu, select  Properties. 
  3864.  
  3865.       The notebook of the selected domain is displayed. 
  3866.  
  3867.    4. Select the  Policy tab. 
  3868.  
  3869.       The first Policy page is displayed. 
  3870.  
  3871.    5. Select  After in the  Expires section. 
  3872.  
  3873.       Select or type the number of days you want the password to be valid. 
  3874.  
  3875.    6. Modify other fields on this page as needed. 
  3876.  
  3877.    7. Select  Set or  Apply. 
  3878.  
  3879.  You can also use the NET ACCOUNTS command and the  maxpwage parameter to set 
  3880.  an expiration period for a user's password. You can issue this command from an 
  3881.  OS/2 command prompt while you are logged on at a client if you are using the 
  3882.  NET ADMIN command or while you are logged on at a server. 
  3883.  
  3884.  The NET ACCOUNTS command can also be used to change the NetLogon service role, 
  3885.  to specify how long a user can be logged on to the network beyond that user's 
  3886.  normal logon hours, and to set the number of user passwords that must be 
  3887.  unique through password changes. If the security features are being used, make 
  3888.  sure that all administrator IDs are defined as requiring passwords. 
  3889.  
  3890.  For more information about the NET ACCOUNTS and NET ADMIN commands, refer to 
  3891.  the Command Reference. 
  3892.  
  3893.  
  3894. ΓòÉΓòÉΓòÉ 7.9. Managing Groups ΓòÉΓòÉΓòÉ
  3895.  
  3896. OS/2 Warp Server or LAN Server can accept up to 256 group IDs per domain; 
  3897. however, nine group IDs are reserved for OS/2 Warp Server and LAN Server. 
  3898. Therefore, you can create up to 247 groups for your own use.  The following IDs 
  3899. are reserved  and should not be deleted: 
  3900.  
  3901.      USERS (IDs with user privileges or groups of all user IDs) 
  3902.  
  3903.      ADMINS (administrators) 
  3904.  
  3905.      GROUPID (default group ID) 
  3906.  
  3907.      SERVERS (servers defined in the domain) 
  3908.  
  3909.      LOCAL (empty group used to grant permissions to the local workstation 
  3910.       when no one is logged on) 
  3911.  
  3912.      GUESTS (group or group of guest IDs) 
  3913.  
  3914.      RPLGROUP (created only if Remote IPL is installed) 
  3915.  
  3916.      SYSASID 
  3917.  
  3918.      PUBLIC 
  3919.  
  3920.  Note:  For Windows NT servers there are persistent users and localgroups, 
  3921.         which are managed solely by the Window NT server. To add or update 
  3922.         these definitions, follow steps a through h of the directions for 
  3923.         defining a Windows NT Server. All other users and localgroups should be 
  3924.         administered on the domain controller to prevent the NT server from 
  3925.         being out of synch with the domain controller. 
  3926.  
  3927.  For more information about group ID restrictions, see  Password and ID 
  3928.  Character Restrictions. 
  3929.  
  3930.  For more information, see the following topics: 
  3931.  
  3932.      Adding a Group 
  3933.  
  3934.      Cloning a Group 
  3935.  
  3936.      Viewing a Group 
  3937.  
  3938.      Updating a Group 
  3939.  
  3940.      Deleting a Group 
  3941.  
  3942.  
  3943. ΓòÉΓòÉΓòÉ 7.9.1. Adding a Group ΓòÉΓòÉΓòÉ
  3944.  
  3945. You can create user groups to refer to several users at the same time. On an 
  3946. OS/2 LAN, groups are used for access control and messaging purposes. 
  3947.  
  3948. To add a group: 
  3949.  
  3950.    1. Open  LAN Server Administration. 
  3951.  
  3952.    2. Open the domain object in which you want to add a group. 
  3953.  
  3954.    3. Open  Groups. 
  3955.  
  3956.       The Groups folder is displayed. 
  3957.  
  3958.    4. Drag a copy of the  Group Template to a convenient position in the 
  3959.       folder. 
  3960.  
  3961.       The Group - Create notebook is displayed. 
  3962.  
  3963.    5. Complete the pages under each tab to add a group. 
  3964.  
  3965.    6. After you complete and check the properties, select  Create. 
  3966.  
  3967.  
  3968. ΓòÉΓòÉΓòÉ 7.9.2. Cloning a Group ΓòÉΓòÉΓòÉ
  3969.  
  3970. If you want to set up a new group ID with characteristics similar to another 
  3971. group, you can clone the existing group ID, give it a new name and then make 
  3972. adjustments to it. 
  3973.  
  3974. To clone a group: 
  3975.  
  3976.    1. Open  LAN Server Administration. 
  3977.  
  3978.    2. Open the domain object in which you want to add a group. 
  3979.  
  3980.    3. Open  Groups. 
  3981.  
  3982.       The Groups folder is displayed. 
  3983.  
  3984.    4. With mouse button 2, select the group object you want to clone. 
  3985.  
  3986.    5. From the pop-up menu, select  Create another. 
  3987.  
  3988.       The Group - Create notebook is displayed. 
  3989.  
  3990.    6. Replace the name in the Group name field with the new group name. 
  3991.  
  3992.    7. If needed, select the  Users tab to change the users in the newly created 
  3993.       group. 
  3994.  
  3995.    8. Select  Create to create the new group ID.  The new group ID inherits all 
  3996.       the properties of the original group. 
  3997.  
  3998.  
  3999. ΓòÉΓòÉΓòÉ 7.9.3. Viewing a Group ΓòÉΓòÉΓòÉ
  4000.  
  4001. You can view the list of users in a group after the group is created. 
  4002.  
  4003. To view a group: 
  4004.  
  4005.    1. Open  LAN Server Administration. 
  4006.  
  4007.    2. Open the domain object. 
  4008.  
  4009.    3. Open  Groups. 
  4010.  
  4011.       The Groups folder is displayed. 
  4012.  
  4013.    4. Open the group for which you want a list of users. 
  4014.  
  4015.       The Group notebook is displayed. 
  4016.  
  4017.    5. Select the  Users tab. 
  4018.  
  4019.       The Users page is displayed, listing and describing all users in the 
  4020.       group. 
  4021.  
  4022.  
  4023. ΓòÉΓòÉΓòÉ 7.9.4. Updating a Group ΓòÉΓòÉΓòÉ
  4024.  
  4025. You can add and remove users in a group after the group is created. 
  4026.  
  4027. For more information, see: 
  4028.  
  4029.      Adding Users to a Group 
  4030.  
  4031.      Removing Users from a Group 
  4032.  
  4033.  
  4034. ΓòÉΓòÉΓòÉ 7.9.4.1. Adding Users to a Group ΓòÉΓòÉΓòÉ
  4035.  
  4036. Use the next procedure to add users to a group. 
  4037.  
  4038. To add users: 
  4039.  
  4040.    1. Open  LAN Server Administration. 
  4041.  
  4042.    2. Open the domain object. 
  4043.  
  4044.    3. Open  Groups. 
  4045.  
  4046.       The Groups folder is displayed. 
  4047.  
  4048.    4. Open the group you want to update. 
  4049.  
  4050.       The Group notebook is displayed. 
  4051.  
  4052.    5. Select the  Users tab. 
  4053.  
  4054.       The Users page is displayed. 
  4055.  
  4056.    6. Select Add. 
  4057.  
  4058.       The Add Users to Group window is displayed. 
  4059.  
  4060.    7. Select one or more users to add. 
  4061.  
  4062.    8. Select Add. 
  4063.  
  4064.       The desired users are added. 
  4065.  
  4066.    9. Select  Set or  Apply. 
  4067.  
  4068.  Note:  You can perform the same task using drag and drop methods. You can drag 
  4069.         and drop user accounts onto group objects or alternatively, drag and 
  4070.         drop group objects onto user accounts. When dropped, the group and user 
  4071.         account definitions are automatically updated. 
  4072.  
  4073.  
  4074. ΓòÉΓòÉΓòÉ 7.9.4.2. Removing Users from a Group ΓòÉΓòÉΓòÉ
  4075.  
  4076. Use the next procedure to remove users from a group. 
  4077.  
  4078. To remove users: 
  4079.  
  4080.    1. Open  LAN Server Administration. 
  4081.  
  4082.    2. Open the domain object. 
  4083.  
  4084.    3. Open  Groups. 
  4085.  
  4086.       The Groups folder is displayed. 
  4087.  
  4088.    4. Open the group you want to update. 
  4089.  
  4090.       The Group notebook is displayed. 
  4091.  
  4092.    5. Select the  Users tab. 
  4093.  
  4094.       The Users page is displayed. 
  4095.  
  4096.    6. Select one or more users to remove. 
  4097.  
  4098.    7. Select  Remove. 
  4099.  
  4100.    8. When you finish removing users, close the notebook. 
  4101.  
  4102.    9. Select  Set or  Apply. 
  4103.  
  4104.  
  4105. ΓòÉΓòÉΓòÉ 7.9.5. Deleting a Group ΓòÉΓòÉΓòÉ
  4106.  
  4107. Besides removing users from groups, you can delete a group from the domain. 
  4108. Users in the deleted group no longer have permissions that may have been 
  4109. granted to them through membership in the group.  However, deleting a group 
  4110. does not affect the individual user IDs and their associated user profiles. 
  4111.  
  4112. Attention  Do not delete the groups named SERVERS, USERS, ADMINS, or any 
  4113.            special group. 
  4114.  
  4115.  To delete a group: 
  4116.  
  4117.    1. Open  LAN Server Administration. 
  4118.  
  4119.    2. Open the domain object. 
  4120.  
  4121.    3. Open  Groups. 
  4122.  
  4123.       The Groups folder is displayed. 
  4124.  
  4125.    4. With mouse button 2, select the group you want to delete. 
  4126.  
  4127.    5. From the pop-up menu, select  Delete. 
  4128.  
  4129.    6. Select  Delete in the confirmation window. 
  4130.  
  4131.  
  4132. ΓòÉΓòÉΓòÉ 7.10. Creating Guest Accounts ΓòÉΓòÉΓòÉ
  4133.  
  4134. If many users outside of your domain need access to one of your resources, you 
  4135. may want to create a guest account.  A guest account for a resource gives any 
  4136. external user attempting to use the resource a specified access permission, 
  4137. without your having to define every user to the domain. 
  4138.  
  4139. To set up a guest account, specify guestacct=userid in the Server section of 
  4140. the domain controller's IBMLAN.INI file.  The default is guestacct=GUEST 
  4141. (userid GUEST is used in the rest of the book). Refer to the Command Reference 
  4142. for more information on the NET USER command. 
  4143.  
  4144. After the guest account is set up, any user not defined to the domain who 
  4145. attempts to use a resource in that domain (either through LAN Server 
  4146. Administration or with the NET USE command) is treated as the user GUEST. 
  4147. Multiple concurrent external users can access a domain resource using the guest 
  4148. account. 
  4149.  
  4150. Resource access permissions given to user ID GUEST are given to users not 
  4151. defined on your domain. Any user ID can be identified as GUEST.  When you set 
  4152. up access control permissions for resources, treat GUEST as any other user ID, 
  4153. but be aware that any user not specifically defined to the domain is given 
  4154. those same access permissions.  All GUEST users receive the same access control 
  4155. profiles as the user specified on the guestacct=userid line.  For example, if 
  4156. the userid to which the GUEST ID is equated is that of an administrator, all 
  4157. GUEST users would have administrator privileges. For information on setting up 
  4158. access control profiles, see  Defining Access Control Profiles. For information 
  4159. on the IBMLAN.INI file, refer to Performance Tuning. 
  4160.  
  4161. Notes: 
  4162.  
  4163.    1. Any user can log on to the domain using the guest ID defined in the 
  4164.       IBMLAN.INI file. This logon does not prevent other users from accessing 
  4165.       domain resources with the guest account permissions. 
  4166.  
  4167.    2. Do not delete the guest account and GUEST user ID from the remote IPL 
  4168.       server. The guest account and GUEST user ID must be intact to allow the 
  4169.       remote IPL workstation to gain access to the \IBMLAN\DCDB\IMAGES 
  4170.       directory on the server. For more information on remote IPL, see 
  4171.       Installing and Configuring Remote IPL. 
  4172.  
  4173.    3. To enable DOS LAN Services users to change expired passwords at logon, 
  4174.       you must either ensure that the server has a guest account or ensure that 
  4175.       all DOS LAN Services client workstations have the OS/2 LAN APIs 
  4176.       installed. 
  4177.  
  4178.  
  4179. ΓòÉΓòÉΓòÉ 7.11. Creating a Logon Profile ΓòÉΓòÉΓòÉ
  4180.  
  4181. You can create a logon profile for a user to gain access to certain files when 
  4182. logged on. A logon profile is a batch file containing commands that run 
  4183. automatically each time the user logs on. If you are using LAN Server 
  4184. Administration to create logon assignments for your users to access shared 
  4185. resources, you do not need to create logon profiles.  However, some resources 
  4186. which are not shared by alias may be needed by a user at logon time.  Use this 
  4187. procedure for those situations. 
  4188.  
  4189. To create a logon profile for a user, create a file with one of the following 
  4190. required names: 
  4191.  
  4192.      PROFILE.CMD for users at OS/2 clients 
  4193.  
  4194.      PROFILE.BAT for users at DOS clients 
  4195.  
  4196.  The logon profile must be in that user's user profile 
  4197.  subdirectory,\IBMLAN\DCDB\USERS\ userid, for users at both OS/2 and DOS 
  4198.  clients. If the subdirectory does not exist, create an alias for it. See 
  4199.  Directory Structure for more information on directory contents. 
  4200.  
  4201.  For example, for a user logging on to a DOS LAN Services client, the following 
  4202.  line in the PROFILE.BAT file assigns printer alias LPT1Q to local printer 
  4203.  LPT1: 
  4204.  
  4205.   NET USE LPT1: \LPT1Q
  4206.  
  4207.  This command causes the DOS LAN Services workstation to connect to the printer 
  4208.  resource at logon. 
  4209.  
  4210.  Notes: 
  4211.  
  4212.    1. User logon profiles can only be used with user IDs that do not exceed 10 
  4213.       characters.  This restriction also applies when adding or changing logon 
  4214.       profiles. 
  4215.  
  4216.    2. If your network has several servers acting as backup domain controllers, 
  4217.       make sure user logon profiles are correctly stored on each of the backup 
  4218.       domain controllers under the correct paths.  Otherwise, if there is a 
  4219.       domain controller failure, users will not be able to access their logon 
  4220.       profiles from the backup domain controller. 
  4221.  
  4222.    3. Currently existing environment variables cannot be permanently set 
  4223.       through the PROFILE.CMD or PROFILE.BAT file. 
  4224.  
  4225.    4. If you log on through UPM and your PROFILE.CMD file contains an ECHO or a 
  4226.       SAY command, you receive a NET8195 error. To avoid this error condition, 
  4227.       log on using the command-line interface. 
  4228.  
  4229.    5. If the PROFILE.CMD file is written in REXX language, you must have the 
  4230.       EXIT (0) statement at the end of the file. Otherwise, a NET8195 error 
  4231.       occurs. 
  4232.  
  4233.  You can also call other .CMD and.BAT files from a .CMD file or.BAT file 
  4234.  associated with a user.  This is a good way of creating a logon script that 
  4235.  all users can run at logon time. 
  4236.  
  4237.  
  4238. ΓòÉΓòÉΓòÉ 8. Sharing Network Resources ΓòÉΓòÉΓòÉ
  4239.  
  4240.  Shared resources are directories, printers, and serial devices available to 
  4241. users of OS/2 Warp Server and LAN Server.  Before users can assign a resource 
  4242. to a local device name, you must make the resource available by sharing it. 
  4243. After a user has redirected a device to the shared resource, requests to access 
  4244. the resource are granted only as specified in an access control profile. 
  4245.  
  4246. Note: 
  4247.  
  4248. Clients can also share resources through the Peer service by using the NET 
  4249. SESSION, NET SHARE, NET START, and NET STATISTICS commands. For information 
  4250. about commands, see the Command Reference. 
  4251.  
  4252. Clients running OS/2 Warp with File and Print Client can share resources 
  4253. through the Shared Resources and Network Connections notebook. 
  4254.  
  4255.  For more information, see the following topics: 
  4256.  
  4257.      Types of Shared Resources 
  4258.  
  4259.      How Resources Are Shared 
  4260.  
  4261.      Using an Alias to Share a Resource 
  4262.  
  4263.      Using a Netname to Share a Resource 
  4264.  
  4265.      Connecting to Shared Resources 
  4266.  
  4267.      Accessing Resources on Another Domain 
  4268.  
  4269.      Examples 
  4270.  
  4271.  
  4272. ΓòÉΓòÉΓòÉ 8.1. Types of Shared Resources ΓòÉΓòÉΓòÉ
  4273.  
  4274. The following types of resources can be shared: 
  4275.  
  4276.      Directory Resources 
  4277.  
  4278.      Spooler Queues (Printers) 
  4279.  
  4280.      Serial Device Queues 
  4281.  
  4282.      Drives 
  4283.  
  4284.      Resources on Servers in Other Domains 
  4285.  
  4286.  
  4287. ΓòÉΓòÉΓòÉ 8.1.1. Directory Resources ΓòÉΓòÉΓòÉ
  4288.  
  4289. A  directory resource is a directory or subdirectory on a server containing 
  4290. programs or data files that can be made available to users.  When you give a 
  4291. user access to a directory resource, that user does not necessarily have access 
  4292. to the subdirectories and files contained in that directory resource. For more 
  4293. information about access control, see  Defining Access Control Profiles. 
  4294.  
  4295.  
  4296. ΓòÉΓòÉΓòÉ 8.1.2. Spooler Queues (Printers) ΓòÉΓòÉΓòÉ
  4297.  
  4298. You can determine which printers are shared, set up spooler queues, and decide 
  4299. whether to create printer pools. Printer port numbers range from LPT1 to LPT9. 
  4300. Printers are managed through individual printer objects. 
  4301.  
  4302. A  spooler queue is an ordered list of print jobs waiting to access a printer. 
  4303. For example, a spooler queue can contain jobs from several users to print on a 
  4304. specific printer.  The jobs in a spooler queue are automatically routed to the 
  4305. printer. You can add, delete, and redefine spooler queues, as well as control 
  4306. print jobs and the printer status. 
  4307.  
  4308. To make network printers available to users, you share spooler queues.  As with 
  4309. other network resources, you can create aliases to identify spooler queues. 
  4310.  
  4311. You can create printer pools for the network.  A  printer pool is a group of 
  4312. printers servicing a single spooler queue.  Jobs on the spooler queue are 
  4313. printed on the first available printer in the pool. 
  4314.  
  4315.  
  4316. ΓòÉΓòÉΓòÉ 8.1.3. Serial Device Queues ΓòÉΓòÉΓòÉ
  4317.  
  4318. OS/2 Warp Server and LAN Server let you share serial devices, such as plotters, 
  4319. with users at OS/2 clients.  Users at DOS clients can access serial printers 
  4320. set up as printer resources, but they cannot access other serial devices. You 
  4321. are responsible for defining serial device queues and pools and for authorizing 
  4322. users. 
  4323.  
  4324. Notes: 
  4325.  
  4326.    1. Ensure that you have any COM.SYS device driver statements placed before 
  4327.       the RDRHELP.SYS statement in the CONFIG.SYS file before defining an alias 
  4328.       for a serial device queue. A COM.SYS device driver is added automatically 
  4329.       when you choose to install serial devices during operating system 
  4330.       installation. You can also copy the COM.SYS file from another server. 
  4331.  
  4332.    2. If more than two serial device queues or devices are created, the 
  4333.       maxchdevq and  maxchdevs parameters in the IBMLAN.INI file need to be 
  4334.       increased.  See Performance Tuning for more information about these 
  4335.       parameters. 
  4336.  
  4337.    3. If handshaking is not specified for the serial device, device errors such 
  4338.       as  Device offline are not reported to the user.  Handshaking for COM 
  4339.       ports can be set anywhere a COM port icon is displayed. 
  4340.  
  4341.    1. Select the printer object on the desktop. 
  4342.  
  4343.    2. Select  Output. 
  4344.  
  4345.    3. Select the COM icon of the printer's port. 
  4346.  
  4347.    4. Open the COM icon properties. 
  4348.  
  4349.    5. Set handshaking to either  Hardware or  None. 
  4350.  
  4351.    6. Select  OK. 
  4352.  
  4353.  A  serial device queue is an ordered list of network requests from users 
  4354.  waiting to use a serial device.  When the device becomes available, the client 
  4355.  is connected to the device. 
  4356.  
  4357.  To make network serial devices available to users, you share serial device 
  4358.  queues. As with other network resources, you can create aliases to identify 
  4359.  serial device queues. 
  4360.  
  4361.  You can create  serial device pools so that a request in the queue is sent to 
  4362.  the next available device.  You can assign priority levels to several queues 
  4363.  connected to the same device or pool.  In this way, a request in a 
  4364.  high-priority queue to a device is processed before a request in a 
  4365.  lower-priority queue. 
  4366.  
  4367.  Serial ports handle direct input/output. When you use a serial device queue, 
  4368.  the  request to use the device, rather than a file, goes into the queue. When 
  4369.  a serial device becomes free, the request is granted and the direct 
  4370.  input/output begins. The device is assigned to the requesting user. 
  4371.  
  4372.  While the serial device request waits in the queue, the user cannot continue 
  4373.  with the present task.  However, the user can do other OS/2 tasks. The amount 
  4374.  of time the request remains in the queue is determined by the charwait 
  4375.  parameter in the client's IBMLAN.INI file. For more information about the 
  4376.  charwait parameter, refer to Performance Tuning . 
  4377.  
  4378.  
  4379. ΓòÉΓòÉΓòÉ 8.1.4. Drives ΓòÉΓòÉΓòÉ
  4380.  
  4381. A  drive resource is a logical drive that contains a root directory and 
  4382. subdirectories that contain data files or application programs. Sharing a drive 
  4383. resource allows LAN users to connect to all data and applications on that 
  4384. drive. 
  4385.  
  4386.  
  4387. ΓòÉΓòÉΓòÉ 8.1.5. Resources on Servers in Other Domains ΓòÉΓòÉΓòÉ
  4388.  
  4389. In LAN Server releases before LAN Server Version 4, an  external resource was a 
  4390. resource (directory resource, spooler queue, or serial device queue) on a 
  4391. server in another domain.  Special configuration requirements and 
  4392. considerations were required. However, in OS/2 Warp Server and LAN Server, 
  4393. access to resources on servers in other domains is automatic. For this reason, 
  4394. such resources are no longer called external resources.  If you have upgraded 
  4395. from a previous version of LAN Server, the external resources you defined are 
  4396. still available in OS/2 Warp Server. 
  4397.  
  4398. In OS/2 Warp Server and LAN Server aliases used to represent resources on other 
  4399. servers are called  cross-domain aliases. 
  4400.  
  4401.  
  4402. ΓòÉΓòÉΓòÉ 8.2. How Resources Are Shared ΓòÉΓòÉΓòÉ
  4403.  
  4404. You can share a resource by creating either a  netname or an alias referring to 
  4405. the resource. A netname is a name that, in conjunction with the server name, 
  4406. identifies a resource on the network when the resource is shared. An alias is a 
  4407. resource definition that an administrator sets up for a directory, printer, or 
  4408. serial device on a particular server. All shared resources are assigned a 
  4409. netname, even if they are shared by the alias definition. 
  4410.  
  4411. Aliases are the intradomain directory service for OS/2 Warp Server and LAN 
  4412. Server that makes connections to resources on multiple servers as easy as if 
  4413. there were one large server. 
  4414.  
  4415. However, to manage who can access the shared resource, you should create an 
  4416. access control profile, as discussed in  Defining Access Control Profiles. 
  4417.  
  4418. The netname of a resource on a server must differ from netnames of other 
  4419. resources on that server. However, the same netname can be used at other 
  4420. servers in the domain (possibly identifying a different resource at each 
  4421. server).  Consequently, when referring to a resource by netname, the user must 
  4422. also specify the server where the resource resides.  This combination of server 
  4423. name and netname is called the  universal naming convention (UNC) name. The 
  4424. format for a UNC name is: \\servername\netname\path. 
  4425.  
  4426. In contrast, resources with aliases can be referred to without specifying a 
  4427. server because the host server name is stored with the alias definition. 
  4428.  
  4429. Another advantage of aliases is that they are more durable than netnames. 
  4430. Netnames are temporary because they are closely related to resource sharing. 
  4431. Resource sharing begins when a netname is created to refer to the resource. 
  4432. When sharing stops (perhaps because a server is stopped), the netname is 
  4433. discarded. 
  4434.  
  4435. In contrast, an alias for a resource exists until you delete it.  An alias 
  4436. definition contains information to create a netname and initiate resource 
  4437. sharing.  This information enables OS/2 Warp Server or LAN Server to share the 
  4438. aliased resource automatically at server startup or at a user request. Or, if 
  4439. an aliased resource should not be shared automatically, it can be designated 
  4440. for sharing by administrator action only. 
  4441.  
  4442. When a directory resource or serial device queue is shared by an alias, OS/2 
  4443. Warp Server or LAN Server creates a netname, identical to the alias, at the 
  4444. server where the resource resides.  For a printer queue, the netname matches 
  4445. the queue name rather than the alias.  Thus, once shared, an aliased resource 
  4446. can be referred to both by its netname (and server) or by its alias. 
  4447.  
  4448. If an alias is deleted while its resource is shared, sharing continues and the 
  4449. resource can still be referred to by its netname.  You can stop this continued 
  4450. sharing, if desired, either before or after deleting the alias. 
  4451.  
  4452. With the NET USE command, you can use the following $ shares.  These items are 
  4453. shared automatically. 
  4454.  
  4455.  $ Share             Description
  4456.  
  4457.  IPC$                The share for interprocess communication (IPC).  Examples 
  4458.                      are named-pipe transactions. 
  4459.  
  4460.  ADMIN$              The share for remote command-line administration. 
  4461.  
  4462.  IBMLAN$             The share for all client access to the IBMLAN tree (mostly 
  4463.                      from the OS/2 Warp Server Administration). 
  4464.  
  4465.  D$                  Every logical local drive on a server.  For example, a 
  4466.                      server with drives C, D, and E has the following automatic 
  4467.                      $ shares made at server service startup:  C$, D$, and E$. 
  4468.  
  4469.  Note:   All $ shares are performed by the Server service except the IBMLAN 
  4470.         share, which is performed by the LSServer service. 
  4471.  
  4472.  For more information, see the following topics: 
  4473.  
  4474.      Permitting Access to Shared Resources 
  4475.  
  4476.      Specifying Maximum Concurrent Connections 
  4477.  
  4478.  
  4479. ΓòÉΓòÉΓòÉ 8.2.1. Permitting Access to Shared Resources ΓòÉΓòÉΓòÉ
  4480.  
  4481. After you create an alias or a netname for a shared resource, create an access 
  4482. control profile to designate access permissions (such as read access) to the 
  4483. resource. A user may be able to access a file that has no access control 
  4484. profile if a profile exists for a drive or directory that contains that file 
  4485. and provides the user with the permissions to perform the requested action. 
  4486.  
  4487. Note:  Default access control profiles created by the network allow access to 
  4488.        all spooler queues and serial devices. You can change these defaults by 
  4489.        modifying the \PRINT and\COMM root profiles. 
  4490.  
  4491.  You can set up an access control profile in one of the following ways: 
  4492.  
  4493.      The administrator is automatically prompted to create an access control 
  4494.       profile when creating an alias. 
  4495.  
  4496.      For an existing alias, you can select  Manage access from an alias pop-up 
  4497.       menu to access the window and create an access control profile for that 
  4498.       resource (see  Creating an Alias). 
  4499.  
  4500.       Note:  Only an administrator can create an access control profile. The 
  4501.              administrator should give the P permission to operators or users 
  4502.              so that they can manage access to this resource. 
  4503.  
  4504.      From a current share on a server object, select the  Manage access 
  4505.       pushbutton on the Current Shares window. 
  4506.  
  4507.      From the OS/2 Desktop, which is a local server: 
  4508.  
  4509.         -  You can select  Manage access from the object pop-up menu of a local 
  4510.            drive, directory, or file on your Desktop. 
  4511.  
  4512.         -  You can select  Manage access from remote shared drive or directory 
  4513.            in the IBM Network Resources folder. 
  4514.  
  4515.      Through the NET ACCESS command. For more information, refer to the 
  4516.       Command Reference. 
  4517.  
  4518.  Note:  Only an administrator can create an access control profile. The 
  4519.         administrator should give the P permission to operators or users so 
  4520.         that they can manage access to this resource.  Only an administrator or 
  4521.         an operator or user with P permission can modify an access control 
  4522.         profile. 
  4523.  
  4524.  For more information on access control, see  Defining Access Control Profiles. 
  4525.  
  4526.  
  4527. ΓòÉΓòÉΓòÉ 8.2.2. Specifying Maximum Concurrent Connections ΓòÉΓòÉΓòÉ
  4528.  
  4529. When you create an alias or share a resource by netname, the OS/2 Warp Server 
  4530. Administration displays an optional field called Maximum concurrent 
  4531. connections, which allows you to control how many users can use the resource at 
  4532. the same time (concurrent users). 
  4533.  
  4534. For example, if you purchase 10 licenses to an application, you can install 
  4535. that application on a server, create a directory alias pointing to the 
  4536. subdirectory where the application resides, and specify Maximum concurrent 
  4537. connections as 10. The eleventh user trying to connect concurrently to the 
  4538. application cannot access it until one of the first 10 users releases the 
  4539. application.  If you select  Unlimited, an unlimited number of users can 
  4540. connect to the alias. 
  4541.  
  4542.  
  4543. ΓòÉΓòÉΓòÉ 8.3. Using an Alias to Share a Resource ΓòÉΓòÉΓòÉ
  4544.  
  4545. You can define aliases using LAN Server Administration, as discussed here, or 
  4546. by using the NET ALIAS command. For information about defining aliases with NET 
  4547. ALIAS, see the Command Reference. 
  4548.  
  4549. Before users can access shared resources, access permission must be granted in 
  4550. an access control profile. For more information on access control, see Defining 
  4551. Access Control Profiles. 
  4552.  
  4553. You can make logon assignments either through aliases or with profile command 
  4554. files.  Network application definitions can be created only with aliased 
  4555. directory resources.  Resource connections established at the time network 
  4556. applications start must be aliased.  Resources in multiple-server domains are 
  4557. easier to find if they are aliased. 
  4558.  
  4559. In most cases users prefer to be connected to resources automatically at logon. 
  4560. The best way to do this in OS/2 Warp Server or LAN Server is to create an alias 
  4561. and make it a logon assignment for the users. 
  4562.  
  4563. For more information, see the following topics: 
  4564.  
  4565.      Resources Requiring Aliases 
  4566.  
  4567.      Alias Example 
  4568.  
  4569.      Defining How and When Aliased Resources Are Shared 
  4570.  
  4571.      Procedures for Using Aliases 
  4572.  
  4573.  
  4574. ΓòÉΓòÉΓòÉ 8.3.1. Resources Requiring Aliases ΓòÉΓòÉΓòÉ
  4575.  
  4576. The following resources must be assigned using aliases: 
  4577.  
  4578.      Resources that are logon assignments (directories, printers, or serial 
  4579.       devices) for your users 
  4580.  
  4581.      Network resources for shared public applications 
  4582.  
  4583.  
  4584. ΓòÉΓòÉΓòÉ 8.3.2. Alias Example ΓòÉΓòÉΓòÉ
  4585.  
  4586. Suppose directory EMP on SERVER1 contains employee data to be shared with 
  4587. network users. You could create an alias named EMPLOYEE for C:\EMP on SERVER1 
  4588. and a short description, such as Employee information.  The description is an 
  4589. optional field you can complete when creating the alias. Users see the alias 
  4590. and its description in the Identity page of the Alias notebook. In this 
  4591. example, the users see the following: 
  4592.  
  4593.      EMPLOYEE is displayed in the  Alias field. 
  4594.  
  4595.      Employee information is displayed in the Description field. 
  4596.  
  4597.  
  4598. ΓòÉΓòÉΓòÉ 8.3.3. Defining How and When Aliased Resources Are Shared ΓòÉΓòÉΓòÉ
  4599.  
  4600. When defining an alias, you can choose to share the resource in different ways: 
  4601.  
  4602.  At server startup   This selection causes the resource to be shared 
  4603.                      immediately when the server on which it is located starts. 
  4604.                      It continues to be shared until the server is stopped, or 
  4605.                      until you explicitly stop sharing it. 
  4606.  
  4607.                      Consider sharing frequently used resources, such as 
  4608.                      often-used printers and serial devices, at server startup. 
  4609.                      Also consider sharing at server startup those resources 
  4610.                      accessed from another domain. 
  4611.  
  4612.  When requested (for directory resources only) This selection causes the 
  4613.                      resource to be shared dynamically when a user (with the 
  4614.                      appropriate access permission) requests to use that 
  4615.                      resource.  A user can request use of a resource by: 
  4616.  
  4617.                          Logging on, thus invoking logon assignments 
  4618.  
  4619.                          Selecting a public application that uses network 
  4620.                           resources from the Network Applications folder 
  4621.  
  4622.                          Going through the Directory Resource Definitions 
  4623.                           folder and assigning the alias to a directory 
  4624.                           resource to start sharing 
  4625.  
  4626.  By administrator action This selection causes a resource to be shared only 
  4627.                      when the administrator starts the sharing with LAN Server 
  4628.                      Administration or with the NET USE command. 
  4629.  
  4630.                      When a resource is shared by administrator action, the 
  4631.                      sharing remains in effect until the server where the 
  4632.                      resource resides is stopped, or when you stop sharing the 
  4633.                      resource. The next time the server starts and a user needs 
  4634.                      to access that resource, you must share the resource 
  4635.                      again. 
  4636.  
  4637.                      You can specify resource sharing by administrator action 
  4638.                      for resources over which you want more control. To access 
  4639.                      such resources, users must first contact you. 
  4640.  
  4641.  An attempt by a user from another domain to use a resource shared as required 
  4642.  does not cause the resource to be shared. 
  4643.  
  4644.  When no user is using the resource, sharing is automatically stopped on 
  4645.  when-requested aliases if the  cleanup parameter is set to YES in the 
  4646.  IBMLAN.INI file.  If you have difficulty with drive disconnection, try adding 
  4647.  CLEANUP=NO. Cleanup also affects nonaliased home directories. 
  4648.  
  4649.  
  4650. ΓòÉΓòÉΓòÉ 8.3.4. Procedures for Using Aliases ΓòÉΓòÉΓòÉ
  4651.  
  4652. When resources are shared, the issue of how the users access and share them 
  4653. must be addressed by the administrator.  Most of this control is exercised 
  4654. through the assignment of aliases to the resources.  Following are procedures 
  4655. for managing shared resources. 
  4656.  
  4657. For more information, see the following topics: 
  4658.  
  4659.      Creating an Alias 
  4660.  
  4661.      Updating an Alias 
  4662.  
  4663.      Deleting an Alias 
  4664.  
  4665.      Determining the Server on Which a Resource Resides 
  4666.  
  4667.      Sharing Resources by Alias 
  4668.  
  4669.      Viewing and Changing Share Details by Alias 
  4670.  
  4671.      Giving Access to User Accounts and Groups 
  4672.  
  4673.      Adding Resources for a Public Application 
  4674.  
  4675.      Adding Public Applications for a User 
  4676.  
  4677.  
  4678. ΓòÉΓòÉΓòÉ 8.3.4.1. Creating an Alias ΓòÉΓòÉΓòÉ
  4679.  
  4680. Creating an alias for a resource does not necessarily grant a user access to 
  4681. that resource. An administrator must also give each user the appropriate 
  4682. permissions. See  Defining Access Control Profiles for information on access 
  4683. control profiles. 
  4684.  
  4685. To create an alias for a resource: 
  4686.  
  4687.    1. Open  LAN Server Administration. 
  4688.  
  4689.    2. Open the domain object in which you want to create the alias. 
  4690.  
  4691.    3. Open the appropriate Resource Definitions folder. 
  4692.  
  4693.    4. Drag the template for the type of alias object you want to create to a 
  4694.       convenient location in the folder. 
  4695.  
  4696.       The templates are Printer Template, Directory Template, and Serial Device 
  4697.       Template. 
  4698.  
  4699.       The appropriate alias notebook is displayed. 
  4700.  
  4701.    5. Type an alias name in the Alias field. 
  4702.  
  4703.    6. Optional: type a description in the Description field. 
  4704.  
  4705.    7. Select or type a server name: 
  4706.  
  4707.         a. If the server where the resource is located is in this domain, 
  4708.            select one of the server names in the  Server name list. 
  4709.  
  4710.         b. If the server where the resource is located is in another domain, 
  4711.            type the name of that server in the  Server name field. 
  4712.  
  4713.    8. Complete the other fields on the Identity page. 
  4714.  
  4715.       Note:  If you create more than two serial device aliases, you should 
  4716.              increase the values of the  maxchdevq and maxchdevs parameters in 
  4717.              the IBMLAN.INI file. 
  4718.  
  4719.    9. Select  Create. 
  4720.  
  4721.       Note:  If you are creating a directory alias and you specified a drive 
  4722.              letter followed by a colon and a backslash (for example, F:\), a 
  4723.              window is displayed requiring you to specify whether the access 
  4724.              control profile is for the entire drive or for the root directory 
  4725.              on the drive.  This is an important consideration for removable 
  4726.              media such as a CD-ROM, which should have the access control 
  4727.              profile specified on the drive.  Select  On drive or  On 
  4728.              directory, and then select  OK. 
  4729.  
  4730.           If there is no access control profile, a message is displayed 
  4731.            prompting you to create one. Select  OK to create the access 
  4732.            profile. 
  4733.  
  4734.            The Access Control Profile notebook is displayed. 
  4735.  
  4736.           If there is an access profile, no message appears. The Access 
  4737.            Control Profile notebook is displayed. 
  4738.  
  4739.       See  Defining Access Control Profiles for information about access 
  4740.       control profiles. 
  4741.  
  4742.   10. Complete the pages in the Access Control Profile notebook. 
  4743.  
  4744.   11. Select  Create or Set to close the notebook. 
  4745.  
  4746.       If it is a directory alias, a message is displayed prompting you whether 
  4747.       to propagate the access permissions to all subdirectories in the path. 
  4748.       See Propagating Access Control Profiles to Subdirectories for information 
  4749.       about propagating (applying) an access profile to subdirectories. 
  4750.  
  4751.   12. Select  OK to propagate access to all the subdirectories in the path, 
  4752.       giving users Read (R), Write (W), and Create (C) access to the entire 
  4753.       program directory tree. 
  4754.  
  4755.       The alias is created, the resource is shared, and the access control 
  4756.       profile is created.  An icon representing the alias is added to the 
  4757.       Resource Definitions object in the domain. 
  4758.  
  4759.  
  4760. ΓòÉΓòÉΓòÉ 8.3.4.2. Updating an Alias ΓòÉΓòÉΓòÉ
  4761.  
  4762. Use the next procedure to change the properties for an alias. 
  4763.  
  4764. To update an alias: 
  4765.  
  4766.    1. Open  LAN Server Administration. 
  4767.  
  4768.    2. Open the domain object in which you want to update the alias. 
  4769.  
  4770.    3. Open the appropriate Resource Definitions folder. 
  4771.  
  4772.       The Resource Definitions folder is displayed. 
  4773.  
  4774.    4. Open the appropriate alias object. 
  4775.  
  4776.    5. Should you want to change the server name: 
  4777.  
  4778.         a. If the server where the resource is located is in this domain, 
  4779.            select one of the server names in the  Server name field. 
  4780.  
  4781.         b. If the server where the resource is located is in another domain, 
  4782.            type the name of that server in the  Server name field. 
  4783.  
  4784.    6. Further update the Identity page as desired. 
  4785.  
  4786.       Note:  If you create more than two serial device aliases, you should 
  4787.              increase the values of the  maxchdevq and maxchdevs parameters in 
  4788.              the IBMLAN.INI file. 
  4789.  
  4790.    7. Select  Manage Access. 
  4791.  
  4792.       The Access Control Profile notebook is displayed. 
  4793.  
  4794.       Note:  Only an administrator, a user with operator privileges, or a user 
  4795.              with P permission can modify an access control profile. 
  4796.  
  4797.       An access control profile can be inherited automatically if the directory 
  4798.       resource is either created remotely or resides on an HPFS or JFS drive 
  4799.       and if the 386 HPFS is installed on the server.  Even if an access 
  4800.       profile is inherited, you may still need to modify the permissions. 
  4801.  
  4802.    8. Complete the pages in the Access Control Profile notebook. 
  4803.  
  4804.    9. Select  Set to close the Access Control Profile notebook. 
  4805.  
  4806.       If this is a directory alias, a message is displayed prompting you 
  4807.       whether to propagate the access permissions to all subdirectories in the 
  4808.       path.  See Propagating Access Control Profiles to Subdirectories for 
  4809.       information about propagating (applying) an access profile to 
  4810.       subdirectories. 
  4811.  
  4812.   10. Select  OKto propagate access to all the subdirectories in the path. 
  4813.  
  4814.   11. Select  Set again to close the alias notebook. 
  4815.  
  4816.  
  4817. ΓòÉΓòÉΓòÉ 8.3.4.3. Deleting an Alias ΓòÉΓòÉΓòÉ
  4818.  
  4819. You can delete one or more aliases from the domain. 
  4820.  
  4821. Note:  If the alias to be deleted is also a logon assignment, delete the logon 
  4822.        assignment.  Otherwise, the next time the user logs on, that user 
  4823.        receives an error message indicating one or more logon assignments 
  4824.        failed. For instructions on deleting logon assignments, see  Adding and 
  4825.        Updating Logon Assignments. 
  4826.  
  4827.  If the alias is shared at the time of its deletion, the sharing and the 
  4828.  associated netname continue to exist. If an alias is created for a new 
  4829.  resource using the deleted alias name and if users are connected to the 
  4830.  original resource, accesses to that alias are to the original resource. To 
  4831.  stop the sharing of a resource either before or after deleting its alias, 
  4832.  refer to  Stopping the Sharing by Netname. 
  4833.  
  4834.  To delete an alias: 
  4835.  
  4836.    1. Open  LAN Server Administration. 
  4837.  
  4838.    2. Open the domain object that contains the alias. 
  4839.  
  4840.    3. Open the appropriate Resource Definitions folder. 
  4841.  
  4842.    4. With mouse button 2, select the alias object you want to delete. 
  4843.  
  4844.    5. From the pop-up menu, select  Delete. 
  4845.  
  4846.    6. Select  Delete in the confirmation window. 
  4847.  
  4848.  
  4849. ΓòÉΓòÉΓòÉ 8.3.4.4. Determining the Server on Which a Resource Resides ΓòÉΓòÉΓòÉ
  4850.  
  4851. You may occasionally need to check which server a resource is on or review how 
  4852. the alias is defined. For example, this ability is useful when deleting 
  4853. resources on a server.  You can change a server on a OS/2 Warp Server or LAN 
  4854. Server Version 4 domain but not on down-level domains. 
  4855.  
  4856. To display the server where a resource (alias) is located: 
  4857.  
  4858.    1. Open  LAN Server Administration. 
  4859.  
  4860.    2. Open the domain that contains the alias. 
  4861.  
  4862.    3. Open the appropriate Resource Definitions folder. 
  4863.  
  4864.    4. Open the alias object you want to display information about. 
  4865.  
  4866.       The alias notebook is displayed. 
  4867.  
  4868.    5. When finished viewing, select  Cancel. 
  4869.  
  4870.  
  4871. ΓòÉΓòÉΓòÉ 8.3.4.5. Sharing Resources by Alias ΓòÉΓòÉΓòÉ
  4872.  
  4873. Use the next procedure to either start or stop resource sharing. 
  4874.  
  4875. To start or stop the sharing of a resource by alias: 
  4876.  
  4877.    1. Open  LAN Server Administration. 
  4878.  
  4879.    2. Open the domain object that contains the alias. 
  4880.  
  4881.    3. Open the appropriate Resource Definitions folder. 
  4882.  
  4883.    4. With mouse button 2, select the appropriate alias object. 
  4884.  
  4885.    5. From the pop-up menu, select one of the following as appropriate: 
  4886.  
  4887.           Start Sharing 
  4888.  
  4889.           Stop Sharing 
  4890.  
  4891.  
  4892. ΓòÉΓòÉΓòÉ 8.3.4.6. Viewing and Changing Share Details by Alias ΓòÉΓòÉΓòÉ
  4893.  
  4894. You can view and temporarily change a resource's sharing details, selecting the 
  4895. resource either by alias or by server and netname. The fields that can be 
  4896. changed are  Description and  Maximum concurrent connections. 
  4897.  
  4898. To view and change the share details for an alias: 
  4899.  
  4900.    1. Open  LAN Server Administration. 
  4901.  
  4902.    2. Open the domain that contains the alias. 
  4903.  
  4904.    3. Open the appropriate Resource Definitions folder. 
  4905.  
  4906.    4. Open the alias object you want to update. 
  4907.  
  4908.       The alias notebook is displayed. 
  4909.  
  4910.    5. View or change the  Description (after the alias is shared again). 
  4911.  
  4912.    6. View or change  When shared and Maximum concurrent connections (after the 
  4913.       alias is shared again). 
  4914.  
  4915.    7. If you change either, select Set or  Apply. 
  4916.  
  4917.       Any changes made do not take effect until the next time the alias is 
  4918.       shared. 
  4919.  
  4920.  
  4921. ΓòÉΓòÉΓòÉ 8.3.4.7. Giving Access to User Accounts and Groups ΓòÉΓòÉΓòÉ
  4922.  
  4923. You can drag and drop a user account or group onto an alias object to give it 
  4924. access or logon assignments to the resource represented by that alias. 
  4925.  
  4926. To drag a user account or group into an alias: 
  4927.  
  4928.    1. Open  LAN Server Administration. 
  4929.  
  4930.    2. Open the appropriate domain object. 
  4931.  
  4932.    3. Open one of the following objects that contains the user account or group 
  4933.       you want to provide access to this alias resource: 
  4934.  
  4935.           User Accounts 
  4936.  
  4937.           Groups 
  4938.  
  4939.    4. Open the appropriate Resource Definitions folder, which is also located 
  4940.       in the domain container. 
  4941.  
  4942.    5. Drag the user account or group object to the alias object that represents 
  4943.       the resource for which you are providing access. 
  4944.  
  4945.       The Grant Access to a Resource window is displayed to allow you to grant 
  4946.       access. 
  4947.  
  4948.    6. Complete the window. 
  4949.  
  4950.    7. Select  Set. 
  4951.  
  4952.       The Administer Logon Assignments window is displayed. 
  4953.  
  4954.    8. Complete the fields in the window. 
  4955.  
  4956.    9. Select  OK. 
  4957.  
  4958.  Note:  You can drag multiple users or groups onto alias objects in the 
  4959.         appropriate Resource Definitions folder.  You can also drag the alias 
  4960.         object onto a user or group ID object. 
  4961.  
  4962.  
  4963. ΓòÉΓòÉΓòÉ 8.3.4.8. Adding Resources for a Public Application ΓòÉΓòÉΓòÉ
  4964.  
  4965. You can drag and drop an alias onto a public application object to allow 
  4966. assignment of the resource represented by that alias to a device when the 
  4967. application is run. 
  4968.  
  4969. To drag an alias to a public application object: 
  4970.  
  4971.    1. Open  LAN Server Administration. 
  4972.  
  4973.    2. Open the appropriate domain object. 
  4974.  
  4975.    3. Open  Public Application Definitions. 
  4976.  
  4977.    4. Open the appropriate Resource Definitions folder. 
  4978.  
  4979.    5. Drag the public applications object onto the alias object that represents 
  4980.       the resource to which you are providing access. 
  4981.  
  4982.       The Assign Resource window is displayed. 
  4983.  
  4984.    6. Complete the window. 
  4985.  
  4986.    7. Select  OK. 
  4987.  
  4988.  
  4989. ΓòÉΓòÉΓòÉ 8.3.4.9. Adding Public Applications for a User ΓòÉΓòÉΓòÉ
  4990.  
  4991. You can drag and drop one or more user account or group objects onto a public 
  4992. application object.  This procedure adds the public application to the user's 
  4993. Network Applications folder for OS/2, or Shared Applications window for DOS 
  4994. clients, or LAN Applications list for DOS LAN Services Windows. 
  4995.  
  4996. To drag a user account or group to a public application object: 
  4997.  
  4998.    1. Open  LAN Server Administration. 
  4999.  
  5000.    2. Open the appropriate domain object. 
  5001.  
  5002.    3. Open User Accounts or Groups. 
  5003.  
  5004.    4. Open  Public Applications Definitions. 
  5005.  
  5006.    5. Drag a copy of the user account or group object to the public application 
  5007.       object. 
  5008.  
  5009.       The Add Public Application window is displayed to allow you to add this 
  5010.       public application for each user at logon. This window has no properties. 
  5011.  
  5012.    6. Select  OK. 
  5013.  
  5014.  
  5015. ΓòÉΓòÉΓòÉ 8.4. Using a Netname to Share a Resource ΓòÉΓòÉΓòÉ
  5016.  
  5017. Using a  netname is another way to share a resource. 
  5018.  
  5019. Sharing a resource by netname causes the resource to be shared only while the 
  5020. server where the resource resides is running (the current server session) or 
  5021. until you stop sharing the resource. The next time the server starts and a user 
  5022. needs to access that resource, you must share the resource again by doing one 
  5023. of the following: 
  5024.  
  5025.      Selecting the  Share another push button on the Current Shares window of 
  5026.       a server object 
  5027.  
  5028.      Selecting  Start share from the menu of a local drive or file on your 
  5029.       desktop 
  5030.  
  5031.      Issuing the NET SHARE command 
  5032.  
  5033.  You can specify resource sharing by administrator action for resources over 
  5034.  which you want more control. To access such resources, users must first 
  5035.  contact you. 
  5036.  
  5037.  For users to access shared resources, access permissions must be granted in an 
  5038.  access control profile. For more information on access control profiles, see 
  5039.  Defining Access Control Profiles. 
  5040.  
  5041.  For more information, see the following topics: 
  5042.  
  5043.      Sharing a Resource by Netname 
  5044.  
  5045.      Stopping the Sharing by Netname 
  5046.  
  5047.      Viewing and Changing Share Details by Netname 
  5048.  
  5049.  
  5050. ΓòÉΓòÉΓòÉ 8.4.1. Sharing a Resource by Netname ΓòÉΓòÉΓòÉ
  5051.  
  5052. To share a resource without an alias, you must specify the location of the 
  5053. resource and give the resource a netname. Such sharing remains in effect only 
  5054. until the server with the resource is stopped or until sharing is stopped by 
  5055. the administrator. 
  5056.  
  5057. To share a resource by netname through the OS/2 Warp Server Administration: 
  5058.  
  5059.    1. Open  LAN Server Administration. 
  5060.  
  5061.    2. Open the appropriate domain object. 
  5062.  
  5063.    3. Open  Defined Servers. 
  5064.  
  5065.    4. With mouse button 2, select the appropriate server object. 
  5066.  
  5067.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  5068.  
  5069.    6. Select the arrow to the right of  Current shares. 
  5070.  
  5071.    7. From the following list, select the type of resource you want to start or 
  5072.       stop sharing: 
  5073.  
  5074.           Printers 
  5075.  
  5076.           Serial devices 
  5077.  
  5078.           Directories 
  5079.  
  5080.       A Current Shares window is displayed.  It includes a list of resources 
  5081.       defined on the domain as network resources currently shared. 
  5082.  
  5083.    8. Select  Share Another. 
  5084.  
  5085.       The Shared Resource window is displayed: 
  5086.  
  5087.    9. Type a unique netname in the  Netname field. 
  5088.  
  5089.   10. Complete the remaining fields. 
  5090.  
  5091.   11. Select  OK. 
  5092.  
  5093.       If you are sharing a serial device queue, the queue is created at this 
  5094.       point if it does not exist. The resource is then shared. 
  5095.  
  5096.   12. If you want to create or revise an access control profile for this 
  5097.       resource, select  Manage Access at the Current Shares window. 
  5098.  
  5099.       Note:  Only an administrator can create an access control profile. The 
  5100.              administrator should give the P permission to operators or users 
  5101.              so that they can manage access to this resource.  Only an 
  5102.              administrator or an operator or user with P permission can modify 
  5103.              an access control profile. 
  5104.  
  5105.       Directory resources require an access control profile before users can 
  5106.       use them. 
  5107.  
  5108.       The Access Control Profile notebook is displayed. 
  5109.  
  5110.   13. Complete the pages in the Access Control Profile notebook. 
  5111.  
  5112.   14. Select  Create or  Set. 
  5113.  
  5114.   15. Select  Close to close the Current Shares window. 
  5115.  
  5116.  
  5117. ΓòÉΓòÉΓòÉ 8.4.2. Stopping the Sharing by Netname ΓòÉΓòÉΓòÉ
  5118.  
  5119. You can stop the sharing of a resource by doing one of the following: 
  5120.  
  5121.      Using LAN Server Administration Current Shares window. 
  5122.  
  5123.      Using the  Stop sharing menu selection on the drive, directory, or 
  5124.       printer object. 
  5125.  
  5126.      Using the  Stop sharing menu selection on the object in the File and 
  5127.       Print Client Resource Browser folder (\\ servername\ netname) of the 
  5128.       resource 
  5129.  
  5130.      Using the NET SHARE command 
  5131.  
  5132.  Users currently using that resource are disconnected from it when the sharing 
  5133.  is stopped. 
  5134.  
  5135.  When you stop sharing a spooler queue, the queue is not deleted. Spooled files 
  5136.  already in the queue print until they are completed.  However, any new spool 
  5137.  file still being written is forced closed and does not print. 
  5138.  
  5139.  To stop sharing a resource by netname: 
  5140.  
  5141.    1. Open  LAN Server Administration. 
  5142.  
  5143.    2. Open the appropriate domain object. 
  5144.  
  5145.    3. Open  Defined Servers. 
  5146.  
  5147.    4. With mouse button 2, select the server for which you want to stop sharing 
  5148.       the resource. 
  5149.  
  5150.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  5151.  
  5152.    6. Select the arrow to the right of  Current shares. 
  5153.  
  5154.    7. From the following list, select the type of resource you want to stop 
  5155.       sharing: 
  5156.  
  5157.           Printers 
  5158.  
  5159.           Serial devices 
  5160.  
  5161.           Directories 
  5162.  
  5163.       A Current Shares window is displayed.  It includes a list of resources 
  5164.       defined on the domain as network resources currently shared. 
  5165.  
  5166.    8. Select the resource from the list. 
  5167.  
  5168.    9. Select  Stop share. 
  5169.  
  5170.   10. Select  Close. 
  5171.  
  5172.  You can also stop the sharing with the NET SHARE command. 
  5173.  
  5174.  
  5175. ΓòÉΓòÉΓòÉ 8.4.3. Viewing and Changing Share Details by Netname ΓòÉΓòÉΓòÉ
  5176.  
  5177. You can view and temporarily change a resource's sharing details, selecting the 
  5178. resource by server and netname. The fields that can be changed are  Description 
  5179. and  Maximum concurrent connections. 
  5180.  
  5181.  To view and change sharing details of a resource by netname: 
  5182.  
  5183.    1. Open  LAN Server Administration. 
  5184.  
  5185.    2. Open the appropriate domain object. 
  5186.  
  5187.    3. Open  Defined Servers. 
  5188.  
  5189.    4. With mouse button 2, select the appropriate server object. 
  5190.  
  5191.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  5192.  
  5193.    6. Select the arrow to the right of  Current shares. 
  5194.  
  5195.    7. From the following list, select the type of resource you want to view or 
  5196.       change: 
  5197.  
  5198.           Printers 
  5199.  
  5200.           Serial devices 
  5201.  
  5202.           Directories 
  5203.  
  5204.       A Current Shares window is displayed.  It includes a list of resources 
  5205.       defined on the domain as network resources currently shared. 
  5206.  
  5207.    8. Select the resource from the list. 
  5208.  
  5209.    9. Select  Change share. 
  5210.  
  5211.       The Change Share window is displayed. 
  5212.  
  5213.   10. View or change the  Description. 
  5214.  
  5215.   11. View or change  Maximum concurrent connections, which is the maximum 
  5216.       number of connections defined for this resource. 
  5217.  
  5218.   12. Select  OK. 
  5219.  
  5220.   13. If you want to create or revise an access control profile for this 
  5221.       resource, select  Manage Access at the Current Shares window. 
  5222.  
  5223.       Note:  Only an administrator can create an access control profile. The 
  5224.              administrator should give the P permission to operators or users 
  5225.              so that they can manage access to this resource. 
  5226.  
  5227.       Directory resources require an access control profile before users can 
  5228.       use them. 
  5229.  
  5230.       The Access Control Profile notebook is displayed. 
  5231.  
  5232.   14. Complete the pages in the Access Control Profile notebook. 
  5233.  
  5234.   15. Select  Create. 
  5235.  
  5236.   16. Select  Close to close the Current Shares window. 
  5237.  
  5238.  
  5239. ΓòÉΓòÉΓòÉ 8.5. Connecting to Shared Resources ΓòÉΓòÉΓòÉ
  5240.  
  5241. For users to access shared network resources, a  local device name can be 
  5242. assigned to the resource. For a directory resource, the local device name is a 
  5243. drive letter. For a printer or serial device, the local device name is a port 
  5244. number. Each logged-on user may have available local drives D through Z, COM 
  5245. ports 1 through 9, and LPT ports 1 through 9. 
  5246.  
  5247. Note:  For a startup drive on a remote IPL client, the drive ID C: is replaced 
  5248.        with the remote IPL startup drive. 
  5249.  
  5250.   To connect to shared resources: 
  5251.  
  5252.    1. Open  LAN Server Administration. 
  5253.  
  5254.    2. Open  Local Workstation. 
  5255.  
  5256.    3. Select  Object. 
  5257.  
  5258.    4. Select the arrow to the right of  Open as. 
  5259.  
  5260.    5. Select  Current assignments. 
  5261.  
  5262.    6. Select  Add. 
  5263.  
  5264.       The Add a Current Assignment window is displayed. 
  5265.  
  5266.    7. Select the resource type. 
  5267.  
  5268.    8. Select or type an alias or UNC name. 
  5269.  
  5270.    9. Type or select the local device used for this assignment. 
  5271.  
  5272.   10. Select  OK. 
  5273.  
  5274.   11. Select  Close at the Current Assignments window. 
  5275.  
  5276.  You can also use the File and Print Client Resource Browser or the NET USE 
  5277.  command to connect to a resource. For more information, refer to the OS/2 File 
  5278.  and Print Client Guide and the Command Reference. 
  5279.  
  5280.  
  5281. ΓòÉΓòÉΓòÉ 8.6. Accessing Resources on Another Domain ΓòÉΓòÉΓòÉ
  5282.  
  5283. To access a resource on another domain, a user must: 
  5284.  
  5285.      Have a user account defined on the other domain. If the user account 
  5286.       exists on the external domain, the password should be identical to that 
  5287.       on the logon domain. 
  5288.  
  5289.       DBCS Note  The following sentence does not apply to DBCS systems. 
  5290.  
  5291.       In order for a PC LAN Program user to access an OS/2 Warp Server or LAN 
  5292.       Server resource, the user's machine ID should be defined as a user ID on 
  5293.       the OS/2 Warp Server or LAN Server domain. 
  5294.  
  5295.      The user ID should be given the requested access permission on the other 
  5296.       domain. 
  5297.  
  5298.      Modify the 40th digit position of the IBMLAN.INI file wrkheuristics 
  5299.       (called othdomains) with an ascii editor.  Up to four other domains can 
  5300.       "know you", your user ID and passwords.  Use the same password in all 
  5301.       domains.  For more information about othdomains, see Performance Tuning 
  5302.       or the command NET START REQUESTER in the Command Reference. 
  5303.  
  5304.  If you updated your othdomains there are three changes visible: 
  5305.  
  5306.    1. Inside the File and Print Client Resource Browser, there are more server 
  5307.       icons. 
  5308.  
  5309.    2. NET VIEW command shows more servers. 
  5310.  
  5311.    3. In LAN Server Administration there are more servers in the icon view. 
  5312.  
  5313.  
  5314. ΓòÉΓòÉΓòÉ 8.7. Examples ΓòÉΓòÉΓòÉ
  5315.  
  5316. The following examples for sharing a CD-ROM drive are provided here: 
  5317.  
  5318.      Example: Sharing a CD-ROM Drive 
  5319.  
  5320.      Example:  Sharing a Directory on a CD-ROM Using an Alias 
  5321.  
  5322.  
  5323. ΓòÉΓòÉΓòÉ 8.7.1. Example: Sharing a CD-ROM Drive ΓòÉΓòÉΓòÉ
  5324.  
  5325. The following example illustrates the steps required to share a CD-ROM drive on 
  5326. the network.  After completing this procedure, all CD-ROM directories installed 
  5327. on this drive are shared. 
  5328.  
  5329.  To share a CD-ROM drive by alias and create an access control profile for it: 
  5330.  
  5331.    1. Open  LAN Server Administration. 
  5332.  
  5333.    2. Open the domain in which you want to share the CD-ROM directory. 
  5334.  
  5335.       Domains are represented by castle icons.  The domain name is displayed 
  5336.       under each icon. 
  5337.  
  5338.    3. Open the appropriate Resource Definitions folder. 
  5339.  
  5340.    4. Drag the  Directory Template to an open area on the folder. The Identity 
  5341.       page is displayed. 
  5342.  
  5343.    5. Complete the fields on the Identity page as follows: 
  5344.  
  5345.           Alias Name:  CDDRIVE 
  5346.  
  5347.           Description:  Nickname identifying shared CD-ROM drive 
  5348.  
  5349.           Server:  SERVER1 
  5350.  
  5351.           Path:  D:\ 
  5352.  
  5353.           When Shared:  At Server Startup 
  5354.  
  5355.           Maximum concurrent connections:  Unlimited 
  5356.  
  5357.    6. Select  Create. 
  5358.  
  5359.           If there is no access control profile, a message is displayed 
  5360.            prompting you to create one. Select  OK to create the access 
  5361.            profile. 
  5362.  
  5363.            The Identity page of the Access Control Profile notebook is 
  5364.            displayed. 
  5365.  
  5366.           If there is an access profile, no message appears. The Identity page 
  5367.            of the Access Control Profile notebook is displayed. 
  5368.  
  5369.       Note:  Only an administrator can create an access control profile. The 
  5370.              administrator should give the P permission to operators or users 
  5371.              so that they can manage access to this resource. 
  5372.  
  5373.    7. Select the  Permissions tab. 
  5374.  
  5375.    8. Select  Add under the list on the left. 
  5376.  
  5377.       The Add Access Control Entries window is displayed.  Select the user IDs 
  5378.       or group IDs you want to access the drive.  Select the permissions you 
  5379.       want to grant to the users and groups you selected. 
  5380.  
  5381.    9. Select  OK. 
  5382.  
  5383.   10. Select  Create. 
  5384.  
  5385.       The access control profile for the drive is created. 
  5386.  
  5387.   11. Select  Cancel. 
  5388.  
  5389.  
  5390. ΓòÉΓòÉΓòÉ 8.7.2. Example:  Sharing a Directory on a CD-ROM Using an Alias ΓòÉΓòÉΓòÉ
  5391.  
  5392. The following example illustrates the steps required to share a directory on a 
  5393. single CD-ROM using an alias.  In this case, you must propagate the access 
  5394. control profiles in order for users to access all of the subdirectories on the 
  5395. CD-ROM directory. 
  5396.  
  5397. Note:  The term  propagate is synonymous with the term  apply used in versions 
  5398.        of LAN Server before LAN Server Version 4.0.  Because CD-ROM is 
  5399.        removable media, the alias applies only to the CD-ROM inserted at the 
  5400.        time the alias is created. 
  5401.  
  5402.   To create an alias for a CD-ROM directory: 
  5403.  
  5404.    1. Open  LAN Server Administration. 
  5405.  
  5406.    2. Open the domain in which you want to share the CD-ROM directory. 
  5407.  
  5408.       Domains are represented by castle icons.  The domain name is displayed 
  5409.       under each icon. 
  5410.  
  5411.    3. Open the appropriate Resource Definitions folder. 
  5412.  
  5413.    4. Drag the  Directory Template to an open area on the folder. The Identity 
  5414.       page of the notebook is displayed. 
  5415.  
  5416.    5. Complete the fields on the Identity page as follows: 
  5417.  
  5418.           Alias Name:  CDDIR 
  5419.  
  5420.           Description:  Nickname identifying shared CD-ROM directory 
  5421.  
  5422.           Server:  SERVER1 
  5423.  
  5424.           Path:  D:\ directory 
  5425.  
  5426.            where directory is the directory path. 
  5427.  
  5428.           When Shared:  At Server Startup 
  5429.  
  5430.           Maximum concurrent connections:  Unlimited 
  5431.  
  5432.    6. Select  Create. 
  5433.  
  5434.       Note:  If you are creating a directory alias and you specified a drive 
  5435.              letter followed by a colon and a backslash (for example, F:\), a 
  5436.              window is displayed requiring you to specify whether the access 
  5437.              control profile is for the entire drive or for the root directory 
  5438.              on the drive.  This is an important consideration for removable 
  5439.              media such as a CD-ROM, which should have the access control 
  5440.              profile specified on the drive.  Select  On drive or  On 
  5441.              directory, and then select  OK. 
  5442.  
  5443.           If there is no access control profile, a message is displayed 
  5444.            prompting you to create one. Select  OK to create the access 
  5445.            profile. 
  5446.  
  5447.            The Access Control Profile notebook is displayed. 
  5448.  
  5449.           If there is an access profile, no message appears. The Access 
  5450.            Control Profile notebook is displayed.  See  Defining Access Control 
  5451.       Profiles for information about access control profiles. 
  5452.  
  5453.    7. Select the  Permissions tab. 
  5454.  
  5455.    8. Select  Add under the list box. 
  5456.  
  5457.       The Add Access Control Entries window is displayed. 
  5458.  
  5459.    9. Select the user IDs or group IDs you want to access the CD-ROM directory. 
  5460.       Select the permissions you want to grant the users and groups you 
  5461.       selected. 
  5462.  
  5463.   10. Select  OK. 
  5464.  
  5465.   11. Select  Create or  Set. 
  5466.  
  5467.       A message is displayed prompting you to specify whether to propagate the 
  5468.       access control profile permissions to all the subdirectories in the path. 
  5469.       See Propagating Access Control Profiles to Subdirectories for information 
  5470.       on propagating (applying) an access control profile to subdirectories. 
  5471.  
  5472.   12. Select  OK if you want your users to access all the subdirectories of the 
  5473.       directory you have shared. 
  5474.  
  5475.       Select  Cancel to give users access to only the directory you have 
  5476.       shared; users can only access files in the indicated directory of the 
  5477.       CD-ROM.  You can propagate access to the other subdirectories at a later 
  5478.       time. 
  5479.  
  5480.       The alias (CDDIR) is created, the CD-ROM directory is shared, and the 
  5481.       access control profile is created.  An icon representing the alias is 
  5482.       added to the Resource Definitions object in the domain. 
  5483.  
  5484.  
  5485. ΓòÉΓòÉΓòÉ 9. Defining Access Control Profiles ΓòÉΓòÉΓòÉ
  5486.  
  5487. This chapter describes access control for resources accessed remotely on the 
  5488. LAN. As the network administrator, you are responsible for network security. 
  5489. Access control allows you to manage user access to network resources. In order 
  5490. to use the security features of OS/2 Warp Server or LAN Server, it is strongly 
  5491. recommended that your ID (as administrator) be defined as requiring a password. 
  5492. Administrators are not subject to access control. 
  5493.  
  5494. Note:  There are differences between the behavior of the access control system 
  5495.        used in the HPFS and JFS and that used in the 386 HPFS. These 
  5496.        differences are noted throughout the chapter. 
  5497.  
  5498.  All resources accessed from the network must have a set of permission rules 
  5499.  defined for them. You can permit use of a resource by assigning access 
  5500.  permissions to particular users or groups. When you create an access control 
  5501.  profile for a resource, you can optionally set up an audit log to record 
  5502.  access attempts to that resource. 
  5503.  
  5504.  You can protect the following: 
  5505.  
  5506.      Directories (including files and subdirectories if the path exists) 
  5507.  
  5508.      Printer spooler queues 
  5509.  
  5510.      Serial device queues 
  5511.  
  5512.      Printers 
  5513.  
  5514.      Drives 
  5515.  
  5516.      Files 
  5517.  
  5518.      Named pipes.  Named pipes allow two programs to communicate with each 
  5519.       other.  They are treated as directory resources. Named pipes must be 
  5520.       preceded by \PIPE\. 
  5521.  
  5522.  For more information, see the following topics: 
  5523.  
  5524.      Access Control Profiles 
  5525.  
  5526.      How Access Permissions Are Processed 
  5527.  
  5528.      Access Control Profile Example 
  5529.  
  5530.      Propagating Access Control Profiles to Subdirectories 
  5531.  
  5532.      Procedures for Managing Access Control Profiles 
  5533.  
  5534.      Default Access Control Profiles on Servers 
  5535.  
  5536.      CD-ROM Devices and Access Control Profiles 
  5537.  
  5538.  
  5539. ΓòÉΓòÉΓòÉ 9.1. Access Control Profiles ΓòÉΓòÉΓòÉ
  5540.  
  5541. Each protected resource has an  access control profile. When you protect a 
  5542. resource, you define the users and groups who have access to the resource and 
  5543. their permissions. 
  5544.  
  5545. An access control profile for a resource is independent of the resource's alias 
  5546. or netname.  You can create an alias or netname for a resource, and then create 
  5547. an access control profile for it. 
  5548.  
  5549. Additional aliases for the same resource share the same access control profile. 
  5550. Modifying an access control profile for one alias modifies it for all aliases 
  5551. for the same resource. 
  5552.  
  5553. For more information, see the following topics: 
  5554.  
  5555.      Access Permissions 
  5556.  
  5557.      Profile Contents 
  5558.  
  5559.  
  5560. ΓòÉΓòÉΓòÉ 9.1.1. Access Permissions ΓòÉΓòÉΓòÉ
  5561.  
  5562. The following list defines the access permissions you can specify in an access 
  5563. control profile. 
  5564.  
  5565.   Permission          Meaning
  5566.  
  5567.  Delete (D)          Permits deleting subdirectories and files. 
  5568.  
  5569.  Attributes (A)      Permits changing of OS/2 file attributes, such as A 
  5570.                      (archive), R (read only), and related file information, 
  5571.                      such as the time and date the file was updated. Also, some 
  5572.                      applications may require attributes permission to copy 
  5573.                      files. 
  5574.  
  5575.  None (N)            Denies access to the resource. 
  5576.  
  5577.  Execute (X)         Permits only running (not copying) of program or command 
  5578.                      files, such as .EXE or .COM files. 
  5579.  
  5580.                      Note:  Besides execute permission, read permission is 
  5581.                             required for users to run .BAT files, .CMD files, 
  5582.                             and DOS applications. Because applications request 
  5583.                             read permission when they open a file for 
  5584.                             execution, provide read access permission for 
  5585.                             applications of this type. 
  5586.  
  5587.  Read (R)            Permits reading and running of files in a directory, and 
  5588.                      copying of files from a directory, but not writing to 
  5589.                      (modifying) them.  Lets users view file names in a shared 
  5590.                      directory.  Read used alone lets users view or run 
  5591.                      programs only. 
  5592.  
  5593.  Write (W)           Permits writing to (modifying) a directory resource in a 
  5594.                      shared directory.  Write used alone lets users modify 
  5595.                      files but not read, run, create, or delete them. In most 
  5596.                      cases, and always when editing files, use write with read 
  5597.                      permission. 
  5598.  
  5599.                      Directory resources with write (W) permission also need 
  5600.                      attributes (A) permission if they are used in applications 
  5601.                      that change file attributes. 
  5602.  
  5603.  Create (C)          Permits creating of subdirectories and files in a shared 
  5604.                      directory. Create used alone lets users create a file in a 
  5605.                      directory and modify the file during its creation. 
  5606.                      However, once a file is created and closed, the same user 
  5607.                      cannot modify it again. 
  5608.  
  5609.                      To write to a serial device, users must have both C and W 
  5610.                      permissions for the serial device. 
  5611.  
  5612.                      To create and send a print job to a printer, users must 
  5613.                      have C permission for the printer. 
  5614.  
  5615.                      To create a named pipe on a server, users must have C 
  5616.                      permission for named pipes. 
  5617.  
  5618.  Permissions (P)     Permits changing of resource access permissions, giving a 
  5619.                      user limited administrator authority over the resource. 
  5620.                      However, a user cannot create an access control profile. 
  5621.  
  5622.  These access permissions can be used in different combinations. However, not 
  5623.  all permissions can be used with all resource types, as shown in the following 
  5624.  table. When you create or update an access control profile, OS/2 Warp Server 
  5625.  or LAN Server accepts permissions applicable to that resource type. 
  5626.  
  5627.  Access Permissions Applicable to Resource Types 
  5628.  
  5629.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5630.   Γöéaccess       ΓöéFiles        ΓöéPrinters     ΓöéSerial       ΓöéNamed Pipes  Γöé
  5631.   Γöépermission   Γöé             Γöé             ΓöéDevices      Γöé             Γöé
  5632.   Γöéaccess       Γöé             Γöé             Γöé             Γöé             Γöé
  5633.   Γöépermission   Γöé             Γöé             Γöé             Γöé             Γöé
  5634.   Γöéaccess       Γöé             Γöé             Γöé             Γöé             Γöé
  5635.   Γöépermission   Γöé             Γöé             Γöé             Γöé             Γöé
  5636.   Γöéaccess       Γöé             Γöé             Γöé             Γöé             Γöé
  5637.   Γöépermission   Γöé             Γöé             Γöé             Γöé             Γöé
  5638.   ΓöéPermission   Γöé             Γöé             Γöé             Γöé             Γöé
  5639.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5640.   ΓöéNone (N)     ΓöéX            ΓöéX            ΓöéX            ΓöéX            Γöé
  5641.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5642.   ΓöéExecute (X)  ΓöéX            Γöé             Γöé             Γöé             Γöé
  5643.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5644.   ΓöéRead (R)     ΓöéX            Γöé             ΓöéX            ΓöéX            Γöé
  5645.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5646.   ΓöéWrite (W)    ΓöéX            Γöé             ΓöéX            ΓöéX            Γöé
  5647.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5648.   ΓöéCreate (C)   ΓöéX            ΓöéX            ΓöéX            ΓöéX            Γöé
  5649.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5650.   ΓöéDelete (D)   ΓöéX            Γöé             Γöé             Γöé             Γöé
  5651.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5652.   ΓöéAttributes   ΓöéX            Γöé             Γöé             Γöé             Γöé
  5653.   Γöé(A)          Γöé             Γöé             Γöé             Γöé             Γöé
  5654.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5655.   ΓöéPermissions  ΓöéX            ΓöéX            ΓöéX            ΓöéX            Γöé
  5656.   Γöé(P)          Γöé             Γöé             Γöé             Γöé             Γöé
  5657.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5658.  
  5659.  
  5660. ΓòÉΓòÉΓòÉ 9.1.2. Profile Contents ΓòÉΓòÉΓòÉ
  5661.  
  5662. An access control profile for a resource can contain the following information: 
  5663.  
  5664.      Descriptions of individual users and their access permissions, including: 
  5665.  
  5666.         -  User ID or group ID 
  5667.  
  5668.         -  Access permissions 
  5669.  
  5670.       Note:  The user accounts system defines a default group named GROUPID. 
  5671.              It can be used as any other group, or it can be deleted. 
  5672.  
  5673.      Recording of access attempts in the audit log. The audit log flag 
  5674.       controls whether audit log records are written for accesses to the 
  5675.       resource.  The flag can have the following values: 
  5676.  
  5677.       None                     Do not write records. 
  5678.  
  5679.       All                      Write records for all accesses to the resource. 
  5680.  
  5681.       Failures                 Write records only for failed accesses. 
  5682.  
  5683.       Successes                Write records only for successful accesses. 
  5684.  
  5685.       For more information, see  Auditing. 
  5686.  
  5687.  Note:  An access control profile is limited to 64 entries of users or groups 
  5688.         of users. Therefore, users with similar access permission requirements 
  5689.         should be put into groups. 
  5690.  
  5691.  
  5692. ΓòÉΓòÉΓòÉ 9.2. How Access Permissions Are Processed ΓòÉΓòÉΓòÉ
  5693.  
  5694. Administrators are automatically granted all permissions by OS/2 Warp Server or 
  5695. LAN Server and are not subject to access control processing. For all other 
  5696. users, OS/2 Warp Server or LAN Server denies access to a resource unless you 
  5697. specifically grant access for a user ID or its corresponding group IDs. When a 
  5698. user attempts to use a resource, OS/2 Warp Server or LAN Server searches for 
  5699. that user ID in the resource's access control profile, checking first the user 
  5700. access profile and then the group access profile. The following steps describe 
  5701. the search procedure: 
  5702.  
  5703.    1. The program first checks to see if the user ID is profiled in the user 
  5704.       access profile and, if so, what permissions are given to that user. 
  5705.  
  5706.           If the user ID is profiled and the requested permissions are 
  5707.            included, the user gains access. 
  5708.  
  5709.           If the user ID is profiled and the requested permissions are not 
  5710.            included, access is denied.  No further checking for access 
  5711.            permissions is done. That is, the program does not go on to check 
  5712.            the group access profile. 
  5713.  
  5714.           If the user ID is not profiled, the program checks the group access 
  5715.            profile.  See step 2. 
  5716.  
  5717.    2. The program checks to see if the user belongs to any of the groups 
  5718.       profiled in the group access profile and, if so, what access permissions 
  5719.       are given to those groups. 
  5720.  
  5721.           All users are members of the group USERS. 
  5722.  
  5723.           If the requested permissions are included in the sum of the group 
  5724.            access profile permissions, the user gains access. For example, if a 
  5725.            user belongs to a group with W and A permissions, and the group 
  5726.            USERS has R, W, C, and P permissions, the sum of the group access 
  5727.            profile permissions is R, W, A, C, and P. 
  5728.  
  5729.           If the requested permissions are  not included in the sum of the 
  5730.            group access profile permissions, access is denied. 
  5731.  
  5732.  See  Access Control Profile Example for an illustration of how this works. 
  5733.  
  5734.  For more information, see the following topics: 
  5735.  
  5736.      Access Control Profile Searching 
  5737.  
  5738.      Denying Access to a Directory Resource 
  5739.  
  5740.  
  5741. ΓòÉΓòÉΓòÉ 9.2.1. Access Control Profile Searching ΓòÉΓòÉΓòÉ
  5742.  
  5743. The search for an access control profile proceeds in the following order: 
  5744.  
  5745.    1. Resource the user is trying to access 
  5746.  
  5747.    2. Directory of that resource (only applies to files) 
  5748.  
  5749.    3. Root (default permission) for that disk partition or resource type 
  5750.  
  5751.       Note: 
  5752.  
  5753.        Specify the drive (C:) to give default permissions to all files in all 
  5754.       subdirectories. Specify the directory (C:\) to give access only to files 
  5755.       in the root subdirectory. 
  5756.  
  5757.       For spooler queues, the root is \PRINT. For serial device queues, the 
  5758.       root is \COMM. For named pipes, the root is \PIPE. 
  5759.  
  5760.  Once the program finds an access control profile, permissions are processed as 
  5761.  described in How Access Permissions Are Processed, and the user may or may not 
  5762.  gain access. The search does not continue once a profile is found at any of 
  5763.  these three places. 
  5764.  
  5765.  For example, suppose a user tries accessing directory resource 
  5766.  C:\SUBDIR\FILE.ONE. If there is an access control profile for the resource 
  5767.  (FILE.ONE), the search stops and permissions in that profile are used.  If no 
  5768.  profile is found, the program checks whether there is a profile for the 
  5769.  current directory, C:\SUBDIR.  If there is a profile for the current 
  5770.  directory, it is used. If a profile is not found, the program goes on to the 
  5771.  root, C:\. If there is a profile for C:\, those permissions are used. If there 
  5772.  is no profile at any of these three levels, the user is denied access. 
  5773.  
  5774.  Note:  Access control checking for named pipes is handled in the same way as 
  5775.         directory resources.  The resource is checked first, the directory is 
  5776.         checked second, and the root is checked last. 
  5777.  
  5778.  
  5779. ΓòÉΓòÉΓòÉ 9.2.2. Denying Access to a Directory Resource ΓòÉΓòÉΓòÉ
  5780.  
  5781. Because of the search process described in  Access Control Profile Searching, a 
  5782. user might be able to gain access to a resource even if no profile exists for 
  5783. that resource. OS/2 Warp Server or LAN Server searches for the existence of an 
  5784. access control profile for that resource, then it searches for the parent, and 
  5785. then it searches for the root. If a profile exists and the user is listed in 
  5786. the access control profile, or if the permissions for the USERS group value is 
  5787. any value but none (N), the user has the access permissions specified. 
  5788.  
  5789. To make sure a user has no access to a directory resource, create an access 
  5790. control profile for the resource, and specify N permission for that user ID in 
  5791. the user access profile. Access control should be done by group to ensure that 
  5792. the user is not in a group that has access.  Delete any occurrences of the user 
  5793. ID in the profile.  You only have to specify N if the user is a member of a 
  5794. group that has access and if you cannot delete that user from the group. The 
  5795. USERS group should be used only for resources that are widely used. 
  5796.  
  5797.  
  5798. ΓòÉΓòÉΓòÉ 9.3. Access Control Profile Example ΓòÉΓòÉΓòÉ
  5799.  
  5800. Access Control Profile Example shows a directory structure and the access 
  5801. control permissions for resources in the directory. The highlighted directories 
  5802. and files are those protected by access control profiles. Permissions included 
  5803. in the access control profiles are shown to the right of the protected 
  5804. resource.  User KIM belongs to the group ACCTGRP. 
  5805.  
  5806.  
  5807. Access Control Profile Example
  5808.  
  5809. Given the directory structure and permissions in the previous figure: 
  5810.  
  5811.      If user KIM tries to edit the file EMPLOYEE.TXT, an error occurs because 
  5812.       the permission at the current directory C:\EXMP allows only read access. 
  5813.  
  5814.      If user KIM tries to create or delete a file in the directory SALES, the 
  5815.       operation succeeds because the combined group (ACCTGRP) permission and 
  5816.       permissions for USERS group gives KIM create and delete permissions. 
  5817.  
  5818.      If user KIM tries to edit the file TOTAL89.RPT, the operation succeeds 
  5819.       because KIM has write and read permissions at the current directory, 
  5820.       C:\EXMP\SALES\STATS. These permissions take precedence over none for 
  5821.       ACCTGRP, because the program checks the user access profile first. 
  5822.  
  5823.      If user KIM tries to copy the file LISTING.EXE, an error occurs because 
  5824.       KIM has only execute permission.  This permission takes precedence over 
  5825.       execute, read, and write permissions for ACCTGRP. 
  5826.  
  5827.  
  5828. ΓòÉΓòÉΓòÉ 9.4. Propagating Access Control Profiles to Subdirectories ΓòÉΓòÉΓòÉ
  5829.  
  5830. The following discussion pertains only to directory resources. 
  5831.  
  5832. After creating an access control profile for a directory resource, you can 
  5833. choose to  propagate the profile to the subdirectories of that resource. When 
  5834. you  propagate an access control profile for a directory, the permissions in 
  5835. that profile are used as a template propagating to all subdirectories beneath 
  5836. the directory. If an access control profile already exists for a subdirectory 
  5837. (or for any files in a subdirectory), it is overwritten with the permissions in 
  5838. the template profile. The existing profile's audit log setting is not modified 
  5839. by the propagate function. If an access control profile does not already exist 
  5840. for a subdirectory, a profile with the same permissions and audit log setting 
  5841. as the template profile is created. A profile is not created for a file that 
  5842. currently has no profile. 
  5843.  
  5844. The propagate function makes sure all profiles in the directory and 
  5845. subdirectories contain only the permissions of the specified source profile. 
  5846.  
  5847. Only administrators can propagate an access control profile. 
  5848.  
  5849. You should not propagate access control profiles to the directory resource that 
  5850. contains the IBMLAN directory:  \DCDB, \DOSLAN, \NETPROG, and \IBMLAN itself. 
  5851. Adhering to this rule prevents changes in the access control profiles of the 
  5852. subdirectories that could adversely affect your server. However, you can 
  5853. propagate access control profiles to users' home directories. 
  5854.  
  5855. Remember the following about using the propagate function with the IBMLAN 
  5856. directory: 
  5857.  
  5858.      You can propagate access control profiles to any subdirectories in the 
  5859.       IBMLAN directory whose names begin with the letters RPL. 
  5860.  
  5861.      If you propagate an access control profile to the root directory of the 
  5862.       drive where the IBMLAN directory resides, OS/2 Warp Server or LAN Server 
  5863.       skips the IBMLAN directory when altering access control profiles. 
  5864.  
  5865.  For more information, see the following topics: 
  5866.  
  5867.      Permissions Used when Propagate Is Not Used 
  5868.  
  5869.      Propagate Example 
  5870.  
  5871.  
  5872. ΓòÉΓòÉΓòÉ 9.4.1. Permissions Used when Propagate Is Not Used ΓòÉΓòÉΓòÉ
  5873.  
  5874. Propagating an access control profile is optional for administrators (users 
  5875. cannot propagate a profile). If you do not propagate an access control profile 
  5876. for a directory, it is used only for that directory and not copied to any 
  5877. subdirectories below the directory. 
  5878.  
  5879.  
  5880. ΓòÉΓòÉΓòÉ 9.4.2. Propagate Example ΓòÉΓòÉΓòÉ
  5881.  
  5882. Using the example shown in the previous figure, an access control profile is 
  5883. created for directory C:\EXMP with the following access permissions: 
  5884.  
  5885. KIM=R,W
  5886. TESTGRP=R
  5887. USERS=N
  5888.  
  5889. The list below shows the example results of propagating the C:\EXMP access 
  5890. control profile. 
  5891.  
  5892.  Files Resource      Result
  5893.  
  5894.  C:\EXMP             No change 
  5895.  
  5896.  C:\EXMP\SALES       Existing profile's permissions replaced 
  5897.  
  5898.  C:\EXMP\PAYROLL     Profile created 
  5899.  
  5900.  C:\EXMP\SALES\STATS Existing profile's permissions replaced 
  5901.  
  5902.  C:\EXMP\SALES\CUSTOMER Profile created 
  5903.  
  5904.  C:\EXMP\SALES\CUSTOMER\LISTING.EXE Existing profile's permissions replaced 
  5905.  
  5906.  C:\EXMP\PAYROLL\DEPT571 Profile created 
  5907.  
  5908.  C:\EXMP\PAYROLL\SALARY.LST Existing profile's permissions replaced 
  5909.  
  5910.  C:\EXMP\SALES\CUSTOMER\RETAIL.LST No change because no profile exists for this 
  5911.                      file 
  5912.  
  5913.  
  5914. ΓòÉΓòÉΓòÉ 9.5. Procedures for Managing Access Control Profiles ΓòÉΓòÉΓòÉ
  5915.  
  5916. This section contains procedures for managing access control profiles. 
  5917.  
  5918. For more information, see the following topics: 
  5919.  
  5920.      Creating an Access Control Profile 
  5921.  
  5922.      Updating an Access Control Profile 
  5923.  
  5924.      Deleting an Access Control Profile 
  5925.  
  5926.  
  5927. ΓòÉΓòÉΓòÉ 9.5.1. Creating an Access Control Profile ΓòÉΓòÉΓòÉ
  5928.  
  5929. There are two ways to create access control profiles: 
  5930.  
  5931.      Through LAN Server Administration, for resources with and without 
  5932.       aliases. This chapter describes the access control profile procedures 
  5933.       performed with LAN Server Administration. 
  5934.  
  5935.      At the OS/2 command prompt, using the NET ACCESS command. Refer to the 
  5936.       Command Reference. 
  5937.  
  5938.  There are two other ways that access control profiles can be applied to a 
  5939.  resource. These methods involve inheritance. 
  5940.  
  5941.      Using a redirected drive remotely. When you create a directory while in a 
  5942.       redirected drive, a new profile is created with the same permissions for 
  5943.       the new directory. 
  5944.  
  5945.      When you create a directory either locally or remotely on a 386 HPFS 
  5946.       server, the newly created directory inherits the access control profile 
  5947.       information of the parent directory. Because of the way the file 
  5948.       allocation table (FAT) works, you can inherit only a remotely created 
  5949.       directory's access control profile on a FAT file server. You must have 
  5950.       access to the access control profile on the server to be able to inherit 
  5951.       it.  You must be logged on with an ID that is allowed access to the 
  5952.       parent access control profile.  If successful, a new profile is created 
  5953.       with the same permissions as the parent of the new directory. 
  5954.  
  5955.       Inheritance is performed by the OS/2 Warp Server or LAN Server code. 
  5956.       When a directory is created locally at a server using the standard OS/2 
  5957.       file systems (FAT, HPFS, and JFS), the OS/2 Warp Server or LAN Server 
  5958.       code is not invoked and does not perform inheritance. 
  5959.  
  5960.       For information on what default access control profiles may already 
  5961.       exist, especially on servers with local security, see  Default Access 
  5962.       Control Profiles on Servers. 
  5963.  
  5964.  The following tasks also include how to create an access profile for users and 
  5965.  groups. 
  5966.  
  5967.  For more information, see the following topics: 
  5968.  
  5969.      Creating Access Control Profiles for Resources with Aliases 
  5970.  
  5971.      Creating Access Control Profiles for Resources without Aliases 
  5972.  
  5973.  Note:  Only an administrator can create an access control profile. The 
  5974.         administrator should give the P permission to operators or users so 
  5975.         that they can manage access to this resource. 
  5976.  
  5977.  
  5978. ΓòÉΓòÉΓòÉ 9.5.1.1. Creating Access Control Profiles for Resources with Aliases ΓòÉΓòÉΓòÉ
  5979.  
  5980. When you create an alias for a resource, you are prompted about whether to 
  5981. create an access control profile as well.  The following procedure is for 
  5982. creating both an alias and access control profile for the resource. 
  5983.  
  5984. Note:  Only one access control profile can exist for each resource, no matter 
  5985.        how many aliases that resource has. 
  5986.  
  5987.  If you created an alias for a resource without creating an access control 
  5988.  profile, use the procedure in  Updating Access Control Profiles for Resources 
  5989.  with Aliases to create the access control profile. 
  5990.  
  5991.  Creating an alias for a resource does not necessarily grant a user access to 
  5992.  that resource. An administrator must also give each user the appropriate 
  5993.  permissions. 
  5994.  
  5995.  To create an alias for a resource: 
  5996.  
  5997.    1. Open  LAN Server Administration. 
  5998.  
  5999.    2. Open the domain object in which you want to create the alias. 
  6000.  
  6001.    3. Open the appropriate Resource Definitions folder. 
  6002.  
  6003.    4. Drag the template for the type of alias object you want to create to a 
  6004.       convenient location in the folder. 
  6005.  
  6006.       The templates are Printer Template, Directory Template, and Serial Device 
  6007.       Template. 
  6008.  
  6009.       The appropriate alias notebook is displayed. 
  6010.  
  6011.    5. Type an alias name in the  Alias field. 
  6012.  
  6013.    6. Optional: type a description in the  Description field. 
  6014.  
  6015.    7. Select or type a server name: 
  6016.  
  6017.         a. If the server where the resource is located is in this domain, 
  6018.            select one of the server names in the  Server name list. 
  6019.  
  6020.         b. If the server where the resource is located is in another domain, 
  6021.            type the name of that server in the  Server name field. 
  6022.  
  6023.    8. Complete the other fields on the Identity page. 
  6024.  
  6025.       Note:  If you create more than two serial device aliases, you should 
  6026.              increase the values of the  maxchdevq and maxchdevs parameters in 
  6027.              the IBMLAN.INI file. 
  6028.  
  6029.    9. Select  Create. 
  6030.  
  6031.       Note:  If you are creating a directory alias and you specified a drive 
  6032.              letter followed by a colon and a backslash (for example, F:\), a 
  6033.              window is displayed requiring you to specify whether the access 
  6034.              control profile is for the entire drive or for the root directory 
  6035.              on the drive.  This is an important consideration for removable 
  6036.              media such as a CD-ROM, which should have the access control 
  6037.              profile specified on the drive.  Select  On drive or  On 
  6038.              directory, and then select  OK. 
  6039.  
  6040.           If there is no access control profile, a message is displayed 
  6041.            prompting you to create one. Select  OK to create the access 
  6042.            profile. 
  6043.  
  6044.            The Access Control Profile notebook is displayed. 
  6045.  
  6046.           If there is an access profile, no message appears. The Access 
  6047.            Control Profile notebook is displayed. 
  6048.  
  6049.   10. Complete the pages in the Access Control Profile notebook. 
  6050.  
  6051.   11. Select  Create or  Set to close the notebook. 
  6052.  
  6053.       If it is a directory alias, a message is displayed prompting you whether 
  6054.       to propagate the access permissions to all subdirectories in the path. 
  6055.       See Propagating Access Control Profiles to Subdirectories for information 
  6056.       about propagating (applying) an access profile to subdirectories. 
  6057.  
  6058.   12. Select  OK to propagate access to all the subdirectories in the path, 
  6059.       giving users Read (R), Write (W), and Create (C) access to the entire 
  6060.       program directory tree. 
  6061.  
  6062.       The alias is created, the resource is shared, and the access control 
  6063.       profile is created.  An icon representing the alias is added to the 
  6064.       Resource Definitions object in the domain. 
  6065.  
  6066.  
  6067. ΓòÉΓòÉΓòÉ 9.5.1.2. Creating Access Control Profiles for Resources without Aliases ΓòÉΓòÉΓòÉ
  6068.  
  6069. Use the following steps to grant access permissions for resources that do not 
  6070. have aliases. 
  6071.  
  6072. To create an access control profile for a shared resource not identified by an 
  6073. alias: 
  6074.  
  6075.    1. Open  LAN Server Administration. 
  6076.  
  6077.    2. Open the appropriate domain object. 
  6078.  
  6079.    3. Open  Defined Servers. 
  6080.  
  6081.    4. With mouse button 2, select the appropriate server object. 
  6082.  
  6083.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  6084.  
  6085.    6. Select the arrow to the right of  Current shares. 
  6086.  
  6087.    7. Select the type of resource you want to start or stop sharing: 
  6088.  
  6089.           Directories 
  6090.  
  6091.           Printers 
  6092.  
  6093.           Serial devices 
  6094.  
  6095.       The Current Shares window is displayed.  It includes a list of resources 
  6096.       defined on the domain for this server as network resources currently 
  6097.       shared. 
  6098.  
  6099.    8. Select  Share another. 
  6100.  
  6101.    9. Type a unique netname in the  Netname field. 
  6102.  
  6103.   10. Complete the remaining fields. 
  6104.  
  6105.   11. Select  OK. 
  6106.  
  6107.   12. If you want to create or revise an access control profile for this 
  6108.       resource, select it from the list and then select  Manage access in the 
  6109.       Current Shares window. 
  6110.  
  6111.       Directory resources require an access control profile before users can 
  6112.       use them. 
  6113.  
  6114.           If there is no access control profile, a message is displayed 
  6115.            prompting you to create one. Select  OK to create the access 
  6116.            profile. 
  6117.  
  6118.            The Identity page of the Access Control Profile notebook is 
  6119.            displayed. 
  6120.  
  6121.           If there is an access profile, no message appears. The Identity page 
  6122.            of the Access Control Profile notebook is displayed. 
  6123.  
  6124.       An access control profile can be inherited automatically if the directory 
  6125.       resource is either created remotely or resides on an HPFS or JFS drive 
  6126.       and the 386 HPFS is installed on the server.  Even if an access profile 
  6127.       is inherited, you may still need to modify the permissions. If the alias 
  6128.       is a directory alias, a message is displayed to determine if you want to 
  6129.       propagate the access down the directory tree. Directory resources require 
  6130.       an access control profile before users can use them. 
  6131.  
  6132.       The Access Control Profile notebook is displayed.  It provides 
  6133.       information about the name of the access control profile. 
  6134.  
  6135.   13. Select the  Permissions tab. 
  6136.  
  6137.       The Permissions page is displayed.  It displays the current access 
  6138.       permissions for this resource. 
  6139.  
  6140.   14. Select  Add. 
  6141.  
  6142.       The Add Access Control Entries window is displayed. 
  6143.  
  6144.   15. Select the names of the user IDs and groups that you want to give access 
  6145.       to this resource. 
  6146.  
  6147.   16. Select the permissions to give them. 
  6148.  
  6149.   17. Select  OK. 
  6150.  
  6151.   18. Select  Set or  Create to close the Access Control Profile notebook. 
  6152.  
  6153.       If you are giving access to a directory resource, the Propagate Access 
  6154.       Profile to Subdirectories message is displayed. 
  6155.  
  6156.   19. If you want to propagate this access control profile to this resource to 
  6157.       all subdirectories, select  OK.  If not, select Cancel. 
  6158.  
  6159.   20. Select  Close to close the Current Shares window. 
  6160.  
  6161.  
  6162. ΓòÉΓòÉΓòÉ 9.5.2. Updating an Access Control Profile ΓòÉΓòÉΓòÉ
  6163.  
  6164. The following are two ways to update an access control profile: 
  6165.  
  6166.      At the OS/2 command prompt, using the NET ACCESS command. Refer to the 
  6167.       Command Reference. 
  6168.  
  6169.      Through LAN Server Administration, for resources with and without 
  6170.       aliases.  The following information describes this method. 
  6171.  
  6172.  If you rename a directory, you must manually delete and recreate any access 
  6173.  control profiles for subdirectories under the directory.  Renaming a directory 
  6174.  in the HPFS, FAT, or JFS file system does not automatically update access 
  6175.  control profiles for the subdirectories. The 386 HPFS access control profiles 
  6176.  remain with the renamed directory. 
  6177.  
  6178.  Note:  Only an administrator or an operator or user with P permission can 
  6179.         modify an access control profile. 
  6180.  
  6181.  For more information, see the following topics: 
  6182.  
  6183.      Updating Access Control Profiles for Resources with Aliases 
  6184.  
  6185.      Resources without Aliases 
  6186.  
  6187.  
  6188. ΓòÉΓòÉΓòÉ 9.5.2.1. Updating Access Control Profiles for Resources with Aliases ΓòÉΓòÉΓòÉ
  6189.  
  6190. Use the following procedure for resources with aliases. 
  6191.  
  6192. To update an access control profile for a resource identified by an alias: 
  6193.  
  6194.    1. Open  LAN Server Administration. 
  6195.  
  6196.    2. Open the domain object in which you want to update the access control 
  6197.       profile. 
  6198.  
  6199.    3. Open the appropriate Resource Definitions folder. 
  6200.  
  6201.    4. With mouse button 2, select the appropriate alias object. 
  6202.  
  6203.    5. From the pop-up menu, select  Manage access. 
  6204.  
  6205.       Note:  If you create more than two serial device aliases, you should 
  6206.              increase the values of the  maxchdevq and maxchdevs parameters in 
  6207.              the IBMLAN.INI file. 
  6208.  
  6209.       The Access Control Profile notebook is displayed.  It provides 
  6210.       information about the name of the access control profile. 
  6211.  
  6212.    6. If you want to update access permissions, select the Permissions tab. 
  6213.  
  6214.       You can add user or group IDs, change permissions for an entry, and 
  6215.       remove an entry: 
  6216.  
  6217.           To add user or group IDs: 
  6218.  
  6219.              a. Select  Add. 
  6220.  
  6221.              b. Select one or more names and their permissions. 
  6222.  
  6223.              c. Select  OK. 
  6224.  
  6225.           To change permissions: 
  6226.  
  6227.              a. Select the name of the user or group for which you want to 
  6228.                 change access permissions. 
  6229.  
  6230.              b. As appropriate for your needs, select Replace,  Add, or 
  6231.                 Remove. 
  6232.  
  6233.              c. In the  Change Permissions list, select the permissions you 
  6234.                 want to substitute, add, or remove. Select  Refresh if you want 
  6235.                 to undo your selections. 
  6236.  
  6237.              d. Select  Change. 
  6238.  
  6239.           To remove user or group IDs from the access control profile: 
  6240.  
  6241.              a. Select one or more names from the list. 
  6242.  
  6243.              b. Select  Remove. 
  6244.  
  6245.              c. Select  OK on the confirmation window. 
  6246.  
  6247.    7. If you want to change the auditing for this access control profile: 
  6248.  
  6249.         a. Select the  Auditing tab. 
  6250.  
  6251.         b. Select one of the audit levels. 
  6252.  
  6253.    8. Select  Set. 
  6254.  
  6255.  
  6256. ΓòÉΓòÉΓòÉ 9.5.2.2. Resources without Aliases ΓòÉΓòÉΓòÉ
  6257.  
  6258. Use the following procedure for resources without aliases. 
  6259.  
  6260. To update an access control profile of a resource not identified by an alias: 
  6261.  
  6262.    1. Open  LAN Server Administration. 
  6263.  
  6264.    2. Open the appropriate domain object. 
  6265.  
  6266.    3. Open  Defined Servers. 
  6267.  
  6268.    4. With mouse button 2, select the appropriate server object. 
  6269.  
  6270.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  6271.  
  6272.    6. Select the arrow to the right of  Current shares. 
  6273.  
  6274.    7. Select the type of resource you want to start or stop sharing: 
  6275.  
  6276.           Directories 
  6277.  
  6278.           Printers 
  6279.  
  6280.           Serial devices 
  6281.  
  6282.       A Current Shares window is displayed.  It includes a list of resources 
  6283.       defined on the domain for this server as network resources currently 
  6284.       shared. 
  6285.  
  6286.    8. Select the resource for which you want to update access control. 
  6287.  
  6288.    9. Select  Manage access. 
  6289.  
  6290.       Note:  If you create more than two serial device aliases, increase the 
  6291.              values of the maxchdevq and maxchdevs parameters in the IBMLAN.INI 
  6292.              file. 
  6293.  
  6294.       The Access Control Profile notebook is displayed.  It provides 
  6295.       information about the name of the access control profile. 
  6296.  
  6297.   10. If you want to update access permissions, select the Permissions tab. 
  6298.  
  6299.       You can add user or group IDs, change permissions for an entry, and 
  6300.       remove an entry: 
  6301.  
  6302.           To add user or group IDs: 
  6303.  
  6304.              a. Select  Add. 
  6305.  
  6306.              b. Select one or more names and their permissions. 
  6307.  
  6308.              c. Select  OK. 
  6309.  
  6310.           To change permissions: 
  6311.  
  6312.              a. Select the name of the user or group for which you want to 
  6313.                 change access permissions. 
  6314.  
  6315.              b. As appropriate for your needs, select Replace,  Add, or 
  6316.                 Remove. 
  6317.  
  6318.              c. In the  Change Permissions list, select the permissions you 
  6319.                 want to substitute, add, or remove. Select  Refresh if you want 
  6320.                 to undo your selections. 
  6321.  
  6322.              d. Select  Change. 
  6323.  
  6324.           To remove user or group IDs from the access control profile: 
  6325.  
  6326.              a. Select one or more names from the list. 
  6327.  
  6328.              b. Select  Remove. 
  6329.  
  6330.              c. Select  OK on the confirmation window. 
  6331.  
  6332.   11. If you want to change the auditing for this access control profile: 
  6333.  
  6334.         a. Select the  Auditing tab. 
  6335.  
  6336.         b. Select one of the audit levels. 
  6337.  
  6338.   12. Select  Set. 
  6339.  
  6340.  
  6341. ΓòÉΓòÉΓòÉ 9.5.3. Deleting an Access Control Profile ΓòÉΓòÉΓòÉ
  6342.  
  6343. There are three ways to delete access control profiles: 
  6344.  
  6345.      At the OS/2 command prompt, using the NET ACCESS command. Refer to the 
  6346.       Command Reference. 
  6347.  
  6348.      Using a redirected drive.  When you delete a directory while in a 
  6349.       redirected drive, if the directory resource associated with the drive is 
  6350.       protected by a profile, the profile is also deleted. 
  6351.  
  6352.      Through LAN Server Administration, for resources with and without 
  6353.       aliases.  The following information describes this method. 
  6354.  
  6355.  If you delete a directory on a  local drive, the associated access control 
  6356.  profile is not deleted. However, if you delete a directory on a local 386 HPFS 
  6357.  drive, the access control profile is deleted.  If you delete the directory of 
  6358.  a  redirected drive, the access control profile is always deleted, whether it 
  6359.  is on a local 386 HPFS drive or not. Check the access control profiles on each 
  6360.  server periodically, and delete those that have no existing directory 
  6361.  resource. 
  6362.  
  6363.  Attention: After you delete an access control profile, you cannot recover it. 
  6364.  
  6365.  For more information, see the following topics: 
  6366.  
  6367.      Resources with Aliases 
  6368.  
  6369.      Resources without Aliases 
  6370.  
  6371.  
  6372. ΓòÉΓòÉΓòÉ 9.5.3.1. Resources with Aliases ΓòÉΓòÉΓòÉ
  6373.  
  6374. Use the next procedure to delete the access control profile for an alias. 
  6375.  
  6376. Regardless of how many aliases are defined for a resource, only one access 
  6377. control profile exists for a resource.  When you complete the following 
  6378. procedure, the access control profile for this resource (and consequently, for 
  6379. all its aliases) is deleted. 
  6380.  
  6381. To delete access control for an alias: 
  6382.  
  6383.    1. Open  LAN Server Administration. 
  6384.  
  6385.    2. Open the domain object for the aliased resource. 
  6386.  
  6387.    3. Open the appropriate Resource Definitions folder. 
  6388.  
  6389.    4. Open the appropriate alias object. 
  6390.  
  6391.       The alias notebook is displayed. 
  6392.  
  6393.    5. Select  Manage access. 
  6394.  
  6395.       The Access Control Profile notebook is displayed.  It provides 
  6396.       information about the name of the access control profile. 
  6397.  
  6398.    6. Select  Delete. 
  6399.  
  6400.  
  6401. ΓòÉΓòÉΓòÉ 9.5.3.2. Resources without Aliases ΓòÉΓòÉΓòÉ
  6402.  
  6403. You should periodically delete access control profiles for resources that are 
  6404. not identified by an alias to ensure that access profiles for nonexistent 
  6405. directories are deleted. If a directory resource (such as C:\TESTDIR1 on 
  6406. SERVER1) is protected by an access profile, and if that resource is deleted 
  6407. from the SERVER1 hard disk, the access control profile associated with that 
  6408. resource is not deleted. Use the following steps to delete the access control 
  6409. profiles associated with that resource.  The BACKACC and RESTACC utilities also 
  6410. can be used to delete access control profiles for nonexistent directories. 
  6411.  
  6412. To delete access control for a resource without an alias: 
  6413.  
  6414.    1. Open  LAN Server Administration. 
  6415.  
  6416.    2. Open the appropriate domain object. 
  6417.  
  6418.    3. Open  Defined Servers. 
  6419.  
  6420.    4. With mouse button 2, select the appropriate server object. 
  6421.  
  6422.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  6423.  
  6424.    6. Select the arrow to the right of  Current shares. 
  6425.  
  6426.    7. Select the type of resource you want to start or stop sharing: 
  6427.  
  6428.           Directories 
  6429.  
  6430.           Printers 
  6431.  
  6432.           Serial devices 
  6433.  
  6434.       The Current Shares window is displayed.  It includes a list of resources 
  6435.       defined on the domain for this resource as network resources currently 
  6436.       shared. 
  6437.  
  6438.    8. Select the resource for which you want to delete access control. 
  6439.  
  6440.    9. Select  Manage access. 
  6441.  
  6442.       The Access Control Profile notebook is displayed.  It provides 
  6443.       information about the name of the access control profile. 
  6444.  
  6445.   10. Select  Delete. 
  6446.  
  6447.  
  6448. ΓòÉΓòÉΓòÉ 9.6. Default Access Control Profiles on Servers ΓòÉΓòÉΓòÉ
  6449.  
  6450. The following profiles contain the default access control profiles for servers. 
  6451. These access control profiles allow the server to operate properly while 
  6452. providing only minimal access to important files. Changing these access control 
  6453. profiles may affect such functions as server startup and user logon assignments 
  6454. and applications. 
  6455.  
  6456. In addition to providing default access control profiles on the server, an 
  6457. access control profile providing all permissions is assigned to each user who 
  6458. has a home directory.  The access control profile is added to the server and 
  6459. path assignment specified during the creation of the home directory. 
  6460.  
  6461. The default auditing controls for the profiles added by the Server and DLRinst 
  6462. services are set to log an audit record only in the event of failures.  You may 
  6463. want to change the auditing controls on the access control profiles to improve 
  6464. network monitoring and maintenance. 
  6465.  
  6466. The following access control profiles are the default profiles added at the 
  6467. domain controller when the Server service is started: 
  6468.  
  6469. d:\IBMLAN\DCDB          GUESTS:R  USERS:R
  6470. d:\IBMLAN\DCDB\APPS     GUESTS:R  USERS:R
  6471. d:\IBMLAN\DCDB\DATA     GUESTS:R  USERS:R
  6472. d:\IBMLAN\DCDB\DEVICES  GUESTS:R  USERS:R
  6473. d:\IBMLAN\DCDB\FILES    GUESTS:R  USERS:R
  6474. d:\IBMLAN\DCDB\LISTS    GUESTS:R  USERS:R
  6475. d:\IBMLAN\DCDB\PRINTERS GUESTS:R  USERS:R
  6476. d:\IBMLAN\NETPROG       GUESTS:R  USERS:R
  6477. d:\IBMLAN\BOOK          GUESTS:R  USERS:R
  6478.  
  6479. where  d is the drive where the IBMLAN directory is located. 
  6480.  
  6481. The following access control profiles are the default profiles added at all 
  6482. servers when the Server service is started: 
  6483.  
  6484. d:\IBMLAN\DOSLAN\NET   GUESTS:R   USERS:R
  6485. d:\IBMLAN\DOSLAN\DOS   GUESTS:R   USERS:R
  6486. d:\IBMLAN\DCDB\IMAGES  GUESTS:R   USERS:R
  6487. \PIPE\IBMLAN\SERVER.RNS               GUESTS:RW  USERS:RW
  6488.  
  6489. where  d is the drive where the IBMLAN directory is located. 
  6490.  
  6491. The following access control profiles are added at the domain controller when 
  6492. the DLRinst service is started: 
  6493.  
  6494. d:\IBMLAN\DOSLAN\DLRINST        GUESTS:R     USERS:R
  6495. d:\IBMLAN\DOSLAN\LSP            GUESTS:R     USERS:R
  6496. C:\PCLP13XS\BATCH               GUESTS:R     USERS:R
  6497. C:\PCLP13XS\LISTS               GUESTS:R     USERS:R
  6498. C:\PCLP13XS\USERS               GUESTS:RWCD  USERS:RWCD
  6499. C:\PCLP13XS\USERS\PCLP          GUESTS:R     USERS:R
  6500.  
  6501. DBCS Note  The preceding access control profiles do not propagate to DBCS 
  6502.            systems. For DBCS systems, the following access control profiles are 
  6503.            the default profiles added at all servers when the Server service is 
  6504.            started: 
  6505.  
  6506.                       d:\IBMLAN\DOSLAN\NET             GUESTS:R   USERS:R
  6507.                       d:\IBMLAN\DOSLAN\DOS             GUESTS:R   USERS:R
  6508.                       d:\IBMLAN\DCDB\IMAGES            GUESTS:R   USERS:R
  6509.                       -PIPE\IBMLAN\SERVER.RNS          GUESTS:RW  USERS:RW
  6510.  
  6511.  The NetLogon service on all servers adds an access control profile of USERS:RX 
  6512.  and ADMINS:RX for the path specified by the scripts parameter in the NetLogon 
  6513.  section of the IBMLAN.INI file. 
  6514.  
  6515.  The following access control profiles are added for each user's DCDB 
  6516.  directory: 
  6517.  
  6518.   d:\IBMLAN\DCDB\USERS\userid userid:RWCXDAP
  6519.   d:\IBMLAN\DCDB\USERS\userid\BATCH userid:RWCXDAP
  6520.  
  6521.  The following access control profiles are added to servers when the Server 
  6522.  service is started, the remote IPL service is installed, and GETRPL has been 
  6523.  run: 
  6524.  
  6525.   d:\IBMLAN\RPL  RPLGROUP:RX
  6526.   d:\IBMLAN\RPL\OS2  RPLGROUP:RX
  6527.   d:\IBMLAN\RPL\OS2\SYSTEM  RPLGROUP:RX
  6528.   d:\IBMLAN\RPL\IBMLAN  RPLGROUP:RX
  6529.   d:\IBMLAN\RPL\IBMLAN\NETLIB  RPLGROUP:RX
  6530.   d:\IBMLAN\RPL\IBMLAN\NETPROG  RPLGROUP:RX
  6531.   d:\IBMLAN\RPL\IBMLAN\SERVICES  RPLGROUP:RX
  6532.   d:\IBMLAN\RPL\IBMCOM  RPLGROUP:RX
  6533.   d:\IBMLAN\RPL\IBMCOM\DLL  RPLGROUP:RX
  6534.   d:\IBMLAN\RPL\IBMCOM\MACS  RPLGROUP:RX
  6535.   d:\IBMLAN\RPL\MUGLIB  RPLGROUP:RX
  6536.   d:\IBMLAN\RPL\DOS  RPLGROUP:RX
  6537.   d:\IBMLAN\RPL\FITS  RPLGROUP:RX
  6538.   d:\IBMLAN\RPLUSER
  6539.   d:\IBMLAN\RPLUSER\DEFALT20
  6540.   d:\IBMLAN\RPLUSER\DEFALT20\IBMCOM
  6541.   d:\IBMLAN\RPLUSER\DEFALT20\IBMLAN
  6542.   d:\IBMLAN\RPLUSER\DEFALT20\OS2
  6543.   d:\IBMLAN\RPLUSER\DEFALT20\OS2\SYSTEM
  6544.   d:\IBMLAN\RPLUSER\DEFALT20\SPOOL
  6545.   d:\IBMLAN\DICTIONA
  6546.  
  6547.  where  d is the drive where the IBMLAN directory is located. 
  6548.  
  6549.  The following access control profiles are added to servers when Local Security 
  6550.  is installed: 
  6551.  
  6552.   For all subdirectories specified           LOCAL:RX
  6553.   by the DPATH environment variable
  6554.   For all subdirectories specified           LOCAL:RX
  6555.   by the PATH environment variable
  6556.   For all subdirectories specified           LOCAL:RX
  6557.   by the LIBPATH variable in CONFIG.SYS
  6558.   For all subdirectories specified           LOCAL:RWX
  6559.   by the DESKTOP directory tree
  6560.   For all subdirectories specified           LOCAL:RX
  6561.   by the GLOSSARY environment variable
  6562.   For all subdirectories specified           LOCAL:RX
  6563.   by the BOOKSHELF environment variable
  6564.   For the file referenced                    LOCAL:RWX
  6565.   by the USER_INI environment variable
  6566.   For the file referenced                    LOCAL:RWX
  6567.   by the SYSTEM_INI environment variable
  6568.   For all subdirectories specified           LOCAL:RWXCD
  6569.   by the TMP environment variable
  6570.   For all subdirectories specified           LOCAL:RWXCD
  6571.   by the TEMP environment variable
  6572.   x:\                                        LOCAL:RX
  6573.   Other HPFS drive roots                     LOCAL:RX
  6574.   x:\OS2                                     LOCAL:RX
  6575.   x:\IBM386FS                                LOCAL:RX
  6576.   x:\OS2\INSTALL                             LOCAL:RX
  6577.   x:\OS2\HELP                                LOCAL:RX
  6578.  
  6579.  DBCS Note  The following access control profile is added only for DBCS 
  6580.             systems: 
  6581.  
  6582.                         x:\OS2\SYSDATA                             LOCAL:RWX
  6583.  
  6584.   x:\OS2\BOOK                                LOCAL:RX
  6585.   x:\OS2\DLL                                 LOCAL:RX
  6586.   x:\OS2\SYSTEM                              LOCAL:RX
  6587.   x:\SPOOL and subdirectories (queues)       LOCAL:RWXCDA
  6588.   x:\IBMCOM                                  LOCAL:RX
  6589.   d:\IBMLAN                                  LOCAL:RX
  6590.   d:\IBMLAN\BOOK                             LOCAL:RX
  6591.   d:\IBMLAN\ACCOUNTS                         LOCAL:RX
  6592.   d:\IBMLAN\LOGS                             LOCAL:RX
  6593.   d:\IBMLAN\ACCOUNTS\NET.ACC                 LOCAL:RWX
  6594.   d:\IBMLAN\ACCOUNTS\NETACC.BKP              LOCAL:NONE
  6595.   d:\IBMLAN\NETLIB                           LOCAL:RX
  6596.   d:\IBMLAN\NETPROG                          LOCAL:RX
  6597.   x:\IBM386FS\HPFS386.IFS                    LOCAL:NONE
  6598.   d:\IBMLAN\INSTALL                          LOCAL:NONE
  6599.   d:\IBMLAN\SERVICES                         LOCAL:RX
  6600.   x:\MUGLIB                                  LOCAL:RX
  6601.   x:\MUGLIB\ACCOUNTS                         LOCAL:RX
  6602.   x:\MUGLIB\DLL                              LOCAL:RX
  6603.   x:\OS2\MDOS\WINOS2\SYSTEM                  LOCAL:RX
  6604.   x:\OS2\MDOS\WINOS2\*.INI                   LOCAL:RWX
  6605.   x:\OS2\MDOS\WINOS2\*.GRP                   LOCAL:RWX
  6606.   x:\NOWHERE                                 LOCAL:RWX
  6607.  
  6608.  where  x is the drive from which OS/2 was started and d is the drive where the 
  6609.  subdirectory is located. 
  6610.  
  6611.  Notes: 
  6612.  
  6613.    1. The default access control profiles for Local Security permit the default 
  6614.       OS/2 Desktop to start for users and if no one is logged on.  If the 
  6615.       Desktop has been reconfigured, not all of the correct access control 
  6616.       profiles may have been created. If the Desktop cannot be started when no 
  6617.       one logs on, try logging on as an administrator.  Then verify that all of 
  6618.       the objects referred to during the Desktop initialization are displayed 
  6619.       correctly. 
  6620.  
  6621.    2. The DESKTOP and NOWHERE directory names may be different on other 
  6622.       machines.  For example, the OS/2 Desktop may have been renamed to 
  6623.       MYDESKTOP.  In this case, MYDESKTOP should have LOCAL:RWX access.  The 
  6624.       NOWHERE directory name is translated for different languages. 
  6625.  
  6626.  
  6627. ΓòÉΓòÉΓòÉ 9.7. CD-ROM Devices and Access Control Profiles ΓòÉΓòÉΓòÉ
  6628.  
  6629. OS/2 Warp Server or LAN Server periodically checks for the existence of a 
  6630. directory resource protected by an access control profile.  Therefore, it is 
  6631. important that you correctly define access control profiles for removable SCSI 
  6632. devices such as CD-ROM devices.  Otherwise, you may get a missing files message 
  6633. because the access control profile has filtered out unknown directories and 
  6634. files.  Users may not be able to access data on a CD-ROM between different 
  6635. media insertions. 
  6636.  
  6637. For example, if you use the IBM Enhanced CD-ROM II device locally on an IBM 
  6638. server as the I drive, ensure that the access control profile specifies the I 
  6639. drive, not the I directory, as the shared resource.  In this way, all files on 
  6640. any CD are available when shared over the LAN. Otherwise, only directories and 
  6641. files from the specific CD that was used when the access control profile was 
  6642. created are visible to LAN clients. In this case, you can issue the following 
  6643. command when logged on the LAN as an administrator: NET ACCESS I: /ADD 
  6644. USERS:RWCD 
  6645.  
  6646.  
  6647. ΓòÉΓòÉΓòÉ 10. Limiting Space within Directories on 386 HPFS Servers ΓòÉΓòÉΓòÉ
  6648.  
  6649. This chapter discusses directory limits, or disk space allocation, for use with 
  6650. the OS/2 Warp Server and LAN Server programs when running 386 HPFS. Directory 
  6651. limits provide management of disk space at the directory level on servers. 
  6652.  
  6653. The allocation scheme works in the same way as the partition of a logical 
  6654. drive.  When a directory tree is full, no user can append data to its files or 
  6655. create subdirectories within the tree.  For example, a limit of 100MB applied 
  6656. to the C:\IBMLAN directory allows only those requests for disk space that do 
  6657. not cause the usage count to exceed 100MB. 
  6658.  
  6659. This chapter also discusses a notification function, which you can use to set 
  6660. up alerts to notify selected users when a directory tree is either full or is 
  6661. nearing its maximum capacity. 
  6662.  
  6663. For more information, see the following topics: 
  6664.  
  6665.      Definition of Terms 
  6666.  
  6667.      How Directory Limits Work 
  6668.  
  6669.      Enabling Directory Limits on a 386 HPFS Volume 
  6670.  
  6671.      Limiting a Directory 
  6672.  
  6673.      Alerts for Directory Limits 
  6674.  
  6675.  
  6676. ΓòÉΓòÉΓòÉ 10.1. Definition of Terms ΓòÉΓòÉΓòÉ
  6677.  
  6678. This chapter contains the following specialized terms: 
  6679.  
  6680.  Available space     The amount of free disk space within a particular 
  6681.                      directory tree. The available space is the limit minus the 
  6682.                      usage count.  However, the available space for a directory 
  6683.                      tree can be affected by limits placed above the directory 
  6684.                      itself.  Consider this example: 
  6685.  
  6686.                          Root directory C:\ has a limit of 250MB.  Its usage 
  6687.                           count is 200MB. 
  6688.  
  6689.                          Directory C:\IBMLAN has a limit of 100MB.  Its usage 
  6690.                           count is 20MB. 
  6691.  
  6692.                          The available space for the root directory is 50MB, 
  6693.                           which is also the available space for the C:\IBMLAN 
  6694.                           directory because C:\ is in the same path as 
  6695.                           C:\IBMLAN. Without the limit on C:\, the available 
  6696.                           space at C:\IBMLAN is either 80MB or the free space 
  6697.                           of the drive, whichever is less. 
  6698.  
  6699.  Drive               A logical drive, used interchangeably with  volume. 
  6700.  
  6701.  Limit               A value, in kilobytes (KB), used to control the size of a 
  6702.                      directory tree. 
  6703.  
  6704.  Threshold alert     An alert generated when the size of a limited directory 
  6705.                      increases past a size threshold, a set percentage of the 
  6706.                      directory limit. 
  6707.  
  6708.  Threshold delay     The minimum amount of set time that must elapse before the 
  6709.                      crossing of the same or lower threshold (percentage of 
  6710.                      limit) can generate another threshold alert. 
  6711.  
  6712.  Usage count         The current size of the directory tree as specified in KB. 
  6713.  
  6714.  Volume              A logical drive, used interchangeably with  drive. 
  6715.  
  6716.  
  6717. ΓòÉΓòÉΓòÉ 10.2. How Directory Limits Work ΓòÉΓòÉΓòÉ
  6718.  
  6719. You apply directory limits only to directories, not to files. The limit you set 
  6720. on a directory applies to all users who have access to that directory.  No 
  6721. distinction is made between users. 
  6722.  
  6723. By combining directory limits with the access control profiles of OS/2 Warp 
  6724. Server or LAN Server, you can control both the access to a directory and the 
  6725. size of that directory. For example, you can give user JOE read, write, create, 
  6726. or delete access to the C:\IBMLAN\USERS\JOE directory and a limit of 20MB for 
  6727. his own use. 
  6728.  
  6729. The following topics include important principles of operation for directory 
  6730. limits. 
  6731.  
  6732.      Application, Hierarchy, and Number Rules 
  6733.  
  6734.      Independence 
  6735.  
  6736.      Privileged Processes Not Limited 
  6737.  
  6738.      Enabling and Removing 
  6739.  
  6740.      Obtaining Information 
  6741.  
  6742.      Tasks of Users and Administrators 
  6743.  
  6744.      What Disk Space Includes 
  6745.  
  6746.  
  6747. ΓòÉΓòÉΓòÉ 10.2.1. Application, Hierarchy, and Number Rules ΓòÉΓòÉΓòÉ
  6748.  
  6749. The following rules apply to directory limits: 
  6750.  
  6751.      You can apply limits only to directories, not to files. 
  6752.  
  6753.      Limits are hierarchical.  A limit on a directory controls the entire 
  6754.       subtree below the directory itself.  For example, a limit on the root 
  6755.       directory controls the whole drive. 
  6756.  
  6757.      You can place multiple limits within a path.  For example, you can place 
  6758.       a limit at the root directory and another at the C:\IBMLAN directory. 
  6759.  
  6760.  
  6761. ΓòÉΓòÉΓòÉ 10.2.2. Independence ΓòÉΓòÉΓòÉ
  6762.  
  6763. OS/2 Warp Server and LAN Server use directory limits when a request for disk 
  6764. space is received.  For a request to be granted, it must satisfy all the limits 
  6765. placed within its path.  What this means is that although directory limits can 
  6766. be set independently of each other, the limit set on a directory can also 
  6767. affect its subdirectory. 
  6768.  
  6769. For example, you can set a limit of 100MB at the C:\ directory and another 
  6770. limit of 120MB at the C:\IBMLAN directory.  In this example, although you set a 
  6771. limit of 120MB for the C:\IBMLAN directory, the size of that directory is also 
  6772. limited by the 100MB limit you set on its parent directory (C:\). 
  6773. Consequently, a disk space request larger than 100MB to the C:\IBMLAN directory 
  6774. would be denied. 
  6775.  
  6776.  
  6777. ΓòÉΓòÉΓòÉ 10.2.3. Privileged Processes Not Limited ΓòÉΓòÉΓòÉ
  6778.  
  6779. Limits are not enforced for privileged processes.  Privileged processes are: 
  6780.  
  6781.      All processes (local and from clients) initiated by an administrator. 
  6782.       That is, administrators are not subject to limits. 
  6783.  
  6784.      Privileged local processes when Local Security is installed. 
  6785.  
  6786.      All local processes when Local Security is not installed. 
  6787.  
  6788.  
  6789. ΓòÉΓòÉΓòÉ 10.2.4. Enabling and Removing ΓòÉΓòÉΓòÉ
  6790.  
  6791. Directory limits are part of 386 HPFS. You can enable this function on, or 
  6792. disable it from, any 386 HPFS drive. 
  6793.  
  6794. Note:  Previous versions of 386 HPFS and HPFS.IFS cannot access drives that 
  6795.        have directory limits enabled on them. You must create a new 386 HPFS 
  6796.        Startup diskette. For information on making utility/startup diskettes, 
  6797.        refer to the Command Reference. 
  6798.  
  6799.  
  6800. ΓòÉΓòÉΓòÉ 10.2.5. Obtaining Information ΓòÉΓòÉΓòÉ
  6801.  
  6802. You can obtain information about limits if you have access to the directory in 
  6803. which you are interested and you specify the DIR command on that directory to 
  6804. display its content.  If you do not have access, the contents of the directory 
  6805. are not displayed.  Because the DosQFSInfo( ) call is a volume-based API, the 
  6806. DIR command always reports the amount of free space on the drive.  It is not 
  6807. subject to directory limits. 
  6808.  
  6809.  
  6810. ΓòÉΓòÉΓòÉ 10.2.6. Tasks of Users and Administrators ΓòÉΓòÉΓòÉ
  6811.  
  6812. Users who are also administrators can modify directory limits at will. 
  6813.  
  6814. Users who are not administrators can manage the limit of a directory if they 
  6815. are given P permission on the parent of the target directory itself.  For 
  6816. example, assume that user ID JOHN has RWCDXAP permissions on the 
  6817. C:\IBMLAN\USERS\JOHN directory. JOHN can create the directory 
  6818. C:\IBMLAN\USERS\JOHN\PUBLIC and apply a limit of 15MB to it.  However, he 
  6819. cannot modify the limit placed on directory C:\IBMLAN\USERS\JOHN directory 
  6820. unless he has P permission for the C:\IBMLAN\USERS directory. John is still 
  6821. subject to directory limits because he is not an administrator. 
  6822.  
  6823. Consider the following scenario: 
  6824.  
  6825. The administrator creates a home directory for user ID MARY and gives MARY the 
  6826. permissions RWCDXAP permissions. With these permissions, MARY can control 
  6827. access by other user IDs to her home directory. 
  6828.  
  6829. The administrator also sets a limit of 100MB on the home directory. MARY can 
  6830. now administer her home directory for access control and disk usage.  MARY 
  6831. creates a directory called PUBLIC within her home directory, applies a limit of 
  6832. 20MB to it and, using the following command, gives unrestricted access to all 
  6833. user IDs: 
  6834.  
  6835. NET ACCESS homedir\PUBLIC /ADD GUESTS:RWCDAX
  6836.  
  6837. where  homedir is Mary's home directory. 
  6838.  
  6839. However, MARY cannot modify the limit (100MB) applied to the root of her home 
  6840. directory. 
  6841.  
  6842.  
  6843. ΓòÉΓòÉΓòÉ 10.2.7. What Disk Space Includes ΓòÉΓòÉΓòÉ
  6844.  
  6845. Disk space includes all space required to store data on disk.  Each directory 
  6846. requires disk space for both the data stored within the directory and the 
  6847. file-system instructions that manage the data.  For example, creating a new 
  6848. directory uses 2560 bytes because that much disk space is required to maintain 
  6849. a directory object.  Even an empty file (zero bytes) use 512 bytes of disk 
  6850. space.  If a directory has 10MB of free disk space, you cannot create a new 
  6851. 10MB file in that directory because the system requires extra space for 
  6852. directory management. 
  6853.  
  6854. In rare conditions, 386 HPFS does not account for certain file-system 
  6855. structures. These exceptions help 386 HPFS to maintain high performance and 
  6856. have minimal effect on the accounting mechanism. 
  6857.  
  6858. In certain cases, 386 HPFS allows a limit to be exceeded. These exception occur 
  6859. only when the directory has room for the data that must be written to disk but 
  6860. not for the required file-system structures. For example, consider a directory 
  6861. with 1024 bytes left.  A write request of 1024 bytes is made. However, the disk 
  6862. is so fragmented that a file-system structure requiring 512 bytes is needed to 
  6863. manage the data written to disk.  In this example, 386 HPFS allows the request 
  6864. to continue and updates the usage count of the directory to reflect the 
  6865. overflow. 386 HPFS denies subsequent requests for disk space. 
  6866.  
  6867.  
  6868. ΓòÉΓòÉΓòÉ 10.3. Enabling Directory Limits on a 386 HPFS Volume ΓòÉΓòÉΓòÉ
  6869.  
  6870. Directory limits, by default, are not activated on a particular volume. You can 
  6871. enable this function on a drive from LAN Server Administration, the command 
  6872. line, or the NetDASDCtl() application programming interface (API). However, 
  6873. before using any method, be aware of the following: 
  6874.  
  6875.      When you issue the ENABLE command, 386 HPFS first calculates the size of 
  6876.       each directory in the tree.  To accomplish this, 386 HPFS processes the 
  6877.       entire directory tree and the files contained within it. 
  6878.  
  6879.      If you are attempting to enable directory limits on the boot drive, the 
  6880.       process is only partially completed. 386 HPFS is not able to lock the 
  6881.       drive because OS/2 always keeps certain files open.  This failure also 
  6882.       can occur on other drives that have open files.  A shutdown of your 
  6883.       system followed by a restart completes the activation process. 
  6884.  
  6885.      If the CHKDSK command repairs a drive on which directory limits are 
  6886.       active, 386 HPFS recalculates the size of each directory.  This action is 
  6887.       necessary because the CHKDSK command, as part of its repair operation, 
  6888.       moves files and directories.  For example, it creates the FOUND.000 and 
  6889.       DIR0000.CHK files. 
  6890.  
  6891.      Drives on which directory limits are enabled are inaccessible to HPFS.IFS 
  6892.       and earlier versions of 386 HPFS (for example, LAN Server 2.0 and 3.0). 
  6893.       You must create a new startup 386 HPFS diskette if you choose to use this 
  6894.       function.  Otherwise, you cannot access these volumes when starting from 
  6895.       a diskette. 
  6896.  
  6897.  To enable directory limits on a volume: 
  6898.  
  6899.    1. Open  LAN Server Administration. 
  6900.  
  6901.    2. With mouse button 2, select the  Local Workstation. 
  6902.  
  6903.    3. From the pop-up menu, select the arrow to the right of  Open as. 
  6904.  
  6905.    4. Select  Current shares. 
  6906.  
  6907.    5. Select  Directories. 
  6908.  
  6909.       The Current Shares window is displayed.  It includes a list of directory 
  6910.       resources currently shared. 
  6911.  
  6912.    6. Select the resource for which you want to enable directory limits. 
  6913.  
  6914.    7. Select  Manage limits. 
  6915.  
  6916.    8. If directory limits have not been enabled for the resource you selected, 
  6917.       you are prompted whether you want to enable limits. Select  Yes. 
  6918.  
  6919.    9. If the drive you are attempting to enable is already being used by 
  6920.       another process, a message is displayed instructing you to restart your 
  6921.       workstation to complete the enabling process. After you restart your 
  6922.       workstation, go to Limiting a Directory. 
  6923.  
  6924.   10. If the drive you are trying to enable is not being used by another 
  6925.       process, the Directory Limits window is displayed. 
  6926.  
  6927.       Specify the limit for the selected directory. 
  6928.  
  6929.  Note:  You can also enable directory limits using the NET DASD command. For 
  6930.         more information, see the Command Reference. 
  6931.  
  6932.  To incorporate directory limits within your own applications, use the 
  6933.  NetDASDCtl() API provided.  For information on how to do this, see the 
  6934.  Programming Guide and Reference . 
  6935.  
  6936.  
  6937. ΓòÉΓòÉΓòÉ 10.4. Limiting a Directory ΓòÉΓòÉΓòÉ
  6938.  
  6939. After you have enabled directory limits on a volume, you can view or change 
  6940. limits to directories on that volume. The following steps are performed at the 
  6941. server for which you are enforcing directory limits. 
  6942.  
  6943. Note:  A network administrator can manage directory limits on a local or remote 
  6944.        server.  A user with server operator privilege can manage a local 
  6945.        server. Managing directory limits on a local server is preferred because 
  6946.        the procedure can be time consuming. 
  6947.  
  6948.  To set a limit for a directory: 
  6949.  
  6950.    1. Open  LAN Server Administration. 
  6951.  
  6952.    2. With mouse button 2, select the  Local Workstation or the appropriate 
  6953.       server object. 
  6954.  
  6955.    3. From the pop-up menu, select the arrow to the right of  Open as. 
  6956.  
  6957.    4. Select  Current shares. 
  6958.  
  6959.    5. Select  Directories. 
  6960.  
  6961.       The Current Shares window is displayed.  It includes a list of directory 
  6962.       resources currently shared. 
  6963.  
  6964.    6. Select the resource for which you want to set directory limits. 
  6965.  
  6966.    7. Select  Manage limits. 
  6967.  
  6968.    8. If directory limits has not been enabled for the resource you selected, 
  6969.       you are prompted whether you want to enable limits. Select  Yes. 
  6970.  
  6971.       The Directory Limits window is displayed. 
  6972.  
  6973.    9. Select one of the following units of measure to indicate the size that 
  6974.       this directory is allow to fill before a directory-full alert is sent 
  6975.       out: 
  6976.  
  6977.           No limit 
  6978.  
  6979.           Specify in kilobytes 
  6980.  
  6981.           Specify in megabytes 
  6982.  
  6983.   10. Specify the  Alert threshold and  Alert increment if desired.  (For more 
  6984.       information, see  Directory-Specific Settings for Alerts) 
  6985.  
  6986.   11. Select  OK. 
  6987.  
  6988.  Note:  You can also enable directory limits using the NET DASD command. For 
  6989.         more information, see the Command Reference. 
  6990.  
  6991.  
  6992. ΓòÉΓòÉΓòÉ 10.5. Alerts for Directory Limits ΓòÉΓòÉΓòÉ
  6993.  
  6994. When limits are set on the size of a directory or tree, the users of that 
  6995. directory cannot exceed the limit.  Therefore, you should notify the 
  6996. appropriate people, not only when the directory is full, but as it increases to 
  6997. the point (threshold) that it might not hold the necessary files. 
  6998.  
  6999. After the threshold is reached, the directory can decrease or increase in size 
  7000. over an unpredictable time span. Administrators and other users appreciate 
  7001. being alerted on a timely basis as the directory approaches and crosses the 
  7002. threshold. 
  7003.  
  7004. The following example of a threshold alert notifies users of the remaining 
  7005. directory space in a particular directory: 
  7006.  
  7007. Directory MYDIR has crossed a threshold.  The available space in
  7008. directory tree is 5KB.
  7009.  
  7010. The following message is an example of a directory-full alert: 
  7011.  
  7012. There was not enough space within the directory tree
  7013. to satisfy your request.  Contact your network
  7014. administrator if you need more space.
  7015.  
  7016. For more information, see the following topics: 
  7017.  
  7018.      Threshold Alerts 
  7019.  
  7020.      Directory-Full Alerts 
  7021.  
  7022.      The Two Stages of Setting Alerts 
  7023.  
  7024.      Directory-Specific Settings for Alerts 
  7025.  
  7026.      Volume-Wide Settings for Alerts 
  7027.  
  7028.  
  7029. ΓòÉΓòÉΓòÉ 10.5.1. Threshold Alerts ΓòÉΓòÉΓòÉ
  7030.  
  7031. Threshold alerts are posted when one percentage threshold is reached as the 
  7032. disk space for the directory increases within the set limit. The following 
  7033. figure illustrates the threshold, the limit, and their relationship to 
  7034. directory size. 
  7035.  
  7036.  
  7037. Threshold Alerts
  7038.  
  7039. As the size of the directory increases, it crosses the threshold (1) and 
  7040. generates an alert.  You can divide the threshold into incremental thresholds, 
  7041. which, as they are crossed, post additional threshold alerts. 
  7042.  
  7043. The  ThreshAlertDelay parameter in the HPFS386.INI file defines the threshold 
  7044. delay, or the minimum amount of time that must elapse before another crossing 
  7045. of the same or lesser threshold generates an alert (2 and 6).  (The same 
  7046. threshold or a lesser one can be crossed when the size of the directory 
  7047. decreases.) The threshold delay is overridden when the directory size crosses a 
  7048. higher threshold (3 and 4). 
  7049.  
  7050.  
  7051. ΓòÉΓòÉΓòÉ 10.5.2. Directory-Full Alerts ΓòÉΓòÉΓòÉ
  7052.  
  7053. Directory-full alerts are posted when a directory tree is full. The following 
  7054. figure illustrates the relationship between alerts, directory limits, and 
  7055. directory sizes. 
  7056.  
  7057.  
  7058. Directory-Full Alerts
  7059.  
  7060. Because the user cannot cross the directory limit, directory-full alerts are 
  7061. generated only when a directory-full condition is reached.  A directory-full 
  7062. condition occurs when a write request is denied because of insufficient space 
  7063. within the directory tree.  Like threshold alerts, directory-full alerts have a 
  7064. delay window that allows you to control alert notification.  The delay is 
  7065. provided by the  DirFullAlertDelay parameter in the HPFS386.INI file, which 
  7066. defines the minimum amount of time that must elapse before another 
  7067. directory-full condition generates an alert (2 and 3). The delay prevents 
  7068. alerts from being generated in quick succession when the directory space 
  7069. rapidly fluctuates between the limit and a lower value. 
  7070.  
  7071.  
  7072. ΓòÉΓòÉΓòÉ 10.5.3. The Two Stages of Setting Alerts ΓòÉΓòÉΓòÉ
  7073.  
  7074. You set up alerts in two stages: 
  7075.  
  7076.      Make directory-specific settings for alerts.  You make these settings for 
  7077.       the threshold value and the incremental threshold values.  These settings 
  7078.       apply only to the directory you specify. 
  7079.  
  7080.      Set volume-wide settings for alerts.  Set these settings in the 
  7081.       HPFS386.INI file or a  filename.INI file (where filename is a name of 
  7082.       your choosing) on the IFS= line of the file by changing the values of the 
  7083.       supplied parameters.  Parameter values control the following variables: 
  7084.  
  7085.         -  Who receives alerts 
  7086.  
  7087.         -  Whether the user who caused the alert receives it 
  7088.  
  7089.         -  Delay time that must elapse before another alert of the same type is 
  7090.            generated after the crossing of the same or lower threshold or 
  7091.            directory-full condition 
  7092.  
  7093.  Although you can perform either stage first, it usually is more logical to 
  7094.  begin with volume-wide settings. 
  7095.  
  7096.  
  7097. ΓòÉΓòÉΓòÉ 10.5.4. Directory-Specific Settings for Alerts ΓòÉΓòÉΓòÉ
  7098.  
  7099. Use the following procedure to set directory-specific alerts. 
  7100.  
  7101. To set directory-specific alerts: 
  7102.  
  7103.    1. Open  LAN Server Administration. 
  7104.  
  7105.    2. Open the appropriate domain object. 
  7106.  
  7107.    3. With mouse button 2, select the  Local Workstation or the appropriate 
  7108.       server object. 
  7109.  
  7110.    4. From the pop-up menu, select the arrow to the right of  Open as. 
  7111.  
  7112.    5. Select  Current shares. 
  7113.  
  7114.    6. Select  Directories. 
  7115.  
  7116.       The Current Shares window is displayed.  It includes a list of directory 
  7117.       resources currently shared. 
  7118.  
  7119.    7. Select the resource for which you want to set directory-specific alerts. 
  7120.  
  7121.    8. Select  Manage limits. 
  7122.  
  7123.    9. If directory limits has not been enabled for the resource you selected, 
  7124.       you are prompted whether you want to enable limits. Select  Yes. 
  7125.  
  7126.   10. If the drive you are attempting to enable is already being used by 
  7127.       another process, a message is displayed instructing you to restart your 
  7128.       workstation to complete the enabling process. After you restart your 
  7129.       workstation, return to either step 1 or 2. 
  7130.  
  7131.   11. If the drive you are trying to enable is not being used by another 
  7132.       process, the Directory Limits window is displayed. 
  7133.  
  7134.   12. Select  Specify threshold, and set the threshold value. 
  7135.  
  7136.       The threshold value is a percentage of the set directory limit. The valid 
  7137.       range is 1 to 99.  An alert is posted when the directory is this 
  7138.       percentage full. 
  7139.  
  7140.   13. Select  Specify increment, and set the incremental threshold value. 
  7141.  
  7142.       The incremental threshold value is a percentage of the set directory 
  7143.       limit.  Valid ranges are values less than or equal to (100 - threshold 
  7144.       value - 1).  An alert is generated each time the directory increases by 
  7145.       this incremental value after the threshold is reached. 
  7146.  
  7147.       Note:  For example, if you specified a directory limit of 1000KB, a 
  7148.              threshold of 80 percent, and an increment value of 3 percent, the 
  7149.              following happens: 
  7150.  
  7151.           The first threshold alert is posted when the directory increases to 
  7152.            80 percent (800KB) of its limit (1000KB). 
  7153.  
  7154.           From that point, each time the directory increases 3 percent (30KB) 
  7155.            of the directory limit, another threshold alert is posted. 
  7156.            Threshold alerts are posted as the directory grows to the following 
  7157.            sizes: 800, 830, 860, 890, 920, 950, and 980. 
  7158.  
  7159.           A directory-full alert is posted at the limit of 1000KB. 
  7160.  
  7161.   14. Select  OK. 
  7162.  
  7163.  You can also set directory-specific alerts limits using the NET DASD command. 
  7164.  For more information, see the Command Reference. 
  7165.  
  7166.  
  7167. ΓòÉΓòÉΓòÉ 10.5.5. Volume-Wide Settings for Alerts ΓòÉΓòÉΓòÉ
  7168.  
  7169. You control settings for volume-wide alerts with parameters that you set in the 
  7170. HPFS386.INI file.  The values for these parameters become active when you 
  7171. restart the server. 
  7172.  
  7173. The list below describes the volume-wide parameters stored in the HPFS386.INI 
  7174. file (or an .INI file you created).  Some parameters control who receives 
  7175. alerts; others control the delay value. 
  7176.  
  7177.   Parameter           Description
  7178.  
  7179.  DirFullAlertNames   Specifies, on a per-volume basis, the user or group IDs to 
  7180.                      receive alerts when the size of a directory has reached 
  7181.                      the set limit. 
  7182.  
  7183.  DirFullAlertUser    Specifies whether a user ID that encounters a 
  7184.                      directory-full condition receives an alert. Specify either 
  7185.                      Yes or No. 
  7186.  
  7187.  ThreshAlertNames    Specifies the user IDs to receive alerts when a threshold 
  7188.                      is exceeded. 
  7189.  
  7190.  ThreshAlertUser     Specifies whether a user ID that caused a threshold to be 
  7191.                      crossed requires notification. Specify either Yes or No. 
  7192.  
  7193.  DirFullAlertDelay   Defines, in minutes, the ThreshDelay period for 
  7194.                      directory-full conditions. 
  7195.  
  7196.  ThreshAlertDelay    Defines, in minutes, the ThreshDelay period for the 
  7197.                      threshold crossing. 
  7198.  
  7199.  For more information, see the following topics: 
  7200.  
  7201.      Format of Parameter Values 
  7202.  
  7203.      Setting Parameter Values 
  7204.  
  7205.  
  7206. ΓòÉΓòÉΓòÉ 10.5.5.1. Format of Parameter Values ΓòÉΓòÉΓòÉ
  7207.  
  7208. The HPFS386.INI file stores volume-wide information patterned after the 
  7209. following format: 
  7210.  
  7211. < parameter>=< drive letters>: arg1 arg2 ... argN 
  7212.  
  7213. where: 
  7214.  
  7215.  parameter           Specifies the parameter in the DASD_Limits section of the 
  7216.                      HPFS386.INI file. 
  7217.  
  7218.  drive letters       Specifies the drives to which the parameter applies. 
  7219.  
  7220.  arg1 arg2 ... argN  Specifies the variable number of arguments to apply to 
  7221.                      this use of the parameter. Depending upon the parameter, 
  7222.                      arguments can be the name of subdirectories, user IDs, 
  7223.                      "Yes" or  "No", or a numerical value for minutes. 
  7224.  
  7225.  Several rules apply to the HPFS386.INI file: 
  7226.  
  7227.      When used instead of drive letters, the * (asterisk) denotes all 386 HPFS 
  7228.       drives. 
  7229.  
  7230.      If the same parameter is specified with the same drives more than once, 
  7231.       the occurrence positioned lower in the file overrides the previous 
  7232.       occurrence. 
  7233.  
  7234.      To add comment lines in the file, comment them out with semicolons as 
  7235.       shown in the following example. 
  7236.   The following example shows the parameters are located under the DASD_Limits 
  7237.  section of the HPFS386.INI file. 
  7238.  
  7239.  Note:  The  * (asterisk) wildcard character signifies all 386 HPFS drives. 
  7240.  
  7241.   [DASD_Limits]
  7242.  
  7243.  
  7244.   ThreshAlertNames=*:userid1 userid2 groupid4   ;For all 386 HPFS drives
  7245.   ThreshAlertDelay=CDE: 60            ;1 hour delay for drives C, D, E
  7246.   ThreshAlertDelay=FG: 10             ;Delay for drives F and G
  7247.   ThreshAlertUser=DE: Yes             ;Notify user by sending
  7248.                                       ;a message.
  7249.  
  7250.  
  7251.   DirFullAlert Names=CDE: admins ;Notify all administrators
  7252.   DirFullAlertDelay=*: 5              ;Post alerts no less than
  7253.                                       ;5 minutes apart
  7254.   DirFullAlertUser=DEG: Yes           ;Notify user who requested space
  7255.   DirFullAlertUser=C: No              ;No alerts to any user for drive C
  7256.  
  7257.  For more information, see the following topic: 
  7258.  
  7259.      Parameter Default Values 
  7260.  
  7261.  
  7262. ΓòÉΓòÉΓòÉ 10.5.5.1.1. Parameter Default Values ΓòÉΓòÉΓòÉ
  7263.  
  7264. Parameters have the following default values if you do not specify other 
  7265. values: 
  7266.  
  7267.  Parameters          Default Values 
  7268.  
  7269.  ThreshAlertNames and  DirFullAlertNames ADMINS 
  7270.  
  7271.  ThreshAlertDelay and  DirFullAlertDelay 10 minutes 
  7272.  
  7273.  ThreshAlertUser and  DirFullAlertUser Yes 
  7274.  
  7275.  
  7276. ΓòÉΓòÉΓòÉ 10.5.5.2. Setting Parameter Values ΓòÉΓòÉΓòÉ
  7277.  
  7278. Use the following procedures to set parameters for directory limits. 
  7279.  
  7280. To set directory limits parameters: 
  7281.  
  7282.    1. Open the 386 HPFS initialization file in the IBM386FS directory. This 
  7283.       file contains the directory limits parameters. 
  7284.  
  7285.    2. Set any of the parameter values as needed to configure your alerts for 
  7286.       directory limits. 
  7287.  
  7288.    3. Stop the server using the Shutdown command, and then start it again to 
  7289.       enable the changes. 
  7290.  
  7291.  You can use the same parameters as many times as necessary.  The next 
  7292.  procedures demonstrate how to set the specific parameter values. 
  7293.  
  7294.  For more information, see the following topic: 
  7295.  
  7296.      Specifying Who Receives Alerts Across a VolumeSpecifying Who Receives 
  7297.       Alerts Across a Volume 
  7298.  
  7299.      Specifying if the User Receives the AlertsSpecifying if the User Receives 
  7300.       the Alerts 
  7301.  
  7302.      Specifying Alert Delay TimesSpecifying Alert Delay Times 
  7303.  
  7304.  
  7305. ΓòÉΓòÉΓòÉ 10.5.5.2.1. Specifying Who Receives Alerts Across a Volume ΓòÉΓòÉΓòÉ
  7306.  
  7307. The parameters  DirFullAlertNames and ThreshAlertNames specify the user IDs 
  7308. that receive alerts. 
  7309.  
  7310. To specify these parameters: 
  7311.  
  7312.    1. Open the 386 HPFS initialization file in the IBM386FS directory, and 
  7313.       locate the DASD_Limits section. 
  7314.  
  7315.    2. After the parameter and its equal sign, type either the drive letter 
  7316.       affected or an asterisk (*) to specify all 386 HPFS drives.  Then type 
  7317.       yes or no to receive the type of alert specified by the parameter. 
  7318.  
  7319.    3. Stop the server using the shutdown command, and then start the server 
  7320.       again to enable the changes. 
  7321.  
  7322.  
  7323. ΓòÉΓòÉΓòÉ 10.5.5.2.2. Specifying if the User Receives the Alerts ΓòÉΓòÉΓòÉ
  7324.  
  7325. The parameters  DirFullAlertUser and ThresAlertUser specify whether the user 
  7326. who caused one of these types of alerts receives the alert. 
  7327.  
  7328. To specify these parameters: 
  7329.  
  7330.    1. Open the HPFS386 file in the IBM386FS directory, and locate the 
  7331.       DASD_Limits section. 
  7332.  
  7333.    2. After the parameter and its equal sign, type either the drive letter 
  7334.       affected or an asterisk (*) to specify all 386 HPFS drives.  Then type 
  7335.       Yes if you want a user to be notified of the event or No if not. 
  7336.  
  7337.    3. Stop the server using the shutdown command, and then start the server 
  7338.       again to enable the changes. 
  7339.  
  7340.  
  7341. ΓòÉΓòÉΓòÉ 10.5.5.2.3. Specifying Alert Delay Times ΓòÉΓòÉΓòÉ
  7342.  
  7343. With the  DirFullAlertDelay and ThreshAlertDelay parameters, you can specify 
  7344. the amount of time that must elapse before another alert is generated for the 
  7345. same alert condition. 
  7346.  
  7347. To specify alert delay times: 
  7348.  
  7349.    1. Open the HPFS386.INI file, and locate the DASD_Limits section. 
  7350.  
  7351.    2. After the parameter and its equal sign, type either the drive letter 
  7352.       affected or an asterisk (*) to specify all 386 HPFS drives.  Then type 
  7353.       the number of minutes for delay. 
  7354.  
  7355.       For example, to set a delay time of 5 minutes for directory-full alerts 
  7356.       on all drives and add a comment, type: 
  7357.  
  7358.             DirFullAlertDelay=*: 5  ;Post alerts no less than  ;5 minutes apart
  7359.  
  7360.    3. Stop the server using the shutdown command; then start the server again 
  7361.       to enable the changes. 
  7362.  
  7363.  
  7364. ΓòÉΓòÉΓòÉ 11. Managing OS/2, DOS, WorkSpace On-Demand, and Windows Applications ΓòÉΓòÉΓòÉ
  7365.  
  7366. An  application is a set of program data files and other files necessary to do 
  7367. a specific job or function, such as word processing.  A network application is 
  7368. an application that is defined to and usually shared on the network. You define 
  7369. network applications as either public or private. A user finds and starts 
  7370. network applications in a program starter, which varies depending on the user's 
  7371. operating system. 
  7372.  
  7373. For brevity, this chapter uses  program starter as a general term to indicate 
  7374. where a user starts public and private applications. The program starter for 
  7375. OS/2 users is the Network Applications folder. The program starter for DOS 
  7376. users depends on whether they run Windows with DOS LAN Services (DLS). 
  7377.  
  7378. For DLS machines with Windows, the program starter is the  LAN Applications 
  7379. list, which is in the Application Installation window. For DLS machines without 
  7380. Windows, the program starter is the Run Applications window. 
  7381.  
  7382. For more information, see the following topics: 
  7383.  
  7384.      Types of Network Applications 
  7385.  
  7386.      How Network Applications and Remote Program Execution Differ 
  7387.  
  7388.      Setting Up an OS/2, DOS, WorkSpace On-Demand, or Windows Network 
  7389.       Application 
  7390.  
  7391.      Managing Network Applications 
  7392.  
  7393.      OS/2 Applications Using Dynamic Link Libraries 
  7394.  
  7395.      Stopping Applications at Logoff 
  7396.  
  7397.      Defining Network Messaging as a Public Application for DOS LAN Requester 
  7398.       3.0 Users 
  7399.  
  7400.      Preparing to Run Programs Remotely 
  7401.  
  7402.  
  7403. ΓòÉΓòÉΓòÉ 11.1. Types of Network Applications ΓòÉΓòÉΓòÉ
  7404.  
  7405. OS/2 Warp Server and LAN Server support two main categories of network 
  7406. applications: 
  7407.  
  7408.      Public 
  7409.  
  7410.      Private 
  7411.  
  7412.  A  public application is available to some or all users on the network. A 
  7413.  private application is created by a user for personal use and is not available 
  7414.  to other users. 
  7415.  
  7416.  Users at OS/2 clients can access public and private applications from the 
  7417.  Network Applications folder on their desktops. WorkSpace On-Demand users can 
  7418.  access public applications from their desktops. Users at DOS LAN Services 
  7419.  clients without Windows can access DOS public and private applications from 
  7420.  the Run Applications window. Users at DOS LAN Services clients with Windows 
  7421.  can access DOS public applications from the  LAN Applications list, which is 
  7422.  in the Application Installation window. These applications are called  shared 
  7423.  applications on these workstations. 
  7424.  
  7425.  You can set up DOS applications to run as OS/2 public or private applications. 
  7426.  OS/2 public and private applications can be either local (on the user's 
  7427.  workstation) or remote (on a server). In DOS LAN Services, applications that 
  7428.  reside on a user's client are called  local applications. 
  7429.  
  7430.  Refer to the DLS and Windows User's Guide for information on setting up 
  7431.  private DOS applications for DOS LAN Services users. 
  7432.  
  7433.  When the Network Applications folder is opened for the first time or when the 
  7434.  folder is refreshed, implicit network connections are made by the OS/2 
  7435.  operating system for applications stored on a remote server.  The implicit 
  7436.  connections are made to determine information about the application objects in 
  7437.  the folder.  The implicit connection is deleted immediately after a program 
  7438.  object is created. 
  7439.  
  7440.  These connections can be affected by the maxuses parameter setting for shares 
  7441.  associated with the network application.  For example, a user who opens the 
  7442.  folder for the first time may not get the actual application icon if the 
  7443.  connection cannot be made to retrieve the icon from the server because the 
  7444.  server is already servicing the maximum number of users indicated by the 
  7445.  maxuses parameter on the server. 
  7446.  
  7447.  
  7448. ΓòÉΓòÉΓòÉ 11.2. How Network Applications and Remote Program Execution Differ ΓòÉΓòÉΓòÉ
  7449.  
  7450. Network applications reside either on a user's workstation (local) or on a 
  7451. server (remote). Remote public applications are loaded from the server and run 
  7452. at the client. Programs that are run as network applications must be compatible 
  7453. with the operating system running on the client. Programs that are run using 
  7454. remote program execution (a program running on a remote server) must be 
  7455. compatible with the operating system running at the server. 
  7456.  
  7457. Running public applications differs from running remote programs. When a user 
  7458. runs a program remotely, that program resides on a server and actually runs in 
  7459. that server's memory, not in the client's memory. Large programs using standard 
  7460. input, output, and error file handles can run remotely in a server's memory, 
  7461. thereby requiring less memory on the client.  Users can interact with the 
  7462. program with command line input. To reduce the amount of memory required on a 
  7463. client machine, run large resource-intensive programs of this type on a remote 
  7464. server. 
  7465.  
  7466.  
  7467. ΓòÉΓòÉΓòÉ 11.3. Setting Up an OS/2, DOS, WorkSpace On-Demand, or Windows Network Application ΓòÉΓòÉΓòÉ
  7468.  
  7469. Use the following steps to set up an OS/2, DOS, or Windows network application 
  7470. located on a server. 
  7471.  
  7472. To set up a WorkSpace On-Demand, OS/2, or DOS application on a server: 
  7473.  
  7474.    1. Install the application. 
  7475.  
  7476.    2. Create a directory alias for the directory containing the application. 
  7477.       Create additional aliases, as needed, for any other network resources 
  7478.       required by the application. 
  7479.  
  7480.    3. Assign access permissions for the aliases. 
  7481.  
  7482.    4. Define the application. 
  7483.  
  7484.    5. Customize the application to meet your needs or the needs of your users. 
  7485.  
  7486.    6. Add the application for users. 
  7487.  
  7488.  For more information, see the following topics: 
  7489.  
  7490.      Installing the Application 
  7491.  
  7492.      Creating Aliases 
  7493.  
  7494.      Assigning Access Permissions 
  7495.  
  7496.      Defining the Application 
  7497.  
  7498.      Customizing Applications 
  7499.  
  7500.  
  7501. ΓòÉΓòÉΓòÉ 11.3.1. Installing the Application ΓòÉΓòÉΓòÉ
  7502.  
  7503. Install the application using the instructions that came with the application. 
  7504. Look for requirements specific to the application.  For example, some 
  7505. applications are not network-aware.  Such applications do not recognize drive 
  7506. letters above E and ports above LPT3 and COM3.  Or, an application may search 
  7507. for data files only on drive C or the drive where it was installed. 
  7508.  
  7509. Note:  For WorkSpace On-Demand, the procedure for installing applications is 
  7510.        different. See the WorkSpace On-Demand 2.0 Administrator's Guide for 
  7511.        more information. 
  7512.  
  7513.  Network-aware applications are applications that use network resources and are 
  7514.  designed to be run on a network. Stand-alone applications, on the other hand, 
  7515.  are designed to be stored and run on the local workstation and are not 
  7516.  network-aware. Some restrictions apply when running stand-alone applications 
  7517.  on a network. 
  7518.  
  7519.  Install the application in a directory. During installation of some 
  7520.  applications, that directory is created for you. Check the documentation that 
  7521.  came with the application. 
  7522.  
  7523.  If the application is to be shared among many users, consider installing it in 
  7524.  a server's directory, rather than on a user's local workstation.  (The 
  7525.  application is then loaded into the user's workstation's memory as needed.) 
  7526.  However, if the application searches for data only on drive C, install the 
  7527.  application or the data files on the users' workstations. 
  7528.  
  7529.  If you use server storage for an OS/2 application that includes files with a 
  7530.  .DLL extension, you must provide access to those files from any clients that 
  7531.  run the application. 
  7532.  
  7533.  
  7534. ΓòÉΓòÉΓòÉ 11.3.2. Creating Aliases ΓòÉΓòÉΓòÉ
  7535.  
  7536. If you have not already done so, create a directory alias for the directory in 
  7537. which your public application resides and create aliases for other resources 
  7538. required by this application. See  Sharing Network Resources for more 
  7539. information. 
  7540.  
  7541. When creating an alias, use the  Maximum concurrent connections field to limit 
  7542. the number of users accessing the application at the same time.  For example, 
  7543. if you bought 10 licenses for this application, specify 10 in that field. 
  7544.  
  7545.  
  7546. ΓòÉΓòÉΓòÉ 11.3.3. Assigning Access Permissions ΓòÉΓòÉΓòÉ
  7547.  
  7548. If you have not already done so, create an access control profile for the alias 
  7549. and assign access permissions for this alias to users and groups. See  Defining 
  7550. Access Control Profiles for more information. 
  7551.  
  7552. Execute (X) permission is usually insufficient for an application to run 
  7553. properly.  If an OS/2 application consists of only one file with the .EXE 
  7554. extension and uses no secondary files, execute permission is sufficient. 
  7555. However, read (R) permission is required to run .BAT and .CMD files.  To run 
  7556. DOS applications, users must have read permission. 
  7557.  
  7558. Applications often use secondary files, such as help files or a dictionary file 
  7559. used by a text editor, and users need at least read permission for these files. 
  7560. Read permission lets users read, execute, and copy files. You can assign read 
  7561. permission to the alias containing the application's secondary files, and then 
  7562. create a separate access control profile for the first executable (.EXE) file 
  7563. with execute permission only. This restriction prevents users from copying the 
  7564. primary executable file. 
  7565.  
  7566. If an application creates a temporary file, both create (C) and read (R) 
  7567. permissions are required.  If a user needs to edit the temporary file, write 
  7568. (W) permission is also necessary. 
  7569.  
  7570. Directory resources with write permission also need attributes (A) permission 
  7571. if they are used in applications that change file attributes. For example, if a 
  7572. directory resource does not have attributes permission and an attempt to write 
  7573. to the file changes file attributes such as date and time, the attempt fails. 
  7574.  
  7575.  
  7576. ΓòÉΓòÉΓòÉ 11.3.4. Defining the Application ΓòÉΓòÉΓòÉ
  7577.  
  7578. Define the application as a public OS/2, DOS, or Windows application through 
  7579. the Public Application Definitions notebook of LAN Server Administration. 
  7580. Steps for defining a public application are in  Defining Public Applications. 
  7581.  
  7582. You, as a system administrator, can define your own private OS/2 applications. 
  7583. Network users can also define and manage their own private applications, which 
  7584. can be located either on their workstation or on a server. 
  7585.  
  7586. Some benefits of defining a public application are: 
  7587.  
  7588.      The application uses disk space only on the server instead of on every 
  7589.       workstation. 
  7590.  
  7591.      Users can directly access applications without having any knowledge of 
  7592.       the network configuration. 
  7593.  
  7594.      Setting up and maintaining the necessary configuration of network 
  7595.       resources required by the application is easier. 
  7596.  
  7597.      Running applications from program starters (either the Network 
  7598.       Applications folder, the Run Applications window, or the  LAN 
  7599.       Applications list in the Application Installation window) is easier than 
  7600.       running them from the command line. 
  7601.  
  7602.  The definition of a network application enables the system to locate and start 
  7603.  the first executable file of the application.  If the application uses 
  7604.  additional files, make sure the first application file can run or read the 
  7605.  other files as needed.  For more information, refer to the publications that 
  7606.  come with your application. 
  7607.  
  7608.  Note:  You can assign DOS applications to users at OS/2 clients. You can also 
  7609.         set up DOS applications to run as OS/2 public or private applications. 
  7610.  
  7611.  
  7612. ΓòÉΓòÉΓòÉ 11.3.5. Customizing Applications ΓòÉΓòÉΓòÉ
  7613.  
  7614. When you customize an application, you make changes in the steps for setting up 
  7615. an application to meet your needs or the needs of your users. Consider the 
  7616. following when customizing an application: 
  7617.  
  7618.      You can create multiple application definitions, each using different 
  7619.       network resources. You can model new application definitions on existing 
  7620.       ones. 
  7621.  
  7622.      The application can require you to set environment variables in a batch 
  7623.       file before running the application. 
  7624.  
  7625.      The application can collect parameters (for example, printername or 
  7626.       username) at run time for use in conditional batch processing.  Use the 
  7627.       IF and GOTO batch commands for this purpose.  Refer to the Command 
  7628.       Reference for more information about command descriptions. 
  7629.  
  7630.       For example, if the application uses a printer and a default printer of 
  7631.       LPT1 is specified, you can allow use of alternate printers by putting a 
  7632.       check mark in the  Prompt for additional parameters field when defining 
  7633.       the application. Different printer names can be handled by combining IF, 
  7634.       GOTO, and NET USE commands in a batch file that subsequently starts the 
  7635.       desired application. 
  7636.  
  7637.      To alter an application for a specific user, prepare a batch file that 
  7638.       calls a secondary batch file containing commands the user needs.  (The 
  7639.       secondary file can be located on a server, for example, in the user's 
  7640.       home directory, so that you can manage it.)  If the secondary batch file 
  7641.       is found, it performs the desired setup and program call.  If it is not 
  7642.       found, the application proceeds normally. 
  7643.  
  7644.       For example, an application batch file can test for the existence of a 
  7645.       secondary batch file in the user's home directory, containing a NET USE 
  7646.       command to a specified plotter.  If found, this secondary batch file 
  7647.       runs, giving the application access to the plotter in addition to the 
  7648.       network assignments defined for the application. 
  7649.  
  7650.  
  7651. ΓòÉΓòÉΓòÉ 11.4. Managing Network Applications ΓòÉΓòÉΓòÉ
  7652.  
  7653. This section contains procedures for managing the public applications of users 
  7654. on the network and managing your own private applications. You can add, delete, 
  7655. and update public applications for specific users or for all the users defined 
  7656. in a group. 
  7657.  
  7658. For more information, see: 
  7659.  
  7660.      Public Applications 
  7661.  
  7662.         -  Defining Public Applications 
  7663.  
  7664.         -  Adding Public Applications for Users 
  7665.  
  7666.      Private Applications 
  7667.  
  7668.         -  Defining Private Applications 
  7669.  
  7670.         -  Updating Private Application Definitions 
  7671.  
  7672.         -  Deleting Private Application Definitions 
  7673.  
  7674.  
  7675. ΓòÉΓòÉΓòÉ 11.4.1. Public Applications ΓòÉΓòÉΓòÉ
  7676.  
  7677. The system administrator sets up public applications for users at WorkSpace 
  7678. On-Demand, OS/2, and DOS clients. You can define WorkSpace On-Demand, OS/2, 
  7679. DOS, and Windows public applications to the network and add them to users' 
  7680. program starters. You can also update and delete definitions for public 
  7681. applications. 
  7682.  
  7683. When a user at a WorkSpace On-Demand client logs on, any publications assigned 
  7684. to them are placed on the desktop. 
  7685.  
  7686. When a user at an OS/2 client logs on, any public applications assigned to the 
  7687. user are included in the Network Applications folder. 
  7688.  
  7689. When a user at a DOS LAN Services client without Windows logs on, the system 
  7690. updates the Run Applications window with the DOS applications you set up as 
  7691. public applications. 
  7692.  
  7693. DOS LAN Services users with Windows can view DOS public applications as shared 
  7694. applications.  When a user at a DOS LAN Services client with Windows logs on, 
  7695. the system lists shared applications in the user's  LAN Applications list, 
  7696. which is in the Application Installation window. 
  7697.  
  7698. Only administrators and users with Server operator privilege can set up public 
  7699. applications. However, both users and administrators can determine which public 
  7700. applications display on the program starter. 
  7701.  
  7702. For more information, see the following topics: 
  7703.  
  7704.      Defining Public Applications 
  7705.  
  7706.      Adding Public Applications for Users 
  7707.  
  7708.  
  7709. ΓòÉΓòÉΓòÉ 11.4.1.1. Defining Public Applications ΓòÉΓòÉΓòÉ
  7710.  
  7711. Use the next procedure to define public WorkSpace On-Demand, OS/2, DOS, or 
  7712. Windows applications. 
  7713.  
  7714. To define WorkSpace On-Demand, OS/2, DOS, and Windows applications as public 
  7715. applications: 
  7716.  
  7717.    1. Open LAN Server Administration. 
  7718.  
  7719.    2. Open the domain object in which you want to create public application 
  7720.       definitions. 
  7721.  
  7722.    3. Open Public Application Definitions. 
  7723.  
  7724.       The Public Application Definitions folder is displayed. 
  7725.  
  7726.    4. To create a new definition, drag a copy of the WorkSpace On-Demand 
  7727.       Template, OS/2 Template, or DOS & Windows Template to an open area of the 
  7728.       folder. 
  7729.  
  7730.    5. Complete the fields on the pages under each tab. Required fields are 
  7731.       identified by an asterisk (*). 
  7732.  
  7733.    6. After you complete and check the pages, select Create. 
  7734.  
  7735.  Note:  You can customize WorkSpace On-Demand applications through the use of 
  7736.         application parameters. For more information on this, refer to the 
  7737.         WorkSpace On-Demand 2.0 Administrator's Guide. 
  7738.  
  7739.  
  7740. ΓòÉΓòÉΓòÉ 11.4.1.2. Adding Public Applications for Users ΓòÉΓòÉΓòÉ
  7741.  
  7742. Adding applications to users' program starters makes the applications 
  7743. convenient. 
  7744.  
  7745. To make WorkSpace On-Demand, OS/2, DOS, and Windows public applications easily 
  7746. available to users: 
  7747.  
  7748.    1. Open  LAN Server Administration. 
  7749.  
  7750.    2. Open the domain object. 
  7751.  
  7752.    3. Open  Public Application Definitions. 
  7753.  
  7754.    4. Open either  User Accounts or  Groups. 
  7755.  
  7756.    5. Drag the appropriate application object from the  Public Application 
  7757.       Definitions folder and drop the object on the appropriate user or group. 
  7758.  
  7759.       The Add Public Applications window is displayed. 
  7760.  
  7761.    6. Select  OK. 
  7762.  
  7763.  
  7764. ΓòÉΓòÉΓòÉ 11.4.2. Private Applications ΓòÉΓòÉΓòÉ
  7765.  
  7766. Users at OS/2 clients can create private OS/2 applications through LAN Server 
  7767. Administration. The network administrator must, however, first set up aliases 
  7768. and access control profiles for the resources before the user can use the 
  7769. application. Then when a user at an OS/2 client logs on, the private 
  7770. applications are automatically added to the Network Applications folder. 
  7771.  
  7772. Refer to the DLS and Windows User's Guide for information on setting up private 
  7773. DOS applications for DOS LAN Services users. 
  7774.  
  7775. DBCS Note  You do not have the online reference on DOS. 
  7776.  
  7777.  You can define private applications to the network. You can also update and 
  7778.  delete definitions for private applications. 
  7779.  
  7780.  For more information, see the following topics: 
  7781.  
  7782.      Defining Private Applications 
  7783.  
  7784.      Updating Private Application Definitions 
  7785.  
  7786.      Deleting Private Application Definitions 
  7787.  
  7788.  
  7789. ΓòÉΓòÉΓòÉ 11.4.2.1. Defining Private Applications ΓòÉΓòÉΓòÉ
  7790.  
  7791. Use the next procedure to create the definition for a private application. 
  7792.  
  7793. To define a private application: 
  7794.  
  7795.    1. Open  LAN Server Administration. 
  7796.  
  7797.    2. Open the domain object in which you want to create private application 
  7798.       definitions. 
  7799.  
  7800.    3. Open  User Accounts. 
  7801.  
  7802.       The User Accounts folder is displayed. 
  7803.  
  7804.    4. With mouse button 2, select a user account object. 
  7805.  
  7806.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  7807.  
  7808.    6. Select  Private applications. 
  7809.  
  7810.       The Private Applications Definitions folder is displayed. 
  7811.  
  7812.    7. To create a new definition, drag a copy of the OS/2 Template to an open 
  7813.       area in the folder. 
  7814.  
  7815.       The Private Applications notebook is displayed. 
  7816.  
  7817.    8. Complete the fields on the pages under each tab.  Required fields are 
  7818.       identified with an asterisk (*). 
  7819.  
  7820.    9. After you complete and check the pages, select Create. 
  7821.  
  7822.  You can run the application from the program starter after you log off and on. 
  7823.  
  7824.  
  7825. ΓòÉΓòÉΓòÉ 11.4.2.2. Updating Private Application Definitions ΓòÉΓòÉΓòÉ
  7826.  
  7827. Use the next procedure to change the definition for a private application. 
  7828.  
  7829. To change private application definitions: 
  7830.  
  7831.    1. Open  LAN Server Administration. 
  7832.  
  7833.    2. Open the domain object. 
  7834.  
  7835.    3. Open  User Accounts. 
  7836.  
  7837.       The User Accounts folder is displayed. 
  7838.  
  7839.    4. With mouse button 2, select the user account you want to work with. 
  7840.  
  7841.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  7842.  
  7843.    6. Select  Private applications. 
  7844.  
  7845.       The Private Applications Definitions folder is displayed. 
  7846.  
  7847.    7. Open the private application object for which you want to update the 
  7848.       definitions. 
  7849.  
  7850.       The notebook of the selected application is displayed. 
  7851.  
  7852.    8. Select the tabs for the pages you want to update. 
  7853.  
  7854.    9. Update the properties. 
  7855.  
  7856.   10. Select  Set. 
  7857.  
  7858.  
  7859. ΓòÉΓòÉΓòÉ 11.4.2.3. Deleting Private Application Definitions ΓòÉΓòÉΓòÉ
  7860.  
  7861. Use the next procedure to remove the definition for a private application. 
  7862.  
  7863. To delete a private application definition: 
  7864.  
  7865.    1. Open  LAN Server Administration. 
  7866.  
  7867.    2. Open the domain object. 
  7868.  
  7869.    3. Open  User Accounts. 
  7870.  
  7871.       The User Accounts folder is displayed. 
  7872.  
  7873.    4. With mouse button 2, select the user account for which you want to delete 
  7874.       a private application definition. 
  7875.  
  7876.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  7877.  
  7878.    6. Select  Private applications. 
  7879.  
  7880.       The Private Applications Definitions folder is displayed. 
  7881.  
  7882.    7. With mouse button 2, select the private application for which you want to 
  7883.       delete the definition. 
  7884.  
  7885.    8. From the pop-up menu, select  Delete. 
  7886.  
  7887.    9. Select  Delete in the confirmation window. 
  7888.  
  7889.  
  7890. ΓòÉΓòÉΓòÉ 11.5. OS/2 Applications Using Dynamic Link Libraries ΓòÉΓòÉΓòÉ
  7891.  
  7892. The OS/2 dynamic link library (DLL) feature allows multiple applications to 
  7893. call common modules. 
  7894.  
  7895. The LIBPATH statement in the CONFIG.SYS file must specify the location of DLL 
  7896. files.  If any application files end with the .DLL extension, you must edit the 
  7897. CONFIG.SYS file of each workstation where the application runs to indicate 
  7898. where DLL files are for that application. Because the OS/2 program supports UNC 
  7899. names, you can specify a server name and netname in the LIBPATH statement.  For 
  7900. changes to the LIBPATH statement to become effective, you must shut down the 
  7901. operating system from the desktop, and then restart the workstation by pressing 
  7902. Ctrl+Alt+Del. The LIBPATH statement is unlike the SET PATH statement, which 
  7903. does not require starting the workstation again for changes to become 
  7904. effective. 
  7905.  
  7906. For more information, see the following topics: 
  7907.  
  7908.      Creating a Subdirectory for DLL Files 
  7909.  
  7910.      Specifying the Location of DLL Files 
  7911.  
  7912.  
  7913. ΓòÉΓòÉΓòÉ 11.5.1. Creating a Subdirectory for DLL Files ΓòÉΓòÉΓòÉ
  7914.  
  7915. If more than one application uses DLL files, keep all DLL files (for all 
  7916. applications) in a separate subdirectory on the server.  Then specify the path 
  7917. to the subdirectory in the LIBPATH statement on each workstation. 
  7918.  
  7919. If DLL files are on several servers, add a UNC name containing each server name 
  7920. and subdirectory to the CONFIG.SYS file LIBPATH statement for a user to access 
  7921. those applications. 
  7922.  
  7923. To create and prepare a subdirectory for DLL files: 
  7924.  
  7925.    1. Create a subdirectory on the server drive C for the DLL files, such as 
  7926.       \DLLIB on SERVER1. 
  7927.  
  7928.    2. Create an alias for the subdirectory, such as DLL. Share this alias at 
  7929.       server startup to allow access to these DLL files at all times. 
  7930.  
  7931.    3. Create an access control profile for the alias, allowing users using 
  7932.       applications with DLL files to have read permission. 
  7933.  
  7934.    4. Edit the CONFIG.SYS file on each client to add the server name and the 
  7935.       netname (the netname value is the same as the alias).  The following 
  7936.       example uses values from the previous steps: 
  7937.  
  7938.              \\SERVER1\DLL
  7939.  
  7940.  
  7941. ΓòÉΓòÉΓòÉ 11.5.2. Specifying the Location of DLL Files ΓòÉΓòÉΓòÉ
  7942.  
  7943. You can also specify the location of DLL files by keeping all the application 
  7944. files, including the DLL files, in the same subdirectory or you can define a 
  7945. working directory where the DLL files are located.  Following are general steps 
  7946. to perform these actions: 
  7947.  
  7948.      Put all of the application files, including DLL files, in the same 
  7949.       subdirectory and perform the following steps: 
  7950.  
  7951.         1. When you define the application, define a working directory with an 
  7952.            assigned drive, for example, drive T. 
  7953.  
  7954.         2. Edit the CONFIG.SYS file on each client to add the working directory 
  7955.            drive to the end of the LIBPATH statement. In this example, add the 
  7956.            following: 
  7957.  
  7958.                       T:\;
  7959.  
  7960.            To avoid conflicts among users on the client, tell your users not to 
  7961.            make resource assignments to this drive. 
  7962.  
  7963.      Define a working (current) directory for the application where the DLL 
  7964.       files are located.  In the LIBPATH statement, append a period followed by 
  7965.       a semicolon (;) to tell the OS/2 program to search the current directory 
  7966.       for DLL files.  When the application is run, the OS/2 program searches 
  7967.       the working directory for the DLL files.  If this method is used, users 
  7968.       must not change the current directory while using the application. 
  7969.  
  7970.  
  7971. ΓòÉΓòÉΓòÉ 11.6. Stopping Applications at Logoff ΓòÉΓòÉΓòÉ
  7972.  
  7973. When you log off from a server, OS/2 Warp Server or LAN Server prompts you if 
  7974. an application is still running.  At the prompt you can either cancel the 
  7975. logoff or stop the application. 
  7976.  
  7977. If you want to stop any network application at logoff without being prompted, 
  7978. type the /Y parameter as follows: 
  7979.  
  7980. LOGOFF /Y
  7981.  
  7982. Note:  If you log off while OS/2 network applications are accessing DLLs from 
  7983.        the server, those applications will trap. In most cases, the trap will 
  7984.        not affect the operation of other software (including the OS/2 operating 
  7985.        system) on the client.  To avoid traps, always close your network 
  7986.        applications before logging off. 
  7987.  
  7988.  
  7989. ΓòÉΓòÉΓòÉ 11.7. Defining Network Messaging as a Public Application for DOS LAN Requester 3.0 Users ΓòÉΓòÉΓòÉ
  7990.  
  7991. If you have DOS LAN Requester 3.0 users who are not upgrading to DOS LAN 
  7992. Services, the DOS LAN Requester Messaging program does not display on their 
  7993. Served Applications program starters after the server is upgraded to LAN Server 
  7994. 4.0 or OS/2 Warp Server. 
  7995.  
  7996. DOS LAN Services provides a new Network Messaging GUI; however DOS LAN 
  7997. Requester 3.0 users are unable to access it because the DOS LAN Requester 
  7998. interface is incompatible. 
  7999.  
  8000. In order to provide DOS LAN Requester users with a messaging service, you can 
  8001. define the messaging service used in DOS LAN Requester 3.0 as a public 
  8002. application.  You must create an alias for the application and define an access 
  8003. control profile for the alias before adding the program to users' Served 
  8004. Application groups. 
  8005.  
  8006. To create an alias and access control profile for the messaging program: 
  8007.  
  8008.    1. Copy the following files from the\DOSLAN directory on a DOS LAN Requester 
  8009.       3.0 workstation and place them in the OS/2 Warp Server or LAN Server 
  8010.       \IBMLAN\DOSLAN\NET directory: 
  8011.  
  8012.           DMPC.EXE 
  8013.  
  8014.           CMM_MAIN.EXE 
  8015.  
  8016.           CEIM.CNF 
  8017.  
  8018.    2. At the server, open  LAN Server Administration. 
  8019.  
  8020.    3. Open the domain you want to access. 
  8021.  
  8022.    4. Open  Directory Resource Definitions. 
  8023.  
  8024.    5. Drag and drop the  Directory Template to an open area in the folder.  The 
  8025.       Identity page of the notebook is displayed. 
  8026.  
  8027.    6. Complete the Identity page as follows. 
  8028.  
  8029.           Alias:  DLRMSG 
  8030.  
  8031.           Description:  DLR Messaging Program 
  8032.  
  8033.           Server:  (name of server where program resides) 
  8034.  
  8035.           Path:  C:\IBMLAN\DOSLAN\NET 
  8036.  
  8037.           When shared:  At server startup 
  8038.  
  8039.           Maximum connections:  Unlimited 
  8040.  
  8041.    7. Select  Create. 
  8042.  
  8043.           If there is no access control profile, a message is displayed 
  8044.            prompting you to create one. Select  OK to create the access 
  8045.            profile. 
  8046.  
  8047.            The Identity page of the Access Control Profile - Create notebook is 
  8048.            displayed. 
  8049.  
  8050.           If there is an access control profile, no message appears. The 
  8051.            Identity page of the Access Control Profile notebook is displayed. 
  8052.  
  8053.       See  Defining Access Control Profiles for information about access 
  8054.       control profiles. 
  8055.  
  8056.    8. Select the  Permissions tab. 
  8057.  
  8058.           If the user is listed: 
  8059.  
  8060.              a. Select the user IDs from the list on the left. 
  8061.  
  8062.              b. Select  Replace. 
  8063.  
  8064.              c. Select Read (R) and Execute (X) permissions from the list on 
  8065.                 the right. 
  8066.  
  8067.              d. Select  Change. 
  8068.  
  8069.                 The permissions you selected appear beside the user IDs in the 
  8070.                 list on the left. 
  8071.  
  8072.           If a user is not listed: 
  8073.  
  8074.              a. Select  Add. 
  8075.  
  8076.                 The Add Access Control Entries window is displayed. 
  8077.  
  8078.              b. Select the user ID from the list on the left. 
  8079.  
  8080.              c. Select Read (R) and Execute (X) permissions from the list on 
  8081.                 the right. 
  8082.  
  8083.              d. Select  OK. 
  8084.  
  8085.                 The user ID appears on the Permissions page with Read (R) and 
  8086.                 Execute (X) permissions. 
  8087.  
  8088.    9. Select  Create or  Set. 
  8089.  
  8090.       A message is displayed prompting you whether to propagate the access 
  8091.       permissions to all subdirectories in the path.  See  Propagating Access 
  8092.       Control Profiles to Subdirectories for information about propagating 
  8093.       (applying) an access profile to subdirectories. 
  8094.  
  8095.   10. Select  OK to propagate access to all the subdirectories in the path, 
  8096.       giving users Read (R) and Execute (X) access to the entire program 
  8097.       directory tree. 
  8098.  
  8099.  The alias DLRMSG is created, the directory is shared, and the access control 
  8100.  profile is created.  An icon representing the alias is added to the Directory 
  8101.  Resource Definitions folder in the domain. 
  8102.  
  8103.  To define the program as a public DOS application using the alias: 
  8104.  
  8105.    1. Open  LAN Server Administration. 
  8106.  
  8107.    2. Open the domain you want to access. 
  8108.  
  8109.    3. Open  Public Application Definitions. 
  8110.  
  8111.    4. Drag and drop the  DOS & Windows Template to an open space in the folder. 
  8112.       The Public Application Definition notebook is displayed. 
  8113.  
  8114.    5. Complete the Identity page as follows: 
  8115.  
  8116.           Application name:  DLRMSG 
  8117.  
  8118.           Description:  DOS LAN Requester Messaging 
  8119.  
  8120.    6. Select the  Invocation tab and complete the fields as follows: 
  8121.  
  8122.           Command:  DMPC 
  8123.  
  8124.           Parameter:  %XSLCNF% CMM_MAIN.EXE 
  8125.  
  8126.           Prompt for additional parameters:  (Do not check) 
  8127.  
  8128.    7. Select the  Program Location tab and complete the fields as follows: 
  8129.  
  8130.           Alias:  DLRMSG 
  8131.  
  8132.           Remaining path to program:  (Accept default) 
  8133.  
  8134.           Assigned drive:  Next available (Accept default) 
  8135.  
  8136.    8. Select the  Work Directory tab and complete the fields. 
  8137.  
  8138.           Alias:  DLRMSG 
  8139.  
  8140.           Remaining path to program:  (Accept default) 
  8141.  
  8142.           Assigned drive:  Next available (Accept default) 
  8143.  
  8144.    9. Select  Create. 
  8145.  
  8146.       The public application is created and an icon representing the DOS public 
  8147.       application definition for the DOS LAN Requester Messaging program is 
  8148.       added to the Public Application Definitions folder in the domain. 
  8149.  
  8150.  In the next series of steps you will add the DOS LAN Requester Messaging 
  8151.  program to a user's program starter. 
  8152.  
  8153.  To add the DOS LAN Requester Messaging program to a user's program starter: 
  8154.  
  8155.    1. Open  LAN Server Administration. 
  8156.  
  8157.    2. Open the domain you want to access. 
  8158.  
  8159.    3. Open  User Accounts. 
  8160.  
  8161.    4. Open the user account to which you are adding the DOS LAN Requester 
  8162.       Messaging program. 
  8163.  
  8164.       The notebook of the selected user account is displayed. 
  8165.  
  8166.    5. Select the  Applications tab. 
  8167.  
  8168.    6. Select  Add to display the Add Public Applications window. 
  8169.  
  8170.    7. Select  DLRMSG and then select  Add. 
  8171.  
  8172.       The DOS LAN Requester Messaging program is added to the user's program 
  8173.       starter as a public application. 
  8174.  
  8175.    8. Select  Set to save changes to the user account properties and close the 
  8176.       notebook. 
  8177.  
  8178.       If the user account is logged on, the user must log off and then log on 
  8179.       again before using the application. This step adds the application to the 
  8180.       user's program starter. 
  8181.  
  8182.  
  8183. ΓòÉΓòÉΓòÉ 11.8. Preparing to Run Programs Remotely ΓòÉΓòÉΓòÉ
  8184.  
  8185. You usually run programs remotely by entering the NET RUN command at the 
  8186. command line interface. You can also use the AT and NET ADMIN commands. For 
  8187. more information about command descriptions, refer to the Command Reference . 
  8188. For information on running a program, refer to the OS/2 File and Print Client 
  8189. Guide. 
  8190.  
  8191. Consider the following methods and constraints when preparing to run programs 
  8192. remotely. 
  8193.  
  8194.      To find out if a program can be run remotely, type the following command 
  8195.       at the command prompt on the server: 
  8196.  
  8197.       DETACH  command <NULL> outfile 2>&1 
  8198.  
  8199.       where  command is the program to run and outfile is the name of the file 
  8200.       that contains output. To display the output of command, type  TYPE 
  8201.       outfile. Examine the information in outfile to make sure the expected 
  8202.       results were obtained. Information in outfile contains standard output or 
  8203.       error messages generated by running the program. 
  8204.  
  8205.       Guidelines for developing a program to be run remotely are: 
  8206.  
  8207.         -  The program must have an .EXE extension. 
  8208.  
  8209.         -  The program must be a noninteractive, nonvideo mode program using 
  8210.            standard input, output, and error file handles.  The program must 
  8211.            allow redirecting of these standard files. 
  8212.  
  8213.         -  The program must be able to be run in the background; that is, it 
  8214.            must be able to do batch (instead of online) processing. You should 
  8215.            be able to use the DETACH command on the program, as in the 
  8216.            preceding example. 
  8217.  
  8218.       The purpose of running a program remotely is to use the server's, rather 
  8219.       than the client's, resources to run a program. Besides using the server's 
  8220.       resources, the program to be run remotely does not inherit any 
  8221.       environment.  If you run a compiler, for example, environment variables 
  8222.       you have set in the server, such as BIN and INCLUDE, are not valid with 
  8223.       NET RUN. 
  8224.  
  8225.      You must do the following to run a program on a remote server: 
  8226.  
  8227.         -  Access a server with the Netrun service started. 
  8228.  
  8229.         -  Be sure the  runpath parameter in the Netrun section of the 
  8230.            IBMLAN.INI file specifies the path to the .EXE program file. All 
  8231.            other files must be in the working (current) directory. For more 
  8232.            information, refer to Performance Tuning. 
  8233.  
  8234.         -  Determine commands you can run on the server, and identify the 
  8235.            search path for these commands. 
  8236.  
  8237.         -  Assign a network drive to use as your current drive. 
  8238.  
  8239.      All files used as parameters must be relative to the server, not to your 
  8240.       workstation. 
  8241.  
  8242.  Be careful when granting access permissions to users for the RUNPATH 
  8243.  directory. If you allow users  create permission to files in the RUNPATH 
  8244.  directory, they will be able to install and run programs that normally require 
  8245.  administrator privilege.  This is possible because the program is running on 
  8246.  the server workstation and local API calls are not checked for authority level 
  8247.  unless Local Security is running. 
  8248.  
  8249.  
  8250. ΓòÉΓòÉΓòÉ 12. Managing Windows Applications for DOS LAN Services ΓòÉΓòÉΓòÉ
  8251.  
  8252. DOS LAN Services Windows allows users of Microsoft Windows 3.1 to access 
  8253. network files, printers, applications, and other services available on a OS/2 
  8254. Warp Server or LAN Server domain through the Windows interface. 
  8255.  
  8256. See the DLS and Windows User's Guide for information on DOS LAN Services 
  8257. Windows tasks such as logging on and off, using shared file resources and 
  8258. network printers, and sending messages. 
  8259.  
  8260. This chapter describes how to set up DOS LAN Services Windows shared 
  8261. applications on the server, run them from the client, and give user groups 
  8262. access to the applications. This chapter also contains information on 
  8263. application configuration environment variables, DOS LAN Services Windows 
  8264. dynamic link libraries (DLLs), and the DOS LAN Services Windows message pop-up 
  8265. facility. 
  8266.  
  8267. For more information, see the following topics: 
  8268.  
  8269.      Configuring for DOS LAN Services Windows Shared Applications 
  8270.  
  8271.      Application Configuration Environment Variables 
  8272.  
  8273.      WLRENV Environment Variable 
  8274.  
  8275.      WLRWORKDIR Environment Variable 
  8276.  
  8277.      DOS LAN Services Support Files for Windows 
  8278.  
  8279.  
  8280. ΓòÉΓòÉΓòÉ 12.1. Configuring for DOS LAN Services Windows Shared Applications ΓòÉΓòÉΓòÉ
  8281.  
  8282. Use the following procedures to set up DOS LAN Services Windows shared 
  8283. applications. 
  8284.  
  8285. To set up DOS LAN Services Windows shared applications: 
  8286.  
  8287. At the server: 
  8288.  
  8289.    1. Install the application.  Many Windows applications require installation 
  8290.       through the Windows interface (available through a WIN-OS/2 command 
  8291.       prompt). 
  8292.  
  8293.    2. Create a files alias for the directory containing the application. 
  8294.       Create additional aliases for any other network resources required by the 
  8295.       application.  See Using an Alias to Share a Resource. 
  8296.  
  8297.    3. Assign access permissions for the aliases.  See Creating an Access 
  8298.       Control Profile. 
  8299.  
  8300.    4. Define both DOS and Windows applications as DOS public applications.  See 
  8301.       Managing Network Applications. 
  8302.  
  8303.    5. At the client, specify environment variables as needed. See  Application 
  8304.       Configuration Environment Variables. 
  8305.  
  8306.    6. Specify network assignments to be made when the application starts 
  8307.       (optional). 
  8308.  
  8309.    7. Customize the application to meet your needs or the needs of your users. 
  8310.  
  8311.  At the DLS client running with Windows: 
  8312.  
  8313.    1. From the Program Manager window, open the  DOS LAN Services program 
  8314.       group. 
  8315.  
  8316.    2. Open the  DOS LAN Services icon. 
  8317.  
  8318.    3. Select  Applications from the menu bar. 
  8319.  
  8320.    4. Select  Shared Applications. If  Shared Applications is not selectable, 
  8321.       you must log on to the domain where applications are available; then 
  8322.       repeat this procedure from step  1. 
  8323.  
  8324.       After selecting  Shared Applications, the OS/2 Warp Server or LAN Server 
  8325.       Application Installation window is displayed, containing two lists and 
  8326.       four selections below the lists. The list on the left shows the LAN 
  8327.       applications. The list on the right shows the user groups. 
  8328.  
  8329.       To run a LAN application, first select the desired application, then 
  8330.       select  Run. 
  8331.  
  8332.       To add a shared LAN application to a user group, first select the 
  8333.       application and user group, then select  Add. 
  8334.  
  8335.       To create a user group, select  Create, complete the Description and 
  8336.       Group File fields, then select OK. 
  8337.  
  8338.  After a LAN application is installed into a Windows user group, you can either 
  8339.  move or copy the application into otherWindows user groups. You can start the 
  8340.  LAN application by opening its program icon. 
  8341.  
  8342.  
  8343. ΓòÉΓòÉΓòÉ 12.2. Application Configuration Environment Variables ΓòÉΓòÉΓòÉ
  8344.  
  8345. Certain applications manipulate resources and store data in ways that require 
  8346. you to alter the network environment to accommodate them. Generally, these 
  8347. applications require one or both of the following: 
  8348.  
  8349.      More environment space than the default 
  8350.  
  8351.      Their own working directories 
  8352.  
  8353.  For more information, see the following topics: 
  8354.  
  8355.      WLRENV Environment Variable 
  8356.  
  8357.      WLRWORKDIR Environment Variable 
  8358.  
  8359.  
  8360. ΓòÉΓòÉΓòÉ 12.2.1. WLRENV Environment Variable ΓòÉΓòÉΓòÉ
  8361.  
  8362. You can adjust the DOS Windows environment space by changing the WLRENV 
  8363. variable, which is 2048 bytes by default. Applications can require more or less 
  8364. than this amount. If you need to adjust the environment space, you must change 
  8365. the WLRENV variable before starting Windows. 
  8366.  
  8367. The format of the environment variable is: 
  8368.  
  8369. SET WLRENV=nnnn
  8370.  where  nnnn equals any value allowed by DOS. 
  8371.  
  8372. Use these steps to double the environment space for a Windows session: 
  8373.  
  8374.    1. At the DOS prompt, type  SET WLRENV=4096 and press Enter. 
  8375.  
  8376.    2. Start Windows by typing WIN and pressing Enter. 
  8377.  
  8378.  
  8379. ΓòÉΓòÉΓòÉ 12.2.2. WLRWORKDIR Environment Variable ΓòÉΓòÉΓòÉ
  8380.  
  8381. You can establish a working directory for a shared application that requires 
  8382. one.  DOS LAN Services Windows working directories can be set with a local 
  8383. environment variable at a workstation to allow the user to override the one 
  8384. defined by the administrator. 
  8385.  
  8386. Note:  This environment variable overrides any working directory assignment 
  8387.        associated with the shared application.  It is not required. 
  8388.  
  8389.  If the WLRWORKDIR environment variable is set to some nonempty string, the 
  8390.  value of this environment variable sets the working directory. For example, if 
  8391.  you enter the DOS command SET WLRWORKDIR=C:\HOME, the system sets the current 
  8392.  directory to C:\HOME. 
  8393.  
  8394.  The format of the WLRWORKDIR variable is: 
  8395.  
  8396.   WLRWORKDIR=d:\symbol
  8397.   where  d is either defined as the logical drive or specified with the  %w 
  8398.  symbol. The following predefined symbols increase the flexibility of this 
  8399.  variable.  If any of these predefined symbols are present in the WLRWORKDIR 
  8400.  string, they are replaced with other characters before the working directory 
  8401.  is set.  If no drive letter or drive letter variable is specified, the default 
  8402.  is the current drive. 
  8403.  
  8404.  The following list shows predefined symbols. 
  8405.  
  8406.   Symbol    Substitution
  8407.  
  8408.  %w        Drive letter for the application working directory (as defined at 
  8409.            the server and connected at program startup) 
  8410.  
  8411.  %p        Drive letter for the application program directory (as defined at 
  8412.            the server and connected at program startup) 
  8413.  
  8414.  %a        Application's program alias 
  8415.  
  8416.  %u        Logged-on user's user ID 
  8417.  
  8418.  %d        Logged-on user's OS/2 Warp Server or LAN Server domain 
  8419.  
  8420.  %%        % 
  8421.  
  8422.  The following example sets the working directory at program startup to C:\ 
  8423.  userid\ program-alias: 
  8424.  
  8425.   WLRWORKDIR=C:\%u\%a
  8426.  
  8427.  This example would support a convention where users have a user name directory 
  8428.  at their workstations with a program-specific subdirectory below it. 
  8429.  
  8430.  The following example sets the working directory at program startup to the 
  8431.  program working directory (as defined at the server) plus a user-specific 
  8432.  subdirectory named the same as the logged-on user ID: 
  8433.  
  8434.   WLRWORKDIR=%w:\%u
  8435.  
  8436.  Notes: 
  8437.  
  8438.    1. The case of the predefined symbols is significant; you must type them in 
  8439.       lowercase for substitution to occur. 
  8440.  
  8441.    2. Predefined symbols and characters to be interpreted can be combined in 
  8442.       whatever order is useful for your installation, as long as the resulting 
  8443.       string, after substitution, defines a valid path. If a drive letter is 
  8444.       not given as part of the expanded WLRWORKDIR value, the string is 
  8445.       interpreted as a subdirectory below the current directory, the same as 
  8446.       though a change directory (CD) command were issued from DOS. 
  8447.  
  8448.    3. After a substitution of special symbols, the specified working directory 
  8449.       must exist on the specified drive or below the current directory if no 
  8450.       drive is specified. The directory is not created automatically when 
  8451.       starting the application. If the given directory does not exist, the 
  8452.       working directory is not set properly. 
  8453.  
  8454.       This method of setting the working directory is not supported by the 
  8455.       non-Windows version of DOS LAN Services. 
  8456.  
  8457.  
  8458. ΓòÉΓòÉΓòÉ 12.3. DOS LAN Services Support Files for Windows ΓòÉΓòÉΓòÉ
  8459.  
  8460. The following sections describe the DOS LAN Services Windows interface and the 
  8461. Windows message pop-up facility. 
  8462.  
  8463. For more information, see the following topics: 
  8464.  
  8465.      Windows Network InterfaceWindows Network Interface 
  8466.  
  8467.      Message Pop-Up Facility Message Pop-Up Facility 
  8468.  
  8469.  
  8470. ΓòÉΓòÉΓòÉ 12.3.1. Windows Network Interface ΓòÉΓòÉΓòÉ
  8471.  
  8472. In Windows, DOS LAN Services requires the following data link library files 
  8473. (DLLs) to perform network tasks such as displaying active servers, browsing 
  8474. available resources, and managing printer queues: 
  8475.  
  8476.      NETAPI.DLL 
  8477.  
  8478.      PMSPL.DLL 
  8479.  
  8480.  The following files provide the connection betweenDOS LAN Services and 
  8481.  Windows: 
  8482.  
  8483.      WINDLS.DLL 
  8484.  
  8485.      DLSNET.EXE 
  8486.  
  8487.      RUNLSAPP.EXE 
  8488.  
  8489.      DLSNET.DRV 
  8490.  
  8491.  The files in both lists, plus the DLSNET.HLP and WINPOPUP.EXE files, are 
  8492.  provided on the DOS LAN Services diskettes and are installed with DOS LAN 
  8493.  Services. 
  8494.  
  8495.  If your application uses DLL files, you can specify a working directory. 
  8496.  
  8497.  
  8498. ΓòÉΓòÉΓòÉ 12.3.2. Message Pop-Up Facility ΓòÉΓòÉΓòÉ
  8499.  
  8500. The message pop-up facility for Windows is WINPOPUP.EXE. The WINPOPUP.EXE file 
  8501. works in conjunction with the NET START command. The messaging pop-up is loaded 
  8502. into memory with the NET START NETPOPUP command or with the NET START command 
  8503. if NETPOPUP is on the autostart line of the NETWORK.INI file.  The WINPOPUP.EXE 
  8504. file displays received messages while the Windows GUI is active. 
  8505.  
  8506.  
  8507. ΓòÉΓòÉΓòÉ 13. Network Printing ΓòÉΓòÉΓòÉ
  8508.  
  8509. Network printers are managed through individual printer objects (objects that 
  8510. represent a physical printer, its printer driver, queue, and other settings). 
  8511. By default, printer objects are created as printer queues.  You can manage 
  8512. printer objects on remote servers, from any client, by accessing the printer 
  8513. object from the Network folder. 
  8514.  
  8515. An administrator, or a user with Print operator privilege, can manage any print 
  8516. job, printer queue, or printer object.  Users can hold, release, and cancel 
  8517. their own print jobs. You can also allow a user to manage network printing. 
  8518.  
  8519. This chapter provides some examples of how to install a printer at a server and 
  8520. how to manage network printers using OS/2 Warp Server or LAN Server. For more 
  8521. information about printer objects and the Network folder, see the OS/2 Desktop 
  8522. Guide . 
  8523.  
  8524. For more information, see the following topics: 
  8525.  
  8526.      How to Grant Print Operator Privileges to a User 
  8527.  
  8528.      Printing from a Client 
  8529.  
  8530.      Installing a Network Printer at a Server 
  8531.  
  8532.      Managing Network Printers 
  8533.  
  8534.      Example:  Setting Up a Printer Object for a 4019 Printer at the Server 
  8535.  
  8536.      Example:  Creating a Network Printer Object for an OS/2 Client 
  8537.  
  8538.  
  8539. ΓòÉΓòÉΓòÉ 13.1. How to Grant Print Operator Privileges to a User ΓòÉΓòÉΓòÉ
  8540.  
  8541. A user with operator privileges has certain administrative capabilities but is 
  8542. not a full administrator.  A user may have one or more operator privileges, 
  8543. including the Print operator privilege. The Print operator privilege permits a 
  8544. user to manage printer queues and print jobs remotely. The user can, either 
  8545. from the command line or from a Print object, create, modify, and delete 
  8546. printers and queues. The user can also share printer queues and manage remote 
  8547. jobs on shared queues. 
  8548.  
  8549. Operator privileges are part of the accounts database and are replicated within 
  8550. a domain.  The following procedure shows how to grant a user Print operator 
  8551. privilege through the OS/2 Warp Server Administration. 
  8552.  
  8553. To grant or revoke Print operator privilege for a user: 
  8554.  
  8555.    1. Open  OS/2 Warp Server Administration. 
  8556.  
  8557.    2. Open the domain object. 
  8558.  
  8559.    3. Open  User Accounts. 
  8560.  
  8561.       The User Accounts folder is displayed. 
  8562.  
  8563.    4. Open the user account for which you want to change privileges. 
  8564.  
  8565.       The first properties page is displayed. 
  8566.  
  8567.    5. Select the  Privileges tab. 
  8568.  
  8569.       The Privilege page is displayed: 
  8570.  
  8571.    6. Select  User. 
  8572.  
  8573.       This choice denies administrator permissions to the user. 
  8574.  
  8575.    7. Select  Print - Manage printer queues in the Special Privileges list to 
  8576.       grant Print operator privilege. 
  8577.  
  8578.       Deselect the check box to revoke the privilege. 
  8579.  
  8580.    8. Select  Set or  Apply. 
  8581.  
  8582.  A system administrator can also use the NET USER command to grant or revoke 
  8583.  Print operator privileges to users. For example, to give the Print operator 
  8584.  privilege to a user, type: 
  8585.  
  8586.   NET USER userid /OPERATOR:PRINT
  8587.  
  8588.  Note:  In the previous example, the NET USER command runs at either the domain 
  8589.         controller or in combination with the NET ADMIN command directed to the 
  8590.         domain controller. 
  8591.  
  8592.  See the Command Reference for more information about the NET USER command and 
  8593.  operator privileges. 
  8594.  
  8595.  
  8596. ΓòÉΓòÉΓòÉ 13.2. Printing from a Client ΓòÉΓòÉΓòÉ
  8597.  
  8598. When you submit a print request on the network, your print job is added to the 
  8599. queue belonging to the printer object or port you selected, and the data is 
  8600. stored on the server's hard disk until the job has been printed.  OS/2 Warp 
  8601. Server and LAN Server support various types of printing. You can print from the 
  8602. desktop using direct manipulation.  You can print outside the desktop using 
  8603. OS/2 and NET commands, or you can print from an application. 
  8604.  
  8605. Printer objects, which are operating system components, allow you to see all 
  8606. the print jobs for selected queues and hold, release, or cancel any job you 
  8607. submitted.  You can access remote printer objects through the Network folder. 
  8608. See the OS/2 Desktop Guide for more information about printing from the desktop 
  8609. and managing your print jobs. 
  8610.  
  8611. Note:  When printing from a LAN Requester to a network printer, both the LAN 
  8612.        Requester and server must have the same level printer driver. 
  8613.  
  8614.  For more information, see the following topics: 
  8615.  
  8616.      Printing Using OS/2 and NET Commands 
  8617.  
  8618.      Printing from a Presentation Manager Application 
  8619.  
  8620.  
  8621. ΓòÉΓòÉΓòÉ 13.2.1. Printing Using OS/2 and NET Commands ΓòÉΓòÉΓòÉ
  8622.  
  8623. You can print text files using the OS/2 COPY command or the NET COPY command. 
  8624. If you want to send a print job across the LAN, then you only need to use a 
  8625. shared printer object.  No other setup is required. 
  8626.  
  8627. The following example shows how to use the OS/2 COPY command to print a file 
  8628. named REPORT.TXT on the printer associated with the printer port LPT3. Connect 
  8629. to the printer by assigning LPT3 to the network printer with the NET USE 
  8630. command.  For example, to connect to the printer named PR3812 on the server 
  8631. named DEPT452, you would type: 
  8632.  
  8633. NET USE LPT3 \\DEPT452\PR3812
  8634.  
  8635. To print the file from LPT3, type: 
  8636.  
  8637. COPY REPORT.TXT LPT3
  8638.  
  8639. The following example shows how to use the NET COPY command to print a file 
  8640. named REPORT.TXT on the printer associated with the shared printer object 
  8641. PRINTQ on the server LASER1: 
  8642.  
  8643. NET COPY REPORT.TXT \\LASER1\PRINTQ
  8644.  
  8645.  
  8646. ΓòÉΓòÉΓòÉ 13.2.2. Printing from a Presentation Manager Application ΓòÉΓòÉΓòÉ
  8647.  
  8648. Printing from a Presentation Manager application requires that you select a 
  8649. printer object name instead of a port.  The Enhanced Editor is an example of an 
  8650. application that requires you to select a printer object name. 
  8651.  
  8652. For information about setting up to print on a network printer from a 
  8653. Presentation Manager application, see the OS/2 Desktop Guide. 
  8654.  
  8655.  
  8656. ΓòÉΓòÉΓòÉ 13.3. Installing a Network Printer at a Server ΓòÉΓòÉΓòÉ
  8657.  
  8658. Network printing uses the printer object functions of the operating system as 
  8659. well as of OS/2 Warp Server or LAN Server. Complete the following tasks to 
  8660. install a network printer. 
  8661.  
  8662. To install a network printer at the server: 
  8663.  
  8664.    1. Attach the printer to the print server. Refer to the documentation that 
  8665.       came with your printer for more information. 
  8666.  
  8667.    2. Create a printer object. See  Creating a Printer Object for more 
  8668.       information. 
  8669.  
  8670.       If necessary, install a printer driver that matches the attached printer. 
  8671.       See  Installing a Printer Driver for more information. 
  8672.  
  8673.    3. From the printer object, change the print properties as needed. 
  8674.  
  8675.    4. From the graphical user interface, share the printer object. See 
  8676.       Creating a Printer Alias for information about creating the alias and 
  8677.       giving users appropriate access. 
  8678.  
  8679.  For more information, see the following topic: 
  8680.  
  8681.      Installing and Configuring Network Printers for DLS WindowsInstalling and 
  8682.       Configuring Network Printers for DLS Windows 
  8683.  
  8684.  
  8685. ΓòÉΓòÉΓòÉ 13.3.1. Installing and Configuring Network Printers for DLS Windows ΓòÉΓòÉΓòÉ
  8686.  
  8687. To use a network printer from DOS LAN Services running on Microsoft Windows, 
  8688. you must install the appropriate printer driver on each workstation. To do so, 
  8689. follow these steps: 
  8690.  
  8691. To install a network printer at a DLS Windows workstation: 
  8692.  
  8693.    1. Select  Control Panel from the Program Manager window. 
  8694.  
  8695.    2. Select  Printers. 
  8696.  
  8697.    3. Select  Add Printer. 
  8698.  
  8699.    4. Select the printer driver for the network printer you want to use from 
  8700.       the  List of Printers list. 
  8701.  
  8702.    5. Select  Install. 
  8703.  
  8704.       If the driver already exists, select  Current from the Printers-Configure 
  8705.       window. 
  8706.  
  8707.       If the driver does not exist, you are prompted to insert the appropriate 
  8708.       Windows diskette. 
  8709.  
  8710.    6. Select  Configure from the Printers window. 
  8711.  
  8712.    7. Select any port for the printer you are configuring, and then select 
  8713.       Setup. 
  8714.  
  8715.       Note:  Even though DLS Windows requires that you specify a port here, 
  8716.              your choice has no effect on how the network printer is connected. 
  8717.  
  8718.    8. Complete the information for the printer you have selected in the 
  8719.       Printers window, and then select  OK. 
  8720.  
  8721.    9. Select  OK. 
  8722.  
  8723.   10. Select the new printer from the Printers-Configure window, and then 
  8724.       select  Active from the Status list. 
  8725.  
  8726.   11. To make the new printer the default printer, select it, and then select 
  8727.       OK to exit the Printers window. 
  8728.  
  8729.  
  8730. ΓòÉΓòÉΓòÉ 13.4. Managing Network Printers ΓòÉΓòÉΓòÉ
  8731.  
  8732. You can send print jobs to printer objects according to general criteria, such 
  8733. as file size.  For example, you can set up one printer object for large jobs 
  8734. and another printer object for small jobs.  Each job waits in the queue 
  8735. associated with the printer object until the job prints on one of the printers 
  8736. that the printer object uses.  You can define a printer object to use just one 
  8737. printer or, to make better use of available resources, to use several printers 
  8738. at once (called pooling printers).  For information about pooling printers, see 
  8739. the OS/2 Desktop Guide. 
  8740.  
  8741. You can specify several network options for printer objects that are shared on 
  8742. the network; for example, a separator page file queue start and stop time and 
  8743. the refresh interval. 
  8744.  
  8745. You can hold or release a printer object.  You can also hold, release, or 
  8746. cancel particular jobs within a printer object.  You can remotely manage 
  8747. printer objects by accessing the printer object from the Network folder. 
  8748.  
  8749. For more information, see the following topics: 
  8750.  
  8751.      Updating OS/2 Printer Object Settings 
  8752.  
  8753.      Description of Printer Settings 
  8754.  
  8755.  
  8756. ΓòÉΓòÉΓòÉ 13.4.1. Updating OS/2 Printer Object Settings ΓòÉΓòÉΓòÉ
  8757.  
  8758. Perform the following procedure to update printer settings. You can change the: 
  8759.  
  8760.      Way in which the printer queue is displayed 
  8761.  
  8762.      Frequency with which the display of the printer queue is refreshed 
  8763.  
  8764.      File that contains the page that separates print jobs 
  8765.  
  8766.      Time at which a print job must start or end 
  8767.   Refer to  Description of Printer Settings for a description of the settings. 
  8768.  
  8769.  To update printer settings: 
  8770.  
  8771.    1. Select the printer object you want to update.  To make changes at a 
  8772.       remote server, select the printer object from the Network folder. 
  8773.  
  8774.    2. Press mouse button 2 to display the pop-up menu for the printer object. 
  8775.  
  8776.    3. Select  Properties. 
  8777.  
  8778.       To specify network job view: 
  8779.  
  8780.         a. Select the  View tab. 
  8781.  
  8782.         b. Select either  Show all jobs or  Show own jobs. 
  8783.  
  8784.       To specify the refresh interval: 
  8785.  
  8786.         a. Select the  View tab. 
  8787.  
  8788.         b. Specify a refresh interval in seconds. 
  8789.  
  8790.       To specify the separator file: 
  8791.  
  8792.         a. Select the  Print options tab. 
  8793.  
  8794.         b. Specify a separator file name. 
  8795.  
  8796.       To specify the start time and stop time: 
  8797.  
  8798.         a. Select the  Print options tab. 
  8799.  
  8800.         b. Specify a start time and stop time. 
  8801.  
  8802.  
  8803. ΓòÉΓòÉΓòÉ 13.4.2. Description of Printer Settings ΓòÉΓòÉΓòÉ
  8804.  
  8805. Following are the descriptions of some of the printer settings that can be set 
  8806. for remote printer objects.  There are other settings not listed that are used 
  8807. to manage the local printer at the server. Refer to the OS/2 Desktop Guide  for 
  8808. more information about changing these local printer settings. 
  8809.  
  8810.   Option              Description
  8811.  
  8812.  Network job view    Specifies whether all jobs or only jobs owned by the user 
  8813.                      are displayed in icon or detail view.  This item is not 
  8814.                      available if the printer object is not remote. 
  8815.  
  8816.  Refresh interval    Sets the rate at which the printer object window is 
  8817.                      refreshed with the latest network jobs.  The default rate 
  8818.                      is 45 seconds. Local jobs are updated as status changes 
  8819.                      occur. 
  8820.  
  8821.  Separator file      Specifies a file name containing information about the 
  8822.                      separator page used for network print jobs.  This 
  8823.                      separator page prints before each job. It can contain, for 
  8824.                      example, a user ID, a job number, and the time the job is 
  8825.                      printed. 
  8826.  
  8827.  Start time          Specifies when the printer object starts printing jobs. 
  8828.                      Specify this option as a time in 24-hour  hh:mm format. If 
  8829.                      the start time and stop time are the same, the printer 
  8830.                      object prints continuously. 
  8831.  
  8832.  Stop time           Specifies when the printer object stops printing jobs. 
  8833.                      Specify this option as a time in 24-hour  hh:mm format. 
  8834.  
  8835.  
  8836. ΓòÉΓòÉΓòÉ 13.5. Example:  Setting Up a Printer Object for a 4019 Printer at the Server ΓòÉΓòÉΓòÉ
  8837.  
  8838. DBCS Note  The 4019 printer is not used on DBCS systems.  However, you can use 
  8839.            this example as a procedure for setting up a printer object for 
  8840.            other printers used with your system. 
  8841.  
  8842.  Following are the tasks for installing a 4019 printer using a parallel (LPT) 
  8843.  port. 
  8844.  
  8845.  For more information, see the following topics: 
  8846.  
  8847.      Creating a Printer ObjectCreating a Printer Object 
  8848.  
  8849.      Installing a Printer DriverInstalling a Printer Driver 
  8850.  
  8851.      Creating a Printer AliasCreating a Printer Alias 
  8852.  
  8853.  
  8854. ΓòÉΓòÉΓòÉ 13.5.1. Creating a Printer Object ΓòÉΓòÉΓòÉ
  8855.  
  8856. Use the next procedure to create an object for the printer. 
  8857.  
  8858. To create a printer object: 
  8859.  
  8860.    1. Open the  Templates folder on the desktop. 
  8861.  
  8862.    2. Select the  Printer template, drag it to a folder or an available space 
  8863.       on your desktop, and drop it. 
  8864.  
  8865.    3. Complete the Create a Printer window: 
  8866.  
  8867.                  Field               Value
  8868.  
  8869.       Name                     LASER1 
  8870.  
  8871.       Default printer driver   (Accept the default) 
  8872.  
  8873.       Output port              LPT1 
  8874.  
  8875.    4. Select  Create when you are finished. 
  8876.  
  8877.  
  8878. ΓòÉΓòÉΓòÉ 13.5.2. Installing a Printer Driver ΓòÉΓòÉΓòÉ
  8879.  
  8880. You must now associate the printer object with the printer driver that matches 
  8881. the printer attached to the server. 
  8882.  
  8883. To install a printer driver: 
  8884.  
  8885.    1. Place your cursor on the  LASER1 printer object and press mouse button 2 
  8886.       to display the pop-up menu. 
  8887.  
  8888.    2. Select  Properties. 
  8889.  
  8890.       The first properties page is displayed. 
  8891.  
  8892.    3. Select the  Printer Driver tab. 
  8893.  
  8894.       DBCS Note  The following statement about the IBM 4019 LaserPrinter does 
  8895.                  not apply to DBCS systems. 
  8896.  
  8897.       If the IBM 4019 LaserPrinter is already included in the list of printer 
  8898.       drivers, select it and close the notebook. The printer driver is 
  8899.       installed. 
  8900.  
  8901.       If it is not included in the list, continue with the rest of this 
  8902.       procedure to install the printer driver. 
  8903.  
  8904.    4. Press mouse button 2 to display the pop-up menu for a printer driver. 
  8905.  
  8906.    5. Select  Install. 
  8907.  
  8908.       A list of OS/2 printer drivers is displayed in the Install New Printer 
  8909.       Driver window.  Scroll through the list of printer drivers until you 
  8910.       reach IBM 4019 LaserPrinter. 
  8911.  
  8912.       DBCS Note  Scroll through the list of printers until you reach the 
  8913.                  printer you want to install.  Substitute your printer for the 
  8914.                  IBM 4019 LaserPrinter. 
  8915.  
  8916.    6. Select the IBM 4019 printer driver and then select  Install. 
  8917.  
  8918.    7. Follow the instructions on the next window and insert the requested 
  8919.       printer driver diskettes and select  OK. 
  8920.  
  8921.       Note:  If you are installing the drivers from a CD-ROM, type the path to 
  8922.              the OS/2 printer drivers instead of inserting diskettes. 
  8923.  
  8924.    8. Select  OK when you are notified that the printer driver has been 
  8925.       installed successfully. 
  8926.  
  8927.    9. Select  Cancel from the Install New Printer Driver window when you are 
  8928.       finished installing printer drivers. 
  8929.  
  8930.  
  8931. ΓòÉΓòÉΓòÉ 13.5.3. Creating a Printer Alias ΓòÉΓòÉΓòÉ
  8932.  
  8933. Printer aliases are nicknames for printer objects that are redirected to 
  8934. network printers.  You can use aliases to represent shared printers, and you 
  8935. can create access control profiles for the aliases.  Access control profiles 
  8936. specify what users or groups can access the printer. 
  8937.  
  8938. Perform the following steps to create a printer alias. The server where the 
  8939. printer resides must be started and you must be logged on as an administrator. 
  8940.  
  8941. To create an alias for a printer: 
  8942.  
  8943.    1. Open  LAN Server Administration. 
  8944.  
  8945.    2. Open the domain object in which you want to create the alias. 
  8946.  
  8947.    3. Open  Resource Definitions. 
  8948.  
  8949.       The Resource Definitions folder is displayed. 
  8950.  
  8951.  
  8952.             Resource Definitions Folder
  8953.  
  8954.    4. Drag the  Printer Template to a convenient location in the folder. 
  8955.  
  8956.       The first properties page is displayed. 
  8957.  
  8958.  
  8959.             Printer Alias Identity Page
  8960.  
  8961.    5. Type an alias name in the  Alias field. 
  8962.  
  8963.    6. If you want, type a description in the  Description field. 
  8964.  
  8965.    7. Select or type a server name: 
  8966.  
  8967.         a. If the server where the resource is located is in this domain, 
  8968.            select one of the server names in the  Server name field. 
  8969.  
  8970.         b. If the server where the resource is located is in another domain, 
  8971.            type the name of that server in the  Server name field. 
  8972.  
  8973.    8. Select or type a spooler queue name. The spooler queue name is the 
  8974.       physical name of the printer queue which is displayed in the Properties 
  8975.       notebook for the printer object. 
  8976.  
  8977.    9. Complete the Identity page. 
  8978.  
  8979.   10. Select  Create. 
  8980.  
  8981.           If there is no access control profile, a message is displayed 
  8982.            prompting you to create one. Select  OK to create the access 
  8983.            profile. 
  8984.  
  8985.            The Identity page of the Access Control Profile notebook is 
  8986.            displayed. 
  8987.  
  8988.           If there is an access profile, no message is displayed. The Identity 
  8989.            page of the Access Control Profile notebook is displayed.  See 
  8990.       Defining Access Control Profiles for information about access control 
  8991.       profiles. 
  8992.  
  8993.  
  8994.             Access Control Profile Window
  8995.  
  8996.   11. Complete the pages in the Access Control Profile notebook. 
  8997.  
  8998.       Give the users and groups who need to use the printer Create (C) 
  8999.       permission. 
  9000.  
  9001.   12. Select  Create or  Set to close the notebook. 
  9002.  
  9003.  
  9004. ΓòÉΓòÉΓòÉ 13.6. Example:  Creating a Network Printer Object for an OS/2 Client ΓòÉΓòÉΓòÉ
  9005.  
  9006. The following example illustrates the steps required for an administrator and a 
  9007. user to set up a network printer object on an OS/2 client. The printer driver 
  9008. for the network printer needs to be installed on the OS/2 client workstation. 
  9009.  
  9010. If the user does not have the correct printer driver installed, you can give 
  9011. the user the printer driver diskettes or share the directory where the printer 
  9012. drivers are contained on the server so they can be downloaded from the server. 
  9013.  
  9014. The first part of the following example illustrates how to create the shared 
  9015. directory so users can download the printer drivers to their workstation. The 
  9016. second part illustrates how to add the network printer object to the user's 
  9017. desktop. 
  9018.  
  9019. To set up a shared directory for printer drivers: 
  9020.  
  9021. The following steps are performed by the network administrator on the server. 
  9022. In our example, the 4019 network printer is attached to the server DONSRV. 
  9023.  
  9024.    1. Using LAN Server Administration, create an alias of 4019PRT for the 
  9025.       network printer and create an access control profile to share the alias. 
  9026.       Give users Create (C) access to the alias.  See  Creating an Alias for 
  9027.       steps on creating an alias and access control profile. 
  9028.  
  9029.    2. Create a directory named C:\DRIVERS on the server.  Copy all the OS/2 
  9030.       printer driver files from the OS/2 printer driver diskettes or CD-ROM 
  9031.       into the directory. 
  9032.  
  9033.    3. Create a directory alias named PRTDRIV for the C:\DRIVERS directory 
  9034.       containing the printer drivers.  Create an access control profile for the 
  9035.       directory alias and give users Read (R) access. 
  9036.  
  9037.  Note:  The printer drivers used by the server are actually stored in the 
  9038.         C:\OS2\DLL\IBM4019 directory on the server DONSRV; however the alias 
  9039.         PRTDRIV points to the directory named C:\DRIVERS which contains  copies 
  9040.         of the drivers. 
  9041.  
  9042.  To add the printer object to a user's desktop: 
  9043.  
  9044.  The following steps are performed by the administrator or user at the OS/2 
  9045.  client. 
  9046.  
  9047.    1. Open the  Templates folder on the desktop. 
  9048.  
  9049.    2. Drag and drop the Network Printer template onto an open area of the 
  9050.       desktop. 
  9051.  
  9052.       The Access Another Network Printer window is displayed. 
  9053.  
  9054.       Note:  You can also drag and drop the Network Printer template into the 
  9055.              Network folder, where the network servers and aliases reside. 
  9056.  
  9057.    3. Complete the  Server field by selecting the down arrow at the right of 
  9058.       the Printer field to select a server or type the name of the server where 
  9059.       the 4019 is attached.  In this example, the server is named DONSRV. 
  9060.  
  9061.    4. In the  Resource field, select the down arrow to select a queue name or 
  9062.       type the queue name. In this example, you would select 4019PRT. 
  9063.  
  9064.    5. Select  OK. 
  9065.  
  9066.    6. If a printer driver has not been installed, a window is displayed 
  9067.       prompting you to install one. Select  Install. 
  9068.  
  9069.    7. The next window prompts you to insert a diskette or type in the directory 
  9070.       where the printer driver can be found. 
  9071.  
  9072.       Because an alias (PRTDRIV) exists for a directory containing copies of 
  9073.       printer drivers for a 4019 printer on the DONSRV server, type: 
  9074.  
  9075.             \\DONSRV\PRTDRIV
  9076.  
  9077.       The printer drivers are installed on the OS/2 client and the Network 
  9078.       Printer object is added to the user's desktop. 
  9079.  
  9080.  
  9081. ΓòÉΓòÉΓòÉ 14. Managing the Network ΓòÉΓòÉΓòÉ
  9082.  
  9083. Several OS/2 Warp Server or LAN Server functions allow you to manage the 
  9084. network effectively. You need not be at a server to complete most 
  9085. administrative tasks.  You can complete most tasks, even those involving server 
  9086. changes, from any OS/2 LAN Requester on the domain. 
  9087.  
  9088. For more information, see the following topics: 
  9089.  
  9090.      Managing Network Services 
  9091.  
  9092.      Updating Parameters 
  9093.  
  9094.      Viewing and Closing Open Files 
  9095.  
  9096.      Viewing and Deleting Active Sessions 
  9097.  
  9098.      Using Statistics 
  9099.  
  9100.      Auditing 
  9101.  
  9102.      Accessing Error Logs 
  9103.  
  9104.      DOS and OS/2 Command Restrictions 
  9105.  
  9106.      Managing More Than One Domain 
  9107.  
  9108.      First Failure Support Technology/2 (FFST/2) 
  9109.  
  9110.  
  9111. ΓòÉΓòÉΓòÉ 14.1. Managing Network Services ΓòÉΓòÉΓòÉ
  9112.  
  9113. Network services are programs that are part of OS/2 Warp Server or LAN Server. 
  9114. The available programs are identified in the\IBMLAN\IBMLAN.INI file. To control 
  9115. which services are started at startup, edit the IBMLAN.INI file on your 
  9116. workstation. Refer to Performance Tuning for more information. 
  9117.  
  9118. Temporary changes to network services can be made through the OS/2 Warp Server 
  9119. Administration or the command line (instead of editing the IBMLAN.INI file). 
  9120.  
  9121. Users can start and stop services available on their workstations. Some 
  9122. services can also be paused and continued. 
  9123.  
  9124. The network services are briefly described in the following list. (For detailed 
  9125. descriptions of the services and information on their parameters, see 
  9126. Performance Tuning.) 
  9127.  
  9128.  Alerter             Notifies selected user IDs when problems occur. It also 
  9129.                      notifies the Generic Alerter service when certain LAN 
  9130.                      problems are detected or anticipated. This service cannot 
  9131.                      be paused. 
  9132.  
  9133.  DCDB Replicator     Copies the domain control database from a primary domain 
  9134.                      controller to one or more backup domain controllers. 
  9135.  
  9136.  Generic Alerter     Enables the server to build and send Systems Network 
  9137.                      Architecture (SNA) alerts.  The Alerter service notifies 
  9138.                      the Generic Alerter service when certain LAN problems 
  9139.                      occur. This service cannot be paused. 
  9140.  
  9141.  LSserver            Provides DOS LAN Services support and logical server 
  9142.                      functions.  The logical server supports remote requests 
  9143.                      from clients for activities such as spooling, querying 
  9144.                      users, logon, and logoff.  The default value for LSserver 
  9145.                      is to start when OS/2 Warp Server or LAN Server is 
  9146.                      installed. The user should never change the default. If 
  9147.                      you stop LSserver, the Server service automatically stops. 
  9148.                      Therefore, this service should never be stopped and cannot 
  9149.                      be paused. 
  9150.  
  9151.  Messenger           Supports the receiving of messages at a client or server. 
  9152.                      This service cannot be paused. 
  9153.  
  9154.  NetLogon            Copies the master user and group definitions file located 
  9155.                      on the domain controller to network servers. This service 
  9156.                      is available only on servers. 
  9157.  
  9158.                      In order for the NetLogon service to replicate user and 
  9159.                      group definitions across servers in a domain, digit 3 of 
  9160.                      the srvheuristics parameter (on domain controllers) and 
  9161.                      digit 8 of the wrkheuristics parameter (on additional 
  9162.                      servers) must be left at their default values. If you 
  9163.                      change the defaults for these parameters, user and group 
  9164.                      data may not be replicated from the domain controller, 
  9165.                      resulting in unknown user IDs or group IDs on the 
  9166.                      additional servers. See  Domain User and Group Definitions 
  9167.                      for more information on using the NetLogon service. 
  9168.  
  9169.  Netrun              Handles requests for running programs remotely on a 
  9170.                      server. 
  9171.  
  9172.  Network Neighborhood Browser Enabler Allows OS/2 Warp Server to function as a 
  9173.                      master browser for Windows Clients. The master browser 
  9174.                      function provides Windows 95 and Windows NT clients the 
  9175.                      ability to view the domain's LAN Server machines and their 
  9176.                      resources via the Network Neighborhood object. 
  9177.  
  9178.  Peer                Allows one client to share resources with another.  This 
  9179.                      service gives a client some of the capabilities of a 
  9180.                      server. You can administer a Peer server remotely. For 
  9181.                      information, see the Command Reference. 
  9182.  
  9183.  Remote IPL          Allows the Server service to support remote initial 
  9184.                      program load (remote IPL) of workstations. This service 
  9185.                      corresponds to the Remoteboot section of the IBMLAN.INI 
  9186.                      file. 
  9187.  
  9188.  Replicator          Copies files from a master location on a server to one or 
  9189.                      more servers or clients requiring a copy of the data. 
  9190.                      This service cannot be paused. 
  9191.  
  9192.  client              Redirects requests for files, printers, and serial devices 
  9193.                      from one workstation to another workstation. 
  9194.  
  9195.  Server              Receives and responds to network requests for files, 
  9196.                      printers, and serial devices. The service checks the 
  9197.                      requests against its database of user IDs and access 
  9198.                      permissions. 
  9199.  
  9200.  Timesource          Designates a server as a source of a reliable time and 
  9201.                      date with which other workstations on the network can 
  9202.                      synchronize. The Timesource service does not keep time. It 
  9203.                      allows other workstations on the network to identify a 
  9204.                      server with a reliable clock.  The default value for the 
  9205.                      Timesource service is to start on domain controllers when 
  9206.                      OS/2 Warp Server or LAN Server is installed.  This service 
  9207.                      cannot be paused. 
  9208.  
  9209.  UPS                 Provides protection against power failure.  If power is 
  9210.                      interrupted, the UPS service keeps the server running 
  9211.                      until the service can shut down the server safely or until 
  9212.                      an administrator stops the server. 
  9213.  
  9214.  For more information, see the following topics: 
  9215.  
  9216.      Network Service Status 
  9217.  
  9218.      Starting a Network Service 
  9219.  
  9220.      Stopping a Network Service 
  9221.  
  9222.      Pausing a Network Service 
  9223.  
  9224.      Continuing a Network Service 
  9225.  
  9226.      Shutting Down the Domain Controller 
  9227.  
  9228.  
  9229. ΓòÉΓòÉΓòÉ 14.1.1. Network Service Status ΓòÉΓòÉΓòÉ
  9230.  
  9231. The list below shows network service status types. 
  9232.  
  9233.   Status              Meaning
  9234.  
  9235.  Started and active  The service is running normally. 
  9236.  
  9237.  Not started         The service has not been started. 
  9238.  
  9239.  Started and paused  The service has been stopped temporarily. 
  9240.  
  9241.  Started with pause pending The service is about to pause. 
  9242.  
  9243.  Started with continue pending The service is about to continue after being 
  9244.                      paused. 
  9245.  
  9246.  Stopping            The service is about to stop. 
  9247.  
  9248.  Starting            The service is about to start. 
  9249.  
  9250.  Through LAN Server Administration, you can manage network services and make 
  9251.  temporary changes to the services' parameters. Such changes remain in effect 
  9252.  until the service is stopped or the value is overridden. You can change the 
  9253.  state of services on your own workstation and on any server in the domain. 
  9254.  However, to make parameter changes take effect each time the network software 
  9255.  starts, you must edit the IBMLAN.INI file. For more information, refer to 
  9256.  Performance Tuning. 
  9257.  
  9258.  For more information, see the following topic: 
  9259.  
  9260.      Guidelines for Stopping and Pausing Network Services 
  9261.  
  9262.  
  9263. ΓòÉΓòÉΓòÉ 14.1.1.1. Guidelines for Stopping and Pausing Network Services ΓòÉΓòÉΓòÉ
  9264.  
  9265. Keep the following in mind when stopping and pausing network services: 
  9266.  
  9267.      When the Messenger service is stopped on a workstation, that workstation 
  9268.       can no longer receive messages or alerts. 
  9269.  
  9270.      When the Requester service is stopped on a server, the server and OS/2 
  9271.       Warp Server or LAN Server program also stop. Users lose access to that 
  9272.       server's network resources. If any user is logged on at that server, 
  9273.       stopping the Requester service logs them off. After the Server service 
  9274.       stops on a server, that workstation can function only as a client and can 
  9275.       no longer share resources with users. 
  9276.  
  9277.      Pausing a client temporarily disables use of shared resources, but you 
  9278.       are not disconnected from those resources.  If you pause a server, no new 
  9279.       requests to use the resources at that server are accepted.  However, 
  9280.       pausing a server does not affect files that are currently open or 
  9281.       outstanding requests to use resources. 
  9282.  
  9283.  Pausing a network service can be used, for example, when preparing to shut 
  9284.  down a server for maintenance. Before shutdown, you want to disallow further 
  9285.  resource requests but allow current jobs in the server's spooler and serial 
  9286.  device queues to complete processing until the queues are empty. Pausing the 
  9287.  Server service disallows additional user connections to server resources, but 
  9288.  allows current requests to complete processing. 
  9289.  
  9290.  Note:  Administrators can connect to paused servers.  This ability allows the 
  9291.         server to be remotely administered. 
  9292.  
  9293.  You can disable user logon to a domain by pausing the NetLogon service on the 
  9294.  domain controller and the other servers in the domain. This keeps new users 
  9295.  from logging on.  However, currently logged-on users and users with sessions 
  9296.  to servers in the domain are not affected.  To enable domain-validated logons 
  9297.  again, continue the NetLogon service on the domain controller and the 
  9298.  additional servers. 
  9299.  
  9300.  
  9301. ΓòÉΓòÉΓòÉ 14.1.2. Starting a Network Service ΓòÉΓòÉΓòÉ
  9302.  
  9303. Use the next procedure to start a network service. 
  9304.  
  9305. To start a network service: 
  9306.  
  9307.    1. Open  LAN Server Administration. 
  9308.  
  9309.    2. If the network service you want to open is on a remote server: 
  9310.  
  9311.         a. Open the appropriate domain object. 
  9312.  
  9313.         b. Open  Defined Servers. 
  9314.  
  9315.         c. Open the appropriate server object. 
  9316.  
  9317.    3. If the network service you want to open is on the local workstation, open 
  9318.       Local Workstation. 
  9319.  
  9320.    4. Open  Services. 
  9321.  
  9322.       The details view of the Services folder is displayed so that you can view 
  9323.       the current status of all installed services. 
  9324.  
  9325.    5. If you want to view more details of a particular service, double-click on 
  9326.       its icon to display its notebook. 
  9327.  
  9328.    6. After you have viewed the properties, close the notebook. 
  9329.  
  9330.    7. With mouse button 2, select the service you want started. 
  9331.  
  9332.    8. From the pop-up menu, select  Start. 
  9333.  
  9334.       The Start Service window is displayed. 
  9335.  
  9336.    9. If you want to override the default parameters stored in the IBMLAN.INI 
  9337.       file, change them in the  Parameters field.  If you leave the field 
  9338.       blank, the default parameters are used. 
  9339.  
  9340.       Changes you make here temporarily override the values in the IBMLAN.INI 
  9341.       file.  The changes remain in effect until you stop the service. 
  9342.  
  9343.   10. Select  Start. 
  9344.  
  9345.  Note:  You cannot start the Server service remotely. 
  9346.  
  9347.  
  9348. ΓòÉΓòÉΓòÉ 14.1.3. Stopping a Network Service ΓòÉΓòÉΓòÉ
  9349.  
  9350. Use the next procedure to stop a network service. 
  9351.  
  9352. To stop a network service: 
  9353.  
  9354.    1. Open  LAN Server Administration. 
  9355.  
  9356.    2. If the network service you want to stop is on a remote server: 
  9357.  
  9358.         a. Open the appropriate domain object. 
  9359.  
  9360.         b. Open  Defined Servers. 
  9361.  
  9362.         c. Open the appropriate server object. 
  9363.  
  9364.    3. If the network service you want to stop is on the local workstation, open 
  9365.       Local Workstation. 
  9366.  
  9367.    4. Open  Services. 
  9368.  
  9369.       The details view of the Services Collection is displayed so that you can 
  9370.       view the current status of all installed services. 
  9371.  
  9372.    5. If you want to view more details of a particular service, double-click on 
  9373.       its icon to open its notebook. 
  9374.  
  9375.    6. After you have viewed the properties, close the notebook. 
  9376.  
  9377.    7. With mouse button 2, select the service you want stopped. 
  9378.  
  9379.    8. From the pop-up menu, select  Stop. 
  9380.  
  9381.  Note:  You cannot restart the Requester or Server service remotely. You cannot 
  9382.         restart the Requester service from here. 
  9383.  
  9384.  
  9385. ΓòÉΓòÉΓòÉ 14.1.4. Pausing a Network Service ΓòÉΓòÉΓòÉ
  9386.  
  9387. Pausing a network service temporarily suspends the service. You can pause only 
  9388. the following network services: 
  9389.  
  9390.      NetLogon 
  9391.  
  9392.      Netrun 
  9393.  
  9394.      Peer 
  9395.  
  9396.      Requester 
  9397.  
  9398.      Server 
  9399.  
  9400.  The Pause menu choice is not displayed for other services. 
  9401.  
  9402.  To pause a network service: 
  9403.  
  9404.    1. Open  LAN Server Administration. 
  9405.  
  9406.    2. If the network service you want to pause is on a remote server: 
  9407.  
  9408.         a. Open the appropriate domain object. 
  9409.  
  9410.         b. Open  Defined Servers. 
  9411.  
  9412.         c. Open the appropriate server object. 
  9413.  
  9414.    3. If the network service you want to pause is on the local workstation, 
  9415.       open Local Workstation. 
  9416.  
  9417.    4. Open  Services. 
  9418.  
  9419.       The details view of the Services Collection is displayed so that you can 
  9420.       view the current status of all installed services. 
  9421.  
  9422.    5. If you want to view more details of a particular service, double-click on 
  9423.       its icon to display its notebook. 
  9424.  
  9425.    6. After you have viewed the properties, close the notebook. 
  9426.  
  9427.    7. With mouse button 2, select the service you want paused. 
  9428.  
  9429.    8. From the pop-up menu, select  Pause. 
  9430.  
  9431.  To resume a paused service, select  Continue. See  Continuing a Network 
  9432.  Service for details. 
  9433.  
  9434.  
  9435. ΓòÉΓòÉΓòÉ 14.1.5. Continuing a Network Service ΓòÉΓòÉΓòÉ
  9436.  
  9437. Continuing a network service resumes the service's functions after the service 
  9438. has been paused. 
  9439.  
  9440. To continue a paused network service: 
  9441.  
  9442.    1. Open  LAN Server Administration. 
  9443.  
  9444.    2. If the network service you want to continue is on a remote server: 
  9445.  
  9446.         a. Open the appropriate domain object. 
  9447.  
  9448.         b. Open  Defined Servers. 
  9449.  
  9450.         c. Open the appropriate server object. 
  9451.  
  9452.    3. If the network service you want to continue is on the local workstation, 
  9453.       open Local Workstation. 
  9454.  
  9455.    4. Open  Services. 
  9456.  
  9457.       The details view of the Services Collection is displayed so that you can 
  9458.       view the current status of all installed services. 
  9459.  
  9460.    5. If you want to view more details of a particular service, double-click on 
  9461.       its icon to display its notebook. 
  9462.  
  9463.    6. After you have viewed the properties, close the notebook. 
  9464.  
  9465.    7. With mouse button 2, select the service you want continued. 
  9466.  
  9467.    8. From the pop-up menu, select  Continue. 
  9468.  
  9469.  
  9470. ΓòÉΓòÉΓòÉ 14.1.6. Shutting Down the Domain Controller ΓòÉΓòÉΓòÉ
  9471.  
  9472. Shutting down the domain controller suspends all network services rendered to 
  9473. the users on the domain.  It is important that the users be warned and given a 
  9474. chance to log off before the shutdown. 
  9475.  
  9476. To shut down the domain controller: 
  9477.  
  9478.    1. Pause the NetLogon service: 
  9479.  
  9480.         a. Open  LAN Server Administration. 
  9481.  
  9482.         b. Open the appropriate domain object. 
  9483.  
  9484.         c. Open  Defined Servers. 
  9485.  
  9486.         d. Open the appropriate server object. 
  9487.  
  9488.         e. Open  Services. 
  9489.  
  9490.            The details view of the Services Collection is displayed so that you 
  9491.            can view the current status of all installed services. 
  9492.  
  9493.         f. If you want to view more details of a particular service, open its 
  9494.            icon. The notebook for that service is displayed. 
  9495.  
  9496.         g. After you have viewed the properties, close the notebook. 
  9497.  
  9498.         h. With mouse button 2, select  NetLogon. 
  9499.  
  9500.         i. From the pop-up menu, select  Pause. 
  9501.  
  9502.    2. Broadcast a message to all users to log off: 
  9503.  
  9504.         a. Open  Network Messaging. 
  9505.  
  9506.            The Network Messaging window is displayed. 
  9507.  
  9508.         b. Select  Messages. 
  9509.  
  9510.         c. From the Messages pull-down menu, select  Send new. 
  9511.  
  9512.         d. In the message text field, type the message you want to send. 
  9513.  
  9514.         e. Select  Broadcast and follow the instructions in the window 
  9515.            displayed. 
  9516.  
  9517.         f. Select either a domain or the whole network and then select OK. 
  9518.  
  9519.         g. Select  Cancel.  If you did not save your message, you are prompted 
  9520.            to do so. 
  9521.  
  9522.            View the list of logged-on users. Depending on your site's 
  9523.            procedures, you may want to contact the remaining users 
  9524.            individually. 
  9525.  
  9526.    3. Stop the Server service, and run Shutdown from the Desktop: 
  9527.  
  9528.         a. Open  LAN Server Administration. 
  9529.  
  9530.         b. Open the appropriate domain object. 
  9531.  
  9532.         c. Open  Object. 
  9533.  
  9534.         d. Select the arrow to the right of  Open as. 
  9535.  
  9536.         e. Open  Logged on users. 
  9537.  
  9538.            The Logged on Users window is displayed.  It lists all the user 
  9539.            currently logged on throughout this domain. 
  9540.  
  9541.         f. After you have finished viewing this list, select  OK. 
  9542.  
  9543.         g. Notify any users still logged on to log off. 
  9544.  
  9545.         h. Stop the Server service from LAN Server Administration. 
  9546.  
  9547.         i. Run Shutdown from the Desktop to shut down the domain controller. 
  9548.  
  9549.  
  9550. ΓòÉΓòÉΓòÉ 14.2. Updating Parameters ΓòÉΓòÉΓòÉ
  9551.  
  9552. The definition parameters for servers and clients are stored in the IBMLAN.INI 
  9553. file for each workstation. To make permanent changes to these parameters, you 
  9554. must stop the Server or Requester service, edit the IBMLAN.INI file, and start 
  9555. the service again (refer to Performance Tuning). You can make temporary changes 
  9556. to a workstation definition without stopping the workstation and starting it 
  9557. again. These changes are in effect while the service is active. 
  9558.  
  9559. For more information, see the following topics: 
  9560.  
  9561.      Updating Defined Server Parameters 
  9562.  
  9563.      Updating Local Workstation Parameters 
  9564.  
  9565.  
  9566. ΓòÉΓòÉΓòÉ 14.2.1. Updating Defined Server Parameters ΓòÉΓòÉΓòÉ
  9567.  
  9568. You can make temporary changes to a server's definition; for example, you can 
  9569. change the size of the audit file. 
  9570.  
  9571. To make temporary changes to a server's parameters: 
  9572.  
  9573.    1. Open  LAN Server Administration. 
  9574.  
  9575.    2. Open the appropriate domain object. 
  9576.  
  9577.    3. Open  Defined Servers. 
  9578.  
  9579.    4. With mouse button 2, select the appropriate server object. 
  9580.  
  9581.    5. From the pop-up menu, select  Properties. 
  9582.  
  9583.       The server notebook is displayed.  Server parameters are provided under 
  9584.       the tabs. 
  9585.  
  9586.    6. Select each notebook tab successively, and change the appropriate 
  9587.       parameters.  For example, select the  Auditing tab. 
  9588.  
  9589.       The Auditing Page is displayed. 
  9590.  
  9591.    7. If you want to change the size of the audit file, type the new size in 
  9592.       the Audit file size field.  The default is 100KB. 
  9593.  
  9594.       Changes you make here temporarily override the values in the IBMLAN.INI 
  9595.       file.  The changes remain in effect while the server is active.  If you 
  9596.       want to change the default parameters stored in the IBMLAN.INI file, 
  9597.       change them in the parameters fields. 
  9598.  
  9599.    8. Select  Set. 
  9600.  
  9601.  
  9602. ΓòÉΓòÉΓòÉ 14.2.2. Updating Local Workstation Parameters ΓòÉΓòÉΓòÉ
  9603.  
  9604. If your local workstation has LAN Requester installed, you can make temporary 
  9605. changes to its parameters with the following procedure. 
  9606.  
  9607. To make temporary changes to a local workstation's parameters: 
  9608.  
  9609.    1. Open  LAN Server Administration. 
  9610.  
  9611.    2. With mouse button 2, select  Local Workstation. 
  9612.  
  9613.    3. From the pop-up menu, select  Properties. 
  9614.  
  9615.       The Local Workstation notebook is displayed. Workstation parameters are 
  9616.       provided under the tabs. 
  9617.  
  9618.    4. Select each notebook tab successively, and change the appropriate 
  9619.       parameters.  For example, select the  Time-out tab. 
  9620.  
  9621.       Changes you make here temporarily override the values in the IBMLAN.INI 
  9622.       file.  The changes remain in effect while the client is active.  If you 
  9623.       want to change the default parameters stored in the IBMLAN.INI file, 
  9624.       change them in the parameters fields. 
  9625.  
  9626.    5. Select  Set. 
  9627.  
  9628.  
  9629. ΓòÉΓòÉΓòÉ 14.3. Viewing and Closing Open Files ΓòÉΓòÉΓòÉ
  9630.  
  9631. A file is  open when its contents are being accessed. You can close an open 
  9632. file on a server to remove a deadlock situation between applications requiring 
  9633. the same file. You can also view and close files on a local workstation if it 
  9634. is a server. 
  9635.  
  9636. To view and close open files on a server: 
  9637.  
  9638.    1. Open  LAN Server Administration. 
  9639.  
  9640.    2. Open the appropriate domain object. 
  9641.  
  9642.    3. Open  Defined Servers. 
  9643.  
  9644.    4. With mouse button 2, select the appropriate server object. 
  9645.  
  9646.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  9647.  
  9648.    6. Select  Open Files. 
  9649.  
  9650.       The Open Files window is displayed. 
  9651.  
  9652.    7. Select the file or files you want to close. 
  9653.  
  9654.    8. Select  Close File. 
  9655.  
  9656.    9. Select  Close. 
  9657.  
  9658.  
  9659. ΓòÉΓòÉΓòÉ 14.4. Viewing and Deleting Active Sessions ΓòÉΓòÉΓòÉ
  9660.  
  9661. A  session is a logical connection between a server and a client. A connection 
  9662. begins when a request for a shared resource is successful.  A OS/2 Warp Server 
  9663. or LAN Server client has only one session per server.  In each session, 
  9664. however, a user can have multiple connections and open files. An additional 
  9665. server has an active session to the domain controller even when no user is 
  9666. logged on at the server.  This session is listed in the display of active 
  9667. sessions.  The  User ID field is blank. 
  9668.  
  9669. When a session is deleted, any files opened by the session are closed. A 
  9670. session is reestablished when the client contacts the server again for 
  9671. information or resource use. 
  9672.  
  9673. You can also view and delete active sessions on a local workstation if it is a 
  9674. server. 
  9675.  
  9676. To view and close active sessions on a server: 
  9677.  
  9678.    1. Open  LAN Server Administration. 
  9679.  
  9680.    2. Open the appropriate domain object. 
  9681.  
  9682.    3. Open  Defined Servers. 
  9683.  
  9684.    4. With mouse button 2, select the appropriate server object. 
  9685.  
  9686.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  9687.  
  9688.    6. Select  Active Sessions. 
  9689.  
  9690.       The Active Sessions window is displayed: 
  9691.  
  9692.    7. Select one or more active sessions to delete. 
  9693.  
  9694.    8. Select  Delete session. 
  9695.  
  9696.    9. Select  Close. 
  9697.  
  9698.  
  9699. ΓòÉΓòÉΓòÉ 14.5. Using Statistics ΓòÉΓòÉΓòÉ
  9700.  
  9701. The statistics function lets you see performance statistics for all of the 
  9702. servers on the domain.  You can use the statistics to tune the performance of 
  9703. the network.  Users can access statistics only for their own workstations. 
  9704. Additional statistics are available with the NET STATISTICS command.  Refer to 
  9705. the Command Reference for more information. 
  9706.  
  9707. For more information, see the following topics: 
  9708.  
  9709.      Viewing Statistics 
  9710.  
  9711.      Printing Statistics 
  9712.  
  9713.      Clearing Statistics 
  9714.  
  9715.  
  9716. ΓòÉΓòÉΓòÉ 14.5.1. Viewing Statistics ΓòÉΓòÉΓòÉ
  9717.  
  9718. Use the next procedure to see the performance statistics for a remote server or 
  9719. local workstation.  If the local workstation is not a server, only client 
  9720. statistics are available. 
  9721.  
  9722. To view the statistics: 
  9723.  
  9724.    1. Open  LAN Server Administration. 
  9725.  
  9726.    2. Open the appropriate domain object. 
  9727.  
  9728.    3. Open  Defined Servers. 
  9729.  
  9730.    4. With mouse button 2, select the appropriate server object. 
  9731.  
  9732.    5. From the pop-up menu, select the arrow to the right of  Open as. 
  9733.  
  9734.    6. Select the arrow to the right of  Statistics. 
  9735.  
  9736.    7. Select either  Server to view server statistics or Requester to view 
  9737.       client statistics. 
  9738.  
  9739.       The appropriate Statistics window is displayed. 
  9740.  
  9741.    8. When you have finished, select  Close. 
  9742.  
  9743.  
  9744. ΓòÉΓòÉΓòÉ 14.5.2. Printing Statistics ΓòÉΓòÉΓòÉ
  9745.  
  9746. You can print the statistics on a network printer. 
  9747.  
  9748. To print statistics on a network printer: 
  9749.  
  9750.    1. Open  LAN Server Administration. 
  9751.  
  9752.    2. Open the appropriate domain object. 
  9753.  
  9754.    3. With mouse button 2, select the appropriate server object. 
  9755.  
  9756.    4. From the pop-up menu, select  Object. 
  9757.  
  9758.    5. Select the arrow to the right of  Open as. 
  9759.  
  9760.    6. Select the arrow to the right of  Statistics. 
  9761.  
  9762.    7. Select either  Server for server statistics or Requester for client 
  9763.       statistics. 
  9764.  
  9765.       The Statistics window is displayed. 
  9766.  
  9767.    8. Select  Print statistics. 
  9768.  
  9769.       Statistics for the selected server print at the default printer for that 
  9770.       server. 
  9771.  
  9772.    9. Select  Close. 
  9773.  
  9774.  
  9775. ΓòÉΓòÉΓòÉ 14.5.3. Clearing Statistics ΓòÉΓòÉΓòÉ
  9776.  
  9777. You can reset the values of all workstation statistics to 0. When you clear the 
  9778. statistics, the date and time statistics collection begins are set to the 
  9779. current date and time.  Only an administrator can clear the statistics for a 
  9780. server.  Users can clear the statistics only on their workstations. After you 
  9781. clear the statistics for a workstation, you cannot recover those values. 
  9782.  
  9783. Use the next procedure to clear the statistics for a remote server or local 
  9784. workstation.  If the local workstation is not a server, only client statistics 
  9785. are available. 
  9786.  
  9787. To clear statistics: 
  9788.  
  9789.    1. Open  LAN Server Administration. 
  9790.  
  9791.    2. Select the appropriate domain object. 
  9792.  
  9793.    3. Open  Defined Servers. 
  9794.  
  9795.    4. Open the appropriate server object. 
  9796.  
  9797.    5. Select  Object. 
  9798.  
  9799.    6. Select the arrow to the right of  Open as. 
  9800.  
  9801.    7. Select the arrow to the right of  Statistics. 
  9802.  
  9803.    8. Select either  Server for server statistics or Requester for client 
  9804.       statistics. 
  9805.  
  9806.       The appropriate Statistics window is displayed. 
  9807.  
  9808.    9. Select  Clear Statistics. 
  9809.  
  9810.   10. Select  Close. 
  9811.  
  9812.  
  9813. ΓòÉΓòÉΓòÉ 14.6. Auditing ΓòÉΓòÉΓòÉ
  9814.  
  9815. The OS/2 Warp Server or LAN Server  audit log contains information about 
  9816. resource use and security.  You can use audit log information for accounting, 
  9817. security, studying network use, or problem determination. 
  9818.  
  9819. Each server keeps an audit log for the resources located on that server. The 
  9820. audit log can contain the following information.  You can choose which of these 
  9821. resources to include in the audit log.  You choose these resources by setting 
  9822. the  auditing parameter in the IBMLAN.INI file or by specifying the /AUDITING 
  9823. parameter on the NET START command. 
  9824.  
  9825.      Service state changes 
  9826.  
  9827.      Successful and unsuccessful requests for session connection 
  9828.  
  9829.      All requests for session connection 
  9830.  
  9831.      Successful and unsuccessful requests for domain logon 
  9832.  
  9833.      All requests for session connection and domain logon and logoff 
  9834.  
  9835.      All logon and logoff requests (session and network) 
  9836.  
  9837.      Successful and unsuccessful share requests 
  9838.  
  9839.      All share requests 
  9840.  
  9841.      Changes to user and group accounts database 
  9842.  
  9843.      Changes to the access control database 
  9844.  
  9845.      Resource access as defined by resource auditing options 
  9846.  
  9847.      Logon limit violations 
  9848.  
  9849.  Additionally, you can specify that access attempts to a resource be recorded 
  9850.  in the audit log when you create an access control profile for that resource. 
  9851.  You can specify that all attempts, failed attempts, or no attempts to access 
  9852.  the resource be recorded in the audit log. 
  9853.  
  9854.  For more information, see the following topics: 
  9855.  
  9856.      Checking the Status of Auditing 
  9857.  
  9858.      Enabling Auditing and Audited Events 
  9859.  
  9860.      Displaying the Audit Log 
  9861.  
  9862.      Reversing the Order of Audit Log Entries 
  9863.  
  9864.      Printing the Audit Log 
  9865.  
  9866.      Writing the Audit Log to a File 
  9867.  
  9868.      Clearing the Audit Log 
  9869.  
  9870.      Changing the Size of the Audit Log 
  9871.  
  9872.  
  9873. ΓòÉΓòÉΓòÉ 14.6.1. Checking the Status of Auditing ΓòÉΓòÉΓòÉ
  9874.  
  9875. Use the following procedure to determine whether auditing is enabled and which 
  9876. events are currently being audited. 
  9877.  
  9878. To check the audit status: 
  9879.  
  9880.    1. Open  LAN Server Administration. 
  9881.  
  9882.    2. Open the appropriate domain object. 
  9883.  
  9884.    3. Open  Defined Servers. 
  9885.  
  9886.    4. With mouse button 2, select the appropriate server object. 
  9887.  
  9888.    5. From the pop-up menu, select  Properties. 
  9889.  
  9890.       The server notebook is displayed. 
  9891.  
  9892.    6. Select the  Auditing tab. 
  9893.  
  9894.       The Auditing page is displayed.  It shows whether auditing is enabled, 
  9895.       auditable events on the selected server, and which events are enabled for 
  9896.       auditing. 
  9897.  
  9898.       If the  Auditing enabled check box is not active, the Auditing parameter 
  9899.       in the IBMLAN.INI file is set to No. 
  9900.  
  9901.       Note:  You can change the audit file size on this page. 
  9902.  
  9903.    7. After you view the properties, select  Cancel to close the notebook. 
  9904.  
  9905.       Note:  Use the  Cancel button to prevent accidentally saving any unwanted 
  9906.              changes you might have made while viewing the properties. 
  9907.  
  9908.    8. Select  Set or  Apply. 
  9909.  
  9910.  
  9911. ΓòÉΓòÉΓòÉ 14.6.2. Enabling Auditing and Audited Events ΓòÉΓòÉΓòÉ
  9912.  
  9913. If the  auditing parameter is set to NO in the server IBMLAN.INI file, no 
  9914. auditing is done. You can choose which resources you want to include in the 
  9915. audit log by setting the  auditing parameter in the server IBMLAN.INI file or 
  9916. by using the /AUDITING option on the NET START command. 
  9917.  
  9918. To enable auditing of all events, type at the OS/2 command line: 
  9919.  
  9920. NET START SERVER /AUDITING:YES
  9921.  To keep only the logon, user list, and resource events in the audit log, type: 
  9922.  
  9923. NET START SERVER /AUDITING:LOGON;USERLIST;RESOURCE
  9924.  To keep all events except service events in the audit log, type: 
  9925.  
  9926. NET START SERVER /AUDITING:YES /NOAUDITING:SERVICE
  9927.  
  9928. For more information on using the NET START command for selective auditing, 
  9929. refer to Command Reference. For more information about the auditing parameter, 
  9930. refer to Performance Tuning. 
  9931.  
  9932. You can display, print, clear, and view the size of a server's audit log. You 
  9933. can also write the audit log to a file and print it using NET commands. To 
  9934. write the first 20 entries of the audit log to a file, type at the OS/2 command 
  9935. line: 
  9936.  
  9937. NET AUDIT /c:20 > filename
  9938.  
  9939. To view the audit log file, type: 
  9940.  
  9941. TYPE filename | MORE
  9942.  
  9943.  
  9944. ΓòÉΓòÉΓòÉ 14.6.3. Displaying the Audit Log ΓòÉΓòÉΓòÉ
  9945.  
  9946. Use the next procedure to see the audit log in LAN Server Administration. 
  9947.  
  9948. To display the audit log: 
  9949.  
  9950.    1. Open  LS Audit Log Utility. 
  9951.  
  9952.       The Audit Log main window is displayed. 
  9953.  
  9954.  
  9955.             Audit Log Main Window
  9956.  
  9957.    2. If the desired audit log is remote: 
  9958.  
  9959.         a. Select  Options. 
  9960.  
  9961.         b. Select  Select server. 
  9962.  
  9963.            The Select server window is displayed.  It lists all available 
  9964.            servers. 
  9965.  
  9966.         c. Either select one of the servers or type the name of the server in 
  9967.            the Set server to field. 
  9968.  
  9969.         d. Select  OK. 
  9970.  
  9971.            The log for the remote server is displayed. 
  9972.  
  9973.    3. To obtain details about a particular event: 
  9974.  
  9975.         a. Select the event. 
  9976.  
  9977.         b. Select  Selected. 
  9978.  
  9979.         c. Select  Audit entry details. 
  9980.  
  9981.            The Audit Event Details window is displayed. 
  9982.  
  9983.  
  9984. ΓòÉΓòÉΓòÉ 14.6.4. Reversing the Order of Audit Log Entries ΓòÉΓòÉΓòÉ
  9985.  
  9986. Audit log entries are displayed in date and time order with the oldest entries 
  9987. displayed first.  You can change the order in which entries are displayed and 
  9988. have the most recent entries displayed first. 
  9989.  
  9990. To reverse the order of audit entries: 
  9991.  
  9992.    1. Open  LS Audit Log Utility. 
  9993.  
  9994.       The Audit Log main window is displayed. 
  9995.  
  9996.    2. If the desired audit log is remote: 
  9997.  
  9998.         a. Select  Options. 
  9999.  
  10000.         b. Select  Select Server. 
  10001.  
  10002.            The Select Server window is displayed.  It lists all available 
  10003.            servers. 
  10004.  
  10005.         c. Either select one of the servers or type the name of the server in 
  10006.            the Set server to field. 
  10007.  
  10008.         d. Select  OK. 
  10009.  
  10010.            The log for the remote server is displayed. 
  10011.  
  10012.    3. Select  View. 
  10013.  
  10014.    4. Select  Sort. 
  10015.  
  10016.       The Sort Audit Log window is displayed. 
  10017.  
  10018.    5. Select the order of sorting, either  Oldest first or Newest first. 
  10019.  
  10020.    6. If you want to group the sorted entries, select either User ID or  Audit 
  10021.       event. 
  10022.  
  10023.    7. Select  OK. 
  10024.  
  10025.  
  10026. ΓòÉΓòÉΓòÉ 14.6.5. Printing the Audit Log ΓòÉΓòÉΓòÉ
  10027.  
  10028. You can print the audit log on a network printer.  The audit log prints in the 
  10029. order selected. 
  10030.  
  10031. To print the audit log: 
  10032.  
  10033.    1. Open  LS Audit Log Utility. 
  10034.  
  10035.       The Audit Log main window is displayed. 
  10036.  
  10037.    2. If the desired audit log is remote: 
  10038.  
  10039.         a. Select  Options. 
  10040.  
  10041.         b. Select  Select server. 
  10042.  
  10043.            The Select Server window is displayed.  It lists all available 
  10044.            servers. 
  10045.  
  10046.         c. Either select one of the servers or type the name of the server in 
  10047.            the Set server to field. 
  10048.  
  10049.         d. Select  OK. 
  10050.  
  10051.            The log for the remote server is displayed. 
  10052.  
  10053.    3. Select  File. 
  10054.  
  10055.    4. Select  Print. 
  10056.  
  10057.       The Print File window is displayed. 
  10058.  
  10059.    5. Type the printer port name (for example, LPT1). 
  10060.  
  10061.    6. Select  OK. 
  10062.  
  10063.       The audit log for the selected server prints at the designated printer. 
  10064.  
  10065.  
  10066. ΓòÉΓòÉΓòÉ 14.6.6. Writing the Audit Log to a File ΓòÉΓòÉΓòÉ
  10067.  
  10068. Use the next procedure to store the contents of the audit log in a file. 
  10069.  
  10070. To write the audit log to a file: 
  10071.  
  10072.    1. Open  LS Audit Log Utility. 
  10073.  
  10074.       The Audit Log main window is displayed. 
  10075.  
  10076.    2. If the desired audit log is remote: 
  10077.  
  10078.         a. Select  Options. 
  10079.  
  10080.         b. Select  Select server. 
  10081.  
  10082.            The Select Server window is displayed.  It lists all available 
  10083.            servers. 
  10084.  
  10085.         c. Either select one of the servers or type the name of the server in 
  10086.            the Set server to field. 
  10087.  
  10088.         d. Select  OK. 
  10089.  
  10090.            The log for the remote server is displayed. 
  10091.  
  10092.    3. Select  File. 
  10093.  
  10094.    4. Select  Output to file. 
  10095.  
  10096.       The Output to File window is displayed. 
  10097.  
  10098.    5. Type the name of the file where you want the audit log to be stored. 
  10099.  
  10100.    6. Select  OK. 
  10101.  
  10102.  
  10103. ΓòÉΓòÉΓòÉ 14.6.7. Clearing the Audit Log ΓòÉΓòÉΓòÉ
  10104.  
  10105. You can clear all entries in the audit log for a specified server. After you 
  10106. clear an audit log, you cannot recover the entries. 
  10107.  
  10108. To clear the audit log: 
  10109.  
  10110.    1. Open  LS Audit Log Utility. 
  10111.  
  10112.       The Audit Log main window is displayed. 
  10113.  
  10114.    2. If the desired audit log is remote: 
  10115.  
  10116.         a. Select  Options. 
  10117.  
  10118.         b. Select  Select server. 
  10119.  
  10120.            The Select Server window is displayed.  It lists all available 
  10121.            servers. 
  10122.  
  10123.         c. Either select one of the servers or type the name of the server in 
  10124.            the Set server to field. 
  10125.  
  10126.         d. Select  OK. 
  10127.  
  10128.            The log for the remote server is displayed. 
  10129.  
  10130.    3. Select  File. 
  10131.  
  10132.    4. Select  Clear. 
  10133.  
  10134.  
  10135. ΓòÉΓòÉΓòÉ 14.6.8. Changing the Size of the Audit Log ΓòÉΓòÉΓòÉ
  10136.  
  10137. You can set the size of the audit log either permanently in the IBMLAN.INI file 
  10138. or temporarily (as long as the server is active). 
  10139.  
  10140. The size of the audit log is set permanently in the IBMLAN.INI file by the 
  10141. maxauditlog parameter in the Server section; refer to Performance Tuning for 
  10142. the maxauditlog parameter description. Each audit log entry occupies about 64 
  10143. bytes.  When the audit log reaches the maximum size, no more entries are 
  10144. recorded until the size is increased or the audit log entries are cleared. 
  10145.  
  10146. Before you can change the size of the audit log at a server, the server must be 
  10147. started, and you must be logged on as an administrator. 
  10148.  
  10149. To temporarily change the audit log size: 
  10150.  
  10151.    1. Open  LS Audit Log Utility. 
  10152.  
  10153.       The Audit Log main window is displayed. 
  10154.  
  10155.    2. If the desired audit log is remote: 
  10156.  
  10157.         a. Select  Options. 
  10158.  
  10159.         b. Select  Select server. 
  10160.  
  10161.            The Select Server window is displayed.  It lists all available 
  10162.            servers. 
  10163.  
  10164.         c. Either select one of the servers or type the name of the server in 
  10165.            the Set server to field. 
  10166.  
  10167.         d. Select  OK. 
  10168.  
  10169.            The log for the remote server is displayed. 
  10170.  
  10171.    3. Select  Options. 
  10172.  
  10173.    4. Select  Set maximum size. 
  10174.  
  10175.       The Audit Log Size window is displayed.  It shows the maximum log size. 
  10176.  
  10177.  
  10178.             Audit Log Size Window
  10179.  
  10180.    5. Type the new maximum size in KB.  The default is 100KB. 
  10181.  
  10182.    6. Select  OK. 
  10183.  
  10184.  
  10185. ΓòÉΓòÉΓòÉ 14.7. Accessing Error Logs ΓòÉΓòÉΓòÉ
  10186.  
  10187. OS/2 Warp Server or LAN Server maintains an  error log on the system hard disk 
  10188. where it is installed.  The error log maintains a record of problems that 
  10189. occurred during a network operation. 
  10190.  
  10191. The error log contains the following information: 
  10192.  
  10193.      Name of the service or program that generated the error 
  10194.  
  10195.      Date and time at which the error occurred 
  10196.  
  10197.      Number and text of the error message 
  10198.  
  10199.      Description, or cause, of the error 
  10200.  
  10201.  You can display, sort, print, and clear error log entries and output them to a 
  10202.  file. 
  10203.  
  10204.  For more information, see the following topics: 
  10205.  
  10206.      Displaying the Error Log 
  10207.  
  10208.      Reversing the Order of Error Log Entries 
  10209.  
  10210.      Printing the Error Log 
  10211.  
  10212.      Writing the Error Log to a File 
  10213.  
  10214.      Clearing the Error Log 
  10215.  
  10216.      Changing the Size of the Error Log 
  10217.  
  10218.  
  10219. ΓòÉΓòÉΓòÉ 14.7.1. Displaying the Error Log ΓòÉΓòÉΓòÉ
  10220.  
  10221. Use the next procedure to view the error log in LAN Server Administration. 
  10222.  
  10223. To display an error log: 
  10224.  
  10225.    1. Open  LS Error Log Utility. 
  10226.  
  10227.       The Error Log main window is displayed. 
  10228.  
  10229.  
  10230.             Error Log Main Window
  10231.  
  10232.    2. If the desired error log is remote: 
  10233.  
  10234.         a. Select  Options. 
  10235.  
  10236.         b. Select  Select server. 
  10237.  
  10238.            The Select Server window is displayed.  It lists all available 
  10239.            servers. 
  10240.  
  10241.         c. Either select one of the servers or type the name of the server in 
  10242.            the Set server to field. 
  10243.  
  10244.         d. Select  OK. 
  10245.  
  10246.            The log for the remote server is displayed. 
  10247.  
  10248.    3. To obtain details about a particular event: 
  10249.  
  10250.         a. Select the event. 
  10251.  
  10252.         b. Select  Selected. 
  10253.  
  10254.         c. Select  Error details. 
  10255.  
  10256.            The Error Details window is displayed. The  Hex data field sometimes 
  10257.            contains additional information about an error.  For example, it may 
  10258.            contain network control block (NCB) information, a file name, or an 
  10259.            error code. 
  10260.  
  10261.  
  10262.                       Error Details Window
  10263.  
  10264.  
  10265. ΓòÉΓòÉΓòÉ 14.7.2. Reversing the Order of Error Log Entries ΓòÉΓòÉΓòÉ
  10266.  
  10267. Error Log entries are displayed in date and time order with the oldest entries 
  10268. displayed first.  You can change the order in which entries are displayed and 
  10269. have the most recent entries displayed first. 
  10270.  
  10271. To reverse the order of error log entries: 
  10272.  
  10273.    1. Open  LS Error Log Utility. 
  10274.  
  10275.       The Error Log main window is displayed. 
  10276.  
  10277.    2. If the desired error log is remote: 
  10278.  
  10279.         a. Select  Options. 
  10280.  
  10281.         b. Select  Select Server. 
  10282.  
  10283.            The Select Server window is displayed.  It lists all available 
  10284.            servers. 
  10285.  
  10286.         c. Either select one of the servers or type the name of the server in 
  10287.            the Set server to field. 
  10288.  
  10289.         d. Select  OK. 
  10290.  
  10291.            The log for the remote server is displayed. 
  10292.  
  10293.    3. Select  View. 
  10294.  
  10295.    4. Select  Sort. 
  10296.  
  10297.       The Sort Error Log window is displayed. 
  10298.  
  10299.    5. Select the order of sorting, either  Oldest first or Newest First. 
  10300.  
  10301.    6. If you want to group the sorted entries, select Group by program 
  10302.       reporting error. 
  10303.  
  10304.    7. Select  OK. 
  10305.  
  10306.  
  10307. ΓòÉΓòÉΓòÉ 14.7.3. Printing the Error Log ΓòÉΓòÉΓòÉ
  10308.  
  10309. You can print the error log on a network printer.  The error log prints in the 
  10310. order selected. 
  10311.  
  10312. To print the error log: 
  10313.  
  10314.    1. Open  LS Error Log Utility. 
  10315.  
  10316.       The Error Log main window is displayed. 
  10317.  
  10318.    2. If the desired error log is remote: 
  10319.  
  10320.         a. Select  Options. 
  10321.  
  10322.         b. Select  Select Server. 
  10323.  
  10324.            The Select Server window is displayed.  It lists all available 
  10325.            servers. 
  10326.  
  10327.         c. Either select one of the servers or type the name of the server in 
  10328.            the Set server to field. 
  10329.  
  10330.         d. Select  OK. 
  10331.  
  10332.            The log for the remote server is displayed. 
  10333.  
  10334.    3. Select  File. 
  10335.  
  10336.    4. Select  Print. 
  10337.  
  10338.       The Print File window is displayed. 
  10339.  
  10340.    5. Type the printer port name (for example, LPT1). 
  10341.  
  10342.    6. Select  OK. 
  10343.  
  10344.       The error log for the selected server prints at the designated printer. 
  10345.  
  10346.  You can also print the error log to a file using the NET PRINT command. For 
  10347.  more information, refer to the Command Reference. 
  10348.  
  10349.  
  10350. ΓòÉΓòÉΓòÉ 14.7.4. Writing the Error Log to a File ΓòÉΓòÉΓòÉ
  10351.  
  10352. Use the next procedure to store the contents of the error log in a file. 
  10353.  
  10354. To write the error log to a file: 
  10355.  
  10356.    1. Open  LS Error Log Utility. 
  10357.  
  10358.       The Error Log main window is displayed. 
  10359.  
  10360.    2. If the desired error log is remote: 
  10361.  
  10362.         a. Select  Options. 
  10363.  
  10364.         b. Select  Select Server. 
  10365.  
  10366.            The Select Server window is displayed.  It lists all available 
  10367.            servers. 
  10368.  
  10369.         c. Either select one of the servers or type the name of the server in 
  10370.            the Set server to field. 
  10371.  
  10372.         d. Select  OK. 
  10373.  
  10374.            The log for the remote server is displayed. 
  10375.  
  10376.    3. Select  File. 
  10377.  
  10378.    4. Select  Output to file. 
  10379.  
  10380.       The Output to File window is displayed. 
  10381.  
  10382.    5. Type the name of the file where you want the error log to be stored. 
  10383.  
  10384.    6. Select  OK. 
  10385.  
  10386.  
  10387. ΓòÉΓòÉΓòÉ 14.7.5. Clearing the Error Log ΓòÉΓòÉΓòÉ
  10388.  
  10389. You can clear all entries in the error log for a specified server. After you 
  10390. clear an error log, you cannot recover the entries. 
  10391.  
  10392. To clear an error log: 
  10393.  
  10394.    1. Open  LS Error Log Utility. 
  10395.  
  10396.       The Error Log main window is displayed. 
  10397.  
  10398.    2. If the desired error log is remote: 
  10399.  
  10400.         a. Select  Options. 
  10401.  
  10402.         b. Select  Select server. 
  10403.  
  10404.            The Select Server window is displayed.  It lists all available 
  10405.            servers. 
  10406.  
  10407.         c. Either select one of the servers or type the name of the server in 
  10408.            the Set server to field. 
  10409.  
  10410.         d. Select  OK. 
  10411.  
  10412.            The log for the remote server is displayed. 
  10413.  
  10414.    3. Select  File. 
  10415.  
  10416.    4. Select  Clear. 
  10417.  
  10418.  
  10419. ΓòÉΓòÉΓòÉ 14.7.6. Changing the Size of the Error Log ΓòÉΓòÉΓòÉ
  10420.  
  10421. You can set the size of the error log either permanently in the IBMLAN.INI file 
  10422. or temporarily (as long as the server is active). 
  10423.  
  10424. The size of the error log is set permanently in the IBMLAN.INI file by the 
  10425. maxerrorlog parameter in the Server section; refer to Performance Tuning for 
  10426. the  maxerrorlog parameter description. Each error log entry occupies about 64 
  10427. bytes.  When the error log reaches the maximum size, no more entries are 
  10428. recorded until the size is increased or the error log entries are cleared. 
  10429.  
  10430. With the Error Log utility, you can change the maximum size only for the 
  10431. current session.  To change the size permanently, modify the value in the 
  10432. IBMLAN.INI file. Before you can change the size of the error log at a server, 
  10433. the server must be started, and you must be logged on as an administrator. 
  10434.  
  10435. To change the error log size temporarily: 
  10436.  
  10437.    1. Open  LS Error Log Utility. 
  10438.  
  10439.       The Error Log main window is displayed. 
  10440.  
  10441.    2. If the desired error log is remote: 
  10442.  
  10443.         a. Select  Options. 
  10444.  
  10445.         b. Select  Select server. 
  10446.  
  10447.            The Select Server window is displayed.  It lists all available 
  10448.            servers. 
  10449.  
  10450.         c. Either select one of the servers or type the name of the server in 
  10451.            the Set server to field. 
  10452.  
  10453.         d. Select  OK. 
  10454.  
  10455.            The log for the remote server is displayed. 
  10456.  
  10457.    3. Select  Options. 
  10458.  
  10459.    4. Select  Set maximum size. 
  10460.  
  10461.       The Error Log Size window is displayed.  It shows the maximum log size. 
  10462.  
  10463.  
  10464.             Error Log Size Window
  10465.  
  10466.    5. Type the new maximum size in KB.  The default is 100KB. 
  10467.  
  10468.    6. Select  OK. 
  10469.  
  10470.  
  10471. ΓòÉΓòÉΓòÉ 14.8. DOS and OS/2 Command Restrictions ΓòÉΓòÉΓòÉ
  10472.  
  10473. You can use most of the DOS commands on network disks, directories, and 
  10474. printers.  However, you cannot use some DOS and OS/2 commands with network 
  10475. devices.  If you try to use these commands with a network device, you receive 
  10476. an error message.  You can use these commands with your local disks and 
  10477. printers. 
  10478.  
  10479. You cannot use the following DOS commands with redirected drives: 
  10480.  
  10481.      BACKUP 
  10482.  
  10483.      CHKDSK (Check Disk) 
  10484.  
  10485.      DISKCOMP (Disk Compare) - Use the COMP (Compare) command to compare 
  10486.       files. 
  10487.  
  10488.      DISKCOPY (Disk Copy) - Use the COPY and XCOPY commands to copy files. 
  10489.  
  10490.      FORMAT 
  10491.  
  10492.      JOIN 
  10493.  
  10494.      LABEL - You cannot change the volume label of a network device you are 
  10495.       using. 
  10496.  
  10497.      PRINT - Use the NET PRINT (or NET COPY) command if you are using network 
  10498.       devices. 
  10499.  
  10500.      RECOVER 
  10501.  
  10502.      RESTORE 
  10503.  
  10504.      SUBST (Substitute) 
  10505.  
  10506.      SYS 
  10507.  
  10508.      VERIFY 
  10509.  
  10510.  The following are the only commands that you can use with universal naming 
  10511.  convention names: 
  10512.  
  10513.      TYPE 
  10514.  
  10515.      PRINT 
  10516.  
  10517.  You cannot use the following OS/2 commands with redirected drives: 
  10518.  
  10519.      CHKDSK (Check Disk) 
  10520.  
  10521.      DISKCOPY (Disk Copy) 
  10522.  
  10523.      JOIN 
  10524.  
  10525.      LABEL 
  10526.  
  10527.      RECOVER 
  10528.  
  10529.      RESTORE 
  10530.  
  10531.      SHELL 
  10532.  
  10533.  You cannot use the following OS/2 commands with universal naming convention 
  10534.  names. 
  10535.  
  10536.      BACKUP 
  10537.  
  10538.      COPY 
  10539.  
  10540.  
  10541. ΓòÉΓòÉΓòÉ 14.9. Managing More Than One Domain ΓòÉΓòÉΓòÉ
  10542.  
  10543. You can manage up to six domains through LAN Server Administration. You can 
  10544. manage a domain from a workstation if the following conditions apply: 
  10545.  
  10546.      Your user ID and password are defined as administrator IDs for all 
  10547.       domains. 
  10548.  
  10549.      One or more of the following applies: 
  10550.  
  10551.         -  The domain name is specified as your default domain name using the 
  10552.            domain parameter in the IBMLAN.INI file. 
  10553.  
  10554.         -  The domain name is specified as one of four possible names in the 
  10555.            othdomains parameter in the IBMLAN.INI file. 
  10556.  
  10557.         -  You are logged on at that domain. 
  10558.  
  10559.  The following is an example of how you would specify the OTHDOMAINS parameter 
  10560.  in the IBMLAN.INI file: 
  10561.  
  10562.   OTHDOMAINS = domain1,domain2,domain3,domain4
  10563.  
  10564.  You can specify up to four additional domains using the OTHDOMAINSparameter on 
  10565.  the client or server on which you are logging on. After you specify additional 
  10566.  domains, restart LAN Requester and then log on. Additional domain objects are 
  10567.  displayed in LAN Server Administration, with which you can manage these 
  10568.  domains.  You can manage a total of six domains in LAN Server Administration 
  10569.  if you log on to a domain that is different from your default domain. 
  10570.  
  10571.  
  10572. ΓòÉΓòÉΓòÉ 14.10. First Failure Support Technology/2 (FFST/2) ΓòÉΓòÉΓòÉ
  10573.  
  10574. First Failure Support Technology/2 (FFST/2) is a set of reliability, 
  10575. availability, and serviceability (RAS) functions that OS/2 Warp Server or LAN 
  10576. Server and other applications can use to perform problem determination tasks. 
  10577. The following list describes the functions that are provided. 
  10578.  
  10579.  Message console services FFST/2 provides a Presentation Manager message 
  10580.                      console facility that maintains a scrollable copy of all 
  10581.                      messages logged or displayed byFFST/2. This service 
  10582.                      permits any type of process (including detached processes) 
  10583.                      to display messages on the Presentation Manager screen. 
  10584.                      The user can quickly obtain a record of recently displayed 
  10585.                      or logged messages. 
  10586.  
  10587.  Error logging       FFST/2 can construct a symptom record that uniquely 
  10588.                      identifies the error detected and place the record in the 
  10589.                      OS/2 error log. 
  10590.  
  10591.  Message logging     FFST/2 can retrieve application-specified messages from 
  10592.                      National Language Support (NLS) message files and record 
  10593.                      the messages in a log file. Optionally, FFST/2 can display 
  10594.                      the messages through the message console facility. Message 
  10595.                      display can be turned on or off through the FFST/2 
  10596.                      initialization and configuration program. 
  10597.  
  10598.  Building and routing generic alerts FFST/2 can be used to build and route a 
  10599.                      software generic alert to describe a detected error 
  10600.                      condition.  The alert can include key segments of the 
  10601.                      symptom record built by the error logging facility if 
  10602.                      error logging has been selected. 
  10603.  
  10604.  Selective data collection and dump FFST/2 can collect and dump storage areas 
  10605.                      and files selected by the calling application. 
  10606.  
  10607.  FFST/2 requires hardware  vital product data (VPD) so that it can identify 
  10608.  machines properly in the messages it generates. Vital product data includes 
  10609.  the machine type, model number, serial number, and plant of manufacture. Vital 
  10610.  product data and other configuration information is entered by the user at 
  10611.  installation time. 
  10612.  
  10613.  The following tasks can be configured by the FFST/2 installation and 
  10614.  configuration program: 
  10615.  
  10616.      Enable or disable FFST/2 
  10617.  
  10618.      Enable or disable the display of application messages 
  10619.  
  10620.      Set the maximum number of dump data sets that can exist in the current 
  10621.       directory for a given type of dump 
  10622.  
  10623.      Set subdirectories to be used for FFST/2 dump files 
  10624.  
  10625.      Set the FFST/2 message log path and file name 
  10626.  
  10627.  
  10628. ΓòÉΓòÉΓòÉ 15. Managing Local Security on 386 HPFS ΓòÉΓòÉΓòÉ
  10629.  
  10630. Permissions that you set for a resource usually apply only to remote users 
  10631. accessing the resource from different workstations. Local Security is provided 
  10632. for the 386 HPFS and extends access restrictions to local users working at the 
  10633. server.  It protects all files on 386 HPFS volumes of the server from 
  10634. unauthorized local access.  Files stored on the FAT file system volumes are not 
  10635. protected by Local Security; however, they are still protected from remote 
  10636. access by unauthorized users. Administrators set permissions for all files on 
  10637. the server and are not subject to access control permissions. 
  10638.  
  10639. When you are working at a server with Local Security, you can access a file 
  10640. only if you have adequate permissions for that file. When you run a program, 
  10641. the program can access a file only if you have permission to access the file. 
  10642. Your permissions, not those of the program, control access to files.  Local 
  10643. NetAPI calls are also subject to privilege checking when Local Security is 
  10644. active.  However, an administrator can also start a program and give it special 
  10645. privileges. 
  10646.  
  10647. For more information, see the following topics: 
  10648.  
  10649.      Local Security on a 386 HPFS Server 
  10650.  
  10651.      Starting a Server with Local Security 
  10652.  
  10653.      Accessing Files with Local Security 
  10654.  
  10655.      Running Privileged Programs at Startup 
  10656.  
  10657.      Running Privileged Programs from the Command Line 
  10658.  
  10659.      Local Security Guidelines 
  10660.  
  10661.  
  10662. ΓòÉΓòÉΓòÉ 15.1. Local Security on a 386 HPFS Server ΓòÉΓòÉΓòÉ
  10663.  
  10664. Local Security protects files on 386 HPFS formatted volumes on the server, 
  10665. regardless of whether OS/2 Warp Server or LAN Server is running. When a local 
  10666. user tries to access a file on a 386 HPFS volume on the server, Local Security 
  10667. checks the permissions for the file.  Access is allowed only if the user has 
  10668. the required permissions.  Local Security also checks file permissions when you 
  10669. run a program that accesses files. 
  10670.  
  10671. File-access auditing is also improved on a server with Local Security 
  10672. installed. Auditing of the files and directories on 386 HPFS volumes on the 
  10673. server begins when the workstation is started, even if the Server service is 
  10674. not started. 
  10675.  
  10676. For information concerning Local Security installation, refer to Quick 
  10677. Beginnings . 
  10678.  
  10679.  
  10680. ΓòÉΓòÉΓòÉ 15.2. Starting a Server with Local Security ΓòÉΓòÉΓòÉ
  10681.  
  10682. When you start a server on which Local Security is installed, many programs are 
  10683. started.  To ensure that the operating system and programs run successfully 
  10684. when no one is logged on to the server, give the special group LOCAL read (R) 
  10685. and execute (X) permissions to the files needed for the operating system and 
  10686. those programs. 
  10687.  
  10688. Only administrators can start services on servers with Local Security. To help 
  10689. you set up correct permissions for system files,OS/2 Warp Server or LAN Server 
  10690. displays the following prompt when a server with Local Security is started: 
  10691.  
  10692. LAN Server Local Security has started.
  10693.  
  10694. Press ESC to log on now, or press ENTER to
  10695. start the workstation with no one logged on.
  10696.  
  10697. Press Enter to test whether the workstation initializes itself with no one 
  10698. logged on.  If the workstation does not start successfully, restart it and 
  10699. press Esc when the prompt is displayed. 
  10700.  
  10701. Note:  This prompt is automatically removed after a short while, allowing the 
  10702.        server to start automatically without intervention. For this reason, it 
  10703.        is recommended that the server and its desktop be allowed to start with 
  10704.        no one logged on. 
  10705.  
  10706.  When the logon prompt is displayed, then log on using a user ID that has 
  10707.  administrator privilege on the server. You can adjust the server file 
  10708.  permissions for the group LOCAL if you want the workstation to start with no 
  10709.  one logged on. For information on how to set up permissions for the group 
  10710.  LOCAL, see  Local Security Guidelines. 
  10711.  
  10712.  After you grant permissions for system files, log off so that no one else can 
  10713.  use the administrator privilege on the server. 
  10714.  
  10715.  Note:  If you log on locally to a server with Local Security, log on to the 
  10716.         network, and then log off from the network, you are still logged on at 
  10717.         the local server. 
  10718.  
  10719.  
  10720. ΓòÉΓòÉΓòÉ 15.3. Accessing Files with Local Security ΓòÉΓòÉΓòÉ
  10721.  
  10722. OS/2 Warp Server or LAN Server creates a special group called LOCAL on servers 
  10723. with Local Security. No users are members of this group nor can any users be 
  10724. added to it. The LOCAL group is a special group ID whose permissions are 
  10725. granted to the system or to users using the local system when no one is logged 
  10726. on. The group LOCAL does not show up in User Profile Management windows; 
  10727. however, it does show up in the LAN Server Administration GUI. 
  10728.  
  10729. Users working at the server workstation when no one is logged on receive the 
  10730. permissions granted to the group LOCAL. If you log on with user privilege, you 
  10731. have the permissions granted to your own user ID and to any groups of which you 
  10732. are a member, in addition to the permissions granted to group LOCAL. If you log 
  10733. on with administrator privilege, you can access all files on the server. For 
  10734. more information about the logon and logoff utilities, refer to Managing Users 
  10735. and Groups. 
  10736.  
  10737. The following list provides a summary of permissions for a user working at the 
  10738. console of a server with Local Security: 
  10739.  
  10740.  Local user not logged on Permissions granted to the group LOCAL, but no access 
  10741.                      to the network 
  10742.  
  10743.  Local user logged on only to a local server Permissions granted to the group 
  10744.                      LOCAL and the user ID, but no access to the network 
  10745.  
  10746.  Local user logged on to the network Permissions granted to the group LOCAL, 
  10747.                      the user ID, and access to the network 
  10748.  
  10749.  Note:  Both the user ID and corresponding password must be in the accounts 
  10750.         database for the server running Local Security before OS/2 Warp Server 
  10751.         or LAN Server will grant network permissions. If OS/2 Warp Server or 
  10752.         LAN Server does not find a valid user ID, OS/2 Warp Server or LAN 
  10753.         Server grants only the permissions of the group LOCAL at the local 
  10754.         server. 
  10755.  
  10756.  
  10757. ΓòÉΓòÉΓòÉ 15.4. Running Privileged Programs at Startup ΓòÉΓòÉΓòÉ
  10758.  
  10759. Many programs must have access to all the files on the server. Only the 
  10760. administrator can start and run a program as a privileged program that can 
  10761. access all files on the server whether or not anyone is logged on locally. 
  10762.  
  10763. An administrator has two ways to start a privileged program when the 
  10764. workstation starts: 
  10765.  
  10766.      Edit the PRIVINIT.CMD file to add the command that starts the program. 
  10767.       The PRIVINIT.CMD file is a special batch program, located in the root 
  10768.       directory on the startup drive, that runs when a workstation with Local 
  10769.       Security starts. Each command in the PRIVINIT.CMD file starts as a 
  10770.       privileged program. 
  10771.  
  10772.       Note:  Starting the PRIVINIT.CMD file by itself does not make the 
  10773.              programs in the PRIVINIT.CMD file privileged.  Start the 
  10774.              PRIVINIT.CMD file by specifying the RUNPRIV.EXE file in the 
  10775.              STARTUP.CMD file. 
  10776.  
  10777.       Commands in the PRIVINIT.CMD file are not automatically run as background 
  10778.       programs.  To start a background program from the PRIVINIT.CMD file, use 
  10779.       the DETACH statement.  For more information about the DETACH statement, 
  10780.       see your operating system documentation. 
  10781.  
  10782.      Put the command to start the program in the CONFIG.SYS file using the RUN 
  10783.       statement.  Programs started with the RUN statement always are started as 
  10784.       background programs.  For more information about the RUN statement, see 
  10785.       your operating system documentation. 
  10786.  
  10787.  Commands in the STARTUP.CMD file are not run as privileged programs. 
  10788.  Therefore, you must be logged on locally as an administrator to start OS/2 
  10789.  Warp Server or LAN Server services from the STARTUP.CMD file. 
  10790.  
  10791.  Note:  To start a service automatically when the server starts and before 
  10792.         anyone logs on at the server, put the NET START command (with the 
  10793.         service to be started) in the PRIVINIT.CMD file. 
  10794.  
  10795.  
  10796. ΓòÉΓòÉΓòÉ 15.5. Running Privileged Programs from the Command Line ΓòÉΓòÉΓòÉ
  10797.  
  10798. To start a privileged program at the OS/2 command prompt after the server is 
  10799. running, type  PRIV followed by the command to start the program. 
  10800.  
  10801. For example, to start the SORT program in the background, type: 
  10802.  
  10803. DETACH SORT <source> target
  10804.  
  10805. To start the SORT program as a privileged background program, type: 
  10806.  
  10807. DETACH PRIV SORT <source> target
  10808.  
  10809. Note:  OS/2 Warp Server or LAN Server services are an exception to this 
  10810.        requirement. When started, OS/2 Warp Server or LAN Server services are 
  10811.        automatically treated as privileged programs.  The PRIV command is not 
  10812.        needed. 
  10813.  
  10814.  When you start a program as a privileged program, the privilege applies only 
  10815.  to that instance of the program.  If you or another user runs the program 
  10816.  again later, the program is not automatically privileged.  This restriction 
  10817.  applies to privileged programs started both from the command line and by the 
  10818.  PRIVINIT.CMD file. 
  10819.  
  10820.  Programs started by a privileged program, regardless of how the privileged 
  10821.  program was started, are also privileged. See the Command Reference for more 
  10822.  information on the PRIV utility. 
  10823.  
  10824.  Refer to Performance Tuning for more information about how to set up the 
  10825.  CONFIG.SYS file for Local Security. 
  10826.  
  10827.  
  10828. ΓòÉΓòÉΓòÉ 15.6. Local Security Guidelines ΓòÉΓòÉΓòÉ
  10829.  
  10830. On a server with Local Security, restrictions begin when the workstation 
  10831. starts, before system initialization files run. If you want the workstation to 
  10832. initialize when no one is logged on, the group LOCAL must have permission to 
  10833. run the server startup programs. 
  10834.  
  10835. To accomplish this, the installation/configuration program automatically grants 
  10836. local permissions for certain files when local security is installed. Refer to 
  10837. Default Access Control Profiles on Servers for a list of permissions installed 
  10838. with Local Security. 
  10839.  
  10840. Once OS/2 Warp Server or LAN Server is installed, you can modify the default 
  10841. permissions. However, when you set permissions for any files on a server with 
  10842. Local Security, follow the security guidelines for each type of file. 
  10843.  
  10844. For more information, see the following topics: 
  10845.  
  10846.      System Files 
  10847.  
  10848.      Data Files 
  10849.  
  10850.      Executable Programs and Dynamic Link Libraries 
  10851.  
  10852.      NET.ACC File 
  10853.  
  10854.      Local Security Considerations for Programs 
  10855.  
  10856.  
  10857. ΓòÉΓòÉΓòÉ 15.6.1. System Files ΓòÉΓòÉΓòÉ
  10858.  
  10859. The following files are examples of system files: 
  10860.  
  10861. CONFIG.SYS
  10862. PRIVINT.CMD
  10863. STARTUP.CMD
  10864. IBMLAN.INI
  10865. SECURESH.EXE
  10866.  
  10867. The changes for the OS/2 operating system require that the desktop directory 
  10868. and files specified by the environment variables USER_INI and SYSTEM_INI have 
  10869. R, W, and X permissions for the entire tree. These permissions allow the 
  10870. desktop to start properly, but not all programs within the desktop can run 
  10871. without at least one user being logged on.  If this is unacceptable in your 
  10872. environment, set up the server so that someone logs on during startup. 
  10873.  
  10874.  
  10875. ΓòÉΓòÉΓòÉ 15.6.2. Data Files ΓòÉΓòÉΓòÉ
  10876.  
  10877. Data files are classified in three types: public, program, and private. 
  10878.  
  10879. Use the following security guidelines to set permissions for data files: 
  10880.  
  10881.      Give all local users read permission to public data files. 
  10882.  
  10883.      Give all local users read and write permissions to program data files 
  10884.       written to by programs that all users are allowed to use. 
  10885.  
  10886.      Do not give any permissions to the private user data files to the group 
  10887.       LOCAL. Give permissions for these private data files only to the 
  10888.       appropriate users. 
  10889.  
  10890.  
  10891. ΓòÉΓòÉΓòÉ 15.6.3. Executable Programs and Dynamic Link Libraries ΓòÉΓòÉΓòÉ
  10892.  
  10893. Executable programs have .EXE and .DLL as file name extensions. A dynamic link 
  10894. library contains commands used by executable programs. 
  10895.  
  10896. Use the following security guidelines to set permissions for executable 
  10897. programs and dynamic link libraries: 
  10898.  
  10899.      For general-use programs, give read and execute permissions to local 
  10900.       users as long as the permissions for the data files modified by these 
  10901.       programs are set correctly. 
  10902.  
  10903.      For programs and dynamic link libraries used only by administrators, do 
  10904.       not give permissions to local users or to any other group. 
  10905.  
  10906.      Do not give write or delete permissions for any program or dynamic link 
  10907.       library. 
  10908.  
  10909.      Do not give create permission for any directory specified in the PATH 
  10910.       statement in the CONFIG.SYS file. 
  10911.  
  10912.  
  10913. ΓòÉΓòÉΓòÉ 15.6.4. NET.ACC File ΓòÉΓòÉΓòÉ
  10914.  
  10915. The NET.ACC file contains the user accounts database for the server. 
  10916.  
  10917. Use the following security guidelines to set permissions for the NET.ACC file: 
  10918.  
  10919.      The installation/configuration program gives all local users read, write, 
  10920.       and execute permissions to the NET.ACC file. 
  10921.  
  10922.       Giving the group LOCAL read, write, and execute permissions should not 
  10923.       cause security problems since the account information in the NET.ACC file 
  10924.       is stored in binary format instead of ASCII text.  Therefore, the 
  10925.       information is not easily readable with a text editor. 
  10926.  
  10927.       Also, as long as Local Security for 386 HPFS is enabled, the NET.ACC file 
  10928.       remains open.  Commands and programs that need exclusive access to a file 
  10929.       cannot work on the NET.ACC file while OS/2 Warp Server or LAN Server is 
  10930.       running. The COPY and DEL commands, for example, need exclusive access. 
  10931.  
  10932.      If you revoke the read, write, and execute permissions for the NET.ACC 
  10933.       file, a local user cannot change a password or user comments while 
  10934.       working at the server; however, a user could do so from a remote 
  10935.       workstation. 
  10936.  
  10937.  Notes: 
  10938.  
  10939.    1. The NETACC.BKP file is the NET.ACC backup file created by the BACKACC 
  10940.       utility. In order to preserve the NETACC.BKP file, do not give any users 
  10941.       or groups access permissions to the NETACC.BKP file. 
  10942.  
  10943.    2. In order to run the BACKACC command on a machine installed with Local 
  10944.       Security, you must: 
  10945.  
  10946.           Be logged on locally as an administrator 
  10947.  
  10948.           Have access to the \IBMLAN\ACCOUNTS subdirectory 
  10949.  
  10950.           Have access to the root directory of the current drive 
  10951.  
  10952.  
  10953. ΓòÉΓòÉΓòÉ 15.6.5. Local Security Considerations for Programs ΓòÉΓòÉΓòÉ
  10954.  
  10955. On servers with Local Security, all programs are subject to file-access 
  10956. permissions.  All programs have the permissions granted to the group LOCAL. In 
  10957. addition, when a user logs on locally at the server, each program the user runs 
  10958. has the permissions granted to that user. When an administrator logs on, each 
  10959. program the administrator runs can access all files on the server, just as the 
  10960. administrator can. 
  10961.  
  10962. While one or more programs are running, users can log on and off the server. If 
  10963. a program is not privileged and a user or administrator logs on at the server, 
  10964. that program has the privilege of the user or administrator. When the user or 
  10965. administrator logs off at the server, the program has the privileges provided 
  10966. by the group LOCAL. 
  10967.  
  10968. For more information, see the following topics: 
  10969.  
  10970.      Local Security Error Messages 
  10971.  
  10972.      Local Security Access Control Profiles 
  10973.  
  10974.  
  10975. ΓòÉΓòÉΓòÉ 15.6.5.1. Local Security Error Messages ΓòÉΓòÉΓòÉ
  10976.  
  10977. If users have problems running programs that are normally accessible, the 
  10978. problems might be caused by Local Security securing the file system. In some 
  10979. applications and programs, error messages do not clearly indicate that the 
  10980. cause of the problem is that users do not have sufficient access permissions to 
  10981. files on the locally secured workstation. 
  10982.  
  10983. To see if Local Security is preventing access because of insufficient access 
  10984. permissions for a user ID, log on to the workstation using an administrator ID 
  10985. and try the command again. Administrators can access all programs on a 
  10986. workstation with Local Security. If necessary, provide the needed access 
  10987. permissions to the group LOCAL or to users requiring access to programs on the 
  10988. workstation. 
  10989.  
  10990. Note:  Turn on auditing to highlight problems with Local Security and file 
  10991.        access. If administrators can successfully run programs but users 
  10992.        cannot, turn on auditing for both the server and the resources in 
  10993.        question. Local resources are audited if Local Security is running. 
  10994.  
  10995.  
  10996. ΓòÉΓòÉΓòÉ 15.6.5.2. Local Security Access Control Profiles ΓòÉΓòÉΓòÉ
  10997.  
  10998. The following example illustrates the access control profiles that are added to 
  10999. servers when Local Security is installed: 
  11000.  
  11001. For all subdirectories specified           LOCAL:RX
  11002. by the DPATH environment variable
  11003. For all subdirectories specified           LOCAL:RX
  11004. by the PATH environment variable
  11005. For all subdirectories specified           LOCAL:RX
  11006. by the LIBPATH variable in CONFIG.SYS
  11007. For all subdirectories specified           LOCAL:RWX
  11008. by the DESKTOP directory tree
  11009. For all subdirectories specified           LOCAL:RX
  11010. by the GLOSSARY environment variable
  11011. For all subdirectories specified           LOCAL:RX
  11012. by the BOOKSHELF environment variable
  11013. For the file referenced                    LOCAL:RWX
  11014. by the USER_INI environment variable
  11015. For the file referenced                    LOCAL:RWX
  11016. by the SYSTEM_INI environment variable
  11017. For all subdirectories specified           LOCAL:RWXCD
  11018. by the TMP environment variable
  11019. For all subdirectories specified           LOCAL:RWXCD
  11020. by the TEMP environment variable
  11021. x:\                                        LOCAL:RX
  11022. Other HPFS drive roots                     LOCAL:RX
  11023. x:\OS2                                     LOCAL:RX
  11024. x:\IBM386FS                                LOCAL:RX
  11025. x:\OS2\INSTALL                             LOCAL:RX
  11026. x:\OS2\HELP                                LOCAL:RX
  11027.  
  11028. DBCS Note  The following access control profile is added only for DBCS systems: 
  11029.  
  11030.                       x:\OS2\SYSDATA                             LOCAL:RWX
  11031.  
  11032.   x:\OS2\BOOK                                LOCAL:RX
  11033.   x:\OS2\DLL                                 LOCAL:RX
  11034.   x:\OS2\SYSTEM                              LOCAL:RX
  11035.   x:\SPOOL and subdirectories (queues)       LOCAL:RWXCDA
  11036.   x:\IBMCOM                                  LOCAL:RX
  11037.   d:\IBMLAN                                  LOCAL:RX
  11038.   d:\IBMLAN\BOOK                             LOCAL:RX
  11039.   d:\IBMLAN\ACCOUNTS                         LOCAL:RX
  11040.   d:\IBMLAN\LOGS                             LOCAL:RX
  11041.   d:\IBMLAN\ACCOUNTS\NET.ACC                 LOCAL:RWX
  11042.   d:\IBMLAN\ACCOUNTS\NETACC.BKP              LOCAL:NONE
  11043.   d:\IBMLAN\NETLIB                           LOCAL:RX
  11044.   d:\IBMLAN\NETPROG                          LOCAL:RX
  11045.  
  11046.   x:\IBM386FS\HPFS386.IFS                    LOCAL:NONE
  11047.   d:\IBMLAN\INSTALL                          LOCAL:NONE
  11048.   d:\IBMLAN\SERVICES                         LOCAL:RX
  11049.   x:\MUGLIB                                  LOCAL:RX
  11050.   x:\MUGLIB\ACCOUNTS                         LOCAL:RX
  11051.   x:\MUGLIB\DLL                              LOCAL:RX
  11052.   x:\OS2\MDOS\WINOS2\SYSTEM                  LOCAL:RX
  11053.   x:\OS2\MDOS\WINOS2\*.INI                   LOCAL:RWX
  11054.   x:\OS2\MDOS\WINOS2\*.GRP                   LOCAL:RWX
  11055.   x:\NOWHERE                                 LOCAL:RWX
  11056.  
  11057.  where  x is the drive from which the OS/2 operating system was started and d 
  11058.  is the drive where the subdirectory is located. 
  11059.  
  11060.  Notes: 
  11061.  
  11062.    1. The default access control profiles for Local Security permit the default 
  11063.       OS/2 desktop to start for users if no one is logged on.  If the desktop 
  11064.       has been reconfigured, not all of the correct access control profiles 
  11065.       might be created. If the desktop cannot be started when no one logs on, 
  11066.       try logging on as an administrator.  Then verify that all of the objects 
  11067.       referred to during the desktop initialization display correctly. 
  11068.  
  11069.    2. The DESKTOP and NOWHERE directory names can be different on other 
  11070.       machines.  For example, the OS/2 2.0 desktop can be renamed to MYDESKTOP. 
  11071.       In this case, MYDESKTOP should have LOCAL:RWX access.  The NOWHERE 
  11072.       directory name is translated for different languages. 
  11073.  
  11074.  
  11075. ΓòÉΓòÉΓòÉ 16. Using Fault Tolerance ΓòÉΓòÉΓòÉ
  11076.  
  11077. The Fault Tolerance system, provided with 386 HPFS, protects against data loss 
  11078. due to hard-disk failure by: 
  11079.  
  11080.      Maintaining two copies of the data. 
  11081.  
  11082.      Monitoring hard-disk operations. 
  11083.  
  11084.      Correcting some errors automatically. 
  11085.  
  11086.      Alerting an administrator about errors that cannot be automatically 
  11087.       corrected 
  11088.  
  11089.  The Fault Tolerance system allows drive mirroring and drive duplexing as well 
  11090.  as error logging, alerting, and monitoring of disk activity in a mirrored, 
  11091.  duplexed, or standard server disk system. Fault Tolerance can be installed on 
  11092.  any server using 386 HPFS and can be administered remotely.  In some cases, 
  11093.  read performance can be improved for disks on mirrored drives, as the disk 
  11094.  with the least number of items waiting for I/O is chosen for the read request. 
  11095.  
  11096.  
  11097.   Fault Tolerance Drive Scenario
  11098.  
  11099.  Drive mirroring and drive duplexing provide duplication of data stored on 
  11100.  disk, thereby improving data integrity.  Drive mirroring is the duplication of 
  11101.  a single logical drive or volume on two partitions, primary and secondary, 
  11102.  that do not reside on the same physical disk. If the data on the two 
  11103.  partitions differs, the drives are synchronized through drive verification, 
  11104.  which ensures that the drives are identical. 
  11105.  
  11106.  The  primary partition is visible to the operating system. A primary partition 
  11107.  as used within the Fault Tolerance system should not be confused with a 
  11108.  primary partition as used by Logical Volume Manager (LVM). Fault Tolerance 
  11109.  primary partitions are actually logical partitions in LVM. The  secondary 
  11110.  partition is the backup partition and is not visible to the operating system. 
  11111.  The mirroring process automatically creates secondary partitions from 
  11112.  contiguous free space. In the previous figure, drive F is mirrored.  Drive F 
  11113.  is the primary partition and F' (F prime) is the secondary partition. 
  11114.  
  11115.  Drive duplexing is a special type of drive mirroring, with the additional 
  11116.  advantage that the two disks on which the two partitions reside are controlled 
  11117.  by two different disk controllers. Drive duplexing provides protection against 
  11118.  errors caused by a faulty controller as well as errors caused by a faulty 
  11119.  disk. In the previous figure, drives C and E are duplexed. Drives C and E are 
  11120.  primary partitions and C' and E' are secondary partitions. 
  11121.  
  11122.  Drive mirroring requires a minimum of two physical disks. The disks you use 
  11123.  for mirroring must have the same geometry. Disks with matching geometries have 
  11124.  the same number of sectors per track and the same number of tracks per 
  11125.  cylinder. Drive duplexing requires a minimum of two disks on two different 
  11126.  controllers.  In addition, each mirrored pair of partitions must reside on 
  11127.  disks that are handled by the same disk device driver. 
  11128.  
  11129.  Fault Tolerance supports up to 48 hard-disk partitions (24 mirrored drives). 
  11130.  
  11131.  Fault monitoring detects and logs errors that occur during hard-disk read and 
  11132.  write operations.  If you are monitoring disk operations, you'll receive an 
  11133.  alert when a critical error occurs. 
  11134.  
  11135.  Error correction helps recover and restore data that is otherwise lost because 
  11136.  of a disk error. When certain disk errors occur, HPFS automatically recovers 
  11137.  the data through  hotfixing.  Hotfixing detects bad sectors and reroutes data 
  11138.  to a good sector in a reserved area on the drive. Hotfixing is automatic and 
  11139.  works only on a drive with HPFS. The hotfix corrects both the primary and 
  11140.  secondary partitions, but it is not audited or in any other way supported by 
  11141.  the Fault Tolerance Monitor Utility (FTMONIT). 
  11142.  
  11143.  Another form of error correction is performed by the FTMONIT during system 
  11144.  startup if disk errors are indicated by either a disk failure or a 
  11145.  low-confidence compare failure. A low-confidence compare failure occurs when 
  11146.  Fault Tolerance discovers that key data structures on both partitions of a 
  11147.  mirrored disk do not match.  If disk errors are indicated, the FTMONIT utility 
  11148.  automatically attempts to verify or compare all sectors on both the primary 
  11149.  and secondary partitions of mirrored drives and correct any inconsistencies or 
  11150.  errors. A message is displayed indicating the drive that is being verified. 
  11151.  During the verification, the disk is locked and unavailable to users. 
  11152.  
  11153.  Fault monitoring is possible regardless of the number of disks in the 
  11154.  workstation and whether they are mirrored, duplexed, or neither. Fault 
  11155.  Tolerance is available only for LVM compatibility volumes. 
  11156.  
  11157.  For more information, see the following topics: 
  11158.  
  11159.      Fault Tolerance Utilities 
  11160.  
  11161.      Getting Started 
  11162.  
  11163.      Creating Logical Drives (Compatibility Volumes) 
  11164.  
  11165.      Starting Fault Tolerance Using the FTSETUP Utility 
  11166.  
  11167.      Using the FTADMIN Utility 
  11168.  
  11169.      Using the FTREMOTE Utility 
  11170.  
  11171.      Fault Tolerance Recovery Procedures 
  11172.  
  11173.  
  11174. ΓòÉΓòÉΓòÉ 16.1. Fault Tolerance Utilities ΓòÉΓòÉΓòÉ
  11175.  
  11176. The following four utilities control Fault Tolerance: 
  11177.  
  11178.      The Fault Tolerance Setup (FTSETUP) utility is used to configure Fault 
  11179.       Tolerance and to mirror drives. Refer to  Starting Fault Tolerance Using 
  11180.       the FTSETUP Utility for more information about using theFault Tolerance 
  11181.       Setup utility. 
  11182.  
  11183.      The FTMONIT utility controls Fault Tolerance monitoring and reports 
  11184.       errors. By default, errors are logged and administrators are alerted 
  11185.       about errors. The FTMONIT utility runs automatically when the line 
  11186.       RUN=FTMONIT.EXE is added to the CONFIG.SYS file.  This line is 
  11187.       automatically added to the CONFIG.SYS file when you run the FTSETUP 
  11188.       utility the first time.  Because the FTMONIT utility runs automatically 
  11189.       in the background, this chapter does not describe how to use this 
  11190.       utility. Refer to Command Reference for more information. 
  11191.  
  11192.      The Fault Tolerance Administration (FTADMIN) utility displays the Fault 
  11193.       Tolerance error log, manages Fault Tolerance on remote servers, views 
  11194.       drive statistics, and manage error correction and drive verification. The 
  11195.       FTADMIN utility can be run remotely to perform these tasks on other 
  11196.       server workstations on which the user has administrative privileges. 
  11197.       Refer to  Using the FTADMIN Utility for more information. 
  11198.  
  11199.      The Fault Tolerance Remote (FTREMOTE) utility is a response-file-driven 
  11200.       version of the FTADMIN utility and the FTSETUP utility that activates 
  11201.       Fault Tolerance, configures the drives to use Fault Tolerance in an 
  11202.       unattended state, verifies mirrored drives, and corrects errors. the 
  11203.       FTREMOTE utility can be called from the command line, from within a batch 
  11204.       file, or through a software distribution manager (SDM) such as the LAN 
  11205.       configuration, installation, and distribution Utility (LAN CID Utility). 
  11206.       Refer to Command Reference  for more information. 
  11207.  
  11208.  Note:  To use Fault Tolerance, Fault Tolerance Support must be installed on at 
  11209.         least one server.  In addition, Fault Tolerance Administration can be 
  11210.         installed on clients so that administrators can then correct errors 
  11211.         remotely. 
  11212.  
  11213.  
  11214. ΓòÉΓòÉΓòÉ 16.2. Getting Started ΓòÉΓòÉΓòÉ
  11215.  
  11216. The general steps to getting started with Fault Tolerance are as follows: 
  11217.  
  11218.    1. Install OS/2 LAN server and Fault Tolerance. Select the Tailored path 
  11219.       during installation to find the option for installing Fault Tolerance. 
  11220.       You must install Fault Tolerance support on at least one server.  In 
  11221.       addition, you can install the FTADMIN utility on clients. With the 
  11222.       FTADMIN utility, administrators can correct errors remotely. 
  11223.  
  11224.       Note:  To use FTADMIN remotely, first copy the following files from the 
  11225.              server to the client: 
  11226.  
  11227.           IBMLAN\NETPROG\FTMONIT.EXE 
  11228.  
  11229.           IBMLAN\NETPROG\FTADMIN.HLP 
  11230.  
  11231.           IBMLAN\NETPROG\FT.DLL 
  11232.  
  11233.    2. Use LVM to create the logical drives to be used as Fault Tolerance 
  11234.       primary partitions on each disk. Secondary partitions are created for you 
  11235.       when you mirror the primary partitions. The mirroring process also 
  11236.       automatically formats both the primary and secondary partitions for the 
  11237.       386 HPFS. 
  11238.  
  11239.       Note:  Define all partitions with LVM.  Then use the FTSETUP utility, not 
  11240.              LVM, to manipulate the drives. 
  11241.  
  11242.    3. If you plan to mirror the boot drive, create it as a logical partition 
  11243.       and install boot manager. 
  11244.  
  11245.    4. Use the FTSETUP utility to mirror drives that contain critical 
  11246.       applications and data.  Up to 24 drives can be mirrored, depending on 
  11247.       available disk space and the number of primary partitions. 
  11248.  
  11249.    5. Update your 386 HPFS Utility Disk 2 with the new mirroring configuration. 
  11250.  
  11251.    6. Designate one or more administrators to receive alerts.  Add the 
  11252.       administrator user IDs to the  alertnames parameter in the IBMLAN.INI 
  11253.       file. 
  11254.  
  11255.    7. Maintain a regular disk backup schedule.  Fault Tolerance provides 
  11256.       protection for single disk failures; however, Fault Tolerance does not 
  11257.       necessarily provide protection for multiple failures or failures that 
  11258.       occur on both partitions of a mirrored drive. 
  11259.  
  11260.  For more information, see the following topic: 
  11261.  
  11262.      Planning Example 
  11263.  
  11264.  
  11265. ΓòÉΓòÉΓòÉ 16.2.1. Planning Example ΓòÉΓòÉΓòÉ
  11266.  
  11267. Using  Fault Tolerance Drive Scenario as a guide, the following example 
  11268. illustrates how you can plan for using Fault Tolerance. 
  11269.  
  11270. Your company requires continuous server availability during business hours. 
  11271. Some of the data kept at the server must be available at all times.  Other data 
  11272. is needed only occasionally. You decide to organize the server by placing 
  11273. programs and data on separate drives, as follows: 
  11274.  
  11275.      The C drive is the startup drive, containing OS/2, OS/2 Warp Server, and 
  11276.       other programs used daily. 
  11277.  
  11278.      The D drive contains correspondence and weekly sales reports, not 
  11279.       critical to daily use. 
  11280.  
  11281.      The E drive contains inventory and daily sales. This drive must be 
  11282.       available during business hours. 
  11283.  
  11284.      The F drive contains employee records, business accounting programs, 
  11285.       customer database, useful during business hours. 
  11286.  
  11287.      The G drive contains occasional-use software and data. 
  11288.  
  11289.  Drives C and E, needed daily, require the greatest level of protection. These 
  11290.  drives are duplexed, providing protection from the failure of a single disk 
  11291.  and failure of a disk controller. 
  11292.  
  11293.  Drive F, somewhat less critical, is mirrored.  Drives D and G, because they 
  11294.  are not critical to the daily running of your business, remain unmirrored. 
  11295.  Additionally, the Boot Manager is installed to help with recovering from a 
  11296.  failure of the C drive. 
  11297.  
  11298.  
  11299. ΓòÉΓòÉΓòÉ 16.3. Creating Logical Drives (Compatibility Volumes) ΓòÉΓòÉΓòÉ
  11300.  
  11301. Before you begin mirroring, you need to create a logical drive (a logical 
  11302. partition and a compatibility volume in LVM) to serve as a Fault Tolerance 
  11303. primary partition. You need to create only the drives you want to mirror.  You 
  11304. do not need to create a drive for secondary partitions. 
  11305.  
  11306. Attention  Do not use LVM to delete a drive that is mirrored.  Refer to 
  11307.            Deleting a Drive for information about deleting a drive. 
  11308.  
  11309.  To create a logical partition: 
  11310.  
  11311.    1. Open the LVM GUI. 
  11312.  
  11313.    2. Select Partition from the toolbar. 
  11314.  
  11315.    3. Choose the disk for the partition. 
  11316.  
  11317.    4. Specify the size, name, location, and type of the partition. 
  11318.  
  11319.       You must specify the type as Logical. 
  11320.  
  11321.    5. Select Ok. 
  11322.  
  11323.  To create a compatibility partition: 
  11324.  
  11325.    1. Open the LVM GUI. 
  11326.  
  11327.    2. Select Volume. 
  11328.  
  11329.    3. Select Create a volume. 
  11330.  
  11331.    4. Select Create a non-bootable volume. 
  11332.  
  11333.       Note:  Bootable volumes can be mirrored, but before doing this, you must 
  11334.              install Boot Manager. For information on Boot Manager, see Quick 
  11335.              Beginnings. 
  11336.  
  11337.    5. Select Create a compatibility volume. 
  11338.  
  11339.    6. Choose the disk for the volume. 
  11340.  
  11341.    7. Specify the name, drive letter, and size of the volume. 
  11342.  
  11343.       The logical partition you created should appear in the partition field. 
  11344.  
  11345.    8. Select Ok. 
  11346.  
  11347.  
  11348. ΓòÉΓòÉΓòÉ 16.4. Starting Fault Tolerance Using the FTSETUP Utility ΓòÉΓòÉΓòÉ
  11349.  
  11350. The Fault Tolerance Setup (FTSETUP) utility is a Presentation Manager 
  11351. application that is used to configure Fault Tolerance and to mirror drives. You 
  11352. can start the FTSETUP utility from either LAN Server Administration or the OS/2 
  11353. command line. 
  11354.  
  11355. Before running the FTSETUP utility, drives to be mirrored must be created with 
  11356. LVM. Refer to  Creating Logical Drives (Compatibility Volumes) for basic 
  11357. information about LVM. 
  11358.  
  11359. Note:  Run the FTSETUP utility when disk activity is minimal. 
  11360.  
  11361.  The FTSETUP utility enables the user to: 
  11362.  
  11363.      Activate Fault Tolerance, including fault monitoring 
  11364.  
  11365.      View drive details 
  11366.  
  11367.      View available disk space 
  11368.  
  11369.      Mirror a drive 
  11370.  
  11371.      Unmirror drives 
  11372.  
  11373.      Delete drives 
  11374.  
  11375.      Recover detached secondary partitions 
  11376.  
  11377.      Rejoin two partitions into a mirrored drive 
  11378.  
  11379.      Deactivate Fault Tolerance 
  11380.  
  11381.  For information about the main elements of the FTSETUP window, see FTSETUP 
  11382.  Main Window Elements. 
  11383.  
  11384.  
  11385. ΓòÉΓòÉΓòÉ 16.4.1. Activating Fault Tolerance with the FTSETUP Utility ΓòÉΓòÉΓòÉ
  11386.  
  11387. This procedure needs to be performed only once, after installation. If, 
  11388. however, you install multiple operating systems, activate Fault Tolerance on 
  11389. all startup partitions. 
  11390.  
  11391. Attention  Restarting the workstation or turning it off while the FTSETUP 
  11392.            utility is running can produce unpredictable results. Always run 
  11393.            Shutdown before restarting the workstation. 
  11394.  
  11395.  To start the FTSETUP utility from LAN Server Administration, perform the 
  11396.  following procedure. 
  11397.  
  11398.  To activate Fault Tolerance: 
  11399.  
  11400.    1. Open  FTSETUP. 
  11401.  
  11402.       Note:  You can, instead, start the FTSETUP utility from the command line 
  11403.              by entering FTSETUP at an OS/2 prompt. 
  11404.  
  11405.       The first time you start the FTSETUP utility, the System Capabilities 
  11406.       window is displayed to indicate that the workstation supports either 
  11407.       fault monitoring only or both fault monitoring and drive mirroring. 
  11408.  
  11409.    2. Select  Activate to configure Fault Tolerance. 
  11410.  
  11411.       Lines are added to the CONFIG.SYS file to invoke the Fault Tolerance 
  11412.       device driver and activate fault monitoring.  After the configuration is 
  11413.       complete, an information window is displayed, indicating that the 
  11414.       workstation must be restarted. 
  11415.  
  11416.    3. Select  Ok on the information window. 
  11417.  
  11418.    4. Select  Drive, and then select  Exit. 
  11419.  
  11420.    5. Run Shutdown from the desktop. Then press Ctrl+Alt+Del to restart the 
  11421.       workstation. 
  11422.  
  11423.  
  11424. ΓòÉΓòÉΓòÉ 16.4.2. FTSETUP Main Window Elements ΓòÉΓòÉΓòÉ
  11425.  
  11426. The main window of FTSETUP provides important information regarding the drives 
  11427. used for Fault Tolerance. There are four columns of information: 
  11428.  
  11429.      The  Drive column contains a letter, C through Z, which represents the 
  11430.       current logical drive being viewed, or a question mark (?) for detached 
  11431.       drives. 
  11432.  
  11433.       The  Drive column includes several icons: 
  11434.  
  11435.         -  An icon that looks like a drive identifies a drive that is not 
  11436.            mirrored. 
  11437.  
  11438.         -  An icon that looks like two stacked drives identifies a drive that 
  11439.            is mirrored. 
  11440.  
  11441.         -  An icon that looks like a cracked drive with a question mark 
  11442.            identifies a detached drive. 
  11443.  
  11444.      The  Volume column contains the partition name assigned by the user to 
  11445.       each logical drive. 
  11446.  
  11447.      The  Status column contains the current status of the logical drive or 
  11448.       partition.  The  Status column can have the following values: 
  11449.  
  11450.         -  Cannot mirror is assigned to an unmirrored drive when there is not 
  11451.            enough additional disk space in the workstation to mirror that 
  11452.            drive.  This value is assigned to all drives if the workstation has 
  11453.            only a single hard disk.  Also, primary partitions that are not 
  11454.            located at the beginning of a disk cannot be mirrored. 
  11455.  
  11456.         -  Not mirrored indicates that a drive is not mirrored and is available 
  11457.            for drive mirroring or deleting. 
  11458.  
  11459.         -  Mirrored indicates that the drive is mirrored and is available for 
  11460.            drive unmirroring. 
  11461.  
  11462.         -  Detached indicates that a mirror (secondary partition) is no longer 
  11463.            associated with a primary partition.  Any partition with this status 
  11464.            has a question mark (?) assigned to it as a drive letter. 
  11465.  
  11466.         -  Pending mirror indicates that the drive has been selected for 
  11467.            mirroring and is associated with a secondary partition.  The drive 
  11468.            becomes mirrored when the workstation is restarted. 
  11469.  
  11470.         -  Pending unmirror indicates that the drive has been selected to be 
  11471.            unmirrored.  The associated secondary partition is available as a 
  11472.            valid logical drive.  The drive becomes unmirrored when the 
  11473.            workstation is restarted. 
  11474.  
  11475.         -  Pending recover describes a detached drive selected for recovery. 
  11476.            The drive is recovered when the workstation is restarted. 
  11477.  
  11478.         -  Recover/mirror describes a detached secondary partition has been 
  11479.            recovered and mirrored again. The newly mirrored drive is available 
  11480.            when the workstation is restarted. 
  11481.  
  11482.  
  11483. ΓòÉΓòÉΓòÉ 16.4.3. Viewing Drive Details ΓòÉΓòÉΓòÉ
  11484.  
  11485. The  Details menu choice on the Drive pull-down menu in the FTSETUP utility 
  11486. displays the details of a drive on the workstation. 
  11487.  
  11488.  To view details of a drive: 
  11489.  
  11490.    1. Select the drive for which you want to view details. 
  11491.  
  11492.    2. Select  Drive from the menu bar of the Fault Tolerance Setup main window. 
  11493.  
  11494.    3. Select  Details. The Drive Details window is displayed, with the 
  11495.       following fields: 
  11496.  
  11497.           Drive Letter indicates the current leter assigned to this drive 
  11498.  
  11499.           Volume name indicates the partition name assigned by the user to the 
  11500.            logical drive. 
  11501.  
  11502.           Status indicates the current status of the logical drive or 
  11503.            partition. 
  11504.  
  11505.           Drive format indicates the file system type.  The possible values 
  11506.            are FAT, HPFS, and UNKNOWN. 
  11507.  
  11508.           Drive size indicates the size, in megabytes, assigned by the user 
  11509.            when the drive was defined using LVM. 
  11510.  
  11511.           Primary partition disk indicates the number of the hard disk on 
  11512.            which the logical drive resides (from 1 through 128). 
  11513.  
  11514.           Primary starting cylinder indicates the starting cylinder of the 
  11515.            primary partition on the primary disk. 
  11516.  
  11517.           Secondary partition disk indicates the number of the hard disk on 
  11518.            which the secondary partition resides.  This field applies only to a 
  11519.            mirrored drive. 
  11520.  
  11521.           Secondary starting cylinder indicates the starting cylinder of the 
  11522.            secondary partition on the secondary disk (the disk containing the 
  11523.            mirror).  This field applies only to a mirrored drive. 
  11524.  
  11525.    4. Select  Ok to exit the Drive Details window and return to the Fault 
  11526.       Tolerance Setup main window. 
  11527.  
  11528.  
  11529. ΓòÉΓòÉΓòÉ 16.4.4. Viewing Available Disk Space ΓòÉΓòÉΓòÉ
  11530.  
  11531. You can view the current disk space on your system, either as a summary or as a 
  11532. detailed map of locations available for mirroring. 
  11533.  
  11534. To view available disk space: 
  11535.  
  11536.    1. Open FTSETUP. 
  11537.  
  11538.    2. Select Options. 
  11539.  
  11540.    3. Select Available Space. 
  11541.  
  11542.    4. Select Available Space Summary for a brief summary of disk space or 
  11543.       Available Space Details for a detailed map of disk space. 
  11544.  
  11545.  
  11546. ΓòÉΓòÉΓòÉ 16.4.5. Mirroring a Drive ΓòÉΓòÉΓòÉ
  11547.  
  11548. Mirrored drives must meet several conditions: 
  11549.  
  11550.      They must be LVM logical partitions residing on compatibility volumes. 
  11551.  
  11552.      A workstation must contain two or more hard disks to have mirrored 
  11553.       partitions. The disks must have the same geometry, which is the same 
  11554.       number of sectors per track and the same number of tracks per cylinder. 
  11555.       Diskette drives, CD-ROM drives, removable media drives, and redirected 
  11556.       network drives cannot be mirrored. 
  11557.  
  11558.      The hard disk intended to contain the secondary partition must have at 
  11559.       least as much contiguous unallocated space as the primary partition. 
  11560.  
  11561.      If a drive contains data, the drive is formatted with HPFS.  Drives 
  11562.       formatted with the FAT file system must be reformatted with HPFS before 
  11563.       mirroring. Back up the drive before mirroring it, because the FTSETUP 
  11564.       utility automatically reformats the disk (after verification) and 
  11565.       overwrites data. 
  11566.  
  11567.      Whenever you change the configuration of a mirrored drive, you must 
  11568.       restart the workstation to put the change into effect. 
  11569.  
  11570.      You must update Utility Disk 2 with the latest configuration information. 
  11571.  
  11572.  Note:  The FTSETUP utility automatically formats non-HPFS drives.  Before 
  11573.         mirroring drives, back up any data on non-HPFS drives. An HPFS drive 
  11574.         containing data can be mirrored without first backing up the data it 
  11575.         contains.  If a drive is an HPFS drive and contains data, no format is 
  11576.         done on the primary partition of the mirror.  Rather, the data is 
  11577.         directly copied to the secondary partition to create the mirror. 
  11578.  
  11579.  To mirror a drive: 
  11580.  
  11581.    1. Create the logical drive you want to mirror, if it is not already 
  11582.       created. 
  11583.  
  11584.    2. Open  FTSETUP. 
  11585.  
  11586.    3. Select the drive you want to mirror. 
  11587.  
  11588.    4. Select  Drive. 
  11589.  
  11590.    5. Select  Default Location to have Fault Tolerance select the location of 
  11591.       the mirror or select Select Location to select a specific location for 
  11592.       the mirror. 
  11593.  
  11594.    6. If you chose to specify the mirror location, the Select Mirror Location 
  11595.       window is displayed. Highlight the location for your mirror and select 
  11596.       Ok. 
  11597.  
  11598.       Note:  The following two steps apply only to those drives not already 
  11599.              formatted with the HPFS. 
  11600.  
  11601.    7. A warning message appears if you are trying to mirror non-HPFS drives. 
  11602.       Either select  Format to format and mirror the drive, or select Cancel to 
  11603.       cancel the mirror request. 
  11604.  
  11605.       When the drive is formatted, the Volume Label window opens. You can, if 
  11606.       you choose, enter a new volume label. 
  11607.  
  11608.    8. Type a volume label for the drive, and then select Ok on the Volume Label 
  11609.       window. 
  11610.  
  11611.       Note:  A  Locked Drive message might be displayed, indicating some 
  11612.              application files are in use. Ignore this message and select 
  11613.              Mirror to continue. 
  11614.  
  11615.       An information window is displayed, indicating that the selected drive 
  11616.       has the  Pending mirror status. 
  11617.  
  11618.    9. Select  Ok on the information window. 
  11619.  
  11620.       Repeat steps 5 through 10 for additional mirrors. After finishing your 
  11621.       selections, you must exit the FTSETUP utility and restart your 
  11622.       workstation to use the mirrored drive. 
  11623.  
  11624.  To exit the FTSETUP utility,restart your workstation, and update Utility Disk 
  11625.  2: 
  11626.  
  11627.    1. Select  Drive. 
  11628.  
  11629.    2. Select  Exit. 
  11630.  
  11631.    3. Select  Save from the Partition Changes window to save the changes.  An 
  11632.       information window is displayed, indicating that the FTSETUP utility is 
  11633.       creating partition configuration files. 
  11634.  
  11635.       Another window is displayed, indicating that data is being copied for 
  11636.       each pending mirrored drive. 
  11637.  
  11638.    4. Run Shutdown from the desktop.  When the shutdown procedure has 
  11639.       completed, press Ctrl+Alt+Del to restart the workstation. 
  11640.  
  11641.    5. Insert Utility Disk 2 in the diskette drive. 
  11642.  
  11643.    6. From an OS/2 command prompt, copy C:\FTCFG.SYS to the A:\ drive (where A 
  11644.       is the letter of your diskette drive). 
  11645.  
  11646.       This updates the mirroring configuration on Utility Diskette 2. 
  11647.  
  11648.  
  11649. ΓòÉΓòÉΓòÉ 16.4.5.1. Hints and Tips on Mirroring a Startup Drive ΓòÉΓòÉΓòÉ
  11650.  
  11651. When you begin to mirror the startup drive, you may receive an attention 
  11652. message notifying you that because other processes are using the startup drive, 
  11653. the mirror to be created might not initially be identical to the original 
  11654. partition. Also, when Shutdown starts, any data in the disk cache that is 
  11655. intended for the startup drive is written only to the primary partition of the 
  11656. mirror. 
  11657.  
  11658. When you restart, Fault Tolerance detects the difference and generates an error 
  11659. code 107 (a low-confidence compare error).  Run the FTADMIN utility at this 
  11660. point and verify the mirrored startup drive.  Doing so synchronizes both 
  11661. partitions in the mirror and corrects the error code 107. 
  11662.  
  11663.  
  11664. ΓòÉΓòÉΓòÉ 16.4.6. Unmirroring a Drive ΓòÉΓòÉΓòÉ
  11665.  
  11666. Unmirroring a drive allows for the separation of primary and secondary 
  11667. partitions into two separate logical drives or the deletion of the secondary 
  11668. partition. Use the following procedure to unmirror a drive. 
  11669.  
  11670.  To unmirror a drive: 
  11671.  
  11672.    1. Open  FTSETUP. 
  11673.  
  11674.    2. Select the drive you want to unmirror. 
  11675.  
  11676.    3. Select  Drive. 
  11677.  
  11678.    4. Select  Unmirror. 
  11679.  
  11680.       You have the option now to keep or delete the secondary partition. If you 
  11681.       choose to keep the secondary partition, you'll be asked to provide a 
  11682.       drive letter and volume name for it. 
  11683.  
  11684.       An information window is displayed indicating that the unmirroring is 
  11685.       complete. 
  11686.  
  11687.    5. Select  Ok from the information window, exit out of FTSETUP, and restart 
  11688.       your system to activate the changes. 
  11689.  
  11690.  
  11691. ΓòÉΓòÉΓòÉ 16.4.7. Deleting a Drive ΓòÉΓòÉΓòÉ
  11692.  
  11693. You can use the FTSETUP utility to delete any drives that are not mirrored, 
  11694. except for the IPL volume. 
  11695.  
  11696. Note:  If you wish to delete a drive that is currently mirrored, you must first 
  11697.        unmirror the drive. See Unmirroring a Drive for more information. 
  11698.  
  11699.  Attention  Deleting a drive causes all data on the drive to be lost.  Save any 
  11700.             valuable data on the drive before deleting the drive. 
  11701.  
  11702.   To delete a drive: 
  11703.  
  11704.    1. Open  FTSETUP. 
  11705.  
  11706.    2. Select the drive you want to delete. 
  11707.  
  11708.    3. Select  Drive. 
  11709.  
  11710.    4. Select  Delete. 
  11711.  
  11712.       An information window is displayed, indicating that deleting the drive 
  11713.       erases all the data on that drive. Select Ok to continue or Cancel to 
  11714.       quit. 
  11715.  
  11716.    5. An information window is displayed informoring you that drive deletion is 
  11717.       complete. Select  Ok on the window, exit FTSETUP, and restart your system 
  11718.       to activate the changes. 
  11719.  
  11720.  
  11721. ΓòÉΓòÉΓòÉ 16.4.8. Recovering a Detached Secondary Partition ΓòÉΓòÉΓòÉ
  11722.  
  11723. In a mirrored pair, a secondary partition that does not have an associated 
  11724. primary partition is referred to as detached. Detached drives have a question 
  11725. mark (?) as their drive letter in the Fault Tolerance Setup and Fault Tolerance 
  11726. Administration main windows. For example, if you have a mirrored drive and the 
  11727. hard disk with the primary partition fails and needs to be replaced, an error 
  11728. is logged and an alert is sent. Data is not lost. The next time the FTSETUP 
  11729. utility or the FTADMIN utility is run, a question mark (?) is displayed as the 
  11730. drive letter for the secondary partition.  The ? indicates that the secondary 
  11731. partition is detached. Detached drives can be a symptom of total disk failure. 
  11732. If you suspect total disk failure, see  Fault Tolerance Recovery Procedures. 
  11733.  
  11734. You can recover the detached secondary partition, making it visible to the 
  11735. operating system. As a part of the recovery process, the detached secondary 
  11736. partition optionally can be made into a primary or secondary partition of a 
  11737. mirrored drive. 
  11738.  
  11739.  To recover a detached drive: 
  11740.  
  11741.    1. Open  FTSETUP. 
  11742.  
  11743.    2. Select the detached drive you want to recover. 
  11744.  
  11745.    3. Select  Drive. 
  11746.  
  11747.    4. Select  Recover secondary. 
  11748.  
  11749.    5. Select the type of recovery: 
  11750.  
  11751.           Leave the drive unmirrored 
  11752.  
  11753.           Make the drive the primary of a mirror 
  11754.  
  11755.           Make the drive the secondary of a mirror 
  11756.  
  11757.    6. Specify a new drive letter and partition name for the recovered 
  11758.       partition. 
  11759.  
  11760.       An information window is displayed, indicating that the partition has 
  11761.       been recovered. 
  11762.  
  11763.    7. Select  Ok from the information window, exit FTSETUP, and restart your 
  11764.       system to activate the changes. 
  11765.  
  11766.  
  11767. ΓòÉΓòÉΓòÉ 16.4.9. Rejoining Two Partitions ΓòÉΓòÉΓòÉ
  11768.  
  11769. Fault Tolerance can rejoin two previously mirrored partitions (primary and 
  11770. secondary) into one mirrored drive. 
  11771.  
  11772. To rejoin two partitions: 
  11773.  
  11774.    1. Open FTSETUP. 
  11775.  
  11776.    2. Select either the primary or detached secondary partition from the main 
  11777.       window. 
  11778.  
  11779.       Select the partitions that contains the non-corrupted data. 
  11780.  
  11781.    3. Select Ok to rejoin the partitions. 
  11782.  
  11783.       An information window is displayed informing you that the two partitions 
  11784.       have been rejoined. 
  11785.  
  11786.    4. Select Ok from the information window, exit FTSETUP, and restart your 
  11787.       system to activate the changes. 
  11788.  
  11789.  
  11790. ΓòÉΓòÉΓòÉ 16.4.10. Deactivating Fault Tolerance using the FTSETUP Utility ΓòÉΓòÉΓòÉ
  11791.  
  11792. Deactivating Fault Tolerance removes some code lines from the CONFIG.SYS file, 
  11793. unmirrors all mirrored or pending drives and their secondary partitions, and 
  11794. recovers all detached secondary partitions. 
  11795.  
  11796. To deactivate Fault Tolerance: 
  11797.  
  11798.    1. Open FTSETUP. 
  11799.  
  11800.    2. Select Options. 
  11801.  
  11802.    3. Select Deactivate Fault Tolerance.... 
  11803.  
  11804.    4. Select Deactivate. 
  11805.  
  11806.    5. Exit FTSETUP and restart your system. 
  11807.  
  11808.  
  11809. ΓòÉΓòÉΓòÉ 16.5. Using the FTADMIN Utility ΓòÉΓòÉΓòÉ
  11810.  
  11811. The Fault Tolerance Administration (FTADMIN) utility is a Presentation Manager 
  11812. application that is used to display the Fault Tolerance error log, display 
  11813. drive statistics, and control error correction and drive verification. You can 
  11814. start the FTADMIN utility from either LAN Server Administration or the OS/2 
  11815. command line. 
  11816.  
  11817. You can use the FTADMIN utility on any client or server workstation that is 
  11818. running OS/2 Warp Server. Also, you can run the FTADMIN utility remotely to 
  11819. perform the previously listed tasks on other server workstations on which you 
  11820. have administrative privileges. 
  11821.  
  11822. From the Fault Tolerance Administration main window, you can: 
  11823.  
  11824.      Select a different server to administer 
  11825.  
  11826.      Set and reset Fault Tolerance alerting 
  11827.  
  11828.      View drive statistics 
  11829.  
  11830.      View information about logical drives 
  11831.  
  11832.      Sort error-rate statistics 
  11833.  
  11834.      Display and correct disk faults 
  11835.  
  11836.      Verify mirrored drives 
  11837.  
  11838.  For information about the main elements in the FTADMIN window, see FTADMIN 
  11839.  Main Window Elements. FTADMIN can also be run remotely. See Running the 
  11840.  FTADMIN Utility Remotely for more information. 
  11841.  
  11842.  
  11843. ΓòÉΓòÉΓòÉ 16.5.1. FTADMIN Main Window Elements ΓòÉΓòÉΓòÉ
  11844.  
  11845. The Fault Tolerance Administration main window contains three sections of 
  11846. information: 
  11847.  
  11848.      Title Bar 
  11849.  
  11850.      Logical Drive Information 
  11851.  
  11852.      Error Information 
  11853.  
  11854.  
  11855.   Fault Tolerance Administration Main Window
  11856.  
  11857.  For more information, see the following topics: 
  11858.  
  11859.      Logical Drive Information 
  11860.  
  11861.      Error Information 
  11862.  
  11863.  
  11864. ΓòÉΓòÉΓòÉ 16.5.1.1. Logical Drive Information ΓòÉΓòÉΓòÉ
  11865.  
  11866. The drive information section contains an icon for each of the workstation's 
  11867. logical drives.  Diskette drives and redirected drives are not shown.  When you 
  11868. select  Full drive information from the View pull-down menu, the drive 
  11869. information section expands horizontally to show a row of detailed information 
  11870. about each logical drive. 
  11871.  
  11872. Each row of information describes a logical drive.  An icon that represents the 
  11873. drive and its current state heads the row.  The various icons and their 
  11874. meanings are as follows: 
  11875.  
  11876.      An icon that looks like a drive identifies a drive that is not mirrored. 
  11877.  
  11878.      An icon that looks like two stacked drives identifies a drive that is 
  11879.       mirrored. 
  11880.  
  11881.      An icon that looks like a cracked drive with a question mark identifies a 
  11882.       drive on which errors have occurred.  For drives with critical errors, 
  11883.       color monitors show a red icon. 
  11884.  
  11885.      An icon that looks like two stacked drives with a crack through them 
  11886.       identifies a mirrored drive on which errors have occurred.  For drives 
  11887.       with critical errors, color monitors show a red icon. 
  11888.  
  11889.      A question mark (?) in place of the drive letter indicates the drive is 
  11890.       detached. 
  11891.  
  11892.       The remaining fields in the row to the right of the icon describe the 
  11893.       drive in more detail: 
  11894.  
  11895.      The  Drive column contains the logical drive letter. 
  11896.  
  11897.      The  Type column describes the current type of the logical drive. 
  11898.  
  11899.      The  Status column describes the current status of the logical drive. 
  11900.  
  11901.      The  Disks column describes the location of the logical drive upon the 
  11902.       physical drive.  The first number represents the physical disk that 
  11903.       contains the primary partition.  The second number represents the 
  11904.       physical disk that contains the secondary partition. 
  11905.  
  11906.      The  Verified column describes the last date on which a mirrored drive 
  11907.       was either verified by the FTADMIN utility or formatted by the FTSETUP 
  11908.       utility. If a drive has not been verified, this column displays Never 
  11909.       verified. 
  11910.  
  11911.  
  11912. ΓòÉΓòÉΓòÉ 16.5.1.2. Error Information ΓòÉΓòÉΓòÉ
  11913.  
  11914. The error information section contains information about disk errors on the 
  11915. selected drive.  On color monitors, critical errors are displayed in red.  For 
  11916. each error, the following columns of information are shown: 
  11917.  
  11918.      The  Drive column contains the drive letter of the logical drive on which 
  11919.       the error occurred. 
  11920.  
  11921.      The  Code column contains a numerical code that identifies the error. 
  11922.  
  11923.      The  Severity column contains a status word that indicates the severity 
  11924.       of the error.  The possible values for the Severity column in decreasing 
  11925.       order of severity are: Critical, Error, and Warning. 
  11926.  
  11927.      The  Disk Block column contains a 10-digit number that indicates which 
  11928.       disk block had the error. 
  11929.  
  11930.      The  Date/Time column indicates the date and time that the error 
  11931.       occurred. 
  11932.  
  11933.  
  11934. ΓòÉΓòÉΓòÉ 16.5.2. Selecting a Server ΓòÉΓòÉΓòÉ
  11935.  
  11936. Use the FTADMIN utility to monitor and correct errors locally and remotely. You 
  11937. can view any of the servers in any domain in which the client is logged on. To 
  11938. monitor and correct errors at a remote server, you must select the remote 
  11939. server. 
  11940.  
  11941.  To select servers in other domains: 
  11942.  
  11943.    1. Open  FTADMIN. 
  11944.  
  11945.       Note:  You can, instead, start the FTADMIN utility from the command line 
  11946.              by entering FTADMIN at an OS/2 prompt. To start the FTADMIN 
  11947.              utility at a server other than the local server, enter FTADMIN \\ 
  11948.              servername, where  servername is the name of the server you want 
  11949.              to administer. 
  11950.  
  11951.    2. Select  Options. 
  11952.  
  11953.    3. Select  Select server. 
  11954.  
  11955.       A window is displayed containing a list of the servers in the local 
  11956.       domain that are enabled for Fault Tolerance. 
  11957.  
  11958.       Note:  When logging on using User Profile Management, Fault Tolerance 
  11959.              performs a domain-wide verification of the user ID.  If you log on 
  11960.              as a user (not an administrator), the  Select server field is 
  11961.              empty because your domain has no servers that you can administer. 
  11962.  
  11963.    4. Select the server that you want to monitor, or type the server's machine 
  11964.       name in the  Set server to field. 
  11965.  
  11966.    5. Select  Ok from the Select Server window. 
  11967.  
  11968.    6. If you are prompted to supply a password, type the password in the Enter 
  11969.       password field, and then select  Enter. The requested password is a User 
  11970.       Profile Management password for the server that is in another domain. 
  11971.       The password must be associated with your user ID on that domain. 
  11972.  
  11973.       The Fault Tolerance Administration main window ( Fault Tolerance 
  11974.       Administration Main Window) returns, displaying drive information for the 
  11975.       server you specified. 
  11976.  
  11977.  
  11978. ΓòÉΓòÉΓòÉ 16.5.3. Setting Up to Receive Fault Tolerance Alerts ΓòÉΓòÉΓòÉ
  11979.  
  11980. Use the following procedure to receive alerts. 
  11981.  
  11982.  To receive Fault Tolerance alerts: 
  11983.  
  11984.    1. Make sure the user IDs of those who are to be sent alerts are given 
  11985.       administrator privilege. 
  11986.  
  11987.    2. Add these user IDs to the  alertnames parameter in the IBMLAN.INI file. 
  11988.  
  11989.    3. Make sure the Alerter service is listed in the srvservices parameter in 
  11990.       the IBMLAN.INI file. 
  11991.  
  11992.    4. Use the FTMONIT utility or the FTADMIN utility to turn on the Fault 
  11993.       Tolerance Alerts setting. 
  11994.  
  11995.  For more information, see the following topic: 
  11996.  
  11997.      Turning Disk Alerts On and Off 
  11998.  
  11999.  
  12000. ΓòÉΓòÉΓòÉ 16.5.3.1. Turning Disk Alerts On and Off ΓòÉΓòÉΓòÉ
  12001.  
  12002. By default, the FTMONIT utility issues an alert whenever a critical disk error 
  12003. occurs.  The administrators who receive alerts are specified by the alertnames 
  12004. parameter in the Server section of the IBMLAN.INI file. If the Requester 
  12005. service is not started on a workstation when a disk error occurs, the FTMONIT 
  12006. utility starts the Requester and Alerter services and then sends the alert to 
  12007. the administrators that are set up to receive error alerts. 
  12008.  
  12009. Three classes of fault tolerance alerts indicate different levels of severity: 
  12010.  
  12011.      Warning alerts inform you that a read or write error occurred and was 
  12012.       corrected.  No alerts are sent to administrators listed by the alertnames 
  12013.       parameter, but Fault Tolerance displays an error message.  The 
  12014.       cracked-drive icon is displayed. The cracked-drive icon is cleared when 
  12015.       the user views the error. 
  12016.  
  12017.      Error alerts inform you of more severe disk errors, such as excessive 
  12018.       disk failures or verification failures.  An alert is sent, and an error 
  12019.       message is displayed.  The cracked-drive icon is displayed. 
  12020.  
  12021.      Critical error alerts inform you of critical disk errors, such as a 
  12022.       complete disk failure or a mirrored drive that has been detached. An 
  12023.       alert is sent, and an error message is displayed.  The cracked-drive icon 
  12024.       is displayed.  On color monitors, the error message and drive icon are 
  12025.       red. 
  12026.  
  12027.  To see a list of the possible errors reported by Fault Tolerance, view the 
  12028.  help index in the FTADMIN utility.  The errors are listed under the "logged 
  12029.  errors" topic. 
  12030.  
  12031.   To turn alerts on or off: 
  12032.  
  12033.    1. Open  FTADMIN. 
  12034.  
  12035.    2. Select  Options. 
  12036.  
  12037.    3. Select  Alerts setting. 
  12038.  
  12039.    4. To turn disk error alerting on, select the  Send alerts check box.  To 
  12040.       cancel disk error alerting, deselect the check box. 
  12041.  
  12042.    5. Select  Ok in the  Alerts setting window. 
  12043.  
  12044.  Note:  Changes made to disk alerts are not permanent and will not last through 
  12045.         a system shutdown. 
  12046.  
  12047.  
  12048. ΓòÉΓòÉΓòÉ 16.5.4. Viewing Drive Statistics ΓòÉΓòÉΓòÉ
  12049.  
  12050. Drive statistics are available for each drive, whether it is mirrored, 
  12051. duplexed, or neither.  These fault monitoring statistics tell you if the drive 
  12052. is mirrored and how many reads and writes, recovered and unrecovered faults, 
  12053. and hotfixed faults have occurred. Statistics are kept from the time the 
  12054. workstation was started or from the last time the statistics were cleared. 
  12055.  
  12056.  To view or clear drive statistics: 
  12057.  
  12058.    1. Open  FTADMIN. 
  12059.  
  12060.    2. Select the drive for which you want statistics. 
  12061.  
  12062.    3. Select  Drive. 
  12063.  
  12064.    4. Select  Statistics. 
  12065.  
  12066.       The displayed statistics have the following meanings: 
  12067.  
  12068.                  Statistics          Definition
  12069.  
  12070.       Status                   Indicates whether errors have been detected. 
  12071.  
  12072.       Primary partition        Indicates whether the primary partition is 
  12073.                                enabled. When a drive is enabled, the 
  12074.                                workstation can perform reads and writes on it. 
  12075.                                A disabled drive has critical errors that must 
  12076.                                be corrected, and it cannot accommodate reads 
  12077.                                and writes. 
  12078.  
  12079.       Secondary partition      Indicates whether the secondary partition is 
  12080.                                enabled.  This field is shaded if the drive is 
  12081.                                not mirrored. 
  12082.  
  12083.       Mirror status            Indicates whether the drive is mirrored. 
  12084.  
  12085.       Reads from primary       Indicates the number of successful reads from 
  12086.                                the primary partition. 
  12087.  
  12088.       Reads from secondary     Indicates the number of successful reads from 
  12089.                                the secondary partition in a mirrored pair. This 
  12090.                                field is shaded if the drive is not mirrored. 
  12091.  
  12092.       Writes to primary        Indicates the number of successful writes to the 
  12093.                                primary partition. 
  12094.  
  12095.       Writes to secondary      Indicates the number of successful writes to the 
  12096.                                secondary partition in a mirrored pair. This 
  12097.                                field is shaded if the drive is not mirrored. 
  12098.  
  12099.       Recovered faults         Indicates the number of read faults that were 
  12100.                                recovered from a mirrored drive. 
  12101.  
  12102.       Unrecovered faults       Indicates the number of faults for which 
  12103.                                recovery was not possible. 
  12104.  
  12105.       Hotfixed faults          Indicates the number of read or write requests 
  12106.                                that failed but were hotfixed.  The hotfixed 
  12107.                                faults can have occurred on a drive that was 
  12108.                                mirrored or on a drive that was not. 
  12109.  
  12110.    5. Select  Clear to clear statistics. 
  12111.  
  12112.    6. Select  Ok when you are through viewing drive statistics. 
  12113.  
  12114.  
  12115. ΓòÉΓòÉΓòÉ 16.5.5. Viewing Information about Logical Drives ΓòÉΓòÉΓòÉ
  12116.  
  12117. The drive information section of the Fault Tolerance Administration main window 
  12118. contains an icon for each of the workstation's logical drives. Diskette drives, 
  12119. CD-ROM, removable media, and redirected drives are not shown.  Several types of 
  12120. icons are used in the drive information section. Refer to Logical Drive 
  12121. Information for descriptions of the icons. 
  12122.  
  12123. You can expand the drive information section of the Fault Tolerance 
  12124. Administration main window.  The error information section moves to the bottom 
  12125. of the window.  The drive information section expands to show detailed 
  12126. information about each drive. 
  12127.  
  12128. For each logical drive, the following information is displayed: 
  12129.  
  12130.      Whether or not the drive is mirrored 
  12131.  
  12132.      The severity of the worst error on the drive (in the Status column) 
  12133.  
  12134.      The physical disks associated with the logical drive 
  12135.  
  12136.      The time when the drive was last verified 
  12137.  
  12138.   To expand the drive information section: 
  12139.  
  12140.    1. Select  View from the menu bar of the Fault Tolerance Administration main 
  12141.       window. 
  12142.  
  12143.    2. Select  Full drive information. 
  12144.  
  12145.       To remove the displayed information, select  Full drive information again 
  12146.       from the View pull-down menu. The  Full drive information menu choice 
  12147.       works like a toggle switch. 
  12148.  
  12149.  
  12150. ΓòÉΓòÉΓòÉ 16.5.6. Sorting the Error Information ΓòÉΓòÉΓòÉ
  12151.  
  12152. The error information section of the Fault Tolerance Administration main window 
  12153. contains information about disk errors on the selected drive.  On color 
  12154. monitors, critical errors are displayed in red.  For each error, five columns 
  12155. of information are displayed. Refer to Error Information for a description of 
  12156. each information column. 
  12157.  
  12158. The errors listed in the error information section of the Fault Tolerance 
  12159. Administration main window can be ordered by time or by severity. 
  12160.  
  12161.  To sort errors by time of occurrence from oldest to most recent: 
  12162.  
  12163.    1. Open  FTADMIN. 
  12164.  
  12165.    2. Select  View. 
  12166.  
  12167.    3. Select  Sort errors by time. 
  12168.  
  12169.   To sort errors by severity: 
  12170.  
  12171.    1. Select  View from the menu bar of the Fault Tolerance Administration main 
  12172.       window. 
  12173.  
  12174.    2. Select  Sort errors by severity. 
  12175.  
  12176.  
  12177. ΓòÉΓòÉΓòÉ 16.5.7. Correcting Disk Errors ΓòÉΓòÉΓòÉ
  12178.  
  12179. Many disk errors that Fault Tolerance detects can be corrected.  As part of 
  12180. fault recovery, Fault Tolerance displays a prompt informing you about the type 
  12181. of error detected and provides information about the best way to correct the 
  12182. error. 
  12183.  
  12184. For purposes of fault recovery, four types of error are monitored: 
  12185.  
  12186.      Self-correcting errors 
  12187.  
  12188.      Administrator-corrected errors using the FTADMIN utility 
  12189.  
  12190.      Repeated drive failures 
  12191.  
  12192.      Complete hard-disk failures 
  12193.  
  12194.  During error correction, you can correct individual errors, all errors on a 
  12195.  drive, or all errors on all drives.  Some errors are self-correcting and do 
  12196.  not require your intervention.  More serious errors require that you perform 
  12197.  an action as part of the error correction. 
  12198.  
  12199.  Online helps are available for each error.  For a list of errors and 
  12200.  corresponding corrective actions for disk errors found by Fault Tolerance, see 
  12201.  the  FTADMIN help. 
  12202.  
  12203.  You can use several methods to correct errors found by Fault Tolerance. 
  12204.  
  12205.  To correct errors: 
  12206.  
  12207.    1. Open  FTADMIN. 
  12208.  
  12209.    2. Select the error or drive on which you want to perform error correction. 
  12210.  
  12211.    3. Select  Error. 
  12212.  
  12213.    4. Select one of the following items: 
  12214.  
  12215.           If you want to correct a specific error, select Correct. 
  12216.  
  12217.           If you want to correct all errors on a specific drive, select 
  12218.            Correct all on selected drive. 
  12219.  
  12220.           If you want to correct all errors on all drives on the server, 
  12221.            select Correct all. 
  12222.  
  12223.            Note:  Using the mouse to double-click on an error message in the 
  12224.                   Fault Tolerance Administration main window has the same 
  12225.                   effect as selecting that error and selecting  Correct from 
  12226.                   the Error pull-down menu. Double-clicking on a drive icon in 
  12227.                   the drive information section of the Fault Tolerance 
  12228.                   Administration main window has the same effect as selecting 
  12229.                   that drive and selecting  Correct all on selected drive from 
  12230.                   the Fault Tolerance Administration main window. 
  12231.  
  12232.    5. When correcting multiple errors, select Yes in the confirmation window 
  12233.       that pops up to confirm and correct one error at a time. To correct all 
  12234.       errors automatically, select No. 
  12235.  
  12236.       If you select  Yes, a message window is displayed, describing each error 
  12237.       and the corrective action to be taken. 
  12238.  
  12239.       If you select  No, the FTADMIN utility attempts to correct the selected 
  12240.       errors automatically on the selected drive.  If any errors cannot be 
  12241.       automatically corrected, the uncorrected errors are listed in the error 
  12242.       information section of the Fault Tolerance Administration main window. To 
  12243.       correct the remaining errors, correct each error individually, or correct 
  12244.       all errors and, when prompted with the message Do you want to confirm 
  12245.       each corrective action before it is taken?, select  Yes. A message window 
  12246.       is displayed describing each error and the corrective action to be taken. 
  12247.  
  12248.  For more information, see the following topics: 
  12249.  
  12250.      Automatically Corrected Errors 
  12251.  
  12252.      Correcting Cracked Mirrored Drives 
  12253.  
  12254.      Repeated Disk Failures 
  12255.  
  12256.  
  12257. ΓòÉΓòÉΓòÉ 16.5.7.1. Automatically Corrected Errors ΓòÉΓòÉΓòÉ
  12258.  
  12259. Disks can develop bad disk sectors in the course of normal workstation 
  12260. operation. In most instances, these errors are self-correcting, and HPFS fixes 
  12261. them without losing or damaging data.  A message in the error information 
  12262. window informs you of the error, but no alert is sent. 
  12263.  
  12264. If errors are detected on a disk during system startup, the FTMONIT utility 
  12265. attempts to verify or compare all sectors on both the primary and secondary 
  12266. partitions of mirrored drives.  Any inconsistencies are corrected, and a 
  12267. message is displayed indicating which drive is being verified. If the drive is 
  12268. in use when the FTMONIT utility tries to verify it, the verify operation does 
  12269. not work.  You must use the FTADMIN utility to verify the drive manually. 
  12270.  
  12271.  
  12272. ΓòÉΓòÉΓòÉ 16.5.7.2. Correcting Cracked Mirrored Drives ΓòÉΓòÉΓòÉ
  12273.  
  12274. When drives in a mirrored pair have had a disk error, the drive is called a 
  12275. cracked mirror.  The drive icon on the FTADMIN utility main window appears 
  12276. cracked, and Fault Tolerance sends an error alert.  Actions such as turning off 
  12277. the workstation without running Shutdown can cause cracked mirrors. 
  12278.  
  12279. If the cracked mirror was caused by a disk error, correcting the error usually 
  12280. clears the cracked mirror.  Refer to Correcting Disk Errors for more 
  12281. information.  In some cases, especially those involving mechanical or 
  12282. electronic damage to a hard disk or its controller, the error cannot be 
  12283. corrected by Fault Tolerance. Fault Tolerance preserves the data, but you must 
  12284. still intervene.  In these cases, you must back up the drive, reformat it, and 
  12285. restore it, or in the worst cases, replace a drive controller or hard disk. 
  12286.  
  12287.  
  12288. ΓòÉΓòÉΓòÉ 16.5.7.3. Repeated Disk Failures ΓòÉΓòÉΓòÉ
  12289.  
  12290. Repeated failures can indicate that a hard disk is going to fail completely. 
  12291. Fault Tolerance sends an error alert when a disk's failure rate is excessive. 
  12292.  
  12293. Excessive failures can indicate that the disk should be reformatted or 
  12294. replaced.  When you get an excessive-failure alert, make a backup copy of all 
  12295. drives that have a primary or secondary partition on the failing disk.  Next, 
  12296. run the diagnostics for the hard disk (supplied by the disk manufacturer) to 
  12297. determine whether the disk needs reformatting. 
  12298.  
  12299. If the diagnostics require a low-level format of the disk, the reformatting 
  12300. removes all partitions on that disk.  If a secondary partition is destroyed, 
  12301. the system marks the primary partition as unmirrored.  If the primary partition 
  12302. is destroyed, leaving just the secondary partition (a detached partition), the 
  12303. secondary partition is represented by a question mark (?) as the drive letter. 
  12304.  
  12305. You can recover the detached partition, making it visible to the operating 
  12306. system (see  Recovering a Detached Secondary Partition). 
  12307.  
  12308. Note:  If excessive errors occur on SCSI drives or your system hangs, make sure 
  12309.        the SCSI adapters are terminated properly.  Refer to the documentation 
  12310.        that came with the adapters for more information. 
  12311.  
  12312.  
  12313. ΓòÉΓòÉΓòÉ 16.5.8. Verifying Drives ΓòÉΓòÉΓòÉ
  12314.  
  12315. Verification consists of reading all the used sectors (sectors that contain 
  12316. either data or controls) on both the primary and secondary partitions of a 
  12317. mirrored drive and comparing the data.  If an inconsistency is found between 
  12318. the data on the two partitions, the data on the partition with the error is 
  12319. replaced with the data from the partition without the error.  Any drive that is 
  12320. represented by a double-drive icon (mirrored) can be verified. 
  12321.  
  12322. Disk errors and loss of power can cause the data on the primary partition to no 
  12323. longer match the data on the secondary partition. Verify drives when you 
  12324. restart a workstation after a power interruption (if the Uninterruptible Power 
  12325. Supply service is not in effect) but not before first correcting all errors on 
  12326. the drive. 
  12327.  
  12328. To verify a single mirrored drive: 
  12329.  
  12330.    1. Open  FTADMIN. 
  12331.  
  12332.    2. Highlight the drive you want to verify. 
  12333.  
  12334.    3. Select  Drive. 
  12335.  
  12336.    4. Select  Verify. 
  12337.  
  12338.  To verify all mirrored drives on the server: 
  12339.  
  12340.    1. Select  Drive. 
  12341.  
  12342.    2. Select  Verify all. 
  12343.  
  12344.  
  12345. ΓòÉΓòÉΓòÉ 16.5.9. Running the FTADMIN Utility Remotely ΓòÉΓòÉΓòÉ
  12346.  
  12347. You can run the FTADMIN utility from a workstation outside of the domain on 
  12348. which Fault Tolerance is active.  It can also be run remotely as a public 
  12349. application. Several prerequisites must be satisfied for you to do this: 
  12350.  
  12351.      The FTADMIN utility must either be installed on the remote workstation 
  12352.       itself or be properly defined as a public application on the network to 
  12353.       be administered.  To use the FTADMIN utility from a workstation on which 
  12354.       it is not currently installed, the proper aliases must also be defined 
  12355.       for it, and the appropriate access controls must be in place. 
  12356.  
  12357.      You mut copy the following files from the server to the remote 
  12358.       workstation: 
  12359.  
  12360.         -  IBMLAN\NETPROG\FTMONIT.EXE 
  12361.  
  12362.         -  IBMLAN\NETPROG\FTADMIN.HLP 
  12363.  
  12364.         -  IBMLAN\NETPROG\FT.DLL 
  12365.  
  12366.      You must be logged on to the network as an administrator. 
  12367.  
  12368.  If the previous prerequisites are satisfied, type 
  12369.  
  12370.   FTADMIN \\servername
  12371.   on the command line, where  servername is the name of the server to 
  12372.  administer. 
  12373.  
  12374.  
  12375. ΓòÉΓòÉΓòÉ 16.6. Using the FTREMOTE Utility ΓòÉΓòÉΓòÉ
  12376.  
  12377. The FTREMOTE utility is a subset of the FTADMIN utility and the FTSETUP utility 
  12378. that can execute a set of Fault Tolerance commands contained in a command file, 
  12379. similar in concept to an AUTOEXEC.BAT file or a logon script file.  Before 
  12380. executing these commands, the FTREMOTE utility can compare a previously 
  12381. recorded drive-details report to the current one and run commands depending on 
  12382. which items on the details reports match. 
  12383.  
  12384. The FTREMOTE utility can perform many of the common Fault Tolerance tasks that 
  12385. do not require the administrator to be present. The tasks it can perform 
  12386. include: 
  12387.  
  12388.      Automatically activating Fault Tolerance (if it is not already 
  12389.       activated). 
  12390.  
  12391.      Configuring the drives to use Fault Tolerance in an unattended state. 
  12392.  
  12393.      Verifying mirrored drives. 
  12394.  
  12395.      Correcting disk errors. 
  12396.  
  12397.  For information on how to use the FTREMOTE utility, see Command Reference. 
  12398.  
  12399.  
  12400. ΓòÉΓòÉΓòÉ 16.7. Fault Tolerance Recovery Procedures ΓòÉΓòÉΓòÉ
  12401.  
  12402. Fault Tolerance should be used on any server that contains vital data or 
  12403. requires high system availability. Mirroring the drives on a hard disk makes it 
  12404. easier to recover from a disk failure because the system keeps two up-to-date 
  12405. versions of the data. 
  12406.  
  12407. OS/2 Warp Server Fault Tolerance is designed to tolerate, correct, and recover 
  12408. from most recurring faults. Fault Tolerance does not, however, protect a system 
  12409. from the loss of two disks at the same time. If one of the mirrored disks fails 
  12410. completely, manual recovery is required. 
  12411.  
  12412. The best way to use Fault Tolerance to recover from a total disk failure in a 
  12413. short time frame is to have a recovery plan. Consider the following tips to 
  12414. ensure successful recovery: 
  12415.  
  12416.      Each time the hardware configuration changes, make a backup of the 
  12417.       configuration. This backup may be needed to recover from a failed system 
  12418.       partition. 
  12419.  
  12420.      Install the OS/2 Boot Manager at the beginning of the first hard disk. 
  12421.       Then create all the drives as logical drives. 
  12422.  
  12423.      After all drives are mirrored, copy C:\FTCFG.SYS to the second 386 HPFS 
  12424.       startup diskette. Also, run the FTREMOTE utility without parameters, and 
  12425.       save the FTSTATUS.LOG file. This file contains a summary of the drive 
  12426.       locations and is very helpful during drive recovery. 
  12427.  
  12428.       Each time the drive configuration is changed, the startup diskette should 
  12429.       be updated and the FTREMOTE utility should be rerun. 
  12430.  
  12431.      Several files are needed when the recovery procedure must be done from 
  12432.       diskette. Save a copy of the files listed in Recovery from Total Failure 
  12433.       of a Nonmirrored Disk. 
  12434.  
  12435.       Note:  Several of these files are DLLs. Make sure the LIBPATH statement 
  12436.              in the CONFIG.SYS file on the second diskette references the 
  12437.              location of these files during the recovery scenario. 
  12438.  
  12439.  For more information, see the following topics: 
  12440.  
  12441.      Recovery from Total Failure of a Nonmirrored Disk 
  12442.  
  12443.      Recovery from Total Failure of a Mirrored Disk 
  12444.  
  12445.  
  12446. ΓòÉΓòÉΓòÉ 16.7.1. Recovery from Total Failure of a Nonmirrored Disk ΓòÉΓòÉΓòÉ
  12447.  
  12448. This procedure describes how to recover from a failed disk that is not 
  12449. mirrored. You need a drive map that shows the partitions, logical drives, and 
  12450. the size in megabytes of each.  One way to generate a drive map is to run 
  12451. FTREMOTE to generate a status file that lists the current configuration.  For 
  12452. more information, see Command Reference. 
  12453.  
  12454.  To recover from a total failure of a nonmirrored disk: 
  12455.  
  12456.    1. Start with the following configuration.  The prime character (') 
  12457.       indicates a secondary partition.  D: is the primary partition on Disk 1, 
  12458.       and the secondary partition is D:' on Disk 2, and so on. 
  12459.  
  12460.  
  12461.             Fault Tolerance Current Drive Configuration
  12462.  
  12463.    2. Because Disk 1 has failed, replace the hard disk. 
  12464.  
  12465.       Note:  If the disk that failed has a system partition, you must install 
  12466.              the system partition from your reference diskette. 
  12467.  
  12468.    3. Perform the following steps only if the failed disk contains the startup 
  12469.       drive: 
  12470.  
  12471.         a. Install the operating system. If you plan to mirror the C drive, it 
  12472.            must be formatted for HPFS.  Otherwise, formatting the C drive as 
  12473.            HPFS is recommended but not required. 
  12474.  
  12475.         b. Install OS/2 Warp Server with the Fault Tolerance Support option. 
  12476.  
  12477.       At this point in the procedure, the two detached secondary partitions are 
  12478.       denoted by a question mark (?). 
  12479.  
  12480.  
  12481.             Fault Tolerance Changed Drive Configuration
  12482.  
  12483.    4. Run the FTSETUP utility, and using your drive map, recover the detached 
  12484.       secondary partitions and remirror the drives. For this example: 
  12485.  
  12486.         a. Recover the first detached secondary drive as a secondary of a 
  12487.            mirror and assign it drive letter D: 
  12488.  
  12489.         b. Recover the second detached secondary drive as a secondary of a 
  12490.            mirror and assign it drive letter E: 
  12491.  
  12492.         c. Mirror drive F.  (This disk becomes F:' on Disk 1.) 
  12493.  
  12494.         d. Mirror drive G.  (This disk becomes G:' on Disk 1.) 
  12495.  
  12496.    5. Save the changes, run Shutdown from the desktop, and restart the system. 
  12497.       The system is now restored, and the drive letters are restored to the 
  12498.       values they had prior to disk failure. 
  12499.  
  12500.  
  12501.             Fault Tolerance Restored Drive Configuration
  12502.  
  12503.  
  12504. ΓòÉΓòÉΓòÉ 16.7.2. Recovery from Total Failure of a Mirrored Disk ΓòÉΓòÉΓòÉ
  12505.  
  12506. This procedure describes how to recover from a failed disk that is mirrored. In 
  12507. this example, the first disk has failed and must be replaced. The computer used 
  12508. in this example consists of a Personal System/2 (PS/2) model 95 with two 400MB 
  12509. SCSI hard disks, one SCSI controller, and a 1.44MB floppy disk drive. The OS/2 
  12510. operating system, OS/2 Warp Server, 386 HPFS, and Fault Tolerance are installed 
  12511. on the system. 
  12512.  
  12513. The OS/2 Boot Manager is installed on the first disk, and all drives are 
  12514. logical drives. The first disk is partitioned as follows: 
  12515.  
  12516.      Boot manager partition 
  12517.  
  12518.      Logical drive C, OS/2, mirrored 
  12519.  
  12520.      Logical drive D, OS/2 Warp Server with 386 HPFS, mirrored 
  12521.  
  12522.      Logical drive E, data area, mirrored 
  12523.  
  12524.      Hidden system partition 
  12525.  
  12526.   To recover from a total failure of a mirrored disk: 
  12527.  
  12528.    1. Replace the crashed disk with a new one. 
  12529.  
  12530.    2. Turn on the system with the backup reference diskette of the system 
  12531.       partition. 
  12532.  
  12533.    3. Run the automatic configuration, if necessary, and restart the system. 
  12534.  
  12535.    4. Restore the system partition to the new disk. 
  12536.  
  12537.    5. Start from the 386 HPFS diskettes. 
  12538.  
  12539.    6. Install Boot Manager on the new disk. 
  12540.  
  12541.    7. Copy the DLLs (described below) to a valid partition. 
  12542.  
  12543.    8. Create the response file for the FTREMOTE utility. Have the right 
  12544.       location information ready in the FTREMOTE response file. This can be 
  12545.       determined by the saved FTSTATUS.LOG file. In this example, the response 
  12546.       file contains: 
  12547.  
  12548.             COMMANDS
  12549.             <
  12550.              RECOVER LOC=2:1 SECONDARY
  12551.              RECOVER LOC=2:100 SECONDARY
  12552.              RECOVER LOC=2:250 SECONDARY
  12553.             >
  12554.  
  12555.    9. Run the FTREMOTE utility to recover the partitions. 
  12556.  
  12557.   10. Run LVM to add the new startup drive to the Boot Manager menu. 
  12558.  
  12559.   11. Restart the server. 
  12560.  
  12561.   12. Run the FTADMIN utility to verify and synchronize the other partitions. 
  12562.  
  12563.  Below are the different DLL modules and their locations: 
  12564.  
  12565.   Location            Module
  12566.  
  12567.  \OS2\DLL 
  12568.  
  12569.                          NAMEPIPES.DLL 
  12570.  
  12571.  \MUGLIB\DLL 
  12572.  
  12573.                          NETAPI.DLL 
  12574.  
  12575.                          NETOEM.DLL 
  12576.  
  12577.                          NETSPOOL.DLL 
  12578.  
  12579.                          MAILSLOT.DLL 
  12580.  
  12581.  \IBMLAN\NETPROG 
  12582.  
  12583.                          FTREMOTE.EXE 
  12584.  
  12585.                          FTR.MSG 
  12586.  
  12587.  \IBMLAN\NETLIB 
  12588.  
  12589.                          FT.DLL 
  12590.  
  12591.  \OS2 
  12592.  
  12593.                          LVM.EXE 
  12594.  
  12595.                          LVM.DLL 
  12596.  
  12597.                          LVM.MSG 
  12598.  
  12599.  
  12600. ΓòÉΓòÉΓòÉ 17. Replicating Files ΓòÉΓòÉΓòÉ
  12601.  
  12602. OS/2 Warp Server or LAN Server provides two file replication 
  12603. services-Replicator and DCDB Replicator-that allow a centralized set of files 
  12604. to be selectively replicated from a server to one or more servers or clients. 
  12605.  
  12606. The Replicator service makes sure that any updates to replicated files are sent 
  12607. in a timely way to all workstations that maintain replicas of the centrally 
  12608. managed information.  The Replicator service can replicate up to 1000 entries 
  12609. within a directory or subdirectory.  Included in the 1000-file limit is an 
  12610. internal file (*.RP$) that is used by the Replicator service.  The depth or 
  12611. path name of any directory cannot exceed 32 subdirectories. 
  12612.  
  12613. Replication simplifies the updating and coordinating of servers. For example, 
  12614. if you must edit a file on several servers every week, you can update the file 
  12615. on one server and let replication handle the other servers. 
  12616.  
  12617. You can also use replication to maintain backup copies of files and directories 
  12618. on different workstations, including the domain controller database (although 
  12619. you should use the DCDB Replicator for this, as it is already optimized and set 
  12620. up for this purpose).  This way, files lost or damaged on one server can be 
  12621. recovered from another. 
  12622.  
  12623. The DCDB Replicator service is a subset of the full Replicator service, 
  12624. optimized for the replication of the domain controller database. Many of the 
  12625. parameters that must be set to back up the DCDB using the full Replicator 
  12626. service are preset in the DCDB Replicator service.  Both services can run 
  12627. simultaneously without conflict. For more information on DCDBREPL, see  Using 
  12628. the DCDB Replicator  Service to Back Up the DCDB. 
  12629.  
  12630. You can use the Replicator service to replicate administrative or application 
  12631. information, including configuration profiles and application directories.  The 
  12632. Replicator service provides: 
  12633.  
  12634.      Replication of one or more directories from any server to any set of 
  12635.       servers or clients 
  12636.  
  12637.      Selective replication, allowing each importer to replicate only the 
  12638.       directories appropriate to it 
  12639.  
  12640.      Ability to add to or delete from the set of directories being replicated 
  12641.       dynamically 
  12642.  
  12643.      Ability to replicate only files in a first-level directory or the entire 
  12644.       tree, including all files and subdirectories 
  12645.  
  12646.      Directory-level integrity checking to make sure that partial replication 
  12647.       of a directory never occurs 
  12648.  
  12649.      Ability to replicate information locally to provide a local mirroring 
  12650.       service 
  12651.  
  12652.  The server sending the data is called the  exporter. clients and servers 
  12653.  receiving the data are called the importers. 
  12654.  
  12655.  Each exporter stores all such information under one common path, called the 
  12656.  export path.  The location of this path can be configured on each exporter. 
  12657.  The importer workstation for any replication operation uses a single path, 
  12658.  called the  import path, as the target of all copied directories. 
  12659.  
  12660.  Before you can replicate files across a domain, you must prepare the computers 
  12661.  that will be sending (exporting) files, and the computers that will be 
  12662.  receiving (importing) files.  Follow the steps in Setting Up The Exporter and 
  12663.  Setting Up the Importer to replicate files. 
  12664.  
  12665.  The export path must contain a set of subdirectories.  The objects copied are 
  12666.  files in each subdirectory. To add data to be replicated, put it in a 
  12667.  subdirectory of a server's export path. To stop sending updates, delete the 
  12668.  directory from the export path. To initiate receiving copies of a given 
  12669.  directory, create an empty directory of that name under the import path in the 
  12670.  intended path at the intended importer.  To stop receiving updates, delete the 
  12671.  directory from the import path. 
  12672.  
  12673.  Exporters check for changes to their directories at the interval you have set 
  12674.  and notify importers of any changes that occurred during that interval. 
  12675.  Importers then perform the specified file replication.  Importers never check 
  12676.  an exporter for changes unless they get an update notice.  A pulse mechanism 
  12677.  guards against lost update notices by retransmitting the last message at a 
  12678.  regular interval when no new messages are generated. Sequence numbers in each 
  12679.  message allow importers to identify lost notices or repeats of notices they 
  12680.  have already seen. 
  12681.  
  12682.  Change notices tell an importer which directory to check for changes. The 
  12683.  importer must determine what has changed. To avoid overloading the exporter 
  12684.  with update efforts following a change notice, the importer accesses the 
  12685.  changed directory at random intervals. 
  12686.  
  12687.  For more information on the Replicator and DCDB Replicator service parameters, 
  12688.  refer to Performance Tuning. 
  12689.  
  12690.  For more information, see the following topics: 
  12691.  
  12692.      Setting Up The Exporter 
  12693.  
  12694.      Setting Up the Importer 
  12695.  
  12696.      Using the Replicator Service 
  12697.  
  12698.      Example Configuration 
  12699.  
  12700.  
  12701. ΓòÉΓòÉΓòÉ 17.1. Setting Up The Exporter ΓòÉΓòÉΓòÉ
  12702.  
  12703. Only servers can export files.  The following steps show how to set up a server 
  12704. to replicate files for the first time. 
  12705.  
  12706. To set up a server as an exporter: 
  12707.  
  12708.    1. Use a text editor to create an ASCII-format REPL.INI file in each 
  12709.       first-level directory of the export path. REPL.INI lets you control how 
  12710.       files and subdirectories in that first-level directory are replicated. 
  12711.       The REPL.INI file is read by the Replicator service when one of the 
  12712.       following occurs: 
  12713.  
  12714.           The Replicator service is started using NET START REPLICATOR from 
  12715.            the OS/2 command prompt. 
  12716.  
  12717.           The Replicator service is started from the command line or LAN 
  12718.            Server Administration. 
  12719.  
  12720.           The Replicator service is automatically started when the server 
  12721.            starts. 
  12722.  
  12723.           A new first-level directory is created. 
  12724.  
  12725.       The REPL.INI file contains only two parameters: extent and  integrity. 
  12726.       Each parameter has two possible values:  TREE and  FILE. 
  12727.  
  12728.       Create a REPL.INI file containing an  extent and integrity statement in 
  12729.       each first-level directory you want to replicate in the exporting tree. 
  12730.       To prevent a first-level directory from being replicated, do not create a 
  12731.       REPL.INI file in the directory. Use one of the four possible REPL.INI 
  12732.       files illustrated below. 
  12733.  
  12734.         a. To replicate files and subdirectories sending updates file-by-file 
  12735.            as changes occur when the file has been stable for a specified 
  12736.            period, create the following REPL.INI file: 
  12737.  
  12738.                       extent = tree  integrity
  12739.                       = file
  12740.  
  12741.         b. To replicate files and subdirectories sending updates when the tree 
  12742.            has been stable for a specified period, create the following 
  12743.            REPL.INI file: 
  12744.  
  12745.                       extent = tree  integrity = tree
  12746.  
  12747.         c. To replicate only files sending updates file-by-file as changes 
  12748.            occur when the file has been stable for a specified period create 
  12749.            the following REPL.INI file: 
  12750.  
  12751.                       extent = files  integrity = file
  12752.  
  12753.         d. To replicate only files sending updates when the tree has been 
  12754.            stable for a specified period, create the following REPL.INI file: 
  12755.  
  12756.                       extent = files  integrity = tree
  12757.  
  12758.       The following list describes each REPL.INI parameter: 
  12759.  
  12760.       extent                   Specifies whether all subdirectories of this 
  12761.                                first-level directory should be replicated. 
  12762.  
  12763.                                If the value is TREE, all files and 
  12764.                                subdirectories in the first-level directory are 
  12765.                                replicated. If the value is FILE, all files in 
  12766.                                the first-level directory are replicated but not 
  12767.                                any of its subdirectories. 
  12768.  
  12769.                                Default value:  TREE 
  12770.  
  12771.       integrity                Specifies the type of updates sent from the 
  12772.                                exporter to the importers. 
  12773.  
  12774.                                If the value is TREE, all files and 
  12775.                                subdirectories in the first-level directory must 
  12776.                                be stable for a predetermined interval before 
  12777.                                any can be replicated.  This interval is 
  12778.                                specified by the guardtime parameter in the 
  12779.                                Replicator section of the IBMLAN.INI file. If 
  12780.                                the value is TREE, it is not possible to 
  12781.                                replicate to the current directory of an active 
  12782.                                process on the importer. 
  12783.  
  12784.                                If the value is FILE, updates are replicated 
  12785.                                file by file. If the  integrity parameter value 
  12786.                                is FILE, the guardtime parameter has no effect. 
  12787.  
  12788.                                Default value:  FILE 
  12789.  
  12790.    2. Create a user ID and password for the importer if it is a server or if it 
  12791.       is in another domain.  Use an ID that is different than the machine name. 
  12792.       The importer requires a user ID for the following reasons: 
  12793.  
  12794.           When a client is an importer, it logs on to replicate using its 
  12795.            machine name defined as a system ID to the domain controller when 
  12796.            the client was installed. 
  12797.  
  12798.           When a server is an importer, it cannot log on to replicate using 
  12799.            its machine name because it periodically changes its system 
  12800.            password. 
  12801.  
  12802.           When an importer is in another domain, the machine name is not 
  12803.            defined as a system ID in the exporting domain. 
  12804.  
  12805.    3. Edit replicator parameters in IBMLAN.INI. Refer to "Parameters 
  12806.       Descriptions - Replicator Section" in Performance Tuning for more 
  12807.       information. 
  12808.  
  12809.       Use the values in one of the following conditions to set up replication 
  12810.       at the exporter: 
  12811.  
  12812.         a. If exporting to an importer in the same domain, set values for 
  12813.            parameters as follows: 
  12814.  
  12815.                replicate=export 
  12816.  
  12817.                exportpath=absolute path to the exporting trees 
  12818.  
  12819.                exportlist=importer receiving updates 
  12820.  
  12821.                add REPLICATOR to srvservices section. 
  12822.  
  12823.         b. If exporting to more than one importer in the same domain, set 
  12824.            values for parameters as follows: 
  12825.  
  12826.                replicate=export 
  12827.  
  12828.                exportpath=absolute path to the exporting trees 
  12829.  
  12830.                exportlist=importer1;importer2 receiving updates 
  12831.  
  12832.                add REPLICATOR to srvservices section. 
  12833.  
  12834.         c. If exporting to an importer in another domain, set the values for 
  12835.            parameters as follows: 
  12836.  
  12837.                replicate=export 
  12838.  
  12839.                exportpath=absolute path to the exporting trees 
  12840.  
  12841.                exportlist=importer1;domain receiving updates 
  12842.  
  12843.                add REPLICATOR to srvservices section. 
  12844.  
  12845.         d. If exporting to more than one importer in another domain, set values 
  12846.            for the parameters as follows: 
  12847.  
  12848.                replicate=export 
  12849.  
  12850.                exportpath=absolute path to the exporting trees 
  12851.  
  12852.                exportlist=importer1;importer2;domain receiving updates 
  12853.  
  12854.                add REPLICATOR to srvservices section. 
  12855.  
  12856.         e. If exporting and importing on the same computer, set values for 
  12857.            parameters as follows: 
  12858.  
  12859.                replicate=both 
  12860.  
  12861.                exportpath=absolute path to the exporting trees 
  12862.  
  12863.                importpath=absolute path to the importing tree 
  12864.  
  12865.                logon=importer's logon ID 
  12866.  
  12867.                password=importer's logon PW 
  12868.  
  12869.                add REPLICATOR to srvservices section. 
  12870.  
  12871.            Use any or all of the following conditions to tune the performance 
  12872.            of the exporter. 
  12873.  
  12874.         f. To change how long the tree must be stable before replication occurs 
  12875.            when the  integrity is set to tree in REPL.INI, set values for 
  12876.            parameters as follows: 
  12877.  
  12878.                guardtime=0-interval/2 
  12879.  
  12880.         g. To change how often, in minutes, subdirectories and files in the 
  12881.            export path are checked for changes, set values for parameters as 
  12882.            follows: 
  12883.  
  12884.                interval=1-60 
  12885.  
  12886.         h. To change how often the exporter sends extra updates, besides those 
  12887.            sent when a change occurs in the export path, set values for 
  12888.            parameters as follows: 
  12889.  
  12890.                pulse=1-10 (This is multiplied times the interval to determine 
  12891.                 how often redundant updates are sent.) 
  12892.  
  12893.         i. To change how often connections are distributed to importers, set 
  12894.            values for parameters as follows: 
  12895.  
  12896.                random=1-120 (seconds) 
  12897.  
  12898.    4. Give the importer access to the export path.  To receive updates, an 
  12899.       importer must be given both read (R) and attributes (A) access 
  12900.       permissions to the files in the export directories. 
  12901.  
  12902.         a. Create an access profile for the export path.  See Creating Access 
  12903.            Control Profiles for Resources without Aliases. 
  12904.  
  12905.         b. Assign read an attributes permissions to user or group IDs who are 
  12906.            to receive replicated files. 
  12907.  
  12908.         c. Apply the access profile to the directories in the export path. For 
  12909.            information on the Apply function, see  Propagating Access Control 
  12910.            Profiles to Subdirectories. 
  12911.  
  12912.    5. Start the Replicator service from the OS/2 command line by typing: 
  12913.  
  12914.             NET START REPLICATOR
  12915.  
  12916.  
  12917. ΓòÉΓòÉΓòÉ 17.2. Setting Up the Importer ΓòÉΓòÉΓòÉ
  12918.  
  12919. Servers or clients can import files.  Following are the steps for setting up a 
  12920. computer to import files for the first time. 
  12921.  
  12922. To set up a server as an importer: 
  12923.  
  12924.    1. Create the import directory tree structure by creating a directory for 
  12925.       all first-level directories being imported.  There can be only one import 
  12926.       path regardless of the number of exporters and exporting trees.  So, to 
  12927.       receive updates from the exporters, all first-level subdirectories must 
  12928.       be in the import path.  It is not necessary to create subdirectories 
  12929.       below the first level. They are created by the Replicator service at the 
  12930.       time of replication. 
  12931.  
  12932.    2. Create a user ID and password if the importer is in another domain.  Use 
  12933.       an ID that is different than the machine name if the importer is a 
  12934.       server. The ID will need to be defined to both the exporting and the 
  12935.       importing domain controllers. 
  12936.  
  12937.    3. Edit replicator parameters in IBMLAN.INI.  Refer to Performance Tuning 
  12938.       for more information. 
  12939.  
  12940.       Use values in one of the following conditions to set up replication at 
  12941.       the importer. 
  12942.  
  12943.         a. If importing from an exporter in the same domain, set values for 
  12944.            parameters as follows: 
  12945.  
  12946.                replicate=import 
  12947.  
  12948.                importpath=absolute path to the importing tree 
  12949.  
  12950.                importlist=exporter sending updates 
  12951.  
  12952.                tryuser=yes 
  12953.  
  12954.                add REPLICATOR to wrkservices section. 
  12955.  
  12956.         b. If importing from more than one exporter in the same domain, set 
  12957.            values for parameters as follows: 
  12958.  
  12959.                replicate=import 
  12960.  
  12961.                importpath=absolute path to the importing tree 
  12962.  
  12963.                importlist=exporter1;exporter2 sending updates 
  12964.  
  12965.                tryuser=yes 
  12966.  
  12967.                add REPLICATOR to wrkservices section. 
  12968.  
  12969.         c. If importing from an exporter in another domain, set values for 
  12970.            parameters as follows: 
  12971.  
  12972.                replicate=import 
  12973.  
  12974.                importpath=absolute path to the importing tree 
  12975.  
  12976.                importlist=exporter1;domain sending updates 
  12977.  
  12978.                tryuser=yes 
  12979.  
  12980.                add REPLICATOR to wrkservices section. 
  12981.  
  12982.         d. If importing from more than one exporter in another domain, set 
  12983.            values for parameters as follows: 
  12984.  
  12985.                replicate=import 
  12986.  
  12987.                importpath=absolute path to the importing tree 
  12988.  
  12989.                importlist=exporter1;exporter2;domain sending updates 
  12990.  
  12991.                tryuser=yes 
  12992.  
  12993.                add REPLICATOR to wrkservices section. 
  12994.  
  12995.            Add one or both of the following alternatives to one of the 
  12996.            preceding conditions. 
  12997.  
  12998.         e. If the importer is a server, add the following replicator parameters 
  12999.            to one of the other importer conditions above: 
  13000.  
  13001.                logon=importer's logon ID 
  13002.  
  13003.                password=importer's logon PW 
  13004.  
  13005.         f. To prevent replication while a user is logged on, set tryuser to no. 
  13006.            Replication does not occur as long as a user is logged on. 
  13007.  
  13008.    4. Start the Replicator service by typing at the OS/2 command line: 
  13009.  
  13010.             NET START REPLICATOR
  13011.  
  13012.  
  13013. ΓòÉΓòÉΓòÉ 17.3. Using the Replicator Service ΓòÉΓòÉΓòÉ
  13014.  
  13015. Use the following procedure to complete the replication of files. 
  13016.  
  13017. To replicate files: 
  13018.  
  13019.    1. Users on importers should not change files in the import path. Such 
  13020.       changes are lost as soon as the Replicator service sends updates to the 
  13021.       importer. 
  13022.  
  13023.    2. Force the immediate replication of files by issuing commands at both the 
  13024.       exporter and importer to stop and start the Replicator service. 
  13025.  
  13026.         a. Stop the Replicator service if it is running by typing NET STOP 
  13027.            REPLICATOR at an OS/2 command line. 
  13028.  
  13029.         b. Start the Replicator service by typing NET START REPLICATOR at an 
  13030.            OS/2 command line. 
  13031.  
  13032.    3. Prevent replication of files and subdirectories in a first-level 
  13033.       directory by creating a USERLOCK. xxx file. The USERLOCK. xxx file can be 
  13034.       empty.  The file extension xxx can be any extension.  The file name 
  13035.       USERLOCK. xxx acts as a signal to the Replicator service. While USERLOCK. 
  13036.       xxx exists, replication in that directory is prevented.  When USERLOCK. 
  13037.       xxx is deleted, replication restarts. 
  13038.  
  13039.       USERLOCK. xxx supplements the guardtime parameter by letting you decide 
  13040.       when files are ready for replication.  Refer to "Parameter Descriptions - 
  13041.       Replicator Section" in Performance Tuning. 
  13042.  
  13043.       Note:  USERLOCK. xxx works only in a first-level subdirectory beyond the 
  13044.              export path, and only if integrity=TREE. 
  13045.  
  13046.    4. Verify that replication is occurring by checking for the existence of a 
  13047.       signal file in the import path.  The Replicator service puts a  signal 
  13048.       file in each first-level subdirectory of an import directory.  Signal 
  13049.       files indicate the status of the directory and are named differently 
  13050.       according to their meanings. 
  13051.  
  13052.            Signal File         Meaning
  13053.  
  13054.       OK.RP$                   The directory is receiving updates from the 
  13055.                                exporter. 
  13056.  
  13057.       NO_MASTR.RP$             The directory is not currently receiving updates 
  13058.                                from an exporter for one of the following 
  13059.                                reasons: 
  13060.  
  13061.                                    The server exporting this directory is not 
  13062.                                     operating. 
  13063.  
  13064.                                    Something is wrong with the replication 
  13065.                                     setup. 
  13066.  
  13067.                                    The exporter has stopped exporting this 
  13068.                                     directory. (The directory may no longer be 
  13069.                                     in the export path, or the REPL.INI file 
  13070.                                     has been removed from the directory.) 
  13071.  
  13072.       NO_SYNC.RP$              The directory is receiving updates, but they may 
  13073.                                not be current. Use the NET ERROR command to 
  13074.                                view the error log for more information.  The 
  13075.                                cause can be one of the following: 
  13076.  
  13077.                                    A communication failure 
  13078.  
  13079.                                    A system failure on the exporter 
  13080.  
  13081.                                    Incorrect access permission to the export 
  13082.                                     path 
  13083.  
  13084.                                    Open files on the importer or exporter 
  13085.  
  13086.    5. Determine the last time replication occurred by checking the time stamp 
  13087.       on the OK.RP$ file in the import path. 
  13088.  
  13089.    6. Clean up a replicated tree at the importers by deleting the first-level 
  13090.       directory from the import path.  Removing this directory deletes the data 
  13091.       at the importer and prevents future replication. 
  13092.  
  13093.    7. Stop all replication by stopping the Replicator service at one or both 
  13094.       computers and removing Replicator service from the IBMLAN.INI files.  If 
  13095.       you leave Replicator in the IBMLAN.INI files, the service starts 
  13096.       automatically the next time you start the client and Server services at 
  13097.       the exporter and importer. 
  13098.  
  13099.  
  13100. ΓòÉΓòÉΓòÉ 17.4. Example Configuration ΓòÉΓòÉΓòÉ
  13101.  
  13102. The following presents an example configuration for using the Replicator 
  13103. service. Workstation IMP1 is set up as an importer to maintain replicated files 
  13104. for the server workstations EXP1 and EXP2. The importers and exporters are in 
  13105. the same domain. 
  13106.  
  13107. The server workstation EXP1 is configured with the following IBMLAN.INI 
  13108. parameter entries in the Replicator section: 
  13109.  
  13110. replicate = export
  13111. exportlist = IMP1
  13112. exportpath = C:\EXPORT
  13113.  
  13114. The Replicator service is added to the srvservices section in the IBMLAN.INI 
  13115. file. The export directory structure of EXP1 is shown in the following figure. 
  13116.  
  13117.  
  13118. Exporter EXP1 Directory Structure
  13119.  
  13120. The server workstation EXP2 is configured with the following IBMLAN.INI 
  13121. parameter entries: 
  13122.  
  13123. replicate = export
  13124. exportlist = IMP1
  13125. exportpath = D:\REPL
  13126.  
  13127. The Replicator service is added to the srvservices section in the IBMLAN.INI 
  13128. file. The export directory structure of EXP2 is shown in the following figure. 
  13129.  
  13130.  
  13131. Exporter EXP2 Directory Structure
  13132.  
  13133. The workstation IMP1 is set up as the importer with the following IBMLAN.INI 
  13134. parameter entries in the Replicator section: 
  13135.  
  13136. replicate = import
  13137. importlist = EXP1;EXP2
  13138. importpath = C:\BACKUP
  13139. tryuser = yes
  13140.  
  13141. The directory structure of IMP1 is shown in the following figure. 
  13142.  
  13143.  
  13144. Importer IMP1 Directory Structure
  13145.  
  13146. First-level directories must be created manually on IMP1 to indicate which of 
  13147. the exporter directories are to be replicated. The remaining directory 
  13148. structure and its contents (subdirectories and files) are created by the 
  13149. Replicator service. 
  13150.  
  13151. The REPL.INI file in D:\REPL\RIPL of EXP2 allows only the files of the IMAGES 
  13152. subdirectory to be replicated.  Its subdirectories are not replicated. Nothing 
  13153. in the \APPS subdirectory is replicated because of the USERLOCK. xxx file in 
  13154. the export directory. All subdirectories and files are replicated in the INFO 
  13155. directory. 
  13156.  
  13157. Setting the  tryuser parameter to YES in the IBMLAN.INI file in IMP1 allows 
  13158. replication to occur when a user with the proper access permissions is logged 
  13159. on. IMP1 is also defined as a user ID with access to the export paths of EXP1 
  13160. and EXP2 so that replication can occur even when no user is logged on. The use 
  13161. of the importer's user ID is possible only if IMP1 is a client. When the server 
  13162. changes its password, the replication does not work using the machine name 
  13163. unless the password is kept current at the exporters. 
  13164.  
  13165.  
  13166. ΓòÉΓòÉΓòÉ 18. Installing and Configuring Remote IPL ΓòÉΓòÉΓòÉ
  13167.  
  13168. Remote initial program load (remote IPL) is the process of downloading IPL 
  13169. files from a server to a workstation in order to start the workstation. 
  13170.  
  13171. Use remote IPL to start medialess workstations (workstations without disk 
  13172. drives) and workstations that do not have OS/2 LAN Requester or DOS LAN 
  13173. Services installed. 
  13174.  
  13175. The following clients are supported by the Remote IPL service: 
  13176.  
  13177.      OS/2 Warp 3.0 
  13178.  
  13179.      OS/2 Warp 4.0 
  13180.  
  13181.      WorkSpace On-Demand 1.0 
  13182.  
  13183.      WorkSpace On-Demand 2.0 
  13184.  
  13185.      DOS 
  13186.  
  13187.  Note:  In order to use LAN Server Administration, OS/2 Warp 3.0 clients need 
  13188.         OS/2 Warp 3.0 FixPak 32 or later, and OS/2 Warp 4.0 clients need OS/2 
  13189.         Warp 4.0 FixPak 6 or later. 
  13190.  
  13191.  Workstations loaded by remote IPL are called  remote IPL workstations (also 
  13192.  referred to as remote IPL clients). Remote IPL workstations can be started 
  13193.  from IPL files on a server. When the workstation is started, the designated 
  13194.  server sends IPL files to the workstation. 
  13195.  
  13196.  OS/2 Warp Server supports 802.2 RIPL using NetBIOS as the network protocol, 
  13197.  and Dynamic Host Communication Protocol (DHCP) boot using TCP/IP as the 
  13198.  network protocol. DHCP boot requires the Preboot Execution Environment (PXE) 
  13199.  extensions as defined in the Intel Wired for Management specification. PXE is 
  13200.  usually provided on ROM/PROM/EPROM on the network adapter, or on the system 
  13201.  board. A client that does not have PXE support must use 802.2 RIPL. 
  13202.  
  13203.  These two boot methods and network protocols can be used in combination to 
  13204.  provide the following types of boot clients: 
  13205.  
  13206.      802.2 RIPL/NetBEUI 
  13207.  
  13208.      802.2 RIPL/TCPBEUI 
  13209.  
  13210.      DHCP PXE RIPL/TCPBEUI 
  13211.  
  13212.      DHCP PXE RIPL/NetBEUI 
  13213.  
  13214.  You must configure TCPBEUI on the server in order to run DHCP PXE RIPL/TCPBEUI 
  13215.  or 802.2 RIPL/TCPBEUI on a client. You can use LANINST to configure TCPBEUI on 
  13216.  the server. For more information about this, see Quick Beginnings. 
  13217.  
  13218.  For more information, see the following topics: 
  13219.  
  13220.      DHCP Boot 
  13221.  
  13222.      Remote IPL Control Files 
  13223.  
  13224.      Installing Remote IPL Using the OS/2 RIPLINST Utility 
  13225.  
  13226.  
  13227. ΓòÉΓòÉΓòÉ 18.1. DHCP Boot ΓòÉΓòÉΓòÉ
  13228.  
  13229. DHCP PXE RIPL uses IP, which is a routeable protocol. This protocol allows the 
  13230. client to be on a different subnet than the boot server's subnet. DHCP servers 
  13231. can provide two functions: dynamic IP address assignments and centralized 
  13232. network boot services. In DHCP with PXE, the IP address server can be on a 
  13233. system separate from the boot file server. You can choose to have more boot 
  13234. servers with fewer DHCP servers to assign IP addresses, which increases the 
  13235. scalability of the DHCP server. 
  13236.  
  13237. The Boot Information Negotiation Layer (BINL) server is configured to identify 
  13238. the IP address of the code server and the path and name of the DHCP boot 
  13239. method's bootstrap loader. A PXE Proxy server services a BINL server when a 
  13240. BINL server service is not running on the same system as the DHCP server. The 
  13241. PXE proxy informs the PXE client of the IP address where the BINL server is 
  13242. located. If the BINL service co-exists with DHCP service on the same system, 
  13243. then the DHCP proxy service is not needed. The DHCP, PXE Proxy, and BINL 
  13244. servers can physically be on separate machines. The Trivial File Transfer 
  13245. Protocol (TFTPD) server  must be on the code server. 
  13246.  
  13247. Note:  All servers, except for the PXE Proxy, must be operational for the boot 
  13248.        process to complete successfully. 
  13249.  
  13250.  The PXE protocol locates the DHCP server and finds the appropriate boot server 
  13251.  to load the DHCP boot method's bootstrap loader.  The bootstrap loader locates 
  13252.  the <client>.INF file on the code server.  Bootstrap loader uses the client's 
  13253.  LAN adapter address to determine the name of the <client>.inf file and its 
  13254.  location on the server.  Bootstrap downloads the <client>.inf file, and then 
  13255.  downloads all the files listed in <client>.inf file.  The first entry in the 
  13256.  <client>.inf file is the client's RIPL workstation record from the RPL.MAP 
  13257.  file.  One of the files listed in <client>.inf file is the bpcommon file. The 
  13258.  bpcommon file includes a list of files that the client needs for the first 
  13259.  phase of boot. Bootstrap downloads these files to the client's high RAM. 
  13260.  Bootstrap creates an entry in a lookup table for each file it downloads. The 
  13261.  entry includes information about each file, such as file size and the address 
  13262.  where the file is located in high RAM. Bootstrap then passes control to 
  13263.  OS2LDR, which uses a VDISK to manage the files in high RAM. This brings up the 
  13264.  operating system, network, and redirected file system. The redirected file 
  13265.  system replaces the VDISK and the initialization process continues using the 
  13266.  redirected file system using System Message Block (SMB) protocol. 
  13267.  
  13268.  A progress indicator is displayed throughout the boot process. During the 
  13269.  first phase of the bootup process, no operating system or font services are 
  13270.  available, so error messages are displayed through BIOS functions. Because 
  13271.  only the characters supported by machine ROM BIOS (code page 437) can be 
  13272.  displayed, the error messages appear in English. See DHCP RIPL Bootstrap 
  13273.  Messages for a list of these error messages and help. When the DHCP boot 
  13274.  bootstrap is loaded and executed successfully, a copyright statement is 
  13275.  displayed. 
  13276.  
  13277.  
  13278. ΓòÉΓòÉΓòÉ 18.1.1. DHCP/BINL Server Configurations for DHCP Boot ΓòÉΓòÉΓòÉ
  13279.  
  13280. To remote boot the DHCP PXE clients from a server, you must have DHCP/BINL 
  13281. server services running and available on the network. In Intel's Wired for 
  13282. Management and NetPC, DHCP server services are extended to include DHCP PROXY 
  13283. and BINL services. You can configure these three services in the following 
  13284. combinations: 
  13285.  
  13286.      DHCP, BINL, code server with TFTP all on the same system. In this 
  13287.       configuration, DHCP PROXY is not needed. 
  13288.  
  13289.      DHCP and BINL on one system, code server with Trivial File Transfer 
  13290.       Protocol (TFTP) on a separate machine. In this configuration, DHCP PROXY 
  13291.       is not needed. 
  13292.  
  13293.      DHCP, BINL, and code server all on separate systems. In this 
  13294.       configuration, DHCP PROXY must be installed either on a separate machine 
  13295.       or on the BINL server or on the code server. 
  13296.  
  13297.  To support WorkSpace On-Demand DHCP PXE RIPL clients, you must configure a 
  13298.  DHCP server that supports the PXE extensions, a BINL server, and a TFTP 
  13299.  server.  The DHCP server installed by WorkSpace On-Demand 2.0 contains the PXE 
  13300.  extensions.  This section provides examples of the parameters that must be 
  13301.  configured for the DHCP and BINL servers. After the DHCP server is configured, 
  13302.  the DHCP configuration data is saved in the file named DHCPSD.CFG and stored 
  13303.  in the directory identified by the ETC environmental variable.  The ETC 
  13304.  default directory name is MPTN\ETC. 
  13305.  
  13306.  When the BINL server is not located on the same machine as the DHCP server, 
  13307.  additional parameters must be configured to support PXE clients. The following 
  13308.  example of the DHCPSD.CFG contains the parameters of DHCP server type.  Note 
  13309.  that the vendor type of PXE client has been disabled by being commented.  The 
  13310.  PXE client vendor option must not be defined for a non-PXE DHCP server. 
  13311.  
  13312.  
  13313.   # Server mode setup
  13314.   servertype   dhcp
  13315.  
  13316.   # Setup to send options to the pxeclient.  Sent in the encapsulated option 43.
  13317.   # vendor PXEClient
  13318.     {
  13319.       option 1 1.1.4.5
  13320.       option 2 2
  13321.       option 3 3
  13322.       option 4 4
  13323.       option 5 5
  13324.     }
  13325.  
  13326.  
  13327.  For the DHCP server to support PXE clients, you must configure the DHCP server 
  13328.  type, and the vendor type for the PXE client.  These parameters are in 
  13329.  addition to the basic DHCP server parameters such as domain name, subnet mask, 
  13330.  default router address, and a range of addresses to be assigned to the 
  13331.  clients. 
  13332.  
  13333.  The following is an example of the DHCPSD.CFG file for the additional 
  13334.  parameters that must be configured to support PXE clients when the BINL server 
  13335.  is located on the same machine as the DHCP server.  The parameters shown is 
  13336.  this example are DHCP server type and PXE client vendor type. 
  13337.  
  13338.  
  13339.   # Server mode setup
  13340.   servertype pxedhcp
  13341.   # Setup to send options to the pxeclient.  Sent in the encapsulated option 43.
  13342.    vendor PXEClient
  13343.     {
  13344.       option 1 1.1.4.5
  13345.       option 2 2
  13346.       option 3 3
  13347.       option 4 4
  13348.       option 5 5
  13349.     }
  13350.  
  13351.  
  13352.  The following is a PROXY DHCP server example of the DHCPSD.CFG file for the 
  13353.  additional parameters that must be configured to support PXE clients when the 
  13354.  BINL server is not located on the same machine as the DHCP server.  The 
  13355.  parameters shown is this example are DHCP server type, location of the BINL 
  13356.  server, and the PXE client vendor type. 
  13357.  
  13358.  
  13359.   # Server mode setup
  13360.   imageserver 9.3.162.196
  13361.   servertype pxeproxy
  13362.  
  13363.   # Setup to send options to the pxeclient.  Sent in the encapsulated option 43.
  13364.    vendor PXEClient
  13365.     {
  13366.       option 1 1.1.4.5
  13367.       option 2 2
  13368.       option 3 3
  13369.       option 4 4
  13370.       option 5 5
  13371.     }
  13372.  
  13373.  
  13374.  To configure the BINL server, you must define the DHCP boot file name (bpname) 
  13375.  and the TFTP server address to the BINL server.  After the BINL server is 
  13376.  configured, the BINL configuration data is saved in the file named BINLSD.CFG 
  13377.  and stored in the directory identified by the ETC environmental variable.  The 
  13378.  ETC default directory name is MPTN\ETC. 
  13379.  
  13380.  The following is an example of the bpname and TFTP server address that is 
  13381.  saved in the BINLSD.CFG file after the BINL server configuration is complete. 
  13382.  The bpname must always be \DOS\DHCPBOOT\RPLBOOTP.SYS.  In this example, the 
  13383.  TFTP server address is 9.3.162.194. 
  13384.  
  13385.  
  13386.   # Global Options
  13387.   # default TFTP server
  13388.   tftp   9.3.162.194
  13389.   # Fully qualified boot Image pathname
  13390.   bpname \DOS\DHCPBOOT\RPLBOOTP.SYS
  13391.  
  13392.   # SA 0, NIT 1 specific options
  13393.   sa 0 nit 1
  13394.   {
  13395.     tftp 9.3.162.194
  13396.     bpname \DOS\DHCPBOOT\RPLBOOTP.SYS
  13397.   }
  13398.  
  13399.  
  13400.  The TFTP server does not require any configuration.  The TFTP server must be 
  13401.  started on the machine that contains the server directory with the location of 
  13402.  the \IBMLAN\RPL directory as the base TFTP directory.  The following examples 
  13403.  show how to start the TFTP server with this directory as the default base 
  13404.  directory: 
  13405.  
  13406.  
  13407.   Start TFTP Server Example 1:
  13408.   C:
  13409.   CD \IBMLAN\RPL
  13410.   TFTPD
  13411.  
  13412.  
  13413.   Start TFTP Server Example 2:
  13414.   TFTPD C:\IBMLAN\RPL
  13415.  
  13416.  
  13417.  To support frequent remote booting of clients, the default TCP/IP keepalive 
  13418.  timer value should be set to 20 seconds. 
  13419.  
  13420.  You can add the configuration files to your startup command file to start DHCP 
  13421.  Boot server services. A sample STARTBB2.CMD is below: 
  13422.  
  13423.  
  13424.   c:
  13425.   dhcpsd
  13426.   binlsd
  13427.   cd ibmlan\rpl
  13428.   tftpd
  13429.   inetcfg -s keepalive 20
  13430.  
  13431.  
  13432. ΓòÉΓòÉΓòÉ 18.2. Remote IPL Control Files ΓòÉΓòÉΓòÉ
  13433.  
  13434. The remote IPL  process is controlled by the following files: 
  13435.  
  13436.      DHCP boot files: 
  13437.  
  13438.         -  <client>.INF 
  13439.  
  13440.         -  bpcommon.ISA, or bpcommon.MCA 
  13441.  
  13442.         -  rfcnames.lst 
  13443.  
  13444.         -  rfcbcst.lst 
  13445.  
  13446.      .CNF boot block definition file (only 802.2 RIPL) 
  13447.  
  13448.      RPL.MAP 
  13449.  
  13450.      File Index Table (FIT) 
  13451.  
  13452.      NDISDD.PRO 
  13453.  
  13454.  Each server contains only one RPL.MAP, NDISDD.PRO file, and bpcommon file. The 
  13455.  bpcommon.ISA file is used to remote IPL DHCP Boot clients on non-Micro Channel 
  13456.  machines. The two Micro Channel machine classes use bpcommon.MCA. There are 
  13457.  multiple .CNF and FIT files on the server. 
  13458.  
  13459.  The remote IPL  service provides default RPL.MAP records, FIT files, 
  13460.  CONFIG.SYS, bpcommon, NDISDD.PRO, and DOS image definition files to use when 
  13461.  setting up remote IPL  requesters.  The default files are always used when 
  13462.  defining a remote IPL  client.  If these files do not meet your requirements, 
  13463.  you can customize your remote IPL  requesters by altering the default files 
  13464.  provided. 
  13465.  
  13466.  For more information, see the following topics: 
  13467.  
  13468.      DHCP Boot Files 
  13469.  
  13470.      Boot Block Definition (.CNF) File 
  13471.  
  13472.      RPL.MAP Control File 
  13473.  
  13474.      File Index Table (FIT) 
  13475.  
  13476.      NDISDD.PRO Control File 
  13477.  
  13478.  
  13479. ΓòÉΓòÉΓòÉ 18.2.1. DHCP Boot Files ΓòÉΓòÉΓòÉ
  13480.  
  13481. The DHCP boot files that you might need to update are: 
  13482.  
  13483.      <client>.INF, where client is the last 8 digits of the LAN address. 
  13484.  
  13485.      bpcommon.ISA, bpcommon.MCA 
  13486.  
  13487.      rfcnames.lst 
  13488.  
  13489.      rfcbcst.lst 
  13490.  
  13491.  When you create a DHCP boot client, the path and file name for that client is 
  13492.  created in a mac address subdirectory of /MACHINES, using the first 4 digits 
  13493.  of the LAN address: 
  13494.  
  13495.  
  13496.    /MACHINES/MACADDR/client_address
  13497.        where client_address is the first 4 digits of the LAN address
  13498.  
  13499.  
  13500.  A client-specific information file is created, using the remaining 8 digits of 
  13501.  the LAN address. Below is an example of a US version of a <client>.INF file in 
  13502.  the MACADDR subdirectory: 
  13503.  
  13504.   0004acec2e6e BJ100 ~ Fits\BJ100 BB2SVR Z ~ ~ ~ ,,, ~ R_BB2_cc_DHCPBOOT
  13505.   \bb20.us\rplbootp.msg
  13506.   \bb20.us\bpcommon.isa
  13507.   \fits\BJ100.FIT
  13508.   \machines\bj100\ibmcom\macs\ibmtrp.os2
  13509.   \machines\bj100\ibmcom\a1.msg
  13510.   \machines\bj100\ibmcom\a1h.msg
  13511.   \machines\bj100\config.sys
  13512.   \machines\bj100\ibmlan\ibmlan.ini
  13513.   \machines\bj100\ibmcom\protocol.ini
  13514.   \machines\bj100\mptn\bin\setup.cmd
  13515.   \machines\bj100\mptn\etc\dhcpcd.chf
  13516.   \machines\bj100\mptn\etc\services
  13517.  
  13518.  The first line in the .INF file is client-specific configuration information, 
  13519.  including the LAN address. This line is the same as the workstation record 
  13520.  entry for this client in the RPL.MAP file. In the example, the LAN address is 
  13521.  0004acec2e6e. The directory structure and filename for this client would be 
  13522.  /MACHINES/MACADDR/0004/acec2e6e.INF. 
  13523.  
  13524.  The <client>.INF file contains the path and file name for the common 
  13525.  descriptor file bpcommon. When you add a base device, you must add a line to 
  13526.  the bpcommon file identifying the path to that device. You will also need to 
  13527.  update the client's CONFIG.SYS file for the additional base device. 
  13528.  
  13529.  Two bpcommon files are located in the BB20.cc\IBMLAN\NETPROG subdirectory. The 
  13530.  two Micro Channel  machine classes use bpcommon.MCA for vga machine classes 
  13531.  and bpcommon.MCX for xvga machine classes. All non-Micro Channel machine 
  13532.  classes use bpcommon.ISA. 
  13533.  
  13534.  Below is a sample of entries as they would appear in a bpcommon file: 
  13535.  
  13536.   \bb20.cc\os2\keyboard.dcp
  13537.   \bb20.cc\os2\system\country.sys
  13538.   \bb20.cc\os2\boot\screen01.sys
  13539.   \bb20.cc\os2\boot\kbdbase.sys
  13540.   \bb20.cc\ibmcomprotocol\netbeui.os2
  13541.   \bb20.cc\ibmlan\netprog\netwksta.200
  13542.  
  13543.  The bpcommon and <client>.INF files have list files that are needed for the 
  13544.  first phase of the client's boot process. Rfcnames.lst and rfcbcst.lst are 
  13545.  TCPBEUI config files. 
  13546.  
  13547.  When you create a DHCP Boot requester using the LAN Server Administration GUI, 
  13548.  the server's NetBIOS name and its IP address are added to the rfcnames.lst and 
  13549.  rfcbcst.lst files. In the PROTOCOL.INI configuration file, the keyword 
  13550.  NAMESFILE value is set to a non-zero number. For broadcast node types, if you 
  13551.  want the requester to be able to access other servers, you must update the 
  13552.  rfcnames.lst and rfcbcst.lst files. 
  13553.  
  13554.  
  13555. ΓòÉΓòÉΓòÉ 18.2.2. Boot Block Definition (.CNF) File ΓòÉΓòÉΓòÉ
  13556.  
  13557. Boot block definition files define an operating system and the way it is loaded 
  13558. into a remote IPL  workstation.  Every server record in the RPL.MAP file must 
  13559. contain a reference to a boot block .CNF file. One server record in the RPL.MAP 
  13560. file supports the DHCP boot method for the server, pointing to a dummy .CNF 
  13561. file. DHCP boot does not access this file. 
  13562.  
  13563. A default .CNF file is provided for all supported network adapters. You do not 
  13564. need to change boot block .CNF files unless it is necessary to have the 802.2 
  13565. RIPL requester operate with different network drivers. 
  13566.  
  13567. The following example shows the default WorkSpace On-Demand .CNF file for the 
  13568. IBM Token-Ring that is provided with the 802.2 RIPL  service of LAN Server. 
  13569.  
  13570.  
  13571. WorkSpace On-Demand Boot Block Definition File BB1USNTR.CNF
  13572.  
  13573. ; OS\2 Boot Block Configuration
  13574. ; (IBM Token-ring Compatible Adapter)
  13575. RPL DOS\RPLBOOT.SYS
  13576. DAT DOS\MFSD30.SYS
  13577. ORG 1000H
  13578. LDR BB20.US\OS2LDR ~ OS2LDR UFSD.SYS MFSD30.SYS
  13579. DAT DOS\UFSD.SYS
  13580. DAT DOS\TOKENRING\OS2\PROTOCOL.INI
  13581. DAT C:\IBMLAN\DOSLAN\LSP\DXM.MSG
  13582. DAT C:\IBMLAN\DOSLAN\LSP\DOS\LT2.MSG
  13583. EXE C:\IBMLAN\DOSLAN\LSP\NETBIND.COM ~ ~ ~
  13584. ;**NETBIOS and IEEE 802.2****************
  13585. ;DRV C:\IBMLAN\DOSLAN\LSP\DXMT0MOD.SYS PBA=0~S=12~C=14~O=N ~ ~
  13586. ;DRV C:\IBMLAN\DOSLAN\LSP\DXME0MOD.SYS ~ 10 ~
  13587. ;**NETBIOS****************
  13588. DRV C:\IBMLAN\DOSLAN\LSP\DXMJOMOD.SYS ~ 6 ~
  13589. ;**NETBIOS****************
  13590. DRV C:\IBMLAN\DOSLAN\LSP\DXMAOMOD.SYS 001 ~ ~
  13591. DRV C:\IBMLAN\DOSLAN\LSP\DOS\IBMTOK.DOS ~ ~ ~
  13592. DRV C:\IBMLAN\DOSLAN\LSP\PROTMAN.DOS /I: ~ ~
  13593.  
  13594. When dealing with path and directory names,  all file name fields either can be 
  13595. fully qualified, or expressed relative to  RPLDIR, as specified in the 
  13596. [Remoteboot] section in the IBMLAN.INI file: 
  13597.  
  13598. RPLDIR = C:\IBMLAN\RPL
  13599. If they are fully qualified, the entire path must be specified, including the 
  13600. drive letter and all the subdirectories. 
  13601.  
  13602. All fields, including .CNF file parameters, are separated by spaces. Some .CNF 
  13603. parameters can contain parameter lists to be used by other software. Fields of 
  13604. these embedded parameter lists must be separated by tilde (~) characters. 
  13605.  
  13606. The following table describes .CNF file entry types, along with their expected 
  13607. file names and parameters: 
  13608.  
  13609. Description of the Boot Block Definition.CNF File Entries 
  13610.  
  13611. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  13612. ΓöéEntry ΓöéDescription                                                Γöé
  13613. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13614. ΓöéRPL   ΓöéA .CNF file can contain only one RPL entry.  The file name Γöé
  13615. Γöé      Γöéfield of this entry specifies the name of the first programΓöé
  13616. Γöé      Γöéto be run on the IPL workstation.  No parameters are       Γöé
  13617. Γöé      Γöéassociated with this file entry.                           Γöé
  13618. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13619. ΓöéORG   ΓöéA .CNF file can contain only one ORG entry.   The second   Γöé
  13620. Γöé      Γöéfile name field of this entry specifies the hexadecimal    Γöé
  13621. Γöé      Γöésegment number of a contiguous memory block on the IPL     Γöé
  13622. Γöé      Γöéworkstation. Files following this entry in the .CNF file   Γöé
  13623. Γöé      Γöéare bound to this memory address.  No parameters are       Γöé
  13624. Γöé      Γöéassociated with this file entry.                           Γöé
  13625. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13626. ΓöéDAT   ΓöéSeveral DAT entries can be located in a .CNF file.  Their  Γöé
  13627. Γöé      Γöéfile name fields specify data files to be stored in the    Γöé
  13628. Γöé      Γöéboot block.  These files are not used by RPLBOOT.SYS, but  Γöé
  13629. Γöé      Γöéthey can be read by DOS Handle I/O functions. No parametersΓöé
  13630. Γöé      Γöéare associated with this file entry.                       Γöé
  13631. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13632. ΓöéLDR   ΓöéLDR applies only to OS/2 and WorkSpace On-Demand           Γöé
  13633. Γöé      Γöéworkstations.  A .CNF file can contain only one LDR entry. Γöé
  13634. Γöé      ΓöéThe file name field of this entry specifies the name of theΓöé
  13635. Γöé      Γöéloader to use on the IPL workstation. For WorkSpace        Γöé
  13636. Γöé      ΓöéOn-Demand, this entry must include the following file name Γöé
  13637. Γöé      Γöéand parameters:                                            Γöé
  13638. Γöé      ΓöéBB20.US\OS2LDR ~ OS2LDR OS2KRNL MFSD30.SYS                 Γöé
  13639. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13640. ΓöéEXE   Γöé A .CNF file can contain one or more EXE entries.  The EXE Γöé
  13641. Γöé      Γöéfile name fields specify the names of executable files thatΓöé
  13642. Γöé      Γöéare to be used on the IPL workstation. The parameter fieldsΓöé
  13643. Γöé      Γöéof an EXE entry are passed on to the executable file when  Γöé
  13644. Γöé      Γöéit runs.                                                   Γöé
  13645. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13646. ΓöéDRV   ΓöéA .CNF file can contain one or more DRV entries.  The DRV  Γöé
  13647. Γöé      Γöéfile name fields specify the names of device drivers to be Γöé
  13648. Γöé      Γöéused on the IPL workstation. Each driver entry requires theΓöé
  13649. Γöé      Γöéfollowing parameter fields:                                Γöé
  13650. Γöé      Γöé┬╖ The parameter list for the device driver.  Fields of thisΓöé
  13651. Γöé      Γöéembedded parameter list must be separated by tilde (~)     Γöé
  13652. Γöé      Γöécharacters in the .CNF file.                               Γöé
  13653. Γöé      Γöé┬╖ The additional memory requirements of the device driver, Γöé
  13654. Γöé      Γöéif any, are expressed in decimal kilobytes.                Γöé
  13655. Γöé      Γöé┬╖ Use the character M if the driver can be moved after     Γöé
  13656. Γöé      Γöéinitialization. Otherwise, use a tilde (~) character. Most Γöé
  13657. Γöé      Γöéof the drivers currently available cannot be moved, and theΓöé
  13658. Γöé      Γöétilde character (~) should be specified.                   Γöé
  13659. Γöé      ΓöéIf the driver can be moved and it requires less memory thanΓöé
  13660. Γöé      Γöéthe original driver image, RPLBOOT.SYS moves the driver to Γöé
  13661. Γöé      Γöéreclaim the unused memory and adjusts all interrupt vectorsΓöé
  13662. Γöé      Γöéthat point into that driver memory area.                   Γöé
  13663. Γöé      Γöé                                                           Γöé
  13664. Γöé      ΓöéNote: The order of field entries must be considered.  PlaceΓöé
  13665. Γöé      ΓöéEXE entries before DRV entries.  This change allows movableΓöé
  13666. Γöé      Γöédrivers to be placed in memory freed by completed .EXE     Γöé
  13667. Γöé      Γöéfiles.                                                     Γöé
  13668. Γöé      ΓöéDRV statements are order-dependent. They are processed in  Γöé
  13669. Γöé      Γöéreverse order, from last to first.                         Γöé
  13670. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  13671. ΓöéBASE  ΓöéBASE applies only to DOS workstations. Only one BASE entry Γöé
  13672. Γöé      Γöécan be in a CNF file. The second field of this entry       Γöé
  13673. Γöé      Γöéspecifies the hexadecimal segment number (paragraph) that  Γöé
  13674. Γöé      Γöéis the boot block base address.  The default base address  Γöé
  13675. Γöé      Γöéis X'00C0H'.                                               Γöé
  13676. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  13677.  
  13678. Note:  DHCP boot is controlled by the DHCP PXE/BINL services, not by the Remote 
  13679.        IPL service. DHCP boot continues to function even when the remote IPL 
  13680.        service has been stopped. 
  13681.  
  13682.  
  13683. ΓòÉΓòÉΓòÉ 18.2.3. RPL.MAP Control File ΓòÉΓòÉΓòÉ
  13684.  
  13685.  The RPL.MAP control file is located in the \IBMLAN\RPL directory. The file is 
  13686. updated when you create a requester. The RPL.MAP control file contains records 
  13687. that define the behavior of the remote IPL service for each client. The RPL.MAP 
  13688. control file contains a unique requester record entry for each requester you 
  13689. create. The remote IPL requester definitions in the RPL.MAP control file 
  13690. specify the name of the remote IPL server and the parameters required to IPL 
  13691. that requester. Each requester record has a unique adapter ID field that is 
  13692. used to match the specific machine to that record. 
  13693.  
  13694. When you use the post-install GETRPL utility, the server records that are 
  13695. enabled depend upon the operating system type. For OS/2 versions 3.0 and 4.0 
  13696. and WorkSpace On-Demand 1.0, only server records that correspond to LAN adapter 
  13697. types found on the server at that time are enabled. To enable server records 
  13698. for other LAN adapter types, you must update the RPL.MAP file by locating the 
  13699. appropriate server record and removing the semicolon in the first column. For 
  13700. WorkSpace On-Demand 2.0, all token-ring and ethernet server records are enabled 
  13701. if all of the support files needed for the adapter are installed on the server. 
  13702.  
  13703. RPL.MAP control files consist of two sections. One section describes server 
  13704. records, and the other describes workstation records. Each requester must have 
  13705. a set of server and workstation records residing on the server before 802.2 
  13706. RIPL can occur. The server records include one line per adapter; the 
  13707. workstation records include one line per workstation. 
  13708.  
  13709.  
  13710. An Example of Server Records and Workstation Records in a RPL.MAP File
  13711.  
  13712. server record fields:
  13713. ;  1    = yyyyyyyyyyyy
  13714. ;  2    = boot block configuration file (.cnf)
  13715. ;  3    = number of retries before default boot
  13716. ;  4    = time window for retries (in seconds)
  13717. ;  5    = acknowledge (A,N)
  13718. ;  6    = loader parameters (~ for os2, image share name for dos)
  13719. ;  7    = descriptive comment
  13720. ;  8,9, = ~
  13721. ;  A    = ,,,
  13722. ;  B    = ~
  13723. ;  C    = server record identifier
  13724. ;  D,E  = ~
  13725.  
  13726. ; server records
  13727.  yyyyyyyyyyyy dosbbntr.cnf 3 10 N IBMLAN$ DOS~TOKEN~RING ~ ~ ,,, Z R_DTK ~ ~
  13728.  yyyyyyyyyyyy os240et.cnf 3 10 N ~ OS2~WARP~4.0~IBM~ETHERNET ~ ~ ,,, ~ R_240_OET ~ ~
  13729.  yyyyyyyyyyyy bb2us316.cnf 3 10 N ~ WSOD~2.0~3COM~ETHERLINK~16~(3C507) ~ ~ ,,, ~ R_BB20_US_OET316 ~ ~
  13730.  yyyyyyyyyyyy bbuntr.cnf 3 10 N ~ WSOD~2.0~IBML~TOKEN~RING~COMPATIBLE~NDIS~~,,,~R_BB20_USOTKNTR  ~ ~
  13731. ; workstation record fields:
  13732. ;  1     = adapter ID (12 hex digits)
  13733. ;  2     = workstation name
  13734. ;  3     = ~
  13735. ;  4     = image file for dos (.img), fit file for OS/2 (.fit)
  13736. ;  5     = name of rpl server
  13737. ;  6     = boot drive for OS/2, domain name for DOS
  13738. ;  7,8,9 = parameters for device drivers 1,2,3
  13739. ;  A     = additional memory for device drivers 1,2,3. Default: ,,,
  13740. ;  B     = ~ for OS/2, Z for DOS
  13741. ;  C     = workstation type; first letter is R -> enabled, D -> disabled
  13742. ;  D     = ~
  13743. ;  E     = volume ID string for DOS, IML image file for OS/2
  13744. ;  F     = P for OS/2 PCNet clients only
  13745.  
  13746. ; workstation records
  13747. 100FFFFFFFFF DEFAULT ~ imagefile    RPLSRV1 RPLSRV1DOM ~ ~ ~ ,,, Z ~ R_DTK ~ ~
  13748. 1000FFFFFFFF DFBB20US ~ FITS\DFBB20US RPLSRV1 Z ~ ~ ~ ,,, ~ R_BB20_US_OTKNTR ~ ~ ~
  13749. 10005A123456 RPLMACH1 ~ FITS\RPLMACH1 RPLSRV1 Z ~ ~ ~ ,,, ~ R_BB20_US_OTKNTR ~ ~ ~
  13750.  
  13751. The two workstation entries made by the GETRPL utility enable remote IPL 
  13752. services.  You may delete these entries if you have defined at least one remote 
  13753. IPL client.  If you don't have at least one workstation record or remote IPL 
  13754. client, you should disable the REMOTEBOOT service in your IBMLAN.INI so that 
  13755. the server can be started. 
  13756.  
  13757. In the RPL.MAP file, DHCP boot method server and client records have a unique 
  13758. field to distinguish them from existing RPL.MAP records.  The server record has 
  13759. the following format: 
  13760.  
  13761.  
  13762. yyyyyyyyyyyy BB2ccDHC.CNF 3 10 N ~ Workspace~On-Demand~2~PXE~DHCP~BOOT~FOR~TOKEN~RING/ETHERNET
  13763. ~~,,,~_R_BB20_cc_DHCPBOOT~~
  13764.      where BB2ccDHC.CNF is a dummy file and cc is the two-character country code.
  13765.  
  13766.  
  13767. You do not have to add additional server record entries for DHCP boot. This one 
  13768. server record is sufficient for all types of adaptors. 
  13769.  
  13770. In the workstation section of the file, there is a record for each configured 
  13771. client. The workstation record has the following format: 
  13772.  
  13773. 0080000123456 BPCLIENT1 ~ FITS\BPCLIENT1 RIPLSRV Z ~ ~ ~ ,,, ~ R_BB20_cc_DHCPBOOT
  13774.      where cc is the two-character country code.
  13775.  
  13776.  
  13777. ΓòÉΓòÉΓòÉ 18.2.3.1. Understanding OS Server Record Identifier ΓòÉΓòÉΓòÉ
  13778.  
  13779. The server record identifier is used to point to the server record that defines 
  13780. the network protocol stack a remote IPL  client can use when connecting to the 
  13781. remote IPL  server. The server record identifier must match field 12 of one of 
  13782. the server records in the RPL.MAP control file. In addition, the syntax 
  13783. convention for naming server record identifiers provides the following 
  13784. information: 
  13785.  
  13786.                    - Enabled/Disabled state of the client
  13787.                    - The OS version that the client is to remote IPL
  13788.                    - The network adapter type and protocol stack that the
  13789.                      remote IPL client is to use
  13790.  
  13791. The server record identifier syntax for WorkSpace On-Demand is as follows: 
  13792.  
  13793. s_BBvv_nn_aaappppp...   (maximum length is 48 characters)
  13794.  
  13795.             s  defines the state of the remote IPL client:
  13796.  
  13797.                R - indicates the client is enabled
  13798.                D - indicates the client is disabled
  13799.  
  13800. WorkSpace On-Demand clients can be created in the enabled or disabled state.
  13801.  
  13802.            vv  defines the major version ID of WorkSpace On-Demand:
  13803.  
  13804.                10 - indicates WorkSpace 1.0
  13805.                20 - indicates WorkSpace 2.0
  13806.  
  13807.            nn  defines the language ID version of
  13808.                WorkSpace On-Demand, for example:
  13809.  
  13810.                US - United States
  13811.                FR - France
  13812.  
  13813.           aaa  defines the network adapter type:
  13814.  
  13815.                OTK - indicates Token-ring
  13816.                OET - indicates Ethernet
  13817.  
  13818.        ppppp...defines a unique string that identifies
  13819.                the network adapter or protocol stack
  13820.                the remote IPL client is to use. This
  13821.                string must match field 4 of the adapter
  13822.                definition record in the NDISDD.PRO file.
  13823.  
  13824. The server record identifier syntax for other versions of OS/2 is as follows: 
  13825.  
  13826. s_2vv_aaappppp...(maximum length is 48 characters)
  13827.  
  13828.               s  defines the state of the remote IPL client:
  13829.  
  13830.                  R - indicates the client is enabled
  13831.                  D - indicates the client is disabled
  13832.  
  13833. OS/2 clients are always created in enabled state.
  13834.  
  13835.              vv  defines the major version ID of OS/2:
  13836.  
  13837.                  0 - indicates OS/2 2.0
  13838.                  1 - indicates OS/2 2.1
  13839.                  30 - indicates OS/2 3.x
  13840.                  40 - indicates OS/2 4.0
  13841.  
  13842.             aaa  defines the network adapter type:
  13843.  
  13844.                  OTK - indicates Token-Ring
  13845.                  OET - indicates Ethernet
  13846.                  3CE - This is an old naming convention
  13847.                        originally used for 3COM ethernet
  13848.                        adapters. OET is the recommended prefix
  13849.                        for ethernet.
  13850.  
  13851.         ppppp... defines a unique string that identifies
  13852.                  the network adapter or protocol stack that the
  13853.                  remote IPL client is to use. The only
  13854.                  requirement for this string is that it
  13855.                  results in a unique server record identifier.
  13856.  
  13857.  
  13858. ΓòÉΓòÉΓòÉ 18.2.4. File Index Table (FIT) ΓòÉΓòÉΓòÉ
  13859.  
  13860. A file index table (FIT) maps OS/2 and WorkSpace On-Demand workstation file 
  13861. names to server file names.  A FIT can be thought of as a mapping file.  A 
  13862. default FIT file and the FIT files for each machine are located on the server 
  13863. in the \IBMLAN\RPL\FITS\ directory. A FIT file is built for each client machine 
  13864. when you create it. Each client FIT file is defined in the workstation section 
  13865. of the RPL.MAP file. For 802.2 RIPL, the FIT file is sent to the requester as 
  13866. part of the boot block record during remote IPL. For DHCP PXE RIPL, the FIT 
  13867. file is downloaded as part of the first phase boot files during DHCP boot. 
  13868.  
  13869. A FIT file consists of a header record specifying the name of the default 
  13870. network share where files can be found, followed by file name mapping records. 
  13871. The mapping records consist of two fields on the same line. The first field 
  13872. represents a file name, and the second represents the actual location of the 
  13873. file on the server. 
  13874.  
  13875. These records consist of a prototype file name or prefix, followed by a space 
  13876. and an actual file name or prefix relative to the network share. If the 
  13877. prototype matches a proper prefix (part of the path name, ending in \) of the 
  13878. name to be matched, the matched portion is replaced by the actual prefix. If 
  13879. there is an exact match, it is used for substitution.  If several prototypes 
  13880. match, the longest match is selected for substitution. 
  13881.  
  13882. Network netnames can also be included as part of the substitution text. When 
  13883. this occurs, the netname on the first line is ignored.  Specifying the network 
  13884. netname also provides the capability to use files and applications located on a 
  13885. server other than the default server. 
  13886.  
  13887. A semicolon character (;) is used anywhere on a line of the FIT to begin a 
  13888. comment.  Blank lines are ignored. 
  13889.  
  13890.  
  13891. ΓòÉΓòÉΓòÉ 18.2.4.1. Using Wildcard Characters in the FIT File ΓòÉΓòÉΓòÉ
  13892.  
  13893. The wildcard characters (?) and (*) are supported and are subject to the 
  13894. following rules: 
  13895.  
  13896.      Wildcard characters can be placed only in the prototype file name field. 
  13897.       They cannot appear in the target server name field. 
  13898.  
  13899.      Wildcard references can be redirected only to the directory level. For 
  13900.       example, the following field is valid: 
  13901.  
  13902.             Z:\OS2\*.INI    \\ANYSRV01\WRKFILES\DEFAULT\OS2
  13903.        The following field is not valid: 
  13904.  
  13905.             Z:\OS2\*.INI    \\ANYSRV01\WRKFILES\DEFAULT\OS2\ANY.INI
  13906.  
  13907.      The ? and * cannot both be present in the same prototype file name field. 
  13908.       For example, the following field is not valid: 
  13909.  
  13910.             Z:\OS2\ANY???.*  \\ANYSRV01\WRKFILES\DEFAULT\OS2
  13911.  
  13912.  A brief example of a client FIT file follows.  The lines are numbered here for 
  13913.  reference; the line numbers are not displayed in the actual FIT file. In this 
  13914.  example, ANYSRV01 is the remote IPL  server name, and DEFAULT is the 
  13915.  workstation name. 
  13916.  
  13917.   1) \\ANYSRV01\RPLFILES
  13918.   2)
  13919.   3) Z:\CONFIG.SYS             MACHINES\DEFAULT\CONFIG.SYS
  13920.   4) Z:\OS2                    BB20.US\OS2
  13921.   5) ; go to a different share
  13922.   6) Z:\OS2\SYSTEM\SWAPPER.DAT \\ANYSRV01\WKRFILES\DEFAULT\OS2\SYSTEM\SWAPPER.DAT
  13923.   7) Z:\                       \\ANYSRV01\WRKFILES\DEFAULT
  13924.  
  13925.   Line      Description
  13926.  
  13927.  1         Defines the default remote IPL  server and network share name. 
  13928.  
  13929.  2         Empty line. 
  13930.  
  13931.  3         Translates all references to Z:\CONFIG.SYS to: 
  13932.  
  13933.                       \\ANYSRV01\RPLFILES\MACHINES\DEFAULT\CONFIG.SYS
  13934.  
  13935.             Note that the default netname is automatically prefixed to the 
  13936.            translated name. 
  13937.  
  13938.  4         Translates all references from Z:\OS2 to: 
  13939.  
  13940.                       \\ANYSRV01\RPLFILES\BB20.US\OS2
  13941.  
  13942.             Except for explicitly mapped file names, this record results in all 
  13943.            Z:\OS2\*.* references being translated to: 
  13944.  
  13945.                       \\ANYSRV01\RPLFILES\BB20.US\OS2\*.*
  13946.  
  13947.            Subdirectory references are also mapped by this statement. For 
  13948.            example, Z:\OS2\DLL\ANYFILE.DLL is translated to: 
  13949.  
  13950.                       \\ANYSRV01\RPLFILES\BB20.US\OS2\DLL\ANYFILE.DLL
  13951.  
  13952.  5         Comment 
  13953.  
  13954.  6         Translates all references from Z:\OS2\SYSTEM\SWAPPER.DAT to: 
  13955.  
  13956.                       \\ANYSRV01\WKRFILES\DEFAULT\OS2\SYSTEM\SWAPPER.DAT
  13957.  
  13958.            Note:  In this example, the default netname is overridden by 
  13959.                   specifying the explicit UNC name.  The translated file name 
  13960.                   is to the requester-unique file structure where the requester 
  13961.                   has read, write, create, delete, and execute access. Swapping 
  13962.                   here is defined on the remote server in comparison to local 
  13963.                   swapping. 
  13964.  
  13965.  7         Translates all other references to be relative to: 
  13966.  
  13967.                       \\ANYSRV01\WRKFILES\DEFAULT
  13968.  
  13969.            Note that the translated path is to the requester-unique file 
  13970.            structure on the server that the requester has read, write, create, 
  13971.            delete, and execute authority. 
  13972.  
  13973.  To add support for TCPBEUI protocol to 802.2 RIPL clients, the FIT file is 
  13974.  extended with additional statements ending with @. Below is an example of a 
  13975.  FIT file extension to support TCPBEUI. 
  13976.  
  13977.  
  13978.   ; READONLY FILES
  13979.  
  13980.   Z:\OS2\MDOS\VDMA.SYS   BB20.US\OS2\MDOS\VDMAAT.SYS
  13981.  
  13982.   Z:\OS2\DLL\BVHVGA.DLL    BB20.US\OS2\DLL\BVHVGA.DLL @
  13983.   Z:\OS2\DLL\DOSCALL1.DLL    BB20.US\OS2\DLL\DOSCALL1.DLL @
  13984.   Z:\OS2\DLL\OS2CHAR.DLL   BB20.US\OS2\DLL\OS2CHAR.DLL @
  13985.   Z:\OS2\DLL\QUECALLS.DLL  BB20.US\OS2\DLL\QUECALLS.DLL @
  13986.   Z:\OS2\DLL\BVSCALLS.DLL  BB20.US\OS2\DLL\BVSCALLS.DLL @
  13987.   Z:\OS2\DLL\BKSCALLS.DLL  BB20.US\OS2\DLL\BKSCALLS.DLL @
  13988.   Z:\OS2\DLL\BMSCALLS.DLL  BB20.US\OS2\DLL\BMSCALLS.DLL @
  13989.   Z:\OS2\DLL\SESMGR.DLL    BB20.US\OS2\DLL\SESMGR.DLL   @
  13990.   Z:\IBMLAN\NETPROG\DHCPWAIT.EXE BB20.US\IBMLAN\NETPROG\DHCPWAIT.EXE @
  13991.   Z:\IBMLAN\NETPROG\DHCPWAIT.SYM BB20.US\IBMLAN\NETPROG\DHCPWAIT.SYM @
  13992.   Z:\IBMCOM\RFCADDR.EXE    BB20.US\IBMCOM\RFCADDR.EXE @
  13993.   Z:\IBMCOM\PROTOCOL\TCPBEUI.SYM  BB20.US\IBMCOM\PROTOCOL\TCPBEUI.SYM @
  13994.   Z:\IBMCOM\PROTOCOL\NBTCP.EXE    BB20.US\IBMCOM\PROTOCOL\NBTCP.EXE @
  13995.   Z:\IBMCOM\RFCNAMES.LST   MACHINES\BH100\IBMCOM\RFCNAMES.LST @
  13996.   Z:\MPTN\BIN\SETUP.CMD    MACHINES\BH100\MPTN\BIN\SETUP.CMD @
  13997.   Z:\MPTN\ETC\DHCPCD.CFG   MACHINES\BH100\MPTN\ETC\DHCPCD.CFG @
  13998.   Z:\MPTN\BIN\ROUTE.EXE    BB20.US\MPTN\BIN\ROUTE.EXE @
  13999.   Z:\MPTN\BIN\ARP.EXE      BB20.US\MPTN\BIN\ARP.EXE @
  14000.   Z:\MPTN\BIN\IFCONFIG.EXE BB20.US\MPTN\BIN\IFCONFIG.EXE @
  14001.   Z:\MPTN\BIN\CNTRL.EXE    BB20.US\MPTN\BIN\CNTRL.EXE @
  14002.   Z:\MPTN\BIN\IPGATE.EXE   BB20.US\MPTN\BIN\IPGATE.EXE @
  14003.   Z:\MPTN\BIN\DHCPSTRT.EXE BB20.US\MPTN\BIN\DHCPSTRT.EXE @
  14004.   Z:\MPTN\BIN\DHCPCD.EXE   BB20.US\MPTN\BIN\DHCPCD.EXE @
  14005.   Z:\MPTN\BIN\SO32DLL.DLL  BB20.US\MPTN\DLL\SO32DLL.DLL @
  14006.   Z:\MPTN\BIN\TCP32DLL.DLL BB20.US\MPTN\DLL\TCP32DLL.DLL @
  14007.   Z:\MPTN\BIN\TCPIPDLL.DLL BB20.US\MPTN\DLL\TCPIPDLL.DLL @
  14008.   Z:\MPTN\BIN\TCPMRI.DLL   BB20.US\MPTN\DLL\TCPMRI.DLL @
  14009.   Z:\MPTN\BIN\TCPIP32.DLL  BB20.US\MPTN\DLL\TCPIP32.DLL @
  14010.   Z:\MPTN\BIN\TCPTIME.DLL  BB20.US\MPTN\DLL\TCPTIME.DLL @
  14011.   Z:\MPTN\MSG\NLS\DHCPSTRT.CAT BB20.US\MPTN\MSG\NLS\DHCPSTRT.CAT @
  14012.   Z:\MPTN\MSG\NLS\DHCPMRES.DLL BB20.US\MPTN\MSG\NLS\DHCPMRES.DLL @
  14013.   Z:\IBMI18N\DLL\SETLOC1.DLL  BB20.US\IBMI18N\DLL\SETLOC1.DLL @
  14014.   Z:\IBMI18N\LOCALE\ENUS437.DLL  BB20.US\IBMI18N\LOCALE\ENUS437.DLL @
  14015.   Z:\IBMI18N\LOCALE\ALIASES  BB20.US\IBMI18N\LOCALE\ALIASES @
  14016.   Z:\IBMLAN\NETPROG\NET.MSG BB20.US\IBMLAN\NETPROG\NET.MSG @
  14017.  
  14018.  
  14019. ΓòÉΓòÉΓòÉ 18.2.4.2. User File Index Table (FIT) ΓòÉΓòÉΓòÉ
  14020.  
  14021. There are also FIT files for each user that provide the same mapping function 
  14022. as remote IPL machine FIT files. However, User FIT files are specific to an 
  14023. individual User ID and are active only while that user is logged onto the 
  14024. client. The user FIT allows the in-memory FIT to be updated with user-specific 
  14025. FIT information. This allows the in-memory FIT to be dynamically changed 
  14026. without rebooting the client machine. 
  14027.  
  14028. User FIT files are located on the Domain Controller in the 
  14029. \IBMLAN\DCDB\USERS\username\ directory. A default User FIT file is located in 
  14030. the \IBMLAN\DCDB\ directory. When a user logs on to a client, the client 
  14031. searches for a user-specific FIT file. If one is found, the in-memory copy of 
  14032. the machine FIT file is updated to add the user-specific FIT file entries. If 
  14033. the user-specific FIT file is not found, the default user FIT file is used. 
  14034.  
  14035. Note:  The default User FIT file is not required. 
  14036.  
  14037.  You can add entries to the default User FIT file or create user-specific FIT 
  14038.  files, or both. The format for the user-specific FIT is the same format as any 
  14039.  other FIT file except there cannot be a UNC name as the first entry. In User 
  14040.  FIT files, all entries are file-mapping entries, comments, or blank lines. The 
  14041.  following is an example of a User FIT mapping entry: 
  14042.  
  14043.   ?:\ABCAPP\ABCFILE.EXT \\IBMLAN$\DCDB\USERS\ABCAPP
  14044.        where ? is replaced by the system as the boot drive of the client machine.
  14045.  
  14046.  Note:  User FIT files are primarily used to map files to the user area of the 
  14047.         Domain Controller database, although they can be used to map files to 
  14048.         any share a user can access. 
  14049.  
  14050.  You can place a special statement in the User FIT file to tell the system to 
  14051.  also use the default User FIT file. Otherwise, only the user-specific FIT file 
  14052.  is used.  If the following line appears in the user-specific User FIT file, 
  14053.  then the global User FIT file is also used: 
  14054.  
  14055.    #include BB20ccDU.FIT
  14056.  
  14057.  where cc is the country code.
  14058.  
  14059.  Notes: 
  14060.  
  14061.    1. Regardless of the location of this line, the default User FIT file is 
  14062.       processed last, after all of the user-specific User FIT file entries. 
  14063.  
  14064.    2. Only one #include is allowed. 
  14065.  
  14066.    3. There can be only one space between the #include and the default User FIT 
  14067.       filename. 
  14068.  
  14069.    4. WorkSpace On-Demand 2.0 configurations may have servers running with 
  14070.       different country codes and different levels of WorkSpace On-Demand. The 
  14071.       remote IPL client that processes the #include statement will substitute 
  14072.       the correct version and country code when it recognizes a default User 
  14073.       FIT filename following #include. 
  14074.  
  14075.  
  14076. ΓòÉΓòÉΓòÉ 18.2.5. NDISDD.PRO Control File ΓòÉΓòÉΓòÉ
  14077.  
  14078. The NDISDD.PRO control file defines the network adapters that are  supported 
  14079. for 802.2 RIPL and DHCP PXE RIPL. This file is located in the \IBMLAN\RPL 
  14080. directory and contains a definition record for each adapter type. 
  14081.  
  14082. When you create a requester using the LAN Server Administration GUI, you select 
  14083. network adapters from those that appear in the listbox. The adapters that 
  14084. appear in the list are defined in the NDISDD.PRO file. When you install a new 
  14085. adapter, you can edit this file to provide the information that will appear in 
  14086. the GUI. 
  14087.  
  14088. The following is an example of an NDISDD.PRO file, including a description of 
  14089. the fields. Fields 3, 4 and 5 apply only to WorkSpace On-Demand. If you include 
  14090. field 3 you must also include fields 4 and 5. 
  14091.  
  14092. ;NDIS device driver profile records are composed of 5 fields.
  14093. ;They are described below.
  14094. ;Field 1  This field specifies the DOS NDIS device driver name.
  14095. ;Field 2  This field specifies the subdirectory name that contains the configuration file(s)
  14096. ;         needed to remote boot the RIPL client.
  14097. ;         d:\IBMLAN\RPL\IBMCOM\xxx contains the configuration files needed to RIPL OS/2 clients.
  14098. ;         d - the drive on which the RIPL component has been installed
  14099. ;         xxx - the text located in the second field of a given line
  14100. ;Field 3  NIF file name for OS/2 device driver
  14101. ;Field 4  CNF file name id reference for server record id
  14102. ;Field 5  This field specifies the remote IPL protocol(s) a card may support
  14103. ;         The possible types are 802.2 and DHCP boot
  14104. IBMTOK.DOS    TOKENRING    IBMTOK.NIF    OTKNTR    802.2
  14105. MACETH.DOS    ETHERNET     MACETH.NIF    OET       802.2
  14106. ELNKMC.DOS    ELNKMC       ELNKMC.NIF    OET3EM    802.2
  14107. ELNKII.DOS    ELNKII       ELNKII.NIF    OET3EI    802.2
  14108. IBMENI.DOS    ETHILAEI     IBMENI.NIF    OETLAE    802.2
  14109. F1MAC.DOS     ETHIPS2I
  14110. ELNK16.DOS    ELNK16       ELNK16.NIF    OET316    802.2
  14111. ELNK3.DOS     ELNK3        EL3IBM02.NIF  OET3E3    802.2
  14112. .
  14113. .
  14114. .
  14115. IBMTRP.DOS    TOKENTRP     IBMTRPO2.NIF  OTKTRP    802.2,DHCP
  14116. IBMFE.DOS     ETHERJ10     IBMFEEO2.NIF  OETFE     802.2,DHCP
  14117.  
  14118. When you are creating a requester using the LAN Server Administration GUI, the 
  14119. information in the third field in the adapter record is used by the server to 
  14120. build the CONFIG.SYS, PROTOCOL.INI, and SETUP.CMD files for the requester. The 
  14121. information in the fourth field is used to correlate to a server record in 
  14122. RPL.MAP when creating the workstation record for the requester. . The 
  14123. information in the fifth field of the record determines the boot method that 
  14124. will be enabled in the GUI for your selection. 
  14125.  
  14126.  
  14127. ΓòÉΓòÉΓòÉ 18.3. Installing Remote IPL Using the OS/2 RIPLINST Utility ΓòÉΓòÉΓòÉ
  14128.  
  14129. The RIPLINST utility copies the OS/2 operating system into a subdirectory on 
  14130. the OS/2 Warp Server or LAN Server. This copy is the central copy of the 
  14131. operating system that the clients use. All files required for remote IPL are 
  14132. copied into this subdirectory, including OS/2 device drivers and display short 
  14133. routines. 
  14134.  
  14135. Each version of OS/2 has a unique version of RIPLINST.  Most versions of 
  14136. RIPLINST have a different default target installation directory. The various 
  14137. default target installation directories are: 
  14138.  
  14139.  OS/2 version        Target directory 
  14140.  
  14141.  OS/2 3.0            d:\IBMLAN\RPL\OS2.30 
  14142.  
  14143.  OS/2 4.0            d:\IBMLAN\RPL\OS2.40 
  14144.   where  d: indicates the drive where IBMLAN\RPL is installed. 
  14145.  
  14146.  This prevents an existing ..\OS2.xx directory tree from being overwritten 
  14147.  automatically.  To upgrade an existing..\OS2.xx directory tree, the target 
  14148.  installation directory must be updated before starting the installation 
  14149.  process. The target directory must be on the same drive where OS/2 remote IPL 
  14150.  support was installed (this can be different from where OS/2 Warp Server or 
  14151.  LAN Server was installed).  The only part of the directory path that should be 
  14152.  updated is the drive ID.  Do not change any of the remaining path information. 
  14153.  
  14154.  After using RIPLINST to install OS/2 for remote IPL, run the updated version 
  14155.  of the GETRPL utility (for more information, see the Command Reference ). 
  14156.  
  14157.  The RIPLINST utility used to install the OS/2 code for OS/2 Warp Server or LAN 
  14158.  Server remote IPL is located (in packed format) on diskette 7 of the OS/2 
  14159.  Installation diskettes. 
  14160.  
  14161.  Note:  Use the OS/2 Installation diskette for the version of OS/2 that you 
  14162.         want to install. 
  14163.  
  14164.  Use one of the following procedures to install and run RIPLINST: 
  14165.  
  14166.      If your  server operating system is the same as the version of OS/2 being 
  14167.       installed by RIPLINST, see Steps to Install RIPLINST. 
  14168.  
  14169.      If your  server operating system is NOT the same as the version of OS/2 
  14170.       being installed by RIPLINST, see Steps to Install RIPLINST on Different 
  14171.       Version Server. 
  14172.  
  14173.  Note:  The OS/2 code on the OS/2 Warp Server SMP and OS/2 Warp Server for 
  14174.         e-business CD-ROMs is not supported for remote IPL and cannot be 
  14175.         installed by the RIPLINST utility. 
  14176.  
  14177.  For more information, see the following topics: 
  14178.  
  14179.      Steps to Install RIPLINST 
  14180.  
  14181.      Steps to Install RIPLINST on Different Version Server 
  14182.  
  14183.  
  14184. ΓòÉΓòÉΓòÉ 18.3.1. Steps to Install RIPLINST ΓòÉΓòÉΓòÉ
  14185.  
  14186.  To install RIPLINST: 
  14187.  
  14188.    1. Do one of the following: 
  14189.  
  14190.           Insert the OS/2 Install diskette 7 into drive A.  Then install 
  14191.            RIPLINST by typing: 
  14192.  
  14193.                       UNPACK A:\RIPLINST
  14194.  
  14195.           Insert the OS/2 Install CD-ROM into your CD-ROM drive.  Then install 
  14196.            RIPLINST by typing: 
  14197.  
  14198.                       UNPACK d:\OS2IMAGE\DISK_7\RIPLINST
  14199.  
  14200.            where  d is your CD-ROM drive. 
  14201.  
  14202.       The RIPLINST files are unpacked to the \OS2\INSTALL directory. 
  14203.  
  14204.    2. To start the RIPLINST program, go to an OS/2 window or full-screen 
  14205.       session and type: 
  14206.  
  14207.             RIPLINST
  14208.  
  14209.    3. Press Enter to remove the title window. 
  14210.  
  14211.    4. The Change Source/Target window is displayed. In this window, you are 
  14212.       provided the option to change the values for the following fields: 
  14213.  
  14214.                  Field                                   Value
  14215.  
  14216.       Source Directory                             A:\ 
  14217.  
  14218.       OS/2 RIPL Directory                          d:\IBMLAN\RPL\OS2.xx 
  14219.  
  14220.       where  d is the drive where OS/2 Warp Server or LAN Server is installed 
  14221.       and  xx is the version of OS/2 installed. 
  14222.  
  14223.       It is not necessary to change either of these options.  It is assumed you 
  14224.       are installing from a diskette drive. Change the source directory 
  14225.       accordingly. 
  14226.  
  14227.       Attention  The OS/2 remote IPL directory must be specified for the same 
  14228.                  drive where the Remote IPL service is installed. In addition, 
  14229.                  the base path of \IBMLAN\RPL must always be specified. 
  14230.  
  14231.    5. Select  Install. 
  14232.  
  14233.    6. Insert diskettes as prompted. 
  14234.  
  14235.  
  14236. ΓòÉΓòÉΓòÉ 18.3.2. Steps to Install RIPLINST on Different Version Server ΓòÉΓòÉΓòÉ
  14237.  
  14238.  To install RIPLINST on a different version server: 
  14239.  
  14240.    1. Create a temporary subdirectory by typing: 
  14241.  
  14242.             MD TEMPRIPL
  14243.  
  14244.    2. Change to the temporary subdirectory by typing: 
  14245.  
  14246.             CD TEMPRIPL
  14247.  
  14248.    3. Insert OS/2 Install diskette 2 into drive A. 
  14249.  
  14250.    4. Copy UNPACK.EXE to the TEMPRIPL directory by typing: 
  14251.  
  14252.             COPY A:UNPACK.EXE
  14253.  
  14254.    5. Check OS/2 Install diskette 2 for the file UNPACK2.EXE. If it is present, 
  14255.       copy UNPACK2.EXE to the TEMPRIPL directory by typing: 
  14256.  
  14257.             COPY A:UNPACK2.EXE
  14258.  
  14259.       Note:  UNPACK2.EXE might not be present.  If it is not on diskette 2, you 
  14260.              do not need it. 
  14261.  
  14262.    6. Insert OS/2 Install diskette 7 into drive A. 
  14263.  
  14264.    7. Install the RIPLINST files by typing: 
  14265.  
  14266.             UNPACK A:\RIPLINST d:\TEMPRIPL
  14267.  
  14268.       where  d is the drive ID where TEMPRIPL is located. 
  14269.  
  14270.    8. Start the RIPLINST program by typing: 
  14271.  
  14272.             RIPLINST
  14273.  
  14274.       Note:  Each version of RIPLINST must use the corresponding OS/2 version 
  14275.              of UNPACK and UNPACK2 (if it exists). Failure to do so results in 
  14276.              one of the following error conditions: 
  14277.  
  14278.           RIPLINST traps while copying the W0F0000.BIO file. 
  14279.  
  14280.           The system locks up after displaying the copy window.  You must 
  14281.            reboot if this occurs. 
  14282.  
  14283.    9. Press Enter to clear the title window. 
  14284.  
  14285.   10. The Change Source/Target window is displayed. In this window, you are 
  14286.       provided the option to change the values for the following fields: 
  14287.  
  14288.                  Field                                   Value
  14289.  
  14290.       Source Directory                             A:\ 
  14291.  
  14292.       OS/2 RIPL Directory                          d:\IBMLAN\RPL\OS2.xx 
  14293.  
  14294.       where  d is the drive where OS/2 Warp Server or LAN Server is installed 
  14295.       and  xx is the version of OS/2 installed. 
  14296.  
  14297.       It is not necessary to change either of these options.  It is assumed you 
  14298.       are installing from a diskette drive. Change the source directory 
  14299.       accordingly. 
  14300.  
  14301.   11. Select  Install. 
  14302.  
  14303.   12. Insert diskettes as prompted. 
  14304.  
  14305.  
  14306. ΓòÉΓòÉΓòÉ 18.3.3. Supporting Multiple Levels of the OS/2 Operating System ΓòÉΓòÉΓòÉ
  14307.  
  14308. It is possible to install and support multiple levels of the OS/2 operating 
  14309. system on a remote IPL server.  This section documents the correct procedure to 
  14310. use to support such an environment. 
  14311.  
  14312. To support multiple levels of the OS/2 operating system: 
  14313.  
  14314.    1. Run the OS/2 utility RIPLINST to install the OS/2 code in the RIPL 
  14315.       directory tree.  You must be careful to use the version of RIPLINST that 
  14316.       matches the level of code to be installed. 
  14317.  
  14318.    2. After running RIPLINST, run the GETRPL utility (provided with OS/2 Warp 
  14319.       Server and LAN Server) GETRPL uses information stored in the OS2SYS.INI 
  14320.       file by RIPLINST so it is very important that GETRPL be run before using 
  14321.       RIPLINST to install another version of OS/2. 
  14322.  
  14323.    3. Repeat steps 1 and 2 for each version of OS/2 to be remotely IPLed. 
  14324.  
  14325.    4. Check the \IBMLAN\RPL\RPL.MAP file.  Look for the OS/2 server records, 
  14326.       they start with yyyyyyyyyyyy or ;yyyyyyyyyyyy and the second field 
  14327.       contains a name like OS230*.CNF or OS240*.CNF. A semicolon (;) in column 
  14328.       1 indicates the record is disabled. GETRPL enables or disables the 
  14329.       appropriate records based upon what OS/2 version you installed. 
  14330.  
  14331.  
  14332. ΓòÉΓòÉΓòÉ 18.3.4. Machines with Updatable IML Records ΓòÉΓòÉΓòÉ
  14333.  
  14334. DBCS Note  The following statement about the Models 8556 and 8557 does not 
  14335.            apply to you. 
  14336.  
  14337.  When using the Remote IPL service on any machine that has updatable initial 
  14338.  microcode load (IML) records, perform the following modification to the remote 
  14339.  IPL server.  (Machines with IML records include Models 8556 and 8557.) 
  14340.  
  14341.  To update machines with IML records: 
  14342.  
  14343.    1. Copy the $0000000.IML file from the Reference Diskette to the 
  14344.       IBMLAN\DCDB\IMAGES subdirectory. 
  14345.  
  14346.    2. Create a remote IPL image of the Reference Diskette. See  Creating a DOS 
  14347.       Image from Diskette for instructions. 
  14348.  
  14349.    3. Edit the \IBMLAN\RPL\xxyyy.CNF file, where  xx is the version of OS/2 
  14350.       installed and yyy identifies a network adapter type. 
  14351.  
  14352.         a. Insert the following new line immediately before the lines starting 
  14353.            with DRV: 
  14354.  
  14355.                       EXE C:\IBMLAN\RPL\DOS\IMLUPDAT.COM
  14356.  
  14357.         b. Save the file. 
  14358.  
  14359.    4. Edit the \IBMLAN\RPL\RPL.MAP file. 
  14360.  
  14361.         a. Locate the workstation record for the workstation that requires the 
  14362.            update. 
  14363.  
  14364.         b. Update field 14 to specify the name of the Reference Diskette image 
  14365.            you created at the beginning of this procedure. 
  14366.  
  14367.         c. Save the file. 
  14368.  
  14369.    5. Restart the remote IPL workstation. 
  14370.  
  14371.  
  14372. ΓòÉΓòÉΓòÉ 19. Managing Remote IPL ΓòÉΓòÉΓòÉ
  14373.  
  14374. After installing Remote IPL, the network administrator can create, customize, 
  14375. and manage Remote IPL clients. This chapter details some of the considerations 
  14376. regarding how to create and customize clients, along with the procedures for 
  14377. adding support for OS/2 SVGA and using the Remote IPL REXX commands. 
  14378.  
  14379. For more information, see the following topics: 
  14380.  
  14381.      Creating, Changing, or Deleting a Remote IPL Client 
  14382.  
  14383.      Customizing DOS Remote IPL Workstations 
  14384.  
  14385.      Customizing OS/2 Remote IPL Workstations 
  14386.  
  14387.      OS/2 SVGA Support for Remote IPL Clients 
  14388.  
  14389.      Remote IPL REXX Procedures 
  14390.  
  14391.  
  14392. ΓòÉΓòÉΓòÉ 19.1. Creating, Changing, or Deleting a Remote IPL Client ΓòÉΓòÉΓòÉ
  14393.  
  14394. Clients for OS/2, DOS, and WorkSpace On-Demand 1.0 and 2.0 can be created and 
  14395. maintained from the administration server. What follows are the basics for 
  14396. managing clients. For specifics in regard to WorkSpace On-Demand (about machine 
  14397. classes, for example), please refer to the WorkSpace On-Demand 2.0 
  14398. Administrator's Guide. 
  14399.  
  14400. For more information, see the following topics: 
  14401.  
  14402.      Creating or Changing a Remote IPL Client 
  14403.  
  14404.      Deleting a Remote IPL Client 
  14405.  
  14406.  
  14407. ΓòÉΓòÉΓòÉ 19.1.1. Creating or Changing a RIPL Client ΓòÉΓòÉΓòÉ
  14408.  
  14409. To create or change a client: 
  14410.  
  14411.    1. Open the Connections object on the Desktop. 
  14412.  
  14413.    2. Open Network. 
  14414.  
  14415.    3. Open LAN Server Administration. 
  14416.  
  14417.    4. Open the domain where the new client is to be created or changed. The 
  14418.       icon for the domain object is a castle. 
  14419.  
  14420.    5. Open Defined Servers. 
  14421.  
  14422.    6. Open the RIPL server object where the new client is to be defined or 
  14423.       changed. 
  14424.  
  14425.    7. Open the Remote IPL Requesters object. This folder contains, a generic 
  14426.       Remote IPL template, templates for WorkSpace 1.0 and WorkSpace 2.0 
  14427.       requesters, and one icon for each requester currently defined. 
  14428.  
  14429.  At this point, the procedures for creating the different types of Remote IPL 
  14430.  clients differ. Use one of the following procedures depending on the type of 
  14431.  client you need: 
  14432.  
  14433.      WorkSpace On-Demand 
  14434.  
  14435.      OS/2 or DOS 
  14436.  
  14437.  
  14438. ΓòÉΓòÉΓòÉ 19.1.1.1. WorkSpace on-Demand 1.0 and 2.0 ΓòÉΓòÉΓòÉ
  14439.  
  14440. To create or change a requester: 
  14441.  
  14442.      To create a requester, drag and drop the WorkSpace 1.0 or 2.0 Template 
  14443.       object to another location in the Remote IPL Requester folder. This adds 
  14444.       a requester object to the folder and displays the Settings notebook. To 
  14445.       use another requester as a template, select the requester object and 
  14446.       press the right mouse button to display the  menu. Then select Create 
  14447.       Another. The Settings notebook is displayed. 
  14448.  
  14449.      To change the properties of an existing requester, select the requester 
  14450.       object you want to change, and then press the right mouse button to 
  14451.       display the menu. Select Properties. The Settings notebook is displayed. 
  14452.  
  14453.  Fill in the pages on the WorkSpace On-Demand Template - Settings notebook: 
  14454.  
  14455.    1. Select the Identity page. 
  14456.  
  14457.         a. When you create a requester it is enabled for remote IPL. You can 
  14458.            disable a requester without deleting it and then enable it at any 
  14459.            time. Select or clear the Disable requester check box. If the 
  14460.            requester is currently running, disabling it does not take effect 
  14461.            until the next time the requester is started. 
  14462.  
  14463.         b. Complete the Machine ID field. The machine ID is an alphanumeric 
  14464.            string containing up to 15 characters that you use to identify the 
  14465.            requester. 
  14466.  
  14467.         c. Complete the Description field. The description is an alphanumeric 
  14468.            string of up to 48 characters that you use to describe the 
  14469.            requester. 
  14470.  
  14471.    2. Select the System page. 
  14472.  
  14473.         a. Select the Boot drive ID from the list. The default is Z: 
  14474.  
  14475.         b. Select the Operating system from the list. 
  14476.  
  14477.         c. Choose the location for the swap file. If the requester has a hard 
  14478.            disk you can select Local. Otherwise, you must select Remote and the 
  14479.            swap file will be on the server. 
  14480.  
  14481.    3. Select the Hardware page. 
  14482.  
  14483.         a. Complete the Network adapter address field. This field is a unique 
  14484.            address of the network adapter card. You can get this by turning on 
  14485.            the requester machine and obtaining the character string following 
  14486.            the AA entry on the display. 
  14487.  
  14488.         b. Select a Machine class from the list. If the list does not include a 
  14489.            machine class to support your specific hardware configuration, see 
  14490.            the WorkSpace On-Demand 2.0 Administrator's Guide. 
  14491.  
  14492.         c. The fields in the Hardware Information box allow you to choose 
  14493.            network adapters, remote boot methods, and video selections. If the 
  14494.            device support you need is not in the list, see the WorkSpace 
  14495.            On-Demand 2.0 Administrator's Guide. 
  14496.  
  14497.              1. Select a Network adapter from the list. The network adapter 
  14498.                 type you select determines the remote boot methods that are 
  14499.                 enabled for selection. If the adapter card supports both 802.2 
  14500.                 RIPL and DHCP boot, both methods are enabled for selection, and 
  14501.                 RIPL is the default. 
  14502.  
  14503.              2. Select a Remote boot method. 802.2 RIPL and DHCP boot are 
  14504.                 enabled for selection if the network card you selected supports 
  14505.                 these boot protocols. 
  14506.  
  14507.              3. Select a Video monitor from the list if your machine class 
  14508.                 supports this selection. 
  14509.  
  14510.              4. Select a Video resolution from the list if your machine class 
  14511.                 supports this selection. 
  14512.  
  14513.            You can press the Reset all defaults button if you want to change 
  14514.            all entries back to the defaulted values. 
  14515.  
  14516.    4. Select the Printers page. You can add, change, or remove network or local 
  14517.       printers. 
  14518.  
  14519.           To remove a network or local printer, select the desired printer 
  14520.            from the list and select Remove. 
  14521.  
  14522.           To add a network or local printer, select Add, and then follow the 
  14523.            steps below. You can configure up to four printers for any one 
  14524.            client. 
  14525.  
  14526.           To change a network or local printer, select the desired printer 
  14527.            from the list and select Change, and then follow the steps below. 
  14528.  
  14529.         a. Complete the Printer name field. The printer name can be up to 25 
  14530.            characters. 
  14531.  
  14532.         b. Select the desired Port from the list. 
  14533.  
  14534.         c. Choose a Resource by selecting the desired Attach using alias name 
  14535.            or Attach using share name button. 
  14536.  
  14537.         d. If Attach using alias name is chosen, select the printer Alias name 
  14538.            from the list. 
  14539.  
  14540.            If Attach using share name is chosen, select the Server name and 
  14541.            Share name from the lists. 
  14542.  
  14543.         e. Select OK. 
  14544.  
  14545.    5. Select the Protocols page. 
  14546.  
  14547.         a. Select a Network and Additional protocol. 
  14548.  
  14549.                Select NetBEUI or TCPBEUI as a network protocol to connect to 
  14550.                 the WorkSpace On-Demand server. 
  14551.  
  14552.                You can optionally select an additional protocol. These options 
  14553.                 are enabled according to the boot protocol selected. 
  14554.  
  14555.         b. If you selected TCPBEUI as the network or additional protocol, you 
  14556.            need to configure the TCPBEUI parameters: 
  14557.  
  14558.              1. Select a Node type from the list. Broadcast node is the 
  14559.                 default. 
  14560.  
  14561.              2. If you did not select broadcast node, you must fill in the 
  14562.                 remaining parameter fields: 
  14563.  
  14564.                   a. Enter NETBIOS scope. This can contain 128 characters in 
  14565.                      the format city.company.com.localscope. 
  14566.  
  14567.                   b. Enter the address of the NETBIOS name server. The address 
  14568.                      can contain up to 12 numeric characters in four groups of 
  14569.                      up to three characters each (for example, 
  14570.                      123.123.123.123). 
  14571.  
  14572.                   c. Enter the address of the Datagram distributor server. The 
  14573.                      address can contain up to 12 numeric characters in four 
  14574.                      groups of up to three characters each (for example, 
  14575.                      123.123.123.123). 
  14576.  
  14577.         c. If you selected NetBEUI as the network protocol and the selected 
  14578.            network adapter supports locally administered addressee, the Locally 
  14579.            Administered Address will be enabled. This is a 13-character field 
  14580.            that contains a locally administered network adapter address. The 
  14581.            first character must be either an I for IEEE standard notation 
  14582.            Ethernet address format, or T for IBM Token Ring Network format. The 
  14583.            remaining 12 characters must be hexidecimal. 
  14584.  
  14585.    6. Select the IP Address page. 
  14586.  
  14587.         a. You must select Configure TCP/IP if you want to perform TCP/IP 
  14588.            configuration. All other entries are disabled until you select this 
  14589.            check box. 
  14590.  
  14591.         b. In the Client address box, select Manual for manual addressing, or 
  14592.            select Automatic using DHCP for automatic addressing using dynamic 
  14593.            host configuration protocol. 
  14594.  
  14595.                If you select Manual, all entry fields are enabled. Host name 
  14596.                 is optional; all other fields are required. 
  14597.  
  14598.                If you select Automatic, using DHCP: 
  14599.  
  14600.                 Optionally select Also using DDNS, dynamic domain name service, 
  14601.                 if you want DDNS in addition to DHCP. 
  14602.  
  14603.                 When Automatic using DHCP is selected, and Also using DDNS is 
  14604.                 checked, Host Name and Domain name are required; all other 
  14605.                 fields are disabled. If Automatic using DHCP is selected, but 
  14606.                 Also using DDNS is unchecked, then all the fields are disabled. 
  14607.  
  14608.         c. Complete the Host name field. The host name can contain up to 32 
  14609.            alphanumeric characters. 
  14610.  
  14611.         d. Complete the Domain name field. The domain name can contain up to 40 
  14612.            alphanumeric characters. 
  14613.  
  14614.         e. Complete the IP address field by entering the client's IP address. 
  14615.            The IP address can contain up to 12 numeric characters in four 
  14616.            groups containing up to three characters each (for example, 
  14617.            123.123.123.123). 
  14618.  
  14619.         f. Complete the Router field by entering the IP address of the router. 
  14620.  
  14621.         g. Complete the Name server field by entering the IP address of the 
  14622.            Name server. 
  14623.  
  14624.         h. Complete the Subnet mask field. 
  14625.  
  14626.  Select Set to save the changes and close the notebook. 
  14627.  
  14628.  
  14629. ΓòÉΓòÉΓòÉ 19.1.1.2. OS/2 or DOS Client ΓòÉΓòÉΓòÉ
  14630.  
  14631. To create or change an OS/2 or DOS client: 
  14632.  
  14633.    1. Drag a copy of the Remote IPL Requesters template to an open area in the 
  14634.       folder. 
  14635.  
  14636.       The Remote IPL Requester notebook is displayed. 
  14637.  
  14638.    2. On the Identity page, select either  Enable DOS client or Enable OS/2 
  14639.       client. 
  14640.  
  14641.       Note:  You must enable one of these clients before you can define or 
  14642.              update any of the fields. 
  14643.  
  14644.       You can disable a client without deleting it and then enable it at any 
  14645.       time. Select or clear the Disable requester check box. If the client is 
  14646.       currently running, disabling does not take effect until the next time the 
  14647.       requester is started. 
  14648.  
  14649.    3. Complete the fields on the Identity page. For the network adapter 
  14650.       address, refer to the documentation that came with the adapter to 
  14651.       determine the adapter number. 
  14652.  
  14653.       Note:  You must specify a universally administered address in this field. 
  14654.              Do not specify a locally administered address. 
  14655.  
  14656.    4. Select the  Parameters tab. 
  14657.  
  14658.       The Parameters page is displayed. 
  14659.  
  14660.    5. Select a server record identifier. 
  14661.  
  14662.    6. For a DOS remote IPL client definition, select an image ID from the 
  14663.       drop-down list. If no IDs are listed, cancel the notebook and create an 
  14664.       image. Several sample image definition files are shipped with the server. 
  14665.       You can use one of these as a template for creating your image file. See 
  14666.       Understanding Image Definition Files for more information on this. 
  14667.  
  14668.       Note:  The diskette size and density information is not relevant in this 
  14669.              situation. For example, STD3HHMA can be used in a client 
  14670.              definition to remote IPL a client with the DOS 6 operating system, 
  14671.              even if the client does not have a 3.5-inch high-density drive. 
  14672.  
  14673.    7. For an OS/2 remote IPL client definition, select a remote IPL startup 
  14674.       drive. 
  14675.  
  14676.       The remote IPL startup drive ID must be a letter from C through Z. If 
  14677.       drive C is selected, and the remote IPL client has a local C drive, the 
  14678.       local drive is automatically reassigned to the D drive. However, the 
  14679.       startup drive ID should not duplicate any other drive letter installed on 
  14680.       the remote IPL client local hard-disk drive. 
  14681.  
  14682.    8. Select  Create. 
  14683.  
  14684.    9. After waiting several minutes to allow the NetLogon service to update the 
  14685.       access control profiles on any additional servers, restart the Remote IPL 
  14686.       service on each additional server. To restart the service, type the 
  14687.       following command at an OS/2 command prompt on each additional server: 
  14688.  
  14689.             NET START REMOTEBOOT
  14690.  
  14691.  
  14692. ΓòÉΓòÉΓòÉ 19.1.2. Deleting a RIPL Client ΓòÉΓòÉΓòÉ
  14693.  
  14694. To delete a client in WorkSpace On-Demand, OS/2, or DOS: 
  14695.  
  14696.    1. Select the requester object you want to delete 
  14697.  
  14698.    2. Press the right mouse button to display the menu, and select Delete from 
  14699.       the menu. 
  14700.  
  14701.       A confirmation window is displayed 
  14702.  
  14703.    3. Select Delete or Cancel 
  14704.  
  14705.  
  14706. ΓòÉΓòÉΓòÉ 19.2. Customizing DOS Remote IPL Workstations ΓòÉΓòÉΓòÉ
  14707.  
  14708. The following information describes how to customize DOS remote IPL workstation 
  14709. features required by a more advanced user of remote IPL for DOS clients. 
  14710.  
  14711. For more information, see the following topics: 
  14712.  
  14713.      Understanding Image Definition Files 
  14714.  
  14715.      Creating a DOS Image from Diskette 
  14716.  
  14717.      Creating a DOS Image from a Definition File 
  14718.  
  14719.      Making a DOS Image on a Diskette 
  14720.  
  14721.      Default Image Definition Files 
  14722.  
  14723.      Sample DOS Remote IPL Data Files 
  14724.  
  14725.      Updating Image Definition File Entries 
  14726.  
  14727.      Upgrading DOS LAN Services IPL Images 
  14728.  
  14729.      Using Custom Startup .BAT Files 
  14730.  
  14731.      Using Custom NETWORK.INI Files 
  14732.  
  14733.      Receiving Messages at a DOS Remote IPL Workstation 
  14734.  
  14735.  
  14736. ΓòÉΓòÉΓòÉ 19.2.1. Creating a DOS Image from Diskette ΓòÉΓòÉΓòÉ
  14737.  
  14738. Use the following steps to create a DOS image from diskette. 
  14739.  
  14740.  To create a DOS image from diskette: 
  14741.  
  14742.    1. Insert the diskette in the local diskette drive. 
  14743.  
  14744.    2. On a DOS remote IPL server, open  LAN Server Administration. 
  14745.  
  14746.    3. Open  Local Workstation. 
  14747.  
  14748.    4. With mouse button 2, select  Diskette image source. 
  14749.  
  14750.    5. From the pop-up menu, select  Make image. 
  14751.  
  14752.       The Make Image from Diskette window is displayed. 
  14753.  
  14754.    6. Type the image name. 
  14755.  
  14756.    7. Select the target server, which is the server where you want the image 
  14757.       created. 
  14758.  
  14759.    8. Select the source drive, which is the local diskette drive. 
  14760.  
  14761.    9. Select  OK. 
  14762.  
  14763.       OS/2 Warp Server or LAN Server copies the image to the target server. 
  14764.  
  14765.  Note:  You can also perform this task from the command line using the MAKEIMG 
  14766.         utility. 
  14767.  
  14768.  
  14769. ΓòÉΓòÉΓòÉ 19.2.2. Creating a DOS Image from a Definition File ΓòÉΓòÉΓòÉ
  14770.  
  14771. If DOS Remote IPL Support is installed, you can also create images from image 
  14772. definition files. (Install DOS Remote IPL Support using the OS/2 Warp Server or 
  14773. LAN Server installation/configuration program. Refer to Quick Beginnings for 
  14774. more information.) 
  14775.  
  14776. After DOS Remote IPL Support has been installed, you can create an image from a 
  14777. definition file. 
  14778.  
  14779.  To create an image from a definition file: 
  14780.  
  14781.    1. Open  LAN Server Administration. 
  14782.  
  14783.    2. Open the appropriate domain object. 
  14784.  
  14785.    3. Open  Defined Servers. 
  14786.  
  14787.    4. Open the appropriate remote IPL server object. 
  14788.  
  14789.    5. Open  DOS Image Definitions. 
  14790.  
  14791.       The DOS Image Definitions folder is displayed.  It contains one object 
  14792.       for each image definition that exists on the server. 
  14793.  
  14794.    6. With mouse button 2, select the definition object from which you want to 
  14795.       make a DOS image. 
  14796.  
  14797.       Note:  The standard image definition files specify the diskette size and 
  14798.              density information.  For example, STD3HHMA can create a DOS image 
  14799.              only on a workstation with a 3.5-inch high-density drive. 
  14800.              However, an image created from the STD3HHMA image definition file 
  14801.              can be used to remote IPL a client even if it does not have a 
  14802.              3.5-inch high-density drive. 
  14803.  
  14804.    7. From the pop-up menu, select the arrow to the right of  Make imageTo 
  14805.       server. 
  14806.  
  14807.    8. Select the name of the target server, which is the server where you want 
  14808.       the image created. 
  14809.  
  14810.    9. Select  OK. 
  14811.  
  14812.       The image is created and saved in the\IBMLAN\DCDB\IMAGES directory on the 
  14813.       target server. 
  14814.  
  14815.  Note:  The target server you specify creates the image.  Therefore, the 
  14816.         required IPL Image Support must be installed at the destination server. 
  14817.  
  14818.  
  14819. ΓòÉΓòÉΓòÉ 19.2.3. Making a DOS Image on a Diskette ΓòÉΓòÉΓòÉ
  14820.  
  14821. If you are logged on to a server, you can use a default .DEF file to make a DOS 
  14822. image on a diskette. However, if you are logged on to a client, you must first 
  14823. replace the  ? in the default .DEF file with \\ servername. The  servername is 
  14824. the name of a remote IPL server in your domain. 
  14825.  
  14826.  To make an image on a diskette: 
  14827.  
  14828. DBCS Note  In the following step, use the DOS 6.3/V system to prepare a system 
  14829.            diskette. 
  14830.  
  14831.    1. Use the DOS 6.1 or higher operating system to prepare a system diskette. 
  14832.       (Use the DOS FORMAT command with the /S option.) You must use a version 
  14833.       of the DOS operating system that is the same as the version of DOS 
  14834.       installed for DOS remote IPL on the selected program server where the 
  14835.       image was created. 
  14836.  
  14837.    2. Open  LAN Server Administration. 
  14838.  
  14839.    3. Open the appropriate domain object. 
  14840.  
  14841.    4. Open  Defined Servers. 
  14842.  
  14843.    5. Open the appropriate remote IPL server object. 
  14844.  
  14845.    6. Open  DOS Image Definitions. 
  14846.  
  14847.       The DOS Image Definitions folder is displayed. 
  14848.  
  14849.    7. With mouse button 2, select the definition object that you want to make 
  14850.       to diskette. 
  14851.  
  14852.    8. From the pop-up window, select the arrow to the right of Make imageTo 
  14853.       diskette. 
  14854.  
  14855.    9. Complete the fields on this window. 
  14856.  
  14857.   10. Ensure that the diskette you formatted in step 1 is inserted in the 
  14858.       target drive. 
  14859.  
  14860.   11. Select  OK. 
  14861.  
  14862.       The DOS image is created on the diskette. 
  14863.  
  14864.  
  14865. ΓòÉΓòÉΓòÉ 19.2.4. Default Image Definition Files ΓòÉΓòÉΓòÉ
  14866.  
  14867. The following list names the standard definition files, with the diskette image 
  14868. for each. Each file creates a diskette image from files stored on the server's 
  14869. hard disk. This file produces an image including the minimum files required to 
  14870. connect a workstation to a program server. 
  14871.  
  14872.  STD3HBAS.DEF        3.5-inch 1.44MB image with basic redirector 
  14873.  
  14874.  STD3HFUL.DEF        3.5-inch 1.44MB image with full redirector 
  14875.  
  14876.  STD3LPRD.DEF        3.5-inch 1.44MB image with protect mode redirector 
  14877.  
  14878.  STD3HHMA.DEF        3.5-inch 1.44MB image with full redirector and high memory 
  14879.                      (HIMEM) support 
  14880.  
  14881.  STD3HUMB.DEF        3.5-inch 1.44MB image with full redirector and 
  14882.                      upper-memory block (UMB) support 
  14883.  
  14884.  STD3LBAS.DEF        3.5-inch 720KB image with basic redirector 
  14885.  
  14886.  STD3LFUL.DEF        3.5-inch 720KB image with full redirector 
  14887.  
  14888.  STD3HPRD.DEF        3.5-inch 720KB image with protect mode redirector 
  14889.  
  14890.  STD3LHMA.DEF        3.5-inch 720KB image with full redirector and high-memory 
  14891.                      support 
  14892.  
  14893.  STD3LUMB.DEF        3.5inch 720KB image with full redirector and upper-memory 
  14894.                      block support 
  14895.  
  14896.  STD5HBAS.DEF        5.25-inch 1.2MB image with basic redirector 
  14897.  
  14898.  STD5HFUL.DEF        5.25-inch 1.2MB image with full redirector 
  14899.  
  14900.  STD3HPRD.DEF        5.25-inch 1.2MB image with protect mode redirector 
  14901.  
  14902.  STD5HHMA.DEF        5.25-inch 1.2MB image with full redirector and high-memory 
  14903.                      support 
  14904.  
  14905.  STD5HUMB.DEF        5.25-inch 1.2MB image with full redirector and 
  14906.                      upper-memory block support 
  14907.  
  14908.  
  14909. ΓòÉΓòÉΓòÉ 19.2.5. Using Custom Startup .BAT Files ΓòÉΓòÉΓòÉ
  14910.  
  14911. Each remote IPL workstation can have a different startup sequence by using 
  14912. different .BAT files. You can provide custom startup .BAT files by using any of 
  14913. the following methods: 
  14914.  
  14915.      Including different .BAT files in the individual diskette images accessed 
  14916.       by different remote IPL workstations 
  14917.  
  14918.      Using the parameter substitution mechanism in a diskette image accessed 
  14919.       by different remote IPL workstations 
  14920.  
  14921.      Using the parameter substitution mechanism to run different .BAT files 
  14922.       (external to the diskette image) from the AUTOEXEC.BAT file.  In this 
  14923.       way, different .BAT files can be run from a single diskette image. 
  14924.   The remote IPL feature has a parameter substitution mechanism.  This 
  14925.  mechanism allows parameter values specified in the client definition section 
  14926.  of the RPL.MAP file to be included in commands as part of any file in a 
  14927.  diskette image (for example, CONFIG.SYS or AUTOEXEC.BAT). 
  14928.  
  14929.  The following sample AUTOEXEC.BAT file illustrates remote IPL parameter 
  14930.  substitution: 
  14931.  
  14932.  DBCS Note  The following example is based on a U.S. English system. 
  14933.  
  14934.   NET START RDR~~~~~~~2~~~~~~~6 /RPL
  14935.   NET LOGON * */DOM:~~~~~~~6
  14936.   NET USE D:\\~~~~~~~5\IBMLAN$:
  14937.  
  14938.   SET CURIMAGE = ~~~~~~~4
  14939.  
  14940.  Variables consisting of tilde characters ( ~) with a hexadecimal digit specify 
  14941.  which parameter values come from the remote IPL workstation's entry in the 
  14942.  RPL.MAP file. The variables must include at least 5 tilde characters to 
  14943.  trigger the substitution mechanism. The number of tilde characters plus the 
  14944.  digit must be greater than or equal to the total number of characters in the 
  14945.  substituted parameter. 
  14946.  
  14947.  The hexadecimal digit following the tilde string denotes the field number from 
  14948.  which the parameter value comes. 
  14949.  
  14950.  The /RPL parameter specifies that this client is a remote IPL client rather 
  14951.  than a client started from its hard disk. 
  14952.  
  14953.  For example, the first command in the previous AUTOEXEC.BAT file example (NET 
  14954.  START RDR) has the following meaning: 
  14955.  
  14956.      Start the DOS LAN Services redirector function using the remote IPL 
  14957.      workstation's network name as specified in field 2 of the RPL.MAP entry 
  14958.      for that remote IPL workstation.  (The maximum expected size of the 
  14959.      redirector name is 15 characters.) 
  14960.  
  14961.  This command becomes: 
  14962.  
  14963.   NET START
  14964.   if REQ001 is the name specified in field 2 and DOMAIN1 is the name specified 
  14965.  in field 6 of the RPL.MAP entry for the remote IPL workstation. 
  14966.  
  14967.  The second command in AUTOEXEC.BAT becomes: 
  14968.  
  14969.   NET LOGON * * /DOM:DOMAIN1
  14970.   if DOMAIN1 is the name specified in field 6 of the RPL.MAP entry for the 
  14971.  remote IPL workstation. This command provides an opportunity to logon to 
  14972.  domain DOMAIN1 by prompting the user for a user ID and password. 
  14973.  
  14974.  Similarly, the third command in AUTOEXEC.BAT becomes: 
  14975.  
  14976.   NET USE D: \\SRV0\IBMLAN$
  14977.   if SRV0 is the name specified in field 5 of the RPL.MAP entry for the remote 
  14978.  IPL workstation. 
  14979.  
  14980.  Notes: 
  14981.  
  14982.    1. All copies of .BAT files used from remote clients must have their 
  14983.       read-only attribute set or must reside in a directory with access control 
  14984.       profile permissions of RX (read, execute) defined for it. 
  14985.  
  14986.       Similarly, all programs run from such .BAT files must also be read-only 
  14987.       or must reside in a directory with access control profile permissions of 
  14988.       RX (read, execute) defined for it. Failure to meet either of these two 
  14989.       criteria causes the DOS operating system to signal a sharing violation if 
  14990.       more than one remote IPL workstation tries accessing the same file 
  14991.       concurrently. 
  14992.  
  14993.    2. Each remote IPL workstation entry in the RPL.MAP file can include up to 
  14994.       15 fields.  Fields E and F are not used by the default remote IPL 
  14995.       configuration. They can be used for parameter substitution by specifying 
  14996.       the correct hexadecimal digit in the substitution variable. 
  14997.  
  14998.  
  14999. ΓòÉΓòÉΓòÉ 19.2.6. Using Custom NETWORK.INI Files ΓòÉΓòÉΓòÉ
  15000.  
  15001. You can create customized NETWORK.INI configuration files for your DOS Remote 
  15002. IPL clients. Unlike other files, you cannot specify a customized NETWORK.INI 
  15003. file to use during startup in an image definition file. This is because the 
  15004. Remote IPL service installs a default NETWORK.INI file for clients upon initial 
  15005. startup. Additional steps to replace the default NETWORK.INI file with the 
  15006. custom NETWORK.INI file are required after rebooting the workstation. 
  15007.  
  15008. The following steps allow DOS Remote IPL client workstations to access a 
  15009. customized NETWORK.INI file. 
  15010.  
  15011.  To create access to customized NETWORK.INI files: 
  15012.  
  15013.    1. Copy the customized NETWORK.INI file onto the\IBMLAN\DOSLAN\NET 
  15014.       subdirectory of the Remote IPL server. 
  15015.  
  15016.    2. Remote IPL to start the client workstation.  This creates a connection to 
  15017.       the server subdirectory\IBMLAN\DOSLAN\NET using the Z: drive. 
  15018.  
  15019.    3. Copy the custom NETWORK.INI file from the server onto the client's Y: 
  15020.       drive by using the COPY command. The following example assumes the client 
  15021.       machine name is SIMPSON. The commands are issued at the client 
  15022.       workstation: 
  15023.  
  15024.         a. Type  Y: and press Enter. 
  15025.  
  15026.         b. Type  CD SIMPSON to change to the directory for SIMPSON located on 
  15027.            the server and press Enter. 
  15028.  
  15029.         c. Type the following command to copy the custom NETWORK.INI file into 
  15030.            the SIMPSON directory: 
  15031.  
  15032.                       COPY Z:\IBMLAN\DOSLAN\NET\custom.ini NETWORK.INI
  15033.             where  custom.ini is the name of the customized NETWORK.INI file. 
  15034.  
  15035.  After the file is copied to the DOS client, the customized NETWORK.INI file is 
  15036.  used to start the workstation instead of the default file. 
  15037.  
  15038.  
  15039. ΓòÉΓòÉΓòÉ 19.2.7. Receiving Messages at a DOS Remote IPL Workstation ΓòÉΓòÉΓòÉ
  15040.  
  15041. Use the following instructions to create an image that allows a remote IPL 
  15042. workstation to receive messages. 
  15043.  
  15044.  To create an image definition file for DOS remote IPL workstations receiving 
  15045. messages: 
  15046.  
  15047.    1. Create a new .DEF file by copying an existing file. 
  15048.  
  15049.    2. Modify the copy of the .DEF file as follows: 
  15050.  
  15051.         a. The file will contain one of the following entries: 
  15052.  
  15053.                ?\IBMLAN\DOSLAN\NET\FULL_NET.INI 
  15054.  
  15055.                ?\IBMLAN\DOSLAN\NET\BASICNET.INI 
  15056.  
  15057.                ?\IBMLAN\DOSLAN\NET\PRDR_NET.INI  Change the entry in your file 
  15058.            to: 
  15059.  
  15060.                       ?\IBMLAN\DOSLAN\NET\xxxxxNET.INI
  15061.             where  xxxxx is the name of the new .INI file. 
  15062.  
  15063.            Note:  Remember the original file name (FULL_NET.INI, PRDR_NET.INI, 
  15064.                   or BASICNET.INI) because you use it later in this procedure. 
  15065.  
  15066.         b. Add the following entry to the .DEF file: 
  15067.  
  15068.                       ?\IBMLAN\DOSLAN\NET\MESSENGR.EXE
  15069.  
  15070.            Note:  To add the Message Pop-Up feature, add another entry: 
  15071.  
  15072.                                     ?\IBMLAN\DOSLAN\NET\NETPOPUP.EXE
  15073.  
  15074.    3. Copy the .INI file (either FULL_NET.INI, PRDR_NET.INI, or BASICNET.INI) 
  15075.       that was listed in your original .DEF file to the xxxxxNET.INI file, 
  15076.       where  xxxxxNET.INI is the file name that you specified in the new .DEF 
  15077.       file. 
  15078.  
  15079.    4. Add  messenger to the autostart parameter in the  xxxxxNET.INI file. 
  15080.  
  15081.       Note:  To start the Message Pop-Up feature, add netpopup to the autostart 
  15082.              parameter in the xxxxxNET.INI file.  For example, type: 
  15083.  
  15084.                           autostart=full messenger netpopup
  15085.  
  15086.    5. To create a message log file, add the following entry to the xxxxxNET.INI 
  15087.       file: 
  15088.  
  15089.             logfile=d:\filename
  15090.        where  d is a local (nonredirected) drive to the xxxxxNET.INI file and 
  15091.       filename is the file name and extension for the message log file. You 
  15092.       cannot log messages to a remote drive. 
  15093.  
  15094.  
  15095. ΓòÉΓòÉΓòÉ 19.3. Customizing OS/2 Remote IPL Workstations ΓòÉΓòÉΓòÉ
  15096.  
  15097. Each OS/2 remote IPL workstation has its own CONFIG.SYS, PROTOCOL.INI, and 
  15098. IBMLAN.INI files, but it uses a central copy of the OS/2 operating system and 
  15099. OS/2 LAN Requester software.  (DOS remote IPL workstations use a central copy 
  15100. of the DOS operating system and DOS LAN Services initialization files.) 
  15101.  
  15102. The following information describes other modifications you need to make to the 
  15103. CONFIG.SYS and  machineid.FIT files. 
  15104.  
  15105. If you want these changes to apply to all the remote IPL clients, make the 
  15106. changes to the default files before you create the remote IPL clients.  The 
  15107. default files are: 
  15108.  
  15109. \IBMLAN\RPL\FITS\DEFALT20.FIT
  15110. \IBMLAN\RPL\MACHINES\DEFALT30\CONFIG.DEF
  15111. \IBMLAN\RPL\MACHINES\DEFALT40\CONFIG.DEF
  15112. \IBMLAN\RPL\IBMCOM\adaptertype\OS2\PROTOCOL.INI
  15113.  The  adaptertype parameter is based on the type of network as follows: 
  15114.  
  15115. DBCS Note  PCNET and PCNETA in the following list do not apply to DBCS systems. 
  15116.  
  15117.   Value               Network
  15118.  
  15119.  3C0XPCI             3Com Fast EtherLink/EtherLink XL Family OS/2 
  15120.  
  15121.  ELNK16              3Com EtherLink 16 (3c507) Family - OS/2 
  15122.  
  15123.  ELNK3               3Com EtherLink III (3c509) Family - OS/2 
  15124.  
  15125.  ELNK II             3Com EtherLink II (3c503) Family - OS/2 
  15126.  
  15127.  ELNKMC              3Com EtherLink/MC (3c523) Family - OS/2 
  15128.  
  15129.  ETHERJ10            IBM 100/10 EtherJet PCI Adapter (OS/2) 
  15130.  
  15131.  ETHERJET            IBM EtherJet ISA Ethernet Adapter (IBMEINDI.OS2) 
  15132.  
  15133.  ETHERNET            IBM PS/2 Adapter for Ethernet Networks 
  15134.  
  15135.  ETHILAE             IBM LAN Adapter/A for Ethernet (IBMENII.OS2) 
  15136.  
  15137.  ETHILAEI            IBM LAN Adapter/A for Ethernet (IBMENI.OS2) 
  15138.  
  15139.  ETHIPS2I            IBM PS/2 Adapter for BNC/UTP Ethernet Networks 
  15140.  
  15141.  IBM_CLA             Crystal LAN CS8900/CS8920 Ethernet Adapter 
  15142.  
  15143.  IBM_E100            Intel 10/100 Ethernet 
  15144.  
  15145.  MADGE               Madge FastMac OS/2 NDIS driver for Smart 16/4 Ringnodes 
  15146.  
  15147.  SMCTOK              SMC TokenCard elite for OS/2 (SMC 8115) 
  15148.  
  15149.  TOKENRING           IBM T-R Shared RAM Family (UP/SMP, IBMTOK.OS2) 
  15150.  
  15151.  TOKENTRP            IBM PCI Token-Ring Adapter (IBMTRP.OS2) 
  15152.  
  15153.  TOKN1641            IBM Token Ring Network 16/4 Adapter II (IBM16TR.OS2) 
  15154.  
  15155.  TOKNLS32            IBM LANStreamer 16/32 MCA Adapter (IBMMPC.OS2) 
  15156.  
  15157.  WDPLUS              SMC Ethernet ISA Adapter Family (SMC8000.OS2) 
  15158.  
  15159.  Note:  Before modifying the default files, create a backup copy. 
  15160.  
  15161.  For more information, see the following topics: 
  15162.  
  15163.      Using a Model to Create Remote IPL Workstations 
  15164.  
  15165.      Specifying Mouse Types 
  15166.  
  15167.      Installing Printer Drivers 
  15168.  
  15169.      Updating Master OS/2 OS2.INI Files 
  15170.  
  15171.      Other CONFIG.SYS Options 
  15172.  
  15173.  
  15174. ΓòÉΓòÉΓòÉ 19.3.1. Using a Model to Create Remote IPL Workstations ΓòÉΓòÉΓòÉ
  15175.  
  15176. When creating OS/2 remote IPL client definitions, you can create a typical 
  15177. definition that can be used as a model when defining other workstations. 
  15178. Modeling allows you to customize OS/2 remote IPL client definitions for a 
  15179. specific group of similar workstations.  The necessary changes are made only 
  15180. once to the model definition.  After the changes to the model files are 
  15181. complete, you can create new remote IPL client definitions that contain these 
  15182. changes.  Modeling can also be used to customize the CONFIG.SYS file, the 
  15183. PROTOCOL.INI file,  machineid.FIT file, the OS2.INI file, and other files for 
  15184. remote IPL workstations. 
  15185.  
  15186. To illustrate how modeling works, assume that you have a group of remote IPL 
  15187. workstations with XGA displays.  Because the IBM-supplied default definition 
  15188. assumes a VGA display, you can create a model definition for an XGA client and 
  15189. then use it to create remote IPL definitions for other workstations with XGA 
  15190. displays.  The following example illustrates the modeling procedure. 
  15191.  
  15192.  To create a model remote IPL client definition: 
  15193.  
  15194.    1. Create an OS/2 remote IPL client definition, for example, XGAMODEL, using 
  15195.       the procedures in  Creating, Changing, or Deleting a Remote IPL Client. 
  15196.  
  15197.    2. Use the RPLSETD utility to configure the XGAMODEL workstation for XGA 
  15198.       support. 
  15199.  
  15200.             RPLSETD /C:XGAMODEL /D:IBMXGA32
  15201.  
  15202.       See RPLSETD.CMD REXX Procedure for more information. 
  15203.  
  15204.    3. Start the remote IPL model client. 
  15205.  
  15206.    4. Customize the desktop. 
  15207.  
  15208.    5. Shut down the remote IPL model client to set the new configuration. 
  15209.  
  15210.    To create a remote IPL client definition using the model definition for an 
  15211.  XGA display: 
  15212.  
  15213.    1. Open  LAN Server Administration. 
  15214.  
  15215.    2. Open the appropriate domain object. 
  15216.  
  15217.    3. Open  Defined Servers. 
  15218.  
  15219.    4. Open the appropriate server object. 
  15220.  
  15221.    5. Open  Remote IPL Clients. 
  15222.  
  15223.    6. Select the  XGAMODEL object. 
  15224.  
  15225.    7. Press mouse button 2, and select  Create another. 
  15226.  
  15227.       The Remote IPL Client notebook is displayed. 
  15228.  
  15229.    8. Modify the fields on the Identity page as necessary: 
  15230.  
  15231.         a. In the  Machine ID field, type the name of the remote IPL client. 
  15232.            Replace the model name with the workstation name. 
  15233.  
  15234.         b. For the network adapter address, use the value you got in step 1 or 
  15235.            refer to the documentation that came with the adapter to determine 
  15236.            the adapter number. The 12-digit hexadecimal address is displayed 
  15237.            when the client is turned on.  This address is preceded by  AA on 
  15238.            the display. 
  15239.  
  15240.            Note:  You must specify a universally administered address in this 
  15241.                   field. Do not specify a locally administered address. 
  15242.  
  15243.    9. Select  Create. 
  15244.  
  15245.       The new OS/2 remote IPL workstation is created using the same CONFIG.SYS 
  15246.       and FIT files that were customized for the model XGAMODEL client 
  15247.       definition. 
  15248.  
  15249.   10. After waiting several minutes to allow the NetLogon service time to 
  15250.       update the access control profiles on any additional servers, restart the 
  15251.       Remote IPL service on each additional server. To restart the service, 
  15252.       type the following command at an OS/2 command prompt on each additional 
  15253.       server: 
  15254.  
  15255.             NET START REMOTEBOOT
  15256.  
  15257.  Notes: 
  15258.  
  15259.    1. Because some files are locked by the OS/2 program when the system is 
  15260.       running, the client being used as a model must not be active. 
  15261.  
  15262.    2. Systems with remote IPL client definitions based on the same model must 
  15263.       have the same type of network adapter. 
  15264.  
  15265.  
  15266. ΓòÉΓòÉΓòÉ 19.3.2. Specifying Mouse Types ΓòÉΓòÉΓòÉ
  15267.  
  15268. By default, remote IPL workstations assume that a PS/2 mouse is connected to 
  15269. the pointing device port.  If a client is using a different mouse, modify 
  15270. \IBMLAN\RPL\MACHINES\ clientname\CONFIG.SYS and make the following updates. 
  15271.  
  15272.  To specify a different mouse type: 
  15273.  
  15274.    1. Add the appropriate device-dependent driver statement before the 
  15275.       DEVICE=Z:\OS2\MOUSE.SYS statement.  For example: 
  15276.  
  15277.             DEVICE=Z:\OS2\PCLOGIC$ SERIAL=COM1
  15278.  
  15279.    2. Update the DEVICE=Z:\OS2\MOUSE.SYS statement and add the TYPE parameter. 
  15280.       For example: 
  15281.  
  15282.             DEVICE=Z:\OS2\MOUSE.SYS TYPE=PCLOGIC$
  15283.  
  15284.  
  15285. ΓòÉΓòÉΓòÉ 19.3.3. Installing Printer Drivers ΓòÉΓòÉΓòÉ
  15286.  
  15287. Use the next procedure to install a printer driver. 
  15288.  
  15289.  To install a new printer driver on an OS/2 remote IPL workstation: 
  15290.  
  15291. Replace the default path in the Install New Printer Driver window from A:\ to 
  15292. C:\OS2\DLL\ xxxx, where xxxx is one of the following directories: 
  15293.  
  15294. DBCS Note  The following example is based on a U.S. English system. 
  15295.  
  15296.  Directory Name      Printer Device Drivers 
  15297.  
  15298.  EPSON               Epson, Panasonic, and Hewlett Packard drivers 
  15299.  
  15300.  HP\PCL\LASERJET     Laserjet drivers for Epson, Hewlett Packard, IBM, Kyocera, 
  15301.                      and Panasonic 
  15302.  
  15303.  IBM4019             IBM 4019 drivers 
  15304.  
  15305.  IBM42XX             IBM 2380, 2381, 2390, 2391, 4201, 4202, 4207, 4208, 4224, 
  15306.                      and 4226 drivers 
  15307.  
  15308.  IBM52012            IBM 52012 driver 
  15309.  
  15310.  IBM52XX             IBM 3816, 5202, and 5204 drivers 
  15311.  
  15312.  IBMNULL             IBM Null driver 
  15313.  
  15314.  PLOTTERS            IBM and Hewlett Packard plotter drivers 
  15315.  
  15316.  PMPLOTPD            PMPLOTQPR driver 
  15317.  
  15318.  PSCRIPT             IBM, Apple, and Hewlett Packard drivers 
  15319.  
  15320.  SMGXPJET            Paintjet* drivers 
  15321.  
  15322.  See the OS/2 Desktop Guide for more information on installing a new printer 
  15323.  driver. 
  15324.  
  15325.  
  15326. ΓòÉΓòÉΓòÉ 19.3.4. Updating Master OS/2 OS2.INI Files ΓòÉΓòÉΓòÉ
  15327.  
  15328. Some users have a customized master OS2.INI file that is copied to the client 
  15329. directory each time the client is started with remote IPL. This master file 
  15330. must also be updated to identify the type of display driver that the client 
  15331. workstation is using.  Clients with different display types (such as VGA, XGA, 
  15332. 8514) MUST use different master OS2.INI files. 
  15333.  
  15334. To update a master OS2.INI file, enter the following command: 
  15335.  
  15336. RPLRXUTL  /D:DISPLAY_DRIVER /C:INI_FILENAME
  15337.  where: 
  15338.  
  15339.  D:DISPLAY_DRIVER    The same as for the RPLSETD command. 
  15340.  
  15341.  C:INI_FILENAME      The drive, path, and filename of the master OS2.INI file 
  15342.                      to be updated. 
  15343.  
  15344.  For example: 
  15345.  
  15346.   RPLRXUTL /D:IBMVGA32 /C:E:\IBMLAN\RPL\MASTER\VGAOS2.INI
  15347.  
  15348.  The RPLRXUTL utility does not display error information, but does display a 
  15349.  non-zero return code if an error occurs. If you need to verify error 
  15350.  information, start RPLRXUTL from a CMD procedure (batch file or REXX) so that 
  15351.  the return code can be tested. 
  15352.  
  15353.  
  15354. ΓòÉΓòÉΓòÉ 19.3.5. Other CONFIG.SYS Options ΓòÉΓòÉΓòÉ
  15355.  
  15356. To improve system performance, reorder the LIBPATH statement, the DPATH 
  15357. statement, and the PATH statement in the CONFIG.SYS file to list the 
  15358. directories from most frequently used to least frequently used. If the client 
  15359. has a hard disk, delete REM from the beginning of the DISKCACHE statement in 
  15360. the CONFIG.SYS file. 
  15361.  
  15362.  
  15363. ΓòÉΓòÉΓòÉ 19.4. OS/2 SVGA Support for Remote IPL Clients ΓòÉΓòÉΓòÉ
  15364.  
  15365. Limited SVGA support is provided for OS/2 Warp 3.0 and 4.0 remote IPL clients. 
  15366.  
  15367. The SVGA support has the following prerequisites: 
  15368.  
  15369.      OS/2 REXX support. 
  15370.  
  15371.      IBM PS/ValuePoint machines used as remote IPL clients must be at BIOS 
  15372.       level L6ET53A or later. 
  15373.  
  15374.  Note:  Only SVGA video drivers provided with the base operating system are 
  15375.         supported in the remote IPL environment.  Other SVGA video drivers, for 
  15376.         example, drivers found on an electronic bulletin board service (BBS), 
  15377.         are not supported for remote IPL. 
  15378.  
  15379.  For more information, see the following topics: 
  15380.  
  15381.      Installing OS/2 SVGA Support on the Remote IPL Server 
  15382.  
  15383.      Configuring a Remote IPL Server/Client for OS/2 SVGA Video Support 
  15384.  
  15385.  
  15386. ΓòÉΓòÉΓòÉ 19.4.1. Installing OS/2 SVGA Support on the Remote IPL Server ΓòÉΓòÉΓòÉ
  15387.  
  15388.  To install OS/2 SVGA support on the remote IPL server: 
  15389.  
  15390.    1. Run the  RPLSVGAI.CMD REXX Procedure for each OS/2 version that is 
  15391.       installed in the remote IPL directory tree.  RPLSVGAI can determine from 
  15392.       Display Driver diskette 1 which OS/2 version is being updated. 
  15393.  
  15394.       If diskettes are used as the source, RPLSVGAI prompts you for the 
  15395.       appropriate OS/2 Display Driver diskettes.  The OS/2 Warp Display Driver 
  15396.       diskettes are in XDF diskette format.  The remote IPL server must support 
  15397.       the XDF format before RPLSVGAI can be used to install the OS/2 Warp SVGA 
  15398.       support files. 
  15399.  
  15400.    2. Start the server and log on as an administrator. 
  15401.  
  15402.    3. Run GETRPL. 
  15403.  
  15404.        GETRPL creates the access control profiles for these directories.  If 
  15405.       you are running 386 HPFS, you do not need to do this step. 
  15406.  
  15407.  
  15408. ΓòÉΓòÉΓòÉ 19.4.2. Configuring a Remote IPL Server/Client for OS/2 SVGA Video Support ΓòÉΓòÉΓòÉ
  15409.  
  15410. Configuring a remote IPL client for SVGA video support is a two step process. 
  15411. First, the remote IPL client definition on the remote IPL server must be 
  15412. updated.  Second, the remote IPL client must use the appropriate OS/2 install 
  15413. function to install the SVGA support.  The following sections provide step by 
  15414. step instructions for these two functions. 
  15415.  
  15416. For more information, see the following topics: 
  15417.  
  15418.      Creating a Remote IPL Client Definition for OS/2 SVGA Support 
  15419.  
  15420.      Installing OS/2 SVGA Support on the Remote IPL Client 
  15421.  
  15422.  
  15423. ΓòÉΓòÉΓòÉ 19.4.2.1. Creating a Remote IPL Client Definition for OS/2 SVGA Support ΓòÉΓòÉΓòÉ
  15424.  
  15425. Perform the following procedure at the remote IPL server. 
  15426.  
  15427.  To create a Remote IPL client definition for OS/2 SVGA support: 
  15428.  
  15429.    1. Create an OS/2 remote IPL client. 
  15430.  
  15431.    2. Use RPLSETD to reconfigure the client to allow SVGA support. 
  15432.  
  15433.  For example, to configure a ISA bus machine called MACH01, use the following 
  15434.  command: 
  15435.  
  15436.   RPLSETD /C:MACH01  /D:SVGA  /B:ISA
  15437.   For a description of the RPLSETD options, see RPLSETD.CMD REXX Procedure. 
  15438.  
  15439.  When the /D:SVGA or S3SVGA option is specified, the RPLSETD utility does not 
  15440.  configure the client for SVGA.  It modifies the client definition so that the 
  15441.  remote IPL client can run the OS/2 Selective Install program. 
  15442.  
  15443.  Notes: 
  15444.  
  15445.    1. SVGA support requires that each remote IPL client have a unique copy of 
  15446.       several display-related files.  Ensure that there is enough free space on 
  15447.       the hard disk where \IBMLAN\RPLUSER is installed to allow each SVGA 
  15448.       workstation to have a copies of the display files in addition to the 
  15449.       normal hard disk requirements for a remote IPL client. 
  15450.  
  15451.    2. Configuring a workstation for SVGA moves the workstations CONFIG.SYS file 
  15452.       from the \IBMLAN\RPL\MACHINES\client directory to the 
  15453.       \IBMLAN\RPLUSER\client directory.  The workstation has write access to 
  15454.       this file and could potentially modify it in such a fashion that the 
  15455.       workstation could no longer be IPLed remotely. 
  15456.  
  15457.  
  15458. ΓòÉΓòÉΓòÉ 19.4.2.2. Installing OS/2 SVGA Support on the Remote IPL Client ΓòÉΓòÉΓòÉ
  15459.  
  15460. Perform the following procedure on the remote IPL client. 
  15461.  
  15462.  To install OS/2 SVGA support on the remote IPL client: 
  15463.  
  15464.    1. Start the remote IPL client. 
  15465.  
  15466.    2. Open  System Setup. 
  15467.  
  15468.    3. Select  Selective Install. 
  15469.  
  15470.    4. Select  Primary Display, and then select  OK. 
  15471.  
  15472.       The Primary Display Adapter Type window is displayed. The detected SVGA 
  15473.       adapter is highlighted. 
  15474.  
  15475.    5. Select  OK. 
  15476.  
  15477.       The Monitor Configuration/Selection Utility window is displayed. 
  15478.  
  15479.    6. Select  Install Using Defaults for Monitor Type and then select  OK. 
  15480.  
  15481.       The screen appears blank for a few seconds, and then either a Screen 
  15482.       Resolution Selection window or the Source Directory window is displayed. 
  15483.  
  15484.    7. If the Screen Resolution Selection window is displayed, select the 
  15485.       appropriate resolution. 
  15486.  
  15487.    8. The Source Directory window is displayed.  Ensure that the default source 
  15488.       ( d:\OS2\DISP where  d: is the boot drive) is highlighted. 
  15489.  
  15490.       Select  Install. 
  15491.  
  15492.       The selected video support is installed.  Depending on the video adapter, 
  15493.       you might be prompted for additional information such as the desired 
  15494.       display resolution. 
  15495.  
  15496.       For OS/2 Warp, a window is displayed requesting the Microsoft Windows 3.1 
  15497.       diskettes.  Change the  Source field to be d:\OS2\DISP where d: is the 
  15498.       boot drive (default is Z:).  Use this same source path for any additional 
  15499.       Windows diskettes requested. 
  15500.  
  15501.       A Display Driver Install information window is displayed indicating that 
  15502.       shutdown is required before the changes become effective. 
  15503.  
  15504.    9. If non-S3 SVGA support was installed, shut down the system and restart 
  15505.       it.  If you were not prompted to select a display resolution during the 
  15506.       install (step 6), continue with the following steps after the system 
  15507.       restarts. 
  15508.  
  15509.       If S3 SVGA support was installed, continue with the following steps. 
  15510.  
  15511.   10. Open  System Setup. 
  15512.  
  15513.   11. Open  System. 
  15514.  
  15515.       The System Properties notebook is displayed. 
  15516.  
  15517.   12. Select the desired display resolution. 
  15518.  
  15519.   13. Depending on the video adapter installed, the Screen page might have a 
  15520.       Page 2 that allows you to configure a specific display for your 
  15521.       workstation. 
  15522.  
  15523.   14. Shut down and restart the system to use the new display support. 
  15524.  
  15525.  
  15526. ΓòÉΓòÉΓòÉ 19.5. Remote IPL REXX Procedures ΓòÉΓòÉΓòÉ
  15527.  
  15528. The following sections provide information relating to changes in REXX 
  15529. procedures that are used by remote IPL.  For more information about these and 
  15530. other utilities, see the Command Reference. 
  15531.  
  15532. For more information, see the following topics: 
  15533.  
  15534.      RPLSETD.CMD REXX Procedure 
  15535.  
  15536.      RPLSVGAI.CMD REXX Procedure 
  15537.  
  15538.  
  15539. ΓòÉΓòÉΓòÉ 19.5.1. RPLSETD.CMD REXX Procedure ΓòÉΓòÉΓòÉ
  15540.  
  15541. The RPLSETD.CMD procedure provides the following functions: 
  15542.  
  15543.      Upgrades existing remote IPL clients to use the appropriate video device 
  15544.       driver.  RPLSETD determines the version of the target OS/2 and 
  15545.       automatically select the appropriate video device driver. 
  15546.  
  15547.      Updates a remote IPL client to perform an IPL on a different version of 
  15548.       OS/2. The OS/2 code must be installed in the remote IPL directory 
  15549.       structure. 
  15550.  
  15551.      Updates a remote IPL client to change the bus type, as in MCA or 
  15552.       ISA/PCI/EISA. 
  15553.  
  15554.      Updates a remote IPL client to specify whether the swap path and WIN-OS/2 
  15555.       paging file is on a local hard disk or on the remote IPL server. 
  15556.  
  15557.      Updates an OS/2 Warp 4 remote IPL client to support TCP/IP. 
  15558.  
  15559.  
  15560. ΓòÉΓòÉΓòÉ 19.5.1.1. Using a RPLSETD Response File ΓòÉΓòÉΓòÉ
  15561.  
  15562. To use the response file option, do the following: 
  15563.  
  15564.    1. Create an ASCII file that contains the appropriate keyword values. 
  15565.  
  15566.       The valid response file entries/keywords are: 
  15567.  
  15568.             ; Comment line
  15569.             [GROUP]  (this statement is optional for the first group
  15570.                      and required for all subsequent groups)
  15571.             DISPLAYDRIVER=
  15572.             CLIENT=
  15573.             CLIENTLIST=
  15574.             CURRENTOS2DIR=
  15575.             NEWOS2DIR=
  15576.             BUSTYPE=
  15577.             SWAPTARGET=
  15578.             TCPIP
  15579.  
  15580.       A ; (semicolon) in column 1 indicates the line is a comment. 
  15581.  
  15582.       Leading blanks are allowed on keyword statements. 
  15583.  
  15584.       The keywords are defined in the Command Reference syntax description. 
  15585.  
  15586.       [GROUP] designates the start of a remote IPL client or group of clients 
  15587.       that share the same configuration characteristics.  When the [GROUP] 
  15588.       statement is encountered, the client machine(s) in the previous group are 
  15589.       updated according to the specified keyword(s). Multiple [GROUP]s can 
  15590.       appear in the response file.  This allows a single response file to 
  15591.       process a number of different configurations.  The [GROUP] statement is 
  15592.       optional for the first group in the response file but is required for all 
  15593.       subsequent groups. 
  15594.  
  15595.       CLIENT and CLIENTLIST are equivalent and multiple entries can be 
  15596.       specified on either.  Multiple CLIENT and CLIENTLIST keywords can be 
  15597.       specified per group.  Only one of each of the other keywords is allowed 
  15598.       per group. 
  15599.  
  15600.    2. Type the following command: 
  15601.  
  15602.             RPLSETD /R:d:\path\response_filename
  15603.  
  15604.       where  d:\ path\ response_filename is the fully qualified file name of 
  15605.       the response file. 
  15606.  
  15607.  Example: 
  15608.  
  15609.   [GROUP]              (optional)
  15610.   ; Update existing clients to support the IBMXGA32 display
  15611.   ; driver, switch from OS2.20 to OS2.30, support the MCA bus,
  15612.   ; and put the swap path on a local hard disk.
  15613.   CLIENT=DEFALT20
  15614.   CLIENT=MACH001,MACH002
  15615.   CLIENTLIST=MACH003,MACH004
  15616.   DISPLAYDRIVER=IBMXGA32
  15617.   CURRENTOS2DIR=OS2.20
  15618.   NEWOS2DIR=OS2.30
  15619.   BUSTYPE=MCA
  15620.   SWAPTARGET=L
  15621.  
  15622.   [GROUP]               (required)
  15623.   ; Update client for ISA bus and put the swap path on the remote IPL
  15624.   ; server (no local hard disk). Enable TCPIP support
  15625.   CLIENT=MACH005
  15626.   BUSTYPE=ISA
  15627.   SWAPTARGET=S
  15628.   TCPIP
  15629.  
  15630.  
  15631. ΓòÉΓòÉΓòÉ 19.5.2. RPLSVGAI.CMD REXX Procedure ΓòÉΓòÉΓòÉ
  15632.  
  15633. Before a remote IPL client can be configured for SVGA support, additional OS/2 
  15634. SVGA support files must be installed. A special utility, RPLSVGAI.CMD, is 
  15635. provided to install this support. 
  15636.  
  15637. The syntax for RPLSVGAI.CMD is: 
  15638.  
  15639. RPLSVGAI  [/S:sourcepath]  [/L:logfile]
  15640.  
  15641.      where  sourcepath specifies where to look for the SVGA support files. 
  15642.       The default is A:\.  However, it can be any of the following: 
  15643.  
  15644.         -  A diskette drive, for example, A:\ 
  15645.  
  15646.         -  The root directory of an OS/2 Warp diskette image tree created by 
  15647.            the OS/2 SEIMAGE.EXE utility, for example, C:\CID\OS2WARP3 or 
  15648.            C:\CID\OS2WARP4. 
  15649.  
  15650.         -  The root directory of an OS/2 Warp diskette image tree on the OS/2 
  15651.            Warp Server CD-ROM; for example,  d:\OS2IMAGE. 
  15652.  
  15653.      where  logfile specifies a fully qualified file name to be used to log 
  15654.       any error messages. 
  15655.  
  15656.  RPLSVGAI must be run for each OS/2 version (OS /2 Warp 3.0 or 4.0) that is 
  15657.  installed in the remote IPL directory tree. RPLSVGAI can determine from 
  15658.  Display Driver diskette 1 which OS/2 version is being updated. 
  15659.  
  15660.  If diskettes are used as the source, RPLSVGAI prompts you for the appropriate 
  15661.  OS/2 Display Driver diskettes.  The Warp Display Driver diskettes are in XDF 
  15662.  diskette format. The remote IPL server must be updated to support the XDF 
  15663.  format before RPLSVGAI can be used to install the OS/2 Warp SVGA support 
  15664.  files. 
  15665.  
  15666.  
  15667. ΓòÉΓòÉΓòÉ 20. The Uninterruptible Power Supply Service ΓòÉΓòÉΓòÉ
  15668.  
  15669. An uninterruptible power supply (UPS) is a battery connected to a server that 
  15670. keeps the server running during an electrical power failure. If power to the 
  15671. server is interrupted, this battery keeps the server running until either the 
  15672. UPS service can manage a safe shutdown or until an administrator stops the 
  15673. server. 
  15674.  
  15675. The UPS battery must be connected to a serial port for the UPS service to 
  15676. provide automatic shutdown.  See the battery manufacturer's instructions for 
  15677. information about how to install the UPS. 
  15678.  
  15679. For more information, see the following topics: 
  15680.  
  15681.      Using the UPS Service 
  15682.  
  15683.      Configuring the UPS Service 
  15684.  
  15685.  
  15686. ΓòÉΓòÉΓòÉ 20.1. Using the UPS Service ΓòÉΓòÉΓòÉ
  15687.  
  15688. During a power failure, the UPS service immediately pauses the Server service 
  15689. to prevent any new connections. It then sends out an alert that a power failure 
  15690. has occurred.  The UPS service waits an interval of time specified by the 
  15691. messdelay parameter in the UPS section of the IBMLAN.INI file. If power is 
  15692. restored during this interval, another alert is sent, informing the 
  15693. administrator that power has been restored. 
  15694.  
  15695. Note:  The Messenger service and Network Message utility must be running for 
  15696.        UPS-based alerts to be displayed as soon as they are sent.  If these 
  15697.        services are not started, you are not alerted to power failures at the 
  15698.        server. 
  15699.  
  15700.  If power is not restored during the interval specified by the messdelay 
  15701.  parameter, the UPS service warns users who have sessions with the server to 
  15702.  end their sessions and displays a message at the server advising that all 
  15703.  sessions will be closed. 
  15704.  
  15705.  The UPS service notifies users and administrators that a shutdown is imminent. 
  15706.  The service repeats this alert at intervals specified by the messtime 
  15707.  parameter in the UPS section of the IBMLAN.INI file. These alerts continue 
  15708.  until power is restored, the server receives a low-battery signal from the 
  15709.  battery (which means the battery is about to run out of power), or until the 
  15710.  battery timer expires. 
  15711.  
  15712.  If power is restored, all users are sent an alert that power is restored, and 
  15713.  normal operations are resumed. 
  15714.  
  15715.  If the server receives a low-battery message while the power is satisfactory, 
  15716.  the UPS service responds as specified by the lowbattery parameter.  If the 
  15717.  server receives a low-battery signal while the power is not available, or if 
  15718.  the battery timer expires, the UPS service does the following (see  Flowchart 
  15719.  of UPS Running with No Electricity and a Good Battery): 
  15720.  
  15721.    1. Informs all users of the server of the impending server shutdown 
  15722.  
  15723.    2. Stops all OS/2 Warp Server or LAN Server network services 
  15724.  
  15725.    3. Closes the file system 
  15726.  
  15727.  Before the UPS service stops the server and client, OS/2 Warp Server or LAN 
  15728.  Server uses the  cmdtimer parameter to determine the time in which to run a 
  15729.  .CMD batch program. For example, you can set up a .CMD batch program to close 
  15730.  any open application files. The .CMD path and file are specified by the 
  15731.  cmdfile parameter in the UPS section of IBMLAN.INI. 
  15732.  
  15733.  
  15734. ΓòÉΓòÉΓòÉ 20.2. Configuring the UPS Service ΓòÉΓòÉΓòÉ
  15735.  
  15736. If a server has a UPS battery installed, make the UPS service one of the 
  15737. services that starts automatically with the Server service. This way, the UPS 
  15738. service is running if there is a power failure at the server. For information 
  15739. about installing and configuring the UPS service, see the Command Reference . 
  15740.  
  15741. All time intervals and options that the UPS service uses are configurable. 
  15742. These options are listed in the following table. See the Command Reference for 
  15743. information on how to start the UPS service from the OS/2 command line. 
  15744.  
  15745. Note:  The configuration options for the UPS service are contained in the UPS 
  15746.        section of the IBMLAN.INI file. 
  15747.  
  15748.   Option              Description
  15749.  
  15750.  batterymsg          Specifies the interval of time used to repeat alerts for a 
  15751.                      low battery condition. This parameter is valid only when 
  15752.                      the  lowbattery parameter is set to either WARNING or 
  15753.                      SHUTDOWN and a low battery signal is received while the AC 
  15754.                      line current is still satisfactory. The range is from 30 
  15755.                      seconds to 3600 seconds. The default is 600 seconds. 
  15756.  
  15757.  batterytime         Specifies the number of seconds the server can run on a 
  15758.                      battery before the UPS service initiates shutdown.  Use 
  15759.                      this optional entry only if no low-battery signal is 
  15760.                      available.  The range is 0 to 28800. The default is 60 
  15761.                      seconds. 
  15762.  
  15763.  cmdfile             Specifies a .CMD batch program of commands to be run 
  15764.                      before the server shuts down.  The path name can be either 
  15765.                      absolute or relative to the OS/2 Warp Server or LAN Server 
  15766.                      directory (IBMLAN). 
  15767.  
  15768.  cmdtimer            Specifies the number of seconds the UPS service gives the 
  15769.                      .CMD file to complete processing. The range is 0 to 600 
  15770.                      seconds. The default is 30 seconds. If the .CMD file does 
  15771.                      not finish execution within the specified number of 
  15772.                      seconds, an error is logged. 
  15773.  
  15774.  devicename          Specifies the name of the device for the server to open. 
  15775.                      This entry must be set to UPS_DEV. 
  15776.  
  15777.  lowbattery          Specifies the response by the UPS service if the UPS 
  15778.                      signals that its battery power is low but the AC line 
  15779.                      current is satisfactory. If this parameter is set to 
  15780.                      WARNING, the UPS service generates repeated warnings 
  15781.                      (using the time interval set by the batterymsg parameter) 
  15782.                      to alert recipients, identifying the affected server. If 
  15783.                      this parameter is set to SHUTDOWN, the UPS services shuts 
  15784.                      down the affected server after warning the server's local 
  15785.                      users and alerting users who have active sessions with the 
  15786.                      server. For both WARNING and SHUTDOWN, the event is 
  15787.                      recorded in the error log. If the  lowbattery parameter is 
  15788.                      set to DISABLE, the event is recorded in the error log and 
  15789.                      no alert is generated. The default is WARNING. 
  15790.  
  15791.  messdelay           Specifies the number of seconds between initial power 
  15792.                      failure and the first message sent to users.  No messages 
  15793.                      are sent if power is restored within this interval. The 
  15794.                      range is 0 to 120.  The default is 5 seconds. 
  15795.  
  15796.  messtime            Specifies the number of seconds between messages sent to 
  15797.                      users notifying them of a power failure.  The range is 30 
  15798.                      to 300. The default is 120 seconds. 
  15799.  
  15800.  recharge            Specifies the number of minutes of recharge time required 
  15801.                      for each minute of battery run time. This optional entry 
  15802.                      is used only if no low-battery signal is available. The 
  15803.                      range is 5 to 250 minutes. The default is 100 minutes. 
  15804.  
  15805.  signals             Specifies the signals available from the battery.  The 
  15806.                      value is a 3-digit binary number.  For information about 
  15807.                      the signals the battery sends and receives, see the manual 
  15808.                      supplied with the battery. 
  15809.  
  15810.                          The first digit is either 1 if the battery can signal 
  15811.                           the UPS service upon power failure or 0 if it cannot. 
  15812.                           The default is 1. 
  15813.  
  15814.                          The second digit is either 1 if the battery can 
  15815.                           signal the UPS service of a low battery condition 
  15816.                           (usually 2 minutes of power remaining) or 0 if it 
  15817.                           cannot. The default is 0. 
  15818.  
  15819.                          The third digit is either 1 if the battery can accept 
  15820.                           a shutoff signal from the UPS service or 0 if it 
  15821.                           cannot.  The default is 0. If the third digit is 1, 
  15822.                           the UPS service conducts an orderly shutdown of the 
  15823.                           OS/2 Warp Server or LAN Server software, and the 
  15824.                           battery stops providing backup power. When the 
  15825.                           battery detects power restoration, it restarts the 
  15826.                           workstation. 
  15827.  
  15828.                      Note:  If neither of the first two digits of  signals is 
  15829.                             set to 1, the UPS service does not start. 
  15830.  
  15831.  voltlevels          Specifies the voltage levels for the signals listed in the 
  15832.                      signals option.  The value is a 3-digit binary number. For 
  15833.                      information about signal voltage, see the manual supplied 
  15834.                      with the battery. 
  15835.  
  15836.                          The first digit is either 0 if the battery uses 
  15837.                           negative voltage or 1 if it uses positive voltage to 
  15838.                           signal the UPS service of a power failure. The 
  15839.                           default is 1. 
  15840.  
  15841.                          The second digit is either 0 if the battery uses 
  15842.                           negative voltage or 1 if it uses positive voltage to 
  15843.                           signal the UPS service that there is less than 2 
  15844.                           minutes of power remaining.  The default is 0. 
  15845.  
  15846.                          The third digit is either 0 if the battery recognizes 
  15847.                           negative voltage as the shutoff signal or 1 if it 
  15848.                           recognizes positive voltage as the shutoff signal. 
  15849.                           The default is 0. 
  15850.  
  15851.                      Note:  If the low battery voltage level is not set 
  15852.                             correctly, the UPS service does not start. 
  15853.  
  15854.   For more information, see the following topics: 
  15855.  
  15856.      Configuring the UPS Device Driver 
  15857.  
  15858.      UPS Scenarios 
  15859.  
  15860.  
  15861. ΓòÉΓòÉΓòÉ 20.2.1. Configuring the UPS Device Driver ΓòÉΓòÉΓòÉ
  15862.  
  15863. The UPS device driver communicates with the UPS through a serial port.  The 
  15864. OS/2 Warp Server or LAN Server installation and configuration program sets the 
  15865. PORT parameter of the device driver to either COM1 or COM2.  The device driver 
  15866. can be further configured if those ports are not available. 
  15867.  
  15868. The CONFIG.SYS statement can be changed as follows: 
  15869.  
  15870. device=path>\netprog\upsdrv.os2/IOADDR:xxxx /IRQ:x/PORT:COMx
  15871.  
  15872. where: 
  15873.  
  15874.  path                Specifies the drive and path to the installed IBMLAN tree. 
  15875.  
  15876.  /IOADDR: xxxx       Specifies the port address of the serial device.  This 
  15877.                      number can be 1 to 4 hexadecimal digits.  For this value, 
  15878.                      refer to the documentation for the serial device. 
  15879.  
  15880.  /IRQ: x             Specifies the interrupt level associated with the serial 
  15881.                      device.  This number must be 1 hexadecimal digit.  For 
  15882.                      this value, refer to the documentation for the serial 
  15883.                      device. 
  15884.  
  15885.  /PORT:COM x         Specifies the number of the serial port.  The value for x 
  15886.                      must be either 1 or 2. 
  15887.  
  15888.  Note:  You must specify the IOADDR and IRQ parameters together.  You cannot 
  15889.         use this combination with the PORT parameters. 
  15890.  
  15891.  The following example installs the UPS device driver on a machine equipped 
  15892.  with a dual-async adapter: 
  15893.  
  15894.   device=d:\ibmlan\netprog\upsdrv.os2 /IOADDR:3220 /IRQ:3
  15895.  
  15896.  Hardware diagnostics indicates that the second port of the adapter uses 
  15897.  interrupt level 3 and I/O address 3220.  The UPS device is attached to the 
  15898.  port, and OS/2 Warp Server or LAN Server is installed on drive D. 
  15899.  
  15900.  
  15901. ΓòÉΓòÉΓòÉ 20.2.2. UPS Scenarios ΓòÉΓòÉΓòÉ
  15902.  
  15903. Figures  Flowchart of UPS Running with No Electricity and a Good Battery and 
  15904. Flowchart of UPS Running with Electricity but a Low Battery During Startup show 
  15905. two possible scenarios for the UPS service. 
  15906.  
  15907.  
  15908. Flowchart of UPS Running with No Electricity and a Good Battery
  15909.  
  15910. Note:  Flowchart of UPS Running with Electricity but a Low Battery During 
  15911.        Startup assumes that the  lowbattery parameter is set to SHUTDOWN. If 
  15912.        lowbattery is set to WARNING, then alerts are generated, but the UPS 
  15913.        service does not shut down the server. 
  15914.  
  15915.  
  15916.   Flowchart of UPS Running with Electricity but a Low Battery During Startup
  15917.  
  15918.  Note: 
  15919.  
  15920.    1. If your UPS unit provides low-battery signaling, the batterytime 
  15921.       parameter is not used.  If your UPS unit does not provide low-battery 
  15922.       signaling, ensure that digit 2 of the signals parameters is set to 0, 
  15923.       which activates the batterytime parameter.  The signals parameter is set 
  15924.       to 100 by default. 
  15925.  
  15926.    2. To set the correct  recharge parameter value for your particular UPS 
  15927.       unit, refer to the manufacturer's documentation accompanying your UPS 
  15928.       unit. 
  15929.  
  15930.    3. The UPS service works with contact closure-type UPS devices.  However, 
  15931.       voltage-sensing serial devices, such as the RS-232, must detect voltage 
  15932.       transitions (from positive to negative and negative to positive) on the 
  15933.       serial port pins to function correctly.  Ensure that the UPS cable that 
  15934.       you are using is capable of correctly signalling this type of port. 
  15935.  
  15936.  
  15937. ΓòÉΓòÉΓòÉ 21. Directory Structure ΓòÉΓòÉΓòÉ
  15938.  
  15939. This appendix lists the contents for the following directories: 
  15940.  
  15941.      MUGLIB (for UPM) 
  15942.  
  15943.      Requester IBMLAN 
  15944.  
  15945.      Server IBMLAN 
  15946.  
  15947.      Server IBMLAN with remote IPL 
  15948.  
  15949.      Domain control database (\IBMLAN\DCDB) 
  15950.  
  15951.  Notes: 
  15952.  
  15953.    1. For information on the IBMCOM directory (for LAN Adapter and Protocol 
  15954.       Support), see the MPTS Configuration Guide. 
  15955.  
  15956.    2. The IBM386FS directory is in the root directory of the boot drive.  It 
  15957.       contains the 386 HPFS files and the Fault Tolerance files. 
  15958.  
  15959.  For more information, see the following topics: 
  15960.  
  15961.      MUGLIB Directory Contents 
  15962.  
  15963.      Requester IBMLAN Directory Contents 
  15964.  
  15965.      Server IBMLAN Directory Contents 
  15966.  
  15967.      Server IBMLAN Directory Contents for Remote IPL 
  15968.  
  15969.      Domain Control Database Directory Contents 
  15970.  
  15971.  
  15972. ΓòÉΓòÉΓòÉ 21.1. MUGLIB Directory Contents ΓòÉΓòÉΓòÉ
  15973.  
  15974. Below is a list of the subdirectories of a server's MUGLIB directory.  MUGLIB 
  15975. is also used for OS/2 Warp Server or LAN Server UPM support. 
  15976.  
  15977.   Subdirectory        Contents
  15978.  
  15979.  \DLL                Network dynamic link libraries (all .DLL files) 
  15980.  
  15981.  \ACCOUNTS           UPM files 
  15982.  
  15983.  Note:  If OS/2 Warp Server or LAN Server is not already installed on the 
  15984.         server, the installation program copies the NET.ACC file from 
  15985.         \MUGLIB\ACCOUNTS (if it exists) to \IBMLAN\ACCOUNTS. If the NET.ACC 
  15986.         file does not exist, the default file on the OS/2 Warp Server or LAN 
  15987.         Server installation diskette is copied to \IBMLAN\ACCOUNTS. 
  15988.  
  15989.  
  15990. ΓòÉΓòÉΓòÉ 21.2. Requester IBMLAN Directory Contents ΓòÉΓòÉΓòÉ
  15991.  
  15992. The following are the subdirectories of a requester's IBMLAN directory. 
  15993.  
  15994.   Subdirectory        Contents
  15995.  
  15996.  IBMLAN.INI          OS/2 configuration parameters for this requester 
  15997.  
  15998.  \BACKUP             Backup of existing configuration files 
  15999.  
  16000.  \INSTALL            Installation/configuration program 
  16001.  
  16002.  \BOOK               Online publications 
  16003.  
  16004.  \NETLIB             Network dynamic link libraries 
  16005.  
  16006.  \NETPROG            Network programs and user interface modules 
  16007.  
  16008.  \SERVICES           Network services available on the requester 
  16009.  
  16010.  \LOGS               Error log and message log 
  16011.  
  16012.  \ACCOUNTS           User Profile Management files 
  16013.  
  16014.  \NETSRC\H           API header files 
  16015.  
  16016.  \NETSRC\LIB         API libraries 
  16017.  
  16018.  \REPL               Empty at installation 
  16019.  
  16020.  \REPL\IMPORT        Default import path for the Replicator service (empty at 
  16021.                      installation) 
  16022.  
  16023.  Note:  Deleting the MESSAGES.LOG file in the \LOGS subdirectory without first 
  16024.         stopping the Messenger service causes the message log file to stop 
  16025.         accepting new entries.  To avoid this loss of entries,first stop the 
  16026.         Messenger service temporarily with the commandNET LOG /OFF . After 
  16027.         deleting the message log file, resume the service by typingNET LOG /ON 
  16028.         . 
  16029.  
  16030.  
  16031. ΓòÉΓòÉΓòÉ 21.3. Server IBMLAN Directory Contents ΓòÉΓòÉΓòÉ
  16032.  
  16033. Below is a list of the subdirectories of a server's IBMLAN directory. 
  16034.  
  16035. DBCS Note  In the following list, the contents of the\DOSLAN\DOS subdirectory 
  16036.            is the code for versions 5.0, 5.0\V, and 6.x \V of the DOS operating 
  16037.            system (optional). 
  16038.  
  16039.   Subdirectory        Contents
  16040.  
  16041.  IBMLAN.INI          Configuration parameters for this server 
  16042.  
  16043.  \INSTALL            Installation/configuration program 
  16044.  
  16045.  \BOOK               Online publications 
  16046.  
  16047.  \NETLIB             Network dynamic link libraries 
  16048.  
  16049.  \NETPROG            Network programs and user interface modules 
  16050.  
  16051.  \SERVICES           Network services on the server 
  16052.  
  16053.  \LOGS               Error logs, message log, audit trail log, and FTADMIN log 
  16054.  
  16055.  \ACCOUNTS           User Profile Management files 
  16056.  
  16057.  \ACCOUNTS\USERDIRS  Logon information (empty at installation) 
  16058.  
  16059.  \ACCOUNTS \USERDIRS\SCRIPTS Logon information (empty at installation) 
  16060.  
  16061.  \NETSRC\H           API header files 
  16062.  
  16063.  \NETSRC\LIB         API libraries 
  16064.  
  16065.  \USERS              Users' home directories. These subdirectories are not 
  16066.                      automatically deleted when the associated user ID is 
  16067.                      deleted. 
  16068.  
  16069.  \REPL               Empty at installation 
  16070.  
  16071.  \REPL\EXPORT        Default export path for the Replicator service (empty at 
  16072.                      installation) 
  16073.  
  16074.  \REPL\IMPORT        Default import path for the Replicator service (empty at 
  16075.                      installation) 
  16076.  
  16077.  \REPL\IMPORT \SCRIPTS Default directory used by NetLogon services 
  16078.  
  16079.  \DOSLAN             DOS LAN Services code (optional) 
  16080.  
  16081.  \DOSLAN\DOS         DOS versions 3.3, 5.0, 6.x code (optional) 
  16082.  
  16083.  \DOSLAN\NET         DOS LAN Services programs (optional) 
  16084.  
  16085.  \DOSLAN\LSP         LAN Support Program files (optional) 
  16086.  
  16087.  \XPG4               Translation utility for OS/2 Warp Server or LAN Server 
  16088.  
  16089.  \XPG4\LOCALE        Translation support for OS/2 Warp Server or LAN Server 
  16090.  
  16091.  
  16092. ΓòÉΓòÉΓòÉ 21.4. Server IBMLAN Directory Contents for Remote IPL ΓòÉΓòÉΓòÉ
  16093.  
  16094. Below is a list of the subdirectories that are added to the server's IBMLAN 
  16095. directory if remote IPL is installed. 
  16096.  
  16097.   Subdirectory        Contents
  16098.  
  16099.  \RPL                Main remote IPL directory 
  16100.  
  16101.  \RPL\FITS           File index tables (FIT) for OS/2, DOS, and WorkSpace 
  16102.                      On-Demand remote IPL workstations.  Default FIT files are 
  16103.                      located here. 
  16104.  
  16105.  \RPL\DOS            DOS remote IPL programs and loader 
  16106.  
  16107.  \DCDB\IMAGES        DOS image files for DOS remote IPL workstations, image DEF 
  16108.                      files of domain controller 
  16109.  
  16110.  \RPL\IBMCOM         Subset of IBMCOM directory that OS/2 remote IPL 
  16111.                      workstations use, which contains CONFIG.SYS and 
  16112.                      PROTOCOL.INI files 
  16113.  
  16114.  \RPL\IBMLAN         Subset of IBMLAN directory that OS/2 remote IPL 
  16115.                      workstations use 
  16116.  
  16117.  \PROFILES           SRVAUTO.PRO, which defines the shares used by OS/2 and DOS 
  16118.                      Remote IPL 
  16119.  
  16120.  \RPL\OS2.30         OS/2 3.0 installed code for remote IPL workstations 
  16121.  
  16122.  \RPL\OS/2.40        OS/2 4.0 installed code for remote IPL workstations 
  16123.  
  16124.  \RPL\BB10.[COUNTRY] Installed code for WorkSpace On-Demand 1.0 
  16125.  
  16126.  \RPL\BB20.[COUNTRY] Installed code for WorkSpace On-Demand 2.0 
  16127.  
  16128.  \RPL\MACHINES       Workstation directories containing workstation-specific 
  16129.                      files, including configuration files (read-only files) 
  16130.  
  16131.  \RPL \MACHINES\DEFALT20 IBMLAN.INI and other files for default users for OS/2; 
  16132.                      2.0 
  16133.  
  16134.  \RPL \MACHINES\DEFALT21 IBMLAN.INI and other files for default users for OS/2; 
  16135.                      2.1 
  16136.  
  16137.  \RPL\MUGLIB         User Profile Management (UPM) programs for all remote IPL 
  16138.                      workstations 
  16139.  
  16140.  \RPLUSER            User-specific remote IPL directory for all remote IPL 
  16141.                      workstations 
  16142.  
  16143.  \RPLUSER\DEFALT xx  User-specific writable OS/2 Warp Server, LAN Server, LAN 
  16144.                      Adapter and Protocol Support, and OS/2 files for the 
  16145.                      default user 
  16146.  
  16147.  
  16148. ΓòÉΓòÉΓòÉ 21.5. Domain Control Database Directory Contents ΓòÉΓòÉΓòÉ
  16149.  
  16150. The domain control database exists in directory IBMLAN\DCDB on the domain 
  16151. controller.  Below are the subdirectories of IBMLAN\DCDB. 
  16152.  
  16153.   Subdirectory        Contents
  16154.  
  16155.  \DATA               DCDB and access control profiles 
  16156.  
  16157.  \FILES              .CMD or .BAT files for external files resources 
  16158.  
  16159.  \DEVICES            .CMD or .BAT files for external serial device resources 
  16160.  
  16161.  \PRINTERS           .CMD or .BAT files for external printer resources 
  16162.  
  16163.  \APPS               .CMD or .BAT files to start applications 
  16164.  
  16165.  \IMAGES             .IMG (image) and .DEF (image definition) files 
  16166.  
  16167.  \LISTS              DOS LAN Services list files 
  16168.  
  16169.  \USERS\ userid      User profiles (for example, \USER1, \USER2 \USERn). Each 
  16170.                      user profile contains the following: 
  16171.  
  16172.                      For a user at an OS/2 requester: 
  16173.  
  16174.                          USER.A - Lists the user's private applications 
  16175.  
  16176.                          USER.S - Lists what is displayed on the user's Public 
  16177.                           and Private Applications objects 
  16178.  
  16179.                          USER.L - Lists the user's logon assignments 
  16180.  
  16181.                          PROFILE.CMD - Contains commands that run 
  16182.                           automatically when the user logs on. You create this 
  16183.                           optional file. 
  16184.  
  16185.                      For a user at a DOS requester: 
  16186.  
  16187.                          LIST.A - Lists the user's private applications 
  16188.  
  16189.                          LIST.S - Lists what is displayed on the user'sLAN 
  16190.                           server application 
  16191.  
  16192.                          LIST.U - Lists the user's logon assignments 
  16193.  
  16194.                          PROFILE.BAT - Contains commands that run 
  16195.                           automatically when the user logs on.  You create this 
  16196.                           optional file. 
  16197.  
  16198.  
  16199. ΓòÉΓòÉΓòÉ 22. User Profile Management ΓòÉΓòÉΓòÉ
  16200.  
  16201. This appendix discusses how you can manage users and groups throughUser Profile 
  16202. Management as in previous versions of OS/2 Warp Server and LAN Server. In OS/2 
  16203. Warp Server, you can also use LAN Server Administration as described in 
  16204. Managing Users and Groups. 
  16205.  
  16206. You can perform more user and group management functions from the OS/2 Warp 
  16207. Server Administration than you can from theUser Profile Management interface. 
  16208. Some of the functions available only from LAN Server Administration are: 
  16209.  
  16210.      The capability to define up to 16,000 users per domain 
  16211.  
  16212.      User and group ID cloning 
  16213.  
  16214.       Cloning saves time by allowing you to use your mouse to take existing 
  16215.       user and group objects and make clones (copies) that can be renamed and 
  16216.       changed as required. 
  16217.  
  16218.      Drag and drop enablement for logon assignments and for user and group 
  16219.       definitions 
  16220.  
  16221.       You can drag and drop aliases into user and group objects to 
  16222.       automatically create logon assignments.  In addition, you can drag and 
  16223.       drop user accounts into groups or groups into user accounts to 
  16224.       automatically update a user or group definition. 
  16225.  
  16226.      Ability to define home directories for users 
  16227.  
  16228.       You can specify home directories on the server for a user's personal use. 
  16229.  
  16230.      Ability to enforce directory limits on users 
  16231.  
  16232.       You can set size limits on home directories and enforce them so users 
  16233.       cannot exceed them.  Alerts are sent to the users when the space used is 
  16234.       nearing the limit. 
  16235.  
  16236.  After you install OS/2 Warp Server, you must define new users to the network 
  16237.  so they can log on and access network resources. Groups are defined for access 
  16238.  and messaging purposes. This appendix describes how to define and manage users 
  16239.  and groups and how to create guest accounts. 
  16240.  
  16241.  The following tasks for managing users are discussed: 
  16242.  
  16243.      Adding users 
  16244.  
  16245.      Granting and revoking operator privileges 
  16246.  
  16247.      Updating user information 
  16248.  
  16249.      Deleting a user 
  16250.  
  16251.      Creating a Logon profile 
  16252.  
  16253.      Updating Logon assignments 
  16254.  
  16255.      Updating public applications on users' program starters 
  16256.  
  16257.      Assigning a home directory 
  16258.  
  16259.      Setting a user password expiration period for the domain 
  16260.  
  16261.  The following tasks for managing groups are discussed: 
  16262.  
  16263.      Adding a group 
  16264.  
  16265.      Viewing a group 
  16266.  
  16267.      Updating a group 
  16268.  
  16269.      Deleting a group 
  16270.  
  16271.  For more information, see the following topics: 
  16272.  
  16273.      Domain User and Group Definitions 
  16274.  
  16275.      What is User Profile Management? 
  16276.  
  16277.      Managing Users 
  16278.  
  16279.      Managing Groups 
  16280.  
  16281.  
  16282. ΓòÉΓòÉΓòÉ 22.1. Domain User and Group Definitions ΓòÉΓòÉΓòÉ
  16283.  
  16284. OS/2 Warp Server allows the user and group definitions file, created and 
  16285. updated through User Profile Management, to be centralized.  This file is named 
  16286. NET.ACC and is maintained on the domain controller.  Whenever a change is made 
  16287. to the user and group definitions, the NET.ACC file is sent from the domain 
  16288. controller to all servers that are running the NetLogon service in the domain. 
  16289. The NetLogon service allows a server to receive a copy of the user and group 
  16290. definitions file (NET.ACC). 
  16291.  
  16292. LAN Requesters do not get copies of the NET.ACC file changes. Therefore, if 
  16293. user and group definitions are needed locally for an application (such as 
  16294. database manager), users must also be defined on the LAN Requester workstation 
  16295. through User Profile Management for the database manager requirements. 
  16296.  
  16297. When the user and group definitions file is updated, the NET.ACC file is not 
  16298. immediately replicated to the additional servers on the domain. The time it 
  16299. takes to update depends on when the update is made in relation to the value 
  16300. specified with the  pulse parameter in the NetLogon section of the IBMLAN.INI 
  16301. file. This value indicates how often (in seconds) the NET.ACC file is 
  16302. replicated to the additional servers. 
  16303.  
  16304. You can log on to a domain and make changes to user and group definitions from 
  16305. any workstation on the network. The changes are made to the master copy at the 
  16306. domain controller and then sent to all servers that are running the NetLogon 
  16307. service. 
  16308.  
  16309. With OS/2 Warp Server, the user and group definitions file is maintained 
  16310. centrally at thedomain controller.  These definitions are used at each 
  16311. workstation in the domain running OS/2 Warp Server. 
  16312.  
  16313. OS/2 Warp Server also allows users with Accounts operator privilege to manage 
  16314. users.  Accounts operators can create new users, modify user accounts, and 
  16315. manage group definitions.  However, they cannot create or manage administrators 
  16316. or other operators. See  Granting and Revoking Operator Privileges for more 
  16317. information. 
  16318.  
  16319.  
  16320. ΓòÉΓòÉΓòÉ 22.2. What is User Profile Management? ΓòÉΓòÉΓòÉ
  16321.  
  16322. User Profile Management (UPM) is the OS/2 Warp Server or LAN Server component 
  16323. that provides the means of managing users and groups: 
  16324.  
  16325.      User ID validation.  Each installation of User Profile Management is 
  16326.       local to the particular workstation where it is installed and validates 
  16327.       users who access controlled data or use programs that reside on that 
  16328.       particular workstation. 
  16329.  
  16330.      The mechanism for users to log on to the system and log off from the 
  16331.       system and to identify and authenticate system users. 
  16332.  
  16333.  For more information, see the following topics: 
  16334.  
  16335.      User Profile Management Character Sets 
  16336.  
  16337.      National Language Support Restrictions 
  16338.  
  16339.  
  16340. ΓòÉΓòÉΓòÉ 22.2.1. User Profile Management Character Sets ΓòÉΓòÉΓòÉ
  16341.  
  16342. OS/2 Warp Server identifiers defined in User Profile Management are  user IDs, 
  16343. group IDs, and passwords. The maximum length of each identifier is: 
  16344.  
  16345.  user IDs            20 
  16346.  
  16347.  group IDs           20 
  16348.  
  16349.  password            14 
  16350.  
  16351.  domain name         15 
  16352.  
  16353.  machine ID          15 
  16354.  
  16355.  Note:  The following characters are not allowed in these fields through the 
  16356.         UPMACCTS interface: 
  16357.  
  16358.                 " / \ : [ ] | < > + = ; , * ?
  16359.  
  16360.  OS/2 Warp Server uses an  expanded character set, which consists of printable 
  16361.  characters.  (National Language Support users should see National Language 
  16362.  Support Restrictions.) 
  16363.  
  16364.  The following rules apply to the use of the character set: 
  16365.  
  16366.      The minimum number of characters (bytes) for the password depends on the 
  16367.       minpwlen parameter on the NET ACCOUNTS command. However, in OS/2 Warp 
  16368.       Server and IBM Extended Services database manager, all identifiers are 
  16369.       restricted to 8 characters (bytes). 
  16370.  
  16371.      User IDs and group IDs cannot have the following values: 
  16372.  
  16373.         -  USERS 
  16374.  
  16375.         -  LOCAL 
  16376.  
  16377.         -  GUESTS 
  16378.  
  16379.         -  ADMINS 
  16380.  
  16381.         -  PUBLIC 
  16382.  
  16383.         -  RPLGROUP 
  16384.  
  16385.  Notes: 
  16386.  
  16387.    1. IBM Extended Services Communications Manager and database manager 
  16388.       identifiers are restricted to the minimal character set.  Communications 
  16389.       Manager identifiers, however, can be from 1 through 10 bytes if the 
  16390.       UPMCSET command is run with the \E parameter. 
  16391.  
  16392.    2. The logon process may be unable to log on or access resources if the code 
  16393.       page or country code of the system differs from those specified when the 
  16394.       identifier was created.  It is the user's responsibility to make sure the 
  16395.       expanded character set is used only when the code page and country code 
  16396.       of the system are not changed. 
  16397.  
  16398.  
  16399. ΓòÉΓòÉΓòÉ 22.2.2. National Language Support Restrictions ΓòÉΓòÉΓòÉ
  16400.  
  16401. National Language Support (NLS) users at DOS LAN Services may not be able to 
  16402. use all characters included in the User Profile Management expanded character 
  16403. set.  Follow the DOS guidelines for acceptable accented characters except for 
  16404. the following: 
  16405.  
  16406.  COUNTRY or LANGUAGE PERMITTED CHARACTERS 
  16407.  
  16408.  France (FR)         A - Z, 1 - 9, and nonalphabetics 
  16409.  
  16410.  Canadian French (CF) A - Z, 1 - 9, and nonalphabetics 
  16411.  
  16412.  Portugal (PO)       A - Z, 1 - 9, ╨╡, and nonalphabetics 
  16413.  
  16414.  Spain (SP)          A - Z, 1 - 9, ╨╡, ╨É, and nonalphabetics 
  16415.  
  16416.  Latin America (LA)  A - Z, 1 - 9, ╨╡, and nonalphabetics 
  16417.  
  16418.  Japan               A - Z, 1 - 9, nonalphabetics, Kanji, Hiragana, and 
  16419.                      Katakana 
  16420.  
  16421.  Korea               A - Z, 1 - 9, nonalphabetics, Hanja, and Hangeul 
  16422.  
  16423.  Taiwan              A - Z, 1 - 9, nonalphabetics, and Hanzi 
  16424.  
  16425.  
  16426. ΓòÉΓòÉΓòÉ 22.3. Managing Users ΓòÉΓòÉΓòÉ
  16427.  
  16428. For these procedures, you are making changes to the user and group definitions 
  16429. file for the  current domain. You can only complete OS/2 Warp Server user and 
  16430. group tasks that require the User Profile Management, such as giving users 
  16431. logon assignments, in the current domain. To make changes to another domain's 
  16432. user and group definitions file without logging on to that domain, select  Use 
  16433. domain from the User Profile Management Actions pull-down menu and then select 
  16434. the domain to administer.  Your user ID and password must be the same on any 
  16435. domain you select to administer through the  Use domain function. 
  16436.  
  16437. For more information, see the following topic: 
  16438.  
  16439.      Adding a User 
  16440.  
  16441.      Granting and Revoking Operator Privileges 
  16442.  
  16443.      Updating User Information 
  16444.  
  16445.      Deleting a User 
  16446.  
  16447.      Creating a Logon Profile 
  16448.  
  16449.      Updating Logon and Desktop Application Assignments 
  16450.  
  16451.  
  16452. ΓòÉΓòÉΓòÉ 22.3.1. Adding a User ΓòÉΓòÉΓòÉ
  16453.  
  16454. You must add a user to the domain before that user can access the network. You 
  16455. can add approximately 1260 users for each domain.  The actual maximum is 
  16456. determined by the length of the user IDs and comments in the file. If your user 
  16457. IDs are brief and your user comments fields unused, you may be able to add as 
  16458. many as 1800 users to the domain. If you exceed the limit, UPM Services does 
  16459. not display the additional users. You can use the NET USER command to define 
  16460. more than 1800 users on a domain; however, you may not be able to view all of 
  16461. the user definitions through User Profile Management. 
  16462.  
  16463. To add a user: 
  16464.  
  16465.    1. On the desktop, select  User Profile Management Services. 
  16466.  
  16467.    2. Select  User Profile Management from the UPM Services folder. 
  16468.  
  16469.    3. In the User Profile Management-User Profile window, select Manage from 
  16470.       the menu bar. 
  16471.  
  16472.    4. Select  Manage Users from the Manage pull-down menu. 
  16473.  
  16474.    5. The User Profile Management-User Management window lists all users 
  16475.       defined to the current domain. Select  New from this list. 
  16476.  
  16477.    6. Select  Add a new user ID from the Actions pull-down menu. 
  16478.  
  16479.    7. Complete the Add a New User window with the information describing the 
  16480.       new user. The user ID should not be the same as the machine ID. 
  16481.  
  16482.           Select  User or  Administrator (a LAN network administrator) to 
  16483.            specify the user type. If you select  User, you can also specify 
  16484.            whether the user should have accounts operator privilege. 
  16485.  
  16486.            Of the user types definable through User Profile Management, only 
  16487.            the user and administrator types are significant to OS/2 Warp 
  16488.            Server. A third User Profile Management user type is  local 
  16489.            administrator. A local administrator has database manager authority 
  16490.            (SYSADM) for local databases (residing on that user's machine) but 
  16491.            has only user privileges on the OS/2 LAN. In contrast, a network 
  16492.            administrator has network administrator authority and database 
  16493.            manager SYSADM authority for all databases on the LAN. For further 
  16494.            information on the local administrator user type, see  Database 
  16495.            Manager Considerations when Adding Users. 
  16496.  
  16497.           In the  Password box, specify whether a password is required. The 
  16498.            password can be from 4 through 14 characters (bytes) long. If you 
  16499.            select Password Required, you can also select Expire Password if you 
  16500.            want to force the user to change the password at the first logon. 
  16501.  
  16502.            Because the password is not displayed when you type it, you are 
  16503.            prompted to type the password a second time to confirm it. 
  16504.  
  16505.            If you select  Password Optional, the user can later choose to add a 
  16506.            password without intervention by the administrator. 
  16507.  
  16508.           The  Logon box lets you allow or deny logon to individual users on 
  16509.            the domain. If you select  Denied, you can give the user access 
  16510.            authority later by changing this field to  Allowed. 
  16511.  
  16512.  For more information, see the following topic: 
  16513.  
  16514.      Database Manager Considerations when Adding Users 
  16515.  
  16516.  
  16517. ΓòÉΓòÉΓòÉ 22.3.1.1. Database Manager Considerations when Adding Users ΓòÉΓòÉΓòÉ
  16518.  
  16519. To access databases on a remote Database Manager server, you must have an 
  16520. administrator or local administrator ID defined at the database client so that 
  16521. you can update the directories.  You can use the default administrator ID 
  16522. supplied at installation or one you created. 
  16523.  
  16524. However, if you are installing OS/2 Warp Server on the same workstation with 
  16525. the database client, then you must have an administrator ID defined on the 
  16526. network or a local administrator ID defined at the database client.  The local 
  16527. administrator ID should be the same as your domain user ID. 
  16528.  
  16529. The local administrator user type must be defined at the local workstation on 
  16530. which the user is a local administrator. To access databases on a remote 
  16531. Database Manager server, there must be one (and only one) local administrator 
  16532. user type defined at each Database Manager client. This definition differs from 
  16533. the LAN user types user and administrator, which can be defined remotely. 
  16534. Because the local administrator user type is tied to the machine ID, it cannot 
  16535. be defined remotely. 
  16536.  
  16537. To create a local administrator user ID at a workstation: 
  16538.  
  16539.    1. If you are logged on to the domain, first log off, either by selecting 
  16540.       Logoff from UPM Services or by typing LOGOFF at the OS/2 command prompt. 
  16541.  
  16542.    2. At the OS/2 command prompt, log on using the /L (local logon) option: 
  16543.  
  16544.             LOGON userid /P:password /L
  16545.  
  16546.       Specify a user ID defined as an administrator user type at your 
  16547.       workstation.  The default administrator user ID shipped with OS/2 Warp 
  16548.       Server is USERID. The default password is PASSWORD. 
  16549.  
  16550.    3. Add the user ID through UPM Services, specifying the user type as local 
  16551.       administrator.  For instructions, see  Adding a User. Make sure this user 
  16552.       ID is also defined to the domain. 
  16553.  
  16554.    4. Log on to the domain again by selecting  Logon from UPM Services or by 
  16555.       typing LOGON at the OS/2 command prompt. 
  16556.  
  16557.  Use this local administrator user ID to update database and node directories 
  16558.  when accessing a remote database. If your workstation is configured as a 
  16559.  database client, use this user ID to create and maintain databases on your 
  16560.  workstation. 
  16561.  
  16562.  If you add OS/2 Warp Server to a workstation that already has a database 
  16563.  client or database server installed, the existing user ID and group ID 
  16564.  definitions file is overlaid with the file from the domain controller. Changes 
  16565.  to domain user and group definitions are also copied to these workstations. 
  16566.  
  16567.  Because all the domain user and group definitions are automatically replicated 
  16568.  to other servers in the domain when the NetLogon service starts, you should 
  16569.  create the local administrator user ID before starting the OS/2 Warp Server 
  16570.  software for the first time.  If you start the OS/2 Warp Server software 
  16571.  first, you must log on locally to the workstation using a user ID defined to 
  16572.  the domain as an administrator ID.  This gives you the authority to create the 
  16573.  local administrator ID. 
  16574.  
  16575.  
  16576. ΓòÉΓòÉΓòÉ 22.3.2. Granting and Revoking Operator Privileges ΓòÉΓòÉΓòÉ
  16577.  
  16578. A user with operator privileges has certain administrative capabilities but is 
  16579. not a full administrator.  A user may have one or more of the following types 
  16580. of operator privilege: 
  16581.  
  16582.   Type                Abilities
  16583.  
  16584.  Accounts            Manage users and groups within the domain.  The user can 
  16585.                      add, modify, or delete users and groups from the command 
  16586.                      line or from User Profile Management.  The user cannot 
  16587.                      create or modify user accounts that have administrator or 
  16588.                      accounts operator privilege. 
  16589.  
  16590.  Print               Manage printer queues and print jobs.  The user can 
  16591.                      create, modify, or delete printers or queues on servers 
  16592.                      within the domain from the command line or from Print 
  16593.                      Manager.  The user can also share printer queues and 
  16594.                      manage remote jobs on shared queues. 
  16595.  
  16596.  Comm                Manage serial devices.  The user can share serial devices 
  16597.                      and manage remote jobs on shared serial devices from the 
  16598.                      command line. 
  16599.  
  16600.  Server              Manage aliases and other shared resources and view network 
  16601.                      status. The user can create, modify, or delete aliases or 
  16602.                      other shared resources from the command line. 
  16603.  
  16604.  Operator privileges are part of the accounts database and are replicated 
  16605.  within a domain.  See the Command Reference for more information about 
  16606.  operator privileges (defined in the NET USER command). 
  16607.  
  16608.  To grant operator privileges to a user, you can use the NET USER command. For 
  16609.  example, to grant accounts operator privilege and print operator privilege to 
  16610.  a user, type: 
  16611.  
  16612.   NET USER userid /OPERATOR:ACCOUNTS,PRINT
  16613.  
  16614.  Note:  In the previous example, the NET USER command runs at either the domain 
  16615.         controller or in combination with the NET ADMIN command directed to the 
  16616.         domain controller. 
  16617.  
  16618.  
  16619. ΓòÉΓòÉΓòÉ 22.3.3. Updating User Information ΓòÉΓòÉΓòÉ
  16620.  
  16621. There are two aspects to updating user information: 
  16622.  
  16623.      Updating user information fields originally defined on the Add a New User 
  16624.       window including: 
  16625.  
  16626.         -  User ID 
  16627.  
  16628.         -  User type (user, local administrator, or administrator) 
  16629.  
  16630.         -  Optional comments about the user ID (40 characters is the maximum) 
  16631.  
  16632.         -  Password 
  16633.  
  16634.         -  Logon authority (whether the user can log on to the domain) 
  16635.  
  16636.      Updating group memberships for a user (adding a user to a group, deleting 
  16637.       a user from a group) 
  16638.  
  16639.  These tasks can be done through User Profile Management. 
  16640.  
  16641.  For more information, see the following topics: 
  16642.  
  16643.      Updating User Information Fields 
  16644.  
  16645.      Updating Group Memberships for a User 
  16646.  
  16647.  
  16648. ΓòÉΓòÉΓòÉ 22.3.3.1. Updating User Information Fields ΓòÉΓòÉΓòÉ
  16649.  
  16650. Use the following procedure to update user information fields. 
  16651.  
  16652. To update user information fields: 
  16653.  
  16654.    1. On the desktop, select  User Profile Management Services. 
  16655.  
  16656.    2. Select  User Profile Management from UPM Services. 
  16657.  
  16658.    3. In the User Profile Management-User Profile window, select Manage from 
  16659.       the menu bar. 
  16660.  
  16661.    4. Select  Manage Users from the Manage pull-down menu. 
  16662.  
  16663.    5. The User Profile Management-User Management window lists all users 
  16664.       currently defined through User Profile Management. 
  16665.  
  16666.       Select the user for whom you want to update user information. 
  16667.  
  16668.    6. Select  Actions from the menu bar. 
  16669.  
  16670.    7. Select  Update user information from the Actions pull-down menu. 
  16671.  
  16672.    8. Complete the Update User Information window with the changed information. 
  16673.  
  16674.  Notes: 
  16675.  
  16676.    1. Passwords are validated only when they are added or changed. Therefore, 
  16677.       if you change the status of a password from Password Optional to Password 
  16678.       Required, but you do not change the password, it is not checked against 
  16679.       the password limitations specified by MINPWLEN (using NET ACCOUNTS). To 
  16680.       see the MINPWLEN restrictions, type  NET ACCOUNTS at the OS/2 command 
  16681.       line. 
  16682.  
  16683.       If the status of a password is changed from Password Required to Password 
  16684.       Optional, the password is not automatically deleted. 
  16685.  
  16686.       To delete a password: 
  16687.  
  16688.         a. Select  Not Required from the Update User Information window. 
  16689.  
  16690.         b. Select the  Change Password option by marking the check box. 
  16691.  
  16692.         c. Select  Delete Password, and then select  OK to delete the existing 
  16693.            password. 
  16694.  
  16695.    2. Null passwords are created when a user is added and the Password field is 
  16696.       left blank. If you change the status of a null password from Password 
  16697.       Optional to Password Required, the null password remains valid. 
  16698.  
  16699.    3. For information on using the command-line interface to change password 
  16700.       requirements, see the NET USER command in the Command Reference. 
  16701.  
  16702.    4. If you are changing a NET USER parameter setting of /PASSWORDREQ:Y to 
  16703.       /PASSWORDREQ:N to cancel password requirements for a user, note that the 
  16704.       /PASSWORDREQ:N setting does not automatically delete the user's password. 
  16705.       After issuing NET USER  userid /PASSWORDREQ:N, one of the following 
  16706.       actions can be taken to delete the password.  ( userid is the user ID of 
  16707.       the person who no longer requires a password for logon.) 
  16708.  
  16709.           An administrator can type  NET USER userid "" where "" indicates a 
  16710.            NULL password. 
  16711.  
  16712.           An administrator or user can use the NET PASSWORD command to nullify 
  16713.            the password.  The password must be known by the person nullifying 
  16714.            the password. For information on NET PASSWORD, see the Command 
  16715.            Reference. 
  16716.  
  16717.  You can also view a user profile without changing it by selecting View user 
  16718.  profile from the Actions pull-down menu on the User Profile Management-User 
  16719.  Management window. 
  16720.  
  16721.  
  16722. ΓòÉΓòÉΓòÉ 22.3.3.2. Updating Group Memberships for a User ΓòÉΓòÉΓòÉ
  16723.  
  16724. After you have defined a user, you can select groups to which that user 
  16725. belongs.  You can also remove a user from a group. 
  16726.  
  16727. To update group memberships for a user: 
  16728.  
  16729.    1. On the desktop, select  User Profile Management Services. 
  16730.  
  16731.    2. Select  User Profile Management from UPM Services. 
  16732.  
  16733.    3. In the User Profile Management-User Profile window, select Manage from 
  16734.       the menu bar. 
  16735.  
  16736.    4. Select  Manage Users from the Manage pull-down menu. 
  16737.  
  16738.    5. The User Profile Management-User Management window lists all users 
  16739.       currently defined through User Profile Management. 
  16740.  
  16741.       Select the user for whom you want to update group membership. 
  16742.  
  16743.    6. Select  Actions from the menu bar. 
  16744.  
  16745.    7. Select  Select groups for user ID from the Actions pull-down menu. 
  16746.  
  16747.    8. The Select Groups window lists all the group IDs currently defined 
  16748.       through User Profile Management. The groups currently assigned to the 
  16749.       user are highlighted. 
  16750.  
  16751.       To add a user to a group: 
  16752.  
  16753.       Use the Spacebar to select the group ID or IDs to which the user is to 
  16754.       belong. Select  OK. 
  16755.  
  16756.       To delete a user ID from a group: 
  16757.  
  16758.       Use the Spacebar to deselect the group ID for the group from which you 
  16759.       want to delete the user. Select  OK. 
  16760.  
  16761.  
  16762. ΓòÉΓòÉΓòÉ 22.3.4. Deleting a User ΓòÉΓòÉΓòÉ
  16763.  
  16764. User Profile Management allows you to remove a user from the domain by deleting 
  16765. the user's user ID. When you delete a user ID, the following occurs: 
  16766.  
  16767.      The user ID is erased from the list of users. 
  16768.  
  16769.      The user ID is removed from all groups. 
  16770.  
  16771.      The user can no longer access network resources. 
  16772.  
  16773.  The directory path and the contents of the home directory for the user ID (if 
  16774.  one exists) and its access control profile are not deleted. These files must 
  16775.  be deleted using the graphical user interface. For more information on 
  16776.  deleting the home directory, see Deleting a Home Directory. For more 
  16777.  information on deleting the access control profile, see  Deleting an Access 
  16778.  Control Profile. 
  16779.  
  16780.  Attention  Do not delete system IDs for existing servers. 
  16781.  
  16782.  To delete a user ID: 
  16783.  
  16784.    1. On the desktop, select  User Profile Management Services. 
  16785.  
  16786.    2. Select  User Profile Management from UPM Services. 
  16787.  
  16788.    3. In the User Profile Management-User Profile window, select Manage from 
  16789.       the menu bar. 
  16790.  
  16791.    4. Select  Manage Users from the Manage pull-down menu. 
  16792.  
  16793.    5. The User Profile Management-User Management window lists all users 
  16794.       currently defined through User Profile Management. Select the user ID or 
  16795.       IDs to delete from this list. 
  16796.  
  16797.    6. Select  Actions from the menu bar. 
  16798.  
  16799.    7. Select  Erase user ID from the Actions pull-down menu. 
  16800.  
  16801.    8. Select  Erase ID from the Erase User ID window. 
  16802.  
  16803.  
  16804. ΓòÉΓòÉΓòÉ 22.3.5. Creating a Logon Profile ΓòÉΓòÉΓòÉ
  16805.  
  16806. You can create a  logon profile for a user, if desired. A logon profile is a 
  16807. batch file containing commands that run automatically each time the user logs 
  16808. on. 
  16809.  
  16810. To create a logon profile for a user, create a file with one of the following 
  16811. names (these file names are required): 
  16812.  
  16813.      PROFILE.CMD for users at OS/2 clients 
  16814.  
  16815.      PROFILE.BAT for users at DOS clients 
  16816.  
  16817.  The logon profile must be in that user's user profile 
  16818.  subdirectory,\IBMLAN\DCDB\USERS\ userid for users at both OS/2 and DOS 
  16819.  clients. If the subdirectory does not exist, create it using LAN Server 
  16820.  Administration Logon details function. See  Directory Structure for more 
  16821.  information on directory contents. 
  16822.  
  16823.  For example, for a user logging on to a DOS LAN client, the following line in 
  16824.  the PROFILE.BAT file assigns printer queue LPT1Q on SERVER1 to local printer 
  16825.  LPT1: 
  16826.  
  16827.   NET USE LPT1: \\SERVER1\LPT1Q
  16828.  
  16829.  This causes the DOS LAN Services workstation to connect to the printer 
  16830.  resource at logon. 
  16831.  
  16832.  Notes: 
  16833.  
  16834.    1. User logon profiles can only be used with user IDs that do not exceed 10 
  16835.       characters.  This restriction also applies when adding or changing logon 
  16836.       profiles. 
  16837.  
  16838.    2. If your network has several servers acting as backup domain controllers, 
  16839.       make sure user logon profiles are correctly stored on each of the backup 
  16840.       domain controllers under the correct paths.  Otherwise, if there is a 
  16841.       domain controller failure, users will not be able to access their logon 
  16842.       profiles from the backup domain controller. 
  16843.  
  16844.    3. Currently existing environment variables cannot be permanently set 
  16845.       through the PROFILE.CMD or PROFILE.BAT file. 
  16846.  
  16847.    4. If you log on through UPM and your PROFILE.CMD file contains an ECHO or a 
  16848.       SAY command, you receive a NET8195 error. To avoid this error condition, 
  16849.       log on using the command-line interface. 
  16850.  
  16851.    5. If the PROFILE.CMD file is written in REXX language, you must have the 
  16852.       EXIT (0) statement at the end of the file; otherwise, a NET8195 error 
  16853.       occurs. 
  16854.  
  16855.  
  16856. ΓòÉΓòÉΓòÉ 22.3.6. Updating Logon and Desktop Application Assignments ΓòÉΓòÉΓòÉ
  16857.  
  16858. You can define  logon assignments for a user. Logon assignments give the user 
  16859. access to network resources by assigning resources to logical drives or ports 
  16860. each time a user logs on. The logon assignments remain in effect until changed. 
  16861. Both you and a user can change that user's logon assignments. 
  16862.  
  16863. You can update logon assignments from the graphical user interface and from the 
  16864. command line.  You also can manage a user's desktop applications from the 
  16865. command line. 
  16866.  
  16867. An alias must be defined for a resource before a resource can be defined as a 
  16868. logon assignment. See  Sharing Network Resourcesfor more information on 
  16869. defining aliases. 
  16870.  
  16871.  
  16872. ΓòÉΓòÉΓòÉ 22.4. Managing Groups ΓòÉΓòÉΓòÉ
  16873.  
  16874. You can create up to 250 groups in each domain.  The following six additional 
  16875. groups already exist for each domain: 
  16876.  
  16877.      USERS (IDs with user privileges or groups of all user IDs) 
  16878.  
  16879.      ADMINS (administrators) 
  16880.  
  16881.      GROUPID (default group ID) 
  16882.  
  16883.      SERVERS (servers defined in the domain) 
  16884.  
  16885.      LOCAL (empty group used to grant permissions to the local workstation 
  16886.       when no one is logged on) 
  16887.  
  16888.      GUESTS (group of guest IDs) 
  16889.  
  16890.  For more information, see the following topics: 
  16891.  
  16892.      Adding a Group 
  16893.  
  16894.      Viewing a Group 
  16895.  
  16896.      Updating a Group 
  16897.  
  16898.      Deleting a Group 
  16899.  
  16900.  
  16901. ΓòÉΓòÉΓòÉ 22.4.1. Adding a Group ΓòÉΓòÉΓòÉ
  16902.  
  16903. You can create user groups to refer to several users at the same time. On an 
  16904. OS/2 LAN, groups are used for access control and messaging purposes. 
  16905.  
  16906. To add a group: 
  16907.  
  16908.    1. On the desktop, select  User Profile Management Services. 
  16909.  
  16910.    2. Select  User Profile Management from UPM Services. 
  16911.  
  16912.    3. In the User Profile Management-User Profile window, select Manage from 
  16913.       the menu bar. 
  16914.  
  16915.    4. Select  Manage Groups from the Manage pull-down menu. 
  16916.  
  16917.    5. The User Profile Management-Group Management window lists all groups 
  16918.       currently defined through User Profile Management. Select  New from this 
  16919.       list. 
  16920.  
  16921.    6. Select  Add a new group from the Actions pull-down. 
  16922.  
  16923.    7. Complete the Add a New Group window.  Specify the group ID and any 
  16924.       optional comments. Select the user IDs to belong to the group. To confirm 
  16925.       or update the new group, see  Updating a Group. 
  16926.  
  16927.  
  16928. ΓòÉΓòÉΓòÉ 22.4.2. Viewing a Group ΓòÉΓòÉΓòÉ
  16929.  
  16930. You can view the list of users in a group after the group is created. This task 
  16931. can be done through User Profile Management. 
  16932.  
  16933. To view a group: 
  16934.  
  16935.    1. On the desktop, select  User Profile Management Services. 
  16936.  
  16937.    2. Select  User Profile Management from UPM Services. 
  16938.  
  16939.    3. In the User Profile Management-User Profile window, select Manage from 
  16940.       the menu bar. 
  16941.  
  16942.    4. Select  Manage Groups from the Manage pull-down menu. 
  16943.  
  16944.    5. The User Profile Management-Group Management window lists all groups 
  16945.       currently defined through User Profile Management. Select the group to 
  16946.       view from this list.  You can only view one group at a time. 
  16947.  
  16948.    6. Select  Actions from the menu bar. 
  16949.  
  16950.    7. Select  View group from the Actions pull-down menu. 
  16951.  
  16952.       The View Group window displays the users in the selected group. 
  16953.  
  16954.  
  16955. ΓòÉΓòÉΓòÉ 22.4.3. Updating a Group ΓòÉΓòÉΓòÉ
  16956.  
  16957. You can change the list of users in a group after the group is created. This 
  16958. task can be done through User Profile Management. 
  16959.  
  16960. To update a group: 
  16961.  
  16962.    1. On the desktop, select  User Profile Management Services. 
  16963.  
  16964.    2. Select  User Profile Management from UPM Services. 
  16965.  
  16966.    3. In the User Profile Management-User Profile window, select Manage from 
  16967.       the menu bar. 
  16968.  
  16969.    4. Select  Manage Groups from the Manage pull-down menu. 
  16970.  
  16971.    5. The User Profile Management-Group Management window lists all groups 
  16972.       currently defined through User Profile Management. Select the group to 
  16973.       update from this list.  You can only update one group at a time. 
  16974.  
  16975.    6. Select  Actions from the menu bar. 
  16976.  
  16977.    7. Select  Update group from the Actions pull-down menu. 
  16978.  
  16979.    8. Complete the Update Group window with the changed information. You can 
  16980.       add new users to the group or remove users from the group. The users 
  16981.       currently assigned to the group are highlighted. 
  16982.  
  16983.  
  16984. ΓòÉΓòÉΓòÉ 22.4.4. Deleting a Group ΓòÉΓòÉΓòÉ
  16985.  
  16986. Besides deleting individual users and removing users from groups, you can 
  16987. remove a group from the domain.  Users in the deleted group no longer have 
  16988. permissions that may have been granted to them through membership in the group. 
  16989. However, deleting a group does not affect the individual user IDs and their 
  16990. associated user profiles. 
  16991.  
  16992. This task is done through User Profile Management. 
  16993.  
  16994. To delete a group: 
  16995.  
  16996.    1. On the desktop, select  User Profile Management Services. 
  16997.  
  16998.    2. Select  User Profile Management from UPM Services. 
  16999.  
  17000.    3. In the User Profile Management-User Profile window, select Manage from 
  17001.       the menu bar. 
  17002.  
  17003.    4. Select  Manage Groups from the Manage pull-down menu. 
  17004.  
  17005.    5. The User Profile Management-Group Management window lists all groups 
  17006.       currently defined through User Profile Management. Select the group or 
  17007.       groups to delete from this list. 
  17008.  
  17009.    6. Select  Actions from the menu bar. 
  17010.  
  17011.    7. Select  Erase group from the Actions pull-down menu. 
  17012.  
  17013.    8. Select  Erase ID in the Erase Group ID window. 
  17014.  
  17015.  Attention  Do not delete the groups named SERVERS or USERS. 
  17016.  
  17017.  
  17018. ΓòÉΓòÉΓòÉ 23. OS/2 Warp Server Interoperability ΓòÉΓòÉΓòÉ
  17019.  
  17020. This appendix identifies how the various versions of OS/2 Warp Server, LAN 
  17021. Server and PCLP work together.  You should read this appendix if you will have 
  17022. servers running various versions of OS/2 Warp Server and LAN Server software in 
  17023. your network. You also should read this appendix if you will use both PCLP and 
  17024. OS/2 Warp Server in your network. 
  17025.  
  17026.  
  17027. ΓòÉΓòÉΓòÉ 23.1. Introduction ΓòÉΓòÉΓòÉ
  17028.  
  17029. File and Print Sharing Server Client/Server Interoperability describes the 
  17030. access capabilities of various IBM LAN clients to resources on IBM LAN server 
  17031. domains.  The following three areas are described: 
  17032.  
  17033.      Logging on to a domain 
  17034.  
  17035.      Administering a domain 
  17036.  
  17037.      Accessing resources across domains 
  17038.  
  17039.  The IBM LAN server domains described are: 
  17040.  
  17041.      PCLP 1.31 (or later) 
  17042.  
  17043.      OS/2 LAN server 1.3 
  17044.  
  17045.      OS/2 LAN server 2.0 
  17046.  
  17047.      OS/2 LAN Server 3.0 
  17048.  
  17049.      OS/2 LAN Server 4.0 
  17050.  
  17051.      OS/2 LAN Server 5.0 
  17052.  
  17053.      OS/2 Warp Server for e-business 
  17054.  
  17055.  The IBM LAN clients described are: 
  17056.  
  17057.      PCLP 1.31 (or later) Base Services Requester (also requires IBMLAN 
  17058.       Support Program) 
  17059.  
  17060.      PCLP 1.31 (or later) Extended Services Requester (also requires IBM LAN 
  17061.       Support Program) 
  17062.  
  17063.      OS/2 LAN Requester shipped with OS/2 Extended Edition 1.3 
  17064.  
  17065.      OS/2 LAN Requester shipped with LAN Server 2.0 and LAN Server 
  17066.  
  17067.      DOS LAN Services shipped with OS/2 LAN Server 1.3, 2.0, and 3.0, and OS/2 
  17068.       Warp Server for e-business (also requires IBM LAN Support Program) 
  17069.  
  17070.      LAN Enabler 2.0 (includes OS/2 LAN Requester and DOS LAN Services) 
  17071.  
  17072.  For more information, see the following topics: 
  17073.  
  17074.      File and Print Sharing Server Client/Server Interoperability 
  17075.  
  17076.      Interoperability with Windows for Workgroup Clients 
  17077.  
  17078.  
  17079. ΓòÉΓòÉΓòÉ 23.1.1. File and Print Sharing Server Client/Server Interoperability ΓòÉΓòÉΓòÉ
  17080.  
  17081. File and Print Sharing Server Client/Server Interoperability illustrates the 
  17082. capabilities of various client products when used with various server services. 
  17083. The table distinguishes the following capabilities: 
  17084.  
  17085.  Resource access                         Determines connectivity to file, 
  17086.                                          print, and serial device resources. 
  17087.  
  17088.  Logon Services                          Determine validation of domain logon 
  17089.                                          requests. 
  17090.  
  17091.  Domain awareness                        Determines the ability to connect to 
  17092.                                          resources by alias, to launch network 
  17093.                                          applications, and to use other 
  17094.                                          centrally administered domain 
  17095.                                          services. 
  17096.  
  17097.  Administrative capabilities             Determine the ability to administer 
  17098.                                          servers and domains. 
  17099.  
  17100.  Only LAN Server servers can participate as full servers within a LAN Server 
  17101.  domain.  Users access resources on other servers, either by referring to the 
  17102.  server and its resource by name, using a Universal Naming Convention (UNC) 
  17103.  name such as\\SERVER1\C-DRIVE, or by connecting to a cross-domain alias. A 
  17104.  cross-domain alias refers to a server outside the domain and is created like a 
  17105.  normal alias, except that the server is not defined within the domain. 
  17106.  
  17107.  A user logged on to an OS/2 or DOS LAN Requester can connect to resources on 
  17108.  any number of servers, whether or not the servers are within the user's 
  17109.  domain. However, when a server outside the domain has user-level security, the 
  17110.  user must either be defined on that server with the same password as in the 
  17111.  logon domain, or access the resource as a guest, assuming that the guest 
  17112.  account (usually GUEST) has access to the resource. 
  17113.  
  17114.  When passwords are assigned to shares (share-level security), the NET USE 
  17115.  command must be used so that the password can be specified on the command. 
  17116.  
  17117.  File and Print Sharing Server Client/Server Interoperability 
  17118.  
  17119.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  17120.   ΓöéClients  ΓöéServersΓöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17121.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17122.   Γöé         ΓöéPCLP   ΓöéPCLP  ΓöéLAN   ΓöéOS/2  ΓöéMicrosoftΓöéLAN    ΓöéLAN    ΓöéPeer  Γöé
  17123.   Γöé         Γöé1.31 orΓöé1.31  ΓöéServerΓöéWarp  ΓöéLAN      ΓöéServer ΓöéServer Γöéfor   Γöé
  17124.   Γöé         Γöélater  Γöéor    Γöé2.0,  ΓöéServerΓöéManager; Γöé4.0;   Γöé4.0;   ΓöéOS/2  Γöé
  17125.   Γöé         Γöé(Base  Γöélater Γöé3.0 orΓöé4.0   ΓöéWindows  ΓöéOS/2   ΓöéOS/2   Γöéfrom  Γöé
  17126.   Γöé         ΓöéServiceΓöé(ES)  Γöé4.0   ΓöéFile  ΓöéNT and   ΓöéWarp   ΓöéWarp   ΓöéWarp  Γöé
  17127.   Γöé         Γöé(7)    Γöé(7)   Γöé      Γöéand   ΓöéNTAS;    ΓöéServer ΓöéServer ΓöéConnecΓöé
  17128.   Γöé         Γöé       Γöé      Γöé      ΓöéPrint ΓöéWindows  Γöé4.0;   Γöé4.0;   Γöé      Γöé
  17129.   Γöé         Γöé       Γöé      Γöé      ΓöéSharinΓöéfor      ΓöéPeer   ΓöéPeer   Γöé      Γöé
  17130.   Γöé         Γöé       Γöé      Γöé      Γöé      ΓöéWorkgroupΓöéServiceΓöéServiceΓöé      Γöé
  17131.   Γöé         Γöé       Γöé      Γöé      Γöé      Γöé         Γöéfor    Γöéfor DOSΓöé      Γöé
  17132.   Γöé         Γöé       Γöé      Γöé      Γöé      Γöé         ΓöéOS/2   Γöé       Γöé      Γöé
  17133.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17134.   ΓöéPCLP 1.31ΓöéR      ΓöéR (1),ΓöéR (1),ΓöéR (1),ΓöéR (1)    ΓöéR (1,3)ΓöéR (1,3)ΓöéR     Γöé
  17135.   Γöéor later Γöé       ΓöéL (2) ΓöéL (2) ΓöéL (2) Γöé         Γöé       Γöé       Γöé      Γöé
  17136.   Γöé(Base    Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17137.   ΓöéServices)Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17138.   Γöé(7)      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17139.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17140.   ΓöéPCLP 1.31ΓöéR      ΓöéL,A   Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17141.   Γöéor later Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17142.   Γöé(ES) (7) Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17143.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17144.   ΓöéOS/2 LAN ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3), ΓöéR (1,3)ΓöéR,A   Γöé
  17145.   ΓöéRequesterΓöé       Γöé      Γöé      Γöé      Γöé         ΓöéA (10) Γöé       Γöé(10)  Γöé
  17146.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17147.   Γöéwith LAN Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17148.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17149.   Γöé2.0, 3.0 Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17150.   Γöéor 4.0,  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17151.   ΓöéLAN      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17152.   ΓöéEnabler  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17153.   Γöé2.0, or  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17154.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17155.   ΓöéConnect) Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17156.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17157.   ΓöéOS/2 LAN ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3), ΓöéR (1,3)ΓöéR,A   Γöé
  17158.   ΓöéRequesterΓöé       Γöé      Γöé      Γöé      Γöé         ΓöéA 10   Γöé       Γöé(10)  Γöé
  17159.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17160.   Γöéwith OS/2Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17161.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17162.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17163.   Γöé4.0 and  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17164.   ΓöéOS/2 WarpΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17165.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17166.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17167.   Γöée-businesΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17168.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17169.   ΓöéDOS LAN  ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3), ΓöéR (1,3)ΓöéR,A   Γöé
  17170.   ΓöéRequesterΓöé       Γöé      Γöé(4)   Γöé(4)   Γöé         ΓöéA (10) Γöé       Γöé(10)  Γöé
  17171.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17172.   Γöéwith LAN Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17173.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17174.   Γöé2.0, 3.0 Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17175.   Γöéor 4.0)  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17176.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17177.   ΓöéDOS LAN  ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3),AΓöéR (1,3)ΓöéR,A   Γöé
  17178.   ΓöéServices Γöé       Γöé      Γöé(5)   Γöé(5)   Γöé         Γöé(10)   Γöé       Γöé(10)  Γöé
  17179.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17180.   Γöéwith OS/2Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17181.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17182.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17183.   Γöé4.0, LAN Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17184.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17185.   Γöé4.0, and Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17186.   ΓöéOS/2 WarpΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17187.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17188.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17189.   Γöée-businesΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17190.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17191.   ΓöéWindows  ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3),AΓöéR (1,3)ΓöéR,A   Γöé
  17192.   Γöé95 ClientΓöé       Γöé      Γöé(5)   Γöé(5)   Γöé         Γöé(10)   Γöé       Γöé(10)  Γöé
  17193.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17194.   Γöéwith OS/2Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17195.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17196.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17197.   Γöé4.0)     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17198.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17199.   ΓöéWindows  ΓöéR      ΓöéR     ΓöéR,L,D,ΓöéR,L,D,ΓöéR        ΓöéR (3),AΓöéR (1,3)ΓöéR,A   Γöé
  17200.   Γöé95 ClientΓöé       Γöé      Γöé(5)   Γöé(5)   Γöé         Γöé(10)   Γöé       Γöé(10)  Γöé
  17201.   Γöéwith IBM Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17202.   ΓöéNetwork  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17203.   ΓöéClients  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17204.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17205.   ΓöéWindows  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17206.   Γöé95       Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17207.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17208.   Γöéwith OS/2Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17209.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17210.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17211.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17212.   Γöée-businesΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17213.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17214.   ΓöéMicrosoftΓöéR      ΓöéR     ΓöéR,L,A ΓöéR,L,A Γöé         ΓöéR,A (8)ΓöéR      ΓöéR     Γöé
  17215.   ΓöéLAN      Γöé       Γöé      Γöé(8)   Γöé(8)   Γöé         Γöé       Γöé       Γöé      Γöé
  17216.   ΓöéManager  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17217.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17218.   ΓöéMicrosoftΓöéR      ΓöéR     ΓöéR,A   ΓöéR,A   Γöé         ΓöéR,A (8)ΓöéR      ΓöéR     Γöé
  17219.   ΓöéNT or    Γöé       Γöé      Γöé(8)   Γöé(8)   Γöé         Γöé       Γöé       Γöé      Γöé
  17220.   ΓöéNTAS     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17221.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17222.   ΓöéMicrosoftΓöéR      ΓöéR     ΓöéR,A   ΓöéR,A   Γöé         ΓöéR,A (8)ΓöéR      ΓöéR     Γöé
  17223.   ΓöéNT with  Γöé       Γöé      Γöé(8)   Γöé(8)   Γöé         Γöé       Γöé       Γöé      Γöé
  17224.   ΓöéIBM      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17225.   ΓöéPrimary  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17226.   ΓöéLogon    Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17227.   ΓöéClient   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17228.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17229.   ΓöéWindows  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17230.   ΓöéNT       Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17231.   Γöé(shipped Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17232.   Γöéwith OS/2Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17233.   ΓöéWarp     Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17234.   ΓöéServer   Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17235.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17236.   Γöée-businesΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17237.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17238.   ΓöéMicrosoftΓöéR      ΓöéR     ΓöéR,L   ΓöéR,L   Γöé         ΓöéR      ΓöéR      ΓöéR     Γöé
  17239.   ΓöéWindows  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17240.   Γöéfor      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17241.   ΓöéWorkgroupΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17242.   Γöé(9)      Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17243.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  17244.   ΓöéWorkgroupΓöéR      ΓöéR     ΓöéR,L   ΓöéR,L   Γöé         ΓöéR      ΓöéR      ΓöéR,L   Γöé
  17245.   ΓöéConnectioΓöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17246.   Γöéfor DOS  Γöé       Γöé      Γöé      Γöé      Γöé         Γöé       Γöé       Γöé      Γöé
  17247.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  17248.  
  17249.  Abbreviations 
  17250.  
  17251.      R = access to shared resources (file, print, serial) 
  17252.  
  17253.      L = domain logon capability 
  17254.  
  17255.      D = Domain Services (aliases, application definitions, etc.) 
  17256.  
  17257.      A = administrative capabilities 
  17258.  
  17259.      ES = Extended Services 
  17260.  
  17261.      PCLP = PCLP 
  17262.  
  17263.  Notes 
  17264.  
  17265.    1. Remote access to serial devices is not supported. 
  17266.  
  17267.    2. The network administrator defines a user ID that matches the machine name 
  17268.       of the PCLP Base Services workstation. When the workstation issues a NET 
  17269.       USE command, the machine name is validated against the defined user IDs. 
  17270.  
  17271.    3. Peer Services for DOS and OS/2 are limited to sharing with one client at 
  17272.       a time (single session). 
  17273.  
  17274.    4. Administrative capability from the DOS LAN Requester client is available 
  17275.       only from the LAN Server application programming interface (API).  A 
  17276.       large number of categories that support remote network administration are 
  17277.       supported. For more information, refer to the Programming Guide and 
  17278.       Reference. 
  17279.  
  17280.    5. In addition to the API support described in the previous note, DOS LAN 
  17281.       Services for LAN Server 4.0 includes the NET ADMIN command, which allows 
  17282.       full command line administration of LAN Server. 
  17283.  
  17284.    6. PCLP and Microsoft servers cannot be defined within a LAN Server domain; 
  17285.       access to those resources are cross-domain. 
  17286.  
  17287.    7. PCLP is available on SBCS systems only. 
  17288.  
  17289.    8. Partial administration function only. 
  17290.  
  17291.    9. Domain Services can be added by installing the DLS requester shipped with 
  17292.       LAN Server 4.0. 
  17293.  
  17294.   10. Command line administration via NET ADMIN only. 
  17295.  
  17296.  
  17297. ΓòÉΓòÉΓòÉ 23.1.2. Administration of LAN Server 2.0 or 3.0 Users and Aliases from the LAN Server Administrator GUI ΓòÉΓòÉΓòÉ
  17298.  
  17299. There are some restrictions when using the LAN Server Administration GUI to 
  17300. administer domains running earlier levels of LAN Server: 
  17301.  
  17302.      A user account running in a LAN Server 2.0 or 3.0 domain cannot be 
  17303.       modified or deleted once it's created from the LAN Server Administration 
  17304.       GUI. If you are using the GUI to update or delete a user in a LAN Server 
  17305.       2.0 or 3.0 domain, the NET.ACC file on the 2.0 or 3.0 domain cannot be 
  17306.       updated and no error message is displayed. 
  17307.  
  17308.      An alias maintained in a LAN Server 2.0 or 3.0 domain cannot be changed 
  17309.       after its initial creation from the LAN Server Administration GUI.  If 
  17310.       you use the GUI to update the alias, the DCDB on the 2.0 or 3.0 domain is 
  17311.       not updated and no error message will be displayed. 
  17312.  
  17313.  
  17314. ΓòÉΓòÉΓòÉ 23.2. Interoperability with Windows for Workgroup Clients ΓòÉΓòÉΓòÉ
  17315.  
  17316. IBM LAN Server 5.0 and Microsoft Windows for Workgroup (3.1 or 3.11) are 
  17317. generally compatible and can interoperate to communicate with each other across 
  17318. a LAN.  This section describes some of the considerations when operating in 
  17319. this environment.  This section focuses on Windows for Workgroups operating 
  17320. with its native client and peer server and connecting with an OS/2 LAN Server 
  17321. client, Peer Services, and server across a LAN. 
  17322.  
  17323. For more information, see the following topics: 
  17324.  
  17325.      Transports 
  17326.  
  17327.      Logging On 
  17328.  
  17329.      Browsing Domains and Servers 
  17330.  
  17331.      File Resources 
  17332.  
  17333.      Printer Resources 
  17334.  
  17335.  
  17336. ΓòÉΓòÉΓòÉ 23.2.1. Transports ΓòÉΓòÉΓòÉ
  17337.  
  17338. The IBM and Microsoft implementation of NetBIOS transports are compatible with 
  17339. each other and can communicate well across a network. You must, of course, 
  17340. install hardware LAN adapters and the correct drivers for those adapters on 
  17341. both the Windows for Workgroups and the LAN Server workstations.  The adapter 
  17342. types and drivers supported in the two environments are different, and you must 
  17343. ensure that your choice of adapter is compatible with each environment. 
  17344.  
  17345.  
  17346. ΓòÉΓòÉΓòÉ 23.2.2. Logging On ΓòÉΓòÉΓòÉ
  17347.  
  17348. Windows for Workgroups clients can log on to a LAN Server domain. Configure the 
  17349. Window for Workgroups clients with its logon workgroup name equivalent to the 
  17350. LAN Server domain name.  You can do this through the Control Panel Network 
  17351. icon. 
  17352.  
  17353. Home directories, logon assignments, network applications, and PROFILE.BAT are 
  17354. not supported from Windows for Workgroups clients. 
  17355.  
  17356.  
  17357. ΓòÉΓòÉΓòÉ 23.2.3. Browsing Domains and Servers ΓòÉΓòÉΓòÉ
  17358.  
  17359. Windows for Workgroups has adopted a different browsing scheme than OS/2 LAN 
  17360. Server.  However, the two browsing schemes are interoperable with the following 
  17361. constraints.  Windows for Workgroups clients can browse LAN Server domains and 
  17362. servers.  If you have logged on to a LAN Server domain, that domain's server 
  17363. will be visible to you when you browse using the File Manager or Print Manager. 
  17364. All other Windows for Workgroups peer servers in other domains should also be 
  17365. visible to you. 
  17366.  
  17367. To browse a LAN Server domain that you have not logged on to, bring up the File 
  17368. Manager's Connect Network Driver dialog box and type a known server name 
  17369. located in that domain in the  Path field. (for example, \\OS2SRV), and then 
  17370. press Enter. Windows for Workgroups will begin browsing that server's domain. 
  17371. When finished, the domain's shared directory aliases are displayed.  To display 
  17372. peer client shared directory aliases, repeat the above steps using a client 
  17373. name. 
  17374.  
  17375. LAN Server clients can browse resources shared from Windows for Workgroups 
  17376. workstations from the command line interface.  On the Windows for Workgroups 
  17377. workstations, you can add a parameter to the\WINDOWS\SYSTEM.INI file to allow 
  17378. the client to browse resources. In the [network] section of the SYSTEM.INI 
  17379. file, add the following line: 
  17380.  
  17381. lmannounce=yes
  17382.  
  17383. This makes the Windows for Workgroups server visible to the LAN Server client 
  17384. which is browsing the same domain.  If you do not add this parameter, you will 
  17385. have to specify the name of the Windows for Workgroups server when you connect 
  17386. to resources. 
  17387.  
  17388.  
  17389. ΓòÉΓòÉΓòÉ 23.2.4. File Resources ΓòÉΓòÉΓòÉ
  17390.  
  17391. Windows for Workgroups clients can use LAN Server file resources, as long as 
  17392. the files and directories conform to the DOS FAT 8.3 naming convention.  Long 
  17393. file names are not visible to Windows for Workgroups clients. 
  17394.  
  17395. To connect to a LAN Server file alias, you must specify the server name and the 
  17396. alias name, not just the alias name.  Windows for Workgroups does not support 
  17397. single system image connections. 
  17398.  
  17399. LAN Server clients can use Windows for Workgroups file resources, except that 
  17400. 32-bit OS/2 applications cannot use the DosFindFirst and DosFindNext APIs. 
  17401. This means that OS/2 desktop Drive objects cannot be used to view Windows for 
  17402. Workgroups file resources, nor can the OS/2 desktop Network folder be used. Use 
  17403. a DOS or OS/2 window to view file names. 
  17404.  
  17405.  
  17406. ΓòÉΓòÉΓòÉ 23.2.5. Printer Resources ΓòÉΓòÉΓòÉ
  17407.  
  17408. Windows for Workgroups can use LAN Server printer resources as long as 
  17409. connections are made using the server name and printer queue name (for example, 
  17410. \\SERVER1\PRINTER1).  The Windows for Workgroups Print Manager can be used to 
  17411. view and manipulate LAN Server printer queues. 
  17412.  
  17413. To connect to a LAN Server printer alias, open the Windows for Workgroups Print 
  17414. Manager and select  Connect Network Printer. 
  17415.  
  17416.  
  17417. ΓòÉΓòÉΓòÉ 24. DHCP RIPL Bootstrap Messages ΓòÉΓòÉΓòÉ
  17418.  
  17419. During the first phase of the bootup process, no operating system or font 
  17420. services are available, so error messages are displayed through BIOS functions. 
  17421. Only the characters supported by machine ROM BIOS (code page 437) can be 
  17422. displayed. These error messages and the associated help for them are described 
  17423. below. 
  17424.  
  17425. BPD0000I: The file identified on the next line displayed cannot be found.
  17426. Help: Make sure the identified file exists on the server in the path specified.
  17427.  
  17428. BPD0001I: The DHCP boot cannot continue.
  17429. Help: Fatal error. DHCP boot client cannot continue its boot process.
  17430.  
  17431. BPD0002I: No response from a DHCP/BOOTP server.
  17432. Help: Check that the network is functioning. Make sure the client can reach the DHCP
  17433. server and remote IPL server. Ensure that DHCP and BINL server services are started and
  17434. client can reach these servers.
  17435.  
  17436. BPD0003I: Not enough memory is available to DHCP boot this machine.
  17437. Help: DHCP boot client machine needs at least 16 MB RAM.
  17438.  
  17439. BPD0004I: TFTP downloading of files started.
  17440.  
  17441. BPD0005I: TFTP downloading of files completed.
  17442.  
  17443. BPD0010I: Invalid file handle.
  17444. Help: File might not exist. Make sure that the specified file is in BPCOMMON and make sure
  17445. that the file exists on the server.
  17446.  
  17447. BPD0011I: No machine name created at WorkSpace On-Demand server.
  17448. Help: Create a machine (client) definition for this machine LAN address on WorkSpace On-Demand
  17449. server.
  17450.  
  17451. BPD0012I: The buffer address passed by OS/2 is invalid.
  17452. Help: Critical OS/2 error. Verify the OS/2 image installed on the WorkSpace On-Demand server's
  17453. client tree is not corrupted.
  17454.  
  17455. BPD0013I: The read request is beyond the end of file.
  17456. Help: Critical OS/2 error. Verify the OS/2 image installed on the WorkSpace On-Demand server's
  17457. client tree is not corrupted.
  17458.  
  17459. BPD0014I: The file data copy from high to low memory failed.
  17460. Help: This might be causing due to int 15 function provided by the BIOS in the system.
  17461. Flash the BIOS if new level BIOS is available.
  17462.  
  17463. BPD0020I: Invalid file handle.
  17464. Help: Internal OS/2 error. If the system boots properly, you may ignore this message,
  17465. because the system recovered from this error.  If the system fails, contact IBM.
  17466.  
  17467. BPD0021I: Not enough memory is available to DHCP boot this machine.
  17468. Help: DHCP boot client machine needs at least 16 MB RAM. If this condition is already
  17469. met then it could be an Internal File System error. Contact IBM.
  17470.  
  17471. BPD0022I: MFSD can not simultaneously open more than one file.
  17472. Help: Critical OS/2 error. Verify the OS/2 image installed on the WorkSpace On-Demand
  17473. server's client tree is not corrupted.
  17474.  
  17475. BPD0023I: The read request is beyond the end of file.
  17476. Help: Internal OS/2 error. If the system boots properly, you may ignore this message,
  17477. because the system recovered from this error. If the system fails then verify that the
  17478. OS/2 image installed on the WorkSpace On-Demand server's client tree is not corrupted.
  17479.  
  17480. BPD0024I: Unable to initialize MFSD data structures.
  17481. Help: Critical OS/2 error. Verify the OS/2 image installed on the WorkSpace On-Demand
  17482. server's client tree is not corrupted.
  17483.  
  17484. BPD0025I: Error handling FIT file.
  17485. Help: FIT file size is greater than 64K. Reduce the size of the fit file and reboot
  17486. the client machine.
  17487.  
  17488. BPD0026I: Network access denied.
  17489. Help: A program has attempted to access a file that it does not have permission to
  17490. access. If the system functions properly, you may ignore this message. Otherwise a
  17491. program is probably attempting to write or replace a file to which it has only read
  17492. or execute authority.
  17493.  
  17494.  
  17495. ΓòÉΓòÉΓòÉ 25. Notices ΓòÉΓòÉΓòÉ
  17496.  
  17497. This information was developed for products and services offered in the U.S.A. 
  17498. IBM may not offer the products, services, or features discussed in this 
  17499. document in other countries. Consult your local IBM representative for 
  17500. information on the products and services currently available in your area. Any 
  17501. reference to an IBM product, program, or service is not intended to state or 
  17502. imply that only that IBM product, program, or service may be used. Any 
  17503. functionally equivalent product, program, or service that does not infringe any 
  17504. IBM intellectual property right may be used instead.  However, it is the user's 
  17505. responsibility to evaluate and verify the operation of any non-IBM product, 
  17506. program, or service. 
  17507.  
  17508. IBM may have patents or pending patent applications covering subject matter in 
  17509. this document. The furnishing of this document does not give you any license to 
  17510. these patents. You can send license inquiries, in writing, to: 
  17511.  
  17512. IBM Director of Licensing
  17513. IBM Corporation
  17514. North Castle Drive
  17515. Armonk, NY  10504-1785
  17516. U.S.A.
  17517.  
  17518. For license inquiries regarding double-byte (DBCS) information, contact the IBM 
  17519. Intellectual Property Department in your country or send inquiries, in writing, 
  17520. to: 
  17521.  
  17522. IBM World Trade Asia Corporation Licensing
  17523. 2-31 Roppongi 3-chome, Minato-ku
  17524. Tokyo 106, Japan
  17525.  
  17526. The following paragraph does not apply to the United Kingdom or any other 
  17527. country where such provisions are inconsistent with local law: INTERNATIONAL 
  17528. BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT 
  17529. WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, 
  17530. THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A 
  17531. PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied 
  17532. warranties in certain transactions, therefore, this statement may not apply to 
  17533. you. 
  17534.  
  17535. This information could include technical inaccuracies or typographical errors. 
  17536. Changes are periodically made to the information herein; these changes will be 
  17537. incorporated in new editions of the information.  IBM may make improvements 
  17538. and/or changes in the product(s) and/or the program(s) described in this 
  17539. information at any time without notice. 
  17540.  
  17541. Any references in this information to non-IBM Web sites are provided for 
  17542. convenience  only and do not in any manner serve as an endorsement of those Web 
  17543. sites.  The  materials at those Web sites are not part of the materials for 
  17544. this IBM product and use  of those Web sites is at your own risk. 
  17545.  
  17546. IBM may use or distribute any of the information you supply in any way it 
  17547. believes appropriate without incurring any obligation to you. 
  17548.  
  17549. Licensees of this program who wish to have information about it for the purpose 
  17550. of enabling:  (i) the exchange of information between independently created 
  17551. programs and other programs (including this one) and (ii) the mutual use of the 
  17552. information which has been exchanged, should contact: 
  17553.  
  17554. IBM Corporation
  17555. Department LZKS
  17556. 11400 Burnet Road
  17557. Austin, TX 78758
  17558. U.S.A.
  17559.  
  17560. Such information may be available, subject to appropriate terms and conditions, 
  17561. including in some cases, payment of a fee. 
  17562.  
  17563. The licensed program described in this document and all licensed material 
  17564. available for it are provided by IBM under terms of the IBM Customer Agreement, 
  17565. IBM International Program License Agreement, or any equivalent agreement 
  17566. between us. 
  17567.  
  17568. Any performance data contained herein was determined in a controlled 
  17569. environment.  Therefore, the results obtained in other operating environments 
  17570. may vary significantly.  Some measurements may have been made on 
  17571. development-level systems and there is no guarantee that these measurements 
  17572. will be the same on generally available systems. Furthermore, some measurement 
  17573. may have been estimated through extrapolation.  Actual results may vary. Users 
  17574. of this document should verify the applicable data for their specific 
  17575. environment. 
  17576.  
  17577. Information concerning non-IBM products was obtained from the suppliers of 
  17578. those products, their published announcements or other publicly available 
  17579. sources.  IBM has not tested those products and cannot confirm the accuracy of 
  17580. performance, compatibility or any other claims related to non-IBM products. 
  17581. Questions on the capabilities of non-IBM products should be addressed to the 
  17582. suppliers of those products. 
  17583.  
  17584. All statements regarding IBM's future direction or intent are subject to change 
  17585. or withdrawal without notice, and represent goals and objectives only. 
  17586.  
  17587. All IBM prices shown are IBM's suggested retail prices, are current and are 
  17588. subject to change without notice.  Dealer prices may vary. 
  17589.  
  17590.  
  17591. ΓòÉΓòÉΓòÉ 25.1. Trademarks ΓòÉΓòÉΓòÉ
  17592.  
  17593. The following terms are trademarks of International Business Machines 
  17594. Corporation in the United States, or other countries, or both: 
  17595.  
  17596. AT
  17597. Extended Services
  17598. First Failure Support Technology/2
  17599. FFST/2
  17600. IBM
  17601. LANStreamer
  17602. Micro Channel
  17603. OS/2
  17604. Presentation Manager
  17605. SP
  17606. WIN-OS/2
  17607.  
  17608. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of 
  17609. Microsoft Corporation in the United States and/or other countries. 
  17610.  
  17611. Other company, product, and service names may be trademarks or service marks of 
  17612. others.