home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / nsc12.zip / nscug.INF (.txt) < prev    next >
OS/2 Help File  |  1996-07-18  |  212KB  |  8,807 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Version Notice ΓòÉΓòÉΓòÉ
  3.  
  4. Second Edition (June 1993) 
  5.  
  6. This edition replaces and makes obsolete the previous edition. 
  7.  
  8. This edition contains changes for Network SignON Coordinator/2 Version 1.2. 
  9. This release contains several functional enhancements. For a detailed list of 
  10. enhancements and changes, see Summary of Changes. 
  11.  
  12. The following paragraph does not apply to the United Kingdom or any country 
  13. where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS 
  14. MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY 
  15. KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
  16. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states 
  17. do not allow disclaimer of express or implied warranties in certain 
  18. transactions; therefore, this statement may not apply to you. 
  19.  
  20. This publication could include technical inaccuracies or typographical errors. 
  21. Changes are periodically made to the information herein; these changes will be 
  22. incorporated in new editions of the publication. IBM may make improvements 
  23. and/or changes in the product(s) and/or the program(s) described in this 
  24. publication at any time. 
  25.  
  26. It is possible that this publication may contain reference to, or information 
  27. about, IBM products (machines and programs), programming, or services that are 
  28. not announced in your country.  Such references or information must not be 
  29. construed to mean that IBM intends to announce such IBM products, programming, 
  30. or services in your country. 
  31.  
  32. Requests for copies of this publication and for technical information about IBM 
  33. products should be made to your IBM Authorized Dealer or your IBM Marketing 
  34. Representative. 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 2. Notices ΓòÉΓòÉΓòÉ
  38.  
  39. References in this publication to IBM products, programs, or services do not 
  40. imply that IBM intends to make these available in all countries in which IBM 
  41. operates. Any reference to an IBM product, program, or service is not intended 
  42. to state or imply that only IBM's product, program, or service may be used. Any 
  43. functionally equivalent product, program, or service that does not infringe any 
  44. of IBM's intellectual property rights or other legally protectible rights may 
  45. be used instead of the IBM product, program, or service. Evaluation and 
  46. verification of operation in conjunction with other products, programs, or 
  47. services, except those expressly designated by IBM, are the user's 
  48. responsibility. 
  49.  
  50. IBM may have patents or pending patent applications covering subject matter in 
  51. this document. The furnishing of this document does not give you any rights to 
  52. these patents. You can inquire, in writing, to the IBM Director of Commercial 
  53. Relations, IBM Corporation, Purchase, NY 10577 - USA. 
  54.  
  55. For online versions of this book, we authorize you to: 
  56.  
  57.      Copy, modify, and print the documentation contained on the media, for use 
  58.       within your enterprise, provided you reproduce the copyright notice, all 
  59.       warning statements, and other required statements on each copy or partial 
  60.       copy. 
  61.      Transfer the original unaltered copy of the documentation when you 
  62.       transfer the related IBM product (which may be either machines you own, 
  63.       or programs, if the program's license terms permit a transfer). You must, 
  64.       at the same time, destroy all other copies of the documentation. 
  65.  
  66.  You are responsible for payment of any taxes, including personal property 
  67.  taxes, resulting from this authorization. 
  68.  
  69.  THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF 
  70.  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
  71.  
  72.  Some jurisdictions do not allow the exclusion of implied warranties, so the 
  73.  above exclusion may not apply to you. 
  74.  
  75.  Your failure to comply with the terms above terminates this authorization. 
  76.  Upon termination, you must destroy your machine readable documentation. 
  77.  
  78.  The following terms, denoted by an asterisk (*) in this publication, are 
  79.  trademarks of the IBM Corporation in the United States and/or other countries: 
  80.  
  81.   IBM                          C Set/2                  System/370
  82.   Operating System/2           OS/2                     CICS/ESA
  83.   Personal System/2            PS/2                     MVS/ESA
  84.   Extended Services            OfficeVision             RACF
  85.   Extended Services for OS/2   OfficeVision/VM          VTAM
  86.   Presentation Manager         AS/400                   OS/400
  87.   Distributed Database         DB2
  88.    Connection Services/2
  89.  
  90.  The following terms, denoted by a double asterisk (**) in this publication, 
  91.  are trademarks of other companies: 
  92.  
  93.      Microsoft and Windows are registered trademarks of Microsoft Corporation. 
  94.  
  95.      Novell, NetWare, and NetWare Requester for OS/2 are registered trademarks 
  96.       of Novell, Inc. 
  97.  
  98.      RUMBA is a registered trademark of Wall Data Incorporated. 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 3. About This Book ΓòÉΓòÉΓòÉ
  102.  
  103. This book describes the tasks required to install, configure, and use Network 
  104. SignON Coordinator/2 (NSC). NSC is a productivity aid for either DOS or OS/2(*) 
  105. end users whose environment includes either multiple LAN Servers or multiple 
  106. central site host computer facilities. NSC synchronizes password changes for 
  107. all the end user's security signons and can also automate their host and LAN 
  108. Server logons. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 3.1. Before you Begin ΓòÉΓòÉΓòÉ
  112.  
  113. You should be familiar with OS/2. You may also need to be familiar with your 
  114. LAN and emulator support software. 
  115.  
  116. If you will be configuring NSC, you will need to be familiar with a text editor 
  117. or word processor in order to edit and work with the NSC Configuration file. If 
  118. you are not familiar with such an editor, see your operating system 
  119. documentation. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 3.2. Who Should Use This Book ΓòÉΓòÉΓòÉ
  123.  
  124. This book assists the network administrator in the following tasks: 
  125.  
  126.      Planning and preparing for NSC installation. 
  127.  
  128.      Configuring NSC for each end user and NSC Servers. 
  129.  
  130.      Customizing NSC to address additional needs. 
  131.  
  132.      Problem determination. 
  133.  
  134.  This book also contains information for the end user about the commands they 
  135.  use to execute NSC. Finally, this book describes information used by 
  136.  application programmers to interface directly with NSC. 
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 3.3. How This Book Is Structured ΓòÉΓòÉΓòÉ
  140.  
  141. This book is organized as follows: 
  142.  
  143.       Overview and information on supported configurations with their 
  144.       prerequisites (see Introduction) 
  145.  
  146.       Information for the end user of NSC (see Using Network SignON 
  147.       Coordinator/2) 
  148.  
  149.       Installation instructions (see Installing Network SignON Coordinator/2) 
  150.  
  151.       Configuration instructions (see Configuring Network SignON Coordinator/2) 
  152.  
  153.       A programmer's guide for using the OS/2 API and Toolkit (see Using the 
  154.       Application Programming Interface) 
  155.  
  156.       An appendix of error messages and explanations (see Messages) 
  157.  
  158.       An appendix describing problem determination and log messages (see 
  159.       Problem Determination) 
  160.  
  161.       An appendix on how to write an Exit Routine (see Exit Routines) 
  162.  
  163.       An appendix on changes in this version (see Summary of Changes) 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 3.3.1. Conventions ΓòÉΓòÉΓòÉ
  167.  
  168. This book uses the following terminology conventions unless otherwise noted: 
  169.  
  170.      LAN Server 
  171.  
  172.       Is a general term which refers to any of the following products which 
  173.       provide a server capability: 
  174.  
  175.         -  IBM OS/2 LAN Server Version 1.3 or later. 
  176.  
  177.         -  Novell(**) NetWare(**) Version 3.11 
  178.  
  179.      DOS 
  180.  
  181.       Refers to IBM DOS Version 3.3 or later. 
  182.  
  183.      Communications Manager 
  184.  
  185.       Refers to one of the following products: 
  186.  
  187.         -  IBM OS/2 Extended Edition 1.3 (EE 1.3) Communications Manager 
  188.  
  189.         -  IBM OS/2 Extended Services(*) 1.0 (ES 1.0) Communications Manager 
  190.  
  191.         -  IBM Communications Manager/2 Version 1.0 or later. 
  192.  
  193.      LAN Support Program 
  194.  
  195.       Refers to the version of the IBM LAN Support Program that is included 
  196.       with the IBM LAN Server. 
  197.  
  198.      Emulator support 
  199.  
  200.       Is a general term which refers to software providing 3270 or 5250 
  201.       terminal emulation communications between a PC and another computer. 
  202.  
  203.  Note:   Highlighting may vary online depending on the type of display. 
  204.  
  205.  The following text conventions are used: 
  206.  
  207.  Bold          Bold print indicates choices made from a menu or action bar. 
  208.  
  209.  Italics       Italics introduces new terms in the text and indicates 
  210.                variables. 
  211.  
  212.  UPPERCASE     Uppercase letters are used for commands, and for directory, 
  213.                device, and file names. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 3.4. Related Publications ΓòÉΓòÉΓòÉ
  217.  
  218. The following is a list of related publications.  For information about 
  219. ordering these publications, contact your IBM authorized dealer or IBM 
  220. marketing representative. 
  221.  
  222.      RACF/MVS General Information, GC28-0722 
  223.  
  224.      MVS/ESA General Information, GC28-1600 
  225.  
  226.      Local Area Network Technical Reference, SC30-3383 
  227.  
  228.      IBM Extended Edition Version 1.3 Programming Services and Advanced 
  229.       Problem Determination for Communications. 
  230.  
  231.      IBM Extended Services for OS/2 Programming Services and Advanced Problem 
  232.       Determination for Communications. 
  233.  
  234.  
  235. ΓòÉΓòÉΓòÉ 4. Introduction ΓòÉΓòÉΓòÉ
  236.  
  237. This chapter describes Network SignON Coordinator/2 (NSC) and defines its 
  238. prerequisites and supported configurations. 
  239.  
  240. Overview explains NSC's functions and the terms used in later sections. 
  241.  
  242. DOS Clients explains the prerequisites and supported function for NSC DOS 
  243. Clients. 
  244.  
  245. OS/2 Clients explains the prerequisites and supported function for NSC OS/2 
  246. Clients. 
  247.  
  248. NSC Server explains the prerequisites and supported function for NSC Servers. 
  249.  
  250. Host Systems explains the prerequisites and supported function for hosts. 
  251.  
  252. RAM and DASD requirements gives RAM and Disk requirements. 
  253.  
  254. Security Considerations gives some security considerations. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 4.1. Overview ΓòÉΓòÉΓòÉ
  258.  
  259. Network SignON Coordinator/2 is a productivity aid for DOS and OS/2 end users 
  260. whose environment requires multiple user signons to different access control 
  261. functions. OS/2 User Profile Management (UPM), IBM LAN Server, and Resource 
  262. Access Control Facility (RACF) are examples of access control functions. NSC 
  263. refers to these access control functions as "locations". Each location requires 
  264. you to signon with an ID and a password before providing access to its 
  265. resources. NSC allows you to signon, change passwords, and signoff at one or 
  266. more locations with a single operation. A signon, change password, or signoff 
  267. operation is referred to as a "request". 
  268.  
  269. Locations are defined in the NSC configuration file (NSC.INI). The location 
  270. definition can contain a User ID to be used for request processing. The same 
  271. location can be defined as many times as necessary to include all IDs you have 
  272. at that location. NSC prompts for your current password and User ID (if 
  273. unknown). NSC then combines the location information, User ID, and password to 
  274. process your request. NSC assumes you have the same password at all locations. 
  275. Password change requests are performed at all locations. Signon requests, 
  276. however, are only performed at selected locations based on the location 
  277. definition. The signoff request signs you off all systems logged on to by a 
  278. signon request. Using the graphical interface, you can selectively signon or 
  279. signoff a particular location using any ID you defined for that location. This 
  280. provides an easy method of accessing a location without affecting your current 
  281. access at other locations. 
  282.  
  283. NSC operates as a Client (DOS and OS/2) and as a Server (OS/2 only) 
  284. configuration. Figure "NSC Configurations", below, shows how these NSC 
  285. configurations relate to locations and the requests that each supports. 
  286.  
  287.  
  288. NSC Configurations
  289.  
  290.  
  291.                     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  292.                     Γöé          Host             Γöé
  293.                     Γöé                           Γöé
  294.                     Γöé    VM     MVS   OS/400(*) Γöé
  295.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  296.                                     
  297.               ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   Γöé   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  298.               Γöé                   Γöé                   Γöé
  299.        ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  300.        Γöé NSC Client  Γöé     Γöé NSC Server  Γöé     Γöé NSC Client  Γöé
  301.        Γöé             Γöé     Γöé             Γöé     Γöé             Γöé
  302.        Γöé Change Pswd Γöé     Γöé Change Pswd Γöé     Γöé Change Pswd Γöé
  303.        Γöé Signon      Γöé     Γöé             Γöé     Γöé Signon      Γöé
  304.        Γöé Signoff     Γöé     Γöé             Γöé     Γöé Signoff     Γöé
  305.        Γöé             Γöé     Γöé             Γöé     Γöé             Γöé
  306.        Γöé    OS/2     Γöé     Γöé    OS/2     Γöé     Γöé     DOS     Γöé
  307.        ΓööΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÿ
  308.             Γöé   Γöé                                 Γöé   Γöé
  309.             Γöé   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ       ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   Γöé
  310.             ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  311.                                      
  312.                     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  313.                     Γöé        LAN Server         Γöé
  314.                     Γöé                           Γöé
  315.                     Γöé NetWare    IBM LAN Server Γöé
  316.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  317.  
  318. The boxes in the middle of Figure "NSC Configurations" show the major NSC 
  319. configurations -- the Client  and the Server. NSC uses location definitions to 
  320. determine how to process a request (signon, change password, and signoff). The 
  321. location definitions are: 
  322.  
  323.      LANServer 
  324.  
  325.       Specifies the name of an IBM OS/2 LAN Server domain or Novell NetWare 
  326.       file server to process the user request. Multiple LAN Server definitions 
  327.       can be specified. Options include: 
  328.  
  329.         -  Use a User ID other than the default. 
  330.  
  331.         -  Log the user onto the LANServer for default signons. 
  332.  
  333.         -  Execute an Exit Routine after performing the request. 
  334.  
  335.       If the user provides a new password, NSC processes a password change for 
  336.       all LAN Servers defined. 
  337.  
  338.      Local 
  339.  
  340.       Specifies that OS/2 User Profile Management (UPM) is to process the user 
  341.       request. A Local Logon is performed for a signon. Multiple Local 
  342.       definitions can be specified. Options include: 
  343.  
  344.         -  Use a User ID other than the default. 
  345.  
  346.         -  Log the user on for default signons. 
  347.  
  348.         -  Execute an Exit Routine after performing the request. 
  349.  
  350.       If the user provides a new password, NSC processes a password change for 
  351.       all Local definitions. 
  352.  
  353.      Node 
  354.  
  355.       Specifies that OS/2 UPM is to process the user request. A Node Logon is 
  356.       performed for a signon. Multiple Node definitions can be specified. 
  357.       Options include: 
  358.  
  359.         -  Use a User ID other than the default. 
  360.  
  361.         -  Log the user on for default signons. 
  362.  
  363.         -  Execute an Exit Routine after performing the request. 
  364.  
  365.       If the user provides a new password, NSC updates all Node logons. 
  366.  
  367.      Host 
  368.  
  369.       Specifies a host system to process the user request and the type of host 
  370.       connection. MVS, VM, and AS/400 can be host locations. Multiple Host 
  371.       definitions can be specified. 
  372.  
  373.       NSC supports two types of host connections: 
  374.  
  375.         -  3270 or 5250 terminal emulation 
  376.  
  377.            NSC can use a terminal emulation session with a host computer via 
  378.            Emulator High-Level Language Application Programming Interface 
  379.            (EHLLAPI). EHLLAPI is provided by emulators on an OS/2 or DOS 
  380.            workstation to access a host terminal presentation space for 3270 
  381.            and 5250 terminal emulators. MVS, VM, and AS/400 are examples of IBM 
  382.            systems that support these types of terminals. 
  383.  
  384.         -  Advanced Program to Program Communications (APPC) 
  385.  
  386.            APPC is an implementation of Systems Network Architecture (SNA) for 
  387.            logical unit (LU) type 6.2. It provides, distributed transaction 
  388.            processing, in which two or more programs cooperate to carry out 
  389.            some processing function. MVS/ESA is the only host system with which 
  390.            NSC on OS/2 can communicate using APPC. 
  391.  
  392.       Options include: 
  393.  
  394.         -  Use a User ID other than the default. 
  395.  
  396.         -  Log the user on to multiple host terminal emulation sessions for 
  397.            default signons. 
  398.  
  399.         -  Check the password as valid and active (not expired) at a host 
  400.            connected via APPC during default signons. 
  401.  
  402.         -  Execute an Exit Routine after performing the request. 
  403.  
  404.       If the user provides a new password, NSC processes a password change for 
  405.       all Host definitions. 
  406.  
  407.  NSC Server processing is initiated by the NSC Client when it processes 
  408.  definitions in its NSC configuration file which follow an NSC Server 
  409.  definition. The NSC Server capability provides remote UPM password changes, 
  410.  increases flexibility in host connectivity, and extends the capabilities of 
  411.  the NSC DOS Client. For example, in an IBM OS/2 Database Manager environment, 
  412.  you can run the NSC Server in the Database Server machine and change a user's 
  413.  password from that user's NSC Client. 
  414.  
  415.  Network SignON Coordinator/2 provides additional features for users to 
  416.  customize their system, including: 
  417.  
  418.      User Exits for additional coordination or synchronization of signons, 
  419.       password changes, and signoffs. 
  420.  
  421.      The ability to specify different User IDs on each system. 
  422.  
  423.      Configuration options for User ID character set, User ID length, and 
  424.       password length. 
  425.  
  426.      The ability to access configuration files from a remote LAN node for a 
  427.       specific user or group of users. 
  428.  
  429.      Dynamic host emulator session allocation. 
  430.  
  431.      An OS/2 API and toolkit that supports all of the function of NSC while 
  432.       bypassing the user interface. 
  433.  
  434.      Queueing requests to hosts, LAN Servers, or NSC Servers when the remote 
  435.       locations are not online. 
  436.  
  437.  Users in the double-byte character set (DBCS) environment are limited to using 
  438.  single-byte characters in their User IDs and passwords. 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 4.2. Configurations and Prerequisites ΓòÉΓòÉΓòÉ
  442.  
  443. NSC operates in three different configurations: DOS Client, OS/2 Client, and 
  444. NSC Server. See the following sections for details about each configuration: 
  445.  
  446.      DOS Clients 
  447.  
  448.      OS/2 Clients 
  449.  
  450.      NSC Server 
  451.  
  452.  For details on Host system requirements, see Host Systems. For RAM and Disk 
  453.  requirements, see RAM and DASD requirements. 
  454.  
  455.  
  456. ΓòÉΓòÉΓòÉ 4.2.1. DOS Clients ΓòÉΓòÉΓòÉ
  457.  
  458. The NSC DOS Client requires: 
  459.  
  460.      DOS Version 3.3 or later. 
  461.      For NSC Server requests, NETBIOS support must be installed. This support 
  462.       can be provided by any product conforming to the DOS NETBIOS software 
  463.       specification as defined in the Local Area Network Technical Reference, 
  464.       SC30-3383. 
  465.      For IBM LAN Server Domain requests, IBM OS/2 LAN Server Version 1.3 or 
  466.       later (DOS LAN Requester component). 
  467.      For Novell NetWare Version 3.11 file server requests, the appropriate 
  468.       NetWare configuration for the level of DOS as defined by Novell must be 
  469.       installed. 
  470.  
  471.  
  472.  
  473.      For host emulator sessions, terminal emulation software that provides an 
  474.       EHLLAPI X'7F' software interrupt handler. 
  475.  
  476.       The following emulators have been validated: 
  477.            IBM PC 3270 Emulation Program Entry Level Version 2.0 and 3.0 
  478.            IBM Personal Communication/3270 (DOS Mode) Version 2.0 and 3.0 
  479.            IBM Personal Communication/3270 (Windows(**) Mode) Version 3.0 (1) 
  480.            RUMBA(**) for the Mainframe Version 3.1, Update 05 (1) 
  481.            RUMBA for the AS/400 Version 1.0, Update 03, with PTF 8757 (1). 
  482.  
  483.       (1) Works in Windows 386/486 Enhanced mode only. 
  484.  
  485.  The NSC DOS Client has the following function: 
  486.  
  487.      Client Functions 
  488.  
  489.       The NSC DOS Client can request a signon, password change, or signoff for 
  490.       LAN Servers or hosts connected to the client. 
  491.  
  492.       If the user requests a password change while signed on to the LAN Server, 
  493.       the user remains signed on. If the user is not signed on to a LAN Server, 
  494.       the user is signed on, the password is changed, and the user is signed 
  495.       off. 
  496.  
  497.      Server Functions 
  498.  
  499.       The NSC DOS Client can utilize all the functions provided by the NSC 
  500.       Server. 
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ 4.2.2. OS/2 Clients ΓòÉΓòÉΓòÉ
  504.  
  505. The NSC OS/2 Client requires: 
  506.  
  507.      OS/2 Version 1.3 or later. 
  508.      NETBIOS support 
  509.      For IBM LAN Server Domain requests, IBM OS/2 LAN Server Version 1.3 or 
  510.       later (either the LAN Requester or LAN Server component). 
  511.      For Novell NetWare Version 3.11 file server requests, the NetWare 
  512.       Requester must be installed on OS/2 2.0 or later. 
  513.      For local UPM requests, one of the following: 
  514.            IBM OS/2 Extended Edition 1.3 (EE 1.3) 
  515.            IBM OS/2 Extended Services 1.0 (ES 1.0) 
  516.            IBM OS/2 LAN Server Version 1.3 or later (either the LAN Requester 
  517.            or LAN Server component). 
  518.            IBM Communications Manager/2 Version 1.0 (CM/2 1.0) or later. 
  519.      For requests to hosts connected to the Client, Communications Manager 
  520.       from either EE 1.3, ES 1.0 or CM/2 1.0. 
  521.  
  522.  The NSC OS/2 Client has the following function: 
  523.  
  524.      Client Functions 
  525.  
  526.       The NSC OS/2 Client can request a signon, password change, or signoff for 
  527.       a LAN Server, local UPM accounts, UPM node logons, or hosts connected to 
  528.       the client. 
  529.  
  530.      Server Functions 
  531.  
  532.       The NSC OS/2 Client can utilize all the functions provided by the NSC 
  533.       Server. 
  534.  
  535.      Queueing of Retries 
  536.  
  537.       If a LAN Server, local UPM, host, or NSC Server does not respond to a 
  538.       request, the NSC OS/2 Client can place the request on a retry queue if 
  539.       the NSC Retry Process has been started. 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 4.2.3. NSC Server ΓòÉΓòÉΓòÉ
  543.  
  544. The NSC Server requires: 
  545.  
  546.      OS/2 Version 1.3 or 2.0, or OS/2 Warp 
  547.      NETBIOS support 
  548.      For local UPM requests, one of the following: 
  549.            IBM OS/2 Extended Edition 1.3 (EE 1.3) 
  550.            IBM OS/2 Extended Services 1.0 (ES 1.0) 
  551.            IBM OS/2 LAN Server Version 1.3 or later (either the LAN Requester 
  552.            or LAN Server component). 
  553.            IBM Communications Manager/2 Version 1.0 (CM/2 1.0) or later. 
  554.      For requests to hosts connected to the Server, Communications Manager 
  555.       from either EE 1.3, ES 1.0 or CM/2 1.0. 
  556.  
  557.  The NSC Server has the following function: 
  558.  
  559.      Server Functions 
  560.  
  561.       The NSC Server can process requests from NSC Clients for password changes 
  562.       for local UPM accounts or hosts connected to the NSC Server. The NSC 
  563.       Server can also process signon verification requests from NSC Clients for 
  564.       hosts connected via APPC. 
  565.  
  566.       The NSC Server can be a single point for an administrator to maintain all 
  567.       the NSC configuration files needed by the NSC Client workstations. The 
  568.       NSC Clients are configured to request their configuration files from an 
  569.       NSC Server. The Clients then access the configuration files at the Server 
  570.       based on the ID of the user signed on to the workstation. 
  571.  
  572.      Queueing of Retries 
  573.  
  574.       If the local UPM or a host does not respond to a request, the NSC Server 
  575.       can place the request on a retry queue if the NSC Retry Process has been 
  576.       started. 
  577.  
  578.  
  579. ΓòÉΓòÉΓòÉ 4.2.4. Host Systems ΓòÉΓòÉΓòÉ
  580.  
  581. Network SignON Coordinator/2 communicates to host systems using APPC on OS/2 or 
  582. host emulator sessions on DOS or OS/2. The following defines the host system 
  583. support requirements for these connections. 
  584.  
  585.      Emulator Sessions 
  586.  
  587.       NSC interfaces with PC communications software packages which support 
  588.       3270 or 5250 terminal emulation and provide EHLLAPI. The supported 
  589.       emulators depend on whether the workstation is using DOS or OS/2. NSC has 
  590.       no special host programming support requirements. 
  591.  
  592.      APPC 
  593.  
  594.       NSC host support via APPC operates only on OS/2 and uses the 
  595.       Communications Manager. The host computer must have MVS/ESA, RACF/MVS, 
  596.       and ACF/VTAM. RACF/MVS verifies and manages passwords. 
  597.  
  598.       The host system must use the MVS/ESA System Product, program product 
  599.       numbers 5695-047 (JES2) or 5695-048 (JES3). See MVS/ESA General 
  600.       Information, GC28-1600 for further information. 
  601.  
  602.       If the host system has MVS/ESA Version 4 Release 3 or later, the 
  603.       following additional software is needed: 
  604.  
  605.         -  RACF/MVS 1.9.2 or later, program product number 5740-XXH. See 
  606.            RACF/MVS General Information, GC28-0722 for further information. 
  607.         -  Appropriate levels of ACF/VTAM, NCP, and SSP. 
  608.  
  609.       If the host system has MVS/ESA Version 4 Release 1 or 2, the following 
  610.       additional software is needed: 
  611.  
  612.         -  CICS/ESA Version 3 Release 3 or later, program product number 
  613.            5685-083. 
  614.         -  RACF/MVS 1.9.0 or later, program product number 5740-XXH. See 
  615.            RACF/MVS General Information, GC28-0722 for further information. 
  616.         -  Appropriate levels of ACF/VTAM, NCP, and SSP. 
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ 4.2.5. RAM and DASD requirements ΓòÉΓòÉΓòÉ
  620.  
  621. Static memory and fixed-disk space requirements for Network SignON 
  622. Coordinator/2 are given in the following table for each configuration: 
  623.  
  624. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  625. Γöé          RAM and DASD Requirements                         Γöé
  626. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  627. Γöé REQUIREMENT  Γöé DOS     Γöé OS/2     Γöé OS/2    Γöé OS/2         Γöé
  628. Γöé              Γöé CLIENT  Γöé CLIENT   Γöé SERVER  Γöé CLIENT/SERVERΓöé
  629. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  630. Γöé Memory       Γöé  160KB  Γöé  170KB   Γöé  130KB  Γöé  200KB       Γöé
  631. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  632. Γöé Fixed-Disk   Γöé  230KB  Γöé  640KB   Γöé  455KB  Γöé  665KB       Γöé
  633. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  634.  
  635. If you do not require APPC Host connections, the fixed-disk space requirements 
  636. for all OS/2 configurations can be reduced by 95K by deleting the sample 
  637. Communications Manager configuration file. 
  638.  
  639. Memory requirements do not include dynamic memory allocated for buffering 
  640. locally accessed configuration files or host information files. 
  641.  
  642.  
  643. ΓòÉΓòÉΓòÉ 4.3. Security Considerations ΓòÉΓòÉΓòÉ
  644.  
  645. Network SignON Coordinator/2 is not a security product; it is a productivity 
  646. aid. However, since it does help the user manage passwords, some care has been 
  647. taken to avoid creating additional security exposures for the user. Review the 
  648. following with respect to your security requirements: 
  649.  
  650.      NSC assumes the user has the same password at all locations. If a user's 
  651.       password is compromised, the security exposure may be greater since all 
  652.       locations can be accessed with that password. 
  653.  
  654.       If this exposure is unacceptable, you should not use NSC. 
  655.  
  656.      NSC can remember the user's password once it has been entered, but only 
  657.       if this option (SAVEPW) is configured. The default operation requires the 
  658.       user to reenter the password each time it is required. 
  659.  
  660.       The password is always discarded when NSC is terminated, even if SAVEPW 
  661.       is configured. 
  662.  
  663.      NSC does not keep passwords in the clear in memory except when necessary 
  664.       to call external application programming interfaces. The password is 
  665.       masked and distributed using a simple reversible algorithm designed to 
  666.       prevent casual viewing of the password. 
  667.  
  668.      NSC does not send passwords from NSC Clients to NSC Servers in the clear. 
  669.       The password is disguised to prevent casual viewing of the password via 
  670.       network analyzers. 
  671.  
  672.      Products supported by NSC send the passwords across the network using 
  673.       different techniques. For information on how passwords are communicated 
  674.       by these products, consult the product information for that product. 
  675.  
  676.      NSC provides no function for restricting access to locations. Access to 
  677.       other locations is controlled by each location's own security facility. 
  678.  
  679.      NSC performs no encryption, and is therefore not subject to any export 
  680.       restriction related to encryption. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 5. Using Network SignON Coordinator/2 ΓòÉΓòÉΓòÉ
  684.  
  685. This chapter contains the following sections, which explain how you interact 
  686. with Network SignON Coordinator/2: 
  687.  
  688.       End User Commands explains how you use the command line interface, DOS 
  689.       menu interface and OS/2 graphical interface. 
  690.  
  691.       Special Considerations discusses specific situations you may encounter. 
  692.  
  693.       NSC Support Processes explains how you start the NSC Server and NSC Retry 
  694.       Process. 
  695.  
  696.  When any of the NSC End User Commands or Support Programs terminate, they set 
  697.  the operating system ERRORLEVEL to one of the following values: 
  698.  
  699.  ERRORLEVEL          Meaning 
  700.  
  701.  0                   No errors or warnings 
  702.  
  703.  1                   One or more warnings (no errors) 
  704.  
  705.  2                   One or more errors 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ 5.1. End User Commands ΓòÉΓòÉΓòÉ
  709.  
  710. The way you use NSC to signon and signoff your personal computer depends on 
  711. which computer interface you prefer: 
  712.  
  713.  Command Line     If you are familiar with operating system commands, the 
  714.                   command line interface is an efficient way to perform NSC 
  715.                   requests. When you type in a command, the results are 
  716.                   displayed as text on the screen. This interface method is 
  717.                   also very useful in building customized command files. If you 
  718.                   create a command file which includes a password, consider the 
  719.                   security exposure of who may gain access to the command file. 
  720.  
  721.                   The command line interface is available for both DOS and OS/2 
  722.                   Clients. The command is described in Command Line Interface. 
  723.  
  724.  Menu             The menu interface requests you to enter information at 
  725.                   prompt fields. You type the required information on the 
  726.                   keyboard. This interface does not display information entered 
  727.                   in password fields. 
  728.  
  729.                   The menu interface is available only for DOS Clients. The 
  730.                   command is described in Menu Interface. 
  731.  
  732.  Graphical        A graphical interface lets you make selections and enter 
  733.                   information using both mouse and keyboard. A graphical 
  734.                   interface is easy to use and lets you enter passwords in 
  735.                   non-displayed fields. You also have easy access to online 
  736.                   help information. NSC messages are presented in a scrollable 
  737.                   area. The graphical interface also supports signon and 
  738.                   signoff for a selected system. 
  739.  
  740.                   The graphical interface is available only for OS/2 Clients. 
  741.                   The command is described in Graphical Interface. 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ 5.1.1. Command Line Interface ΓòÉΓòÉΓòÉ
  745.  
  746. To signon to the locations for which you specified the ON option in your 
  747. configuration, use the NSC command with the ON parameter. The syntax for this 
  748. is: 
  749.  
  750. >>ΓöÇΓöÇNSCΓöÇΓöÇONΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  751.              ΓööΓöÇuseridΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  752.                       ΓööΓöÇcurrentΓöÇpasswordΓöÇΓöÿ
  753.  
  754. If you do not specify your userid and current-password, the menu or graphical 
  755. interface is presented. 
  756.  
  757. To signoff of all locations where you are currently signed on, use the NSC 
  758. command with the OFF parameter. The syntax for this is: 
  759.  
  760. >>ΓöÇΓöÇNSCΓöÇΓöÇOFFΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  761.               ΓööΓöÇuseridΓöÇΓöÿ
  762.  
  763. To change your password at all of your configured locations, use the NSC 
  764. command with the CHGPW parameter. The syntax for this is: 
  765.  
  766. >>ΓöÇΓöÇNSCΓöÇΓöÇCHGPWΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  767.                 ΓööΓöÇuseridΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  768.                          ΓööΓöÇcurrentΓöÇpasswordΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  769.                                             ΓööΓöÇnewΓöÇpasswordΓöÇΓöÿ
  770.  
  771. If you do not specify your userid, current-password and new-password, the menu 
  772. or graphical interface is presented. 
  773.  
  774. Whenever you specify userid with the NSC command, it overrides any USERID 
  775. option in a NSC configuration file. If you type NSC and press Enter without the 
  776. ON, OFF or CHGPW parameter, the menu or graphical interface is presented. If 
  777. you specify all of the parameters required for the operation so that the menu 
  778. or graphical interface is not presented, all of the messages for the requests 
  779. initiated by NSC are written to standard output (the display, unless you 
  780. redirect standard output). 
  781.  
  782.  
  783. ΓòÉΓòÉΓòÉ 5.1.2. Menu Interface ΓòÉΓòÉΓòÉ
  784.  
  785. To use the menu interface for DOS, type NSC and press Enter. The command syntax 
  786. is the same as that defined in Command Line Interface. If you do not specify 
  787. all of the parameters required to execute the command, the menu interface is 
  788. presented. If you specify the ON or CHGPW parameter, the appropriate menu will 
  789. be displayed. If you specify the userid, it overrides any USERID option in a 
  790. NSC configuration file. If you specify the current-password for the CHGPW 
  791. command, it is used for the menu value. 
  792.  
  793. The menu interface displays a full-screen character-mode menu, giving you the 
  794. option to signon, change passwords, or signoff. Signon/signoff for a selected 
  795. system, online information and help are not available from the menu interface. 
  796.  
  797.  
  798. ΓòÉΓòÉΓòÉ 5.1.3. Graphical Interface ΓòÉΓòÉΓòÉ
  799.  
  800. The graphical interface can be initiated by using the mouse to open the icon 
  801. representing NSC in the Network SignON Coordinator/2 folder. 
  802.  
  803. You can also initiate the graphical interface for OS/2 in the same way you 
  804. start the menu interface for DOS -- type NSC and press Enter. The command 
  805. syntax is the same as that defined in Command Line Interface. If you do not 
  806. specify all of the parameters required to execute the command, the graphical 
  807. interface is presented. If you specify the ON or CHGPW parameter, the 
  808. appropriate panel will be displayed. If you specify the userid, it overrides 
  809. any USERID option in a NSC configuration file. If you specify the 
  810. current-password for the CHGPW command, it is used for the panel value. 
  811.  
  812. The graphical interface can also be initiated directly by typing NSCPM and 
  813. pressing Enter. In fact, the icon representing NSC in the Network SignON 
  814. Coordinator/2 folder does just that. NSCPM is the Presentation Manager (PM) 
  815. program. It should be used when starting NSC from a folder because it avoids 
  816. starting a full screen program for NSC first. The command syntax for NSCPM is 
  817. the same as that defined for NSC in Command Line Interface. It always presents 
  818. the graphical interface. 
  819.  
  820. When you start the graphical interface, a logo panel is conditionally 
  821. displayed. The duration for which it is displayed is controlled by your OS/2 
  822. System setting for logos. 
  823.  
  824. The graphical interface opens two Presentation Manager windows. In the primary 
  825. window, NSC displays icons indicating the status of each location where you can 
  826. sign on (icons are not displayed for locations where signon is not allowed). If 
  827. you are currently signed on to a location, the icon is displayed with a shaded 
  828. workstation screen and a connection indicator if the location is not Local, and 
  829. the User ID signed on is displayed (in this case, if the User ID is displayed 
  830. as "<Unknown>", this indicates NSC is not certain of the signed on User ID). If 
  831. you are signed on to a host emulation session, the session id is displayed 
  832. after the host name. Double clicking on the icon will sign you off. 
  833.  
  834. If you are not currently signed on to a location, the icon is displayed with a 
  835. clear workstation screen and no connection indicator, and no User ID is 
  836. displayed (in this case, if the User ID is displayed as "<Unknown>", this 
  837. indicates NSC is not certain of the signon state). Double clicking on the icon 
  838. will sign you on using the User ID for the first definition for this location. 
  839.  
  840. The action bar menu provides the following menu hierarchy of functions: 
  841.  
  842.      Actions 
  843.         -  Signon 
  844.             --  Default Systems -- Signon to the locations for which you 
  845.                 specified the ON option in your configuration. 
  846.             --  Selected Systems -- Signon to the currently selected (cursored) 
  847.                 location. 
  848.         -  Change Password... -- Change passwords at all configured locations. 
  849.         -  Signoff 
  850.             --  All Systems -- Signoff of all locations where you are currently 
  851.                 signed on. 
  852.             --  Selected System -- Signoff of the currently selected (cursored) 
  853.                 location. 
  854.         -  Exit -- Exit NSC. 
  855.      Options 
  856.         -  Show/Hide Messages -- Display or minimize the Messages window 
  857.            (depending on the current state of the window). 
  858.      Help 
  859.         -  Using help -- Display instructions on using the help facility. 
  860.         -  General help -- Display help for NSC. 
  861.         -  Keys help -- Display help on keys. 
  862.         -  Reference Information -- Display the NSC online reference 
  863.            information. 
  864.         -  Product Information -- Display the NSC logo and product information. 
  865.  
  866.  Clicking the right mouse button on an icon will cause a menu of available 
  867.  actions to be displayed for the location, including a signon action for each 
  868.  User ID defined for the location. Clicking the right mouse button in the 
  869.  client area but not on an icon will cause a menu of available actions to be 
  870.  displayed for all locations. 
  871.  
  872.  As actions are performed, messages are written to the list box in the Messages 
  873.  window (the second PM window opened by NSC). The window may be scrolled back 
  874.  to review messages. New messages will always cause the list box to be scrolled 
  875.  to the end so the new message will be visible. Help for error messages is 
  876.  provided by selecting the message in the list box. 
  877.  
  878.  If you move or resize either of the NSC windows, NSC will remember the 
  879.  position and size of the windows the next time you start the graphical 
  880.  interface. You can start multiple PM sessions running the graphical interface; 
  881.  however, only one set of window locations/sizes is saved. 
  882.  
  883.  
  884. ΓòÉΓòÉΓòÉ 5.2. Special Considerations ΓòÉΓòÉΓòÉ
  885.  
  886. Password Change Considerations discusses what to do when your passwords get out 
  887. of sync between computer systems. 
  888.  
  889. If you have a LOCAL signon and use EE 1.3 or have a LANSERVER signon and use 
  890. IBM LAN Server 1.3, you should review the information in Incorrect Passwords. 
  891.  
  892.  
  893. ΓòÉΓòÉΓòÉ 5.2.1. Password Change Considerations ΓòÉΓòÉΓòÉ
  894.  
  895. This section describes what to do when an error occurs while changing a 
  896. password.  It also explains the steps to take the first time you use NSC. 
  897.  
  898. When you change your password, Network SignON Coordinator/2 attempts to make 
  899. the change on every computer system defined in the NSC configuration file. 
  900. Occasionally a password change cannot be processed (e.g., the communication 
  901. link to the host system is down) or the request fails for another reason. NSC 
  902. displays an error message on your screen, but it changes your password at all 
  903. the other systems. For example, suppose the NSC configuration file contained 
  904. the following three system definitions: 
  905.  
  906.  
  907.   HOST,NAME=SYSTEM1,...
  908.   HOST,NAME=SYSTEM2,...
  909.   HOST,NAME=SYSTEM3,...
  910.  
  911. Assume your current password is BLUE and you decide to change it to RED. Using 
  912. NSC, you make a change password request, which results in these actions: 
  913.  
  914.    1. Password changed to RED on SYSTEM1 
  915.  
  916.    2. Password change fails on SYSTEM2 
  917.  
  918.    3. Password changed to RED on SYSTEM3 
  919.  
  920.  Your passwords are now out of sync. SYSTEM2 has the password BLUE. 
  921.  
  922.  How do you straighten this mess out? 
  923.  
  924.  When SYSTEM2 is available, repeat the change password request using BLUE as 
  925.  your current password and RED as your new password. This results in the 
  926.  following actions: 
  927.  
  928.    1. Password change fails on SYSTEM1 
  929.  
  930.    2. Password changed to RED on SYSTEM2 
  931.  
  932.    3. Password change fails on SYSTEM3 
  933.  
  934.  You can ignore the failures reported from SYSTEM1 and SYSTEM3 because your 
  935.  first password change request was successful. Should SYSTEM2 fail again, 
  936.  repeat the process when the failure has been corrected. You should repeat this 
  937.  process until all of your system passwords are back in sync. If the password 
  938.  change failed because the new password is not acceptable, pick another new 
  939.  password and follow the password change process. 
  940.  
  941.  When you first use NSC, you probably will have different passwords on each 
  942.  system defined in the NSC configuration file. You should choose a new password 
  943.  acceptable on all your systems, and use NSC to make a password change. 
  944.  Remember to repeat the request using each system's current password until you 
  945.  get them all in sync. 
  946.  
  947.  You should not attempt a LAN Server domain password change more than once when 
  948.  logged on to a LAN Server domain. If you need to repeat a password change to 
  949.  get your passwords in sync and have a LAN Server domain, perform a signoff 
  950.  request before starting. 
  951.  
  952.  
  953. ΓòÉΓòÉΓòÉ 5.2.2. Incorrect Passwords ΓòÉΓòÉΓòÉ
  954.  
  955. If you have a LOCAL signon and use EE 1.3 or have a LANSERVER signon and use 
  956. IBM LAN Server 1.3, then review the following information. 
  957.  
  958. If you enter an incorrect password in either the EE 1.3 or IBM LAN Server 1.3 
  959. environments, you will be prompted to enter a different password. Figure 
  960. "Incorrect Passwords" shows the pop-up panel that appears. 
  961.  
  962.  
  963. Incorrect Passwords
  964.  
  965.     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  966.     Γöé                     Logon                      Γöé
  967.     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  968.     Γöé                                                Γöé
  969.     Γöé                                                Γöé
  970.     Γöé Note: The password will not display            Γöé
  971.     Γöé                                                Γöé
  972.     Γöé           ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ                           Γöé
  973.     Γöé User ID   ΓöéPDQUEUE.Γöé                           Γöé
  974.     Γöé           ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ                           Γöé
  975.     Γöé           ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ                           Γöé
  976.     Γöé Password  Γöé........Γöé                           Γöé
  977.     Γöé           ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ                           Γöé
  978.     Γöé                                                Γöé
  979.     Γöé    ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ    Γöé
  980.     Γöé    Γöé Enter  Γöé     Γöé Cancel Γöé     Γöé Help   Γöé    Γöé
  981.     Γöé    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ    Γöé
  982.     Γöé                                                Γöé
  983.     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  984.  
  985. The panel shown in Figure "Incorrect Passwords" is displayed by UPM, not NSC. 
  986. You should select Cancel to return to NSC. Then, use NSC to repeat the signon 
  987. with the correct password. 
  988.  
  989.  
  990. ΓòÉΓòÉΓòÉ 5.3. NSC Support Processes ΓòÉΓòÉΓòÉ
  991.  
  992. NSC provides two support processes to help you keep your password changes in 
  993. sync more easily and to extend your connection to either another OS/2 or host 
  994. system. 
  995.  
  996. These support processes are: 
  997.  
  998.       NSCRETRY - Start the NSC Retry Process 
  999.  
  1000.       NSCNDMN - Start the NSC Server 
  1001.  
  1002.  
  1003. ΓòÉΓòÉΓòÉ 5.3.1. NSCRETRY - Start the NSC Retry Process ΓòÉΓòÉΓòÉ
  1004.  
  1005. NSCRETRY creates a queue for requests that originally failed, and retries these 
  1006. requests at set intervals. The retry queue is lost in a power failure or when 
  1007. you shutdown the workstation. NSCRETRY is installed on the NSC OS/2 Client and 
  1008. on the NSC Server. 
  1009.  
  1010. By default, outstanding requests will be retried three times at fifteen minute 
  1011. intervals. The number of retries and the retry interval are configurable. if a 
  1012. request is removed from the queue because the maximum number of retries has 
  1013. been reached, NSCRETRY sounds a 2.5 second beep. If a request has been queued 
  1014. for retry, once the situation causing the original failure has been remedied, 
  1015. you should check the NSCRETRY output messages to verify that the request was 
  1016. processed. 
  1017.  
  1018. EXIT processing specified in an NSC configuration definition is not done for 
  1019. any request handled by NSCRETRY. Your exit routine will only get control when 
  1020. the initial request fails and is queued for retry. 
  1021.  
  1022. NSCRETRY may be run as a windowed or full screen program. Start NSCRETRY from 
  1023. "STARTUP.CMD" or from the OS/2 System Startup folder. Use the following command 
  1024. to start NSCRETRY in STARTUP.CMD. 
  1025.  
  1026.  
  1027.   START "NSC Retry Process" NSCRETRY.EXE
  1028.  
  1029. Once NSCRETRY starts, you can stop it by: 
  1030.  
  1031.      Pressing Ctrl+c 
  1032.  
  1033.      Pressing Ctrl+Break 
  1034.  
  1035.      Closing the task from your desktop 
  1036.  
  1037.  Syntax 
  1038.  
  1039.                 <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  1040.   >>ΓöÇΓöÇNSCRETRYΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  1041.                  ΓööΓöÇΓö¼ΓöÇ/InnΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  1042.                    Γö£ΓöÇ/RnnnΓöÇΓöÇΓöñ
  1043.                    ΓööΓöÇ/DEBUGΓöÇΓöÿ
  1044.  
  1045.  Parameters: 
  1046.  
  1047.               May be entered in lower case, upper case, or mixed case. 
  1048.  
  1049.               /Inn        The /I option specifies the delay interval in minutes 
  1050.                           between retries. nn is the number of minutes to 
  1051.                           delay, from 1 to 60. The default is 15 minutes. 
  1052.  
  1053.               /Rnnn       The /R option specifies the number of retries before 
  1054.                           the request is deleted from the queue. nnn is the 
  1055.                           number of retries, from 1 to 100. The default is 3. 
  1056.  
  1057.               /DEBUG      This option causes NSC to log additional debugging 
  1058.                           trace information. See Problem Determination for 
  1059.                           further details. 
  1060.  
  1061.  Example 
  1062.  
  1063.               The following example causes the NSC Retry process to be started 
  1064.               with a delay interval of 20 minutes. 
  1065.  
  1066.                               NSCRETRY /I20
  1067.  
  1068.  Output 
  1069.  
  1070.               When NSCRETRY is started, the following messages are displayed: 
  1071.  
  1072.                               (c) Copyright IBM Corporation 1992, 1995
  1073.                               Network SignON Coordinator/2 Retry Process Version 1.2
  1074.  
  1075.                               IN 01 nn:nn:nn NSCRETRY System queue for retry requests created.
  1076.                               IN 01 nn:nn:nn NSCRETRY Maximum number of attempts per request is nnn.
  1077.                               IN 01 nn:nn:nn NSCRETRY Delay interval between attempts is nn minute(s).
  1078.                               IN 01 nn:nn:nn NSCRETRY Waiting for retry request.
  1079.  
  1080.               Whenever the queue becomes empty, the last message listed above 
  1081.               is redisplayed. Whenever the queue is empty and a retry request 
  1082.               is received, the following message is displayed: 
  1083.  
  1084.                               IN 01 nn:nn:nn NSCRETRY Sleeping until time to retry.
  1085.  
  1086.               When a request is retried, messages are displayed in the 
  1087.               following format: 
  1088.  
  1089.                               IN 01 nn:nn:nn NSCRETRY <execution message>
  1090.  
  1091.               The execution messages are documented in Messages. 
  1092.  
  1093.  
  1094. ΓòÉΓòÉΓòÉ 5.3.2. NSCNDMN - Start the NSC Server ΓòÉΓòÉΓòÉ
  1095.  
  1096. NSCNDMN is installed on an NSC Server. It must be started on an OS/2 
  1097. Workstation before NSC Clients can access configuration files stored on the NSC 
  1098. Server, or process requests on the NSC Server or Host systems connected to it. 
  1099. NSCNDMN listens for NETBIOS connections from NSC Clients, establishes sessions 
  1100. with NSC Clients to do the following: 
  1101.  
  1102.      Receive remote requests for configuration files, read the requested 
  1103.       configuration files, and send them to the NSC Client. Refer to GETDEFS 
  1104.       for information on using configuration files stored on the NSC Server. 
  1105.  
  1106.      Receive remote requests for signon verification or password changes, and 
  1107.       execute the requests for the NSC Clients. Refer to SERVER for information 
  1108.       on configuring location definitions at the NSC Server. 
  1109.  
  1110.  NSCNDMN may be run as a windowed or full screen program. It writes messages to 
  1111.  the screen and sounds a beep when an error is detected. Start NSCNDMN from 
  1112.  "STARTUP.CMD" or from the OS/2 System Startup folder. Use the following 
  1113.  command to start NSCNDMN in STARTUP.CMD. 
  1114.  
  1115.  
  1116.     START "NSC Server Process" NSCNDMN.EXE
  1117.  
  1118.  Once NSCNDMN starts, you can stop it by: 
  1119.  
  1120.      Pressing Ctrl+c 
  1121.  
  1122.      Pressing Ctrl+Break 
  1123.  
  1124.      Closing the task from your desktop 
  1125.  
  1126.  Syntax 
  1127.  
  1128.                <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  1129.   >>ΓöÇΓöÇNSCNDMNΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  1130.                 ΓööΓöÇΓö¼ΓöÇ/CnnΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  1131.                   Γö£ΓöÇ/DEBUGΓöÇΓöñ
  1132.                   ΓööΓöÇnameΓöÇΓöÇΓöÇΓöÿ
  1133.  
  1134.  Parameters: 
  1135.  
  1136.               May be entered in lower case, upper case, or mixed case. 
  1137.  
  1138.               /Cnn        The /C option specifies the maximum number of 
  1139.                           concurrent NSC Client requests processed by the NSC 
  1140.                           Server. nn is the number of concurrent requests, from 
  1141.                           1 to 16. If this option is specified, the NSC Server 
  1142.                           will require nn NETBIOS sessions and nn NETBIOS 
  1143.                           commands to initialize successfully. The default is 
  1144.                           to attempt to allow up to 6 concurrent requests if 
  1145.                           there are adequate NETBIOS resources when the NSC 
  1146.                           Server starts; if fewer NETBIOS sessions or commands 
  1147.                           are available, the NSC Server will use them as long 
  1148.                           as there are at least 2 of each. See Configuring 
  1149.                           NETBIOS for further details on NETBIOS Resources. 
  1150.  
  1151.                           Specifying a large number for this option may improve 
  1152.                           NSC Server throughput when the NSC Server is used by 
  1153.                           a large number of NSC Clients. 
  1154.  
  1155.               /DEBUG      This option causes NSC to log additional debugging 
  1156.                           trace information. See Problem Determination for 
  1157.                           further details. 
  1158.  
  1159.               name        The name parameter specifies a name to be used for 
  1160.                           this NSC Server. It is used in SERVER definitions 
  1161.                           (see SERVER) and GETDEFS definitions (see GETDEFS). 
  1162.                           If this parameter is not specified, NSC uses the 
  1163.                           computername configured for the IBM LAN Requester or 
  1164.                           IBM LAN Server, and can be found in the IBMLAN.INI 
  1165.                           file in the IBMLAN directory. 
  1166.  
  1167.                           You must specify this parameter if neither LAN 
  1168.                           Requester or LAN Server is installed. In this case, 
  1169.                           the name specified must be unique within the LAN and 
  1170.                           can not match any other NSC Server's name, LAN 
  1171.                           Requester computername, or LAN Server computername. 
  1172.                           The name must be from 1 to 15 characters in length. 
  1173.                           Lower case alphabetic characters are converted to 
  1174.                           upper case. 
  1175.  
  1176.  Example 
  1177.  
  1178.               The following example causes the NSC Server process named 
  1179.               NSCSERV01 to be started with debugging. 
  1180.  
  1181.                               NSCNDMN NSCSERV01 /debug
  1182.  
  1183.  Output 
  1184.  
  1185.               When NSCNDMN is started, the following messages are displayed: 
  1186.  
  1187.                               (c) Copyright IBM Corporation 1992, 1995
  1188.                               Network SignON Coordinator/2 Server Version 1.2
  1189.  
  1190.                               IN 01 nn:nn:nn NSCNDMN  NSC Server NSCSERV01 has successfully started.
  1191.  
  1192.  
  1193. ΓòÉΓòÉΓòÉ 6. Installing Network SignON Coordinator/2 ΓòÉΓòÉΓòÉ
  1194.  
  1195. This chapter explains how to install Network SignON Coordinator/2 onto a 
  1196. workstation's hard disk. You can install NSC on a workstation in one of four 
  1197. configurations: 
  1198.  
  1199.      NSC DOS Client 
  1200.  
  1201.      NSC OS/2 Client 
  1202.  
  1203.      NSC Server 
  1204.  
  1205.      NSC OS/2 Client and NSC Server 
  1206.  
  1207.       This allows a workstation to function as both an NSC OS/2 Client and an 
  1208.       NSC Server. 
  1209.  
  1210.  All installation instructions assume that the installation diskette (or its 
  1211.  files stored in the same directory structure) is in the current drive and that 
  1212.  your current directory is the root of that drive. For example, if you are 
  1213.  using a diskette enter these commands: 
  1214.  
  1215.     A:
  1216.     CD \
  1217.  
  1218.  to proceed with the installation instructions. 
  1219.  
  1220.  If you have a LAN Server and have copied the installation diskette onto its 
  1221.  hard disk, you can perform the installation across a LAN. You should copy the 
  1222.  installation diskette into a separate directory on the LAN Server's disk. At 
  1223.  the LAN server enter these commands: 
  1224.  
  1225.     MD D:\NSCDISK
  1226.     CD D:\NSCDISK
  1227.     XCOPY A: /S
  1228.  
  1229.  Assuming you have the LAN Requester running on the workstation you only need 
  1230.  to switch to a drive that logically represents the directory containing the 
  1231.  NSC install diskette image. For example, if N is a redirected drive, the 
  1232.  following commands get you ready to start the installation. 
  1233.  
  1234.     N:
  1235.     CD \
  1236.  
  1237.  If you are installing NSC Version 1.1 over NSC Version 1.0, the install will 
  1238.  keep your NSC.INI configuration file as it is. 
  1239.  
  1240.  You should be ready to start the install. Choose among these options: 
  1241.  
  1242.       Installing DOS Workstations 
  1243.  
  1244.       Installing OS/2 Workstations 
  1245.  
  1246.  
  1247. ΓòÉΓòÉΓòÉ 6.1. Installing DOS Workstations ΓòÉΓòÉΓòÉ
  1248.  
  1249. To install an NSC client on a DOS workstation, follow these steps: 
  1250.  
  1251.    1. Decide whether to install NSC in an existing directory or to make a new 
  1252.       one. Here are the considerations: 
  1253.  
  1254.       Existing         If you pick a directory that already exists and is 
  1255.                        specified in your AUTOEXEC.BAT PATH statement, you will 
  1256.                        not need to update your PATH and create a new disk 
  1257.                        directory. 
  1258.  
  1259.       New              If you want to keep NSC in its own directory, then you 
  1260.                        must: 
  1261.  
  1262.                        - Create a disk directory. 
  1263.  
  1264.                        - Update or add the AUTOEXEC.BAT PATH statement. 
  1265.  
  1266.                        - Re-boot the machine before installation. 
  1267.  
  1268.    2. Assuming the disk directory you selected in the preceding step was 
  1269.       C:\TOOLS, use the following command: 
  1270.  
  1271.  
  1272.               INSTALL  C:\TOOLS
  1273.  
  1274.    3. Edit AUTOEXEC.BAT to include a SET statement for the environment variable 
  1275.       DPATH. NSC uses DPATH to locate the installation drive and path. For 
  1276.       example: 
  1277.  
  1278.  
  1279.               SET DPATH=C:\TOOLS
  1280.  
  1281.    4. To use NSC with Windows Version 3.1 in 386/486 Enhanced mode, follow 
  1282.       these steps: 
  1283.  
  1284.         a) Add NSC to a program group by selecting either the group's icon or 
  1285.            its window. 
  1286.  
  1287.         b) Select the File menu from the Program Manager's action bar. 
  1288.  
  1289.         c) Select the New... item. 
  1290.  
  1291.         d) Select the Program Item option. 
  1292.  
  1293.         e) Select the OK push button. 
  1294.  
  1295.         f) Enter <NSC PATH>\NSC.PIF in the Command Line field of the Program 
  1296.            Item Properties dialog. 
  1297.  
  1298.         g) Select the OK push button. 
  1299.  
  1300.         h) Use the NSC program icon in the selected program group to start NSC. 
  1301.  You have completed the installation. 
  1302.  
  1303.  Table "Installed Files" lists the NSC files installed on your system. 
  1304.  
  1305.  
  1306. ΓòÉΓòÉΓòÉ 6.2. Installing OS/2 Workstations ΓòÉΓòÉΓòÉ
  1307.  
  1308. This section describes the considerations and steps you take to install an NSC 
  1309. OS/2 Client or Server. The installation process involves running the 
  1310. INSTALL.CMD file located on your installation diskette. The INSTALL process 
  1311. will ask you questions about where to place the NSC files. If you are using 
  1312. OS/2 2.0 or later, you are also asked about adding NSC processes to your 
  1313. Startup folder. 
  1314.  
  1315. Before installing, consider the following: 
  1316.  
  1317.    1. Decide whether to install NSC in an existing directory or to make a new 
  1318.       one. Here are the considerations: 
  1319.  
  1320.       Existing         If you pick a directory that already exists and is 
  1321.                        specified in your CONFIG.SYS PATH, LIBPATH, and DPATH 
  1322.                        statements, you will not need to update CONFIG.SYS and 
  1323.                        create a new disk directories. 
  1324.  
  1325.                        The executable files and NSC.INI files must be placed in 
  1326.                        the directory specified by PATH and DPATH. The dynamic 
  1327.                        execution library has to be installed in a directory 
  1328.                        specified by your LIBPATH. 
  1329.  
  1330.       New              If you want to keep NSC in its own directory, then you 
  1331.                        must: 
  1332.  
  1333.                        - Create at least one disk directory. 
  1334.  
  1335.                        - Update the CONFIG.SYS PATH and DPATH statement for the 
  1336.                        executables. 
  1337.  
  1338.                        - Update LIBPATH for the dynamic execution library. 
  1339.  
  1340.                        - Re-boot the machine before installation. 
  1341.  
  1342.    2. Decide whether to install the NSC Server on your workstation. The NSC 
  1343.       Server component should be installed on your workstation only when users 
  1344.       on other NSC Client workstations need to issue NSC requests to your 
  1345.       workstation either to 
  1346.  
  1347.           change a UPM password on your workstation (for example, if your 
  1348.            workstation is an IBM Database Manager server, but not an IBM LAN 
  1349.            Server domain controller or additional server), or 
  1350.  
  1351.           change a password on a host connected to your workstation (but not 
  1352.            connected directly to the NSC Client workstation -- for example, an 
  1353.            APPC gateway workstation). 
  1354.  
  1355.       The NSC Server should not be installed on LAN Servers which handle only 
  1356.       LAN Server logons, logoffs and password change requests from clients 
  1357.       (these requests can be handled by the NSC Client). The NSC Server should 
  1358.       not be installed on additional servers for the purpose of changing 
  1359.       passwords on the additional server (these requests must be directed to 
  1360.       the LAN Server that controls the additional server). 
  1361.  
  1362.    3. If you are using OS/2 2.0 or later, you will be asked whether or not you 
  1363.       want the NSC Retry process and the NSC Server (if this configuration is 
  1364.       requested) added to your desktop's Startup folder. 
  1365.  
  1366.       Choosing to add them will cause them to startup automatically when the 
  1367.       system is restarted. You do not have to add them to your system startup 
  1368.       at installation. They can be added later. See NSCRETRY - Start the NSC 
  1369.       Retry Process and NSCNDMN - Start the NSC Server for further information. 
  1370.  
  1371.  To install the NSC OS/2 Client or Server, use the following command: 
  1372.  
  1373.  
  1374.     INSTALL
  1375.  
  1376.  The INSTALL command will ask you to select the type of NSC configuration you 
  1377.  want and any necessary information. 
  1378.  
  1379.  Table "Installed Files" lists the NSC files installed on your system. 
  1380.  
  1381.  If you are using OS/2 1.3 and want to create an NSC program group or add 
  1382.  either the NSC Retry Process or NSC Server program to an existing group, you 
  1383.  must create or modify the group manually from the OS/2 1.3 desktop. 
  1384.  
  1385.  
  1386. ΓòÉΓòÉΓòÉ 6.3. Files Installed ΓòÉΓòÉΓòÉ
  1387.  
  1388. Table "Installed Files" lists the NSC files installed on your system based on 
  1389. the NSC configuration selected. The table headings on the right side indicate 
  1390. the configuration types for which the files are installed. 
  1391.  
  1392.      NOTE If you do not use APPC Host connections, or you have already 
  1393.      configured your APPC Host connections, the fixed-disk space requirements 
  1394.      for all OS/2 configurations can be reduced by 95K by deleting the sample 
  1395.      Communications Manager configuration file NSCSAMPL.CFG. 
  1396.  
  1397.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1398.   Γöé          Installed Files                                        Γöé
  1399.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1400.   Γöé FILE NAME   Γöé DESCRIPTION               Γöé OS/2  Γöé OS/2  Γöé DOS   Γöé
  1401.   Γöé             Γöé                           Γöé CLIENTΓöé SERVERΓöé CLIENTΓöé
  1402.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1403.   Γöé NSCREAD.ME  Γöé Read before installing    Γöé  X    Γöé  X    Γöé  X    Γöé
  1404.   Γöé             Γöé NSC                       Γöé       Γöé       Γöé       Γöé
  1405.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1406.   Γöé NSC.INI     Γöé Default NSC configuration Γöé  X    Γöé  X    Γöé  X    Γöé
  1407.   Γöé             Γöé file                      Γöé       Γöé       Γöé       Γöé
  1408.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1409.   Γöé NSCVERSN.LVLΓöé Version level of NSC      Γöé  X    Γöé  X    Γöé  X    Γöé
  1410.   Γöé             Γöé installed                 Γöé       Γöé       Γöé       Γöé
  1411.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1412.   Γöé NSCMVS.HIF  Γöé Sample host information   Γöé  X    Γöé  X    Γöé  X    Γöé
  1413.   Γöé             Γöé file for MVS              Γöé       Γöé       Γöé       Γöé
  1414.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1415.   Γöé NSCOS400.HIFΓöé Sample host information   Γöé  X    Γöé  X    Γöé  X    Γöé
  1416.   Γöé             Γöé file for OS/400           Γöé       Γöé       Γöé       Γöé
  1417.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1418.   Γöé NSCVM.HIF   Γöé Sample host information   Γöé  X    Γöé  X    Γöé  X    Γöé
  1419.   Γöé             Γöé file for VM               Γöé       Γöé       Γöé       Γöé
  1420.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1421.   Γöé NSCVMOV.HIF Γöé Sample host information   Γöé  X    Γöé  X    Γöé  X    Γöé
  1422.   Γöé             Γöé file for VM with          Γöé       Γöé       Γöé       Γöé
  1423.   Γöé             Γöé OfficeVision              Γöé       Γöé       Γöé       Γöé
  1424.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1425.   Γöé NSCIIN.HIF  Γöé Sample host information   Γöé  X    Γöé  X    Γöé  X    Γöé
  1426.   Γöé             Γöé file for the IBM Informa- Γöé       Γöé       Γöé       Γöé
  1427.   Γöé             Γöé tion Network              Γöé       Γöé       Γöé       Γöé
  1428.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1429.   Γöé NSC.EXE     Γöé Program providing command Γöé  X    Γöé       Γöé  X    Γöé
  1430.   Γöé             Γöé line execution as well as Γöé       Γöé       Γöé       Γöé
  1431.   Γöé             Γöé the menu or graphical     Γöé       Γöé       Γöé       Γöé
  1432.   Γöé             Γöé interface                 Γöé       Γöé       Γöé       Γöé
  1433.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1434.   Γöé NSCPM.EXE   Γöé PM graphical interface    Γöé  X    Γöé       Γöé       Γöé
  1435.   Γöé             Γöé program                   Γöé       Γöé       Γöé       Γöé
  1436.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1437.   Γöé NSCHELP.HLP Γöé Online helps for NSCPM    Γöé  X    Γöé       Γöé       Γöé
  1438.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1439.   Γöé NSCUG.INF   Γöé Information file for      Γöé  X    Γöé  X    Γöé       Γöé
  1440.   Γöé             Γöé online documentation      Γöé       Γöé       Γöé       Γöé
  1441.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1442.   Γöé NSCAPI.DLL  Γöé Dynamic link routines and Γöé  X    Γöé  X    Γöé       Γöé
  1443.   Γöé             Γöé API                       Γöé       Γöé       Γöé       Γöé
  1444.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1445.   Γöé NSRETRY.EXE Γöé NSC Retry Process program Γöé  X    Γöé  X    Γöé       Γöé
  1446.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1447.   Γöé NSCNDMN.EXE Γöé NSC Server program        Γöé       Γöé  X    Γöé       Γöé
  1448.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1449.   Γöé NSCSAMPL.CFGΓöé Sample Communications     Γöé  X    Γöé  X    Γöé       Γöé
  1450.   Γöé             Γöé Manager configuration     Γöé       Γöé       Γöé       Γöé
  1451.   Γöé             Γöé file for APPC             Γöé       Γöé       Γöé       Γöé
  1452.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1453.   Γöé NSCRSON.EXE Γöé Stub for obsolete command Γöé  X    Γöé       Γöé  X    Γöé
  1454.   Γöé             Γöé line / menu program (it   Γöé       Γöé       Γöé       Γöé
  1455.   Γöé             Γöé executes NSC.EXE)         Γöé       Γöé       Γöé       Γöé
  1456.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1457.   Γöé NSCRSOFF.EXEΓöé Stub for obsolete command Γöé  X    Γöé       Γöé  X    Γöé
  1458.   Γöé             Γöé line / menu program (it   Γöé       Γöé       Γöé       Γöé
  1459.   Γöé             Γöé executes NSC.EXE)         Γöé       Γöé       Γöé       Γöé
  1460.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1461.   Γöé NSCRSIGN.LIBΓöé Toolkit library con-      Γöé  X    Γöé       Γöé       Γöé
  1462.   Γöé             Γöé taining the NSCRSIGN API  Γöé       Γöé       Γöé       Γöé
  1463.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1464.   Γöé NSCRSIGN.H  Γöé Toolkit 'C' header file   Γöé  X    Γöé       Γöé       Γöé
  1465.   Γöé             Γöé for the NSCRSIGN API      Γöé       Γöé       Γöé       Γöé
  1466.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1467.   Γöé NSCNET.EXE  Γöé LAN Server and User Exit  Γöé       Γöé       Γöé  X    Γöé
  1468.   Γöé             Γöé interface program         Γöé       Γöé       Γöé       Γöé
  1469.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1470.   Γöé NSC.PIF     Γöé Windows Program Informa-  Γöé       Γöé       Γöé  X    Γöé
  1471.   Γöé             Γöé tion File                 Γöé       Γöé       Γöé       Γöé
  1472.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1473.  
  1474.  
  1475. ΓòÉΓòÉΓòÉ 7. Configuring Network SignON Coordinator/2 ΓòÉΓòÉΓòÉ
  1476.  
  1477. This chapter contains information on how to configure Network SignON 
  1478. Coordinator/2. 
  1479.  
  1480. Configuration information for NSC is stored in a file named "NSC.INI". NSC.INI 
  1481. file defines the defaults for NSC operation and defines where you want to 
  1482. signon, change passwords, and signoff. This file is created when you install 
  1483. NSC. You can use any ASCII file editor to modify the file to meet your 
  1484. configuration requirements. A copy of the file must either reside in the 
  1485. current directory or in a directory specified in the DPATH when executing NSC 
  1486. (or NSCRSON, NSCRSOFF, or NSCPM) or calling the NSCRSIGN API. 
  1487.  
  1488. NSC is usually used in one or more of the following environments. Determine 
  1489. which of these environments most closely matches yours, then see The NSC 
  1490. Configuration File. After reviewing the definitions in The NSC Configuration 
  1491. File, read Special Considerations. 
  1492.  
  1493.  Host Emulation      Workstations using host terminal emulation to multiple 
  1494.                      host systems (MVS, VM, or OS/400). NSC coordinates 
  1495.                      password changes for all configured host systems. To 
  1496.                      configure NSC for this environment, you need the following 
  1497.                      definition: 
  1498.  
  1499.                                             HOST,EMULATOR,NAME=...
  1500.  
  1501.                      This definition is described in HOST. You should also read 
  1502.                      Configuring EMULATOR Connections for a description of host 
  1503.                      information files along with some samples. Follow the 
  1504.                      directions for using the sample host information file for 
  1505.                      your host system. 
  1506.  
  1507.  LAN Servers         Workstations using multiple LAN Servers. NSC coordinates 
  1508.                      password changes for all configured LAN Servers. To 
  1509.                      configure NSC for this environment, you need the following 
  1510.                      definition: 
  1511.  
  1512.                                             LANSERVER,...,NAME=...
  1513.  
  1514.                      This definition is described in LANSERVER. 
  1515.  
  1516.  OS/2 Database Manager DOS and OS/2 workstations using one or more OS/2 
  1517.                      Database Manager Servers. NSC coordinates password changes 
  1518.                      for users at the configured NSC Servers running on the 
  1519.                      Database Server workstations. To configure NSC for this 
  1520.                      environment, you need the following definitions: 
  1521.  
  1522.                                             NODE,NAME=...
  1523.                                             SERVER,NAME=...
  1524.                                             LOCAL
  1525.  
  1526.                      These definitions are described in NODE, SERVER and LOCAL. 
  1527.                      Be sure to read the special considerations in OS/2 
  1528.                      Database Requester Considerations. 
  1529.  
  1530.  MVS/ESA - APPC      NSC Clients that have User IDs on MVS/ESA. APPC provides 
  1531.                      faster and more reliable password changes than the Host 
  1532.                      Emulation capability. NSC coordinates password changes for 
  1533.                      all configured MVS/ESA systems. To configure NSC for this 
  1534.                      environment, you need the following definitions: 
  1535.  
  1536.                                             SERVER,NAME=...
  1537.                                             HOST,APPC,NAME=...
  1538.  
  1539.                      These definitions are described in SERVER and HOST. See 
  1540.                      Configuring APPC for a description of how to configure 
  1541.                      Communications Manager and suggestions for the host system 
  1542.                      software. 
  1543.  
  1544.  If you plan to use an NSC Server on your LAN, see Configuring NETBIOS for a 
  1545.  description of the NETBIOS resource requirements for NSC, along with 
  1546.  information on how to configure these resources. 
  1547.  
  1548.  
  1549. ΓòÉΓòÉΓòÉ 7.1. The NSC Configuration File ΓòÉΓòÉΓòÉ
  1550.  
  1551. Each line of the NSC configuration file defines a default for NSC operation or 
  1552. defines a location where you want to signon or change a password. Any line 
  1553. beginning with an asterisk or blank (space) character is considered a comment 
  1554. and ignored. Any text following the first blank character on a line is 
  1555. considered comment text and ignored. Although the definitions are shown in 
  1556. upper case, you may enter them in upper, lower or mixed case. 
  1557.  
  1558. The following sections explain how you configure Network SignON Coordinator/2. 
  1559.  
  1560.      Changing the Defaults explains the NSC operation defaults. 
  1561.  
  1562.      Defining Locations explains how you define the signon or change password 
  1563.       locations. 
  1564.  
  1565.      Other Configuration Definitions explains how you define user exits that 
  1566.       can be associated with your location definitions, or how to include 
  1567.       configuration definitions stored on an NSC Server or in a user-specific 
  1568.       configuration file. 
  1569.  
  1570.      Special Considerations contains some special considerations for accessing 
  1571.       configuration files on NSC Servers, supporting multiple users on the same 
  1572.       machine and OS/2 Clients that are also OS/2 Database Requesters. 
  1573.  
  1574.      Configuration File Example contains a complete example configuration 
  1575.       file. 
  1576.  
  1577.  
  1578. ΓòÉΓòÉΓòÉ 7.1.1. Changing the Defaults ΓòÉΓòÉΓòÉ
  1579.  
  1580. You define how NSC interacts with an end user and how NSC validates user input. 
  1581. The order of the definitions does not matter. If NSC.INI contains duplicate 
  1582. definitions, the one nearest the bottom takes effect. The definition defaults 
  1583. you can change are: 
  1584.  
  1585.  To specify                          Definition 
  1586.  -------------                       ------------- 
  1587.  Error beeps                         BEEP 
  1588.  Character Set                       CHARSET 
  1589.  Exit warning                        CONFIRMEXIT 
  1590.  Debugging                           DEBUG 
  1591.  Minimum Password Length             MINPWLEN 
  1592.  Maximum Password Length             MAXPWLEN 
  1593.  Minimum User ID Length              MINUIDLEN 
  1594.  Maximum User ID Length              MAXUIDLEN 
  1595.  Password retention                  SAVEPW 
  1596.  Shortcut to signon                  SIGNON 
  1597.  Default User ID                     USERID 
  1598.  
  1599.  
  1600. ΓòÉΓòÉΓòÉ 7.1.1.1. BEEP ΓòÉΓòÉΓòÉ
  1601.  
  1602. Use the BEEP definition to turn off the beeps NSC sounds when error messages 
  1603. are displayed or the user presses invalid keys. 
  1604.  
  1605.  Syntax        BEEP={ON|OFF} 
  1606.  
  1607.  Values        Choose either ON or OFF. 
  1608.  
  1609.  Default       ON 
  1610.  
  1611.  Example       BEEP=OFF 
  1612.  
  1613.                NSC will not beep when displaying error messages or invalid keys 
  1614.                are pressed. 
  1615.  
  1616.  
  1617. ΓòÉΓòÉΓòÉ 7.1.1.2. CHARSET ΓòÉΓòÉΓòÉ
  1618.  
  1619. Use the CHARSET definition to specify the characters (other than alphanumerics) 
  1620. that are valid in passwords. 
  1621.  
  1622.  Syntax        CHARSET=characters 
  1623.  
  1624.  Values        characters is a string of non-blank characters. You cannot 
  1625.                specify the alphanumeric characters A through Z, a through z, or 
  1626.                0 through 9. Specify only graphic ASCII characters other than a 
  1627.                space (i.e., 0x21 through 0x7E and 0x80 through 0xFE). 
  1628.  
  1629.                Do not specify lower case extended ASCII characters, because 
  1630.                they will not be converted to upper case and may not give the 
  1631.                desired result when passed to UPM or LAN Server. You can specify 
  1632.                up to 159 characters. No check is made for duplicate characters. 
  1633.  
  1634.  Default       The default ignore this CHARSET definition. 
  1635.  
  1636.  Example       CHARSET=╤ü 
  1637.  
  1638.                This restricts the character set for passwords to just 
  1639.                alphanumeric characters and ╤ü. 
  1640.  
  1641.  
  1642. ΓòÉΓòÉΓòÉ 7.1.1.3. CONFIRMEXIT ΓòÉΓòÉΓòÉ
  1643.  
  1644. Use the CONFIRMEXIT definition to display a warning message before NSC exits 
  1645. (when closing the main window). 
  1646.  
  1647.  Syntax        CONFIRMEXIT={ON|OFF} 
  1648.  
  1649.  Values        Choose either ON or OFF. 
  1650.  
  1651.  Default       OFF 
  1652.  
  1653.  Example       CONFIRMEXIT=ON 
  1654.  
  1655.                When the user selects Close or Exit, a warning message is 
  1656.                displayed before NSC exits.  If OK is selected, NSC exits. If 
  1657.                NSC was started from a folder and is active when Shutdown is 
  1658.                selected from the desktop, the warning message will be displayed 
  1659.                when the system attempts to close NSC. The user may then cancel 
  1660.                Shutdown. 
  1661.  
  1662.  
  1663. ΓòÉΓòÉΓòÉ 7.1.1.4. DEBUG ΓòÉΓòÉΓòÉ
  1664.  
  1665. Use the DEBUG definition to have NSC record additional LOG information when a 
  1666. problem occurs (user request processing is slower when DEBUG is defined). See 
  1667. Problem Determination, for further information. 
  1668.  
  1669.  Syntax        DEBUG 
  1670.  
  1671.  Values        None 
  1672.  
  1673.  Default       None 
  1674.  
  1675.  Example       DEBUG 
  1676.  
  1677.                NSC will log non-error information as well as error information. 
  1678.  
  1679.  
  1680. ΓòÉΓòÉΓòÉ 7.1.1.5. MINPWLEN ΓòÉΓòÉΓòÉ
  1681.  
  1682. Use the MINPWLEN definition to set the minimum password length. If the user 
  1683. enters fewer characters than this in the menu for the current or new password, 
  1684. an error message is displayed. 
  1685.  
  1686.  Syntax        MINPWLEN={1..14} 
  1687.  
  1688.  Values        Pick a value between 1 and 14. 
  1689.  
  1690.  Default       5 
  1691.  
  1692.  Example       MINPWLEN=6 
  1693.  
  1694.                NSC will check that the password contains at least 6 characters. 
  1695.  
  1696.  
  1697. ΓòÉΓòÉΓòÉ 7.1.1.6. MAXPWLEN ΓòÉΓòÉΓòÉ
  1698.  
  1699. Use the MAXPWLEN definition to set the maximum password length. If the user 
  1700. enters more characters than this in the menu for the current or new password, 
  1701. an error message is displayed. 
  1702.  
  1703.  Syntax        MAXPWLEN={1..14} 
  1704.  
  1705.  Values        Pick a value between 1 and 14. 
  1706.  
  1707.  Default       8 
  1708.  
  1709.  Example       MAXPWLEN=7 
  1710.  
  1711.                NSC will check that the password contains no more than 7 
  1712.                characters. 
  1713.  
  1714.  
  1715. ΓòÉΓòÉΓòÉ 7.1.1.7. MINUIDLEN ΓòÉΓòÉΓòÉ
  1716.  
  1717. Use the MINUIDLEN definition to set the minimum User ID length. If the user 
  1718. enters fewer characters than this in the menu for a User ID, an error message 
  1719. is displayed. 
  1720.  
  1721.  Syntax        MINUIDLEN={1..8} 
  1722.  
  1723.  Values        Pick a value between 1 and 8. 
  1724.  
  1725.  Default       4 
  1726.  
  1727.  Example       MINUIDLEN=5 
  1728.  
  1729.                NSC will check that the User ID contains at least 5 characters. 
  1730.  
  1731.  
  1732. ΓòÉΓòÉΓòÉ 7.1.1.8. MAXUIDLEN ΓòÉΓòÉΓòÉ
  1733.  
  1734. Use the MAXUIDLEN definition to set the maximum User ID length. If the user 
  1735. enters more characters than this in the menu for a User ID, an error message is 
  1736. displayed. 
  1737.  
  1738. If you use a GETDEFS definition (see GETDEFS), do not specify a MAXUIDLEN 
  1739. greater than 8 since the User ID is used to construct the filename containing 
  1740. the additional configuration definitions. If you have a User ID greater than 8 
  1741. and want to use a GETDEFS, you must pick a pseudo User ID of 8 or fewer 
  1742. characters and specify the larger User ID on the location definition(s) where 
  1743. it is applicable. 
  1744.  
  1745.  Syntax        MAXUIDLEN={1..47} 
  1746.  
  1747.  Values        Pick a value between 1 and 47. 
  1748.  
  1749.  Default       8 
  1750.  
  1751.  Example       MAXUIDLEN=7 
  1752.  
  1753.                NSC will check that the User ID contains no more than 7 
  1754.                characters. 
  1755.  
  1756.  
  1757. ΓòÉΓòÉΓòÉ 7.1.1.9. SAVEPW ΓòÉΓòÉΓòÉ
  1758.  
  1759. Use the SAVEPW definition to have NSC remember the end user's password once it 
  1760. has been entered. This allows you to signon to a selected location without 
  1761. having to renter your password. If you select the Default Signons or Change 
  1762. Password actions, the previously entered password is used. 
  1763.  
  1764. If you change your password, the new password becomes the saved password if the 
  1765. change is successful everywhere. If the change fails anywhere, the saved 
  1766. password is cleared and you will have to reenter it the next time you select a 
  1767. signon action. 
  1768.  
  1769. The password is not stored on disk, but kept hidden and masked in memory. When 
  1770. NSC is closed, the saved password is no longer available. 
  1771.  
  1772.  Syntax        SAVEPW={ON|OFF} 
  1773.  
  1774.  Values        Choose either ON or OFF. 
  1775.  
  1776.  Default       OFF 
  1777.  
  1778.  Example       SAVEPW=ON 
  1779.  
  1780.                Once entered, the password is saved and reused. 
  1781.  
  1782.  
  1783. ΓòÉΓòÉΓòÉ 7.1.1.10. SIGNON ΓòÉΓòÉΓòÉ
  1784.  
  1785. When you start the NSC graphical interface (see Graphical Interface), you can 
  1786. have NSC automatically initiate the dialog to perform a Signon to Default 
  1787. Systems by using the SIGNON definition. 
  1788.  
  1789.  Syntax        SIGNON 
  1790.  
  1791.  Values        None 
  1792.  
  1793.  Default       None 
  1794.  
  1795.  Example       SIGNON 
  1796.  
  1797.                NSC starts a signon to the user's default locations. This is 
  1798.                equivalent to using the mouse to select Actions, then selecting 
  1799.                Signon, then selecting Default Systems. 
  1800.  
  1801.  
  1802. ΓòÉΓòÉΓòÉ 7.1.1.11. USERID ΓòÉΓòÉΓòÉ
  1803.  
  1804. Use the USERID definition to specify your default User ID. This User ID can be 
  1805. overridden by a User ID entered as a command line parameter. The default User 
  1806. ID is used for all location definitions that do not explicitly specify a USERID 
  1807. parameter. 
  1808.  
  1809. The most appropriate use of the USERID definition is for a workstation that has 
  1810. a single user. In this situation, it eliminates the user having to enter their 
  1811. User ID every time they start NSC. 
  1812.  
  1813. USERID should not be specified on workstations used by multiple users or where 
  1814. a user moves between workstations. In this case, use a GETDEFS definition (see 
  1815. GETDEFS) and let NSC prompt the user at startup for their User ID. 
  1816.  
  1817.  Syntax        USERID=userid 
  1818.  
  1819.  Values        The userid is a string of characters. It should not include any 
  1820.                character that is not part of the Character Set you defined (see 
  1821.                CHARSET). Lower case alphabetic characters are converted to 
  1822.                upper case, and the string is then displayed in the NSC menus as 
  1823.                the initial value for User ID. 
  1824.  
  1825.  Default       None 
  1826.  
  1827.  Example       USERID=SMITH 
  1828.  
  1829.                The User ID "SMITH" will be the default User ID. 
  1830.  
  1831.  
  1832. ΓòÉΓòÉΓòÉ 7.1.2. Defining Locations ΓòÉΓòÉΓòÉ
  1833.  
  1834. You must define where you want to signon or change passwords. In the 
  1835. definitions that follow, the term "request" means a signon, signoff, or change 
  1836. password action. The definitions to do this are: 
  1837.  
  1838.      LOCAL 
  1839.      NODE 
  1840.      LANSERVER 
  1841.      HOST 
  1842.      SERVER 
  1843.  
  1844.  The order of these definitions is very important because: 
  1845.  
  1846.      NSC processes requests in the order that you list the definitions. 
  1847.  
  1848.       Each definition is processed without checking for duplicate definitions. 
  1849.       When a request is duplicated for the same User ID at the same location, 
  1850.       the second request usually fails. 
  1851.  
  1852.      The SERVER definitions determine where requests are processed. 
  1853.  
  1854.       All definitions for requests to be processed at the local workstation 
  1855.       must precede the first SERVER definition. Definitions that follow a 
  1856.       SERVER definition are sent to that NSC Server for request processing. 
  1857.  
  1858.  For example, suppose you have an OS/2 workstation in your office and you also 
  1859.  have a UPM account on another workstation down the hall. The two workstations 
  1860.  are connected by a LAN as in Figure "Two Workstations". 
  1861.  
  1862.  
  1863.   Two Workstations
  1864.  
  1865.          ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1866.          Γöé Workstation Γöé     Γöé Workstation Γöé
  1867.          Γöé  in your    Γöé     Γöé   down the  Γöé
  1868.          Γöé   office    Γöé     Γöé    hall     Γöé
  1869.          Γöé             Γöé     Γöé             Γöé
  1870.          Γöé             Γöé     Γöé             Γöé
  1871.          Γöé             Γöé     Γöé             Γöé
  1872.          Γöé    OS/2     Γöé     Γöé    OS/2     Γöé
  1873.          ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1874.                   Γöé                 Γöé
  1875.                   Γöé      LAN        Γöé
  1876.               ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇ
  1877.  NSC changes your passwords on both machines from your workstation. Figure "NSC 
  1878.  Client/Server" shows the necessary relationship and configuration definitions 
  1879.  at the bottom. 
  1880.  
  1881.  
  1882.   NSC Client/Server
  1883.  
  1884.          ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1885.          Γöé NSC Client  Γöé     Γöé NSC Server  Γöé
  1886.          Γöé             Γöé     Γöé   SERVE1    Γöé
  1887.          Γöé             Γöé     Γöé             Γöé
  1888.          Γöé  - Local    Γöé     Γöé  - Local    Γöé
  1889.          Γöé             Γöé     Γöé             Γöé
  1890.          Γöé    OS/2     Γöé     Γöé    OS/2     Γöé
  1891.          ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÿ     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1892.                   Γöé                 
  1893.                   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1894.  
  1895.        NSC configuration file
  1896.  
  1897.           USERID=ELVIS
  1898.           LOCAL,ON
  1899.           SERVER,NAME=SERVE1
  1900.           LOCAL
  1901.  
  1902.  The NSC configuration file located at your workstation should contain two 
  1903.  LOCAL signon definitions.  One is processed on your workstation and the other 
  1904.  at the workstation down the hall (SERVE1) whenever you change your password. 
  1905.  In this example, the User ID on both workstations is ELVIS. 
  1906.  
  1907.  Your configuration file may contain up to 255 location definitions. A location 
  1908.  definition cannot be made in the same configuration file as a GETDEFS 
  1909.  definition. The location definitions must be made in the referenced 
  1910.  configuration file. You can specify the definitions below: 
  1911.  
  1912.  To specify                          Definition 
  1913.  -------------                       ------------- 
  1914.  UPM Local signon                    LOCAL 
  1915.  UPM Node signon                     NODE 
  1916.  LAN Server signon                   LANSERVER 
  1917.  NSC Server machine                  HOST 
  1918.  Host signon                         SERVER 
  1919.  
  1920.  
  1921. ΓòÉΓòÉΓòÉ 7.1.2.1. LOCAL ΓòÉΓòÉΓòÉ
  1922.  
  1923. Use the LOCAL definition to change OS/2 UPM passwords and, optionally, to logon 
  1924. to the local UPM. You can specify multiple LOCAL definitions. 
  1925.  
  1926. A DOS Client cannot process LOCAL definitions, but an NSC Server can process 
  1927. them for the DOS Client. 
  1928.  
  1929. When users move between workstations or a workstation has several users, you 
  1930. should avoid defining a UPM account for each user on each OS/2 workstation. Not 
  1931. only does this require a lot of UPM configuration work, but it also creates a 
  1932. situation where it is impossible to keep a single user's password up to date on 
  1933. every workstation. You can use a NODE definition (see NODE) instead of a LOCAL. 
  1934. The User ID associated with a node logon does not require a UPM account 
  1935. definition. For more information on this topic, see Special Considerations. 
  1936.  
  1937. Syntax 
  1938.  
  1939.            <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  1940. >>ΓöÇΓöÇLOCALΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  1941.             ΓööΓöÇΓö¼ΓöÇ,ONΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  1942.               Γö£ΓöÇ,USERID=useridΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1943.               ΓööΓöÇΓö¼ΓöÇ,EXIT=filenameΓöÇΓö¼ΓöÇΓöÿ
  1944.                 ΓööΓöÇ,EXITID=exitidΓöÇΓöÿ
  1945.  
  1946. Parameters: 
  1947.  
  1948.               ON          Causes Network SignON Coordinator/2 to perform a 
  1949.                           local logon as well as synchronize password changes 
  1950.                           with UPM. 
  1951.  
  1952.                           The ON parameter is valid on only an OS/2 Client. You 
  1953.                           can specify the ON parameter for only one LOCAL 
  1954.                           definition, because a workstation session can have 
  1955.                           only one active local logon. 
  1956.  
  1957.                           The ON parameter cannot be specified in a LOCAL 
  1958.                           definition that follows a SERVER definition. 
  1959.  
  1960.               USERID      Specifies the User ID to be used for the request. 
  1961.                           Specify this parameter when the user's account on the 
  1962.                           local workstation is under a different User ID than 
  1963.                           that provided to NSC (from the USERID configuration 
  1964.                           definition, from the command line, from the API, or 
  1965.                           from the User ID dialog). Lower case alphabetic 
  1966.                           characters are converted to upper case. This 
  1967.                           parameter also allows a user to synchronize passwords 
  1968.                           for multiple UPM accounts and selectively signon 
  1969.                           different User IDs for a local logon. 
  1970.  
  1971.               EXITID      Identifies an EXIT definition defining a command file 
  1972.                           or program to be executed after the request has been 
  1973.                           processed. See EXIT for a description of the EXIT 
  1974.                           definition. See Exit Routines for information on how 
  1975.                           to define exit routines. 
  1976.  
  1977.               EXIT        This parameter is equivalent to "EXITID=exitid" where 
  1978.                           the EXIT definition is specified as 
  1979.                           "EXIT,ID=exitid,NAME=filename" (all other options are 
  1980.                           defaulted). 
  1981.  
  1982.  Example 
  1983.  
  1984.               In the following example, the user has three different local User 
  1985.               IDs defined in UPM on the client workstation; two of these User 
  1986.               IDs are also defined in UPM on the NSC Server "DBSERVER". When 
  1987.               requested to signon, NSC performs a local logon for the User ID 
  1988.               "PDQUEUE" on the client workstation. When requested to change 
  1989.               passwords, NSC performs a password change for each of the three 
  1990.               User IDs on the client workstation and the two User IDs on the 
  1991.               NSC Server. After processing each request for User ID "PDQUEUE", 
  1992.               the user command file "MYEXIT.CMD" is executed in the background. 
  1993.               In the OS/2 graphical interface, the user can signon using either 
  1994.               of the other two User IDs defined in UPM on the client 
  1995.               workstation. 
  1996.  
  1997.                               USERID=PDQUEUE
  1998.                               LOCAL,ON,EXIT=D:\TOOLS\MYEXIT.CMD
  1999.                               LOCAL,USERID=DBADM
  2000.                               LOCAL,USERID=SYSADM
  2001.                               SERVER,NAME=DBSERVER
  2002.                               LOCAL
  2003.                               LOCAL,USERID=DBADM
  2004.  
  2005.  
  2006. ΓòÉΓòÉΓòÉ 7.1.2.2. NODE ΓòÉΓòÉΓòÉ
  2007.  
  2008. Use the NODE definition to perform a node logon to your local UPM. Node signons 
  2009. do not perform any User ID or password validation; they are always successful. 
  2010. Node logons create User ID and password information used by OS/2 Database 
  2011. Manager, APPC applications, and the Communications Manager 5250 Emulator. You 
  2012. can specify multiple NODE definitions to be processed locally, but NODE 
  2013. definitions cannot follow a SERVER definition. 
  2014.  
  2015. NSC does no signon processing for DOS Clients since there is no UPM on DOS. A 
  2016. NODE definition on a DOS Client can be used to execute an exit routine (for 
  2017. example, to perform a logon to the DOS Database Requester). They can also be 
  2018. used for this purpose on OS/2 because of the low overhead of a node logon 
  2019. (except on EE 1.3, which requires that a new process be started). 
  2020.  
  2021. A 5250 node logon can be automated by using a NODE definition with an exit 
  2022. routine which starts the Communications Manager. 
  2023.  
  2024. Syntax 
  2025.  
  2026.                       <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  2027. >>ΓöÇΓöÇNODEΓöÇΓöÇ,NAME=nameΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  2028.                        ΓööΓöÇΓö¼ΓöÇ,ONΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  2029.                          Γö£ΓöÇ,USERID=useridΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2030.                          ΓööΓöÇΓö¼ΓöÇ,EXIT=filenameΓöÇΓö¼ΓöÇΓöÿ
  2031.                            ΓööΓöÇ,EXITID=exitidΓöÇΓöÿ
  2032.  
  2033. Parameters: 
  2034.  
  2035.               NAME        name is the Server Node Name configured in the OS/2 
  2036.                           Database Manager Workstation Directory for a database 
  2037.                           server, or the PLU Name for an APPC application. 
  2038.                           Lower case alphabetic characters in the name will be 
  2039.                           converted to upper case. 
  2040.  
  2041.               ON          Causes NSC to perform a node logon on an OS/2 Client. 
  2042.  
  2043.                           You can specify the ON parameter for multiple NODE 
  2044.                           definitions. You should only specify it for one NODE 
  2045.                           definition with the same NAME. If you specify the ON 
  2046.                           parameter on more than one NODE definition with the 
  2047.                           same NAME, signon will fail for all but the first of 
  2048.                           the definitions because you are already signed on. 
  2049.  
  2050.               USERID      Specifies the User ID to be used for the request. For 
  2051.                           example, for OS/2 Database Requesters, specify this 
  2052.                           parameter when the User ID for the remote database 
  2053.                           connection is different from the default User ID 
  2054.                           provided to NSC (from the USERID configuration 
  2055.                           definition, from the command line, from the API, or 
  2056.                           from the User ID dialog). Lower case alphabetic 
  2057.                           characters are converted to upper case. This 
  2058.                           parameter also allows a user to selectively signon 
  2059.                           different User IDs for a node logon. 
  2060.  
  2061.               EXITID      Identifies an EXIT definition defining a command file 
  2062.                           or program to be executed after the request has been 
  2063.                           processed. See EXIT for a description of the EXIT 
  2064.                           definition. See Exit Routines for information on how 
  2065.                           to define exit routines. 
  2066.  
  2067.                           If you have more than one NODE definition for the 
  2068.                           same node name (i.e. for multiple User IDs), you 
  2069.                           should specify the same exit routine for each of 
  2070.                           these definitions.  For a password change, only the 
  2071.                           exit routine for the last of these definitions is 
  2072.                           executed, and only if there is a current node logon 
  2073.                           for the node (the User ID will be the currently 
  2074.                           logged on User ID). 
  2075.  
  2076.               EXIT        This parameter is equivalent to "EXITID=exitid" where 
  2077.                           the EXIT definition is specified as 
  2078.                           "EXIT,ID=exitid,NAME=filename" (all other options are 
  2079.                           defaulted). 
  2080.  
  2081.  Example 
  2082.  
  2083.               In the following example, the user has two different User IDs 
  2084.               defined in UPM on the NSC Server "DBSERVER". These User IDs are 
  2085.               not necessarily defined in UPM on the client workstation. When 
  2086.               requested to signon, NSC performs a node logon for the User ID 
  2087.               "PDQUEUE" on the client workstation. When requested to change 
  2088.               passwords, NSC performs a password change for each of the two 
  2089.               User IDs on the NSC Server, and performs a new node logon for the 
  2090.               currently logged on User ID on the client workstation using the 
  2091.               new password. After processing each request, the user command 
  2092.               file "MYEXIT.CMD" is executed in the background (it will only be 
  2093.               executed once for a password change). For DOS Clients, this 
  2094.               command file could handle the logon for the DOS Database 
  2095.               Requester (see the example exit routine in Logging on to a DOS 
  2096.               Database Client). In the OS/2 graphical interface, the user can 
  2097.               choose to signon the User ID "DBADM", replacing the node logon 
  2098.               for "PDQUEUE". 
  2099.  
  2100.                               USERID=PDQUEUE
  2101.                               NODE,ON,EXIT=D:\TOOLS\MYEXIT.CMD
  2102.                               NODE,USERID=DBADM,EXIT=D:\TOOLS\MYEXIT.CMD
  2103.                               SERVER,NAME=DBSERVER
  2104.                               LOCAL
  2105.                               LOCAL,USERID=DBADM
  2106.  
  2107.  
  2108. ΓòÉΓòÉΓòÉ 7.1.2.3. LANSERVER ΓòÉΓòÉΓòÉ
  2109.  
  2110. Use the LANSERVER definition to change LAN Server passwords and, optionally, to 
  2111. logon to the LAN Server. You can specify multiple LANSERVER definitions to be 
  2112. processed locally, but LANSERVER definitions cannot follow a SERVER definition. 
  2113.  
  2114. Syntax 
  2115.  
  2116.                                           <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  2117. >>ΓöÇΓöÇLANSERVERΓöÇΓöÇ,ΓöÇΓö¼ΓöÇIBMΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ,NAME=nameΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  2118.                  ΓööΓöÇNOVELLΓöÇΓöÿ                ΓööΓöÇΓö¼ΓöÇ,ONΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  2119.                                              Γö£ΓöÇ,USERID=useridΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2120.                                              ΓööΓöÇΓö¼ΓöÇ,EXIT=filenameΓöÇΓö¼ΓöÇΓöÿ
  2121.                                                ΓööΓöÇ,EXITID=exitidΓöÇΓöÿ
  2122.  
  2123. Parameters: 
  2124.  
  2125.               IBM         Identifies this as an IBM LAN Server. 
  2126.  
  2127.                           Because a workstation can have only one active IBM 
  2128.                           LAN Server logon, you can specify the ON parameter 
  2129.                           for only one IBM LANSERVER definition. 
  2130.  
  2131.                           If you are configuring for a DOS IBM LAN Requester, 
  2132.                           specify the /NMS:n parameter (where n is greater than 
  2133.                           or equal to 1) in its DOSLAN.INI file. 
  2134.  
  2135.               NOVELL      Identifies this as a NetWare file server. 
  2136.  
  2137.                           If you specify the ON parameter, NSC uses interfaces 
  2138.                           provided by NetWare to do a LOGIN to the file server. 
  2139.                           However, NetWare does not execute the user login 
  2140.                           script. You can achieve some of the same results 
  2141.                           using an exit routine that executes NetWare MAP 
  2142.                           commands. OS/2 NetWare Drive Mapping and DOS NetWare 
  2143.                           Drive Mapping are examples of exit routines that use 
  2144.                           the MAP command. 
  2145.  
  2146.               NAME        name is the IBM LAN Server domain or the NetWare file 
  2147.                           server's name. Lower case alphabetic characters in 
  2148.                           the name will be converted to upper case. 
  2149.  
  2150.               ON          Causes NSC to perform a LAN Server logon and to 
  2151.                           synchronize password changes with the LAN Server. 
  2152.  
  2153.               USERID      Specifies the User ID to be used for the request. 
  2154.                           Specify this parameter when the user's User ID for 
  2155.                           the LAN Server is different from the User ID provided 
  2156.                           to NSC (from the USERID configuration definition, 
  2157.                           from the command line, from the API, or from the User 
  2158.                           ID dialog). Lower case alphabetic characters are 
  2159.                           converted to upper case. This parameter also allows a 
  2160.                           user to synchronize passwords for multiple accounts 
  2161.                           on the same LAN Server. 
  2162.  
  2163.               EXITID      Identifies an EXIT definition defining a command file 
  2164.                           or program to be executed after the request has been 
  2165.                           processed. For example, an exit routine could check 
  2166.                           for a successful IBM LAN Server logon and then 
  2167.                           perform a NET USE for an IBM LAN Server resource. See 
  2168.                           EXIT for a description of the EXIT definition. See 
  2169.                           Exit Routines for information on how to define exit 
  2170.                           routines. 
  2171.  
  2172.               EXIT        This parameter is equivalent to "EXITID=exitid" where 
  2173.                           the EXIT definition is specified as 
  2174.                           "EXIT,ID=exitid,NAME=filename" (all other options are 
  2175.                           defaulted). 
  2176.  
  2177.  Example 
  2178.  
  2179.               In the following example, the user has User IDs "PDQUEUE" and 
  2180.               "SYSADM" defined on the IBM LAN Server domain "LANSYS04", and 
  2181.               User ID "PDQUEUE" defined on the IBM LAN Server domain 
  2182.               "LANSYS07". When requested to signon, NSC performs a logon for 
  2183.               the User ID "PDQUEUE" to domain "LANSYS04". When requested to 
  2184.               change passwords, NSC performs a password change for "PDQUEUE" 
  2185.               and "SYSADM" on domain "LANSYS04" and "PDQUEUE" on domain 
  2186.               "LANSYS07". In the OS/2 graphical interface, the user can choose 
  2187.               to signon to the domain "LANSYS04" using the User ID "SYSADM", or 
  2188.               domain "LANSYS07" using the User ID "PDQUEUE". In either case, a 
  2189.               domain logoff is first performed. 
  2190.  
  2191.                               LANSERVER,IBM,NAME=LANSYS04,ON
  2192.                               LANSERVER,IBM,NAME=LANSYS04,USERID=SYSADM
  2193.                               LANSERVER,IBM,NAME=LANSYS07
  2194.  
  2195.  
  2196. ΓòÉΓòÉΓòÉ 7.1.2.4. HOST ΓòÉΓòÉΓòÉ
  2197.  
  2198. Use the HOST definition to change host passwords and, optionally, logon to the 
  2199. host. You can specify multiple HOST definitions. 
  2200.  
  2201. Syntax 
  2202.  
  2203. >>ΓöÇΓöÇHOSTΓöÇΓöÇΓö¼ΓöÇ,APPCΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ,NAME=hostnameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2204.           Γöé           <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<  Γöé
  2205.           ΓööΓöÇ,EMULATORΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÿ
  2206.                        ΓööΓöÇΓö¼ΓöÇ,HIF=filenameΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  2207.                          ΓööΓöÇ,Vn=variableΓöÇtextΓöÇΓöÿ
  2208.    <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  2209. >ΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  2210.     ΓööΓöÇΓö¼ΓöÇ,ONΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  2211.       Γö£ΓöÇ,USERID=useridΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2212.       ΓööΓöÇΓö¼ΓöÇ,EXIT=filenameΓöÇΓö¼ΓöÇΓöÿ
  2213.         ΓööΓöÇ,EXITID=exitidΓöÇΓöÿ
  2214.  
  2215. Parameters: 
  2216.  
  2217.               APPC        Specifies that APPC is to be used to make the host 
  2218.                           connection. APPC and EMULATOR are mutually exclusive. 
  2219.  
  2220.                           If the workstation has a host emulator session, use 
  2221.                           the emulator connection to avoid additional 
  2222.                           communications configuration work. APPC provides a 
  2223.                           faster, more reliable method of changing passwords on 
  2224.                           a host system than does a host emulator session. 
  2225.                           However, not all host systems provide support for NSC 
  2226.                           APPC connections. 
  2227.  
  2228.               EMULATOR    Specifies that a host emulator session is to be used 
  2229.                           to make the host connection. APPC and EMULATOR are 
  2230.                           mutually exclusive. 
  2231.  
  2232.                           EMULATOR can be used with either 3270 or 5250 host 
  2233.                           emulator session. If a 5250 session on OS/2 is used, 
  2234.                           the emulator prompts the user for a node logon when 
  2235.                           that session is started. This node logon can be 
  2236.                           automated through the use of the EXIT parameter. See 
  2237.                           Exit Routines for an example illustrating how this 
  2238.                           can be accomplished. 
  2239.  
  2240.                           NOTE: If a 5250 session is used on an NSC Server, the 
  2241.                           node logon must be done manually. 
  2242.  
  2243.               HIF         Identifies the host information file for the host 
  2244.                           emulator session (see Configuring EMULATOR 
  2245.                           Connections for a description of host information 
  2246.                           files). A complete path (up to 80 characters) may be 
  2247.                           specified if the host information file is not in the 
  2248.                           same directory as the NSC configuration file. If a 
  2249.                           file extension is not specified, the default is 
  2250.                           ".INI". 
  2251.  
  2252.                           Use this parameter when you have multiple User IDs at 
  2253.                           the same host location.  Each definition should 
  2254.                           specify the same host information file. 
  2255.  
  2256.               Vn          Specifies an HIF Variable. Up to 10 HIF Variables may 
  2257.                           be defined (V0 through V9). The HIF Variable 
  2258.                           parameters for a single HOST definition are limited 
  2259.                           to a total of 80 characters. An HIF Variable defines 
  2260.                           a string (variable-text) that can replace the HIF 
  2261.                           Variable in the host information file. If the 
  2262.                           variable-text string is enclosed in double quotes, 
  2263.                           the string can contain embedded spaces and commas. 
  2264.                           Two successive double quotes ("") represent a single 
  2265.                           double quote character. 
  2266.  
  2267.                           Using an HIF Variable can reduce the number of host 
  2268.                           information files needed. For example, you may have 
  2269.                           two MVS systems that are the same but, their signon 
  2270.                           screens have a different system name (e.g., "TSO1" 
  2271.                           versus "TSO2"). You can use an HIF Variable to 
  2272.                           substitute values into a search string. Another 
  2273.                           example is to use the HIF Variable to specify the 
  2274.                           host emulator session. 
  2275.  
  2276.                           HIF variables contained within a variable-text string 
  2277.                           are recursively replaced by their corresponding 
  2278.                           variable-text strings. If the User ID is "JUDY" and 
  2279.                           you define the following HIF variables: 
  2280.  
  2281.  
  2282.                                                      V1=Good,V2=morning,V3="@V1 @V2 @u"
  2283.  
  2284.                           then all occurances of @V3 in the HIF are replaced 
  2285.                           with: 
  2286.  
  2287.  
  2288.                                                         Good morning JUDY
  2289.  
  2290.                           If you specify HIF variables within a variable-text 
  2291.                           string, do not make a circular definitions since they 
  2292.                           cannot be resolved. The following definitions are 
  2293.                           circular and will cause and endless series of 
  2294.                           replacements. 
  2295.  
  2296.  
  2297.                                                         V1=@V1
  2298.                                                         V1=@V2,V2=@V1
  2299.  
  2300.               NAME        NSC uses the hostname to locate further definitions 
  2301.                           needed to make the host connection. 
  2302.  
  2303.                           For APPC, hostname is the name of the Partner LU 
  2304.                           profile in the APPC configuration (see Personal 
  2305.                           Computer Definitions describes these profiles). 
  2306.  
  2307.                           For EMULATOR, choose a value for hostname that 
  2308.                           identifies the host. This name is used in messages 
  2309.                           and in the graphical interface. Use the same hostname 
  2310.                           for different User IDs at the same location (these 
  2311.                           definitions should also specify the same HIF 
  2312.                           parameter and use the same host emulator session 
  2313.                           ids). NSC uses the hostname in the graphical 
  2314.                           interface to combine all User IDs for the same 
  2315.                           location and provide a list of valid signon requests. 
  2316.                           If you want to signon two different User IDs to the 
  2317.                           same host location at the same time, you must specify 
  2318.                           a different hostname for the second User ID and use a 
  2319.                           different host emulator session id. 
  2320.  
  2321.                           If the HIF parameter is not specified, hostname 
  2322.                           specifies the name of the host information file used 
  2323.                           for the emulator session. In this case, a file 
  2324.                           extension of ".INI" is appended to hostname to get 
  2325.                           the filename, and the host information file must be 
  2326.                           in the same directory as the NSC configuration file. 
  2327.  
  2328.               ON          For host emulator sessions, the ON parameter causes 
  2329.                           NSC to perform a host logon and to synchronize 
  2330.                           password changes with the host. 
  2331.  
  2332.                           For APPC connections, the ON parameter causes NSC to 
  2333.                           verify the User ID and password at the host and 
  2334.                           notify the user of the host signon status (valid, 
  2335.                           invalid, or password expired) at signon. 
  2336.  
  2337.                           The ON parameter cannot be specified in a HOST 
  2338.                           EMULATOR definition that follows a SERVER definition. 
  2339.  
  2340.               USERID      Specifies the User ID to be used for the request. 
  2341.                           Specify this parameter when the user's host ID is 
  2342.                           different from the User ID provided to NSC (from the 
  2343.                           USERID configuration definition, from the command 
  2344.                           line, from the API, or from the User ID dialog). 
  2345.                           Lower case alphabetic characters are converted to 
  2346.                           upper case. This parameter also allows a user to 
  2347.                           synchronize passwords for multiple host accounts. 
  2348.  
  2349.               EXITID      Identifies an EXIT definition defining a command file 
  2350.                           or program to be executed after the request has been 
  2351.                           processed. See EXIT for a description of the EXIT 
  2352.                           definition. See Exit Routines for information on how 
  2353.                           to define exit routines. 
  2354.  
  2355.               EXIT        This parameter is equivalent to "EXITID=exitid" where 
  2356.                           the EXIT definition is specified as 
  2357.                           "EXIT,ID=exitid,NAME=filename" (all other options are 
  2358.                           defaulted). 
  2359.  
  2360.  Example 
  2361.  
  2362.               In the following example, the user has defined three different 
  2363.               User IDs on two different host systems. The sample host 
  2364.               information file for VM is used, taking advantage of HIF 
  2365.               variables to assign host sessions and to supply search string 
  2366.               text. HIF variable V1 is used to select the host session. HIF 
  2367.               variable V2 is substitution text used in a host information file 
  2368.               search string. NSC uses "VM1" or "VM2" to identify the host 
  2369.               system in its messages. 
  2370.  
  2371.               When requested to signon, NSC performs a logon for the User ID 
  2372.               "PDQUEUE" to VM1 (using either session A or C) and VM2 (using 
  2373.               session B). When requested to change passwords, NSC performs a 
  2374.               password change for User ID "PDQUEUE" on VM1 and VM2, and a 
  2375.               password change for User ID "SYSADM" on VM1. If "PDQUEUE" is 
  2376.               signed on to VM1 session A, the password change for "SYSADM" will 
  2377.               be done using host emulator session C; otherwise, it will use 
  2378.               session A. The same is true for User ID "PDQUEUE" if "SYSADM" is 
  2379.               signed on to session A. In the OS/2 graphical interface, the user 
  2380.               can choose to signon to VM1 using the User ID "SYSADM"; if signed 
  2381.               on as "PDQUEUE", the user will first be signed off and then 
  2382.               signed on as "SYSADM". 
  2383.  
  2384.                               USERID=PDQUEUE
  2385.                               HOST,EMULATOR,NAME=VM1,HIF=d:\nsc\nscvm.hif,V1="A-C",V2=VM1,ON
  2386.                               HOST,EMULATOR,NAME=VM1,HIF=d:\nsc\nscvm.hif,V1="A-C",V2=VM1,USERID=SYSADM
  2387.                               HOST,EMULATOR,NAME=VM2,HIF=d:\nsc\nscvm.hif,V1=B,V2=VM2,ON
  2388.  
  2389.  
  2390. ΓòÉΓòÉΓòÉ 7.1.2.5. SERVER ΓòÉΓòÉΓòÉ
  2391.  
  2392. Use the SERVER definition to specify an NSC Server that will process the 
  2393. definitions that follow it. You can specify multiple SERVER definitions. 
  2394.  
  2395. NSC Server processing is initiated by the NSC Client when it processes 
  2396. definitions in the Client NSC configuration. The NSC Server processes only host 
  2397. and local definitions. The main difference between the NSC Client and NSC 
  2398. Server processing is that a definition passed to the NSC Server cannot request 
  2399. a signon operation. At signon, the NSC Server processes only password change 
  2400. requests and APPC password verification requests. Another difference is that 
  2401. Exit Routines are driven only in the NSC Client.  The following sequence takes 
  2402. place: 
  2403.  
  2404.    1. NSC Client displays the in-progress message for the definition. 
  2405.  
  2406.    2. NSC Client sends the definition to the NSC Server. 
  2407.  
  2408.    3. NSC Server processes the definition. 
  2409.  
  2410.    4. NSC Server sends results to the NSC Client. 
  2411.  
  2412.    5. NSC Client displays the completion message for the definition. 
  2413.  
  2414.    6. NSC Client drives the Exit Routine. 
  2415.  
  2416.  Consider using an NSC Server when you use host APPC connections and make the 
  2417.  APPC connection definition at the Server. This reduces the configuration work 
  2418.  at the workstation (Communications Manager and NSC both) and at the host 
  2419.  computer site. 
  2420.  
  2421.  Syntax 
  2422.  
  2423.   >>ΓöÇΓöÇSERVERΓöÇΓöÇ,NAME=machineΓöÇnameΓöÇΓöÇ><
  2424.  
  2425.  Parameters: 
  2426.  
  2427.               NAME        The machine-name is the name assigned to an NSC 
  2428.                           Server. NSCNDMN - Start the NSC Server explains how 
  2429.                           the server is named. Lower case alphabetic characters 
  2430.                           in the machine name will be converted to upper case. 
  2431.  
  2432.  Example 
  2433.  
  2434.               In the following example, the user has defined the User ID 
  2435.               "PDQUEUE" in UPM on the NSC Server "MAC2", an account for 
  2436.               "PDQUEUE" on the MVS Host "MVSSYS01", and the User ID "DBADM" in 
  2437.               UPM on the NSC Server "DBM03". When requested to signon, NSC 
  2438.               connects to the NSC Server "DBM03" and validates the User ID 
  2439.               "PDQUEUE" and password via APPC at the MVS Host "MVSSYS01". When 
  2440.               requested to change passwords, NSC does the following: 
  2441.  
  2442.                 1. Connects to the NSC Server "MAC2". 
  2443.                 2. Performs a password change for User ID "PDQUEUE" on the NSC 
  2444.                    Server "MAC2". 
  2445.                 3. Executes the exit routine "MYEXIT.CMD" on the client 
  2446.                    workstation. 
  2447.                 4. Connects to the NSC Server "DBM03". 
  2448.                 5. Performs a password change via APPC at the MVS Host 
  2449.                    "MVSSYS01" for User ID "PDQUEUE". 
  2450.                 6. Performs a password change for the User ID "DBADM" on the 
  2451.                    NSC Server "DBM03". 
  2452.  
  2453.                               USERID=PDQUEUE
  2454.                               SERVER,NAME=MAC2
  2455.                               LOCAL,EXIT=MYEXIT.CMD
  2456.                               SERVER,NAME=DBM03
  2457.                               HOST,APPC,NAME=MVSSYS01,ON
  2458.                               LOCAL,USERID=DBADM
  2459.  
  2460.  
  2461. ΓòÉΓòÉΓòÉ 7.1.3. Other Configuration Definitions ΓòÉΓòÉΓòÉ
  2462.  
  2463.      EXIT explains how you define user exits that can be associated with your 
  2464.       location definitions. 
  2465.  
  2466.      GETDEFS explains how to include configuration definitions stored on an 
  2467.       NSC Server or in a user-specific configuration file. 
  2468.  
  2469.  
  2470. ΓòÉΓòÉΓòÉ 7.1.3.1. EXIT ΓòÉΓòÉΓòÉ
  2471.  
  2472. You can define user exit routines by identifying the command file or program to 
  2473. be executed after a request has been processed. User exit definitions can be 
  2474. referenced by one or more location definitions. Up to 40 EXIT definitions may 
  2475. be defined. See Exit Routines for more information on exit routines and the 
  2476. parameters passed to the exit routines. 
  2477.  
  2478. For example, an exit routine could check for a successful IBM LAN Server logon 
  2479. and then perform a NET USE for an IBM LAN Server resource. In OS/2, exit 
  2480. routines that allow user interaction may be started. 
  2481.  
  2482. Syntax 
  2483.  
  2484.                                       <ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  2485. >>ΓöÇΓöÇEXITΓöÇΓöÇ,ID=exitidΓöÇΓöÇ,NAME=filenameΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  2486.                                        ΓööΓöÇΓö¼ΓöÇΓö¼ΓöÇ,BGΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  2487.                                          Γöé ΓööΓöÇ,FGΓöÇΓöÿ     Γöé
  2488.                                          Γö£ΓöÇΓö¼ΓöÇ,WAITΓöÇΓöÇΓöÇΓö¼ΓöÇΓöñ
  2489.                                          Γöé ΓööΓöÇ,NOWAITΓöÇΓöÿ Γöé
  2490.                                          Γö£ΓöÇΓö¼ΓöÇ,NORCΓöÇΓö¼ΓöÇΓöÇΓöÇΓöñ
  2491.                                          Γöé ΓööΓöÇ,RCΓöÇΓöÇΓöÇΓöÿ   Γöé
  2492.                                          ΓööΓöÇΓö¼ΓöÇ,NOMSGSΓöÇΓö¼ΓöÇΓöÿ
  2493.                                            ΓööΓöÇ,MSGSΓöÇΓöÇΓöÇΓöÿ
  2494.  
  2495. Parameters: 
  2496.  
  2497.               ID          Identifies this EXIT definition. The exitid must be 
  2498.                           an integer from 1 to 40. This ID may be referenced by 
  2499.                           one or more location definitions to associate the 
  2500.                           exit routine defined by this EXIT definition with a 
  2501.                           specific location. 
  2502.  
  2503.               NAME        Identifies the user exit command file or executable 
  2504.                           program. A complete path (up to 80 characters) may be 
  2505.                           specified if the command file or executable program 
  2506.                           is not in the PATH. 
  2507.  
  2508.               BG          Specifies that the exit routine will be executed in 
  2509.                           the background (this is the default). 
  2510.  
  2511.               FG          Specifies that the exit routine will be executed in 
  2512.                           the foreground. If this option is not specified, the 
  2513.                           exit routine will be executed in the background. This 
  2514.                           parameter is ignored in DOS. 
  2515.  
  2516.               WAIT        Specifies that NSC should wait until the exit routine 
  2517.                           terminates before processing the next location 
  2518.                           definition (this is the default). 
  2519.  
  2520.               NOWAIT      Specifies that NSC should continue processing the 
  2521.                           next location definition without waiting for the exit 
  2522.                           routine to finish. If this option is not specified, 
  2523.                           NSC waits until the exit routine finishes before 
  2524.                           processing the next location definition. This 
  2525.                           parameter is ignored in DOS. Do not specify this 
  2526.                           parameter if the exit routine returns an error code 
  2527.                           and you want details on the result of the exit 
  2528.                           routine. 
  2529.  
  2530.               NORC        Specifies that the exit routine does not set the 
  2531.                           ERRORLEVEL or return an error code (this is the 
  2532.                           default). 
  2533.  
  2534.               RC          Specifies that the exit routine sets the ERRORLEVEL 
  2535.                           or returns a return code to indicate its success or 
  2536.                           failure. See Exit Routines for a description of 
  2537.                           return codes. If this option is not specified, it is 
  2538.                           assumed that the exit routine does not set the 
  2539.                           ERRORLEVEL or return a return code. If the NOWAIT 
  2540.                           parameter is specified, this parameter is ignored. 
  2541.  
  2542.               NOMSGS      Specifies that in-progress and successful completion 
  2543.                           messages should not be displayed when the user exit 
  2544.                           is executed (this is the default). Error messages for 
  2545.                           the user exit will always be displayed. 
  2546.  
  2547.               MSGS        Specifies that in-progress and successful completion 
  2548.                           messages should be displayed when the user exit is 
  2549.                           executed. If this option is not specified, 
  2550.                           in-progress and successful completion messages will 
  2551.                           not be displayed. 
  2552.  
  2553.  Example 
  2554.  
  2555.               The following example causes NSC to execute the exit routine 
  2556.               "MYEXIT.CMD" after processing a request for the Local User ID. In 
  2557.               this example, the exit routine is assumed to be an OS/2 REXX 
  2558.               command file requiring user interaction and returning a return 
  2559.               code, so the user exit is defined so that NSC will start the exit 
  2560.               routine in a foreground session and wait for it to terminate 
  2561.               before continuing. When the exit routine terminates, if it 
  2562.               returns an error, NSC will display an appropriate error message 
  2563.               based on the return code. 
  2564.  
  2565.                               EXIT,ID=1,NAME=D:\TOOLS\MYEXIT.CMD,FG,WAIT,RC,NOMSGS
  2566.                               LOCAL,ON,EXITID=1
  2567.  
  2568.  
  2569. ΓòÉΓòÉΓòÉ 7.1.3.2. GETDEFS ΓòÉΓòÉΓòÉ
  2570.  
  2571. You can combine configuration definitions from another file with the 
  2572. definitions in the Client NSC.INI file using the GETDEFS definition. 
  2573. Definitions can be included from a local file or from an NSC Server, allowing 
  2574. centralized configuration management. The included file must be in the same 
  2575. directory as the NSC configuration file. Included definitions can be either 
  2576. user-specific or group-specific: 
  2577.  
  2578.      Included files can be identified by User IDs. A file extension of "NSC" 
  2579.       is appended to the default User ID to get the filename for the included 
  2580.       definitions. 
  2581.  
  2582.      On an NSC Server, included files can be identified by a Group ID. To 
  2583.       group User IDs together, create a flat ASCII file called "NSCGROUP.TAB" 
  2584.       in the same directory as the NSC configuration file on the NSC Server. 
  2585.       Each line in this file must have the syntax: 
  2586.  
  2587.               Group-ID,User-ID   *comment
  2588.  
  2589.       A line may have leading blanks or embedded blanks preceding the comment 
  2590.       indicator (asterisk). If the default User ID is found in this file, a 
  2591.       file extension of "NSC" is appended to the associated Group ID to get the 
  2592.       filename for the included definitions. If the default User ID is not 
  2593.       found in this file, or if the file does not exist, a user-specific file 
  2594.       is assumed. 
  2595.  
  2596.  If an included configuration file is located on an NSC Server, it is used to 
  2597.  complete the NSC configuration definitions. Also, any host information files 
  2598.  referenced by HOST definitions are copied from the NSC Server to the NSC 
  2599.  Client's execution directory. The local host information file copies are then 
  2600.  used by NSC as long as NSC is not exited. 
  2601.  
  2602.  Any configuration definition may be used in an included configuration file. 
  2603.  However, if the NSC.INI file contains a GETDEFS definition, it may not contain 
  2604.  any location or user exit definitions (i.e. all location or user exit 
  2605.  definitions must be placed in the included configuration file). See Special 
  2606.  Considerations for other considerations. 
  2607.  
  2608.  Syntax 
  2609.  
  2610.   >>ΓöÇΓöÇGETDEFSΓöÇΓöÇ,SERVER=machineΓöÇnameΓöÇΓöÇ><
  2611.  
  2612.  Parameters: 
  2613.  
  2614.               NAME        The machine-name is the name assigned to an NSC 
  2615.                           Server. NSCNDMN - Start the NSC Server explains how 
  2616.                           the server is named. Lower case alphabetic characters 
  2617.                           in the machine name will be converted to upper case. 
  2618.  
  2619.                           If the SERVER parameter is not specified, the 
  2620.                           included configuration file is assumed to be on the 
  2621.                           NSC Client. 
  2622.  
  2623.  Example 
  2624.  
  2625.               The following example causes NSC to read the file "PDQUEUE.NSC" 
  2626.               on the NSC Server "DBM03" and process configurations definitions 
  2627.               in this file in addition to those found in the NSC.INI file. Any 
  2628.               host information files referenced in HOST definitions within 
  2629.               "PDQUEUE.NSC" will by copied from the NSC Server to the NSC 
  2630.               Client. 
  2631.  
  2632.                               USERID=PDQUEUE
  2633.                               GETDEFS,SERVER=DBM03
  2634.  
  2635.               If the NSCGROUP.TAB file on the NSC Server contains the following 
  2636.               line: 
  2637.  
  2638.                               DEPT100,PDQUEUE
  2639.               NSC will process the file "DEPT100.NSC" on the NSC Server instead 
  2640.               of "PDQUEUE.NSC". 
  2641.  
  2642.  
  2643. ΓòÉΓòÉΓòÉ 7.1.4. Special Considerations ΓòÉΓòÉΓòÉ
  2644.  
  2645.      Accessing Remote Configuration Files explains how you can access 
  2646.       configuration files on remote LAN nodes (NSC Servers). 
  2647.  
  2648.      Supporting Multiple Users at a Workstation explains how you can use 
  2649.       user-specific configuration files for multiple users on the same machine. 
  2650.  
  2651.      If you have an OS/2 Client running OS/2 Database Requester, you should 
  2652.       review the information in OS/2 Database Requester Considerations. 
  2653.  
  2654.  
  2655. ΓòÉΓòÉΓòÉ 7.1.4.1. Accessing Remote Configuration Files ΓòÉΓòÉΓòÉ
  2656.  
  2657. In large installations, it may be desirable to store all NSC configuration 
  2658. files in a central location to make it easier to manage changes. This is 
  2659. supported by NSC via the GETDEFS definition with the SERVER parameter (see 
  2660. GETDEFS). Instead of specifying location definitions in the NSC.INI file on the 
  2661. NSC Clients, a GETDEFS definition is specified, identifying the NSC Server on 
  2662. which the configuration files are stored. NSC processes the NSC.INI file on the 
  2663. NSC Client, then connects to the NSC Server and processes the associated 
  2664. configuration file. 
  2665.  
  2666. The file containing the included configuration definitions can be identified 
  2667. either by a User ID or a Group ID. To group User IDs together, create a flat 
  2668. ASCII file called "NSCGROUP.TAB" in the same directory as the NSC configuration 
  2669. file on the NSC Server. Each line in this file must have the syntax: 
  2670.  
  2671.   Group-ID,User-ID   *comment
  2672.  
  2673. If the default User ID is found in this file, a file extension of "NSC" is 
  2674. appended to the associated Group ID to get the filename for the included 
  2675. definitions. This allows a single configuration file to be used for all users 
  2676. with the same configuration. If the default User ID is not found in this file, 
  2677. or if the file does not exist, a file extension of "NSC" is appended to the 
  2678. default User ID to get the filename for the included definitions. 
  2679.  
  2680. If included location definitions contain HOST definitions for emulator 
  2681. sessions, the host information files will also be copied to the NSC Client. 
  2682. This allows one copy of an host information file to be maintained for all users 
  2683. accessing an emulator session using the host information file. 
  2684.  
  2685. Smaller host information files (less than 2K bytes in size) can reduce NSC 
  2686. startup time. Edit host information files stored on an NSC Server to remove 
  2687. unnecessary commentary. 
  2688.  
  2689.  
  2690. ΓòÉΓòÉΓòÉ 7.1.4.2. Supporting Multiple Users at a Workstation ΓòÉΓòÉΓòÉ
  2691.  
  2692. In some installations, a single workstation may be used by more than one 
  2693. person. If each person using the workstation has a unique User ID, it may be 
  2694. desirable to have a unique NSC Configuration File for each user. This is 
  2695. supported by NSC via the GETDEFS definition with no SERVER parameter (see 
  2696. GETDEFS). Default definitions that are common for all users at the workstation 
  2697. can be placed in the NSC.INI Configuration File. The location and user exit 
  2698. definitions can be placed in a file with a file extension of "NSC" appended to 
  2699. the User ID for the filename. The User ID may be entered from the command line; 
  2700. if not, NSC will prompt for the User ID before accessing the user-specific 
  2701. configuration file. 
  2702.  
  2703. Avoid using the USERID definition. USERID should not be specified on 
  2704. workstations used by multiple users or where a user moves between workstations. 
  2705. NSC will prompt the user at startup for their User ID. 
  2706.  
  2707. When users move between workstations or a workstation has several users, you 
  2708. should avoid defining a UPM account for each user on each OS/2 workstation. Not 
  2709. only does this require a lot of UPM configuration work, but it also creates a 
  2710. situation where it is impossible to keep a single user's password up to date on 
  2711. every workstation. You can use a NODE definition (see NODE) instead of a LOCAL 
  2712. definition. 
  2713.  
  2714.  
  2715. ΓòÉΓòÉΓòÉ 7.1.4.3. OS/2 Database Requester Considerations ΓòÉΓòÉΓòÉ
  2716.  
  2717. If your OS/2 Client is an OS/2 Database Requester, Database Manager uses either 
  2718. a node logon, local logon or domain logon to get your User ID and password to 
  2719. validate your access to databases on the Database Server. For local or domain 
  2720. logons (using the LOCAL or LANSERVER,IBM definitions) the password provided by 
  2721. UPM to Database Manager after a password change may be incorrect (the NET 
  2722. command does not update the UPM table from which the password is retrieved). 
  2723. However, for node logons (using the NODE definition), NSC will force UPM to 
  2724. update the password for the node logon after a password change by performing 
  2725. another node logon with the currently logged on User ID and the new password. 
  2726. For OS/2 Clients running OS/2 Database Requester, use a NODE definition to 
  2727. identify your User ID to Database Manager for each Database Server to which you 
  2728. connect. See NODE for an example and information on configuring the NODE 
  2729. definition. 
  2730.  
  2731.  
  2732. ΓòÉΓòÉΓòÉ 7.1.5. Configuration File Example ΓòÉΓòÉΓòÉ
  2733.  
  2734. The following configuration file shows several configuration definitions and 
  2735. illustrates how the placement of definitions for host connections is 
  2736. significant. 
  2737.  
  2738.  
  2739. NSC Configuration File Example
  2740.  
  2741. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2742. Γöé *                   NSC Configuration File for Paul D. Queue     Γöé
  2743. Γöé USERID=PDQUEUE                 Default User ID                   Γöé
  2744. Γöé *                              Passwords on VM1A and VM2B must beΓöé
  2745. Γöé MINPWLEN=5                       - at least five chars long, and Γöé
  2746. Γöé MAXPWLEN=6                       - no more than six.             Γöé
  2747. Γöé BEEP=OFF                       Run quietly                       Γöé
  2748. Γöé LOCAL,ON                       Local UPM                         Γöé
  2749. Γöé NODE,NAME=DBM03,ON             Node logon for DBM                Γöé
  2750. Γöé *                              Signon to VM1A 3270 Session       Γöé
  2751. Γöé HOST,EMULATOR,NAME=VM1A,ON,HIF=d:\nsc\nscvm.hif,V1=A,V2=AUSVM1   Γöé
  2752. Γöé *                              Signon to VM2B 3270 Session       Γöé
  2753. Γöé HOST,EMULATOR,NAME=VM2B,ON,HIF=d:\nsc\nscvm.hif,V1=B,V2=AUSVM2   Γöé
  2754. Γöé *                              Signon to LAN Server LANSYS04     Γöé
  2755. Γöé LANSERVER,IBM,NAME=LANSYS04,ON                                   Γöé
  2756. Γöé *                              LAN Server LANSYS07 (no signon)   Γöé
  2757. Γöé LANSERVER,IBM,NAME=LANSYS07                                      Γöé
  2758. Γöé SERVER,NAME=DBM03              OS/2 Database Server/Gateway      Γöé
  2759. Γöé *                              Route everything behind this to   Γöé
  2760. Γöé *                              NSC Server DBM03                  Γöé
  2761. Γöé LOCAL                          Change UPM passwords at DBM03     Γöé
  2762. Γöé HOST,APPC,NAME=MVSSYS01,ON     DB2 Host pswd verify and changes  Γöé
  2763. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2764.  
  2765. This is a customized configuration file for Mr. Paul D. Queue. Comments in the 
  2766. configuration file explain most of the definitions. The User ID Character Set 
  2767. definition is not specified since "PDQUEUE" is the only User ID Mr. Queue will 
  2768. ever use, and the default character set is acceptable for passwords as well. 
  2769. Since he always allows the User ID to default, the minimum and maximum User ID 
  2770. length are not a concern. 
  2771.  
  2772. Mr. Queue has specified the LOCAL definition with the ON parameter, requesting 
  2773. a local logon at signon. He has also specified the NODE definition with the ON 
  2774. parameter, requesting a node logon at signon for the OS/2 Database Manager at 
  2775. the DBM03 workstation. 
  2776.  
  2777. The first two HOST definitions precede the first SERVER definition and are 
  2778. accessed via 3270 emulation sessions from Mr. Queue's workstation. The sample 
  2779. host information file NSCVM.HIF will be used to log Mr. Queue on to both hosts 
  2780. at signon, since the HOST definition specifies the ON parameter for both of 
  2781. these hosts. 
  2782.  
  2783. Mr. Queue is defined on two IBM LAN Server domains. He wants to be signed on to 
  2784. LANSYS04 at signon, so he has specified the ON parameter in the LANSYS04 
  2785. LANSERVER definition. The other LANSERVER definition is specified without the 
  2786. ON parameter, so that only password changes are made on the LANSYS07 domain. 
  2787.  
  2788. Finally, Mr. Queue uses Extended Services Database Manager to access a remote 
  2789. database. The computername of the database server is "DBM03". He also uses 
  2790. Distributed Database Connection Services/2(*) (DDCS/2) to access a DB2(*) 
  2791. database using the database server as a gateway. To synchronize his passwords 
  2792. on the database server and on the MVS host where DB2 resides, Mr. Queue 
  2793. specifies a SERVER definition followed by a LOCAL definition and a HOST 
  2794. definition. Specifying the LOCAL definition after the SERVER definition 
  2795. indicates a UPM password change is processed at DBM03 (an NSC Server). 
  2796. Specifying the HOST definition after the SERVER definition indicates the host 
  2797. connection is from DBM03. An APPC profile "MVSSYS01" has been defined in the 
  2798. Communications Manager configuration on DBM03 to send password changes to the 
  2799. host. 
  2800.  
  2801.  
  2802. ΓòÉΓòÉΓòÉ 7.2. Configuring NETBIOS ΓòÉΓòÉΓòÉ
  2803.  
  2804. If you have an NSC Server (NSCNDMN program with or without NSCRETRY) or run an 
  2805. NSC Client that uses an NSC Server, you may have to configure additional 
  2806. NETBIOS resources. 
  2807.  
  2808. NSC programs require the following NETBIOS resources: 
  2809.  
  2810.      NSCNDMN 
  2811.  
  2812.            6 sessions (*) 
  2813.            6 commands (*) 
  2814.            1 name 
  2815.  
  2816.      NSCRETRY 
  2817.  
  2818.            1 session 
  2819.            1 command 
  2820.            1 name 
  2821.  
  2822.      NSC (or NSCPM, NSCRSON or NSCRSOFF) 
  2823.  
  2824.            1 session 
  2825.            1 command 
  2826.            1 name 
  2827.  
  2828.  You may configure the NETBIOS sessions and commands required by NSCNDMN as 
  2829.  command line parameters to the NSCNDMN program. The number specified 
  2830.  determines how many concurrent NSC Client requests the NSC Server can process. 
  2831.  The default is for the NSC Server to request 6 sessions and 6 commands, but 
  2832.  fail only if it is allocated less than 2 sessions or 2 commands. 
  2833.  
  2834.  If you have not configured enough NETBIOS resources, the NSC process will fail 
  2835.  when it is started and the following message is logged and displayed: 
  2836.  
  2837.     NB 01 tt:tt:tt ResAlloc add nn more SESSIONS, nn more NCBS, and nn more NAMES.
  2838.  
  2839.  In the message, "nn" is the number of additional resources needed to 
  2840.  successfully start the NSC process. 
  2841.  
  2842.  In Extended Services 1.0 and LAN Server 2.0, these NETBIOS resources are 
  2843.  configured in the "PROTOCOL.INI" file located in the "C:\IBMCOM" directory. 
  2844.  The parameters are specified in the "NETBEUI" section of the file as follows: 
  2845.  
  2846.     SESSIONS = nn
  2847.     NCBS = nn
  2848.     NAMES = nn
  2849.  
  2850.  Note that "NCBS" is equivalent to "commands". In Extended Edition 1.3, the 
  2851.  NETBIOS parameters are changed using the Communications Manager Configuration 
  2852.  function. You must restart the workstation for the new resource allocations to 
  2853.  take effect. 
  2854.  
  2855.  NSC NETBIOS resource requirements are additive. Add the requirements for each 
  2856.  NSC program that will run concurrently on the workstation to get a total 
  2857.  NETBIOS resource requirement. For example, on an OS/2 Client where NSCRETRY 
  2858.  will be running when a signon is performed, a minimum of two is required for 
  2859.  each of the NETBIOS parameters. An NSC Server running NSCRETRY requires a 
  2860.  minimum of 7, 7, and 2 respectively for these parameters. 
  2861.  
  2862.  NSC Clients register NETBIOS names that begin with "NSC". NSC may be 
  2863.  incompatible with a NETBIOS application that also attempts to register names 
  2864.  beginning with "NSC". 
  2865.  
  2866.  
  2867. ΓòÉΓòÉΓòÉ 7.3. Configuring EMULATOR Connections ΓòÉΓòÉΓòÉ
  2868.  
  2869. NSC uses a host information file (HIF) to process your requests using a host 
  2870. emulator session. NSC reads what is on the emulated terminal screen and inputs 
  2871. keystroke information just as if you had pressed the keys on the keyboard. You 
  2872. use the host information file to tell NSC how to interpret the screen 
  2873. information and what to send the host computer system. 
  2874.  
  2875. The host information file is a flat ASCII file that you may change using any 
  2876. ASCII editor (for example, the OS/2 Enhanced Editor). If you do not identify 
  2877. the host information file using the HIF parameter on the HOST definition, then 
  2878. the host information file must reside in the same directory as NSC.INI and have 
  2879. a file extension of "INI". When the host connection is made from an NSC Server, 
  2880. the host information file is accessed at the computer specified in the Client's 
  2881. SERVER definition. 
  2882.  
  2883. NSC provides sample host information files for MVS, VM, and OS/400 host 
  2884. emulator sessions. You may be able to use one of these sample host information 
  2885. files with your host emulator session without making changes. To configure a 
  2886. host emulator connection, follow these steps: 
  2887.  
  2888.    1. If you have a DOS Client, see Emulator Considerations. 
  2889.  
  2890.    2. Refer to the sample host information file for your system in Sample Host 
  2891.       Information Files. 
  2892.  
  2893.    3. Read the instructions for using the host information file. 
  2894.  
  2895.    4. Make a copy of the sample host information file. 
  2896.  
  2897.    5. Configure your HOST definition in the NSC configuration file using the 
  2898.       copy of the host information file. 
  2899.  
  2900.         a) Specify the HIF filename 
  2901.  
  2902.         b) Specify the HIF variable for the session id 
  2903.  
  2904.         c) Specify any other HIF variables required for the sample host 
  2905.            information file 
  2906.  
  2907.    6. If you have more than one host account, repeat step 5 for each account. 
  2908.       Be sure to specify a unique hostname and session id for each unique host. 
  2909.       If you have multiple User IDs on the same host, or if you have more 
  2910.       accounts than available session ids, refer to the notes in SESSION for 
  2911.       information on how to assign session ids. 
  2912.  
  2913.  You may need to customize your host information file because of software 
  2914.  differences on your host. If so, see the following sections: 
  2915.  
  2916.       General HIF Information 
  2917.  
  2918.       HIF Structure 
  2919.  
  2920.       Configuration Definitions 
  2921.  
  2922.       Screen Definitions 
  2923.  
  2924.  
  2925. ΓòÉΓòÉΓòÉ 7.3.1. Emulator Considerations ΓòÉΓòÉΓòÉ
  2926.  
  2927. To communicate with your terminal emulation session, NSC uses the Emulator High 
  2928. Level Language Application Program Interface (EHLLAPI). Many terminal emulation 
  2929. packages provide EHLLAPI support. For OS/2, NSC will work only with those 
  2930. emulators listed in OS/2 Clients. For DOS, NSC can work with any DOS or Windows 
  2931. emulators that provide a software interrupt handler for interrupt X'7F'. The 
  2932. DOS and Windows emulators that have been validated to work with NSC are listed 
  2933. in DOS Clients. 
  2934.  
  2935. This section describes special considerations for the following validated DOS 
  2936. emulators: 
  2937.  
  2938.       IBM PC 3270 Emulation Program Entry Level Version 2.0 and 3.0 
  2939.  
  2940.       IBM Personal Communications/3270 (DOS Mode) Version 2.0 and 3.0 
  2941.  
  2942.       IBM Personal Communications/3270 (Windows Mode) Version 3.0 
  2943.  
  2944.       RUMBA for the Mainframe Version 3.1 Update 05 
  2945.  
  2946.       RUMBA for the AS/400 Version 1.0 Update 03 PTF 8757 
  2947.  
  2948.  
  2949. ΓòÉΓòÉΓòÉ 7.3.1.1. IBM PC 3270 Emulation Program Entry Level Version 2.0 and 3.0 ΓòÉΓòÉΓòÉ
  2950.  
  2951.      This emulator supports only one emulation session, which is assigned a 
  2952.       session id of E. You must use E for the SESSION definition in the host 
  2953.       information file. 
  2954.  
  2955.      This emulator does not support the BackSpace key (@K) or the End key 
  2956.       (@D). Do not use these control characters in the host information file. 
  2957.  
  2958.      To get EHLLAPI support with Version 2.0 of this emulator follow these 
  2959.       steps: 
  2960.  
  2961.         1. Edit the batch file that you normally use to start this emulator, 
  2962.            which will be either the AUTOEXEC.BAT file, or a file you have 
  2963.            created to do this. If you currently execute PC3270.COM to start the 
  2964.            emulator, you need to create a batch file. Modify the batch file so 
  2965.            that it contains these two commands: 
  2966.  
  2967.              -  <PC3270 PATH>\PC3270 r 
  2968.  
  2969.                 This command starts the emulator in resume mode so that NSC can 
  2970.                 continue running when you have switched to the emulation 
  2971.                 session. Do not use the command line option c when executing 
  2972.                 this command, it disables EHLLAPI support. 
  2973.  
  2974.              -  <PC3270 PATH>\EEHLLAPI 
  2975.  
  2976.                 This command loads EHLLAPI support. 
  2977.  
  2978.         2. If the emulator is currently running, reboot your system by pressing 
  2979.            the Ctrl+Alt+Delete keys. 
  2980.  
  2981.         3. Start the emulator as you normally do, or by using the new batch 
  2982.            file if you had to create one. You now have EHLLAPI support. 
  2983.  
  2984.      To get EHLLAPI support with Version 3.0 of this emulator follow these 
  2985.       steps: 
  2986.  
  2987.         1. Alter the emulators configuration file by executing the Entry Level 
  2988.            3.0 command CONFIG. 
  2989.  
  2990.         2. On the initial menu, enter the name of your existing configuration 
  2991.            file. This is the name of the command you execute to start the 
  2992.            emulator. For example: 
  2993.  
  2994.                           D:\PC3270\PC3270.BAT
  2995.  
  2996.         3. Press F8 until you get to the menu titled CUT Configuration. 
  2997.  
  2998.         4. Set High Level Language Application Program Interface to YES. 
  2999.  
  3000.         5. Press F8 until you get to the final menu. 
  3001.  
  3002.         6. Press F6 to save the change. 
  3003.  
  3004.         7. Press F3 to exit CONFIG. 
  3005.  
  3006.         8. If the emulator is currently running, reboot your system by pressing 
  3007.            the Ctrl+Alt+Delete keys. 
  3008.  
  3009.         9. Start the emulator as you normally do. You now have EHLLAPI support. 
  3010.  
  3011.  
  3012. ΓòÉΓòÉΓòÉ 7.3.1.2. IBM Personal Communications/3270 (DOS Mode) Version 2.0 and 3.0 ΓòÉΓòÉΓòÉ
  3013.  
  3014.      This emulator supports up to 8 sessions, which are assigned a session id 
  3015.       of A through H. The session id for a particular emulator session is 
  3016.       displayed in the 7th column of its Operator Information Area (OIA), that 
  3017.       occupies the bottom row of the host screen. 
  3018.  
  3019.      This emulator does not support the End key (@D). Do not use this control 
  3020.       character in the host information file. 
  3021.  
  3022.      You may not have chosen to include EHLLAPI support when you installed 
  3023.       this emulator. If you did not include EHLLAPI support, follow these 
  3024.       steps: 
  3025.  
  3026.         1. Insert Disk 1 of the emulator's installation diskettes into a 
  3027.            diskette drive. 
  3028.  
  3029.         2. Change to the root directory of the diskette drive. 
  3030.  
  3031.         3. Type INSTALL and press Enter. 
  3032.  
  3033.         4. Press F8 to go to the menu titled Personal Communications/3270 
  3034.            Installation. 
  3035.  
  3036.         5. Select Flexible Installation, and press F8. 
  3037.  
  3038.         6. Enter the name of your existing configuration file.  This is the 
  3039.            name of the command you execute to start the emulator.  For example: 
  3040.  
  3041.                          D:\PC3270\PC3270.BAT
  3042.  
  3043.         7. Press F8 until you get to the menu titled End of Link Options. 
  3044.  
  3045.         8. Set Advanced Configuration Options to YES, and press F8. 
  3046.  
  3047.         9. Set Facilities to YES, and press F8. 
  3048.  
  3049.        10. Set High Level Language Application Program Interface to YES. 
  3050.  
  3051.        11. Press F8 until you get to the final menu. 
  3052.  
  3053.        12. Press F6 to install EHLLAPI support. 
  3054.  
  3055.        13. Follow the screen prompts for the installation diskettes. 
  3056.  
  3057.        14. When finished installing, press F3 to exit INSTALL. 
  3058.  
  3059.        15. If the emulator is currently running, switch to a host session and 
  3060.            press the Ctrl+End key to stop the emulator. 
  3061.  
  3062.        16. Start the emulator as you normally do. You now have EHLLAPI support. 
  3063.  
  3064.  
  3065. ΓòÉΓòÉΓòÉ 7.3.1.3. IBM Personal Communications/3270 (Windows Mode) Version 3.0 ΓòÉΓòÉΓòÉ
  3066.  
  3067.      NSC will work with this emulator only in Windows 386/486 Enhanced mode. 
  3068.       Refer to Installing DOS Workstations for information on how to install 
  3069.       NSC for use in Windows 386/486 Enhanced mode. 
  3070.  
  3071.      This emulator supports multiple sessions. The session id for a particular 
  3072.       session is displayed in the session's title bar, the session's icon text, 
  3073.       and in the 7th column of its Operator Information Area (OIA), that 
  3074.       occupies the bottom row of the host screen. 
  3075.  
  3076.      This emulator does not support the End key (@D). Do not use this control 
  3077.       character in the host information file. 
  3078.  
  3079.      To configure the emulator to provide EHLLAPI support, follow these steps: 
  3080.  
  3081.         1. From the Personal Communications group, start the Setup program. 
  3082.  
  3083.              a) Select the Options menu from the action bar. 
  3084.  
  3085.              b) Select the Change System Settings... item. 
  3086.  
  3087.              c) Check the box for the Dos-Mode EHLLAPI item in the API settings 
  3088.                 group. 
  3089.  
  3090.              d) Select the OK push button. 
  3091.  
  3092.              e) Select the Restart Windows push button from the Exit Windows 
  3093.                 dialog. 
  3094.  
  3095.         2. When Windows has restarted, for each of the sessions you will use 
  3096.            NSC with, follow these steps: 
  3097.  
  3098.              a) From the Personal Communications group, start the session's 
  3099.                 WorkStation program. 
  3100.  
  3101.              b) Select the File menu from the action bar. 
  3102.  
  3103.              c) Select the API Settings... item. 
  3104.  
  3105.              d) Check the DDE/EHLLAPI box. 
  3106.  
  3107.              e) Select ON for the Dos-Mode EHLLAPI item. 
  3108.  
  3109.              f) Select the OK push button. 
  3110.  
  3111.              g) Select the OK push button from the Personal Communications 
  3112.                 dialog. 
  3113.  
  3114.              h) Select the File menu from the action bar again. 
  3115.  
  3116.              i) Select the Save item. 
  3117.  
  3118.                 Note:   If you have not yet created a WorkStation Profile for 
  3119.                 this WorkStation icon, you are presented with the Save 
  3120.                 WorkStation Profile as dialog. To save the new settings, follow 
  3121.                 these steps: 
  3122.  
  3123.                   1. Enter a file name in the File Name field. 
  3124.  
  3125.                   2. Select the OK push button. 
  3126.  
  3127.                   3. Select the YES push button from the Personal 
  3128.                      Communications dialog. This creates a new icon for a 
  3129.                      WorkStation program using these new settings. 
  3130.  
  3131.                   4. Enter a name of your choice in the Program Group field 
  3132.                      when presented with the Add WorkStation Program to Program 
  3133.                      Group dialog, or accept the supplied name. 
  3134.  
  3135.                   5. Select the OK push button. 
  3136.  
  3137.                   6. Select the OK push button from the Personal Communications 
  3138.                      dialog. 
  3139.  
  3140.              j) Select the File menu from the WorkStation program's action bar. 
  3141.  
  3142.              k) Select the Exit item. 
  3143.  
  3144.              l) Start the session's WorkStation program. You now have EHLLAPI 
  3145.                 support for this session. 
  3146.  
  3147.  
  3148. ΓòÉΓòÉΓòÉ 7.3.1.4. RUMBA for the Mainframe Version 3.1 Update 05 ΓòÉΓòÉΓòÉ
  3149.  
  3150.      NSC will work with this emulator only in Windows 386/486 Enhanced mode. 
  3151.       Refer to Installing DOS Workstations for information on how to install 
  3152.       NSC for use in Windows 386/486 Enhanced mode. 
  3153.  
  3154.      This emulator supports multiple sessions. The session id for a particular 
  3155.       session is specified during configuration of the emulator's EHLLAPI 
  3156.       support (see below). 
  3157.  
  3158.      To configure the emulator to provide EHLLAPI support, follow these steps: 
  3159.  
  3160.         1. Edit the AUTOEXEC.BAT file, adding the command <RUMBA PATH>\SET7F to 
  3161.            the beginning of the file, for example: 
  3162.  
  3163.                          @ECHO OFF
  3164.                          D:\RUMBA\SET7F
  3165.                          ...
  3166.  
  3167.         2. Edit the Windows SYSTEM.INI file, that is located in the Windows 
  3168.            install directory, for example C:\WINDOWS\WINDOWS.INI. Add the 
  3169.            statement DEVICE=<RUMBA PATH>\VWHLLD.386 to the [386Enh] section of 
  3170.            the file, for example: 
  3171.  
  3172.                         [386Enh]
  3173.                            DEVICE=D:\RUMBA\VWHLLD.386
  3174.                            ...
  3175.  
  3176.         3. Select the File menu from the Program Manager's action bar. 
  3177.  
  3178.         4. Select the Exit Windows... item. 
  3179.  
  3180.         5. Select the OK push button from the Exit Windows dialog. 
  3181.  
  3182.         6. Reboot your system by pressing the Ctrl+Alt+Delete keys. 
  3183.  
  3184.         7. When the system has restarted, if Windows was not auto started from 
  3185.            the AUTOEXEC.BAT file, start it by entering the WIN command. For 
  3186.            each of the sessions you will use NSC with, follow these steps: 
  3187.  
  3188.              a) From the RUMBA Applications or Rumba Profile program group, 
  3189.                 start the session's Terminal program. 
  3190.  
  3191.              b) Select the Session menu from the action bar. 
  3192.  
  3193.              c) Select the EHLLAPI Configuration... item. 
  3194.  
  3195.              d) Check the EHLLAPI SDK box from the EHLLAPI Configuration 
  3196.                 dialog. 
  3197.  
  3198.              e) Enter a one character session id in the Short Name... field. 
  3199.  
  3200.                 Note:   This is the session id you must specify in the SESSION 
  3201.                 definition of the host information file. 
  3202.  
  3203.              f) Select the OK push button. 
  3204.  
  3205.              g) Select the File menu from the action bar. 
  3206.  
  3207.              h) Select the Save item. 
  3208.  
  3209.                 Note:   If you have not yet created a Terminal Profile for this 
  3210.                 Terminal icon, you are presented with the Save Profile dialog. 
  3211.                 To save the new settings, follow these steps: 
  3212.  
  3213.                   1. Enter a file name in the Filename field. 
  3214.  
  3215.                   2. Check the Create Icon Entry box for the Program Item 
  3216.                      settings group. 
  3217.  
  3218.                   3. Enter description text in the Program Item Description 
  3219.                      field. It may be helpful to include the session id you 
  3220.                      chose in this description text. For example: if you enter 
  3221.                      "Terminal Session A", this text is displayed as the icon's 
  3222.                      description text, and makes it easier to find the session 
  3223.                      id when needed. 
  3224.  
  3225.                   4. Select the OK push button. This creates a new icon for a 
  3226.                      Terminal program using these new settings. The new icon is 
  3227.                      added to the Rumba Profile program group. 
  3228.  
  3229.                   5. Select the OK push button. This creates a program icon for 
  3230.                      a Terminal program using these new settings. The icon is 
  3231.                      added to the Rumba Profile program group. Use this icon to 
  3232.                      start the session's Terminal program. 
  3233.  
  3234.              i) Select the File menu from the action bar. 
  3235.  
  3236.              j) Select the Exit item. 
  3237.  
  3238.              k) Start the session's Terminal program. You now have EHLLAPI 
  3239.                 support for this session. 
  3240.  
  3241.  
  3242. ΓòÉΓòÉΓòÉ 7.3.1.5. RUMBA for the AS/400 Version 1.0 Update 03 PTF 8757 ΓòÉΓòÉΓòÉ
  3243.  
  3244.      NSC will work with this emulator only in Windows 386/486 Enhanced mode. 
  3245.       Refer to Installing DOS Workstations for information on how to install 
  3246.       NSC for use in Windows 386/486 Enhanced mode. 
  3247.  
  3248.      This emulator supports multiple sessions. The session id for a particular 
  3249.       session is specified during configuration of the emulator's EHLLAPI 
  3250.       support (see below). 
  3251.  
  3252.      To configure the emulator to provide EHLLAPI support, follow these steps: 
  3253.  
  3254.         1. Edit the AUTOEXEC.BAT file, adding the command <RUMBA PATH>\SET7F to 
  3255.            the beginning of the file, for example: 
  3256.  
  3257.                          @ECHO OFF
  3258.                          D:\RUMBAPCS\SET7F
  3259.                          ...
  3260.  
  3261.         2. Edit the Windows SYSTEM.INI file, that is located in the Windows 
  3262.            install directory, for example C:\WINDOWS\WINDOWS.INI. Add the 
  3263.            statement DEVICE=<RUMBA PATH>\VWHLLD.386 to the [386Enh] section of 
  3264.            the file, for example: 
  3265.  
  3266.                         [386Enh]
  3267.                            DEVICE=D:\RUMBAPCS\VWHLLD.386
  3268.                            ...
  3269.  
  3270.         3. Select the File menu from the Program Manager's action bar. 
  3271.  
  3272.         4. Select the Exit Windows... item. 
  3273.  
  3274.         5. Select the OK push button from the Exit Windows dialog. 
  3275.  
  3276.         6. Reboot your system by pressing the Ctrl+Alt+Delete keys. 
  3277.  
  3278.         7. When the system has restarted, if Windows was not auto started from 
  3279.            the AUTOEXEC.BAT file, start it by entering the WIN command. For 
  3280.            each of the sessions you will use NSC with, follow these steps: 
  3281.  
  3282.              a) From the RUMBA for AS/400 Applications program group, start the 
  3283.                 session's Terminal program. 
  3284.  
  3285.              b) Select the Session menu from the action bar. 
  3286.  
  3287.              c) Select the EHLLAPI Configuration... item. 
  3288.  
  3289.              d) Check the EHLLAPI SDK box from the EHLLAPI Configuration 
  3290.                 dialog. 
  3291.  
  3292.              e) Enter a one character session id in the Short Name field. 
  3293.  
  3294.                 Note:   This is the session id you must specify in the SESSION 
  3295.                 definition of the host information file. 
  3296.  
  3297.              f) Select the OK push button. 
  3298.  
  3299.              g) Select the File menu from the action bar. 
  3300.  
  3301.              h) Select the Save item. 
  3302.  
  3303.                 Note:   If you have not yet created a Terminal Profile for this 
  3304.                 Terminal icon, you are presented with the Save Profile dialog. 
  3305.                 To save the new settings, follow these steps: 
  3306.  
  3307.                   1. Enter a file name of your choice in the Filename field. 
  3308.  
  3309.                   2. Select the OK push button. 
  3310.  
  3311.                   3. Select the File menu from the action bar. 
  3312.  
  3313.                   4. Select the Exit item. 
  3314.  
  3315.                   5. To create a program icon that can be used to start this 
  3316.                      session, follow these steps: 
  3317.  
  3318.                        a) Select the program group you would like to add the 
  3319.                           icon to by selecting either the group's icon or its 
  3320.                           window via the mouse or keyboard. 
  3321.  
  3322.                        b) Select the File menu from the Program Manager's 
  3323.                           action bar. 
  3324.  
  3325.                        c) Select the New... item. 
  3326.  
  3327.                        d) Select the Program Item option. 
  3328.  
  3329.                        e) Select the OK push button. 
  3330.  
  3331.                        f) Enter description text in the Description field of 
  3332.                           the Program Item Properties dialog. It may be helpful 
  3333.                           to include the session id you chose in this 
  3334.                           description text. For example: if you enter "Terminal 
  3335.                           Session A", this text is displayed as the icon's 
  3336.                           description text, and makes it easier to find the 
  3337.                           session id when needed. 
  3338.  
  3339.                        g) Enter <RUMBA PATH>\RUMBAWSF.EXE Profile Name in the 
  3340.                           Command Line field. Profile Name is the file name you 
  3341.                           supplied when saving the terminal profile in a 
  3342.                           previous step. For example: D:\RUMBAPCS\RUMBAWSF.EXE 
  3343.                           SESSIONA.WSF. 
  3344.  
  3345.                        h) Enter <RUMBA PATH> in the Working Directory field. 
  3346.  
  3347.                        i) Select the OK push button. This creates a program 
  3348.                           icon for a Terminal program using these new settings. 
  3349.                           The icon is added to the program group you selected. 
  3350.                           Use this icon to start the session's Terminal 
  3351.                           program. 
  3352.  
  3353.              i) Start the session's Terminal program. You now have EHLLAPI 
  3354.                 support for this session. 
  3355.  
  3356.  
  3357. ΓòÉΓòÉΓòÉ 7.3.2. General HIF Information ΓòÉΓòÉΓòÉ
  3358.  
  3359. The following sections contain information on the syntax of definitions found 
  3360. in the host information file. 
  3361.  
  3362.       Syntax 
  3363.  
  3364.       Control Characters 
  3365.  
  3366.       HIF Variables 
  3367.  
  3368.  
  3369. ΓòÉΓòÉΓòÉ 7.3.2.1. Syntax ΓòÉΓòÉΓòÉ
  3370.  
  3371. The host information file syntax rules are: 
  3372.  
  3373.      Line length may not exceed 256 characters (bytes). 
  3374.  
  3375.      Empty lines, blanks, and tabs are ignored. 
  3376.  
  3377.      Only one keyword is permitted per line. 
  3378.  
  3379.      A keyword and the first parameter must be separated by at least one 
  3380.       blank, and the remaining parameters must be separated by commas (,). For 
  3381.       example: 
  3382.  
  3383.               NEXT "enter password", "@p@E", "logoff@E"
  3384.  
  3385.      A keyword and the parameters must all appear on the same line. 
  3386.  
  3387.      Keywords are not case sensitive (i.e., Logon, LOGON, and logon are 
  3388.       equivalent). Keywords are shown in uppercase in the examples to help 
  3389.       distinguish them. 
  3390.  
  3391.      Character strings are case sensitive and must be enclosed by double 
  3392.       quotes ("). To include a double quote within a string, two consecutive 
  3393.       double quotes must be used (""). For example: 
  3394.  
  3395.               "This is a double quote "" in a string"
  3396.  
  3397.      Comments can appear either on a separate line or on the same line as a 
  3398.       keyword.  All characters following an asterisk (*) are assumed to be 
  3399.       commentary, unless the asterisk is in a character string. For example: 
  3400.  
  3401.               * This comment appears on a separate line
  3402.               SESSION A     * This comment shares a line
  3403.  
  3404.  
  3405. ΓòÉΓòÉΓòÉ 7.3.2.2. Control Characters ΓòÉΓòÉΓòÉ
  3406.  
  3407. Control characters are used within a character string to specify a 
  3408. non-alphanumeric terminal keystroke or to substitute some information in the 
  3409. string. A control character is indicated by a preceding at sign (@). To include 
  3410. an at sign within a string, two consecutive at signs must be used (@@). Note: 
  3411. control characters are case sensitive. 
  3412.  
  3413. Table "Keyboard Control Characters" shows control characters that represent 
  3414. keystrokes. Table "Substitution Control Characters" shows control characters 
  3415. that allow you to substitute the User ID, password, and new password in a 
  3416. string. You can also use a special control character that causes a time delay. 
  3417.  
  3418. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3419. Γöé          Keyboard Control Characters                        Γöé
  3420. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3421. Γöé CHAR- Γöé KEY                  Γöé CHAR- Γöé KEY                  Γöé
  3422. Γöé ACTER Γöé                      Γöé ACTER Γöé                      Γöé
  3423. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3424. Γöé  @    Γöé  @                   Γöé  j    Γöé  PF19                Γöé
  3425. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3426. Γöé  1    Γöé  PF1                 Γöé  v    Γöé  PF20                Γöé
  3427. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3428. Γöé  2    Γöé  PF2                 Γöé  w    Γöé  PF21                Γöé
  3429. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3430. Γöé  3    Γöé  PF3                 Γöé  x    Γöé  PF22                Γöé
  3431. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3432. Γöé  4    Γöé  PF4                 Γöé  y    Γöé  PF23                Γöé
  3433. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3434. Γöé  5    Γöé  PF5                 Γöé  z    Γöé  PF24                Γöé
  3435. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3436. Γöé  6    Γöé  PF6                 Γöé  A    Γöé  Attention           Γöé
  3437. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3438. Γöé  7    Γöé  PF7                 Γöé  B    Γöé  Left Tab            Γöé
  3439. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3440. Γöé  8    Γöé  PF8                 Γöé  C    Γöé  Clear Screen        Γöé
  3441. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3442. Γöé  9    Γöé  PF9                 Γöé  D    Γöé  End (1)             Γöé
  3443. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3444. Γöé  a    Γöé  PF10                Γöé  E    Γöé  Enter               Γöé
  3445. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3446. Γöé  b    Γöé  PF11                Γöé  F    Γöé  New Line            Γöé
  3447. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3448. Γöé  c    Γöé  PF12                Γöé  H    Γöé  Home                Γöé
  3449. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3450. Γöé  d    Γöé  PF13                Γöé  I    Γöé  Insert              Γöé
  3451. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3452. Γöé  e    Γöé  PF14                Γöé  K    Γöé  Back Space (1)      Γöé
  3453. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3454. Γöé  f    Γöé  PF15                Γöé  R    Γöé  Reset               Γöé
  3455. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3456. Γöé  g    Γöé  PF16                Γöé  T    Γöé  Right Tab           Γöé
  3457. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3458. Γöé  h    Γöé  PF17                Γöé  X    Γöé  System Request      Γöé
  3459. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3460. Γöé  i    Γöé  PF18                Γöé       Γöé                      Γöé
  3461. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3462. Γöé NOTE:                                                       Γöé
  3463. Γöé                                                             Γöé
  3464. Γöé 1.  Not supported by all DOS emulators.                     Γöé
  3465. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3466.  
  3467. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3468. Γöé          Substitution Control Characters               Γöé
  3469. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3470. Γöé CHAR-    Γöé REPLACED BY                                 Γöé
  3471. Γöé ACTER    Γöé                                             Γöé
  3472. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3473. Γöé  n       Γöé new password text                           Γöé
  3474. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3475. Γöé  N       Γöé new password text followed by the Tab key   Γöé
  3476. Γöé          Γöé if the text length is shorter than the      Γöé
  3477. Γöé          Γöé value of PField.                            Γöé
  3478. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3479. Γöé  p       Γöé password text                               Γöé
  3480. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3481. Γöé  P       Γöé password text followed by the Tab key if    Γöé
  3482. Γöé          Γöé the text length is shorter than the value   Γöé
  3483. Γöé          Γöé of PField.                                  Γöé
  3484. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3485. Γöé  s       Γöé 1-second delay, allows the host time to     Γöé
  3486. Γöé          Γöé process keystrokes                          Γöé
  3487. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3488. Γöé  S       Γöé 2-second delay, allows the host time to     Γöé
  3489. Γöé          Γöé process keystrokes                          Γöé
  3490. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3491. Γöé  u       Γöé User ID text                                Γöé
  3492. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3493. Γöé  U       Γöé User ID text followed by the Tab key if the Γöé
  3494. Γöé          Γöé text length is shorter than the value of    Γöé
  3495. Γöé          Γöé UField.                                     Γöé
  3496. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3497.  
  3498.  
  3499. ΓòÉΓòÉΓòÉ 7.3.2.3. HIF Variables ΓòÉΓòÉΓòÉ
  3500.  
  3501. HIF variables are used within the host information file to allow substitution 
  3502. of user specified text. A HIF variable is case sensitive, and is indicated by a 
  3503. preceding at sign (@). Ten HIF variables, @V0 through @V9, are supported, and 
  3504. may appear anywhere within the host information file. They are replaced with 
  3505. your text on the HOST definition line of the NSC configuration file. 
  3506.  
  3507. For details on how to specify HIF variables in the NSC configuration file, 
  3508. refer to HOST. For examples of how to use HIF variables within host information 
  3509. files, refer to Sample Host Information Files. 
  3510.  
  3511.  
  3512. ΓòÉΓòÉΓòÉ 7.3.3. HIF Structure ΓòÉΓòÉΓòÉ
  3513.  
  3514. The host information file contains five sections: 
  3515.  
  3516.  CONFIGURATION       Provides information about the host emulator session and 
  3517.                      the host system. 
  3518.  
  3519.                      See Configuration Section for more details. 
  3520.  
  3521.  GLOBAL              This section defines how NSC interacts with the host 
  3522.                      system while performing a signon, signoff, or password 
  3523.                      change. 
  3524.  
  3525.                      See Global Section for more details. 
  3526.  
  3527.  LOGON               This section defines how NSC interacts with the host 
  3528.                      system to perform a signon. 
  3529.  
  3530.                      See Logon Section for more details. 
  3531.  
  3532.  PASSWORD            This section defines how NSC interacts with the host 
  3533.                      system to perform a password change. 
  3534.  
  3535.                      See Change Password Section for more details. 
  3536.  
  3537.  LOGOFF              This section defines how NSC interacts with the host 
  3538.                      system to perform a signoff. 
  3539.  
  3540.                      See Logoff Section for more details. 
  3541.  Figure "Host Information File Sections" shows the host information file 
  3542.  sections. 
  3543.  
  3544.  
  3545.   Host Information File Sections
  3546.  
  3547.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3548.   ΓöéCONFIGURATION    *Section for config definitions              Γöé
  3549.   Γöé    .                                                         Γöé
  3550.   Γöé    .                                                         Γöé
  3551.   Γöé    .                                                         Γöé
  3552.   Γöé                                                              Γöé
  3553.   ΓöéGLOBAL           * Section for global definitions             Γöé
  3554.   Γöé    .                                                         Γöé
  3555.   Γöé    .                                                         Γöé
  3556.   Γöé    .                                                         Γöé
  3557.   Γöé                                                              Γöé
  3558.   ΓöéLOGON            * Section for logon definitions              Γöé
  3559.   Γöé    .                                                         Γöé
  3560.   Γöé    .                                                         Γöé
  3561.   Γöé    .                                                         Γöé
  3562.   Γöé                                                              Γöé
  3563.   ΓöéPASSWORD         * Section for password change definitions    Γöé
  3564.   Γöé    .                                                         Γöé
  3565.   Γöé    .                                                         Γöé
  3566.   Γöé    .                                                         Γöé
  3567.   Γöé                                                              Γöé
  3568.   ΓöéLOGOFF           * Section for logoff definitions             Γöé
  3569.   Γöé    .                                                         Γöé
  3570.   Γöé    .                                                         Γöé
  3571.   Γöé    .                                                         Γöé
  3572.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3573.  Sections may appear any number of times, in any order. 
  3574.  
  3575.  
  3576. ΓòÉΓòÉΓòÉ 7.3.3.1. Configuration Section ΓòÉΓòÉΓòÉ
  3577.  
  3578. The Configuration section, denoted by the keyword CONFIGURATION, defines 
  3579. general information about the host system. Configuration definitions may appear 
  3580. in any order within this section. If the same definition appears more than 
  3581. once, the last value is the one used. 
  3582.  
  3583. The following host definitions are allowed in the Configuration section: 
  3584.  
  3585.       SESSION 
  3586.       SESSIONWAIT 
  3587.       HOSTWAIT 
  3588.       UFIELD 
  3589.       PFIELD 
  3590.  
  3591.  
  3592. ΓòÉΓòÉΓòÉ 7.3.3.2. Global Section ΓòÉΓòÉΓòÉ
  3593.  
  3594. The Global section, denoted by the keyword GLOBAL, defines common screens that 
  3595. may be encountered at any time while interacting with a host system. This 
  3596. section can be used for such things as clearing a screen when a full screen 
  3597. indicator is displayed, or for exiting a host application or menu system 
  3598. sub-menu so that a successful signon, signoff, or password change can be 
  3599. achieved. A section consists of one or more screen definitions. 
  3600.  
  3601. Example: 
  3602.  
  3603. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3604. ΓöéGLOBAL                                                        Γöé
  3605. Γöé * these screen definitions describe common host interactions Γöé
  3606. Γöé                                                              Γöé
  3607. Γöé * these definitions will clear the screen                    Γöé
  3608. Γöé * clear the screen if the host says "HOLDING"                Γöé
  3609. Γöé CLEAR  "HOLDING"                                             Γöé
  3610. Γöé * clear the screen if the host says "MORE..."                Γöé
  3611. Γöé CLEAR  "MORE..."                                             Γöé
  3612. Γöé * clear the screen if the host says "Messages Waiting"       Γöé
  3613. Γöé CLEAR  "Messages Waiting"                                    Γöé
  3614. Γöé                                                              Γöé
  3615. Γöé * these definitions will exit an application                 Γöé
  3616. Γöé * send the F3 key to exit if reading your mail               Γöé
  3617. Γöé NEXT?  "MAILBOX",  "@3"                                      Γöé
  3618. Γöé * send the F2 key to save & F3 key to exit if using an editorΓöé
  3619. Γöé NEXT?  "XEDIT",    "@2@3"                                    Γöé
  3620. Γöé                                                              Γöé
  3621. Γöé * these definitions will back out of a submenu               Γöé
  3622. Γöé * send the F11 key to return to the main menu if in menu 2   Γöé
  3623. Γöé NEXT?  "MENU 2", "@b"                                        Γöé
  3624. Γöé * send the F12 key to return to previous menu if in sub-menu Γöé
  3625. Γöé NEXT?  "PF12=Return",  "@c"                                  Γöé
  3626. Γöé * send the F12 key to return to previous menu if in sub-menu Γöé
  3627. Γöé NEXT?  "Press PF12 for previous menu",  "@c"                 Γöé
  3628. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3629.  
  3630. If the host is in one of the specified screens, that screen definition will be 
  3631. processed. 
  3632.  
  3633. The following host screen definitions are allowed in the Global section: 
  3634.  
  3635.       CLEAR 
  3636.       NEXT? 
  3637.  
  3638.  
  3639. ΓòÉΓòÉΓòÉ 7.3.3.3. Logon Section ΓòÉΓòÉΓòÉ
  3640.  
  3641. The Logon section, denoted by the keyword LOGON, defines the screens 
  3642. encountered while logging on to a host system. A section consists of one or 
  3643. more groups of screen definitions. A screen definition group begins with a 
  3644. START definition and ends with a STOP definition. 
  3645.  
  3646. Example: 
  3647.  
  3648. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3649. ΓöéLOGON                                                         Γöé
  3650. Γöé * this group of screen definitions describes a logon sequenceΓöé
  3651. Γöé                                                              Γöé
  3652. Γöé * send node and User ID when prompted                        Γöé
  3653. Γöé START "Enter node User ID",  "NODE1 @u@E"                    Γöé
  3654. Γöé  * check if the User ID is valid                             Γöé
  3655. Γöé  UINV  "User ID invalid",     "logoff@E"                     Γöé
  3656. Γöé  * send password when prompted                               Γöé
  3657. Γöé  NEXT  "enter your password", "@p@E",       "logoff@E"       Γöé
  3658. Γöé  * logon is successful if the host says "Ready;"             Γöé
  3659. Γöé  STOP? "Ready;"                                              Γöé
  3660. Γöé  * check if the password is valid                            Γöé
  3661. Γöé  PINV  "password invalid",    "logoff@E"                     Γöé
  3662. Γöé  * check if the password has expired                         Γöé
  3663. Γöé  PEXP  "password expired",    "logoff@E"                     Γöé
  3664. Γöé  * check if the password will expire soon                    Γöé
  3665. Γöé  PWRN  "password will expire"                                Γöé
  3666. Γöé  * logon is successful if the host says "Ready;"             Γöé
  3667. Γöé STOP  "Ready;"                                               Γöé
  3668. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3669.  
  3670. If the host is in a start screen, that start screen's sequence of screen 
  3671. definitions will be processed in an attempt to reach its stop screen. If the 
  3672. host is already in one of the stop screens specified in this section, the user 
  3673. is already logged on. 
  3674.  
  3675. The following host screen definitions are allowed in the Logon section: 
  3676.  
  3677.       START 
  3678.       NEXT 
  3679.       NEXT? 
  3680.       HNAVL 
  3681.       ULOGD 
  3682.       UINV 
  3683.       PINV 
  3684.       UPINV 
  3685.       PEXP 
  3686.       PWRN 
  3687.       STOP? 
  3688.       STOP 
  3689.  
  3690.  
  3691. ΓòÉΓòÉΓòÉ 7.3.3.4. Change Password Section ΓòÉΓòÉΓòÉ
  3692.  
  3693. The Change Password section, denoted by the keyword PASSWORD, defines the 
  3694. screens encountered while changing a user's password on a host system. A 
  3695. section consists of one or more groups of screen definitions. A screen 
  3696. definition group begins with a START definition and ends with a STOP 
  3697. definition. 
  3698.  
  3699. If the host is in a start screen, that start screen's sequence of screen 
  3700. definitions will be processed in an attempt to reach its stop screen. 
  3701.  
  3702. Example: 
  3703.  
  3704. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3705. ΓöéPASSWORD                                                      Γöé
  3706. Γöé * this group of screen definitions describes the password    Γöé
  3707. Γöé * change sequence if the user is logged off                  Γöé
  3708. Γöé                                                              Γöé
  3709. Γöé * send node and User ID when prompted                        Γöé
  3710. Γöé START "Enter node User ID",  "NODE1 @u@E"                    Γöé
  3711. Γöé  * check if the User ID is valid                             Γöé
  3712. Γöé  UINV  "User ID invalid",     "logoff@E"                     Γöé
  3713. Γöé  * when prompted for password, enter                         Γöé
  3714. Γöé  * password/new password/new password                        Γöé
  3715. Γöé  NEXT  "enter your password", "@p/@n/@n@E",   "logoff@E"     Γöé
  3716. Γöé  * check if the current password is valid                    Γöé
  3717. Γöé  PINV  "password invalid",    "logoff@E"                     Γöé
  3718. Γöé  * check if the new password is valid                        Γöé
  3719. Γöé  NINV  "new password invalid","logoff@E"                     Γöé
  3720. Γöé  * when password is changed and finished logging on, logoff  Γöé
  3721. Γöé  NEXT  "Ready;",              "logoff@E",     "@A@slogoff@E" Γöé
  3722. Γöé  * pswd change successful if the host is in the stop screen  Γöé
  3723. Γöé STOP  "Enter node User ID"                                   Γöé
  3724. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3725.  
  3726. The following host screen definitions are allowed in the Password section: 
  3727.  
  3728.       START 
  3729.       NEXT 
  3730.       NEXT? 
  3731.       HNAVL 
  3732.       ULOGD 
  3733.       UINV 
  3734.       PINV 
  3735.       UPINV 
  3736.       NINV 
  3737.       PNINV 
  3738.       STOP? 
  3739.       STOP 
  3740.  
  3741.  
  3742. ΓòÉΓòÉΓòÉ 7.3.3.5. Logoff Section ΓòÉΓòÉΓòÉ
  3743.  
  3744. The Logoff section, denoted by the keyword LOGOFF, defines the screens 
  3745. encountered while logging off from a host system. A section consists of one or 
  3746. more groups of screen definitions. A screen definition group begins with a 
  3747. START definition and ends with a STOP definition. 
  3748.  
  3749. If the host is in a start screen, that start screen's sequence of screen 
  3750. definitions will be processed in an attempt to reach its stop screen. If the 
  3751. host is already in one of the stop screens specified in this section, the user 
  3752. is already logged off. 
  3753.  
  3754. Example: 
  3755.  
  3756. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3757. ΓöéLOGOFF                                                        Γöé
  3758. Γöé * this group of screen definitions is a logoff sequence      Γöé
  3759. Γöé                                                              Γöé
  3760. Γöé * exit when in the menu system                               Γöé
  3761. Γöé START "Menu I",           "@3"                               Γöé
  3762. Γöé  * logoff when finished exiting menu system                  Γöé
  3763. Γöé  NEXT  "Ready;",           "logoff@E",  "@A@slogoff@E"       Γöé
  3764. Γöé  * logoff successful if the host is in the stop screen       Γöé
  3765. Γöé STOP  "Enter node User ID"                                   Γöé
  3766. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3767.  
  3768. The following host screen definitions are allowed in the Logoff section: 
  3769.  
  3770.       START 
  3771.       NEXT 
  3772.       NEXT? 
  3773.       STOP? 
  3774.       STOP 
  3775.  
  3776.  
  3777. ΓòÉΓòÉΓòÉ 7.3.4. Configuration Definitions ΓòÉΓòÉΓòÉ
  3778.  
  3779. The configuration definitions and where to find out more about them are: 
  3780.  
  3781.  To specify                          Definition 
  3782.  -------------                       ------------- 
  3783.  Session Identifier                  SESSION 
  3784.  Session wait time                   SESSIONWAIT 
  3785.  Host wait time                      HOSTWAIT 
  3786.  User ID field length                UFIELD 
  3787.  Password field length               PFIELD 
  3788.  
  3789.  
  3790. ΓòÉΓòÉΓòÉ 7.3.4.1. SESSION ΓòÉΓòÉΓòÉ
  3791.  
  3792. Use the SESSION definition to specify which emulator sessions NSC should try to 
  3793. use to make the host connection. You can specify multiple sessions to try and 
  3794. the order in which they should be tried. An emulator session must be started 
  3795. and available for NSC to use it. 
  3796.  
  3797. Syntax 
  3798.  
  3799.              <ΓöÇ,ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ<
  3800. >>ΓöÇΓöÇSESSIONΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇ><
  3801.               ΓööΓöÇΓö¼ΓöÇ{A..Z}ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  3802.                 Γö£ΓöÇ{A..Z}ΓöÇ{A..Z}ΓöÇΓöñ
  3803.                 ΓööΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3804.  
  3805. Values 
  3806.  
  3807.               Choose one or more from the following: 
  3808.  
  3809.                   To use a particular session, specify a single character 
  3810.                    between "A" and "Z". 
  3811.  
  3812.                   To pick from a set of sessions, specify each session ID ("A" 
  3813.                    to "Z"), separated by commas. NSC will check the sessions in 
  3814.                    the order you specify them. 
  3815.  
  3816.                   To pick from a range of sessions, specify the first and last 
  3817.                    session IDs in the range separated by a dash ("-").  You can 
  3818.                    specify an ascending or descending range. 
  3819.  
  3820.                   To pick any session, specify a question mark ("?"). 
  3821.  
  3822.  Default 
  3823.  
  3824.               A 
  3825.  
  3826.  Example 
  3827.  
  3828.               The following example causes NSC to search for an available 
  3829.               session. 
  3830.  
  3831.                               SESSION  A,C-E,H-F,?
  3832.               NSC checks the emulator sessions in the following order: 
  3833.  
  3834.                 1. A 
  3835.  
  3836.                 2. C, D, and then E. 
  3837.  
  3838.                 3. H, G, and then F. 
  3839.  
  3840.                 4. B and then I through Z.  In this case, "?" is the set of IDs 
  3841.                    that have not been previously specified. 
  3842.  
  3843.    1. Session IDs are not case sensitive. 
  3844.  
  3845.    2. If the same session ID appears more than once, the second occurrence is 
  3846.       ignored. 
  3847.  
  3848.    3. If you do not know what session IDs are available to you, refer to your 
  3849.       emulator support information on how to determine the correct session ID. 
  3850.  
  3851.    4. You can specify the SESSION as a HIF Variable (e.g. %V1). In this case, 
  3852.       all of the rules that apply to session IDs still apply to the string 
  3853.       assigned to the HIF Variable. Specifying the SESSION as a HIF Variable 
  3854.       allows the same host information file to be used for HOST definitions 
  3855.       using different host emulator sessions (this is how the SESSION is 
  3856.       specified in the sample HIFs). 
  3857.  
  3858.    5. If you have more HOST definitions than available sessions, you must keep 
  3859.       in mind that if you are signed on to a host emulator session, you cannot 
  3860.       use that session to change your password on another account on the same 
  3861.       host. You must either: 
  3862.  
  3863.           reserve one session that can be used for changing passwords, or 
  3864.  
  3865.           change passwords only when you are not signed on to a shared 
  3866.            emulator session 
  3867.  
  3868.    6. If you have multiple HOST definitions that must share the same session, 
  3869.       specify a unique hostname for each HOST definition, and specify the 
  3870.       session ID as a combination of the shared session ID for signon and the 
  3871.       session ID reserved for changing passwords (e.g. "A,D"). Before you 
  3872.       selectively signon to one of these hosts, you will have to signoff of the 
  3873.       one currently signed on. 
  3874.  
  3875.    7. If you have multiple User IDs on the same host, you can configure them in 
  3876.       one of two ways: 
  3877.  
  3878.           If you want to be able to signon to more than one of the User IDs at 
  3879.            the same time, and you have enough available emulator sessions, 
  3880.            specify a unique hostname and session ID for each User ID. 
  3881.  
  3882.           If you only want to signon to one User ID at a time, specify the 
  3883.            same hostname for each HOST definition, and specify the session ID 
  3884.            as a combination of the session ID for signon and the session ID 
  3885.            reserved for changing passwords. When you selectively signon to one 
  3886.            of these User IDs, NSC will first signoff the User ID currently 
  3887.            signed on. 
  3888.  
  3889.  
  3890. ΓòÉΓòÉΓòÉ 7.3.4.2. SESSIONWAIT ΓòÉΓòÉΓòÉ
  3891.  
  3892. Use the SESSIONWAIT definition to specify the maximum number of seconds NSC 
  3893. waits to gain access to an emulator session. 
  3894.  
  3895.  Syntax        SESSIONWAIT  {1..600} 
  3896.  
  3897.  Values        Choose a number between 1 and 600. 
  3898.  
  3899.                NSC attempts to access all of the specified sessions repeatedly 
  3900.                until successful, or the specified session wait maximum is 
  3901.                reached. If the emulator session has not been started, or the 
  3902.                session is in use, NSC will not be able to access it. If the 
  3903.                session is started shortly before NSC attempts an access, it may 
  3904.                not have finished starting yet. If the session is on an NSC 
  3905.                Server, it is probably used by others for password changes and 
  3906.                at times the session will be in use when a new request arrives. 
  3907.                Specifying a higher value increases the chances of gaining 
  3908.                access to a session, but a lower value decreases the time spent 
  3909.                waiting for an invalid session. If the session is nearly 
  3910.                finished starting before NSC attempts an access, and is 
  3911.                dedicated to one user, the default value will be adequate. 
  3912.  
  3913.  Default       30 
  3914.  
  3915.  Example       The following causes NSC to try for up to 60 seconds to gain 
  3916.                access to any one of the specified session ids. 
  3917.  
  3918.                                 SESSIONWAIT 60     *try for up to 60 seconds
  3919.  
  3920.  
  3921. ΓòÉΓòÉΓòÉ 7.3.4.3. HOSTWAIT ΓòÉΓòÉΓòÉ
  3922.  
  3923. Use the HOSTWAIT definition to specify the maximum number of seconds NSC waits 
  3924. for the host to update the screen. If the host doesn't update the screen within 
  3925. this time, NSC assumes the host has finished processing all keystrokes. 
  3926.  
  3927.  Syntax        HOSTWAIT  {1..60} 
  3928.  
  3929.  Values        Specify a value equal to the longest delay between screen 
  3930.                updates you have observed while interacting with the host via an 
  3931.                emulator session. If NSC doesn't wait long enough for the host 
  3932.                to make its updates, increase this number. If the value is too 
  3933.                low, your signon request will not be processed correctly. If the 
  3934.                value is too high, your signon request may take longer than 
  3935.                necessary. The default should work in many cases. 
  3936.  
  3937.                Note: Use care in setting this value since host and network 
  3938.                responses vary. Setting the value too low can result in 
  3939.                occasional request failures. 
  3940.  
  3941.  Default       5 
  3942.  
  3943.  Example       The following causes NSC to wait up to 3 seconds for a screen 
  3944.                update. 
  3945.  
  3946.                                 HOSTWAIT    3     *Wait up to 3 seconds
  3947.  
  3948.  
  3949. ΓòÉΓòÉΓòÉ 7.3.4.4. UFIELD ΓòÉΓòÉΓòÉ
  3950.  
  3951. Use the UFIELD definition to specify the length of the emulator session 
  3952. screen's User ID field. A screen can be formatted with an entry field to hold 
  3953. the User ID. If the User ID fills the entry field, the cursor is automatically 
  3954. advanced to the next entry field on the screen. When the User ID is shorter 
  3955. than its entry field, NSC will add a Tab key following it to advance to the 
  3956. next entry field. 
  3957.  
  3958.  Syntax        UFIELD  {4..16} 
  3959.  
  3960.  Values        Specify a value between 4 and 16. 
  3961.  
  3962.  Default       8 
  3963.  
  3964.  Example       The following causes NSC to add a Tab key when the User ID is 
  3965.                shorter than 16 characters. 
  3966.  
  3967.                                 UFIELD   16     *User ID screen entry field length
  3968.  
  3969.  
  3970. ΓòÉΓòÉΓòÉ 7.3.4.5. PFIELD ΓòÉΓòÉΓòÉ
  3971.  
  3972. Use the PFIELD definition to specify the length of the emulator session 
  3973. screen's password fields. A screen can be formatted with an entry field to hold 
  3974. a password. If the password fills the entry field, the cursor is automatically 
  3975. advanced to the next entry field on the screen. When the password is shorter 
  3976. than its entry field, NSC will add a Tab key following it to advance to the 
  3977. next entry field. 
  3978.  
  3979.  Syntax        PFIELD  {4..16} 
  3980.  
  3981.  Values        Specify a value between 4 and 16. 
  3982.  
  3983.  Default       8 
  3984.  
  3985.  Example       The following causes NSC to add a Tab key when the password is 
  3986.                shorter than 7 characters. 
  3987.  
  3988.                                 PFIELD    7     *Password screen entry field length
  3989.  
  3990.  
  3991. ΓòÉΓòÉΓòÉ 7.3.5. Screen Definitions ΓòÉΓòÉΓòÉ
  3992.  
  3993. Screen definitions are used to describe a specific host screen, and how to 
  3994. change the host to the next screen. They are used in the Global, Logon, 
  3995. Password, and Logoff sections. 
  3996.  
  3997. Three types of string parameters are used with screen definitions: 
  3998.  
  3999.  Search    Used to specify the text message that appears on the emulator's 
  4000.            screen. NSC will search the emulator session screen buffer for this 
  4001.            string. 
  4002.  
  4003.            Control characters within this string parameter are not processed, 
  4004.            but HIF variables are. Refer to Control Characters and HIF Variables 
  4005.            for more information. 
  4006.  
  4007.            If an empty string is specified for this parameter, i.e.: "", the 
  4008.            search string will always be found in the screen buffer. Consider 
  4009.            this affect before specifying an empty search string. 
  4010.  
  4011.  Response  Used to specify the keys that should be sent to the host to continue 
  4012.            the requested host operation. This key sequence should result in the 
  4013.            host changing to a screen from which the host operation can be 
  4014.            continued or completed. 
  4015.  
  4016.            Control characters and HIF variables within this string parameter 
  4017.            are processed. Refer to Control Characters and HIF Variables for 
  4018.            more information. 
  4019.  
  4020.            If an empty string is specified for this parameter, i.e.: "", no 
  4021.            keys are sent to the host. 
  4022.  
  4023.  Reset     Used to specify the keys that should be sent to the host to 
  4024.            terminate the requested host operation. This key sequence should 
  4025.            result in the host changing to a screen from which the host 
  4026.            operation can be initiated again. 
  4027.  
  4028.            Control characters and HIF variables within this string parameter 
  4029.            are processed. Refer to Control Characters and HIF Variables for 
  4030.            more information. 
  4031.  
  4032.            If an empty string is specified for this parameter, i.e.: "", no 
  4033.            keys are sent to the host. 
  4034.  
  4035.  In the Logon, Password, and Logoff sections, screen definitions are specified 
  4036.  in Start-Stop groups, that tell NSC how to achieve the request if the host is 
  4037.  in that specific start screen. Each section can contain multiple Start-Stop 
  4038.  groups, but they may not be nested. NSC will check the host for all START 
  4039.  screen definitions listed in a section; if the host is not found to be in any 
  4040.  of the specified start screens, an appropriate error message will be returned. 
  4041.  If the host is found to be in one of the specified start screens, each screen 
  4042.  definition following that start definition is processed sequentially through 
  4043.  the associated stop screen definition. Screen definitions are order-dependent; 
  4044.  they must occur in the order they will be encountered while interacting with 
  4045.  the host system. 
  4046.  
  4047.  Example: 
  4048.  
  4049.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4050.   ΓöéLOGON                                                         Γöé
  4051.   Γöé* one logon sequence                                          Γöé
  4052.   ΓöéSTART "Enter Id:","@u@E"            * send userid             Γöé
  4053.   Γöé NEXT  "Enter pw:","@p@E","logoff@E"* send pw when prompted,  Γöé
  4054.   Γöé                                    *  else logoff            Γöé
  4055.   ΓöéSTOP  "Ready;"                      * finished logon          Γöé
  4056.   Γöé                                                              Γöé
  4057.   Γöé* another possible logon sequence                             Γöé
  4058.   ΓöéSTART "Node =>","MVS1@E"            * send "MVS1"             Γöé
  4059.   Γöé NEXT  "User Id:","@U@E","logoff@E" * send uid when prompted, Γöé
  4060.   Γöé                                    *  else logoff            Γöé
  4061.   Γöé NEXT  "Password:","@P@E","logoff@E"* send pw when prompted,  Γöé
  4062.   Γöé                                    *  else logoff            Γöé
  4063.   ΓöéSTOP  "RUNNING"                     * finished logon          Γöé
  4064.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4065.  
  4066.   In this example, two different logon sequences are possible. NSC will 
  4067.  determine if the host is in any of these start screens. If the string "Node 
  4068.  =>" is found on the host screen, that Start-Stop group will be processed to 
  4069.  completion. In this case, the string "RUNNING" notifies NSC that the logon has 
  4070.  completed. 
  4071.  
  4072.  The screen definitions and where to find out more about them are: 
  4073.  
  4074.  To specify                              Definition 
  4075.  -------------                           ------------- 
  4076.  Clear screens                           CLEAR 
  4077.  Start screens                           START 
  4078.  Required next screens                   NEXT 
  4079.  Optional next screens                   NEXT? 
  4080.  Host not available screens              HNAVL 
  4081.  User ID already logged on screens       ULOGD 
  4082.  Invalid User ID screens                 UINV 
  4083.  Invalid password screens                PINV 
  4084.  Invalid User ID or password screens     UPINV 
  4085.  Expired password screens                PEXP 
  4086.  Password will expire soon screens       PWRN 
  4087.  Invalid new password screens            NINV 
  4088.  Invalid old or new password screens     PNINV 
  4089.  Optional stop screens                   STOP? 
  4090.  Stop screens                            STOP 
  4091.  
  4092.  
  4093. ΓòÉΓòÉΓòÉ 7.3.5.1. CLEAR ΓòÉΓòÉΓòÉ
  4094.  
  4095. Use the CLEAR screen definition to specify a message that is displayed by the 
  4096. host to indicate it is waiting for the screen to be cleared. When a host has 
  4097. more data to display than will fit on one screen, it displays a full screen of 
  4098. data and some indicator that more data is waiting. Usually, the user presses 
  4099. the Clear key to display more data. 
  4100.  
  4101. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4102.  
  4103.      Sends the response string to the host. 
  4104.  
  4105.  If the search string is not found, NSC: 
  4106.  
  4107.      Processes the next screen definition in the GLOBAL section. 
  4108.  
  4109.  Syntax 
  4110.  
  4111.   >>ΓöÇΓöÇCLEARΓöÇΓöÇsearchΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  4112.                      ΓööΓöÇ,responseΓöÇΓöÿ
  4113.  
  4114.  Parameters 
  4115.  
  4116.               search      Specifies the string that NSC searches for in the 
  4117.                           screen buffer to determine whether a Clear key is 
  4118.                           needed to clear the screen. Refer to Screen 
  4119.                           Definitions for more information about the search 
  4120.                           string. 
  4121.  
  4122.                           Carefully consider the string specified since the 
  4123.                           host may not be expecting a clear response. 
  4124.  
  4125.               response    Specifies the optional string that NSC sends to the 
  4126.                           host when the search string is found. If not 
  4127.                           supplied, the Clear key ("@C") is used. Refer to 
  4128.                           Screen Definitions for more information about the 
  4129.                           response string. 
  4130.  
  4131.  Example 
  4132.  
  4133.               The following examples cause NSC to clear a screen when the 
  4134.               screen buffer contains "HOLDING". 
  4135.  
  4136.                               CLEAR "HOLDING"        *Screen full?, send clear key
  4137.  
  4138.                                         or
  4139.  
  4140.                               CLEAR "HOLDING","@C"   *Screen full?, send clear key
  4141.  
  4142.  
  4143. ΓòÉΓòÉΓòÉ 7.3.5.2. START ΓòÉΓòÉΓòÉ
  4144.  
  4145. Use the START screen definition to specify a message that is displayed by the 
  4146. host to indicate it is ready to accept a logon, logoff, or change password 
  4147. request. It is also used to mark the beginning of a Start-Stop group. Multiple 
  4148. START definitions can be specified, as long as they are paired with a STOP 
  4149. definition. 
  4150.  
  4151. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4152.  
  4153.      Selects this Start-Stop group to process the user request. 
  4154.      Sends the response string to the host. 
  4155.      Processes the next screen definition in this group. 
  4156.  
  4157.  If the search string is not found, and another Start-Stop group exists, NSC: 
  4158.  
  4159.      Continues processing with the START definition in the next group. 
  4160.  
  4161.  If the search string is not found, and no more Start-Stop groups exist, NSC: 
  4162.  
  4163.      Terminates request processing. 
  4164.      Displays an error message on the screen. 
  4165.  
  4166.  Syntax 
  4167.  
  4168.   >>ΓöÇΓöÇSTARTΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresponseΓöÇΓöÇ><
  4169.  
  4170.  Parameters 
  4171.  
  4172.               search      Specifies the string that NSC searches for in the 
  4173.                           emulator session screen buffer to determine whether 
  4174.                           to process this Start-Stop group of definitions. 
  4175.                           Refer to Screen Definitions for more information 
  4176.                           about the search string. 
  4177.  
  4178.               response    Specifies the string that NSC sends to the host when 
  4179.                           the search string is found. Refer to Screen 
  4180.                           Definitions for more information about the response 
  4181.                           string. 
  4182.  
  4183.  Example 
  4184.  
  4185.               The following shows a logon request causing NSC to send the User 
  4186.               ID to the host when the host prompts for it. 
  4187.  
  4188.                               LOGON                         *section definition
  4189.                                START "Enter User ID:", "@u@E"     * send User ID
  4190.                                                                   * when asked
  4191.  
  4192.  
  4193. ΓòÉΓòÉΓòÉ 7.3.5.3. NEXT ΓòÉΓòÉΓòÉ
  4194.  
  4195. Use the NEXT (Required Next) screen definition to specify a message that must 
  4196. be displayed by the host before NSC can continue processing the request. 
  4197. Multiple NEXT definitions can be specified. 
  4198.  
  4199. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4200.  
  4201.      Sends the response string to the host. 
  4202.      Processes the next screen definition in this group. 
  4203.  
  4204.  If the search string is not found, NSC: 
  4205.  
  4206.      Sends the reset string, if supplied, to the host. 
  4207.      Terminates request processing. 
  4208.      Displays an error message on the screen. 
  4209.  
  4210.  Syntax 
  4211.  
  4212.   >>ΓöÇΓöÇNEXTΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresponseΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  4213.                                  ΓööΓöÇ,resetΓöÇΓöÿ
  4214.  
  4215.  Parameters 
  4216.  
  4217.               search      Specifies the string that NSC searches for in the 
  4218.                           emulator session screen buffer to determine that 
  4219.                           request processing should continue. Refer to Screen 
  4220.                           Definitions for more information about the search 
  4221.                           string. 
  4222.  
  4223.               response    Specifies the string that NSC sends to the host when 
  4224.                           the search string is found. Refer to Screen 
  4225.                           Definitions for more information about the response 
  4226.                           string. 
  4227.  
  4228.               reset       Specifies the optional string that NSC sends to the 
  4229.                           host when the search string is not found. Refer to 
  4230.                           Screen Definitions for more information about the 
  4231.                           reset string. 
  4232.  
  4233.  Example 
  4234.  
  4235.               This shows a user's password being sent to the host during a 
  4236.               logon request using the NEXT definition. When the "enter 
  4237.               password" string is found in the screen buffer, the user's 
  4238.               password followed by the Enter key is sent to the host. 
  4239.  
  4240.               If the "enter password" string doesn't appear, the string 
  4241.               "logoff" followed by the Enter key is sent to the host. Sending 
  4242.               the "logoff" should reset the host session to a condition where 
  4243.               another logon can be attempted. 
  4244.  
  4245.                               LOGON                         *section definition
  4246.                                START "Enter User ID:", "@u@E"     * send User ID
  4247.                                                                   * when asked
  4248.                                NEXT  "enter password", "@p@E", "logoff@E"
  4249.  
  4250.  
  4251. ΓòÉΓòÉΓòÉ 7.3.5.4. NEXT? ΓòÉΓòÉΓòÉ
  4252.  
  4253. Use the NEXT? (Optional Next) screen definition to specify a message that may 
  4254. be displayed by the host to indicate it is waiting for user interaction. 
  4255. Multiple NEXT? definitions can be specified. 
  4256.  
  4257. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4258.  
  4259.      Sends the response string to the host. 
  4260.      Processes the next screen definition in this group. 
  4261.  
  4262.  If the search string is not found, NSC: 
  4263.  
  4264.      Processes the next screen definition in this group. 
  4265.  
  4266.  Syntax 
  4267.  
  4268.   >>ΓöÇΓöÇNEXT?ΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresponseΓöÇΓöÇ><
  4269.  
  4270.  Parameters 
  4271.  
  4272.               search      Specifies the string that NSC searches for in the 
  4273.                           emulator session screen buffer. Refer to Screen 
  4274.                           Definitions for more information about the search 
  4275.                           string. 
  4276.  
  4277.               response    Specifies the string that NSC sends to the host when 
  4278.                           the search string is found. Refer to Screen 
  4279.                           Definitions for more information about the response 
  4280.                           string. 
  4281.  
  4282.  Example 
  4283.  
  4284.               The following shows how you can use NEXT? to exit a system news 
  4285.               host application. When the "SYSNEWS" string is found in the 
  4286.               screen buffer, the host is sent an F3 key to cause an exit from 
  4287.               this application. 
  4288.  
  4289.                                NEXT? "SYSNEWS", "@3"       * exit if in system news application
  4290.  
  4291.  
  4292. ΓòÉΓòÉΓòÉ 7.3.5.5. HNAVL ΓòÉΓòÉΓòÉ
  4293.  
  4294. Use the HNAVL (Host Not Available) screen definition to specify a message that 
  4295. is displayed by the host to indicate it is currently not available. Multiple 
  4296. HNAVL definitions can be specified. 
  4297.  
  4298. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4299.  
  4300.      Sends the reset string to the host. 
  4301.      Terminates request processing. 
  4302.      Displays an error message on the screen. 
  4303.  
  4304.  If the search string is not found, NSC: 
  4305.  
  4306.      Processes the next screen definition in this group. 
  4307.  
  4308.  Syntax 
  4309.  
  4310.   >>ΓöÇΓöÇHNAVLΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4311.  
  4312.  Parameters 
  4313.  
  4314.               search      Specifies the string that NSC searches for in the 
  4315.                           emulator session screen buffer to determine that the 
  4316.                           host is not available. Refer to Screen Definitions 
  4317.                           for more information about the search string. 
  4318.  
  4319.               reset       Specifies the string that NSC sends to the host when 
  4320.                           the search string is found. Refer to Screen 
  4321.                           Definitions for more information about the reset 
  4322.                           string. 
  4323.  
  4324.  Example 
  4325.  
  4326.               The following shows a HNAVL definition that logs the user off 
  4327.               when the host sends a message indicating the host is not 
  4328.               available. 
  4329.  
  4330.                                HNAVL "host application is down", "logoff@E"
  4331.  
  4332.  
  4333. ΓòÉΓòÉΓòÉ 7.3.5.6. ULOGD ΓòÉΓòÉΓòÉ
  4334.  
  4335. Use the ULOGD (User Logged on From Another Session) screen definition to 
  4336. specify a message that is displayed by the host to indicate the User ID is 
  4337. already logged on from another session. Multiple ULOGD definitions can be 
  4338. specified. 
  4339.  
  4340. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4341.  
  4342.      Sends the reset string to the host. 
  4343.      Terminates request processing. 
  4344.      Displays an error message on the screen. 
  4345.  
  4346.  If the search string is not found, NSC: 
  4347.  
  4348.      Processes the next screen definition in this group. 
  4349.  
  4350.  Syntax 
  4351.  
  4352.   >>ΓöÇΓöÇULOGDΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4353.  
  4354.  Parameters 
  4355.  
  4356.               search      Specifies the string that NSC searches for in the 
  4357.                           emulator session screen buffer to determine that the 
  4358.                           User ID is already logged on from another session. 
  4359.                           Refer to Screen Definitions for more information 
  4360.                           about the search string. 
  4361.  
  4362.               reset       Specifies the string that NSC sends to the host when 
  4363.                           the search string is found. Refer to Screen 
  4364.                           Definitions for more information about the reset 
  4365.                           string. 
  4366.  
  4367.  Example 
  4368.  
  4369.               The following shows a ULOGD definition that logs the user off 
  4370.               when the host sends a message indicating the User ID is already 
  4371.               logged on from another session. 
  4372.  
  4373.                                ULOGD "User is already logged on", "logoff@E"
  4374.  
  4375.  
  4376. ΓòÉΓòÉΓòÉ 7.3.5.7. UINV ΓòÉΓòÉΓòÉ
  4377.  
  4378. Use the UINV (User ID Invalid) screen definition to specify a message that is 
  4379. displayed by the host to indicate that an invalid User ID was entered. Multiple 
  4380. UINV definitions can be specified. 
  4381.  
  4382. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4383.  
  4384.      Sends the reset string to the host. 
  4385.      Terminates request processing. 
  4386.      Displays an error message on the screen. 
  4387.  
  4388.  If the search string is not found, NSC: 
  4389.  
  4390.      Processes the next screen definition in this group. 
  4391.  
  4392.  Syntax 
  4393.  
  4394.   >>ΓöÇΓöÇUINVΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4395.  
  4396.  Parameters 
  4397.  
  4398.               search      Specifies the string that NSC searches for in the 
  4399.                           emulator session screen buffer to determine that the 
  4400.                           User ID is invalid. Refer to Screen Definitions for 
  4401.                           more information about the search string. 
  4402.  
  4403.               reset       Specifies the string that NSC sends to the host when 
  4404.                           the search string is found. Refer to Screen 
  4405.                           Definitions for more information about the reset 
  4406.                           string. 
  4407.  
  4408.  Example 
  4409.  
  4410.               The following shows a UINV definition that logs the user off when 
  4411.               the host sends a message indicating the User ID is invalid. 
  4412.  
  4413.                                UINV "User ID not valid", "logoff@E"
  4414.  
  4415.  
  4416. ΓòÉΓòÉΓòÉ 7.3.5.8. PINV ΓòÉΓòÉΓòÉ
  4417.  
  4418. Use the PINV (Password Invalid) screen definition to specify a message that is 
  4419. displayed by the host to indicate an invalid password was entered. Multiple 
  4420. PINV definitions can be specified. 
  4421.  
  4422. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4423.  
  4424.      Sends the reset string to the host. 
  4425.      Terminates request processing. 
  4426.      Displays an error message on the screen. 
  4427.  
  4428.  If the search string is not found, NSC: 
  4429.  
  4430.      Processes the next screen definition in this group. 
  4431.  
  4432.  Syntax 
  4433.  
  4434.   >>ΓöÇΓöÇPINVΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4435.  
  4436.  Parameters 
  4437.  
  4438.               search      Specifies the string that NSC searches for in the 
  4439.                           emulator session screen buffer to determine that the 
  4440.                           password is invalid. Refer to Screen Definitions for 
  4441.                           more information about the search string. 
  4442.  
  4443.               reset       Specifies the string that NSC sends to the host when 
  4444.                           the search string is found. Refer to Screen 
  4445.                           Definitions for more information about the reset 
  4446.                           string. 
  4447.  
  4448.  Example 
  4449.  
  4450.               The following shows a PINV definition that logs the user off when 
  4451.               the host sends a message indicating the password is invalid. 
  4452.  
  4453.                                PINV "invalid password", "logoff@E"
  4454.  
  4455.  
  4456. ΓòÉΓòÉΓòÉ 7.3.5.9. UPINV ΓòÉΓòÉΓòÉ
  4457.  
  4458. Use the UPINV (User ID or Password Invalid) screen definition to specify a 
  4459. message that is displayed by the host to indicate an invalid password or User 
  4460. ID was entered. Multiple UPINV definitions can be specified. 
  4461.  
  4462. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4463.  
  4464.      Sends the reset string to the host. 
  4465.      Terminates request processing. 
  4466.      Displays an error message on the screen. 
  4467.  
  4468.  If the search string is not found, NSC: 
  4469.  
  4470.      Processes the next screen definition in this group. 
  4471.  
  4472.  Syntax 
  4473.  
  4474.   >>ΓöÇΓöÇUPINVΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4475.  
  4476.  Parameters 
  4477.  
  4478.               search      Specifies the string that NSC searches for in the 
  4479.                           emulator session screen buffer to determine that the 
  4480.                           User ID or password is invalid. Refer to Screen 
  4481.                           Definitions for more information about the search 
  4482.                           string. 
  4483.  
  4484.               reset       Specifies the string that NSC sends to the host when 
  4485.                           the search string is found. Refer to Screen 
  4486.                           Definitions for more information about the reset 
  4487.                           string. 
  4488.  
  4489.  Example 
  4490.  
  4491.               The following shows a UPINV definition that logs the user off 
  4492.               when the host sends a message indicating the password is invalid. 
  4493.  
  4494.                                UPINV "invalid id or password", "logoff@E"
  4495.  
  4496.  
  4497. ΓòÉΓòÉΓòÉ 7.3.5.10. PEXP ΓòÉΓòÉΓòÉ
  4498.  
  4499. Use the PEXP (Password Expired) screen definition to specify a message that is 
  4500. displayed by the host to indicate the password has expired. Multiple PEXP 
  4501. definitions can be specified. 
  4502.  
  4503. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4504.  
  4505.      Sends the reset string to the host. 
  4506.      Terminates request processing. 
  4507.      Displays an error message on the screen. 
  4508.  
  4509.  If the search string is not found, NSC: 
  4510.  
  4511.      Processes the next screen definition in this group. 
  4512.  
  4513.  Syntax 
  4514.  
  4515.   >>ΓöÇΓöÇPEXPΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4516.  
  4517.  Parameters 
  4518.  
  4519.               search      Specifies the string that NSC searches for in the 
  4520.                           emulator session screen buffer to determine that the 
  4521.                           password has expired. Refer to Screen Definitions for 
  4522.                           more information about the search string. 
  4523.  
  4524.               reset       Specifies the string that NSC sends to the host when 
  4525.                           the search string is found. Refer to Screen 
  4526.                           Definitions for more information about the reset 
  4527.                           string. 
  4528.  
  4529.  Example 
  4530.  
  4531.               The following shows a PEXP definition that logs the user off when 
  4532.               the host sends a message indicating the password has expired. 
  4533.  
  4534.                                PEXP "password has expired", "logoff@E"
  4535.  
  4536.  
  4537. ΓòÉΓòÉΓòÉ 7.3.5.11. PWRN ΓòÉΓòÉΓòÉ
  4538.  
  4539. Use the PWRN (Password Will Expired) screen definition to specify a message 
  4540. that is displayed by the host to indicate the password will soon expire. 
  4541. Multiple PWRN definitions can be specified. 
  4542.  
  4543. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4544.  
  4545.      Sends the response string, if supplied, to the host. 
  4546.      Processes the next screen definition in this group. 
  4547.      Displays a warning message on the screen. 
  4548.  
  4549.  If the search string is not found, NSC: 
  4550.  
  4551.      Processes the next screen definition in this group. 
  4552.  
  4553.  Syntax 
  4554.  
  4555.   >>ΓöÇΓöÇPWRNΓöÇΓöÇsearchΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇ><
  4556.                     ΓööΓöÇ,responseΓöÇΓöÿ
  4557.  
  4558.  Parameters 
  4559.  
  4560.               search      Specifies the string that NSC searches for in the 
  4561.                           emulator session screen buffer to determine that the 
  4562.                           password will expire soon. Refer to Screen 
  4563.                           Definitions for more information about the search 
  4564.                           string. 
  4565.  
  4566.               response    Specifies the optional string that NSC sends to the 
  4567.                           host when the search string is found. Refer to Screen 
  4568.                           Definitions for more information about the response 
  4569.                           string. 
  4570.  
  4571.  Example 
  4572.  
  4573.               The following shows a PWRN definition. 
  4574.  
  4575.                                PWRN "password will expire"
  4576.  
  4577.  
  4578. ΓòÉΓòÉΓòÉ 7.3.5.12. NINV ΓòÉΓòÉΓòÉ
  4579.  
  4580. Use the NINV (New Password Invalid) screen definition to specify a message that 
  4581. is displayed by the host to indicate the new password is invalid. Multiple NINV 
  4582. definitions can be specified. 
  4583.  
  4584. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4585.  
  4586.      Sends the reset string to the host. 
  4587.      Terminates request processing. 
  4588.      Displays an error message on the screen. 
  4589.  
  4590.  If the search string is not found, NSC: 
  4591.  
  4592.      Processes the next screen definition in this group. 
  4593.  
  4594.  Syntax 
  4595.  
  4596.   >>ΓöÇΓöÇNINVΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4597.  
  4598.  Parameters 
  4599.  
  4600.               search      Specifies the string that NSC searches for in the 
  4601.                           emulator session screen buffer to determine that the 
  4602.                           new password is invalid. Refer to Screen Definitions 
  4603.                           for more information about the search string. 
  4604.  
  4605.               reset       Specifies the string that NSC sends to the host when 
  4606.                           the search string is found. Refer to Screen 
  4607.                           Definitions for more information about the reset 
  4608.                           string. 
  4609.  
  4610.  Example 
  4611.  
  4612.               The following shows a NINV definition that logs the user off when 
  4613.               the host sends a message indicating the new password is invalid. 
  4614.  
  4615.                                NINV "invalid new password", "logoff@E"
  4616.  
  4617.  
  4618. ΓòÉΓòÉΓòÉ 7.3.5.13. PNINV ΓòÉΓòÉΓòÉ
  4619.  
  4620. Use the PNINV (Password or New Password Invalid) screen definition to specify a 
  4621. message that is displayed by the host to indicate the password or new password 
  4622. is invalid. Multiple PNINV definitions can be specified. 
  4623.  
  4624. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4625.  
  4626.      Sends the reset string to the host. 
  4627.      Terminates request processing. 
  4628.      Displays an error message on the screen. 
  4629.  
  4630.  If the search string is not found, NSC: 
  4631.  
  4632.      Processes the next screen definition in this group. 
  4633.  
  4634.  Syntax 
  4635.  
  4636.   >>ΓöÇΓöÇPNINVΓöÇΓöÇsearchΓöÇΓöÇ,ΓöÇΓöÇresetΓöÇΓöÇ><
  4637.  
  4638.  Parameters 
  4639.  
  4640.               search      Specifies the string that NSC searches for in the 
  4641.                           emulator session screen buffer to determine that the 
  4642.                           password or new password is invalid. Refer to Screen 
  4643.                           Definitions for more information about the search 
  4644.                           string. 
  4645.  
  4646.               reset       Specifies the string that NSC sends to the host when 
  4647.                           the search string is found. Refer to Screen 
  4648.                           Definitions for more information about the reset 
  4649.                           string. 
  4650.  
  4651.  Example 
  4652.  
  4653.               The following shows a PNINV definition that logs the user off 
  4654.               when the host sends a message indicating some password is 
  4655.               invalid. 
  4656.  
  4657.                                PNINV "a password was invalid", "logoff@E"
  4658.  
  4659.  
  4660. ΓòÉΓòÉΓòÉ 7.3.5.14. STOP? ΓòÉΓòÉΓòÉ
  4661.  
  4662. Use the STOP? (Optional Stop) screen definition to specify a message that is 
  4663. displayed by the host to indicate a logon, logoff, or change password has 
  4664. completed. Multiple STOP? definitions can be specified. Use STOP? definitions 
  4665. in conjunction with a STOP definition in situations where more than one host 
  4666. message indicates a request has completed successfully. 
  4667.  
  4668. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4669.  
  4670.      Terminates request processing. 
  4671.      Displays a completion message on the screen. 
  4672.  
  4673.  If the search string is not found, NSC: 
  4674.  
  4675.      Processes the next screen definition in this group. 
  4676.  
  4677.  Syntax 
  4678.  
  4679.   >>ΓöÇΓöÇSTOP?ΓöÇΓöÇsearchΓöÇΓöÇ><
  4680.  
  4681.  Parameters 
  4682.  
  4683.               search      Specifies the string that NSC searches for in the 
  4684.                           emulator session screen buffer to determine that the 
  4685.                           request has completed. Refer to Screen Definitions 
  4686.                           for more information about the search string. 
  4687.  
  4688.  Example 
  4689.  
  4690.               The following shows a STOP? definition that checks for "MENU I" 
  4691.               along with a STOP definition that terminates the definition 
  4692.               group. 
  4693.  
  4694.                                STOP? "MENU I"
  4695.                                STOP  "Ready;"
  4696.  
  4697.  
  4698. ΓòÉΓòÉΓòÉ 7.3.5.15. STOP ΓòÉΓòÉΓòÉ
  4699.  
  4700. Use the STOP screen definition to specify a message displayed by the host to 
  4701. indicate a logon, logoff, or change password has completed. It is also used to 
  4702. mark the end of a Start-Stop group. Multiple STOP definitions can be specified, 
  4703. as long as they are paired with a START definition. 
  4704.  
  4705. NSC scans the screen buffer looking for the search string.  If found, NSC: 
  4706.  
  4707.      Terminates request processing. 
  4708.      Displays a completion message on the screen. 
  4709.  
  4710.  If the search string is not found, NSC: 
  4711.  
  4712.      Terminates request processing. 
  4713.      Displays an error message on the screen. 
  4714.  
  4715.  Syntax 
  4716.  
  4717.   >>ΓöÇΓöÇSTOPΓöÇΓöÇsearchΓöÇΓöÇ><
  4718.  
  4719.  Parameters 
  4720.  
  4721.               search      Specifies the string that NSC searches for in the 
  4722.                           emulator session screen buffer to determine that the 
  4723.                           request has completed. Refer to Screen Definitions 
  4724.                           for more information about the search string. 
  4725.  
  4726.  Example 
  4727.  
  4728.               The following shows a STOP definition that checks for "RUNNING". 
  4729.  
  4730.                                STOP "RUNNING"
  4731.  
  4732.  
  4733. ΓòÉΓòÉΓòÉ 7.3.6. Sample Host Information Files ΓòÉΓòÉΓòÉ
  4734.  
  4735. This section contains sample host information files included on the NSC 
  4736. installation diskette. 
  4737.  
  4738.       NSCMVS.HIF shows a sample for a MVS Host System. 
  4739.  
  4740.       NSCVM.HIF shows a sample for a VM Host System. 
  4741.  
  4742.       NSCVMOV.HIF shows a sample for a VM Host System with OfficeVision. 
  4743.  
  4744.       NSCOS400.HIF shows a sample for an OS/400 Host System. 
  4745.  
  4746.       NSCIIN.HIF shows a sample for the IBM Information Network. 
  4747.  
  4748.  
  4749. ΓòÉΓòÉΓòÉ 7.3.6.1. NSCMVS.HIF ΓòÉΓòÉΓòÉ
  4750.  
  4751. NSCVMS.HIF is a host information file for a MVS Host System. It defines start 
  4752. and stop screens for the standard TSO prompts. It uses a RACF command to change 
  4753. the host password. If your host system does not use RACF, you will need to 
  4754. modify the host information file based on the host security software program 
  4755. used. To signon to the host, it sends the node id of the host (you specify this 
  4756. as a HIF Variable in the HOST definition) followed by your User ID. NSCMVS.HIF 
  4757. has two HIF Variables: 
  4758.  
  4759.      V1 defines the host session id (e.g. V1=A) 
  4760.  
  4761.      V2 defines the node id sent for a signon with the userid (e.g. V2=TSO1) 
  4762.  
  4763.  The following is an example of a HOST definition using this host information 
  4764.  file. 
  4765.  
  4766.     USERID=PDQUEUE
  4767.     Host,EMULATOR,Name=TSO1,ON,HIF=d:\nsc\nscmvs.hif,V1=A,V2=TSO1
  4768.  
  4769.  In this example, "V1=A" specifies host emulator session A will be used for the 
  4770.  host "TSO1", and "V2=TSO1" specifies that the initial connection to the host 
  4771.  will be made by sending the string "TSO1 PDQUEUE" to the emulator. 
  4772.  
  4773.    NSCMVS.HIF 
  4774.  
  4775.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  4776.   * This is a sample host information file for an MVS host system
  4777.   * It requires the following HIF Variables in the NSC configuration file:
  4778.   *   V1=host session id  (e.g. V1=A or V1=A-E)
  4779.   *   V2=the first command sent for a signon with the userid (e.g. V2=TSO1)
  4780.  
  4781.   CONFIGURATION                 * Section for configuration options
  4782.     SESSION     @V1                       * Host session id from HIF Variable V1
  4783.     HOSTWAIT    5                         * Wait for Host up to 5 seconds
  4784.     SESSIONWAIT 60                        * Wait for Session up to 60 seconds
  4785.     UFIELD      8                         * UserID entry field length
  4786.     PFIELD      8                         * Password entry field length
  4787.  
  4788.   GLOBAL                        * Section for global screen definitions
  4789.     * The following definitions are for when the screen needs to be cleared
  4790.     CLEAR   " *** ",               "@C@E"       * if " *** ", send Clear,Enter
  4791.  
  4792.   LOGON                         * Section for logon screen definitions
  4793.     START  "Enter access code:",   "@V2 @u@E"   * Start screen
  4794.                                                 * if found, send V2," ",UID,Enter
  4795.      UINV  "not authorized to",    "@3"         * UserID Invalid error screen
  4796.                                                 * if found, send PF3
  4797.      NEXT  "Password  ===>",       "@P@E",    "@3"       * Required next screen
  4798.                                                 * if found, send PW,Enter
  4799.                                                 * if not found, send PF3
  4800.      STOP? "READY"                              * Conditional stop screen
  4801.      ULOGD "IN USE",               "logoff@E"   * UserID is already logged on
  4802.                                                 * if found, send "logoff",Enter
  4803.      PINV  "PASSWORD NOT AUTH",    "@3"         * Password invalid error screen
  4804.                                                 * if found, send PF3
  4805.      PEXP  "PASSWORD HAS EXPIRED", "@3"         * Password expired error screen
  4806.                                                 * if found, send PF3
  4807.      PWRN  "PASSWORD WILL EXPIRE"               * Password expiring warning screen
  4808.     STOP   "READY"                              * Required stop screen
  4809.  
  4810.   PASSWORD                      * Section for password change screen definitions
  4811.     * Password change screen definitions if logged off
  4812.     START  "Enter access code:",   "@V2 @u@E"   * Start screen
  4813.                                                 * if found, send V2," ",UID,Enter
  4814.      UINV  "not authorized to",    "@3"         * UserID Invalid error screen
  4815.                                                 * if found, send PF3
  4816.      NEXT  "Password  ===>",       "@P@N@E",  "@3"       * Required next screen
  4817.                                                 * if found, send PW,NPW,Enter
  4818.                                                 * if not found, send PF3
  4819.      ULOGD "IN USE",               "logoff@E"   * UserID is already logged on
  4820.                                                 * if found, send "logoff",Enter
  4821.      NEXT  "Reenter the new",      "@N@E",    "@3"       * Required next screen
  4822.                                                 * if found, send NPW,Enter
  4823.                                                 * if not found, send PF3
  4824.      PINV  "PASSWORD NOT AUTH",    "@3"         * Password invalid error screen
  4825.                                                 * if found, send PF3
  4826.      NINV  "NEW-PASSWORD IS INVAL","@3"         * NewPassword invalid error screen
  4827.                                                 * if found, send PF3
  4828.      NEXT  "READY",                "logoff@E","logoff@E" * Required next screen
  4829.                                                 * if found, send "logoff",Enter
  4830.                                                 * if not found, send "logoff",Ent
  4831.     STOP   "Enter access code:"                 * Required stop screen
  4832.  
  4833.     * Password change screen definitions if logged on
  4834.     START  "READY",                "password password(@p @n)@E"   * Start screen
  4835.                                                 * if found, send
  4836.                                                 * "password password(",PW," ",
  4837.                                                 *  NPW,")",Enter
  4838.      PINV  "NOT CURRENT PASSWORD", "@C@E"       * Password invalid error screen
  4839.                                                 * if found, send Clear,Enter
  4840.      NINV  "MATCHES A PREVIOUS",   "@C@E"       * NewPassword invalid error screen
  4841.                                                 * if found, send Clear,Enter
  4842.      NINV  "CANNOT EQUAL CURRENT", "@C@E"       * NewPassword invalid error screen
  4843.                                                 * if found, send Clear,Enter
  4844.      NINV  "CHANGE REJECTED",      "@C@E"       * NewPassword invalid error screen
  4845.                                                 * if found, send Clear,Enter
  4846.      NINV  "INVALID NEW PASSWORD", "@A@C@E"     * NewPassword invalid error screen
  4847.                                                 * if found, send Attn,Clear,Enter
  4848.     STOP   "READY"                              * Required stop screen
  4849.  
  4850.   LOGOFF                        * Section for logoff screen definitions
  4851.     START  "READY",                "logoff@E"   * Start screen
  4852.                                                 * if found, send "logoff",Enter
  4853.     STOP   "Enter access code:"                 * Required stop screen
  4854.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  4855.  
  4856.  
  4857. ΓòÉΓòÉΓòÉ 7.3.6.2. NSCVM.HIF ΓòÉΓòÉΓòÉ
  4858.  
  4859. NSCVM.HIF is a host information file for a VM Host System (see NSCVMOV.HIF for 
  4860. a host information file for a VM Host System with OfficeVision). It defines 
  4861. start and stop screens for the standard CMS prompts. It uses a RACF command to 
  4862. change the host password. If your host system does not use RACF, you will need 
  4863. to modify the host information file based on the host security software program 
  4864. used. To signon to the host, it sends the node id of the host (you specify this 
  4865. as a HIF Variable in the HOST definition) followed by your User ID. NSCVM.HIF 
  4866. has two HIF Variables: 
  4867.  
  4868.      V1 defines the host session id (e.g. V1=A) 
  4869.  
  4870.      V2 defines the node id sent for a signon with the userid (e.g. V2=AUSVM2) 
  4871.  
  4872.  The following is an example of two HOST definitions using this host 
  4873.  information file. 
  4874.  
  4875.     USERID=PDQUEUE
  4876.     Host,EMULATOR,Name=VM2,ON,HIF=d:\nsc\nscvm.hif,V1=B,V2=AUSVM2
  4877.     Host,EMULATOR,Name=VM6,ON,HIF=d:\nsc\nscvm.hif,V1=C,V2=AUSVM6
  4878.  
  4879.  In this example, "V1=B" specifies host emulator session B will be used for the 
  4880.  host "VM2", and "V2=AUSVM2" specifies that the initial connection to the host 
  4881.  will be made by sending the string "AUSVM2 PDQUEUE" to the emulator. 
  4882.  
  4883.  The host "VM6" is defined in a similar way using the same host information 
  4884.  file. 
  4885.  
  4886.    NSCVM.HIF 
  4887.  
  4888.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  4889.   * This is a sample host information file for a VM host system
  4890.   * It requires the following HIF Variables in the NSC configuration file:
  4891.   *   V1=host session id  (e.g. V1=A or V1=A-E)
  4892.   *   V2=the first command sent for a signon with the userid (e.g. V2=AUSVM2)
  4893.  
  4894.   CONFIGURATION           * Section for configuration options
  4895.     SESSION     @V1                       * Host session id from HIF Variable V1
  4896.     HOSTWAIT    5                         * Wait for Host up to 5 seconds
  4897.     SESSIONWAIT 60                        * Wait for Session up to 60 seconds
  4898.     UFIELD      8                         * UserID entry field length
  4899.     PFIELD      8                         * Password entry field length
  4900.  
  4901.   GLOBAL                  * Section for global screen definitions
  4902.     * The following definitions are for when the screen needs to be cleared
  4903.     CLEAR  "HOLDING"                      * if "HOLDING", send Clear
  4904.     CLEAR  "MORE..."                      * if "MORE...", send Clear
  4905.     * The following definitions are for exiting intermediate functions
  4906.     NEXT?  "SYSNEWS:",             "@s@3" * if "SYSNEWS:", send PF3
  4907.     NEXT?  "F3=Exit",              "@3"   * if "F3=Exit", send PF3
  4908.     NEXT?  "3=EXIT",               "@3"   * if "3=EXIT", send PF3
  4909.     NEXT?  "3= Quit",              "@3"   * if "3= Quit", send PF3
  4910.     NEXT?  "PF12  Return",         "@c"   * if "PF12  Return", send PF12
  4911.  
  4912.   LOGON                   * Section for logon screen definitions
  4913.     START  "MSG10",                "@V2 @u@E"   * Start screen
  4914.                                                 * if found, send V2," ",UID,Enter
  4915.      HNAVL "may be down.",         "help@E@S@4" * Host not available error screen
  4916.                                                 * if found, send "help", Enter,
  4917.                                                 *   Wait 2 seconds, send F4
  4918.      UINV  "not in CP directory",  "logoff@E"   * UserID Invalid error screen
  4919.                                                 * if found, send "logoff",Enter
  4920.      NEXT  "Enter your password",  "@p@E"       * Required next screen
  4921.                                                 * if found, send PW,Enter
  4922.      STOP? "Ready;"                             * Conditional stop screen
  4923.      ULOGD "Already logged on",    "logoff@E"   * UserID is already logged on
  4924.                                                 * if found, send "logoff",Enter
  4925.      PINV  "incorrect password",   "logoff@E"   * Password invalid error screen
  4926.                                                 * if found, send "logoff",Enter
  4927.      PEXP  "PASSWORD EXPIRED",     "logoff@E"   * Password expired error screen
  4928.                                                 * if found, send "logoff",Enter
  4929.      PWRN  "PASSWORD WILL EXPIRE"               * Password expiring warning screen
  4930.      NEXT? "CP READ",              "b@E"        * Optional next screen
  4931.                                                 * if found, send "b",Enter
  4932.      STOP? "Ready;"                             * Conditional stop screen
  4933.     STOP   "RUNNING"                            * Required stop screen
  4934.  
  4935.   PASSWORD                * Section for password change screen definitions
  4936.     * Password change screen definitions if logged off
  4937.     START  "MSG10",                "@V2 @u@E"   * Start screen
  4938.                                                 * if found, send V2," ",UID,Enter
  4939.      HNAVL "may be down.",         "help@E@S@4" * Host not available error screen
  4940.                                                 * if found, send "help", Enter,
  4941.                                                 *   Wait 2 seconds, send F4
  4942.      UINV  "not in CP directory",  "logoff@E"   * UserID Invalid error
  4943.                                                 * if found, send "logoff",Enter
  4944.      NEXT  "Enter your password",  "@p/@n/@n@E" * Required next screen
  4945.                                                 * if found, send
  4946.                                                 *   PW,"/",NPW,"/",NPW,Enter
  4947.      ULOGD "Already logged on",    "logoff@E"   * UserID is already logged on
  4948.                                                 * if found, send "logoff",Enter
  4949.      PINV  "incorrect password",   "logoff@E"   * Password invalid error screen
  4950.                                                 * if found, send "logoff",Enter
  4951.      NINV  "NEW PASSWORD INVALID", "logoff@E"   * NewPassword invalid error screen
  4952.                                                 * if found, send "logoff",Enter
  4953.      NEXT? "CP READ",              "b@E@E"      * Optional next screen
  4954.                                                 * if found, send "b",Enter,Enter
  4955.      NEXT  "Ready;",               "logoff@E"   * Required next screen
  4956.                                                 * if found, send "logoff",Enter
  4957.     STOP   "MSG10"                              * Required stop screen
  4958.  
  4959.     * Password change screen definitions if logged on and in native CMS
  4960.     START  "RUNNING",              "password@E" * Start screen
  4961.                                                 * if found, send "password",Enter
  4962.      NEXT  "U P D A T E",          "@P@N@N@E"   * Required next screen
  4963.                                                 * if found, send PW,NPW,NWP,Enter
  4964.      PNINV "RACF did not like",    "@C"         * PW or NewPW invalid error screen
  4965.                                                 * if found, send Clear
  4966.     STOP   "Ready;"                             * Required stop screen
  4967.  
  4968.   LOGOFF                  * Section for logoff screen definitions
  4969.     START  "RUNNING",              "logoff@E"   * Start screen
  4970.                                                 * if found, send "logoff",Enter
  4971.     STOP   "MSG10"                              * Required stop screen
  4972.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  4973.  
  4974.  
  4975. ΓòÉΓòÉΓòÉ 7.3.6.3. NSCVMOV.HIF ΓòÉΓòÉΓòÉ
  4976.  
  4977. NSCVMOV.HIF is a host information file for a VM Host System with OfficeVision. 
  4978. It is designed for the user who starts OfficeVision from PROFILE EXEC. Thus it 
  4979. defines start and stop screens for the OfficeVision menus. It uses the 
  4980. OfficeVision menus (PF11 and PF5) to change the host password. To signon to the 
  4981. host, it sends the node id of the host (you specify this as a HIF Variable in 
  4982. the HOST definition) followed by your User ID. NSCVMOV.HIF has two HIF 
  4983. Variables: 
  4984.  
  4985.      V1 defines the host session id (e.g. V1=A) 
  4986.  
  4987.      V2 defines the node id sent for a signon with the userid (e.g. V2=AUSVM1) 
  4988.  
  4989.  The following is an example of a HOST definition using this host information 
  4990.  file. 
  4991.  
  4992.     USERID=PDQUEUE
  4993.     Host,EMULATOR,Name=VM1,ON,HIF=d:\nsc\nscvmov.hif,V1=A,V2=AUSVM1
  4994.  
  4995.  In this example, "V1=A" specifies host emulator session A will be used, and 
  4996.  "V2=AUSVM1" specifies that the initial connection to the host will be made by 
  4997.  sending the string "AUSVM1 PDQUEUE" to the emulator. 
  4998.  
  4999.    NSCVMOV.HIF 
  5000.  
  5001.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5002.   * This is a sample host information file for a VM host system with OfficeVision
  5003.   * It requires the following HIF Variables in the NSC configuration file:
  5004.   *   V1=host session id  (e.g. V1=A or V1=A-E)
  5005.   *   V2=the first command sent for a signon with the userid (e.g. V2=AUSVM1)
  5006.  
  5007.   CONFIGURATION           * Section for configuration options
  5008.     SESSION     @V1                       * Host session id from HIF Variable V1
  5009.     HOSTWAIT    5                         * Wait for Host up to 5 seconds
  5010.     SESSIONWAIT 60                        * Wait for Session up to 60 seconds
  5011.     UFIELD      8                         * UserID entry field length
  5012.     PFIELD      8                         * Password entry field length
  5013.  
  5014.   GLOBAL                  * Section for global screen definitions
  5015.     * The following definitions are for when the screen needs to be cleared
  5016.     CLEAR  "HOLDING"                      * if "HOLDING", send Clear
  5017.     CLEAR  "MORE..."                      * if "MORE...", send Clear
  5018.     CLEAR  "Messages Waiting"             * if "Messages Waiting", send Clear
  5019.     * The following definitions are for exiting intermediate functions
  5020.     NEXT?  "SYSNEWS:",             "@s@3" * if "SYSNEWS:", send PF3
  5021.     NEXT?  "FEEDBACK",             "@3"   * if "SYSNEWS:", send PF3
  5022.     NEXT?  "In-Basket:",           "@3"   * if "In-Basket", send PF3
  5023.     NEXT?  "F3=Exit",              "@3"   * if "F3=Exit", send PF3
  5024.     NEXT?  "3=EXIT",               "@3"   * if "3=EXIT", send PF3
  5025.     NEXT?  "3= Quit",              "@3"   * if "3= Quit", send PF3
  5026.     NEXT?  "PF12  Return",         "@c"   * if "PF12  Return", send PF12
  5027.     NEXT?  "PF12= Return",         "@c"   * if "PF12= Return", send PF12
  5028.     NEXT?  "PF12 Return",          "@c"   * if "PF12 Return", send PF12
  5029.     NEXT?  "MENU 2",               "@b"   * if "MENU 2", send PF11
  5030.  
  5031.   LOGON                   * Section for logon screen definitions
  5032.     START  "MSG10",                "@V2 @u@E"   * Start screen
  5033.                                                 * if found, send V2," ",UID,Enter
  5034.      HNAVL "may be down.",         "help@E@S@4" * Host not available error screen
  5035.                                                 * if found, send "help", Enter,
  5036.                                                 *   Wait 2 seconds, send F4
  5037.      UINV  "not in CP directory",  "logoff@E"   * UserID Invalid error screen
  5038.                                                 * if found, send "logoff",Enter
  5039.      NEXT  "Enter your password",  "@p@E"       * Required next screen
  5040.                                                 * if found, send PW,Enter
  5041.      STOP? "MENU 1"                             * Conditional stop screen
  5042.      ULOGD "Already logged on",    "logoff@E"   * UserID is already logged on
  5043.                                                 * if found, send "logoff",Enter
  5044.      PINV  "incorrect password",   "logoff@E"   * Password invalid error screen
  5045.                                                 * if found, send "logoff",Enter
  5046.      PEXP  "PASSWORD EXPIRED",     "logoff@E"   * Password expired error screen
  5047.                                                 * if found, send "logoff",Enter
  5048.      PWRN  "PASSWORD WILL EXPIRE"               * Password expiring warning screen
  5049.      NEXT? "CP READ",              "b@E"        * Optional next screen
  5050.                                                 * if found, send "b",Enter
  5051.     STOP   "MENU 1"                             * Required stop screen
  5052.  
  5053.   PASSWORD                * Section for password change screen definitions
  5054.     * Password change screen definitions if logged off
  5055.     START  "MSG10",                "@V2 @u@E"   * Start screen
  5056.                                                 * if found, send V2," ",UID,Enter
  5057.      HNAVL "may be down.",         "help@E@S@4" * Host not available error screen
  5058.                                                 * if found, send "help", Enter,
  5059.                                                 *   Wait 2 seconds, send F4
  5060.      UINV  "not in CP directory",  "logoff@E"   * UserID Invalid error
  5061.                                                 * if found, send "logoff",Enter
  5062.      NEXT  "Enter your password",  "@p/@n/@n@E" * Required next screen
  5063.                                                 * if found, send
  5064.                                                 *   PW,"/",NPW,"/",NPW,Enter
  5065.      ULOGD "Already logged on",    "logoff@E"   * UserID is already logged on
  5066.                                                 * if found, send "logoff",Enter
  5067.      PINV  "incorrect password",   "logoff@E"   * Password invalid error screen
  5068.                                                 * if found, send "logoff",Enter
  5069.      NINV  "NEW PASSWORD INVALID", "logoff@E"   * NewPassword invalid error screen
  5070.                                                 * if found, send "logoff",Enter
  5071.      NEXT? "CP READ",              "b@E@E"      * Optional next screen
  5072.                                                 * if found, send "b",Enter,Enter
  5073.      NEXT  "MENU 1",               "logoff@E"   * Required next screen
  5074.                                                 * if found, send "logoff",Enter
  5075.     STOP   "MSG10"                              * Required stop screen
  5076.  
  5077.     * Password change screen definitions if logged on and in OfficeVision
  5078.     START  "MENU 1",               "@b"         * Start screen
  5079.                                                 * if found, send PF11
  5080.      NEXT  "MENU 2",               "@5"         * Required next screen
  5081.                                                 * if found, send PF5
  5082.      NEXT  "CHANGE PASSWORD",      "@N@N@P@E"   * Required next screen
  5083.                                                 * if found, send NPW,NPW,PW,Enter
  5084.      PNINV "Password not changed", "@c@b"       * PW or NewPW invalid error screen
  5085.                                                 * if found, send PF12,PF11
  5086.      NINV  "must be different",    "@c@b"       * NewPassword invalid error screen
  5087.                                                 * if found, send PF12,PF11
  5088.      NEXT  "MENU 2",               "@b"         * Required next screen
  5089.                                                 * if found, send PF11
  5090.     STOP   "MENU 1"                             * Required stop screen
  5091.  
  5092.   LOGOFF                  * Section for logoff screen definitions
  5093.     START  "MENU 1",               "logoff@E"   * Start screen
  5094.                                                 * if found, send "logoff",Enter
  5095.     STOP   "MSG10"                              * Required stop screen
  5096.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5097.  
  5098.  
  5099. ΓòÉΓòÉΓòÉ 7.3.6.4. NSCOS400.HIF ΓòÉΓòÉΓòÉ
  5100.  
  5101. NSCOS400.HIF is a host information file for an OS/400 System. It defines start 
  5102. and stop screens for the OS/400 menu system. It uses the chgpwd command to 
  5103. change the password. To signon to the host, it uses the OS/400 initial Sign On 
  5104. screen. NSCOS400.HIF has one HIF Variable: 
  5105.  
  5106.      V1 defines the host session id (e.g. V1=A) 
  5107.  
  5108.  The following is an example of HOST definition using this host information 
  5109.  file. 
  5110.  
  5111.     USERID=PDQUEUE
  5112.     Host,EMULATOR,Name=AS400,ON,HIF=d:\nsc\nscos400.hif,V1=D
  5113.  
  5114.  In this example, "V1=D" specifies host emulator session D will be used for the 
  5115.  host "AS400". 
  5116.  
  5117.    NSCOS400.HIF 
  5118.  
  5119.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5120.   * This is a sample host information file for an OS/400 host system
  5121.   * It requires the following HIF Variables in the NSC configuration file:
  5122.   *   V1=host session id  (e.g. V1=C)
  5123.  
  5124.   CONFIGURATION                 * Section for configuration options
  5125.     SESSION     @V1                       * Host session id from HIF Variable V1
  5126.     HOSTWAIT    5                         * Wait for Host up to 5 seconds
  5127.     SESSIONWAIT 60                        * Wait for Session up to 60 seconds
  5128.     UFIELD      10                        * UserID entry field length
  5129.     PFIELD      10                        * Password entry field length
  5130.  
  5131.   LOGON                         * Section for logon screen definitions
  5132.     START  "Sign On",              "@U@P@E"     * Start screen
  5133.                                                 * if found, send UID,PW,Enter
  5134.      STOP? "===>"                               * Conditional stop screen
  5135.      UINV  "does not exist",       "@C"         * UserID Invalid error screen
  5136.                                                 * if found, send Clear
  5137.      PINV  "Password not correct", "@C"         * Password invalid error screen
  5138.                                                 * if found, send Clear
  5139.      PEXP  "Password has expired", "@3@sY@E"    * Password expired error screen
  5140.                                                 * if found, send PF3,"Y",Enter
  5141.      PWRN  "until password expire","@3"         * Password expiring warning screen
  5142.                                                 * if found, send PF3
  5143.     STOP   "===>"                               * Required stop screen
  5144.  
  5145.   PASSWORD                      * Section for password change screen definitions
  5146.     * Password change screen definitions if logged off
  5147.     START  "Sign On",              "@U@P@E"     * Start screen
  5148.                                                 * if found, send UID,PW,Enter
  5149.      UINV  "does not exist",       "@C"         * UserID Invalid error screen
  5150.                                                 * if found, send Clear
  5151.      PINV  "Password not correct", "@C"         * Password invalid error screen
  5152.                                                 * if found, send Clear
  5153.      * Password change screen definitions if password has not expired
  5154.      NEXT? "===>",                 "chgpwd@E"   * Optional next screen
  5155.                                                 * if found, send "chgpwd",Enter
  5156.      NEXT? "Change Password",      "@P@N@N@E"   * Optional next screen
  5157.                                                 * if found, send PW,NPW,NWP,Enter
  5158.      PINV  "Current password not", "@3@ssignoff@E" * Password invalid error screen
  5159.                                                 * if found,send PF3,"signoff",Ent
  5160.      NINV  "Name is not valid",    "@3@ssignoff@E" * NewPW invalid error screen
  5161.                                                 * if found,send PF3,"signoff",Ent
  5162.      NINV  "password cannot be",   "@3@ssignoff@E" * NewPW invalid error screen
  5163.                                                 * if found,send PF3,"signoff",Ent
  5164.      * Password change screen definitions if password has expired
  5165.      NEXT? "Password has expired", "@9"         * Optional next screen
  5166.                                                 * if found, send PF9
  5167.      NEXT? "Change Password",      "@P@N@N@E"   * Optional next screen
  5168.                                                 * if found, send PW,NPW,NWP,Enter
  5169.      PINV  "Current password not", "@3@s@3@sY@E"   * Password invalid error screen
  5170.                                                 * if found,send PF3,PF3,"Y",Enter
  5171.      NINV  "Name is not valid",    "@3@s@3@sY@E"   * NewPW invalid error screen
  5172.                                                 * if found,send PF3,PF3,"Y",Enter
  5173.      NINV  "password cannot be",   "@3@s@3@sY@E"   * NewPW invalid error screen
  5174.                                                 * if found,send PF3,PF3,"Y",Enter
  5175.      NEXT  "===>",                 "signoff@E"  * Required next screen
  5176.                                                 * if found, send "signoff",Enter
  5177.     STOP   "Sign On"                            * Required stop screen
  5178.  
  5179.     * Password change screen definitions if logged on
  5180.     START  "===>",                 "chgpwd@E"   * Start screen
  5181.                                                 * if found, send "chgpwd",Enter
  5182.      NEXT  "Change Password",      "@P@N@N@E"   * Required next screen
  5183.                                                 * if found, send PW,NPW,NWP,Enter
  5184.      PINV  "Current password not", "@3"         * Password invalid error screen
  5185.                                                 * if found, send PF3
  5186.      NINV  "Name is not valid",    "@3"         * NewPassword invalid error screen
  5187.                                                 * if found, send PF3
  5188.      NINV  "password cannot be",   "@3"         * NewPassword invalid error screen
  5189.                                                 * if found, send PF3
  5190.     STOP   "Password changed"                   * Required stop screen
  5191.  
  5192.   LOGOFF                        * Section for logoff screen definitions
  5193.     START  "===>",                 "signoff@E"  * Start screen
  5194.                                                 * if found, send "signoff",Enter
  5195.     STOP   "Sign On"                            * Required stop screen
  5196.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5197.  
  5198.  
  5199. ΓòÉΓòÉΓòÉ 7.3.6.5. NSCIIN.HIF ΓòÉΓòÉΓòÉ
  5200.  
  5201. NSCIIN.HIF is a host information file for the IBM Information Network (IIN). It 
  5202. defines start and stop screens for the IIN Product Selection screen. It uses 
  5203. the IIN Services screens to change the IIN password. It does not support any 
  5204. particular product that you may access via IIN. It can only change your 
  5205. password if you are signed off, or signed on and at the IIN Product Selection 
  5206. screen. 
  5207.  
  5208. To signon to the IIN, it sends the node id for IIN, (typically "IIN", but you 
  5209. specify this as a HIF Variable in the HOST definition). NSCIIN.HIF has five HIF 
  5210. Variables: 
  5211.  
  5212.      V1 defines the host session id (e.g. V1=A) 
  5213.  
  5214.      V2 defines the node id sent for a signon (e.g. V2=IIN) 
  5215.  
  5216.      V3 defines the account name, plus a tab if less than 8 characters (e.g. 
  5217.       V3=ACCOUNT1 or V3=AUSD@T) 
  5218.  
  5219.      V4 is normally an empty string; if you want NSC to construct an extended 
  5220.       password for you, it is the first character for passwords (e.g. V4="" or 
  5221.       V4=".") 
  5222.  
  5223.      V5 is normally 8; if you want NSC to construct an extended password for 
  5224.       you, it must be 7 (e.g. V5=8 or V5=7) 
  5225.  
  5226.  Some IIN accounts require the use of extended passwords. Extended passwords 
  5227.  must contain one of the following special characters: 
  5228.  
  5229.     . ? ; ' " ( ) : &
  5230.  
  5231.  Since many security facilities do not allow these characters in passwords, we 
  5232.  have added some special provisions to this host information file to allow you 
  5233.  to keep your IIN password in sync if you must use extended passwords. There 
  5234.  are three different ways that you can choose for using NSCIIN to access the 
  5235.  IIN: 
  5236.  
  5237.    1. IIN password is not extended, and the same password is used everywhere. 
  5238.       In this case, you should define: 
  5239.  
  5240.               MAXPWLEN=8
  5241.               HOST,EMULATOR,...V4="",V5=8
  5242.  
  5243.    2. IIN password is extended, and the same password is used everywhere (this 
  5244.       requires that all locations support your extended password). In this 
  5245.       case, you should define: 
  5246.  
  5247.               MAXPWLEN=8
  5248.               CHARSET=.?;'"():&
  5249.               HOST,EMULATOR,...,V4="",V5=8
  5250.  
  5251.       Adding the CHARSET definition enables the entering of the extended 
  5252.       characters in NSC. 
  5253.  
  5254.    3. IIN password is extended, and the password excluding the extended 
  5255.       character is used everywhere else. In this case, you should define: 
  5256.  
  5257.               MAXPWLEN=7
  5258.               HOST,EMULATOR,...,V4=".",V5=7
  5259.  
  5260.       You can choose any of the extended characters for V4. NSC will always 
  5261.       prefix your password with this character before sending it to the 
  5262.       emulator for IIN. You may have to first change your password to a 
  5263.       password that conforms to this syntax without using NSC before allowing 
  5264.       NSC to perform signons or change your password. You do not need the 
  5265.       CHARSET definition, since you never actually enter the extended character 
  5266.       in NSC. The length of the password field is set to 7 so that NSC will 
  5267.       send a Tab key with your password only if your password is less than 7 
  5268.       characters (the extended character goes into the password field on the 
  5269.       screen, but NSC does not count it as part of the password length). 
  5270.  
  5271.  The following is an example of a HOST definition using this host information 
  5272.  file. 
  5273.  
  5274.     USERID=PDQUEUE
  5275.     MAXPWLEN=8
  5276.     Host,EMULATOR,Name=IIN,HIF=d:\nsc\nsciis.hif,V1=A,V2=iin,V3=ACCT@T,V4="",V5=8
  5277.  
  5278.  In this example, "V1=A" specifies host emulator session A will be used for the 
  5279.  host "IIN", and "V2=iin" specifies that the initial connection to the IIN will 
  5280.  be made by sending the string "iin" to the emulator. "V3=ACCT@T" specifies the 
  5281.  account as "ACCT", and includes a tab character since it is less than eight 
  5282.  characters long. Since this account does not require extended passwords, V4 is 
  5283.  set to an empty string and V5 is set to 8. 
  5284.  
  5285.    NSCIIN.HIF 
  5286.  
  5287.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5288.   * This is a sample host information file for the IBM Information Network.
  5289.   * It requires the following HIF Variables in the NSC configuration file:
  5290.   *   V1=host session id  (e.g. V1=A or V1=A-E)
  5291.   *   V2=the first command sent for a signon (e.g. V2=iin)
  5292.   *   V3=the account name, plus a tab if less than 8 characters (e.g. V3=AUSD@T)
  5293.   *   V4=first character of PW if extended PW reqd (e.g. V4="" or V4=".")
  5294.   *   V5=password field length: 7 if using extended PWs, 8 otherwise (e.g. V5=7)
  5295.  
  5296.   CONFIGURATION           * Section for configuration options
  5297.     SESSION     @V1                       * Host session id from HIF Variable V1
  5298.     HOSTWAIT    5                         * Wait for Host up to 5 seconds
  5299.     SESSIONWAIT 60                        * Wait for Session up to 60 seconds
  5300.     UFIELD      7                         * UserID entry field length
  5301.     PFIELD      @V5                       * Password entry field length
  5302.  
  5303.   GLOBAL                  * Section for global screen definitions
  5304.     * The following definitions are for when the screen needs to be cleared
  5305.     * The following definitions are for exiting intermediate functions
  5306.  
  5307.   LOGON                   * Section for logon screen definitions
  5308.     START  "MSG10",                "@V2@E"      * Start screen
  5309.                                                 * if found, send V2,Enter
  5310.      NEXT  "SVM0201P",             "@V3@U@V4@p@E"  * Required next screen
  5311.                                                 * if found,
  5312.                                                 * send V3,UID,V4,PW,Enter
  5313.      STOP? "SVM0401P"                           * Conditional stop screen
  5314.      UINV  "account and userid",   "@T@T@Tlogoff@E"  * UserID Invalid error screen
  5315.                                                 * if found,
  5316.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5317.      PINV  "an extended password", "@Tlogoff@E" * Password invalid error
  5318.                                                 * if found,
  5319.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5320.      PINV  "a valid password",     "@Tlogoff@E" * Password invalid error
  5321.                                                 * if found,
  5322.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5323.      PEXP  "SVM3201P",             "@3@T@T@Tlogoff@E" * Password expired error
  5324.                                                 * if found, send PF3,
  5325.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5326.     STOP   "SVM0401P"                           * Required stop screen
  5327.  
  5328.   PASSWORD                * Section for password change screen definitions
  5329.     * Password change screen definitions if logged off
  5330.     START  "MSG10",                "iin@E"      * Start screen
  5331.                                                 * if found, send "iin",Enter
  5332.      NEXT  "SVM0201P",             "@V3@U@V4@p@E"  * Required next screen
  5333.                                                 * if found,
  5334.                                                 * send V3,UID,V4,PW,Enter
  5335.      UINV  "account and userid",   "@T@T@Tlogoff@E"  * UserID Invalid error screen
  5336.                                                 * if found,
  5337.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5338.      PINV  "an extended password", "@T@T@Tlogoff@E"  * Password invalid error
  5339.                                                 * if found,
  5340.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5341.      PINV  "a valid password",     "@T@T@Tlogoff@E"  * Password invalid error
  5342.                                                 * if found,
  5343.                                                 * send Tab,Tab,Tab,"logoff",Enter
  5344.      * Password change screen definitions if password has not expired
  5345.      * If password has expired, system goes directly to the Required next screen
  5346.      NEXT? "SVM0401P",             "@5"         * Conditional next screen
  5347.                                                 * if found, send PF5
  5348.      NEXT? "SVM1501P",             "PAS@E"      * Conditional next screen
  5349.                                                 * if found, send "PAS",Enter
  5350.      NEXT  "SVM3201P",             "@V4@P@V4@N@V4@N@E"    * Required next screen
  5351.                                                 * if found,
  5352.                                                 * send V4,PW,V4,NPW,V4,NPW,Enter
  5353.      PNINV "an extended password", "@3@3@3@T@T@Tlogoff@E"
  5354.                                                 * PW or NewPW invalid error screen
  5355.                                                 * if found, send PF3,PF3,PF3
  5356.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5357.      PNINV "a valid password",     "@3@3@3@T@T@Tlogoff@E"
  5358.                                                 * PW or NewPW invalid error screen
  5359.                                                 * if found, send PF3,PF3,PF3
  5360.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5361.      NINV  "new password was inv", "@3@3@3@T@T@Tlogoff@E"
  5362.                                                 * NewPW invalid error screen
  5363.                                                 * if found, send PF3,PF3,PF3
  5364.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5365.      NEXT  "successfully changed", "@3","@3@3@3@T@T@Tlogoff@E"
  5366.                                                 * Required next screen
  5367.                                                 * if found send PF3, else PF3,PF3
  5368.                                                 * PF3,Tab,Tab,Tab,"logoff",Enter
  5369.      NEXT? "SVM1501P",             "@3"         * Conditional next screen
  5370.                                                 * if found, send PF3
  5371.      NEXT  "SVM0401P",             "@3@T@T@Tlogoff@E"     * Required next screen
  5372.                                                 * if found, send PF3,
  5373.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5374.     STOP   "MSG10"                              * Required stop screen
  5375.  
  5376.     * Password change screen definitions if logged on at the main menu
  5377.     START  "SVM0401P",             "@5"         * Start screen
  5378.                                                 * if found, PF5
  5379.      NEXT  "SVM1501P",             "PAS@E"      * Required next screen
  5380.                                                 * if found, "PAS",Enter
  5381.      NEXT  "SVM3201P",             "@V4@P@V4@N@V4@N@E"    * Required next screen
  5382.                                                 * if found,
  5383.                                                 * send V4,PW,V4,NPW,V4,NPW,Enter
  5384.      PNINV "an extended password", "@3@3"       * PW or NewPW invalid error screen
  5385.                                                 * if found, send PF3,PF3
  5386.      PNINV "a valid password",     "@3@3"       * PW or NewPW invalid error
  5387.                                                 * if found, send PF3,PF3
  5388.      NINV  "new password was inv", "@3@3"       * NewPW invalid error screen
  5389.                                                 * if found, send PF3,PF3
  5390.      NEXT  "successfully changed", "@3@3","@3@3"* Required next screen
  5391.                                                 * send PF3,PF3
  5392.     STOP   "SVM0401P"                           * Required stop screen
  5393.  
  5394.   LOGOFF                  * Section for logoff screen definitions
  5395.     START  "SVM0401P",             "@3@T@T@Tlogoff@E"     * Start screen
  5396.                                                 * if found, send PF3,
  5397.                                                 *      Tab,Tab,Tab,"logoff",Enter
  5398.     STOP   "MSG10"                              * Required stop screen
  5399.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  5400.  
  5401.  
  5402. ΓòÉΓòÉΓòÉ 7.4. Configuring APPC ΓòÉΓòÉΓòÉ
  5403.  
  5404. NSC can communicate with a host computer program using APPC. (APPC is a 
  5405. communication protocol that is used by programs to talk to each other.) The 
  5406. host computer programs that can use APPC to talk to NSC are described in Host 
  5407. Systems. Before NSC and the host program can talk, network definitions must be 
  5408. done at the personal computer and at the host computer. The following 
  5409. information will help you make those definitions. 
  5410.  
  5411. You can use APPC host connections from either an NSC OS/2 Client or an NSC 
  5412. Server. Making your APPC connection at an NSC Server requires less work for you 
  5413. and your host system communication programmer. If the APPC connection is done 
  5414. over an expensive communications circuit, you may also reduce your circuit 
  5415. cost. You can have APPC password change operations done for either an NSC DOS 
  5416. or OS/2 Client by an NSC Server by placing these two statements in the client's 
  5417. NSC configuration file: 
  5418.  
  5419.  
  5420.   SERVER,NAME=....
  5421.   HOST,NAME=....,APPC
  5422.  
  5423. Using an NSC Server means you must make the Communications Manager definitions 
  5424. for only the server workstation (not every client). The same thing applies to 
  5425. the host computer. Each workstation (client) having an APPC connection requires 
  5426. a host system definition. 
  5427.  
  5428. Browse through this subsection for planning purposes, then contact your host 
  5429. system communication programmer for help with the host computer definitions. 
  5430. The definitions you make at the personal computer must fit with those made at 
  5431. your host computer. You may then want to review the information in detail and 
  5432. proceed with your definitions. 
  5433.  
  5434. The personal computer definitions must be done with the Communications Manager. 
  5435. See Personal Computer Definitions. 
  5436.  
  5437. The host computer definitions may involve NCP, VTAM, and CICS or other host 
  5438. computer software. After reading about the personal computer definitions, you 
  5439. will find the host computer definition information and some host examples in 
  5440. Matching the Host and PC Definitions. 
  5441.  
  5442.  
  5443. ΓòÉΓòÉΓòÉ 7.4.1. Personal Computer Definitions ΓòÉΓòÉΓòÉ
  5444.  
  5445. You must define several Communications Manager configuration profiles to effect 
  5446. the APPC connection at the personal computer. Figure "PC APPC Profiles" depicts 
  5447. the relationship among the various APPC profiles you will define. 
  5448.  
  5449.  
  5450. PC APPC Profiles
  5451.  
  5452.       NSC configuration file
  5453.    ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5454.    ΓöéHOST..=<host-name>,APPC   Γöé
  5455.    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ Γöé ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5456.         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5457.  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇ Γöé ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5458.  Γöé      Γöé APPC Partner LU Profile                             Γöé
  5459.  Γöé      Γöé <PLU alias>                                         Γöé
  5460.  Γöé    Γöî V ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  5461.  Γöé    Γöé...<LU alias>...<Mode Name>...<Initial Session Limit>Γöé Γöé
  5462.  Γöé    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ Γöé ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ Γöé ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ Γöé ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
  5463.  Γöé            Γöé             Γöé                   Γöé             Γöé
  5464.  Γöé            ΓööΓöÇΓöÇΓöÇΓöÇΓöÉ        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ  Γöé
  5465.  Γöé                 Γöé APPC LU Profile        Γöé              Γöé  Γöé
  5466.  Γöé                 Γöé <LU alias>             Γöé              Γöé  Γöé
  5467.  Γöé           ΓöîΓöÇΓöÇΓöÇΓöÇ V ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ     Γöé              Γöé  Γöé
  5468.  Γöé           Γöé.............<LU Name>..Γöé     Γöé              Γöé  Γöé
  5469.  Γöé           ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ     Γöé              Γöé  Γöé
  5470.  Γöé                                          Γöé              Γöé  Γöé
  5471.  Γöé                   APPC Transmission Service Mode ProfileΓöé  Γöé
  5472.  Γöé                 ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ              Γöé  Γöé
  5473.  Γöé                 Γöé <Mode Name>                           Γöé  Γöé
  5474.  Γöé           ΓöîΓöÇΓöÇΓöÇΓöÇ V ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ                    Γöé  Γöé
  5475.  Γöé           Γöé........................Γöé                    Γöé  Γöé
  5476.  Γöé           ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ                    Γöé  Γöé
  5477.  Γöé                                                         Γöé  Γöé
  5478.  Γöé                   APPC Initial Session Limit Profile    Γöé  Γöé
  5479.  Γöé                 ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ  Γöé
  5480.  Γöé                 Γöé <Initial Session Limit>                  Γöé
  5481.  Γöé           ΓöîΓöÇΓöÇΓöÇΓöÇ V ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ                       Γöé
  5482.  Γöé           Γöé........................Γöé                       Γöé
  5483.  Γöé           ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ                       Γöé
  5484.  Γöé                                                            Γöé
  5485.  Γöé      Communications Manager Configuration Definitions      Γöé
  5486.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5487.  
  5488. The APPC connection starts with your NSC configuration file. The HOST option in 
  5489. the NSC configuration file defines a host-name. The value for host-name is the 
  5490. name of an APPC Partner LU Profile. The APPC Partner LU Profile in turn 
  5491. identifies three other APPC profiles. 
  5492.  
  5493. Use any of the following methods to define the options: 
  5494.  
  5495.  Copy      NSC provides a sample Communications Manager configuration file that 
  5496.            you can modify to meet your configuration requirements. If you have 
  5497.            just installed the Communications Manager, this is probably the 
  5498.            fastest and easiest way to get started. See Using the Sample for a 
  5499.            description of this process. 
  5500.  
  5501.  Merge     You can merge the NSC sample Communications Manager configuration 
  5502.            file profiles into another Communications Manager configuration 
  5503.            file. If you have already configured Communications Manager for your 
  5504.            network, this may the easiest way to get started. See Merging the 
  5505.            Sample for a description of this process. 
  5506.  
  5507.  New       You can create a new Communications Manager configuration file. See 
  5508.            APPC Definitions for a description of this process. 
  5509.  
  5510.  
  5511. ΓòÉΓòÉΓòÉ 7.4.1.1. Using the Sample ΓòÉΓòÉΓòÉ
  5512.  
  5513. To use the sample OS/2 EE 1.3 Communications Manager configuration file, follow 
  5514. these steps: 
  5515.  
  5516.    1. Use the OS/2 COPY command to copy the NSC sample Communications Manager 
  5517.       configuration file into CMLIB. For example: 
  5518.  
  5519.                 COPY  C:\TOOLS\NSCSAMPL.CFG  C:\CMLIB\MYOWN.CFG
  5520.  
  5521.      NOTE You must provide the path locations to the sample file and to CMLIB. 
  5522.      The location of the sample file is where NSC was installed. To determine 
  5523.      the location of CMLIB, enter PATH at the OS/2 command prompt and determine 
  5524.      the path from the information presented. 
  5525.  
  5526.    2. If you are using Communications Manager ES 1.0, follow these steps to 
  5527.       upgrade the configuration file: 
  5528.  
  5529.         a) Switch to the Communications Manager task window. 
  5530.  
  5531.         b) At the Main Menu select the Advanced pulldown and the Upgrade 
  5532.            configuration files option. 
  5533.  
  5534.         c) When prompted, enter the the name of the file you created with the 
  5535.            copy in Step 1. 
  5536.  
  5537.            When prompted for a target file name, you can reuse the source file 
  5538.            by specifying the same name. 
  5539.  
  5540.            When prompted, enter a report file name. 
  5541.  
  5542.    3. See Matching the Host and PC Definitions to customize the configuration 
  5543.       file. If your host connection supports APPC but is not LAN Token Ring, 
  5544.       then add the host link definition (DLC profile) and change the DLC type 
  5545.       in the APPC Partner LU Profile. 
  5546.  
  5547.  
  5548. ΓòÉΓòÉΓòÉ 7.4.1.2. Merging the Sample ΓòÉΓòÉΓòÉ
  5549.  
  5550. To merge the sample OS/2 EE 1.3 Communications Manager configuration file, 
  5551. follow these steps: 
  5552.  
  5553.    1. Use the OS/2 COPY command to copy the NSC sample Communications Manager 
  5554.       configuration file into CMLIB. For example: 
  5555.  
  5556.                 COPY  C:\TOOLS\NSCSAMPL.CFG  C:\CMLIB\MYOWN.CFG
  5557.  
  5558.      NOTE You must provide the path locations to the sample file and to CMLIB. 
  5559.      The location of the sample file is where NSC was installed. To determine 
  5560.      the location of CMLIB, enter PATH at the OS/2 command prompt and determine 
  5561.      the path from the information presented. 
  5562.  
  5563.    2. Switch to the Communications Manager task window. 
  5564.  
  5565.    3. If you are using Communications Manager ES 1.0, follow these steps to 
  5566.       upgrade the configuration file: 
  5567.  
  5568.         a) At the Main Menu select the Advanced pulldown and the Upgrade 
  5569.            configuration files option. 
  5570.  
  5571.         b) When prompted, enter the the name of the file you created with the 
  5572.            copy in Step 1. 
  5573.  
  5574.            When prompted for a target file name, you can reuse the source file 
  5575.            by specifying the same name. 
  5576.  
  5577.            When prompted, enter a report file name. 
  5578.  
  5579.    4. At the Communications Manager Main Menu select the Advanced pulldown and 
  5580.       the Configuration option. 
  5581.  
  5582.    5. When prompted, enter the name of a Communications Manager configuration 
  5583.       file.  You should then see the Communication Configuration Menu. 
  5584.  
  5585.    6. Select the Configuration file utilities. 
  5586.  
  5587.    7. The Configuration File Utilities menu should be displayed. Use the 
  5588.       options provided to copy the APPC profiles from the NSC sample file you 
  5589.       upgraded in Step 3b or that you copied in Step 1. 
  5590.  
  5591.    8. See Matching the Host and PC Definitions to customize the configuration 
  5592.       file. If your host connection supports APPC but is not LAN Token Ring, 
  5593.       then add the host link definition (DLC profile) and change the DLC type 
  5594.       in the APPC Partner LU Profile. 
  5595.  
  5596.  
  5597. ΓòÉΓòÉΓòÉ 7.4.1.3. APPC Definitions ΓòÉΓòÉΓòÉ
  5598.  
  5599. If you have defined your data link connection profiles, follow these steps to 
  5600. make the APPC definitions shown in Figure "PC APPC Profiles". 
  5601.  
  5602.    1. Switch to the Communications Manager task window. 
  5603.  
  5604.    2. At the Main Menu select the Advanced pulldown and specify the 
  5605.       Configuration option. 
  5606.  
  5607.    3. You will be prompted to specify the name of a Communications Manager 
  5608.       configuration file.  After you select the configuration file to change, 
  5609.       you should see the Communication Configuration Menu. 
  5610.  
  5611.    4. Select the SNA feature profiles option. 
  5612.  
  5613.    5. Select the options in the SNA Feature Configuration menu to define the 
  5614.       APPC profiles. 
  5615.  
  5616.       HINT: It is easier to make these definitions from the bottom up. For 
  5617.       example, do the Mode and LU definitions before the Partner LU definition. 
  5618.  
  5619.    6. If you are using Communications Manager ES 1.0, follow these steps after 
  5620.       you define the PLU, LU, and Mode: 
  5621.  
  5622.         a) Edit the Network Definition File (.NDF) associated with the 
  5623.            Communications Manager configuration file containing your SNA 
  5624.            network definitions. The NDF file is located in the APPN 
  5625.            subdirectory of CMLIB. The filename is the same as your 
  5626.            configuration file and its extension is NDF. 
  5627.  
  5628.         b) Add a CNOS definition to the NDF file. The CNOS links the LU and 
  5629.            Mode definitions together with the PLU. For example: 
  5630.  
  5631.                         CNOS  LOCAL_LU_ALIAS(TPC01PI0) <ΓöÇΓöÇLUName
  5632.                               PARTNER_LU_ALIAS(NSCPLU01)
  5633.                               MODE_NAME(LU62P   ) <ΓöÇΓöÇModeName
  5634.                               SET_NEGOTIABLE(NO)
  5635.                               PLU_MODE_SESSION_LIMIT(3) <ΓöÇΓöÇSesLim
  5636.                               MIN_CONWINNERS_SOURCE(3)
  5637.                               MIN_CONWINNERS_TARGET(0)
  5638.                               AUTO_ACTIVATE(3);
  5639.  
  5640.            The values specified for LOCAL_LU_ALIAS, MODE_NAME, and 
  5641.            PLU_MODE_SESSION_LIMIT must match those used in your Communications 
  5642.            Manager definitions and in your host computer definitions. 
  5643.  
  5644.            The value of PARTNER_LU_ALIAS must match the name given to the PLU 
  5645.            you defined. 
  5646.  
  5647.         c) After adding the CNOS definition, use the Communications Manager to 
  5648.            verify the configuration file. 
  5649.  
  5650.    7. See Matching the Host and PC Definitions to verify that your 
  5651.       configuration matches the host definitions. 
  5652.  
  5653.  
  5654. ΓòÉΓòÉΓòÉ 7.4.2. Matching the Host and PC Definitions ΓòÉΓòÉΓòÉ
  5655.  
  5656. Be sure that the Communications Manager configuration file matches your host 
  5657. definitions so that NSC can use APPC to talk to the host. This section 
  5658. discusses the other Communications Manager profiles that must be coordinated 
  5659. with host definitions. The profiles discussed are: 
  5660.  
  5661.       Workstation profile 
  5662.  
  5663.       LAN feature profiles 
  5664.  
  5665.       SNA feature profiles 
  5666.  
  5667.  
  5668. ΓòÉΓòÉΓòÉ 7.4.2.1. Workstation profile ΓòÉΓòÉΓòÉ
  5669.  
  5670. The Workstation profile must specify that the SNA/APPC service be loaded. If 
  5671. you do not configure your system for APPC, NSC provides an error message when 
  5672. host signon is attempted. 
  5673.  
  5674.  
  5675. ΓòÉΓòÉΓòÉ 7.4.2.2. LAN feature profiles ΓòÉΓòÉΓòÉ
  5676.  
  5677. If you use a LAN to connect to the host, then your LAN feature profile must 
  5678. specify addressing information to locate the host computer. Review the LAN 
  5679. feature profile and change it as needed. 
  5680.  
  5681.      NOTE In Communications Manager ES 1.0, the LAN feature profile is called 
  5682.      the LAN Adapter and Protocol Support. 
  5683.  
  5684.  
  5685. ΓòÉΓòÉΓòÉ 7.4.2.3. SNA feature profiles ΓòÉΓòÉΓòÉ
  5686.  
  5687. Several profiles within the SNA feature profile definitions must match their 
  5688. host counterparts. In Communications Manager ES 1.0, these profiles are stored 
  5689. in the SNA network definitions part of the SNA feature profile. 
  5690.  
  5691. The SNA profiles are: 
  5692.  
  5693.      SNA base profile (EE 1.3) or Local Node Characteristics (ES 1.0) 
  5694.  
  5695.       The PU name (EE 1.3) or Local node name (ES 1.0) for your personal 
  5696.       computer must match the CPNAME given in the host VTAM definition (see 
  5697.       CPName in Figure "VTAM Switched Major Node Definition"). 
  5698.  
  5699.       The name of the Network your personal computer is attached to must match 
  5700.       the Network name given when VTAM is started (see NetID in Figure "Host 
  5701.       VTAM Startup Parameter"). 
  5702.  
  5703.      APPC LU profile (EE 1.3) or Additional SNA Features Local LU (ES 1.0) 
  5704.  
  5705.       The LU name must match the LU name given in the VTAM definition (see 
  5706.       LUName in Figure "VTAM Switched Major Node Definition"). If your host 
  5707.       uses CICS, the LU name must also match the one given in the CICS 
  5708.       definition (see LUName in Figure "Host CICS Definition 1"). 
  5709.  
  5710.       The PC's LU can be dependent or independent. The sample file defines it 
  5711.       as independent, because that is more flexible. 
  5712.  
  5713.      Transmission Service Mode profile (EE 1.3) or Additional SNA Features 
  5714.       Modes (ES 1.0) 
  5715.  
  5716.       The Mode name must match: 
  5717.  
  5718.         1. One of the LOGMODE entries defined in a LOGMODE Table (see ModeName 
  5719.            in Figure "Host LOGMODE Definition"). 
  5720.  
  5721.         2. It should also match the LOGMODE specified for the host LU (see 
  5722.            ModeName in Figure "Host VTAM APPL LU Definition"). The Mode name 
  5723.            may also be specified in the VTAM definition (see ModeName in Figure 
  5724.            "VTAM Switched Major Node Definition") as the default entry. 
  5725.  
  5726.         3. If your host uses CICS, the Mode name must also match the one given 
  5727.            in the CICS definition (see ModeName in Figure "Host CICS Definition 
  5728.            2"). 
  5729.  
  5730.      Initial Session Limit profile (EE 1.3) The Minimum number of contention 
  5731.       winners source should match the DSESLIM (see SesLim in Figure "Host VTAM 
  5732.       APPL LU Definition") and the SESSIONS PROPERTIES MAximum in the CICS 
  5733.       definition (see SesLim in Figure "Host CICS Definition 2"). 
  5734.  
  5735.       You can have multiple concurrent sessions with the host to handle host 
  5736.       logon validations. In this case, use the personal computer as a gateway 
  5737.       (NSC Server) for other workstations to perform the host logon 
  5738.       validations. 
  5739.  
  5740.       Sessions are allocated only as needed, up to the session limit you 
  5741.       establish. The more sessions you establish, the faster your host logon 
  5742.       request is serviced when concurrent signon operations are active. A host 
  5743.       logon typically takes 2 seconds to process. The number of sessions you 
  5744.       need to provide good service depends on the number of attached 
  5745.       workstations and the arrival rate of their requests. Start with 3 
  5746.       sessions and add more if the logon service is too slow. 
  5747.  
  5748.       If you are using ES 1.0, this value does not have to be specified since 
  5749.       the host computer never initiates a session with the PC. The maximum 
  5750.       number of sessions is defined in Additional SNA Features Modes. 
  5751.  
  5752.      APPC Partner LU Profile 
  5753.  
  5754.       The Fully qualified PLU name is a required field naming the host 
  5755.       application program which NSC talks with (e.g., CICS). The name consists 
  5756.       of: 
  5757.  
  5758.         1. The network name (see NetID in Figure "Host VTAM Startup Parameter") 
  5759.  
  5760.         2. An LU Name (see PLUName in Figure "Host VTAM APPL LU Definition") 
  5761.            that is defined to VTAM as the host LU to talk to NSC. In the sample 
  5762.       configuration file, the network name is NET001 and the LU name is 
  5763.       TH2CICS. VTAM knows CICS by the name TH2CICS since it is specified as a 
  5764.       part of the VTAM definition process. 
  5765.  
  5766.       If you are not using CICS, your host VTAM programmer would define an APPL 
  5767.       LU similar to that shown in Figure "Host VTAM APPL LU Definition". You 
  5768.       must specify the same name (PLUName) as the second part of the Fully 
  5769.       qualified PLU name. 
  5770.  
  5771.       The Mode name field must be the same as that previously discussed about 
  5772.       the Transmission Service Mode profile. 
  5773.  
  5774.       If you are using ES 1.0, the association between the Partner LU and the 
  5775.       Local LU is accomplished via a CNOS definition in the APPN Network 
  5776.       Definition File (.NDF). The NDF file is located in the APPN subdirectory 
  5777.       of CMLIB. 
  5778.  
  5779.  
  5780. ΓòÉΓòÉΓòÉ 7.4.3. Host Computer Definitions ΓòÉΓòÉΓòÉ
  5781.  
  5782. This section contains figures depicting the host APPC definitions needed in an 
  5783. MVS/ESA environment with and without CICS/ESA. These are not the complete 
  5784. definitions necessary for MVS or CICS, only the pieces that involve a PC using 
  5785. APPC communications. 
  5786.  
  5787. The definitions are: 
  5788.  
  5789.       VTAM Startup Parameters 
  5790.  
  5791.       VTAM Switched Major Node Definition 
  5792.  
  5793.       Host VTAM Partner LU Definition 
  5794.  
  5795.       Host LOGMODE Definition 
  5796.  
  5797.       Host CICS Definition 1 
  5798.  
  5799.       Host CICS Definition 2 
  5800.  
  5801.  
  5802. ΓòÉΓòÉΓòÉ 7.4.3.1. VTAM Startup Parameters ΓòÉΓòÉΓòÉ
  5803.  
  5804. Figure "Host VTAM Startup Parameter" shows the VTAM startup parameters. 
  5805.  
  5806.  
  5807. Host VTAM Startup Parameter
  5808.  
  5809. **********************************************************************
  5810. **                                                                  **
  5811. **       VTAM STARTUP OPTION - COMMON STARTUP PARAMETERS FOR:       **
  5812. **                                                                  **
  5813. **                                                                  **
  5814. **  NOTE:  ATCSTR00 IS THE DEFAULT VTAM START-UP OPTIONS MEMBER     **
  5815. **         USED TO INITIALIZE A SPECIFIC VTAM DOMAIN AND IS ALWAYS  **
  5816. **         PROCESSED.  IF A USER DEFINED "ATCSTRYY" IS SPECIFIED    **
  5817. **         (WHERE "YY" IS ANY TWO ALPHANUMERIC DIGITS), THAT        **
  5818. **         MEMBER IS PROCESSED BEFORE AND MERGED INTO THE ATCSTR00  **
  5819. **         MEMBER.                                                  **
  5820. **                                                                  **
  5821. **                                                                  **
  5822. *
  5823. *   BUFFER DEFINITION POSITIONAL PARAMETERS
  5824. *   (BASENO,BUFSIZE,SLOWPT,F,XPANNO,XPANPT,XPANLIM)
  5825. *
  5826.  CRPLBUF=(250,,10,,30,30),   RPL-COPY - PAGEABLE                       X
  5827.  IOBUF=(2000,288,3,,90,36),   I/O BUFFERS - FIXED                      X
  5828.  LFBUF=(80,,2,,5,5),         LARGE GENERAL PURPOSE - FIXED             X
  5829.  LPBUF=(60,,1,,6,2),         LARGE GENERAL PURPOSE - PAGEABLE          X
  5830.  SFBUF=(30,,1,,5,5),         SMALL GENERAL PURPOSE - FIXED             X
  5831.  SPBUF=(30,,2,,8,4),         SMALL GENERAL PURPOSE - PAGEABLE          X
  5832.  CDRSCTI=1H,                      DYNAMIC CDRSC RETENTION  0-32767 480 X
  5833.  IOINT=28800,                 SUPPRESS PENDING MESSAGES 0-99999999 180 X
  5834.  MAXSUBA=31,                                                        15 X
  5835.  MSGMOD=NO,                  INCLUDE VTAM MODULE NAME IN MESSAGES   NO X
  5836.  NETID=NET001, <ΓöÇΓöÇNetID      ** SNI - UNIQUE NETWORK IDENTIFIER     ** X
  5837.  SSCPDYN=YES,                ** DEFAULT                             ** X
  5838.  DYNASSCP=YES,               ** DEFAULT                             ** X
  5839.  COLD,                       ** DEFAULT                             ** X
  5840.  DYNLU=NO,                   ** NO DYNAMIC DEFINITION OF LUS        ** X
  5841.  NMVTLOG=NEVER,              ** DON'T WRITE NV ALERTS TO LOGREC     ** X
  5842.  PROMPT,                                                        PROMPT X
  5843.  NOTRACE,TYPE=VTAM,                                                 ** X
  5844.  PPOLOG=YES                       ** VTAM COMMANDS TO NETWORK LOG   NO
  5845.  
  5846.  
  5847. ΓòÉΓòÉΓòÉ 7.4.3.2. VTAM Switched Major Node Definition ΓòÉΓòÉΓòÉ
  5848.  
  5849. Figure "VTAM Switched Major Node Definition" shows shows part of the VTAM 
  5850. definition defining a PC having an APPC LU and four 3270 LU 2 sessions. 
  5851.  
  5852.  
  5853. VTAM Switched Major Node Definition
  5854.  
  5855. SWTRD80 VBUILD  TYPE=SWNET      TOKEN RING                              00400003
  5856. *                                                                       19810016
  5857. TPC01P   PU    ADDR=04,                                                X19820017
  5858.                CPNAME=TPC01P,   PU 2.1                                 X19821017
  5859.                         
  5860.                         Γöé
  5861.                      CPName
  5862.                MAXDATA=1033,                                           X
  5863.                SSCPFM=USSSCS,                                          X
  5864.                USSTAB=USSHATS,                                         X
  5865.                MODETAB=LOGMODES,DLOGMOD=D3270M0Q
  5866. *
  5867. TPC01P02 LU    LOCADDR=2
  5868. TPC01P03 LU    LOCADDR=3
  5869. TPC01P04 LU    LOCADDR=4
  5870. TPC01P05 LU    LOCADDR=5
  5871. TPC01PI0 LU    LOCADDR=0,DLOGMOD=LU62P,USSTAB=USSLU62
  5872.                                   
  5873.    Γöé                               Γöé
  5874.  LUName                        ModeName
  5875.  
  5876.  
  5877. ΓòÉΓòÉΓòÉ 7.4.3.3. Host VTAM Partner LU Definition ΓòÉΓòÉΓòÉ
  5878.  
  5879. Figure "Host VTAM APPL LU Definition" shows shows the host application 
  5880. definition for the Partner LU the PC talks to when using MVS/ESA without CICS. 
  5881. The host LU name of TH2CICS was used because it matches the Fully qualified PLU 
  5882. name in NSCSAMPL.CFG. 
  5883.  
  5884.  
  5885. Host VTAM APPL LU Definition
  5886.  
  5887.    TH2CICS  APPL  ACBNAME=Z010AP03,
  5888.      
  5889.      Γöé
  5890.   PLUName
  5891.                   APPC=YES,
  5892.                   AUTOSES=0,
  5893.                   DDRAINL=NALLOW,
  5894.                   DLOGMOD=LU62P,
  5895.                             
  5896.                             Γöé
  5897.                          ModeName
  5898.                   DMINWNL=0,
  5899.                   DMINWNR=3,
  5900.                   DRESPL=NALLOW,
  5901.                   DSESLIM=3,
  5902.                           
  5903.                           Γöé
  5904.                        SesLim
  5905.                   LMDENT=19,
  5906.                   MODETAB=LOGMODES,
  5907.                   PARSESS=YES,
  5908.                   SECACPT=PERSISTV,
  5909.                   SRBEXIT=YES
  5910.  
  5911.  
  5912. ΓòÉΓòÉΓòÉ 7.4.3.4. Host LOGMODE Definition ΓòÉΓòÉΓòÉ
  5913.  
  5914. Figure "Host LOGMODE Definition" shows the LOGMODE definition. 
  5915.  
  5916.  
  5917. Host LOGMODE Definition
  5918.  
  5919. LOGMODES MODETAB
  5920.          EJECT
  5921.          TITLE 'SNASVCMG'
  5922. **********************************************************************
  5923. *        LOGMODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING         *
  5924. *                                AS LU 6.2 DEVICES                   *
  5925. **********************************************************************
  5926. SNASVCMG MODEENT LOGMODE=SNASVCMG,FMPROF=X'13',TSPROF=X'07',           *
  5927.                PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'D0B1',            *
  5928.                RUSIZES=X'8585',ENCR=B'0000',                           *
  5929.                PSERVIC=X'060200000000000000000300'
  5930. **********************************************************************
  5931. *        LOGMODE table entry for Network SignON Coordinator          *
  5932. *                 It functions as an LU 6.2 device.                  *
  5933. *                 The default RU Size is 1024 (1K) and supports      *
  5934. *                 parallel sessions.                                 *
  5935. *                                                                    *
  5936. *                 NOTE: CICS does not support AUTOINSTALL for        *
  5937. *                 parallel sessions.                                 *
  5938. *                                                                    *
  5939. **********************************************************************
  5940. LU62P  MODEENT LOGMODE=LU62P, <ΓöÇΓöÇModeName                              X
  5941.                TYPE=0,                                                 X
  5942.                FMPROF=X'13',TSPROF=X'07',                              X
  5943.                PRIPROT=X'B0',SECPROT=X'B0',                            X
  5944.                COMPROT=X'50B1',                                        X
  5945.                SSNDPAC=X'00',SRCVPAC=X'00',                            X
  5946.                RUSIZES=X'8585',PSNDPAC=X'00',                          X
  5947.                PSERVIC=X'060200000000000000002F00'
  5948. **********************************************************************
  5949. * End of LOGMODE table entries                                       *
  5950. **********************************************************************
  5951.          MODEEND
  5952.          END
  5953.  
  5954.  
  5955. ΓòÉΓòÉΓòÉ 7.4.3.5. Host CICS Definition 1 ΓòÉΓòÉΓòÉ
  5956.  
  5957. Figure "Host CICS Definition 1" shows part of the CICS definition referencing a 
  5958. PC using APPC. 
  5959.  
  5960.  
  5961. Host CICS Definition 1
  5962.  
  5963.   OBJECT CHARACTERISTICS                                    CICS RELEASE = 0330
  5964.    CEDA  VIew
  5965.     Connection     : C0P1
  5966.     Group          : OS2LU62
  5967.     DEscription    : LU62 CONNECTION WITH PARALLEL SESSIONS
  5968.    CONNECTION IDENTIFIERS
  5969.     Netname        : TPC01PI0 <ΓöÇΓöÇLUName
  5970.     INDsys         :
  5971.    REMOTE ATTRIBUTES
  5972.     REMOTESystem   :
  5973.     REMOTEName     :
  5974.    CONNECTION PROPERTIES
  5975.     ACcessmethod   : Vtam               Vtam | IRc | INdirect | Xm
  5976.     Protocol       : Appc               Appc | Lu61
  5977.     SInglesess     : No                 No | Yes
  5978.     DAtastream     : User               User | 3270 | SCs | STrfield | Lms
  5979.     RECordformat   : U                  U | Vb
  5980.    OPERATIONAL PROPERTIES
  5981.     AUtoconnect    : No                 No | Yes | All
  5982.     INService      : Yes                Yes | No
  5983.    SECURITY
  5984.     SEcurityname   :
  5985.     ATtachsec      : Local              Local | Identify | Verify | Persistent
  5986.                                         | Mixidpe
  5987.     BINDPassword   :                    PASSWORD NOT SPECIFIED
  5988.     BINDSecurity   : No                 No | Yes
  5989.  
  5990.  
  5991. ΓòÉΓòÉΓòÉ 7.4.3.6. Host CICS Definition 2 ΓòÉΓòÉΓòÉ
  5992.  
  5993. Figure "Host CICS Definition 2" shows part of the CICS definition referencing a 
  5994. PC using APPC. 
  5995.  
  5996.  
  5997. Host CICS Definition 2
  5998.  
  5999.   OBJECT CHARACTERISTICS                                    CICS RELEASE = 0330
  6000.    CEDA  View
  6001.     Sessions       : C0P1001
  6002.     Group          : OS2LU62
  6003.     DEscription    : LU62 CONNECTION WITH PARALLEL SESSIONS
  6004.    SESSION IDENTIFIERS
  6005.     Connection     : C0P1
  6006.     SESSName       :
  6007.     NETnameq       :
  6008.     MOdename       : LU62P <ΓöÇΓöÇModeName
  6009.    SESSION PROPERTIES
  6010.     Protocol       : Appc               Appc | Lu61
  6011.     MAximum        : 003 , 000 <ΓöÇΓöÇSesLim 0-999
  6012.     RECEIVEPfx     :
  6013.     RECEIVECount   :                    1-999
  6014.     SENDPfx        :
  6015.     SENDCount      :                    1-999
  6016.     SENDSize       : 01024              1-30720
  6017.     RECEIVESize    : 01024              1-30720
  6018.     SESSPriority   : 000                0-255
  6019.     Transaction    :
  6020.    OPERATOR DEFAULTS
  6021.     OPERId         :
  6022.     OPERPriority   : 000                0-255
  6023.     OPERRsl        : 0                  0-24,...
  6024.     OPERSecurity   : 1                  1-64,...
  6025.    PRESET SECURITY
  6026.     USERId         :
  6027.    OPERATIONAL PROPERTIES
  6028.     Autoconnect    : No                 No | Yes | All
  6029.     INservice      :                    No | Yes
  6030.     Buildchain     : Yes                Yes | No
  6031.     USERArealen    : 000                0-255
  6032.     IOarealen      : 00000 , 00000      0-32767
  6033.     RELreq         : No                 No | Yes
  6034.     DIscreq        : No                 No | Yes
  6035.     NEPclass       : 000                0-255
  6036.    RECOVERY
  6037.     RECOVOption    : Sysdefault         Sysdefault | Clearconv | Releasesess
  6038.                                         | Uncondrel | None
  6039.     RECOVNotify    : None               None | Message | Transaction
  6040.  
  6041.  
  6042. ΓòÉΓòÉΓòÉ 8. Using the Application Programming Interface ΓòÉΓòÉΓòÉ
  6043.  
  6044. The NSCRSIGN API allows both 16-bit and 32-bit applications to take full 
  6045. advantage of the capabilities of Network SignON Coordinator/2 while bypassing 
  6046. the NSC user interface. The request (signon or signoff), User ID, password, and 
  6047. optionally a new password are provided to the API. In addition, the application 
  6048. must pass the address of a procedure that will be called for each message 
  6049. generated by the API. The application can display these messages, write them to 
  6050. a log file, or perform other processing based on return codes associated with 
  6051. each message. 
  6052.  
  6053. For more information on using the NSCRSIGN API, refer to the following: 
  6054.  
  6055.       NSCRSIGN 
  6056.  
  6057.       OS/2 Toolkit 
  6058.  
  6059.       Compiling and Linking 
  6060.  
  6061.       Example 
  6062.  
  6063.  
  6064. ΓòÉΓòÉΓòÉ 8.1. NSCRSIGN ΓòÉΓòÉΓòÉ
  6065.  
  6066. The NSCRSIGN function performs the signon, change password, and signoff actions 
  6067. as defined in the user's NSC configuration file. For more information, refer to 
  6068. the following: 
  6069.  
  6070.       Syntax 
  6071.  
  6072.       Parameters 
  6073.  
  6074.       Return Codes 
  6075.  
  6076.       Message Callbacks 
  6077.  
  6078.  
  6079. ΓòÉΓòÉΓòÉ 8.1.1. Syntax ΓòÉΓòÉΓòÉ
  6080.  
  6081.   #include  "nscrsign.h"
  6082.  
  6083.   unsigned char UserId[NSC_MAXUIDLEN+1];     /* User ID */
  6084.   unsigned char Password[NSC_MAXPWLEN+1];    /* Current Password */
  6085.   unsigned char NewPassword[NSC_MAXPWLEN+1]; /* New Password */
  6086.   short         Action;                      /* NSC_LOGON, NSC_LOGOFF, NSC_CHGPW */
  6087.   FNMSGDSP     *msgdsp;                      /* Message Callback Procedure */
  6088.   short         return_code;                 /* Return Code */
  6089.  
  6090.   return_code = NSCRSIGN (UserId, Password, NewPassword, Action, NULL, msgdsp);
  6091.  
  6092.  
  6093. ΓòÉΓòÉΓòÉ 8.1.2. Parameters ΓòÉΓòÉΓòÉ
  6094.  
  6095.      UserId (unsigned char *) -- input 
  6096.  
  6097.       The User ID for signon or signoff. If the requested action is NSC_LOGON 
  6098.       or NSC_CHGPW, the "UserId" parameter is required. If the requested action 
  6099.       is NSC_LOGOFF, the "UserId" parameter is not required, but if specified 
  6100.       will be used for some messages. 
  6101.  
  6102.      Password (unsigned char *) -- input 
  6103.  
  6104.       The Current Password for signon. If the requested action is NSC_LOGON or 
  6105.       NSC_CHGPW, the "Password" parameter is required. If the requested action 
  6106.       is NSC_LOGOFF, the "Password" parameter is ignored. 
  6107.  
  6108.      NewPassword (unsigned char *) -- input 
  6109.  
  6110.       The New Password for change password. If the requested action is 
  6111.       NSC_CHGPW, the "NewPassword" parameter is required. If the requested 
  6112.       action is NSC_LOGON or NSC_LOGOFF, the "NewPassword" parameter is 
  6113.       ignored. 
  6114.  
  6115.      Action (short) -- input 
  6116.  
  6117.       The requested action must be one of the following: 
  6118.  
  6119.         -  NSC_LOGON 
  6120.         -  NSC_CHGPW 
  6121.         -  NSC_LOGOFF 
  6122.  
  6123.      reserved (void *) -- not used 
  6124.  
  6125.       The reserved fifth parameter should be set to NULL. 
  6126.  
  6127.      msgdsp (FNMSGDSP *) -- input 
  6128.  
  6129.       The address of the procedure for processing messages. This procedure will 
  6130.       be called for each error encountered while processing the request. This 
  6131.       procedure will also be called for each informational message normally 
  6132.       displayed will processing a request. If no configuration errors are 
  6133.       found, this procedure will be called with an empty message to indicate 
  6134.       processing has begun. See Message Callbacks for a description of this 
  6135.       procedure. 
  6136.  
  6137.  
  6138. ΓòÉΓòÉΓòÉ 8.1.3. Return Codes ΓòÉΓòÉΓòÉ
  6139.  
  6140. NSCRSIGN returns values defined as a short integer (2 bytes). 
  6141.  
  6142. A value of 0 indicates the call was successful. The following non-zero values 
  6143. are returned: 
  6144.  
  6145.  Return Code                   Error 
  6146.  
  6147.  NSC_INVALID_REQUEST           The "Action" parameter contains a value other 
  6148.                                than NSC_LOGON or NSC_LOGOFF. 
  6149.  
  6150.  NSC_BAD_ADDRESS               The address passed as a parameter for "msgdsp" 
  6151.                                is invalid, or one of the addresses passed as a 
  6152.                                parameter for "UserId" or "Password" is invalid 
  6153.                                for a NSC_LOGON request, or one of the addresses 
  6154.                                passed as a parameter for "UserId", "Password", 
  6155.                                or "NewPassword" is invalid for a NSC_CHGPW 
  6156.                                request. 
  6157.  
  6158.  NSC_BAD_PARMS                 The "UserID", "Password", or "NewPassword" is 
  6159.                                longer than 8 characters. The length of the 
  6160.                                "UserId" parameter must be less than 
  6161.                                NSC_MAXUIDLEN. The length of the "Password" or 
  6162.                                "NewPassword" parameter must be less than 
  6163.                                NSC_MAXPWLEN. 
  6164.  
  6165.  NSC_NO_USERID                 No "UserId" parameter was specified for a 
  6166.                                NSC_LOGON request. The "UserId" parameter is 
  6167.                                required for this request. 
  6168.  
  6169.  NSC_NO_PW                     Either no "Password" parameter was specified for 
  6170.                                a NSC_LOGON request, or no "Password" or 
  6171.                                "NewPassword was specified for a NSC_CHGPW 
  6172.                                request. The "Password" parameter is required 
  6173.                                for both the NSC_LOGON and NSC_CHGPW request. 
  6174.                                The "NewPassword" parameter is required for the 
  6175.                                NSC_CHGPW request. 
  6176.  
  6177.  NSC_CONFIG_ERRORS             Configuration Errors were found and passed to 
  6178.                                the procedure specified by "msgdsp". 
  6179.  
  6180.  NSC_EXEC_WARNINGS             Execution Warnings were encountered and passed 
  6181.                                to the procedure specified by "msgdsp". 
  6182.  
  6183.  NSC_EXEC_ERRORS               Execution Errors were encountered and passed to 
  6184.                                the procedure specified by "msgdsp". 
  6185.  
  6186.  
  6187. ΓòÉΓòÉΓòÉ 8.1.4. Message Callbacks ΓòÉΓòÉΓòÉ
  6188.  
  6189. Errors from the NSCRSIGN API are reported to the caller via a message callback 
  6190. procedure as each location defined in an NSC configuration file is processed. 
  6191. The address of this procedure is passed as a parameter to NSCRSIGN. This saves 
  6192. the NSCRSIGN API from having to interact with the user, and allows the 
  6193. application to be a either a full screen or PM application. 
  6194.  
  6195. The message callback procedure should be defined as follows: 
  6196.  
  6197.   void NSC_DLL_ENTRY
  6198.        dspmsg (short                  config_index,
  6199.                short                  return_code,
  6200.                short                  reserved,
  6201.                unsigned char * NSCPTR message_text)
  6202.  
  6203. This procedure is passed the following parameters: 
  6204.  
  6205.      config_index (short) -- input 
  6206.  
  6207.       The index of the LOCAL, LANSERVER, HOST, or SERVER definition being 
  6208.       processed from the NSC configuration file. This parameter allows 
  6209.       identification of a specify remote location as the source of an error. 
  6210.       For configuration errors that do no refer to a LOCAL, LANSERVER, HOST, or 
  6211.       SERVER definition, this parameter is set to 0. For informational 
  6212.       messages, this parameter is set to 0. The first definition has an index 
  6213.       of 1. 
  6214.  
  6215.      return_code (short) -- input 
  6216.  
  6217.       The return code associated with the error message. For information 
  6218.       messages, this parameter is set to 0. For warnings or errors, the return 
  6219.       code is one of the values defined in NSCRSIGN.H. 
  6220.  
  6221.      reserved (short) -- not used 
  6222.  
  6223.       This parameter should be ignored. 
  6224.  
  6225.      message_text (unsigned char * NSCPTR) -- input 
  6226.  
  6227.       The message text associated with the error or informational message. For 
  6228.       error message explanations see Messages. 
  6229.  
  6230.  
  6231. ΓòÉΓòÉΓòÉ 8.2. OS/2 Toolkit ΓòÉΓòÉΓòÉ
  6232.  
  6233. The NSC OS/2 Client contains the following two toolkit files: 
  6234.  
  6235.      NSCRSIGN.LIB - a library containing the import definition for the 
  6236.       NSCRSIGN API. 
  6237.      NSCRSIGN.H - a C header file for the NSCRSIGN API 
  6238.  
  6239.  The NSCRSIGN.H file contains the C prototype for the API and the message 
  6240.  callback procedure, as well as return code definitions, and must be included 
  6241.  in the application source code. If using the IBM C Set/2 Compiler, NSC32 must 
  6242.  be defined prior to including this header file (for example, by using the 
  6243.  -DNSC32 compiler option). 
  6244.  
  6245.  The NSCRSIGN.LIB file can be linked with an application to resolve the 
  6246.  reference to NSCRSIGN (the API itself is in NSCAPI.DLL). 
  6247.  
  6248.  
  6249. ΓòÉΓòÉΓòÉ 8.3. Compiling and Linking ΓòÉΓòÉΓòÉ
  6250.  
  6251. The NSCRSIGN API may be used with one of two compilers: 
  6252.  
  6253.      Microsoft(**) C 6.0 
  6254.      IBM C Set/2(*) 
  6255.  
  6256.  When using the Microsoft C Compiler, use the large memory model. 
  6257.  
  6258.  When using the IBM C Set/2 Compiler, specify the -DNSC32 option. 
  6259.  
  6260.  The NSCRSIGN API may require up to 12K of stack space. 
  6261.  
  6262.  Specify the NSCRSIGN.LIB file when linking. 
  6263.  
  6264.  
  6265. ΓòÉΓòÉΓòÉ 8.4. Example ΓòÉΓòÉΓòÉ
  6266.  
  6267. The following example illustrates a call to NSCRSIGN with all messages written 
  6268. to standard output. The example consists of four files: 
  6269.  
  6270.      example.def - definition file 
  6271.      example.c - C source file 
  6272.      example.mak - nmake file for Microsoft C 6.0 
  6273.      example2.mak - nmake file for IBM C Set/2 
  6274.  
  6275.  The "example.mak" file uses the Microsoft C 6.0 Compiler with the combined 
  6276.  library "llibcep.lib" and can be invoked with the following command: 
  6277.  
  6278.     nmake /F example.mak all
  6279.  
  6280.  The "example2.mak" file uses the IBM C Set/2 Compiler with the library 
  6281.  "dde4sbs.lib" and can be invoked with the following command: 
  6282.  
  6283.     nmake /F example2.mak all
  6284.  
  6285.  Note that compiler option "-DNSC32" is used in this make file to enable 32-bit 
  6286.  definitions in the NSCRSIGN.H header file as well as in EXAMPLE.C. 
  6287.  
  6288.  The definition file "example.def" defines EXAMPLE.EXE to be a 
  6289.  window-compatible protect mode executable. This program will request NSC to 
  6290.  perform a signon for user "USERID" with the password "PASSWORD" and using the 
  6291.  NSC configuration file. 
  6292.  
  6293.  EXAMPLE.DEF 
  6294.  
  6295.     NAME EXAMPLE WINDOWCOMPAT
  6296.     PROTMODE
  6297.  
  6298.  EXAMPLE.C 
  6299.  
  6300.     #include  <stdio.h>
  6301.     #include  <stdlib.h>
  6302.     #include  "nscrsign.h"
  6303.  
  6304.     void NSC_DLL_ENTRY
  6305.          dspmsg (short                  config_index,
  6306.                  short                  return_code,
  6307.                  short                  reserved,
  6308.                  unsigned char * NSCPTR message_text);
  6309.     int main (void);
  6310.  
  6311.     #ifdef    NSC32
  6312.     #pragma   linkage (dspmsg, far16 pascal)
  6313.     #endif
  6314.  
  6315.     int main ()
  6316.     {
  6317.        short rc;
  6318.        rc = NSCRSIGN ("userid", "password", NULL, NSC_LOGON, NULL, dspmsg);
  6319.        printf ("NSCRSIGN rc = %d\n", rc);
  6320.        return (0);
  6321.     }
  6322.  
  6323.     void NSC_DLL_ENTRY
  6324.          dspmsg (short                  config_index,
  6325.                  short                  return_code,
  6326.                  short                  reserved,
  6327.                  unsigned char * NSCPTR message_text)
  6328.     {
  6329.        (void) reserved;
  6330.        if (message_text[0])
  6331.        {
  6332.           printf ("%3d %3d  %s\n",
  6333.                   config_index, return_code, (void *) message_text);
  6334.        }
  6335.     }
  6336.  
  6337.  EXAMPLE.MAK 
  6338.  
  6339.     ALL: example.exe
  6340.  
  6341.     example.obj: example.c nscapi.h
  6342.        cl /c /AL /G2s /W4 /Ox example.c
  6343.  
  6344.     example.exe: example.obj nscapi.lib example.mak example.def
  6345.        link $*, $* /M /NOD /ST:12288, $*, llibcep+os2+nscrsign, $*;
  6346.  
  6347.  EXAMPLE2.MAK 
  6348.  
  6349.     ALL: example.exe
  6350.  
  6351.     example.obj: example.c nscapi.h
  6352.        ICC -c -Kb+ /DNSC32 example.c
  6353.  
  6354.     example.exe: example.obj nscapi.lib example.mak example.def
  6355.        link386 $*, $* /M /NOD /ST:12288, $*, dde4sbs+os2386+nscrsign, $*;
  6356.  
  6357.  
  6358. ΓòÉΓòÉΓòÉ 9. Messages ΓòÉΓòÉΓòÉ
  6359.  
  6360. All of the messages displayed by Network SignON Coordinator/2 are numbered, and 
  6361. they are ordered accordingly as follows: 
  6362.  
  6363.       Messages 100-138 
  6364.  
  6365.       Messages 140-153 
  6366.  
  6367.       Messages 154-178 
  6368.  
  6369.       Messages 180-309 
  6370.  
  6371.       Messages 401-419 
  6372.  
  6373.       Messages 420-445 
  6374.  
  6375.  Messages displayed by the operating system are described in 
  6376.  
  6377.       System Error Messages 
  6378.  
  6379.  Network SignON Coordinator/2 displays several different types of messages, 
  6380.  each containing different information to explain the situation. 
  6381.  
  6382.  An in-progress message is displayed as the action requested for each 
  6383.  configuration file definition begins execution. This message is: NSC0106  The 
  6384.  requested action is in progress. 
  6385.  
  6386.  Execution completion messages are displayed as the action requested for each 
  6387.  configuration file definition succeeds or fails. 
  6388.  
  6389.  Data Entry error messages are displayed when the NSC Signon panel is entered 
  6390.  (OK is selected). For the PM interface, these messages are displayed in a 
  6391.  pop-up window, which must be removed before continuing. For the full screen 
  6392.  interface, these messages are displayed in the message area, and are cleared 
  6393.  when the next key is pressed. In either case, the data entry field in error is 
  6394.  cleared, and the entry must be re-keyed. 
  6395.  
  6396.  Configuration error messages are displayed when NSC, NSCRSON, or NSCRSOFF is 
  6397.  executed if any problems exist in the NSC configuration file. Network SignON 
  6398.  Coordinator/2 will identify as many configuration errors as it can. Most of 
  6399.  the configuration error messages are followed immediately by the actual line 
  6400.  from the configuration file that is in error. "line <nn>" in the error 
  6401.  messages gives the actual line number in the NSC configuration file. 
  6402.  
  6403.  
  6404. ΓòÉΓòÉΓòÉ 9.1. Messages 100-138 ΓòÉΓòÉΓòÉ
  6405.  
  6406.  NSC0100   The requested action is complete. 
  6407.  
  6408.            Explanation: The indicated action has completed successfully. 
  6409.  
  6410.            Severity: Informational 
  6411.  
  6412.            User Response: None. 
  6413.  
  6414.  NSC0101   The requested action completed, but the password will expire soon. 
  6415.  
  6416.            Explanation: The signon has completed successfully. Your password 
  6417.            will expire shortly. For LOCAL, APPC, and LAN Server accounts, this 
  6418.            warning is returned when your password will expire within 5 days. 
  6419.            For host emulator sessions, this warning is returned when the host 
  6420.            notifies you at signon of this condition (as determined by the 
  6421.            search string in your host information file). 
  6422.  
  6423.            Severity: Warning 
  6424.  
  6425.            User Response: Change your password. 
  6426.  
  6427.  NSC0102   The user is already signed on. 
  6428.  
  6429.            Explanation: You attempted to signon but were already signed on. For 
  6430.            host emulator sessions or NetWare servers, you may be signed on 
  6431.            under a different User ID. For IBM LAN Servers, you may be signed on 
  6432.            to the requested domain under a different User ID, or you may be 
  6433.            signed on to a different domain. 
  6434.  
  6435.            Severity: Warning 
  6436.  
  6437.            User Response: None. 
  6438.  
  6439.  NSC0103   The user has already signed off. 
  6440.  
  6441.            Explanation: You attempted to signoff when you were not signed on. 
  6442.  
  6443.            Severity: Warning 
  6444.  
  6445.            User Response: None 
  6446.  
  6447.  NSC0104   The password change completed successfully, but Signon failed. 
  6448.  
  6449.            Explanation: RACF has changed the password, however it was then 
  6450.            unable to complete a signon process. 
  6451.  
  6452.            Severity: Warning 
  6453.  
  6454.            User Response: If you have any subsequent problem signing on at this 
  6455.            location, contact the security administrator of that location. 
  6456.  
  6457.  NSC0105   The requested action has completed successfully , but the password 
  6458.            has expired. 
  6459.  
  6460.            Explanation: The signon has completed successfully, but the password 
  6461.            has expired. This error can be returned for a local logon on a LAN 
  6462.            Server with local security. 
  6463.  
  6464.            Severity: Warning 
  6465.  
  6466.            User Response: Change your password. 
  6467.  
  6468.  NSC0106   The requested action is in progress. 
  6469.  
  6470.            Explanation: NSC has begun processing the action you just indicated. 
  6471.  
  6472.            Severity: Informational 
  6473.  
  6474.            User Response: None. 
  6475.  
  6476.  NSC0107   The password change completed successfully, but could not Signon 
  6477.            again. 
  6478.  
  6479.            Explanation: The password was changed and no user is currently 
  6480.            signed on. 
  6481.  
  6482.            To make the change, it was necessary to signon the user whose 
  6483.            password was changed. There was a different user signed on before 
  6484.            the request was processed and NSC could not sign the original user 
  6485.            back on. 
  6486.  
  6487.            NSC probably had the wrong password for the original user when it 
  6488.            tried the Signon. 
  6489.  
  6490.            Severity: Warning 
  6491.  
  6492.            User Response: If you need to sign the original user back on, make a 
  6493.            Signon request with the correct password. 
  6494.  
  6495.  NSC0108   The NSC operation is complete. 
  6496.  
  6497.            Explanation: The indicated operation has completed successfully. 
  6498.  
  6499.            Severity: Informational 
  6500.  
  6501.            User Response: None. 
  6502.  
  6503.  NSC0126   The requested action completed, with warnings. 
  6504.  
  6505.            Explanation: One or more signon requests have completed with warning 
  6506.            conditions. 
  6507.  
  6508.            Severity: Warning 
  6509.  
  6510.            User Response: Review messages preceding this one to determine the 
  6511.            locations with warnings and take any further actions needed. 
  6512.  
  6513.  NSC0127   The requested action completed, with errors. 
  6514.  
  6515.            Explanation: One or more signon requests have failed with error 
  6516.            conditions. 
  6517.  
  6518.            Severity: Error 
  6519.  
  6520.            User Response: Review messages preceding this one to determine which 
  6521.            locations failed and why. 
  6522.  
  6523.  NSC0128   Error executing NSCPM.EXE. 
  6524.  
  6525.            Explanation: NSC was unable to successfully execute the PM 
  6526.            executable NSCPM.EXE. This message is displayed if the session for 
  6527.            the NSCPM.EXE program could not be started. 
  6528.  
  6529.            Severity: Error 
  6530.  
  6531.            User Response: Make sure the NSCPM.EXE program is in the same 
  6532.            directory as the NSC.EXE program. Reinstall the NSC OS/2 Client if 
  6533.            necessary. 
  6534.  
  6535.  NSC0130   The user ID is not valid. 
  6536.  
  6537.            Explanation: The User ID was not recognized. 
  6538.  
  6539.            Severity: Error 
  6540.  
  6541.            User Response: Resubmit the request with the correct User ID. 
  6542.  
  6543.  NSC0131   The user ID or password is not valid. 
  6544.  
  6545.            Explanation: The action attempted in the preceding in-progress 
  6546.            message failed. Possible reasons for the failure could be: 
  6547.  
  6548.            - The user ID was not recognized. 
  6549.  
  6550.            - The current password entered for signon or change password was not 
  6551.            valid. 
  6552.  
  6553.            - The user ID is not allowed to signon at this time. 
  6554.  
  6555.            Severity: Error 
  6556.  
  6557.            User Response: Resubmit the request with the correct User ID and 
  6558.            password. It the failure persists, try the signon using the normal 
  6559.            signon facility for the location to more precisely identify the 
  6560.            problem. 
  6561.  
  6562.  NSC0132   The password is not valid. 
  6563.  
  6564.            Explanation: The current password entered for signon or change 
  6565.            password was not valid. 
  6566.  
  6567.            Severity: Error 
  6568.  
  6569.            User Response: Resubmit the request with the correct password. If 
  6570.            your passwords are out of sync, change your password. 
  6571.  
  6572.  NSC0133   The password has expired. 
  6573.  
  6574.            Explanation: Your password has expired. 
  6575.  
  6576.            Severity: Error 
  6577.  
  6578.            User Response: Change your password. 
  6579.  
  6580.  NSC0134   The password or the new password is not valid. 
  6581.  
  6582.            Explanation: Either the current password entered for change password 
  6583.            was not valid, or the new password was not accepted. If you are 
  6584.            certain you entered your current password correctly, the new 
  6585.            password was rejected because it violated some rule for passwords. 
  6586.  
  6587.            Severity: Error 
  6588.  
  6589.            User Response: Resubmit the request with the correct current 
  6590.            password and a different new password. If you successfully changed 
  6591.            the password to the offending password at other locations, you will 
  6592.            need to change the password at those locations to the new password. 
  6593.            Both of these requests can be submitted using NSC -- simply ignore 
  6594.            the errors from the locations where the operation was not necessary. 
  6595.  
  6596.  NSC0135   The password cannot be changed. 
  6597.  
  6598.            Explanation: The LAN Server will not let you change your password 
  6599.            for one of two reasons: 
  6600.  
  6601.            - The LAN Server administrator has specified that you are not 
  6602.            allowed to change your own password. 
  6603.  
  6604.            - The LAN Server administrator has specified a minimum password age 
  6605.            before the password may be changed. 
  6606.  
  6607.            Severity: Error 
  6608.  
  6609.            User Response: Contact your LAN Server administrator to remove the 
  6610.            restriction, or do not attempt to change your password on the LAN 
  6611.            Server at this time. 
  6612.  
  6613.  NSC0136   The password change request failed.  The new password is not valid. 
  6614.  
  6615.            Explanation: You attempted to change passwords, and the new password 
  6616.            was not accepted. The new password was rejected because it violated 
  6617.            some rule for passwords. 
  6618.  
  6619.            Severity: Error 
  6620.  
  6621.            User Response: Resubmit the request with a different new password. 
  6622.            If you successfully changed the password to the offending password 
  6623.            at other locations, you will need to change the password at those 
  6624.            locations to the new password. Both of these requests can be 
  6625.            submitted using NSC -- simply ignore the errors from the locations 
  6626.            where the operation was not necessary. 
  6627.  
  6628.  NSC0137   Error executing LOGON program. 
  6629.  
  6630.            Explanation: The installed level of UPM did not support APIs for 
  6631.            logon and logoff, so NSC attempted to execute the LOGON.EXE program. 
  6632.            An error occurred attempting this operation. The most likely causes 
  6633.            are: 
  6634.  
  6635.            - The appropriate software is not installed. 
  6636.  
  6637.            - The appropriate paths for the software were not set up. 
  6638.  
  6639.            Severity: Error 
  6640.  
  6641.            User Response: Either install the appropriate software, or do not 
  6642.            attempt to configure a LOCAL option. 
  6643.  
  6644.  NSC0138   Error executing LOGOFF program. 
  6645.  
  6646.            Explanation: The installed level of UPM did not support APIs for 
  6647.            logon and logoff, so NSC attempted to execute the LOGOFF.EXE 
  6648.            program. An error occurred attempting this operation. The most 
  6649.            likely causes are: 
  6650.  
  6651.            - The appropriate software is not installed. 
  6652.  
  6653.            - The appropriate paths for the software were not set up. 
  6654.  
  6655.            Severity: Error 
  6656.  
  6657.            User Response: Either install the appropriate software, or do not 
  6658.            attempt to configure a LOCAL option. 
  6659.  
  6660.  
  6661. ΓòÉΓòÉΓòÉ 9.2. Messages 140-153 ΓòÉΓòÉΓòÉ
  6662.  
  6663.  NSC0140   NETWKSTA.200 is not started. 
  6664.  
  6665.            Explanation: The NETWKSTA.200 device driver was not started. The 
  6666.            most likely cause is that the appropriate software support for 
  6667.            NETBIOS has not been installed. 
  6668.  
  6669.            Severity: Error 
  6670.  
  6671.            User Response: Install the appropriate software or remove the 
  6672.            configuration option from your configuration file. 
  6673.  
  6674.  NSC0141   The IBM LAN Requester is not started. 
  6675.  
  6676.            Explanation: The IBM LAN Requester is not started (or possibly not 
  6677.            installed). The request was not queued because the NSC Retry Process 
  6678.            was not started. If you were attempting to change passwords, your 
  6679.            password will be out of sync on the IBM LAN Server domain. If you 
  6680.            were attempting to signon, you will not be signed on to the IBM LAN 
  6681.            Server domain. 
  6682.  
  6683.            Severity: Error 
  6684.  
  6685.            User Response: Start the LAN Requester and resubmit the request. 
  6686.  
  6687.            If you start the NSC Retry Process at startup, failures such as this 
  6688.            can be queued and automatically retried when the LAN Requester has 
  6689.            started. 
  6690.  
  6691.  NSC0142   The IBM LAN Requester is not started.  The operation has been 
  6692.            queued. 
  6693.  
  6694.            Explanation: The IBM LAN Requester is not started. The request was 
  6695.            queued to be retried. The operation will be retried by the NSC Retry 
  6696.            Process (see NSCRETRY - Start the NSC Retry Process). If the IBM LAN 
  6697.            Requester is not started and you were attempting to change 
  6698.            passwords, your password will be out of sync at the location 
  6699.            indicated in the preceding in-progress message. If you were 
  6700.            attempting to signon, you will not be signed on to the location. 
  6701.  
  6702.            Severity: Warning 
  6703.  
  6704.            User Response: Start the IBM LAN Requester. Once the IBM LAN 
  6705.            Requester has been started, check the NSC Retry Process to verify 
  6706.            that the operation was successfully retried. If the retry was not 
  6707.            successful, resubmit the request. 
  6708.  
  6709.  NSC0143   Cannot change password on additional server. 
  6710.  
  6711.            Explanation: You attempted to change your password locally on a 
  6712.            workstation installed as an additional server for an IBM LAN Server. 
  6713.            The UPM account database for an additional server is replicated from 
  6714.            the IBM LAN Server domain controller, and passwords can only be 
  6715.            modified by changing the password on the IBM LAN Server domain 
  6716.            controller. 
  6717.  
  6718.            Severity: Error 
  6719.  
  6720.            User Response: If you configured a LANSERVER or DOMAIN option for 
  6721.            the IBM LAN Server domain controller that controls your additional 
  6722.            server, you can ignore this error, since the password change to the 
  6723.            domain controller is replicated to the additional server. Otherwise, 
  6724.            your password on the IBM LAN Server domain controller may be out of 
  6725.            sync. Use a LANSERVER option for the IBM LAN Server domain 
  6726.            controller instead of a LOCAL option for the additional server. 
  6727.  
  6728.  NSC0144   Unable to execute IBM NET program. 
  6729.  
  6730.            Explanation: NSC either attempted to call an IBM LAN Requester 
  6731.            function in OS/2 or attempted to execute its NSCNET.EXE program in 
  6732.            order to execute a NET LOGON or NET LOGOFF command for DOS. An error 
  6733.            occurred attempting this operation. The most likely causes are: 
  6734.  
  6735.            - The appropriate software is not installed. 
  6736.  
  6737.            - The appropriate paths for the software were not set up. 
  6738.  
  6739.            Severity: Error 
  6740.  
  6741.            User Response: Either install the appropriate software, or do not 
  6742.            attempt to configure a LANSERVER or DOMAIN option. 
  6743.  
  6744.  NSC0145   IBM LAN Server logon has active sessions. 
  6745.  
  6746.            Explanation: An IBM LAN Server logoff failed because some session 
  6747.            has a redirected drive as the current drive. The request was not 
  6748.            queued because the NSC Retry Process was not started. You are not 
  6749.            logged off of the domain. 
  6750.  
  6751.            Severity: Error 
  6752.  
  6753.            User Response: Determine which session is using the redirected drive 
  6754.            and change the current drive for the session. Resubmit the request. 
  6755.  
  6756.            If you start the NSC Retry Process at startup, failures such as this 
  6757.            can be queued and automatically retried later. 
  6758.  
  6759.  NSC0146   IBM LAN Server logon has active sessions.  The operation has been 
  6760.            queued. 
  6761.  
  6762.            Explanation: An IBM LAN Server logoff failed because some session 
  6763.            has a redirected drive as the current drive. NSC has queued your 
  6764.            request to be retried. The logoff will be retried by the NSC Retry 
  6765.            Process (see NSCRETRY - Start the NSC Retry Process). If the use of 
  6766.            the redirected drive by other sessions is not resolved, you will 
  6767.            remain logged on to the IBM LAN Server. 
  6768.  
  6769.            Severity: Warning 
  6770.  
  6771.            User Response: Determine which session is using the redirected drive 
  6772.            and change the current drive for the session. 
  6773.  
  6774.            Once the redirected drive is no longer in use, check the NSC Retry 
  6775.            Process to verify that the operation was successfully retried. If 
  6776.            the retry was not successful, resubmit the request. 
  6777.  
  6778.  NSC0147   <userid> is already signed on at another workstation. 
  6779.  
  6780.            Explanation: For IBM LAN Servers, you have specified 'multilogon = 
  6781.            no' in the IBMLAN.INI file in the C:\IBMLAN directory, and <userid> 
  6782.            is already signed on to this IBM LAN Server on another client 
  6783.            workstation. For host emulator sessions, <userid> is already signed 
  6784.            on to the host from another emulator session (possibly from another 
  6785.            workstation). 
  6786.  
  6787.            Severity: Error 
  6788.  
  6789.            User Response: For IBM LAN Servers, signoff the IBM LAN Server from 
  6790.            the other client workstation, or specify 'multilogon = yes' in the 
  6791.            IBMLAN.INI file in the C:\IBMLAN directory and restart the LAN 
  6792.            Requester services. For host emulator sessions, signoff the host 
  6793.            from the other emulator session. 
  6794.  
  6795.  NSC0148   No mailslots configured for IBM DOS LAN Requester. 
  6796.  
  6797.            Explanation: No mailslots have been configured for the IBM DOS LAN 
  6798.            Requester in the DOSLAN.INI file where DOS LAN Requester is 
  6799.            installed. Network SignON Coordinator/2 requires at least one 
  6800.            mailslot for the IBM DOS LAN Requester functions it uses. 
  6801.  
  6802.            Severity: Error 
  6803.  
  6804.            User Response: Edit the DOSLAN.INI file in the directory where IBM 
  6805.            DOS LAN Requester is installed and configure at least one mailslot. 
  6806.            For example, adding "/NMS:1" at the end of the configuration will 
  6807.            configure one mailslot. Restart the IBM DOS LAN Requester before 
  6808.            attempting to use Network SignON Coordinator/2. 
  6809.  
  6810.  NSC0150   NETBIOS is not installed. 
  6811.  
  6812.            Explanation: Network SignON Coordinator/2 could not connect to an 
  6813.            NSC Server because NETBIOS is not installed. NETBIOS is included as 
  6814.            part of PCLP or IBM DOS LAN Requester for DOS, or as part of IBM 
  6815.            OS/2 LAN Requester, IBM OS/2 LAN Server, or IBM OS/2 Communications 
  6816.            Manager. 
  6817.  
  6818.            Severity: Error 
  6819.  
  6820.            User Response: Install the appropriate software and restart the 
  6821.            machine before attempting to connect to an NSC Server. 
  6822.  
  6823.  NSC0151   NETBIOS Connection error (see LOG file). 
  6824.  
  6825.            Explanation: Network SignON Coordinator/2 could not connect to an 
  6826.            NSC Server to perform the requested action. If the action is 
  6827.            Initialization, an error may have occurred accessing a configuration 
  6828.            file or host information file on the NSC Server. The connection 
  6829.            request was not queued because the NSC Retry Process was not 
  6830.            started. If you were attempting to change passwords, your password 
  6831.            will be out of sync on hosts accessed from the NSC Server and local 
  6832.            accounts on the NSC Server. If you were attempting to signon, your 
  6833.            signon password was not verified at the APPC host connected to the 
  6834.            NSC Server. 
  6835.  
  6836.            Severity: Error 
  6837.  
  6838.            User Response: Examine the NETBIOS messages in the LOG files on the 
  6839.            NSC Client and NSC Server and follow the directions indicated in the 
  6840.            User Response for the message to resolve the NETBIOS problem. If you 
  6841.            were attempting to change passwords, resubmit the password change. 
  6842.  
  6843.            If you start the NSC Retry Process at startup, failures other than 
  6844.            Initialization can be queued and automatically retried when the NSC 
  6845.            Server or host becomes available. 
  6846.  
  6847.  NSC0152   NETBIOS Connection error (see LOG file).  The operation has been 
  6848.            queued. 
  6849.  
  6850.            Explanation: Network SignON Coordinator/2 could not connect to an 
  6851.            NSC Server to perform the requested action. NSC has queued the 
  6852.            connection request to be retried. The connection will be retried by 
  6853.            the NSC Retry Process (see NSCRETRY - Start the NSC Retry Process). 
  6854.            The operation will be retried once the connection retry is 
  6855.            successful. If the NETBIOS connection problem is not resolved and 
  6856.            you were attempting to change passwords, your password will be out 
  6857.            of sync on hosts accessed from the NSC Server and local accounts on 
  6858.            the NSC Server.  If you were attempting to signon, your signon 
  6859.            password was not verified at the APPC host connected to the NSC 
  6860.            Server. 
  6861.  
  6862.            Severity: Warning 
  6863.  
  6864.            User Response: Examine the NETBIOS messages in the LOG file and 
  6865.            follow the directions indicated in the User Response for the message 
  6866.            to resolve the NETBIOS problem. If you were attempting to change 
  6867.            passwords, once the NETBIOS connection is established, check the NSC 
  6868.            Retry Process to verify that the connection was successfully 
  6869.            retried. If the retry was not successful, resubmit the password 
  6870.            change. 
  6871.  
  6872.  NSC0153   <location> is not available. 
  6873.  
  6874.            Explanation: The configured location <location> did not respond to 
  6875.            the preceding NSC request. The computer location is probably down 
  6876.            (i.e., powered off, software not started, etc.), too busy to 
  6877.            respond, or the location name is incorrectly specified in the NSC 
  6878.            configuration file. 
  6879.  
  6880.            The request was not queued because the NSC Retry Process was not 
  6881.            started. If you were attempting to change passwords, your password 
  6882.            was not changed at the location and will be out of sync with your 
  6883.            other locations. If you were attempting to signon, you will not be 
  6884.            signed on to the location. 
  6885.  
  6886.            Severity: Error 
  6887.  
  6888.            User Response: Verify the location name <location> is correct. Check 
  6889.            the following based on the type of location: 
  6890.  
  6891.            - LANSERVER or NSC Server, machine is powered on and software 
  6892.            started. 
  6893.  
  6894.            - HOST, host computer is available. 
  6895.  
  6896.            - LOCAL or NODE, the local UPM was probably busy... retry the 
  6897.            request. 
  6898.  
  6899.            Resolve the problem and resubmit the request. If the location is an 
  6900.            NSC Server, the log file on the NSC Server may help in determining 
  6901.            the problem. 
  6902.  
  6903.            If you start the NSC Retry Process at startup, failures other than 
  6904.            Initialization can be queued and automatically retried when the 
  6905.            location becomes available. 
  6906.  
  6907.  
  6908. ΓòÉΓòÉΓòÉ 9.3. Messages 154-178 ΓòÉΓòÉΓòÉ
  6909.  
  6910.  NSC0154   <location> is not available.  The operation has been queued. 
  6911.  
  6912.            Explanation: The configured location <location> did not respond to 
  6913.            the preceding NSC request. The computer location is probably down 
  6914.            (i.e., powered off, software not started, etc.), too busy to 
  6915.            respond, or the location name is incorrectly specified in the NSC 
  6916.            configuration file. 
  6917.  
  6918.            The request was queued to be retried. The operation will be retried 
  6919.            by the NSC Retry Process (see NSCRETRY - Start the NSC Retry 
  6920.            Process). If you were attempting to change passwords, your password 
  6921.            was not changed at the location and will be out of sync with your 
  6922.            other locations. If you were attempting to signon, you will not be 
  6923.            signed on to the location. 
  6924.  
  6925.            Severity: Warning 
  6926.  
  6927.            User Response: Verify the location name <location> is correct. Check 
  6928.            the following based on the type of location: 
  6929.  
  6930.            - LANSERVER or NSC Server, machine is powered on and software 
  6931.            started. 
  6932.  
  6933.            - HOST, host computer is available. 
  6934.  
  6935.            - LOCAL or NODE, the local UPM was probably busy... retry the 
  6936.            request. 
  6937.  
  6938.            If the location is an NSC Server, the log file on the NSC Server may 
  6939.            help in determining the problem. 
  6940.  
  6941.            Resolve the problem before the NSC Retry Process reaches its retry 
  6942.            limit. Once the problem has been resolved, check the NSC Retry 
  6943.            Process to verify that the operation was successfully retried. If 
  6944.            the retry was not successful, resubmit the request. 
  6945.  
  6946.  NSC0160   Communications Manager is not started. 
  6947.  
  6948.            Explanation: Communications Manager has not been started or had not 
  6949.            completed its startup when your request was processed. The request 
  6950.            was not queued because the NSC Retry Process was not started. If you 
  6951.            were attempting to change passwords, your password will be out of 
  6952.            sync on the host. If you were attempting to signon, you will not be 
  6953.            signed on to the host. 
  6954.  
  6955.            Severity: Error 
  6956.  
  6957.            User Response: Start Communications Manager and retry your request. 
  6958.  
  6959.            If you start the NSC Retry Process at startup, failures such as this 
  6960.            can be queued and automatically retried when the NSC Server or host 
  6961.            becomes available. 
  6962.  
  6963.  NSC0161   Communications Manager is not started.  The operation has been 
  6964.            queued. 
  6965.  
  6966.            Explanation: Communications Manager has not been started or had not 
  6967.            completed its startup when your request was processed. NSC has 
  6968.            queued your request to be retried. The operation will be retried by 
  6969.            the NSC Retry Process (see NSCRETRY - Start the NSC Retry Process). 
  6970.            If the problem with the host is not resolved, and you were 
  6971.            attempting to change passwords, your password will be out of sync on 
  6972.            the host; if you were attempting to signon, you will not be signed 
  6973.            on to the host. 
  6974.  
  6975.            Severity: Warning 
  6976.  
  6977.            User Response: Start Communications Manager. 
  6978.  
  6979.            Once Communications Manager has started, check the NSC Retry Process 
  6980.            to verify that the operation was successfully retried. If the retry 
  6981.            was not successful, resubmit the request. 
  6982.  
  6983.  NSC0162   APPC is not installed. 
  6984.  
  6985.            Explanation: APPC has not been installed with Communications 
  6986.            Manager. 
  6987.  
  6988.            Severity: Error 
  6989.  
  6990.            User Response: Contact the person who installed Communications 
  6991.            Manager and have them assist you in determining whether or not APPC 
  6992.            was installed with Communications Manager. 
  6993.  
  6994.  NSC0163   APPC is not available. 
  6995.  
  6996.            Explanation: APPC has not been installed or configured with 
  6997.            Communications Manager. 
  6998.  
  6999.            Severity: Error 
  7000.  
  7001.            User Response: Contact the person who installed Communications 
  7002.            Manager and have them assist you in determining whether or not APPC 
  7003.            was installed with Communications Manager. 
  7004.  
  7005.  NSC0164   APPC allocate error. 
  7006.  
  7007.            Explanation: APPC has indicated an allocation error that should not 
  7008.            be retried. 
  7009.  
  7010.            Severity: Error 
  7011.  
  7012.            User Response: The most likely cause for this error is a mismatch in 
  7013.            your APPC definitions and those made at the Host computer. You 
  7014.            should: 
  7015.  
  7016.            - Contact the person who has installed and configured NSC for 
  7017.            assistance. 
  7018.  
  7019.            - Review the Communications Manager Message file for any additional 
  7020.            information. 
  7021.  
  7022.            - See Problem Determination and make sure the DEBUG option is 
  7023.            enabled as it may produce additional information to help pinpoint 
  7024.            the problem. 
  7025.  
  7026.  NSC0165   APPC Partner LU is not defined. 
  7027.  
  7028.            Explanation: An APPC PLU could not be found or is not configured 
  7029.            correctly. 
  7030.  
  7031.            Severity: Error 
  7032.  
  7033.            User Response: You should have seen a more detailed message 
  7034.            preceding this which will better determine the cause. See Problem 
  7035.            Determination on how to locate the LOG, if it is not on your screen. 
  7036.  
  7037.  NSC0166   Communications Manager is not installed. 
  7038.  
  7039.            Explanation: NSC could not access the host because Communications 
  7040.            Manager is not installed. 
  7041.  
  7042.            Severity: Error 
  7043.  
  7044.            User Response: Install Communications Manager and restart the 
  7045.            machine before attempting to access a host. 
  7046.  
  7047.  NSC0167   Communications Manager must be restarted. 
  7048.  
  7049.            Explanation: NSC could not access the host because Communications 
  7050.            Manager has experienced a fatal error. 
  7051.  
  7052.            Severity: Error 
  7053.  
  7054.            User Response: Restart Communications Manager and retry the request. 
  7055.  
  7056.  NSC0170   EHLLAPI is not installed. 
  7057.  
  7058.            Explanation: EHLLAPI has not been installed or configured correctly. 
  7059.  
  7060.            Severity: Error 
  7061.  
  7062.            User Response: Refer to Emulator Considerations, and the emulator's 
  7063.            support information to determine how to install and configure 
  7064.            EHLLAPI support. 
  7065.  
  7066.  NSC0171   Host emulator session is in use. 
  7067.  
  7068.            Explanation: The host emulator session is in use by another user. 
  7069.            NSC is not able to access it. The request was not queued because the 
  7070.            NSC Retry Process was not started. If you were attempting to change 
  7071.            passwords, your password will be out of sync on the host. If you 
  7072.            were attempting to signon, you will not be signed on to the host. 
  7073.  
  7074.            Severity: Error 
  7075.  
  7076.            User Response: Try the operation again at a later time. 
  7077.  
  7078.            If you start the NSC Retry Process at startup, failures such as this 
  7079.            can be queued and automatically retried when the host session 
  7080.            becomes available. 
  7081.  
  7082.  NSC0172   Host emulator session is in use.  The operation has been queued. 
  7083.  
  7084.            Explanation: The host emulator session is in use by another user. 
  7085.            NSC is not able to access it. NSC has queued your request to be 
  7086.            retried. The operation will be retried by the NSC Retry Process (see 
  7087.            NSCRETRY - Start the NSC Retry Process). If the host emulator 
  7088.            session does not become available, and you were attempting to change 
  7089.            passwords, your password will be out of sync on the host; if you 
  7090.            were attempting to signon, you will not be signed on to the host. 
  7091.  
  7092.            Severity: Warning 
  7093.  
  7094.            User Response: Once the host emulator session has become available, 
  7095.            check the NSC Retry Process to verify that the operation was 
  7096.            successfully retried. If the retry was not successful, resubmit the 
  7097.            request. 
  7098.  
  7099.  NSC0173   Host info file open/access error. 
  7100.  
  7101.            Explanation: The host information file was not found, or could not 
  7102.            be accessed. 
  7103.  
  7104.            Severity: Error 
  7105.  
  7106.            User Response: Refer to the relevant log file for more detailed 
  7107.            information. (See Problem Determination for more details). Review 
  7108.            the ParseHIF function's log messages near the end of the log file. 
  7109.            The last ParseHIF log message will tell you the host information 
  7110.            file name, the line number, and the column number where the file 
  7111.            open/access error was encountered. Verify the host information file 
  7112.            is named correctly, resides in the correct directory, and can be 
  7113.            accessed successfully. 
  7114.  
  7115.  NSC0174   Host emulator session id is invalid. 
  7116.  
  7117.            Explanation: The host emulator session id specified in the host 
  7118.            information file's configuration section does not correspond to a 
  7119.            configured/started host emulator session. 
  7120.  
  7121.            Severity: Error 
  7122.  
  7123.            User Response: Verify that the one character session id specified in 
  7124.            the host information file's configuration section corresponds to a 
  7125.            host emulator session that has been configured/started. 
  7126.  
  7127.  NSC0175   Host info file contains a syntax error. 
  7128.  
  7129.            Explanation: The host information file contains a syntax error (for 
  7130.            example, a misspelled keyword, a missing comma, a missing double 
  7131.            quote for a string, etc.). 
  7132.  
  7133.            Severity: Error 
  7134.  
  7135.            User Response: Refer to the relevant log file for more detailed 
  7136.            information. (See Problem Determination for more details). Review 
  7137.            the ParseHIF function's log messages near the end of the log file. 
  7138.            The last ParseHIF log message will tell you the host information 
  7139.            file name, the line number, and the column number of syntax error. 
  7140.            The contents of the host information file line in error will appear 
  7141.            in the log file on a following line. Edit the host information file, 
  7142.            correcting the syntax error. 
  7143.  
  7144.  NSC0176   Host info file contains a parameter that is not valid. 
  7145.  
  7146.            Explanation: The host information file contains a parameter that is 
  7147.            not valid. 
  7148.  
  7149.            Severity: Error 
  7150.  
  7151.            User Response: Refer to the relevant log file for more detailed 
  7152.            information. (See Problem Determination for more details). Review 
  7153.            the ParseHIF function's log messages near the end of the log file. 
  7154.            The last ParseHIF log message will tell you the host information 
  7155.            file name, the line number, and the column number of the parameter 
  7156.            in error. The contents of the host information file line in error 
  7157.            will appear in the log file on a following line. Edit the host 
  7158.            information file, correcting the parameter. 
  7159.  
  7160.  NSC0178   Host info file exceeds maximum line length. 
  7161.  
  7162.            Explanation: The host information file contains a line that exceeds 
  7163.            the maximum line length allowed. 
  7164.  
  7165.            Severity: Error 
  7166.  
  7167.            User Response: Refer to the relevant log file for more detailed 
  7168.            information. (See Problem Determination for more details). Review 
  7169.            the ParseHIF function's log messages near the end of the log file. 
  7170.            The last ParseHIF log message will tell you the host information 
  7171.            file name, the line number, and the column number of the line 
  7172.            exceeding the maximum length allowed. The contents of the host 
  7173.            information file line in error will appear in the log file on a 
  7174.            following line. Edit the host information file, reducing the length 
  7175.            of the line in error. 
  7176.  
  7177.  
  7178. ΓòÉΓòÉΓòÉ 9.4. Messages 180-309 ΓòÉΓòÉΓòÉ
  7179.  
  7180.  NSC0180   Cannot start from the host session's current screen. 
  7181.  
  7182.            Explanation: The host emulator session is not in one of the 
  7183.            specified start screens for the requested signon operation. If you 
  7184.            were attempting to change passwords, your password will be out of 
  7185.            sync on the host. If you were attempting to signon, you will not be 
  7186.            signed on to the host. 
  7187.  
  7188.            Severity: Error 
  7189.  
  7190.            User Response: Check the host emulator session. If the host is in a 
  7191.            valid start screen for the requested operation, edit the host 
  7192.            information file, adding a corresponding new sequence of screen 
  7193.            definitions, or correct an existing one. Otherwise, reset the host 
  7194.            emulator session to a valid start screen and try the operation 
  7195.            again. 
  7196.  
  7197.  NSC0181   Cannot continue from the host session's current screen. 
  7198.  
  7199.            Explanation: The host emulator session did not enter one of the 
  7200.            required screens for the requested signon operation. Thus, the 
  7201.            operation cannot be continued. 
  7202.  
  7203.            Severity: Error 
  7204.  
  7205.            User Response: Refer to the relevant log file for more detailed 
  7206.            information. (See Problem Determination for more details). Review 
  7207.            the PerfAct function's log messages near the end of the log file. 
  7208.            The last PerfAct log message will tell you the host screen that was 
  7209.            required but not encountered. 
  7210.  
  7211.            Edit the host information file, adding a corresponding new screen 
  7212.            definition, or correcting an existing one for the requested 
  7213.            operation. If the screen definition already exists and is correct, 
  7214.            you may need to increase the value of the configuration option 
  7215.            HOSTWAIT until NSC waits long enough for the host to finish changing 
  7216.            screens. 
  7217.  
  7218.            Check the host emulator session. If the host has not already been 
  7219.            reset, reset it to a valid start screen. 
  7220.  
  7221.  NSC0182   No host screen definitions configured. 
  7222.  
  7223.            Explanation: The host information file does not contain any screen 
  7224.            definitions for the requested operation. 
  7225.  
  7226.            Severity: Error 
  7227.  
  7228.            User Response: Edit the host information file, adding the required 
  7229.            screen definitions for the desired operation. 
  7230.  
  7231.  NSC0183   No available host emulator session. 
  7232.  
  7233.            Explanation: The host emulator session ids specified in the host 
  7234.            information file's configuration section are all either in use, 
  7235.            invalid, or not available. 
  7236.  
  7237.            Severity: Error 
  7238.  
  7239.            User Response: Modify the session ids specified in the host 
  7240.            information file's configuration section, or make sure the desired 
  7241.            host emulator session is configured/started. 
  7242.  
  7243.  NSC0190   An unexpected system error was encountered. 
  7244.  
  7245.            Explanation: An internal NSC function detected a software failure. 
  7246.  
  7247.            Severity: Error 
  7248.  
  7249.            User Response: Submit an NSC problem report along with your NSC 
  7250.            LOGs. 
  7251.  
  7252.  NSC0191   Not enough memory is available. 
  7253.  
  7254.            Explanation: Not enough memory is available to perform the desired 
  7255.            operation. 
  7256.  
  7257.            Severity: Error 
  7258.  
  7259.            User Response: Free up system resources. Resubmit the request. 
  7260.  
  7261.  NSC0192   User Exit could not be executed. 
  7262.  
  7263.            Explanation: NSC was unable to successfully execute the user exit 
  7264.            routine for the location just processed. This message is displayed 
  7265.            in DOS if the exit routine could not be started, or in OS/2 if the 
  7266.            session for a user exit program could not be started. 
  7267.  
  7268.            Severity: Error 
  7269.  
  7270.            User Response: Review the preceding messages to determine the 
  7271.            location definition being processed. Look in the configuration file 
  7272.            to determine the user exit program or command file specified for the 
  7273.            definition. Check the file name specification and make sure the 
  7274.            program or command file is in the path. 
  7275.  
  7276.  NSC0193   User Exit failed.  Return code = <rc>. 
  7277.  
  7278.            Explanation: The user exit routine for the location just processed 
  7279.            return the return code rc to NSC. 
  7280.  
  7281.            Severity: Unknown 
  7282.  
  7283.            User Response: Review the preceding messages to determine the 
  7284.            location definition being processed. Look in the configuration file 
  7285.            to determine the user exit program or command file specified for the 
  7286.            definition. Consult your administrator if necessary to determine the 
  7287.            cause of the error. 
  7288.  
  7289.  NSC0200   You are not authorized to Signon at this time of day. 
  7290.  
  7291.            Explanation: You attempted to Signon in a time period which you have 
  7292.            not been authorized by the system administrator. 
  7293.  
  7294.            Severity: Error 
  7295.  
  7296.            User Response: Contact the system administrator to verify your 
  7297.            authorization to use the LAN Server. This may have been caused by an 
  7298.            incorrect clock setting on the server. 
  7299.  
  7300.  NSC0201   You are not authorized from this computer. 
  7301.  
  7302.            Explanation: You attempted to Signon from a computer which you have 
  7303.            not been authorized by the system administrator. 
  7304.  
  7305.            Severity: Error 
  7306.  
  7307.            User Response: Contact the system administrator to verify your 
  7308.            authorization. 
  7309.  
  7310.  NSC0202   Your account is empty. 
  7311.  
  7312.            Explanation: Your account either has a zero balance, no credit, or 
  7313.            it has been disabled by the system administrator. 
  7314.  
  7315.            Severity: Error 
  7316.  
  7317.            User Response: Contact the system administrator to reset your 
  7318.            account. 
  7319.  
  7320.  NSC0220   Novell NetWare not installed. 
  7321.  
  7322.            Explanation: NSC cannot access Novell NetWare to process the 
  7323.            request. 
  7324.  
  7325.            Severity: Error 
  7326.  
  7327.            User Response: Install NetWare or change the LANSERVER definition in 
  7328.            the configuration file to not specify NOVELL. 
  7329.  
  7330.  NSC0301   The User ID is too short or was not entered. 
  7331.  
  7332.            Explanation: Either you failed to enter your User ID, or you entered 
  7333.            a User ID that is shorter than the minimum length specified in the 
  7334.            configuration file for the MinUIDLen definition. 
  7335.  
  7336.            Severity: Error 
  7337.  
  7338.            User Response: Enter the correct User ID, or exit Network SignON 
  7339.            Coordinator/2 and modify the MinUIDLen option in the configuration 
  7340.            file. 
  7341.  
  7342.  NSC0302   The password is too short or was not entered. 
  7343.  
  7344.            Explanation: Either you failed to enter your password, or you 
  7345.            entered a password that is shorter than the minimum length specified 
  7346.            in the configuration file for the MinPWLen definition. 
  7347.  
  7348.            Severity: Error 
  7349.  
  7350.            User Response: Enter the correct password, or choose a different new 
  7351.            password, or exit Network SignON Coordinator/2 and modify the 
  7352.            MinPWLen option in the configuration file. 
  7353.  
  7354.  NSC0303   The User ID is too long. 
  7355.  
  7356.            Explanation: You entered a User ID that is longer than the maximum 
  7357.            length specified in the configuration file for the MaxUIDLen 
  7358.            definition. 
  7359.  
  7360.            Severity: Error 
  7361.  
  7362.            User Response: Enter the correct User ID, or exit Network SignON 
  7363.            Coordinator/2 and modify the MaxUIDLen option in the configuration 
  7364.            file. 
  7365.  
  7366.  NSC0304   The password is too long. 
  7367.  
  7368.            Explanation: You entered a password that is longer than the maximum 
  7369.            length specified in the configuration file for the MaxPWLen 
  7370.            definition. 
  7371.  
  7372.            Severity: Error 
  7373.  
  7374.            User Response: Enter the correct password, or choose a different new 
  7375.            password, or exit Network SignON Coordinator/2 and modify the 
  7376.            MaxPWLen option in the configuration file. 
  7377.  
  7378.  NSC0305   The new and confirmation passwords are not the same. 
  7379.  
  7380.            Explanation: You entered a Confirmation Password that did not match 
  7381.            the entered New Password. Both entries must be identical. 
  7382.  
  7383.            Severity: Error 
  7384.  
  7385.            User Response: Enter the new password correctly in both fields. 
  7386.  
  7387.  NSC0306   The current and new passwords are the same. 
  7388.  
  7389.            Explanation: You entered a New Password that was identical to the 
  7390.            entered Current Password. 
  7391.  
  7392.            Severity: Error 
  7393.  
  7394.            User Response: Enter a new password that is different than the 
  7395.            current password. 
  7396.  
  7397.  NSC0307   User ID or password contains characters that are not valid. 
  7398.  
  7399.            Explanation: You typed a character that is not valid in the User ID 
  7400.            or password command line parameter. For the User ID, any graphic 
  7401.            ASCII character is valid (ASCII controls are not valid). For 
  7402.            passwords, each character must either be alphanumeric or in the 
  7403.            character set specified by the CHARSET definition in the 
  7404.            configuration file (or in the default character set (#, @ or $) if 
  7405.            the CHARSET definition is not specified in the configuration file). 
  7406.  
  7407.            Severity: Error 
  7408.  
  7409.            User Response: Restart the command with a valid User ID and/or 
  7410.            password. 
  7411.  
  7412.  NSC0308   Too many command line parameters specified. 
  7413.  
  7414.            Explanation: You attempted to execute either 
  7415.  
  7416.            - "NSC ON" with more than two additional command line parameters 
  7417.            (valid parameters for ON are User ID and Password), or 
  7418.  
  7419.            - "NSC OFF" with more than one additional command line parameters 
  7420.            (the only valid parameter for OFF is User ID), or 
  7421.  
  7422.            - "NSC CHGPW" with more than three additional command line 
  7423.            parameters (valid parameters for CHGPW are User ID, Current Password 
  7424.            and New Password). 
  7425.  
  7426.            Severity: Error 
  7427.  
  7428.            User Response: Restart the command with a valid number of command 
  7429.            line parameters. 
  7430.  
  7431.  NSC0309   A command line parameter that is not valid <parm> was specified. 
  7432.  
  7433.            Explanation: You specified something other than "ON", "OFF" or 
  7434.            "CHGPW" as the first command line parameter. 
  7435.  
  7436.            Severity: Error 
  7437.  
  7438.            User Response: Restart the command with a valid parameter. 
  7439.  
  7440.  
  7441. ΓòÉΓòÉΓòÉ 9.5. Messages 401-419 ΓòÉΓòÉΓòÉ
  7442.  
  7443.  NSC0401   Actions are not available because of errors. 
  7444.  
  7445.            Explanation: NSC encountered errors during initialization, or 
  7446.            detected a configuration error. 
  7447.  
  7448.            Severity: Error 
  7449.  
  7450.            User Response: Close the window to exit NSC. Correct the errors and 
  7451.            restart the program. 
  7452.  
  7453.  NSC0403   <pppp> not allowed with definition on line <nn> of NSC config file. 
  7454.  
  7455.            Explanation: One of the following has occurred: 
  7456.  
  7457.            - You specified the APPC, EMULATOR or EHLL parameter for a 
  7458.            LANSERVER, DOMAIN, LOCAL, NODE or SERVER definition. These 
  7459.            parameters can be used only with a HOST definition. 
  7460.  
  7461.            - You specified the IBM or NOVELL parameter for a DOMAIN, HOST, 
  7462.            LOCAL, NODE or SERVER definition. These parameters can be used only 
  7463.            with a LANSERVER definition. 
  7464.  
  7465.            - You specified a HIF parameter or HIF Variable parameter for a 
  7466.            LANSERVER, DOMAIN, LOCAL, NODE or SERVER definition, or a HOST 
  7467.            definition of type APPC. The HIF parameter and HIF Variable 
  7468.            parameter are only allowed with a HOST definition of type EMULATOR. 
  7469.  
  7470.            Severity: Error 
  7471.  
  7472.            User Response: Delete the parameter or change the definition. 
  7473.  
  7474.  NSC0404   <def> definition on line <nn> of NSC config file not allowed after a 
  7475.            SERVER definition. 
  7476.  
  7477.            Explanation: You placed a NODE, LANSERVER or DOMAIN definition after 
  7478.            a SERVER definition in your configuration file. Definitions for node 
  7479.            logons or LAN Servers can be configured only for the local 
  7480.            workstation, and must precede all SERVER definitions. 
  7481.  
  7482.            Severity: Error 
  7483.  
  7484.            User Response: For node logons, place the NODE definition preceding 
  7485.            all SERVER definitions. For password synchronization to the LAN 
  7486.            Server, place the LANSERVER definition preceding all SERVER 
  7487.            definitions; the definition would then cause NSC to process password 
  7488.            changes for the LAN Server from the local workstation. 
  7489.  
  7490.  NSC0405   Configuration file <config-file> was not found. 
  7491.  
  7492.            Explanation: The configuration file identified by config-file was 
  7493.            not found in the current directory or in the DPATH. 
  7494.  
  7495.            Severity: Error 
  7496.  
  7497.            User Response: Either change the current directory before executing 
  7498.            or calling NSC or modify the DPATH. 
  7499.  
  7500.  NSC0406   EXIT or EXITID not allowed with SERVER definition on line <nn> of 
  7501.            NSC config file. 
  7502.  
  7503.            Explanation: You specified an EXIT or EXITID parameter on a SERVER 
  7504.            definition. No signon or password synchronization is associated with 
  7505.            the SERVER definition. Because no action is taken that can be passed 
  7506.            on to an exit routine, the EXIT or EXITID parameter is not allowed. 
  7507.  
  7508.            Severity: Error 
  7509.  
  7510.            User Response: Remove the EXIT or EXITID parameter from the SERVER 
  7511.            definition. If a user exit needs the results of access to the local 
  7512.            UPM on the Server, specify the EXIT or EXITID parameter on a LOCAL 
  7513.            definition following the SERVER definition. 
  7514.  
  7515.  NSC0407   Configuration definition on line <nn> of NSC config file is not 
  7516.            valid. 
  7517.  
  7518.            Explanation: NSC did not recognize the definition on the indicated 
  7519.            line from the configuration file. 
  7520.  
  7521.            Severity: Error 
  7522.  
  7523.            User Response: Either correct the spelling of the definition, or 
  7524.            start the line with an asterisk if the line should be ignored. 
  7525.  
  7526.  NSC0408   Definition or parameter value <vvvv> on line <nn> of NSC config file 
  7527.            is not valid. 
  7528.  
  7529.            Explanation: The value vvvv is outside the range of valid values for 
  7530.            this definition or parameter on the indicated line from the 
  7531.            configuration file For Menu Parameter Length definitions (MinUIDLen, 
  7532.            MaxUIDLen, MinPWLen, and MaxPWLen), valid values are 1 to 8. For 
  7533.            Beep and ConfirmExit definitions, valid values or ON and OFF. For 
  7534.            the ID parameter, valid values are 1 to 40. For the ExitID 
  7535.            parameter, the value must match a value specified in an ID parameter 
  7536.            for an Exit definition. 
  7537.  
  7538.            Severity: Error 
  7539.  
  7540.            User Response: Correct the value. 
  7541.  
  7542.  NSC0409   The parameter <pppp> on line <nn> of NSC config file is not valid. 
  7543.  
  7544.            Explanation: The parameter pppp is not a valid parameter for this 
  7545.            definition. 
  7546.  
  7547.            - For LOCAL definitions, the only valid parameters are ON, USERID, 
  7548.            EXIT and EXITID. 
  7549.  
  7550.            - For NODE definitions, the only valid parameters are ON, NAME, 
  7551.            USERID, EXIT and EXITID. 
  7552.  
  7553.            - For LANSERVER definitions, the only valid parameters are ON, NAME, 
  7554.            IBM, NOVELL, USERID, EXIT and EXITID. 
  7555.  
  7556.            - For DOMAIN definitions, the only valid parameters are ON, NAME, 
  7557.            USERID, EXIT and EXITID. 
  7558.  
  7559.            - For HOST definitions, the only valid parameters are ON, NAME, 
  7560.            APPC, EMULATOR, USERID, EXIT and EXITID. 
  7561.  
  7562.            - For SERVER definitions, the only valid parameter is NAME. 
  7563.  
  7564.            - For EXIT definitions, the only valid parameters are NAME, ID, FG, 
  7565.            BG, WAIT, NOWAIT, NOMSGS, MSGS, RC, and NORC. 
  7566.  
  7567.            - For GETDEFS definitions, the only valid parameter is SERVER. 
  7568.  
  7569.            Severity: Error 
  7570.  
  7571.            User Response: Remove the invalid text from the definition, or 
  7572.            insert a space in the definition prior to the text that should be 
  7573.            ignored. 
  7574.  
  7575.  NSC0410   LOCAL definition not allowed before SERVER definition in DOS on line 
  7576.            <nn> of NSC config file. 
  7577.  
  7578.            Explanation: You defined a LOCAL definition preceding a SERVER 
  7579.            definition on the DOS Client. NSC does not support local signons for 
  7580.            your NSC DOS Client. 
  7581.  
  7582.            Severity: Error 
  7583.  
  7584.            User Response: Remove the LOCAL definition. A NODE definition is 
  7585.            valid on a DOS Client and can be used to run a User Exit routine. 
  7586.  
  7587.  NSC0411   MINPWLEN cannot be greater that MAXPWLEN. 
  7588.  
  7589.            Explanation: You specified a value for the minimum length of a 
  7590.            password (MINPWLEN) that is greater than the value you specified for 
  7591.            the maximum length of a password (MAXPWLEN). 
  7592.  
  7593.            Severity: Error 
  7594.  
  7595.            User Response: Either change the MINPWLEN Option value to be less 
  7596.            than or equal to MAXPWLEN (it must remain greater than or equal to 
  7597.            1), or change the MAXPWLEN Option value to be greater than or equal 
  7598.            to MINPWLEN (it must remain less than or equal to 8). 
  7599.  
  7600.  NSC0412   MINUIDLEN cannot be greater that MAXUIDLEN. 
  7601.  
  7602.            Explanation: You specified a value for the minimum length of a User 
  7603.            ID (MINUIDLEN) that is greater than the value you specified for the 
  7604.            maximum length of a User ID (MAXUIDLEN). 
  7605.  
  7606.            Severity: Error 
  7607.  
  7608.            User Response: Either change the MINUIDLEN Option value to be less 
  7609.            than or equal to MAXUIDLEN (it must remain greater than or equal to 
  7610.            1), or change the MAXUIDLEN Option value to be greater than or equal 
  7611.            to MINUIDLEN (it must remain less than or equal to 8). 
  7612.  
  7613.  NSC0413   More than one LANSERVER (type IBM) or DOMAIN definition with the ON 
  7614.            option on line <nn> of NSC config file. 
  7615.  
  7616.            Explanation: You specified more than one IBM LANSERVER or DOMAIN 
  7617.            definition with the ON parameter. Only one IBM LAN Server logon may 
  7618.            be active at a time for a workstation. 
  7619.  
  7620.            Severity: Error 
  7621.  
  7622.            User Response: Remove the ON parameter from one of the LANSERVER or 
  7623.            DOMAIN definitions to allow password synchronization or delete one 
  7624.            of the LANSERVER or DOMAIN definitions. 
  7625.  
  7626.  NSC0414   More than one LOCAL definition with ON parameter on line <nn> of NSC 
  7627.            config file. 
  7628.  
  7629.            Explanation: You specified more than one LOCAL definition with the 
  7630.            ON parameter for the local workstation. Only one Local Logon may be 
  7631.            active for a session. 
  7632.  
  7633.            Severity: Error 
  7634.  
  7635.            User Response: Remove the ON parameter from one of the LOCALs 
  7636.            definition to allow password synchronization or delete one of the 
  7637.            LOCAL definitions. 
  7638.  
  7639.  NSC0415   NAME not allowed with LOCAL definition on line <nn> of NSC config 
  7640.            file. 
  7641.  
  7642.            Explanation: A NAME parameter was specified for a LOCAL definition. 
  7643.            For LOCAL definitions, the only valid parameters are ON, USERID and 
  7644.            EXIT. 
  7645.  
  7646.            Severity: Error 
  7647.  
  7648.            User Response: Remove the NAME parameter from the LOCAL definition. 
  7649.            To specify the User ID for the LOCAL definition, use the USERID 
  7650.            parameter. 
  7651.  
  7652.  NSC0416   Name is too long on line <nn> of NSC config file. 
  7653.  
  7654.            Explanation: You specified a Host name, IBM LAN Server domain name, 
  7655.            NetWare server name, or NSC Server name for the NAME parameter of a 
  7656.            HOST, LANSERVER, DOMAIN or SERVER definition that is too long. The 
  7657.            maximum length of node names and host names is 8 characters. The 
  7658.            maximum length of IBM LAN Server names and NSC Server names is 15 
  7659.            characters. The maximum length of a NetWare server name is 47 
  7660.            characters. 
  7661.  
  7662.            Severity: Error 
  7663.  
  7664.            User Response: Determine the correct name and modify the parameter. 
  7665.            For HOST definitions defining APPC hosts, this is the name of the LU 
  7666.            profile in the APPC configuration. For HOST definitions defining 
  7667.            emulator sessions, this is the name of the host information file for 
  7668.            the emulator session (not including the file extension of ".INI"). 
  7669.            For SERVER definitions, this is the computername specified when 
  7670.            installing LAN Requester or LAN Server (this can be found in the 
  7671.            IBMLAN.INI file in the C:\IBMLAN directory). For IBM LANSERVER or 
  7672.            DOMAIN definitions, this is the IBM LAN Server domain name. For 
  7673.            NOVELL LANSERVER definitions, this is the NetWare file server name. 
  7674.            For NODE definitions, this is the Server Node Name configured in the 
  7675.            OS/2 Database Manager Workstation Directory for a database server, 
  7676.            or the PLU Name for an APPC application. 
  7677.  
  7678.  NSC0417   No host type specified for HOST definition on line <nn> of NSC 
  7679.            config file. 
  7680.  
  7681.            Explanation: You specified a HOST definition without a host type of 
  7682.            either EMULATOR or APPC, or you did not specify the host type prior 
  7683.            to an optional parameter. 
  7684.  
  7685.            Severity: Error 
  7686.  
  7687.            User Response: For the HOST definition, specify the host type as 
  7688.            either EMULATOR or APPC preceding any optional parameters. 
  7689.  
  7690.  NSC0418   NSC terminated because of configuration errors. 
  7691.  
  7692.            Explanation: NSC was not able to execute because of errors detected 
  7693.            in your configuration file. 
  7694.  
  7695.            Severity: Error 
  7696.  
  7697.            User Response: Correct the configuration errors and restart the 
  7698.            program. 
  7699.  
  7700.  NSC0419   Signon not allowed at an NSC Server on line <nn> of NSC config file. 
  7701.  
  7702.            Explanation: You specified the ON parameter for a SERVER definition, 
  7703.            or for a LOCAL definition or HOST definition with a host type of 
  7704.            EMULATOR or EHLL following a SERVER definition. Signon is not 
  7705.            supported at the Server. 
  7706.  
  7707.            Severity: Error 
  7708.  
  7709.            User Response: Remove the ON parameter from the definition to allow 
  7710.            password synchronization at the location, or delete the definition. 
  7711.  
  7712.  
  7713. ΓòÉΓòÉΓòÉ 9.6. Messages 420-445 ΓòÉΓòÉΓòÉ
  7714.  
  7715.  NSC0420   Path Name is too long on line <nn> of NSC config file. 
  7716.  
  7717.            Explanation: You specified a path name for an EXIT definition or an 
  7718.            EXIT or HIF parameter that is longer than 80 characters. The 
  7719.            complete path specification must be less than 80 characters in 
  7720.            length. 
  7721.  
  7722.            Severity: Error 
  7723.  
  7724.            User Response: Correct the path name. If necessary, make sure the 
  7725.            current path includes the path where the exit routine resides, and 
  7726.            specify only the file name of the exit routine. 
  7727.  
  7728.  NSC0421   Too many Exits on line <nn> of NSC config file. 
  7729.  
  7730.            Explanation: You specified more than 40 different EXIT definitions 
  7731.            or unique filenames as exit routines on the EXIT parameters for 
  7732.            location definitions in the configuration file. Network SignON 
  7733.            Coordinator/2 supports a maximum of 40 EXIT definitions. Each EXIT 
  7734.            parameter that specifies a filename that is not specified in any 
  7735.            EXIT definition or any other EXIT parameter is also counted. 
  7736.            Filename uniqueness is case-sensitive. 
  7737.  
  7738.            Severity: Error 
  7739.  
  7740.            User Response: Remove one or more EXIT definitions, or remove the 
  7741.            EXIT parameter from one or more of the definitions, or combine the 
  7742.            functions of one or more exit routines into a single exit routine. 
  7743.  
  7744.  NSC0422   Too many location definitions in NSC config file. 
  7745.  
  7746.            Explanation: More than 255 LOCAL, NODE, LANSERVER, DOMAIN, HOST and 
  7747.            SERVER definitions were specified in the configuration file. Network 
  7748.            SignON Coordinator/2 supports a maximum of 255 configured location 
  7749.            definitions. 
  7750.  
  7751.            Severity: Error 
  7752.  
  7753.            User Response: Delete the extra definitions. It may be possible to 
  7754.            support additional signon and password synchronization using user 
  7755.            exits. 
  7756.  
  7757.  NSC0424   User ID contains characters that are not valid on line <nn> of NSC 
  7758.            config file. 
  7759.  
  7760.            Explanation: You specified a User ID containing an ASCII control 
  7761.            character. Only graphic ASCII characters are valid in User IDs. 
  7762.  
  7763.            Severity: Error 
  7764.  
  7765.            User Response: Correct the User ID. 
  7766.  
  7767.  NSC0425   User ID is too long on line <nn> of NSC config file. 
  7768.  
  7769.            Explanation: You specified a User ID that is longer than the maximum 
  7770.            length specified in the configuration file for the MaxUIDLen 
  7771.            definition. 
  7772.  
  7773.            Severity: Error 
  7774.  
  7775.            User Response: Correct the User ID. 
  7776.  
  7777.  NSC0426   USERID not allowed with SERVER definition on line <nn> of NSC config 
  7778.            file. 
  7779.  
  7780.            Explanation: You specified a USERID parameter on a SERVER 
  7781.            definition. No signon or password synchronization is associated with 
  7782.            the SERVER definition. Thus, the USERID parameter is not allowed. 
  7783.  
  7784.            Severity: Error 
  7785.  
  7786.            User Response: Remove the USERID parameter from the SERVER 
  7787.            definition. If password synchronization with the local UPM on the 
  7788.            Server is required, specify the USERID parameter on a LOCAL 
  7789.            definition following the SERVER definition. 
  7790.  
  7791.  NSC0427   No name specified for a <def> definition on line <nn> of NSC config 
  7792.            file. 
  7793.  
  7794.            Explanation: You specified a NODE, LANSERVER, DOMAIN, HOST, SERVER 
  7795.            or EXIT definition without a NAME parameter. 
  7796.  
  7797.            Severity: Error 
  7798.  
  7799.            User Response: Specify a NAME parameter. For a LANSERVER (type IBM) 
  7800.            or DOMAIN definition, specify the IBM LAN Server domain name. For a 
  7801.            LANSERVER (type NOVELL) definition, specify the NetWare Server name 
  7802.            using the NAME parameter. For a HOST definition, specify the host 
  7803.            name. For a SERVER definition, specify the machine name. For an EXIT 
  7804.            definition, specify the user exit filename. For NODE definitions, 
  7805.            specify the Server Node Name configured in the OS/2 Database Manager 
  7806.            Workstation Directory for a database server, or the PLU Name for an 
  7807.            APPC application. 
  7808.  
  7809.  NSC0428   I/O error reading <config-file> after line <nn>. 
  7810.  
  7811.            Explanation: NSC detected an I/O error when reading the NSC 
  7812.            configuration file or host information file identified by 
  7813.            config-file. The error was detected after reading line nn. 
  7814.  
  7815.            Severity: Error 
  7816.  
  7817.            User Response: Retry the operation. If the disk error persists, take 
  7818.            steps to circumvent the error. Possible corrective actions include: 
  7819.  
  7820.            - Rename the file so that the faulty disk space is not reused, then 
  7821.            recreate the file. 
  7822.  
  7823.            - Reformat the disk to eliminate bad sectors, then restore your 
  7824.            system. 
  7825.  
  7826.            - Replace your disk, then restore your system. 
  7827.  
  7828.  NSC0429   Line <nn> in NSC config file is too long. 
  7829.  
  7830.            Explanation: Line <nn> contains too many characters. 
  7831.  
  7832.            Severity: Error 
  7833.  
  7834.            User Response: Edit the NSC configuration file and delete unneeded 
  7835.            characters, then retry the operation. 
  7836.  
  7837.  NSC0431   No server type specified for LANSERVER definition on line <nn> of 
  7838.            NSC config file. 
  7839.  
  7840.            Explanation: You specified a LANSERVER definition without a host 
  7841.            type of IBM or NOVELL, or you did not specify the host type prior to 
  7842.            an optional parameter. 
  7843.  
  7844.            Severity: Error 
  7845.  
  7846.            User Response: For the LANSERVER definition, specify the host type 
  7847.            as IBM or NOVELL preceding any optional parameters. 
  7848.  
  7849.  NSC0432   User ID is too short on line <nn> of NSC config file. 
  7850.  
  7851.            Explanation: You specified a User ID that is shorter than the 
  7852.            minimum length specified in the configuration file for the MinUIDLen 
  7853.            definition. 
  7854.  
  7855.            Severity: Error 
  7856.  
  7857.            User Response: Correct the User ID. 
  7858.  
  7859.  NSC0433   Host type already specified for HOST definition on line <nn> of NSC 
  7860.            config file. 
  7861.  
  7862.            Explanation: You specified a host type of both EMULATOR (EHLL) and 
  7863.            APPC for the HOST definition. You may only specify one host type. 
  7864.  
  7865.            Severity: Error 
  7866.  
  7867.            User Response: Remove the incorrect host type. 
  7868.  
  7869.  NSC0434   Server type already specified for LANSERVER definition on line <nn> 
  7870.            of NSC config file. 
  7871.  
  7872.            Explanation: You specified a LAN Server type of both IBM and NOVELL 
  7873.            for the LANSERVER definition. You may only specify one LAN Server 
  7874.            type. 
  7875.  
  7876.            Severity: Error 
  7877.  
  7878.            User Response: Remove the incorrect LAN Server type. 
  7879.  
  7880.  NSC0435   Too much variable length text on line <nn> of NSC config file. 
  7881.  
  7882.            Explanation: The length of your location names, userid, and user 
  7883.            exit paths, combined with the large number of location definitions 
  7884.            you have configured, requires too much memory. 
  7885.  
  7886.            Severity: Error 
  7887.  
  7888.            User Response: If the same user exit path is specified more than 
  7889.            once, try using specifying it once with an EXIT definition and 
  7890.            referencing it using the EXITID parameter. If this does not help, 
  7891.            reduce the number of location definitions, 
  7892.  
  7893.  NSC0436   No ID specified for an EXIT definition on line <nn> of NSC config 
  7894.            file. 
  7895.  
  7896.            Explanation: You specified an EXIT definition without an ID 
  7897.            parameter. 
  7898.  
  7899.            Severity: Error 
  7900.  
  7901.            User Response: Specify a unique ID number for the user exit using 
  7902.            the ID parameter. 
  7903.  
  7904.  NSC0440   V<x> already specified for HOST definition on line <nn> of NSC 
  7905.            config file. 
  7906.  
  7907.            Explanation: You specified the same HIF Variable parameter twice for 
  7908.            the HOST definition. 
  7909.  
  7910.            Severity: Error 
  7911.  
  7912.            User Response: Remove one of the HIF Variable parameters. 
  7913.  
  7914.  NSC0441   V<x> string syntax error for HOST definition on line <nn> of NSC 
  7915.            config file. 
  7916.  
  7917.            Explanation: The HIF Variable parameter was specified starting with 
  7918.            a double quote, but not terminated by a double quote. 
  7919.  
  7920.            Severity: Error 
  7921.  
  7922.            User Response: Terminate the HIF Variable parameter value with a 
  7923.            double quote. 
  7924.  
  7925.  NSC0442   Too much variable string text for HOST definition on line <nn> of 
  7926.            NSC config file. 
  7927.  
  7928.            Explanation: The combined length of all of the HIF Variable 
  7929.            parameters for the HOST definition is greater than 80. The HIF 
  7930.            Variable parameters for a single HOST definition are limited to a 
  7931.            total of 80 characters. 
  7932.  
  7933.            Severity: Error 
  7934.  
  7935.            User Response: Reduce the number of HIF Variable parameters or 
  7936.            reduce the length of the values for one or more of the HIF Variable 
  7937.            parameters. 
  7938.  
  7939.  NSC0443   Multiple GETDEFS found; or an EXIT or location definition used with 
  7940.            a GETDEFS definition. 
  7941.  
  7942.            Explanation: One or more of the following configuration errors has 
  7943.            occurred: 
  7944.  
  7945.            - The NSC.INI file has multiple GETDEFS. 
  7946.  
  7947.            - The NSC.INI file contained a GETDEFS as well as an EXIT definition 
  7948.            or location definition. 
  7949.  
  7950.            Severity: Error 
  7951.  
  7952.            User Response: Determine which configuration error occurred and 
  7953.            correct it. In the first case, delete the extraneous GETDEFS. In the 
  7954.            second case, either remove the GETDEFS or remove the location and 
  7955.            EXIT definitions. 
  7956.  
  7957.  NSC0444   A linked to definition file contained a GETDEFS definition. 
  7958.  
  7959.            Explanation: The configuration file loaded because of a GETDEFS in 
  7960.            the NSC.INI file contains a GETDEFS. 
  7961.  
  7962.            Severity: Error 
  7963.  
  7964.            User Response: Either remove the GETDEFS from the NSC.INI file or 
  7965.            the file referenced by the GETDEFS. 
  7966.  
  7967.  NSC0445   Unable to create local copy of HIF file <filename>. 
  7968.  
  7969.            Explanation: When NSC loads a configuration file from an NSC Server, 
  7970.            it attempts to copy all HIF files referenced from the server and 
  7971.            created a local copy of the HIFs. NSC was attempting to copy the 
  7972.            filename HIF file. 
  7973.  
  7974.            Severity: Error 
  7975.  
  7976.            User Response: Investigate the following: 
  7977.  
  7978.            - Is there adequate disk space on the drive where NSC is installed 
  7979.            at the Client workstation to hold the HIF? 
  7980.  
  7981.            - Does the HIF exist on the NSC Server in the NSC execution 
  7982.            directory? 
  7983.  
  7984.            Correct the problem and restart NSC. 
  7985.  
  7986.  
  7987. ΓòÉΓòÉΓòÉ 9.7. System Error Messages ΓòÉΓòÉΓòÉ
  7988.  
  7989.  SYS1041:  The name specified is not recognized as an internal or external 
  7990.            command, operable program or batch file. 
  7991.  
  7992.            Explanation: This error is displayed by OS/2, not by Network SignON 
  7993.            Coordinator/2. If displayed while attempting to startup NSC, it may 
  7994.            mean that the working directory or path is not set up correctly to 
  7995.            specify the directory where NSC is installed. 
  7996.  
  7997.            Severity: Error 
  7998.  
  7999.            User Response: Correct the specification of the working directory 
  8000.            for Network SignON Coordinator/2, or change the current directory to 
  8001.            where NSC is installed, or correct the PATH environment string for 
  8002.            the NSC session. 
  8003.  
  8004.  
  8005. ΓòÉΓòÉΓòÉ 10. Problem Determination ΓòÉΓòÉΓòÉ
  8006.  
  8007. At times things just don't work in spite of our best efforts. You may not have 
  8008. done anything different, but NSC can not successfully do what you requested. 
  8009. You get messages from NSC in response to your signon and signoff requests that 
  8010. explain what it perceives to be the problem. There may be additional problem 
  8011. determination available that can help resolve the situation. This section will 
  8012. help identify additional sources of information and how it can be used. This 
  8013. information may help an end user, but it is primarily used by the network 
  8014. administrator or the person who installed and configured NSC. 
  8015.  
  8016. NSC creates a file of all error and information messages on disk. Most of these 
  8017. are displayed on your screen too. The messages are written to disk to avoid 
  8018. loss since some processes are not monitored by an end user (e.g., NSCRETRY and 
  8019. NSCNDMN). 
  8020.  
  8021. NSC can create as many as three logs on a single workstation, depending on what 
  8022. processes are running. Table "NSC Logs" identifies the logs by process and the 
  8023. default for capturing debug information. 
  8024.  
  8025. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8026. Γöé          NSC Logs                              Γöé
  8027. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8028. Γöé PROCESS           Γöé FILE NAME         Γöé DEBUG  Γöé
  8029. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8030. Γöé   NSC (1)         Γöé   NSC.LOG         Γöé   Off  Γöé
  8031. Γöé                   Γöé                   Γöé        Γöé
  8032. Γöé                   Γöé   NSCNET.LOG (2)  Γöé   N/A  Γöé
  8033. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8034. Γöé   NSCRETRY        Γöé   NSCRETRY.LOG    Γöé   Off  Γöé
  8035. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8036. Γöé   NSCNDMN         Γöé   NSCNDMN.LOG     Γöé   Off  Γöé
  8037. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8038. Γöé NOTE:                                          Γöé
  8039. Γöé                                                Γöé
  8040. Γöé 1.  Or NSCPM, NSCRSON or NSCRSOFF.             Γöé
  8041. Γöé                                                Γöé
  8042. Γöé 2.  Only exists in DOS.  Contains error mes-   Γöé
  8043. Γöé     sages generated doing LAN Domain logon and Γöé
  8044. Γöé     logoffs.                                   Γöé
  8045. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8046.  
  8047. NSC writes these disk files (logs) in the directory that contains the NSC 
  8048. configuration file (NSC.INI). A log is an ASCII text file and can be processed 
  8049. using an operating system command (PRINT, TYPE, etc.) or viewed with a text 
  8050. editor. 
  8051.  
  8052. Each line is a message and follows a certain format, illustrated by the 
  8053. following sample message: 
  8054.  
  8055.  
  8056.   IN 01 nn:nn:nn NSCRETRY System queue ....
  8057.                       
  8058.   Γöé  Γöé  Γöé        Γöé        Γöé
  8059.   Γöé  Γöé  Γöé        Γöé        Γöé
  8060.   Γöé  Γöé  Γöé        Γöé        Text
  8061.   Γöé  Γöé  Γöé        Γöé
  8062.   Γöé  Γöé  Γöé        Function
  8063.   Γöé  Γöé  Γöé
  8064.   Γöé  Γöé  TimeStamp
  8065.   Γöé  Γöé
  8066.   Γöé  ThreadID
  8067.   Γöé
  8068.   FunctionalArea
  8069.  
  8070.  FunctionalArea      Is a two-character code that identifies the internal NSC 
  8071.                      functional area that originated the message. 
  8072.  
  8073.  ThreadID            Is the two-digit OS/2 thread number on which the function 
  8074.                      was executing. Since concurrent requests can be processed, 
  8075.                      this value can be used to associate messages for the same 
  8076.                      request. In DOS, this value is always "01". 
  8077.  
  8078.  TimeStamp           The time when the message was written.  This may be useful 
  8079.                      in finding messages that were logged when the user had an 
  8080.                      earlier problem. 
  8081.  
  8082.  Function            Is used to either clarify the function generating the 
  8083.                      message or the type of message. It is always eight 
  8084.                      characters in length. Abbreviations for OS/2 functions, 
  8085.                      NET functions, UPM functions, APPC verbs and NETBIOS verbs 
  8086.                      can be found in LOG Functions. 
  8087.  
  8088.  Text                Is a variable length message constructed by NSC. 
  8089.  
  8090.  When Debug information is requested, additional messages are logged. Debug 
  8091.  logging is turned "ON" in the NSC process by including a DEBUG command in the 
  8092.  NSC configuration file. Debug logging is turned "ON" in the NSCRETRY and 
  8093.  NSCNDMN processes by using the /DEBUG parameter option when starting the 
  8094.  process. 
  8095.  
  8096.  
  8097. ΓòÉΓòÉΓòÉ 10.1. LOG Functions ΓòÉΓòÉΓòÉ
  8098.  
  8099. The following table defines the abbreviations for OS/2 functions, NET 
  8100. functions, UPM functions, C library functions, APPC verbs, EHLLAPI verbs and 
  8101. NETBIOS verbs that may be found in the Function field of LOG messages. 
  8102.  
  8103. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8104. Γöé          NSC LOG message functions                       Γöé
  8105. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8106. Γöé ABBREVIATION Γöé FUNCTION                                  Γöé
  8107. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8108. Γöé   AddName    Γöé   NETBIOS ADD_NAME_WAIT                   Γöé
  8109. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8110. Γöé   Allocate   Γöé   APPC ALLOCATE                           Γöé
  8111. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8112. Γöé   AllocSeg   Γöé   OS/2 DosAllocSeg                        Γöé
  8113. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8114. Γöé   BeginT     Γöé   C _beginthread                          Γöé
  8115. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8116. Γöé   ConnPS     Γöé   EHLLAPI CONNECT PRESENTATION SPACE      Γöé
  8117. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8118. Γöé   DeAlloc    Γöé   APPC DEALLOCATE                         Γöé
  8119. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8120. Γöé   DiscoPS    Γöé   EHLLAPI DISCONNECT PRESENTATION SPACE   Γöé
  8121. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8122. Γöé   dup2       Γöé   C dup2                                  Γöé
  8123. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8124. Γöé   Call       Γöé   NETBIOS CALL_WAIT                       Γöé
  8125. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8126. Γöé   CfgGet2    Γöé   NetConfigGet2                           Γöé
  8127. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8128. Γöé   Confirm    Γöé   APPC Confirm                            Γöé
  8129. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8130. Γöé   CloseQ     Γöé   OS/2 DosCloseQue                        Γöé
  8131. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8132. Γöé   CreateQ    Γöé   OS/2 DosCreateQue                       Γöé
  8133. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8134. Γöé   Execute    Γöé   C spawnv                                Γöé
  8135. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8136. Γöé   FreeSeg    Γöé   OS/2 DosFreeSeg                         Γöé
  8137. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8138. Γöé   GetDCNam   Γöé   NetGetDCName                            Γöé
  8139. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8140. Γöé   GetSeg     Γöé   OS/2 DosGetSeg                          Γöé
  8141. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8142. Γöé   GiveSeg    Γöé   OS/2 DosGiveSeg                         Γöé
  8143. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8144. Γöé   HangUp     Γöé   NETBIOS HANG_UP_WAIT                    Γöé
  8145. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8146. Γöé   Init       Γöé   NETBIOS Initialize                      Γöé
  8147. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8148. Γöé   Listen     Γöé   NETBIOS LISTEN_WAIT                     Γöé
  8149. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8150. Γöé   lseek      Γöé   C lseek                                 Γöé
  8151. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8152. Γöé   ModalGet   Γöé   NetUserModalsGet                        Γöé
  8153. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8154. Γöé   open       Γöé   C open                                  Γöé
  8155. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8156. Γöé   OpenQ      Γöé   OS/2 DosOpenQue                         Γöé
  8157. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8158. Γöé   Pause      Γöé   EHLLAPI PAUSE                           Γöé
  8159. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8160. Γöé   QryHUpdt   Γöé   EHLLAPI QUERY HOST UPDATE               Γöé
  8161. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8162. Γöé   read       Γöé   C read                                  Γöé
  8163. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8164. Γöé   ReadQ      Γöé   OS/2 DosReadQue                         Γöé
  8165. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8166. Γöé   RcvWait    Γöé   APPC RECEIVE_AND_WAIT                   Γöé
  8167. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8168. Γöé   Receive    Γöé   NETBIOS RECEIVE_WAIT                    Γöé
  8169. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8170. Γöé   RelPS      Γöé   EHLLAPI RELEASE                         Γöé
  8171. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8172. Γöé   ResAlloc   Γöé   NETBIOS RESET_WAIT                      Γöé
  8173. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8174. Γöé   ResetSys   Γöé   EHLLAPI RESET SYSTEM                    Γöé
  8175. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8176. Γöé   RsvPS      Γöé   EHLLAPI RESERVE                         Γöé
  8177. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8178. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8179. Γöé          NSC LOG message functions                       Γöé
  8180. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8181. Γöé ABBREVIATION Γöé FUNCTION                                  Γöé
  8182. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8183. Γöé   SearchPS   Γöé   EHLLAPI SEARCH PRESENTATION SPACE       Γöé
  8184. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8185. Γöé   Send       Γöé   NETBIOS SEND_WAIT                       Γöé
  8186. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8187. Γöé   SendData   Γöé   APPC SEND_DATA                          Γöé
  8188. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8189. Γöé   SendKey    Γöé   EHLLAPI SEND KEY                        Γöé
  8190. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8191. Γöé   SetSessP   Γöé   EHLLAPI SET SESSION PARAMETERS          Γöé
  8192. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8193. Γöé   Status     Γöé   NETBIOS STATUS_WAIT                     Γöé
  8194. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8195. Γöé   StpHNtfy   Γöé   EHLLAPI STOP HOST NOTIFICATION          Γöé
  8196. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8197. Γöé   SttHNtfy   Γöé   EHLLAPI START HOST NOTIFICATION         Γöé
  8198. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8199. Γöé   TpStart    Γöé   APPC TP_STARTED                         Γöé
  8200. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8201. Γöé   UGetInfo   Γöé   NetUserGetInfo                          Γöé
  8202. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8203. Γöé   upmelocu   Γöé   UPM UPMELOCU                            Γöé
  8204. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8205. Γöé   upmeulgf   Γöé   UPM UPMEULGF                            Γöé
  8206. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8207. Γöé   upmeulgn   Γöé   UPM UPMEULGN                            Γöé
  8208. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8209. Γöé   upmeusrl   Γöé   UPM UPMEUSRL                            Γöé
  8210. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8211. Γöé   UPWSet     Γöé   NetUserPasswordSet                      Γöé
  8212. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8213. Γöé   Wait       Γöé   EHLLAPI WAIT                            Γöé
  8214. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8215. Γöé   WkstaSet   Γöé   NetWkstaSetUID2                         Γöé
  8216. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8217. Γöé   WriteQ     Γöé   OS/2 DosWriteQue                        Γöé
  8218. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8219.  
  8220.  
  8221. ΓòÉΓòÉΓòÉ 11. Exit Routines ΓòÉΓòÉΓòÉ
  8222.  
  8223. User exits may be specified for specific locations definitions to allow an exit 
  8224. routine to provide additional coordination or synchronization of signons, 
  8225. password changes, and/or signoffs. Refer to EXIT for a description of how to 
  8226. specify an user exit. 
  8227.  
  8228. Exit routines can be command files or programs. The following sections 
  8229. described how exit routines are executed by NSC, and give details required for 
  8230. writing exit routines. 
  8231.  
  8232.      OS/2 Considerations 
  8233.  
  8234.      DOS Considerations 
  8235.  
  8236.      Parameters 
  8237.  
  8238.      Return Codes 
  8239.  
  8240.      Examples 
  8241.  
  8242.  
  8243. ΓòÉΓòÉΓòÉ 11.1. OS/2 Considerations ΓòÉΓòÉΓòÉ
  8244.  
  8245. Exit routines in OS/2 are started in a separate session and may be windowed, 
  8246. full screen or PM applications. The session inherits the environment of the 
  8247. Network SignON Coordinator/2 session. Exit routines may be defined to start in 
  8248. the background or foreground. Exit routines may be defined to execute 
  8249. synchronously (NSC waits for the user exit to terminate) or asynchronously (NSC 
  8250. processes the next definition without waiting for the user exit to terminate). 
  8251. If an exit routine requires user interaction, and you want NSC to wait for it 
  8252. to complete before continuing, you should define it to start in the foreground. 
  8253.  
  8254. Exit routines that end with an extension of ".CMD" are started using the 
  8255. command interpreter as a windowed session. All other exit routines are started 
  8256. as executable programs. 
  8257.  
  8258.  
  8259. ΓòÉΓòÉΓòÉ 11.2. DOS Considerations ΓòÉΓòÉΓòÉ
  8260.  
  8261. Exit routines in DOS are started with standard output and standard error 
  8262. redirected to files (NSCNET.UID and NSCNET.ERR) to prevent most routines from 
  8263. overwriting the Network SignON Coordinator/2 menu. You should avoid using exit 
  8264. routines that require user interaction. If the prompt is written to standard 
  8265. output, it will not display. If you have an exit routine that writes directly 
  8266. to the screen, it will corrupt the Network SignON Coordinator/2 menu. 
  8267.  
  8268. Exit routines are always executed synchronously in DOS (NSC waits for the user 
  8269. exit to terminate before processing the next definition). 
  8270.  
  8271.  
  8272. ΓòÉΓòÉΓòÉ 11.3. Parameters ΓòÉΓòÉΓòÉ
  8273.  
  8274. Exit routines are called with the following parameters: 
  8275.  
  8276.    1. Either 
  8277.  
  8278.           "0" for a signon request 
  8279.           "1" for a signoff request 
  8280.           "2" for a change password request 
  8281.  
  8282.    2. The configuration index of the associated definition (the first 
  8283.       definition is "1") 
  8284.  
  8285.    3. The return code from the request for the associated definition (i.e. LAN 
  8286.       Server, Host, or Local UPM). Return codes are listed in the NSCRSIGN.H 
  8287.       header file. 
  8288.  
  8289.    4. User ID (may be blank for Signoff) 
  8290.  
  8291.    5. Current Password (blank for Signoff) 
  8292.  
  8293.    6. New Password (blank for Signoff or if password was not changed) 
  8294.  
  8295.  
  8296. ΓòÉΓòÉΓòÉ 11.4. Return Codes ΓòÉΓòÉΓòÉ
  8297.  
  8298. Exit routines can be defined to return an ERRORLEVEL indication to NSC (RC 
  8299. parameter on EXIT definition, see EXIT). If the EXIT definition does not 
  8300. include the RC parameter, NSC will ignore the return code from the exit 
  8301. routine. When RC is specified, NSC displays a message if a non-zero return code 
  8302. is returned by the exit routine. This allows a user to receive feedback on the 
  8303. success or failure of the exit routine. Return codes and their interpretations 
  8304. are defined in the file NSCRSIGN.H. Messages displayed by NSC and their 
  8305. explanations can be found in Messages by adding 100 to the return code to 
  8306. determine the NSC message number. 
  8307.  
  8308. Note:   Caution, exit routines which are command files may terminate with 
  8309. syntax errors resulting in a non-zero return code. 
  8310.  
  8311. If the EXIT definition MSGS parameter is not specified, NSC will only display 
  8312. an exit status message if an error occurs. 
  8313.  
  8314.  
  8315. ΓòÉΓòÉΓòÉ 11.5. Examples ΓòÉΓòÉΓòÉ
  8316.  
  8317. The following sections contain examples of exit routines for OS/2 and DOS: 
  8318.  
  8319.      Accessing Network Resources 
  8320.  
  8321.      Enabling 5250 Node Logons 
  8322.  
  8323.      Logging on to a DOS Database Client 
  8324.  
  8325.      Keeping Audit Logs of Signons 
  8326.  
  8327.      OS/2 NetWare Drive Mapping 
  8328.  
  8329.      DOS NetWare Drive Mapping 
  8330.  
  8331.  
  8332. ΓòÉΓòÉΓòÉ 11.5.1. Accessing Network Resources ΓòÉΓòÉΓòÉ
  8333.  
  8334. The following example illustrates a command file that could be executed as the 
  8335. exit routine for an IBM LAN Server on either an OS/2 or DOS Client. It performs 
  8336. a NET USE following a successful signon. It does not return a return code. 
  8337.  
  8338.   @echo off
  8339.   rem %1 = 0 for signon, 1 for signoff, 2 for change password,
  8340.   rem %2 = Configuration definition index
  8341.   rem %3 = Return code
  8342.   rem %4 = User ID
  8343.   rem %5 = Current Password
  8344.   rem %6 = New Password
  8345.   rem
  8346.   rem exit if not a signon request
  8347.   if not %1 == 0 goto end
  8348.   rem
  8349.   rem exit if signon request was not successful
  8350.   if %3 == 0 goto success
  8351.   if %3 == 1 goto success
  8352.   goto end
  8353.   rem
  8354.   rem access the network drive
  8355.   :success
  8356.   NET USE N: \\LSERVER\NETDRV
  8357.   :end
  8358.  
  8359.  
  8360. ΓòÉΓòÉΓòÉ 11.5.2. Enabling 5250 Node Logons ΓòÉΓòÉΓòÉ
  8361.  
  8362. The following example illustrates a command file that can be executed as the 
  8363. exit routine for a HOST definition using an OS/2 Communications Manager 5250 
  8364. emulator session. It generates a command file each time the password is 
  8365. changed. The generated command file performs a 5250 node logon, and then starts 
  8366. Communications Manager. If this generated command file is used to start 
  8367. Communications Manager, the UPM node logon screen is bypassed when the 
  8368. Communications Manager 5250 terminal session starts. 
  8369.  
  8370.   @echo off
  8371.   rem %1 = 0 for signon, 1 for signoff, 2 for change password,
  8372.   rem %2 = Configuration definition index
  8373.   rem %3 = Return code
  8374.   rem %4 = User ID
  8375.   rem %5 = Current Password
  8376.   rem %6 = New Password
  8377.   rem
  8378.   rem exit if not a change password request
  8379.   if not %1 == 2 goto end
  8380.   rem
  8381.   rem exit if change password request was not successful
  8382.   if not %3 == 0 goto end
  8383.   rem
  8384.   rem generate the command file
  8385.   echo @LOGON %4 /P:%6 /N:PLUALIAS > D:\NSC\STARTCM.CMD
  8386.   echo @CM 5250.CFG >> D:\NSC\STARTCM.CMD
  8387.   rem PLUALIAS is the partner logical unit alias for this 5250 session,
  8388.   rem which can be found either in the Communications Manager configuration file,
  8389.   rem or on the Communications Manager initiated node logon screen.
  8390.   rem 5250.cfg is the configuration file you use to start Communications Manager
  8391.   :end
  8392.  
  8393. Note: This approach to bypassing the UPM node logon screen stores the password 
  8394. in the clear on the hard disk. If this is an unacceptable security exposure, 
  8395. the above example could be altered to scramble the password when writing it to 
  8396. disk, and unscramble the password when reading it from disk. 
  8397.  
  8398.  
  8399. ΓòÉΓòÉΓòÉ 11.5.3. Logging on to a DOS Database Client ΓòÉΓòÉΓòÉ
  8400.  
  8401. The following example illustrates a command file that could be executed as the 
  8402. exit routine for a NODE definition from a DOS Client running the DOS Database 
  8403. Requester. 
  8404.  
  8405.   @echo off
  8406.   rem %1 = 0 for signon, 1 for signoff, 2 for change password,
  8407.   rem %2 = Configuration definition index
  8408.   rem %3 = Return code
  8409.   rem %4 = User ID
  8410.   rem %5 = Current Password
  8411.   rem %6 = New Password
  8412.   rem
  8413.   rem if a signon request
  8414.   if not %1 == 0 goto off
  8415.   rem
  8416.   rem perform the database logon
  8417.   sqllogn2 %4 /p:%5
  8418.   goto end
  8419.   :off
  8420.   rem
  8421.   rem if a signoff request
  8422.   if not %1 == 1 goto pw
  8423.   rem
  8424.   rem perform the database logoff
  8425.   sqllogf2
  8426.   goto end
  8427.   :pw
  8428.   rem
  8429.   rem if a change password request
  8430.   if not %1 == 2 goto end
  8431.   rem
  8432.   rem perform the database logon using the new password
  8433.   sqllogn2 %4 /p:%6
  8434.   :end
  8435.  
  8436.  
  8437. ΓòÉΓòÉΓòÉ 11.5.4. Keeping Audit Logs of Signons ΓòÉΓòÉΓòÉ
  8438.  
  8439. The following example illustrates a command file that could be executed as the 
  8440. exit routine for any signon from either an OS/2 or DOS Client to record the 
  8441. time and date of a user signon. The "e" drive may either be local, or may be a 
  8442. network drive to which the user received access via the signon. The file 
  8443. "rtn.inp" contains nothing but a line end. 
  8444.  
  8445.   @echo off
  8446.   rem %1 = 0 for signon, 1 for signoff, 2 for change password,
  8447.   rem %2 = Configuration definition index
  8448.   rem %3 = Return code
  8449.   rem %4 = User ID
  8450.   rem %5 = Current Password
  8451.   rem %6 = New Password
  8452.   rem
  8453.   rem exit if not a signon request
  8454.   if not %1 == 0 goto end
  8455.   rem
  8456.   echo %1 %2 %3 %4 >>e:\audit.log
  8457.   date <e:\rtn.inp >>e:\audit.log
  8458.   time <e:\rtn.inp >>e:\audit.log
  8459.   :end
  8460.  
  8461.  
  8462. ΓòÉΓòÉΓòÉ 11.5.5. OS/2 NetWare Drive Mapping ΓòÉΓòÉΓòÉ
  8463.  
  8464. The following example illustrates a command file that could be executed as the 
  8465. exit routine for an OS/2 signon to assign subdirectories on a NetWare file 
  8466. server to OS/2 disk drives. 
  8467.  
  8468.   /************************************************************************/
  8469.   /*  OS/2 NSC Sample Novell User Exit  --  NOVELL1.CMD                   */
  8470.   /*                                                                      */
  8471.   /*      This sample is intended to be used for multiple LANSERVER       */
  8472.   /*      definitions.  For example:                                      */
  8473.   /*                                                                      */
  8474.   /*        EXIT,ID=1,NAME=D:\NSC\NOVELL1.CMD,RC                          */
  8475.   /*        LANSERVER,NOVELL,NAME=DEPT_036_SERVER,ON,EXITID=1             */
  8476.   /*        LANSERVER,NOVELL,NAME=DEPT_042_SERVER,ON,EXITID=1             */
  8477.   /*        LANSERVER,NOVELL,NAME=DEPT_102_SERVER,EXITID=1                */
  8478.   /*                                                                      */
  8479.   /*                                                                      */
  8480.   /*      This exit returns if this is NOT a signon request that          */
  8481.   /*      succeeded.  If successful, based on which file server           */
  8482.   /*      was signed on to, causes different drive map commands to        */
  8483.   /*      be issued.                                                      */
  8484.   /*                                                                      */
  8485.   /************************************************************************/
  8486.  
  8487.    '@ECHO OFF'
  8488.    /*TRACE ?R  */
  8489.    /* set default values */
  8490.    UserID  = ''
  8491.    CurPswd = ''
  8492.    NewPswd = ''
  8493.    exitrc = 0;
  8494.    NSC.RC.ERROR.BOUNDARY  = 10;  /* Warnings are less than this value */
  8495.  
  8496.    /* get the parameters passed from NSC to this exit command file */
  8497.    parse upper arg Request Location Result UserID CurPswd NewPswd;
  8498.  
  8499.    if (Request <> 0) then signal TheEnd;  /* if not signon --> exit */
  8500.  
  8501.    /* If signon resulted in an error --> exit */
  8502.    if (Result > (NSC.RC.ERROR.BOUNDARY-1)) then signal TheEnd;
  8503.  
  8504.    /* The following check of Location is dependent on the physical */
  8505.    /* line the LANSERVER definition appears in the NSC.INI file.   */
  8506.    /* Review the values any time a change is made to NSC.INI.      */
  8507.    select
  8508.      when Location = 1         /*  Department 36 Server           */
  8509.        then do
  8510.          /* map drives M and N to subdirectories on Server 36  */
  8511.          'MAP M:=DEPT_036_SERVER/SYS:HOME/'||UserID
  8512.          if (rc > exitrc) then exitrc = rc;
  8513.          'MAP N:=DEPT_036_SERVER/SYS:PUBLIC';
  8514.          if (rc > exitrc) then exitrc = rc;
  8515.        end
  8516.      when Location = 2         /*  Department 42 Server           */
  8517.        then do
  8518.          /* map drive P to a subdirectory on Server 42  */
  8519.          'MAP P:=DEPT_042_SERVER/SYS:'||UserID;
  8520.          if (rc > exitrc) then exitrc = rc;
  8521.        end
  8522.      when Location = 3         /*  Department 102 Server          */
  8523.        then do
  8524.          /* map drive N to a subdirectory on Server 102 */
  8525.          /* NOTE: this assumes you are not signed on to both   */
  8526.          /*       Server 36 and 102 at the same time.          */
  8527.          'MAP N:=DEPT_102_SERVER/SYS:PUBLIC';
  8528.          if (rc > exitrc) then exitrc = rc;
  8529.        end
  8530.      OTHERWISE
  8531.        do                      /* Unknown .....                    */
  8532.          say "Error in Location codes  ";
  8533.          exitrc = 8;
  8534.        end
  8535.    end
  8536.  
  8537.   TheEnd:
  8538.    /* command files are limited to 256 as the highest ERRORLEVEL */
  8539.    if (exitrc > 256) then exitrc = 256;
  8540.    exit exitrc;
  8541.  
  8542.  
  8543. ΓòÉΓòÉΓòÉ 11.5.6. DOS NetWare Drive Mapping ΓòÉΓòÉΓòÉ
  8544.  
  8545. The following example illustrates a command file that could be executed as the 
  8546. exit routine for a DOS signon to assign subdirectories on a NetWare file server 
  8547. to disk drives. 
  8548.  
  8549.   @ECHO OFF
  8550.   :/************************************************************************/
  8551.   :/*  DOS NSC Sample Novell User Exit  --  NOVELL2.BAT                    */
  8552.   :/*                                                                      */
  8553.   :/*      This sample is used for a single LANSERVER definition.          */
  8554.   :/*      For example:                                                    */
  8555.   :/*                                                                      */
  8556.   :/*        EXIT,ID=1,NAME=D:\NSC\NOVELL2.BAT                             */
  8557.   :/*        LANSERVER,NOVELL,NAME=DEPT_036_SERVER,ON,EXITID=1             */
  8558.   :/*                                                                      */
  8559.   :/*      This exit returns if this is NOT a signon request that          */
  8560.   :/*      succeeded.  If successful, based on which file server           */
  8561.   :/*      was signed on to, causes different drive map commands to        */
  8562.   :/*      be issued.                                                      */
  8563.   :/*                                                                      */
  8564.   :/************************************************************************/
  8565.   rem
  8566.   rem   If no parameters provided, exit.
  8567.   if .%1 == . goto TheEnd
  8568.   rem   If not a password change, exit.
  8569.   if not %1 == 0 goto TheEnd
  8570.   rem   Check if successful or warnings.  If not, exit.
  8571.   if %3 == 0 goto DoMap
  8572.   if %3 == 1 goto DoMap
  8573.   if %3 == 2 goto DoMap
  8574.   if %3 == 3 goto DoMap
  8575.   if %3 == 4 goto DoMap
  8576.   if %3 == 5 goto DoMap
  8577.   if %3 == 6 goto DoMap
  8578.   if %3 == 7 goto DoMap
  8579.   if %3 == 8 goto DoMap
  8580.   if %3 == 9 goto DoMap
  8581.   goto TheEnd
  8582.   :DoMap
  8583.   rem  map drives M and N to subdirectories on Server 36
  8584.   MAP M:=DEPT_036_SERVER/SYS:HOME/%4
  8585.   MAP N:=DEPT_036_SERVER/SYS:PUBLIC
  8586.   :TheEnd
  8587.  
  8588.  
  8589. ΓòÉΓòÉΓòÉ 12. Summary of Changes ΓòÉΓòÉΓòÉ
  8590.  
  8591. This document contains changes for Network SignON Coordinator/2 Version 1.1. 
  8592. This is a maintenance release for Network SignON Coordinator/2 Version 1.0 
  8593. which also includes several functional changes summarized here: 
  8594.  
  8595.      Installation Changes 
  8596.  
  8597.      Novell NetWare Support 
  8598.  
  8599.      DOS Emulator Support 
  8600.  
  8601.      Graphical Interface Changes 
  8602.  
  8603.      End User Command Changes 
  8604.  
  8605.      Configuration Definitions Changes 
  8606.  
  8607.      Message Changes 
  8608.  
  8609.      NETBIOS Usage Changes 
  8610.  
  8611.      User Exit Changes 
  8612.  
  8613.      Host Information File Changes 
  8614.  
  8615.      NOTE If you have an NSC Server, you must install a Version 1.1 NSC Server 
  8616.      at the same time you install Version 1.1 NSC Clients (and vice-versa). 
  8617.      Version 1.0 NSC Clients are not compatible with the Version 1.1 NSC 
  8618.      Server, and the Version 1.0 NSC Server is not compatible with Version 1.1 
  8619.      NSC Clients. 
  8620.  
  8621.  
  8622. ΓòÉΓòÉΓòÉ 12.1. Installation Changes ΓòÉΓòÉΓòÉ
  8623.  
  8624. New installation command files have been shipped for Version 1.1. Installation 
  8625. for both DOS and OS/2 is now performed with the same command, specifically 
  8626.  
  8627.   INSTALL
  8628.  
  8629. This command file can handle both a first-time installation, or a 
  8630. reinstallation (over Version 1.0 or Version 1.1). For reinstallation, your NSC 
  8631. configuration file will be preserved. 
  8632.  
  8633. For DOS, the INSTALL command installs the DOS client. For OS/2, you will be 
  8634. asked to select the type of NSC configuration you want. For OS/2 2.0 and later, 
  8635. the NSC Folder is recreated. 
  8636.  
  8637. Installation procedures are described fully in Installing Network SignON 
  8638. Coordinator/2. 
  8639.  
  8640.  
  8641. ΓòÉΓòÉΓòÉ 12.2. Novell NetWare Support ΓòÉΓòÉΓòÉ
  8642.  
  8643. NSC now supports signons to Novell NetWare File Servers from both OS/2 and DOS 
  8644. Clients. See LANSERVER for information on configuring NetWare File Servers. 
  8645.  
  8646.  
  8647. ΓòÉΓòÉΓòÉ 12.3. DOS Emulator Support ΓòÉΓòÉΓòÉ
  8648.  
  8649. NSC now supports DOS host emulators for 3270 or 5250 terminal emulation from 
  8650. DOS Clients. See DOS Clients for information on supported software. 
  8651.  
  8652.  
  8653. ΓòÉΓòÉΓòÉ 12.4. Graphical Interface Changes ΓòÉΓòÉΓòÉ
  8654.  
  8655. The graphical interface now displays icons in the client window for each system 
  8656. on which you can sign on from your client. A second window is created to 
  8657. contain the messages from NSC. Signon status is displayed for each location 
  8658. with the icon. Icons may be selected to signon or signoff a single location. 
  8659. The menu options have been enhanced to support selective signon. The new user 
  8660. interface is described more fully in Graphical Interface. 
  8661.  
  8662. When you start the graphical interface, a logo panel is conditionally 
  8663. displayed.  The duration for which it is displayed is controlled by your OS/2 
  8664. System setting for logos. 
  8665.  
  8666.  
  8667. ΓòÉΓòÉΓòÉ 12.5. End User Command Changes ΓòÉΓòÉΓòÉ
  8668.  
  8669. The NSCRSON and NSCRSOFF commands documented in Version 1.0 have been replaced 
  8670. in Version 1.1 by the NSC command. The command syntax is defined in Command 
  8671. Line Interface. The NSC command now supports both the command line interface 
  8672. and the menu or graphical interface. This is described fully in End User 
  8673. Commands. 
  8674.  
  8675. NSC Version 1.1 contains two small executables, NSCRSON.EXE and NSCRSOFF.EXE, 
  8676. which execute the NSC.EXE program, maintaining compatibility with Version 1.0. 
  8677. Parameters are mapped as follows: 
  8678.  
  8679. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8680. Γöé          NSCRSON and NSCRSOFF Support                           Γöé
  8681. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8682. Γöé OLD COMMAND                    Γöé NEW COMMAND                    Γöé
  8683. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8684. Γöé   NSCRSON                      Γöé   NSC ON (1)                   Γöé
  8685. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8686. Γöé   NSCRSON UID                  Γöé   NSC ON UID (1)               Γöé
  8687. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8688. Γöé   NSCRSON UID PW               Γöé   NSC ON UID PW (2)            Γöé
  8689. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8690. Γöé   NSCRSON UID PW NPW           Γöé   NSC CHGPW UID PW NPW (2)     Γöé
  8691. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8692. Γöé   NSCRSOFF                     Γöé   NSC OFF (2)                  Γöé
  8693. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8694. Γöé   NSCRSOFF UID                 Γöé   NSC OFF UID (2)              Γöé
  8695. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8696. Γöé NOTE:                                                           Γöé
  8697. Γöé                                                                 Γöé
  8698. Γöé 1.  Presents the menu or graphical interface                    Γöé
  8699. Γöé                                                                 Γöé
  8700. Γöé 2.  Executes as the command line interface                      Γöé
  8701. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8702.  
  8703.  
  8704. ΓòÉΓòÉΓòÉ 12.6. Configuration Definitions Changes ΓòÉΓòÉΓòÉ
  8705.  
  8706. We have replaced the "Domain" configuration definition with the "LANServer" 
  8707. definition. The definition syntax is defined in LANSERVER. The "Domain" 
  8708. definition is still supported in Version 1.1, maintaining compatibility with 
  8709. Version 1.0. The "LANServer" definition allows specification of the LAN Server 
  8710. as an IBM or Novell LAN Server. 
  8711.  
  8712. In general, the use of the term "LAN Server" has replaced the use of the term 
  8713. "domain" in much of the documentation. 
  8714.  
  8715. We have added a "Node" configuration definition to support Node logons to UPM 
  8716. on OS/2 Clients (primarily to support OS/2 Database Manager clients). 
  8717.  
  8718. We have added a "GetDefs" configuration definition that allows you to store 
  8719. configuration definitions on a single LAN node for easier NSC configuration 
  8720. management. 
  8721.  
  8722. When you exit the graphical interface, a new popup warning message may 
  8723. optionally be displayed.  We have added a new configuration definition, 
  8724. "ConfirmExit".  The default is "ConfirmExit=NO".  If you specify 
  8725. "ConfirmExit=YES", when you exit from the NSC panel, a popup warning message 
  8726. will be displayed asking you to confirm that you want to exit. 
  8727.  
  8728. The "ON" parameter may now be specified with the "Host" definition for an APPC 
  8729. connection to request User ID and password verification at signon. 
  8730.  
  8731. User exits may now be specified using the "Exit" definition. This gives 
  8732. additional flexibility for OS/2, including the ability to specify execution in 
  8733. the foreground or background, whether or not NSC should wait for the user exit 
  8734. to complete, and whether NSC should display in-progress and completion messages 
  8735. (based on the errorlevel set by the user exit). The "ExitID" parameter can be 
  8736. used in a location definition to reference a user exit defined by an "Exit" 
  8737. definition. We have raised the number of exit routines that can be specified to 
  8738. 40. 
  8739.  
  8740. We have eliminated the restriction on the number of configuration definitions 
  8741. that can be associated with a "Server" definition. This used to be 5, but is 
  8742. now only limited by the limitation on the total number of definitions, which 
  8743. has been raised from 50 to 255. 
  8744.  
  8745. The "SavePW" definition has been added to instruct NSC to remember your 
  8746. password and not reprompt for it on subsequent requests. 
  8747.  
  8748. The "EHLLAPI" parameter has been changed to "EMULATOR". In general, the use of 
  8749. the term "host emulator session" has replaced the use of the term "EHLLAPI Host 
  8750. connection" in much of the documentation. For host emulation sessions, several 
  8751. new parameters have been added to make it possible for one host information 
  8752. file to be used for multiple hosts. The "Hif" parameter allows the 
  8753. specification of the host information file name, allowing the Host name to be 
  8754. independent of the host information file name. The "V0" through "V9" parameters 
  8755. allow variable information to be substituted in the host information file. 
  8756.  
  8757.  
  8758. ΓòÉΓòÉΓòÉ 12.7. Message Changes ΓòÉΓòÉΓòÉ
  8759.  
  8760. We have added a message number identifier to all messages, and messages are now 
  8761. ordered in the documentation by message number in Messages. 
  8762.  
  8763. We now display an "in progress" message as each definition is processed. 
  8764. Definitions that are associated with NSC Servers are now processed one at a 
  8765. time.  This is intended to give you better feedback on what NSC is currently 
  8766. doing. 
  8767.  
  8768. Other message changes have been made as a result of the functional changes in 
  8769. this release. 
  8770.  
  8771.  
  8772. ΓòÉΓòÉΓòÉ 12.8. NETBIOS Usage Changes ΓòÉΓòÉΓòÉ
  8773.  
  8774. We have optimized the NETBIOS resource usage, with some resulting performance 
  8775. improvements. The new resource requirements are described in Configuring 
  8776. NETBIOS. 
  8777.  
  8778. The NSC Server NETBIOS resource requirements can now be specified as a command 
  8779. line option.  The option is defined in NSCNDMN - Start the NSC Server. 
  8780.  
  8781. Passwords are now masked when transmitted from an NSC Client to an NSC Server. 
  8782.  
  8783.  
  8784. ΓòÉΓòÉΓòÉ 12.9. User Exit Changes ΓòÉΓòÉΓòÉ
  8785.  
  8786. User exits for OS/2 can now be executed synchronously (NSC waits for the user 
  8787. exit to terminate) or asynchronously (NSC processes the next definition without 
  8788. waiting for the user exit to terminate). The session for user exits for OS/2 
  8789. can also be specified to be start in the foreground or background. User exits 
  8790. may now return an errorlevel to NSC, with feedback to the user on the result of 
  8791. the user exit. The default is to start a session in the background and wait for 
  8792. it to terminate, and only display a message if the user exit cannot be 
  8793. executed. 
  8794.  
  8795.  
  8796. ΓòÉΓòÉΓòÉ 12.10. Host Information File Changes ΓòÉΓòÉΓòÉ
  8797.  
  8798. Support for dynamic session ids and substitution strings has been added to make 
  8799. host information files more flexible and allow a single host information file 
  8800. to be used for more than one host location. We have removed several restriction 
  8801. on strings, section ordering and screen definitions within host information 
  8802. files. Old host information files are fully supported. The host information 
  8803. file is described in Configuring EMULATOR Connections. 
  8804.  
  8805. New sample host information files are included that make use of substitution 
  8806. strings so that they can in general be used as-is for many host systems. These 
  8807. sample host information files are described in Sample Host Information Files.