home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Security / Security.zip / sec30250.zip / seinst.inf (.txt) < prev    next >
OS/2 Help File  |  2001-10-24  |  806KB  |  14,674 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Before you begin ΓòÉΓòÉΓòÉ
  3.  
  4. Before installing SecureEntry in a given machine, you should read carefully 
  5. this on-line manual, and be sure that all prerequisites are met. Notice that 
  6. this is a quite impressive piece of software, but because of its nature, it is 
  7. very important that you know what you are doing when using it. 
  8.  
  9. Also look for a file named  README.DOC in the first installation diskette, for 
  10. last minute changes and detailed driver changes description. 
  11.  
  12.      Copyright 
  13.  
  14.      What is SecureEntry 
  15.  
  16.      IMPORTANT : Delivery policy, beta components and packaging 
  17.  
  18.      Hardware requirements 
  19.  
  20.      Software requirements 
  21.  
  22.      If you had a previous version... 
  23.  
  24.      If you had a previous UCM version... 
  25.  
  26.  
  27. ΓòÉΓòÉΓòÉ 1.1. Copyright ΓòÉΓòÉΓòÉ
  28.  
  29. IBM SecureEntry for OS/2 Version 3
  30. 5793-R46 (C) Copyright IBM Corp. 1996
  31. All Rights reserved. US Government Users Restricted Rights -
  32. Use, duplication or disclosure restricted by GSA ADP
  33. Schedule Contract with IBM Corp.
  34. Licensed Materials - Property of IBM.
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 1.2. What is SecureEntry ΓòÉΓòÉΓòÉ
  38.  
  39. SecureEntry is a software product that enhances any OS/2 workstation, in 
  40. standalone or network configuration by providing it with an extensive set of 
  41. functions in the area of security and personalization. 
  42.  
  43. With SecureEntry you can define the users and groups of users that are allowed 
  44. to use the workstations, and at the same time, set up their working environment 
  45. in such a way that they will have the machines already configured to do the 
  46. work they are intended to, by also restricting the features and functions they 
  47. should not be able to access. 
  48.  
  49. By doing all of the above, SecureEntry does effectively convert a single user 
  50. machine into a workgroup machine, which is effectively then a serially shared 
  51. multiuser machine. From the end user's perspective, all what changes from his 
  52. normal way of working is that an identification will be required before 
  53. starting a work session, being at that point when SecureEntry will establish 
  54. what security profiles to activate, thus setting up the environment for the 
  55. user working in the workstation. 
  56.  
  57. SecureEntry has been designed in such a way that security components can easily 
  58. be 'plugged in' so that if a given software or hardware piece is to be 
  59. secure-controlled, a new security component can be written and incorporated 
  60. easily to the architecture. As a sample, you can easily write and define to 
  61. SecureEntry an interface to your Netscape bookmark file so that each user 
  62. logging into any workstation will have his personal bookmarks activated for 
  63. him. The following security components are included in the base product : 
  64.  
  65.      Desktop restrictions component : Allows to restrict the properties of the 
  66.       objects existing in the OS/2 Workplace Shell desktop in a per user/group 
  67.       basis. For instance, you could define some objects to be visible for some 
  68.       users and invisible for others. 
  69.  
  70.      The Personal desktop component : Allows the definition of 'personal 
  71.       folders', as well as their contents, so that those folders will 'travel' 
  72.       with the user no matter in which machine does the user log on (supposing 
  73.       SecureEntry is installed in a networked environment). This folders are 
  74.       also known as memory and/or user folders. 
  75.  
  76.      The Launchpad component : Allows you to define a given Workplace Shell 
  77.       Launchpad for each user or group of users, so that each one has always 
  78.       the launchpad that better suits their working needs. 
  79.  
  80.      The Window list component : This component's purpose is to personalize 
  81.       the switch list behavior, with a wide range of options, that can vary 
  82.       from the inhibited state to a full-function one. You can, among other 
  83.       things, select which entries are allowed to appear in the switch list, 
  84.       and whether you permit it to be used only as a task switcher, or do 
  85.       specific manipulations with the appearing programs. You can also change 
  86.       the aspect of the switch list. 
  87.  
  88.      Windows behavior component : Also called restricted window frames, allows 
  89.       you to set up the initial position/size of any application frame window, 
  90.       as well as inhibit any of their system menu entries. For instance, you 
  91.       may be interested in not letting users to 'play' with a given application 
  92.       fonts, by deactivating that application's 'Fonts' menu entry. 
  93.  
  94.      SES behavior component : This component allows for customizing general 
  95.       operating parameters for the system, such as the desired Ctl-Alt-Del 
  96.       behavior, systemwide hot keys, or screen saver bitmaps and activation 
  97.       settings, in a per user or group basis. 
  98.  
  99.      Floppy restrictions component : This component works at a device driver 
  100.       level in order to avoid or allow floppy drive access depending on the 
  101.       customized profile for the user logged on. It allows also access in 
  102.       encrypted mode. 
  103.  
  104.      Treelock component : Working at a file system level, this component 
  105.       allows the administrator to define which part(s) of the existing file 
  106.       system is the user allowed to read, look at, write or execute, in a per 
  107.       process basis. For instance, you could define a given user to only be 
  108.       able to write to certain directories when working with a given word 
  109.       processor program. This component is also referred to as 'Tree_lock'. 
  110.  
  111.      The shortcuts component : This component allows for definition of 
  112.       shortcut keyboard/mouse combinations that allow for opening of the 
  113.       desired objects when issued. 
  114.  
  115.      The Hooked objects component : This component allows for the 
  116.       configuration of hooks to certain objects, so that a user chosen program 
  117.       is launched at object open or close time. This allows for easily setting 
  118.       up protected folders through one time password mechanisms. One 
  119.       implementation of such a tool is also supplied as part of this component. 
  120.  
  121.      The WarpCenter component : By using this component, you can define 
  122.       personalized warpcenters that match your security criteria, and then 
  123.       assign the resulting profiles to different users or user groups. 
  124.  
  125.      The Public Applications component : This component handles the 
  126.       administration of LAN Server Public Applications, allowing an 
  127.       administrator to assign a set of LAN Server Public Applications to users 
  128.       and groups of users. 
  129.  
  130.      The Processes Auditor component : This component allows you to measure 
  131.       the CPU utilization time by different processes on a user basis. 
  132.  
  133.      The Lotus Notes component : This component allows you integrate a user's 
  134.       NOTES.INI, .ID file and/or password in such a way that these data 
  135.       effectively travel with your user. The component will automatically 
  136.       provide the user password to Lotus Notes whenever it requests it, without 
  137.       user interaction. 
  138.  
  139.  Other than the above mentioned components, which are programs that in the end 
  140.  you can profile in a per user/group basis, SecureEntry would not be complete 
  141.  without another set of programs which allow you to fully 'lock' the 
  142.  workstation from a security point of view. These are : 
  143.  
  144.      Startup process : Substitutes the OS/2 'startup.cmd' default processing 
  145.       by enabling the processing of a command file which can not be interrupted 
  146.       by the user, thus making the complete boot process a secure one, and at 
  147.       the time allowing for startup messages and progress indicators to be 
  148.       shown. 
  149.  
  150.      Session control programs : These are really the 'heart' of a SecureEntry 
  151.       system, allowing for users identification and control, plus functions 
  152.       such as logoff, lockup, shutdown,... in a secure way. 
  153.  
  154.      Administration subsystem : Allows you to easily define and assign the 
  155.       security profiles for the different components to your users and groups 
  156.       of users, through a common and integrated view, which is independent from 
  157.       the SecureEntry installed environment. This subsystem includes graphical 
  158.       interactive and also batch tools to do the administration. 
  159.  
  160.      File integrity check tools : Which you can use to grant critical files 
  161.       integrity at certain intervals. 
  162.  
  163.      Other tools : Such as the VDM utilities or the selective application 
  164.       closer, can be used to end up the integration of the SecureEntry software 
  165.       with your own production software. 
  166.  
  167.      Programming APIs : SecureEntry provides also with a set of comprehensive 
  168.       programming interfaces and user exits which can be used to Taylor its 
  169.       behavior to the required customer's needs. 
  170.  
  171.  Combine these with the broad scope of environments supported, and the provided 
  172.  level of user customization and code exits that allow for perfect customer 
  173.  control, and you will envision the new meaning that SecureEntry gives to the 
  174.  concept of 'Workstation security'. 
  175.  
  176.  SecureEntry is a very complex package, and for its nature, you are encouraged 
  177.  to read this document carefully before attempting to install and run this 
  178.  package. 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ 1.3. IMPORTANT : Delivery policy, beta components and packaging ΓòÉΓòÉΓòÉ
  182.  
  183. Delivery policy 
  184.  
  185.  It is important to notice that SecureEntry, as a package, is not being 
  186. developed following the traditional versioning scheme of other products. Due to 
  187. its modular nature, we are allowed to follow a more flexible and customer 
  188. oriented policy. That is : 
  189.  
  190.  We are not providing with new or repackaged versions of the product in a 
  191. timely basis. Instead, we distribute quite frequently new builds which are a 
  192. complete replacement for the old ones. A new build can be used to install a new 
  193. machine or service a previous SecureEntry installed one. This new builds 
  194. incorporate : 
  195.  
  196.      Fixes to existing reported problems 
  197.  
  198.      New functions 
  199.  
  200.  For the first ones, i.e fixes, you are recommended to install the new build 
  201.  only if you have faced the reported fixed problems, which are described within 
  202.  the README.DOC file supplied with that build level, unless otherwise stated. 
  203.  
  204.  For the second ones, i.e new functions, these will be installed with the new 
  205.  build, but will be in 'beta' i.e not fully granted state for a while. The 
  206.  functions that are still in beta will be also properly documented within the 
  207.  above mentioned readme file. 
  208.  
  209.  As a last fact, note that we will only accept problem reports for production 
  210.  machines on functions that are not in beta. Likewise, you are only allowed to 
  211.  use these new functions appearing after your SecureEntry contract, as long as 
  212.  you have contracted SecureEntry evolutive maintenance. 
  213.  
  214.  Packaging : Evaluation vs. Production copies 
  215.  
  216.  SecureEntry has two different licensed package types : 
  217.  
  218.      An evaluation copy is full functional but only valid for a granted amount 
  219.       of days, being it normally of 180 days after build creation. After this 
  220.       period, you will start receiving messages about the fact that either the 
  221.       product has to be deinstalled, or properly licensed. Note that you are 
  222.       not allowed to run an evaluation copy in a production environment. 
  223.  
  224.      A production copy does not expire. 
  225.  
  226.  You can service a machine with an evaluation copy using a production copy, and 
  227.  the machine will automatically become licensed. Similarly, you can service a 
  228.  production copy with an evaluation one, and the machine will remain a 
  229.  production copy enabled one. 
  230.  
  231.  You can verify the type of package to install by looking into the ASCII file 
  232.  SENTRY.SIG, located in all of the distribution diskettes. After installing, 
  233.  this file is placed in the SecureEntry path, INSTALL directory. 
  234.  
  235.  UCM code 
  236.  
  237.  Note that the distribution policy for UCM code is slightly different : 
  238.  
  239.      There is no evaluation version of the UCM-MVS/ESA code. This code is only 
  240.       supplied to contracted customers. If you want to checkout the 
  241.       functionality provided by UCM, please proceed to install the UCM-OS/2 
  242.       code, which is supplied with SecureEntry/2. 
  243.  
  244.      For the UCM-OS/2 code, the code is supplied completely with SecureEntry/2 
  245.       drivers, either evaluation or production ones. However, the UCM-OS/2 code 
  246.       as provided is locked and can be used only for evaluation purposes for a 
  247.       period no longer than 180 days after package creation date. Once 
  248.       evaluated, and if you choose to contract the solution, you will be able 
  249.       to unlock the code as explained in the UCM administrator guide. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 1.4. Hardware requirements ΓòÉΓòÉΓòÉ
  253.  
  254. The following is necessary to run this version of SecureEntry : 
  255.  
  256.    1. A machine with 12 MB of memory (or more) and a 486-level processor 
  257.       (minimum) 
  258.  
  259.    2. Disk space free of at least 11.5 Mb (2 Mb additional required if you plan 
  260.       on installing the SecureEntry tutorial) 
  261.  
  262.    3. LAN hardware for LAN installations. 
  263.  
  264.  Note that when using WorkSpace On-Demand, you may also use Intel(c) 
  265.  architecture Network Station client machines such as the IBM Network Station 
  266.  series 2800 thin client, which has been fully tested as a RIPLable client, 
  267.  SecureEntry enabled of a WorkSpace On-Demand server. 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 1.5. Software requirements ΓòÉΓòÉΓòÉ
  271.  
  272. The following (or upper level) software must be installed in the machines were 
  273. you intend to install SecureEntry 3.0 on : 
  274.  
  275.    1. OS/2 WARP with Fixpack 17 or superior. The minimum screen resolution 
  276.       supported for administration tasks is of 800 x 600. 
  277.  
  278.    2. OS/2 SES (Security Enabling Services). This is only mandatory if you 
  279.       choose to use it at installation time instead of the SecureEntry provided 
  280.       SES emulator. 
  281.  
  282.    3. IBM LAN Server/Requester 4.0 Only for Lan Server type SecureEntry 
  283.       installs. The Server must be installed in the machine intended for 
  284.       SecureEntry Server function. 
  285.  
  286.    4. WorkSpace On-Demand, only if you wish to use SecureEntry WorkSpace 
  287.       On-Demand support. For WorkSpace On-Demand 1.0, the OS/2 Warp 4 code that 
  288.       execute the WorkSpace On-Demand requesters must be at FixPak 8 level 
  289.       minimum (FixPack 9 is recommended however to avoid memory leak problems). 
  290.       For WorkSpace On-Demand 2.0, then you won't need any additional FixPak 
  291.       for the OS/2 Warp 4 code that the WorkSpace On-Demand requesters execute. 
  292.  
  293.    5. If using the Processes Auditor Component, you are strongly encouraged to 
  294.       have Fixpak 40 for Warp 3.0, or Fixpak 10 for Warp 4.0. 
  295.  
  296.    6. If using the Editor of the Lotus Notes Component, you will need the Java 
  297.       runtime environment. Supported Java versions: 
  298.  
  299.           Java 1.2, also known as Java2. 
  300.  
  301.           Java 1.1.7A. In this case you will also need to have Swing 1.0.3 
  302.            installed. 
  303.  
  304.    7. If using the SecureEntry Java APIs, you will need the Java2 1.3 runtime 
  305.       environment. 
  306.  
  307.    8. If installing the UCM feature, then you also need : 
  308.  
  309.         a. DDCS/2 single user in the UCM administration workstations 
  310.  
  311.         b. The following Host computer software : 
  312.  
  313.              1. MVS/ESA 
  314.  
  315.              2. DB2 
  316.  
  317.              3. RACF V1.9.2 or later (if using RACF validation). 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 1.6. If you had a previous version of SecureEntry installed. ΓòÉΓòÉΓòÉ
  321.  
  322. If you had SecureEntry 2.0 or 1.0 installed: 
  323.  
  324. You must deinstall it before upgrading. Use the appropriate tool supplied with 
  325. your current version of SecureEntry to do so. Note that desktop restriction 
  326. profiles you may already have in your installation are fully compatible with 
  327. SecureEntry 3.0, as well as Launchpads. SecureEntry 3.0 can migrate those 
  328. together with your users definitions to the new database format. To do so, you 
  329. must run the 'MIGRADB.CMD' program once in the SecureEntry Server machine after 
  330. reinstalling the new version. Note that this tool expects the environment 
  331. variable 'SGM_LS' to be set and pointing to the directory where the 'old' 
  332. SecureEntry users information was stored. (take note of its setting before 
  333. deinstalling the current version). 
  334.  
  335. If you had an 'alpha' version of SecureEntry 3.0 installed (builds 35..72) : 
  336.  
  337. Do the following : 
  338.  
  339.    1. Save, if necessary, the file 'x:\SGMSHELL\NOUSER\EDYREGDB.VLB' (only if 
  340.       it exists and you want to keep on working with it after installing. Note 
  341.       that this file is the database for all the users and groups security 
  342.       components. If you decide so to maintain it, remember to enter as 
  343.       institution name at installation time, the string 'SER' (three 
  344.       characters), so that the master key used to decipher this file is 
  345.       compatible with the one used to encipher your old database. 
  346.  
  347.    2. Save the files 'x:\SGMSHELL\DLL\EDYCUST.DLL' and 
  348.       'x:\SGMSHELL\EXEC\EDYCUST.CMD' if you have used the SecureEntry user 
  349.       exits to do anything special and wish to keep on doing it after 
  350.       installing. 
  351.  
  352.    3. If you have a user written file 'x:\SGMSHELL\EDYFILT.DLL', save it also. 
  353.  
  354.    4. Save also the file 'EDYSTART.CMD', from the boot drive root directory, 
  355.       for if you have some code there that you wish to keep. 
  356.  
  357.    5. If you have machine security profiles (located in the nouser directory), 
  358.       copy those to the first SecureEntry 3.0 installation diskette within a 
  359.       directory named 'NOUSER' which you will have to create. Then at 
  360.       installation time these profiles will be copied were they belong. 
  361.  
  362.    6. Execute the command 'UNINSTAL.CMD' located in the first SecureEntry 3.0 
  363.       diskette. It may give you some warnings, and errors about commands not 
  364.       found, but upon a shutdown and reboot, will be able to deinstall 
  365.       SecureEntry alpha from your machine. 
  366.  
  367.    7. After rebooting, notice that SecureEntry alpha is no longer in the 
  368.       machine. Note that this is not exactly the case, since some warnings 
  369.       appeared in the previous steps, but enough is done so that reinstalling 
  370.       will succeed. Now, proceed with the installation. 
  371.  
  372.    8. Then install the actual copy of SecureEntry, by following the steps 
  373.       explained under 'Installing SecureEntry'. 
  374.  
  375.    9. After installing this version of SecureEntry, and before rebooting, 
  376.       recopy the above saved files : 
  377.  
  378.           Place the user exit code where it belongs, after migrating it 
  379.            manually (note that there are some new entry points and that 
  380.            security components do not any longer require to be activated here). 
  381.            These are the 'EDYCUST.*' files. 
  382.  
  383.           Place your original 'EDYSTART.CMD' file again in the boot drive root 
  384.            directory. 
  385.  
  386.           Place your personal 'EDYFILT.DLL' in the 'DLL' directory. 
  387.  
  388.           If you have an 'EDYREGDB.VLB' file saved (security components 
  389.            database), then place it in the 'NOUSER' directory. (Note that you 
  390.            may have to remove the READONLY attribute from this file) 
  391.  
  392.  If you had a previous 'beta' or GA version of SecureEntry 3.0 (builds 72..) : 
  393.  
  394.  Follow the service procedure to update your software. This is explained 
  395.  afterwards, under Providing service to a SecureEntry 3.0 machine. 
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ 1.7. If you had a previous version of UCM installed. ΓòÉΓòÉΓòÉ
  399.  
  400. If you have UCM 3.0 already installed, and you want to migrate to UCM V4R0 
  401. revision, then you must follow the steps explained underneath: 
  402.  
  403.    1. Follow the service procedure explained in the UCM administrator guide to 
  404.       set up UCM V4R0 at your host site. 
  405.  
  406.    2. Follow the service procedure to upgrade your UCM administrator 
  407.       workstation software. This is explained afterwards under Setting up the 
  408.       User Centralized Management workstation. 
  409.  
  410.    3. You can skip this procedure if you do not plan to activate the new UCM 
  411.       Refresh Branch Online procedure, since what follows is a sample guideline 
  412.       of how to migrate your branches and activate the Refresh branch online 
  413.       procedure: 
  414.  
  415.           You have to migrate your branches to SecureEntry build level 191 or 
  416.            higher. You can do this task by applying SERVICE to your machines, 
  417.            as explained under Providing service to a SecureEntry 3.0 machine. 
  418.            Note that the service procedure does not add the policy refresh 
  419.            parameter to the appropriate server's edystart.cmd line (EDYSRV load 
  420.            sentence). You can force this change by adding the appropriate rexx 
  421.            code to a service hook (POSTSERV.CMD), as explained under 
  422.            Personalized installations. The EDYSRV refresh policy parameters are 
  423.            explained under EDYSRV and EDYFREE. 
  424.  
  425.           While you are activating the refresh procedure, you can use both 
  426.            methods to update the branches definitions (group and resource 
  427.            definitions): the refresh branch online (EDYSRV.EXE with refresh 
  428.            parameter) and the batch process (EDYUCDIS.EXE, UCMP01, ... ) 
  429.            method. 
  430.  
  431.            Both methods can live together while you are changing the load 
  432.            parameter for EDYSRV process. You have to be aware of the fact that 
  433.            the UCM change tables at the host can not be deleted until the 
  434.            migration has been ended and you are still using the batch update 
  435.            process. To grant it, you can follow the next steps: 
  436.  
  437.              -  When you run the UCMP01 and UCMP02 batch processes to get delta 
  438.                 information of your branches, the Force Delete parameter must 
  439.                 be specified with 'N' value. 
  440.  
  441.              -  Do not change the threshold branch number. This parameter of 
  442.                 the policy refresh must remain set to '0000' value. This is to 
  443.                 prevent the deletion of the UCM change tables through the 
  444.                 refresh branch online process. 
  445.  
  446.              -  Once you have activated the refresh parameter for EDYSRV 
  447.                 process at all of your branches, and no longer expect to use 
  448.                 the batch update process, you can then modify the threshold 
  449.                 branch number value to activate the purge process of the UCM 
  450.                 change tables and set it to the appropriate value (number of 
  451.                 installed branches). You can do this by using the UCM users and 
  452.                 groups management tool. 
  453.  
  454.  
  455. ΓòÉΓòÉΓòÉ 2. Installing SecureEntry ΓòÉΓòÉΓòÉ
  456.  
  457. The SecureEntry install process is composed of two different subprocesses : 
  458.  
  459.      First, the SecureEntry installation setup, which is always interactive, 
  460.       allows you to define the parameters and characteristics for your 
  461.       installation(s), ending up by writing a response file for the second 
  462.       part. The module that does this work is INSTALL.EXE. This module invokes, 
  463.       if the user chooses to do so, the second part of the installation in 
  464.       order to setup the actual machine. 
  465.  
  466.      Then, the SecureEntry workstation installation process, where the 
  467.       SecureEntry files are transferred to the system, and the environment is 
  468.       set up in the machine so that after rebooting the machine, SecureEntry 
  469.       will be installed, enabled and running. This part of the installation can 
  470.       be either interactive or batch (no user intervention). INSTALB.EXE is the 
  471.       module in charge of this part. 
  472.  
  473.      Installation environments 
  474.  
  475.      Regular installations 
  476.  
  477.      Personalized installations 
  478.  
  479.      Workstation installation utility 
  480.  
  481.      Setting up the User Centralized Management workstation 
  482.  
  483.      Setting up a backup domain controller for Lan Server 
  484.  
  485.      Providing service to a SecureEntry 3.0 machine 
  486.  
  487.      What to do if installation fails 
  488.  
  489.  
  490. ΓòÉΓòÉΓòÉ 2.1. Installation environments ΓòÉΓòÉΓòÉ
  491.  
  492. One of SecureEntry's strongest points is its flexibility. That is, the ability 
  493. of this software to run in different environments and to be adapted to fit 
  494. different security requirements. The following picture shows the different 
  495. suitable scenarios for installation. 
  496.  
  497. The best part of all this is that administering/working with one, one hundred 
  498. or ten thousand workstations is exactly done the same way, irrelevant of the 
  499. environment, with the same tools and easiness, except for few exceptions. 
  500.  
  501. This chapter provides detailed description for the different environments: 
  502.  
  503.      Standalone environment 
  504.  
  505.      IBM Lan server environment 
  506.  
  507.      Network environment.Other networks 
  508.  
  509.      Special (centralized) environments 
  510.  
  511.  
  512. ΓòÉΓòÉΓòÉ 2.1.1. Standalone environment ΓòÉΓòÉΓòÉ
  513.  
  514. Being the simplest one, this working environment is intended for not networked 
  515. machines, in which administration and runtime are done from the same 
  516. workstation, which also holds the security database were the different security 
  517. profiles are stored. This environment is very well suited for home machines, 
  518. mobility professionals with shared portable workstations, and as a SecureEntry 
  519. demonstration and training environment. 
  520.  
  521.  
  522. ΓòÉΓòÉΓòÉ 2.1.2. IBM Lan server environment ΓòÉΓòÉΓòÉ
  523.  
  524. Under a Local area network environment, and if the network software running is 
  525. the IBM Lan Server/requester one, then SecureEntry can be installed as a 
  526. 'back-pack' to the network software, providing additional local security 
  527. function. This is achieved by synchronizing SecureEntry and UPM signons, and 
  528. allowing for Lan server administration through the SecureEntry administration 
  529. tools. 
  530.  
  531. After installing SecureEntry this way, all Lan Server users and groups will be 
  532. automatically considered SecureEntry users and groups, with the added 
  533. possibility of being assigned some or all of the SecureEntry local security 
  534. component profiles. 
  535.  
  536. It is important to note that under this kind of environment, you are not 
  537. maintaining a 'couple' of secured and unrelated workstations, but instead 
  538. creating a 'workgroup' of workstations which share a common security profiles 
  539. repository. This is why one of the machines in the network plays the role of a 
  540. 'server' of security profiles, being this one the machine where the SecureEntry 
  541. database is created. This machine will have to be necessarily powered on and 
  542. with the Lan Server software running at the time when other machines are to be 
  543. connected, so that the user's signon information is available. This is the 
  544. reason why the normal choice for the SecureEntry repository server machine is 
  545. the domain controller machine, but being this not a mandatory option. 
  546.  
  547. From the administrator's point of view, this environment is not much more 
  548. different from the standalone environment, being the main differences : 
  549.  
  550.      The graphical administrator tool will now show buttons to configure Lan 
  551.       Server specific resources and user's characteristics (resource alias and 
  552.       user's parameters). 
  553.  
  554.      The batch administration tool will accept a couple of new keywords to 
  555.       configure Lan Server specific resources. 
  556.  
  557.      Group names will have to be named beginning with the letters 'SG', to 
  558.       identify them as a SecureEntry group definition which can accept security 
  559.       component profiles. 
  560.  
  561.      Since the underlying users and groups database is now that of the Lan 
  562.       Server (UPM), then its rules are enforced (naming, hierarchy, and 
  563.       allowable value ranges). 
  564.  
  565.      Since the security profiles are to be used by all the machines in the 
  566.       network, you should plan for them and provide all the machines in the 
  567.       Secure Entry network with the necessary objects to activate those 
  568.       profiles. For instance, you will achieve the best results by 'cloning' 
  569.       the workstations so that their basic desktop looks the same. 
  570.  
  571.  As a last comment, note that you can configure a Lan Server machine as a 
  572.  backup controller, in order to be able to keep on working in the event that 
  573.  the domain controller fails. Refer to Setting up a backup domain controller 
  574.  for Lan Server for a detailed description of how to do so. 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 2.1.3. Network environment. Other networks ΓòÉΓòÉΓòÉ
  578.  
  579. If you have a network of connected workstations which are not running under IBM 
  580. Lan Server, you can configure SecureEntry also as a 'workgroup' of 
  581. workstations, i.e, sharing a common repository for security components, but in 
  582. this case using the network software only as a 'transport' mechanism to allow 
  583. access to this repository. The idea being that you configure the workstations 
  584. so that a shared directory path exists and is used to access and establish the 
  585. logged on user's security profiles, but without the ability (from SecureEntry 
  586. point of view) of administering the alien network resources. 
  587.  
  588. This configuration is really much similar to that of a standalone installation, 
  589. being the only exception the fact that SecureEntry users, groups and security 
  590. profiles are defined within the shared directory. 
  591.  
  592. If you want to further integrate SecureEntry with your network software, you 
  593. can always write a specific 'LMP' (logon modular procedure) which does the 
  594. network signon to your own network. Samples are provided within the Secure 
  595. Entry installation directory, and an explanation of the process is provided 
  596. later on. 
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 2.1.4. Special environments ΓòÉΓòÉΓòÉ
  600.  
  601. There is one more consideration to take into account when describing the 
  602. working environments : If you have contracted UCM (Users Centralized 
  603. Management), then you have two more options : 
  604.  
  605. One is to do password validations to RACF or similar software running at the 
  606. host site. This requires an APPC link to the host running in the server 
  607. machine, plus the activation of a few additional components in the network. Of 
  608. course, using this option alone implies that you are responsible for 
  609. maintaining a user's definition database at the host site which matches that 
  610. one existing in the network (although password synchronization will be done by 
  611. SecureEntry itself). Optionally, you can still do user/password validation at a 
  612. host level if using UCM by means of the UCM provided RACF emulator. 
  613.  
  614. The second one is to activate central administration of users, groups and 
  615. security profiles, so that all administration changes are stored at the host 
  616. site, within a DB2 database by using the UCM software, and the local Secure 
  617. Entry databases existing in the administered networks are used as 'shadows' of 
  618. this central database. Just by doing this the concept of 'security workgroup' 
  619. is migrated into that of a 'corporate security policy', allowing any of the 
  620. defined users to sign on to any of the workstations of any of the corporation 
  621. networks. 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 2.2. Regular installations ΓòÉΓòÉΓòÉ
  625.  
  626. Before proceeding with SecureEntry installation, and if you have contracted the 
  627. UCM solution, read and perform the UCM installation procedure in order to 
  628. prepare the prerequisite software in the workstations as well as in the host 
  629. system. 
  630.  
  631. Right before installing SecureEntry 3.0, verify that you have installed the 
  632. prerequisite software, and also take into account : 
  633.  
  634.    1. Take note of and remove any software that you may be starting from the 
  635.       startup folder of the WorkPlace shell. Since you are installing in a 
  636.       machine to be used by several users, you probably may want to start those 
  637.       applications from a SecureEntry user exit, from the EDYSTART.CMD 
  638.       procedure which will substitute the regular STARTUP.CMD, or from the 
  639.       SecureEntry EdyStart folder, which will be installed by the product as a 
  640.       substitute for this function. 
  641.  
  642.    2. If you are installing under IBM Lan Server environment, and wish to 
  643.       install a SecureEntry server (not necessary for requesters), and you have 
  644.       IBM Lan server local security enabled (i.e, the server has HPFS386 
  645.       installed), then you need to logon to Lan Server as an administrator in 
  646.       order for SecureEntry installation process to be able to to create the 
  647.       'SGMSHELL' alias, where the SecureEntry database will reside. 
  648.  
  649.    3. In the same case, (IBM Lan Server installs), make sure that no groups 
  650.       exist defined that begin by the letters 'SG', so that they will not be 
  651.       confused with SecureEntry groups later on. 
  652.  
  653.    4. If you are installing SecureEntry in a WorkSpace On-Demand server, and 
  654.       wish to enable the different WSOD workstations for SecureEntry later on, 
  655.       then take into account the following restrictions : 
  656.  
  657.           WorkSpace On-Demand should be completely installed before proceeding 
  658.            with the SecureEntry install process. 
  659.  
  660.           You must use the Security Enabling services SecureEntry emulator in 
  661.            your installation. (Basically, uncheck the Use OS/2 Security 
  662.            Enabling Services checkbox, as explained underneath). 
  663.  
  664.           You must install SecureEntry in a directory named SGMSHELL within 
  665.            the IBMLAN\RPL\BBxx.yy directory. This directory is the one proposed 
  666.            by the installation tool if WorkSpace On-Demand is detected. 
  667.  
  668.       Later on, and after completing the installation process, read WorkSpace 
  669.       On-Demand support to know how to enable the different WSOD workstations 
  670.       for SecureEntry. 
  671.  
  672.  Once you are ready to install, just by typing : 
  673.  
  674.         INSTALL [response file path-name]
  675.  
  676.  from the first SecureEntry installation diskette, all the installation 
  677.  processes will be chained, and you will be able to define your installation 
  678.  setup response file, and optionally configure the workstation (by 
  679.  automatically calling the next step : Workstation Installation utility). Note 
  680.  that the default response file if no other is specified, will be called 
  681.  'SENTRY.CNF' and placed where the INSTALL.EXE resides (disk and directory). 
  682.  
  683.  The first (interactive) part of the installation process looks like : 
  684.  
  685.  The fields that you can fill up in this panel are : 
  686.  
  687.      Institution name: Enter here the name of your institution. This, together 
  688.       with some other information, will be used in order to generate a private 
  689.       master key for ciphering your security profiles data base. This is the 
  690.       reason why this field can not be left blank. 
  691.  
  692.      Install from : Enter here the path to the source of the installation 
  693.       package files. 
  694.  
  695.      Install to: Enter here the destination directory where you want 
  696.       SecureEntry to be installed. Note that if WorkSpace On-Demand is 
  697.       detected, the default directory presented here will be 
  698.       IBMLAN\RPL\BBxx.yy\SGMSHELL, which will allow you to later on enable your 
  699.       SecureEntry client workstations. 
  700.  
  701.      Use OS/2 Security Enabling Services: Uncheck this button if you want to 
  702.       install SecureEntry with its Security Enabling Services emulator active, 
  703.       instead of the real thing. Everything will work the same, except for the 
  704.       superuser signal, as will be explained later on. Not using the real 
  705.       Security Enabling Services is specially useful for memory constrained 
  706.       systems, or when installing under OS/2 versions for which these services 
  707.       are not available, such as OS/2 SMP or the different WSOD clients. Note 
  708.       that using the emulator is also a prerequisite for installing in 
  709.       Coexistence mode with other SES clients. 
  710.  
  711.      Install treelock device driver: Only if your OS/2 kernel does NOT support 
  712.       the Security Enabling Services hooks, you will need to uncheck this 
  713.       button. 
  714.  
  715.      Install API development components: Uncheck this check button if you do 
  716.       not intend to develop with the SecureEntry APIs in the machine(s) to 
  717.       install the software in. This way, you will save some hard drive space 
  718.       and left out from the installing process the SecureEntry source code and 
  719.       API information. 
  720.  
  721.      Standalone environment: Check this radio button if you wish to install 
  722.       SecureEntry in standalone mode. (see SecureEntry environments 
  723.       descriptions). 
  724.  
  725.      Networked workstation. IBM LAN server: Check this radio button if you 
  726.       wish to install in IBM Lan Server environment. You are then also prompted 
  727.       for the following values : 
  728.  
  729.         -  Domain name: Enter here the name of your Lan Server logon domain. 
  730.  
  731.         -  Allow change at signon: Check this button if you wish to allow the 
  732.            user to be prompted for and sign on to other SecureEntry available 
  733.            domains. 
  734.  
  735.         -  SecureEntry repository server name: Enter here the name of your Lan 
  736.            Server domain controller computer, that is where the SecureEntry 
  737.            profiles database will be installed. 
  738.  
  739.      Networked workstation. Other networks: Check this radio button if you 
  740.       wish to install SecureEntry in Lan environment, non IBM Lan Server. You 
  741.       are also prompted for : 
  742.  
  743.         -  SecureEntry repository server path: Enter here the remote path to 
  744.            access the SecureEntry repository from any requester machine. 
  745.  
  746.      Use RACF for password validation: If you have contracted UCM, then you 
  747.       can check this button to allow RACF password validation at signon time, 
  748.       or leave it unchecked to use the provided RACF emulator for user/password 
  749.       validation, if UCM is also installed. Note that RACF is only available 
  750.       under MVS environments, so you can not choose this option when installing 
  751.       the UCM repository server under other environments. 
  752.  
  753.       Playing the same role as RACF validation, you can optionally make Network 
  754.       Signon Coordinator/2 act as your main password synchronizer. You do not 
  755.       need to have UCM contracted to do so. In this case, you will have to 
  756.       manually configure it as explained in the provided NSC/2 LMP. 
  757.  
  758.      Scramble communications: In case you use RACF for users authentication 
  759.       (previous checkbox), then you can optionally choose to make use of the 
  760.       SecureEntry scrambling facility ( EDYURACF) to scramble userids and 
  761.       passwords at transmission time, during signon. You do not need this 
  762.       feature if your APPC network is secure enough, or already using 
  763.       encryption at a lower level. 
  764.  
  765.       When using the RACF emulator provided by UCM, data scrambling will always 
  766.       be active by default. 
  767.  
  768.      Use UCM (MVS or OS/2) for users administration. If you have contracted 
  769.       UCM services, then you can check this button to allow for the workstation 
  770.       to be administered at signon time from a host site. If this is the case, 
  771.       then you may be interested in setting up the UCM environment variable 
  772.       SGM_UCM_THIS_BRANCH through a proper CONFIG.ADD file before installing 
  773.       each different branch machine, as explained under Personalized 
  774.       installations. 
  775.  
  776.  After you have filled this panel, you will be given the option to continue the 
  777.  installation process by automatically calling the workstation installation 
  778.  utility, or exiting. If you exit now, the SecureEntry response file will have 
  779.  been created, and you can optionally use it in other workstations invoking the 
  780.  workstation installation utility through a command line. 
  781.  
  782.  
  783. ΓòÉΓòÉΓòÉ 2.3. Personalized installations ΓòÉΓòÉΓòÉ
  784.  
  785. It may be the case that you desire to distribute your own profiles or certain 
  786. files with SecureEntry installation process. You can do so by following what is 
  787. explained herein. 
  788.  
  789. You can place in the first or last installation diskette whatever files you 
  790. want, within the directory were they will have to reside after installing. i.e, 
  791. in order to set up automatically a default SecureEntry launchpad profile as the 
  792. default one, copy it (EDYPAD.INI) into a directory named 'NOUSER' within the 
  793. first installation diskette. 
  794.  
  795. To distribute other component files which may not reside within the 
  796. SecureEntryPath directory, copy them into a created : 
  797.  
  798.      BOOT Directory, if you wish those files to be copied to the boot drive. 
  799.  
  800.      x$ Directory, if you want those copied to the 'x' drive. 
  801.  
  802.  If you want SecureEntry to add automatically some config.sys settings to the 
  803.  installed workstation, then create an ASCII file named CONFIG.ADD within the 
  804.  root directory of the first installation diskette, with the desired 
  805.  definitions. As a sample : 
  806.  
  807.  
  808.       Sample CONFIG.ADD
  809.       -----------------
  810.  
  811.       SET SGM_ALLOW_CAD=TRUE
  812.       SET SGM_PM_WAIT_B4_KILL=0
  813.       SET SGM_UCM_THIS_BRANCH=Branch 22, Johnson st. 4561
  814.  
  815.  Now, if you want to do more complex processing, you can always write a post 
  816.  installation REXX command file, and place it in the first installation 
  817.  diskette, so that it gets called after the installation process. The name of 
  818.  the called cmd file will be POSTINST.CMD for new installs, and POSTSERV.CMD 
  819.  for service (upgrade) procedures. At invocation time, this hooks will be 
  820.  called from the SecureEntryPath\INSTALL directory. 
  821.  
  822.  After doing this, you can proceed with the regular installation process as 
  823.  explained in the previous chapter. 
  824.  
  825.  
  826. ΓòÉΓòÉΓòÉ 2.4. Workstation installation utility ΓòÉΓòÉΓòÉ
  827.  
  828. INSTALB.EXE is the workstation installation utility which will do the file 
  829. unpacking process, and setup the workstation with the installation options 
  830. choosen in the previous step. To invoke it, type : 
  831.  
  832.       INSTALB [SERVICE] [OVERFROM:sourcepath] [OVERTO:destpath]
  833.               [response file path name] [SERVER] [BATCH]
  834.  
  835. Use the 'SERVER' parameter to install a SecureEntry server machine in lan 
  836. environments, and the 'BATCH' parameter if you want unattended installations 
  837. (no questions asked). 
  838.  
  839. The SERVICE parameter, together with the OVERFROM: and OVERTO: parameters are 
  840. used only to provide service to an already installed machine, by means of 
  841. overriding the source files and destination path with those specified through 
  842. the command line. 
  843.  
  844. Note that it is not normally necessary to invoke this process manually if 
  845. interactive installations are being done, since the installation setup utility 
  846. (INSTALL.EXE) will already chain to this module if the user selects to do it. 
  847. Keep on reading to know what to do after this process ends. 
  848.  
  849. The normal procedure to follow after this utility has run is to reboot the 
  850. machine, but if you are doing a network installation, you must make sure that 
  851. the file 'EDYSTART.CMD', located in the root directory of the boot drive 
  852. contains the appropriate sentences to start your network software before the 
  853. machine reboot. (i.e, 'NET START REQ' for requester installations, 'NET START 
  854. SRV' for server installations). 
  855.  
  856. Besides, if you are installing UCM and/or RACF validation features, you may 
  857. want to check that the comms manager startup command is also in the SecureEntry 
  858. startup file (EDYSTART.CMD). In the same case, and if you are installing the 
  859. administrator's machine for UCM within the control LAN, you will have to 
  860. manually setup this machine by following the Setting up the User Centralized 
  861. Management workstation procedure. 
  862.  
  863.  
  864. ΓòÉΓòÉΓòÉ 2.5. Setting up the User Centralized Management workstation ΓòÉΓòÉΓòÉ
  865.  
  866. You can skip this procedure if not installing the UCM feature for SecureEntry. 
  867.  
  868. To set up the user centralized management workstation, go through the following 
  869. steps: 
  870.  
  871.    1. Install DDCS/2. 
  872.  
  873.    2. Install LAN Server. 
  874.  
  875.    3. Configure Communications Manager. For details on configuring CM/2, refer 
  876.       to the UCM administrator's guide. 
  877.  
  878.    4. Configure DDCS/2 For details on configuring DDCS/2, refer to the UCM 
  879.       administrator's guide. 
  880.  
  881.    5. Install SecureEntry Release 3.0. 
  882.  
  883.    6. Log on as a user with administrator privileges. 
  884.  
  885.    7. Open the SecureEntry Workbench folder. 
  886.  
  887.    8. Make a copy of the Users and Groups Management folder and rename the new 
  888.       object to UCM Users and Groups Management. Open the new object settings 
  889.       notebook and change EDYSNADM.EXE to UCMADM.CMD in the Path and file name 
  890.       entry field of the Program tab. Enter as parameter : EDYSNADM.EXE. 
  891.  
  892.    9. If you want to use your own ASCII to EBCDIC and EBCDIC to ASCII 
  893.       conversion tables, you will have to place the following files in a 
  894.       directory named INSTALL of the installation diskettes: 
  895.  
  896.             EDYA2E.DAT
  897.              This file contains 256 character codes for ASCII to EBCDIC
  898.              translation.
  899.             EDYE2A.DAT
  900.              This file contains 256 character codes for EBCDIC to ASCII
  901.              translation.
  902.       By default, UCM uses its own Translation tables. Refer to the UCM 
  903.       administrator's guide to get information about how to install these 
  904.       translation tables at Host site. 
  905.  
  906.   10. From an OS/2 command prompt enter the statements to Bind the UCM API. 
  907.  
  908.   11. Run the INSTSUB.EXE program, which adds the host subsystems information 
  909.       to the UCM database, using the API previously installed on the 
  910.       workstation, and enables to verify the installation correctness. For do 
  911.       this, you can follow the next statements explained hereafter from an OS/2 
  912.       command prompt: 
  913.  
  914.              db2start
  915.              instsub
  916.              db2stop
  917.  
  918.   12. From an OS/2 command prompt, enter the statements to Bind the EDYQRYBR 
  919.       program. 
  920.  
  921.   13. From an OS/2 command prompt, enter the statements to Bind the EDYRVUCM 
  922.       program. 
  923.  
  924.  Refer to the UCM administrator's guide for details on how to set up the UCM 
  925.  product itself. 
  926.  
  927.  
  928. ΓòÉΓòÉΓòÉ 2.6. Setting up a backup domain controller for Lan Server ΓòÉΓòÉΓòÉ
  929.  
  930. If your installation environment is of Lan Server type, you may wish to set up 
  931. a machine as a backup domain controller, so that in the event that the main 
  932. domain controller is down, your users may still be able to work with their 
  933. machines. 
  934.  
  935. This kind of support is intrinsically provided by Lan Server, but and as 
  936. SecureEntry extends Lan Server repository with its own security profiles 
  937. database, it becomes necessary to make sure that this database is available 
  938. also when only the backup domain controller is working. 
  939.  
  940. The process to follow in order to set up the backup domain controller is as 
  941. follows: 
  942.  
  943.    1. Regular Lan Server backup domain controller setup 
  944.  
  945.         a. When installing Lan Server: 
  946.  
  947.                select "Backup domain controller" when it is requested. 
  948.  
  949.                install REPLICATOR and DCDB REPLICATOR. 
  950.  
  951.         b. Once Lan Server is installed 
  952.  
  953.                Define the Backup Domain Controller in the domain, as it should 
  954.                 be done for any additional server. 
  955.  
  956.         c. Tuning: several replicator parameters, such as replication interval, 
  957.            can be modified editing IBMLAN.INI. Refer to the Lan Server handbook 
  958.            for further information. 
  959.  
  960.         d. Runtime operative suggestions: 
  961.  
  962.                To set the Backup Domain Controller as the Domain Controller 
  963.                 (when the main domain controller is down) do the following 
  964.                 sentences in the Backup Domain Controller: 
  965.  
  966.                                         NET STOP NETLOGON
  967.                                         NET ACCOUNTS  /ROLE:PRIMARY
  968.                                         NET START NETLOGON
  969.  
  970.                To force DCDB replication: 
  971.  
  972.                                         NET STOP   DCDBREPL
  973.                                         NET START  DCDBREPL
  974.  
  975.                To resynchronize local and LAN Backup Domain Controller machine 
  976.                 passwords (they can mismatch after several days of Power-Off, 
  977.                 and this blocks replication) 
  978.  
  979.                                         LOGON an administrator
  980.                                         NET ACCOUNTS  /ROLE:STANDALONE
  981.                                         NET USER machine_name newpassword
  982.                                         NET ACCOUNTS  /ROLE:BACKUP
  983.                                         NET USER machine_name newpassword
  984.  
  985.    2. SecureEntry specific setup 
  986.  
  987.         a. Create the backup database repository alias in the backup domain 
  988.            controller. You can do this by running the command : 
  989.  
  990.                               NET ALIAS SGMSHBAK \\bdcname backupdirectory /WHEN:STARTUP
  991.  
  992.            Where bdcname is the server name of the backup domain controller. 
  993.  
  994.         b. Copy the SecureEntry database to the backup controller. Do this with 
  995.            a regular copy command : 
  996.  
  997.                               COPY  \\dcname\SGMSHELL\EDYREGDB.VLB \\bdcname\SGMSHBAK\EDYREGDB.VLB
  998.  
  999.            Where dcname is the server name of the main domain controller, and 
  1000.            bdcname is the server name of the backup domain controller. 
  1001.  
  1002.         c. Establish a mechanism by which the above is done in a regular basis. 
  1003.            You can use the Lan Server replicator services to do this. Refer to 
  1004.            the Lan Server documentation for how to do this. 
  1005.  
  1006.         d. Grant access to this backup repository to all desired users. As a 
  1007.            sample, you could do it for all the Lan Server users with the 
  1008.            following command : 
  1009.  
  1010.                               NET ACCESS SGMSHBAK /ADD USERS:RWA
  1011.  
  1012.       After all of the above is done, and in the event that the domain 
  1013.       controller fails, users will still be able to logon and be validated to 
  1014.       the backup controller. 
  1015.  
  1016.       Operating considerations 
  1017.  
  1018.       Take into account : 
  1019.  
  1020.           There is no necessity to change the role of the backup domain 
  1021.            controller once the main controller fails. 
  1022.  
  1023.           When logging on to the backup domain controller, you will receive a 
  1024.            message indicating so. Similarly, logon and logoff operations will 
  1025.            be slower than normal. 
  1026.  
  1027.           If you have logged on to the main controller and it fails, you will 
  1028.            not be able to use the administration tools until you logoff and 
  1029.            logon again against the backup controller. 
  1030.  
  1031.           If you use the administration tools against the backup controller, 
  1032.            the changes you make will not be automatically updated against the 
  1033.            main controller, unless, when the main controller is available again 
  1034.            you do: 
  1035.  
  1036.              a. Follow the regular resynchronization procedures for Lan Server 
  1037.                 users information. 
  1038.  
  1039.              b. Copy the modified .VLB SecureEntry repository file back from 
  1040.                 the backup controller on to the main controller. 
  1041.  
  1042.           When logging on to the backup domain controller, it may be that the 
  1043.            received error messages are less indicative than when using the main 
  1044.            controller, unless you start the EDYSRV program in the backup 
  1045.            controller. Note that only one EDYSRV program can be running within 
  1046.            a given domain at the same time, so before restarting the main 
  1047.            controller, you should unload it with the EDYFREE utility. Refer to 
  1048.            EDYSRV and EDYFREE. 
  1049.  
  1050.  
  1051. ΓòÉΓòÉΓòÉ 2.7. Providing service to a SecureEntry 3.0 machine ΓòÉΓòÉΓòÉ
  1052.  
  1053. You can use the supplied diskettes to provide service and update a previous 
  1054. version of SecureEntry 3.0, as long as it was beta version at least. Do the 
  1055. following : 
  1056.  
  1057.    1. Insert the first SecureEntry installation diskette 
  1058.  
  1059.    2. Type (supposing you are providing service from diskette drive A) : 
  1060.  
  1061.                   A:\SERVICE [sourcepath] [BATCH]
  1062.  
  1063.       Use the sourcepath parameter to specify the path where the new files are 
  1064.       located. By default the location of the SERVICE.CMD is used, unless 
  1065.       executing the installed copy of SERVICE.CMD within the SecureEntry path, 
  1066.       in which case 'A:\' is used. 
  1067.  
  1068.       Use the 'BATCH' parameter to run SERVICE.CMD in unattended mode. 
  1069.  
  1070.       The service procedure will be started and the SecureEntry software will 
  1071.       be updated. 
  1072.  
  1073.  This service procedure will respect your users definitions and profiles, as 
  1074.  well as your current CONFIG.SYS settings. Any personalized user exit file 
  1075.  (EDYCUST.xxx) or naming filter (EDYFILT.DLL) will have to be migrated 
  1076.  manually, since the service procedure will not override the one that is 
  1077.  currently being used. 
  1078.  
  1079.  If the files EDYKILL.NOT or EDYLOGS.STR residing in SecureEntryPath\NOUSER are 
  1080.  different from the default ones (have been customized for your installation), 
  1081.  they won't be automatically migrated either, so you will have to manually 
  1082.  apply the new changes incorporated into the default file, which will be 
  1083.  located in the SecureEntry path\EXEC directory for your reference. 
  1084.  
  1085.  WARNING: If you do code development in your machine, note that the API 
  1086.  directory will be overwritten by this procedure, so take a minute to backup 
  1087.  your modified sources before servicing. 
  1088.  
  1089.  Note that the service process will not be completed until you reboot the 
  1090.  machine after running the above mentioned command. After such reboot, all 
  1091.  previously locked DLLs will be replaced, and the temporary service directories 
  1092.  will be deleted, plus a subprocess named 'EdyStart' will be launched as soon 
  1093.  as the Workplace Shell is loaded. This subprocess mission is to make sure that 
  1094.  all workbench objects are refreshed and service changes applied to its 
  1095.  definition, so please let it run until it ends by its own and do not interrupt 
  1096.  it. 
  1097.  
  1098.  Note also that calling the SERVICE.CMD program is an alternative to calling 
  1099.  the INSTALB program with the appropriate parameters for servicing an already 
  1100.  installed machine, as explained in the previous section. 
  1101.  
  1102.  As a last comment, you will normally require administrator privilege for 
  1103.  running this process. For remote distribution environments, the service 
  1104.  procedure will work correctly independently of the logged on user as long as : 
  1105.  
  1106.    1. It is invoked in batch mode ('BATCH' parameter) 
  1107.  
  1108.    2. It is invoked from a superuser context process (i.e, started as a daemon 
  1109.       from EDYSTART, CONFIG.SYS or any superuser context user exit). Read About 
  1110.       processes and running contexts to know more about running contexts. 
  1111.  
  1112.  
  1113. ΓòÉΓòÉΓòÉ 2.8. What to do if the installation fails ΓòÉΓòÉΓòÉ
  1114.  
  1115. In any case, if the installation does not succeed, you will be able to browse 
  1116. the 'SENTRY.LOG' file located either in the boot drive root directory (for 
  1117. preliminary installation errors), or in your 'x:\SGMSHELL\INSTALL' directory, 
  1118. and look for the cause of the error. Note that if the error happens before the 
  1119. 'setup' phase, (the one immediately after the disk copy process), then you 
  1120. ought to be able to delete the directory, correct the error and retry. If the 
  1121. error happens after that point, the installation utility will do its best to 
  1122. leave you with an 'usable machine', but you are advised to take a quick look to 
  1123. your 'config.sys' file, and verify that it does not contain any SES-related 
  1124. line, and looks normal so that you can reboot the machine if necessary. If this 
  1125. was not the case, this critical file is backed-up into your 
  1126. 'x:\SGMSHELL\INSTALL' as 'config.sen', so you can recover it. (Same thing with 
  1127. the 'startup.cmd' file). 
  1128.  
  1129. If all of the above fails, please contact us and we will be very pleased to 
  1130. help you. 
  1131.  
  1132.  
  1133. ΓòÉΓòÉΓòÉ 3. What to do after installing ΓòÉΓòÉΓòÉ
  1134.  
  1135. After the installation is completed, you will have to reboot the machine, and 
  1136. on power up, a logon panel will be shown. The process to follow is : 
  1137.  
  1138.      Standalone workstations : Sign on as user 'EDYADMIN', password 
  1139.       'PASSWORD', changing it (this userid is created with the password 
  1140.       expired). Proceed to define other users, groups and security profiles. 
  1141.  
  1142.      Network server machines : Sign on as a network administrator, and proceed 
  1143.       to define the SecureEntry users, groups, and security profiles. 
  1144.  
  1145.      Network non server machines : You can start working straight away as with 
  1146.       any other net machine. 
  1147.  
  1148.  Once you have signed on as an administrator, you will have a newly created 
  1149.  folder on your desktop : SecureEntry Workbench. It contains : 
  1150.  
  1151.      One folder with the SecureEntry installation tools object, which also 
  1152.       contains a shadow to your original launchpad, plus a shadow of the 
  1153.       SecureEntry signature file. 
  1154.  
  1155.      One folder with the SecureEntry customization tools object, which 
  1156.       contains already customized program objects for you to use while making a 
  1157.       custom solution, with functions such as logon, logoff, etc.. 
  1158.  
  1159.      An icon for reviewing the last minute changes file (README.DOC) 
  1160.  
  1161.      A folder for each of the available components with its particular 
  1162.       workbench. Each of this folders contains basically the necessary icons to 
  1163.       test, create, and edit profiles of its kind through drag and drop 
  1164.       operations. Note that the 'Desktop restrictions workbench' folder is a 
  1165.       bit more complicated than that, since you can deal with text and binary 
  1166.       profiles. 
  1167.  
  1168.      Two icons representing the online reference documentation. 
  1169.  
  1170.      Two icons for invoking the administration tools (batch and interactive). 
  1171.  
  1172.      A shadow of the 'TEMPLATE' directory, where some sample profiles are 
  1173.       located, plus templates of the standard SecureEntry components for you to 
  1174.       create new profiles. 
  1175.  
  1176.      A shadow of the 'NOUSER' directory where you may wish to place the 
  1177.       machine-level security component profiles (default values). Note that in 
  1178.       order to be recognized, these profiles have to have a default name, which 
  1179.       is the same as that of the template for the given component that can be 
  1180.       found in the 'TEMPLATES' shadow folder. You will find within this folder 
  1181.       the EdyStart object, where you can place a shadow of all the objects that 
  1182.       you were starting previously through the system's startup folder. 
  1183.  
  1184.  
  1185.                    *************************************************
  1186.                     IMPORTANT
  1187.  
  1188.                     Whenever you change a NOUSER  security  profile,
  1189.                     remember to manually activate (test) it, in order
  1190.                     to grant that the profile is effectively read.
  1191.                    *************************************************
  1192.  
  1193.  
  1194.  The general idea is that you work and test with each of the component's 
  1195.  workbench, until familiar with it, and then create the profiles which you 
  1196.  later will assign to the different users and groups by dropping those into the 
  1197.  graphical (interactive) administration tool components container of a given 
  1198.  user or group. 
  1199.  
  1200.  To define the users, groups and security components, you can open the newly 
  1201.  created 'SecureEntry WorkBench' folder of the desktop, and use either the 
  1202.  batch or interactive administration tool. Refer to the SecureEntry 
  1203.  documentation on how to configure each component and how to assign them to 
  1204.  users and / or groups. 
  1205.  
  1206.  After installing, note that all components have their own default restriction 
  1207.  settings active at startup, being those : 
  1208.  
  1209.      For the floppy access, to allow no access to the diskette drive. Note 
  1210.       that the installation program places already a profile with full access 
  1211.       into the NOUSER template, so although the default is no access, you will 
  1212.       have access to it after signon. 
  1213.  
  1214.      For desktop restrictions, to apply no restrictions to existing objects. 
  1215.  
  1216.      For the Launchpad, to not present any launchpad. Note however, that 
  1217.       SecureEntry sets up a copy of your original launchpad in the installation 
  1218.       tools folder, so that if you wish to use it you can, either drop it into 
  1219.       the opened EdyStart object, or create a launchpad security profile with 
  1220.       the same contents and place it in the NOUSER folder or assign it to a 
  1221.       user/group, as explained afterwards. 
  1222.  
  1223.      The WarpCenter component will create a SecureEntry WarpCenter security 
  1224.       profile during the installation process with the same contents as your 
  1225.       original WarpCenter, and place it into the NOUSER folder, making it the 
  1226.       default WarpCenter. 
  1227.  
  1228.      For the System Menus, to not restrict any application. 
  1229.  
  1230.      For the Window list, to behave as standard in OS/2. 
  1231.  
  1232.      For SES behavior : 
  1233.  
  1234.         1. Lockup timeout set to 3 minutes, with standard size unlock dialog 
  1235.            and without logoff/shutdown buttons nor a maximum number of unlock 
  1236.            attempts. 
  1237.  
  1238.         2. Show options dialog at Ctrl-Alt-Del. 
  1239.  
  1240.         3. Show default bitmaps for lockup/screensaver. 
  1241.  
  1242.      For the File Access (treelock), to allow full access to anything except 
  1243.       the Implicit restrictions. 
  1244.  
  1245.      For the others, no special definitions active. 
  1246.  
  1247.  So, if you wish to use any of those, you may have to define and assign a 
  1248.  profile either to your group or userid, or to the machine configuration. The 
  1249.  easiest way to do it is to drag from the given component profile template 
  1250.  object located in the 'template' folder within the SecureEntry workbench 
  1251.  folder, an instance of the desired profile, and dropping it into the nouser 
  1252.  folder or your own user/group component container of the Users and Groups 
  1253.  Management application, and edit it from there. You can edit the profile 
  1254.  either by drag and dropping it into its editor (located in its component's 
  1255.  private workbench), or by double clicking over it (if within the Users and 
  1256.  Groups graphic administration tool). 
  1257.  
  1258.  
  1259. ΓòÉΓòÉΓòÉ 4. WorkSpace On-Demand support ΓòÉΓòÉΓòÉ
  1260.  
  1261. If you have installed SecureEntry in a WorkSpace On-Demand server (you can read 
  1262. how to do it under Regular installations), and wish to use it in the different 
  1263. WorkSpace On-Demand client machines, you will have to use the WorkSpace 
  1264. On-Demand SecureEntry enabler program to configure the different client machine 
  1265. images so that they effectively load SecureEntry at RIPL time. This utility is 
  1266. located within the SecureEntry installation tools folder of the SecureEntry 
  1267. workbench of the WSOD server machine. 
  1268.  
  1269. Note that all your WorkSpace On-Demand client machines will then use the 
  1270. server's copy of SecureEntry code, thus avoiding the necessity for installing 
  1271. SecureEntry separately for each client, and also making software updates 
  1272. easier. 
  1273.  
  1274. Under this environment you will also find a new folder in the SecureEntry 
  1275. workbench, named WSOD Workstations, that contains shadows of the different 
  1276. NOUSER folders for the different machines, which allow you to easily assign 
  1277. security components that define the default behavior for the related client 
  1278. workstations. You will find there also a shadow of the related workstation 
  1279. CONFIG.SYS file, and, if any, the startup command script file, EDYSTART.CMD. 
  1280.  
  1281. Note the Refresh program object present in this folder. It must be used 
  1282. whenever you enable your workstations indirectly, creating a workstation 
  1283. instance by deriving it from a machine type that has been SecureEntry enabled. 
  1284. In this case, the folder contents can be updated to reflect the new 
  1285. workstations by double-clicking over this icon. 
  1286.  
  1287. Once you have your workstations SecureEntry enabled, then configuring a 
  1288. specific WorkSpace On-Demand desktop is as easy as administering a SecureEntry 
  1289. public applications security profile using The Public Applications component, 
  1290. which you can then assign to the different users, SecureEntry groups, or even 
  1291. place them as default desktop profile for the different WSOD client machines, 
  1292. by copying it to the related workstation's NOUSER folder. 
  1293.  
  1294.      The WSOD enabler 
  1295.  
  1296.      Tips for administering SecureEntry WSOD environments 
  1297.  
  1298.  
  1299. ΓòÉΓòÉΓòÉ 4.1. The WSOD enabler ΓòÉΓòÉΓòÉ
  1300.  
  1301. The WSOD enabler application allows you to enable/disable WorkSpace On-Demand 
  1302. workstations or machine classes so that they effectively load SecureEntry at 
  1303. RIPL time. Note that you need administrator privilege to be able to run this 
  1304. utility. 
  1305.  
  1306. The first time the WSOD enabler is run, it will ask whether you want to enable 
  1307. the SecureEntry server for WorkSpace On-Demand. Upon positive response, it will 
  1308. process the required steps so that subsequently regular WSOD workstations 
  1309. and/or machine classes can be SecureEntry enabled. 
  1310.  
  1311. You can have at any moment any combination of enabled/disabled machine classes 
  1312. and/or workstations. Enabling a given machine class is only useful for avoiding 
  1313. the enable step for workstations of its kind that will be defined afterwards. 
  1314.  
  1315. Interactively calling the WSOD enabler 
  1316.  
  1317. The WSOD enabler, when called without parameters, will work in interactive 
  1318. mode, allowing for manual enabling/disabling of WSOD workstations or machine 
  1319. classes. 
  1320.  
  1321. You can run the program by typing : 
  1322.  
  1323.        SEWSODEN
  1324.  
  1325. From the SecureEntry path, INSTALL directory, or by double clicking its related 
  1326. object located within the SecureEntry Installation tools folder of the 
  1327. SecureEntry workbench 
  1328.  
  1329. You are then presented with the following dialog : 
  1330.  
  1331. Where the upper left listbox represents the currently defined WSOD machine 
  1332. classes, with an indication on whether that particular machine class has 
  1333. already been SecureEntry enabled. The upper right listbox represents the 
  1334. currently defined WSOD workstations for the selected machine class, also with 
  1335. an indicator of its current enabling state. The lower listbox contains 
  1336. information about the carried-on actions. You can then proceed with the 
  1337. following actions: 
  1338.  
  1339.      Enable class This button will cause the SecureEntry enabling of the 
  1340.       currently selected machine class, and up on request, also of its related 
  1341.       workstations. Once a given machine class is SecureEntry enabled, all the 
  1342.       workstations subsequently derived from it will also be SecureEntry 
  1343.       enabled. 
  1344.  
  1345.      Disable class This button will cause a given (selected) machine class to 
  1346.       be SecureEntry disabled, and also upon request, the disabling of its 
  1347.       related workstations. 
  1348.  
  1349.      Enable workstation This button will cause the selected workstation to be 
  1350.       SecureEntry enabled, so that upon the following boot, the workstation 
  1351.       will load SecureEntry as part of its RIPL process. 
  1352.  
  1353.      Disable workstation By pressing this button you can SecureEntry disable a 
  1354.       given (selected) workstation, so that it becomes again a 'regular' 
  1355.       WorkSpace On-Demand client, without SecureEntry. 
  1356.  
  1357.      Disable server If all your machine classes and workstations are 
  1358.       SecureEntry disabled, you will be able to use this button in order to 
  1359.       undo the server enabling process that was carried out the first time that 
  1360.       the WSOD enabler was run. When this process is ran, the application 
  1361.       terminates automatically. 
  1362.  
  1363.  Batch calling the WSOD enabler 
  1364.  
  1365.  Alternatively, you can call the WSOD enabler in batch mode, by invoking it 
  1366.  with the appropriate parameters : 
  1367.  
  1368.          SEWSODEN [ES | DS | EA | DA | EC:classname | DC:classname |
  1369.                    ECW:classname | DCW:classname | EW:wsname | DW:wsname | EX ]
  1370.  
  1371.  Where 
  1372.  
  1373.  ES        Can be used to force server enabling at load time, if necessary 
  1374.  
  1375.  DS        Can be used to force server disabling. Note that the program will 
  1376.            terminate afterwards 
  1377.  
  1378.  EA        Enable All, enables for SecureEntry all machine classes and 
  1379.            workstations found disabled 
  1380.  
  1381.  DA        Disable All, disables all machine classes and workstations found 
  1382.            SecureEntry enabled enabled 
  1383.  
  1384.  EC        Enable Class, enables for SecureEntry the specified machine class 
  1385.  
  1386.  DC        Disable Class, disables for SecureEntry the specified machine class 
  1387.  
  1388.  ECW       Enable Class Workstations, enables for SecureEntry the related 
  1389.            workstations of the specified machine class 
  1390.  
  1391.  DCW       Disable Class Workstations, disables for SecureEntry the related 
  1392.            workstations of the specified machine class 
  1393.  
  1394.  EW        Enable Workstation, enables for SecureEntry specified workstation 
  1395.  
  1396.  DW        Disable Workstation, disables for SecureEntry the specified 
  1397.            workstation 
  1398.  
  1399.  EX        When this parameter is processed, the program is exited 
  1400.  
  1401.  Note that all parameters are processed sequentially. For instance, the command 
  1402.  : 
  1403.  
  1404.           SEWSODEN  ES EC:MCAVGA ECW:MCAVGA EX
  1405.  
  1406.  Means : Run the enabler, enable the server if necessary, then SecureEntry 
  1407.  enable the WSOD machine class MCAVGA, follow on by enabling all the WSOD 
  1408.  workstations of the same type, and finally, exit, all in unattended mode. 
  1409.  
  1410.  Return codes and problem determination 
  1411.  
  1412.  The program will return 0 if no errors have been posted, otherwise the return 
  1413.  code will be the number of enable/disable errors encountered. 
  1414.  
  1415.  For problem determination, all activity will be logged in the SecureEntry 
  1416.  installation log file SENTRY.LOG, located in the INSTALL directory of the 
  1417.  current SecureEntry path. 
  1418.  
  1419.  
  1420. ΓòÉΓòÉΓòÉ 4.2. Tips for administering SecureEntry WSOD environments ΓòÉΓòÉΓòÉ
  1421.  
  1422. Personalizing workstations 
  1423.  
  1424. If you want to enable your machine classes or workstations with a different set 
  1425. of environment variables than those provided by default, you can place these in 
  1426. a file named CONFWSOD.ADD, with the same format as previously explained under 
  1427. Personalized installations for the file CONFIG.ADD. This file must reside in 
  1428. the INSTALL subdirectory of your SecureEntry path. 
  1429.  
  1430. Additionally, if you want to run some more complex processes during the 
  1431. enabling and disabling of workstations and/or machine classes, the WSOD enabler 
  1432. calls, if found, the following user exit commands: 
  1433.  
  1434.      POSTENCL.CMD Called after a machine class has been enabled for 
  1435.       SecureEntry, receives the class name as a parameter. 
  1436.  
  1437.      POSTDSCL.CMD Called after a machine class has been disabled for 
  1438.       SecureEntry, receives the class name as a parameter. 
  1439.  
  1440.      POSTENWS.CMD Called after a WSOD workstation has been enabled for 
  1441.       SecureEntry, receives the workstation name as a parameter. 
  1442.  
  1443.      POSTDSWS.CMD Called after a WSOD workstation has been disabled for 
  1444.       SecureEntry, receives the workstation name as a parameter. 
  1445.  
  1446.  This files must be placed also in the INSTALL subdirectory of your SecureEntry 
  1447.  path. 
  1448.  
  1449.  If you want to place a specific read only file as available for all enabled 
  1450.  workstations, such as an EDYCUST user exits file, just put it in the server, 
  1451.  SecureEntry path, EXEC or DLL directory. 
  1452.  
  1453.  The SecureEntry R/W tree is located under 
  1454.  x:\IBMLAN\RPLUSER\machinename\SGMSHELL, for if any read/write additional 
  1455.  SecureEntry file is required. 
  1456.  
  1457.  For the startup file, you can place a EDYSTART.CMD file in the 
  1458.  x:\IBMLAN\RPLUSER\workstationname directory for it to be processed by 
  1459.  SecureEntry startup. Note that if a STARTUP.CMD file exists in the same 
  1460.  directory before enabling the intended workstation, it will be migrated to 
  1461.  EDYSTART.CMD during the SecureEntry enabling process. 
  1462.  
  1463.  Which components will/will not work 
  1464.  
  1465.  You can use all components and features of SecureEntry while running under a 
  1466.  WorkSpace on Demand environment, with the following exceptions/restrictions : 
  1467.  
  1468.      The WarpCenter component  This component is not supported, since if it 
  1469.       were, it could only be used as an 'applications launcher' due to WSOD 
  1470.       restrictive working strategy. For this reason, if you need such 
  1471.       functionality, we suggest you to use a SecureEntry launchpad instead. 
  1472.  
  1473.      The EdyStart object Because the Workplace Shell is restarted every time a 
  1474.       WSOD workstation logons, SecureEntry ignores the EdyStart object contents 
  1475.       to avoid restarting those at every session signon. We suggest you to use 
  1476.       the command file EDYSTART.CMD to provide for machine power up automated 
  1477.       process launching, or use the appropriate user exit to do so. If you want 
  1478.       to provide for per user session process launching, use then a personal 
  1479.       desktop profile with a dynamic folder configured as 'autostart'. 
  1480.  
  1481.      All desktop related components Specifically speaking, the desktop 
  1482.       restrictions, launchpad or the personal desktop component are fully 
  1483.       supported in this environment, but you should take into account that the 
  1484.       functionality for those is also restricted by WSOD itself. For instance, 
  1485.       you will not be able to drop/delete objects in a launchpad, or create new 
  1486.       shadows inside a personal folder unless you have signed on as an 
  1487.       administrator. 
  1488.  
  1489.  Besides, and for customization purposes, it is possible to create a 
  1490.  SecureEntry Workbench within a WSOD workstation, provided that : 
  1491.  
  1492.    1. You have signed on as an administrator 
  1493.  
  1494.    2. You have access to a command line or drives object 
  1495.  
  1496.    3. You are using WSOD version 2.0 (minimum) 
  1497.  
  1498.  To do so, run the program EDYCRWRK located in your SecureEntry path, INSTALL 
  1499.  directory. 
  1500.  
  1501.  This way, you will be able to configure and assign SecureEntry profiles to 
  1502.  your groups and users, based on the real objects and environment of your 
  1503.  client workstations. This is very useful for configuring workplace shell 
  1504.  related SecureEntry components, such as Desktop restrictions, launchpads,... 
  1505.  since it is often impossible to create a desktop with exactly the same client 
  1506.  objects in the WSOD host server machine, due to the fact that the operating 
  1507.  system base code is different. 
  1508.  
  1509.  
  1510. ΓòÉΓòÉΓòÉ 5. Using SecureEntry ΓòÉΓòÉΓòÉ
  1511.  
  1512. If you are a SecureEntry user, most of the product will work transparently for 
  1513. you. Only the session control functions will show that the machine is enhanced 
  1514. with SecureEntry. 
  1515.  
  1516.      Session logon 
  1517.  
  1518.      Session unlock 
  1519.  
  1520.      Session logoff or shutdown 
  1521.  
  1522.      Ctl-Alt-Del 
  1523.  
  1524.  
  1525. ΓòÉΓòÉΓòÉ 5.1. Session Logon ΓòÉΓòÉΓòÉ
  1526.  
  1527. At machine startup, or after an end session event, you will be prompted with 
  1528. the following panel : 
  1529.  
  1530. Just enter here your userid and password, and press <OK>, and you will be able 
  1531. to start your regular work session. 
  1532.  
  1533.  
  1534. ΓòÉΓòÉΓòÉ 5.2. Session unlock ΓòÉΓòÉΓòÉ
  1535.  
  1536. Several events can cause the session to lockup, being those : 
  1537.  
  1538.      Pressing the 'lockup' button on the launchpad 
  1539.  
  1540.      Selecting the 'lockup' function within the desktop popup menu 
  1541.  
  1542.      Automatic lockup function being activated after a period of system 
  1543.       inactivity. 
  1544.  
  1545.  If this happens, you will see the following panel displayed : 
  1546.  
  1547.  Just reenter the same password you used to signon, press <OK> and the work 
  1548.  session will continue. 
  1549.  
  1550.  
  1551. ΓòÉΓòÉΓòÉ 5.3. Session logoff or shutdown ΓòÉΓòÉΓòÉ
  1552.  
  1553. You can, at any time select 'logoff' or 'shutdown' from the desktop popup menu, 
  1554. or any of the system buttons placed on the launchpad. The difference between 
  1555. both functions is evident. Shutdown will close all active applications and 
  1556. allow for machine power-off, whereas logoff will reenter the session logon 
  1557. (signon) panel. When issuing any of this functions, the system may prompt you 
  1558. with the following panel : 
  1559.  
  1560. Which reminds you of those applications which you may have to close in an 
  1561. orderly way before being able to grant that a logoff or shutdown process will 
  1562. not lose any data. Press <OK> if you do not care about closing these 
  1563. applications, or <Cancel> if you are not sure and want to close the 
  1564. applications manually. 
  1565.  
  1566.  
  1567. ΓòÉΓòÉΓòÉ 5.4. Ctl-Alt-Del ΓòÉΓòÉΓòÉ
  1568.  
  1569. Pressing this key combination at any time can cause the system to prompt you 
  1570. with the appropriate action to process. Note that this only happens if you have 
  1571. this function setup for you in your personal profile. 
  1572.  
  1573. You can then choose among : 
  1574.  
  1575.      Killing (terminating) the application with focus. 
  1576.  
  1577.      Session logoff. 
  1578.  
  1579.      Machine Shutdown. 
  1580.  
  1581.      Lockup the machine. 
  1582.  
  1583.      Machine reboot. This should be considered an emergency shutdown. 
  1584.  
  1585.  Choose one of the options and press <OK> to continue processing. 
  1586.  
  1587.  
  1588. ΓòÉΓòÉΓòÉ 6. Security components - Base and PM ΓòÉΓòÉΓòÉ
  1589.  
  1590. Supposing you have just installed SecureEntry, and you are responsible for 
  1591. defining and administering the installation, you need to do the following tasks 
  1592. : 
  1593.  
  1594.    1. Define a security policy for your installation, that is, the roles that 
  1595.       will be playing the different users. For instance, you could envisage 
  1596.       several groups of users with common needs (i.e, tellers, developers, 
  1597.       administrators,...) This will give you a basic idea on the SecureEntry 
  1598.       groups that you will need to define. 
  1599.  
  1600.    2. Define, in a per group basis, what kind of interactions will each of the 
  1601.       groups require with the machine, at a component level. That is : 
  1602.  
  1603.           What applications need to be visible for each group, (required for 
  1604.            work), and the degree of flexibility you want to give to each one in 
  1605.            order to personalize his desktop. (Desktop restrictions component). 
  1606.  
  1607.           What will be a good launchpad/smartcenter content for each group, 
  1608.            which contains the most frequently required functions. 
  1609.  
  1610.           What kind of behavior will you allow for standard window frame 
  1611.            applications, i.e, you may not want to let users to mess with the 
  1612.            font selections of a 3270 emulator. Also, if you want to be strict 
  1613.            with the positioning and sizing of these frame window applications 
  1614.            (very useful for inexperienced groups of users). This is what the 
  1615.            Window restrictions component allows you to customize. 
  1616.  
  1617.           Look and feel of your installation during working sessions. i.e, 
  1618.            background bitmaps at lockup, behavior at Ctl-Alt-Del pressing, 
  1619.            Screen saving feature, present a shutdown button at lockup,... This 
  1620.            is what the SES behavior component lets you define. 
  1621.  
  1622.           Floppy access policy. I.e, which users may have access to the floppy 
  1623.            drive, and whether this should be encrypted or not. (Floppy 
  1624.            restrictions component). 
  1625.  
  1626.           Define, at a file system level, which files/directories will a given 
  1627.            group of users be able to access, also if necessary in a per process 
  1628.            basis. (Tree lock component) 
  1629.  
  1630.           Define which accelerator keys to define for fast object opening 
  1631.            (shortcuts component). 
  1632.  
  1633.           Establish which objects should be hooked at open time to require a 
  1634.            password or similar (hooked objects). 
  1635.  
  1636.           Define the aspect and required contents of the window list (window 
  1637.            list component). 
  1638.  
  1639.           What about memory folders and personal folders ? will those be 
  1640.            required in your installation ? (personal desktop component). 
  1641.  
  1642.    3. Extract, from the above definitions, the common profiles for all groups, 
  1643.       and the exceptions which should be assigned in a per user basis. Discard 
  1644.       any component for which you do not want to establish restrictions. 
  1645.  
  1646.    4. Build a table describing the different needs you have, as the following 
  1647.       one : 
  1648.  
  1649.             ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1650.             ΓöéGroup               ΓöéRequirements                  ΓöéComponent                     Γöé
  1651.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1652.             ΓöéDefault             ΓöéHave the standard lockup      ΓöéSES                           Γöé
  1653.             Γöé                    Γöébitmaps, ctl-alt-del to promptΓöé                              Γöé
  1654.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1655.             ΓöéADMINS              ΓöéDo not need any restriction,  ΓöéLaunchpad                     Γöé
  1656.             Γöé                    ΓöéSpecial launchpad to launch   Γöé                              Γöé
  1657.             Γöé                    ΓöéADMIN tools.                  Γöé                              Γöé
  1658.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1659.             ΓöéTELLERS             Γöé Access to the banking        ΓöéDesktop, Treelock, Floppy,    Γöé
  1660.             Γöé                    Γöéapplication. Disable moving ofΓöéSES, Launchpad, Windows B.    Γöé
  1661.             Γöé                    Γöéicons. Enable access to       Γöé                              Γöé
  1662.             Γöé                    ΓöéAMIPRO. Only read             Γöé                              Γöé
  1663.             Γöé                    Γöéfloppy/encrypted. ctl-alt-del Γöé                              Γöé
  1664.             Γöé                    Γöéto do nothing. Launchpad with Γöé                              Γöé
  1665.             Γöé                    Γöébank application. Disable     Γöé                              Γöé
  1666.             Γöé                    ΓöéFonts manipulation from       Γöé                              Γöé
  1667.             Γöé                    Γöéemulators                     Γöé                              Γöé
  1668.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1669.             ΓöéDEVELOPERS          ΓöéHave general access. LaunchpadΓöéDesktop, Launchpad            Γöé
  1670.             Γöé                    Γöéspecial with development toolsΓöé                              Γöé
  1671.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1672.             ΓöéIndividual requests ΓöéSome developers may need      ΓöéFloppy                        Γöé
  1673.             Γöé                    Γöéaccess to floppy in R/W       Γöé                              Γöé
  1674.             Γöé                    Γöéencrypted mode                Γöé                              Γöé
  1675.             ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1676.  
  1677.    5. Create and test the different profiles using each component workbench, 
  1678.       assigning names to those in the previous table. 
  1679.  
  1680.    6. Build a table like the following : 
  1681.  
  1682.             ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1683.             ΓöéComponent   ΓöéDefault     ΓöéADMINS      ΓöéTELLERS     ΓöéDEVELOPERS  ΓöéIndividual  Γöé
  1684.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1685.             ΓöéDESKTOP     ΓöéAll         ΓöéAll visible ΓöéDESK1.INI   ΓöéDESK2.INI   Γöé            Γöé
  1686.             Γöé            Γöéinvisible   Γöé            Γöé            Γöé            Γöé            Γöé
  1687.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1688.             ΓöéLAUNCHPAD   Γöé            ΓöéLP1.INI     ΓöéLP2.INI     ΓöéLP3.INI     Γöé            Γöé
  1689.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1690.             ΓöéWINDOWS     Γöé            Γöé            ΓöéWB1.INI     Γöé            Γöé            Γöé
  1691.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1692.             ΓöéSES         ΓöéSES1.INI    Γöé            ΓöéSES2.INI    Γöé            Γöé            Γöé
  1693.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1694.             ΓöéFLOPPY      Γöé            Γöé            ΓöéFLOP1.INI   Γöé            ΓöéFLOP2.INI   Γöé
  1695.             Γöé            Γöé            Γöé            Γöé            Γöé            Γöé(*)         Γöé
  1696.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1697.             ΓöéTREELOCK    Γöé            Γöé            ΓöéTLK1.INI    Γöé            Γöé            Γöé
  1698.             ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1699.  
  1700.  
  1701.             (*) For developers which require encrypted access.
  1702.  
  1703.    7. Use the interactive or batch users and groups administration tool to 
  1704.       create the different users and groups. Take into account that SecureEntry 
  1705.       groups for IBM Lan Server environment should begin with the letters 'SG' 
  1706.  
  1707.    8. Use the interactive or batch users and groups administration tool to drop 
  1708.       into the different users and groups their assigned profiles. 
  1709.  
  1710.    9. Drop into the NOUSER folder the profiles for default restrictions (valid 
  1711.       for all users/groups without a specific profile for a given component). 
  1712.       Remember to rename those profiles to the default component profile name 
  1713.       to be identified by the system. That is the name of the given component's 
  1714.       template profile within the TEMPLATE folder. 
  1715.  
  1716.   10. Decide on whether it is necessary/how to install any of the other 
  1717.       components supplied such as : 
  1718.  
  1719.           Boot protection 
  1720.  
  1721.           File Integrity check 
  1722.  
  1723.           Startup process 
  1724.  
  1725.           User exits 
  1726.  
  1727.   11. Test your solution 
  1728.  
  1729.   12. At any time, if you want to change any assigned component profile, once 
  1730.       it has already been assigned to a user, you can do that by directly 
  1731.       double clicking the component icon within the interactive administration 
  1732.       tool, or writing a batch process file with the change to be processed by 
  1733.       the batch users and group management tool. 
  1734.  
  1735.  Follows a list and description of how to configure and work with the different 
  1736.  components, as described under this and the following chapter : 
  1737.  
  1738.  Base and presentation manager related components : 
  1739.  
  1740.      Floppy restrictions component 
  1741.  
  1742.      SES behavior component 
  1743.  
  1744.      Windows behavior component 
  1745.  
  1746.      The Window list component 
  1747.  
  1748.      Treelock component 
  1749.  
  1750.      Startup process 
  1751.  
  1752.      Boot protection 
  1753.  
  1754.      File integrity 
  1755.  
  1756.      Processes auditor component 
  1757.  
  1758.      Lotus Notes component 
  1759.  
  1760.  Components related to WorkPlace Shell : 
  1761.  
  1762.      Desktop restrictions component 
  1763.  
  1764.      The Personal desktop component 
  1765.  
  1766.      The Hooked objects component 
  1767.  
  1768.      The Launchpad component 
  1769.  
  1770.      The WarpCenter component 
  1771.  
  1772.      The shortcuts component 
  1773.  
  1774.      The Public Applications component 
  1775.  
  1776.  
  1777. ΓòÉΓòÉΓòÉ 6.1. The Floppy restrictions component ΓòÉΓòÉΓòÉ
  1778.  
  1779. Being this one the easiest component to work with, we will describe it first. 
  1780.  
  1781. The Floppy restrictions component allows to configure the way that the user 
  1782. will be able to 'see' the floppy diskette drive, with several options : 
  1783.  
  1784.      No access at all 
  1785.  
  1786.      Read/write access 
  1787.  
  1788.      Read/write access with encryption 
  1789.  
  1790.      Read only access 
  1791.  
  1792.      Read only access with encryption 
  1793.  
  1794.  Besides, and if encryption access mode is selected, then you have te option to 
  1795.  choose either a generic encryption algorithm, or one which is dependant on the 
  1796.  institution and configuration of your SecureEntry network, so that diskettes 
  1797.  created using this mode will not be readable from another SecureEntry 
  1798.  configured workstation unless it belongs to your institution. If you choose a 
  1799.  generic algorithm, then it can be the default one ('light encryption'), or an 
  1800.  enhanced one which, although less performing, is somewhat more secure. 
  1801.  
  1802.  In order to work with this component, please open the Floppy restrictions 
  1803.  Workbench folder located in the SecureEntry Workbench folder. 
  1804.  
  1805.  You can create a profile for this component by dragging a copy from its 
  1806.  component profile template (name is EDYFLOPP.INI). 
  1807.  
  1808.  You can edit the different options by dropping the profile into the 'Floppy 
  1809.  restrictions editor' program object, which has the following aspect : 
  1810.  
  1811.  You can test a given profile by dropping it into the program object named 
  1812.  'Test floppy restrictions'. 
  1813.  
  1814.  By last, you can translate disks from one format to another one with the 
  1815.  'Floppy translator' utility object, located also within this folder, without 
  1816.  the need to reformat the diskette. Please run the program and refer to the 
  1817.  associated help to know how it works. Note that this utility is specially 
  1818.  efficient as it can do a translation of only the logical found data on the 
  1819.  disk, skipping the need to write all of it unless completely filled up. 
  1820.  SecureEntry supplies you with two versions of this program, being one 
  1821.  graphical, and the other command line. The names are : 
  1822.  
  1823.      EDYTFLOP.EXE For the graphical one, and 
  1824.  
  1825.      TRANDISK.EXE For the command line one. 
  1826.  
  1827.  They both reside within the EXEC directory of the SecureEntry path. 
  1828.  
  1829.      API and modules description 
  1830.  
  1831.  
  1832. ΓòÉΓòÉΓòÉ 6.1.1. API and modules description ΓòÉΓòÉΓòÉ
  1833.  
  1834. What follows is the description of the Floppy restrictions component modules: 
  1835.  
  1836.      Floppy disk filter 
  1837.  
  1838.       Loaded at CONFIG.SYS processing time through the following sentence: 
  1839.  
  1840.             BASEDEV=EDYFLPY.FLT
  1841.  
  1842.       Note that to avoid problems with the XDF filter, this filter should be 
  1843.       loaded after the XDFLOPPY.FLT filter. 
  1844.  
  1845.       Messages: 
  1846.  
  1847.         -  Successful operation: 
  1848.  
  1849.  
  1850.                            IBM SecureEntry Floppy Disk Filter V 1.00
  1851.  
  1852.         -  Warning: none. 
  1853.  
  1854.         -  Error: none. 
  1855.  
  1856.       Return codes: successful operation lets the system to continue the boot 
  1857.       process. So does at failure, but in this case the Floppy disk filter 
  1858.       remains unloaded. 
  1859.  
  1860.      EDYFLINI 
  1861.  
  1862.       For each profile (INI file) you want to create you must run the following 
  1863.       utility: 
  1864.  
  1865.  
  1866.                  EDYFLINI.EXE [IniFileName]
  1867.  
  1868.       If the Floppy disk filter is loaded, you can set a floppy disk access 
  1869.       immediately through the Push-Button TEST NOW. 
  1870.  
  1871.       You have the facility to load, save and create new INI files. 
  1872.  
  1873.      EDYFLPY 
  1874.  
  1875.       To activate an access right, you can build your own application calling 
  1876.       the Floppy disk filter API, or you can run the provided program: 
  1877.  
  1878.  
  1879.                  EDYFLPY.EXE [/I:[drive:][pathname][filename][.INI]] | [/V:Value]
  1880.  
  1881.       If passing an INI file name, you will activate the access right stored in 
  1882.       it. If passing a value, you will activate its related access right. 
  1883.  
  1884.       Messages: 
  1885.  
  1886.         -  Successful operation: 
  1887.  
  1888.                       Ok
  1889.  
  1890.         -  Warning: none. 
  1891.  
  1892.         -  Errors: 
  1893.  
  1894.                       Usage: EDYFLPY [/I:[drive:][pathname]filename.[.INI]] | [/V:Value]]
  1895.                                      Value in [10,20,21,22,30,40,41,42,50]
  1896.  
  1897.            Or: 
  1898.  
  1899.                       Error produced on WEEKDAY, DATE AND TIME
  1900.                       ------------------------------------------
  1901.                        Source Module Name: SOURCE MODULE NAME
  1902.                        Compilation Date  : COMPILATION DATE
  1903.                        Compilation Time  : COMPILATION TIME
  1904.                        Source Line Number: SOURCE LINE NUMBER
  1905.                        Logged Error      : (hex)=RC (dec)=RC
  1906.  
  1907.                       The Floppy Disk Filter API returned (hex)=__ (dec)=__
  1908.  
  1909.       Return codes: successful operation or warning returns the value 0 to the 
  1910.       command line. A failure returns its value to the command line. 
  1911.  
  1912.      Floppy disk filter API 
  1913.  
  1914.       The Floppy disk filter API has the following entry points, defined in 
  1915.       EDYFLAPI.H: 
  1916.  
  1917.  
  1918.                  ULONG _System EDYFloppyAccessFromIni(PSZ FileName);
  1919.  
  1920.       If FileName is not NULL, it must point to the name of an INI file 
  1921.       gathering data about the access rights of a given user. If FileName is 
  1922.       NULL, if the file %SGM_SHELL%\NOUSER\EDYFLOPP.INI exists, the settings in 
  1923.       that file will be activated; if that file does not exist, no rights to 
  1924.       the floppy drive will be given. 
  1925.  
  1926.  
  1927.                  ULONG _System EDYFloppyAccessFromValue(LONG Value);
  1928.  
  1929.       Value must be one of the five access rights. 
  1930.  
  1931.  
  1932.                  ULONG _System EDYGetIniValue(PSZ FileName, PLONG Value);
  1933.  
  1934.       Reads the access right defined in the INI file FileName, but it does not 
  1935.       update current access rights to floppy disk. 
  1936.  
  1937.  
  1938.                  ULONG _System EDYSetIniValue(PSZ FileName, LONG Value);
  1939.  
  1940.       Sets an access right in the INI file FileName, but it does not update 
  1941.       current access rights to floppy disk. 
  1942.  
  1943.       Messages: 
  1944.  
  1945.         -  Successful operation: none. 
  1946.  
  1947.         -  Warning: none. 
  1948.  
  1949.         -  Error: none. 
  1950.  
  1951.       Return codes: successful operation returns the value 0 to the caller. A 
  1952.       failure returns its value. 
  1953.  
  1954.  
  1955. ΓòÉΓòÉΓòÉ 6.2. The SES behavior component ΓòÉΓòÉΓòÉ
  1956.  
  1957. The SES behavior component allows you to configure 'system level' settings for 
  1958. the behavior of the system during session control functions, such as : 
  1959.  
  1960.      Secure startup bitmaps 
  1961.  
  1962.      Desktop background bitmap 
  1963.  
  1964.      Lockup behavior and appearance 
  1965.  
  1966.      Screen saving function 
  1967.  
  1968.      Systemwide hot keys disabling and/or hooking 
  1969.  
  1970.      Ctl-Alt-Del behavior 
  1971.  
  1972.      Whether to show which processes at logoff/shutdown time 
  1973.  
  1974.  In order to work with this component, please open the SES Behavior Workbench 
  1975.  folder located in the SecureEntry Workbench folder. 
  1976.  
  1977.  In order to create a security profile for this component, drag one from the 
  1978.  component profile template object (named EDYSES.INI). 
  1979.  
  1980.  In order to edit one of these profiles, drop it into the 'SES Behavior 
  1981.  restrictions editor' program object, set up your preferences and then save it 
  1982.  as with any other editor. This editor looks as follows : 
  1983.  
  1984.  Note that this component allows you to configure very different machine 
  1985.  behavior characteristics, such as control-alt-del behavior, and/or which 
  1986.  processes to show at logoff/shutdown time. Take into account : 
  1987.  
  1988.      This component can be used to configure the startup application bitmaps, 
  1989.       which will be the 'background bitmap' used for lockup, and the specific 
  1990.       'startup bitmap' as the logo one, when a profile of its kind is placed in 
  1991.       the NOUSER directory. 
  1992.  
  1993.      Within the 'Show applications at logoff' page, you ought to configure 
  1994.       those applications for which you want to override the prompting behavior, 
  1995.       i.e, whether to show them in the logoff applications list or not. Those 
  1996.       can be configured by process name, or by session title, Noting that all 
  1997.       VDMs programs are seen as the same application process, named either 
  1998.       SYSINIT, or VDM. by SecureEntry. 
  1999.  
  2000.       In order to understand what will be the behavior of the mentioned dialog 
  2001.       at shutdown or logoff, follows a step by step description of its process 
  2002.       : 
  2003.  
  2004.         1. First, an initial process list is being built up with the processes 
  2005.            to kill. This list includes all processes running in the system 
  2006.            except : 
  2007.  
  2008.              -  All superuser context running processes, if performing a logoff 
  2009.                 (no shutdown) operation. (see About processes and running 
  2010.                 contexts) 
  2011.  
  2012.              -  Processes already dying. 
  2013.  
  2014.              -  Processes running under superuser context, detached. 
  2015.  
  2016.              -  Reserved processes, such as PMSPOOL, PMSHELL or SecureEntry 
  2017.                 daemons. 
  2018.  
  2019.              -  All processes belonging to screengroup ID 0, such as 
  2020.                 HARDERR.EXE. 
  2021.  
  2022.         2. Then, and one by one, all the elements remaining in the list (those 
  2023.            that will be killed by the ongoing process) are passed through the 
  2024.            configured list of filter restrictions, marking it as 'to show', 
  2025.            'not to show' or 'default action', in order to build the list of 
  2026.            processes to show. 
  2027.  
  2028.         3. Those processes marked as 'default action', i.e, not directly 
  2029.            specified by the security restriction profile filter, are handled as 
  2030.            follows : 
  2031.  
  2032.              -  Processes running under a Dos Box (VDM) will be shown. 
  2033.  
  2034.              -  PM or detached processes will not be shown. 
  2035.  
  2036.              -  OS/2 fullscreen or windowed processes will show only its more 
  2037.                 deeper descendant process. 
  2038.  
  2039.       Note that you can specify within the filter list, either the process 
  2040.       name, or the process title, by enclosing it between double quotes. In 
  2041.       both cases you can use wildcards. If you want to know the process name 
  2042.       for a given title, make it appear in the list at logoff or shutdown, and 
  2043.       then double click within the listbox area so that the list will switch 
  2044.       between showing process titles and process executable names. 
  2045.  
  2046.      Default processing for the foreground startup bitmap is a bit tricky, 
  2047.       since the default value will be the 'Moving bitmap' of the screen saver 
  2048.       page, if any. Failing that, a default OS/2 bitmap will be presented. 
  2049.  
  2050.  The 'Test SES behavior' program object can be used to test any profile for 
  2051.  this component. Drop a given profile into it to do so. 
  2052.  
  2053.  For last, this component is fully supported, independently of the fact that 
  2054.  the real Security Enabling Services are being used. If they are not, 
  2055.  SecureEntry will provide with the equivalent function. 
  2056.  
  2057.  
  2058. ΓòÉΓòÉΓòÉ 6.3. The Windows behavior component ΓòÉΓòÉΓòÉ
  2059.  
  2060. The windows behavior component allows you to configure part of the general 
  2061. behavior of application frame windows whenever a given security profile of its 
  2062. kind is active. Among other things you can set up the frame window initial size 
  2063. and position, and restrict some or all of the system menu options that the 
  2064. application may display. 
  2065.  
  2066. In order to work with this component, please open the Window Restrictions 
  2067. Workbench folder located in the SecureEntry Workbench folder. 
  2068.  
  2069. In order to create a security profile for this component, drag one from the 
  2070. component profile template object (named EDYWIN.INI). 
  2071.  
  2072. To modify a profile of this type, you can drop it into the 'Windows 
  2073. Restrictions Editor' program object, edit the frame window settings you wish 
  2074. to, and then close it as if working with any regular editor : 
  2075.  
  2076. In order to test a given Window Restrictions profile, just drop it into the 
  2077. 'Test window restrictions' program object. 
  2078.  
  2079. There are several details to take into account when working with this component 
  2080. : 
  2081.  
  2082.    1. The 'delay' configurable parameter for the Window position/size setting 
  2083.       should only be used for those applications which 'refuse' to 
  2084.       position/size themselves with delay value of 0. This is because some 
  2085.       applications reseize their windows some time after window creation. 
  2086.  
  2087.    2. You can setup restrictions in a per window title name basis, or in a per 
  2088.       process basis. To do so : 
  2089.  
  2090.           If you choose to configure by title name, you should configure the 
  2091.            window title names exactly as they appear in the frame window title, 
  2092.            enclosed between double quotes. 
  2093.  
  2094.           If you do configure by process name, the process name has to be that 
  2095.            of the process owning the dialog procedure for the desired window. 
  2096.            Do not enclose the process name between quotes. Note that this 
  2097.            option is only advised when configuring by title results impossible, 
  2098.            since restrictions may end up applied to more than the desired 
  2099.            windows. Note that all DOS Box and OS/2 windowed sessions are 
  2100.            'owned' by the first pmshell (SESSHELL.EXE when working with the 
  2101.            Security Enabling Services). 
  2102.  
  2103.    3. Both window title names, process names and window Menu strings that you 
  2104.       wish to deactivate accept wildcards in their specification, and are 
  2105.       processed in a case insensitive manner, orderly from the first to the 
  2106.       last one, as appears within the appropriate editor's listbox. Note that 
  2107.       only the first matching entry is processed. 
  2108.  
  2109.    4. You can only restrict reseize capabilities or initial position and size 
  2110.       for windows which are 'sizeable', that is, have a sizeable border. 
  2111.  
  2112.    5. In order to configure menu strings to disable, the following tricks may 
  2113.       be of interest : 
  2114.  
  2115.           The scope of menu controls affected is : 
  2116.  
  2117.              a. For window frames specified by window frame title, all menus 
  2118.                 and submenus that are owned by a frame with the same title. 
  2119.  
  2120.              b. For window frames specified by process name, all menus whose 
  2121.                 window procedure executes within the context of the specified 
  2122.                 process (same process id). 
  2123.  
  2124.           The frame 'Desktop' owns all first level menus of the desktop, 
  2125.            whereas the process 'PMSHELL.EXE' owns all menus for all desktop 
  2126.            objects, including opened folders menus. 
  2127.  
  2128.           You can configure default menu strings to disable, to be disabled in 
  2129.            all cases, by doing so within the definitions for the <DEFAULT> 
  2130.            window. 
  2131.  
  2132.       As a samples of all this, 
  2133.  
  2134.       To disable the End Session menu item from the desktop system menu: 
  2135.  
  2136.  
  2137.               Configure the menu string End Session for a window named "Desktop"
  2138.  
  2139.       To disable the Find item from all the desktop menus, including opened 
  2140.       folders: 
  2141.  
  2142.  
  2143.               Configure the menu string *Find* for the process named *PMSHELL.EXE
  2144.  
  2145.       Note the asterisks, since the F is frequently an accelerator key, and the 
  2146.       menu item can have also usually the form Find... 
  2147.  
  2148.       To universally disable the Find item from all desktop, folders, and 
  2149.       applications menus of the system: 
  2150.  
  2151.  
  2152.               Configure the menu string *Find* for the <DEFAULT> window name entry.
  2153.  
  2154.    6. When configuring restrictions for WIN-OS/2 applications, take into 
  2155.       account : 
  2156.  
  2157.           You can set an initial position for those, and restrict the reseize, 
  2158.            move, close, maximize, minimize or hide capabilities of the window, 
  2159.            but the effect on the screen will be different from the same 
  2160.            restrictions applied to an OS/2 PM application, since the menu 
  2161.            entries will not be disabled, although any attempt to invoke those 
  2162.            will revert to an allowed state for the window. 
  2163.  
  2164.           You can not deactivate menu items by name (lower right corner list 
  2165.            on the editor), since the WIN-OS/2 applications menu items do not 
  2166.            belong to the OS/2 frame window which owns them. 
  2167.  
  2168.           Remember to mark the application entry as 'DOS' type. 
  2169.  
  2170.    7. Finally, a brief description of the initial state radio buttons : 
  2171.  
  2172.           If you choose to fix an initial window position and select the 
  2173.            'Restored' radio button, then the window will be restored to that 
  2174.            specified size and position right after creation plus the configured 
  2175.            'delay' time. 
  2176.  
  2177.           If you choose to fix an initial window position and select the 
  2178.            'Maximized' radio button, then the window will be maximized to its 
  2179.            default maximized position and size right after creation plus the 
  2180.            configured 'delay' time. 
  2181.  
  2182.           If you choose to fix an initial window position and select the 
  2183.            'Minimized' radio button, then the window will be minimized to its 
  2184.            default minimized position and size right after creation plus the 
  2185.            configured 'delay' time. The window frames behavior component will 
  2186.            then wait until an attempt is made to maximize or restore the 
  2187.            window, and then force the 'restored' state with the configured size 
  2188.            and position, unless either 
  2189.  
  2190.              -  The window is configured to not allow the maximize state, or 
  2191.  
  2192.              -  The configured width and height are both set to 1 (minimum) 
  2193.  
  2194.            In this case the forced state will be the maximized one. 
  2195.  
  2196.       In any case, it becomes clear that in order to be able to choose a given 
  2197.       initial state, the corresponding state allowance flag must be enabled, 
  2198.       i.e you can not set an initial state of 'maximized' if the 'maximize' 
  2199.       checkbox is unchecked. 
  2200.  
  2201.    8. When restricting position and sizing of windows, special care has to be 
  2202.       taken with applications that do their own adjustments. A clear such 
  2203.       sample are the CM/2 3270 emulator windows when configured with 'variable 
  2204.       font size'. There is the risk in this case that both applications 
  2205.       (SecureEntry and the window owner) start 'fighting' to setup a different 
  2206.       position or size for the window. If such a problem appears, there is 
  2207.       normally an application option that you can deactivate, which is the 
  2208.       cause for the application autoadjust. This is solved in the CM/2 sample, 
  2209.       by setting a fixed font size for the emulators. 
  2210.  
  2211.    9. Be careful when 'forcing' initial window states that applications do not 
  2212.       allow in normal operation (i.e, without SecureEntry). They will possibly 
  2213.       not work. 
  2214.  
  2215.  And for last, take into account that this component does heavily rely on 
  2216.  defacto system behavior assumptions, and pushes the Presentation Manager 
  2217.  limits quite high, being designed to cover a high percentage of the 
  2218.  requirements in this area. What this all means is that the end result may just 
  2219.  not be the desired one in a few cases, without real possible solutions. In any 
  2220.  case, we would like to hear about the specific case, and try to find out one 
  2221.  if possible. 
  2222.  
  2223.  
  2224. ΓòÉΓòÉΓòÉ 6.4. The Window List component ΓòÉΓòÉΓòÉ
  2225.  
  2226. The windows list component allows you to configure the behavior of the window 
  2227. list application whenever a given security profile of its kind is active. Among 
  2228. other things you can specify which tasks are to be shown or hidden, whether to 
  2229. allow task management from itself, and some aesthetic configuration of its 
  2230. appearance. 
  2231.  
  2232. In order to work with this component, please open the Window List Restrictions 
  2233. Workbench folder located in the SecureEntry Workbench folder. 
  2234.  
  2235. In order to create a security profile for this component, drag one from the 
  2236. component profile template object (named EDYWDLST.INI). 
  2237.  
  2238. To modify a profile of this type, you can drop it into the 'Windows List 
  2239. Restrictions Editor' program object, edit the settings you wish to, and then 
  2240. close it as if working with any regular editor : 
  2241.  
  2242. In order to test a given Window List Restrictions profile, just drop it into 
  2243. the 'Test window List restrictions' program object. You can test it also from 
  2244. within the editor application through its menu options. 
  2245.  
  2246. When configuring profiles for this component, keep in mind : 
  2247.  
  2248.      The Lists of processes to hide/show are used to decide whether a new 
  2249.       entry in the switch list should be visible or not. The following rules 
  2250.       are applied: 
  2251.  
  2252.         1. Wildcards '*' and '?' are allowed and the pattern matching is done 
  2253.            case insensitive. 
  2254.  
  2255.         2. The matched string is in some instances not exactly what you see in 
  2256.            the switch list container, but instead the real title of the 
  2257.            application. This may be because, depending on the session type, 
  2258.            OS/2 does preppend some session identification string to the title. 
  2259.            You can use the supplied Switch list utilities : EDYSWL2 program to 
  2260.            see the real string titles. 
  2261.  
  2262.         3. If the application title is not in both lists, the title is left 
  2263.            untouched. (visible or invisible depending on the application 
  2264.            itself). 
  2265.  
  2266.         4. If the application title matches an entry in the  'Entries to show' 
  2267.            list, but not in the 'Entries to hide' list, then the application 
  2268.            will be visible within the task list. 
  2269.  
  2270.         5. If the application title matches an entry in the  'Entries to hide' 
  2271.            list, but not in the 'Entries to show' list, then the application 
  2272.            will not be visible within the task list. 
  2273.  
  2274.         6. If the application title matches an entry in both lists, then the 
  2275.            list to which the longest pattern belongs mandates what to do. So, 
  2276.            for instance : 
  2277.  
  2278.                                    Entries to hide       Entries to show
  2279.  
  2280.                                         *                   *CMD*
  2281.                                                             *Desktop*
  2282.  
  2283.            Will hide everything except what matches '*CMD*' or '*Desktop*', 
  2284.            similarly 
  2285.  
  2286.                                    Entries to hide       Entries to show
  2287.  
  2288.                                       *CMD*                   *
  2289.                                       *Communic*
  2290.  
  2291.            Would show everything in the task list, except those applications 
  2292.            with switch list titles matching '*CMD*' or '*Communic*'. 
  2293.  
  2294.      Due to the standard behavior of the task list, you should make sure that 
  2295.       if it is active, then there is at least one item showable at all times, 
  2296.       or the <ESC> key will not let you dismiss the dialog. 
  2297.  
  2298.      The 'Popup menu' checkbox refers to the ability to work with the context 
  2299.       menus of the entries of the switch list. If the state is unchecked, then 
  2300.       when using the profile, the task list will only be able to be used as a 
  2301.       task switcher without the ability to move, close.... the affected 
  2302.       windows. 
  2303.  
  2304.  
  2305. ΓòÉΓòÉΓòÉ 6.5. The Treelock component ΓòÉΓòÉΓòÉ
  2306.  
  2307. The treelock component allows you to control through an access control list 
  2308. profile, the parts of the logical drive and/or devices that the system should 
  2309. allow access to, once the component is activated with a given profile. 
  2310.  
  2311. In order to work with this component, please open the Treelock Workbench folder 
  2312. located in the SecureEntry Workbench folder. 
  2313.  
  2314. Within the treelock workbench folder, you will find : 
  2315.  
  2316.      Shadows to open the two sample profile files. 
  2317.  
  2318.      Templates to create treelock restriction profiles and audit files. 
  2319.  
  2320.      A program object to invoke the Treelock Editor by drag and drop in order 
  2321.       to edit a given profile. 
  2322.  
  2323.      A program object to test a given treelock profile, named 'Test treelock'. 
  2324.  
  2325.  The Treelock Editor allows you to edit treelock profiles. A Treelock profile 
  2326.  is basically an access rights list that specifies which file system resources 
  2327.  will be accessible and which will not, once the profile is activated. 
  2328.  
  2329.  Note that the treelock audit file is treated as any other component, which you 
  2330.  can assign to users or at a machine level through the users and groups 
  2331.  administration tools. 
  2332.  
  2333.      Profile, overview 
  2334.  
  2335.      Profile, Superuser Processes 
  2336.  
  2337.      Profile, Default Access Rights 
  2338.  
  2339.      Profile, Explicit Access Rights 
  2340.  
  2341.      Profile, Inactive Definitions 
  2342.  
  2343.      Profile, Parameterization 
  2344.  
  2345.      Profile, The ASCII syntax 
  2346.  
  2347.      Profile, Log Activity Configuration 
  2348.  
  2349.      Designing Treelock profiles 
  2350.  
  2351.      Testing Treelock profiles 
  2352.  
  2353.      Profile, Sample 1 
  2354.  
  2355.      Profile, Sample 2 
  2356.  
  2357.      Ambiguity Resolution 
  2358.  
  2359.      Templates 
  2360.  
  2361.      The Log Debug File 
  2362.  
  2363.      The audit file 
  2364.  
  2365.      Usage Samples 
  2366.  
  2367.      The Treelock API 
  2368.  
  2369.      Implicit restrictions 
  2370.  
  2371.  
  2372. ΓòÉΓòÉΓòÉ 6.5.1. Profile, overview ΓòÉΓòÉΓòÉ
  2373.  
  2374. A Treelock Profile specifies: 
  2375.  
  2376.       Which file system resources will be accessible and which will not. 
  2377.  
  2378.       Which accesses to the file system will be logged and which will not. 
  2379.  
  2380.  Control over the file system is achieved through the definition of a  default 
  2381.  access rights section and the definition of an explicit access rights section, 
  2382.  which is an access rights list structured in a process by process basis. Once 
  2383.  the profile is activated, each time a process attempts an access to the file 
  2384.  system, the explicit access rights list is queried first and, if possible, 
  2385.  applied, otherwise, the default access rights are used. 
  2386.  
  2387.  Control over the log activity is achieved by means of a global definition 
  2388.  and/or many process by process definitions called private log mode 
  2389.  definitions. The global log mode acts as a default log mode that applies to 
  2390.  all user processes that do not have a private log mode and, optionally, to all 
  2391.  superuser processes. Either global o private definitions can specify to log 
  2392.  all the attempted accesses or only the denied ones. 
  2393.  
  2394.  Note: a Treelock profile is in fact a text file that must fit a given syntax. 
  2395.  So, a profile may have syntax errors. The Treelock Editor detects them at load 
  2396.  time, and may display them at any time, giving the erroneous line number and 
  2397.  an error message pointing to a possible cause. 
  2398.  
  2399.  Note: a process running in superuser mode is not subject to Treelock profile 
  2400.  restrictions. 
  2401.  
  2402.  
  2403. ΓòÉΓòÉΓòÉ 6.5.2. Profile, Superuser Processes ΓòÉΓòÉΓòÉ
  2404.  
  2405. A process running in superuser mode is not related to any user and hence should 
  2406. not be restricted by the active Treelock profile (which is always related to a 
  2407. user session). To enforce this feature, every time a process attempts an access 
  2408. to a resource, the Treelock device driver finds out if the process is running 
  2409. in superuser or user mode. If the process turns out to be a superuser process 
  2410. then the Treelock device driver grants to it the access no matter what the 
  2411. active profile says about this process's access rights, otherwise the access is 
  2412. solved as defined by the profile. 
  2413.  
  2414. So, superuser processes have always full rights on all file system resources, 
  2415. you can not change this,  but you can configure the profile so as to log all 
  2416. accesses attempted by a superuser process. This allows you to monitor which 
  2417. processes are running in superuser mode in a given user session. See the 
  2418. Treelock Editor on-line help for more information. 
  2419.  
  2420.  
  2421. ΓòÉΓòÉΓòÉ 6.5.3. Profile, Default Access Rights ΓòÉΓòÉΓòÉ
  2422.  
  2423. A Treelock profile provides two ways to define the default access rights: 
  2424.  
  2425. An explicit access rights definition related to the reserved process name: 
  2426. EXES. 
  2427.  
  2428. A list of logical drives, from A to Z, that classifies each drive as accessible 
  2429. or not. 
  2430.  
  2431. When a process P attempts an access to a resource R and its explicit rights are 
  2432. not applicable, then the EXES process explicit rights are queried, if possible 
  2433. they are applied, if not then the drive list is queried and the access is 
  2434. granted only if R is located in an accessible drive. 
  2435.  
  2436.  
  2437. ΓòÉΓòÉΓòÉ 6.5.4. Profile, Explicit Access Rights ΓòÉΓòÉΓòÉ
  2438.  
  2439. A Treelock profile's explicit access rights section is designed to define 
  2440. access rights in a process by process basis. It is a list of access rights 
  2441. definitions. 
  2442.  
  2443. An access rights definition is an assignment of the same access rights to a 
  2444. particular set of processes. 
  2445.  
  2446. The access rights are defined in two steps. First the minimum granted rights 
  2447. are specified and then the specific access rights are specified. The minimum 
  2448. granted rights, if defined, act as the default access rights for the set of 
  2449. processes, and are applied only if the specific rights can not be applied. The 
  2450. specific access rights cannot be more restrictive than the minimum granted 
  2451. ones, and they are an access rights list structured in a resource by resource 
  2452. basis. 
  2453.  
  2454. The set of processes affected by an access rights definition is specified by 
  2455. means of a complete file system pathname, all processes that match this 
  2456. pathname belong to this set of processes. So, a process P has explicit access 
  2457. rights defined, only if P belongs to a set of processes specified by at least 
  2458. one of the profile's access rights definition (except EXES). 
  2459.  
  2460. Minimum Granted Rights 
  2461.  
  2462. The minimum granted rights, if defined, act as default access rights for the 
  2463. set of processes, they apply whenever any of these processes attempts an access 
  2464. to a resource not specified in the access rights definition's specific access 
  2465. rights list. Can take the following values: 
  2466.  
  2467.      FULL : the processes will have full access rights (open, execute, delete, 
  2468.       move, and subdirectories creation and removal) on all resources and will 
  2469.       be able to start a command line. 
  2470.  
  2471.      OPEN/EXECUTE : the processes will have open and execute rights (but not 
  2472.       delete, nor move, nor subdirectories creation and removal) on all 
  2473.       resources except those included in the specific access rights list, and 
  2474.       will be able to start a command line. 
  2475.  
  2476.      NONE : the processes will have no minimum granted rights defined, and all 
  2477.       accesses to resources not included in the specific access rights list 
  2478.       will be resolved using the logical drives default access rights list. 
  2479.  
  2480.  Specific Access Rights 
  2481.  
  2482.  The specific access rights section of an access rights definition is designed 
  2483.  to define access rights in a resource by resource basis, it is list of 
  2484.  arguments, <R,D,T>, specifying what kind of access the processes have to what 
  2485.  kind of resources: 
  2486.  
  2487.  R is a pathname to a file o directory. 
  2488.        Processes will have access rights, D, on all resources that match this 
  2489.        pathname. 
  2490.  
  2491.  D are the access rights. 
  2492.        Processes will have access rights D on the resources defined by R These 
  2493.        access rights can not be more restrictive than the minimum granted ones. 
  2494.  
  2495.  T is the resource type. 
  2496.        It is used to modify the set of resources specified by R. May take three 
  2497.        values: 
  2498.  
  2499.        File           The set of resources is not modified. 
  2500.  
  2501.        Directory      Processes have D access rights also on all resources 
  2502.                       located inside the directory specified by R. 
  2503.  
  2504.        Subtree        Is the same as specifying the pathname R*. Processes have 
  2505.                       D access rights also on all resources located in the 
  2506.                       subtree that hangs from R 
  2507.  
  2508.  Note: all pathnames that reference processes or resources in a profile can 
  2509.  accept wildcards ('*' ,'?') , and may be parameterized to unrelate them from 
  2510.  their file system's location. 
  2511.  
  2512.  Note: see the Treelock Editor's on-line help for more information about how to 
  2513.  define access rights definitions. 
  2514.  
  2515.  
  2516. ΓòÉΓòÉΓòÉ 6.5.5. Profile, Inactive Definitions ΓòÉΓòÉΓòÉ
  2517.  
  2518. The Treelock Editor allows you to deactivate any access rights definition and 
  2519. any specific access rights definition. 
  2520.  
  2521. An inactive definition acts as not defined when the profile is activated, 
  2522. however, the Treelock Editor recognizes it, and shows it inside the profile's 
  2523. inactive definitions section. 
  2524.  
  2525.  
  2526. ΓòÉΓòÉΓòÉ 6.5.6. Profile, Parameterization ΓòÉΓòÉΓòÉ
  2527.  
  2528. All pathnames that reference processes or resources in a profile may be 
  2529. parameterized to unrelate them from fixed file system's locations. After that, 
  2530. a profile becomes also a template and can be used to easily generate new 
  2531. profiles adapted to other file system configurations. 
  2532.  
  2533. Parameterization is done by relating pathname's substrings to arbitrary 
  2534. parameter names. 
  2535.  
  2536. c:\os2 could be related to %os_dir%
  2537. c:\sgmshell could be related to %sgm_shell%
  2538.  
  2539. Note: to avoid ambiguity, a parameterized string cannot be a complete substring 
  2540. of another parameterized string. 
  2541.  
  2542. After being parameterized, a profile is still a profile, the difference is that 
  2543. it can also behave as a template, that is, it can be loaded as a template with 
  2544. the parameterized strings being substituted by their related parameter names, 
  2545. and you can assign new values to them to generate new profiles. 
  2546.  
  2547. Note: see the Treelock Editor's on-line help for more information about how to 
  2548. parameterize a profile. 
  2549.  
  2550.  
  2551. ΓòÉΓòÉΓòÉ 6.5.7. Profile, The ASCII syntax ΓòÉΓòÉΓòÉ
  2552.  
  2553. The Treelock Editor detects a profile's syntax errors at load time. Once the 
  2554. profile is loaded, syntax errors can be displayed at any time: each erroneous 
  2555. line is showed, and for each error the line number and a an error message is 
  2556. given. 
  2557.  
  2558. A profile with syntax errors is not trusty: the Treelock Editor does not save 
  2559. profiles with syntax errors, so it can be assumed that the profile has been 
  2560. edited as a text file and modified by hand. 
  2561.  
  2562. What follows is the grammar that the ASCII profile must adjust to: 
  2563.  
  2564.    ; This is a comment, and lasts until the end of a line
  2565.  
  2566.    ; GLOBAL parameters section
  2567.    ; -------------------------
  2568.  
  2569.    [Set Debug=d:\fullpathname\filename]
  2570.  
  2571.    ; "set debug" establishes the name of the logging file. This file is
  2572.    ; recreated whenever the system is loaded or a profile is enabled and
  2573.    ; will contain all the actions the Device Driver logs. If not specified,
  2574.    ; no log file will be used, so nothing will be logged.
  2575.  
  2576.    [Set Globdebug={a|d}]
  2577.  
  2578.    ; "set globdebug" directs the Device Driver to log ALL actions/accesses
  2579.    ; or only DENIED ones
  2580.  
  2581.    ;           ZYXWVUTSRQPONMLKJIHGFEDCBA
  2582.    [Set Drives=00000011011011001001010111]
  2583.  
  2584.    ; "set drives" is a map of bits indicating whether access to a logical
  2585.    ; unit must be given (1) or not (0). This variable will be scanned when
  2586.    ; access to a resource could not be decided.
  2587.  
  2588.    [Set Mode={s|c}]
  2589.  
  2590.    ; "set mode" establishes whether unspecified processes have no access
  2591.    ; rights (STRICT), so that all accesses will be denied; or full access
  2592.    ; rights (CALCULATED), so that all accesses will be allowed. The Device
  2593.    ; Driver will scan this variable only if no global variable "set drives"
  2594.    ; was present.
  2595.    ; NOTE : the Treelock Editor does not use this variable because profiles
  2596.    ; are always saved with DRIVES defined.
  2597.    ; NOTE : This line alone does NOT override the implicit treelock
  2598.    ; restrictions (i.e, access to config.sys for regular users).
  2599.  
  2600.    ; PER PROCESS parameters section
  2601.    ; ------------------------------
  2602.  
  2603.    [A|D] {F|O|Y|N} <executable|EXES|VDMS> [args]*
  2604.    [args] = [A|R|N] {F|D|S} <filepath>
  2605.  
  2606.    ; A = analyze flag for this line: all access performed by this process
  2607.    ;     will be logged, but not prohibited.
  2608.    ; D = debug flag for this line: all failing access performed by this
  2609.    ;     process will be logged.
  2610.    ; F = this <executable> has full access: open, execute, delete, move,
  2611.    ;     and subdirectory creation/removal.
  2612.    ; O = this <executable> has full open and execute rights, but no delete,
  2613.    ;     move, mkdir nor rmdir.
  2614.    ; N = start of a command line will not be allowed for this <executable>.
  2615.    ; Y = start of a command line will be allowed for this <executable>.
  2616.    ;     This is the default value.
  2617.    ; <executable> = complete path and name of file, including drive letter
  2618.    ;                and colon (may contain the wildcards '*' and '?').
  2619.    ; <VDMS>       = Real-Mode executables have the kind of access on data
  2620.    ;                files present in <filepath>. If a data file is not
  2621.    ;                present there, Real-Mode executables will have the
  2622.    ;                access right depending on EXES statement.
  2623.    ; <EXES>       = non specified executables (even Real-Mode ones) have
  2624.    ;                the kind of access on data files present in <filepath>.
  2625.  
  2626.    ;                If a data file is not present there, non specified
  2627.    ;                executables will have the access right depending on
  2628.    ;                SET DRIVES value. If SET DRIVES variable is not specified,
  2629.    ;                non specified executables will have the access rights
  2630.    ;                depending on SET MODE value.
  2631.    ; For each process, there are zero or more args possible. Each argument
  2632.    ; has two or three arguments:
  2633.    ; o Optionally the kind of access to a <filepath>:
  2634.    ;   o A means that All accesses are allowed
  2635.    ;   o R means that Read-only accesses are allowed
  2636.    ;   o X means that Execute-only accesses are allowed
  2637.    ;   o N means that No accesses at all are allowed
  2638.    ;   A is the default value if none of the previous parameters is specified.
  2639.    ; o How to behave with <filepath>:
  2640.    ;   o F means access to a File.
  2641.    ;   o D means access to all files in a Directory
  2642.    ;   o S means access to all files in a directory and its Subdirectories
  2643.    ; o The <filepath>, which may contain the wildcards '*' and '?'.
  2644.    ;
  2645.    ; You can break a line into more lines using the character '/'
  2646.  
  2647.  
  2648. ΓòÉΓòÉΓòÉ 6.5.8. Profile, Log Activity Configuration ΓòÉΓòÉΓòÉ
  2649.  
  2650. From a Treelock profile you can configure the log activity you want to get done 
  2651. once the profile is activated. You can specify which processes do you want to 
  2652. monitor and which of their accesses do you want to log. 
  2653.  
  2654. For a given process, there are two log modes that specify which accesses to 
  2655. log: 
  2656.  
  2657.       Log only denied accesses. 
  2658.  
  2659.       Log all attempted accesses (and grant them, no matter what the profile 
  2660.       says) 
  2661.  
  2662.  A log mode may be globally or privately defined. A private log definition 
  2663.  assigns a log mode to an access rights definition and takes effect on all user 
  2664.  processes related to that definition; a global log definition assigns a log 
  2665.  mode to all user processes that do not have a private log mode and, 
  2666.  optionally, to all superuser processes. 
  2667.  
  2668.  Note: a private log definition does not apply to a process running in 
  2669.  superuser mode. Superuser processes can only be monitorized by specifying it 
  2670.  in the profile's global log mode definition. 
  2671.  
  2672.  Note: see the Treelock Editor's on-line help for more information about how to 
  2673.  define log modes for processes. 
  2674.  
  2675.  
  2676. ΓòÉΓòÉΓòÉ 6.5.9. Designing Treelock profiles ΓòÉΓòÉΓòÉ
  2677.  
  2678. When assigning file access permissions, the system administrator must edit a 
  2679. treelock profile specifying what rights must be active. This profile will be 
  2680. saved as an ASCII file by the treelock editor and may be read by the Treelock 
  2681. device driver either when loading, or at run-time through the use of the 
  2682. Treelock device driver API. 
  2683.  
  2684. You must be aware that the process of closing the system to unprivileged 
  2685. accesses consists of a fine tuning of the profiles using the method of "trial 
  2686. and error". For example, if you want to let the user execute the program 
  2687. Amipro/2, but restricting its access to some working directories, then you'll 
  2688. have to repeatedly test your profile until you get confident that: 
  2689.  
  2690.    1. You have identified all the resources that Amipro/2 internally accesses, 
  2691.       giving it full access to those resources that it creates or updates, and 
  2692.       giving it read-only access to those resources that it does not need to 
  2693.       create nor update. 
  2694.  
  2695.    2. You have identified all the resources that Amipro/2 accesses as a result 
  2696.       of the user accessing different directories/files. You must grant 
  2697.       Amipro/2 a particular kind of access depending on what resources you want 
  2698.       to protect/unprotect. 
  2699.  
  2700.  You can manage all the applications by giving specific access rights to some 
  2701.  of these applications, and then by giving specific access rights to the rest 
  2702.  of the non-specified applications (they all will have the same access rights). 
  2703.  
  2704.  Programs running in VDMs, even in the Windows subsystem, are indistinguishable 
  2705.  one from the other, since the OS/2 Warp kernel only sees different instances 
  2706.  of the Protected Shell process running in real mode. Therefore, all programs 
  2707.  running in real mode will match the "joker" process VDMS. If the Treelock 
  2708.  device driver cannot decide whether or not to give access depending on what 
  2709.  the VDMS "joker" process restrictions state, it will eventually end up 
  2710.  managing the process trying with the "joker" process EXES. 
  2711.  
  2712.  The process of closing the system heavily depends on your needs. You may need 
  2713.  a relatively closed system where you specify restrictions on few processes and 
  2714.  assign the rest of the process few restrictions; or you may need a more closed 
  2715.  system, where you specify the restrictions you need for the majority of the 
  2716.  processes, and let no open doors to non-specified processes. The first case 
  2717.  leads to a relaxed, easy to configure, system profile; the second one will 
  2718.  take more of your time to fine-tune it. To help you in this task the Treelock 
  2719.  Editor allows you to activate profiles and to edit log files in such a way 
  2720.  that the displayed information may be directly used to modify the profile's 
  2721.  data. 
  2722.  
  2723.  Anyway, the best method to follow when approaching the tuning of a process in 
  2724.  a profile is: 
  2725.  
  2726.    1. Specify a log file name for the profile. 
  2727.  
  2728.    2. Specify the global log mode as "log only denied accesses". 
  2729.  
  2730.    3. Specify all logical drives as accessible (open system). 
  2731.  
  2732.    4. For the process you want to tune specify the private log mode as "tune 
  2733.       mode" 
  2734.  
  2735.    5. Give to the process you want to tune "NO" minimum granted rights. 
  2736.  
  2737.    6. Enable the profile and begin extensively using the program. 
  2738.  
  2739.    7. Edit the log file from the Treelock Editor and find out what resources 
  2740.       are accessed by this process. 
  2741.  
  2742.    8. Add the internally used resources in the access rights definition of the 
  2743.       process in the profile and set their specific access rights (you can do 
  2744.       it directly from the log file editor) 
  2745.  
  2746.    9. Change the minimum granted rights's value to the one that best fit your 
  2747.       needs. 
  2748.  
  2749.   10. Go to step 6 until you see that you have fine-tuned this program. 
  2750.  
  2751.  
  2752. ΓòÉΓòÉΓòÉ 6.5.10. Testing Treelock profiles ΓòÉΓòÉΓòÉ
  2753.  
  2754. The Treelock Editor allows you to activate and deactivate Treelock profiles 
  2755. without quitting it. Activating a profile means applying all its restrictions, 
  2756. so care must be taken when working with closed profiles. 
  2757.  
  2758. To ensure normal operation the Treelock editor grants himself full rights on 
  2759. all profiles before activating them (it adds the the line "F 
  2760. <pathname>\tlcked.exe"). This is the only difference between a real activation 
  2761. and one done from the Treelock editor. 
  2762.  
  2763. Besides, the active Treelock profile can only be deactivated by activating 
  2764. another Treelock profile, so, the Treelock editor deactivates it by activating 
  2765. the profile which was active before it. So, deactivating a profile from the 
  2766. Treelock editor is nothing but restoring the Treelock profile assigned at logon 
  2767. time to the current user. 
  2768.  
  2769. See the Treelock editor's on-line help for more information about how to 
  2770. activate/deactivate a profile. 
  2771.  
  2772.  
  2773. ΓòÉΓòÉΓòÉ 6.5.11. Profile, Sample 1 ΓòÉΓòÉΓòÉ
  2774.  
  2775. The configuration file EDYDDSM1.CFG sets no restrictions on accesses, writing 
  2776. them all to the file c:\treelock.log: 
  2777.  
  2778.    set debug=c:\treelock.log
  2779.    set globdebug=a
  2780.    set mode=c
  2781.  
  2782.  
  2783. ΓòÉΓòÉΓòÉ 6.5.12. Profile, Sample 2 ΓòÉΓòÉΓòÉ
  2784.  
  2785. The configuration file EDYDDSM2.CFG sets some restrictions on accesses, writing 
  2786. only denied accesses to the file c:\treelock.log. Unspecified processes will 
  2787. behave depending on what's specified in EXES; if the access specified in EXES 
  2788. fails it will fail, since mode is strict: 
  2789.  
  2790.    set debug=c:\treelock.log
  2791.    set globdebug=d
  2792.    set mode=s
  2793.  
  2794.    ; ====================
  2795.    ; Base OS/2 (required)
  2796.    ; ====================
  2797.  
  2798.    ; Give c:\os2\pmshell.exe open/execute rights to any resource in c:\spool,
  2799.    ; k:\post and h:\ . Give full access to c:\os2\os2.ini, c:\os2\os2.###,
  2800.    ; c:\os2\os2.!!!, c:\os2\os2sys.ini, c:\os2\os2sys.###, c:\os2\os2sys.!!!,
  2801.    ; c:\os2\pmdiary.###, c:\os2\pmdiary.!!!, c:\os2\pmdiary.ini,
  2802.    ; c:\os2\install\reinstal.ini, c:\os2\install\reinstal.### and
  2803.    ; c:\os2\install\reinstal.!!!
  2804.  
  2805.    O c:\os2\pmshell.exe            s c:\spool           s k:\post     s H:   /
  2806.      f c:\os2\os2.ini              f c:\os2\os2.###     f c:\os2\os2.!!!     /
  2807.      f c:\os2\os2sys.ini           f c:\os2\os2sys.###  f c:\os2\os2sys.!!!  /
  2808.      f C:\OS2\PMDIARY.###          f C:\OS2\PMDIARY.!!! f C:\OS2\PMDIARY.INI /
  2809.      f c:\os2\install\reinstal.ini f c:\os2\install\reinstal.###             /
  2810.      f c:\os2\install\reinstal.!!!
  2811.  
  2812.    ; Give c:\os2\harderr.exe, c:\os2\chkdsk.com and c:\os2\pmspool.exe
  2813.    ; full rights.
  2814.  
  2815.    F c:\os2\system\harderr.exe
  2816.    F c:\os2\chkdsk.com
  2817.    F c:\os2\pmspool.exe
  2818.  
  2819.    ; ======================
  2820.    ; Base OS/2 (additional)
  2821.    ; ======================
  2822.  
  2823.    ; Don't allow c:\os2\apps\pmdcalc.exe to start a command line, giving it
  2824.    ; full access to c:\os2\apps\dll\pmdiary.dll, c:\os2\pmdiary.###,
  2825.    ; c:\os2\pmdiary.ini, c:\os2\pmdiary.!!!, c:\os2\help\pmdiary.hlp and
  2826.    ; c:\os2\help\hmhelp.hlp
  2827.  
  2828.    n C:\OS2\APPS\PMDCALC.EXE  f C:\OS2\APPS\DLL\PMDIARY.DLL         /
  2829.      f C:\OS2\PMDIARY.### f C:\OS2\PMDIARY.INI f C:\OS2\PMDIARY.!!! /
  2830.      f C:\OS2\HELP\pmdiary.hlp f C:\OS2\HELP\HMHELP.HLP
  2831.  
  2832.    ; Don't allow c:\os2\apps\pmsticky.exe to start a command line, giving it
  2833.    ; full access to c:\os2\apps\dll\pmdiary.dll, h:\os2\pmdiary.###,
  2834.    ; h:\os2\pmdiary.ini, h:\os2\pmdiary.!!!, c:\os2\help\pmdiary.hlp,
  2835.    ; c:\os2\help\hmhelp.hlp and h:\pmsticky.$$p
  2836.  
  2837.    n C:\OS2\APPS\PMSTICKY.EXE f C:\OS2\APPS\DLL\PMDIARY.DLL         /
  2838.      f H:\OS2\PMDIARY.### f H:\OS2\PMDIARY.INI f H:\OS2\PMDIARY.!!! /
  2839.      f C:\OS2\HELP\pmdiary.hlp f C:\OS2\HELP\HMHELP.HLP f H:\PMSTICKY.$$P
  2840.  
  2841.    ; Don't allow c:\os2\more.com to start a command line, giving it
  2842.    ; full access to c:\os2\system\oso001.msg and c:\oso0001.msg
  2843.  
  2844.    N c:\os2\MORE.COM f C:\OS2\SYSTEM\OSO001.MSG f c:\oso0001.msg
  2845.  
  2846.    ; The following line would prevent cmd.exe from starting another cmd.exe,
  2847.    ; would give no access to program format.com, would give access to any
  2848.    ; other exe and com in c:, would give Read-Only access to treelock.log
  2849.    ; and full access to d: drive.
  2850.    ; With that line, exes and coms different from format.com in c: could be
  2851.    ; created and deleted, but no other files nor directories could be created
  2852.    ; nor deleted.
  2853.    ; To keep the same restrictions, but allowing the command prompt to start
  2854.    ; another command prompt, you must change the initial "n" to a "y"
  2855.  
  2856.    ;n c:\os2\cmd.exe n f c:\os2\format.com                     /
  2857.    ;  a s c:\*.exe a s c:\*.com r f c:\treelock.log a s d:
  2858.  
  2859.    ; The following line will will allow to start any program and open or create
  2860.    ; any file, even if you add some restrictions after cmd.exe. What you will
  2861.    ; not be allowed to do is erase nor move files, neither create nor delete
  2862.    ; nor move directories.
  2863.  
  2864.    ;o c:\os2\cmd.exe
  2865.  
  2866.    ; The following line gives full access to d: drive. Since nothing is stated
  2867.    ; about other drives, no access is given to them.
  2868.  
  2869.    ;n c:\os2\cmd.exe a s d:
  2870.  
  2871.    ; The following line makes cmd.exe to behave as the past line, but it will
  2872.    ; allow to start another command prompt.
  2873.  
  2874.    ;y c:\os2\cmd.exe a f c:\os2\cmd.exe a s d:
  2875.  
  2876.    ; The following line sets no restrictions on a command prompt:
  2877.  
  2878.    f c:\os2\cmd.exe
  2879.  
  2880.    ; ==============
  2881.    ; VDMS statement
  2882.    ; ==============
  2883.  
  2884.    ; Give any Real-Mode program Read-Only access to files C:\CONFIG.SYS and
  2885.    ; C:\STARTUP.CMD, full access to C:\DOSUTILS and its subdirectories,
  2886.    ; full access to C:\OS2\MDOS\DOSKRNL and C:\OS2\BOOT\VIOTBL.DCP, etc.
  2887.    ; Note that No access will be given to any file/subdirectory in unit A:.
  2888.    ; Note that wildcards are accepted.
  2889.    ; Note that this statement manages IBM Anitvirus for DOS and DW4.
  2890.  
  2891.    N VDMS R F C:\CONFIG.SYS              R F C:\STARTUP.CMD                      /
  2892.        S C:\DOSUTILS                     F C:\OS2\MDOS\DOSKRNL                   /
  2893.      A F C:\OS2\BOOT\VIOTBL.DCP          F C:\OS2\SYSTEM\COUNTRY.SYS             /
  2894.      A F C:\OS2\MDOS\COMMAND.COM         F C:\OS2\MDOS\APPEND.EXE                /
  2895.      A F C:\OS2\MDOS\WINOS2\WINOS2.COM   F C:\OS2\MDOS\WINOS2\SYSTEM\OS2K386.EXE /
  2896.      A F C:\OS2\MDOS\SYSTEM\*.DRV        F C:\OS2\MDOS\WINOS2\*.INI              /
  2897.      A F C:\OS2\MDOS\SYSTEM\*.FON                                                /
  2898.      A F C:\OS2\MDOS\WINOS2\*.GRP                                                /
  2899.      A F C:\OS2\MDOS\WINOS2\SYSTEM\SETUP.INF                                     /
  2900.      A D C:\OS2\MDOS                                                             /
  2901.      N S A:                                                                      /
  2902.      a s c:\ibmav                                                                /
  2903.      N F C:\DW4\*.doc                                                            /
  2904.      N F C:\DW4\*.rft                                                            /
  2905.      A F C:\DW4\*.LST                                                            /
  2906.      A F C:\DW4\*.PG1                                                            /
  2907.      A F C:\DW4\*.PRF                                                            /
  2908.      A F C:\DW4\DW4ODIR.BAT                                                      /
  2909.      A F C:\*.$$P                                                                /
  2910.      R S C:
  2911.  
  2912.    ; ==============
  2913.    ; EXES statement
  2914.    ; ==============
  2915.  
  2916.    ; Give to non-specified EXES no access to a command line, plus no access
  2917.    ; to C:\CONFIG.SYS at all, Read-only access to C:\STARTUP.CMD, full access
  2918.    ; to directory C:\TOOLS, etc.
  2919.    ; Note that wildcards are accepted.
  2920.  
  2921.    N EXES N F C:\CONFIG.SYS  R F C:\STARTUP.CMD         N F C:\AUTOEXEC.BAT /
  2922.      A D C:\TOOLS            R F C:\OS2\HELP\EPM.HLP      S C:\OS2\APPS     /
  2923.      A D C:\OS2\APPS\DLL       S C:\OS2\DLL               S C:\OS2UTILS     /
  2924.      N S A:                  N F C:\OS2\MDOS\WINOS2\*.INI
  2925.  
  2926.    ; ==========
  2927.    ; Lan Server
  2928.    ; ==========
  2929.  
  2930.    ; And so on ...
  2931.  
  2932.    F c:\os2\epw.exe
  2933.    F C:\IBMLAN\NETPROG\LSDAEMON.EXE
  2934.    F C:\IBMLAN\NETPROG\STOPLAN.EXE
  2935.    F C:\IBMLAN\NETPROG\NET.EXE
  2936.    F C:\IBMLAN\SERVICES\WKSTA.EXE
  2937.    F C:\IBMLAN\SERVICES\MSRVINIT.EXE
  2938.    F c:\IBMLAN\SERVICES\MSRV.EXE
  2939.    N C:\MUGLIB\MUGLRQST.EXE S C:\MUGLIB S C:\IBMLAN
  2940.  
  2941.    ;====================================================================
  2942.    ; Communications Manager
  2943.    ;====================================================================
  2944.  
  2945.    F c:\ibmcom\lanmsgex.exe
  2946.    F c:\ibmcom\protocol\netbind.exe
  2947.    F c:\ibmcom\protocol\LANDLL.EXE
  2948.    n c:\CMLIB\DMCM.EXE          S C:\CMLIB
  2949.    n C:\CMLIB\ACS.EXE           S C:\CMLIB F C:\IBMLVL.### F C:\IBMLVL.INI F C:\IBMLVL.!!!
  2950.    n C:\CMLIB\APPN\ACSAPLDR.EXE S C:\CMLIB
  2951.    N C:\CMLIB\ACS3EINI.EXE      S C:\CMLIB F C:\OS2\HELP\HMHELP.HLP
  2952.  
  2953.    ; ==========
  2954.    ; OS2 AmiPro
  2955.    ; ==========
  2956.  
  2957.    N C:\AMIPRO\AMIPRO.EXE          A D C:\AMIPRO                            /
  2958.    A F C:\AMIPRO\ICONS\*.BMP                                                /
  2959.    A F C:\AMIPRO\ICONS\*.TBL       A F C:\AMIPRO\ICONS\*.SMI                /
  2960.    A F C:\AMIPRO\MACROS\*.DLG      A F C:\AMIPRO\MACROS\*.SMM               /
  2961.    A F C:\AMIPRO\STYLES\*.STY      A F C:\AMIPRO\DRAWSYM\*.SDW              /
  2962.    A F C:\OS2\AMI*.*               A D C:\OS2\DLL                           /
  2963.    A F C:\OS2\*.BIN                A S C:\SPOOL                             /
  2964.    A F C:\OS2\HELP\HMHELP.HLP      A D C:\PSFONTS                           /
  2965.    A F C:\OS2\INSTALL\SYSLEVEL.OS2 A F C:\OS2\SYSTEM\COUNTRY.SYS            /
  2966.    A F C:\OS2\MDOS\WINOS2\*.INI    A F c:\amipro\teller\*.sam               /
  2967.    N S C:
  2968.  
  2969.    ; ============
  2970.    ; OS2 IbmWorks
  2971.    ; ============
  2972.  
  2973.    n c:\ibmworks\ibmworks.exe  a f c:\ibmworks\ibmworks.ini                 /
  2974.                                a f c:\ibmworks\ibmworks.hlp                 /
  2975.                                a f c:\os2\help\hmhelp.hlp                   /
  2976.                                a f c:\os2\dll\*.drv                         /
  2977.                                a f c:\os2\dll\*.dev                         /
  2978.                                a f c:\os2\dll\*.prf                         /
  2979.                                a f c:\ibmworks\*.def                        /
  2980.                                a f c:\ibmworks\*.tmp                        /
  2981.                                a s c:\delete                                /
  2982.                                a f c:\ibmworks\*.ctn                        /
  2983.                                a s c:\psfonts                               /
  2984.                                a s d:
  2985.  
  2986.    N c:\ibmworks\fpwpim.exe    a f c:\ibmworks\ibmworks.ini                 /
  2987.                                a f c:\ibmworks\fpwpim.*                     /
  2988.                                a f c:\os2\help\hmhelp.hlp                   /
  2989.                                a f c:\ibmworks\*.tmp                        /
  2990.                                a s c:\delete                                /
  2991.                                a s c:\ibmworks\DATA                         /
  2992.                                a s c:\psfonts                               /
  2993.                                a s d:
  2994.  
  2995.    N c:\ibmworks\fpwmon.exe    a f c:\ibmworks\ibmworks.ini                 /
  2996.                                a f c:\ibmworks\fpwpim.*                     /
  2997.                                a f c:\os2\help\hmhelp.hlp                   /
  2998.                                a f c:\ibmworks\*.tmp                        /
  2999.                                a s c:\delete                                /
  3000.                                a s c:\ibmworks\DATA                         /
  3001.                                a s c:\psfonts                               /
  3002.                                a s d:
  3003.  
  3004.    ; =============
  3005.    ; OS2 Lotus 123
  3006.    ; =============
  3007.  
  3008.    n C:\LOTUS\123G\123G.EXE S C:\LOTUS\123G S D:\DADES\123 D C:\PSFONTS     /
  3009.    F C:\OS2\SYSTEM\OSO001.MSG
  3010.  
  3011.    ; ========
  3012.    ; FaxWorks
  3013.    ; ========
  3014.  
  3015.    N c:\PBA\FXSVIEW.EXE  s c:\PBA f M:\FAXWORKS\FAX.LOG
  3016.  
  3017.    N G:\FAXWORKS\FAXWORKS.EXE S G:\FAXWORKS S C:\FAXWORKS                   /
  3018.     F M:\FaxWorks\Fax.log F M:\FaxWorks\User.Spl
  3019.  
  3020.    ; ======================
  3021.    ; Other OS2 applications
  3022.    ; ======================
  3023.  
  3024.    n c:\os2\view.exe a s c:\*.inf a f c:\os2\viewdoc.exe
  3025.  
  3026.    N C:\OS2\VIEWDOC.EXE a s c:\*.inf a s c:\*.cp S C:\OS2\HELP              /
  3027.      f C:\OS2\SYSTEM\COUNTRY.SYS  f C:\OS2\VIEWDOC.EXE
  3028.  
  3029.  
  3030.    f m:\tools\inie.exe
  3031.    f m:\tools\inimaint.exe
  3032.  
  3033.  
  3034. ΓòÉΓòÉΓòÉ 6.5.13. Ambiguity Resolution ΓòÉΓòÉΓòÉ
  3035.  
  3036. A treelock profile may be ambiguous for one of two reasons: 
  3037.  
  3038.       A process exists that belongs to more than one access rights definition. 
  3039.  
  3040.       A resource exists that belongs to more than one definition in the 
  3041.       specific access rights section of the same access rights definition. 
  3042.  
  3043.  The problem arises from the fact that two pathnames in the same profile may 
  3044.  have a match intersection set not null. All processes or resources belonging 
  3045.  to this set will be subject to ambiguity because more than one definition can 
  3046.  be applied to solve their accesses. 
  3047.  
  3048.  The best solution would be to apply the definition with the most specific 
  3049.  pathname, but due to the inherent complexity of that solution, the following 
  3050.  approximation has been implemented: Whenever a process tries to access a 
  3051.  resource, the treelock device driver begins to search sequentially all the 
  3052.  definitions in the access rights definitions list. The first definition's 
  3053.  pathname that matches the process pathname will be applied. 
  3054.  
  3055.  With this in mind, all we need to know is the sort method used by the treelock 
  3056.  device driver to store the profile's access rights definitions. 
  3057.  
  3058.  The sorting is done on the access rights definition's pathname that specifies 
  3059.  the set of processes related to the definition, and the sort algorithm is as 
  3060.  follows: 
  3061.  
  3062.       Pathnames with no wildcards are stored first. 
  3063.  
  3064.       Pathnames with wildcards are stored after with the following sorting 
  3065.       scheme:. 
  3066.  
  3067.           Longest pathnames are stored first. 
  3068.  
  3069.           For equal length pathnames a special alphabetical sorting is applied: 
  3070.           x<?<* (where x is any other character different from '?' and '*') 
  3071.  
  3072.  
  3073. ΓòÉΓòÉΓòÉ 6.5.14. Templates ΓòÉΓòÉΓòÉ
  3074.  
  3075. A template is simply a Treelock profile that the Treelock Editor has loaded as 
  3076. a template. At load time the Treelock Editor substitutes all the profile's 
  3077. parameterized substrings with the parameter names related to them, and assigns 
  3078. default values to each of these parameters. Usually a parameter's default value 
  3079. value is the substring the parameter has substituted at load time; but if the 
  3080. parameter name is equal to a defined environment variable name at load time, 
  3081. then the default value assigned is not the environment variable's name but the 
  3082. environment variable's value. This allows to define lasting relations between 
  3083. parameters and environment variables. 
  3084.  
  3085. Note: a profile not parameterized is still a template, but a template with no 
  3086. parameters 
  3087.  
  3088. You can assign new values to the parameters to adapt the profile to many 
  3089. different file system configurations. Note that if a value assigned to a 
  3090. parameter is equal to a currently defined environment variable name, the value 
  3091. assigned is not the variable's name but the variable's value. 
  3092.  
  3093. To generate profiles from templates you must merge the template to a Treelock 
  3094. profile. The merge operation adds the template's access rights definitions to 
  3095. the profile with the parameters substituted by their current values but without 
  3096. modifying any other profile's data. Through this operation you can create new 
  3097. profiles (if the target profile is the empty profile) or easily update already 
  3098. existing profiles. 
  3099.  
  3100. Note: see the Treelock Editor's on-line help for more information about how to 
  3101. load and work with templates. 
  3102.  
  3103.  
  3104. ΓòÉΓòÉΓòÉ 6.5.15. The Log Debug File ΓòÉΓòÉΓòÉ
  3105.  
  3106. The log debug file related to a Treelock profile, is useful when tuning 
  3107. restrictions for a specific profile. It has the following line format: 
  3108.  
  3109.      Result: it can be one of the following: 
  3110.  
  3111.         -  Ok: the access has been granted. 
  3112.  
  3113.         -  Nok: the access has not been granted. 
  3114.  
  3115.      Process Name: eight characters at most specifying the name of the process 
  3116.       attempting the access. 
  3117.  
  3118.      Access Resolution Information: it can be one of the following: 
  3119.  
  3120.         -  The profile's access rights definition's pathname that matched the 
  3121.            process (and was applied by the Treelock device driver) to solve the 
  3122.            access. 
  3123.  
  3124.         -  SUPERUSER: the process was running in superuser mode (so the access 
  3125.            was granted). 
  3126.  
  3127.         -  EMPTY: the profile's default rights were applied to solve the 
  3128.            access. 
  3129.  
  3130.      Function Attempted: it can be one of the following: 
  3131.  
  3132.         -  DEL: a delete was attempted. 
  3133.  
  3134.         -  REN: a rename was attempted. 
  3135.  
  3136.         -  EXECP: a process creation was attempted. 
  3137.  
  3138.         -  OPEN: an open was attempted. 
  3139.  
  3140.         -  MKDIR: a create directory was attempted. 
  3141.  
  3142.         -  RMDIR: a remove directory was attempted. 
  3143.  
  3144.         -  CHDIR: a change of directory was attempted. 
  3145.  
  3146.         -  FINDF: a FindFirst was attempted. 
  3147.  
  3148.         -  FINDN: a FindNext was attempted. 
  3149.  
  3150.         -  FINDV: a Find from a DOS Box was attempted. 
  3151.  
  3152.      Flags: it can be a combination of the following and they are positional: 
  3153.  
  3154.         -  AN: analyze flag if it was specified for the process. 
  3155.  
  3156.         -  DB: debug flag if it was specified for the process. 
  3157.  
  3158.         -  BX: the process is running in Real-Mode. 
  3159.  
  3160.         -  DA: you must ignore this flag. 
  3161.  
  3162.         -  OE: open access. 
  3163.  
  3164.         -  NC: no command line starting allowed. 
  3165.  
  3166.         -  FA: full access. 
  3167.  
  3168.         -  NA: no access. 
  3169.  
  3170.      Full Filename: the full file name that was attempted to be accessed. 
  3171.  
  3172.  Take a look at the following example: 
  3173.  
  3174.    Nok CMD  C:\OS2\*     OPEN  '  DB          NA' A:\
  3175.    Nok E                      OPEN  '  DB          NA' C:\CONFIG.SYS
  3176.    ok   E   SUPERUSER   EXECP '  DB      NC    ' C:\OS2\CMD.EXE
  3177.  
  3178.  The example states: 
  3179.  
  3180.      From a command line, an access to drive A: was denied, and the profile's 
  3181.       "c:\os2\*" access rights definition was used to solve the action. 
  3182.  
  3183.      From program E, an access to file C:\CONFIG.SYS was denied, and the 
  3184.       profile's default rights were used to solve the access. 
  3185.  
  3186.      From program E, starting a command prompt was granted, and program was 
  3187.       running in superuser mode. 
  3188.  
  3189.  The Treelock Editor allows you to edit any log file either as a text file or 
  3190.  as log file editor file. As a text file the log file is displayed as it is, 
  3191.  and cannot be modified; as a log file editor file, the log file contents are 
  3192.  interpreted and structured so as to allow you to use the information to tune 
  3193.  the currently loaded profile. The log file editor shows all this information 
  3194.  indexing the logged accesses by the process that made them, and by whether 
  3195.  they were granted or denied, and allows you to use the displayed processes and 
  3196.  resources pathnames to directly add them to the currently loaded profile. 
  3197.  
  3198.  Note: see the Treelock Editor's on-line help for more information about how to 
  3199.  edit log files. 
  3200.  
  3201.  
  3202. ΓòÉΓòÉΓòÉ 6.5.16. The audit file ΓòÉΓòÉΓòÉ
  3203.  
  3204. The audit file contains information of denied accesses only. This file contains 
  3205. a header and a tail with the denied actions: 
  3206.  
  3207.      Header: 
  3208.  
  3209.         -  Optional reserved word TLOCK_AUDIT: specifies that this file is an 
  3210.            audit file. 
  3211.  
  3212.         -  Optional reserved word MAX_LINES: specifies that this audit file 
  3213.            will purge a number of lines each time it's opened. If not 
  3214.            specified, it will keep the most recent 1000 lines in the file, thus 
  3215.            purging all previous lines. 
  3216.  
  3217.      Tail: 
  3218.  
  3219.         -  TimeStamp: audited date and time of denied access. 
  3220.  
  3221.         -  UserID: the userId that attempted the failed access. 
  3222.  
  3223.         -  Administrator: whether or not the user is Administrator. 
  3224.  
  3225.         -  Process Name: eight characters at most specifying the name of the 
  3226.            process attempting the access. 
  3227.  
  3228.         -  Function Attempted: it can be one of the following: 
  3229.  
  3230.              -- DEL: a delete was attempted. 
  3231.  
  3232.              -- REN: a rename was attempted. 
  3233.  
  3234.              -- EXECP: a process creation was attempted. 
  3235.  
  3236.              -- OPEN R/O: an open for ReadOnly was attempted. 
  3237.  
  3238.              -- OPEN W/O: an open for WriteOnly was attempted. 
  3239.  
  3240.              -- OPEN R/W: an open for ReadWrite was attempted. 
  3241.  
  3242.              -- OPEN DLL: an open for a DLL was attempted. 
  3243.  
  3244.              -- MKDIR: a create directory was attempted. 
  3245.  
  3246.              -- RMDIR: a remove directory was attempted. 
  3247.  
  3248.              -- CHDIR: a change of directory was attempted. 
  3249.  
  3250.              -- FINDF: a FindFirst was attempted. 
  3251.  
  3252.              -- FINDN: a FindNext was attempted. 
  3253.  
  3254.              -- FINDV: a Find from a DOS Box was attempted. 
  3255.  
  3256.         -  Full Filename: the full file name that was attempted to be accessed. 
  3257.  
  3258.  Take a look at the following example: 
  3259.  
  3260.   MAX_LINES 100
  3261.   07-08-1996 16:25:42 USER_A    No Admin E        OPEN R/W C:\CONFIG.SYS
  3262.   07-08-1996 16:25:42 USER_A    No Admin TEDIT    OPEN R/O C:\CONFIG.SYS
  3263.   07-08-1996 16:25:43 USER_A    No Admin CMD      FINDF    C:\CONFIG.SYS
  3264.  
  3265.  The header states that this file will be purged each time it's opened, leaving 
  3266.  only unpurged the most recent 100 lines at most. 
  3267.  
  3268.  The tail states that UserID USER_A, who is not an administrator UserID, was 
  3269.  denied access to the file C:\CONFIG.SYS three times: 
  3270.  
  3271.      First, attempting to open for ReadWrite the file C:\CONFIG.SYS from the 
  3272.       program E 
  3273.  
  3274.      Second, attempting to open for ReadOnly the file C:\CONFIG.SYS from the 
  3275.       program TEDIT 
  3276.  
  3277.      Third, attempting to see whether or not the file C:\CONFIG.SYS exists 
  3278.       from a command line (probably with a DIR command). 
  3279.  
  3280.  
  3281. ΓòÉΓòÉΓòÉ 6.5.17. Usage Samples ΓòÉΓòÉΓòÉ
  3282.  
  3283. This section shows how to build these three common treelock profiles: 
  3284.  
  3285.    1. Hide a directory to a user 
  3286.  
  3287.    2. Restrict a user to a home directory 
  3288.  
  3289.    3. Give a user execute-only rights to an applications directory 
  3290.  
  3291.  To hide a directory to a user you must: 
  3292.  
  3293.    1. Give access to all logical drives 
  3294.  
  3295.    2. Specify the EXES access rights definition with NO minimum granted rights 
  3296.  
  3297.    3. Add to the definition's specific rights section the directory you want to 
  3298.       hide with: 
  3299.  
  3300.            Access rights = none 
  3301.  
  3302.            Resource Type = subtree 
  3303.  
  3304.  Let's see why this works out: any attempt to access a resource outside the 
  3305.  hided directory is resolved using the logical drives access list because the 
  3306.  EXES definition has no minimum granted rights defined and its specific access 
  3307.  rights list does not include the accessed resource. As the logical drives list 
  3308.  specifies all drives to be accessible the access is granted. However, if a 
  3309.  process attempts to access the hided directory, the EXES definition can be 
  3310.  applied to resolve the access, and as it specifies null rights on the 
  3311.  resource, the access is denied. 
  3312.  
  3313.  Note: the resource type must be "subtree" to assure that all subdirectories 
  3314.  will also be hided. We could also have specified the resource type to be 
  3315.  "file" and the resource to be "dir_to_hide*" 
  3316.  
  3317.  To restrict a user to a home directory you must: 
  3318.  
  3319.    1. Give no access to all logical drives (except drive A if you want the user 
  3320.       to be able to use the floppy) 
  3321.  
  3322.    2. Specify the EXES access rights definition with NO minimum granted rights 
  3323.  
  3324.    3. Add to the definition's specific rights section the home directory with: 
  3325.  
  3326.            Access rights = full 
  3327.  
  3328.            Resource Type = subtree 
  3329.  
  3330.  Once again, any attempt to access a resource outside the home directory is 
  3331.  resolved using the logical drives access list because the EXES definition has 
  3332.  no minimum granted rights defined and its specific access rights list does not 
  3333.  include the accessed resource. As the logical drives list specifies all drives 
  3334.  to be unaccessible the access is denied. However, if a process attempts to 
  3335.  access a resource inside the home directory, the EXES definition can be 
  3336.  applied to resolve the access, and as it specifies full rights on the 
  3337.  resource, the access is granted. 
  3338.  
  3339.  Note: the resource type must be "subtree" to allow the user to work with 
  3340.  subdirectories inside his home directory. 
  3341.  
  3342.  Give a user execute-only rights to an applications directory 
  3343.  
  3344.  Let's assume we want a closed system (drive c: is not accessible by default) 
  3345.  and the applications directory name is "c:\exes". We want the user to be able 
  3346.  to execute all applications located on that directory, but not to delete them. 
  3347.  So, we must: 
  3348.  
  3349.    1. Set drive c: as not accessible by default. 
  3350.  
  3351.    2. Specify the EXES access rights definition with NO minimum granted rights. 
  3352.  
  3353.    3. Add "c:\exes" to the EXES's specific access rights section with: 
  3354.  
  3355.            Access Rights=Execution 
  3356.  
  3357.            Resource Type=Directory 
  3358.  
  3359.       Now the user could execute any application located in the "c:\exes" 
  3360.       directory and he could not delete them. That would be ok, but we must 
  3361.       also tune each application the user is going to use. For instance, the 
  3362.       application "my_app.exe" could need to modify its INI file which could be 
  3363.       located in the directory "c:\exes". By now it could not done it because 
  3364.       "my_app.exe" has no explicit rights and the default ones give it 
  3365.       execute-only rights to "c:\exes". So we should: 
  3366.  
  3367.    4. Add "c:\exes\my_app.exe" to the access rights definition list with NO 
  3368.       minimum granted rights. 
  3369.  
  3370.    5. Add "c:\exes\my_app.ini" to the above definition's specific access rights 
  3371.       list with: 
  3372.  
  3373.            Access Rights=Full 
  3374.  
  3375.            Resource Type=File. 
  3376.  
  3377.  
  3378. ΓòÉΓòÉΓòÉ 6.5.18. The Treelock API ΓòÉΓòÉΓòÉ
  3379.  
  3380. The Treelock API has three entry points, defined in EDYDDAPI.H: 
  3381.  
  3382.      Set an Access Control List, or reset it. 
  3383.  
  3384.  
  3385.                  ULONG _System EDYPDDSetAccessToFiles(PSZ FileName);
  3386.  
  3387.       If FileName is NULL it will tell the Treelock device driver to check 
  3388.       accesses depending on what is specified in the file 
  3389.       %SGM_SHELL%\NOUSER\EDYDD32.INI; if this file does not exist, it will tell 
  3390.       the device driver to not check any access. If FileName is not NULL, it 
  3391.       will tell the treelock device driver to check accesses depending on what 
  3392.       is specified in FileName; if this file does not exist, it will return an 
  3393.       error. 
  3394.  
  3395.      Set an Audit File, or reset it. 
  3396.  
  3397.  
  3398.                  ULONG _System EDYPDDSetAuditFile(PSZ FileName);
  3399.  
  3400.       If FileName is NULL it will tell the Treelock device driver to append 
  3401.       denied accesses in the file %SGM_SHELL%\NOUSER\EDYDD32.AUD; if this file 
  3402.       does not exist, it will tell the device driver to not audit any access. 
  3403.       If FileName is not NULL, it will tell the device driver to append denied 
  3404.       accesses to FileName; if this file does not exist, it will return an 
  3405.       error. 
  3406.  
  3407.      Close the device driver log debug and audit files: 
  3408.  
  3409.  
  3410.                  ULONG _System EDYPDDCloseLogDebugFile(VOID);
  3411.  
  3412.  
  3413.  Successful operation returns the value 0 to the caller. A failure returns its 
  3414.  value to the caller. Only 32-bit callers are supported. 
  3415.  
  3416.  The program EDYDDUTL.EXE is provided as a sample using the API API. Usage: 
  3417.  
  3418.  
  3419.          EDYDDUTL { {/F|/A}[drive:][pathname][filename][.ext] | /C }
  3420.  
  3421.  Where: 
  3422.  
  3423.      /Ffilename activates the access rights in filename. 
  3424.  
  3425.      /F     disables the access rights checking. 
  3426.  
  3427.      /Afilename activates the auditing file filename. 
  3428.  
  3429.      /A     disables the auditing file. 
  3430.  
  3431.      /C     closes the log and audit files. 
  3432.  
  3433.  
  3434. ΓòÉΓòÉΓòÉ 6.5.19. Implicit restrictions ΓòÉΓòÉΓòÉ
  3435.  
  3436. In order to provide for an enough safe system, the treelock provides for the 
  3437. ultimate security restrictions which grant that a non-administrator user is not 
  3438. allowed to play with the different SecureEntry tools and interfaces, and thus 
  3439. jeopardize all of the integrity features that the product provides. 
  3440.  
  3441. The restrictions are : 
  3442.  
  3443.  
  3444.   - Administrators will not have any restriction.
  3445.  
  3446.   - Non-administrators will have the following restrictions:
  3447.  
  3448.     o No access to any resource located inside the paths given by the
  3449.       environment variable RUNWORKPLACE except SES\PSSDMON.EXE,
  3450.       e.g. C:\OS2\SECURITY, will be denied.
  3451.  
  3452.     o Any access to the following resources will be denied:
  3453.  
  3454.       o OS2\BOOT\SESDD32.SYS
  3455.       o OS2\BOOT\EDYDD32.SYS
  3456.       o OS2\BOOT\EDYFLPY.FLT
  3457.  
  3458.     o All files within the SGM_SHELL environment variable path,
  3459.       DLL subdirectory will have Read Only and DLL permission.
  3460.  
  3461.     o All files within the SGM_SHELL environment variable path,
  3462.       WORK and TEMP subdirectories will have full access.
  3463.  
  3464.     o All files within the SGM_SHELL environment variable path,
  3465.       TOOLS subdirectory will have read and execute permission.
  3466.  
  3467.     o The file EDYUTIL.EXE, located within the SGM_SHELL
  3468.       environment variable path, EXEC subdirectory will have
  3469.       execute permission, as well as the SecureEntry trace
  3470.       modules.
  3471.  
  3472.     o The following resources will have Read-only access:
  3473.  
  3474.       o EDYSTART.CMD
  3475.       o CONFIG.SYS
  3476.       o STARTUP.CMD
  3477.       o All files within the SGM_SHELL environment variable path
  3478.         except those subject to previous less restrictive
  3479.         rules.
  3480.  
  3481. Note that you can override this restrictions by using a treelock profile which 
  3482. explicitly includes your preferences, although you are encouraged not to do so. 
  3483. For instance, supposing you want to override the restriction of not letting 
  3484. regular users modify the config.sys file, you could use the following treelock 
  3485. profile : 
  3486.  
  3487.  
  3488.      set mode=c
  3489.      Y EXES A F C:\CONFIG.SYS
  3490.  
  3491. Which means : Let unspecified processes do all type of operations with 
  3492. config.sys, plus opening command lines. 
  3493.  
  3494.  
  3495. ΓòÉΓòÉΓòÉ 6.6. The startup process ΓòÉΓòÉΓòÉ
  3496.  
  3497. The regular OS/2 startup process is not secure because it can be interrupted at 
  3498. any time, and it could leave the workstation in a non stable state. The 
  3499. objective of the Secure Startup process is to provide a secure startup 
  3500. sequence. You should do this by placing the contents of what you would have put 
  3501. in the 'STARTUP.CMD' file inside a file called 'EDYSTART.CMD' within the boot 
  3502. drive's root directory. The startup process component has some commands which 
  3503. you can use to give feedback to the user while processing this startup file. 
  3504.  
  3505. The Secure Startup process cannot be interrupted and it is a system modal 
  3506. application which it gives to the user information about the different programs 
  3507. that are being started. The application has also a slider which informs of the 
  3508. percent value completed of the startup process and a multiline entry field used 
  3509. to give messages of the process being started at any time. 
  3510.  
  3511. A log file named 'EDYLKINI.LOG', located on the same directory of 
  3512. 'EDYSTART.CMD' is created each time the Secure Startup application is launched. 
  3513. It contains the messages displayed on the multiline entry field of the main 
  3514. window. It also contains information of any error produced during the execution 
  3515. of the Secure Startup process. 
  3516.  
  3517.      EDYLKINI.EXE 
  3518.  
  3519.      EDYLKSLD.EXE 
  3520.  
  3521.      EDYLKMSG.EXE 
  3522.  
  3523.      EDYLKBLK.EXE 
  3524.  
  3525.      EDYLKSWT.EXE 
  3526.  
  3527.      EDYWFWPS.EXE 
  3528.  
  3529.      Sample startup process 
  3530.  
  3531.  
  3532. ΓòÉΓòÉΓòÉ 6.6.1. EDYLKINI.EXE ΓòÉΓòÉΓòÉ
  3533.  
  3534. Description 
  3535.  
  3536. This file is to be used in testing period in order to test the startup 
  3537. sequence. 
  3538.  
  3539. Syntax 
  3540.  
  3541.   EDYLKINI [/NOMODAL]
  3542.  where /NOMODAL means the startup process won't be system modal. 
  3543.  
  3544. Return codes 
  3545.  
  3546. None. 
  3547.  
  3548.  
  3549. ΓòÉΓòÉΓòÉ 6.6.2. EDYLKSLD.EXE ΓòÉΓòÉΓòÉ
  3550.  
  3551. Description 
  3552.  
  3553. Executable used for moving the slider of the secure startup dialog. 
  3554.  
  3555. Syntax 
  3556.  
  3557.   EDYLKSLD [number]
  3558.  where number is the slider's position. If omitted, it slides to the next 
  3559. position. 
  3560.  
  3561. Return codes 
  3562.  
  3563. None 
  3564.  
  3565.  
  3566. ΓòÉΓòÉΓòÉ 6.6.3. EDYLKMSG.EXE ΓòÉΓòÉΓòÉ
  3567.  
  3568. Description 
  3569.  
  3570. Executable used to show an informational message in the multiline entry field 
  3571. of the secure startup window. 
  3572.  
  3573. Syntax 
  3574.  
  3575.   EDYLKMSG message
  3576.  where message is the message to be displayed on the multiline entry field 
  3577. (MLE) of the secure startup process. 
  3578.  
  3579. Return codes 
  3580.  
  3581. None 
  3582.  
  3583.  
  3584. ΓòÉΓòÉΓòÉ 6.6.4. EDYLKBLK.EXE ΓòÉΓòÉΓòÉ
  3585.  
  3586. Description 
  3587.  
  3588. Executable used to lockup the workstation. It can be used if some error 
  3589. occurred. 
  3590.  
  3591. Syntax 
  3592.  
  3593.   EDYLKBLK message
  3594.  where message is the last message to be displayed on the multiline entry field 
  3595. (MLE) of the secure startup window. 
  3596.  
  3597. Return codes 
  3598.  
  3599. None. 
  3600.  
  3601.  
  3602. ΓòÉΓòÉΓòÉ 6.6.5. EDYLKSWT.EXE ΓòÉΓòÉΓòÉ
  3603.  
  3604. Description 
  3605.  
  3606. Stores the name of the process to be launched after the startup command is 
  3607. finished. 
  3608.  
  3609. Syntax 
  3610.  
  3611.   EDYLKSWT parameters
  3612.  
  3613.   parameters:
  3614.   -D:program working directory
  3615.   -P:program.exe
  3616.   -A:program arguments
  3617.   -T:session title
  3618.   -U:x program startup time in seconds, default 0 seconds
  3619.   -F:x foreground/background  0=foreground (default)
  3620.                                     1=background
  3621.   -S:x  session type 1=OS/2 full screen (default)
  3622.                            2=OS/2 Windowed
  3623.                            3=OS/2 PM
  3624.                            4=VDM (DOS or WINOS2)
  3625.                            7=Windowed VDM
  3626.   -X:x window position X
  3627.   -Y:x window position Y
  3628.   -W:x window width
  3629.   -H:x window height
  3630.  
  3631. Return codes 
  3632.  
  3633. None. 
  3634.  
  3635.  
  3636. ΓòÉΓòÉΓòÉ 6.6.6. EDYWFWPS.EXE ΓòÉΓòÉΓòÉ
  3637.  
  3638. This command allows you to wait for completion of the WorkPlace Shell 
  3639. initialization process, and is designed to be used exclusively during 
  3640. EDYSTART.CMD processing. Once executed, it will not return control until it is 
  3641. safe to use the WorkPlace Shell. It has no optional parameters, so the calling 
  3642. syntax is : 
  3643.  
  3644.  
  3645.   EDYWFWPS
  3646.  
  3647. Note that you can only use this utility if the environment variable 
  3648. RESTARTUSERSHELL is set to NO (default value). Otherwise, the startup code 
  3649. would never complete. 
  3650.  
  3651. This executable resides in the SecureEntry installation path, EXEC directory. 
  3652.  
  3653.  
  3654. ΓòÉΓòÉΓòÉ 6.6.7. Sample startup process ΓòÉΓòÉΓòÉ
  3655.  
  3656. This is an example of a secure startup cmd. It should be named 'EDYSTART.CMD' 
  3657. and placed in the boot drive's root directory. 
  3658.  
  3659.   rem move the slider to the first position
  3660.   edylksld
  3661.   rem show a message
  3662.   edylkmsg "Starting Server services"
  3663.   rem move the slider to the third position
  3664.   edylksld 3
  3665.   rem starting net
  3666.   net start requester
  3667.   edylksld
  3668.   rem show a message
  3669.   edylkmsg "Start communications manager"
  3670.   rem start sessions
  3671.   cmstart
  3672.   edylksld 6
  3673.   edylkmsg "Starting background processes."
  3674.   start myserver.exe
  3675.   edylksld 8
  3676.   edylkmsg "Starting daemon"
  3677.   rem  Next instruction will start our own daemon program when the secure startup cmd ends but
  3678.   rem  will remain the secure startup window for 10 seconds.
  3679.   edylkswt -P:C:\MYAPPS\MYDAEMON.EXE -S:3 -D:C:\MYAPPS -U:10
  3680.   rem move slider
  3681.   edylksld 9
  3682.   rem assign resources
  3683.   net use J: MyAlias
  3684.   rem Slider : 100% completed
  3685.   edylksld
  3686.   rem  end the secure startup process. After executed, all the programs specified with the
  3687.   rem  edylkswt instruction will be launched.
  3688.   rem  exit the cmd
  3689.   @exit
  3690.  
  3691.  
  3692. ΓòÉΓòÉΓòÉ 6.7. Boot protection ΓòÉΓòÉΓòÉ
  3693.  
  3694. The SecureEntry Boot Protection tools allow you to protect the system from 
  3695. attempts to boot with uncontrolled operating systems through diskettes. There 
  3696. are basically three ways to accomplish this : 
  3697.  
  3698.    1. By using directly the machine system menus to define the startup sequence 
  3699.       of the machine not to look for diskette drives at startup and define an 
  3700.       administrator password to enter the system menus. This option does not 
  3701.       require SecureEntry help at all, but unfortunately not all available 
  3702.       hardware supports this features. 
  3703.  
  3704.    2. By changing the startup sequence through the machine BIOS, so that the 
  3705.       diskette drive is not 'seen' by the system at startup. This is the safest 
  3706.       one but can only be used with PS/2 models that have system programs on a 
  3707.       hard disk partition. This is called the BIOS boot control. 
  3708.  
  3709.    3. By protecting the master boot record of the machine so that 'alien' 
  3710.       operating systems can not see the protected partition. This is the only 
  3711.       left solution for machines which can not benefit from any of the previous 
  3712.       two methods. This is called software boot protection. 
  3713.  
  3714.  You have to decide which of the three methods to use for your hardware. 
  3715.  
  3716.      SecureEntry BIOS Boot control 
  3717.  
  3718.      SecureEntry Software boot protection 
  3719.  
  3720.  By last, and although not directly related to boot protection, note that you 
  3721.  can use the Master boot record saver provided utility, if what you are looking 
  3722.  for is also a means for preventing misbehaved programs from overwriting your 
  3723.  system disks master boot records. 
  3724.  
  3725.  
  3726. ΓòÉΓòÉΓòÉ 6.7.1. SecureEntry BIOS Boot control ΓòÉΓòÉΓòÉ
  3727.  
  3728. Description 
  3729.  
  3730. The BIOS boot control feature prevents end users from booting the system from a 
  3731. diskette drive and accessing the system setup menus. This feature applies only 
  3732. to the PS/2 models that have system programs on a hard disk partition. 
  3733.  
  3734. This security feature is implemented by changing the startup sequence through 
  3735. the system setup menus and controlling user access to the setup menus that 
  3736. reside on the system partition. The following should be fulfilled: 
  3737.  
  3738.      Obtaining the installation diskettes to be used on the production 
  3739.       workstations to install the boot control feature. 
  3740.      Setting up the production workstations. The startup sequence is changed 
  3741.       and the boot control feature is installed on each workstation. 
  3742.      Generating password diskettes to be used at the production sites by 
  3743.       system administrators. When a password is entered by the user and matches 
  3744.       the password on the diskette, the user can access the setup menus. 
  3745.  
  3746.  Obtaining installation diskettes 
  3747.  
  3748.  The installation diskettes for the boot control feature are obtained from a 
  3749.  reference diskette. 
  3750.  
  3751.  To generate reference diskettes, you must perform the following on a 
  3752.  workstation that has system programs on a hard disk partition: 
  3753.  
  3754.      Access the setup menus in one of the following ways, depending on the 
  3755.       system, during system startup: 
  3756.  
  3757.         -  Pressing Ctrl-Alt-Ins when the cursor appears on the top right 
  3758.            screen corner. 
  3759.  
  3760.         -  Pressing the required function key, usually F1. 
  3761.  
  3762.      Get a copy of the system programs. Choose the following sequence of 
  3763.       options from the setup menus: 
  3764.  
  3765.         -  Backup/Restore system programs 
  3766.  
  3767.         -  Backup the System Partition. 
  3768.  
  3769.       To get a copy of the system programs, you will need one or two diskettes. 
  3770.       The first one is the reference diskette, which will be used to obtain the 
  3771.       installation diskette. The second one is the diagnostics diskette, which 
  3772.       is not required for setting up the production workstations. 
  3773.  
  3774.  To generate installation diskettes, you must perform the following: 
  3775.  
  3776.      Ensure that the files EDYSREFD.EXE and EDYCHKPW.EXE are located on the 
  3777.       same directory, either on a hard disk or on a diskette. They can be 
  3778.       obtained from the SecureEntryPath\TOOLS path on the workstation. 
  3779.  
  3780.      From the directory where EDYSREFD.EXE and EDYCHKPW.EXE are located, run 
  3781.       EDYSREFD. This utility requests you to insert the reference diskette into 
  3782.       the diskette drive. 
  3783.  
  3784.  Upon completion, the contents of the diskette are modified and it becomes the 
  3785.  installation diskette. 
  3786.  
  3787.  Setting up the production workstations 
  3788.  
  3789.  To modify the startup boot sequence and prevent booting from diskette drive, 
  3790.  perform the following on every production workstation: 
  3791.  
  3792.      Access the setup menus. 
  3793.  
  3794.      Choose the following sequence of options from the setup menus: 
  3795.  
  3796.         -  Set features 
  3797.  
  3798.         -  Set startup sequence. 
  3799.  
  3800.      Select the hard disk as the primary startup device and the diskette drive 
  3801.       as the secondary startup device. 
  3802.  
  3803.      Save the new startup boot sequence. 
  3804.  
  3805.  To install the boot control feature, insert the installation diskette into the 
  3806.  diskette drive and restart the system. 
  3807.  
  3808.  Upon completion, the boot control feature is operative. To access the system 
  3809.  setup menus, a password diskette is necessary. 
  3810.  
  3811.  Generating password diskettes 
  3812.  
  3813.  To generate password diskettes, you must perform the following: 
  3814.  
  3815.      Ensure that the file EDYSETPW.EXE is available. It can be obtained from 
  3816.       the SecureEntryPath\TOOLS path on the workstation. 
  3817.  
  3818.      Insert an empty diskette into the diskette drive. 
  3819.  
  3820.      From the directory where EDYSETPW.EXE is located, run EDYSETPW. 
  3821.  
  3822.      Enter a password, which can be up to 8-characters long. 
  3823.  
  3824.      Enter the same password a second time for verification. 
  3825.  
  3826.  Upon completion, the diskette contains the password in encrypted mode. It 
  3827.  becomes the password diskette and can be used to access the system setup menus 
  3828.  on those workstations where the boot control feature is operative. 
  3829.  
  3830.  Accessing system setup menus 
  3831.  
  3832.  To access the system setup menus on those workstations where the boot control 
  3833.  feature is operative, a password diskette is necessary. 
  3834.  
  3835.  System administrators can provide end users with password diskettes so that 
  3836.  they can access the system setup menus as follows: 
  3837.  
  3838.      Insert the password diskette in a diskette drive. 
  3839.  
  3840.      Start up the system. 
  3841.  
  3842.      Access the setup menus. 
  3843.  
  3844.      Enter the password corresponding to the password diskette, when prompted. 
  3845.       The maximum number of attempts is three. 
  3846.  
  3847.  If the password is correct, the user can choose one of the following options: 
  3848.  
  3849.    1. Access setup menus 
  3850.  
  3851.       The setup menus appear on the screen. The user can change any settings, 
  3852.       even the startup sequence, which should be reestablished for security 
  3853.       reasons. 
  3854.  
  3855.    2. Change password 
  3856.  
  3857.       The user must provide first a new password for the password diskette and 
  3858.       then the same password for verification. If the passwords match, the 
  3859.       password on the password diskette changes. 
  3860.  
  3861.    3. Restricted operation 
  3862.  
  3863.       This option displays the following menu choices: 
  3864.  
  3865.         a. Return to the previous menu 
  3866.         b. Deactivate protection process 
  3867.  
  3868.            This option should be restricted to system administrators. If 
  3869.            selected, the boot control feature becomes not operative. 
  3870.  
  3871.  
  3872. ΓòÉΓòÉΓòÉ 6.7.2. SecureEntry Software Boot protection ΓòÉΓòÉΓòÉ
  3873.  
  3874. Description and procedures 
  3875.  
  3876. The SecureEntry software Boot Protection component makes it impossible to 
  3877. access partitions in the hard disk drives in a machine if the system has been 
  3878. booted from a floppy drive. Although booting from diskette can be carried out, 
  3879. the system will not be able to access the data in the partitions of the hard 
  3880. disk drives. 
  3881.  
  3882. Note that you can directly install this component through the program icons 
  3883. located within the SecureEntry installation tools folder. 
  3884.  
  3885. To enable the Boot Protection component run the following program from an OS/2 
  3886. session: 
  3887.  
  3888.  
  3889.      EDYNOTA.EXE /Ppassword
  3890.  
  3891.  password  This is your own keyword that enables the Boot Protection component 
  3892.  
  3893.  Then, add a line in your CONFIG.SYS file calling EDYNOTA.EXE program. For 
  3894.  example, if SGM_SHELL=E:\SGM then add the following line: 
  3895.  
  3896.  
  3897.        CALL=E:\SGM\EXEC\EDYNOTA.EXE /R
  3898.  
  3899.  At this point, the hard disks will be prevented to be accessed if the system 
  3900.  is booted from a diskette. 
  3901.  
  3902.  To inhibit the Boot Protection component, you must REM (or delete) the line 
  3903.  that you previously added to the CONFIG.SYS file, and then run the following 
  3904.  program from an OS/2 session: 
  3905.  
  3906.  
  3907.        EDYYESA.EXE /Ppassword
  3908.  
  3909.  password  This is the keyword that you previously used to enable the Software 
  3910.            Boot Protection component. 
  3911.  
  3912.  Once the Boot Protection component is installed, using EDYNOTA.EXE with a 
  3913.  password different from the keyword used when the Boot Protection component 
  3914.  was installed will not make any change to the Boot Protection component. 
  3915.  Similarly, the Boot Protection component will not be deinstalled if 
  3916.  EDYYESA.EXE is called with a password different from the keyword used when the 
  3917.  Boot Protection component was installed. 
  3918.  
  3919.  Messages 
  3920.  
  3921.  Notice that having the Boot Protection component enabled produces some side 
  3922.  effects: any program you run that reads the master boot record., e.g. FDISK, 
  3923.  will show you meaningless data since all partitions are marked as unused. 
  3924.  
  3925.  The following messages may appear: 
  3926.  
  3927.      EDYNOTA.EXE (run-time) 
  3928.  
  3929.         -  Successful operation (even with a warning): 
  3930.  
  3931.                       Ok
  3932.  
  3933.         -  Warning: 
  3934.  
  3935.                       Boot protection already installed on disk X - Password ignored
  3936.                       Password ignored
  3937.                       Boot protection not installed on disk X
  3938.                       Boot protection already installed on disk X
  3939.  
  3940.         -  Error: 
  3941.  
  3942.                       Error produced on WEEKDAY, DATE AND TIME
  3943.                       ------------------------------------------
  3944.                        Source Module Name: SOURCE MODULE NAME
  3945.                        Compilation Date  : COMPILATION DATE
  3946.                        Compilation Time  : COMPILATION TIME
  3947.                        Source Line Number: SOURCE LINE NUMBER
  3948.                        Logged Error      : (hex)=RC (dec)=RC
  3949.  
  3950.            In this case, this error message will also be output to an ASCII 
  3951.            file named EDYLOGA.ERR. 
  3952.  
  3953.      EDYYESA.EXE (run-time) 
  3954.  
  3955.         -  Successful operation (even with a warning): 
  3956.  
  3957.                       Ok
  3958.  
  3959.         -  Warning: 
  3960.  
  3961.                       Boot protection not installed on disk X
  3962.                       Invalid password
  3963.  
  3964.         -  Error: the same type of message shown with EDYNOTA.EXE. 
  3965.  
  3966.      EDYBOOT.SYS (boot-time) 
  3967.  
  3968.         -  Successful operation: none. 
  3969.  
  3970.         -  Warning: none. 
  3971.  
  3972.         -  Error: 
  3973.  
  3974.                       Cannot read partition
  3975.                       Invalid partition
  3976.  
  3977.  Compatibility with OS/2 standalone dump facility 
  3978.  
  3979.  Note that if you use the standard OS/2 feature TRAPDUMP to initiate a system 
  3980.  dump of the machine memory to a hard disk (SADUMP partition) automatically 
  3981.  whenever a system fatal fault is produced, then if SecureEntry boot protection 
  3982.  is installed, the dump partition may not be recognized by the dump facility 
  3983.  program. To overcome this situation, either : 
  3984.  
  3985.      Remove SecureEntry boot protection before reproducing the situation that 
  3986.       causes the memory dump to be initiated, or 
  3987.  
  3988.      Use the supplied command EDYPDUMP.CMD to patch the OS/2 dump facility 
  3989.       code so that it will recognize SecureEntry boot protected partitions. 
  3990.       This program is located within your SecureEntry path, EXEC directory.. 
  3991.       You can invoke it without parameters to read a usage description. 
  3992.       Basically, running : 
  3993.  
  3994.                       EDYPDUMP SET
  3995.       will patch the dump code, and 
  3996.  
  3997.                       EDYPDUMP RESET
  3998.       will unpatch it. If you intend to use this approach in production 
  3999.       machines, you should TEST it with your hardware before implementing it. 
  4000.       There is a small risk that this technique is not compatible with certain 
  4001.       types of SCSI adapters. 
  4002.  
  4003.  Return Codes 
  4004.  
  4005.  At run-time, successful operation or warning returns the value 0 to the 
  4006.  command line. A failure returns 1 to the command line. 
  4007.  
  4008.  At boot-time, successful operation lets the system to continue the boot 
  4009.  process. A failure makes the boot strap to enter an endless loop. 
  4010.  
  4011.  
  4012. ΓòÉΓòÉΓòÉ 6.8. File integrity check ΓòÉΓòÉΓòÉ
  4013.  
  4014. The SecureEntry file integrity check component provides a means of validate the 
  4015. integrity of all static data and program files at either start-up time or prior 
  4016. to the use of the files. A variety of integrity-checking schemes is offered, 
  4017. including fast and effective checking for virus changes and thorough 
  4018. cryptographic validation. 
  4019.  
  4020. The SecureEntry file integrity check component configuration table is used to 
  4021. specify which files in the system will be checked for integrity by comparing 
  4022. checksums during startup. These checksums must be computed beforehand using an 
  4023. utility. 
  4024.  
  4025. For a particular file, you can select one of two possible checksum algorithms: 
  4026.  
  4027.      XOR the 64th bit 
  4028.  
  4029.      MD4 Message Digest Algorithm 
  4030.  
  4031.  XORing the 64th bit is fastest than applying MD4, but MD4 is safest. 
  4032.  
  4033.      Components description 
  4034.  
  4035.  
  4036. ΓòÉΓòÉΓòÉ 6.8.1. Components ΓòÉΓòÉΓòÉ
  4037.  
  4038.      To calculate a file checksum: 
  4039.  
  4040.             SAF2INGN.EXE <Method> <FileName>
  4041.  
  4042.             where: <Method> is 1 for XORing the 64th bit, or 3 for MD4
  4043.                    <FileName> is the name of the file to calculate the checksum
  4044.  
  4045.       Messages: 
  4046.  
  4047.         -  Successful operation: 
  4048.  
  4049.                       Calculated checksum:
  4050.  
  4051.         -  Error: 
  4052.  
  4053.                       Usage: SAF2INGN Method Filename
  4054.                       Invalid method
  4055.                       Open file error
  4056.                       Invalid Checksum
  4057.  
  4058.       Return Codes: Successful operation returns the value 0 to the command 
  4059.       line. A failure returns the corresponding Return Code to the command 
  4060.       line. 
  4061.  
  4062.      To verify a series of files: 
  4063.  
  4064.             SAF2INCK.EXE <ParmFile> <CheckID> <OutFile> [<OptProgram>]
  4065.  
  4066.             where: <ParmFile> is the name of the file with filenames to check
  4067.                    <CheckID> is the line(s) with ID in file to be checked
  4068.                    <OutFile> is the output results file, which is stdout if
  4069.                              it cannot be opened
  4070.                    <OptProgram> is an optional program that is started on
  4071.                    successful check
  4072.  
  4073.       The <ParmFile> must adjust to the following syntax: 
  4074.  
  4075.             <CheckID> <CheckSumMethod> <CheckSum> <FileName>
  4076.                 |            |             |          |
  4077.                 |            |             |          +-> Name of the file to be checked
  4078.                 |            |             +------------> Hexadecimal CheckSum
  4079.                 |            +--------------------------> 00001: XOR the 64th bit
  4080.                 |                                         00003: MD4
  4081.                 +---------------------------------------> CheckID for current line
  4082.  
  4083.       In the following example, the files C:CONFIG.SYS and C:AUTOEXEC.BAT will 
  4084.       be checked for checksums of 77 and 40, respectively, XORing the 64th bit 
  4085.       if SAF2INCK.EXE is invoked with a CheckID of 10000; and the files 
  4086.       C:OS2\SYSTEM\CONFIG.DOS and C:OS2\SYSTEM\AUTOEXEC.DOS will be checked for 
  4087.       checksums of 7F89AA02751EA8908348C4C38D9D390A and 
  4088.       680A5CA3E0F9B8A5372B39EB856CE268, respectively, using MD4 if SAF2INCK.EXE 
  4089.       is invoked with a CheckID of 1000A. 
  4090.  
  4091.             10000 00001 77                               C:CONFIG.SYS
  4092.             10000 00001 40                               C:AUTOEXEC.BAT
  4093.             1000A 00003 7F89AA02751EA8908348C4C38D9D390A C:OS2\SYSTEM\CONFIG.DOS
  4094.             1000A 00003 680A5CA3E0F9B8A5372B39EB856CE268 C:OS2\SYSTEM\AUTOEXEC.DOS
  4095.             * Comments can be inserted with a '*' at the beginning of a line
  4096.  
  4097.       Messages: 
  4098.  
  4099.         -  Successful operation: 
  4100.  
  4101.                       Check OK !!!!
  4102.  
  4103.         -  Error: 
  4104.  
  4105.                       Wrong usage
  4106.                       Unable to open configuration file
  4107.                       Error(s) found during check
  4108.                       Invalid method
  4109.                       Open file error
  4110.                       Invalid Checksum
  4111.                       Unknown checkid
  4112.                       System stopped
  4113.  
  4114.       Return Codes: Successful operation returns the value 0 to the command 
  4115.       line. A failure returns the corresponding Return Code to the command 
  4116.       line. 
  4117.  
  4118.      To calculate a series of files checksums: 
  4119.  
  4120.             SAF2GEN.CMD <CheckID> <FileSpec[+Filespec..]> <Method> [/S] [/H] [/R] [/T]
  4121.  
  4122.             where: <CheckID>  is the check id to generate on output for each processed file
  4123.                    <Method>   is 1 for XORing the 64th bit, or 3 for MD4
  4124.                    <FileSpec> are the names of the files to calculate checksum for, with
  4125.                               wildcards allowed
  4126.                    /S         optionally does recursive searching in the included directories
  4127.                    /H         include also hidden files
  4128.                    /R         include also readonly files
  4129.                    /T         include also system files
  4130.  
  4131.       On output, this command generates the expected output for running 
  4132.       SAF2INCK, so you can redirect it to a file and use it as a <ParmFile>. 
  4133.       Any error found will be output with a beginning '*' character, so that 
  4134.       SAF2INCK will interpret it as a comment (i.e, when the checksum could not 
  4135.       be calculated because, for instance, another process is using the file). 
  4136.  
  4137.       Return Codes: Successful operation returns the value 0 to the command 
  4138.       line. If the checksum for all the intended files could not be calculated, 
  4139.       1 is returned. Syntax errors in the calling command cause 2 to be 
  4140.       returned. 
  4141.  
  4142.       In the following sample, all files in C:\OS2\DLL and C:\CMLIB\DLL are 
  4143.       having their checksum calculated, and appended to a param file where we 
  4144.       calculate also the checksums for all the tree in C:\MYDIR with id 00001 
  4145.       and method 3. The output parameter file will be PARMFILE.DAT. 
  4146.  
  4147.  
  4148.                  SAF2GEN 1 C:\MYDIR\* 3 /S >PARMFILE.DAT
  4149.                  SAF2GEN 1 C:\OS2\DLL\*+C:\CMLIB\DLL\* 3 /S >>PARMFILE.DAT
  4150.  
  4151.                  Note that checkid will be left padded with 0's. in the output.
  4152.  
  4153.  
  4154. ΓòÉΓòÉΓòÉ 6.9. Processes auditor component ΓòÉΓòÉΓòÉ
  4155.  
  4156. The SecureEntry Processes Auditor Component allows you to get answers to 
  4157. questions such as: 
  4158.  
  4159.      Are there some processes hogging the CPU? Which? 
  4160.  
  4161.      Are the users actually using the tools the Corporation I work for has 
  4162.       invested on? Which of them have more acceptance? 
  4163.  
  4164.      Are there users who have a real CPU shortage in their systems? 
  4165.  
  4166.      Are there some users wasting their time when performing iterative tasks? 
  4167.  
  4168.      Are explicitly forbidden programs used in the Corporation's systems? 
  4169.  
  4170.  In order to work with this component, open the Processes Auditor Workbench, 
  4171.  located inside the SecureEntry Workbench. 
  4172.  
  4173.  You can create a profile for this component by dragging a copy from its 
  4174.  component profile template (EDYEXEC.INI) and dropping it. 
  4175.  
  4176.  In order to modify a processes auditor profile, drag and drop it into the 
  4177.  Processes Auditor Editor, or just double click it. Make the necessary changes 
  4178.  and then save the modified profile. Follow the editor's help for further 
  4179.  advice. 
  4180.  
  4181.  In order to verify the profile behavior, drag and drop it on the object 
  4182.  Processes Auditor Tester, or select the option test through the editor menu 
  4183.  bar. The defined profile will be activated. 
  4184.  
  4185.  Once configured, associate the profile to the desired user or group, by 
  4186.  dragging and dropping it into the adequate container of the users and groups 
  4187.  administration tool, or establish it as the default for the system, copying it 
  4188.  with its default name (EDYEXEC.INI) to the NOUSER folder. 
  4189.  
  4190.  When a user logs on the system, its related profile will be activated, yet his 
  4191.  or his SecureEntry group's if his does not exist. If the user does not have 
  4192.  any defined processes auditor profile, then the profile residing in the NOUSER 
  4193.  folder will be activated. If the NOUSER folder does not contain any processes 
  4194.  auditor profile, then no processes will be audited. 
  4195.  
  4196.  Since this is one of the SecureEntry Components that feedbacks the profile 
  4197.  with output data, a profile is not only downloaded at user logon time, but it 
  4198.  is also uploaded at user logoff time. You can use the Processes Auditor Editor 
  4199.  to display SecureEntry detailed collected data. 
  4200.  
  4201.  The Editor also provides additional extensions for exporting to or importing 
  4202.  from an external file information about detailed collected data. 
  4203.  
  4204.  Refer to Error codes and messages for a description of the error codes the 
  4205.  Processes Auditor Editor can return. 
  4206.  
  4207.      The collected information 
  4208.  
  4209.      Description of the modules and the API 
  4210.  
  4211.      Auditable Processes Dumper Tool: EDYEXEDM 
  4212.  
  4213.  
  4214. ΓòÉΓòÉΓòÉ 6.9.1. The collected information ΓòÉΓòÉΓòÉ
  4215.  
  4216. Output Collected Data by the SecureEntry Processes Auditor component is made up 
  4217. of: 
  4218.  
  4219.      CPU Usage by User By definition, this is the accumulated time when a 
  4220.       process is running at Ring 2 or Ring 3. In practice, you can think of it 
  4221.       as the amount of time a process has been executing, probably as a 
  4222.       consequence of the action of the user, using the resources owned by the 
  4223.       application. 
  4224.  
  4225.      CPU Usage by System By definition, this is the accumulated time when a 
  4226.       process is running at Ring 0. In practice, you can think of it as the 
  4227.       amount of time a process has been executing using system resources and 
  4228.       code, i.e., at device driver and kernel level. 
  4229.  
  4230.      Total CPU Usage This is the sum of both User and System usage times, and 
  4231.       it measures the amount of time a specific process has been running at 
  4232.       task time. 
  4233.  
  4234.      Total Execution Time This measures the elapsed amount of time between the 
  4235.       process has started and its termination. 
  4236.  
  4237.      Real Invocations This is the number of times a different instance of the 
  4238.       selected process has been found running. 
  4239.  
  4240.  As a rule of thumb, since the total CPU usage reflects the amount of time a 
  4241.  process has been running at task time, subtracting this amount from the 
  4242.  elapsed time gets the value for interrupt and disabled time processing. 
  4243.  
  4244.  The system clock granularity, which is 31.25 ms per timer tick, makes CPU User 
  4245.  and System times rather useless for anything but gross measurement, so beware 
  4246.  you can get meaningless information if you audit your profile during a 
  4247.  relatively short period of time. 
  4248.  
  4249.  
  4250. ΓòÉΓòÉΓòÉ 6.9.2. Description of the modules and the API ΓòÉΓòÉΓòÉ
  4251.  
  4252. What follows is the description of the modules integrated in this component: 
  4253.  
  4254.      EDYEXECE 
  4255.  
  4256.       This is the program editor of profiles. It accepts the following syntax: 
  4257.  
  4258.  
  4259.                  EDYEXECE.EXE [Profile]
  4260.  
  4261.       Where Profile is the path and file name of the desired profile. The 
  4262.       editor allows for testing a profile directly. 
  4263.  
  4264.      EDYEXECT 
  4265.  
  4266.       This is the program activator of profiles. It accepts the following 
  4267.       syntax: 
  4268.  
  4269.  
  4270.                  EDYEXECT.EXE /F[Profile]
  4271.  
  4272.         -  /FProfile activates the profile defined in Profile. If Profile does 
  4273.            not exist, no processes are audited. 
  4274.  
  4275.         -  /F activates the profile EDYEXEC.INI defined in the NOUSER. If the 
  4276.            profile does not exist, no processes are audited. 
  4277.  
  4278.      Processes auditor component interface 
  4279.  
  4280.       The component exports the following routine, defined in EDYEXECD.H. The 
  4281.       routine executes correctly if it returns zero; otherwise it returns the 
  4282.       gotten error: 
  4283.  
  4284.  
  4285.               APIRET _System ActivateExecsAuditor(PSZ pszFileName);
  4286.  
  4287.            Activates the profile defined in pszFileName. If pszFileName 
  4288.            contents is empty, then no processes are audited. 
  4289.  
  4290.            If pszFileName points to "", then NOUSER ini file will be handled. 
  4291.  
  4292.            If the file does not exist, then an error is returned and no 
  4293.            processes are audited. 
  4294.  
  4295.  
  4296. ΓòÉΓòÉΓòÉ 6.9.3. Auditable Processes Dumper Tool: EDYEXEDM ΓòÉΓòÉΓòÉ
  4297.  
  4298. The EDYEXEDM  tool can be used to extract and/or to reset in batch mode the 
  4299. collected information by the processes auditor component. The extracted 
  4300. information will be stored in a text file with the same format as the one used 
  4301. by the Processes Auditor Editor  to import and export the detailed collected 
  4302. data. 
  4303.  
  4304. The invocation syntax for this command is as follows: 
  4305.  
  4306.  
  4307. EDYEXEDM ? | /Help | [/Outfile:f] [/Users:{mask[+mask...]|@file.lst}]
  4308.          [/Groups:{mask[+mask...]|@file.lst}]
  4309.          [/Process:{process[+process...]|@file.lst}]
  4310.          [/Cpu:{U|S}ratio] [/Reset | /ONLYReset]
  4311.          [/Info:{[U|G] [M|S] [D|D[..]date{[..]|[..date...]}|D@file.lst]
  4312.                  [OCU|OCS|OCT]}]
  4313.  
  4314.  
  4315.     /Help and ?  : Usage.
  4316.     /Outfile     : Output file path and name. Defaults to EDYEXEDM.TXT.
  4317.     /Users       : Only extract the information of the processes belonging
  4318.                    to the users matching the specified masks.
  4319.     /Groups      : Only extract the information of the processes belonging
  4320.                    to the users of the groups matching the
  4321.                    specified masks.
  4322.     /Process     : Only extract the information of the specified processes.
  4323.     /Cpu         : Only store the extracted information of the processes
  4324.                    with:
  4325.                    U  a Cpu usage by user ratio larger or equal
  4326.                       than the specidied ratio (0-100).
  4327.                    S  a Cpu usage by system ratio larger or equal
  4328.                       than the specified ratio (0-100).
  4329.     /Reset       : Also reset in the profile the extracted information
  4330.                    of the processes.
  4331.     /ONLYReset   : Reset and do not extract the information of
  4332.                    the processes.
  4333.     /Info        : Determines how is stored in the output file the extracted
  4334.                    information. At least one of the next values
  4335.                    must be specified:
  4336.                    U  join the information of the processes of all the users.
  4337.                    G  join the information of the processes of all the users
  4338.                       belonging to the same group.
  4339.                    M  merge all the invocations belonging to the same process.
  4340.                    S  summarize all the invocations of the same process.
  4341.                    D  merge the invocations belonging to the same process that
  4342.                       start the same day.
  4343.                    D[..]date{[..]|[..date...]} and D@file.list
  4344.                         merge the invocations belonging to the same process
  4345.                         that start in the same interval of time.
  4346.                         The border interval date have the "dd-mm-yyyy" format.
  4347.                    OCU  order the invocations by cpu usage by user.
  4348.                    OCS  order the invocations by cpu usage by system.
  4349.                    OCT  order the invocations by the cpu usage total.
  4350.                       (by default the invocations are ordered by start date)
  4351.  
  4352. So for instance: 
  4353.  
  4354.   EDYEXEDM /U:EDYADMIN+U* /G:@GROUP.LST /C:U30 /INFO:G S OCT
  4355.  
  4356. Extract the process information for the EDYADMIN  user, the users matching with 
  4357. U*  and the users of the groups matching the masks specified in the GROUP.LST 
  4358. file. Also, only the processes with a cpu usage by user ratio larger than 30 
  4359. will be considered. The information extracted will be stored by groups, 
  4360. summarizing the invocations and sorting it by total cpu usage. 
  4361.  
  4362.   EDYEXEDM /U:* /R /INFO:D..12-09-1999..12-10-1999..
  4363.  
  4364. Extract and reset the process information for all the users. The information is 
  4365. stored merging all the invocations that start before 12-09-1999 in one line. 
  4366. Between 12-09-1999 and 12-10-1999 in another line,  and after 12-10-1999 as the 
  4367. third summary line. 
  4368.  
  4369.   EDYEXEDM /U:@USER.LST /P:* /ONLYR
  4370.  
  4371. Reset the information of the process * for the users matching the masks 
  4372. specified in the USER.LST file. 
  4373.  
  4374. Note that the M  and S  values of the /INFO  parameter perform exactly the same 
  4375. task as the Merge  and  Summarize commands of the Processes Auditor Editor. 
  4376.  
  4377. This module resides in the SecureEntryPath, EXEC directory. 
  4378.  
  4379.  
  4380. ΓòÉΓòÉΓòÉ 6.10. Lotus Notes Component ΓòÉΓòÉΓòÉ
  4381.  
  4382. The SecureEntry Lotus Notes Component allows you to integrate the following 
  4383. data in a single compressed file: 
  4384.  
  4385.      A NOTES.INI file 
  4386.  
  4387.      A .ID file 
  4388.  
  4389.      A password 
  4390.  
  4391.  This means that you can take a user NOTES.INI, .ID file and password, put them 
  4392.  into a file, and make this file to travel with the user, no matter what 
  4393.  workstation the user logs on. The password inside the profile is gathered 
  4394.  scrambled. 
  4395.  
  4396.  At logon time, NOTES.INI and the .ID file are copied to the customized 
  4397.  directories in the user workstation. SecureEntry adds a Lotus Notes Extension 
  4398.  Manager Add-In, so that it gets control whenever the Lotus Notes client 
  4399.  program requests the password to the user. 
  4400.  
  4401.  At run-time, if a password has been customized, SecureEntry provides the user 
  4402.  password to the Lotus Notes client program, without any user interaction. If 
  4403.  the password is unknown, or wrong, then SecureEntry requests the password to 
  4404.  the user the first time the Lotus Notes client program requests it. Then, 
  4405.  SecureEntry validates the password, gathers it inside the profile, and gives 
  4406.  it back to Lotus Notes client program, so that normal execution continues. 
  4407.  SecureEntry handles the Change Password event in a similar way. 
  4408.  
  4409.  Since the file NOTES.INI is updated during a Lotus Notes working session, and 
  4410.  so may the .ID file and the user password, a Lotus Notes profile is uploaded 
  4411.  at user logoff time. 
  4412.  
  4413.  In order to work with this component, open the Lotus Notes Workbench, located 
  4414.  inside the SecureEntry Workbench. 
  4415.  
  4416.  The SecureEntry installer program detects the Java version installed in the 
  4417.  system and creates the object Lotus Notes Editor for Java for that version. If 
  4418.  you don't have a Java version installed, or it is different from Java 1.1.x, 
  4419.  then it automatically creates the object for Java2. 
  4420.  
  4421.  You can create a profile for this component by dragging a copy from its 
  4422.  component profile template (EDYNT.LOT) and dropping it. 
  4423.  
  4424.  In order to modify a Lotus Notes profile, drag and drop it into the Lotus 
  4425.  Notes Editor for Java, or just double click on the profile. Make the necessary 
  4426.  changes and then save the modified profile. Since the contents of a Lotus 
  4427.  Notes SecureEntry profile may vary during a Lotus Notes working session, 
  4428.  trying to overwrite a given profile currently active will result in the editor 
  4429.  returning the error code ERROR_BUSY (170). Follow the editor's help for 
  4430.  further advice. 
  4431.  
  4432.  In order to verify the profile behavior, drag and drop it on the object Lotus 
  4433.  Notes Tester. The defined profile will be activated. Notice that for the 
  4434.  profile to be correctly activated, the Lotus Notes client program cannot be 
  4435.  running; otherwise, the return code ERROR_BUSY (170) will be returned. Once 
  4436.  the profile is active, you can kick again the Lotus Notes client program. 
  4437.  
  4438.  Once configured, associate the profile to the desired user or group, by 
  4439.  dragging and dropping it into the adequate container of the users and groups 
  4440.  administration tool, or establish it as the default for the system, copying it 
  4441.  with its default name (EDYNT.LOT) to the NOUSER folder. 
  4442.  
  4443.  When a user logs on the system, its related profile will be activated, yet his 
  4444.  or his SecureEntry group's if his does not exist. If the user does not have 
  4445.  any defined Lotus Notes profile, then the profile residing in the NOUSER 
  4446.  folder will be activated. If the NOUSER folder does not contain any Lotus 
  4447.  Notes profile, then no profile will be activated. 
  4448.  
  4449.  Note that full portability with Windows NT is provided, i.e., profiles 
  4450.  generated under SecureEntry for OS/2 are totally compatible under SecureEntry 
  4451.  for NT, and viceversa. This means that you can use the same profile at logon 
  4452.  time, no matter what the underlying operating system in the client workstation 
  4453.  is. 
  4454.  
  4455.      Description of the modules and the API 
  4456.  
  4457.      Providing NLS support to the editor 
  4458.  
  4459.  
  4460. ΓòÉΓòÉΓòÉ 6.10.1. Description of the modules and the API ΓòÉΓòÉΓòÉ
  4461.  
  4462. What follows is the description of the modules integrated in this component: 
  4463.  
  4464.      EDNOTES 
  4465.  
  4466.       This is the editor program of profiles. Expected syntax: 
  4467.  
  4468.  
  4469.                  EDNOTES.CMD [Profile]
  4470.  
  4471.       Where Profile is the path and file name of the desired profile. 
  4472.  
  4473.      EDYNTTST 
  4474.  
  4475.       This is the program activator of profiles. It accepts the following 
  4476.       syntax: 
  4477.  
  4478.  
  4479.                  EDYNTTST.EXE [Profile]
  4480.  
  4481.         -  Profile activates the profile defined in Profile. If Profile does 
  4482.            not exist, no profile is activated. 
  4483.  
  4484.         -  Without parameters, it activates the profile EDYNT.LOT defined in 
  4485.            the NOUSER. If the profile does not exist, no profile is activated. 
  4486.  
  4487.       Notes: 
  4488.  
  4489.         1. Any printed-out Lotus Notes error "Error reading Character Set 
  4490.            Translation File" at activation time must be ignored. 
  4491.  
  4492.         2. At run-time, any cancelled password change may make Lotus Notes to 
  4493.            show a dialog box stating that the operation was cancelled. 
  4494.  
  4495.      EDYNTBAT 
  4496.  
  4497.       This program generates a profile through the command line, i.e., in 
  4498.       unattended mode. It may be used to generate mass profiles from the 
  4499.       command line. 
  4500.  
  4501.  
  4502.                  EDYNTBAT  [ -INISOURCE:Source [ -INITARGET:Target ] ]
  4503.                            [ -IDSOURCE:Source  [ -IDTARGET:Target  ] -IDNAME:Name [ -IDUPLOADNEW:Y|N ] ]
  4504.                            [ -PWDSOURCE:Source | -PWD:Password ] [ -PWDCHANGE:Y|N ]
  4505.                            -VLB:Target [ -OVERWRITE:Y|N ]
  4506.  
  4507.  
  4508.                    -INISOURCE:   get NOTES.INI from full path and file name. If not specified,
  4509.                                  NOTES.INI already located in the client will be used.
  4510.                    -INITARGET:   put NOTES.INI to specific full path. If not specified,
  4511.                                  NOTES.INI will be left in Lotus Notes Data directory.
  4512.                    -IDSOURCE:    get .ID from full path and file name. If not specified, .ID
  4513.                                  already located in the client will be used.
  4514.                    -IDTARGET:    put .ID to specific full path. If not specified, .ID will be
  4515.                                  left in Lotus Notes Data directory.
  4516.                    -IDNAME:      designate the .ID file name.
  4517.                    -IDUPLOADNEW: upload new .ID in case of File->Tools->SwitchID. If not
  4518.                                  specified, it defaults to N.
  4519.                    -PWDSOURCE:   get password for .ID from full path and file name.
  4520.                    -PWD:         get password from the command line. If not PWDSOURCE nor PWD
  4521.                                  are provided, then the password for .ID is initially unknown.
  4522.                    -PWDCHANGE:   allow user to change the password for the .ID. If not
  4523.                                  specified, it defaults to Y.
  4524.                    -VLB:         full path and file name to the output profile. If no extension
  4525.                                  is provided, then ".LOT" is assumed.
  4526.                    -OVERWRITE:   overwrite the output profile if it already exists. If not
  4527.                                  specified, it defaults to N.
  4528.  
  4529.  
  4530.       Notes: 
  4531.  
  4532.         1. A valid path name must adjust to the following rules: 
  4533.  
  4534.                         drive:\
  4535.                         drive:\path
  4536.                         \\workstation\resource
  4537.                         \\workstation\resource\path
  4538.  
  4539.         2. Few checkings will be done regarding drives, paths, workstation 
  4540.            names, or resources available to the client workstation, since these 
  4541.            data cannot be verified at the Administrator workstation. 
  4542.  
  4543.         3. SecureEntry will create the subdirectory tree if it does not already 
  4544.            exist. 
  4545.  
  4546.         4. If you want to extract your user password from a plain text file, 
  4547.            keep in mind that Lotus Notes passwords can have a maximum length of 
  4548.            64 characters. SecureEntry will read from the beginning of the file 
  4549.            up to the first End Of Line with a maximum of 64 characters, 
  4550.            whichever comes first. 
  4551.  
  4552.      Lotus Notes component interface 
  4553.  
  4554.       Any user-written application using the SecureEntry Lotus Notes component 
  4555.       API must allocate a stack size of at least 32KB. This is a Lotus Notes 
  4556.       API requirement, which is used by the SecureEntry Lotus Notes API 
  4557.       component. 
  4558.  
  4559.       The component exports the following routines, defined in EDYNTAPI.H. The 
  4560.       routines execute correctly if they return zero; otherwise they return the 
  4561.       gotten error: 
  4562.  
  4563.         -  ActivateNotesVLB: activates a SecureEntry Lotus Notes profile 
  4564.  
  4565.  
  4566.                            unsigned long ActivateNotesVLB(char *pszFileVLB);
  4567.  
  4568.                 If pszFileVLB points to "", then NOUSER profile will be 
  4569.                 handled. 
  4570.  
  4571.                 If the file does not exist, then an error is returned and no 
  4572.                 profile will be activated. 
  4573.  
  4574.                 Any previously activated profile will be deactivated right 
  4575.                 before activating the new one, no matter if the new one does or 
  4576.                 does not exist. 
  4577.  
  4578.                 If the Notes code is running when calling ActivateNotesVLB, 
  4579.                 then error code ERROR_BUSY=170 will be returned. 
  4580.  
  4581.         -  CreateNotesVLB: validates and creates a SecureEntry Lotus Notes 
  4582.            profile. It may be used to generate mass profiles from an 
  4583.            application. 
  4584.  
  4585.  
  4586.                            unsigned long CreateNotesVLB(PNOTES_VLB pNotesVLB);
  4587.  
  4588.                 The fields of the structure pointed to by PNOTES_VLB are 
  4589.                 explained in detail in the header file EDYNTAPI.H and they are 
  4590.                 identical to the parameters for the command EDYNTBAT.EXE. 
  4591.  
  4592.                 If attempting to overwrite a profile which is currently active 
  4593.                 when calling CreateNotesVLB, then error code ERROR_BUSY=170 
  4594.                 will be returned. 
  4595.  
  4596.  
  4597. ΓòÉΓòÉΓòÉ 6.10.2. Providing NLS support to the editor ΓòÉΓòÉΓòÉ
  4598.  
  4599. If you want to translate the editor to another language and you have the Java 
  4600. Development Kit JDK, you can upgrade the editor translation by your own means 
  4601. using the following procedure: 
  4602.  
  4603.    1. Extract the file EdNotes.properties from one of the editor JAR files, 
  4604.       which are located in the directory EXEC: 
  4605.  
  4606.                 JAR xf ednotes1.jar EdNotes.properties, or
  4607.                 JAR xf ednotes2.jar EdNotes.properties
  4608.  
  4609.    2. Rename the file EdNotes.properties to EdNotes_XX.properties, where XX 
  4610.       represents the locale prefix you use, generally given by the environment 
  4611.       variable LANG. For example, for the french locale, XX=fr 
  4612.  
  4613.    3. Translate the file EdNotes_XX.properties depending on the defined rules 
  4614.       at the top of the file 
  4615.  
  4616.    4. Update the JAR files: 
  4617.  
  4618.                 JAR uf ednotes1.jar EdNotes_XX.properties
  4619.                 JAR uf ednotes2.jar EdNotes_XX.properties
  4620.  
  4621.  Please be aware that Java properties files names are case sensitive. 
  4622.  
  4623.  Since JAR files are actually ZIP files, if you don't have the JDK then you can 
  4624.  also translate the editor with a similar procedure using ZIP/UNZIP programs: 
  4625.  
  4626.    1. Extract the file EdNotes.properties from one of the editor JAR files, 
  4627.       which are located in the directory EXEC: 
  4628.  
  4629.                 UNZIP ednotes1.jar EdNotes.properties, or
  4630.                 UNZIP ednotes2.jar EdNotes.properties
  4631.  
  4632.    2. Rename the file EdNotes.properties to EdNotes_XX.properties, where XX 
  4633.       represents the locale prefix you use, generally given by the environment 
  4634.       variable LANG. For example, for the french locale, XX=fr 
  4635.  
  4636.    3. Translate the file EdNotes_XX.properties depending on the defined rules 
  4637.       at the top of the file 
  4638.  
  4639.    4. Update the JAR files: 
  4640.  
  4641.                 ZIP ednotes1.jar EdNotes_XX.properties
  4642.                 ZIP ednotes2.jar EdNotes_XX.properties
  4643.  
  4644.  The editor help file is located in the SecureEntry directory HELP and its name 
  4645.  is EDNOTES.HTM. You can translate it using any HTML editor. 
  4646.  
  4647.  
  4648. ΓòÉΓòÉΓòÉ 7. Security components - WorkPlace shell ΓòÉΓòÉΓòÉ
  4649.  
  4650.      Desktop restrictions component 
  4651.  
  4652.      The Personal desktop component 
  4653.  
  4654.      The Hooked objects component 
  4655.  
  4656.      The Launchpad component 
  4657.  
  4658.      The WarpCenter component 
  4659.  
  4660.      The shortcuts component 
  4661.  
  4662.      The Public Applications component 
  4663.  
  4664.  
  4665. ΓòÉΓòÉΓòÉ 7.1. The Desktop restrictions component ΓòÉΓòÉΓòÉ
  4666.  
  4667. The Desktop restrictions component allows you to place restrictions on the 
  4668. machine's desktop once a given profile is activated. You can, for instance set 
  4669. some objects invisible or disallow dragging of them, or completely/partially 
  4670. suppress the popup menu for the desired objects. 
  4671.  
  4672. In order to work with this component, please open the Desktop restrictions 
  4673. Workbench folder located in the SecureEntry Workbench folder : 
  4674.  
  4675. The Restrictions profiles come in two different fashions : Text profiles and 
  4676. binary profiles. You can only assign to users and groups the binary profiles. 
  4677.  
  4678. You can create a text profile for this component by dragging a copy from its 
  4679. component profile template (name is Text Profile). 
  4680.  
  4681. You can create a binary profile for this component by dragging a copy from its 
  4682. component profile template (name is Binary Profile). 
  4683.  
  4684. The tools that the desktop restrictions workbench provide are : 
  4685.  
  4686.      A desktop capturer, to capture the contents of your desktop (the objects 
  4687.       and their current settings). Capture a desktop by dropping a text profile 
  4688.       into the 'Desktop Restrictions Capturer' program object. 
  4689.  
  4690.      Both 'compilers', from binary to text and from text to binary, in order 
  4691.       to convert one profile to the contrary format. Do this by dropping the 
  4692.       given profile into the appropriate compiler program object (names are 
  4693.       'Binary to Text translator' and 'Text to binary translator'). 
  4694.  
  4695.      The 'Desktop restrictions tester' program object, to be able to test the 
  4696.       effects on the desktop of a given profile. Just drop a given binary 
  4697.       profile into this object to test it. 
  4698.  
  4699.      The 'Desktop restrictions editor' program object, which allows you to set 
  4700.       the desktop into edition mode, and be able to edit the restrictions of a 
  4701.       given binary profile. Use it by dropping into it a given binary profile. 
  4702.       The edit window will open and you can then edit any desktop object 
  4703.       restrictions for that profile by opening its restrictions notebook by 
  4704.       clicking into the 'Edit restrictions' menu item of its pop-up menu. 
  4705.  
  4706.      The direct editing feature : allows you to drop a given object into a 
  4707.       binary profile and edit then directly the object's restrictions for that 
  4708.       profile. 
  4709.  
  4710.      *************************************************************************
  4711.      * Note : Most of the processes explained underneath are only maintained *
  4712.      *        for compatibility reasons. Specifically, working your desktop  *
  4713.      *        restrictions  through text desktop profiles is no longer  the  *
  4714.      *        suggested way to do it,  since  working directly  with binary  *
  4715.      *        profiles is  a  far better and more  efficient way to achieve  *
  4716.      *        the same result.                                               *
  4717.      *************************************************************************
  4718.  
  4719.      Configuring desktop profiles starting with a text desktop profile 
  4720.  
  4721.      Testing desktop profiles 
  4722.  
  4723.      Modifying desktop profiles 
  4724.  
  4725.      Text desktop profile format 
  4726.  
  4727.      Managing desktop objects position 
  4728.  
  4729.      Workplace shell personalization 
  4730.  
  4731.      Desktop profile activation API 
  4732.  
  4733.      Commands syntax 
  4734.  
  4735.  
  4736. ΓòÉΓòÉΓòÉ 7.1.1. Configuring desktop profiles starting with a text desktop profile ΓòÉΓòÉΓòÉ
  4737.  
  4738. To configure a desktop profile, that is, to produce a binary file with the 
  4739. desktop profile information, you can either start with a binary profile and use 
  4740. the desktop profile editor to provide it with your desired restrictions, or 
  4741. start with a text desktop profile. In this later case, go through the following 
  4742. steps: 
  4743.  
  4744.    1. Editing the desktop profile 
  4745.  
  4746.    2. Compiling the desktop profile 
  4747.  
  4748.  Editing the text desktop profile 
  4749.  
  4750.  To edit and obtain a text desktop profile, go through the following steps: 
  4751.  
  4752.    1. Create an instance of the Text desktop profile object. Specify as object 
  4753.       title the name of the file where the desktop profile configuration data 
  4754.       will be stored. 
  4755.  
  4756.       You can also use a text file corresponding to a desktop profile already 
  4757.       configured. In this case, you may get the text desktop profile as 
  4758.       follows: 
  4759.  
  4760.           The text desktop profile is stored on the system and hence, already 
  4761.            available. 
  4762.  
  4763.           To re-use the active desktop profile, drop a text desktop profile 
  4764.            object into the Desktop profile capturer object. The tool stores the 
  4765.            information in the active binary desktop profile in the dropped text 
  4766.            desktop profile. 
  4767.  
  4768.            To re-use the desktop profile, you can also select the Capture 
  4769.            desktop option that appears under the Open option in a text desktop 
  4770.            profile object pop-up menu. 
  4771.  
  4772.            The tool can also be started from the command line. 
  4773.  
  4774.            When the tool is started, an OS/2 session is opened where it runs; 
  4775.            when the processing ends, the session window remains open. 
  4776.  
  4777.           If only the binary desktop profile is available, drop the binary 
  4778.            desktop profile object into the Binary-to-text translator object. 
  4779.  
  4780.            If you drop only a binary desktop profile, the tool creates a text 
  4781.            desktop profile with the binary desktop profile information. The 
  4782.            text desktop profile has the same filename as the binary desktop 
  4783.            profile and the TXT extension. If the TXT file already exists, the 
  4784.            tool creates a new one. 
  4785.  
  4786.            If you drop both a binary desktop profile and a text desktop 
  4787.            profile, the tool creates a new text desktop profile, with the same 
  4788.            filename and extension, that only contains the information in the 
  4789.            binary desktop profile. 
  4790.  
  4791.            To obtain the text desktop profile, you can also select the 
  4792.            Translate to text option that appears under the Open option in the 
  4793.            binary desktop profile object pop-up menu. 
  4794.  
  4795.            The tool can also be started from the command line. 
  4796.  
  4797.            When the tool is started, an OS/2 session is opened where it runs; 
  4798.            when the processing ends, the session window remains open. 
  4799.  
  4800.    2. Open the text desktop profile by double-clicking on the text desktop 
  4801.       profile object. 
  4802.  
  4803.       You can also edit the file with any text editor that preserves the 
  4804.       extended attributes. 
  4805.  
  4806.    3. Specify the desktop profile objects and their properties in the text 
  4807.       desktop profile. 
  4808.  
  4809.    4. Save the text desktop profile. 
  4810.  
  4811.  Compiling the text desktop profile 
  4812.  
  4813.  To compile a text desktop profile and obtain a binary desktop profile, drop 
  4814.  the text desktop profile object into the Text-to-binary translator object. 
  4815.  
  4816.  If you drop only a text desktop profile, the tool creates a binary desktop 
  4817.  profile with the text desktop profile configuration data. The binary desktop 
  4818.  profile has the same filename as the text desktop profile and the INI 
  4819.  extension. If the INI file already exists, the tool updates the file with the 
  4820.  configuration data in the text desktop profile. 
  4821.  
  4822.  If you drop both a text desktop profile and a binary desktop profile, the tool 
  4823.  updates the binary desktop profile with the configuration data in the text 
  4824.  desktop profile. On an object basis, new data is added or existing data is 
  4825.  modified; objects can not be deleted. 
  4826.  
  4827.  To obtain the binary desktop profile, you can also select the Translate to 
  4828.  binary option that appears under the Open option in the text desktop profile 
  4829.  object pop-up menu. 
  4830.  
  4831.  The tool can also be started from the command line. 
  4832.  
  4833.  When the tool is started, an OS/2 session is opened where it runs; when the 
  4834.  processing ends, the session window remains open. 
  4835.  
  4836.  The resulting binary file contains the information about the desktop profile 
  4837.  and is ready for test. 
  4838.  
  4839.  
  4840. ΓòÉΓòÉΓòÉ 7.1.2. Testing desktop profiles ΓòÉΓòÉΓòÉ
  4841.  
  4842. To test desktop profiles, that is, to try the binary files with desktop profile 
  4843. information before releasing them for production, go through the following 
  4844. steps: 
  4845.  
  4846.    1. Capture the original desktop profile so that it can be restored after the 
  4847.       test activities. Alternatively, you can always plan on logging off and on 
  4848.       again to reset the desktop restrictions after the test. 
  4849.  
  4850.       You can drop a text desktop profile into the Desktop profile capturer 
  4851.       object of the Desktop restrictions workbench folder. The tool stores the 
  4852.       information in the active binary desktop profile in the dropped text 
  4853.       desktop profile. 
  4854.  
  4855.       To capture the desktop profile, you can also select the Capture desktop 
  4856.       option that appears under the Open option in a text desktop profile 
  4857.       object pop-up menu. 
  4858.  
  4859.       The tool can also be started from the command line. 
  4860.  
  4861.       When the tool is started, an OS/2 session is opened where it runs; when 
  4862.       the processing ends, the session window remains open. 
  4863.  
  4864.    2. Activate the desktop profile to be tested. 
  4865.  
  4866.       You can drop the binary desktop profile object into the Desktop profile 
  4867.       tester object of the Desktop restrictions folder. 
  4868.  
  4869.       The Workplace Shell is updated with the desktop profile information. The 
  4870.       objects provided in the Desktop restrictions folder are not affected. 
  4871.  
  4872.       To activate the desktop profile, you can also select the Test desktop 
  4873.       profile option that appears under the Open option in the binary desktop 
  4874.       profile object pop-up menu. 
  4875.  
  4876.       The tool can also be started from the command line. 
  4877.  
  4878.    3. Check that the Workplace Shell looks and works as defined, according to 
  4879.       your test cases. 
  4880.  
  4881.  To restore the original desktop profile, drop the binary desktop profile 
  4882.  object into the Desktop profile tester object. You may get the binary desktop 
  4883.  profile as follows: 
  4884.  
  4885.      The binary desktop profile is stored on the system and hence, already 
  4886.       available. 
  4887.  
  4888.      If only the text desktop profile is available, drop the text desktop 
  4889.       profile object into the Text-to-binary translator object. 
  4890.  
  4891.  
  4892. ΓòÉΓòÉΓòÉ 7.1.3. Modifying desktop profiles ΓòÉΓòÉΓòÉ
  4893.  
  4894. To modify a desktop profile, that is, to update the binary file with the 
  4895. desktop profile information, you can go through the following steps. 
  4896.  
  4897.    1. Drop the Workplace Shell objects to be updated into the binary desktop 
  4898.       profile object. They can be dropped one-by-one or at a time. 
  4899.  
  4900.       For each dropped object, a notebook is opened. If the object has been 
  4901.       already defined for this desktop profile, the values that were specified 
  4902.       will be displayed. If the object has not been previously defined for this 
  4903.       desktop profile, the current values will be displayed. 
  4904.  
  4905.    2. Use the object notebook to specify: 
  4906.  
  4907.           A subset of the setup string parameters (Setup tab). 
  4908.  
  4909.            The OS/2 setup string is used to specify parameters that define the 
  4910.            behavior of the object. The SecureEntry parameter list also provides 
  4911.            for modifying the link property and enabling to make shadow copy of 
  4912.            the object only to user folders. 
  4913.  
  4914.           The options that can be selected from the object pop-up menu (Pop-up 
  4915.            tab). 
  4916.  
  4917.           The pages that can be modified in the object settings notebook 
  4918.            (Settings tab). 
  4919.  
  4920.       For information on how to navigate through the notebook pages and specify 
  4921.       configuration data, display help information by selecting Help from the 
  4922.       system menu, clicking on the Help button on the notebook page, or 
  4923.       pressing F1 with the cursor on a particular page. 
  4924.  
  4925.    3. Close the object notebook when all object properties are specified. You 
  4926.       should use the OK push button. 
  4927.  
  4928.  When all object notebooks are closed, the binary file contains the desktop 
  4929.  profile information and is ready for test. 
  4930.  
  4931.  To modify a desktop profile, you can also edit the text file with the 
  4932.  configuration data and translate the text file into a binary file, which will 
  4933.  contain the updated information. 
  4934.  
  4935.  
  4936. ΓòÉΓòÉΓòÉ 7.1.4. Text desktop profile format ΓòÉΓòÉΓòÉ
  4937.  
  4938. Follows the grammar description for the allowable syntax to be found within a 
  4939. text desktop profile. Note that for non-english SecureEntry language versions 
  4940. the keywords name may have been translated. If so, you can find the correct 
  4941. spelling within the SecureEntryPath\API\NLS\WRKB\EDYNLSxx.DLG, where xx 
  4942. corresponds to the specific country code. 
  4943.  
  4944. You can replicate the basic object text definition restrictions structure as 
  4945. many times as objects have to be defined. 
  4946.  
  4947. The following conventions are used: 
  4948.  
  4949.      UPPERCASE CHARACTERS represent values you specify directly, without any 
  4950.       change. 
  4951.  
  4952.      lowercased characters represent variables for which you can supply 
  4953.       values. 
  4954.  
  4955.  
  4956.          [objectname]|[DEFAULT]
  4957.  
  4958.            SETUP_DELETE=YES|Y|1|NO|N|0
  4959.            SETUP_COPY=YES|Y|1|NO|N|0
  4960.            SETUP_MOVE=YES|Y|1|NO|N|0
  4961.            SETUP_LINK=YES|Y|1|NO|N|0
  4962.            SETUP_RESTRICTED_LINK=YES|Y|1|NO|N|0
  4963.            SETUP_VISIBLE=YES|Y|1|NO|N|0
  4964.            SETUP_PRINT=YES|Y|1|NO|N|0
  4965.            SETUP_RENAME=YES|Y|1|NO|N|0
  4966.            SETUP_DRAG=YES|Y|1|NO|N|0
  4967.            SETUP_DROP=YES|Y|1|NO|N|0
  4968.            SETUP_SETTINGS=YES|Y|1|NO|N|0
  4969.  
  4970.            POPUP_OPEN=YES|Y|1|NO|N|0
  4971.            POPUP_SETTINGS=YES|Y|1|NO|N|0
  4972.            POPUP_ICON_VIEW=YES|Y|1|NO|N|0
  4973.            POPUP_TREE_VIEW=YES|Y|1|NO|N|0
  4974.            POPUP_DETAILS_VIEW=YES|Y|1|NO|N|0
  4975.            POPUP_PROGRAM=YES|Y|1|NO|N|0
  4976.            POPUP_PALETTE=YES|Y|1|NO|N|0
  4977.            POPUP_HELP=YES|Y|1|NO|N|0
  4978.            POPUP_CREATE_ANOTHER=YES|Y|1|NO|N|0
  4979.            POPUP_COPY=YES|Y|1|NO|N|0
  4980.            POPUP_MOVE=YES|Y|1|NO|N|0
  4981.            POPUP_SHADOW=YES|Y|1|NO|N|0
  4982.            POPUP_CREATE_PARTITION=YES|Y|1|NO|N|0
  4983.            POPUP_DELETE=YES|Y|1|NO|N|0
  4984.            POPUP_FIND=YES|Y|1|NO|N|0
  4985.            POPUP_PRINT=YES|Y|1|NO|N|0
  4986.            POPUP_SELECT=YES|Y|1|NO|N|0
  4987.            POPUP_LOCKUP=YES|Y|1|NO|N|0
  4988.            POPUP_SHUTDOWN=YES|Y|1|NO|N|0
  4989.            POPUP_SETUP=YES|Y|1|NO|N|0
  4990.            POPUP_SORT=YES|Y|1|NO|N|0
  4991.            POPUP_ARRANGE=YES|Y|1|NO|N|0
  4992.            POPUP_REFRESH=YES|Y|1|NO|N|0
  4993.            POPUP_CHANGE_STATUS=YES|Y|1|NO|N|0
  4994.            POPUP_SET_DEFAULT=YES|Y|1|NO|N|0
  4995.            POPUP_DISABLE_SPOOLER=YES|Y|1|NO|N|0
  4996.            POPUP_CHECKDISK=YES|Y|1|NO|N|0
  4997.            POPUP_FORMATDISK=YES|Y|1|NO|N|0
  4998.            POPUP_COPYDISK=YES|Y|1|NO|N|0
  4999.            POPUP_OPEN_PARENT=YES|Y|1|NO|N|0
  5000.            POPUP_PICKUP=YES|Y|1|NO|N|0
  5001.  
  5002.            SETTINGS_GENERAL=YES|Y|1|NO|N|0
  5003.            SETTINGS_SYSTEM_WINDOW=YES|Y|1|NO|N|0
  5004.            SETTINGS_CLOCK_VIEW1=YES|Y|1|NO|N|0
  5005.            SETTINGS_CLOCK_VIEW2=YES|Y|1|NO|N|0
  5006.            SETTINGS_COUNTRY_DATE=YES|Y|1|NO|N|0
  5007.            SETTINGS_COUNTRY_NUMBER=YES|Y|1|NO|N|0
  5008.            SETTINGS_COUNTRY_COUNTRY=YES|Y|1|NO|N|0
  5009.            SETTINGS_COUNTRY_TIME=YES|Y|1|NO|N|0
  5010.            SETTINGS_DESKTOP_LOCKUP1=YES|Y|1|NO|N|0
  5011.            SETTINGS_DESKTOP_LOCKUP2=YES|Y|1|NO|N|0
  5012.            SETTINGS_DESKTOP_LOCKUP3=YES|Y|1|NO|N|0
  5013.  
  5014.            SETTINGS_DISK_DETAILS=YES|Y|1|NO|N|0
  5015.            SETTINGS_FILE_MENU=YES|Y|1|NO|N|0
  5016.            SETTINGS_FILE_TYPE=YES|Y|1|NO|N|0
  5017.            SETTINGS_FILE_FILE1=YES|Y|1|NO|N|0
  5018.            SETTINGS_FILE_FILE2=YES|Y|1|NO|N|0
  5019.            SETTINGS_FILE_FILE3=YES|Y|1|NO|N|0
  5020.            SETTINGS_FOLDER_BACKGROUND=YES|Y|1|NO|N|0
  5021.            SETTINGS_FOLDER_INCLUDE=YES|Y|1|NO|N|0
  5022.            SETTINGS_FOLDER_SORT=YES|Y|1|NO|N|0
  5023.            SETTINGS_FOLDER_VIEW1=YES|Y|1|NO|N|0
  5024.            SETTINGS_FOLDER_VIEW2=YES|Y|1|NO|N|0
  5025.            SETTINGS_FOLDER_VIEW3=YES|Y|1|NO|N|0
  5026.            SETTINGS_KEYBOARD_MAPPINGS=YES|Y|1|NO|N|0
  5027.            SETTINGS_KEYBOARD_SPECIAL_NEEDS=YES|Y|1|NO|N|0
  5028.            SETTINGS_KEYBOARD_TIMING=YES|Y|1|NO|N|0
  5029.            SETTINGS_MOUSE_MAPPINGS=YES|Y|1|NO|N|0
  5030.            SETTINGS_MOUSE_TIMING=YES|Y|1|NO|N|0
  5031.            SETTINGS_MOUSE_SETUP=YES|Y|1|NO|N|0
  5032.            SETTINGS_CLOCK_ALARM=YES|Y|1|NO|N|0
  5033.            SETTINGS_POWER_POWER=YES|Y|1|NO|N|0
  5034.            SETTINGS_POWER_VIEW=YES|Y|1|NO|N|0
  5035.            SETTINGS_PROGRAM_PROGRAM=YES|Y|1|NO|N|0
  5036.            SETTINGS_PROGRAM_ASSOCIATION=YES|Y|1|NO|N|0
  5037.            SETTINGS_PROGRAM_SESSION=YES|Y|1|NO|N|0
  5038.            SETTINGS_SOUND_WARNING_BEEP=YES|Y|1|NO|N|0
  5039.            SETTINGS_SYSTEM_CONFIRMATIONS=YES|Y|1|NO|N|0
  5040.            SETTINGS_SYSTEM_LOGO=YES|Y|1|NO|N|0
  5041.            SETTINGS_CLOCK_DATA_TIME=YES|Y|1|NO|N|0
  5042.            SETTINGS_PRINTER_PRINTER_DRIVER=YES|Y|1|NO|N|0
  5043.            SETTINGS_SYSTEM_PRINT_SCREEN=YES|Y|1|NO|N|0
  5044.            SETTINGS_PRINTER_PRINT_OPTIONS=YES|Y|1|NO|N|0
  5045.            SETTINGS_SPOOL_PRINT_PRIORITY=YES|Y|1|NO|N|0
  5046.            SETTINGS_PRINTER_OUTPUT=YES|Y|1|NO|N|0
  5047.            SETTINGS_PRINTER_QUEUE_OPTIONS=YES|Y|1|NO|N|0
  5048.            SETTINGS_SYSTEM_SCREEN=YES|Y|1|NO|N|0
  5049.            SETTINGS_SYSTEM_SCREEN2=YES|Y|1|NO|N|0
  5050.            SETTINGS_SYSTEM_TITLE=YES|Y|1|NO|N|0
  5051.            SETTINGS_SPOOL_SPOOL_PATH=YES|Y|1|NO|N|0
  5052.            SETTINGS_PRINTER_VIEW=YES|Y|1|NO|N|0
  5053.            SETTINGS_GENERAL2=YES|Y|1|NO|N|0
  5054.            SETTINGS_SYSTEM_WINDOW2=YES|Y|1|NO|N|0
  5055.            SETTINGS_SYSTEM_WINDOW3=YES|Y|1|NO|N|0
  5056.            SETTINGS_ARCHIVE=YES|Y|1|NO|N|0
  5057.            SETTINGS_DESKTOP=YES|Y|1|NO|N|0
  5058.            SETTINGS_MOUSE_COMET_CURSOR=YES|Y|1|NO|N|0
  5059.            SETTINGS_MOUSE_POINTER_PAGE=YES|Y|1|NO|N|0
  5060.            SETTINGS_SYSTEM_INPUT=YES|Y|1|NO|N|0
  5061.  
  5062.  Note:  The following keywords apply only when working with IBM OS/2 V3.0 (OS/2 
  5063.  Warp): 
  5064.  
  5065.  
  5066.            SETUP_SETTINGS
  5067.            POPUP_OPEN_PARENT
  5068.            POPUP_PICKUP
  5069.            SETTINGS_GENERAL2
  5070.            SETTINGS_SYSTEM_WINDOW2
  5071.            SETTINGS_SYSTEM_WINDOW3
  5072.            SETTINGS_ARCHIVE
  5073.            SETTINGS_DESKTOP
  5074.            SETTINGS_MOUSE_COMET_CURSOR
  5075.            SETTINGS_MOUSE_POINTER_PAGE
  5076.            SETTINGS_SYSTEM_INPUT
  5077.  
  5078.  The objectname parameter value can be either the object title or the object 
  5079.  identifier. 
  5080.  
  5081.  The object identifier and the object title are specified in the OS/2 setup 
  5082.  string, which is used to specify parameters that define the behavior of the 
  5083.  object. The object identifier stays with the object even though the object 
  5084.  title is changed or the object is copied. The object you create is not 
  5085.  assigned an object identifier because identifiers must be unique through the 
  5086.  system. 
  5087.  
  5088.  Write the title or identifier exactly like the original, taking especial care 
  5089.  about capitals and blanks, and do not leave blanks between the brackets, < >, 
  5090.  and the value. 
  5091.  
  5092.  To specify an object title of more than one line, use the \n string. 
  5093.  
  5094.  If you specify DEFAULT as objectname parameter value, the properties you 
  5095.  define through the following keywords apply to all objects that do not appear 
  5096.  in the text desktop profile. 
  5097.  
  5098.  The first block of keywords corresponds to a subset of the setup string 
  5099.  parameters, as the SETUP_ prefix indicates, except for the 
  5100.  SETUP_RESTRICTED_LINK keyword. 
  5101.  
  5102.  This keyword restricts the scope of the SETUP_LINK keyword by enabling to make 
  5103.  shadow copy of the object only to user folders. 
  5104.  
  5105.  The keyword applies only if the SecureEntry user management and access control 
  5106.  features will be implemented in the target workgroup. 
  5107.  
  5108.  In addition, the SETUP_RESTRICTED_LINK keyword does not apply when making a 
  5109.  shadow copy of the object (SETUP_LINK keyword) is not enabled. If the 
  5110.  SETUP_LINK keyword is set to enable the property, the SETUP_RESTRICTED_LINK 
  5111.  keyword can be set to restrict or not to restrict the property. 
  5112.  
  5113.  When the desktop profile is activated, those properties not defined through 
  5114.  the SETUP_ keywords keep the value specified in the previously active desktop 
  5115.  profile. 
  5116.  
  5117.  The second block of keywords corresponds to the options that can be selected 
  5118.  from the object pop-up menu (POPUP_ prefix). 
  5119.  
  5120.  The third block of keywords corresponds to the pages that can be modified in 
  5121.  the object settings notebook (SETTINGS_ prefix). Pages under the same tab are 
  5122.  identified by using both the tab label and the page number; for example, 
  5123.  SETTINGS_CLOCK_VIEW1 and SETTINGS_CLOCK_VIEW2. 
  5124.  
  5125.  When the desktop profile is activated, those properties not defined through 
  5126.  the POPUP_ or SETTINGS_ keywords keep the value corresponding to the OS/2 
  5127.  Workplace Shell. 
  5128.  
  5129.  For all keywords the parameter value can be: 
  5130.  
  5131.  YES, Y, or 1 To enable a setup property, show a pop-up option, or add a 
  5132.            settings page. 
  5133.  
  5134.  NO, N, or 0 To disable a setup property, hide a pop-up option, or remove a 
  5135.            settings page. 
  5136.  
  5137.  Keywords and parameter values are not case-sensitive. 
  5138.  
  5139.  Text desktop profile sample 
  5140.  
  5141.  
  5142.   /* All objects in the desktop are not visible, except   */
  5143.   /* for those that appear explicitly in the file.        */
  5144.  
  5145.       [DEFAULT]
  5146.       SETUP_VISIBLE=NO
  5147.  
  5148.   /* The OS/2 System object would also be visible if the  */
  5149.   /* SETUP_VISIBLE=YES keyword-value pair did not appear  */
  5150.   /* in the file.                                         */
  5151.  
  5152.       [OS\2 System]
  5153.       SETUP_VISIBLE=YES
  5154.  
  5155.       [Workbench]
  5156.       SETUP_VISIBLE=YES
  5157.       SETUP_COPY=NO
  5158.       SETUP_MOVE=NO
  5159.       SETUP_DELETE=NO
  5160.       SETUP_DRAG=NO
  5161.       POPUP_COPY=NO
  5162.       POPUP_DELETE=NO
  5163.  
  5164.       [Desktop]
  5165.       POPUP_OPEN=NO
  5166.       POPUP_REFRESH=NO
  5167.       POPUP_HELP=YES
  5168.       POPUP_SHADOW=NO
  5169.       POPUP_LOCKUP=YES
  5170.       POPUP_SHUTDOWN=YES
  5171.       POPUP_SETUP=NO
  5172.       POPUP_FIND=NO
  5173.       POPUP_SELECT=NO
  5174.       POPUP_SORT=NO
  5175.       POPUP_ARRANGE=NO
  5176.  
  5177.  
  5178. ΓòÉΓòÉΓòÉ 7.1.5. Managing desktop objects position ΓòÉΓòÉΓòÉ
  5179.  
  5180. In order to control how SecureEntry will manage object positions within the 
  5181. Workplace, there are three different options : 
  5182.  
  5183.    1. The checkbox 'Save Desktop Settings' is checked in the Desktop page of 
  5184.       the settings notebook for the desktop. 
  5185.  
  5186.       In this case, object positions are handled by the Workplace Shell, so 
  5187.       that moving an object to another position is just a matter of really 
  5188.       dragging it, and it will stay there across sessions and shutdowns. Of 
  5189.       course, you will only be allowed to move it if the desktop restrictions 
  5190.       profile for your working session allow you to do so. 
  5191.  
  5192.    2. The checkbox 'Discard all changes on folder's positions when logging off' 
  5193.       is checked in the Desktop page of the settings notebook for the desktop. 
  5194.  
  5195.       In this case, SecureEntry maintains the positions of folders and contents 
  5196.       so that they will always appear in the same place for all users right 
  5197.       after logon, but you can play with your folder's positions during your 
  5198.       work session. 
  5199.  
  5200.       Administrator users have the additional option then to save the positions 
  5201.       at any moment by using the added 'save positions' option in the affected 
  5202.       folder's view popup menu. 
  5203.  
  5204.    3. The checkbox 'Discard all changes on folder's positions as soon as they 
  5205.       are closed' is checked in the Desktop page of the settings notebook for 
  5206.       the desktop. 
  5207.  
  5208.       In this case, SecureEntry maintains the positions of folders and contents 
  5209.       so that they will always appear in the same place for all users every 
  5210.       time they are opened. 
  5211.  
  5212.       Administrator users have the additional option then to save the positions 
  5213.       at any moment by using the added 'save positions' option in the affected 
  5214.       folder's view popup menu. 
  5215.  
  5216.  Note : Changes made to the desktop page of the settings notebook for the 
  5217.  desktop will only be honored after a WorkPlace Shell reload. In other words, 
  5218.  you may have to reboot the machine after checking the appropriate value to 
  5219.  observe the desired desktop behavior. 
  5220.  
  5221.  
  5222. ΓòÉΓòÉΓòÉ 7.1.6. Workplace Shell personalization ΓòÉΓòÉΓòÉ
  5223.  
  5224. When a SecureEntry user opens a SecureEntry session, the Workplace Shell is 
  5225. modified according to the specifications in the assigned desktop profile. The 
  5226. end user can then change the layout properties of the folders, the desktop 
  5227. folder inclusive: 
  5228.  
  5229.      Positions of the icons in the folder. 
  5230.  
  5231.       Through the Sort or Arrange option in the folder pop-up menu, through the 
  5232.       Sort page in the Settings notebook, or by dragging and dropping. 
  5233.  
  5234.      View properties of the folder. 
  5235.  
  5236.       Through the View pages in the Settings notebook: Icon view, Tree view, 
  5237.       and Details view. 
  5238.  
  5239.  When the SecureEntry user closes the SecureEntry session and opens a new one, 
  5240.  the initial settings are restored so that the end user is always provided with 
  5241.  the same Workplace Shell, regarding the properties defined through these 
  5242.  settings. This is true provided that the workplace is configured that way, as 
  5243.  explained under Managing desktop objects position. 
  5244.  
  5245.               **************************************************
  5246.               IMPORTANT NOTE
  5247.  
  5248.               What follows is  a  description of the  maintained
  5249.               functionality  on how  to  create  personalized
  5250.               (user associated) folders  and  memory folders
  5251.               using the desktop restrictions component through
  5252.               its  text  profile  definition  characteristics.
  5253.               This function is  still available and  supported
  5254.               for compatibility reasons, but you are encouraged
  5255.               to use The Personal desktop component to do the
  5256.               same tasks more efficiently from now on.
  5257.               **************************************************
  5258.  
  5259.  However, SecureEntry enables the system administrator to permanently associate 
  5260.  the new settings, that is, the settings specified during a SecureEntry 
  5261.  session, to the end user. To enable a folder to keep the new settings, when 
  5262.  the user closes the folder or performs logoff, the system administrator should 
  5263.  define it as memory folder. 
  5264.  
  5265.  In addition, SecureEntry enables the system administrator to provide 
  5266.  SecureEntry users with user folders, where the end user can create or delete 
  5267.  object shadows through the Create shadow option or Delete option, 
  5268.  respectively, in the object pop-up menu. Object shadows can also be created or 
  5269.  deleted by dragging and dropping objects into the user folder or into the OS/2 
  5270.  Shredder object, respectively. 
  5271.  
  5272.  The end user may keep the shadows of the objects that are more frequently used 
  5273.  in the user folder. The contents of the user folder are associated only to the 
  5274.  SecureEntry user that is logged-on. 
  5275.  
  5276.  Memory folders 
  5277.  
  5278.  If a folder is defined as memory folder, the changes performed during a 
  5279.  SecureEntry session to some layout properties are stored in a file associated 
  5280.  to the user that is logged-on. When the user opens another session, the layout 
  5281.  properties of the folder are restored according to the settings active the 
  5282.  last time the user performed logoff. 
  5283.  
  5284.  The folder properties that are stored for the memory folders are: 
  5285.  
  5286.      Positions of the icons. 
  5287.  
  5288.      View properties that can be set through the View pages in the Settings 
  5289.       notebook: Icon view, Tree view, and Details view. 
  5290.  
  5291.  The system administrator can define as memory folder any folder with an object 
  5292.  identifier, the desktop folder inclusive. 
  5293.  
  5294.  User folders 
  5295.  
  5296.  User folders are a SecureEntry class of folders where object shadows can be 
  5297.  created or deleted. 
  5298.  
  5299.  User folders can exist only in the desktop folder and can contain only shadows 
  5300.  of objects. They are removed from the desktop folder at logoff time and 
  5301.  re-created with all their contents when the user performs logon. When a user 
  5302.  folder is re-created, its title and object identifier are also restored. 
  5303.  
  5304.  To create a shadow of an object to a user folder, the object has to be 
  5305.  accordingly defined in the desktop profile assigned to the SecureEntry user 
  5306.  that is currently logged-on. That is, the making shadow copy property must be 
  5307.  enabled (SETUP_LINK keyword) but restricted to user folders 
  5308.  (SETUP_RESTRICTED_LINK keyword). 
  5309.  
  5310.  If a SecureEntry user is to be provided with a user folder, the first time 
  5311.  that logon takes place, an empty user folder is created. 
  5312.  
  5313.  The system administrator can specify whether a given SecureEntry group is 
  5314.  provided with a user folder through the personalization profile. 
  5315.  
  5316.  In addition, user folders should be defined through a settings notebook. 
  5317.  
  5318.  Configuring personalization profiles 
  5319.  
  5320.  Personalization profiles are configured on a SecureEntry group or user basis. 
  5321.  That is, one personalization profile can be configured for each SecureEntry 
  5322.  group or individually to a SecureEntry user. 
  5323.  
  5324.  To configure a personalization profile, you can produce a text file with the 
  5325.  configuration data and translate the text file into a binary file, which will 
  5326.  contain the personalization profile information. 
  5327.  
  5328.  Go through the following steps: 
  5329.  
  5330.      Editing the text personalization profile 
  5331.  
  5332.       To edit and obtain a text personalization profile, go through the 
  5333.       following steps: 
  5334.  
  5335.         1. Open a text file with any text editor that preserves the extended 
  5336.            attributes. You can use the file corresponding to an existing text 
  5337.            personalization profile. 
  5338.  
  5339.         2. Specify the configuration data in the text file. 
  5340.  
  5341.         3. Save the text file. 
  5342.  
  5343.       Text personalization profile format 
  5344.  
  5345.       You can replicate the basic structure of a memory folder as many times as 
  5346.       memory folders are to be defined. Only one user folder can be defined. 
  5347.       The following conventions are used: ;p. 
  5348.  
  5349.         -  UPPERCASE CHARACTERS represent values you specify directly, without 
  5350.            any change. 
  5351.  
  5352.         -  regular characters represent variables for which you can supply 
  5353.            values. 
  5354.  
  5355.       Text personalization profile keyword structure 
  5356.  
  5357.  
  5358.                    [objectname]
  5359.                      SAVE_ICONS_POSITION=YES|Y|1|NO|N|0
  5360.  
  5361.                    [_SE_PERSONAL_FOLDER_]
  5362.                      CREATE_FOLDER=YES|Y|1|NO|N|0
  5363.  
  5364.       The objectname parameter value can be either the object title or the 
  5365.       object identifier corresponding to the memory folder. 
  5366.  
  5367.       The SAVE_ICONS_POSITION keyword can be set to save (YES, Y, or 1) or not 
  5368.       to save (NO, N, or 0) the position of the objects that the memory folder 
  5369.       contains at logoff time and to display them in that position after logon. 
  5370.  
  5371.       The CREATE_FOLDER keyword can be set to create (YES, Y, or 1) or not to 
  5372.       create (NO, N, or 0) a user folder at startup time. 
  5373.  
  5374.       Keywords and parameter values are not case-sensitive. Text 
  5375.       personalization profile sample 
  5376.  
  5377.  
  5378.             /* The desktop folder keeps its layout and the productivity  */
  5379.             /* folder does not keep its contents positions.  The other   */
  5380.             /* folders do not keep their contents positions, either.     */
  5381.  
  5382.                    [<WP_DESKTOP>]
  5383.                      SAVE_ICONS_POSITION=YES
  5384.  
  5385.                    [<WP_TOOLS>]
  5386.                      SAVE_ICONS_POSITION=NO
  5387.  
  5388.             /* The user is provided with a user folder.                  */
  5389.  
  5390.                    [_SE_PERSONAL_FOLDER_]
  5391.                      CREATE_FOLDER=YES
  5392.  
  5393.      Compiling the text personalization profile 
  5394.  
  5395.       To compile a text personalization profile and obtain a binary 
  5396.       personalization profile, drop the text personalization profile object 
  5397.       into the Text-to-binary translator object. 
  5398.  
  5399.       The tool creates a binary personalization profile with the text 
  5400.       personalization profile configuration data. The binary personalization 
  5401.       profile has the same filename as the text personalization profile and the 
  5402.       PER extension. 
  5403.  
  5404.  
  5405. ΓòÉΓòÉΓòÉ 7.1.7. Desktop profile activation API ΓòÉΓòÉΓòÉ
  5406.  
  5407. Description 
  5408.  
  5409. The Desktop restrictions workbench API consists of: 
  5410.  
  5411.      A dynamic link library called EDYSHELL.DLL. Programs that issue requests 
  5412.       to the Desktop restrictions API function must be dynamically linked to 
  5413.       this library. 
  5414.  
  5415.      A link time library called EDYSHELL.LIB. Programs that issue requests to 
  5416.       the Desktop restrictions API function at link time must be linked to this 
  5417.       library. 
  5418.  
  5419.      An include file called EDYSHELL.H. Programs that use the Desktop 
  5420.       restrictions API must include this file. This file declares information 
  5421.       required to use the Desktop restrictions API function. 
  5422.  
  5423.  The API provides only the edy_refresh_profile function, intended to activate 
  5424.  desktop profiles. 
  5425.  
  5426.  When your program issues this function, the objects in the Workplace Shell and 
  5427.  the object properties are refreshed according to the information in the 
  5428.  desktop profile that is activated. 
  5429.  
  5430.  edy_refresh_profile syntax 
  5431.  
  5432.  The following statement shows how to include this function into your programs: 
  5433.  
  5434.  
  5435.     LONG APIENTRY edy_refresh_profile (CHAR *profilename)
  5436.  
  5437.  Where profilename is the full path of the file that contains the desktop 
  5438.  profile to be activated. A NULL value is resolved to 
  5439.  SecureEntryPath\WORK\EDYDESK.INI or, if this file does not exist, it is 
  5440.  resolved to SecureEntryPath\NOUSER\EDYDESK.INI 
  5441.  
  5442.  edy_refresh_profile return codes 
  5443.  
  5444.  The following diagram show the codes that can be returned by this function: 
  5445.  
  5446.  
  5447.         Code         Meaning
  5448.         =====        =======
  5449.  
  5450.         0001x        Successful operation
  5451.         0000x        Error refreshing Workplace Shell
  5452.         FFFFx        Error catching Workplace Shell return code
  5453.         Other        OS/2 error
  5454.  
  5455.  
  5456. ΓòÉΓòÉΓòÉ 7.1.8. Commands syntax ΓòÉΓòÉΓòÉ
  5457.  
  5458. This section describes the commands to be entered at the OS/2 prompt and start 
  5459. the tools provided by the Desktop restrictions component. 
  5460.  
  5461. Desktop activation command 
  5462.  
  5463. The EDYREFR tool is provided to activate desktop profiles from the command 
  5464. line. To start the tool, enter: 
  5465.  
  5466.  
  5467.      EDYREFR [fullpath]
  5468.  
  5469.  fullpath  Full path of the file that contains the desktop profile to be 
  5470.            activated. 
  5471.  
  5472.            The default is SecureEntryPath\WORK\EDYDESK.INI or, if this file 
  5473.            does not exist, SecureEntryPath\NOUSER\EDYDESK.INI. 
  5474.  
  5475.  Text-to-binary translator command 
  5476.  
  5477.  To start the text-to-binary translator tool, enter: 
  5478.  
  5479.  
  5480.        EDYT2B text-filename binary-filename
  5481.  
  5482.  text-filename Name of the file corresponding to the text desktop profile. This 
  5483.            is the input file. 
  5484.  
  5485.  binary-filename Name of the file corresponding to the binary desktop profile. 
  5486.            This is the output file. 
  5487.  
  5488.  Binary-to-text translator command 
  5489.  
  5490.  To start the binary-to-text translator tool, enter: 
  5491.  
  5492.  
  5493.        EDYB2T binary-filename text-filename
  5494.  
  5495.  binary-filename Name of the file corresponding to the binary desktop profile. 
  5496.            This is the input file. 
  5497.  
  5498.  text-filename Name of the file corresponding to the text desktop profile. This 
  5499.            is the output file. 
  5500.  
  5501.  Desktop profile capturer command 
  5502.  
  5503.  To start the desktop profile capturer tool, enter: 
  5504.  
  5505.  
  5506.        EDYSAVEE  [filename] [/ID:(YES|NO)]
  5507.  
  5508.  filename  Name of the file corresponding to the text desktop profile. The 
  5509.            default is EDYDESK.TXT. 
  5510.  
  5511.  ID        Specifies whether objects are to be identified by the object 
  5512.            identifier (YES value) or by the object title (NO value). The 
  5513.            default is NO. 
  5514.  
  5515.  Desktop profile tester command 
  5516.  
  5517.  To start the desktop profile tester tool, enter: 
  5518.  
  5519.  
  5520.        EDYTEST [filename]
  5521.  
  5522.  filename.ext Name of the file corresponding to the binary desktop profile. 
  5523.  
  5524.            The default is SecureEntryPath\WORK\EDYDESK.INI or, if this file 
  5525.            does not exist, SecureEntryPath\NOUSER\EDYDESK.INI. 
  5526.  
  5527.  Note that this utility is maintained only for SecureEntry previous version 
  5528.  compatibility reasons, so we suggest you to use the EDYREFR utility instead. 
  5529.  
  5530.  
  5531. ΓòÉΓòÉΓòÉ 7.2. The Personal desktop component ΓòÉΓòÉΓòÉ
  5532.  
  5533. SecureEntry enables the system administrator to permanently associate a given 
  5534. folder's settings, that is, the settings specified during a SecureEntry 
  5535. session, to the end user. To enable a folder to keep the new settings, when the 
  5536. user closes the folder or performs logoff, the system administrator should 
  5537. define it as memory folder. 
  5538.  
  5539. In addition, SecureEntry enables the system administrator to provide 
  5540. SecureEntry users with user folders, where the end user can create or delete 
  5541. object shadows through the Create shadow option or Delete option, respectively, 
  5542. in the object pop-up menu. 
  5543.  
  5544. You use the Personal desktop component to define personal desktop profiles, 
  5545. which specify both, memory and user folders. user folders will from now on be 
  5546. called dynamic folders, since they are effectively created and destroyed for 
  5547. the user at logon/logoff times. This personal desktop profiles, once created, 
  5548. are assigned to SecureEntry users by means of the SecureEntry administration 
  5549. tools. 
  5550.  
  5551. In order to work with this component, please open the Personal Desktop 
  5552. workbench folder located in the SecureEntry workbench folder. 
  5553.  
  5554. Use the objects in the Personal Desktop workbench to 
  5555.  
  5556.      Define Dynamic Folders 
  5557.  
  5558.      Edit Personalization Profiles and Models 
  5559.  
  5560.      Edit Memory folders 
  5561.  
  5562.      Edit Lists of Shadows through the list of shadows editor 
  5563.  
  5564.  
  5565. ΓòÉΓòÉΓòÉ 7.2.1. Dynamic folders ΓòÉΓòÉΓòÉ
  5566.  
  5567. Dynamic folders (also called user folders) are special folders that 
  5568.  
  5569.      can only contain shadows. Shadows can be added by drag and drop 
  5570.       operations. 
  5571.  
  5572.      store the list of contained shadows in a file that can be used in 
  5573.       different workstations. 
  5574.  
  5575.      are created on logon and deleted on logoff. 
  5576.  
  5577.      can be defined as startup folders, having their contents opened on logon. 
  5578.  
  5579.  The list of contained shadows can be kept in the user's personalization 
  5580.  profiles or in an external file. When the list is kept in the user's 
  5581.  personalization profile, the contents of the folder are defined by the user, 
  5582.  and the user will have access to his own personal folder no matter the 
  5583.  workstation where he is working. When the list is kept in an external file, 
  5584.  the administrator sets if the contents are to be defined by him or by the 
  5585.  users. 
  5586.  
  5587.  Dynamic folders are suitable for 
  5588.  
  5589.      allowing users to have a personal folder, where they add the objects they 
  5590.       choose. 
  5591.  
  5592.      allowing users to have a personal startup folder, where they add the 
  5593.       objects that they want to be opened on logon. 
  5594.  
  5595.      having startup folders defined by the administrator. 
  5596.  
  5597.      having workstation dependant folders, where the administrator defines 
  5598.       contents that match different workstation configurations. 
  5599.  
  5600.      having folders with their contents defined by a set of users in the LAN. 
  5601.  
  5602.  Since dynamic folders create shadows of objects, the objects that have to be 
  5603.  shadowed must be available in the workstation where the folders are created. 
  5604.  
  5605.  A dynamic folder is assigned to a personalization profile or model by dropping 
  5606.  a dynamic folder model on the personalization editor's lower container. 
  5607.  
  5608.  
  5609. ΓòÉΓòÉΓòÉ 7.2.2. Personalization profiles and models ΓòÉΓòÉΓòÉ
  5610.  
  5611. The personalization profiles specify 
  5612.  
  5613.      the dynamic folders that will be created on logon 
  5614.  
  5615.      the folders that will act as memory folders on logon. 
  5616.  
  5617.  The personalization profiles (created through the object model Edy_Per.ini) 
  5618.  may contain information unique to the user, and they are stored by SecureEntry 
  5619.  when the user logs off. Administrators can only define personalization 
  5620.  profiles on a user basis, not on a group basis or in the NOUSER folder. If 
  5621.  this is done, the profile will be taken as a model for all users as they log 
  5622.  on in order to create their specific personalization profile. 
  5623.  
  5624.  The personalization models (created through the object model Edy_MPer.ini) 
  5625.  have the same format as the personalization profiles, but do not contain any 
  5626.  user dependant information. They can be used by administrators to dynamically 
  5627.  create or update personalization profiles. Personalization models can be 
  5628.  defined on a group basis. 
  5629.  
  5630.  A default personalization model can be placed in the NOUSER folder. The name 
  5631.  of the default personalization mode has to be EDYMPER.INI. 
  5632.  
  5633.  When a personalization model is available, either because it has been assigned 
  5634.  to the user or to the user's group, or because it is placed in the NOUSER 
  5635.  folder, the user's personalization file is updated with the definitions of the 
  5636.  personalization model: 
  5637.  
  5638.      if the user does not have a personalization profile, a personalization 
  5639.       profile will be created with the definitions of the personalization 
  5640.       model. The new personalization profile will be assigned to the user on 
  5641.       logoff. 
  5642.  
  5643.      any memory or dynamic folders defined by the profile that are not defined 
  5644.       by the model will be deleted from the profile. 
  5645.  
  5646.      any memory or dynamic folders defined by the model that are not defined 
  5647.       by the profile will be added to the profile. 
  5648.  
  5649.      any dynamic folders defined by the model that are also defined by the 
  5650.       profile will have their settings updated with the information in the 
  5651.       model, but will keep the contents stored in the profile. 
  5652.  
  5653.  
  5654. ΓòÉΓòÉΓòÉ 7.2.3. Memory folders ΓòÉΓòÉΓòÉ
  5655.  
  5656. When a folder is defined to act as a memory folder in the user's 
  5657. personalization profile, any changes that the user performs on the folder's 
  5658. layout is stored in the personalization profile, and applied to the folder 
  5659. whenever the user logs on to the same or another workstation. The layout 
  5660. information that is stored and applied includes 
  5661.  
  5662.      window position. 
  5663.  
  5664.      contents positions. 
  5665.  
  5666.      view attributes (container attributes and fonts). 
  5667.  
  5668.  Folders can only be defined to act as memory folders when the have an object 
  5669.  ID defined. 
  5670.  
  5671.  
  5672. ΓòÉΓòÉΓòÉ 7.2.4. Lists of shadows ΓòÉΓòÉΓòÉ
  5673.  
  5674. List of shadows files are used to store the contents of dynamic folders, and to 
  5675. define the startup process (EdyStart object within the NOUSER folder). 
  5676.  
  5677. List of shadows files can also be used when editing dynamic folder models. 
  5678.  
  5679. List of shadow files can be viewed and edited with the List of shadows editor 
  5680. or from the Contents page of dynamic folder models. 
  5681.  
  5682. Shadows can be added to the list by dropping them on the container, and deleted 
  5683. by using their popup menu. 
  5684.  
  5685.  
  5686. ΓòÉΓòÉΓòÉ 7.3. The Hooked objects component ΓòÉΓòÉΓòÉ
  5687.  
  5688. The hooked objects component allows you to create a security profile where you 
  5689. specify which of the desktop's objects to establish a hook over. This means, 
  5690. basically, that you can get an external program called whenever a given object 
  5691. is opened or closed. This external program, in the case of object open event, 
  5692. can optionally decide whether to honor or not honor the open request, thus 
  5693. making it extremely easy to configure a protection scheme based on one time 
  5694. passwords request for program or folder objects. The only requirement that 
  5695. hooked objects must have is that they have to be objects with an assigned 
  5696. objectID. 
  5697.  
  5698. Within this component's workbench, SecureEntry provides a sample hook program 
  5699. that implements a reasonably safe one time password algorithm, that depends on 
  5700. the institution name and the date/time, so that just by drag and drop you can 
  5701. configure an object to be opened only if that password is given. The password 
  5702. itself can be retrieved by running the one time password generator by a 
  5703. SecureEntry administrator which is running SecureEntry in another machine of 
  5704. the same institution. 
  5705.  
  5706. In order to establish hooks for a given component, you should create a profile 
  5707. of this component's type, by dragging one instance from the supplied template 
  5708. object. Then edit it by dropping the profile object into the editor. Refer to 
  5709. the help information of the editor program in order to configure a given hook. 
  5710.  
  5711. As usual, and after you have established the desired hooks, you can assign the 
  5712. profile to users, groups, or as machine default by putting it in the NOUSER 
  5713. directory within the SecureEntry path. 
  5714.  
  5715.      The one time password utilities 
  5716.  
  5717.      One Time Password Generation 
  5718.  
  5719.      One Time Password Verification 
  5720.  
  5721.      Default OTP generation/verification 
  5722.  
  5723.  
  5724. ΓòÉΓòÉΓòÉ 7.3.1. The one time password utilities ΓòÉΓòÉΓòÉ
  5725.  
  5726. This utility allows you to work with one time passwords bound to particular 
  5727. <date,time> pairs. 
  5728.  
  5729. The generation utility, edyotpg.exe, located in the <sgm_shell>\exec directory, 
  5730. takes as input a <date,time> pair and outputs the password bound to that 
  5731. <date,time> pair. 
  5732.  
  5733. The verification utility, edyotpv.exe, located in the <sgm_shell>\exec 
  5734. directory, takes as input a password and checks it against the current 
  5735. <date,time> pair. If successful it returns zero, otherwise it returns 1. 
  5736.  
  5737. You can supply to both utilities your own generation/verification routines or 
  5738. work with the default ones incorporated in them. 
  5739.  
  5740. One time passwords are useful to allow access to restricted resources under 
  5741. administration supervision: when the user attempts to access the resource 
  5742. edyotpv.exe is executed, the user then must contact an administrator to get the 
  5743. one time password bound to the <date,time> pair edyotpv.exe is asking for, the 
  5744. administrator then runs the edyotpg.exe utility with the <date,time> pair the 
  5745. user has told him and gets the one time password that the user needs, finally 
  5746. he tells it to the user in some secure way. Of course, all this works out only 
  5747. if users cannot modify the system's date and time. 
  5748.  
  5749.  
  5750. ΓòÉΓòÉΓòÉ 7.3.2. One Time Password Generation ΓòÉΓòÉΓòÉ
  5751.  
  5752. This program is designed to take as input a date (dd/mm/yyyy) and a time 
  5753. (hh:mm:ss) and generate as output a password that should be valid only for this 
  5754. particular date and time ,or seed string. 
  5755.  
  5756.  
  5757.         edyotpg [/G<pathname>] [/K] [/R(S|D|M|H)] [/M]
  5758.  
  5759.  <pathname> Is the pathname of your OTP optional generation routine. 
  5760.  
  5761.  /K        Use this parameter to work with reference seed strings instead of 
  5762.            date/time pairs. 
  5763.  
  5764.  /R        Set resolution to (S)econds, (D)ays, (M)inutes, or (H)ours 
  5765.  
  5766.  /M        Force dialog sysmodality 
  5767.  
  5768.  Your own one time password generation routine must follow some guidelines to 
  5769.  properly interface to edyotpg.exe: 
  5770.  
  5771.       It must be an executable file. (.exe) 
  5772.  
  5773.       The first two command line arguments must be two strings, the first one 
  5774.       being the date with the dd/mm/yyyy format and the second one the time 
  5775.       with the hh:mm:ss format. In the case that reference seeds are used, then 
  5776.       only one parameter, containing the seed (6 characters), will be passed. 
  5777.  
  5778.       It must return 0 if the generation was successful and something different 
  5779.       from zero otherwise. 
  5780.  
  5781.       The generated password must be written to standard output and must be the 
  5782.       first program's output to standard output. 
  5783.  
  5784.       All other messages, such as error messages, must be written to standard 
  5785.       output if you want edyotpg.exe to show them when things go wrong, that 
  5786.       is, when your routine returns something different from zero. 
  5787.  
  5788.  
  5789. ΓòÉΓòÉΓòÉ 7.3.3. One Time Password Verification ΓòÉΓòÉΓòÉ
  5790.  
  5791. This program is designed to check the password entered by the user against the 
  5792. current date and time, and, if successful, execute a program that was specified 
  5793. as a command line argument with the '/E' modifier. The other command line 
  5794. arguments are used to change the behavior of the program, as follows: 
  5795.  
  5796.  
  5797.    edyotpv [/E<pathname>] [/ID<string>] [/Dn(S|D|M|H)] [/K] [/R(S|D|M|H)] [/M]
  5798.  
  5799.  <pathname> is the program's pathname you want to execute on success. 
  5800.  
  5801.  /ID<string> Replace string with an instance identifier, in the case you have 
  5802.            more than one resource protected through this program in a given 
  5803.            machine. 
  5804.  
  5805.  /DnX      Password valid duration time. If this parameter is specified, once a 
  5806.            valid password has been entered, this password will be considered 
  5807.            valid for the same ID instance during the given timeframe. i.e, /D3H 
  5808.            means 'keep passwords valid during 3 hours'. 
  5809.  
  5810.  /K        Use this parameter to work with reference seed strings instead of 
  5811.            date/time pairs. 
  5812.  
  5813.  /R        Set resolution to (S)econds, (D)ays, (M)inutes, or (H)ours 
  5814.  
  5815.  /M        Force dialog sysmodality. Use this option if you want to ask for a 
  5816.            OTP password through a user exit during session flow 
  5817.            (logon/logoff/unlock). 
  5818.  
  5819.  Note: if no command line (/E) argument is specified then no program is 
  5820.  executed. 
  5821.  
  5822.  If the password is validated edyotpv.exe returns a 0, otherwise returns a 1 
  5823.  
  5824.  You can supply your own verification routine by naming it edyotpv.exe and 
  5825.  locating it in the <sgm_shell>\nouser directory, edyotpv.exe looks for this 
  5826.  file and if it exists then uses it to validate the password. 
  5827.  
  5828.  Your validation routine must follow some guidelines to properly interface with 
  5829.  edyotpv.exe: 
  5830.  
  5831.      It must be named edyotpv.exe or edyotpv.cmd and be located in the 
  5832.       <sgm_shell>\nouser directory. 
  5833.  
  5834.      The first three command line arguments must be two strings, the first one 
  5835.       being the date with the dd/mm/yyyy format, the second one the time with 
  5836.       the hh:mm:ss format, and the third one the password in uppercase, to be 
  5837.       validated. In the case that reference seeds are used, then instead of the 
  5838.       three parameters, only two will be passed (seed (6 characters) and 
  5839.       password to validate). 
  5840.  
  5841.      It must return 0 if password was validated and something different from 
  5842.       zero otherwise. 
  5843.  
  5844.      All error messages must be written to standard output if you want 
  5845.       edyotpv.exe to show them whenever the password entered by the user is not 
  5846.       valid. (if it is valid, edyotpv.exe will not show anything) 
  5847.  
  5848.  
  5849. ΓòÉΓòÉΓòÉ 7.3.4. Default OTP generation/verification ΓòÉΓòÉΓòÉ
  5850.  
  5851. The default OTP generation/verification routines work with six character long 
  5852. passwords over the alphabet ( {'A'..'Z'} - {'P','T','V','N'} ) U {'0'..'9'}. 
  5853. The characters 'P','T','V','N' are excluded for phonetical reasons and the 
  5854. default validation routine treats the characters 'V' and 'P' as the character 
  5855. 'B',  the character 'T' as the character 'D', and the character 'N' as the 
  5856. character 'M'. This is to prevent possible phonetical misunderstanding in the 
  5857. oral communication of one time passwords between the administrator and the 
  5858. final user. 
  5859.  
  5860.  
  5861. ΓòÉΓòÉΓòÉ 7.4. The Launchpad component ΓòÉΓòÉΓòÉ
  5862.  
  5863. The launchpad component allows you to create launchpad security profiles which 
  5864. contain the necessary information to recreate a given launchpad with some 
  5865. special features once the component is activated with a given profile. This is 
  5866. very useful in order to create custom launchpads for your users depending on 
  5867. their needs or requirements. 
  5868.  
  5869.  
  5870.  
  5871. In order to work with this component, please open the Launchpad Workbench 
  5872. folder located in the SecureEntry Workbench folder. 
  5873.  
  5874. In order to create a security profile for this component, drag one from the 
  5875. component profile template object (named EDYPAD.INI). 
  5876.  
  5877. To modify a profile of this type, you can drop it into the 'Launchpad 
  5878. Restrictions Editor' program object, and immediately a launchpad will appear in 
  5879. editing mode. You can distinguish this one from your regular launchpad by the 
  5880. fact that the one being edited has, in its popup menu, the entries 'Save' and 
  5881. 'Close', and a different background color (white). Edit the launchpad as you 
  5882. would do normally (drag and drop), and after that select the 'Save' and/or 
  5883. 'Close' as necessary. Note that you have some settings available for this 
  5884. object which are specific SecureEntry features : 
  5885.  
  5886.      Whether to allow moving of the launchpad. 
  5887.  
  5888.      Initial position of the launchpad. 
  5889.  
  5890.      Whether to deactivate some or all of the action buttons. 
  5891.  
  5892.  In order to test a given Launchpad profile, just drop it into the 'SELP 
  5893.  profile tester' program object. 
  5894.  
  5895.  Once the launchpad is customized, drop its profile into the appropriate place 
  5896.  (NOUSER folder or administration tool) to assign it to a given user, group or 
  5897.  machine configuration. 
  5898.  
  5899.  
  5900. ΓòÉΓòÉΓòÉ 7.5. The WarpCenter component ΓòÉΓòÉΓòÉ
  5901.  
  5902. The WarpCenter component allows you to create WarpCenter security profiles 
  5903. which contain the necessary information to customize the WarpCenter with some 
  5904. special features once the component is activated with a given profile. This is 
  5905. very useful in order to create customized WarpCenters for your users depending 
  5906. on their needs or requirements. 
  5907.  
  5908.  
  5909.  
  5910. In order to work with this component, please open the WarpCenter Workbench 
  5911. folder located in the SecureEntry Workbench folder. 
  5912.  
  5913. In order to create a security profile for this component, drag one from the 
  5914. component profile template object (named EDYSC.INI). 
  5915.  
  5916. To modify a profile of this type, you can drop it into the 'WarpCenter 
  5917. Restrictions Editor' program object, and immediately a WarpCenter will appear 
  5918. in edition mode. You can distinguish this one from your regular WarpCenter by 
  5919. the fact that the one being edited is enclosed in a white border and its popup 
  5920. menu has specific customization entries. 
  5921.  
  5922. Edit the WarpCenter as you would do normally (properties,drag and drop, ...), 
  5923. and after that select the 'Save' or 'Close' as necessary. Note that you have 
  5924. some settings available for this object which are specific SecureEntry 
  5925. features: 
  5926.  
  5927.      Whether to use the OS2 standard window list or the WarpCenter's window 
  5928.       list. 
  5929.  
  5930.      Enable/Disable the WarpCenter's FIND button and the popup menu's FIND 
  5931.       entry of the objects contained in the WarpCenter. 
  5932.  
  5933.      Enable/Disable the popup menu's ORIGINAL entry of the objects contained 
  5934.       in the WarpCenter. 
  5935.  
  5936.      Enable/Disable the popup menu's DELETE entry of the objects contained in 
  5937.       the WarpCenter. 
  5938.  
  5939.      Whether to allow for the shutdown icon in the warpcenter to have its 
  5940.       functionality changed to logoff. 
  5941.  
  5942.  Note also that the original WarpCenter's lockup and shutdown procedures have 
  5943.  been substituted by the SENTRY's lockup and shutdown procedures. 
  5944.  
  5945.  In order to test a given WarpCenter profile, just drop it into the 'WarpCenter 
  5946.  profile tester' program object, a green border will enclose the WarpCenter 
  5947.  while the profile is activating and will disappear as soon as activation ends. 
  5948.  
  5949.  Once the WarpCenter is customized, drop its profile into the appropriate place 
  5950.  (NOUSER folder or administration tool) to assign it to a given user, group or 
  5951.  machine configuration. 
  5952.  
  5953.      New Setup Strings 
  5954.  
  5955.      WarpCenter Environment Variables 
  5956.  
  5957.  
  5958. ΓòÉΓòÉΓòÉ 7.5.1. New Setup Strings ΓòÉΓòÉΓòÉ
  5959.  
  5960. These are the new setup strings defined for the SmartCenter class. They will 
  5961. only work on a SmartCenter class instance which has <WP_WARPCENTER> as its 
  5962. object ID. 
  5963.  
  5964.  EDYSCOPEN=YES 
  5965.        Opens the WarpCenter's default view (same as double-click). 
  5966.  
  5967.  EDYSCCLOSE=YES 
  5968.        Closes the WarpCenter's default view. 
  5969.  
  5970.  EDYSCDELETETRAY=tray number 
  5971.        Deletes the specified tray. 
  5972.  
  5973.  EDYSCTRAYNAME=tray name 
  5974.        Renames the current tray. 
  5975.  
  5976.  EDYSCCONFIRMSHUTDOWN={YES|NO} 
  5977.        Enable/disable shutdown confirmation. 
  5978.  
  5979.  EDYSCLARGEICONS={YES|NO} 
  5980.        Use large or small icons. 
  5981.  
  5982.  EDYSCDISPLAYALWAYS={YES|NO} 
  5983.        Display the WarpCenter only when mouse is over it or always. 
  5984.  
  5985.  EDYSCFLOATONTOP={YES|NO} 
  5986.        Makes WarpCenter to float (or not) on top of maximized windows. 
  5987.  
  5988.  EDYSCTOPPOSITION={YES|NO} 
  5989.        Display the WarpCenter at the top or bottom of the screen. 
  5990.  
  5991.  EDYSCBUBBLEHELP={YES|NO} 
  5992.        Enable/disable the WarpCenter's bubble help. 
  5993.  
  5994.  ADDTRAY=tray name [,object ID,...] 
  5995.        Adds a new tray with the specified name containing the specified 
  5996.        objects. 
  5997.  
  5998.  
  5999. ΓòÉΓòÉΓòÉ 7.5.2. Environment Variables ΓòÉΓòÉΓòÉ
  6000.  
  6001. These are environment variables which can be defined in your CONFIG.SYS file to 
  6002. modify some of the WarpCenter's properties: 
  6003.  
  6004.  SCKillFeatureEnabled=YES 
  6005.        Allows to kill processes from the WarpCenter's window list when 
  6006.        selecting it while pressing the Ctrl key. This variable works only if 
  6007.        the WarpCenter is customized to use its original window list procedure. 
  6008.  
  6009.  SCFindUtility=executable pathname 
  6010.        The specified executable is started whenever the WarpCenter's FIND 
  6011.        button is selected. This variable works only if the WarpCenter is 
  6012.        customized with its FIND button enabled. 
  6013.  
  6014.  SCUsePrettyClock=YES 
  6015.        The WarpCenter's displays a more "pretty" clock than the default one. 
  6016.  
  6017.  SCCanbeNuked=1 
  6018.        Allows to delete SmartCenter class instances. This variable works only 
  6019.        if SGM_EDYSC_DISABLE is defined. 
  6020.  
  6021.  SGM_EDYSC_DISABLE=YES 
  6022.        Disables all the WarpCenter's SENTRY features leaving it as originally 
  6023.        defined. 
  6024.  
  6025.  
  6026. ΓòÉΓòÉΓòÉ 7.6. The shortcuts component ΓòÉΓòÉΓòÉ
  6027.  
  6028. The shortcuts component allows you to define keyboard and mouse combinations 
  6029. which, when activated, are able to open a given object. 
  6030.  
  6031. In order to create a shortcuts profile, obtain one from the template object 
  6032. located within the shortcuts workbench, and drop it into the editor, then 
  6033. follow the editor's help for further advice. 
  6034.  
  6035. Once the profile has been created, you can assign it to a given user or group 
  6036. by following the standard SecureEntry administration procedures. 
  6037.  
  6038. Special care has to be taken as to not define keyboard combinations which are 
  6039. already used by the system for other purposes. 
  6040.  
  6041.  
  6042. ΓòÉΓòÉΓòÉ 7.7. Public Applications Component ΓòÉΓòÉΓòÉ
  6043.  
  6044. The public applications component allows for handling, in LAN Server 
  6045. environments, the definition of its public applications. Furthermore, you can 
  6046. use this component to define a SecureEntry profile containing the LAN Server 
  6047. domain public applications that must be shown in a user's Network Applications 
  6048. folder as soon as she/he logs on the system. 
  6049.  
  6050. In order to work with this component, open the Public Applications Workbench, 
  6051. located inside the SecureEntry Workbench. 
  6052.  
  6053. You can create a profile for this component by dragging a copy from its 
  6054. component profile template (EDYROAM.INI) and dropping it. 
  6055.  
  6056. In order to modify a public applications profile, drag and drop it into the 
  6057. Public Applications Editor, or just double click it. Make the necessary changes 
  6058. and then save the modified profile. Follow the editor's help for further 
  6059. advice. 
  6060.  
  6061. The editor may be also useful to configure, not only the set of public 
  6062. applications that must appear in the user's Network Applications folder at 
  6063. logon time, but the public applications defined on the domain controller of the 
  6064. LAN Server domain where you are logged on. 
  6065.  
  6066. You must beware of the following points: 
  6067.  
  6068.      The editor of this component obtains the name of the domain controller 
  6069.       the administrator user is logged on. This means that if the user has done 
  6070.       a SecureEntry logon from the domain controller to another domain, and 
  6071.       then he manually logs off, then he will be able to continue administering 
  6072.       the public applications of the domain controller he physically is at. 
  6073.  
  6074.      The editor of this component handles two lists of applications: the list 
  6075.       on the left side contains the definitions of the public applications to 
  6076.       assign to a SecureEntry profile and it uses the definitions of the 
  6077.       existing resources in the repository SecureEntry. The list on the right 
  6078.       side contains the definitions of the public applications that must reside 
  6079.       in the domain controller. This means, in corporate environments using 
  6080.       UCM, that the resources, i.e., the alias, available may differ in both 
  6081.       lists. 
  6082.  
  6083.      The OS/2 public applications edition notepad contains the tab Parameters. 
  6084.       You can provide information in this tab, no matter the environment you 
  6085.       are working in. However, the data you enter will be effective only if you 
  6086.       are administering public applications for WorkSpace On-Demand 
  6087.       environments. Refer to WorkSpace On-Demand considerations for more 
  6088.       information. 
  6089.  
  6090.  In order to verify the profile behavior, drag and drop it on the object Test 
  6091.  Public Applications, or select the option test through the editor menu bar. 
  6092.  The defined profile will be activated, and the Network Applications folder 
  6093.  will be rebuilt. If the test is done from the editor, then the contents of the 
  6094.  list of public applications defined on the domain controller will be 
  6095.  refreshed. Otherwise you will have to select the Refresh option from the 
  6096.  pull-down menu related to the option Domain of the menu bar of the editor. 
  6097.  
  6098.  Once configured, associate the profile to the desired user or group, by 
  6099.  dragging and dropping it into the adequate container of the users and groups 
  6100.  administration tool, or establish it as the default for the system, copying it 
  6101.  with its default name (EDYROAM.INI) to the NOUSER folder. 
  6102.  
  6103.  When a user logs on the system, its related profile will be activated, yet his 
  6104.  or his SecureEntry group's if his does not exist. If the user does not have 
  6105.  any defined public applications profile, then the profile residing in the 
  6106.  NOUSER folder will be activated. If the NOUSER folder does not contain any 
  6107.  public applications profile, then the set of public applications the user 
  6108.  currently has will be preserved. 
  6109.  
  6110.  Take into account that a GUEST SecureEntry logon does not imply the activation 
  6111.  of the EDYROAM.INI profile residing in the folder NOUSER, if it exists. 
  6112.  
  6113.      Description of the modules and the API 
  6114.  
  6115.      The Log File 
  6116.  
  6117.      WorkSpace On-Demand considerations 
  6118.  
  6119.      WorkSpace On-Demand specific parameters for public applications 
  6120.  
  6121.      Public Applications object IDs 
  6122.  
  6123.  
  6124. ΓòÉΓòÉΓòÉ 7.7.1. Description of the modules and the API ΓòÉΓòÉΓòÉ
  6125.  
  6126. The names of this component include de word ROAM, since the set of definitions 
  6127. of public applications assigned to a user or group of users travel to the 
  6128. workstation the user uses to log on. This is especially important in corporate 
  6129. environments, where the users administration is centralized through UCM. 
  6130.  
  6131. What follows is the description of the modules integrated in this component: 
  6132.  
  6133.      EDYROAME 
  6134.  
  6135.       This is the program editor of profiles. It accepts the following syntax: 
  6136.  
  6137.  
  6138.                  EDYROAME.EXE [Profile]
  6139.  
  6140.       Where Profile is the path and file name of the desired profile. The 
  6141.       editor allows for testing a profile directly. 
  6142.  
  6143.      EDYROAMT 
  6144.  
  6145.       This is the program activator of profiles. It accepts the following 
  6146.       syntax: 
  6147.  
  6148.  
  6149.                  EDYROAMT.EXE /F[Profile] [/T]
  6150.  
  6151.         -  /FProfile activates the roaming desktop defined in Profile. If 
  6152.            Profile does not exist, the set of user's current public 
  6153.            applications will be preserved. 
  6154.  
  6155.         -  /F activates the roaming desktop EDYROAM.INI defined in the NOUSER. 
  6156.            If the profile does not exist, the set of user's current public 
  6157.            applications will be preserved. 
  6158.  
  6159.         -  /T indicates that the roaming desktop must be activated in test 
  6160.            mode. This parameter restores back to the user the set of public 
  6161.            applications she/he had before the test. 
  6162.  
  6163.      Public applications component interface 
  6164.  
  6165.       The component exports the following routine, defined in EDYROAM.H. The 
  6166.       routine executes correctly if it returns zero; otherwise it returns the 
  6167.       gotten error: 
  6168.  
  6169.  
  6170.               APIRET _System SetRoamingDesktop(PSZ pszFileName, BOOL Testing);
  6171.  
  6172.            Activates the user Roaming desktop defined in pszFileName. If 
  6173.            pszFileName contents is empty, then any defined Public Application 
  6174.            assigned to current user is deleted. 
  6175.  
  6176.            If pszFileName points to "", then NOUSER ini file will be handled. 
  6177.  
  6178.            If the file does not exist, then current user Public Applications 
  6179.            will be preserved. 
  6180.  
  6181.            The parameter Testing must state whether or not doing a real logon 
  6182.            (FALSE) or doing a profile test (TRUE). 
  6183.  
  6184.  
  6185. ΓòÉΓòÉΓòÉ 7.7.2. The Log File ΓòÉΓòÉΓòÉ
  6186.  
  6187. The log file takes the name EDYROAM.LOG and resides in the path specified by 
  6188. the environment variable SGM_ROAM_LOGPATH. This file contains the errors and 
  6189. warnings found by the component during its execution. 
  6190.  
  6191.  
  6192.    Date      Time     Program    Severity   Error           Explanation
  6193. ---------- -------- ------------ -------- ---------- --------------------------
  6194. 29/09/1998 16:03:01 EDYROAME.EXE ERROR    0X0000000D Could not determine logon domain.
  6195.                                                      Probably there's no user logged on.
  6196. 29/09/1998 16:04:23 EDYROAME.EXE WARNING  0X00000000 NetServerEnum2 returned 0 entries.
  6197.                                                      Retrying with NetGetDCName.
  6198. 29/09/1998 16:05:48 EDYROAME.EXE ERROR    0X00000015 DosQueryPathInfo: could not get
  6199.                                                      file information about "A:\NOALIAS.INI".
  6200. 29/09/1998 16:06:32 EDYROAME.EXE ERROR    0X00000ADF NetAliasGetInfo: the alias "ARBRE"
  6201.                                                      is not defined in the Domain Controller.
  6202.  
  6203. This sample shows that the public applications editor got three errors and one 
  6204. warning during its execution. 
  6205.  
  6206. The first error states that the domain against which the logon was done could 
  6207. not be determined and suggests that probably a non-SecureEntry manual logoff 
  6208. was done. The OS/2 error 0X0000000D was returned to the editor, meaning that 
  6209. Data is invalid. 
  6210.  
  6211. The only existing warning states that a LAN Server API returned and error and 
  6212. that an alternative API was used. Since it was a warning, no error was returned 
  6213. to the public applications editor. 
  6214.  
  6215. Remember that you can control the size of the SecureEntry log files, as well as 
  6216. any other ASCII file by using the EDYLOGFS utility. 
  6217.  
  6218.  
  6219. ΓòÉΓòÉΓòÉ 7.7.3. WorkSpace On-Demand considerations ΓòÉΓòÉΓòÉ
  6220.  
  6221. Like with any other SecureEntry component, you can administer the set of public 
  6222. applications to assign to a user or group from any workstation. However, if you 
  6223. are administering or testing public applications with parameters from a non 
  6224. WorkSpace On-Demand administrator workstation, then the update of the 
  6225. parameters of the public applications will not succeed in the WorkSpace 
  6226. On-Demand server if there's not an administrator user logged on in the 
  6227. mentioned server. 
  6228.  
  6229. The best suggestion is to administer from the WorkSpace On-Demand 
  6230. Administration Client, or from the WorkSpace On-Demand Server -if the LAN 
  6231. Server administration tools were installed there-, if you must administer 
  6232. public applications with parameters. 
  6233.  
  6234. If a user, yet administrator or not, having assigned a set of public 
  6235. applications with parameters logs on in a non WorkSpace On-Demand workstation, 
  6236. the possible update of the public applications parameters will neither succeed 
  6237. in the WorkSpace On-Demand server if there's not an administrator user logged 
  6238. on in the mentioned server. 
  6239.  
  6240. Notice that, in this case, the folder of public applications assigned to the 
  6241. user will remain containing the assigned applications, since the parameters of 
  6242. the public applications are meaningless in these workstations. 
  6243.  
  6244.  
  6245. ΓòÉΓòÉΓòÉ 7.7.4. WorkSpace On-Demand specific parameters for public applications ΓòÉΓòÉΓòÉ
  6246.  
  6247. What follows is the list of WorkSpace On-Demand specific parameters that may be 
  6248. helpful when configuring public applications: 
  6249.  
  6250.      WSOD_LAUNCH_MINIMIZED. Assign the value 1 to this environment variable to 
  6251.       make the application to start minimized. 
  6252.  
  6253.      WSOD_LAUNCH_NOCLOSE. Assign the value 1 to this environment variable to 
  6254.       make the DOS or OS/2 VIO window to not close when the application ends. 
  6255.       This may be useful when having to determine the cause of a problem with 
  6256.       the application definition. 
  6257.  
  6258.      WSOD_LAUNCH_SESSION. This parameter gives the administrator full control 
  6259.       over the type of session in which WorkSpace On-Demand will launch the 
  6260.       application. The application may not work at all if you choose the wrong 
  6261.       type of session. This parameter may take the following values: 
  6262.  
  6263.         -  1. Full-screen OS/2 
  6264.  
  6265.         -  2. Windowed OS/2 
  6266.  
  6267.         -  3. OS/2 PM 
  6268.  
  6269.         -  4. Full-screen DOS 
  6270.  
  6271.         -  7. Windowed DOS 
  6272.  
  6273.         -  10. WinOS2 Real Mode 
  6274.  
  6275.         -  12. WinOS2 Auto 
  6276.  
  6277.         -  15. WinOS2 Standard, seamless, separate VDM 
  6278.  
  6279.         -  16. WinOS2 Standard, seamless, common VDM 
  6280.  
  6281.         -  17. WinOS2 Enhanced, seamless, separate VDM 
  6282.  
  6283.         -  18. WinOS2 Enhanced, seamless, common VDM 
  6284.  
  6285.         -  19. WinOS2 Enhanced, full-screen 
  6286.  
  6287.         -  20. WinOS2 Standard, full-screen 
  6288.  
  6289.      WSOD_LAUNCH_NODROP. Assign the value 1 to this environment variable to 
  6290.       signal the application launcher to leave the network resources attached. 
  6291.  
  6292.      NCC_SETUP_POST. This environment variable allows to provide setup strings 
  6293.       to the application. The parameter value can consist of any of the setup 
  6294.       strings specified below. Each setup string consists of a key name, 
  6295.       followed immediately by an equal ('=') sign and a value. Multiple setup 
  6296.       strings can be passed in the environment variable by separating each 
  6297.       setup string with a semicolon (';'). Some of the most useful setup 
  6298.       strings are: 
  6299.  
  6300.         -  CCVIEW. It can take the values DEFAULT, YES or NO. 
  6301.  
  6302.         -  ICONFILE. It must take the file name that sets the object's icon. 
  6303.  
  6304.         -  ICONPOS. It must take the percentage coordinates pair (x,y) where 
  6305.            the object must be placed in the desktop. 
  6306.  
  6307.         -  ICONRESOURCE. It must take the pair (id,module) that designates the 
  6308.            resource Id and the module name that contains the object's icon. 
  6309.  
  6310.       For example, to make the object to initially appear at ten percent from 
  6311.       the origin of the coordinates, assign the following value to the variable 
  6312.       NCC_SETUP_POST : 
  6313.  
  6314.                 ICONPOS=10,10;
  6315.  
  6316.  If you are configuring public applications to be executed on WorkSpace 
  6317.  On-Demand 2.0 requesters, then you can also use the following parameters: 
  6318.  
  6319.      NCC_PREFITS. Assign a FIT file name to this environment variable. The FIT 
  6320.       file entries contained within this file are preppended to the default 
  6321.       user FIT file entries for the logged on user. Use this file to force FIT 
  6322.       file entries to be found before similar entries in the default user FIT 
  6323.       file, or to introduce new FIT file entries. 
  6324.  
  6325.      NCC_POSTFITS. Assign a FIT file name to this environment variable. The 
  6326.       FIT file entries contained within this file are appended to the default 
  6327.       user FIT file entries for the logged on user. Use this file to force FIT 
  6328.       file entries to be after similar entries in the default user FIT file, or 
  6329.       to introduce new FIT file entries. 
  6330.  
  6331.      NCC_FOLDER. This environment variable allows to provide setup strings to 
  6332.       the application. Use this parameter to place a program object in a folder 
  6333.       on the Desktop. You can use any WPFolder and WPObject setup strings. For 
  6334.       example, to make the application to reside inside the Managers folder, 
  6335.       assign the following value to the variable NCC_FOLDER : 
  6336.  
  6337.                 NCC_FOLDER=TITLE=Managers;
  6338.  
  6339.       Since WorkSpace On-Demand 2.0 allows for multilevel folders, you can use 
  6340.       the NCC_CHILD_SETUP setup string, which is part of the NCC_FOLDER 
  6341.       parameter, to specify a child folder. For example, if NCC_FOLDER 
  6342.       contained the following setup string: 
  6343.  
  6344.                 NCC_FOLDER=TITLE=Secretaries;NCC_CHILD_SETUP=BOOKKEEP;
  6345.  
  6346.       and another parameter BOOKKEEP also existed and contained the following 
  6347.       value: 
  6348.  
  6349.                 BOOKKEEP=TITLE=BookKeeping;
  6350.  
  6351.       then a folder called Secretaries would be created on the Desktop, a 
  6352.       folder called BookKeeping would be created in the Secretaries folder, and 
  6353.       the program object for the application would be created in the 
  6354.       BookKeeping folder. 
  6355.  
  6356.  To get more information on WorkSpace On-Demand specific parameters for public 
  6357.  applications, refer to the publications WorkSpace On-Demand HandBook and 
  6358.  WorkSpace On-Demand Administrator's Guide. 
  6359.  
  6360.  To get more information on setup strings, refer to the publication Workplace 
  6361.  Shell Programming Reference. 
  6362.  
  6363.  
  6364. ΓòÉΓòÉΓòÉ 7.7.5. Public Applications object IDs ΓòÉΓòÉΓòÉ
  6365.  
  6366. In conventional LAN Server environments, public applications assigned to a user 
  6367. are located in the Network Applications folder. The object ID of this folder is 
  6368. <\NETAPPS\NETAPPFLDR>. Each program object inside this folder is created with 
  6369. the object ID <\ServerName\ApplicationId>, where ServerName is the the server 
  6370. name of the user logon domain, and ApplicationId is the name that the public 
  6371. application was created with. 
  6372.  
  6373. In WorkSpace On-Demand environments, each program object related to a public 
  6374. application appearing in the user's desktop has the object ID 
  6375. <NCID_ApplicationId>, where ApplicationId is the name that the public 
  6376. application was created with. 
  6377.  
  6378. Refer to About object IDs to get more information about object IDs. 
  6379.  
  6380.  
  6381. ΓòÉΓòÉΓòÉ 8. Administering users and groups ΓòÉΓòÉΓòÉ
  6382.  
  6383.      Interactive administration 
  6384.  
  6385.      Batch administration 
  6386.  
  6387.  
  6388. ΓòÉΓòÉΓòÉ 8.1. Users and groups interactive administration tool ΓòÉΓòÉΓòÉ
  6389.  
  6390. The Users and groups interactive administration tool allows you to easily 
  6391. manage users and groups for your installation, assign security profiles and 
  6392. edit those once assigned. 
  6393.  
  6394. If you ever want to invoke this utility from the command line, just enter : 
  6395.  
  6396.  
  6397.   EDYSNADM
  6398.  
  6399. The following pages briefly describe the generics of working with this 
  6400. application. Note, however, that a detailed description for each field can be 
  6401. found within the application's help itself. 
  6402.  
  6403. There are several issues to take into account when working with this 
  6404. application : 
  6405.  
  6406.      The 'Lan Server specifics' panels will only display in IBM Lan Server 
  6407.       installed environments. 
  6408.  
  6409.      In the same environment (Lan Server), all Lan Server groups will be 
  6410.       displayed, but and due to the fact that groups and users are defined to 
  6411.       UPM, you have to observe : 
  6412.  
  6413.         -  You can only assign SecureEntry components to SecureEntry groups 
  6414.            (those that start with the letters 'SG'). 
  6415.  
  6416.         -  You can not define first level users, that is, users not belonging 
  6417.            to any group. 
  6418.  
  6419.         -  You can not define groups belonging to other groups. 
  6420.  
  6421.         -  You have more flexibility defining user/group relationships, in the 
  6422.            sense that a given user can belong to more than one group. 
  6423.  
  6424.  The following pages give more detailed information of the different panels 
  6425.  that the application provides: 
  6426.  
  6427.      Startup panel 
  6428.  
  6429.      Group definition panel 
  6430.  
  6431.      User definition panel 
  6432.  
  6433.      Privilege handling 
  6434.  
  6435.      User exits 
  6436.  
  6437.  
  6438. ΓòÉΓòÉΓòÉ 8.1.1. Startup panel ΓòÉΓòÉΓòÉ
  6439.  
  6440. This panel displays the main groups and users defined within your users and 
  6441. groups database, that is, those defined at first level (They have no 'parent' 
  6442. group assigned). You can view the details of any user or group displayed here 
  6443. just by double-clicking on its icon. 
  6444.  
  6445. You can also add, view or delete a new group or user by selecting it if 
  6446. appropriate, and then pressing the appropriate button. 
  6447.  
  6448. To add a new user associated with a given group, open the group panel by 
  6449. double-clicking on its group definition icon, and add the user from that panel. 
  6450. Note that if you are using UCM, adding of a new user requires also that you 
  6451. supply a 'branch name', i.e the branch that the new user belongs to. 
  6452.  
  6453. There is an 'operations' menu within this panel, which allows you, among other 
  6454. things, to directly find a user given his user id. 
  6455.  
  6456. There is an 'options' menu within this panel, which allows you to enable or 
  6457. disable displaying of warning messages that may be reported by the different 
  6458. subsystems. 
  6459.  
  6460. The 'Lan Server' specifics button can be used, under IBM Lan Server 
  6461. environments, to access Lan Server specific data. In this case, from the main 
  6462. panel, it can be used to define ALIAS definitions, as shown by the following 
  6463. panel : 
  6464.  
  6465. In this panel you define the resources, i.e, Lan Server alias, that may be used 
  6466. by your defined users. Refer to the appropriate Lan Server documentation for 
  6467. the meaning of this fields, and also take into account the following : 
  6468.  
  6469.      If you do not give a server name for a given alias, the current server 
  6470.       (where the SecureEntry definitions database reside) will be used. 
  6471.  
  6472.      You can drag and drop alias definitions from/into the resources 
  6473.       container. An alias definition is a text file with the format required to 
  6474.       define a resource through the batch administration tool. This file is 
  6475.       also accepted as a drop source within the groups and users Lan Server 
  6476.       specifics panel, to ease the assignment of such resources. 
  6477.  
  6478.  If you are using UCM, there is an UCM menu where you will be able to define 
  6479.  the dynamic refresh feature for your corporate branches. If you select this 
  6480.  menu you will then be able to choose between one of the three available 
  6481.  options: 
  6482.  
  6483.      Branch Data 
  6484.  
  6485.       Through this panel you will be able to see the branch name as known by 
  6486.       the  UCM Database, the current SecureEntry branch information level and 
  6487.       whether there was an error in the last dynamic refresh operation for this 
  6488.       server. If you don't have the dynamic refresh feature activated, then you 
  6489.       will receive an error. 
  6490.  
  6491.      Policy Refresh 
  6492.  
  6493.       Through this panel you will be able to manage the Corporate refresh 
  6494.       policy customized for all your branches. Also you can manage the 
  6495.       threshold number of branches that will launch the purge process for 
  6496.       obsolete data in the UCM tables once all of them are found to be at a 
  6497.       minimum refresh level. In addition, you will be able to see the active 
  6498.       refresh policy in the UCM administrator workstation (which can differ 
  6499.       from the corporate refresh policy as customized in the UCM Database). 
  6500.  
  6501.      LOG Activity 
  6502.  
  6503.       Through this panel you will be able to activate the UCM LOG feature. If 
  6504.       you activate this feature, then a new UCM LOG table will be updated by 
  6505.       UCM whenever necessary.The only way to delete the obsolete rows in this 
  6506.       table will be through the EDYEXLOG process as explained in the UCM 
  6507.       Administrator's Guide. 
  6508.  
  6509.  
  6510. ΓòÉΓòÉΓòÉ 8.1.2. Group definition panel ΓòÉΓòÉΓòÉ
  6511.  
  6512. Within this panel, you can modify a group definition by adding other groups or 
  6513. users, or assigning SecureEntry security components for the group. There is 
  6514. also the description field which you can use to add a short description to a 
  6515. given group. 
  6516.  
  6517. In order to add, view or delete users or groups, just click on the appropriate 
  6518. button. 
  6519.  
  6520. To add a security component to the group, just drag and drop the file into the 
  6521. component's container. 
  6522.  
  6523. You can also edit a security component by double-clicking on its icon. 
  6524.  
  6525. The 'Lan Server specifics' button can be used here to define resource accesses 
  6526. at a group level, that is, allow users belonging to the group to be able to 
  6527. access the specified resources. The panel looks as follows : 
  6528.  
  6529. Refer to the appropriate Lan Server documentation for the meaning of the 
  6530. different fields displayed by this panel. Also take into account that : 
  6531.  
  6532.      Group logon assignment is not supported directly by Lan Server, but is a 
  6533.       feature implemented and supported within SecureEntry. This basically 
  6534.       means that you will not be able to see those from within the Lan Server 
  6535.       administration tools. 
  6536.  
  6537.      Ensure that resources are available and powered on at administration 
  6538.       time, or you will not be able to see their associations. 
  6539.  
  6540.      The container allows for drag and drop of definition files, with the same 
  6541.       format as that required for batch administration. 
  6542.  
  6543.  
  6544. ΓòÉΓòÉΓòÉ 8.1.3. User definition panel ΓòÉΓòÉΓòÉ
  6545.  
  6546. This panel is very similar to the one for groups definition, allowing you to 
  6547. change the specific data for the user, and optionally assign security 
  6548. components at a user level. 
  6549.  
  6550. To add a security component to the user, just drag and drop the file into the 
  6551. component's container. 
  6552.  
  6553. You can also edit a security component by double-clicking on its icon. 
  6554.  
  6555. The 'Lan Server specifics' button can be used here to define resource accesses 
  6556. at a user level, that is, allow the user to access the specified resources. 
  6557. This panel looks like : 
  6558.  
  6559. Refer to the appropriate Lan Server documentation for the meaning of the 
  6560. different fields displayed by this panel. Also take into account that : 
  6561.  
  6562.      SecureEntry extends the syntax of the home directory specification by 
  6563.       allowing you to leave the server name (MachineName) blank, taking by 
  6564.       default the current server name at assignment time. This is especially 
  6565.       important when working with UCM, facilitating administration and 
  6566.       management. Besides, it attempts to create the directory if not found, 
  6567.       and does an instant access apply to all existing subbdirs when creating 
  6568.       it. So, the syntax for the home directory becomes : 
  6569.  
  6570.                      x:\[MachineName]\y$\path
  6571.       or 
  6572.  
  6573.                      \\[MachineName]\y$\path
  6574.  
  6575.       where x is the drive assigned at logon to the home directory, MachineName 
  6576.       is the server machine name where the home directory resides, (which you 
  6577.       can leave blank to indicate the domain server machine name), y is the 
  6578.       drive within the server, and path is the physical path within that drive. 
  6579.  
  6580.      Ensure that resources are available and powered on at administration 
  6581.       time, or you will not be able to see their associations. 
  6582.  
  6583.      The container allows for drag and drop of definition files, with the same 
  6584.       format as that required for batch administration. 
  6585.  
  6586.  
  6587. ΓòÉΓòÉΓòÉ 8.1.4. Privilege handling ΓòÉΓòÉΓòÉ
  6588.  
  6589. You can set permissions on single administrative operations by defining the 
  6590. administration specific environment variable SGM_ADM_PRIV. The users and groups 
  6591. interactive administration enforces this permissions by automatically disabling 
  6592. the controls that give access to operations to which rights are not held. 
  6593. Anyway, if the user succeeds on requesting an operation to which it has no 
  6594. rights, the operation will not be performed and the user will be prompted with 
  6595. a message box saying that he has not enough rights to perform the operation. 
  6596.  
  6597. For instance, if you set the environment variable SGM_ADM_PRIV to 0xFFFF555F on 
  6598. a particular machine, you're configuring that machine to be able to 
  6599. administrate all existing groups, users and resources, but not to add new ones 
  6600. neither to delete existing ones. 
  6601.  
  6602. Note: to be able to use the users and groups interactive application, the 
  6603. rights 
  6604.  
  6605.       EDYUCM_PRIVILEGE_SUB_VIEW 
  6606.  
  6607.       EDYUCM_PRIVILEGE_USER_GRP_VIEW 
  6608.  
  6609.       EDYUCM_PRIVILEGE_GRP_GRP_VIEW 
  6610.  
  6611.  must be enabled 
  6612.  
  6613.  
  6614. ΓòÉΓòÉΓòÉ 8.1.5. User Exits ΓòÉΓòÉΓòÉ
  6615.  
  6616. You can install administration user exits for the users and groups interactive 
  6617. administration (not for any other administration tool, but only this one) by 
  6618. filling the file EDYADMUS.CMD and placing it into SecureEntry installation 
  6619. path, EXEC subdirectory. An empty sample file is located within the 
  6620. API\SOURCES\EDYADMUS directory. The following user exit points are supported: 
  6621.  
  6622.  UserExitBeforeADD_USER 
  6623.        Called before adding a user 
  6624.  
  6625.  UserExitBeforeADD_USERGROUP 
  6626.        Called before linking a user to a group 
  6627.  
  6628.  UserExitBeforeADD_GROUP 
  6629.        Called before adding a group 
  6630.  
  6631.  UserExitBeforeADD_GROUPGROUP 
  6632.        Called before linking a group to another group 
  6633.  
  6634.  UserExitBeforeADD_RESOURCE 
  6635.        Called before adding a resource 
  6636.  
  6637.  UserExitBeforeADD_RESOURCEUSER 
  6638.        Called before linking a resource to a user 
  6639.  
  6640.  UserExitBeforeADD_RESOURCEGROUP 
  6641.        Called before linking a resource to a group 
  6642.  
  6643.  UserExitBeforeADD_SUBSYSTEM 
  6644.        Called before adding a subsystem 
  6645.  
  6646.  UserExitBeforeUPDATE_USER 
  6647.        Called before updating a user data 
  6648.  
  6649.  UserExitBeforeUPDATE_USERGROUP 
  6650.        Called before updating a user-group link data 
  6651.  
  6652.  UserExitBeforeUPDATE_GROUP 
  6653.        Called before updating a group data 
  6654.  
  6655.  UserExitBeforeUPDATE_GROUPGROUP 
  6656.        Called before updating a group-group link data 
  6657.  
  6658.  UserExitBeforeUPDATE_RESOURCE 
  6659.        Called before updating a resource data 
  6660.  
  6661.  UserExitBeforeUPDATE_RESOURCEGROUP 
  6662.        Called before updating a resource-group link data 
  6663.  
  6664.  UserExitBeforeUPDATE_RESOURCEUSER 
  6665.        Called before updating a resource-user link data 
  6666.  
  6667.  UserExitBeforeUPDATE_SUBSYSTEM 
  6668.        Called before updating a subsystem data 
  6669.  
  6670.  UserExitBeforeDELETE_USER 
  6671.        Called before deleting a user 
  6672.  
  6673.  UserExitBeforeDELETE_USERGROUP 
  6674.        Called before deleting a user-group link 
  6675.  
  6676.  UserExitBeforeDELETE_GROUP 
  6677.        Called before deleting a group 
  6678.  
  6679.  UserExitBeforeDELETE_GROUPGROUP 
  6680.        Called before deleting a group-group link 
  6681.  
  6682.  UserExitBeforeDELETE_RESOURCE 
  6683.        Called before deleting a resource 
  6684.  
  6685.  UserExitBeforeDELETE_RESOURCEUSER 
  6686.        Called before deleting a resource-user link 
  6687.  
  6688.  UserExitBeforeDELETE_RESOURCEGROUP 
  6689.        Called before deleting a resource-group link 
  6690.  
  6691.  UserExitBeforeDELETE_SUBSYSTEM 
  6692.        Called before deleting a subsystem 
  6693.  
  6694.  These exit points allow you to insert any code just before the specified 
  6695.  operation, being able to cancel it or change any desired parameters. 
  6696.  
  6697.  Please edit the edyadmus.cmd file to know more about the implementation 
  6698.  guidelines in order to write your own administration user exits. 
  6699.  
  6700.  
  6701. ΓòÉΓòÉΓòÉ 8.2. Users and groups batch administration tools ΓòÉΓòÉΓòÉ
  6702.  
  6703. SecureEntry provides with tools to allow easily administration of its 
  6704. definitions in batch mode. This chapter describes all of them. 
  6705.  
  6706.      EDYDEFS is a program which will add, update or delete the database 
  6707.       definitions as described within a supplied response file. This is the 
  6708.       tool that you can find in the SecureEntry workbench folder named 'Batch 
  6709.       Users and Groups management' 
  6710.  
  6711.      EDYERASE is a cleanup tool that allows you to selectively erase all or 
  6712.       part of the definitions stored in the SecureEntry users and groups 
  6713.       repository. 
  6714.  
  6715.      EDYDUMP is a tool that allows you extract part or all of the definitions 
  6716.       stored in the SecureEntry users and groups repository, in a format 
  6717.       suitable for later processing through the EDYDEFS utility. 
  6718.  
  6719.      EDYADMIN is a generic purpose administration tool that can help you in 
  6720.       writing easily your own administration jobs. 
  6721.  
  6722.  All of this tools can be located within the SecureEntry path, EXEC directory, 
  6723.  and require administrator privilege for its successful execution. 
  6724.  
  6725.  
  6726. ΓòÉΓòÉΓòÉ 8.2.1. The definitions processing tool ΓòÉΓòÉΓòÉ
  6727.  
  6728. The batch users and groups administration tool allows you to process 
  6729. administration tasks in an unattended way, by means of processing a batch job 
  6730. description file which specifies the actions to process. 
  6731.  
  6732. The invocation command to process batch administration files is : 
  6733.  
  6734.  
  6735.   EDYDEFS Help | ([/]userid [[/]Password:p] [[/]File:f] [[/]Action:a]
  6736.           [[/Trace] [[/]Warn] [[/]Ignore'
  6737.  
  6738.   Userid and password : Ignored. You should have logged on as ADMIN
  6739.   File   : Definitions file name. defaults to EDYDEFS.TXT
  6740.   Action : Startup action. defaults to ADD. Allowed values are
  6741.            ADD, UPDATE, DELETE
  6742.   Trace  : Trace calls to display
  6743.   Warn   : Do not process calls, just syntax check the file
  6744.   Ignore : Ignore errors and continue
  6745.  
  6746. The best way to show the format of the definitions job file is through some 
  6747. sample files, as follows : 
  6748.  
  6749. Sample definitions file for standalone environment. 
  6750.  
  6751. // **********************************************************************
  6752. // * Sample batch file for Secure Entry standalone users administration *
  6753. // **********************************************************************
  6754.  
  6755. [ACTION=ADD]                        // Allowed action types are ADD, UPDATE
  6756.                                     // and DELETE. ACTION keyword means
  6757.                                     // sets the action until otherwise said
  6758. // Lets define one tellers group
  6759.  
  6760. [GROUP=TELLERS]
  6761.   FULL_NAME=Tellers group
  6762.   DESCRIPTION=Group for tellers
  6763.   DESKTOP=EDYDESK.INI               // Any standard SE component is allowed
  6764.   LAUNCHPAD=SELP.INI                // here : DESKTOP, PERS_DESKTOP, LAUNCHPAD
  6765.   FLOPPY_DISK=FPY.INI               // SYSTEM_MENUS, FLOPPY_DISK, TREE_LOCK and
  6766.                                     // SES_BEHAVIOUR
  6767. // Now define two users
  6768. [USER=PEPE]
  6769.   GROUP=TELLERS                     // The group should exist when adding user
  6770.   PRIV_USER=USER                    // Only values : USER or ADMIN
  6771.   FULL_NAME=Pepito de los palotes
  6772.   DESCRIPTION=A user
  6773.   USER_EXPIRE=NEVER                 // NEVER or dd-mm-yyyy format
  6774.   CONNECTION=1                      // 1=> Signon permitted 0=> Not permitted
  6775.   HOUR_START=8                      // These hours are for all days of the week.
  6776.   HOUR_END=20                       // set to 0-24 for Signon permitted anytime.
  6777.   PASSWORD=password                 // 'password' is the default signon password
  6778.   LAUNCHPAD=SELP.INI                // Any standard SE component is allowed
  6779.   FLOPPY_DISK=FPY.INI               // here : DESKTOP, PERS_DESKTOP, LAUNCHPAD
  6780.                                     // SYSTEM_MENUS, FLOPPY_DISK, TREE_LOCK and
  6781. [USER=MIGUEL]                       // SES_BEHAVIOUR
  6782.   GROUP=TELLERS
  6783.   PRIV_USER=USER
  6784.   FULL_NAME=Miguel Indurain
  6785.   DESCRIPTION=A power user
  6786.   USER_EXPIRE=NEVER
  6787.   CONNECTION=1
  6788.   HOUR_START=8
  6789.   HOUR_END=20
  6790.  
  6791. // Now a managers group and a manager definition
  6792.  
  6793. [GROUP=MANAGERS]
  6794.   FULL_NAME=Managers group          // The rest of possible keywords will take
  6795.                                     // the default values
  6796.  
  6797. [USER=ANDRES]
  6798.   GROUP=MANAGERS
  6799.   PRIV_USER=USER                    // We could have used GROUP_LS instead of
  6800.   FULL_NAME=Andy Garcia             // PRIV_USER with the same meaning
  6801.   DESCRIPTION=A manager
  6802.   USER_EXPIRE=1-1-1999
  6803.   CONNECTION=1
  6804.   HOUR_START=8
  6805.   HOUR_END=20
  6806.  
  6807. // Now update Miguel adding a personal launchpad, and move it to another group
  6808.  
  6809. [ACTION=UPDATE]
  6810. [USER=MIGUEL]
  6811.   GROUP=MANAGERS                    // Move user to group managers
  6812.   LAUNCHPAD=SELP.INI                // And add/modify launchpad
  6813.  
  6814. // Now delete the launchpad component for user Miguel
  6815.  
  6816. [ACTION=DELETE]
  6817. [USER=MIGUEL]                       // Not a user deletion, but only component
  6818.   LAUNCHPAD                         // deletion because a keyword follows.
  6819.  
  6820. // Now delete completely the created groups and users
  6821.  
  6822. [USER=MIGUEL]                       // Full user delete
  6823. [USER=ANDRES]
  6824. [USER=PEPE]
  6825. [GROUP=TELLERS]                     // Group delete (must be empty)
  6826. [GROUP=MANAGERS]
  6827.  
  6828. Sample definitions file for Lan Server environment. 
  6829.  
  6830. // **********************************************************************
  6831. // * Sample batch file for Secure Entry Lan Server users administration *
  6832. // **********************************************************************
  6833.  
  6834. [ACTION=ADD]                        // Allowed action types are ADD, UPDATE
  6835.                                     // and DELETE. ACTION keyword means
  6836.                                     // sets the action until otherwise said
  6837. // Lets define one alias
  6838.  
  6839. [ALIAS=TSTALIAS]
  6840.   TYPE=FILES                        // Type of resource.'FILES','SERIAL',
  6841.                                     //  'PRINTER' or 'TREE'
  6842.                                     // for a given alias definition
  6843.   NETNAME=C:\MAR\SGMSHELL           // This is the net name path
  6844.                                     // Can use RESNAME as a synonym
  6845.   SERVER=SERVER1                    // The server of the alias without '\\'
  6846.   WHEN_SHARED=STARTUP               // STARTUP, BYADMIN or DYNAMIC
  6847.   DESCRIPTION=Alias sample          // Put the description here
  6848.   MAX_CONN=45                       // Max. Connections
  6849.  
  6850. // Lets define one tellers group
  6851.  
  6852. [GROUP=SGTELLE]                     // Remember that Secure Entry group names
  6853.                                     // should start with 'SG'
  6854.   FULL_NAME=Tellers group           // Under Lan Server this is ignored
  6855.   DESCRIPTION=Group for tellers     // Put the group description here
  6856.   ACCESS_FILE=ACCESS.DAT            // 'old way' of defining accesses
  6857.                                     // Sample access file :
  6858.                                     // *****************************************
  6859.                                     // * [ALIAS=TSTALIAS]  // aliasname        *
  6860.                                     // *   ACCESS=RWX      // access privileges*
  6861.                                     // *   LOGON_ASN=J:    // logon assignment *
  6862.                                     // *****************************************
  6863.                                     // Note that even if you define an access for
  6864.                                     // update, it will be recreated so the full
  6865.                                     // specification has to appear here :
  6866.                                     // the aliasname, the access rights and
  6867.                                     // logon_asn.
  6868.   ACCESS=TSTALIAS,RWX,J             // 'new way' of defining accesses, inlined.
  6869.                                     // Note that even if you define an access for
  6870.                                     // update, it will be recreated so the full
  6871.                                     // specification has to appear here :
  6872.                                     // ACCESS=aliasname,accessrights,logon_asn.
  6873.   DESKTOP=EDYDESK.INI               // Any standard SE component is allowed
  6874.   LAUNCHPAD=SELP.INI                // here : DESKTOP, PERS_DESKTOP, LAUNCHPAD
  6875.   FLOPPY_DISK=FPY.INI               // SYSTEM_MENUS, FLOPPY_DISK, TREE_LOCK and
  6876.                                     // SES_BEHAVIOUR
  6877. // Now define two users
  6878.  
  6879. [USER=PEPE]
  6880.   GROUP=SGTELLE                     // The group should exist when adding user
  6881.   PRIV_USER=USER                    // Only values : USER or ADMIN
  6882.   FULL_NAME=Pepito de los palotes
  6883.   DESCRIPTION=A user
  6884.   USER_EXPIRE=NEVER                 // NEVER or dd-mm-yyyy format
  6885.   CONNECTION=1                      // 1=> Signon permitted 0=> Not permitted
  6886.   HOUR_START=8                      // These hours are for all days of the week.
  6887.   HOUR_END=20                       // set to 0-24 for Signon permitted anytime.
  6888.   PASSWORD=password                 // 'password' is the default signon password
  6889.   LAUNCHPAD=SELP.INI                // Any standard SE component is allowed
  6890.   FLOPPY_DISK=FPY.INI               // here : DESKTOP, PERS_DESKTOP, LAUNCHPAD
  6891.                                     // SYSTEM_MENUS, FLOPPY_DISK, TREE_LOCK and
  6892.                                     // SES_BEHAVIOUR
  6893.  
  6894.   // Follow keywords specific for Lan Server
  6895.  
  6896.   HOME_DIR=X:\\c$\HOME\PEPE         // The Lan Server home directory for this user
  6897.                                     // Use the syntax :
  6898.                                     //     \\MachineName\x$\path, or
  6899.                                     //    x:\MachineName\x$\path
  6900.                                     // MachineName omitted means server machine
  6901.   MAX_STORAGE=2048000               // Defaults to -1 (no limit)
  6902.   SCRIPT_PATH=C:\SCRIPTS            // Lan server script path
  6903.   ACCESS_FILE=ACCESS.DAT            // 'old way' of defining accesses
  6904.                                     // Sample access file :
  6905.                                     // *****************************************
  6906.                                     // * [ALIAS=TSTALIAS]  // aliasname        *
  6907.                                     // *   ACCESS=RWX      // access privileges*
  6908.                                     // *   LOGON_ASN=J:    // logon assignment *
  6909.                                     // *****************************************
  6910.                                     // Note that even if you define an access for
  6911.                                     // update, it will be recreated so the full
  6912.                                     // specification has to appear here :
  6913.                                     // the aliasname, the access rights and
  6914.                                     // logon_asn.
  6915.   ACCESS=TSTALIAS,RWX,J:            // 'new way' of defining accesses, inlined.
  6916.                                     // Format is alias-name,access privileges,
  6917.                                     // logon-assignment
  6918.                                     // Privileges allowed :
  6919.                                     // D (Delete) A (Attributes) X (Execute)
  6920.                                     // R (Read) W (Write) P (Permissions) N (None)
  6921. [USER=MIGUEL]
  6922.   GROUP=SGTELLE
  6923.   PRIV_USER=USER
  6924.   FULL_NAME=Miguel Indurain
  6925.   DESCRIPTION=A power user
  6926.   USER_EXPIRE=NEVER
  6927.   CONNECTION=1
  6928.   HOUR_START=8
  6929.   HOUR_END=20
  6930.  
  6931. // Now a managers group and a manager definition
  6932.  
  6933. [GROUP=SGMANAG]
  6934.   DESCRIPTION=Managers group        // The rest of possible keywords will take
  6935.                                     // the default values
  6936.  
  6937. [USER=ANDRES]
  6938.   GROUP=SGMANAG,OTHERGR             // LAN Server allows more than one group
  6939.                                     // Note that all groups should be specified
  6940.   PRIV_USER=USER                    // We could have used GROUP_LS instead of
  6941.   FULL_NAME=Andy Garcia             // PRIV_USER with the same meaning
  6942.   DESCRIPTION=A manager
  6943.   USER_EXPIRE=1-1-1999
  6944.   CONNECTION=1
  6945.   HOUR_START=8
  6946.   HOUR_END=20
  6947.  
  6948. // Now update Miguel adding a personal launchpad, and move it to another group
  6949.  
  6950. [ACTION=UPDATE]
  6951. [USER=MIGUEL]
  6952.   GROUP=SGMANAG                     // Move user to group managers
  6953.   LAUNCHPAD=SELP.INI                // And add/modify launchpad
  6954.  
  6955. // Now delete the launchpad component for user Miguel
  6956.  
  6957. [ACTION=DELETE]
  6958. [USER=MIGUEL]                       // Not a user deletion, but only component
  6959.   LAUNCHPAD                         // deletion because a keyword follows.
  6960.  
  6961. // Now delete completely the created groups and users
  6962.  
  6963. [USER=MIGUEL]                       // Full user delete
  6964. [USER=ANDRES]
  6965. [USER=PEPE]
  6966. [GROUP=SGTELLE]                     // Group delete (must be empty)
  6967. [GROUP=SGMANAG]
  6968. [ALIAS=TSTALIAS]                    // Now delete the defined alias
  6969.  
  6970. // General notes :
  6971. //
  6972. // - Remember to specify all group names the user belongs to (except reserved ones)
  6973. //   when updating users. Reserved ones are ADMINS, USERS and GUESTS
  6974. //
  6975. // - Remember that all Secure Entry group names have to start with 'SG'
  6976. //
  6977. // - Remember that update of accesses or components do only update the specified
  6978. //   ones through keywords, not erasing other components or accesses already
  6979. //   existent.
  6980. //
  6981. // - Also remember that deletion of main objects (groups, users, alias) is only
  6982. //   performed if no additional keywords are specified.
  6983.  
  6984.  
  6985. ΓòÉΓòÉΓòÉ 8.2.2. The definitions cleanup tool ΓòÉΓòÉΓòÉ
  6986.  
  6987. The EDYERASE program allows you to easily do planned or unplanned cleanups of 
  6988. your users and groups database. The invocation syntax for this command is as 
  6989. follows : 
  6990.  
  6991.  
  6992.    EDYERASE [?|[/Help]|
  6993.             [[/Branch] [:branchname]] [[/]Groups]
  6994.             [[/]Ignoreerrors [[/]Local] [[/]NBbranch[:branchname]]
  6995.             [[/]Resources] [[/]Trace] [[/]SGroups] [[/]Users]
  6996.             [[/]Usersgroup] [[/]Warning]
  6997.             ([[/]XUsers:mask]..) ([[/]XGroups:mask]..) ([[/XResources:mask]..)
  6998.  
  6999.      /Branch    : Erase all users belonging to a branch
  7000.      /Groups    : Erase all groups
  7001.      /Help      : Help
  7002.      /Ignore    : Ignore errors and continue
  7003.      /Local     : Local branch processing (ignored if no UCM)
  7004.      /NBranch   : Erase all users not defined for the specified branch
  7005.      /Resources : Erase all resources except SGMSHELL
  7006.      /Trace     : Trace on
  7007.      /SGroups   : Erase all SecureEntry groups (all if standalone)
  7008.      /Users     : Erase all users except administrator ones
  7009.      /USERSGroup: Erase all users belonging to a group recursively
  7010.      /XGroups   : In any case, do not erase groups matching mask
  7011.      /XResources: In any case, do not erase resources matching mask
  7012.      /XUsers    : In any case, do not erase users matching mask
  7013.      /Warning   : Do not perform actions, just display
  7014.  
  7015.     Sample : EDYERASE /NB:BR03 /XU:9* /XU:THEBOSS
  7016.              Erases all users not belonging to branch BR03 except
  7017.              users beginning with '9' and THEBOSS user
  7018.  
  7019. Note that full wildcard support is provided for the mask type parameters. 
  7020.  
  7021.  
  7022. ΓòÉΓòÉΓòÉ 8.2.3. The definitions dumper tool ΓòÉΓòÉΓòÉ
  7023.  
  7024. The EDYDUMP utility allows you to extract resources, users and groups 
  7025. information from the users and groups repository, in a format which is suitable 
  7026. for later processing through the EDYDEFS utility. It will create the necessary 
  7027. batch file and download the appropriate security profiles as temporary files. 
  7028. The invocation syntax for this command is as follows: 
  7029.  
  7030.  
  7031.   EDYDUMP Help | [[/]File:f]  [[/]Password:p] [[/]Expire]
  7032.                  [[/]Nofiles] [[/NOGroups] [[/]NOResources] [[/NOUsers]
  7033.                  [[/]Trace]   [[/]Ignore]
  7034.  
  7035.             File    : Definitions file path and name to create
  7036.                       downloaded profiles will go to the same directory
  7037.             Password: Generate passwords for users. p may contain
  7038.                       %(.x)U for userid
  7039.                       %(.x)N for user number
  7040.                       %(.x)D for current day
  7041.                       %(.x)M for current month
  7042.                       %(.x)Y for current year
  7043.                       x indicates forced length. left padded with 0s
  7044.             Expire  : Add password expire keyword for all users
  7045.             Nofiles : Do not download profiles. Only DEF data
  7046.             NOGroups: Do not extract groups information
  7047.          NOResources: Do not extract resources information (LS only)
  7048.             NOUsers : Do not extract users information
  7049.             Trace   : Trace calls to display
  7050.             Ignore  : Ignore errors and continue
  7051.  
  7052.       Example : EDYDUMP /P:U%.7N
  7053.  
  7054. Note that since the administration APIs do not return passwords, this is the 
  7055. only information you may find missing from the output batch file. To help 
  7056. overcome this problem, you can use the '/P' parameter, specifying a syntax for 
  7057. generating new passwords which are unique in a per user basis. 
  7058.  
  7059.  
  7060. ΓòÉΓòÉΓòÉ 8.2.4. The generic administration tool command ΓòÉΓòÉΓòÉ
  7061.  
  7062. The EDYADMIN program allows you to do any administration task through command 
  7063. line. Since this command is of a generic purpose, requires a good knowledge of 
  7064. the SecureEntry repository structure, and is not necessary for regular 
  7065. administration tasks. It is described in the following chapter under 
  7066. Programming your own administration tools. 
  7067.  
  7068.  
  7069. ΓòÉΓòÉΓòÉ 9. Implementing SecureEntry solutions ΓòÉΓòÉΓòÉ
  7070.  
  7071. In some occasions, what is provided with SecureEntry base may not be sufficient 
  7072. to implement the requirements that are necessary for a given installation. 
  7073. SecureEntry has an architecture which allows, with little effort, to achieve 
  7074. significant expandability in order to be adapted to a very heterogeneous set of 
  7075. needs. 
  7076.  
  7077. You can basically expand SecureEntry in the following areas : 
  7078.  
  7079.      Programming to the SecureEntry user info API to obtain security 
  7080.       information about the currently logged on user from within your 
  7081.       application. 
  7082.  
  7083.      Programming user exits to perform required tasks in a per session event 
  7084.       basis. 
  7085.  
  7086.      Programming your own naming filters to provide for special naming 
  7087.       requirements within the signon process. 
  7088.  
  7089.      Adding your own components to be integrated as all SecureEntry base 
  7090.       components are. 
  7091.  
  7092.      Programming your own logon procedures to grant access to your specific 
  7093.       subsystems as part of the logon process. 
  7094.  
  7095.      Programming your own administration tools to do special tasks or 
  7096.       processes in the administration area. 
  7097.  
  7098.  SecureEntry has a also a complete set of utilities to help you perform all of 
  7099.  this and also aid you with your software integration effort. This includes 
  7100.  several OS/2 native utilities,VDM utilities, plus a very sophisticated trace 
  7101.  subsystem, which you can use to debug your solution, always with the handy 
  7102.  help of the SecureEntry maintenance utilities. 
  7103.  
  7104.  
  7105. ΓòÉΓòÉΓòÉ 9.1. The SecureEntry user info API ΓòÉΓòÉΓòÉ
  7106.  
  7107. The SecureEntry kernel API allows you to obtain information about who is logged 
  7108. on, its privileges and other relevant session data. The include and library 
  7109. files are located in the SecureEntryPath\API\SOURCES\EDYAPI directory. 
  7110.  
  7111. The provided functions are two : 
  7112.  
  7113.  
  7114.   unsigned long _System sgm_userinfo_getkey (char * key,
  7115.                                              char * data,
  7116.                                              unsigned long size,
  7117.                                              unsigned long reserved);
  7118.  
  7119. Allows you to get information in a per key basis. 
  7120.  
  7121.  
  7122.   unsigned long _System sgm_userinfo_get (char * buffer, long buflen,
  7123.                                           short level, unsigned long reserved);
  7124.  
  7125. Allows you to get user information in a structured way. 
  7126.  
  7127. Note that return codes and valid structures are defined within the EDYAPI.H 
  7128. file. 
  7129.  
  7130. Note also that other functions you may find here are maintained in the include 
  7131. file for compatibility reasons, but will not be honored by SecureEntry 3.0, 
  7132. since the profile management functions should go now through the new 
  7133. administration interfaces. 
  7134.  
  7135.  
  7136. ΓòÉΓòÉΓòÉ 9.2. Programming user exits ΓòÉΓòÉΓòÉ
  7137.  
  7138. When you want to do special processing in a per event basis, you can use 
  7139. SecureEntry user exits to do so. There are two ways to program your own user 
  7140. exits. Via REXX or a compiled language. In any case, you can find the source 
  7141. modules required within the SecureEntryPath\API\SOURCES\EDYCUST directory. 
  7142.  
  7143. If you choose to program those in REXX, just fill in the provided EDYCUST.CMD 
  7144. file and place it within the SecureEntryPath\EXEC directory. 
  7145.  
  7146. If coding the user exits in REXX, note that the performance degradation will be 
  7147. minimal, since the REXX user exits program is kept loaded as a function of the 
  7148. EDYSLA SecureEntry kernel. In this case, you have also limited support for 
  7149. global 'inter user exit' variables, as explained in the EDYCUST.CMD file. 
  7150.  
  7151. If you code these in C, the filled and compiled file EDYCUST.DLL must be placed 
  7152. within the SecureEntryPath\DLL directory. 
  7153.  
  7154. The user exits provided are : 
  7155.  
  7156.      User exit after startup: 
  7157.  
  7158.       Intended as a 'second opportunity' to the startup processing, allows you 
  7159.       to start processes in a symmetrical way to the user exit before shutdown. 
  7160.       Runs under superuser context. 
  7161.  
  7162.      User exit before logon dialog: 
  7163.  
  7164.       This one gives the opportunity to do some processing and optionally 
  7165.       decide to continue with a guest logon before the SecureEntry logon dialog 
  7166.       starts interacting with the user, i.e, a guest logon does not require to 
  7167.       fill up the userid/password dialog. Runs under superuser context. You can 
  7168.       optionally present your own logon dialog here, but if you do so, then 
  7169.       your application dialog has to be system modal, and will have to call 
  7170.       EDYUTIL with the appropriate NEXTLOGON parameters to avoid the 
  7171.       SecureEntry LOGON dialog appearing afterwards. In any case, do not forget 
  7172.       to return the system modality to the previous owner once your dialog is 
  7173.       destroyed. 
  7174.  
  7175.       You can also decide to shutdown the system when exiting from this user 
  7176.       exit. 
  7177.  
  7178.      User exit before logon: 
  7179.  
  7180.       This user exit can be used to decide on guest logon processing after the 
  7181.       user has filled up the logon dialog. It can be used to implement 
  7182.       'service' logons with algorithmic passwords provided by a central site. 
  7183.       Runs under superuser context. 
  7184.  
  7185.       You can also decide to shutdown the system when exiting from this user 
  7186.       exit. 
  7187.  
  7188.      User exit before logon changing password: 
  7189.  
  7190.       Same as the user exit before logon, but receiving the new password also. 
  7191.       Runs under superuser context. 
  7192.  
  7193.      User exit after logon changing password: 
  7194.  
  7195.       This user exit is intended to inform your applications that the password 
  7196.       has been changed, if required. Runs in user context. 
  7197.  
  7198.      User exit before profiles activation: 
  7199.  
  7200.       This user exit is processed at logon, once the security profiles have 
  7201.       been downloaded to the workstation's WORK directory. You can use it to 
  7202.       modify/copy those profiles and do any preprocessing that may be necessary 
  7203.       before they are activated. 
  7204.  
  7205.      User exit after logon: 
  7206.  
  7207.       Used to do specific processes after any logon. Note that presentation 
  7208.       manager and Workplace shell are ready when this user exit is called. Also 
  7209.       note that this user exit is called even in the guest logon case and after 
  7210.       any shell (PMSHELL) restart. Runs under user context. 
  7211.  
  7212.      User exit before cancellable logoff: 
  7213.  
  7214.       This user exit gives the opportunity to verify and optionally deny the 
  7215.       logoff event, if for any reason it is detected that it can not be 
  7216.       processes due to application requirements. Runs under user context. 
  7217.  
  7218.      User exit before imminent logoff: 
  7219.  
  7220.       This user exit's purpose is to allow closing of critical applications, 
  7221.       having granted the fact that the logoff event will be processed until the 
  7222.       end. Runs under the logged on user context. 
  7223.  
  7224.      User exit after profiles deactivation: 
  7225.  
  7226.       This user exit is processed at logoff, once the security profiles have 
  7227.       been deactivated at the workstation's. You can use it to modify/copy 
  7228.       those profiles and do any postprocessing that may be necessary before 
  7229.       they are uploaded. 
  7230.  
  7231.      User exit after logoff: 
  7232.  
  7233.       This user exit is intended to do any required cleanup necessary after a 
  7234.       user logoff in superuser context. 
  7235.  
  7236.      User exit before shutdown: 
  7237.  
  7238.       This user exit allows for doing final cleanup of the machine before the 
  7239.       shutdown event completes. Runs under superuser context. 
  7240.  
  7241.      User exit after pmshell: 
  7242.  
  7243.       This exit is given to inform whoever requires it that the Workplace Shell 
  7244.       is active and running. Note that this one is special in the sense that 
  7245.       nothing else is granted here about logged on users. 
  7246.  
  7247.      User exit after startup: 
  7248.  
  7249.       This exit is given to inform whoever requires it that the EDYSTART.CMD 
  7250.       file has finished processing. You can use this user exit to start any 
  7251.       process that you may want to somehow 'hide' from the EDYSTART.CMD file. 
  7252.  
  7253.      User exit before cancellable lockup: 
  7254.  
  7255.       This exit is given to inform whoever requires it that a lock event has 
  7256.       been posted, and to give you the ability to programmatically cancel it, 
  7257.       or prefill the parameter area with the userid/password to use. 
  7258.  
  7259.      User exit lockup: 
  7260.  
  7261.       This exit is given to inform whoever requires it that an lock event, 
  7262.       which can not be cancelled, is about to be processed, in order to start 
  7263.       or terminate any required task. 
  7264.  
  7265.      User exit before unlock dialog: 
  7266.  
  7267.       This exit is given to inform whoever requires it that an unlock event is 
  7268.       about to be processed, to give the opportunity to display your own panel, 
  7269.       or prefill/read/validate the password. If you do present your own dialog, 
  7270.       then your dialog has to be system modal, and your application will be 
  7271.       responsible for calling EDYUTIL with the appropriate NEXTUNLOCK 
  7272.       parameters to avoid the UNLOCK dialog to be presented afterwards. In any 
  7273.       case, do not forget to return the system modality to the previous owner 
  7274.       once your dialog is destroyed. 
  7275.  
  7276.       You can also decide to logoff or shutdown the system when exiting from 
  7277.       this user exit. 
  7278.  
  7279.      User exit before unlock: 
  7280.  
  7281.       This exit is given to inform whoever requires it that, once the unlock 
  7282.       password has been obtained, it is going to be validated against the 
  7283.       current SecureEntry validation password for the session. You can validate 
  7284.       it yourself at this point. 
  7285.  
  7286.       You can also decide to logoff or shutdown the system when exiting from 
  7287.       this user exit. 
  7288.  
  7289.      User exit after unsuccessful unlock: 
  7290.  
  7291.       This is the last chance before an invalid password processing follows its 
  7292.       regular flow to inform the user at unlock time. You can use it to modify 
  7293.       the behavior, accepting the password, blocking the machine, forcing a 
  7294.       logoff or a shutdown. 
  7295.  
  7296.      User exit after unlock: 
  7297.  
  7298.       This exit is given to start/terminate any required process when an unlock 
  7299.       event is finishing. 
  7300.  
  7301.      User exit before logoff from unlock dialog: This user exit allows for a 
  7302.       programmed authorization of logoff from the unlock dialog, in case this 
  7303.       option is enabled through the currently active SES behavior profile. 
  7304.  
  7305.      User exit before shutdown from unlock dialog: This user exit allows for a 
  7306.       programmed authorization of shutdown from the unlock dialog, in case this 
  7307.       option is enabled through the currently active SES behavior profile. 
  7308.  
  7309.      Signal user exit: This user exit allows to receive parameters from the 
  7310.       application code within the user exit context, to perform specific 
  7311.       actions under the user exit's code environment. The Session event 
  7312.       launcher : EDYUTIL utility can be used to launch one of this user exits. 
  7313.  
  7314.      SupeUser signal user exit: This user exit allows to receive parameters 
  7315.       from the application code within the user exit context, to perform 
  7316.       specific actions knowing that they will run under super user context and 
  7317.       within the user exit's code environment. Note that if you are not using 
  7318.       the real Security Enabling Services, then all processes started within 
  7319.       this user exit will run under regular user context, and not super user 
  7320.       context as explained above. The Session event launcher : EDYUTIL utility 
  7321.       can be used to launch one of this user exits. 
  7322.  
  7323.      LMP user exits: These user exits allow you to change the normal control 
  7324.       flow of the logon procedures by examining the ret. code about to be 
  7325.       returned, and changing it appropriately. With this user exits you can, 
  7326.       for instance, avoid users to logon in emergency mode, or force an 
  7327.       algorithmic password for specific users. 
  7328.  
  7329.      Folder open and close user exits: 
  7330.  
  7331.       This user exits are invoked whenever an object with a defined hook has 
  7332.       been configured to call them, at open or close time. The user exit for 
  7333.       the open object event may decide not to open the object by returning a 
  7334.       specific return code. You can read more about hooked objects in The 
  7335.       Hooked objects component chapter. 
  7336.  
  7337.      User exit hotkey: 
  7338.  
  7339.       If the active SES profile has defined hooks for systemwide hotkeys, then 
  7340.       this user exit will be triggered each time one of the hooked key 
  7341.       combination is detected. You can then do your logic, and choose to either 
  7342.       process the hotkey yourself, or pass it along so that the default action 
  7343.       is then performed. 
  7344.  
  7345.      User exit before reboot: 
  7346.  
  7347.       You can use this user exit as a signal that reboot is to be performed by 
  7348.       SecureEntry, either from within the Ctl-Alt-Del options dialog, or as a 
  7349.       Ctl-Alt-Del user request when the configured action for this key 
  7350.       combination is to directly reboot the system. 
  7351.  
  7352.  For further information, please look at the User exits control flow, and read 
  7353.  the appropriate fully commented source file. 
  7354.  
  7355.  A Sample user exit implementation is also available for review, as well as two 
  7356.  sample logon and unlock dialogs. 
  7357.  
  7358.  
  7359. ΓòÉΓòÉΓòÉ 9.2.1. User exits control flow ΓòÉΓòÉΓòÉ
  7360.  
  7361. The following list shows the regular flow (calling sequence) for the different 
  7362. available user exits. 
  7363.  
  7364.  
  7365.     * Machine startup and logon
  7366.  
  7367.     UserExitAfterStartup
  7368.     UserExitBeforeLogonDialog
  7369.     UserExitBeforeLogon
  7370.     UserExitBeforeLMPSignon              Note : one received per LMP
  7371.     UserExitAfterLMPSignon
  7372.     UserExitAfterPmShell                 Note : Asynchronous (not granted timing)
  7373.     UserExitBeforeProfilesActivation
  7374.     UserExitAfterLogon
  7375.  
  7376.     * Regular lock-unlock
  7377.  
  7378.     UserExitBeforeCancellableLockup
  7379.     UserExitLockup
  7380.     UserExitBeforeUnlockDialog
  7381.     UserExitBeforeUnlock
  7382.     UserExitAfterUnlock
  7383.  
  7384.     * Regular shutdown from desktop of logged on user
  7385.  
  7386.     UserExitBeforeCancellableLogoff
  7387.     UserExitBeforeImminentLogoff
  7388.     UserExitAfterProfilesDeactivation
  7389.     UserExitBeforeLMPSignoff              Note : one received per LMP
  7390.     UserExitAfterLMPSignoff
  7391.     UserExitAfterLogoff
  7392.     UserExitBeforeShutdown
  7393.  
  7394.     * Machine startup and regular logon changing password
  7395.  
  7396.     UserExitAfterStartup
  7397.     UserExitBeforeLogonDialog
  7398.     UserExitAfterPmShell                 Note : Asynchronous (not granted timing)
  7399.     UserExitBeforeLogonChangingPassword
  7400.     UserExitBeforeLMPSignon              Note : one received per LMP
  7401.     UserExitAfterLMPSignon
  7402.     UserExitBeforeProfilesActivation
  7403.     UserExitAfterLogonChangingPassword
  7404.  
  7405.     * Regular lockup - logoff from unlock dialog
  7406.  
  7407.     UserExitBeforeCancellableLockup
  7408.     UserExitLockup
  7409.     UserExitBeforeUnlockDialog
  7410.     UserExitBeforeLogoffFromUnlock
  7411.     UserExitBeforeCancellableLogoff
  7412.     UserExitBeforeImminentLogoff
  7413.     UserExitAfterProfilesDeactivation
  7414.     UserExitBeforeLMPSignoff              Note : one received per LMP
  7415.     UserExitAfterLMPSignoff
  7416.     UserExitAfterLogoff
  7417.  
  7418.     * Regular Shutdown from logon panel
  7419.  
  7420.     UserExitBeforeLogonDialog
  7421.     UserExitBeforeShutdown
  7422.  
  7423.     * Machine startup and logon
  7424.  
  7425.     UserExitAfterStartup
  7426.     UserExitBeforeLogonDialog
  7427.     UserExitBeforeLogon
  7428.     UserExitAfterPmShell                 Note : Asynchronous (not granted timing)
  7429.     UserExitBeforeLMPSignon              Note : one received per LMP
  7430.     UserExitAfterLMPSignon
  7431.     UserExitBeforeProfilesActivation
  7432.     UserExitAfterLogon
  7433.  
  7434.     * Lockup - unlock fail due to invalid password - Retry and successful unlock
  7435.  
  7436.     UserExitBeforeCancellableLockup
  7437.     UserExitLockup
  7438.     UserExitBeforeUnlockDialog
  7439.     UserExitBeforeUnlock
  7440.     UserExitAfterUnsuccessfulUnlock
  7441.     UserExitBeforeUnlock
  7442.     UserExitAfterUnlock
  7443.  
  7444.     * Regular logoff from desktop of logged on user
  7445.  
  7446.     UserExitBeforeCancellableLogoff
  7447.     UserExitBeforeImminentLogoff
  7448.     UserExitAfterProfilesDeactivation
  7449.     UserExitBeforeLMPSignoff             Note : one received per LMP
  7450.     UserExitAfterLMPSignoff
  7451.     UserExitAfterLogoff
  7452.  
  7453.     * Regular logon changing password
  7454.  
  7455.     UserExitBeforeLogonDialog
  7456.     UserExitBeforeLogonChangingPassword
  7457.     UserExitBeforeLMPSignon              Note : one received per LMP
  7458.     UserExitAfterLMPSignon
  7459.     UserExitBeforeProfilesActivation
  7460.     UserExitAfterLogonChangingPassword
  7461.  
  7462.     * Regular Logoff from desktop, cancelled
  7463.  
  7464.     UserExitBeforeCancellableLogoff
  7465.  
  7466.     * Regular logoff from desktop
  7467.  
  7468.     UserExitBeforeCancellableLogoff
  7469.     UserExitBeforeImminentLogoff
  7470.     UserExitAfterProfilesDeactivation
  7471.     UserExitBeforeLMPSignoff             Note : one received per LMP
  7472.     UserExitAfterLMPSignoff
  7473.     UserExitAfterLogoff
  7474.  
  7475.     * Forcing Guest logon from User exit before logon
  7476.  
  7477.     UserExitBeforeLogonDialog
  7478.     UserExitBeforeLogon                  Note : Returning RC_GUEST_LOGON
  7479.     UserExitAfterLogon
  7480.  
  7481.     * Regular logoff from desktop of guest user
  7482.  
  7483.     UserExitBeforeCancellableLogoff
  7484.     UserExitBeforeImminentLogoff
  7485.  
  7486.     * Forcing Guest logon from user exit before logon dialog
  7487.  
  7488.     UserExitBeforeLogonDialog            Note : Returning RC_GUEST_LOGON
  7489.     UserExitAfterLogon
  7490.  
  7491.     * Regular logoff from desktop of guest user
  7492.  
  7493.     UserExitBeforeCancellableLogoff
  7494.     UserExitBeforeImminentLogoff
  7495.  
  7496.     * Regular logon
  7497.  
  7498.     UserExitBeforeLogonDialog
  7499.     UserExitBeforeLogon
  7500.     UserExitBeforeLMPSignon              Note : one received per LMP
  7501.     UserExitAfterLMPSignon
  7502.     UserExitBeforeProfilesActivation
  7503.     UserExitAfterLogon
  7504.  
  7505.     * Lock and then Shutdown from unlock dialog
  7506.  
  7507.     UserExitBeforeCancellableLockup
  7508.     UserExitLockup
  7509.     UserExitBeforeUnlockDialog
  7510.     UserExitBeforeShutdownFromUnlock
  7511.     UserExitBeforeCancellableLogoff
  7512.     UserExitBeforeImminentLogoff
  7513.     UserExitAfterProfilesDeactivation
  7514.     UserExitBeforeLMPSignoff             Note : one received per LMP
  7515.     UserExitAfterLMPSignoff
  7516.     UserExitAfterLogoff
  7517.     UserExitBeforeShutdown
  7518.  
  7519.  
  7520. ΓòÉΓòÉΓòÉ 9.2.2. Sample user exit implementation ΓòÉΓòÉΓòÉ
  7521.  
  7522. To clarify things a bit, lets suppose the following scenario : 
  7523.  
  7524. We have an already written application which does handle logon and logoff, and 
  7525. wish to integrate SecureEntry inside this environment, taking profit of the 
  7526. lockup, ctl-alt-del handling, and security profile activation features of 
  7527. SecureEntry. Lets assume also that the written application has the following 
  7528. logic : 
  7529.  
  7530.  
  7531.         Do
  7532.           Query UserID and Password
  7533.           Validate_user
  7534.           if not privileged then
  7535.              run teller application
  7536.         Until privileged
  7537.  
  7538. We also want a 'backdoor' to be able to logon as a real SecureEntry 
  7539. administrator. 
  7540.  
  7541. It seems clear now that we have three types of users : 
  7542.  
  7543.      Regular 'tellers' which a set of restricted security profiles 
  7544.  
  7545.      Service people who have limited access to system resources 
  7546.  
  7547.      SecureEntry administrators 
  7548.  
  7549.  One of the easiest ways to implement such a scenario, taking into account that 
  7550.  userid/password query is normally processed by the application, is through 
  7551.  user exits. Lets describe the proposal : 
  7552.  
  7553.      Normally, all logons will be as GUEST, except when logging as a 
  7554.       SecureEntry administrator. This means that SecureEntry dialogs for logon 
  7555.       will never be displayed except when the backdoor is called. 
  7556.  
  7557.      The default teller security profiles will be kept as the default ones, 
  7558.       and stored in the NOUSER directory. 
  7559.  
  7560.      The privileged security profiles for the service people will be also in 
  7561.       the NOUSER directory, but activated/deactivated in an as required basis 
  7562.       (p*.ini). 
  7563.  
  7564.      The 'backdoor' real SecureEntry logon will be implemented as a signal 
  7565.       passed parameter. 
  7566.  
  7567.      Just for the beauty of it, (and to show how to do it), we will start the 
  7568.       system clock for real SecureEntry users. 
  7569.  
  7570.  Now, the required EDYCUST file changes are as follows : 
  7571.  
  7572.  
  7573.      1) Lets declare a global variable
  7574.  
  7575.         Line 158 :  MyGlobalVars='aString'
  7576.  
  7577.      2) UserExitAfterStartup:
  7578.  
  7579.            /*
  7580.               We can do one time user exit initialization code here, since
  7581.               not counting the user exit after PMSHELL, this one will be the
  7582.               first one
  7583.            */
  7584.  
  7585.            /* To be able to open the clock */
  7586.            call RxFuncAdd 'SysLoadFuncs', 'REXXUTIL', 'SysLoadFuncs'
  7587.            call SysLoadFuncs
  7588.            /* Make sure first logon is regular */
  7589.            aString=''
  7590.  
  7591.         return RC_NONE
  7592.  
  7593.      3) UserExitBeforeLogonDialog:
  7594.  
  7595.         /* If not using the backdoor, always user GUEST LOGON */
  7596.  
  7597.         if strip(translate(aString))<>'SENTRY' then
  7598.            return RC_GUEST_LOGON
  7599.  
  7600.         return RC_CONTINUE_NORMAL_LOGON_FLOW
  7601.  
  7602.      4) UserExitAfterLogon:
  7603.  
  7604.            UserID=Reserved1
  7605.  
  7606.            if strip(translate(aString))<>'SENTRY' then
  7607.            do
  7608.  
  7609.              /* Regular logon....                    */
  7610.              /* This should be started or detached, since has to run
  7611.                 within the user session, not inside a user exit      */
  7612.  
  7613.              'start /C d:\sgmshell\exec\apprun.cmd'
  7614.            end
  7615.            else
  7616.            do
  7617.              /* Backdoor logon....                   */
  7618.              /* Following time will be regular logon */
  7619.              /* But for this time as a sample lets open the clock object */
  7620.  
  7621.              aString=''
  7622.              rc=SysOpenObject('<WP_CLOCK>','DEFAULT',1)
  7623.            end
  7624.  
  7625.         return RC_NONE
  7626.  
  7627.  
  7628.      5) UserExitBeforeImminentLogoff:
  7629.  
  7630.            if strip(translate(aString))='PRIV' then
  7631.            do
  7632.              /* Deactivate the privileged profiles by
  7633.                 activating NOUSER standard ones       */
  7634.  
  7635.              'd:\sgmshell\exec\edyrefr.exe d:\sgmshell\nouser\edydesk.ini'
  7636.              'd:\sgmshell\exec\edyflpy.exe /I:d:\sgmshell\nouser\edyflopp.ini'
  7637.              aString=''
  7638.            end
  7639.            /* Note that if sentry backdoor aString value is maintained 'SENTRY' */
  7640.  
  7641.         return RC_NONE
  7642.  
  7643.      6) UserExitSignal:
  7644.  
  7645.            aString=AllParms
  7646.  
  7647.            if strip(translate(aString))='PRIV' then
  7648.            do
  7649.              /* Activate the privileged profiles */
  7650.  
  7651.              'd:\sgmshell\exec\edyrefr.exe d:\sgmshell\nouser\pdesk.ini'
  7652.              'd:\sgmshell\exec\edyflpy.exe /I:d:\sgmshell\nouser\pflopp.ini'
  7653.            end
  7654.            /* If backdoor to sentry then force logoff */
  7655.            if strip(translate(aString))='SENTRY' then
  7656.              'edyutil frlogoff'
  7657.  
  7658.         return RC_NONE
  7659.  
  7660.  And the application code (APPRUN.CMD) would have to have the following logic 
  7661.  change : 
  7662.  
  7663.  
  7664.           Do
  7665.             Query UserID and Password
  7666.             Validate_user
  7667.  
  7668.             RUN EDYUTIL NEXTUNLOCK /U:UserID /V:password
  7669.  
  7670.             if not privileged then
  7671.                run teller application
  7672.           Until privileged
  7673.  
  7674.           RUN EDYUTIL SIGNAL PRIV
  7675.  
  7676.  And at any time, calling EDYUTIL SIGNAL SENTRY would force the backdoor to 
  7677.  run, making the next logon a real SecureEntry one. 
  7678.  
  7679.  Note how easy is it, what a huge behavior change achieved with just 20 lines 
  7680.  of REXX code added!!. 
  7681.  
  7682.  
  7683. ΓòÉΓòÉΓòÉ 9.2.3. Sample logon and unlock dialogs ΓòÉΓòÉΓòÉ
  7684.  
  7685. The user exits allow to easily insert logon and unlock dialogs created by the 
  7686. user, as an alternative to the default dialogs that SecureEntry provides. 
  7687.  
  7688. You can find two fully customable alternative logon and unlock dialogs in the 
  7689. EXEC directory of the SecureEntry path. The source files of both dialogs are 
  7690. available in the API\SOURCES\DIALOGS directory of the SecureEntry path. This 
  7691. are two ZIP files which contain the source tree structure of a VisproRexx 
  7692. project. 
  7693.  
  7694. The logon dialog accepts the following syntax: 
  7695.  
  7696.  
  7697.      LOGSAMP [/D:domain | /d:[domain]]
  7698.              [/U:userid /L:file.bmp /S:string /NG /NC /Ns /NS
  7699.               /NH /P:px,py /T /F]
  7700.  
  7701.  
  7702.  /D:       to specify the default Domain for the next logon. 
  7703.  
  7704.  /d:       to specify the default Domain, and to show an entry field that 
  7705.            allows for modifying this domain. 
  7706.  
  7707.  /U:       to specify the default Userid that must be shown in the userid entry 
  7708.            field. 
  7709.  
  7710.  /L:       to specify the file having the logo that must be shown in the 
  7711.            dialog. If not specified, it defaults to the IBM logo. 
  7712.  
  7713.  /S:       to specify the header string that must be shown in the logon dialog. 
  7714.            If not specified, it defaults to the string "IBM Global Services". 
  7715.  
  7716.  /NG       to hide the Guest button. 
  7717.  
  7718.  /NC       to hide the Clear button. 
  7719.  
  7720.  /Ns       to hide the Shutdown button. 
  7721.  
  7722.  /NS       to hide the Forced Shutdown button. 
  7723.  
  7724.  /NH       to hide the Help button. 
  7725.  
  7726.  /P:       to specify the logon dialog position in the screen. Horizontal 
  7727.            coordinates (px) and vertical coordinates (py) have their origin in 
  7728.            the left bottom corner of the screen and their values range from 0 
  7729.            to 100, both included. The default position is at the center of the 
  7730.            screen. 
  7731.  
  7732.  /T        to show the Clock. 
  7733.  
  7734.  /F        to show the Date. 
  7735.  
  7736.  The unlock dialog accepts the following syntax: 
  7737.  
  7738.  
  7739.        UNSAMP [/L:file.bmp /S:string /Nl /NL /Ns /NS
  7740.                /NH /P:px,py /T /F]
  7741.  
  7742.  
  7743.  /L:       to specify the file having the logo that must be shown in the 
  7744.            dialog. If not specified, it defaults to the IBM logo. 
  7745.  
  7746.  /S:       to specify the header string that must be shown in the logon dialog. 
  7747.            If not specified, it defaults to the string "IBM Global Services". 
  7748.  
  7749.  /Nl       to hide the Logoff button. 
  7750.  
  7751.  /NL       to hide the Forced Logoff button. 
  7752.  
  7753.  /Ns       to hide the Shutdown button. 
  7754.  
  7755.  /NS       to hide the Forced Shutdown button. 
  7756.  
  7757.  /NH       to hide the Help button. 
  7758.  
  7759.  /P:       to specify the unlock dialog position in the screen. Horizontal 
  7760.            coordinates (px) and vertical coordinates (py) have their origin in 
  7761.            the left bottom corner of the screen and their values range from 0 
  7762.            to 100, both included. The default position is at the center of the 
  7763.            screen. 
  7764.  
  7765.  /T        to show the Clock. 
  7766.  
  7767.  /F        to show the Date. 
  7768.  
  7769.  For example, if you want to use the alternative logon dialog having the 
  7770.  following features: 
  7771.  
  7772.      with a modifiable default domain whose name is "domain" 
  7773.  
  7774.      without the Guest button 
  7775.  
  7776.      without the Forced Shutdown button 
  7777.  
  7778.      with Clock and Date 
  7779.  
  7780.  then you should call LOGSAMP in the user exit before the logon dialog in the 
  7781.  EDYCUST.CMD file this way: 
  7782.  
  7783.  
  7784.        UserExitBeforeLogonDialog:
  7785.  
  7786.               /*  Call the alternative logon dialog */
  7787.  
  7788.                'LOGSAMP /d:domain /NG/NS/F/T'
  7789.  
  7790.               /*  Return the RC supplied by LOGSAMP */
  7791.  
  7792.                 return RC
  7793.  
  7794.  Similarly, you can call the alternative unlock dialog the same way in the user 
  7795.  exit before unlock dialog. 
  7796.  
  7797.  Also, you may want to read about the SGM_USER_DLGS environment variable, to 
  7798.  achieve maximum robustness in overriding the default logon/unlock dialogs. 
  7799.  
  7800.  
  7801. ΓòÉΓòÉΓòÉ 9.3. Programming naming filters ΓòÉΓòÉΓòÉ
  7802.  
  7803. The file EDYFILT.DLL can be used to provide for automatic translation of 
  7804. userid's, passwords and/or domain names. It is intended to allow for 
  7805. integrating different subsystem naming conventions. 
  7806.  
  7807. The skeleton file to program a filter DLL can be found within the 
  7808. SecureEntryPath\API\SOURCES\EDYFILT path, and if filled and compiled and then 
  7809. placed within the DLL directory, it will be called by the different logon 
  7810. subsystems before using the passed arguments. For instance, you may decide to 
  7811. have all your passwords scrambled somehow to the Lan Server, or to preppend a 
  7812. given letter to all SecureEntry users, without requiring the user to type it in 
  7813. the logon dialog. Then this is the place to put the code. 
  7814.  
  7815. Note however that any translation you do here is only used at signon time, and 
  7816. that the administration tools should use the 'real' defined names. 
  7817.  
  7818.  
  7819. ΓòÉΓòÉΓòÉ 9.4. Adding your own components ΓòÉΓòÉΓòÉ
  7820.  
  7821. The same way that SecureEntry provides with some default components (i.e, 
  7822. Launchpad, Treelock, ...), you can add to the SecureEntry database a given 
  7823. component of your own, and assign it to a user or group through the SecureEntry 
  7824. administration tools. 
  7825.  
  7826.      What is a Security component 
  7827.  
  7828.      The components description file and UPDATEDB command 
  7829.  
  7830.      IMPORTANT WARNINGS 
  7831.  
  7832.  
  7833. ΓòÉΓòÉΓòÉ 9.4.1. What is a Security component ΓòÉΓòÉΓòÉ
  7834.  
  7835. A security component is really an object (file) with some behavior expected and 
  7836. associated characteristics : 
  7837.  
  7838.    1. A component should have a component name. This one is evident. 
  7839.  
  7840.    2. A component has a download file name. This is the file name of a given 
  7841.       instance of security profile for the component which will be used at 
  7842.       signon time to activate it. 
  7843.  
  7844.    3. A component has an editor. This is the name and calling parameters of the 
  7845.       program which is able to recognize and allow editing for a given profile 
  7846.       of this component. 
  7847.  
  7848.    4. A component has an activation interface. Again, the this is the name and 
  7849.       calling parameters of an executable module which is able to read a 
  7850.       profile and set up the security restrictions for it within a given 
  7851.       machine. 
  7852.  
  7853.    5. A component has also an icon which represents it, and 
  7854.  
  7855.    6. It has also some rules, i.e if it is static (the profiles only vary 
  7856.       through an administrator tool), or if must be uploaded to the database 
  7857.       after logoff, plus whether it is mandatory to have a given profile 
  7858.       assigned in order to be able to logon to the workstation. 
  7859.  
  7860.  
  7861. ΓòÉΓòÉΓòÉ 9.4.2. The components description file and UPDATEDB command ΓòÉΓòÉΓòÉ
  7862.  
  7863. All of the components description characteristics are stored within the 
  7864. SecureEntry repository as a file which you can change or view through the 
  7865. UPDATEDB command. This command will normally take a description file in ASCII 
  7866. format and upload it to the repository, making it the active one (for the next 
  7867. machine reboot). The invocation syntax is : 
  7868.  
  7869.  
  7870.    UPDATEDB  descriptionfilename
  7871.  
  7872. If no descriptionfilename is used, the utility will just list the active 
  7873. component table contents (stored within the repository). 
  7874.  
  7875. Note that the description file used at SecureEntry install time is named 
  7876. 'SENTRY.DSC', and you can find it within the first installation diskette. This 
  7877. file can serve you as a sample on how new components can be defined. 
  7878.  
  7879. A sample of the description file follows : 
  7880.  
  7881. [General]
  7882.  
  7883. MaxSignonAttempts   5       # Beware if you have only one administrator defined
  7884. MinPasswordLen      4
  7885. PasswordExpireDays  0       # 0 means do not expire passwords
  7886.  
  7887. [Components]
  7888.  
  7889. #CompName       DownloadName  Editor            Interface          Datatype Icon  Mand Chg Description
  7890. #------------------------------------------------------------------------------------------------------------------
  7891. DESKTOP         EDYDESK.INI   'EDYEDRES.EXE &'  $SENTRY            MISSING  @3003   N   A  Personal desktop profile
  7892. PERS_DESKTOP    EDY_PER.INI   MISSING           $SENTRY            MISSING  MISSING N   U  Personal desktop settings
  7893. SYSTEM_MENUS    EDYWIN.INI    'EDYWINE.EXE &'   'EDYWINR.EXE /F:&' MISSING  @3006   N   A  Window behavior
  7894. FLOPPY_DISK     EDYFLOPP.INI  'EDYFLINI.EXE /&' 'EDYFLPY.EXE /I:&' MISSING  @3005   N   A  Floppy disk behavior
  7895. TREE_LOCK       EDYDD32.INI   'E.EXE &'         'EDYDDUTL.EXE /F&' MISSING  MISSING N   A
  7896. SES_BEHAVIOUR   EDYSES.INI    'EDYSESE.EXE &'   'EDYBGINI.EXE /F&' MISSING  @3007   N   A  Lockup, timeouts and CAD
  7897. TLOCK_AUDIT     EDYDD32.AUD   'E.EXE &'         'EDYDDUTL.EXE /A&' MISSING  MISSING N   U  Tree Lock audit
  7898. LAUNCHPAD       EDYPAD.INI '/I EDYLNEDT.EXE /F&''EDYLNREF.EXE /F&' MISSING  @3004   N   A  Personal launchpad
  7899. SCENTER         EDYSC.INI  '/I EDYSCEDT.EXE &'  'EDYSCTST.EXE &'   MISSING  @3017   N   A  SmartCenter profile
  7900. WINDOW_LIST     EDYWDLST.INI   'EDYWDEDT.EXE &' 'EDYWDINI.EXE /F&' MISSING  @3011   N   A  WindowList behaviour
  7901. PERS_MODEL      EDYMPER.INI    'EDYEDPER.EXE &' $SENTRY            MISSING  @3013   N   A  Personal desktop model
  7902. SHORTCUTS       EDYHOTK.INI    'EDYHOTKE.EXE &' 'EDYHOTKR.EXE /F &'MISSING  @3014   N   A  Shortcuts profile
  7903. HOOKED_OBJECTS  EDYCUSWP.INI 'EDYEDPER.EXE /P &'$SENTRY            MISSING  @3016   N   A  Hooked objects
  7904. ROAMING_DESKTOP EDYROAM.INI    'EDYROAME.EXE &' 'EDYROAMT.EXE /F&' MISSING  @3018   N   A  Roaming desktops
  7905. EXECS_AUDITOR   EDYEXEC.INI    'EDYEXECE.EXE &' 'EDYEXECT.EXE /F&' MISSING  @3019   N   U  Processes auditor
  7906.  
  7907. It becomes evident by studying this file how the new components have to be 
  7908. added. Take into account the following : 
  7909.  
  7910.      The [General] section, even if present, will have only sense for 
  7911.       standalone environment installations, because this values will be 
  7912.       overridden by Lan Server in Lan Server installs. 
  7913.  
  7914.      Any line can have comments, which start by the '#' character 
  7915.  
  7916.      The reserved keyword 'MISSING' allows you to define component 
  7917.       characteristics as not available. 
  7918.  
  7919.      The component name will be used by the administration utilities to 
  7920.       identify new components through its API. i.e, once you define your 
  7921.       component with a special name, this name becomes the index keyword to 
  7922.       locate its profiles. It also becomes automatically a new keyword for the 
  7923.       batch administration tools. 
  7924.  
  7925.      The DownloadName will be used as the name with which the profile will be 
  7926.       downloaded within the workstation at logon time, within the SecureEntry 
  7927.       directory path, WORK subdirectory. 
  7928.  
  7929.      The editor must be any executable program which 'Understands' your 
  7930.       profiles and knows how to save them with the same name as when invoked. 
  7931.       (i.e, you can use the system editor for ASCII profiles). The launch 
  7932.       string, as placed in the description file describes how to invoke it 
  7933.       (substituting '&' by the full path of the profile component file). 
  7934.  
  7935.      The interface must be any executable program that knows how to 'activate' 
  7936.       a given profile with the configured startup string (substituting '&' by 
  7937.       the full path of the profile component file). Note however, that 
  7938.       SecureEntry will launch this startup string at logoff time without a 
  7939.       filename, and it is the responsibility of the interface program to 
  7940.       deactivate then the previously activated profile. The reserved keyword 
  7941.       '$SENTRY' is reserved by SecureEntry. 
  7942.  
  7943.      Datatype is not used by SecureEntry right now. 
  7944.  
  7945.      Iconfile is the icon filename of an icon that represents the component. 
  7946.       Note that you should place here the full path for the icon. What is in 
  7947.       the default sample file (keywords start by '@') is a convention so that 
  7948.       these are icons already linked with the administration (EDYSNADM) 
  7949.       application. 
  7950.  
  7951.      The 'Mand' field indicates whether the component is mandatory for logon 
  7952.       or not. It can only take the values 'Y' or 'N'. 
  7953.  
  7954.      The 'Chng' field indicates whether it is a component profile which the 
  7955.       user can change or the administrator. Values are 'A' (Admin) or 'U' 
  7956.       (User). If a component is defined as user modifiable, then it will be 
  7957.       uploaded at logoff time to the LAN repository, or to the host if UCM is 
  7958.       present, so that at the next logon (from this or another machine), the 
  7959.       refreshed profile is downloaded. 
  7960.  
  7961.      Description is a free format description string for the component. 
  7962.  
  7963.      No two components can have the same component name or downloadname. 
  7964.  
  7965.  
  7966. ΓòÉΓòÉΓòÉ 9.4.3. IMPORTANT WARNINGS ΓòÉΓòÉΓòÉ
  7967.  
  7968. When designing for adding new components, take care of : 
  7969.  
  7970.      The UPDATEDB program will overwrite completely the active components 
  7971.       description table. It is your responsibility to make sure that you do not 
  7972.       delete components which have active profiles stored in the repository. 
  7973.  
  7974.      The component profiles may have a 'signature' added by the interactive 
  7975.       administration tool. This signature is : 
  7976.  
  7977.         -  For text files, a first line added to the file with the 
  7978.            ComponentName. 
  7979.  
  7980.         -  For INI (prf format) files, a new tuple Application=SENTRY, 
  7981.            Key=COMPONENT, Value=Componentname. 
  7982.  
  7983.       This signature is added only by this tool to allow for drag and drop 
  7984.       without being always prompting about which component is being dropped. 
  7985.       Note that to avoid this behavior, you can always uncheck the 'save 
  7986.       component association checkbox' whenever dropping a component profile and 
  7987.       being prompted for its association within the interactive administration 
  7988.       tool. 
  7989.  
  7990.      Be careful when applying SERVICE to machines with customer defined 
  7991.       components. Before using the diskettes, copy your components description 
  7992.       file to an INSTALL directory within the last installation diskette, with 
  7993.       file name 'SENTRY.DSC', so that the service procedure uses this one 
  7994.       instead of the default one to update the database. 
  7995.  
  7996.  
  7997. ΓòÉΓòÉΓòÉ 9.5. Programming logon procedures ΓòÉΓòÉΓòÉ
  7998.  
  7999. A logon procedure is basically a DLL with a couple of standard entry points 
  8000. which you can add to a SecureEntry installation, providing for password 
  8001. synchronization and the basic identification functions. The idea is that in 
  8002. order to make SecureEntry logon to your own subsystems in a fully integrated 
  8003. way, you just have to write this quite simple code. 
  8004.  
  8005.      Writing and running your own LMP 
  8006.  
  8007.      API entry points 
  8008.  
  8009.      Rules to follow 
  8010.  
  8011.  
  8012. ΓòÉΓòÉΓòÉ 9.5.1. Writing and running your own LMP ΓòÉΓòÉΓòÉ
  8013.  
  8014. Within the SecureEntryPath\API\SOURCES\LMP directory, you have a skeleton of a 
  8015. logon procedure in order to do signon to your own subsystems. 
  8016.  
  8017. Once that file is coded, compile it and generate a DLL named EDYxxLMP.DLL (do 
  8018. not forget to change the DEF file reflecting this archive name change), where 
  8019. xx are your sybsystem identifier letters, then place the code in the DLL 
  8020. directory, and modify the file SecureEntryPath\NOUSER\EDYSSLMP.DAT, so that it 
  8021. calls your DLL at signon time. Refer to Configuration files, where this 
  8022. configuration file is described. 
  8023.  
  8024.  
  8025. ΓòÉΓòÉΓòÉ 9.5.2. API entry points ΓòÉΓòÉΓòÉ
  8026.  
  8027. Follows a description of the entry points available for LMPs. 
  8028.  
  8029.      EdySignOn 
  8030.  
  8031.       In this function you are supposed to do the signon to your subsystem, 
  8032.       activating any subsystem specific resource configured to be accessible at 
  8033.       signon time (i.e, logon assignments for Lan Server), and take note of the 
  8034.       userid, password and domain (if required) of the signed on user for 
  8035.       further requests. Note that replying OK to this function implies that you 
  8036.       validate and grant access to the passed on user with the passed on 
  8037.       password. SecureEntry will not call you to do a second signon while a 
  8038.       user is already in signon state. (The sign-off API will be called first). 
  8039.  
  8040.       This API is called in your order of appearance within the EDYSSLMP.DAT 
  8041.       configuration file, with respect to other LMPs. 
  8042.  
  8043.      EdySignOff 
  8044.  
  8045.       In this function you have to issue a subsystem sign-off, reset your 
  8046.       variables and take note that from now on your subsystem is in a signed 
  8047.       off state. 
  8048.  
  8049.      EdyForcePassword 
  8050.  
  8051.       This API will only be called if you are being synchronized by other LMP, 
  8052.       i.e, RACF or similar. It means that you have to force the password for 
  8053.       the passed userid to the newly provided one. Note that if you use the 
  8054.       supplied skeleton, it has implemented a security mechanism by which only 
  8055.       SecureEntry in a safe state (id granted) can call this API. 
  8056.  
  8057.      EdyQueryUserid 
  8058.  
  8059.       Within this API you are requested to reply the signon parameters as they 
  8060.       were passed to you, in order to know who is signed on for your subsystem. 
  8061.  
  8062.      EdyPwSyntaxValidation 
  8063.  
  8064.       In this entry point you are supposed to verify the syntax of a given 
  8065.       password, that is, if the password would be accepted as valid for a user 
  8066.       in a change password operation for your subsystem. 
  8067.  
  8068.      EdyIdSyntaxValidation 
  8069.  
  8070.       In this entry point you are supposed to verify the syntax of a given 
  8071.       userid, that is, if the userid would be accepted as valid for a user in a 
  8072.       change password operation for your subsystem. 
  8073.  
  8074.      EdyUserPwValidation 
  8075.  
  8076.       This API will be used by SecureEntry to verify the userid and password of 
  8077.       a given user without issuing a real signon, just replying if the tuple is 
  8078.       valid for your subsystem. This API may be called to you by SecureEntry in 
  8079.       the name of end user applications. 
  8080.  
  8081.  
  8082. ΓòÉΓòÉΓòÉ 9.5.3. Rules to follow ΓòÉΓòÉΓòÉ
  8083.  
  8084. When writing LMPs, take note of the following : 
  8085.  
  8086.      All of the entry points are mandatory, except the force password one. 
  8087.       This one is only used if your DLL is synchronized by another one. If 
  8088.       yours is the synchronizer, you can leave this entry point empty since it 
  8089.       will never be called. 
  8090.  
  8091.      Use the skeleton file EDYxxLMP.C. It provides with security measures by 
  8092.       which only SecureEntry in a granted state can call the 'potentially 
  8093.       risky' APIs. 
  8094.  
  8095.      Do not change the input parameters you are passed with by reference. 
  8096.  
  8097.      Always return with errors that are defined in the EDYERROR.TXT, or fill 
  8098.       up the error string if providing new errors. 
  8099.  
  8100.      Do not store pointers to passed parameter across calls. I.e, the buffer 
  8101.       you are passed with the userid may not be valid after you have replied to 
  8102.       the signon call. 
  8103.  
  8104.  
  8105. ΓòÉΓòÉΓòÉ 9.6. Programming your own administration tools ΓòÉΓòÉΓòÉ
  8106.  
  8107. There are currently three different levels of administration equivalent API's 
  8108. to do your own development : 
  8109.  
  8110.      The Command line API (EDYADMIN program) 
  8111.  
  8112.      The REXX API 
  8113.  
  8114.      The 'C' API 
  8115.  
  8116.  All of these interfaces deal with the same objects, and you may wish to use 
  8117.  the appropriate one depending on your coding experience and requirements. 
  8118.  
  8119.  As an introduction to the API, and at a generic level, there are four main 
  8120.  functions (add, delete, update and view) defined over a set of 7 different 
  8121.  object types : 
  8122.  
  8123.      User object which stores the characteristics (keywords) of a given user. 
  8124.       These are the user logon data and security profiles. 
  8125.  
  8126.      Group object which stores the characteristics (keywords) of a given 
  8127.       group. This are the group logon data and security profiles. 
  8128.  
  8129.      Resource object which stores the characteristics of a given resource. 
  8130.       This one is only used under LAN SERVER environments, and refers to 
  8131.       shareable resources with associated ALIAS names. 
  8132.  
  8133.      UserGroup object which stores a ownership relation between a user and a 
  8134.       group, and has no other attributes. 
  8135.  
  8136.      GroupGroup object which stores a ownership relation between a group and 
  8137.       another group, and has no other attributes. This object type is only used 
  8138.       in standalone environments, where you can define one group as belonging 
  8139.       to another one. 
  8140.  
  8141.      ResourceUser object which stores a 'uses' relation between a resource and 
  8142.       a user. The associated keywords for this relation are the logon 
  8143.       assignment and sharing mode. 
  8144.  
  8145.      ResourceGroup object which stores a 'uses' relation between a resource 
  8146.       and a user. The associated keywords for this relation are the logon 
  8147.       assignment and sharing mode. 
  8148.  
  8149.  So, for instance, if you wanted to add a new user to the database, you should 
  8150.  do : 
  8151.  
  8152.    1. Execute a User object ADD call passing the necessary keywords to describe 
  8153.       the security profiles and user data (LAN_DATA). The user data keyword 
  8154.       describes characteristics such as user logon hours, description, 
  8155.       password,... 
  8156.  
  8157.    2. Execute a UserGroup object ADD call to make the user part of all 
  8158.       necessary groups (one call for each desired group relationship). 
  8159.  
  8160.    3. Execute a ResourceUser object ADD call to make the user use the required 
  8161.       resources (one call for each desired resource relationship). 
  8162.  
  8163.  
  8164. ΓòÉΓòÉΓòÉ 9.6.1. The EDYADMIN utility ΓòÉΓòÉΓòÉ
  8165.  
  8166. This utility, located in the SecureEntryPath, EXEC directory can be used to 
  8167. call the API from batch files without any restriction, allowing full usage of 
  8168. the administration API. 
  8169.  
  8170. The syntax for this command is : 
  8171.  
  8172.  
  8173.   EDYADMIN [S=subsystem] Command Objecttype=objectid[,objectid2] [keyword]
  8174.  
  8175.  Subsystem Name of the agent to process it. You will normally not use this 
  8176.            option if working with the default SecureEntry subsystem (this 
  8177.            option is intended for developing of customer SecureEntry subsystem 
  8178.            agents). 
  8179.  
  8180.  Command   A valid command name. These are : 
  8181.  
  8182.                Add 
  8183.  
  8184.                Delete 
  8185.  
  8186.                Update 
  8187.  
  8188.                View 
  8189.  
  8190.  Objecttype A valid object type name. These are : 
  8191.  
  8192.                Group 
  8193.  
  8194.                GROUPGroup 
  8195.  
  8196.                Resource 
  8197.  
  8198.                RESOURCEGroup 
  8199.  
  8200.                RESOURCEUser 
  8201.  
  8202.                Subsystem 
  8203.  
  8204.                User 
  8205.  
  8206.                USERGroup 
  8207.  
  8208.  Objectid[,objectid2] Valid object(s) name. Place them separated by a comma for 
  8209.            object types that deal with more than one object id. 
  8210.  
  8211.  Keyword   Valid keywords string list (separated by commas). For instance, 
  8212.  
  8213.                           LAUNCHPAD=@myfile1,LAN_DATA=DESCRIPTION=A user
  8214.  
  8215.            Note that the keyword id is always the name to the left of the first 
  8216.            equal sign per each keyword string. You can indirect a value by 
  8217.            using the @ sign. 
  8218.  
  8219.  Usage Samples : 
  8220.  
  8221.     EDYADMIN A U=JOHN
  8222.                        Adds user John with default values
  8223.     EDYADMIN A USERG=JOHN,TELLERS
  8224.                        Adds link of user John to TELLERS group
  8225.     EDYADMIN U U=JOHN DESKTOP=@EDYDESK.INI
  8226.                        Updates Johns desktop with file
  8227.     EDYADMIN U U=JOHN LAN_DATA=FULL_NAME=John Smith DESCRIPTION=A teller
  8228.                        Updates Johns name
  8229.     EDYADMIN V USERG=*,*
  8230.                        View all userids belonging to any group
  8231.     EDYADMIN V USERG=*,TELLERS
  8232.                        View all userids belonging to group TELLERS
  8233.     EDYADMIN V USERG=*,
  8234.                        View all users not belonging to any group
  8235.  
  8236.  
  8237. ΓòÉΓòÉΓòÉ 9.6.2. The REXX API ΓòÉΓòÉΓòÉ
  8238.  
  8239. The SecureEntry REXX API is built into the rexx dll named RXUCM. The batch 
  8240. administration tools are good samples of its usage, namely EDYERASE.CMD, 
  8241. EDYADMIN.CMD and EDYDEFS.CMD. Follow the description of the provided API 
  8242. functions : 
  8243.  
  8244.      RxEdyUcmLoadFuncs 
  8245.  
  8246.       This function is used to load the rest of the API, as in the following 
  8247.       sample: 
  8248.  
  8249.  
  8250.                If RxFuncQuery('RxEdyUcmLoadFuncs') Then
  8251.                do
  8252.                  call RxFuncAdd 'RxEdyUcmLoadFuncs', 'RXUCM', 'RxEdyUcmLoadFuncs'
  8253.                  call RxEdyUcmLoadFuncs
  8254.                end
  8255.  
  8256.      RxEdyUcmDropFuncs 
  8257.  
  8258.       This function is used to unload the API functions, as in the following 
  8259.       sample: 
  8260.  
  8261.  
  8262.                call RxEdyUcmDropFuncs
  8263.  
  8264.      RxEdyUcmGetError 
  8265.  
  8266.       This function returns a descriptive error message concerning the last 
  8267.       issued API function which ended up in error, as in the following sample : 
  8268.  
  8269.  
  8270.                say RxEdyUcmGetError()
  8271.  
  8272.       Note that the reported error has always the format : 
  8273.  
  8274.  
  8275.               ERROR:errorcode SEVERITY:severity TYPE:type MESSAGE:message
  8276.  
  8277.       Where: 
  8278.  
  8279.       errorcode      Numeric error code 
  8280.  
  8281.       severity       Severity level for the error. 
  8282.  
  8283.                      The following convention is used by the different 
  8284.                      SecureEntry components : 
  8285.  
  8286.                        -  'E' for error 
  8287.  
  8288.                        -  'W' for warning 
  8289.  
  8290.                        -  'I' for informative 
  8291.  
  8292.       type           Type of error. 
  8293.  
  8294.                      This intends to help locate the component which generated 
  8295.                      the error. It is a four char string, where the convention 
  8296.                      used has been that the first two represent the component 
  8297.                      who posted the error, and the second two represent the 
  8298.                      subcomponent. As a sample : 
  8299.  
  8300.                        -  UCSQ Means that the UCM agent encountered a DB2 SQL 
  8301.                           error. 
  8302.  
  8303.                        -  LSER Means that the Lan Server agent encountered a 
  8304.                           Lan Server API error. 
  8305.  
  8306.                        -  SESR Means that the SecureEntry agent gave an error 
  8307.                           posted by the registry component. 
  8308.  
  8309.                        -  RXUC Means that the error was produced within the 
  8310.                           RXUCM DLL itself. 
  8311.  
  8312.       message        Descriptive message for the error. 
  8313.  
  8314.       Note that the components are not to follow this conventions mandatory, 
  8315.       but just advisory. Note also that not all of the functions will always 
  8316.       return errors that can be retrieved through this function, but just the 
  8317.       indicated ones. 
  8318.  
  8319.      RxEdyUcm_AddObj 
  8320.  
  8321.       This function adds a new object to the repository. The correct invocation 
  8322.       parameters are shown by the following syntax diagram : 
  8323.  
  8324.  
  8325.                rc=RxEdyUcm_AddObj(subsystem,objecttype,objectname1,objectname2,'keysstem')
  8326.  
  8327.       Where: 
  8328.  
  8329.       subsystem      is the subsystem identification for the agent to process 
  8330.                      the call. 
  8331.  
  8332.                      Normally you should use always 'SENT' for SecureEntry 
  8333.                      administration. 
  8334.  
  8335.       objecttype     Is the object type for the function. 
  8336.  
  8337.                      Valid object types are : 
  8338.  
  8339.                        -  'GROUP' 
  8340.  
  8341.                        -  'GROUPGROUP' 
  8342.  
  8343.                        -  'RESOURCE' 
  8344.  
  8345.                        -  'RESOURCEGROUP' 
  8346.  
  8347.                        -  'RESOURCEUSER' 
  8348.  
  8349.                        -  'SUBSYSTEM' 
  8350.  
  8351.                        -  'USER' 
  8352.  
  8353.                        -  'USERGROUP' 
  8354.  
  8355.       objectname1 and objectname2 These are the id(s) for the object to be 
  8356.                      processed. Use the second one for complex objects which 
  8357.                      require two id's. If this field is not needed, a blank 
  8358.                      string ('') must be placed. 
  8359.  
  8360.       keysstem       This is the name of a REXX stem where the keywords and 
  8361.                      associated values for the object are stored, following 
  8362.                      regular REXX standards, i.e the 0th element contains the 
  8363.                      number of elements, and the rest are of the form 
  8364.                      'keyname=keyvalue'. 
  8365.  
  8366.       This function will return : 
  8367.  
  8368.         -  'OK' for correct operation 
  8369.  
  8370.         -  'WARNING' for warning return code 
  8371.  
  8372.         -  'ERROR' for error/not completed operation 
  8373.  
  8374.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8375.       can be used to retrieve further information about it. 
  8376.  
  8377.      RxEdyUcm_UpdateObj 
  8378.  
  8379.       This function updates an existing object in the repository. the correct 
  8380.       invocation parameters are shown by the following syntax diagram : 
  8381.  
  8382.  
  8383.                rc=RxEdyUcm_UpdateObj(subsystem,objecttype,objectname1,objectname2,'keysstem')
  8384.  
  8385.       Where: 
  8386.  
  8387.       subsystem      is the subsystem identification for the agent to process 
  8388.                      the call. 
  8389.  
  8390.                      Normally you should use always 'SENT' for SecureEntry 
  8391.                      administration. 
  8392.  
  8393.       objecttype     Is the object type for the function. Valid object types 
  8394.                      are : 
  8395.  
  8396.                        -  'GROUP' 
  8397.  
  8398.                        -  'GROUPGROUP' 
  8399.  
  8400.                        -  'RESOURCE' 
  8401.  
  8402.                        -  'RESOURCEGROUP' 
  8403.  
  8404.                        -  'RESOURCEUSER' 
  8405.  
  8406.                        -  'SUBSYSTEM' 
  8407.  
  8408.                        -  'USER' 
  8409.  
  8410.                        -  'USERGROUP' 
  8411.  
  8412.       objectname1 and objectname2 These are the id(s) for the object to be 
  8413.                      processed. Use the second one for complex objects which 
  8414.                      require two id's. If this field is not needed, a blank 
  8415.                      string ('') must be placed. 
  8416.  
  8417.       keysstem       This is the name of a REXX stem where the keywords and 
  8418.                      associated values for the object are stored, following 
  8419.                      regular REXX standards, i.e the 0th element contains the 
  8420.                      number of elements, and the rest are of the form 
  8421.                      'keyname=keyvalue'. 
  8422.  
  8423.       This function will return : 
  8424.  
  8425.         -  'OK' for correct operation 
  8426.  
  8427.         -  'WARNING' for warning return code 
  8428.  
  8429.         -  'ERROR' for error/not completed operation 
  8430.  
  8431.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8432.       can be used to retrieve further information about it. 
  8433.  
  8434.      RxEdyUcm_ViewObj 
  8435.  
  8436.       This function retrieves an existing object from the repository. the 
  8437.       correct invocation parameters are shown by the following syntax diagram : 
  8438.  
  8439.  
  8440.                keysstem.0=0
  8441.                rc=RxEdyUcm_ViewObj(subsystem,objecttype,objectname1,objectname2,'keysstem')
  8442.  
  8443.       Where: 
  8444.  
  8445.       subsystem      is the subsystem identification for the agent to process 
  8446.                      the call. Normally you should use always 'SENT' for 
  8447.                      SecureEntry administration. 
  8448.  
  8449.       objecttype     Is the object type for the function. Valid object types 
  8450.                      are : 
  8451.  
  8452.                        -  'GROUP' 
  8453.  
  8454.                        -  'GROUPGROUP' 
  8455.  
  8456.                        -  'RESOURCE' 
  8457.  
  8458.                        -  'RESOURCEGROUP' 
  8459.  
  8460.                        -  'RESOURCEUSER' 
  8461.  
  8462.                        -  'SUBSYSTEM' 
  8463.  
  8464.                        -  'USER' 
  8465.  
  8466.                        -  'USERGROUP' 
  8467.  
  8468.       objectname1 and objectname2 These are the id(s) for the object to be 
  8469.                      processed. Use the second one for complex objects which 
  8470.                      require two id's. If this field is not needed, a blank 
  8471.                      string ('') must be placed. 
  8472.  
  8473.       keysstem       This is the name of a REXX stem where the returned 
  8474.                      keywords and associated values for the object will be 
  8475.                      stored, following regular REXX standards, i.e the 0th 
  8476.                      element will contain the number of elements, and the rest 
  8477.                      are of the form 'keyname=keyvalue'. 
  8478.  
  8479.                      Note that the 0'th element of the stem is initialized to 
  8480.                      0, indicating that we request for all information about 
  8481.                      the object. Some agents will accept and serve requests 
  8482.                      taking keywordstem as an input parameter also for 
  8483.                      retrieving specific keywords values. This is why you are 
  8484.                      encouraged not to forget this initialization in order to 
  8485.                      avoid erratic program behavior. 
  8486.  
  8487.       This function will return : 
  8488.  
  8489.         -  'OK' for correct operation 
  8490.  
  8491.         -  'WARNING' for warning return code 
  8492.  
  8493.         -  'ERROR' for error/not completed operation 
  8494.  
  8495.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8496.       can be used to retrieve further information about it. 
  8497.  
  8498.      RxEdyUcm_DeleteObj 
  8499.  
  8500.       This function deletes an existing object from the repository. the correct 
  8501.       invocation parameters are shown by the following syntax diagram : 
  8502.  
  8503.  
  8504.                rc=RxEdyUcm_DeleteObj(subsystem,objecttype,objectname1,objectname2,'keysstem')
  8505.  
  8506.       Where: 
  8507.  
  8508.       subsystem      is the subsystem identification for the agent to process 
  8509.                      the call. Normally you should use always 'SENT' for 
  8510.                      SecureEntry administration. 
  8511.  
  8512.       objecttype     Is the object type for the function. Valid object types 
  8513.                      are : 
  8514.  
  8515.                        -  'GROUP' 
  8516.  
  8517.                        -  'GROUPGROUP' 
  8518.  
  8519.                        -  'RESOURCE' 
  8520.  
  8521.                        -  'RESOURCEGROUP' 
  8522.  
  8523.                        -  'RESOURCEUSER' 
  8524.  
  8525.                        -  'SUBSYSTEM' 
  8526.  
  8527.                        -  'USER' 
  8528.  
  8529.                        -  'USERGROUP' 
  8530.  
  8531.       objectname1 and objectname2 These are the id(s) for the object to be 
  8532.                      processed. Use the second one for complex objects which 
  8533.                      require two id's. If this field is not needed, a blank 
  8534.                      string ('') must be placed. 
  8535.  
  8536.       keysstem       This is the name of a REXX stem where the keywords and 
  8537.                      associated values for the object are stored, following 
  8538.                      regular REXX standards, i.e the 0th element contains the 
  8539.                      number of elements, and the rest are of the form 
  8540.                      'keyname=keyvalue'. It is taken as an input parameter for 
  8541.                      selectively deleting only some keywords, and not the full 
  8542.                      object. This is why, when desiring to delete the complete 
  8543.                      object, you should set this parameter to the void string 
  8544.                      (''). 
  8545.  
  8546.       This function will return : 
  8547.  
  8548.         -  'OK' for correct operation 
  8549.  
  8550.         -  'WARNING' for warning return code 
  8551.  
  8552.         -  'ERROR' for error/not completed operation 
  8553.  
  8554.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8555.       can be used to retrieve further information about it. 
  8556.  
  8557.      RxEdyUcm_SetAgent 
  8558.  
  8559.       This function can be used when developing specific agents for the API, in 
  8560.       order to tell the Rexx API to redirect all requests directly to the 
  8561.       agent, and do not go through the 'selector' agent. This way you can test 
  8562.       in a non SecureEntry environment before the integration phase. The 
  8563.       invocation command is : 
  8564.  
  8565.  
  8566.                rc=RxEdyUcm_SetAgent(agentid)
  8567.  
  8568.       Where agentid is the two character string that identifies the agent DLL, 
  8569.       which will have to be called : EDYxxAGT.DLL. 
  8570.  
  8571.       This function will return : 
  8572.  
  8573.         -  'OK' for correct operation 
  8574.  
  8575.         -  'ERROR' for error/not completed operation 
  8576.  
  8577.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8578.       can be used to retrieve further information about it. 
  8579.  
  8580.      RxEdyUcm_QueryUsersDB 
  8581.  
  8582.       This function allows you to query the location of the local users 
  8583.       database. Takes no parameters and will return the component ID for the 
  8584.       database. The invocation sample is : 
  8585.  
  8586.  
  8587.                locdb=RxEdyUcm_QueryUsersDB()
  8588.  
  8589.       The return values can be: 
  8590.  
  8591.         -  'SR' For SecureEntry registry 
  8592.  
  8593.         -  'LS' For Lan server UPM 
  8594.  
  8595.         -  'ERROR' If any error. Use then the RxEdyUcmGetError function to 
  8596.            obtain further information if required. 
  8597.  
  8598.      RxEdyUcm_Enable_Remote 
  8599.  
  8600.       This function will enable/disable remote access of the rest of the API 
  8601.       when UCM is present, independent of the SGM_UCM_ENABLE environment 
  8602.       variable setting and only valid for the current process. It takes one 
  8603.       argument which can be 0 or 1. As a sample : 
  8604.  
  8605.  
  8606.                rc=RxEdyUcm_Enable_Remote(0)
  8607.  
  8608.       This function will return : 
  8609.  
  8610.         -  'OK' for correct operation 
  8611.  
  8612.         -  'ERROR' for error/not completed operation 
  8613.  
  8614.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8615.       can be used to retrieve further information about it. 
  8616.  
  8617.      RxEdyUcm_Connect 
  8618.  
  8619.       Use this function to inform the administration subsystem that you are to 
  8620.       start working with the API, and issue the required DB2 connect whenever 
  8621.       host access is required. 
  8622.  
  8623.       The sample invocation code looks like : 
  8624.  
  8625.  
  8626.                rc=RxEdyUcm_Connect()
  8627.  
  8628.       This function will return : 
  8629.  
  8630.         -  'OK' for correct operation 
  8631.  
  8632.         -  'ERROR' for error/not completed operation 
  8633.  
  8634.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8635.       can be used to retrieve further information about it. 
  8636.  
  8637.      RxEdyUcm_Disconn 
  8638.  
  8639.       Use this function to inform the administration subsystem that you have 
  8640.       ended working with the API, and issue the required DB2 disconnect if host 
  8641.       access was issued. 
  8642.  
  8643.       The sample invocation code looks like : 
  8644.  
  8645.  
  8646.                rc=RxEdyUcm_Disconn()
  8647.  
  8648.       This function will return : 
  8649.  
  8650.         -  'OK' for correct operation 
  8651.  
  8652.         -  'ERROR' for error/not completed operation 
  8653.  
  8654.       If you receive an error or a warning, then the RxEdyUcmGetError function 
  8655.       can be used to retrieve further information about it. 
  8656.  
  8657.      RxEdyUcm_GetUser 
  8658.  
  8659.       Use this function to obtain information about the currently logged on 
  8660.       user. It will not normally return an error, and the invocation code is : 
  8661.  
  8662.  
  8663.                userinfo=RxEdyUcm_GetUser()
  8664.  
  8665.       The returned string can easily be parsed since it is of the form : 
  8666.  
  8667.  
  8668.                USER:username GROUP:groupname DOMAIN:domainname COMPUTER:computername ADMIN:x
  8669.  
  8670.       Where x can be 0 or 1. 
  8671.  
  8672.  
  8673. ΓòÉΓòÉΓòÉ 9.6.3. The 'C' API ΓòÉΓòÉΓòÉ
  8674.  
  8675. A mapping of the same API explained as the REXX API exists for 'C' programs. 
  8676. You can find the related include and library files within the SecureEntryPath, 
  8677. API\SOURCES\EDYUCM path, as well as a commented sample program to list the 
  8678. first level defined groups. What follows is a description of the API and 
  8679. differences with the already discussed, REXX API: 
  8680.  
  8681. The following functions are available, and predefined in the EDYSLAGT.H file : 
  8682.  
  8683.      EdyUcm_Enable_Remote 
  8684.  
  8685.       This function is only useful when you grant access to the local database, 
  8686.       even if users centralized management (UCM) is installed. The idea is to 
  8687.       do the following : 
  8688.  
  8689.                       ...
  8690.                       Centralized processing calls
  8691.                       ...
  8692.                       EdyUcm_Enable_Remote(0)
  8693.                         ...
  8694.                         Local administration calls
  8695.                         ...
  8696.                       EdyUcm_Enable_Remote(1)
  8697.                       ...
  8698.                       Centralized processing calls
  8699.                       ...
  8700.  
  8701.       So, the real function of this API is to inform the administration 
  8702.       subsystem when the administration functions have to be redirected against 
  8703.       the local database instead of the host DB2 UCM database. Note that the 
  8704.       parameter sets a boolean flag, not a recursive counter. 
  8705.  
  8706.      EdyUcm_Connect 
  8707.  
  8708.       This function call is only mandatory when using the UCM centralized 
  8709.       management option. Its mission is to do the DBM connect to the database, 
  8710.       and takes no parameters. In the event that your code requires this call, 
  8711.       it must be the first call before any other API call. 
  8712.  
  8713.      EdyUcm_Disconn 
  8714.  
  8715.       This is the opposite to the previous call. Only mandatory if UCM is in 
  8716.       use, must then be the last call to the administration API before your 
  8717.       program terminates. Takes one parameter of type long, that is only used 
  8718.       when UCM is available, and indicates whether to commit or rollback the 
  8719.       changes made before disconnecting. (set to 0 for commit, 1 for rollback). 
  8720.       Note that at this point and since most UCM API calls are atomic, it does 
  8721.       not really matter what parameter you code for this function, but it we 
  8722.       suggest you to code commit or rollback appropriately just in case 
  8723.       SecureEntry/2 in the future provides for transactional integrity across 
  8724.       calls. 
  8725.  
  8726.      EdyUcm_AddObj 
  8727.  
  8728.       This function, like its REXX counterpart, can be used to add objects of a 
  8729.       given type to the repository. See Common parameters definition 
  8730.  
  8731.      EdyUcm_DeleteObj 
  8732.  
  8733.       This function, like its REXX counterpart, is used to delete objects of a 
  8734.       given type to the repository, or specific keywords. See Common parameters 
  8735.       definition 
  8736.  
  8737.      EdyUcm_UpdateObj 
  8738.  
  8739.       This function, like its REXX counterpart, can be used to modify, add or 
  8740.       delete keyword/value pairs from a given existing object. See Common 
  8741.       parameters definition 
  8742.  
  8743.      EdyUcm_ViewObj 
  8744.  
  8745.       This function, like its REXX counterpart, is used to view a given object, 
  8746.       that is, obtain the list of keyword/values associated to a given existing 
  8747.       object. See Common parameters definition 
  8748.  
  8749.      EdyUcm_FreeMemUcm 
  8750.  
  8751.       This function is to be used after the EdyUcmViewObj, to free up the 
  8752.       resources allocated by that call. 
  8753.  
  8754.  Common parameters definition: Parameters for the Add, Update, Delete and View 
  8755.  functions : 
  8756.  
  8757.  Ucm_ObjectType Object type to process: 
  8758.  
  8759.            USR            User 
  8760.  
  8761.            GRP            Group 
  8762.  
  8763.            RES            Resource 
  8764.  
  8765.            USR_GRP        Link user-group 
  8766.  
  8767.            RES_USR        Link resource-user 
  8768.  
  8769.            GRP_GRP        Link group-group 
  8770.  
  8771.            RES_GRP        Link resource-group 
  8772.  
  8773.  void *    Pointer to a structure that contains the data for each object type. 
  8774.            The structure is Ucm_XxxXxxData where XxxXxx is the object type 
  8775.            used. This structure will always be an input parameter and has the 
  8776.            following fields : 
  8777.  
  8778.            Subsystem      This is the subsystem destination ID. Set to the 
  8779.                           string 'SENT' for SecureEntry administration. 
  8780.  
  8781.            Object instance Ids These are one or two fields, which are used to 
  8782.                           select the appropriate object instance (i.e to get 
  8783.                           the information about a user named john, the user id 
  8784.                           should be set to 'JOHN'). 
  8785.  
  8786.            Condition      Leave this field blank if not using UCM (initialized 
  8787.                           to 0's). Otherwise, it can be set to the SQL select 
  8788.                           condition to run against the specified table. 
  8789.  
  8790.  unsigned short Number of keyword definitions to process. On view calls, set 
  8791.            this field normally to 0, unless you want to obtain specifically 
  8792.            some object keywords, and not all of them. 
  8793.  
  8794.  Ucm_KeyData * Pointer to a structure that is an array of Ucm_KeyData elements, 
  8795.            containing the keyword definitions. For the View function, this 
  8796.            parameter is Ucm_KeyData **, and as with the previous field, you can 
  8797.            set this to point to a NULL initialized pointer, unless you want to 
  8798.            obtain specifically some of the object keywords, and not all of 
  8799.            them. 
  8800.  
  8801.  Ucm_Error * Pointer to a Ucm_Error structure, that contains all the necessary 
  8802.            information to access the error. 
  8803.  
  8804.            nerror         This is the error code 
  8805.  
  8806.            severity       This is the error severity, as defined in the include 
  8807.                           file (i.e, 'I','W', 'E','C','S'), 
  8808.  
  8809.            Type           This is the error type, and gives a clue on what type 
  8810.                           of error code the structure is returning : 
  8811.  
  8812.                           UCSQ           UCM SQL error (Look for errorcode in 
  8813.                                          the SQL reference) 
  8814.  
  8815.                           UCAP           UCM API error (Look for errorcode in 
  8816.                                          the EDYSLAGT.H file) 
  8817.  
  8818.                           UCME           UCM memory error (not enough 
  8819.                                          resources) 
  8820.  
  8821.                           LSER           Lan Server error (Look into Lan server 
  8822.                                          error documentation) 
  8823.  
  8824.                           SESR           SecureEntry registry error (as defined 
  8825.                                          in EDYERROR.H) 
  8826.  
  8827.            msg            Descriptive message 
  8828.  
  8829.            asoc_struc     Not used by now 
  8830.  
  8831.  Default allowable keywords 
  8832.  
  8833.      Keywords for object type USER 
  8834.  
  8835.         -  LAN_DATA: the values for these keyword are pairs of 
  8836.            (subkeyword=value) separated by binary 0 bytes, with a trailing 
  8837.            final 0 (i.e, same as when dealing with a program environment). The 
  8838.            type for this keyword must be 'A' (ASCII). The allowable subkeywords 
  8839.            expected in the value field are : 
  8840.  
  8841.              -- HOUR_START   start logon allowed hour 
  8842.  
  8843.              -- HOUR_END    end logon allowed hour 
  8844.  
  8845.              -- PRIV_USER    ADMIN,USER, or GUEST (Only for Lan Server 
  8846.                 environments) 
  8847.  
  8848.              -- FULL_NAME    Full name 
  8849.  
  8850.              -- CONNECTION   1 (allowed), 0 (not allowed) 
  8851.  
  8852.              -- USER_EXPIRE   NEVER, or day-month-year 
  8853.  
  8854.              -- DESCRIPTION   Free text description 
  8855.  
  8856.              -- PASSWORD    User password, only valid as input 
  8857.  
  8858.              -- PASSWD_EXPIRED 1 (expire password), 0 (do not expire password) 
  8859.  
  8860.              -- HOME_DIR    \\MachineName\x$\path, or x:\MachineName\x$\path. 
  8861.                 Only valid in Lan Server environments 
  8862.  
  8863.              -- MAX_STORAGE   As required by Lan Server. -1=no limit. Only 
  8864.                 valid in Lan Server environments 
  8865.  
  8866.              -- SCRIPT_PATH   As required by Lan Server. Only valid in Lan 
  8867.                 Server environments 
  8868.  
  8869.         -  Other: The keyword is assumed to be a security component 
  8870.            identificator, as described in the 'SENTRY.DSC' file located within 
  8871.            the SecureEntry path, INSTALL directory. The type is expected to be 
  8872.            'B' (binary), and values are buffers with the complete copy of the 
  8873.            file data, with a leading LONG set equal to 4. 
  8874.  
  8875.      Keywords for object type GROUP 
  8876.  
  8877.         -  LAN_DATA: the values for these keyword are pairs of 
  8878.            (subkeyword=value) separated by binary 0 bytes, with a trailing 
  8879.            final 0 (i.e, same as when dealing with a program environment). The 
  8880.            type for this keyword must be 'A' (ASCII). The allowable subkeywords 
  8881.            expected in the value field are : 
  8882.  
  8883.              -- DESCRIPTION   Free text description 
  8884.  
  8885.              -- FULL_NAME    Full name 
  8886.  
  8887.         -  Other: The keyword is assumed to be a security component 
  8888.            identificator, as described in the 'SENTRY.DSC' file located within 
  8889.            the SecureEntry path, INSTALL directory. The type is expected to be 
  8890.            'B' (binary), and values are buffers with the complete copy of the 
  8891.            file data, with a leading LONG set equal to 4. 
  8892.  
  8893.      Keywords for object type RESOURCE 
  8894.  
  8895.       This objects are only supported in Lan Server environment. All of the 
  8896.       defined keywords are of type 'A' (ASCII). The id for this object is the 
  8897.       alias name. 
  8898.  
  8899.         -  SERVER    Server name 
  8900.  
  8901.         -  TYPE     FILES, TREE, PRINTER or SERIAL 
  8902.  
  8903.         -  WHEN_SHARED  STARTUP, BYADMIN, or DYNAMIC 
  8904.  
  8905.         -  RESNAME    Resource name 
  8906.  
  8907.         -  DESCRIPTION  Free text description 
  8908.  
  8909.         -  MAX_CONN   Max number of supported connections 
  8910.  
  8911.      Keywords for object type RESOURCEGROUP and RESOURCEUSER 
  8912.  
  8913.       These are 'A' (ASCII) type keywords, only valid for Lan Server 
  8914.       environments. 
  8915.  
  8916.         -  ACCESS    Access type, i.e RWX 
  8917.  
  8918.         -  LOGON_ASN  Logon assignment device 
  8919.  
  8920.      Keywords for object type USERGROUP and GROUPGROUP 
  8921.  
  8922.       No keywords defined. 
  8923.  
  8924.  Objects listing 
  8925.  
  8926.  If you want to list the objects existing of a given type, you should issue an 
  8927.  EdyUcm_ViewObj call, but setting the appropriate object IDs as '*'. This will 
  8928.  generate a list of all the objects found matching the criteria within the 
  8929.  returned keyword structure. Note that the only exception to this rule is when 
  8930.  listing users or groups. You can only access the list of users or groups in a 
  8931.  way that works in all environments by viewing the appropriate USERGROUP or 
  8932.  GROUPGROUP object list, as shown in the sample provided (LISTGRP.C). 
  8933.  
  8934.  Additional notes: 
  8935.  
  8936.      Error reporting : Errors are returned in a per function basis within the 
  8937.       provided error structure (Ucm_Error) in the C API. The function call ret. 
  8938.       code for the EdyUcm_xxxObj functions will be : 
  8939.  
  8940.         -  Rc=0  Function successful 
  8941.  
  8942.         -  Rc<0  Error. Function not performed. Look into the error structure 
  8943.            for further information. 
  8944.  
  8945.         -  Rc>0  Warning. Function performed, but an unexpected condition was 
  8946.            found. Look into the error structure for further information. 
  8947.  
  8948.      Remember to initialize all structures whenever calling the API. Unless 
  8949.       otherwise noted, all fields should be set to 0. This includes the error 
  8950.       (Ucm_Error) and keywords structure (Ucm_KeyData). 
  8951.  
  8952.      Remember to free up the memory for the returned KeyData buffers using the 
  8953.       function EdyUcm_FreeMemUcm(). This is necessary only for API returned 
  8954.       structures (i.e, only in EdyUcm_ViewObj calls). 
  8955.  
  8956.      Indirection through the ' @' character is not supported within the 'C' 
  8957.       API. All component data is passed by value at this level, as explained 
  8958.       above under default allowable keywords 
  8959.  
  8960.      Uppercasing and blank stripping of ID's is not done for you at the 'C' 
  8961.       API level. 
  8962.  
  8963.      You should link and redirect calls to the 'EDYSLAGT.DLL' when working 
  8964.       with the 'C' API. 
  8965.  
  8966.  
  8967. ΓòÉΓòÉΓòÉ 9.7. SecureEntry OS/2 utilities ΓòÉΓòÉΓòÉ
  8968.  
  8969. SecureEntry provides with several tools to do all the necessary coding for a 
  8970. final security solution. This chapter describes those that run under pure OS/2 
  8971. environment. 
  8972.  
  8973.      Session event launcher : EDYUTIL 
  8974.  
  8975.      User Information display : EDYUSINF 
  8976.  
  8977.      Lan server classes override : WPSLAN 
  8978.  
  8979.      Switch list utilities : EDYSWL2 
  8980.  
  8981.      Semaphore management : EDYSEM2 
  8982.  
  8983.      Selective application closer : EDYCLOSE 
  8984.  
  8985.      CM/2 emulators manager : EDYE3270 
  8986.  
  8987.      Master boot record saver : EDYRWMBR 
  8988.  
  8989.      RACF PassTicket generation : EDYPTTST 
  8990.  
  8991.      Java APIs 
  8992.  
  8993.  
  8994. ΓòÉΓòÉΓòÉ 9.7.1. Session event launcher : EDYUTIL ΓòÉΓòÉΓòÉ
  8995.  
  8996. This command line utility allows you to launch a given session event. 
  8997.  
  8998. The command line invocation syntax is : 
  8999.  
  9000.  
  9001.      EDYUTIL TOLOCKUP | TOLOGOFF | FRLOGOFF | REBOOT
  9002.              TOSHTDWN [REBOOT] |
  9003.              FRSHTDWN [REBOOT] |
  9004.              NEXTLOGON [/CLEAR | /ASK /U:userid /P:password
  9005.                         /N:newpass /D:domain] |
  9006.              NEXTUNLOCK [/CLEAR | /ASK /U:userid|NO
  9007.                         /V:validationpassword|NO /P:password] |
  9008.              SIGNAL "aString" |
  9009.              SUPERSIGNAL "aString" |
  9010.              J_LOGON |
  9011.              J_LOGOFF
  9012.  
  9013.  TOLOCKUP            To launch a lockup event 
  9014.  
  9015.  TOLOGOFF            To launch a logoff event 
  9016.  
  9017.  FRLOGOFF            To launch a forced logoff event (not cancellable) 
  9018.  
  9019.  REBOOT              To reboot the machine immediately 
  9020.  
  9021.  TOSHTDWN            To launch a shutdown event. Use the REBOOT parameter to 
  9022.                      force a reboot once shutdown is completed 
  9023.  
  9024.  FRSHTDWN            To launch a forced shutdown event (not cancellable). Use 
  9025.                      the REBOOT parameter to force a reboot once shutdown is 
  9026.                      completed 
  9027.  
  9028.  NEXTLOGON           To prefill the next logon parms data area. When using this 
  9029.                      parameter you must specify either 
  9030.  
  9031.                          /CLEAR To erase the previous logon parms data area, 
  9032.                           or 
  9033.  
  9034.                          One or more of : 
  9035.  
  9036.                             -  /U: To set up the userid for the next logon 
  9037.  
  9038.                             -  /P: To set up the user password for the next 
  9039.                                logon 
  9040.  
  9041.                             -  /D: To set up the domain for the next logon 
  9042.  
  9043.                             -  /N: To set up the new password field for the 
  9044.                                next logon 
  9045.  
  9046.                             -  /ASK To make the default SecureEntry logon panel 
  9047.                                to prompt for entries. Otherwise, if the logon 
  9048.                                parms data area is found filled at logon time, 
  9049.                                then an automatic logon attempt will be made 
  9050.                                with the preconfigured parameters. 
  9051.  
  9052.  NEXTUNLOCK          To setup the validation password/userid to use for the 
  9053.                      current session unlock panels, and also to optionally 
  9054.                      prefill the password field during the next unlock event. 
  9055.                      When using this parameter you must specify either 
  9056.  
  9057.                          /CLEAR To erase the previous unlock parms data area, 
  9058.                           or 
  9059.  
  9060.                          One or more of : 
  9061.  
  9062.                             -  /U: To set up the informational userid for the 
  9063.                                next unlock, or NO for none 
  9064.  
  9065.                             -  /V: To set up the user password used to validate 
  9066.                                the input password for the next unlock 
  9067.  
  9068.                             -  /P: To prefill the user password used for the 
  9069.                                next unlock 
  9070.  
  9071.                             -  /ASK To make the default SecureEntry unlock 
  9072.                                panel to prompt for entries. Otherwise, if the 
  9073.                                unlock password (/P parameter) data area is 
  9074.                                found filled at unlock time, then an automatic 
  9075.                                unlock attempt will be made with that 
  9076.                                parameters. 
  9077.  
  9078.  SIGNAL              To invoke the SIGNAL user exit passing it the aString 
  9079.                      parameter. 
  9080.  
  9081.  SUPERSIGNAL         To invoke the SUPERSIGNAL user exit passing it the aString 
  9082.                      parameter. 
  9083.  
  9084.  J_LOGON             To awaken any Java listeners waiting for notification of a 
  9085.                      logon event. For this notification to take place simply 
  9086.                      add the following line in the SecureEntry 
  9087.                      UserExitAfterLogon: 
  9088.  
  9089.                                                'start /min edyutil j_logon'
  9090.  
  9091.                      Refer to Java APIs for more information on how to use the 
  9092.                      SecureEntry Java classes and interfaces. 
  9093.  
  9094.  J_LOGOFF            To awaken any Java listeners waiting for notification of a 
  9095.                      logoff event. For this notification to take place simply 
  9096.                      add the following line in the SecureEntry 
  9097.                      UserExitBeforeImminentLogoff: 
  9098.  
  9099.                                                'start /min edyutil j_logoff'
  9100.  
  9101.                      Refer to Java APIs for more information on how to use the 
  9102.                      SecureEntry Java classes and interfaces. 
  9103.  
  9104.  If the Nextlogon/Nextunlock features are used, they can be used as late as 
  9105.  within the user exit before the logon/unlock dialog, thus effectively 
  9106.  providing for an easy way to substitute the default SecureEntry logon/unlock 
  9107.  panels with a custom one. Remember, however, that for a dialog to be shown 
  9108.  within a user exit, it has to be system modal. Besides, the responsibility to 
  9109.  maintain the focus on your customized panels becomes yours. 
  9110.  
  9111.  Note that this features are very powerful, since they also allows for a way to 
  9112.  enter user data directly from a device which does not necessarily has to be 
  9113.  the keyboard. 
  9114.  
  9115.  This program is provided as a tool, but also as a sample C program, with the 
  9116.  appropriate API files for if you want to launch your own events from within 
  9117.  your applications, all of this located in the 
  9118.  SecureEntryPath\API\SOURCES\EDYFLOW directory. 
  9119.  
  9120.  Note that this program executes the events in an asynchronous way, so that it 
  9121.  will normally return control long before the indicated event is processed. 
  9122.  
  9123.  This utility is located in the SecureEntryPath\EXEC directory of the 
  9124.  workstation. 
  9125.  
  9126.  IMPORTANT NOTES 
  9127.  
  9128.  It is not allowed to use this utility during machine startup, since the 
  9129.  SecureEntry kernel is not yet fully active at this time. Should you need to 
  9130.  use it at every boot, you can do it during user exit after start up 
  9131.  processing, the earliest. 
  9132.  
  9133.  SES events are serialized by architecture. This means that you will not 
  9134.  normally be able to use this utility to launch SES events while another event 
  9135.  is being processed. A clear example of this is when you want to shutdown or 
  9136.  logoff from within a given user exit. Use instead the appropriate ret. code to 
  9137.  return from the user exit. An exception to this rule is when the logon and 
  9138.  unlock panels are being displayed. SecureEntry allows in this case you to 
  9139.  launch EDYUTIL from a background process to force a shutdown or logoff event. 
  9140.  
  9141.  
  9142. ΓòÉΓòÉΓòÉ 9.7.2. User Information display : EDYUSINF ΓòÉΓòÉΓòÉ
  9143.  
  9144. This utility displays the currently logged on user, group, domain, server, 
  9145. computer and whether it is administrator or not. 
  9146.  
  9147. The command line invocation sentence is : 
  9148.  
  9149.  
  9150.      EDYUSINF
  9151.  
  9152. It will display the information as in the following sample : 
  9153.  
  9154.  
  9155.      USER:USERID
  9156.      GROUP:
  9157.      DOMAIN:SEDOMAIN
  9158.      SERVER:\\SESRV01
  9159.      ADMIN:YES
  9160.      COMPUTER:SESRV01
  9161.  
  9162. This utility is located in the SecureEntryPath\TOOLS directory of the 
  9163. workstation. 
  9164.  
  9165.  
  9166. ΓòÉΓòÉΓòÉ 9.7.3. Lan Server classes override : WPSLAN ΓòÉΓòÉΓòÉ
  9167.  
  9168. If you are running under a Lan Server environment, then the Lan Server adds Lan 
  9169. entries to most objects system menus, which you may want not to display. In 
  9170. that case you can use the WPSLAN program to install or uninstall those entries. 
  9171.  
  9172. The command line invocation sentence is : 
  9173.  
  9174.  
  9175.   WPSLAN /U to deregister the LAN server classes
  9176.   WPSLAN /I to register and replace the LAN server classes
  9177.  
  9178. This utility is located in the SecureEntryPath\TOOLS directory of the 
  9179. workstation. 
  9180.  
  9181.  
  9182. ΓòÉΓòÉΓòÉ 9.7.4. Switch list utilities : EDYSWL2 ΓòÉΓòÉΓòÉ
  9183.  
  9184. The files that compose the Window List utility are located in the 
  9185. SecureEntryPath\TOOLS directory on the workstation. 
  9186.  
  9187. If you want to display on-line information about this procedure, enter: 
  9188.  
  9189.  
  9190.   EDYSWL2
  9191.  
  9192. This utility provides access to the task list and to the system sessions 
  9193. (Window List), even to those that are hidden. It allows for session management. 
  9194.  
  9195. The syntax for this command is: 
  9196.  
  9197.  
  9198.      EDYSWL2 [action:session]
  9199.  
  9200.  Action    Action to be performed with the specified session. The parameter 
  9201.            value can be: 
  9202.  
  9203.            HIDE           Removes the session from the Window List. 
  9204.  
  9205.            KILL           Ends the process running in the session. 
  9206.  
  9207.            SHOW           Restores the session in the Window List. 
  9208.  
  9209.            SWITCHTO       Gives control to the session. 
  9210.  
  9211.            LIST           Displays the list of sessions. No session must be 
  9212.                           specified for this action. 
  9213.  
  9214.            MINIWIN        Minimizes all windows for the specified session. 
  9215.  
  9216.            HIDEWIN        Hides all windows for the specified session. 
  9217.  
  9218.            RESTWIN        Restores all windows for the specified session. 
  9219.  
  9220.            MAXIWIN        Maximizes all windows for the specified session. 
  9221.  
  9222.            ACTIWIN        Activates all windows for the specified session. 
  9223.  
  9224.            DEACWIN        Deactivates all windows for the specified session. 
  9225.  
  9226.            CLOSWIN        Closes all windows for the specified session. 
  9227.  
  9228.            Note that all the *WIN actions are performed against the windows, 
  9229.            and not the switch list entries, in an asynchronous mode (rc=0 only 
  9230.            means that the message has been sent). 
  9231.  
  9232.  Session   Session that will be affected by the action. The parameter value can 
  9233.            be specified in different formats: 
  9234.  
  9235.            HSWL:handle    Where handle is the Window List handle in 
  9236.                           hexadecimal. 
  9237.  
  9238.            PID:pid        Where pid is the process identifier in hexadecimal. 
  9239.  
  9240.            SESSID:sessionid Where sessionid is the session identifier in 
  9241.                           hexadecimal. 
  9242.  
  9243.            SLINDEX:index  Where index is the Window List index in decimal. 
  9244.  
  9245.            TITLE:title    Where title is the session title in ASCII. 
  9246.  
  9247.                           Blank characters and control keys must be replaced by 
  9248.                           underscores.Wildcards are allowed. All task list 
  9249.                           sessions matching the specifications will have the 
  9250.                           intended action applied. Note that the carriage 
  9251.                           return character (CR) plus the line feed character 
  9252.                           (LF) require two underscores. 
  9253.  
  9254.  
  9255. ΓòÉΓòÉΓòÉ 9.7.5. Semaphore management : EDYSEM2 ΓòÉΓòÉΓòÉ
  9256.  
  9257. If you want to display online information about this utility, enter: 
  9258.  
  9259.   EDYSEM2
  9260.  
  9261. This utility provides access to OS/2 event semaphores from a command line. It 
  9262. is intended to ease process synchronization between working sessions. 
  9263.  
  9264. The syntax for this command is : 
  9265.  
  9266.  
  9267.      EDYSEM2 [Post|Wait] Semname
  9268.  
  9269.  Post      Opens the OS/2 event semaphore \SEM32\Semname, provided it is 
  9270.            already created, and posts an event. If the semaphore does not 
  9271.            exist, it waits for the semaphore being created. 
  9272.  
  9273.  Wait      Opens the OS/2 event semaphore \SEM32\semaphore_name, provided it is 
  9274.            already created, or creates the semaphore, if it does not exist. 
  9275.            Then, it waits for an event to be posted. 
  9276.  
  9277.  Semname   Name of the semaphore. The parameter value is not case-sensitive. 
  9278.  
  9279.  SecureEntry also provides the EDYSEMV utility, with the same functionality and 
  9280.  parameters, which runs under a VDM. 
  9281.  
  9282.  The EDYSEM2 utility can be stopped by pressing Ctrl-C. The EDYSEMV utility 
  9283.  does not support it. 
  9284.  
  9285.  
  9286. ΓòÉΓòÉΓòÉ 9.7.6. Selective application closer : EDYCLOSE ΓòÉΓòÉΓòÉ
  9287.  
  9288. The selective application closer utility enables to close applications after a 
  9289. given event. 
  9290.  
  9291. The files that compose this utility are located in the SecureEntryPath\TOOLS 
  9292. directory on the workstation. 
  9293.  
  9294. Those applications that will remain active must be specified in an INI file. 
  9295.  
  9296. When the EDYCLOSE procedure runs, the INI file is read and only the 
  9297. applications that are not specified are closed. To close the sessions, the 
  9298. procedure uses a DosKillProcess. If the file can not be found, no application 
  9299. is closed. 
  9300.  
  9301. The applications that do not appear in the Window List are not closed, no 
  9302. matter whether they are specified in the INI file or not. The session where the 
  9303. EDYCLOSE procedure runs is not closed, either. 
  9304.  
  9305. To start the procedure, enter the following: 
  9306.  
  9307.      EDYCLOSE [Filepath]Filename[.INI]
  9308.  
  9309.  Filepath  Full path of the INI file with the specifications. The default is 
  9310.            the current directory. 
  9311.  
  9312.  Filename  Filename of the INI file with the specifications. The default is 
  9313.            EDYCLOSE. 
  9314.  
  9315.  For example, you can specify to kill all the user applications present in the 
  9316.  window list except those specified in the list file by starting this procedure 
  9317.  in any appropriate user exit provided by the SecureEntry user exits API, or 
  9318.  your own applications. Note that it is not really necessary to use this tool 
  9319.  to kill user applications at logoff time, since this is done automatically by 
  9320.  SecureEntry, but it may be needed to be used by your application in some 
  9321.  instances. 
  9322.  
  9323.  Editing the selective application closer file 
  9324.  
  9325.  To produce the input file for the selective application closer utility, you 
  9326.  can use a settings notebook that is opened by entering: 
  9327.  
  9328.  
  9329.        EDYEDTCL [Filepath]Filename[.INI]
  9330.  
  9331.  Filepath  Full path of the INI file with the specifications. The default is 
  9332.            the current directory. 
  9333.  
  9334.  Filename  Filename of the INI file with the specifications. The default is 
  9335.            EDYCLOSE. 
  9336.  
  9337.  The following information can be specified: 
  9338.  
  9339.  Name      Identifies the application that will not be closed and must match 
  9340.            the corresponding entry in the Window List. 
  9341.  
  9342.            To specify a task that corresponds to an object title of more than 
  9343.            one line, use the \n string. For example, Minimized\nWindow Viewer. 
  9344.  
  9345.            After typing the task name, click on the Add push button, so that 
  9346.            the name is added to the List. Specify as many task names as 
  9347.            applications will not be killed. 
  9348.  
  9349.  List      Contains the task names of all those applications that will remain 
  9350.            active. To remove a task name from the list, select it and click the 
  9351.            Remove push button. 
  9352.  
  9353.  
  9354. ΓòÉΓòÉΓòÉ 9.7.7. CM/2 emulators manager tool : EDYE3270 ΓòÉΓòÉΓòÉ
  9355.  
  9356. This command line utility allows controlling of the start and stop of the CM/2 
  9357. emulator sessions. It is intended to be added as part of the SecureEntry user 
  9358. exits to have the sessions started as desired under a per signon basis. 
  9359.  
  9360. The command line invocation sentence is : 
  9361.  
  9362.  
  9363.   EDYE3270 START  to start the configured emulator sessions
  9364.   EDYE3270 STOP   to stop the configured emulator sessions
  9365.   EDYE3270 SWITCH to switch status of the configured emulator sessions
  9366.  
  9367. This utility is located in the SecureEntryPath\TOOLS directory of the 
  9368. workstation. 
  9369.  
  9370. If you don't use CM/2 support for your emulators, but the Access Feature (AF) 
  9371. through Personal Communications (PCOM), then the utility EDYE3270 is useless 
  9372. and you will have to use the proper PCOM tools as follows: 
  9373.  
  9374.   PCSWS    name.WS      to start the session configured in the file name.WS
  9375.   PCSBAT   name.BCH /R  to start the set of sessions configured in the file name.BCH
  9376.   PCSSTOP               to stop the up and running emulator sessions
  9377.  
  9378. SecureEntry will automatically stop the up and running emulator sessions if 
  9379. they are identified in the file EDYKILL.NOT, whose support is currently 
  9380. available. 
  9381.  
  9382. To get more information about the file EDYKILL.NOT refer to Configuration files 
  9383. and its own comments section. To get more information about PCOM emulators 
  9384. handling refer to Personal Communications v4.2 Quick Beginnings. 
  9385.  
  9386.  
  9387. ΓòÉΓòÉΓòÉ 9.7.8. Master boot record saver : EDYRWMBR ΓòÉΓòÉΓòÉ
  9388.  
  9389. All systems are exposed to virus or other events which can make them non 
  9390. bootable. SecureEntry provides now a means of restoring the original master 
  9391. boot records in case an external event destroys them, no matter whether or not 
  9392. the Software Boot Protection is installed. 
  9393.  
  9394. When using this utility, you are encouraged to generate a copy of the master 
  9395. boot records of the system in the last diskette of the OS/2 Utility Diskettes, 
  9396. so that you can restore them after booting from the Utility Diskettes if the 
  9397. system cannot boot from hard disk. 
  9398. Setup process 
  9399.  
  9400.      Make a back-up copy of the original master boot records: 
  9401.  
  9402.             EDYRWMBR.EXE /R [/Fpath_name]
  9403.             where: /R          reads the original MBRs from the physical disks.
  9404.                    /Fpath_name writes the files containing the MBRs in the specified
  9405.                                path_name. If not present, it defaults to current directory.
  9406.  
  9407.       There exists one saved file for each physical disk in the system. The 
  9408.       name of these files is EDYBOOT and their extension is 001 for the first 
  9409.       physical disk, 002 for the second one, and so on. For example, in a 
  9410.       system with two hard drives, the command: 
  9411.  
  9412.             EDYRWMBR /R /Fa:
  9413.       will read the original master boot records of both disks and write them 
  9414.       to the files EDYBOOT.001 and EDYBOOT.002 in the A: drive. 
  9415.  
  9416.       If the Software Boot Protection is installed, the original master boot 
  9417.       records will be written to the external files. If the Software Boot 
  9418.       Protection is not installed, the current master boot records will. 
  9419.  
  9420.       If these files already exist, they will be overwritten. 
  9421.  
  9422.       If the master boot records are invalid, this utility will refuse to 
  9423.       generate the external files. 
  9424.  
  9425.      Restore a back-up copy of the original master boot records: 
  9426.  
  9427.             EDYRWMBR.EXE /W [/Ppassword] [/Fpath_name]
  9428.             where: /W          writes the saved MBRs to the physical disks.
  9429.                    /Ppassword  this parameter is mandatory if the Software
  9430.                                Boot Protection is enabled.
  9431.                    /Fpath_name reads the files containing the MBRs from
  9432.                                the specified path_name. If not present, it
  9433.                                defaults to current directory.
  9434.  
  9435.       Having a system with the Software Boot Protection installed and the saved 
  9436.       files in the current directory, you can restore the original MBRs using 
  9437.       the command: 
  9438.  
  9439.             EDYRWMBR /W /Pxxxx
  9440.       Having a system without the Software Boot Protection installed and the 
  9441.       saved files in the A: drive, you can restore the original MBRs using the 
  9442.       command: 
  9443.  
  9444.             EDYRWMBR /W /Fa:
  9445.  
  9446.       Since this command will be used when the system cannot start, it will 
  9447.       apply the strategy "do my best", hence very few checkings will be carried 
  9448.       out on the current master boot records of the physical disks. 
  9449.  
  9450.  
  9451. ΓòÉΓòÉΓòÉ 9.7.9. RACF PassTickets Generation: EDYPTTST ΓòÉΓòÉΓòÉ
  9452.  
  9453. RACF PassTickets are an alternative to the RACF passwords that allows a user to 
  9454. access the host system without sending the RACF password across the network. 
  9455. RACF PassTickets are one time passwords usable in a time frame of plus or minus 
  9456. ten minutes since the moment they are generated, as measured on the GMT clock 
  9457. of the host. Since RACF PassTickets are cryptographically-generated, 
  9458. single-use, short-lifespan password substitutes, they are inherently more 
  9459. secure than passwords. 
  9460.  
  9461. Unlike regular passwords, the algorithm that generates the RACF PassTicket is a 
  9462. function of: 
  9463.  
  9464.    1. The RACF user ID 
  9465.  
  9466.    2. The application ID, which is the profile name of the RACF APPL class for 
  9467.       protecting the access to the application (CICS applid, IMSid, TSO SMFid, 
  9468.       etc.) 
  9469.  
  9470.    3. A secured SignOn application key, which depends on the application ID and 
  9471.       optionally on the user ID 
  9472.  
  9473.    4. A time and date stamp 
  9474.  
  9475.  For RACF to successfully handle PassTickets you have to configure it 
  9476.  accordingly. Follow these steps: 
  9477.  
  9478.    1. Activate the class PassTicket: 
  9479.  
  9480.                SETROPTS CLASSACT(PTKTDATA)
  9481.                SETROPTS RACLIST(PTKTDATA)
  9482.  
  9483.    2. Define a profile for the user and the application: 
  9484.  
  9485.                RDEFINE PTKTDATA appl.group.userid - SSIGNON(KEYMASKED(0123456789abcdef))
  9486.       where appl is the name of the application (CICS, TSO+SMFID, etc.), group 
  9487.       and userid are the group and the RACF userid and 0123456789abcdef is the 
  9488.       secret 16-digits key. 
  9489.  
  9490.    3. Refresh the class: 
  9491.  
  9492.               SETR REFRESH RACLIST(PTKTDATA)
  9493.  
  9494.  What follows is the description of the PassTickets modules: 
  9495.  
  9496.      RACF PassTicket Generator EDYPTTST 
  9497.  
  9498.       To get a PassTicket, you can call the generation API inside your program, 
  9499.       or run the following program: 
  9500.  
  9501.  
  9502.               EDYPTTST -U:UserId -K:Key -A:App [-T:Time] [-Z:TimeZone]
  9503.  
  9504.       where: 
  9505.  
  9506.  
  9507.               UserId  : the UserId on the system on which the target application runs.
  9508.                         The maximum UserId length is 8 bytes.
  9509.               Key     : the secured signon application key that matches the key value
  9510.                         when defining the application to the PTKTDATA class to RACF.
  9511.                         The key length must be a valid 16-digit secret key containing
  9512.                         only characters 0 through 9 and A through F.
  9513.               App     : the application name as defined for a particular application
  9514.                         associated to the secured signon key. The maximum Application
  9515.                         Name length is 8 bytes.
  9516.               Time    : the number of seconds elapsed since 01.01.1970 at 00:00 GMT.
  9517.                         If not specified, the PassTicket will be generated using the
  9518.                         current date and time.
  9519.               TimeZone: the shift from GMT on the host side. This is a positive or
  9520.                         negative integer representing the timezone in hours. For
  9521.                         example: Paris = +1 in summer
  9522.  
  9523.       Messages: 
  9524.  
  9525.         -  Successful operation: 
  9526.  
  9527.                         Generated PassTicket=<AGD1PPXU>
  9528.            where the PassTicket is enclosed between the signs '<' and '>'. 
  9529.  
  9530.         -  Warnings: none. 
  9531.  
  9532.         -  Errors: a value different from 0 to the command line. 
  9533.  
  9534.      RACF PassTicket API 
  9535.  
  9536.       The RACF PassTicket API has the following entry point, defined in 
  9537.       EDYPTAPI.H: 
  9538.  
  9539.  
  9540.               unsigned long GetPassTicket(unsigned char *pszUserId,
  9541.                                           unsigned char *pszKey,
  9542.                                           unsigned char *pszApp,
  9543.                                           long           lTime,
  9544.                                           long           lTimeZone,
  9545.                                           unsigned char *pszPTKT);
  9546.  
  9547.       Notes: 
  9548.  
  9549.         1. pszUserId must be a zero ended string buffer preallocated to a 
  9550.            maximum length of 8 bytes. 
  9551.  
  9552.         2. pszKey must be a zero ended string buffer preallocated to a length 
  9553.            of 16 bytes. 
  9554.  
  9555.         3. pszApp must be a zero ended string buffer preallocated to a maximum 
  9556.            length of 8 bytes. 
  9557.  
  9558.         4. If lTime is set to zero, then the PassTicket will be generated using 
  9559.            the current date and time. 
  9560.  
  9561.         5. pszPTKT is the calculated PassTicket. It is a 8-character 
  9562.            alphanumeric string containing only characters 0 through 9 and A 
  9563.            through Z. It must be pre-allocatted to a size of 9 bytes (8+ending 
  9564.            zero). 
  9565.  
  9566.            Return codes: 
  9567.  
  9568.              -  Successful operation: 0 
  9569.  
  9570.              -  Error: 87 = ERROR_INVALID_PARAMETER 
  9571.  
  9572.            Refer to I have gotten a PassTicket, but RACF rejects it if a 
  9573.            generated PassTicket does not allow you to signon a user to a 3270 
  9574.            application. 
  9575.  
  9576.  
  9577. ΓòÉΓòÉΓòÉ 9.7.10. Java APIs ΓòÉΓòÉΓòÉ
  9578.  
  9579. SecureEntry provides a set of APIs for Java2 1.3. 
  9580.  
  9581. These APIs contain interfaces and classes needed for interacting with some 
  9582. specific SecureEntry events, such as logon and logoff, so that different 
  9583. programs may be notified when a user has logged on or off the system. 
  9584.  
  9585. Besides, a program may get information about the current logged on user (if 
  9586. any), as well as request SecureEntry to log the current user off the system, 
  9587. and get a RACF PassTicket for a given user. 
  9588.  
  9589. The APIs that define the SecureEntry classes and interfaces reside in the file 
  9590. SENTRY.JAR, which is located in the directory <sgm_shell>\EXEC. A Java Virtual 
  9591. Machine JVM using the SecureEntry classes must properly load those classes 
  9592. adding the path to where SENTRY.JAR (as well as this file) is located in the 
  9593. ClassPath parameter of the JVM, regarding the following example as a sample: 
  9594.  
  9595.   JAVA -CP %SGM_SHELL%\EXEC;%SGM_SHELL%\EXEC\SENTRY.JAR MyClass
  9596.  
  9597. You can find detailed documentation about this set of APIs in the file JAVA.ZIP 
  9598. located in the <sgm_shell>\API\JAVA directory. Just unzip it and make a browser 
  9599. to point to the file INDEX.HTML 
  9600.  
  9601.  
  9602. ΓòÉΓòÉΓòÉ 9.8. Virtual DOS Machine utilities ΓòÉΓòÉΓòÉ
  9603.  
  9604. Migrating DOS programs to use them in the OS/2 Virtual DOS Machines (VDMs) 
  9605. requires changes in the processing environment. 
  9606.  
  9607. OS/2 is a multiprocessing platform from which the DOS programs that you migrate 
  9608. can benefit. That is, several DOS programs can run within their own 
  9609. environments in different VDMs. 
  9610.  
  9611. SecureEntry provides the following programs that meet the synchronization 
  9612. requirements involved in this multiprocessing: 
  9613.  
  9614.  VDM programs starter : EDYSTRTV To start OS/2 programs from a VDM. 
  9615.  
  9616.  VDM NET commands launcher : EDYNETV To run network commands from a VDM. 
  9617.  
  9618.  VDM switch list utility : EDYSWLV To access the OS/2 task list from a VDM. 
  9619.  
  9620.  VDM session switcher : EDYBRNGV To bring to foreground a OS/2 program from a 
  9621.            VDM. 
  9622.  
  9623.  VDM semaphores : EDYSEMV To work with OS/2 semaphores from a VDM. 
  9624.  
  9625.  The files corresponding to these programs are located in the 
  9626.  SecureEntryPath\TOOLS directory on the workstation. 
  9627.  
  9628.  
  9629. ΓòÉΓòÉΓòÉ 9.8.1. VDM programs starter : EDYSTRTV ΓòÉΓòÉΓòÉ
  9630.  
  9631. If you want to display on-line information about this utility, enter: 
  9632.  
  9633.  
  9634.   EDYSTRTV
  9635.  
  9636. This utility starts DOS programs in VDMs. The CMD.EXE path must be specified in 
  9637. the PATH statement of the OS/2 CONFIG.SYS file. 
  9638.  
  9639. The syntax of this command is: 
  9640.  
  9641.  
  9642.      EDYSTRTV [/S:Sessiontype] [/F:Sessionmode] [/T:Sessiontitle]
  9643.               [/D:DOSsettings] [/X:Winposx] [/Y:Winposy] [/W:Width]
  9644.               [/H:Height] Programname Programparameters
  9645.  
  9646.  Sessiontype The following types of session are supported, which should be 
  9647.            specified by these parameter values: 
  9648.  
  9649.            1              OS/2 full screen 
  9650.  
  9651.            2              OS/2 window 
  9652.  
  9653.            3              OS/2 Presentation Manager 
  9654.  
  9655.            4              Virtual DOS machine (either DOS VDM or WINOS2 VDM) 
  9656.  
  9657.            7              VDM window 
  9658.  
  9659.            The default is 1. 
  9660.  
  9661.  Sessionmode The following modes of session are supported, which should be 
  9662.            specified by these parameter values: 
  9663.  
  9664.            0              Foreground 
  9665.  
  9666.            1              Background 
  9667.  
  9668.            The default is 1. 
  9669.  
  9670.  Sessiontitle The title of the session can be any string. 
  9671.  
  9672.            Blank characters and control keys must be replaced by underscores. 
  9673.            Note that the carriage return character (CR) plus the line feed 
  9674.            character (LF) require two underscores. 
  9675.  
  9676.  DOSsettings The DOS settings must be separated by the ; character. A file can 
  9677.            also be specified by @file_name. 
  9678.  
  9679.  Winposx   Horizontal coordinate of the window position. 
  9680.  
  9681.  Winposy   Vertical coordinate of the window position. 
  9682.  
  9683.  Width     Width of the window. 
  9684.  
  9685.  Height    Height of the window. 
  9686.  
  9687.  Programname Program to be started. 
  9688.  
  9689.            Blank characters and control keys must be replaced by underscores. 
  9690.            Note that the carriage return character (CR) plus the line feed 
  9691.            character (LF) require two underscores. 
  9692.  
  9693.  Programparameters Parameters for the program to be started. 
  9694.  
  9695.  
  9696. ΓòÉΓòÉΓòÉ 9.8.2. VDM NET commands launcher : EDYNETV ΓòÉΓòÉΓòÉ
  9697.  
  9698. If you want to display online information about this utility, enter: 
  9699.  
  9700.  
  9701.   EDYNETV
  9702.  
  9703. This utility runs the OS/2 NET command from VDMs. 
  9704.  
  9705. For information about the OS/2 NET command, enter: 
  9706.  
  9707.  
  9708.   EDYNETV HELP
  9709.  
  9710. Interactive commands are not supported. Redirected input (for example, when 
  9711. using the SEND command) or absolute paths (for example, when using the COPY 
  9712. command) are not supported, either. 
  9713.  
  9714. The following is required: 
  9715.  
  9716.      The Virtual DOS LAN API Support of LAN Server must be installed. 
  9717.  
  9718.      The LAN Requester must be active. 
  9719.  
  9720.      The SecureEntry user must be logged-on. 
  9721.  
  9722.      The NET.EXE and EDYSEM2.EXE paths must be specified in the PATH statement 
  9723.       of the OS/2 CONFIG.SYS file. 
  9724.  
  9725.  The syntax for this command is: 
  9726.  
  9727.  
  9728.        EDYNETV [ MACH | USE redirectionspecs ]
  9729.  
  9730.  MACH      Returns the machine ID. 
  9731.  
  9732.  USE       Returns the list of all redirected devices and drives, if no 
  9733.            redirection specifications are provided. 
  9734.  
  9735.            The following can be specified: 
  9736.  
  9737.            dev \\server\netname [password] Starts a device redirection. 
  9738.  
  9739.            d: \\server\netname [password] Starts a drive redirection. 
  9740.  
  9741.            dev /D         Ends a device redirection. 
  9742.  
  9743.  Other specifications are directly passed to the OS/2 session where the NET.EXE 
  9744.  program is running. 
  9745.  
  9746.  
  9747. ΓòÉΓòÉΓòÉ 9.8.3. VDM switch list utility : EDYSWLV ΓòÉΓòÉΓòÉ
  9748.  
  9749.            If you want to display online information about this utility, enter: 
  9750.  
  9751.  
  9752.                         EDYSWLV
  9753.  
  9754.            This utility provides access to the task list and to the system 
  9755.            sessions (OS/2 Window List), even to those that are hidden in the 
  9756.            switch list, from VDMs. It allows for session management. 
  9757.  
  9758.            The CMD.EXE and EDYSWL2.EXE paths must be specified in the PATH 
  9759.            statement of the OS/2 CONFIG.SYS file. 
  9760.  
  9761.            The syntax for this command is: 
  9762.  
  9763.  
  9764.                            EDYSWLV  [action:session]
  9765.  
  9766.  action    Action to be performed with the specified session. The parameter 
  9767.            value can be: 
  9768.  
  9769.            HIDE           Removes the session from the Window List. 
  9770.  
  9771.            KILL           Ends the process running in the session. 
  9772.  
  9773.            SHOW           Restores the session in the Window List. 
  9774.  
  9775.            SWITCHTO       Gives control to the session. 
  9776.  
  9777.            LIST           Displays the list of sessions. No session must be 
  9778.                           specified for this action. 
  9779.  
  9780.            MINIWIN        Minimizes all windows for the specified session. 
  9781.  
  9782.            HIDEWIN        Hides all windows for the specified session. 
  9783.  
  9784.            RESTWIN        Restores all windows for the specified session. 
  9785.  
  9786.            MAXIWIN        Maximizes all windows for the specified session. 
  9787.  
  9788.            ACTIWIN        Activates all windows for the specified session. 
  9789.  
  9790.            DEACWIN        Deactivates all windows for the specified session. 
  9791.  
  9792.            CLOSWIN        Closes all windows for the specified session. 
  9793.  
  9794.  session   Session that will be affected by the action. The parameter value can 
  9795.            be specified in different formats: 
  9796.  
  9797.            HSWL:handle    Where handle is the Window List handle in 
  9798.                           hexadecimal. 
  9799.  
  9800.            PID:pid        Where pid is the process identifier in hexadecimal. 
  9801.  
  9802.            SESSID:sessionid Where sessionid is the session identifier in 
  9803.                           hexadecimal. 
  9804.  
  9805.            SLINDEX:index  Where index is the Window List index in decimal. 
  9806.  
  9807.            TITLE:title    Where title is the session title in ASCII. 
  9808.  
  9809.                           Blank characters and control keys must be replaced by 
  9810.                           underscores. Note that the carriage return character 
  9811.                           (CR) plus the line feed character (LF) require two 
  9812.                           underscores. 
  9813.  
  9814.  Note : In order for this utility to work properly, the companion EDYSWL2 
  9815.  utility must be located within any of the environment PATH directories. 
  9816.  
  9817.  
  9818. ΓòÉΓòÉΓòÉ 9.8.4. VDM session switcher : EDYBRNGV ΓòÉΓòÉΓòÉ
  9819.  
  9820. If you want to display online information about this utility, enter: 
  9821.  
  9822.  
  9823.   EDYBRNGV
  9824.  
  9825. This utility starts a program, provided it is not started, or switches to a 
  9826. program, if already started, and brings the program to foreground. The CMD.EXE 
  9827. and EDYSWL2.EXE paths must be specified in the PATH statement of the OS/2 
  9828. CONFIG.SYS file. 
  9829.  
  9830. Both DOS and OS/2 programs can be located either in a path specified in the 
  9831. PATH statement or in any other path, which must be specified by entering the 
  9832. full path of the program. DOS programs can also be located in the current path. 
  9833.  
  9834. The syntax for this command is: 
  9835.  
  9836.  
  9837.      EDYBRNGV [/S:Sessiontype] [/F:Sessionmode] [/T:Sessiontitle]
  9838.               [/D:DOSsettings] [/X:Winposx] [/Y:Winposy] [/W:Width]
  9839.               [/H:Height] Programname Programparameters
  9840.  
  9841.  Sessiontype The following types of session are supported, which should be 
  9842.            specified by these parameter values: 
  9843.  
  9844.            1              OS/2 full screen 
  9845.  
  9846.            2              OS/2 window 
  9847.  
  9848.            3              OS/2 Presentation Manager 
  9849.  
  9850.            4              Virtual DOS machine (either DOS VDM or WINOS2 VDM) 
  9851.  
  9852.            7              VDM window 
  9853.  
  9854.            The default is 1. 
  9855.  
  9856.  Sessionmode The following modes of session are supported, which should be 
  9857.            specified by these parameter values: 
  9858.  
  9859.            0              Foreground 
  9860.  
  9861.            1              Background 
  9862.  
  9863.            The default is 0. 
  9864.  
  9865.  Sessiontitle The title of the session can be any string. 
  9866.  
  9867.            Blank characters and control keys must be replaced by underscores; 
  9868.            note that the carriage return character (CR) plus the line feed 
  9869.            character (LF) require two underscores. 
  9870.  
  9871.  DOSsettings The DOS settings must be separated by the ; character. A file can 
  9872.            also be specified by @file_name. 
  9873.  
  9874.  Winposx   Horizontal coordinate of the window position. 
  9875.  
  9876.  Winposy   Vertical coordinate of the window position. 
  9877.  
  9878.  Width     Width of the window. 
  9879.  
  9880.  Height    Height of the window. 
  9881.  
  9882.  Programname Program to be started. 
  9883.  
  9884.            To specify a CMD program, the parameter value must be: 
  9885.  
  9886.                         CMD.EXE /C filename.CMD
  9887.  
  9888.  Programparameters Parameters for the program to be started. 
  9889.  
  9890.  
  9891. ΓòÉΓòÉΓòÉ 9.8.5. VDM semaphores : EDYSEMV ΓòÉΓòÉΓòÉ
  9892.  
  9893. If you want to display online information about this utility, enter: 
  9894.  
  9895.   EDYSEMV
  9896.  
  9897. This utility provides access to OS/2 event semaphores from VDMs. It is intended 
  9898. to ease process synchronization either between VDMs or between VDMs and OS/2 
  9899. sessions. 
  9900.  
  9901. The syntax for this command is : 
  9902.  
  9903.  
  9904.      EDYSEMV [Post|Wait] Semname
  9905.  
  9906.  Post      Opens the OS/2 event semaphore \SEM32\Semname, provided it is 
  9907.            already created, and posts an event. If the semaphore does not 
  9908.            exist, it waits for the semaphore being created. 
  9909.  
  9910.  Wait      Opens the OS/2 event semaphore \SEM32\semaphore_name, provided it is 
  9911.            already created, or creates the semaphore, if it does not exist. 
  9912.            Then, it waits for an event to be posted. 
  9913.  
  9914.  Semname   Name of the semaphore. The parameter value is not case-sensitive. 
  9915.  
  9916.  SecureEntry also provides the EDYSEM2 utility, with the same functionality and 
  9917.  parameters, which runs under OS/2. 
  9918.  
  9919.  The EDYSEM2 utility can be stopped by pressing Ctrl-C. The EDYSEMV utility 
  9920.  does not support it. 
  9921.  
  9922.  
  9923. ΓòÉΓòÉΓòÉ 9.9. SecureEntry maintenance utilities ΓòÉΓòÉΓòÉ
  9924.  
  9925. SecureEntry provides also with a set of utilities for its own maintenance, plus 
  9926. general system maintenance. Some of these are used by SecureEntry itself during 
  9927. its different processes, but may be of interest to solve problems or defects in 
  9928. specific situations. 
  9929.  
  9930.      Deleting directories with EDYDD 
  9931.  
  9932.      Unpacking installation files using UNPACK32 
  9933.  
  9934.      Updating the SecureEntry database definitions with UPDATEDB 
  9935.  
  9936.      Recreating SecureEntry database with CREADB 
  9937.  
  9938.      Registering WP classes with EDYCLASS 
  9939.  
  9940.      Fixing OS/2 INI files by means of EDYCLINI 
  9941.  
  9942.      Installing PM DLLs with EDYWINI 
  9943.  
  9944.      Recreating the SecureEntry workbench using EDYCRWRK 
  9945.  
  9946.      Establishing SecureEntry Lan Links with EDYSRV and EDYFREE 
  9947.  
  9948.      Migrating SecureEntry 2.0 definitions using MIGRADB 
  9949.  
  9950.      Controlling the size of the log files using EDYLOGFS 
  9951.  
  9952.      Browsing the SecureEntry audit files with EDYLOGBR 
  9953.  
  9954.      Obtaining and viewing configuration image photo files with EDYPHOTO 
  9955.  
  9956.  WARNING!The incorrect use of some of this utilities may leave your system in a 
  9957.  unstable/unusable state. 
  9958.  
  9959.  
  9960. ΓòÉΓòÉΓòÉ 9.9.1. EDYDD ΓòÉΓòÉΓòÉ
  9961.  
  9962. The EDYDD program is a generic 'delete directory' utility. It erases the 
  9963. contents of the specified directory and all of its descendants, no matter if 
  9964. any file is marked as readonly or not. This program is located in the 
  9965. SecureEntryPath\INSTALL directory. 
  9966.  
  9967. The format for this utility is : 
  9968.  
  9969.  
  9970.      EDYDD directoryname [/N]
  9971.  
  9972.  directoryname The full path of the directory to delete 
  9973.  
  9974.  /N        Use this parameter to process without confirmation questions. 
  9975.  
  9976.  
  9977. ΓòÉΓòÉΓòÉ 9.9.2. UNPACK32 ΓòÉΓòÉΓòÉ
  9978.  
  9979. The UNPACK32.EXE is a program used to obtain from a SecureEntry installation 
  9980. diskette bundle file a given component. It is used internally by SecureEntry 
  9981. during the installation or service process. Its syntax is exactly that of the 
  9982. UNPACK2.EXE provided with OS/2 base. Refer to the OS/2 documentation for more 
  9983. details. This program is located in the SecureEntryPath\INSTALL directory. 
  9984.  
  9985.  
  9986. ΓòÉΓòÉΓòÉ 9.9.3. UPDATEDB ΓòÉΓòÉΓòÉ
  9987.  
  9988. This program is used to update the SecureEntry database for static 
  9989. characteristics, such as passwords expiration days or adding new components to 
  9990. the table of recognized ones. Refer to the chapter named 'Adding your own 
  9991. components' for instructions on its usage. This program is located in the 
  9992. SecureEntryPath\INSTALL directory. 
  9993.  
  9994.  
  9995. ΓòÉΓòÉΓòÉ 9.9.4. CREADB ΓòÉΓòÉΓòÉ
  9996.  
  9997. This program is used during installation to create an empty SecureEntry 
  9998. database of components and users. This program takes as input a subsystem name 
  9999. and a components description file. It resides in the SecureEntryPath\INSTALL 
  10000. directory. 
  10001.  
  10002. The syntax for this command is : 
  10003.  
  10004.  
  10005.      CREADB subsystemname configurationfile
  10006.  
  10007.  subsystemname Name of the subsystem to create. Only supported value is : 
  10008.            SENTRY 
  10009.  
  10010.  configurationfile Path and name for the configuration file. The one used by 
  10011.            the SecureEntry installation is SecureEntryPath\INSTALL\SENTRY.DSC 
  10012.  
  10013.  
  10014. ΓòÉΓòÉΓòÉ 9.9.5. EDYCLASS ΓòÉΓòÉΓòÉ
  10015.  
  10016. This utility is used by SecureEntry to register/deregister the SecureEntry SOM 
  10017. required classes. It is not normally necessary to use this command manually, 
  10018. since the product takes care of having those correctly registered at startup. 
  10019. The program is located in the SecureEntryPath\INSTALL directory. 
  10020.  
  10021. The syntax for this command is : 
  10022.  
  10023.  
  10024.      EDYCLASS /I | /U [binaryprofile]
  10025.  
  10026.  /I        To register the SecureEntry classes. 
  10027.  
  10028.  /U        To deregister the SecureEntry classes. Optionally, specify a desktop 
  10029.            restrictions profile which species the desired object settings to 
  10030.            set as default ones. 
  10031.  
  10032.  
  10033. ΓòÉΓòÉΓòÉ 9.9.6. EDYCLINI ΓòÉΓòÉΓòÉ
  10034.  
  10035. This program can be used to maintain and cleanup the OS/2 system initialization 
  10036. files OS2.INI and OS2SYS.INI. Note that this program has to be used with 
  10037. extreme care, since it can easily destroy your system settings or cause system 
  10038. malfunctions. 
  10039.  
  10040. WARNING : YOU ABSOLUTELY MUST KNOW WHAT YOU ARE DOING!!!!! 
  10041.  
  10042.  
  10043.  EDYCLINI [Operation mode] [Actions]
  10044.  
  10045.  Operation mode:
  10046.  
  10047.    /B[+|-]   Batch mode: enable (-) or disable (+) user interaction.
  10048.    /D[+|-]   Deferred mode. /D+ will start the program after next boot.
  10049.              /D- will cancel the effect of a previous call with /D+.
  10050.    /T[+|-]   Test mode. /T+ will not write corrections to disk.
  10051.              /T- will update the *.INI files.
  10052.    /V[0|1|2] Verbose mode: quiet (0) or verbose (2) operation.
  10053.  
  10054.  Actions:
  10055.  
  10056.    /N[+|-]   Nowhere shadows: delete (+) or ignore (-) shadows
  10057.              in the <WP_NOWHERE> folder.
  10058.    /H[+|-]   Handles: delete (+) or ignore (-) the handles of
  10059.              objects that have no matching file or directory.
  10060.    /I[+|-]   Identifiers: delete (+) or ignore (-) the object identifiers
  10061.              that have no matching handle.
  10062.    /Rdrives  Remove all the handles of objects that are defined
  10063.              in the specified drives. More than one drive can be
  10064.              specified using ';' as a separator.
  10065.    /U[i|d|c] UNC dives: ignore (i), delete (d) or, if available, check (c)
  10066.              the drives specified with UNC names.
  10067.  
  10068.  Default parameters:
  10069.  
  10070.    EdyClini /B- /T- /V2 /N- /H- /I- /Ui
  10071.  
  10072. Note that if you use the program to cleanup the <WP_NOWHERE> folder, then if 
  10073. the system malfunctions afterwards, the only way (not granted) method to fix it 
  10074. could be : 
  10075.  
  10076.      Reboot the machine to a command line through config.sys 
  10077.  
  10078.      Remove the <WP_NOWHERE> physical directory 
  10079.  
  10080.      Continue the boot process 
  10081.  
  10082.      Run the following little code : 
  10083.  
  10084.                 /* */
  10085.                 call RxFuncAdd 'SysLoadFuncs', 'REXXUTIL', 'SysLoadFuncs'
  10086.                 call SysLoadFuncs
  10087.                 call SysSetObjectData '<WP_NOWHERE>','OBJECTID=<WP_NOWHERE>'
  10088.  
  10089.      Now use any .INI maintenance tool to remove from the OS2.INI file the 
  10090.       data corresponding to the application PM_ABSTRACT:FolderContents within 
  10091.       the key corresponding to the object handle for <WP_NOWHERE>, which can be 
  10092.       located scanning the application PM_WorkPlace:Location for <WP_NOWHERE> 
  10093.       key. 
  10094.  
  10095.      Finally, reboot again 
  10096.  
  10097.  
  10098. ΓòÉΓòÉΓòÉ 9.9.7. EDYWINI ΓòÉΓòÉΓòÉ
  10099.  
  10100. This program is used to install or deinstall the PM DLLs required by some 
  10101. components. It resides in the SecureEntryPath\EXEC directory, and its syntax is 
  10102. : 
  10103.  
  10104.  
  10105.      EDYWINI /I[inifile] dllname [..dllname] |
  10106.              /U[inifile] dllname [..dllname] |
  10107.              /L[inifile]
  10108.  
  10109.  /I        To register a set of DLLs (dllname(s)) to the system. 
  10110.  
  10111.  /U        To deregister a set of DLLs (dllname(s)) from the system. 
  10112.  
  10113.  /L        To list the registered DLL names. 
  10114.  
  10115.  Note that you can specify in all three commands an optional path and filename 
  10116.  to the OS2.INI file to work with (inifile). By default, the one taken will be 
  10117.  the one pointed to by the USER_INI config.sys variable. 
  10118.  
  10119.  The DLLs required by SecureEntry to be installed are named : EDYWIN, EDYSESNO, 
  10120.  and EDYLKSTR. So, if at any time you recreate your OS2.INI file and intend to 
  10121.  use it in a SecureEntry machine, you must issue the following command before 
  10122.  the machine will become operative : 
  10123.  
  10124.  
  10125.        EDYWINI /I EDYWIN EDYSESNO EDYLKSTR
  10126.  
  10127.  Note that this utility can be run in a non-PM environment, such as an Alt-F1 
  10128.  command line. 
  10129.  
  10130.  
  10131. ΓòÉΓòÉΓòÉ 9.9.8. EDYCRWRK ΓòÉΓòÉΓòÉ
  10132.  
  10133. This REXX command can be used to recreate the SecureEntry workbench if 
  10134. necessary. It should be used by an administrator, and its invocation syntax is 
  10135. : 
  10136.  
  10137.  
  10138.      EDYCRWRK
  10139.  
  10140. Note that this command is located in the SecureEntryPath\INSTALL directory. 
  10141.  
  10142.  
  10143. ΓòÉΓòÉΓòÉ 9.9.9. EDYSRV and EDYFREE ΓòÉΓòÉΓòÉ
  10144.  
  10145. The EDYSRV program is a daemon that runs in the background of network 
  10146. environment installed SecureEntry servers, and communicates with clients 
  10147. through netbios. If this program is necessary, the appropriate sentence to 
  10148. launch it will have been added to your EDYSTART.CMD (boot) command. Both 
  10149. programs reside in the SecureEntryPath\EXEC directory. 
  10150.  
  10151. The invocation syntax for EDYSRV is : 
  10152.  
  10153.  
  10154.    (detach) EDYSRV [/N:netbiosname] [/S:netbiossessions]
  10155.                    [/R:update_policy]
  10156.  
  10157.  netbiosname Netbios name to add to the network. Note that clients use, to 
  10158.            communicate with this module, the name 'EDYdomainname', where 
  10159.            domainname is the name of your Lan Server domain (if any). 
  10160.  
  10161.  netbiossessions Number of parallel netbios sessions to use, where the default 
  10162.            value is 4. You are encouraged to increase this number if you see 
  10163.            big contention in the server machine (i.e, many users logging on at 
  10164.            the same time with RACF or UCM). 
  10165.  
  10166.  update_policy The update policy to use for this server. This parameter can 
  10167.            take the following values: 
  10168.  
  10169.     /R:H -> EDYSRV will use the corporate policy
  10170.             stored in the central repository (UCM) to apply the
  10171.             refresh branch process.
  10172.     /R:I -> EDYSRV will override the update corporate policy and
  10173.             run the refresh branch process at IPL time.
  10174.     /R:L -> EDYSRV will override the update corporate policy and
  10175.             run the refresh branch process at users signon time.
  10176.     /R:N -> EDYSRV will override the corporate policy and
  10177.             will not run any branch refresh update.
  10178.     /R:T<hhmm> -> EDYSRV will override the corporate policy and
  10179.             run the branch update process at the specified time.
  10180.     /R:E<mmmmm>-> EDYSRV will override the corporate policy and
  10181.             run the branch update process at IPL time, and every mmmm
  10182.             minutes subsequently.
  10183.  
  10184.  EDYFREE is the command to unload a running EDYSRV. Its invocation syntax is : 
  10185.  
  10186.  
  10187.        EDYFREE netbiosname
  10188.  
  10189.  
  10190. ΓòÉΓòÉΓòÉ 9.9.10. MIGRADB ΓòÉΓòÉΓòÉ
  10191.  
  10192. This REXX command can be used to migrate a SecureEntry 2.0 users and components 
  10193. database to the new SecureEntry 3.0 library. It must be run in the Domain 
  10194. controller (Where the SecureEntry 2.0 components were stored). To use it, you 
  10195. should have installed SecureEntry 3.0 over the old SecureEntry 2.0, and make 
  10196. sure that the environment variable SGM_LS is still defined and pointing to the 
  10197. directory structure for the users database of the old installation. 
  10198.  
  10199. The syntax for this command is : 
  10200.  
  10201.  
  10202.      MIGRADB  SECP|BOTH
  10203.  
  10204.  SECP      Use this option just to migrate the security components, assuming 
  10205.            you are still using the groups and users definitions of the Lan 
  10206.            Server UPM. (Working under Lan Server environment). 
  10207.  
  10208.  BOTH      Use this option if you have installed SecureEntry 3.0 in standalone 
  10209.            mode, and want to redefine users and groups, or if you have erased 
  10210.            the Lan Server users and groups that you had defined. 
  10211.  
  10212.  
  10213. ΓòÉΓòÉΓòÉ 9.9.11. EDYLOGFS ΓòÉΓòÉΓòÉ
  10214.  
  10215. The EDYLOGFS program is an utility that allows you to control the size of 
  10216. SecureEntry Log Files. This program is located in the SecureEntryPath\EXEC 
  10217. directory. 
  10218.  
  10219. It gets all its input from an ASCII file called EDYLOGS.STR located in the 
  10220. SecureEntryPath\nouser directory.  Each line of this file may specify a way to 
  10221. locate a SecureEntry log file and a size control policy that will be applied to 
  10222. this log file. As a first approach, a line of this file is interpreted like 
  10223. this: 
  10224.  
  10225.       where_to_locate_the_log_file   which_size_control_policy_to_apply
  10226.  
  10227. Locating SecureEntry Log Files 
  10228.  
  10229. All non-blank nor comment lines in the EDYLOGS.STR file must begin with a 
  10230. pathname to a SecureEntry log file that ends with the base SecureEntry log file 
  10231. name. This pathname can be interpreted in three different ways depending on the 
  10232. pathname's header: 
  10233.  
  10234.   x$...
  10235.            Absolute pathname starting from the x drive's root 
  10236.  
  10237.   boot...
  10238.            Absolute pathname starting from the boot drive's root 
  10239.  
  10240.   \...
  10241.            Relative pathname to SecureEntryPath 
  10242.  
  10243.  Optionally, an environment variable can also be stated after the pathname. If 
  10244.  so, this environment variable is used first (and if successfully last) to try 
  10245.  to locate the SecureEntry log file. To do so it is interpreted as a pointer to 
  10246.  the complete pathname of a directory where the SecureEntry log file should be 
  10247.  found. 
  10248.  
  10249.  Size Control Policies 
  10250.  
  10251.  All non-blank nor comment lines in the EDYLOGS.STR file must end stating which 
  10252.  size control policy should be applied to the SecureEntry log file specified at 
  10253.  the begin of the same line. 
  10254.  
  10255.  EDYLOGFS utility offers two ways for restricting the SecureEntry log files 
  10256.  size: 
  10257.  
  10258.      By Size (in Kb) 
  10259.  
  10260.       To set a size control policy based upon file size in Kbs on a particular 
  10261.       file, the user states two numbers optionally preceded by an 'S' at the 
  10262.       end of the EDYLOGS.STR line that references this particular file. Like 
  10263.       this: 
  10264.  
  10265.             c$\myfile.log        MY_ENV_VAR         S64,32
  10266.  
  10267.       These two numbers are interpreted (from left to right) as: 
  10268.  
  10269.         -  The Base File (or Trunc File) Size in Kb (BFS) 
  10270.  
  10271.         -  The maximum allowed Increment in Kb over BFS. (IBFS) 
  10272.  
  10273.       Note:  the second number, IBFS, is not mandatory. Its default value is 
  10274.       BFS/2 
  10275.  
  10276.        From them it is derived the maximum allowed size for the specified log 
  10277.       file which is BFS+IBFS Kb. If EDYLOGFS finds the log file to have a size 
  10278.       greater than this value it will trunc the log file to have a size as near 
  10279.       as possible to BFS Kb assuring no text line in the file gets trunked, and 
  10280.       it will do so in a FIFO way, that is, deleting the data that was first 
  10281.       written to the file. 
  10282.  
  10283.       To conclude here are some examples that set size restrictions based upon 
  10284.       file's size in Kb: 
  10285.  
  10286.             c $ \ myfile . log         MY _ ENV _ VAR          64
  10287.             c $ \ myfile . log         MY _ ENV _ VAR          s64 , 32
  10288.             boot \ myfile . log                          S23
  10289.             \ nouser \ myfile . log                       56 , 10
  10290.  
  10291.      By number of lines 
  10292.  
  10293.       To set a size control policy based upon the number of lines on a 
  10294.       particular file, the user states two numbers preceded by an 'L' at the 
  10295.       end of the EDYLOGS.STR line that references this particular file. Like 
  10296.       this: 
  10297.  
  10298.             boot\myfile.log                            L100,10
  10299.  
  10300.       These two numbers are interpreted (from left to right) as: 
  10301.  
  10302.         -  The Base (or Trunc) Number of Lines for the file (BNL) 
  10303.  
  10304.         -  The maximum allowed Increment in lines over BNL for the file (IBNL) 
  10305.  
  10306.       Note:  the second number, IBNL, is not mandatory. It's default value is 
  10307.       BNL/2 
  10308.  
  10309.        From them it is derived the maximum number of lines the specified log 
  10310.       file can have, which is BNL+IBNL . If EDYLOGFS finds the log file to have 
  10311.       a number of lines greater than this value it will trunc the log file to 
  10312.       have exactly BNL lines, and it will do so in a FIFO way, that is, 
  10313.       deleting the lines that were first written to the file. 
  10314.  
  10315.  The Input File for EDYLOGFS utility. 
  10316.  
  10317.   EDYLOGFS utility reads its input from the ASCII file EDYLOGS.STR located in 
  10318.  the SecureEntryPath\nouser directory. Each non-blank nor comment line of this 
  10319.  file states a file size control policy that is to be applied to a SecureEntry 
  10320.  log file. 
  10321.  
  10322.  EDYLOGS.STR Syntax Specification 
  10323.  
  10324.  What follows is a grammar specifying the syntax of the EDYLOGS.STR file: 
  10325.  
  10326.  (<LINE> | <COMMENT>) ('\n')* 
  10327.  
  10328.  <COMMENT> = ';' (any string) 
  10329.  
  10330.  <LINE>    = (<blanks>|<null>)  <PATHNAME> ( (<blanks> <ENV_VAR>) | <null> ) 
  10331.            <blanks> <SIZE_CTRL_POLICY> (<blanks>|<null>|<COMMENT>) 
  10332.  
  10333.  <null>    = the null string 
  10334.  
  10335.  <blanks>  = ('_'|'\t')+ 
  10336.  
  10337.  <PATHNAME>  = (<BOOT> | <DRIVE> | <null>) <os/2 pathname> 
  10338.  
  10339.  <ENV_VAR>  = any valid string for an environment variable 
  10340.  
  10341.  <SIZE_CTRL_POLICY> = (<POL_CHAR> | <null>) <TRUNC_SIZE> ( <null> | (',' 
  10342.            <OFFSET>) ) 
  10343.  
  10344.  <BOOT>    = any upper/lower case of the word 'BOOT'. 
  10345.  
  10346.  <DRIVE>   = <char> '$' 
  10347.  
  10348.  <os/2 pathname> = any valid os/2 pathname with no drive specification and 
  10349.            terminated by a base file name 
  10350.  
  10351.  <POL_CHAR> = 'S'|'s'|'L'|'l' 
  10352.  
  10353.  <TRUNC_SIZE> = <num> 
  10354.  
  10355.  <OFFSET>  = <num> 
  10356.  
  10357.  <char>    = ('a'-'z') U ('A'-'Z') 
  10358.  
  10359.  <num>     = any integer number 
  10360.  
  10361.  Note:  <num>, <ENV_VAR> and <os/2 pathname> tokens have size restrictions. If 
  10362.  any of this tokens has more characters than allowed, a syntax error will be 
  10363.  returned. 
  10364.  
  10365.  A sample EDYLOGS.STR file 
  10366.  
  10367.   This is an EDYLOGS.STR file example: 
  10368.  
  10369.   ; SENTRY  LOG  FILES  SIZE  CONTROLLER  EXAMPLE  FILE
  10370.  
  10371.   ; These  blank  lines  are  ignored .
  10372.  
  10373.   \ install \ myfile . log        64
  10374.   ;    Maximum  size  128  Kb .  Would  be  trunked  to  64  Kb .
  10375.   ;    File  " myfile . log "  would  be  searched  in  the  SecureEntryPath \ install  directory
  10376.  
  10377.   c $ \ install \ myfile . log     L10
  10378.   ;   Maximum  number  of  lines :  15 .  Would  be  trunked  to  10  lines .
  10379.   ;   File  " myfile . log "  would  be  searched  in  the  c : \ install  directory .
  10380.  
  10381.   c $ colon . myfile . log       MY _ ENV _ VAR     l100 , 50
  10382.   ;   Maximum  number  of  lines :  150 .  Would  be  trunked  to  100  lines .
  10383.   ;   File  " myfile . log "  would  be  searched  first  in  the  directory  pointed  by
  10384.   ;   MY _ ENV _ VAR  environment  variable ,  and ,  only  if  not  found ,  would  be
  10385.   ;   searched  in  the  c  drive  root  directory .
  10386.  
  10387.  The default EDYLOGS.STR file shipped with SecureEntry. 
  10388.  
  10389.   The default EDYLOGFS.STR file shipped with SecureEntry is as follows: 
  10390.  
  10391.   ;SENTRY LOG FILES SIZE CONTROLLER CONFIGURATION FILE
  10392.  
  10393.   \install\sentry.log                                        64,64 ;SENTRY INSTALLATION LOG FILE
  10394.  
  10395.   boot\edylkini.log                    SGM_INI_LOGPATH      64,64 ;STARTUP MESSAGES LOG FILE
  10396.  
  10397.   \nouser\edyadmin.log                 SGM_SL_LOGPATH        64,64 ;SENTRY ADMINISTRATION LOG FILE
  10398.  
  10399.   boot\os2\security\sesdb\edysla.log   SGM_SES_LOGPATH      64,64 ;SENTRY SESSION ACTIVITY LOG FILE
  10400.  
  10401.  After applying a service to your SecureEntry version the new default file 
  10402.  EDYLOGS.STR will be copied into the SecureEntryPath\EXEC directory. If the 
  10403.  file SecureEntryPath\NOUSER\EDYLOGS.STR has not been modified for your 
  10404.  installation, it will be then automatically updated; otherwise you will have 
  10405.  to manually update it in order to make the changes effective. 
  10406.  
  10407.  Command Line Syntax 
  10408.  
  10409.  The syntax to call EDYLOGFS utility from the command line is: 
  10410.  
  10411.    EDYLOGFS [(/V|/?)]
  10412.  
  10413.  /V 
  10414.             Verbose mode. 
  10415.  
  10416.  /? 
  10417.             Display usage help 
  10418.  
  10419.  Installing EDYLOGFS 
  10420.  
  10421.  There are two possible places for a call to EDYLOGFS : 
  10422.  
  10423.      Within the config.sys file. This is the default place and as is setup in 
  10424.       a regular SecureEntry installation. 
  10425.  
  10426.       To automatically control log file sizes at boot time it is recommended to 
  10427.       call EDYLOGFS.EXE from the CONFIG.SYS file. A way to do this is to add 
  10428.       the following line to your CONFIG.SYS file: 
  10429.  
  10430.           CALL=SecureEntryPath\exec\edylogfs.exe
  10431.  
  10432.      A second place where you could place a call to this utility is within any 
  10433.       user exit. SecureEntry grants that its log files are closed at this time 
  10434.       and thus the files can be truncated. 
  10435.  
  10436.  Error Return Codes 
  10437.  
  10438.  EDYLOGFS utility returns a zero on successful execution, otherwise something 
  10439.  went very wrong and a negative integer related to the cause of the problem is 
  10440.  returned. 
  10441.  
  10442.  What follows is a list of the error codes that EDYLOGFS utility might return: 
  10443.  
  10444.  -1        The SecureEntryPath could not be found. Either the environment 
  10445.            variable SGM_SHELL was not defined or pointed to an invalid 
  10446.            directory 
  10447.  
  10448.  -2        The input file (EDYLOGS.STR) could not be opened or didn't exist in 
  10449.            the SecureEntryPath\nouser directory 
  10450.  
  10451.  -3        I/O error on the input file (EDYLOGS.STR) 
  10452.  
  10453.  -4        The input file (EDYLOGS.STR) could not be closed 
  10454.  
  10455.  -5        The process EDYLOGFS.EXE could not allocate memory 
  10456.  
  10457.  -6        Program flow reached some point presumed to be unreachable 
  10458.  
  10459.  
  10460. ΓòÉΓòÉΓòÉ 9.9.12. EDYLOGBR ΓòÉΓòÉΓòÉ
  10461.  
  10462.  The EDYLOGBR program can be used to browse interactively the following 
  10463. SecureEntry log files, conveniently merged by event timestamp : 
  10464.  
  10465.      The session event log file 
  10466.  
  10467.      The administration log file 
  10468.  
  10469.      The Treelock audit file, if one is present in the machine 
  10470.  
  10471.  It can be run from a command line, by typing 
  10472.  
  10473.       EDYLOGBR
  10474.  
  10475.  or by launching the appropriate object in the SecureEntry workbench, 
  10476.  installation tools folder : 
  10477.  
  10478.  Once started, it will display the selected log files records, for your review, 
  10479.  as choosed from the View menu : 
  10480.  
  10481.      Errors/denials Will show only records logged for events that terminated 
  10482.       in an error condition or a denied access. 
  10483.  
  10484.      Simplified view Will show all of the log lines, but skip event start 
  10485.       records as well as Lan Server administration events, which are redundant 
  10486.       since the same record is also logged normally as a SecureEntry subsystem 
  10487.       administration event. 
  10488.  
  10489.      Full view Will show all the current logs information. 
  10490.  
  10491.      Event log Use this menu selection to include/exclude those records coming 
  10492.       from the SecureEntry session event log file. This log tracks session flow 
  10493.       events such as logon, lockup,... 
  10494.  
  10495.      Administration log Use this menu selection to include/exclude those 
  10496.       records coming from the SecureEntry administration log file. This log 
  10497.       tracks all of the activity issued against the SecureEntry administration 
  10498.       system. 
  10499.  
  10500.      Audit log Use this menu selection to include/exclude those records coming 
  10501.       from the SecureEntry Treelock audit file, if one is present in the NOUSER 
  10502.       directory as a machine default profile. This log tracks access attempts 
  10503.       to directories/files without the required permission. 
  10504.  
  10505.      Show icons Can be used to switch on/off the icon view from the result 
  10506.       container. 
  10507.  
  10508.      Refresh now can be used to force re-reading of the selected log files. 
  10509.  
  10510.  The File menu has the following options : 
  10511.  
  10512.      Export Allows you to save, in ASCII format, the displayed records. 
  10513.  
  10514.      Find You can filter off any records which do not include the chosen mask 
  10515.       with this option. Note that wildcards are allowed and you should assume 
  10516.       that the scanned string for each record is the concatenation of all the 
  10517.       column values for the intended record. So, for instance issuing a find 
  10518.       request with the mask : smith*add will find all records that refer to an 
  10519.       administration add operation issued by userid smith. 
  10520.  
  10521.      Find Next Will find the next matching record, given the current find mask 
  10522.       starting at the current selected record in the container. 
  10523.  
  10524.      Find Previous Will find the previous matching record, given the current 
  10525.       find mask starting at the current selected record in the container. 
  10526.  
  10527.      Quit Quits the application. 
  10528.  
  10529.  Now, some important notes about this utility : 
  10530.  
  10531.      First, take into account that log files are normally purged (old lines 
  10532.       removed) by the log files size controller utility at machine startup, so 
  10533.       it may be the case, when searching for very old events, that those are no 
  10534.       longer present in the log files. 
  10535.  
  10536.      The utility uses date and time formats as specified in the country object 
  10537.       of the OS/2 configuration folder, so it may render uncorrectly sorted 
  10538.       records if this configuration setting is changed for previously existing 
  10539.       log records. 
  10540.  
  10541.      For last, remember that the scope for the event and audit logs is local, 
  10542.       that is, you will only find events there that originated in the current 
  10543.       machine. However, and for administration events, the scope (for LAN 
  10544.       installations) is at a domain level, since there is a single 
  10545.       edministration log file in the domain server. 
  10546.  
  10547.  
  10548. ΓòÉΓòÉΓòÉ 9.9.13. EDYPHOTO ΓòÉΓòÉΓòÉ
  10549.  
  10550. The EDYPHOTO programs allow you to create and view a binary file with the 
  10551. necessary installation and configuration files for problem determination and 
  10552. solving. Both the photo taker and the photo display programs can be accessed 
  10553. from the SecureEntry Installation tools folder, or started manually. 
  10554.  
  10555. Double click over the photo generator icon to get a file named MMDDhhmm.BIN 
  10556. which contains a copy of the machine configuration files. Alternatively, you 
  10557. can generate a configuration photo file by typing : 
  10558.  
  10559.  
  10560.   EDYPHOTO
  10561.  
  10562. By typing the parameter '?' you can obtain a brief description of the complete 
  10563. syntax and parameters for this utility. 
  10564.  
  10565. Drop the previously generated file into the Photo viewer icon to view its 
  10566. contents. Alternatively, you can invoke the photo displayer by typing : 
  10567.  
  10568.  
  10569.   EDYPHDSP  [filename]
  10570.  
  10571. Note that photo archives are normally left with read-only attribute, so that 
  10572. they can not be mistakenly erased. 
  10573.  
  10574.  
  10575. ΓòÉΓòÉΓòÉ 9.10. The trace server ΓòÉΓòÉΓòÉ
  10576.  
  10577. The trace server is provided so that applications can record trace data. 
  10578.  
  10579. When applications run, information is gathered that can be used either for 
  10580. debugging purposes at development stage or to diagnose and fix problems at 
  10581. production time. 
  10582.  
  10583.      Operation modes 
  10584.  
  10585.      Changing operation mode 
  10586.  
  10587.      Loading the trace server 
  10588.  
  10589.  
  10590. ΓòÉΓòÉΓòÉ 9.10.1. Operation modes ΓòÉΓòÉΓòÉ
  10591.  
  10592. The trace server supports these modes of operation: 
  10593.  
  10594.      Tracing to memory (memory status) 
  10595.  
  10596.      Tracing to file (file status) 
  10597.  
  10598.  In addition, the trace server can be loaded but not operative (stop status). 
  10599.  
  10600.  To minimize the trace overhead, it is recommended to load the trace server in 
  10601.  not operative mode and change the operation mode dynamically. 
  10602.  Tracing to memory 
  10603.  
  10604.  The EDYTRDSP.EXE program is provided to display trace data on the screen. 
  10605.  
  10606.  The contents of the trace panel are updated only upon request. To refresh the 
  10607.  contents, select the appropriate action from the View pull-down menu or press 
  10608.  the F5 function key. 
  10609.  
  10610.  The font of the panel contents can be modified by dropping a new font from the 
  10611.  font palette. You should select a non-proportional font type; for example, 
  10612.  system monospaced, system vio, or courier. 
  10613.  Tracing to file 
  10614.  
  10615.  The EDYTRCS.EXE program is provided to save trace data in a file. 
  10616.  
  10617.  You can display the records in the trace file by using the EDYTRDSP.EXE 
  10618.  program. 
  10619.  
  10620.  
  10621. ΓòÉΓòÉΓòÉ 9.10.2. Changing operation mode ΓòÉΓòÉΓòÉ
  10622.  
  10623. The EDYTRSET.EXE program is provided to change the operation mode of the trace 
  10624. server. 
  10625.  
  10626. To start this program, enter: 
  10627.  
  10628.  
  10629.         EDYTRSET  [/S:status]
  10630.  
  10631. Where status is the mode of operation to which the trace server will be set: 
  10632.  
  10633.      M : Trace to memory 
  10634.  
  10635.      F : Trace to file 
  10636.  
  10637.      S : Not operative 
  10638.  
  10639.  The F parameter value applies only if the EDYTRCS.EXE program is loaded. 
  10640.  
  10641.  
  10642. ΓòÉΓòÉΓòÉ 9.10.3. Loading the trace server ΓòÉΓòÉΓòÉ
  10643.  
  10644. This section explains the trace server loading statement and the load time 
  10645. return codes. 
  10646.  
  10647. If you specify that the trace server stores trace data to a file and this trace 
  10648. file already exists, the loading parameters will not take effect. In addition, 
  10649. trace data will be appended to the existing trace file. 
  10650. Loading statement 
  10651.  
  10652. The following diagram shows the loading statement of the EDYTRCS program. To 
  10653. catch errors corresponding to this program that may happen at load time or at 
  10654. run-time, you can redirect the output to a file. 
  10655.  
  10656.  
  10657.      DETACH EDYTRCS [/S:status] [/M:buffersize]
  10658.                     [/T:filesize] [/PT:drive:path\filename]
  10659.                     [/PC:drive:path] [/N:tracenumber]
  10660.  
  10661. where : 
  10662.  
  10663.      Status is the mode of operation (MEMORY, FILE or STOP). FILE is the 
  10664.       default. 
  10665.  
  10666.      Buffersize is the Size of the memory buffer, in KB, where trace data is 
  10667.       stored. 
  10668.  
  10669.       The parameter applies only if the EDYTRCS.EXE program is loaded before 
  10670.       any application that records trace data. The parameter value ranges from 
  10671.       4 to 512. The default is 64. 
  10672.  
  10673.      Filesize is the maximum size of the file, in KB, where trace data is 
  10674.       stored. The file header should not be included. 
  10675.  
  10676.       The parameter value ranges from 64 to the available disk space. The 
  10677.       default is 150. 
  10678.  
  10679.      /PT and /PC Specifies the full path name of the trace file (optional). 
  10680.       Default name is EDYTRC.DAT and located where the EDYTRACE.INI file is 
  10681.       located. 
  10682.  
  10683.      Tracenumber is the number of valid traces to be kept after a stop 
  10684.       condition is fulfilled. 
  10685.  
  10686.       The parameter value ranges from 0 to 512. The default is 10. 
  10687.  
  10688.  Loading return codes 
  10689.  
  10690.  The following list shows the codes that can be returned at load time: 
  10691.  
  10692.         Value     meaning
  10693.         -----------------
  10694.         x'5A'     Error creating or opening trace file.
  10695.         x'5C'     Invalid parameter specified.
  10696.         x'5D'     Insufficient disk space for trace file.
  10697.         x'5F'     Trace file damaged.
  10698.         x'61'     Error initializing trace server.
  10699.         x'62'     Trace server already loaded
  10700.  
  10701.  
  10702. ΓòÉΓòÉΓòÉ 10. SecureEntry technical information ΓòÉΓòÉΓòÉ
  10703.  
  10704. This chapter contains a description of SecureEntry 3.0 used resources, 
  10705. environment variables, logs and configuration files. 
  10706.  
  10707.      SecureEntry directory structure 
  10708.  
  10709.      Environment variables 
  10710.  
  10711.      Configuration files 
  10712.  
  10713.      Log files 
  10714.  
  10715.      About processes and running contexts 
  10716.  
  10717.      About Object IDs 
  10718.  
  10719.      Session process description 
  10720.  
  10721.      Fine tuning SecureEntry 
  10722.  
  10723.      Error codes and messages 
  10724.  
  10725.  
  10726. ΓòÉΓòÉΓòÉ 10.1. SecureEntry directory structure ΓòÉΓòÉΓòÉ
  10727.  
  10728. The SecureEntry directory includes the following subdirectories : 
  10729.  
  10730.      The API directory, where the source code for implementing API calls as 
  10731.       well as NLS translation is located. 
  10732.  
  10733.      The DLL directory, where all SecureEntry DLLs reside. 
  10734.  
  10735.      The EXEC directory, where the command line interfaces and executables are 
  10736.       located. 
  10737.  
  10738.      The TOOLS directory, where the SecureEntry tools (integration programs) 
  10739.       are located. 
  10740.  
  10741.      The NOUSER directory, where the machine configuration data as well as the 
  10742.       security profiles repository is placed. 
  10743.  
  10744.      The WORK directory, where the assigned security profiles are downloaded 
  10745.       at logon time from the repository server. 
  10746.  
  10747.      The HELP directory, which holds the required help files. 
  10748.  
  10749.      The TEMPLATE directory, where the basic profiles templates as well as 
  10750.       component samples are located. 
  10751.  
  10752.      You may have also a TEMP directory, used by the administration tools to 
  10753.       do temporary copies of the repository files. 
  10754.  
  10755.      And by last, with a NLS dependant name, there is the workbench directory, 
  10756.       where the workbench objects are located. 
  10757.  
  10758.  
  10759. ΓòÉΓòÉΓòÉ 10.2. Environment variables ΓòÉΓòÉΓòÉ
  10760.  
  10761. The following environment variables are used by SecureEntry : 
  10762.  
  10763.      General purpose 
  10764.  
  10765.      Lan Server behavior specific 
  10766.  
  10767.      Related to session control 
  10768.  
  10769.      UCM specific 
  10770.  
  10771.      Administration specific 
  10772.  
  10773.      Related to Workplace Shell 
  10774.  
  10775.      Related to other components 
  10776.  
  10777.  
  10778. ΓòÉΓòÉΓòÉ 10.2.1. General purpose ΓòÉΓòÉΓòÉ
  10779.  
  10780.      SGM_SHELL This variable is mandatory and must be defined in your 
  10781.       config.sys file. It should be defined as a path to where the SecureEntry 
  10782.       files have been installed. By default, and unless otherwise specified, it 
  10783.       points to the C:SGMSHELL directory. 
  10784.  
  10785.      SGM_DB This environment variable is also mandatory, and must be defined 
  10786.       in your config.sys file. It points to the directory where the SecureEntry 
  10787.       profiles database (file EDYREGDB.VLB) is located. In network 
  10788.       environments, it can be a UNC path. 
  10789.  
  10790.  
  10791. ΓòÉΓòÉΓòÉ 10.2.2. Lan Server behavior specific ΓòÉΓòÉΓòÉ
  10792.  
  10793.      SGM_LS This variable is obsolete, and not generally used, but it must be 
  10794.       set to its original value if the MIGRADB utility is to be run in order to 
  10795.       be able to locate the original (SecureEntry 2.0) security profiles. 
  10796.  
  10797.      SGM_LS_IFLOGGED This environment variable sets the action to do for Lan 
  10798.       Server environments, when at logon time a domain logon is found in the 
  10799.       machine. The options are : 
  10800.  
  10801.  
  10802.                SET SGM_LS_IFLOGGED=INFORM   :  Do not logon. Display error message (default)
  10803.                SET SGM_LS_IFLOGGED=FORCE    :  Force a logoff and retry logon automatically
  10804.                SET SGM_LS_IFLOGGED=USE      :  Use the logged on session if the userid and
  10805.                                                domain found already logged match the
  10806.                                                requested ones. Inform otherwise.
  10807.                SET SGM_LS_IFLOGGED=FORCEUSE :  Use the logged on session if the userid and
  10808.                                                domain found already logged match the
  10809.                                                requested ones. Force a logoff and retry
  10810.                                                otherwise.
  10811.  
  10812.       Note that this variable can prove very useful for integrating SecureEntry 
  10813.       with other security products, so that the logon responsibility can be 
  10814.       shared. 
  10815.  
  10816.      SGM_SGMSHELL_GROUP SecureEntry/2 does internally provide shared access to 
  10817.       its repository for Lan Server clients through the hidden resource 
  10818.       SGMSHELL. Since its normal behavior is to grant such access for all 
  10819.       SecureEntry groups (those that start with letters 'SG'), it may be the 
  10820.       case, if you have or plan on having more than 64 such groups that the ACL 
  10821.       (Access Control List) for the SGMSHELL resource becomes too small, since 
  10822.       its limit is 64 entries. 
  10823.  
  10824.       To overcome such limit, this environment variable can be used. By 
  10825.       specifying it, you are effectively defining the name of the group which 
  10826.       should have access to the SGMSHELL resource, and that way, telling 
  10827.       SecureEntry not to update the ACL for this resource with accesses for 
  10828.       each group beginning with letters 'SG'. 
  10829.  
  10830.       So, if this variable has value 'USERS', all the users defined in the Lan 
  10831.       Server domain will be able to issue a SecureEntry signon. If it has 
  10832.       another value, then you are responsible to make sure that all SecureEntry 
  10833.       users belong to such group AND to the SecureEntry group ('SG'), in order 
  10834.       to be able to signon. 
  10835.  
  10836.       Note that the access to the SGMSHELL resource will be granted only after 
  10837.       at least one SecureEntry group has been redefined (added) or modified 
  10838.       (updated) with this environment variable in place. 
  10839.  
  10840.  
  10841. ΓòÉΓòÉΓòÉ 10.2.3. Related to session control ΓòÉΓòÉΓòÉ
  10842.  
  10843.      SGM_EDYLK_SHOW This variable can be used to force the startup dialog to 
  10844.       be kept hidden even if a EDYSTART.CMD file can be found within the root 
  10845.       directory of the boot drive, by assigning it a value of NO or 0. 
  10846.  
  10847.      SGM_HIDE_WAIT_DLGS Use this environment variable set to YES to avoid 
  10848.       showing of the 'xxxx in progress, please wait...' dialogs. If this 
  10849.       variable is not defined or set to other value, these dialogs will be 
  10850.       displayed. 
  10851.  
  10852.      SGM_INI_LOGPATH This environment variable sets up the path for the 
  10853.       EDYLKINI.LOG file, which keeps information about the startup process 
  10854.       activity. It is not set by the installation process. By default, if this 
  10855.       variable is not set, then this log file will be placed within the root 
  10856.       directory of the boot drive, that is, the same directory where the 
  10857.       EDYSTART.CMD file resides. 
  10858.  
  10859.      SGM_SES_LOGPATH This environment variable sets up the path for the 
  10860.       EDYSLA.LOG file, which keeps information about all of the machine's 
  10861.       session activity. It is not set by the installation process. By default, 
  10862.       if this variable is not set, then this log file will be placed within the 
  10863.       path pointed by the SESDBPATH variable (normally being the 
  10864.       OS2\SECURITY\SESDB path of the boot partition). If SES is not installed, 
  10865.       then the file will be stored in the SGMSHELL\NOUSER directory, unless 
  10866.       otherwise specified through the appropriate environment variable. 
  10867.  
  10868.      SGM_WPS_FASTLOAD  This variable is not mandatory. It determines the 
  10869.       activation sequence for Desktop  restrictions at WPS load time. The WPS 
  10870.       is loaded when the workstation is started, after an error causes it to 
  10871.       terminate, and after logging on when the SES environment variable 
  10872.       'RESTARTUSERSHELL' is set to YES. 
  10873.  
  10874.       If fast loading is disabled, the Desktop restrictions defined in NOUSER 
  10875.       are applied when the WPS is being loaded. Once the WPS is fully 
  10876.       initialized, the restrictions for all the other SecureEntry components 
  10877.       are applied; then, the user's Desktop restrictions are applied. 
  10878.  
  10879.       If fast loading is enabled, the user Desktop restrictions are applied as 
  10880.       soon as they are available (user identified); then, the restrictions for 
  10881.       all the other SecureEntry components are applied. This means that the 
  10882.       user can access the Desktop before additional restrictions are applied. 
  10883.       Fast loading can affect security if the user's Desktop restrictions allow 
  10884.       the user to manipulate desktop objects that should only be available when 
  10885.       all the other restrictions have been applied (e.g. starting an editor 
  10886.       before the File System restrictions have been applied). 
  10887.  
  10888.       A second effect of this variable is to specify 'when to rise the curtain' 
  10889.       at logon time, i.e, when will the user be able to use his desktop. If 
  10890.       enabled, the background bitmap will be closed as soon as the user is 
  10891.       identified. If disabled, this will be delayed until all security profiles 
  10892.       are active, thus not allowing user interaction with the machine until 
  10893.       that moment. 
  10894.  
  10895.       By default, fast loading is disabled. To enable it, set this variable to 
  10896.       YES or to any other value that starts with Y. 
  10897.  
  10898.      SGM_ALLOW_CAD Use this variable set to YES to allow one-touch Ctl-alt-del 
  10899.       to reboot the system, as any non SecureEntry OS/2 system does. By 
  10900.       default, the value of NO will enable SecureEntry specific support for 
  10901.       this key combination. The third allowed value is TWICE, which will force 
  10902.       twice-touch of the key combination to effectively reboot the machine. 
  10903.       This is useful for obtaining system dumps, since then Ctl-alt-del 
  10904.       followed by Ctl-alt-NumLock-NumLock will force the dump. 
  10905.  
  10906.      SGM_PM_WAIT_B4_KILL Use this environment variable to specify a wait 
  10907.       interval (in seconds) before SecureEntry decides to kill user context PM 
  10908.       running applications at logoff time after sending them the close message. 
  10909.       This becomes handy if you want to grant the logoff function to terminate 
  10910.       even if applications request for any user input when receiving the 
  10911.       WM_CLOSE PM message. So, for instance, if you are editing a file, and 
  10912.       then decide to logoff, the typical editor behavior would be to prompt 
  10913.       about saving or discarding changes at this time. Once the specified 
  10914.       timeout expires without further user interaction, the editor will be 
  10915.       killed and the logoff task resumed. 
  10916.  
  10917.       The default value is 20 seconds. Use a value of -1 to indicate an 
  10918.       indefinite timeout. Use a value of 0 to indicate no timeout, i.e, kill 
  10919.       applications immediately. In any case, and to avoid problems, it is 
  10920.       advisable to have this variable set to a value different from 0, since 
  10921.       some processes do not die 'elegantly' if they do not receive the WM_CLOSE 
  10922.       message and/or some data could be lost if they do not have an opportunity 
  10923.       to save it. 
  10924.  
  10925.      SET SGM_WAIT_B4_FLUSH Set this variable to xxx, where xxx is the number 
  10926.       of seconds to wait before flushing system buffers to disk at shutdown 
  10927.       time in case of a shutdown hang. 
  10928.  
  10929.       This means that a system power off will not imply a chkdsk during the 
  10930.       next IPL if xxx seconds have passed from the beginning of 
  10931.       WinShutdownSystem. 
  10932.  
  10933.       If "edyutil { toshtdwn | frshtdwn } reboot" was specified, then the 
  10934.       reboot will take place almost immediately if it succeeds, or after xxx 
  10935.       seconds have passed since the beginning of WinShutdownSystem. 
  10936.  
  10937.       If not specified, xxx defaults to 300 seconds (5 minutes). 
  10938.  
  10939.       If xxx==0, then 300 seconds (5 minutes) will be set. 
  10940.  
  10941.             Format:
  10942.  
  10943.             o If xxx begins with 0, then the value will be assumed to be octal
  10944.             o If xxx begins with 0x or 0X, then the value will be assumed to be hexadecimal.
  10945.             o Otherwise the value will be assumed to be decimal.
  10946.  
  10947.      SGM_SS_ALLOW_IU This environment variable does only make sense when using 
  10948.       RACF (or the RACF emulator) to synchronize passwords. It allows you to 
  10949.       customize the behavior of the signon process when Unknown user is 
  10950.       received from such logon procedure. The valid values are : 
  10951.  
  10952.         -  0 (default) Abort the signon process presenting to the user the 
  10953.            appropriate error message dialog box. 
  10954.  
  10955.         -  1 Gate to emergency logon *without* synchronizing passwords, so that 
  10956.            if the userid/password are valid at the branch, signon will succeed. 
  10957.            Note that password changes will not be allowed. 
  10958.  
  10959.         -  2 Continue signon process *without* synchronizing passwords, so that 
  10960.            if the used userid/password are valid at the branch, signon will 
  10961.            succeed. Password changes are allowed. 
  10962.  
  10963.         -  3 Continue signon process *without* synchronizing passwords, so that 
  10964.            if the used userid/password are valid at the branch, signon will 
  10965.            succeed. Password changes are allowed. Additionally, present the 
  10966.            user with a dialog box message informing about the event (message 
  10967.            number 106). 
  10968.  
  10969.       Note that using values different than 0 may cause userid/password 
  10970.       desynchronization problems, but may be a requirement for local 
  10971.       administration at your corporation. 
  10972.  
  10973.      SGM_SS_ALLOW_IP This environment variable does only make sense when using 
  10974.       RACF (or the RACF emulator) to synchronize passwords. It allows you to 
  10975.       customize the behavior of the signon process when Invalid password is 
  10976.       received from such logon procedure. The valid values are : 
  10977.  
  10978.         -  0 (default) Abort the signon process presenting to the user the 
  10979.            appropriate error message dialog box. 
  10980.  
  10981.         -  1 Gate to emergency logon *without* synchronizing passwords, so that 
  10982.            if the password is valid in the branch, signon will succeed. Note 
  10983.            that password changes will not be allowed. 
  10984.  
  10985.         -  2 Continue signon process *without* synchronizing passwords, so that 
  10986.            if the used password is valid at the branch, signon will succeed. 
  10987.            Password changes are allowed. 
  10988.  
  10989.         -  3 Continue signon process *without* synchronizing passwords, so that 
  10990.            if the used password is valid at the branch, signon will succeed. 
  10991.            Password changes are allowed. Additionally, present the user with a 
  10992.            dialog box message informing about the event (message number 106). 
  10993.  
  10994.       Note that using values different than 0 may cause password 
  10995.       desynchronization problems, but may be a requirement for local 
  10996.       administration at your corporation. 
  10997.  
  10998.      SGM_SS_IF_NO_AUTOLOCKUP Set this variable to NO if you want the screen 
  10999.       saver function disabled when there is no autolockup defined through the 
  11000.       active SES restrictions profile. i.e, you only want the screen saving 
  11001.       function to activate over a lockup screen, and not over an unprotected 
  11002.       user desktop. 
  11003.  
  11004.      SGM_SS_USEREXIT Set this variable to NO if you want to avoid the screen 
  11005.       saving function to be active while processing user exits. Note that in 
  11006.       this case, and if you provide your own logon or unlock dialogs, they will 
  11007.       be responsible for avoiding losing the focus and should provide their own 
  11008.       screen saving function. 
  11009.  
  11010.      SGM_SS_WHEN_LOCKUP Set this variable to YES if you want the screen saving 
  11011.       function to activate immediately when a lockup event is processed, 
  11012.       because of explicit user request or inactivity timeout. The customized 
  11013.       (security profile) screen saver inactivity timer will still be used for : 
  11014.  
  11015.         -  Popping up the screen saving function while not in lockup state (if 
  11016.            automatic lockup is not being used), or 
  11017.  
  11018.         -  Popping up the screen saver function while in lockup state after the 
  11019.            user forces the lockup panel to appear by issuing some keystrokes. 
  11020.  
  11021.      SGM_BACK_BITMAP Set this variable to NO if you want to disable displaying 
  11022.       of the background bitmap during the logon, logoff and lockup processes. 
  11023.       This is a feature not normally needed, but which may prove useful in 
  11024.       those installations where SecureEntry has to be integrated with existing 
  11025.       applications in a seamless way. 
  11026.  
  11027.       If you require more granularity, this same variable accepts an alternate 
  11028.       syntax, as follows: 
  11029.  
  11030.  
  11031.                 SET SGM_BACK_BITMAP=xyz
  11032.  
  11033.       Where: 
  11034.  
  11035.         -  x specifies where to display the background bitmap at startup. 
  11036.  
  11037.         -  y specifies where to display the background bitmap during 
  11038.            logon/logoff. 
  11039.  
  11040.         -  z specifies where to display the background bitmap during lockup. 
  11041.  
  11042.       Specify all values x, y and z as character '0' (disable) or '1' (enable). 
  11043.  
  11044.      SGM_DISABLE_SYSTEM_KEYS Set this variable to a number in order to specify 
  11045.       a given systemwide key to disable. the number can be any combination 
  11046.       (addition) of : 
  11047.  
  11048.                     Ctrl-Alt-Del .............. 1
  11049.                     Ctrl-Alt-NumlockNumlock ... 2
  11050.                     Ctrl-Esc .................. 4
  11051.                     Alt-Esc ................... 8
  11052.                     Alt-Tab .................. 16
  11053.                     Pause .................... 32
  11054.                     Print-Screen ............. 64
  11055.                     Left Windows key ........ 128
  11056.                     Right Windows key ....... 256
  11057.                     Windows select key ...... 512
  11058.  
  11059.       You can specify octal notation, by beginning the value with '0', 
  11060.       hexadecimal, beginning with '0x', or decimal (otherwise). Note that for 
  11061.       this feature to work correctly, you need to have a fully compatible 
  11062.       IBM-PS2 type keyboard. 
  11063.  
  11064.       If you configure a given key combination to be disabled through this 
  11065.       environment variable, and also to be enabled by the active EDYSES 
  11066.       profile, then the key will be disabled since a bitwise OR is done among 
  11067.       both masks to decide what to disable or not 
  11068.  
  11069.       The default value is 0 (do not disable system keys). 
  11070.  
  11071.      SGM_HOOK_SYSTEM_KEYS 
  11072.  
  11073.       This environment variable allows you to configure which of the supported 
  11074.       systemwide keys are to be hooked through a user exit. Allowed values are 
  11075.       the same as those of SGM_DISABLE_SYSTEM_KEYS. Note that if a given key 
  11076.       combination is disabled, then even if it is also configured to be hooked, 
  11077.       it will not be seen by the hook (user exit). If you configure a given key 
  11078.       combination to be hooked through this environment variable, and also to 
  11079.       not be hooked by the active EDYSES profile, then the hook will be active 
  11080.       since a bitwise OR is done among both masks to decide what to hook or not 
  11081.  
  11082.       The default value is 0 (do not hook system keys). 
  11083.  
  11084.      SGM_SES_CAD 
  11085.  
  11086.       Use this variable set to YES to force the system to handle Ctrl-Alt-Del 
  11087.       Requests through the SES API, instead of using SecureEntry's own device 
  11088.       driver, which is the default behavior. Using SecureEntry device driver to 
  11089.       check for CAD combination has the advantage that Ctrl-Alt-Del is 
  11090.       correctly distinguished from Ctrl-Alt-Numlock, but could not work if you 
  11091.       are working with non-standard keyboard devices. 
  11092.  
  11093.      SGM_SES_INACTIVITY 
  11094.  
  11095.       Use this variable set to YES to force the system to handle inactivity 
  11096.       timeouts through the SES API, instead of using SecureEntry's own device 
  11097.       driver, which is the default behavior. Using SecureEntry device driver to 
  11098.       check for inactivity has the advantage of increased accuracy, but could 
  11099.       not work if you apply a OS/2 base fixpack for which this feature has not 
  11100.       been tested. 
  11101.  
  11102.      SGM_HOOK_CANN_KEY 
  11103.  
  11104.       Use this environment variable to force SecureEntry *not* to internally 
  11105.       hook the Ctrl-Alt-NumLockNumLock key combination, by setting it to a NO 
  11106.       value. Note that SecureEntry does always by default handle this key 
  11107.       combination internally, to avoid potential problems when trying to obtain 
  11108.       a memory dump over a FAT partition in a disk where SecureEntry boot 
  11109.       protection is installed, since the memory dump process needs to have 
  11110.       direct BIOS access to the partition. 
  11111.  
  11112.       The drawback of this approach is that then and since the key combination 
  11113.       is intercepted by SecureEntry, such obtained system dumps do always point 
  11114.       CS:EIP to SecureEntry's EDYSLA.EXE kernel code, masking off the real 
  11115.       responsible module which caused the necessity of a dump in the first 
  11116.       place. 
  11117.  
  11118.       Summarizing, set this variable temporarily to no, if you want to obtain a 
  11119.       clean memory dump, but in this case you should either uninstall the boot 
  11120.       protection feature first, or be careful not to generate the dump into a 
  11121.       FAT partition. 
  11122.  
  11123.      SGM_USER_DLGS 
  11124.  
  11125.       If you are Overriding the default SecureEntry logon/lockup dialogs, then 
  11126.       you can use this environment variable to specify the name of your 
  11127.       executable modules or dialog titles which implement such overridden 
  11128.       windows. These will be used to identify which windows are allowed to 
  11129.       steal system modality over the lockup background bitmap when the 
  11130.       appropriate user exit is serviced. If this environment variable is not 
  11131.       used, then SecureEntry will assume that the first system modal window 
  11132.       that appears during user exit processing is the intended one, thus 
  11133.       allowing for a few seconds hole where an asynchronous system modal window 
  11134.       could be assumed to be the expected logon/lockup one. 
  11135.  
  11136.       Specify as many process names or window titles (enclosed between double 
  11137.       quotes) as you need, separated by commas, case insensitive and with 
  11138.       wildcards allowed. For instance, and if you are using the provided Sample 
  11139.       logon/unlock dialogs, you could specify: 
  11140.  
  11141.                     SET SGM_USER_DLGS=*LOGSAMP.EXE,*UNSAMP.EXE
  11142.  
  11143.      SGM_HIDE_EXIT_AFTER_LOGON 
  11144.  
  11145.       Use this environment variable to specify whether SecureEntry should keep 
  11146.       the logon background bitmap in place while the user exit after logon is 
  11147.       being processed (value YES), or leave this user exit to be processed 
  11148.       while the desktop is accessible (value NO). Note that the installation 
  11149.       process sets this variable to YES, to grant workstation security, since 
  11150.       treelock profiles enforcement is not active while this user exit is 
  11151.       running. 
  11152.  
  11153.      SGM_NC This environment variable is used to specify the NSC subsystems 
  11154.       that will act as password synchronizers when using the provided NSC/2 
  11155.       LMP. It will accept the following values: 
  11156.  
  11157.         -  ALL. All systems defined in the NSC profile will act as password 
  11158.            synchronizer subsystems. This is the default value. 
  11159.  
  11160.         -  The indexes, separated by commas, of the subsystems ( LOCAL, SERVER, 
  11161.            LANSERVER, HOST ) that are defined in the NSC configuration file 
  11162.            that you want to act as synchronizer subsystems. For example: 
  11163.  
  11164.            SGM_NC=2,3,6 
  11165.  
  11166.            In this case the subsystems defined in second, third and sixth 
  11167.            position within the NSC configuration file will act as synchronizer 
  11168.            subsystems. 
  11169.  
  11170.      SGM_SHUTDOWN_AT_LOGON_PANEL 
  11171.  
  11172.       Use this environment variable set to NO if you want to disable the 
  11173.       Shutdown button in the standard SecureEntry logon dialog, for instance, 
  11174.       because the machine is a server and you want to avoid casual shutdowns 
  11175.       initiated by unauthorized users. The default value if unspecified is YES. 
  11176.  
  11177.  
  11178. ΓòÉΓòÉΓòÉ 10.2.4. UCM specific ΓòÉΓòÉΓòÉ
  11179.  
  11180.      SGM_UCM_ENABLE This variable is to be defined only when UCM is being 
  11181.       used, in the centralized administration workstation. When set to YES, all 
  11182.       administration API requests are rerouted to the host through the DB2/DDCS 
  11183.       UCM agent. Note that you can set this variable in a per administration 
  11184.       session basis (i.e, not config.sys mandatory). 
  11185.  
  11186.      SGM_UCM_BRANCH This variable is to be defined only when UCM is being used 
  11187.       at the central UCM administrator workstation. It defines the default 
  11188.       branch name to be used by the administration utilities when adding a new 
  11189.       user to the corporate repository. 
  11190.  
  11191.      SGM_UCM_THIS_BRANCH This environment variable defines the branch name by 
  11192.       which this actual branch will be known at the host site. This is only for 
  11193.       informative purposes, so you can relate a given branch ID, which is given 
  11194.       automatically by the host, with a full sense identification string. Note 
  11195.       that this environment variable will only be really used once, whenever a 
  11196.       new branch is known to the host for the first time, so if you intend to 
  11197.       use it, you will have to set it up during the installation process of 
  11198.       your new branch servers. Once installed, the utility EDYBRNVW.EXE, can be 
  11199.       used at any workstation to view the branch synchronization and 
  11200.       identification data. 
  11201.  
  11202.      EDY_UCM_MAXROWS This variable can be defined to customize the maximum 
  11203.       number of rows that the UCM API will be able to handle as a query result 
  11204.       before returning the MANY_ROWS_FETCHED error. The default value not to 
  11205.       impose any limit. 
  11206.  
  11207.      SGM_REFRESH_PARMS This environment variable its not mandatory. This 
  11208.       variable should be defined in the config.sys file. Sets up the number of 
  11209.       retries for the branch refresh task in case of error, the time interval 
  11210.       between this repeat operations and the minutes interval to be used to 
  11211.       calculate the init hour of refresh branch. This variable can take the 
  11212.       following allowable values: SGM_REFRESH_PARMS=a,b,c with this ranges: 0 
  11213.       to 9, 0 to 99 and 0 to 180 for a, b, c respectively. The default values 
  11214.       if SGM_REFRESH_PARMS not specified is 1,15,30. 
  11215.  
  11216.      SGM_UCM_LOGPATH This environment variable sets up the path for the 
  11217.       EDYDIS.LOG file, which keeps information about the refresh activity of a 
  11218.       branch. It is not set by the installation process. By default, if this 
  11219.       variable is not set, then this log will be placed within then path 
  11220.       pointed by the SGM_DB variable (normally the server machine 
  11221.       SecureEntryPath\NOUSER directory). 
  11222.  
  11223.      SGM_NETBIOS_ADAPTER_NUM If your desired netbios protocol is not 
  11224.       configured over logical adapter 0 through MPTS, you can use this variable 
  11225.       to indicate which logical adapter to use for communicating between the 
  11226.       EDYSRV and the client machines. This communication is specially relevant 
  11227.       when using UCM or RACF validation. Valid values are 0,1,2 and 3. 
  11228.  
  11229.      SGM_FORCE_LUALIAS Use this environment variable to specify the 
  11230.       independent LU 6.2 alias to use for EDYSRV/EDYTP communications. If not 
  11231.       specified, (which is the default case), the default configured 
  11232.       independent LU 6.2 in communications manager will be used. 
  11233.  
  11234.      SGM_UCM_DBDFT Only for the UCM's administrator workstation. If you 
  11235.       catalog the UCM Database in the administrator workstation with an alias 
  11236.       different than 'UCM', then you must define this environment environment 
  11237.       variable with value: the UCM choosen alias. 
  11238.  
  11239.      SGM_UCM_CORPORATE_NAME Use this environment variable in the UCM 
  11240.       administrator workstation only. If you install UCM in a multi-enterprise 
  11241.       corporation with a separate UCM Database for each company and you wish to 
  11242.       be able issue all UCM administrator's tasks from a single workstation, 
  11243.       you must customize this variable as explained below: 
  11244.  
  11245.         -  Before you proceed with SecureEntry and UCM installation, you must 
  11246.            decide the institution name  to use for each company. This name will 
  11247.            be required by SecureEntry and UCM installation processes. If you 
  11248.            use the same name for each company then you will not need to use 
  11249.            this environment variable. 
  11250.  
  11251.         -  After installing SecureEntry in the UCM administrator's workstation, 
  11252.            make as many object copies as needed of the UCM, Users and groups 
  11253.            administration tool (as many as different existing UCM databases you 
  11254.            wish to administer). Make the same number of copies of the file 
  11255.            UCMADM.CMD located in \SGMSHELL\EXEC (i.e, UCMADM1.CMD..UCMADMn.CMD 
  11256.            ...). 
  11257.  
  11258.         -  Then set this environment variable for each UCMADMx.CMD file with 
  11259.            the appropriate institution name you want to administer. Make sure 
  11260.            also that each command file connects to the appropriate DB2 database 
  11261.            alias. 
  11262.  
  11263.         -  Now assign each command file to each of the copied UCM, Users and 
  11264.            groups administration tool object by directly editing the object's 
  11265.            settings. 
  11266.  
  11267.      SGM_FORCE_MODE Only for the domain controller workstations in your 
  11268.       branches. If you want to define another APPCMODE for the UCM 
  11269.       communications channel, you must define the APPCMODE's name in this 
  11270.       environment variable. This can be very useful in RACF and UCM 
  11271.       installations. If you use the RACF emulator provided by SecureEntry, this 
  11272.       environment variable is not needed. 
  11273.  
  11274.      SGM_SNA_TIMEOUT Use this environment variable to specify, in seconds, an 
  11275.       increased maximum timeout for APPC host responses. The default and 
  11276.       minimum allowable value is 180 seconds. 
  11277.  
  11278.  
  11279. ΓòÉΓòÉΓòÉ 10.2.5. Administration specific ΓòÉΓòÉΓòÉ
  11280.  
  11281.      SGM_SL_LOGMODE This variable is not mandatory, and can be used to set up 
  11282.       the logging mode for administration utilities. Its possible values are : 
  11283.  
  11284.  
  11285.               SET SGM_SL_LOGMODE=TEST    : Log all activity, including returned keyword
  11286.                                            values in view operations. Useful for testing
  11287.                                            your own developed agents
  11288.               SET SGM_SL_LOGMODE=ALL     : Log all activity
  11289.               SET SGM_SL_LOGMODE=UPDATES : Log only activity which modifies the database.
  11290.                                            This is the default setting
  11291.               SET SGM_SL_LOGMODE=NONE    : Log no activity
  11292.  
  11293.      SGM_SL_LOGPATH This environment variable sets up the path for the 
  11294.       EDYADMIN.LOG file, which keeps information about all administration 
  11295.       activity. It is not set by the installation process. By default, if this 
  11296.       variable is not set, then this log file will be placed within the path 
  11297.       pointed by the SGM_DB variable (normally the server machine 
  11298.       SecureEntryPath\NOUSER directory. 
  11299.  
  11300.      SGM_ADM_PRIV This environment variable can be used to filter which 
  11301.       administration functions are allowed by the agents selector for 
  11302.       administrator users. You can specify it by setting this variable to an 
  11303.       integer value where each bit specifies a given operation, either in 
  11304.       decimal, hex (0x...) or binary (0b...) : 
  11305.  
  11306.                 EDYUCM_PRIVILEGE_SUB_VIEW         0x00000001
  11307.                 EDYUCM_PRIVILEGE_SUB_ADD          0x00000002
  11308.                 EDYUCM_PRIVILEGE_SUB_UPDATE       0x00000004
  11309.                 EDYUCM_PRIVILEGE_SUB_DELETE       0x00000008
  11310.                 EDYUCM_PRIVILEGE_RESOURCE_VIEW    0x00000010
  11311.                 EDYUCM_PRIVILEGE_RESOURCE_ADD     0x00000020
  11312.                 EDYUCM_PRIVILEGE_RESOURCE_UPDATE  0x00000040
  11313.                 EDYUCM_PRIVILEGE_RESOURCE_DELETE  0x00000080
  11314.                 EDYUCM_PRIVILEGE_GROUP_VIEW       0x00000100
  11315.                 EDYUCM_PRIVILEGE_GROUP_ADD        0x00000200
  11316.                 EDYUCM_PRIVILEGE_GROUP_UPDATE     0x00000400
  11317.                 EDYUCM_PRIVILEGE_GROUP_DELETE     0x00000800
  11318.                 EDYUCM_PRIVILEGE_USER_VIEW        0x00001000
  11319.                 EDYUCM_PRIVILEGE_USER_ADD         0x00002000
  11320.                 EDYUCM_PRIVILEGE_USER_UPDATE      0x00004000
  11321.                 EDYUCM_PRIVILEGE_USER_DELETE      0x00008000
  11322.                 EDYUCM_PRIVILEGE_USER_GRP_VIEW    0x00010000
  11323.                 EDYUCM_PRIVILEGE_USER_GRP_ADD     0x00020000
  11324.                 EDYUCM_PRIVILEGE_USER_GRP_UPDATE  0x00040000
  11325.                 EDYUCM_PRIVILEGE_USER_GRP_DELETE  0x00080000
  11326.                 EDYUCM_PRIVILEGE_RES_USER_VIEW    0x00100000
  11327.                 EDYUCM_PRIVILEGE_RES_USER_ADD     0x00200000
  11328.                 EDYUCM_PRIVILEGE_RES_USER_UPDATE  0x00400000
  11329.                 EDYUCM_PRIVILEGE_RES_USER_DELETE  0x00800000
  11330.                 EDYUCM_PRIVILEGE_GRP_GRP_VIEW     0x01000000
  11331.                 EDYUCM_PRIVILEGE_GRP_GRP_ADD      0x02000000
  11332.                 EDYUCM_PRIVILEGE_GRP_GRP_UPDATE   0x04000000
  11333.                 EDYUCM_PRIVILEGE_GRP_GRP_DELETE   0x08000000
  11334.                 EDYUCM_PRIVILEGE_RES_GRP_VIEW     0x10000000
  11335.                 EDYUCM_PRIVILEGE_RES_GRP_ADD      0x20000000
  11336.                 EDYUCM_PRIVILEGE_RES_GRP_UPDATE   0x40000000
  11337.                 EDYUCM_PRIVILEGE_RES_GRP_DELETE   0x80000000
  11338.  
  11339.       So, for instance : 
  11340.  
  11341.                 SET SGM_ADM_PRIV=0x11111111
  11342.       Would allow only view access through SecureEntry administration tools, 
  11343.       and 
  11344.  
  11345.                 SET SGM_ADM_PRIV=0x1111F111
  11346.       Would allow view access to all of SecureEntry repository, plus 
  11347.       add/update/and delete access for user objects. 
  11348.  
  11349.       Note however, that using this variable only makes sense if you are 
  11350.       providing a 'closed' environment to your local branch administrators, 
  11351.       i.e, they do not have access to a command line. If this variable is not 
  11352.       specified, unlimited access is granted to administrator users. 
  11353.  
  11354.  
  11355. ΓòÉΓòÉΓòÉ 10.2.6. Related to Workplace Shell ΓòÉΓòÉΓòÉ
  11356.  
  11357.      SGM_WPS_LOADCLASS  This variable is not mandatory. It can be used to 
  11358.       specify WPS classes that need to be loaded before the SecureEntry 
  11359.       profiles are activated during the WPS loading. It should only be defined 
  11360.       if custom components are defined that include WPS code that needs to be 
  11361.       initialized before activating the user profiles. The value of the 
  11362.       variable should be a list of class names separated with comas, with no 
  11363.       blanks allowed. 
  11364.  
  11365.      SGM_WPS_DISABLE  This variable is not mandatory, and should only be used 
  11366.       during problem determination. When it is set to YES, or to any other 
  11367.       value that starts with Y, the SecureEntry WPS classes that replace the 
  11368.       standard classes are disabled. 
  11369.  
  11370.      SGM_WPS_TRACE  This variable is not mandatory, and is only useful during 
  11371.       problem determination. It allows to define the level of trace detail of 
  11372.       different subsystems in the WPS code. The value must be a list of 
  11373.       subsystems with their corresponding level of detail. The defined 
  11374.       subsystems and their default level of detail are: RES-3: Object 
  11375.       restrictions CLS-3: Class loading OBJ-3: Object loading POS-3: Object 
  11376.       position management MGR-3: Profile and event management DRG-3: Drag and 
  11377.       Drop SHD-3: Shadow folders MTX-5: Mutex semaphore management ASY-5: 
  11378.       Asynchronous events management Examples: 
  11379.  
  11380.               If the variable is not defined and the SNTOBJ trace level is set to 1,
  11381.             none of this subsystems will trace its actions. If the trace level is
  11382.             changed to 3, all the subsystems except MTX and ASY will trace their
  11383.             actions.
  11384.               If the variable is set to SGM_WPS_TRACE=RES-1,DRG-1, and the SNTOBJ
  11385.             trace level is set to 2, the RES and DRG subsystems will trace their
  11386.             actions.
  11387.  
  11388.      SGM_WPS_PRINTJOBS  This variable is not mandatory. It defines how 
  11389.       restrictions should be applied on print jobs. Its possible values are: 
  11390.       RESTRICT_NONE, RESTRICT_BY_TITLE, RESTRICT_BY_DEFAULT or 
  11391.       RESTRICT_PRINTJOBS.  When it is set to RESTRICT_NONE, no restrictions are 
  11392.       applied on print jobs, no matter their title.  When it is set to 
  11393.       RESTRICT_BY_TITLE, print jobs are restricted with the standard mechanism: 
  11394.       if a matching title is found in the Desktop Restrictions profile, the 
  11395.       specified restrictions are used; if no matching title is found, the 
  11396.       restrictions specified for the DEFAULT entry are used; if there is no 
  11397.       DEFAULT entry, no restrictions are applied.  When it is set to 
  11398.       RESTRICT_BY_DEFAULT, print jobs are restricted with the restrictions 
  11399.       specified for the DEFAULT entry in the Desktop Restrictions profile, no 
  11400.       matter their title; if there is no DEFAULT entry, no restrictions are 
  11401.       applied.  When it is set to RESTRICT_PRINTJOBS, all print jobs are 
  11402.       treated as if their title were RESTRICT_PRINTJOBS. If the  Desktop 
  11403.       Restrictions profile contains a RESTRICT_PRINTJOBS entry, its 
  11404.       restrictions are used for all print jobs, no matter their title; if there 
  11405.       is no RESTRICT_PRINTJOBS , the restrictions specified for the DEFAULT 
  11406.       entry are used; if there is no DEFAULT entry, no restrictions are 
  11407.       applied.  The default value is RESTRICT_BY_TITLE. 
  11408.  
  11409.      SGM_WPS_NONDESKTOP  This variable is not mandatory. It defines how 
  11410.       restrictions should be applied on objects that are not located on the 
  11411.       current Desktop or Nowhere folders or any of their subfolders. Its 
  11412.       possible values are: RESTRICT_NONE, RESTRICT_BY_TITLE, 
  11413.       RESTRICT_BY_DEFAULT or RESTRICT_NONDESKTOP.  To avoid a severe 
  11414.       performance degradation, the restrictions applied to these objects only 
  11415.       affect their menus and setting pages: no change is done regarding their 
  11416.       styles (visible or not, deleteable or not...). If their styles need to be 
  11417.       restricted, the standard OS/2 mechanism can be used, either on 
  11418.       installation or by means of a user exit if they need to be changed 
  11419.       dynamically (e.g. SysSetObjectData(ObjectPath, 
  11420.       "NOTVISIBLE=YES;NODELETE=YES")).  When it is set to RESTRICT_NONE, no 
  11421.       restrictions are applied on these objects, no matter their title.  When 
  11422.       it is set to RESTRICT_BY_TITLE, these objects are restricted with the 
  11423.       standard mechanism: if a matching title is found in the Desktop 
  11424.       Restrictions profile, the specified restrictions are used; if no matching 
  11425.       title is found, the restrictions specified for the DEFAULT entry are 
  11426.       used; if there is no DEFAULT entry, no restrictions are applied. The use 
  11427.       of this value can cause a noticeable delay when opening these objects' 
  11428.       settings notebook or when displaying their menu.  When it is set to 
  11429.       RESTRICT_BY_DEFAULT, these objects are restricted with the restrictions 
  11430.       specified for the DEFAULT entry in the Desktop Restrictions profile, no 
  11431.       matter their title; if there is no DEFAULT entry, no restrictions are 
  11432.       applied.  When it is set to RESTRICT_NONDESKTOP, these objects are 
  11433.       treated as if their title were RESTRICT_NONDESKTOP. If the  Desktop 
  11434.       Restrictions profile contains a RESTRICT_NONDESKTOP entry, its 
  11435.       restrictions are used for all these objects, no matter their title; if 
  11436.       there is no RESTRICT_NONDESKTOP , the restrictions specified for the 
  11437.       DEFAULT entry are used; if there is no DEFAULT entry, no restrictions are 
  11438.       applied.  The default value is RESTRICT_NONE. 
  11439.  
  11440.      SGM_WPS_BEEP This variable is also not mandatory, and can be used to make 
  11441.       SecureEntry beep through the speaker at certain times for debugging 
  11442.       purposes. The supported values are : 
  11443.  
  11444.         -  REFRESH : A beep will sound at the beginning and end of a desktop 
  11445.            refresh. 
  11446.  
  11447.         -  EXIT : A beep will sound whenever the  WPS dies. 
  11448.  
  11449.         -  TRAP : Will sound a beep whenever a trap is processed by SecureEntry 
  11450.            WPS code (default). 
  11451.  
  11452.      SGM_WPS_SKIP_PREPOPULATE This variable controls whether SecureEntry 
  11453.       should inhibit the default folders population done by the OS/2 system at 
  11454.       startup. A standard OS/2 WARP system WorkPlace prepopulates the following 
  11455.       folders at startup : 
  11456.  
  11457.         -  <WP_TOOLS> 
  11458.  
  11459.         -  <WP_GAMES> 
  11460.  
  11461.         -  <WP_DRIVES> 
  11462.  
  11463.         -  <WP_CONFIG> 
  11464.  
  11465.         -  <WP_OS2SYS> 
  11466.  
  11467.         -  <WP_INFO> 
  11468.  
  11469.         -  <WP_PROMPTS> 
  11470.  
  11471.         -  <WP_SERVER> 
  11472.  
  11473.       Doing this task takes several seconds, and it may be very well the case 
  11474.       that this set of folders do not belong to the 'most used' ones on your 
  11475.       system, in which case it is just spending time without purpose. This 
  11476.       together with the fact that up to recent fix levels on OS/2 WARP fix code 
  11477.       this 'prepopulate thread' could potentially aggravate an internal timing 
  11478.       dependant deadlock problem of workplace at startup, have been the reasons 
  11479.       for adding the present environment variable. 
  11480.  
  11481.       The variable can take the following values : 
  11482.  
  11483.         -  ALL Skip all folders populate at startup 
  11484.  
  11485.         -  NONE Skip no folders populate at startup (default if not present) 
  11486.  
  11487.         -  <ObjectId>..<ObjectId> Skip listed folders populate at startup 
  11488.  
  11489.       SecureEntry installs itself setting the ALL value in config.sys file. 
  11490.  
  11491.      SGM_EDYSC_DISABLE This variable can be used to disable all the 
  11492.       WarpCenter's SENTRY features leaving the SmartCenter Workplace Shell 
  11493.       class as original defined. Allowed values are YES or NO 
  11494.  
  11495.      SGM_WPS_IGNORE_ADMIN You can override SecureEntry specific workplace 
  11496.       shell functionality done for administrators by setting this variable to 
  11497.       YES. Specifically, this refers to the visibility state of the SecureEntry 
  11498.       workbench folder and the added folder's popup menu entry 'Save 
  11499.       positions'. Note that you can cancel this setting temporarily by 
  11500.       executing the provided EDYWPADM.CMD command, as supplied within the 
  11501.       SecureEntry path, TOOLS directory. 
  11502.  
  11503.  
  11504. ΓòÉΓòÉΓòÉ 10.2.7. Related to other components ΓòÉΓòÉΓòÉ
  11505.  
  11506.      SGM_WIN_EXPLICITMENUS Set this variable to NO if you want the windows 
  11507.       behavior component to enforce the <DEFAULT> system menu settings for all 
  11508.       windows of the system. Note that the default value is set to YES, so that 
  11509.       system menu settings will only be enforced for explicitly configured 
  11510.       windows. Setting the NO value will cause system menu options that are 
  11511.       managed by the applications to become active/inactive as specified, with 
  11512.       unpredictable results unless tested. 
  11513.  
  11514.      SGM_OVER_MK This variable can be used to control what information is used 
  11515.       as a seed for floppy encryption with the institution dependant algorithm. 
  11516.  
  11517.       If not specified or has the value NONE, then no override is made to the 
  11518.       seed calculation algorithm, so that the institution name, configuration 
  11519.       type, server name and UCM/RACF flags are used to build up the seed. The 
  11520.       net effect is that diskettes encrypted this way will end up being branch 
  11521.       specific, as long as the domain server name is unique across branches. 
  11522.  
  11523.       The value ALL (default as installed) ensures that only the institution 
  11524.       name will be used to generate the encryption seed. 
  11525.  
  11526.       Any other value implies to use the installation fields institution name, 
  11527.       configuration type, server name and UCM/RACF flags to generate the master 
  11528.       key for floppy encryption, but assuming that the server name is fixed to 
  11529.       the one specified through the environment variable. 
  11530.  
  11531.       SecureEntry will set this variable to the value ALL at installation time. 
  11532.  
  11533.      WarpCenter Environment Variables. 
  11534.  
  11535.      SGM_ROAM_LOGPATH This environment variable sets up the path for the 
  11536.       EDYROAM.LOG file, which keeps information about the Public Applications 
  11537.       component in LAN Server environments. It is not set by the installation 
  11538.       process. By default, if this variable is not set, this log file will be 
  11539.       placed within the subdirectory NOUSER of the path pointed to by the 
  11540.       environment variable SGM_SHELL. 
  11541.  
  11542.  
  11543. ΓòÉΓòÉΓòÉ 10.3. Configuration files ΓòÉΓòÉΓòÉ
  11544.  
  11545. SecureEntry 3.0 has some control files which define its configuration and 
  11546. installed version. These are : 
  11547.  
  11548.      SENTRY.SIG This file contains information about the SecureEntry driver 
  11549.       that is installed. A sample follows : 
  11550.  
  11551.  
  11552.               PRODUCT=Secure Entry
  11553.               VERSION=3.0
  11554.               BUILD=69
  11555.               BUNDLES=8
  11556.               DATE=23 Sep 1996 20:46:05
  11557.  
  11558.       This file is located in the SecureEntryPath, INSTALL subdirectory. 
  11559.  
  11560.      SENTRY.CNF This file contains information about how SecureEntry has been 
  11561.       configured. It is almost self-explanatory, with the output coming 
  11562.       directly from the installation configuration panel. A sample of this file 
  11563.       follows : 
  11564.  
  11565.               INSTITUTION=Jone's Bank
  11566.               INSTALLPATH=C:\SGMSHELL
  11567.               INSTALLFROM=A:\
  11568.               CONFIGURATION=1
  11569.               USERACF=0
  11570.               USEUCM=0
  11571.               INSTALLSOURCES=1
  11572.  
  11573.       The only not so obvious field here is the 'CONFIGURATION' one, which can 
  11574.       have the following values : 
  11575.  
  11576.         1. Standalone workstation 
  11577.  
  11578.         2. IBM Lan Server networked 
  11579.  
  11580.         3. Network installation. Not Lan Server. 
  11581.  
  11582.       This file is located in the SecureEntryPath, INSTALL subdirectory. 
  11583.  
  11584.      EDYSSLMP.DAT This file describes the configuration of the LMP's (Logon 
  11585.       procedures) to be called, as well as the location of the users and 
  11586.       security profiles databases. Although its format is internal to 
  11587.       SecureEntry, it is an ASCII file and thus, can be seen or edited. You 
  11588.       should never touch this file unless otherwise specified by the 
  11589.       documentation or SecureEntry development team. This file is located in 
  11590.       the SecureEntryPath, NOUSER subdirectory. 
  11591.  
  11592.       In order to read this file, you can use any ASCII editor, since this is 
  11593.       an editable file, which must match the following rules : 
  11594.  
  11595.         -  The file is splitted into two blocks : 
  11596.  
  11597.              -- The LMPs description list, where all composing logon procedures 
  11598.                 are described by their unique two-letter specifier : 
  11599.  
  11600.                   1. SS For the SecureEntry synchronizer LMP. This is mandatory 
  11601.                      and should always be the first one. 
  11602.  
  11603.                   2. RF For the RACF validation LMP. This one, if present, has 
  11604.                      to be the second one, since it is mandatory that this LMP 
  11605.                      synchronizes passwords to all of the other ones. 
  11606.  
  11607.                   3. UF For the RACF emulator LMP. This one, if present, has to 
  11608.                      be the second one, since it is mandatory that this LMP 
  11609.                      synchronizes passwords to all of the other ones. You can 
  11610.                      install the RACF emulator instead the RACF validation. 
  11611.  
  11612.                   4. UC For the UCM channel LMP. This one, if present, has to 
  11613.                      be immediately after the RF or UF LMP, and its mission is 
  11614.                      to update the LAN configuration at logon time before the 
  11615.                      Lan Server (or SecureEntry registry) LMPs do signon, so 
  11616.                      that they find the requesting user already present in the 
  11617.                      Lan. 
  11618.  
  11619.                   5. LS For the Lan Server LMP, in lan server environments. 
  11620.                      This is the LMP which controls signon to Lan Server. 
  11621.  
  11622.                   6. SR For the SecureEntry Registry LMP, in standalone 
  11623.                      environments. 
  11624.  
  11625.                   7. xx Any other combination represents a user written LMP, 
  11626.                      which must coded in the DLL named EDYxxLMP.DLL. 
  11627.  
  11628.              -- The database description specifiers, contains two lines, which 
  11629.                 describes where the location of the users database is and where 
  11630.                 that one for the security profiles. The only supported values 
  11631.                 are : 
  11632.  
  11633.                   -  SR or LS For USERS_DATABASE. 
  11634.  
  11635.                   -  SR For SCPRF_DATABASE. 
  11636.  
  11637.         -  The optional parameters that can be placed by the side of the LMPs 
  11638.            list describe whether the LMP will require a DOMAIN name and which 
  11639.            default value to present at signon time. 
  11640.  
  11641.       Follows a sample EDYSSLMP.DAT file : 
  11642.  
  11643.  
  11644.                  SS 1 SRVMAR
  11645.                  LS 1 SRVMAR
  11646.                  USERS_DATABASE LS
  11647.                  SCPRF_DATABASE SR
  11648.  
  11649.      EDYREGDB.VLB This is a ciphered library file which contains the security 
  11650.       profiles and/or users and group information. You can not list or modify 
  11651.       this file, and it is completely managed by SecureEntry. The CREADB 
  11652.       utility can be used to regenerate a new, empty one by administrators. 
  11653.       This file is located in the SecureEntryPath, NOUSER subdirectory of all 
  11654.       standalone workstations or server machines of networked environments. 
  11655.  
  11656.      EDYKILL.NOT This is an ASCII file which contains a list of processes not 
  11657.       to be killed at any time. Since in regular OS/2 installations it is 
  11658.       normal for daemons and detached processes to never expect a 
  11659.       DosKillProcess call to kill them, it is frequent that many of this kind 
  11660.       of processes are not even tested for this event, and may abend or cause 
  11661.       unexpected behavior if they are killed. In the other hand, SecureEntry 
  11662.       can not afford not to kill all superuser/user context running processes 
  11663.       at shutdown/logoff time unless explicitly said so, since any PM program 
  11664.       could theoretically resume user interaction at this point, jeopardizing 
  11665.       system security. 
  11666.  
  11667.       So, the net idea is that if you find shutdown traps by a specific 
  11668.       process, add its name to the list and it will not be killed. This file is 
  11669.       located in the SecureEntryPath, NOUSER directory, and accepts wildcards 
  11670.       in the process names specification. 
  11671.  
  11672.       A second purpose of this file is to specify 'orderly close' commands for 
  11673.       whenever SecureEntry has to kill a given process. This is useful either 
  11674.       for performance reasons, or as a last resort when a given application 
  11675.       does not end correctly because of interprocess dependencies. 
  11676.  
  11677.       After applying a service to your SecureEntry version the new default file 
  11678.       EDYKILL.NOT will be copied into the SecureEntryPath\EXEC directory. If 
  11679.       the file SecureEntryPath\NOUSER\EDYKILL.NOT has not been customized for 
  11680.       your installation, then it will be automatically updated; otherwise you 
  11681.       will have to manually update it in order to make the changes effective. 
  11682.  
  11683.       Read the comments section of the same file for more information on how to 
  11684.       alter it. 
  11685.  
  11686.      EDYSTART.CMD 
  11687.  
  11688.       This file is the SecureEntry version of the STARTUP.CMD file and has the 
  11689.       same purpose. The reason why it is different is that it must be started 
  11690.       by SecureEntry in order to grant a proper secure machine startup. Read 
  11691.       the chapter The startup process in order to know more on how to use it. 
  11692.  
  11693.      EdyStart object 
  11694.  
  11695.       This object, located within the SecureEntry NOUSER directory, acts as a 
  11696.       folder and can contain a list of shadows which substitute the traditional 
  11697.       OS/2 startup folder. The difference being that, by placing your startup 
  11698.       objects here, SecureEntry grants that these programs will be started in 
  11699.       superuser context by waiting for those before proceeding with logon 
  11700.       (assuming the objects represent synchronous tasks). 
  11701.  
  11702.      EDYUCFPW.DSC 
  11703.  
  11704.       This is an ASCII file which contains the list of valid characters and the 
  11705.       maximum and minimum allowable length for password validation as needed by 
  11706.       the UF RACF SecureEntry emulator. By default this file has maximum length 
  11707.       for passwords set to 14 and the minimum one set to 4 characters. The 
  11708.       default allowable character set is as follows: 
  11709.  
  11710.                   A..Z, 0..9, a..z and @, # and $.
  11711.  
  11712.       Remember that if you want to update this file, you will have to update 
  11713.       the same definitions at the Host site. 
  11714.  
  11715.  
  11716. ΓòÉΓòÉΓòÉ 10.4. SecureEntry Log files ΓòÉΓòÉΓòÉ
  11717.  
  11718. If at any time you want to check out SecureEntry activity, there are several 
  11719. files which can be used for tracing or auditing purposes : 
  11720.  
  11721.      The installation log file 
  11722.  
  11723.       This file reflects all the installation/service activity due to the 
  11724.       machine. It is named 'SENTRY.LOG', and placed in your SecureEntryPath, 
  11725.       INSTALL directory. A sample of this file follows : 
  11726.  
  11727.             SecureEntry start install : 23 Sep 1996 21:26:56
  11728.             Applying: Secure Entry Version: 3.0 Build level: 69
  11729.             Secure Entry start setup : 23 Sep 1996 21:34:03
  11730.             Relocating base system files..
  11731.             Creating SENTRY database..
  11732.             Creating SENTRY logon configuration file..
  11733.             Creating SENTRY STARTUP file..
  11734.             Setting up default profiles
  11735.             Modifying CONFIG.SYS file..
  11736.             Modifying SES configuration file..
  11737.             Registering SYS_DLLs..
  11738.             SecureEntry start crwrk : 23 Sep 1996 21:34:18
  11739.             The folder 'SecureEntry ^Workbench' has been created successfully.
  11740.             The shadow of 'SecureEntry ^Workbench' has been created successfully.
  11741.             Saving current launchpad..
  11742.             SENTRY setup completed correctly..
  11743.             You must shutdown now to activate changes and start Secure Entry.
  11744.             Workstation setup completed OK
  11745.  
  11746.      The startup process file 
  11747.  
  11748.       This file has all messages posted to the startup process during its 
  11749.       execution. it is named 'EDYLKINI.LOG', and placed in the same directory 
  11750.       where the 'EDYSTART.CMD' file must reside, that is, the root directory of 
  11751.       the boot drive (unless otherwise specified with the environment variable 
  11752.       SGM_INI_LOGPATH). This file is useful in order to know what went wrong in 
  11753.       a machine's startup if it was attempted in an unattended environment. See 
  11754.       the startup process description for more detailed information. 
  11755.  
  11756.      The administration log file 
  11757.  
  11758.       This file reflects all the activity of the administration API. It is 
  11759.       named 'EDYADMIN.LOG', and placed in your SecureEntryPath, NOUSER 
  11760.       directory of all the standalone workstations, or of the Network 
  11761.       environment SecureEntry servers. You can change this location by setting 
  11762.       up a 'SGM_SL_LOGPATH' environment variable within the config.sys file. A 
  11763.       sample of this file follows : 
  11764.  
  11765.             Date       Time   Computer User   Typ Process      Agent   Rc  Actn Subs ObjType Obj1 Obj2 Keys
  11766.             -----------------------------------------------------------------------------------------------
  11767.             23/09/1996 22:50:14        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] ADD  SENT Group GRUPO      LAN_DATA
  11768.             23/09/1996 22:50:27        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] ADD  SENT User  LUIS       LAN_DATA
  11769.             23/09/1996 22:50:28        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] ADD  SENT UserGroup LUIS,GRUPO
  11770.             23/09/1996 22:51:57        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] UPDT SENT Group GRUPO      FLOPPY_DISK
  11771.             23/09/1996 23:01:34        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] ADD  SENT User  ADMIN2     LAN_DATA
  11772.             23/09/1996 23:01:58        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] UPDT SENT User  ADMIN2     LAN_DATA
  11773.             23/09/1996 23:02:26        EDYADMIN A EDYSNADM.EXE EDYSEAGT[ ] UPDT SENT User  EDYADMIN   LAUNCHPAD
  11774.  
  11775.      The session event log file 
  11776.  
  11777.       This file reflects all the session activity for a given machine. It is 
  11778.       named 'EDYSLA.LOG', and placed in the OS2\SECURITY\SESDB path of the 
  11779.       machine's boot partition. You can change this location by setting up a 
  11780.       'SGM_SES_LOGPATH' environment variable within the config.sys file. A 
  11781.       sample of this file follows : 
  11782.  
  11783.  
  11784.               Date     Time      Event    Phase  Result  UserId              Additional info
  11785.             -------- -------- ----------- ------ ------ -------- ---------------------------------------
  11786.             11/21/96 11:43:13 DOMAIN      QUERY   [ ]            Default Domain: SEDOMAIN
  11787.             11/21/96 11:44:58 SHUTDOWN    START   [ ]
  11788.             11/21/96 12:19:57 SHUTDOWN    END     [C]
  11789.             11/21/96 11:45:05 LOGON       START   [ ]   U0000007 Domain: SEDOMAIN
  11790.             11/21/96 11:46:37 LOGON       END     [ ]   U0000007
  11791.             11/21/96 11:47:33 LOCKUP      START   [ ]   U0000007
  11792.             11/21/96 11:47:33 LOCKUP      END     [ ]   U0000007
  11793.             11/21/96 11:47:38 UNLOCK      START   [ ]   U0000007
  11794.             11/21/96 11:47:46 UNLOCK      END     [E]   U0000007 You typed and invalid Password. Try again.
  11795.             11/21/96 11:47:51 UNLOCK      END     [ ]   U0000007
  11796.             11/21/96 11:48:21 LOGOFF      START   [ ]   U0000007
  11797.             11/21/96 11:48:30 LOGOFF      END     [C]   U0000007
  11798.             11/21/96 11:48:43 SHUTDOWN    START   [ ]   U0000007
  11799.             11/21/96 11:48:49 SHUTDOWN    END     [C]   U0000007
  11800.  
  11801.      The treelock log file 
  11802.  
  11803.       In order to audit the treelock component, it can be configured to log its 
  11804.       accesses to a text file. Since this file is treated as another component, 
  11805.       you can place it in the NOUSER directory, or assign one in a per user 
  11806.       basis. See the description of the Treelock component for a more detailed 
  11807.       description of this file. 
  11808.  
  11809.      Public applications log file 
  11810.  
  11811.       This file contains the errors and warnings found by the public 
  11812.       applications component during its execution. 
  11813.  
  11814.      The Distribution data log file 
  11815.  
  11816.       This file keeps the information related with the refresh branch and 
  11817.       refresh profiles activity. In this file you can find whether the refresh 
  11818.       operations (branch or profiles) went ok. It is named 'EDYDIS.LOG' and it 
  11819.       is placed in the SecureEntry\NOUSER path of the server machine. You can 
  11820.       change the location of this file by setting up the SGM_UCM_LOGPATH 
  11821.       environment variable within the config.sys file. 
  11822.  
  11823.       A sample of this file follows: 
  11824.  
  11825.                10/28/98 12:16:48 < REFRESH BRANCH ONLINE BEGINS >
  11826.  
  11827.                > REFRESH STATISTICS
  11828.                    Buffer Length  : 34738
  11829.                    Final Register found
  11830.                >   Read Blocks    : 4
  11831.                >   Correct Blocks : 4
  11832.                >   Error Blocks   : 0
  11833.                >   Number of Add Object Operations    : 1
  11834.                >   Number of Update Object Operations : 2
  11835.                >   Number of Delete Object Operations : 1
  11836.  
  11837.                10/28/98 12:16:57 < REFRESH BRANCH ONLINE ENDED  >
  11838.  
  11839.  Note that you can control the size of the SecureEntry log files, as well as 
  11840.  any other ASCII file by using the EDYLOGFS utility. 
  11841.  
  11842.  
  11843. ΓòÉΓòÉΓòÉ 10.5. About processes and running contexts ΓòÉΓòÉΓòÉ
  11844.  
  11845. With SecureEntry installed, each running process in the machine has a context 
  11846. of execution associated for security. This basically means that the system 
  11847. keeps track of who started the process and what privileges did it have. 
  11848. Basically, there are two kinds of execution contexts : 
  11849.  
  11850.    1. Superuser context All processes started with an associated superuser 
  11851.       context have no file system restrictions (treelock does not check 
  11852.       accesses for them), plus are never killed or terminated at user session 
  11853.       logoff time. 
  11854.  
  11855.    2. User context All processes started with an associated user context will 
  11856.       basically have the currently active treelock profile restrictions 
  11857.       enforced for file accesses, plus they will be killed/terminated at logoff 
  11858.       time unless otherwise specified through the EDYKILL.NOT file. 
  11859.  
  11860.  The obvious following question is what processes run under one or the other 
  11861.  context : 
  11862.  
  11863.      Processes started through CONFIG.SYS have superuser context. 
  11864.  
  11865.      Processes started through EDYSTART.CMD have superuser context. 
  11866.  
  11867.      Processes started through the EDYSTART object in the NOUSER folder have 
  11868.       superuser context. 
  11869.  
  11870.      Processes started during a user session (between logon and logoff) have 
  11871.       User context. 
  11872.  
  11873.      Processes started through a user exit have the context related with the 
  11874.       specified user exit : 
  11875.  
  11876.         -  User exit after startup : Superuser context 
  11877.  
  11878.         -  User exit before logon dialog : Superuser context 
  11879.  
  11880.         -  User exit before logon : Superuser context 
  11881.  
  11882.         -  User exit before LMP signon : Superuser context 
  11883.  
  11884.         -  User exit after LMP signon : Superuser context 
  11885.  
  11886.         -  User exit before profiles activation : User context 
  11887.  
  11888.         -  User exit after logon : User context 
  11889.  
  11890.         -  User exit after PMSHELL : Undefined context (depends on timing) 
  11891.  
  11892.         -  User exit before cancellable lockup : User context 
  11893.  
  11894.         -  User exit before lockup : User context 
  11895.  
  11896.         -  User exit before unlock dialog : User context 
  11897.  
  11898.         -  User exit before unlock : User context 
  11899.  
  11900.         -  User exit after unsuccessful unlock : User context 
  11901.  
  11902.         -  User exit after unlock : User context 
  11903.  
  11904.         -  User exit signal : Undefined context (depends on timing) 
  11905.  
  11906.         -  User exit before cancellable logoff : User context 
  11907.  
  11908.         -  User exit before imminent logoff : User context 
  11909.  
  11910.         -  User exit after profiles deactivation : User context 
  11911.  
  11912.         -  User exit after logoff : Superuser context 
  11913.  
  11914.         -  User exit before shutdown : SuperUser context 
  11915.  
  11916.         -  User exit before logoff from unlock : User context 
  11917.  
  11918.         -  User exit before shutdown from unlock : User context 
  11919.  
  11920.         -  User exit before LMP signoff : User context 
  11921.  
  11922.         -  User exit after LMP signoff : User context 
  11923.  
  11924.         -  User exit open folder : Undefined context (depends on timing) 
  11925.  
  11926.  
  11927. ΓòÉΓòÉΓòÉ 10.6. About Object IDs ΓòÉΓòÉΓòÉ
  11928.  
  11929. When administering SecureEntry, you will find several components that accept 
  11930. only objects with an assigned object ID as suitable for certain operations. 
  11931. This is because the object ID is the only way to uniquely identify an object 
  11932. within the desktop that will retain this characteristic in any machine of a 
  11933. SecureEntry workgroup. 
  11934.  
  11935. Many objects have already an object ID, so you do not have to worry about this 
  11936. until you find a problem. In the event that you do want to deal with an object 
  11937. for which an object ID is required, but does not have one, the following piece 
  11938. of REXX code can be used to assign one to it : 
  11939.  
  11940.  
  11941. /* */
  11942. Call rxfuncadd sysloadfuncs, rexxutil, sysloadfuncs
  11943. Call sysloadfuncs
  11944.  
  11945. /* assign to objectpath the fullpath of the object */
  11946.  
  11947. result=SysSetObjectData(objectpath, 'OBJECTID=<'||NewId||'>')
  11948.  
  11949. Note that object IDs have to be unique, and you will have to repeat this 
  11950. command in all machines where this object will be used by SecureEntry. 
  11951.  
  11952. Refer to Public Applications object IDs to get more information about this kind 
  11953. of LAN Server objects. 
  11954.  
  11955.  
  11956. ΓòÉΓòÉΓòÉ 10.7. SecureEntry session process description ΓòÉΓòÉΓòÉ
  11957.  
  11958. Up to now, we have been describing the SecureEntry process as separate 
  11959. components, but in order to have a clear view on what happens 'under the 
  11960. covers', in terms of events timing, we will describe now all the processes. 
  11961.  
  11962. After power on, the sequence of events is the following : 
  11963.  
  11964.    1. Machine power on 
  11965.  
  11966.    2. OS/2 bootstrap and config.sys processing 
  11967.  
  11968.    3. SecureEntry device drivers load and SES activation 
  11969.  
  11970.    4. Second read of config.sys by OS/2, honoring 'call=' statements 
  11971.  
  11972.    5. First shell (PM) is loaded. SecureEntry PM DLL hooks loaded 
  11973.  
  11974.    6. Asynchronously to this point, if configured, OS/2 launches the daemons 
  11975.       which will end up loading the second shell (Workplace). Whenever the 
  11976.       workplace will be loaded and in a stable state, SecureEntry will serve 
  11977.       the user exit after pmshell. Note that this happens normally not before 
  11978.       several of the following steps are completed 
  11979.  
  11980.    7. SecureEntry processes the EDYSTART.CMD file (Startup process) 
  11981.  
  11982.    8. SecureEntry serves the user exit after startup 
  11983.  
  11984.    9. SecureEntry forces a SES logon event 
  11985.  
  11986.   10. Control is passed to SecureEntry from SES in order to process the logon 
  11987.       event 
  11988.  
  11989.   11. (LOGON) SES Logon event processing : SecureEntry serves the user exit 
  11990.       before logon dialog. If the user exit decides to do a guest logon, then 
  11991.       go to GUEST 
  11992.  
  11993.   12. SecureEntry inspects the logon parms area and decides whether to present 
  11994.       the logon panel or skip the next point 
  11995.  
  11996.   13. The logon panel is displayed. When the user presses 'OK', go to next 
  11997.       step, or if shutdown has been pressed, then go to SHUTDOWN 
  11998.  
  11999.   14. SecureEntry serves the user exit before logon. If the user exit decides 
  12000.       to do a guest logon, then go to GUEST 
  12001.  
  12002.   15. SecureEntry serves the user exit before logon changing password if a 
  12003.       password change request has been made for this logon 
  12004.  
  12005.   16. SecureEntry issues signon to the LMP (Logon procedures) chain in the 
  12006.       order defined in the EDYSSLMP file, synchronizing passwords if necessary. 
  12007.       If there is any error, then go to LOGON 
  12008.  
  12009.   17. SecureEntry downloads the security profiles for the signed on user into 
  12010.       the SecureEntryPath\WORK directory, overriding if necessary the group 
  12011.       profiles with the per user profiles. If there is any error, then go to 
  12012.       LOGON 
  12013.  
  12014.   18. SecureEntry activates each component for which a profile was downloaded 
  12015.       with the profile data, following the interface as defined in the 
  12016.       repository database. If there is any error, then go to LOGON 
  12017.  
  12018.   19. (GUEST) SecureEntry serves the user exit after logon 
  12019.  
  12020.   20. SecureEntry serves the user exit after logon changing password if a 
  12021.       password change request has been made for this logon 
  12022.  
  12023.   21. The user session begins. Only a request for logoff or shutdown will exit 
  12024.       from this state, and proceed to the next step. Note that any new process 
  12025.       started within the user session will be considered by SecureEntry a user 
  12026.       privileged process, and killed at logoff time 
  12027.  
  12028.   22. A request for logoff or shutdown has been made. The appropriate event 
  12029.       (logoff or shutdown) is posted to SES. 
  12030.  
  12031.   23. SecureEntry serves the user exit before cancellable logoff. If cancel has 
  12032.       been returned we go back to the user session (previous step). Otherwise 
  12033.       SecureEntry displays if configured to do so, the confirmation dialog as a 
  12034.       last opportunity to keep on the user session. 
  12035.  
  12036.   24. SecureEntry serves the user exit before imminent logoff 
  12037.  
  12038.   25. SecureEntry kills all of the remaining user session processes 
  12039.  
  12040.   26. SecureEntry Deactivates all of the components downloaded in the logon 
  12041.       process by passing them a call indicating them to reset to the profiles 
  12042.       as stored in the NOUSER directory (machine configuration profiles) 
  12043.  
  12044.   27. SecureEntry Uploads any component profile which may have been changed by 
  12045.       the user to the repository, and erases them from the workstation's WORK 
  12046.       directory 
  12047.  
  12048.   28. SecureEntry issues sign-off to the LMP chain, calling only those LMPs 
  12049.       which were in a signed on state 
  12050.  
  12051.   29. SecureEntry serves the user exit after logoff 
  12052.  
  12053.   30. If the event in process was logoff, then post a SES logon event which 
  12054.       will cause a jump to LOGON, and terminate the logoff event. 
  12055.  
  12056.   31. (SHUTDOWN) SecureEntry serves the user exit before shutdown 
  12057.  
  12058.   32. SecureEntry kills foreground processes which are still alive 
  12059.  
  12060.   33. SecureEntry gives control to SES to shutdown the system, which will in 
  12061.       turn call OS/2 shutdown API 
  12062.  
  12063.  
  12064. ΓòÉΓòÉΓòÉ 10.8. Fine tuning SecureEntry. Performance considerations ΓòÉΓòÉΓòÉ
  12065.  
  12066. There are several factors affecting SecureEntry operation performance. Follow 
  12067. this chapter for a clue on how to tune your system. 
  12068.  
  12069. Note that performance tuning usually yields the best results if you look first 
  12070. after the 'bottlenecks' of the system. Symptoms of such bottlenecks are : 
  12071.  
  12072.      General system sluggish response time, and possibly too much disk 
  12073.       activity. This is normally an indication of low memory condition, and is 
  12074.       accompanied by very big swapper files (when compared to the amount of 
  12075.       memory installed). It deserves a general system tuning session and may 
  12076.       possibly end up by adding more memory to the system. 
  12077.  
  12078.         -  General operating system performance tuning 
  12079.  
  12080.      Specific performance problems at certain moments. i.e, at logon time. 
  12081.       This one is normally an indication of another sort of problem, and if 
  12082.       happening within SecureEntry, may be cured by following the indications 
  12083.       under 'SecureEntry specific performance tuning'. 
  12084.  
  12085.         -  SecureEntry specific performance tuning 
  12086.  
  12087.  
  12088. ΓòÉΓòÉΓòÉ 10.8.1. General operating system performance tuning ΓòÉΓòÉΓòÉ
  12089.  
  12090. The following things can be tuned in order to improve performance on a OS/2 
  12091. running machine : 
  12092.  
  12093.      Software tuning 
  12094.  
  12095.         1. Swapper : The swapper file should be positioned into the more used 
  12096.            partition of the least used physical drive. Also, it usually helps 
  12097.            to preallocate the swap file to a given size so that it does not 
  12098.            have to be dynamically shrunken or expanded. You can do this by 
  12099.            using the SWAPPATH sentence of your CONFIG.SYS file, as follows : 
  12100.  
  12101.  
  12102.                               SWAPPATH=D:\ 8192 16384
  12103.  
  12104.                               Set the swapper file to reside in the root directory of the D drive,
  12105.                               with an initial size of 16 Mb, posting a user alert if the remaining
  12106.                               free space is less than 8 Mb
  12107.  
  12108.         2. Disk cache : Usually a big enough disk cache helps performance also. 
  12109.            Use the DISKCACHE sentence for FAT drives, and/or the CACHE / IFS 
  12110.            sentences for HPFS drives. Do not forget the lazy write flags for 
  12111.            maximum performance!!. 
  12112.  
  12113.         3. Remove/do not install unused software/drivers. I.e, multimedia 
  12114.            extensions, or HPFS drivers if this file system is not being used. 
  12115.  
  12116.         4. Remember to switch off traces and / or verify switches in end user 
  12117.            runtime environments. Also gadgets such as 'desktop animation' can 
  12118.            make the system feel slower. 
  12119.  
  12120.         5. Try to keep your disk defragmented, and if possible use HPFS instead 
  12121.            of FAT partitions, specially for big disks. 
  12122.  
  12123.         6. Fine tune your PATH, LIBPATH and DPATH config.sys statements, 
  12124.            placing first those directories which are accessed more. 
  12125.  
  12126.         7. In fast machines and/or server machines, it may be a good idea to 
  12127.            reduce the time slicing parameters : TIMESLICE and MAXWAIT, to 
  12128.            improve the responsiveness of the system. (i.e TIMESLICE=32,512 and 
  12129.            MAXWAIT=1). 
  12130.  
  12131.         8. If using windows applications, it may be a good idea to switch on 
  12132.            the WINOS2 fastload setting (through the proper page of the settings 
  12133.            notebook of the WINOS2 configuration object), and run all windows 
  12134.            applications from the same session. 
  12135.  
  12136.         9. For startup performance tuning, you can do the following : 
  12137.  
  12138.              -  Keep optimized system .INI files (OS2.INI and OS2SYS.INI). 
  12139.                 There are several utilities around that can help you with this. 
  12140.                 SecureEntry provides you also with one : EDYCLINI. 
  12141.  
  12142.              -  Remember to turn off archiving of your critical files at each 
  12143.                 power on. You should do this only when major updates to your 
  12144.                 system configuration have been made. You can do this from 
  12145.                 within the desktop page of the desktop settings notebook. 
  12146.  
  12147.      Hardware tuning 
  12148.  
  12149.         1. Adding memory is many times the most efficient way to improve 
  12150.            performance. Look at the server machines first. 
  12151.  
  12152.         2. Consider also adding L2 cache memory to your system if this is an 
  12153.            option for your hardware. 
  12154.  
  12155.         3. Of course, faster processor/disks help a lot also. 
  12156.  
  12157.         4. Think about improving your host communications link speeds, 
  12158.            specially if using UCM. 
  12159.  
  12160.         5. For Lan based installations, keep an eye on Lan performance and 
  12161.            contention problems, which may be solved by lan splitting or 
  12162.            hardware changes. 
  12163.  
  12164.  
  12165. ΓòÉΓòÉΓòÉ 10.8.2. SecureEntry specific performance tuning ΓòÉΓòÉΓòÉ
  12166.  
  12167. Although SecureEntry is installed with most options already tuned for 
  12168. performance, the following rules could also be observed to help improving the 
  12169. response time even more : 
  12170.  
  12171.      Although SecureEntry does not have a minimum physical memory requirement, 
  12172.       you are encouraged to consider that the approx working set size of the 
  12173.       code is of around 3Mb, being this the amount of physical memory that you 
  12174.       should add to the system if your objective is to achieve the same level 
  12175.       of performance that you have without it in the same hardware. Note also 
  12176.       that SecureEntry has constantly a minimum of 15 threads active, so to be 
  12177.       safe you should increase your CONFIG.SYS THREADS statement by that 
  12178.       amount. 
  12179.  
  12180.      Within Lan Server environments, take into account that the 'big chunk' of 
  12181.       signon time is taken by Lan Server itself, so generally tuning Lan Server 
  12182.       performance will result in a substantial SecureEntry operation 
  12183.       improvement. 
  12184.  
  12185.      Also for Lan environments, take a close look at the protocol parameters 
  12186.       of your PROTOCOL.INI file, located in the IBMCOM directory. The base 
  12187.       network software normally installs itself with too much conservative 
  12188.       default parameters for simple environments such as the typical banking 
  12189.       branch network. This is why simply by changing the NETBIOSTIMEOUT 
  12190.       parameter from 2000 to 500 msec you can easily cut the signon time by 
  12191.       about 20 seconds or more. Another parameter to reduce for fast not 
  12192.       bridged lans would be the NETBIOSRETRIES one on the same file. Reducing 
  12193.       it to 2 or 3 will improve response time also. 
  12194.  
  12195.      If you are having problems at signon time, measure the complete logon 
  12196.       time with a stopwatch (not the first logon), and verify if the time is 
  12197.       mostly spent : 
  12198.  
  12199.         1. When the logon panel is displayed but the window 'signon in 
  12200.            progress.. please wait' has not yet appeared. In this case, look for 
  12201.            your user exit code or at other activity being performed in the 
  12202.            machine at the same time. 
  12203.  
  12204.         2. When the logon panel is displayed and the window 'signon in 
  12205.            progress.. please wait' is over it. In this case, the time is spent 
  12206.            on RACF validation, UCM download and Lan Server validation and 
  12207.            signon. These are the components to be checked. 
  12208.  
  12209.         3. When the logon panel has disappeared. Check in this case after the 
  12210.            individual components activation time. 
  12211.  
  12212.      Avoid using too many user exit code when possible. User exits are a very 
  12213.       powerful mechanism, but quite expensive. An exception to this rule can be 
  12214.       found when it is necessary to unload software. It will always be more 
  12215.       efficient to do it using the proper command than leaving the task to 
  12216.       SecureEntry, which does not know the internals of the processes composing 
  12217.       any particular software package. You can use for this purpose the user 
  12218.       exit before shutdown and/or the user exit before imminent logoff, or a 
  12219.       customized EDYKILL.NOTfile. 
  12220.  
  12221.      Try to use machine-assigned components (in the NOUSER directory) rather 
  12222.       than group or user assigned ones, since this will save time, not having 
  12223.       to activate/deactivate the same profiles at each signon. 
  12224.  
  12225.      Consider the possibility of enabling the environment variable 
  12226.       'SGM_WPS_FASTLOAD' in your config.sys. Take into account the risks 
  12227.       exposed under Environment variables. Note that this setting only modifies 
  12228.       the 'perception' of faster signons, since the population of the desktop 
  12229.       will be anticipated a few seconds. 
  12230.  
  12231.      Do not change the config.sys variable RESTARTUSERSHELL default setting of 
  12232.       'NO', except when required by your installation. Restarting the Workplace 
  12233.       Shell at each signon will easily delay it by several seconds. 
  12234.  
  12235.      Place the SecureEntry path as closer to the beginning of the PATH and 
  12236.       LIBPATH statements as possible within config.sys. 
  12237.  
  12238.      Also for best power on performance, leave alone the 
  12239.       'SGM_WPS_SKIP_PREPOPULATE' environment variable set to 'ALL', as 
  12240.       installed by SecureEntry. 
  12241.  
  12242.      Suppress all unneeded logging/traces. For instance, you can set the trace 
  12243.       level to 0 by adding to your EDYSTART.CMD file : 
  12244.  
  12245.  
  12246.                   EDYTRSET /A:0
  12247.  
  12248.      For the launchpad component, two considerations : 
  12249.  
  12250.         1. Try to set up launchpads which contain only objects with object ID. 
  12251.            Adding objects to a launchpad (when it is created), is much more 
  12252.            time expensive if the objects to be added do not have an object ID. 
  12253.  
  12254.         2. If installing within an old machine (i.e, OS/2 has been installed 
  12255.            there for a long time), it may be a good idea to 'clean' the nowhere 
  12256.            directory with a tool like the supplied EDYCLINI. Old launchpad 
  12257.            shadows (not SecureEntry ones) end up here and are never deleted by 
  12258.            the system itself, making access to objects residing in this 
  12259.            location slower. 
  12260.  
  12261.            WARNING : Do this only if you find lots of objects within the 
  12262.            NOWHERE folder. 
  12263.  
  12264.      For your screensaver or background bitmaps, take into account that big 
  12265.       bitmaps take a lot of disk space, which in turn takes a long time to be 
  12266.       read, and may cause quite some swapping activity to be processed, so it 
  12267.       is a matter of finding the desired middlepoint between image quality and 
  12268.       response time. If you decide to use 'big' bitmaps anyways, then if 
  12269.       possible try to use bitmaps with the same sizing in pixels/colors of your 
  12270.       desktop resolution, as this will avoid expensive color remapping and 
  12271.       reseizing functions. 
  12272.  
  12273.  
  12274. ΓòÉΓòÉΓòÉ 10.9. Error codes and messages ΓòÉΓòÉΓòÉ
  12275.  
  12276. Session control errors and messages 
  12277.  
  12278. The following errors may appear during regular runtime and session control 
  12279. functions, i.e logon, logoff, lockup... Some of these can be reported also 
  12280. through the administration APIs. 
  12281.  
  12282. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  12283. ΓöéMessage   ΓöéMessage                       ΓöéDescription                             Γöé
  12284. Γöénumber    Γöé                              Γöé                                        Γöé
  12285. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12286. ΓöéEDY0001E  ΓöéInvalid password.             ΓöéThe entered password is not valid for   Γöé
  12287. Γöé          Γöé                              Γöéthis user during a logon or unlock      Γöé
  12288. Γöé          Γöé                              Γöéoperation.                              Γöé
  12289. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12290. ΓöéEDY0002E  ΓöéOperating System error.       ΓöéA generic operating system error        Γöé
  12291. Γöé          Γöé                              Γöéhappened. The message can contain       Γöé
  12292. Γöé          Γöé                              Γöéadditional data. Check traces or log    Γöé
  12293. Γöé          Γöé                              Γöéfiles to know more about it.            Γöé
  12294. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12295. ΓöéEDY0003E  ΓöéSubsystem %s not available.   ΓöéA required subsystem was not available  Γöé
  12296. Γöé          Γöé                              Γöéat logon time. (SR: Registry, LS: Lan   Γöé
  12297. Γöé          Γöé                              ΓöéServer, UC: UCM, RF: RACF..).           Γöé
  12298. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12299. ΓöéEDY0004E  ΓöéControl file wrong            ΓöéCheck the integrity of the EDYSSLMP.DAT Γöé
  12300. Γöé          Γöéconfiguration.                Γöéfile. It probably has been altered.     Γöé
  12301. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12302. ΓöéEDY0005E  ΓöéLogoff state: no user logged  ΓöéAn operation pre requiring a logon foundΓöé
  12303. Γöé          Γöéon this workstation.          Γöéthat no user has logged into the machineΓöé
  12304. Γöé          Γöé                              Γöé(typically can happen during logoff if aΓöé
  12305. Γöé          Γöé                              Γöélan server logoff was issued during userΓöé
  12306. Γöé          Γöé                              Γöésession).                               Γöé
  12307. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12308. ΓöéEDY0006E  ΓöéUnknown user.                 ΓöéThe requested userid is not known to theΓöé
  12309. Γöé          Γöé                              Γöélogon subsystem.                        Γöé
  12310. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12311. ΓöéEDY0007E  ΓöéAnother user is logged on thisΓöéThe logon subsystem found a user alreadyΓöé
  12312. Γöé          Γöéworkstation.                  Γöélogged on during logon processing.      Γöé
  12313. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12314. ΓöéEDY0008E  ΓöéPassword expired.             ΓöéThe password has expired. You must      Γöé
  12315. Γöé          Γöé                              Γöéchange the password to proceed.         Γöé
  12316. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12317. ΓöéEDY0009E  ΓöéNew password invalid.         ΓöéThe new password is not valid. Either   Γöé
  12318. Γöé          Γöé                              Γöétoo short, too long, contains invalid   Γöé
  12319. Γöé          Γöé                              Γöécharacters, or is equal to one of the   Γöé
  12320. Γöé          Γöé                              Γöélast used passwords.                    Γöé
  12321. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12322. ΓöéEDY0010E  ΓöéBad input parameter.          ΓöéThis is an internal error. Contact      Γöé
  12323. Γöé          Γöé                              Γöéservice support.                        Γöé
  12324. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12325. ΓöéEDY0011E  ΓöéConnection denied, user cannotΓöéThe user's account has been revoked.    Γöé
  12326. Γöé          Γöélog on.                       ΓöéContact your system administrator.      Γöé
  12327. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12328. ΓöéEDY0012E  ΓöéImpossible to load DLL %s.    ΓöéDuring logon subsystem initialization,  Γöé
  12329. Γöé          Γöé                              Γöéthe specified DLL could not be found.   Γöé
  12330. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12331. ΓöéEDY0080E  ΓöéSecurity Profile manipulation ΓöéInternal error. Contact service support.Γöé
  12332. Γöé          Γöégeneral error.                Γöé                                        Γöé
  12333. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12334. ΓöéEDY0081E  ΓöéError while getting access to ΓöéCheck machine resources and/or contact  Γöé
  12335. Γöé          Γöéthe shared memory.            Γöéservice support.                        Γöé
  12336. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12337. ΓöéEDY0082E  ΓöéShared memory is full.        ΓöéInternal error. Contact service support.Γöé
  12338. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12339. ΓöéEDY0083E  ΓöéInformation not available in  ΓöéInternal error. Contact service support.Γöé
  12340. Γöé          Γöéthe shared memory.            Γöé                                        Γöé
  12341. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12342. ΓöéEDY0084E  ΓöéQuerying for shared memory    ΓöéInternal error. Contact service support.Γöé
  12343. Γöé          Γöéinformation: input buffer is  Γöé                                        Γöé
  12344. Γöé          Γöétoo small.                    Γöé                                        Γöé
  12345. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12346. ΓöéEDY0085E  ΓöéError reading INI file.       ΓöéInternal error. Contact service support.Γöé
  12347. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12348. ΓöéEDY0086E  ΓöéReading INI: label not found. ΓöéInternal error. Contact service support.Γöé
  12349. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12350. ΓöéEDY0087E  ΓöéFile not found.               ΓöéThe requested file does not exist.      Γöé
  12351. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12352. ΓöéEDY0088E  ΓöéFile copy error.              ΓöéThe requested file could not be copied. Γöé
  12353. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12354. ΓöéEDY0100W  ΓöéEmergency logon (basic        ΓöéThe basic logon subsystems are          Γöé
  12355. Γöé          Γöésubsystems are available but  Γöéavailable, but the director one failed  Γöé
  12356. Γöé          Γöé%s has failed). Password      Γöé(typically RACF). You are logged on in  Γöé
  12357. Γöé          Γöéchange not allowed.           Γöéemergency mode. Password change will notΓöé
  12358. Γöé          Γöé                              Γöébe allowed for this reason.             Γöé
  12359. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12360. ΓöéEDY0101W  ΓöéControl File: found end of    ΓöéCheck the integrity of the EDYSSLMP.DAT Γöé
  12361. Γöé          Γöéfile.                         Γöéfile. It probably has been altered.     Γöé
  12362. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12363. ΓöéEDY0102W  ΓöéControl File: found an empty  ΓöéCheck the integrity of the EDYSSLMP.DAT Γöé
  12364. Γöé          Γöéline.                         Γöéfile. It probably has been altered.     Γöé
  12365. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12366. ΓöéEDY0103W  ΓöéPending request.              ΓöéInternal error. Contact service support.Γöé
  12367. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12368. ΓöéEDY0104W  ΓöéControl File: found the users ΓöéCheck the integrity of the EDYSSLMP.DAT Γöé
  12369. Γöé          ΓöéDB line.                      Γöéfile. It probably has been altered.     Γöé
  12370. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12371. ΓöéEDY0105W  ΓöéControl File: found the       ΓöéCheck the integrity of the EDYSSLMP.DAT Γöé
  12372. Γöé          Γöéprofiles DB line.             Γöéfile. It probably has been altered.     Γöé
  12373. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12374. ΓöéEDY0110E  ΓöéLan Server fail.              ΓöéLan Server was available but failed.    Γöé
  12375. Γöé          Γöé                              ΓöéPossible causes are Lan Server internal Γöé
  12376. Γöé          Γöé                              Γöéerror, Too many names in access control Γöé
  12377. Γöé          Γöé                              Γöéfile, error accessing the NET.ACC file, Γöé
  12378. Γöé          Γöé                              Γöéand others.                             Γöé
  12379. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12380. ΓöéEDY0111E  ΓöéLan Server configuration      ΓöéAn error related to Lan Server          Γöé
  12381. Γöé          Γöéerror.                        Γöéconfiguration or code level has been    Γöé
  12382. Γöé          Γöé                              Γöéfound. Either net path not found, not   Γöé
  12383. Γöé          Γöé                              Γöésupported request or API, computername  Γöé
  12384. Γöé          Γöé                              Γöénot valid, or wrongly configured server.Γöé
  12385. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12386. ΓöéEDY0112E  ΓöéSome Lan Server service has   ΓöéThis error should not appear in any     Γöé
  12387. Γöé          Γöénot been started and was      Γöécase. EDY0003 would be expected.        Γöé
  12388. Γöé          Γöérequired.                     Γöé                                        Γöé
  12389. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12390. ΓöéEDY0113E  ΓöéLan Server domain fail.       ΓöéCould not obtain the domain server name.Γöé
  12391. Γöé          Γöé                              ΓöéContact administrator.                  Γöé
  12392. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12393. ΓöéEDY0114E  ΓöéThis operation needs Lan      ΓöéUnauthorized request reported by Lan    Γöé
  12394. Γöé          ΓöéServer administrator          ΓöéServer.                                 Γöé
  12395. Γöé          Γöéprivilege.                    Γöé                                        Γöé
  12396. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12397. ΓöéEDY0115E  ΓöéUserId and/or password are    ΓöéThe EDYSRV program is probably not      Γöé
  12398. Γöé          Γöéinvalid and cannot be         Γöérunning in the domain controller        Γöé
  12399. Γöé          Γöévalidated. Try again.         Γöémachine. Thus, could not refine further Γöé
  12400. Γöé          Γöé                              Γöéthe error code and this more generic oneΓöé
  12401. Γöé          Γöé                              Γöéis displayed.                           Γöé
  12402. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12403. ΓöéEDY0116E  ΓöéLan Server: This user is      ΓöéYour Lan Server is not configured for   Γöé
  12404. Γöé          Γöéalready logged in the LAN.    Γöémultilogon, and you are attempting to   Γöé
  12405. Γöé          Γöé                              Γöélog on while are logged on already in   Γöé
  12406. Γöé          Γöé                              Γöéanother machine.                        Γöé
  12407. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12408. ΓöéEDY0117E  ΓöéLan Server: Logon/logoff in   ΓöéAnother logon or logoff is in progress  Γöé
  12409. Γöé          Γöéprocess, or Lan Requester toolΓöéat this time.                           Γöé
  12410. Γöé          Γöéis active.                    Γöé                                        Γöé
  12411. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12412. ΓöéEDY0118E  ΓöéLan Server: User account      ΓöéThe user account has expired. Contact   Γöé
  12413. Γöé          Γöéexpired.                      Γöéyour system administrator.              Γöé
  12414. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12415. ΓöéEDY0119E  ΓöéLan Server: new password is   ΓöéSelf explanatory.                       Γöé
  12416. Γöé          Γöétoo short.                    Γöé                                        Γöé
  12417. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12418. ΓöéEDY0120E  ΓöéLan Server: new password is   ΓöéSelf explanatory.                       Γöé
  12419. Γöé          Γöétoo recent.                   Γöé                                        Γöé
  12420. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12421. ΓöéEDY0121E  ΓöéLan Server: The password      ΓöéSelf explanatory.                       Γöé
  12422. Γöé          Γöécannot be changed.            Γöé                                        Γöé
  12423. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12424. ΓöéEDY0122E  ΓöéBad connection conditions:    ΓöéSelf explanatory.                       Γöé
  12425. Γöé          Γöéinvalid logon hours.          Γöé                                        Γöé
  12426. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12427. ΓöéEDY0123W  ΓöéDomain controller unavailable.ΓöéInformational : The main domain         Γöé
  12428. Γöé          ΓöéUsing backup controller.      Γöécontroller was not found in the domain, Γöé
  12429. Γöé          Γöé                              ΓöéA backup controller has taken its role. Γöé
  12430. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12431. ΓöéEDY0201E: ΓöéToo many subsystem logons.    ΓöéInternal error. Contact service support.Γöé
  12432. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12433. ΓöéEDY0202E: ΓöéInvalid system id %s.         ΓöéInternal error. Contact service support.Γöé
  12434. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12435. ΓöéEDY0203E: ΓöéUnauthorized request. Access  ΓöéUnauthorized request reported by        Γöé
  12436. Γöé          Γöédenied.                       ΓöéSecureEntry Registry.                   Γöé
  12437. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12438. ΓöéEDY0204E: ΓöéA user %s already exists.     ΓöéCould not add user/group because it is  Γöé
  12439. Γöé          Γöé                              Γöéalready defined as a user in the        Γöé
  12440. Γöé          Γöé                              ΓöéSecureEntry registry.                   Γöé
  12441. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12442. ΓöéEDY0205E: ΓöéA group %s already exists.    ΓöéCould not add user/group because it is  Γöé
  12443. Γöé          Γöé                              Γöéalready defined as a group in the       Γöé
  12444. Γöé          Γöé                              ΓöéSecureEntry registry.                   Γöé
  12445. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12446. ΓöéEDY0206E: ΓöéA component %s already exists.ΓöéCould not add a component profile       Γöé
  12447. Γöé          Γöé                              Γöébecause it already exists.              Γöé
  12448. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12449. ΓöéEDY0207E: ΓöéThe group %s does not exist.  ΓöéThe requested group does not exist in   Γöé
  12450. Γöé          Γöé                              Γöéthe registry.                           Γöé
  12451. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12452. ΓöéEDY0208E: ΓöéThe group %s is not empty.    ΓöéCan not delete a group from the registryΓöé
  12453. Γöé          Γöé                              Γöéwhile users belong to it.               Γöé
  12454. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12455. ΓöéEDY0209E: ΓöéCan not delete current logged ΓöéThe logged on user can not be deleted.  Γöé
  12456. Γöé          Γöéuser.                         Γöé                                        Γöé
  12457. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12458. ΓöéEDY0210E: ΓöéThe component name %s is      ΓöéThe component has not been registered asΓöé
  12459. Γöé          Γöéinvalid.                      Γöéa valid component to the registry, or   Γöé
  12460. Γöé          Γöé                              Γöéthe syntax is invalid for the name.     Γöé
  12461. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12462. ΓöéEDY0211E: ΓöéThe component %s does not     ΓöéCould not update/delete the component   Γöé
  12463. Γöé          Γöéexist.                        Γöéprofile because it does not exist       Γöé
  12464. Γöé          Γöé                              Γöérelated to the specified user / group.  Γöé
  12465. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12466. ΓöéEDY0212E: ΓöéCould not load DLL %s.        ΓöéThe registry could not load the requiredΓöé
  12467. Γöé          Γöé                              ΓöéDLL. Make sure it exists and is         Γöé
  12468. Γöé          Γöé                              Γöéaccessible through the libpath          Γöé
  12469. Γöé          Γöé                              Γöéconfig.sys setting.                     Γöé
  12470. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12471. ΓöéEDY0213E: ΓöéCould not find address of %s. ΓöéInternal error. Contact service support.Γöé
  12472. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12473. ΓöéEDY0214E: ΓöéUsers Database not EdyReg     ΓöéThe requested operation is only valid   Γöé
  12474. Γöé          Γöédefined.                      Γöéfor standalone configurations.          Γöé
  12475. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12476. ΓöéEDY0215E: ΓöéProfiles Database not EdyReg  ΓöéCheck EDYSSLMP.DAT file syntax and      Γöé
  12477. Γöé          Γöédefined.                      Γöéintegrity.                              Γöé
  12478. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12479. ΓöéEDY0216E: ΓöéEDYAPI Error %s.              ΓöéThe registry got an error while queryingΓöé
  12480. Γöé          Γöé                              ΓöéEDYAPI for configuration information.   Γöé
  12481. Γöé          Γöé                              ΓöéCheck the reported error in this same   Γöé
  12482. Γöé          Γöé                              Γöétable.                                  Γöé
  12483. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12484. ΓöéEDY0217E: ΓöéSentry subsystem not found.   ΓöéThere was probably an error during      Γöé
  12485. Γöé          Γöé                              Γöéinstallation. Contact service support.  Γöé
  12486. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12487. ΓöéEDY0218E: ΓöéComponent list empty.         ΓöéInternal error. Contact service support.Γöé
  12488. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12489. ΓöéEDY0219E: ΓöéSyntax error in component listΓöéThe registered components list is in    Γöé
  12490. Γöé          Γöé: %s .                        Γöéerror. Check SENTRY.DSC file and        Γöé
  12491. Γöé          Γöé                              Γöéreregister it through UPDATEDB.         Γöé
  12492. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12493. ΓöéEDY0220E: ΓöéThe component %s is unknown.  ΓöéThe component has not been registered asΓöé
  12494. Γöé          Γöé                              Γöéa valid component to the registry.      Γöé
  12495. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12496. ΓöéEDY0221E: ΓöéThe mandatory component %s is ΓöéMandatory component missing. The user   Γöé
  12497. Γöé          Γöénot present.                  Γöécan not logon.                          Γöé
  12498. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12499. ΓöéEDY0222E: ΓöéUnknown EdyReg error %d.      ΓöéAn unknown error was reported to the    Γöé
  12500. Γöé          Γöé                              Γöéregistry. Check the error message.      Γöé
  12501. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12502. ΓöéEDY0223E: ΓöéUnknown EdyReg error class %d.ΓöéInternal error. Contact service support.Γöé
  12503. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12504. ΓöéEDY0224W: ΓöéComponent to be put matches   ΓöéInformative.                            Γöé
  12505. Γöé          Γöéprevious version. Not stored  Γöé                                        Γöé
  12506. Γöé          Γöéagain.                        Γöé                                        Γöé
  12507. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12508. ΓöéEDY0330E: ΓöéInternal error.               ΓöéInternal error. Contact service support.Γöé
  12509. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12510. ΓöéEDY0331E: ΓöéA security error due to       ΓöéInternal error. Contact service support.Γöé
  12511. Γöé          Γöéintegrity violation has       Γöé                                        Γöé
  12512. Γöé          Γöéoccurred. The system will     Γöé                                        Γöé
  12513. Γöé          Γöéshutdown.                     Γöé                                        Γöé
  12514. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12515. ΓöéEDY0332E: ΓöéIncorrect Userid length. Try  ΓöéError reported during logon/unlock      Γöé
  12516. Γöé          Γöéagain.                        Γöépanels syntax checking.                 Γöé
  12517. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12518. ΓöéEDY0333E: ΓöéIncorrect Password length. TryΓöéError reported during logon/unlock      Γöé
  12519. Γöé          Γöéagain.                        Γöépanels syntax checking.                 Γöé
  12520. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12521. ΓöéEDY0334E: ΓöéIncorrect Domain length. Try  ΓöéError reported during logon/unlock      Γöé
  12522. Γöé          Γöéagain.                        Γöépanels syntax checking.                 Γöé
  12523. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12524. ΓöéEDY0335E: ΓöéNew and verification PasswordsΓöéError reported during logon/unlock      Γöé
  12525. Γöé          Γöédon't match.                  Γöépanels syntax checking.                 Γöé
  12526. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12527. ΓöéEDY0337E: ΓöéYou typed and invalid         ΓöéError reported during logon/unlock      Γöé
  12528. Γöé          ΓöéPassword. Try again.          Γöépanels syntax checking.                 Γöé
  12529. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12530. ΓöéEDY0338E: ΓöéInvalid Password change.      ΓöéError encountered during the syntax     Γöé
  12531. Γöé          ΓöéContact your System           Γöévalidation phase of the logon and/or    Γöé
  12532. Γöé          ΓöéAdministrator.                Γöéunlock events.                          Γöé
  12533. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12534. ΓöéEDY0341E: ΓöéYou are not authorized to     ΓöéError encountered during the syntax     Γöé
  12535. Γöé          Γöélogon. Contact your System    Γöévalidation phase of the logon and/or    Γöé
  12536. Γöé          ΓöéAdministrator.                Γöéunlock events.                          Γöé
  12537. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12538. ΓöéEDY0347E: ΓöéA Severe Initialization Error ΓöéTake note of the provided information   Γöé
  12539. Γöé          Γöéhas been produced. Module: %s.Γöéand contact SecureEntry support.        Γöé
  12540. Γöé          ΓöéFunction: %s. Line: %d. SystemΓöé                                        Γöé
  12541. Γöé          ΓöéError: %#X. The system will   Γöé                                        Γöé
  12542. Γöé          Γöéshutdown.                     Γöé                                        Γöé
  12543. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12544. ΓöéEDY0349E: ΓöéThe OS/2 initialization file  ΓöéThe initialization file specified by theΓöé
  12545. Γöé          Γöécontains an invalid           Γöéenvironment variable USER_INI, normally Γöé
  12546. Γöé          Γöéapplication. The program to   Γöébeing the file OS2.INI located in the   Γöé
  12547. Γöé          Γöéfix it could not be executed. Γöésubdirectory OS2 of the boot partition, Γöé
  12548. Γöé          ΓöéThe system will shutdown.     Γöécontains the pair SYS_DLLS/Load having  Γöé
  12549. Γöé          ΓöéContact your System           Γöéan invalid key value. This error may be Γöé
  12550. Γöé          ΓöéAdministrator.                Γöécaused by overwriting the system        Γöé
  12551. Γöé          Γöé                              Γöéinitialization files with other ones notΓöé
  12552. Γöé          Γöé                              Γöéhaving the needed information. The      Γöé
  12553. Γöé          Γöé                              ΓöéSecureEntry program that solves this    Γöé
  12554. Γöé          Γöé                              Γöéprogram could not be launched. Contact  Γöé
  12555. Γöé          Γöé                              Γöéservice support.                        Γöé
  12556. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12557. ΓöéEDY0350E: ΓöéThe OS/2 initialization file  ΓöéThe initialization file specified by theΓöé
  12558. Γöé          Γöécontains an invalid           Γöéenvironment variable USER_INI, normally Γöé
  12559. Γöé          Γöéapplication. The program to   Γöébeing the file OS2.INI located in the   Γöé
  12560. Γöé          Γöéfix it terminated             Γöésubdirectory OS2 of the boot partition, Γöé
  12561. Γöé          Γöéunexpectedly. The system will Γöécontains the pair SYS_DLLS/Load having  Γöé
  12562. Γöé          Γöéshutdown. Contact your System Γöéan invalid key value. This error may be Γöé
  12563. Γöé          ΓöéAdministrator.                Γöécaused by overwriting the system        Γöé
  12564. Γöé          Γöé                              Γöéinitialization files with other ones notΓöé
  12565. Γöé          Γöé                              Γöéhaving the needed information. The      Γöé
  12566. Γöé          Γöé                              ΓöéSecureEntry program that solves this    Γöé
  12567. Γöé          Γöé                              Γöéprogram abnormally ended (ABENDed).     Γöé
  12568. Γöé          Γöé                              ΓöéContact service support.                Γöé
  12569. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12570. ΓöéEDY0351E: ΓöéThe OS/2 initialization file  ΓöéThe initialization file specified by theΓöé
  12571. Γöé          Γöécontains an invalid           Γöéenvironment variable USER_INI, normally Γöé
  12572. Γöé          Γöéapplication. The program to   Γöébeing the file OS2.INI located in the   Γöé
  12573. Γöé          Γöéfix it could not actually fix Γöésubdirectory OS2 of the boot partition, Γöé
  12574. Γöé          Γöéit. The system will shutdown. Γöécontains the pair SYS_DLLS/Load having  Γöé
  12575. Γöé          ΓöéContact your System           Γöéan invalid key value. This error may be Γöé
  12576. Γöé          ΓöéAdministrator.                Γöécaused by overwriting the system        Γöé
  12577. Γöé          Γöé                              Γöéinitialization files with other ones notΓöé
  12578. Γöé          Γöé                              Γöéhaving the needed information. The      Γöé
  12579. Γöé          Γöé                              ΓöéSecureEntry program that solves this    Γöé
  12580. Γöé          Γöé                              Γöéprogram could not correct the problem.  Γöé
  12581. Γöé          Γöé                              ΓöéContact service support.                Γöé
  12582. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12583. ΓöéEDY0352E: ΓöéThe OS/2 initialization file  ΓöéThe initialization file specified by theΓöé
  12584. Γöé          Γöécontains an invalid           Γöéenvironment variable USER_INI, normally Γöé
  12585. Γöé          Γöéapplication. The problem has  Γöébeing the file OS2.INI located in the   Γöé
  12586. Γöé          Γöébeen fixed. The system will   Γöésubdirectory OS2 of the boot partition, Γöé
  12587. Γöé          Γöéshutdown. Contact your System Γöécontains the pair SYS_DLLS/Load having  Γöé
  12588. Γöé          ΓöéAdministrator if you continue Γöéan invalid key value. This error may be Γöé
  12589. Γöé          Γöéhaving this problem.          Γöécaused by overwriting the system        Γöé
  12590. Γöé          Γöé                              Γöéinitialization files with other ones notΓöé
  12591. Γöé          Γöé                              Γöéhaving the needed information.          Γöé
  12592. Γöé          Γöé                              ΓöéSecureEntry fixed the problem in the    Γöé
  12593. Γöé          Γöé                              Γöéinitialization file. An IPL is needed inΓöé
  12594. Γöé          Γöé                              Γöéorder for the new valid values to be    Γöé
  12595. Γöé          Γöé                              Γöéeffective. Another forthcoming of this  Γöé
  12596. Γöé          Γöé                              Γöéerror after IPLing the system indicates Γöé
  12597. Γöé          Γöé                              Γöéan automatic replacement of operating   Γöé
  12598. Γöé          Γöé                              Γöésystem initialization files at some     Γöé
  12599. Γöé          Γöé                              Γöéstage of the boot process.              Γöé
  12600. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  12601.  
  12602. Administration API errors 
  12603.  
  12604. Although you will normally encounter these errors when working directly with 
  12605. the administration API, it is possible also to get one of these when using any 
  12606. of the administration tools. The key is to look at the error type and then find 
  12607. the appropriate error list depending on the ultimate component causing the 
  12608. error condition, as follows : 
  12609.  
  12610. Error types table 
  12611.  
  12612. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  12613. ΓöéError ΓöéError ΓöéDescription                                                 Γöé
  12614. Γöécode  Γöétype  Γöé                                                            Γöé
  12615. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12616. Γöéxxxx  ΓöéRXUC  ΓöéThe REXX layer DLL found an error. Look into the associated Γöé
  12617. Γöé      Γöé      Γöémessage to find more about it.                              Γöé
  12618. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12619. Γöéxxxx  ΓöéSLAG  ΓöéSecureEntry selector agent error. This means that the       Γöé
  12620. Γöé      Γöé      ΓöéSecureEntry selector agent, that is, the common entry point Γöé
  12621. Γöé      Γöé      Γöéto the administration API, found an error. Refer to the     Γöé
  12622. Γöé      Γöé      Γöéagents error table to find more about xxxx.                 Γöé
  12623. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12624. Γöéxxxx  ΓöéSEAG  ΓöéSecureEntry administration agent error. This means that the Γöé
  12625. Γöé      Γöé      ΓöéSecureEntry subsystem administration agent found an error.  Γöé
  12626. Γöé      Γöé      ΓöéRefer to the agents error table to find more about xxxx.    Γöé
  12627. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12628. Γöéxxxx  ΓöéSESR  ΓöéSecureEntry registry component error. The SecureEntry/UCM   Γöé
  12629. Γöé      Γöé      Γöésubsystem administration agents received an error reported  Γöé
  12630. Γöé      Γöé      Γöéfrom the SecureEntry registry. Look into the associated     Γöé
  12631. Γöé      Γöé      Γöémessage to find more about it. Refer to the Session control Γöé
  12632. Γöé      Γöé      Γöéerrors and messages table to find specific information aboutΓöé
  12633. Γöé      Γöé      Γöécode xxxx.                                                  Γöé
  12634. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12635. Γöéxxxx  ΓöéLSAP  ΓöéLan Server agent error xxxx. This means that the SecureEntryΓöé
  12636. Γöé      Γöé      ΓöéLan Server agent found an error. Refer to the agents error  Γöé
  12637. Γöé      Γöé      Γöétable to find more about xxxx.                              Γöé
  12638. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12639. Γöéxxxx  ΓöéLSER  ΓöéLan Server API error xxxx. This means that the SecureEntry  Γöé
  12640. Γöé      Γöé      ΓöéLan Server agent got an error passed up from the Lan Server Γöé
  12641. Γöé      Γöé      ΓöéAPI. Refer to the Lan server documentation to find about    Γöé
  12642. Γöé      Γöé      Γöéerror code xxxx. If this is a common error, chances are thatΓöé
  12643. Γöé      Γöé      Γöéthe associated error message contains some meaningful       Γöé
  12644. Γöé      Γöé      Γöéinformation. TIP: Most Lan Server API errors are also OS/2  Γöé
  12645. Γöé      Γöé      Γöébase errors, so HELP SYSxxxx may give you a clue.           Γöé
  12646. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12647. Γöéxxxx  ΓöéREGT  ΓöéRegistry API error xxxx. This means that the SecureEntry LanΓöé
  12648. Γöé      Γöé      ΓöéServer agent got an error passed up from the SecureEntry    Γöé
  12649. Γöé      Γöé      Γöéregistry component. Look into the associated message to findΓöé
  12650. Γöé      Γöé      Γöémore about it. Refer to the Session control errors and      Γöé
  12651. Γöé      Γöé      Γöémessages  table to find specific information about code     Γöé
  12652. Γöé      Γöé      Γöéxxxx. TIP: The Lan Server agent does only use the           Γöé
  12653. Γöé      Γöé      ΓöéSecureEntry Registry to store per group logon assignment    Γöé
  12654. Γöé      Γöé      Γöédata, so the error must be related to an operation of this  Γöé
  12655. Γöé      Γöé      Γöékind.                                                       Γöé
  12656. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12657. Γöéxxxx  ΓöéUCAG  ΓöéUCM administration agent error. This means that the UCM     Γöé
  12658. Γöé      Γöé      Γöésubsystem administration agent found an error. Refer to the Γöé
  12659. Γöé      Γöé      Γöéagents error table to find more about xxxx.                 Γöé
  12660. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12661. Γöéxxxx  ΓöéUCSQ  ΓöéA SQL API error has been reported to the UCM subsystem      Γöé
  12662. Γöé      Γöé      Γöéagent. Refer to the SQL error code table to find about errorΓöé
  12663. Γöé      Γöé      Γöéxxxx.                                                       Γöé
  12664. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12665. Γöéxxxx  ΓöéUCAP  ΓöéA UCM API error has been reported to the UCM subsystem      Γöé
  12666. Γöé      Γöé      Γöéagent. Refer to the agents error table to find more about   Γöé
  12667. Γöé      Γöé      Γöéerror code xxxx.                                            Γöé
  12668. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12669. Γöéxxxx  ΓöéUCME  ΓöéThis is a memory error reported by the UCM API to the UCM   Γöé
  12670. Γöé      Γöé      Γöéadministration agent. An allocation request failed either inΓöé
  12671. Γöé      Γöé      Γöéthe host or workstation site.                               Γöé
  12672. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  12673.  
  12674. Agents error table 
  12675.  
  12676. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  12677. ΓöéError ΓöéError name            ΓöéDescription                                       Γöé
  12678. ΓöénumberΓöé                      Γöé                                                  Γöé
  12679. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12680. Γöé001   ΓöéINFOOK                ΓöéInformational message. No real error happened, theΓöé
  12681. Γöé      Γöé                      Γöéassociated message contains event information thatΓöé
  12682. Γöé      Γöé                      Γöéhad to be reported.                               Γöé
  12683. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12684. Γöé002   ΓöéINVALID_KEYWORD_SIZE  ΓöéOne of the passed keywords (object attributes) wasΓöé
  12685. Γöé      Γöé                      Γöéeither too short or too long.                     Γöé
  12686. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12687. Γöé003   ΓöéINVALID_OBJTYPE       ΓöéThe agent received an invalid object type through Γöé
  12688. Γöé      Γöé                      Γöéthe API.                                          Γöé
  12689. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12690. Γöé004   ΓöéINVALID_OPERATION     ΓöéThe operation is not valid at this time (add,     Γöé
  12691. Γöé      Γöé                      Γöéupdate, delete..).                                Γöé
  12692. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12693. Γöé005   ΓöéINVALID_PARAMETERS    ΓöéGeneric error to report invalid parameters passed Γöé
  12694. Γöé      Γöé                      Γöéto the agent through an API call.                 Γöé
  12695. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12696. Γöé006   ΓöéEXISTS_OBJ            ΓöéThe object already exists.                        Γöé
  12697. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12698. Γöé007   ΓöéNEXISTS_OBJ           ΓöéThe required object does NOT exist.               Γöé
  12699. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12700. Γöé008   ΓöéEXPECTED_KWD          ΓöéA mandatory keyword was expected for this object. Γöé
  12701. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12702. Γöé009   ΓöéNEXPECTED_KWD         ΓöéAn unexpected keyword was received for this       Γöé
  12703. Γöé      Γöé                      Γöéobject.                                           Γöé
  12704. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12705. Γöé010   ΓöéNEXIST_KWD            ΓöéThe keyword does not exist.                       Γöé
  12706. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12707. Γöé011   ΓöéEXIST_KWD             ΓöéThe keyword already exists.                       Γöé
  12708. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12709. Γöé012   ΓöéINCORRECT_KWD         ΓöéGeneric. The keyword is incorrect.                Γöé
  12710. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12711. Γöé013   ΓöéNOT_ALL_KWD           ΓöéNot all keywords could be returned.               Γöé
  12712. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12713. Γöé014   ΓöéMANY_ROWS_FETCHED     ΓöéToo many rows fetched. The UCM API is configured  Γöé
  12714. Γöé      Γöé                      Γöéwith a maximum of tuples to handle as a response  Γöé
  12715. Γöé      Γöé                      Γöéto a query. Use the EDY_UCM_MAXROWS to customize  Γöé
  12716. Γöé      Γöé                      Γöéthis maximum for your needs.                      Γöé
  12717. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12718. Γöé015   ΓöéNROWS_FETCHED         ΓöéNo rows fetched. The result is empty since there  Γöé
  12719. Γöé      Γöé                      Γöéare no rows matching the search criteria.         Γöé
  12720. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12721. Γöé016   ΓöéDEL_USR_UCM           ΓöéCould not delete user from the UCM subsystem. It  Γöé
  12722. Γöé      Γöé                      Γöéis still defined in other subsystems.             Γöé
  12723. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12724. Γöé017   ΓöéDEL_SUB_UCM           ΓöéCould not delete the UCM subsystem. It must be theΓöé
  12725. Γöé      Γöé                      Γöélast one to delete.                               Γöé
  12726. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12727. Γöé018   ΓöéNEXIST_DEFKWD         ΓöéDefault required keyword 'Keyword Id' not found   Γöé
  12728. Γöé      Γöé                      Γöéfor the UCM subsystem.                            Γöé
  12729. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12730. Γöé960   ΓöéPRVERR                ΓöéNot enough privilege for the requested operation. Γöé
  12731. Γöé      Γöé                      ΓöéCheck the environment variable SGM_ADM_PRIV       Γöé
  12732. Γöé      Γöé                      Γöésetting.                                          Γöé
  12733. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12734. Γöé961   ΓöéLOGERR                ΓöéCould not open the log file for writing. The      Γöé
  12735. Γöé      Γöé                      Γöéreturned operating system return code is also     Γöé
  12736. Γöé      Γöé                      Γöésupplied.                                         Γöé
  12737. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12738. Γöé962   ΓöéDYNERR                ΓöéCould not dynamic link the required module. The   Γöé
  12739. Γöé      Γöé                      Γöéreturned operating system ret. code is also       Γöé
  12740. Γöé      Γöé                      Γöésupplied.                                         Γöé
  12741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12742. Γöé963   ΓöéMAXERR                ΓöéThe maximum number of subsystems has already been Γöé
  12743. Γöé      Γöé                      Γöéreached. Contact SecureEntry service support if   Γöé
  12744. Γöé      Γöé                      Γöéthis error happens.                               Γöé
  12745. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  12746.  
  12747. Processes Auditor Editor Errors and Messages 
  12748.  
  12749. The following messages may appear during regular editor runtime. 
  12750.  
  12751. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  12752. ΓöéError     ΓöéError Message                 ΓöéError Description                       Γöé
  12753. ΓöéNumber    Γöé                              Γöé                                        Γöé
  12754. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12755. ΓöéEDY1000   ΓöéInitialization failed.        ΓöéAn initialization task could not be     Γöé
  12756. Γöé          Γöé                              Γöécarried out. This may be produced as a  Γöé
  12757. Γöé          Γöé                              Γöéconsequence of lack of resources in the Γöé
  12758. Γöé          Γöé                              Γöésystem or of the editor corruption.     Γöé
  12759. Γöé          Γöé                              ΓöéVerify that other programs in the systemΓöé
  12760. Γöé          Γöé                              Γöéare running correctly and that the imageΓöé
  12761. Γöé          Γöé                              Γöéof the editor executable in the disk is Γöé
  12762. Γöé          Γöé                              Γöénot corrupted.                          Γöé
  12763. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12764. ΓöéEDY1001   ΓöéFailed to create main window. ΓöéThe editor main dialog could not be     Γöé
  12765. Γöé          Γöé                              Γöécreated. This may be produced as a      Γöé
  12766. Γöé          Γöé                              Γöéconsequence of lack of resources in the Γöé
  12767. Γöé          Γöé                              Γöésystem or of the editor corruption.     Γöé
  12768. Γöé          Γöé                              ΓöéVerify that other programs in the systemΓöé
  12769. Γöé          Γöé                              Γöéare running correctly and that the imageΓöé
  12770. Γöé          Γöé                              Γöéof the editor executable in the disk is Γöé
  12771. Γöé          Γöé                              Γöénot corrupted.                          Γöé
  12772. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12773. ΓöéEDY1002   ΓöéCannot open input file.       ΓöéThe specified file is R/O, or is held byΓöé
  12774. Γöé          Γöé                              Γöéanother process, or does not exist, or  Γöé
  12775. Γöé          Γöé                              Γöéthe full path name does not exist, or isΓöé
  12776. Γöé          Γöé                              Γöéactually a directory, or the disk is    Γöé
  12777. Γöé          Γöé                              Γöéfull, or the system has ran out of      Γöé
  12778. Γöé          Γöé                              Γöéhandles. In the latter, wait until      Γöé
  12779. Γöé          Γöé                              Γöéanother program has ended and retry the Γöé
  12780. Γöé          Γöé                              Γöéoperation.                              Γöé
  12781. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12782. ΓöéEDY1003   ΓöéCannot open output file.      ΓöéThe specified file is R/O, or is held byΓöé
  12783. Γöé          Γöé                              Γöéanother process, or the full path name  Γöé
  12784. Γöé          Γöé                              Γöédoes not exist, or is actually a        Γöé
  12785. Γöé          Γöé                              Γöédirectory, or the disk is full, or the  Γöé
  12786. Γöé          Γöé                              Γöésystem has ran out of handles. In the   Γöé
  12787. Γöé          Γöé                              Γöélatter, wait until another program has  Γöé
  12788. Γöé          Γöé                              Γöéended and retry the operation.          Γöé
  12789. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12790. ΓöéEDY1004   ΓöéFailed to load help manager.  ΓöéThe standard OS/2 help manager could notΓöé
  12791. Γöé          Γöé                              Γöélocate the file EDYEXECE.HLP. Verify    Γöé
  12792. Γöé          Γöé                              Γöéthat this file resides in the           Γöé
  12793. Γöé          Γöé                              ΓöéSecureEntry installation path, HELP     Γöé
  12794. Γöé          Γöé                              Γöésubdirectory.                           Γöé
  12795. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12796. ΓöéEDY1005   ΓöéFailed to load string.        ΓöéThe editor could not locate a string.   Γöé
  12797. Γöé          Γöé                              ΓöéVerify that the file EDYERROR.MSG       Γöé
  12798. Γöé          Γöé                              Γöéresides in the SecureEntry installation Γöé
  12799. Γöé          Γöé                              Γöépath, EXEC subdirectory, and that the   Γöé
  12800. Γöé          Γöé                              Γöéimage of the editor executable in the   Γöé
  12801. Γöé          Γöé                              Γöédisk is not corrupted.                  Γöé
  12802. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12803. ΓöéEDY1006   ΓöéFailed to display help panel. ΓöéThe editor could not locate a help      Γöé
  12804. Γöé          Γöé                              Γöépanel. Contact SecureEntry support team.Γöé
  12805. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12806. ΓöéEDY1007   ΓöéCannot load Exit List         ΓöéThe termination routine of the editor   Γöé
  12807. Γöé          Γöéprocessor.                    Γöécould not be loaded. This may be        Γöé
  12808. Γöé          Γöé                              Γöéproduced as a consequence of lack of    Γöé
  12809. Γöé          Γöé                              Γöéresources in the system. Verify that    Γöé
  12810. Γöé          Γöé                              Γöéother programs in the system are runningΓöé
  12811. Γöé          Γöé                              Γöécorrectly.                              Γöé
  12812. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12813. ΓöéEDY1008   ΓöéError getting file            ΓöéA call to the spooler validation or fileΓöé
  12814. Γöé          Γöéinformation.                  Γöésystem seek routines resulted in error. Γöé
  12815. Γöé          Γöé                              ΓöéContact SecureEntry support team.       Γöé
  12816. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12817. ΓöéEDY1009   ΓöéNot enough memory.            ΓöéLack of memory in the system. Reduce theΓöé
  12818. Γöé          Γöé                              Γöénumber of running programs, or the      Γöé
  12819. Γöé          Γöé                              Γöévalues of the BUFFERS=, TRACEBUF=,      Γöé
  12820. Γöé          Γöé                              ΓöéDISKCACHE=, THREADS=, RMSIZE=, or       Γöé
  12821. Γöé          Γöé                              ΓöéDEVICE=VDISK.SYS statements in the      Γöé
  12822. Γöé          Γöé                              ΓöéCONFIG.SYS file and then restart the    Γöé
  12823. Γöé          Γöé                              Γöésystem, or remove unwanted files from   Γöé
  12824. Γöé          Γöé                              Γöéthe swap file disk and restart the      Γöé
  12825. Γöé          Γöé                              Γöésystem.                                 Γöé
  12826. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12827. ΓöéEDY1010   ΓöéError reading file.           ΓöéA call to the spooler validation or fileΓöé
  12828. Γöé          Γöé                              Γöésystem read routines resulted in error. Γöé
  12829. Γöé          Γöé                              ΓöéContact SecureEntry support team.       Γöé
  12830. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12831. ΓöéEDY1011   ΓöéError writing file.           ΓöéA call to the spooler validation or fileΓöé
  12832. Γöé          Γöé                              Γöésystem write routines resulted in error,Γöé
  12833. Γöé          Γöé                              Γöéor the disk is full. If not the latter, Γöé
  12834. Γöé          Γöé                              Γöécontact SecureEntry support team.       Γöé
  12835. Γöé          Γöé                              ΓöéFor an export operation, this error     Γöé
  12836. Γöé          Γöé                              Γöéindicates that not all the information  Γöé
  12837. Γöé          Γöé                              Γöéhas been correctly exported, if any.    Γöé
  12838. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12839. ΓöéEDY1012   ΓöéInvalid input file format.    ΓöéThe input file is not a SecureEntry     Γöé
  12840. Γöé          Γöé                              ΓöéProcesses Auditor profile. Retry the    Γöé
  12841. Γöé          Γöé                              Γöéoperation with a real SecureEntry       Γöé
  12842. Γöé          Γöé                              ΓöéProcesses Auditor profile.              Γöé
  12843. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12844. ΓöéEDY1013   ΓöéThe process name to audit is  ΓöéYou did not provide the process name to Γöé
  12845. Γöé          Γöémissing.                      Γöéaudit when trying to add a new process  Γöé
  12846. Γöé          Γöé                              Γöéname to the list of processes to audit. Γöé
  12847. Γöé          Γöé                              ΓöéProvide a process name and retry the    Γöé
  12848. Γöé          Γöé                              Γöéoperation.                              Γöé
  12849. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12850. ΓöéEDY1014   ΓöéThe process name to audit is  ΓöéThe process name to audit you tried to  Γöé
  12851. Γöé          Γöéinvalid.                      Γöéadd contains one or some of the         Γöé
  12852. Γöé          Γöé                              Γöéfollowing invalid characters: 01-1F hex Γöé
  12853. Γöé          Γöé                              Γöé"    +   ,   /   ;   <   =   >   [   ]  Γöé
  12854. Γöé          Γöé                              Γöé|                                       Γöé
  12855. Γöé          Γöé                              ΓöéRemove the invalid characters and retry Γöé
  12856. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12857. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12858. ΓöéEDY1015   ΓöéThe process name to audit     ΓöéYou tried to add a process name that    Γöé
  12859. Γöé          Γöéalready exists.               Γöéalready exists. Provide a different     Γöé
  12860. Γöé          Γöé                              Γöéprocess name and retry the operation.   Γöé
  12861. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12862. ΓöéEDY1016   ΓöéThe number of invocations is  ΓöéYou specified to control the number of  Γöé
  12863. Γöé          Γöémissing.                      Γöéinvocations of the selected process, butΓöé
  12864. Γöé          Γöé                              Γöéyou did not specify the upper limit.    Γöé
  12865. Γöé          Γöé                              ΓöéSpecify it and retry the operation.     Γöé
  12866. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12867. ΓöéEDY1017   ΓöéThe number of invocations mustΓöéYou specified to control the number of  Γöé
  12868. Γöé          Γöébe a number.                  Γöéinvocations of the selected process, butΓöé
  12869. Γöé          Γöé                              Γöéthe upper limit you specified is not a  Γöé
  12870. Γöé          Γöé                              Γöénumber. Specify it as a number and retryΓöé
  12871. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12872. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12873. ΓöéEDY1018   ΓöéThe number of invocations mustΓöéYou specified to control the number of  Γöé
  12874. Γöé          Γöébe in the range 1 to 65535.   Γöéinvocations of the selected process, butΓöé
  12875. Γöé          Γöé                              Γöéthe upper limit you specified is out of Γöé
  12876. Γöé          Γöé                              Γöérange. Specify it to be in the range 1  Γöé
  12877. Γöé          Γöé                              Γöéto 65535 and retry the operation.       Γöé
  12878. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12879. ΓöéEDY1019   ΓöéCould not test the file.      ΓöéThe activation or deactivation of a     Γöé
  12880. Γöé          ΓöéReturned error code: %u       ΓöéSecureEntry Processes Auditor profile   Γöé
  12881. Γöé          Γöé                              Γöédid not succeed. Note down the enclosed Γöé
  12882. Γöé          Γöé                              Γöéreturn code and contact SecureEntry     Γöé
  12883. Γöé          Γöé                              Γöésupport team.                           Γöé
  12884. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  12885.  
  12886. The following messages may appear during import operations. Notice that any 
  12887. error will abort the whole import operation. 
  12888.  
  12889. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  12890. ΓöéError     ΓöéError Message                 ΓöéError Description                       Γöé
  12891. ΓöéNumber    Γöé                              Γöé                                        Γöé
  12892. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12893. ΓöéEDY1040   ΓöéUnexpected double quote found ΓöéDouble quotes must enclose only process Γöé
  12894. Γöé          Γöéat line %u of input file.     Γöénames containing blank spaces. Remove   Γöé
  12895. Γöé          ΓöéImport process aborted.       Γöésuch a symbol from the specified line inΓöé
  12896. Γöé          Γöé                              Γöéthe import file and retry the operation.Γöé
  12897. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12898. ΓöéEDY1041   ΓöéExpected double quote not     ΓöéDouble quotes must enclose only process Γöé
  12899. Γöé          Γöéfound in line %u of input     Γöénames containing blank spaces. Add such Γöé
  12900. Γöé          Γöéfile. Import process aborted. Γöéa symbol to the specified line in the   Γöé
  12901. Γöé          Γöé                              Γöéimport file and retry the operation.    Γöé
  12902. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12903. ΓöéEDY1042   ΓöéUnexpected end of line in lineΓöéThe specified line in the import file   Γöé
  12904. Γöé          Γöé%u of input file. Import      Γöéwas not complete. Either remove or      Γöé
  12905. Γöé          Γöéprocess aborted.              Γöécomment the line, or add the missing    Γöé
  12906. Γöé          Γöé                              Γöéinformation, and retry the operation.   Γöé
  12907. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12908. ΓöéEDY1043   ΓöéThe number of invocations in  ΓöéChange the number of invocations to     Γöé
  12909. Γöé          Γöéline %u of input file must be Γöéaudit in the specified line of the      Γöé
  12910. Γöé          Γöéa number in the range 1 to    Γöéimport file to a number in the range 1  Γöé
  12911. Γöé          Γöé65535 or the word 'All'.      Γöéto 65535 or to the word 'All' (without  Γöé
  12912. Γöé          ΓöéImport process aborted.       Γöésingle quotes). Then retry the          Γöé
  12913. Γöé          Γöé                              Γöéoperation.                              Γöé
  12914. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12915. ΓöéEDY1044   ΓöéUnexpected value for          ΓöéChange the value for Invocations Are    Γöé
  12916. Γöé          ΓöéInvocations Are Working       ΓöéWorking Sessions in the specified line  Γöé
  12917. Γöé          ΓöéSessions in line %u of input  Γöéof the import file to 'Yes' or 'No'     Γöé
  12918. Γöé          Γöéfile. Import process aborted. Γöé(without single quotes). Then retry the Γöé
  12919. Γöé          Γöé                              Γöéoperation.                              Γöé
  12920. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12921. ΓöéEDY1045   ΓöéUnexpected value for Discard  ΓöéChange the value for Discard CPU Usages Γöé
  12922. Γöé          ΓöéCPU Usages having Value Zero  Γöéhaving Value Zero in the specified line Γöé
  12923. Γöé          Γöéin line %u of input file.     Γöéof the import file to 'Yes' or 'No'     Γöé
  12924. Γöé          ΓöéImport process aborted.       Γöé(without single quotes). Then retry the Γöé
  12925. Γöé          Γöé                              Γöéoperation.                              Γöé
  12926. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12927. ΓöéEDY1046   ΓöéThe start date in line %u of  ΓöéChange the format of the string         Γöé
  12928. Γöé          Γöéinput file is not valid.      Γöéconforming the start date in the        Γöé
  12929. Γöé          ΓöéImport process aborted.       Γöéspecified line to a valid one and retry Γöé
  12930. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12931. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12932. ΓöéEDY1047   ΓöéThe start time in line %u of  ΓöéChange the format of the string         Γöé
  12933. Γöé          Γöéinput file is not valid.      Γöéconforming the start time in the        Γöé
  12934. Γöé          ΓöéImport process aborted.       Γöéspecified line to a valid one and retry Γöé
  12935. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12936. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12937. ΓöéEDY1048   ΓöéThe ending date in line %u of ΓöéChange the format of the string         Γöé
  12938. Γöé          Γöéinput file is not valid.      Γöéconforming the ending date in the       Γöé
  12939. Γöé          ΓöéImport process aborted.       Γöéspecified line to a valid one and retry Γöé
  12940. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12941. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12942. ΓöéEDY1049   ΓöéThe ending time in line %u of ΓöéChange the format of the string         Γöé
  12943. Γöé          Γöéinput file is not valid.      Γöéconforming the ending time in the       Γöé
  12944. Γöé          ΓöéImport process aborted.       Γöéspecified line to a valid one and retry Γöé
  12945. Γöé          Γöé                              Γöéthe operation.                          Γöé
  12946. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12947. ΓöéEDY1050   ΓöéThe ending timestamp in line  ΓöéEither change the ending timestamp to a Γöé
  12948. Γöé          Γöé%u of input file is less      Γöémore recent one, or the starting        Γöé
  12949. Γöé          Γöérecent than or equal to its   Γöétimestamp to a less recent one, and     Γöé
  12950. Γöé          Γöérelated starting timestamp.   Γöéretry the operation.                    Γöé
  12951. Γöé          ΓöéImport process aborted.       Γöé                                        Γöé
  12952. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12953. ΓöéEDY1051   ΓöéThe start date and time and   ΓöéYou are trying to import a detail line  Γöé
  12954. Γöé          Γöéthe process ID at line %u of  Γöéwhose key, constructed by the start dateΓöé
  12955. Γöé          Γöéinput file has already been   Γöéand time and the process ID, already    Γöé
  12956. Γöé          Γöéprocessed in the file. Import Γöéexisted in the same import file.        Γöé
  12957. Γöé          Γöéprocess aborted.              ΓöéSlightly modify the key in the specifiedΓöé
  12958. Γöé          Γöé                              Γöéline in the import file by changing the Γöé
  12959. Γöé          Γöé                              Γöéhundredths of second and retry the      Γöé
  12960. Γöé          Γöé                              Γöéoperation, or comment the specified lineΓöé
  12961. Γöé          Γöé                              Γöéand retry the operation.                Γöé
  12962. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12963. ΓöéEDY1052   ΓöéThe process ID specified in   ΓöéThe process ID could not be understood  Γöé
  12964. Γöé          Γöéline %u of input file is not  Γöéas an hexadecimal value. Change it in   Γöé
  12965. Γöé          Γöévalid. Import process aborted.Γöéthe specified line to a valid one and   Γöé
  12966. Γöé          Γöé                              Γöéretry the operation.                    Γöé
  12967. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12968. ΓöéEDY1053   ΓöéNot enough memory for import  ΓöéLack of memory in the system. Reduce theΓöé
  12969. Γöé          Γöéprocess starting at line %u ofΓöénumber of running programs, or the      Γöé
  12970. Γöé          Γöéinput file. Import process    Γöévalues of the BUFFERS=, TRACEBUF=,      Γöé
  12971. Γöé          Γöéaborted.                      ΓöéDISKCACHE=, THREADS=, RMSIZE=, or       Γöé
  12972. Γöé          Γöé                              ΓöéDEVICE=VDISK.SYS statements in the      Γöé
  12973. Γöé          Γöé                              ΓöéCONFIG.SYS file and then restart the    Γöé
  12974. Γöé          Γöé                              Γöésystem, or remove unwanted files from   Γöé
  12975. Γöé          Γöé                              Γöéthe swap file disk and restart the      Γöé
  12976. Γöé          Γöé                              Γöésystem.                                 Γöé
  12977. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12978. ΓöéEDY1054   ΓöéToo many items starting at    ΓöéThe maximum number of items in the list Γöé
  12979. Γöé          Γöéline %u of input file. Import Γöéof processes to audit is 32767. Either  Γöé
  12980. Γöé          Γöéprocess aborted.              Γöétry to break the input file into smallerΓöé
  12981. Γöé          Γöé                              Γöéones, or try to split the current       Γöé
  12982. Γöé          Γöé                              Γöéprofile into profiles having less items.Γöé
  12983. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  12984. ΓöéEDY1055   ΓöéThe start date and time and   ΓöéYou are trying to import a detail line  Γöé
  12985. Γöé          Γöéthe process ID at line %u of  Γöéwhose key, constructed by the start dateΓöé
  12986. Γöé          Γöéinput file already exist in   Γöéand time and the process ID, already    Γöé
  12987. Γöé          Γöécurrent profile. Import       Γöéexists in the current profile. Slightly Γöé
  12988. Γöé          Γöéprocess aborted.              Γöémodify the key in the specified line in Γöé
  12989. Γöé          Γöé                              Γöéthe import file by changing the         Γöé
  12990. Γöé          Γöé                              Γöéhundredths of second and retry the      Γöé
  12991. Γöé          Γöé                              Γöéoperation, or comment the specified lineΓöé
  12992. Γöé          Γöé                              Γöéand retry the operation.                Γöé
  12993. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  12994.  
  12995.  
  12996. ΓòÉΓòÉΓòÉ 11. UCM specifics ΓòÉΓòÉΓòÉ
  12997.  
  12998. Working with UCM allows SecureEntry to provide you with centralized, corporate 
  12999. level administration. In order to set up the centralized management 
  13000. workstation, read the Setting up the User Centralized Management workstation 
  13001. section. 
  13002.  
  13003. Under this environment, all of what has been explained until now is absolutely 
  13004. valid, with very few differences : 
  13005.  
  13006.      You have to use the administration tools through the UCMADM command, 
  13007.       which will setup the system to reroute all administration requests to the 
  13008.       host system. So, for instance, to call the interactive administration 
  13009.       tool the command becomes : 
  13010.  
  13011.  
  13012.                       UCMADM EDYSNADM
  13013.  
  13014.      If you have installed the RACF validation feature, you will not be able 
  13015.       to change user passwords through the SecureEntry administration tools. 
  13016.       You will have to use RACF to do so. 
  13017.  
  13018.      If you have installed the RACF emulator, you will be able to change user 
  13019.       passwords through the SecureEntry administration tools. 
  13020.  
  13021.      All changes you make to the central repository will become effective in 
  13022.       the LAN at logon time for the affected users. Changes made to group or 
  13023.       resource definitions will have to be processed through the EDYUCDIS 
  13024.       program before they are effective in the LAN environment. 
  13025.  
  13026.      You can define that all changes made to groups and resource definitions 
  13027.       in the central repository become effective in the LAN environment through 
  13028.       an asynchronous process (Refresh branch online). This is an alternative 
  13029.       method to EDYUCDIS program. The utility EDYBRNVW.EXE, can be used in that 
  13030.       case at any workstation to view the branch synchronization data. To 
  13031.       activate this procedure you must use the UCM administration tools. With 
  13032.       this tools you can define the update method for all branches of the 
  13033.       corporation. 
  13034.  
  13035.      You can allow parallel administration (allow regular LAN administration), 
  13036.       but then the central repository will not know about changes you made at a 
  13037.       LAN level, so you are encouraged not to do so. 
  13038.  
  13039.  
  13040. ΓòÉΓòÉΓòÉ 11.1. Refresh branch online ΓòÉΓòÉΓòÉ
  13041.  
  13042. Refresh Branch Online is a procedure to update the definitions of groups and 
  13043. resources of every branch of the corporation. This procedure has been 
  13044. integrated in EDYSRV.EXE process for updating LAN definitions dynamically. 
  13045.  
  13046. The refresh process is an alternate way to the Host batch processes, which gets 
  13047. information of UCM database changes (tables of changes), and to the Lan batch 
  13048. process (EDYUCDIS), which updates this information in the SecureEntry 
  13049. repository server. 
  13050.  
  13051. To activate the refresh branch online process, the EDYSRV process must be 
  13052. loaded with a specific parameter (policy). This parameter is explained in the 
  13053. EDYSRV and EDYFREE at SecureEntry maintenance utilities. 
  13054.  
  13055. The EDYDIS.LOG file keeps information about all refresh branch update activity. 
  13056. This file is stored in the path pointed to by the SGM_UCM_LOGPATH environment 
  13057. variable, explained in UCM specific at Environment Variables. 
  13058.  
  13059. SecureEntry provides the way to allow for easily update of the definitions of 
  13060. groups and resources. This chapter describes how do you do this. The following 
  13061. pages give more information about the process. 
  13062.  
  13063.      Update policy methods 
  13064.  
  13065.      Purge change tables 
  13066.  
  13067.      Update policy override 
  13068.  
  13069.  
  13070. ΓòÉΓòÉΓòÉ 11.1.1. Update policy methods ΓòÉΓòÉΓòÉ
  13071.  
  13072. The different methods to update this definitions are named update policy. 
  13073.  
  13074. When this procedure is started, the actual update level of every branch is 
  13075. established by checking for it in the corporate repository. Then the necessary 
  13076. changes are downloaded to the branch and applied, registering the branch as 
  13077. updated to the latest known level. 
  13078.  
  13079. The update policy can be modified according to needs of every corporation, and 
  13080. stored at the UCM repository. You can do this operation through to UCM 
  13081. administration tools. At installation time, this procedure will be off by 
  13082. default. 
  13083.  
  13084. Once a day, every branch will query the Host for the update policy to 
  13085. synchronize the Lan policy for if it has been changed. 
  13086.  
  13087. The update policy can take the following values: 
  13088.  
  13089.      Logon The branch information changes, if any, are downloaded from the 
  13090.       Host at LOGON time. 
  13091.  
  13092.      Ipl The branch information changes, if any, are downloaded from the Host 
  13093.       at IPL time. 
  13094.  
  13095.      Never The branch information changes are never downloaded from the Host. 
  13096.  
  13097.      Time The branch information changes are downloaded from the Host at the 
  13098.       hour and minute specified. 
  13099.  
  13100.  
  13101. ΓòÉΓòÉΓòÉ 11.1.2. Purge change tables ΓòÉΓòÉΓòÉ
  13102.  
  13103. When the system administrator defines the update policy branch through the 
  13104. administration tools, he also can define the number of branches of the 
  13105. corporation to be stored in the corporate repository. If this number is not 
  13106. zero, then the purge process will be activated. Then, when changes are 
  13107. downloaded to all branches of the company, the information will be removed from 
  13108. the tables of pending changes within the corporate repository. 
  13109.  
  13110.  
  13111. ΓòÉΓòÉΓòÉ 11.1.3. Update policy override ΓòÉΓòÉΓòÉ
  13112.  
  13113. You can customize EDYSRV to override the update policy stored in the repository 
  13114. of the company. To do this, you must load EDYSRV with one specific parameter 
  13115. which will override de update host update policy. 
  13116.  
  13117. This parameter can take one of the following values at load time: 
  13118.  
  13119.      Logon The branch information changes, if any, are downloaded from the 
  13120.       Host at LOGON time. 
  13121.  
  13122.      Ipl The branch information changes, if any, are downloaded from the Host 
  13123.       at IPL time. 
  13124.  
  13125.      Never The branch information changes are never downloaded from the Host. 
  13126.  
  13127.      Time The branch information changes are downloaded from the Host at the 
  13128.       hour and minute specified. 
  13129.  
  13130.      Periodically Specify the wait number of minutes before activating the 
  13131.       refresh process and then repeat it every specified number of minutes. At 
  13132.       start up time, the branch information changes, if any, are downloaded 
  13133.       from the Host. 
  13134.  
  13135.  
  13136. ΓòÉΓòÉΓòÉ 11.2. UCM Logging Facility ΓòÉΓòÉΓòÉ
  13137.  
  13138. Through of the UCM administrator utilities you can activate de Logging facility 
  13139. for UCM operations. All the operations will be logged at Host site and later 
  13140. can be managed by the EDYEXLOG process at Host environment. For further 
  13141. information about this process refer to the EDYEXLOG batch process in the UCM 
  13142. administrator's guide. 
  13143.  
  13144.  
  13145. ΓòÉΓòÉΓòÉ 11.3. UCM Recovery Facility ΓòÉΓòÉΓòÉ
  13146.  
  13147. If the Refresh branch online process fails because a wrong definition has been 
  13148. made, you can correct the definition through the UCM administrator utility and 
  13149. afterwards run the EDYRVUCM process in your UCM administrator workstation to 
  13150. correct and compress the change tables involved in the error. 
  13151.  
  13152. This tool checks the change tables of the UCM database compressing and 
  13153. correcting the unnecessary rows as described in EDYRVUCM recovery tool. 
  13154.  
  13155.  
  13156. ΓòÉΓòÉΓòÉ 11.4. RACF emulator ΓòÉΓòÉΓòÉ
  13157.  
  13158. The RACF emulator lets you validate users passwords against the UCM database 
  13159. instead of the security subsystem that you may have installed at Host site. 
  13160.  
  13161. You can specify the valid character set and maximum and minimum length of the 
  13162. passwords to be used for the users of the corporation. 
  13163.  
  13164.  
  13165. ΓòÉΓòÉΓòÉ 12. Deinstalling SecureEntry ΓòÉΓòÉΓòÉ
  13166.  
  13167. If, after installing, you ever want to deinstall SecureEntry 3.0, you can use 
  13168. the command 'UNINSTAL.CMD' that will be placed under your x:\SGMSHELL\INSTALL 
  13169. directory. It will completely remove SecureEntry from your machine. The command 
  13170. syntax is as follows: 
  13171.  
  13172.  
  13173.          UNINSTAL [BATCH] [SHUTDOWN]
  13174.  
  13175. Use the BATCH parameter to avoid program prompts, and the SHUTDOWN one to force 
  13176. machine shutdown after process completion. 
  13177.  
  13178. Note that before uninstalling, you must remove manually the boot protection 
  13179. mechanism if installed. 
  13180.  
  13181. Note also that after the deinstallation process is finished, you will be 
  13182. prompted to reboot the machine, and the immediate reboot may take longer than 
  13183. usual, since it is then when all SecureEntry files will be physically erased. 
  13184.  
  13185.  
  13186. ΓòÉΓòÉΓòÉ 13. Differences from SecureEntry 2.0 ΓòÉΓòÉΓòÉ
  13187.  
  13188. This version of SecureEntry has lots of improvements over previous versions, 
  13189. being basically a much improved superset of that version : 
  13190.  
  13191.    1. SES (Security enabling services) architecture based, Which improves 
  13192.       robustness and security, besides being a follow on for IBM OS/2 security 
  13193.       based strategy. 
  13194.  
  13195.    2. Seamless integration of new components : 
  13196.  
  13197.           The windows behavior (system_menus) component, allows you to set up 
  13198.            the initial position of any application window, plus deactivating 
  13199.            system menu entries. 
  13200.  
  13201.           The windows list component, allows you to control and setup the 
  13202.            aspect of the switch list, as well as its behavior. 
  13203.  
  13204.           The Floppy restrictions component, allows you to restrict access to 
  13205.            the floppy disk drive to any user/group, besides allowing simple 
  13206.            encipherment of the diskette drive contents. 
  13207.  
  13208.           The SES behavior component, allows you to choose on various system 
  13209.            level functions in a per user/group basis, including the action to 
  13210.            take on Ctrl-Alt-Del, What bitmaps to use, and/or how to configure 
  13211.            the screen saver function. 
  13212.  
  13213.           The File access component (Tree-Lock), allows you to restrict access 
  13214.            at a file system level to files and/or directories. 
  13215.  
  13216.           The SecureEntry Launchpad component allows you to configure 
  13217.            launchpad models for your different groups/users. 
  13218.  
  13219.    3. Much broader scope. Now SecureEntry supports three types of basic 
  13220.       installations, from standalone to centrally administered installs, not 
  13221.       requiring Lan Server if not desired. (Thus, incorporating its own user's 
  13222.       registry). 
  13223.  
  13224.    4. New Logon Modular Procedures architecture, which makes it possible to 
  13225.       build a custom-written module to unify the signon process to your 
  13226.       subsystem of choice. 
  13227.  
  13228.    5. Rewritten administration tools (batch and interactive), which allow 
  13229.       easily to configure your users/groups database from any workstation. (Now 
  13230.       all workstations are 'administration aware', and it only depends on who 
  13231.       did sign on (administrator or user), whether these functions will be 
  13232.       available. Note also that the administration tools are common and 
  13233.       independent on the environment setup. 
  13234.  
  13235.    6. Improved granularity. Now you can assign any security component to any 
  13236.       user or group, being user profiles always overriding existing component 
  13237.       group profiles. 
  13238.  
  13239.    7. Improved and simpler installation routines, still allowing for batch 
  13240.       and/or interactive installs. 
  13241.  
  13242.    8. Rewritten UCM support. For centrally administered installations, UCM has 
  13243.       been rewritten, and the SecureEntry components supporting this 
  13244.       alternative solution have also been rewritten, allowing for much more 
  13245.       flexibility and robustness, plus great performance enhancements. Note 
  13246.       that UCM is not included in this package itself. 
  13247.  
  13248.  
  13249. ΓòÉΓòÉΓòÉ 14. Common questions and tips ΓòÉΓòÉΓòÉ
  13250.  
  13251. The following list provides tips and answers to common questions: 
  13252.  
  13253.      Installation tips 
  13254.  
  13255.      Boot/signon/sign-off problems and tips 
  13256.  
  13257.      Configuration/administration tips 
  13258.  
  13259.      Miscellaneous tips 
  13260.  
  13261.      UCM common situations 
  13262.  
  13263.  
  13264. ΓòÉΓòÉΓòÉ 14.1. Installation tips ΓòÉΓòÉΓòÉ
  13265.  
  13266. This section describes solutions to common installation problems. 
  13267.  
  13268.  
  13269. ΓòÉΓòÉΓòÉ 14.1.1. What is the best way to prepare a system to install SecureEntry 3.0 ? ΓòÉΓòÉΓòÉ
  13270.  
  13271. If you choose to use the Security Enabling Services, then since SecureEntry 3.0 
  13272. requires OS/2 WARP, SES and a fixpack level of at least 17, and because OS/2 
  13273. fixpacks are cumulative and provide service code for SES also, then for new 
  13274. machines, the fastest sequence would be : 
  13275.  
  13276.    1. Install OS/2 Warp 
  13277.  
  13278.    2. Install SES 
  13279.  
  13280.    3. Install the current OS/2 fixpack level 
  13281.  
  13282.  Note that if you do it in the reverse order, you may lose the service modules 
  13283.  that the OS/2 fixpack could have for SES. 
  13284.  
  13285.  
  13286. ΓòÉΓòÉΓòÉ 14.1.2. I get the error 'UNPACK32 ERROR' or similar... What is wrong ? ΓòÉΓòÉΓòÉ
  13287.  
  13288. If you receive unpack errors while installing, then either : 
  13289.  
  13290.    1. The original SecureEntry diskette bundle files are damaged, or 
  13291.  
  13292.    2. The unpack program does not 'understand' the packed bundle files. 
  13293.  
  13294.  For the first case, it is easy to verify from your sources the correctness of 
  13295.  your diskettes... The second one can only happen because you have installed an 
  13296.  old version of the FTCOMP.DLL library. This could happen if you had installed 
  13297.  in this same machine BranchCare, or other product which uses this DLL. In this 
  13298.  case, you can replace the DLL with the one shipped in the first SecureEntry 
  13299.  installation diskette. 
  13300.  
  13301.  
  13302. ΓòÉΓòÉΓòÉ 14.1.3. After installation, what userid and password should I use ? ΓòÉΓòÉΓòÉ
  13303.  
  13304. Please, read the chapter of this same document titled What to do after 
  13305. installing. 
  13306.  
  13307.  
  13308. ΓòÉΓòÉΓòÉ 14.1.4. How can I know the build level number for my installed product ? ΓòÉΓòÉΓòÉ
  13309.  
  13310. Other than reading at the install/service window while applying this driver, 
  13311. you can always type the file 'SENTRY.SIG' located in the install directory 
  13312. within your SecureEntry path. 
  13313.  
  13314.  
  13315. ΓòÉΓòÉΓòÉ 14.1.5. How can I distribute my own add on's or profiles with SecureEntry installation ? ΓòÉΓòÉΓòÉ
  13316.  
  13317. Read the Personalized installations chapter 
  13318.  
  13319.  
  13320. ΓòÉΓòÉΓòÉ 14.1.6. Can I provide service to a machine with another NLS version of SecureEntry ? ΓòÉΓòÉΓòÉ
  13321.  
  13322. Yes, but the workbench object titles will not appear in the new language. You 
  13323. will have to erase the workbench shadow and underlying objects and recreate the 
  13324. workbench by executing the 'EDYCRWRK.CMD' command located in your 
  13325. SecureEntryPath, install directory. 
  13326.  
  13327.  
  13328. ΓòÉΓòÉΓòÉ 14.1.7. After installation/service the workbench contains missing objects... ΓòÉΓòÉΓòÉ
  13329.  
  13330. This is normally an indication of some small corruption in your system ini 
  13331. files. You can use the EDYCLINI program to attempt to fix this, and then upon 
  13332. reboot, delete the workbench and underlying objects, followed by a recreation 
  13333. of those using the 'EDYCRWRK.CMD' command, located in your SecureEntryPath, 
  13334. install directory. 
  13335.  
  13336.  
  13337. ΓòÉΓòÉΓòÉ 14.1.8. The service procedure hangs. What should I check for ? ΓòÉΓòÉΓòÉ
  13338.  
  13339. There is one case in which the service procedure will look like 'hanged'. It is 
  13340. when you have activated a Treelock profile which does not let cmd fullscreens 
  13341. to be launched. The underlying subsystem sees the 'access denied' message and 
  13342. attempts to reopen the fullscreen. You will have to reboot the machine, remove 
  13343. the treelock profile and retry. 
  13344.  
  13345.  
  13346. ΓòÉΓòÉΓòÉ 14.1.9. I get massages installing about too many open files, not enough handles or copy problems... ΓòÉΓòÉΓòÉ
  13347.  
  13348. It may be the case that you have installed in the target machine other software 
  13349. that is using most of the WorkPlace file handles. In order to overcome this 
  13350. situation, edit your config.sys and add the line : 
  13351.  
  13352.  
  13353.     SET SHELLHANDLESINC=30
  13354.  
  13355.  
  13356. ΓòÉΓòÉΓòÉ 14.1.10. I am installing over Warp 4.0, are there any tricks ? ΓòÉΓòÉΓòÉ
  13357.  
  13358. Warp 4.0 (Merlin) support is fully completed. It will work fine. Just remember, 
  13359. before installing SecureEntry, to install the SES component (in case you want 
  13360. to use the real thing instead of SecureEntry SES emulator),  which can be done 
  13361. by choosing the security component from the Selective install Operating system 
  13362. components list. 
  13363.  
  13364. It is possible that you encounter a hangup after installing SecureEntry in the 
  13365. first reboot. This problem is supposed to be fixed by Merlin FP1, but as a 
  13366. workaround, a reboot will normally be enough to bypass it and continue working. 
  13367.  
  13368.  
  13369. ΓòÉΓòÉΓòÉ 14.1.11. I have just installed. Where is my launchpad ? ΓòÉΓòÉΓòÉ
  13370.  
  13371. The default setup for SecureEntry is to not activate any launchpad. If you want 
  13372. to use the one you had before, just drag the Launchpad object located in the 
  13373. Installation tools folder into the opened EdyStart object within the NOUSER 
  13374. folder. You can also create a SecureEntry launchpad profile and place it in the 
  13375. NOUSER folder as a new default component profile, or assign it to users/groups 
  13376. as desired, using the administration tools. 
  13377.  
  13378.  
  13379. ΓòÉΓòÉΓòÉ 14.1.12. I find missing or hidden objects after uninstalling ΓòÉΓòÉΓòÉ
  13380.  
  13381. There was a bug in previous versions of SecureEntry that could make some 
  13382. original object styles not to be stored correctly. To cure from this : 
  13383.  
  13384.    1. Install SecureEntry in standalone mode. 
  13385.  
  13386.    2. Create a binary profile with default attribute set to visible for all 
  13387.       objects. 
  13388.  
  13389.    3. Run EDYCLASS /U profilename to set the default styles to those created in 
  13390.       the previous step. 
  13391.  
  13392.    4. Uninstall SecureEntry 
  13393.  
  13394.  
  13395. ΓòÉΓòÉΓòÉ 14.1.13. How to install SecureEntry with other applications that use SES (i.e, Tivoli) ΓòÉΓòÉΓòÉ
  13396.  
  13397. For now only coexistence with such applications is supported. Before you 
  13398. actually install SecureEntry, you must decide whether the session control 
  13399. functions are going to be managed by SecureEntry or the other SES client 
  13400. product. 
  13401.  
  13402. If you decide that SecureEntry is to manage session control (logon, logoff, 
  13403. lockup,...) then first of all you have to find a way to disable the session 
  13404. control panels in the other application. After this is achieved, install 
  13405. SecureEntry in SES coexistence mode as explained underneath, with the stealSES 
  13406. option 1. 
  13407.  
  13408. If you want the other application to manage the session control flow, then not 
  13409. only you have to install SecureEntry in coexistence mode with SES applications, 
  13410. but also define the required environment variables so that its own session 
  13411. control flow functions are disabled. You can do this by installing with the 
  13412. stealSES option 2, as follows. 
  13413.  
  13414. Installing in coexistence mode with other SES applications 
  13415.  
  13416. In any case, use the following options : 
  13417.  
  13418.    1. Do NOT install treelock support 
  13419.  
  13420.    2. Do use the SES emulator 
  13421.  
  13422.  Then, define the environment variable SET SGM_STEALSES=x , where x is the 
  13423.  option you choose before installing (1 for session control flow managed by 
  13424.  SecureEntry, 2 for Session control flow managed by the other application), and 
  13425.  proceed with the installation. 
  13426.  
  13427.  Note that option 2 can also be activated at installation time, regardless of 
  13428.  the SGM_STEALSES setting if SES is found installed and running during the 
  13429.  installation process, and you have choosen to use the SES emulator instead of 
  13430.  real SES. To clarify things a bit, if the other SES application is already 
  13431.  installed and running, you do not need to define the environment variable for 
  13432.  SecureEntry install to notice that coexistence mode is required. 
  13433.  
  13434.  The only difference between both options is that option 2 will also define in 
  13435.  your config.sys file the following environment variables : 
  13436.  
  13437.    set sgm_edylk_show=no
  13438.    set sgm_back_bitmap=no
  13439.    set sgm_ses_cad=yes
  13440.    set sgm_ses_inactivity=no
  13441.    set sgm_hide_wait_dlgs=yes
  13442.  
  13443.  After installing (before rebooting the machine), and in case you were using 
  13444.  option 2, you may wish to configure a edycust.cmd user exit file to 
  13445.  automatically logon any user as guest, or the desired user, by for instance, 
  13446.  invoking EDYUTIL within the UserExitBeforeLogonDialog with the appropriate 
  13447.  parameters (read about it under Programming user exits). In any case, notice 
  13448.  that the default user for standalone SecureEntry installations is setup with 
  13449.  the password expired, so the first logon should attempt to change this 
  13450.  password to succeed. You may also need to define a SES security profile in the 
  13451.  NOUSER folder, so that automatic lockup is avoided, and a desktop restrictions 
  13452.  profile (EDYDESK.INI) which suppresses the SecureEntry 'end session' option 
  13453.  from the desktop popup menu. 
  13454.  
  13455.  Remember that you can setup this user exit/profile files to be installed in 
  13456.  batch mode automatically as explained under Personalized installations. 
  13457.  
  13458.  
  13459. ΓòÉΓòÉΓòÉ 14.1.14. Integration with NSC/2 (Network Signon Coordinator) ΓòÉΓòÉΓòÉ
  13460.  
  13461. SecureEntry provides with an NSC/2 Logon Modular Procedure, which you can use 
  13462. in place of the RACF or RACF emulator ones. This section explains how to 
  13463. customize and use it in your environment: 
  13464.  
  13465. INTRODUCTION 
  13466.  
  13467. This logon modular procedure allows you to integrate the NSC/2 ( Network SignOn 
  13468. Coordinator/2 ) productivity tool within the SecureEntry logon flow. This 
  13469. procedure must be configured as the main (synchronizer) one, due to the fact 
  13470. that it lacks the ability to force a given user's password at signon time, thus 
  13471. not being able to play the role of other password synchronized subsystems by 
  13472. SecureEntry. 
  13473.  
  13474. When you perform a SecureEntry logon, password change, or logoff, you will be 
  13475. performing, respectively, a logon, a password change or a logoff to the 
  13476. subsystems defined in the NSC configuration file, as well as to all the other 
  13477. configured regular SecureEntry subsystems. 
  13478.  
  13479. By means of the environment variable SGM_NC you can decide which of the 
  13480. subsystems defined in the NSC profile will work as password synchronizers for 
  13481. the rest of SecureEntry LMPs. If you define more than one NSC subsystems as 
  13482. synchronizers, then SecureEntry passwords will only be forced, if each and 
  13483. everyone of the NSC synchronizers can logon successfully. 
  13484.  
  13485. INSTALLATION 
  13486.  
  13487. Follow the underneath instructions to install this LMP: 
  13488.  
  13489.    1. Define this LMP in the EDYSSLMP.DAT file at the second position after the 
  13490.       SS definition. To define this LMP use the NC identifier and use parameter 
  13491.       0. Remember to erase your previous synchronizer definition, if any.After 
  13492.       you include this subsystem in the EDYSSLMP.DAT file, it will look more or 
  13493.       less as follows: 
  13494.  
  13495.             SS 1 EDYDOM
  13496.             NC 0
  13497.              ...
  13498.             Rest of subsystems
  13499.  
  13500.    2. Define, if necessary, the SGM_NC environment variable in your config.sys 
  13501.       file, as needed. 
  13502.  
  13503.    3. Specify in your CONFIG.SYS file the SGM_LS_IFLOGGED environment variable 
  13504.       with the FORCEUSE value. 
  13505.  
  13506.    4. Reboot your machine. 
  13507.  
  13508.  IMPORTANT CONSIDERATIONS 
  13509.  
  13510.  If you decide to use this logon procedure, keep into account : 
  13511.  
  13512.      It may be advisable to protect the NSC configuration files against write 
  13513.       access by unauthorized people in order to avoid security exposures. Only 
  13514.       administrators ought to be able to modify NSC/2 configuration files. You 
  13515.       can use the Treelock SecureEntry component to restrict access to this 
  13516.       files. 
  13517.  
  13518.      The Lan Server logon will be performed to the domain specified in the 
  13519.       SecureEntry logon dialog and not to the lan domain specified in the NSC 
  13520.       configuration file. 
  13521.  
  13522.      If the different NSC passwords become desynchronized,for instance, 
  13523.       because a password change request is processed while some subsystems are 
  13524.       not available, follow the next procedure to get them synchronized again 
  13525.       and be able to signon : 
  13526.  
  13527.         1. make sure you that all of the NSC/2 subsystems are available. 
  13528.  
  13529.         2. Try a SecureEntry logon with password change. Supply as  signon 
  13530.            password the password for the first subsystem that is not 
  13531.            synchronized and as new password the password for the synchronized 
  13532.            subsystems. You will notice that the invalid password message is 
  13533.            returned. However, the password change request should have been 
  13534.            honored, thus synchronizing the password for the intended subsystem. 
  13535.            Repeat this step for the rest of NSC/2 subsystems to synchronize. 
  13536.  
  13537.         3. Try a SecureEntry signon again, this time, it will succeed. 
  13538.  
  13539.  
  13540. ΓòÉΓòÉΓòÉ 14.2. Boot/signon/sign-off problems and tips ΓòÉΓòÉΓòÉ
  13541.  
  13542. This section describes solutions to common problems during a work session with 
  13543. SecureEntry related to event handling. 
  13544.  
  13545.  
  13546. ΓòÉΓòÉΓòÉ 14.2.1. I get a signon error saying that the system can not open the file 'EDYREGDB.VLB'. What is wrong ? ΓòÉΓòÉΓòÉ
  13547.  
  13548. This file is necessary to be accessible right after the physical signon in 
  13549. order to extract the security profiles from it. Verify the following points : 
  13550.  
  13551.      That you have installed SecureEntry in your Lan Server domain controller, 
  13552.       specifying, at installation time, that it is the security profiles 
  13553.       server, either by responding 'YES' to the interactive dialog, or by using 
  13554.       the 'SERVER' parameter for unattended installs. If you are not sure, look 
  13555.       for the file 'EDYREGDB.VLB' in the server's SecureEntry path, NOUSER 
  13556.       directory. This file is created only in the SecureEntry servers. 
  13557.  
  13558.      That the user logging in is a Lan Server administrator one, or 
  13559.  
  13560.      That the user belongs to a SecureEntry group (group name starts by 
  13561.       letters 'SG'). 
  13562.  
  13563.      If the user belongs to a SecureEntry group, then verify that this group 
  13564.       has an access defined to resource 'SGMSHELL' of the domain controller 
  13565.       with 'RWA' Attributes. This access is provided by SecureEntry 
  13566.       administration tools when defining a SecureEntry group, but can be 
  13567.       missing if the group was defined through the Lan Server admin. tools 
  13568.       directly, or you have deinstalled and reinstalled SecureEntry in the 
  13569.       server machine after creating the group. 
  13570.  
  13571.      Check that the Lan Server resource 'SGMSHELL' is currently being shared 
  13572.       in the server machine. 
  13573.  
  13574.      Finally, this error can also be caused by an old bug existing in the MPTS 
  13575.       code. Verify that you have applied fixpack level WR08610 at least. 
  13576.  
  13577.  
  13578. ΓòÉΓòÉΓòÉ 14.2.2. I get an error at signon saying 'Lan Server Fail'. What is wrong ? ΓòÉΓòÉΓòÉ
  13579.  
  13580. The first cause of this error is that the edysrv.exe program is not running at 
  13581. the domain server site. This program should be started with a detach sentence 
  13582. within the 'EDYSTART.CMD' file of the domain server machine. Note that this 
  13583. line is normally placed by SecureEntry installation. Remember that the correct 
  13584. sentence for starting it under IBM Lan Server environment is : 
  13585.  
  13586.  
  13587.      DETACH EDYSRV.EXE /N:EDYdomainname
  13588.  
  13589.      where domainname is the name of your domain.
  13590.  
  13591. A second possibility may be that either the Lan requester program is not 
  13592. running in the requester (client) machine, or that the server is unreachable, 
  13593. because of a logical or physical breakage of the lan. 
  13594.  
  13595. Yet another cause for this sort of problem can be a mismatch between password 
  13596. maintenance rules for Lan Server against RACF, if this one is being used. For 
  13597. instance, you try to use for an user the same password that was used two weeks 
  13598. ago, and RACF allows for that, but Lan Server does not because it matches one 
  13599. of his last memorized passwords for the user. This is why it is recommended 
  13600. that, when using RACF, you reset the Lan Server password restrictions to a less 
  13601. strict ones than those of RACF. For instance, The max. and min. password 
  13602. length, the uniqueness factor (historic memory for used passwords), etc.. You 
  13603. can modify this parameters using the NET ACCOUNTS command after signon as an 
  13604. administrator. Note that in this situation, the only way to be able to be able 
  13605. to signon with the 'problematic' user is to delete his LAN definition using 
  13606. EDYERASE and change his RACF password. 
  13607.  
  13608. Failing all of the above, please verify the user definitions at the UCM 
  13609. repository, since it is probably one of those that does not follow the required 
  13610. Lan Server required rules. 
  13611.  
  13612.  
  13613. ΓòÉΓòÉΓòÉ 14.2.3. How can I debug the processing of EDYSTART.CMD ? ΓòÉΓòÉΓòÉ
  13614.  
  13615. First of all, you can debug it normally during a user session with the 
  13616. EDYLKINI.EXE utility. But for those cases where errors only happen during boot, 
  13617. you can do the following : 
  13618.  
  13619.    1. Rename the file 'SecureEntryPath\DLL\EDYLKSTR.DLL' to another thing. 
  13620.  
  13621.    2. From now on the machine will boot through execution of STARTUP.CMD 
  13622.  
  13623.    3. Build a STARTUP.CMD file with the contents : 
  13624.  
  13625.  
  13626.                EDYLKINI /NOMODAL
  13627.  
  13628.    4. Now you can boot and debug the processing of EDYSTART.CMD 
  13629.  
  13630.       Do not forget to leave things as previously, once you are sure the 
  13631.       EDYSTART processing is correct. 
  13632.  
  13633.  
  13634. ΓòÉΓòÉΓòÉ 14.2.4. I cannot signon to the machine, or the machine does not start. What can I do ? ΓòÉΓòÉΓòÉ
  13635.  
  13636. Being SecureEntry a security product, it can prove itself especially difficult 
  13637. to go after this kind of problems, since the same mechanisms that protect the 
  13638. machine under normal operation will now interfere the diagnosis and correction 
  13639. of the error. 
  13640.  
  13641. Just to start, you will have to remove the boot protection feature from the 
  13642. machine, if any one is installed. Refer to the appropriate chapter for further 
  13643. information on this step. 
  13644.  
  13645. After this, you will be able to, at least, boot the machine from a DOS bootable 
  13646. disk, or OS/2 boot diskettes (installation diskettes 1 and 2), up to the point 
  13647. where you will be able to edit your config.sys file, and add the following line 
  13648. at the beginning : 
  13649.  
  13650.   call=c:\os2\cmd.exe
  13651.  
  13652. Then, and up on rebooting the machine, you will be able to investigate a bit 
  13653. further. First of all, and if you are in a hurry, verify the following : 
  13654.  
  13655.      That the LIBPATH sentence in your CONFIG.SYS file contains SecureEntry 
  13656.       directories and SES directories (when using real SES) in the first 
  13657.       position. 
  13658.  
  13659.      That the desktop background bitmap is not defined as a 4 bpp bitmap. OS/2 
  13660.       does not like them!. 
  13661.  
  13662.      That you do not have installed a very old and expired SecureEntry 
  13663.       evaluation copy. 
  13664.  
  13665.      That you have not played/modified your configuration files (i.e, 
  13666.       SENTRY.CNF, SENTRY.SIG, EDYSSLMP.DAT, EDYSLA.INI). Note that some of 
  13667.       these reside in the NOUSER directory. 
  13668.  
  13669.      That the SYS_DLLs required by SecureEntry to startup are correctly 
  13670.       registered in the OS2.INI file, as explained under EDYWINI., as it could 
  13671.       happen if you have just rebuilt your system files through MAKEINI 
  13672.  
  13673.      That you do not have user exit code or startup code that enters in an 
  13674.       endless loop. 
  13675.  
  13676.      That you have not just applied service or installed SecureEntry under 
  13677.       OS/2 Warp 4.0 (Merlin). If this is the case, and you have not applied 
  13678.       Merlin FixPack 1, then probably just by forcing a reboot of the machine, 
  13679.       the error will not reappear. 
  13680.  
  13681.      Erase any instance of the file 'EDYTRDSP.INI' that may be left in the 
  13682.       machine, as well as 'EDYTRC.DAT' and retry boot. If you have been playing 
  13683.       around with the trace utilities and its profiles have been left in an 
  13684.       unconsistent state due to an abnormal IPL, it is possible that the 
  13685.       machine is looping when attempting to read those. 
  13686.  
  13687.  If the error persists, then keep on pursuing the problem by making sure that : 
  13688.  
  13689.    1. That the EDYSTART.CMD file has been completely processed. Look at the 
  13690.       'EDYLKINI.LOG' file that the startup process writes for this purpose. 
  13691.       Remember that you will see in this file all messages that your own 
  13692.       edystart file displays through the edylkmsg command. 
  13693.  
  13694.       Once you are sure about the startup process, you should be able to see 
  13695.       the signon panel, and attempt to logon. If this is not successful, keep 
  13696.       on with the list : 
  13697.  
  13698.    2. Check that the user and password you are trying to signon with are valid, 
  13699.       correctly configured and activated. You may have to go to RACF and UCM 
  13700.       definitions, or Lan Server administration to do so. If you are not sure, 
  13701.       then try to signon with another userid for which you are sure that access 
  13702.       is granted. 
  13703.  
  13704.    3. In Lan Server and/or UCM environments, make sure that the EDYSRV module 
  13705.       is running in the server machine. This module is the one that acts as a 
  13706.       'gateway' to the host before the real signon is done. 
  13707.  
  13708.    4. Also in Lan Server environment, verify that the user you are issuing 
  13709.       logon with has access to the alias 'SGMSHELL'. This is the alias which 
  13710.       defines the access to the security profiles database. 
  13711.  
  13712.    5. Make sure that your user exits are working properly. You can add 'beeps' 
  13713.       or trace points in the EDYCUST.CMD file to know the logon points reached. 
  13714.  
  13715.    6. In order to know the operations performed during logon in UCM 
  13716.       environments, check at the EDYADMIN.LOG file. It may be a good idea to 
  13717.       set the SGM_SL_LOGMODE environment variable to 'TEST' value in your 
  13718.       config.sys to see the maximum of available information. 
  13719.  
  13720.    7. If everything else fails, then you can start the SecureEntry traces in 
  13721.       your EDYSTART.CMD file, and analyze the resulting trace file or report it 
  13722.       to the lab. 
  13723.  
  13724.  
  13725. ΓòÉΓòÉΓòÉ 14.2.5. I start lan requester and peer in a per user basis, and can not restart after sign-off ΓòÉΓòÉΓòÉ
  13726.  
  13727. When you sign off, SecureEntry does its best to kill all user tasks started 
  13728. during the ending session. Unfortunately, if you load system and/or base 
  13729. software during your work session (i.e, not during startup processing, but 
  13730. after logon), some times this software can not be killed in an orderly way and 
  13731. it may be that a daemon running at ring 0 does not even permit SecureEntry to 
  13732. kill it. This is the case of the WKSTAHLP process of the peer services. The 
  13733. only safe way to unload it is by a Lan Requester command. So, if you intend to 
  13734. allow peer services to be started by signed on users, then adding the following 
  13735. line within the user exit before imminent logoff is mandatory : 
  13736.  
  13737.  
  13738.   NET STOP REQ /Y
  13739.  
  13740. Refer to the lan requester command reference for more info about this command. 
  13741.  
  13742.  
  13743. ΓòÉΓòÉΓòÉ 14.2.6. Signon/sign-off performance. How to tune it ΓòÉΓòÉΓòÉ
  13744.  
  13745. First of all, read Fine tuning SecureEntry. Performance considerations, to know 
  13746. what can be done to improve performance. 
  13747.  
  13748. Then, if you want to confirm your data, and taking into account that the 
  13749. numbers can vary a lot depending on available hardware and software, we have 
  13750. obtained the following numbers : 
  13751.  
  13752.  
  13753.         Environment        Standalone     Lan Server    Lan Server + UCM
  13754.  
  13755.         Signon time        10 seconds     20 seconds    30 seconds
  13756.  
  13757. Note that this numbers have been obtained with no memory constrained machines, 
  13758. running a 486 DX2 processor. 
  13759.  
  13760.  
  13761. ΓòÉΓòÉΓòÉ 14.2.7. Logoff hangs the machine on server/overloaded systems, or other signon errors ΓòÉΓòÉΓòÉ
  13762.  
  13763. If you are using Lan Server 4.0, make sure you have installed PTF level IP08227 
  13764. for this product. Similarly,  IP08260 level is required for Lan Server 5.0. 
  13765.  
  13766.  
  13767. ΓòÉΓòÉΓòÉ 14.2.8. I get 'Another user is already logged on in this machine' ΓòÉΓòÉΓòÉ
  13768.  
  13769. In Lan Server environments, only a single simultaneous domain logon is 
  13770. supported at a given machine. If you have logged on to the domain through 
  13771. edystart.cmd or a user exit, SecureEntry will report this error when attempting 
  13772. to re-logon. Note also that the machine will in some instances force a domain 
  13773. logon if there is a local logon already done and you issue a NET command (i.e 
  13774. NET SHARE IPC$). To cure from this, you can either force a domain logoff 
  13775. (LOGOFF /D) right before SecureEntry attempts to logon, or touch the 
  13776. environment variable SGM_LS_IFLOGGED to leave this task to SecureEntry. 
  13777.  
  13778.  
  13779. ΓòÉΓòÉΓòÉ 14.3. Configuration/administration tips ΓòÉΓòÉΓòÉ
  13780.  
  13781. This section describes solutions to common problems that may arise when 
  13782. administering SecureEntry. 
  13783.  
  13784.  
  13785. ΓòÉΓòÉΓòÉ 14.3.1. How can I access more than one SecureEntry Lan from a single requester ? ΓòÉΓòÉΓòÉ
  13786.  
  13787. In order to be able to sign on to different SecureEntry LANs, and provided that 
  13788. you are working under an IBM Lan Server Environment, you have to configure it 
  13789. by checking the 'Enable domain change at sign on' at startup. Note that this 
  13790. will let you log on only to other SecureEntry 3.0 domains which are of similar 
  13791. configuration (same institution name and administration characteristics). 
  13792.  
  13793.  
  13794. ΓòÉΓòÉΓòÉ 14.3.2. How can I add my own components ? ΓòÉΓòÉΓòÉ
  13795.  
  13796. You will have to edit the file 'SENTRY.DSC' from the first installation 
  13797. diskette before installing, adding the appropriate components. Alternatively, 
  13798. if you want to update an already installed workstation, use the command 
  13799. UPDATEDB located in the SecureEntryPath, INSTALL directory. The syntax of this 
  13800. command is : 
  13801.  
  13802.  
  13803.      UPDATEDB descriptionfile
  13804.  
  13805.      Where descriptionfile is your modified SENTRY.DSC file.
  13806.  
  13807. Take into account that : 
  13808.  
  13809.      You have to be logged on as an administrator. 
  13810.  
  13811.      Modifying the SecureEntry base components definitions may cause the 
  13812.       database not to recognize already assigned components. 
  13813.  
  13814.  
  13815. ΓòÉΓòÉΓòÉ 14.3.3. Can I change password expiration interval, Max. signon attempts or min. password length ? ΓòÉΓòÉΓòÉ
  13816.  
  13817. Yes. To do so, 
  13818.  
  13819.      If your installation is a standalone one (no Lan Server), then You will 
  13820.       have to edit the file 'SENTRY.DSC' from the first installation diskette 
  13821.       before installing SecureEntry 3.0, setting up your preferred values. 
  13822.  
  13823.       For machines that have already been installed, read the previous question 
  13824.       in order to know how to run 'UPDATEDB' to activate this changes. 
  13825.  
  13826.      If your installation is of Lan Server type, then refer to the appropriate 
  13827.       Lan Server documentation in order to do so (Book : Network Administrator 
  13828.       Tasks, section : Managing Users and Groups, Chapter : Setting a user 
  13829.       password expiration period for a domain). 
  13830.  
  13831.  
  13832. ΓòÉΓòÉΓòÉ 14.3.4. How can I write my own user exits ? ΓòÉΓòÉΓòÉ
  13833.  
  13834. You can either program those in C (there is a skeleton and necessary files 
  13835. within your SecureEntry path, API\SOURCES\EDYCUST directory), or in REXX (the 
  13836. skeleton is placed in the same directory). If you write an EDYCUST.DLL, then 
  13837. place it afterwards within your SecureEntry path, DLL directory. If you write 
  13838. those in REXX, then place the resulting 'EDYCUST.CMD' in the SecureEntry path, 
  13839. EXEC directory. 
  13840.  
  13841. All of this is fully detailed under Programming user exits. 
  13842.  
  13843.  
  13844. ΓòÉΓòÉΓòÉ 14.3.5. How can I change the startup bitmaps ? ΓòÉΓòÉΓòÉ
  13845.  
  13846. Edit a SES behavior profile, and setup the lockup background bitmap and startup 
  13847. bitmaps of your choice, and then copy it with the default SES behavior 
  13848. component name 'EDYSES.INI' to the NOUSER directory within the SecureEntry 
  13849. path. They will be used at startup. 
  13850.  
  13851.  
  13852. ΓòÉΓòÉΓòÉ 14.3.6. I get 'LS API Error 53' when accessing group definitions. What is going on ? ΓòÉΓòÉΓòÉ
  13853.  
  13854. The error 53 means network path not found. You probably have an alias defined 
  13855. to a nonexistent path. 
  13856.  
  13857.  
  13858. ΓòÉΓòÉΓòÉ 14.3.7. I can not see objects in the tree view of my drives objects ΓòÉΓòÉΓòÉ
  13859.  
  13860. Each drive object by itself is considered a desktop object, but not its 
  13861. contents. When the workplace goes to create the tree view, it sees no object to 
  13862. expand its tree from (hang on the underlying tree) if the default object 
  13863. restrictions visibility setting is set to off, so it does not go on with the 
  13864. tree expansion. If this is not the behavior you want, then the solution is to 
  13865. add to your desktop restrictions profile an entry for each drive object you 
  13866. want to make visible with its visibility style set to on, or change the default 
  13867. visibility style setting of desktop objects to visible. 
  13868.  
  13869. Note that setting the profile to not apply restrictions to the non-desktop 
  13870. objects would not correct the situation since, as before said, the drives 
  13871. objects are really objects belonging to the desktop. 
  13872.  
  13873.  
  13874. ΓòÉΓòÉΓòÉ 14.3.8. Objects do not open in an autostart personal folder ΓòÉΓòÉΓòÉ
  13875.  
  13876. Probably the objects to open are non visible, and as such they are not shown 
  13877. and not found within the folder when running the autostart thread. If you want 
  13878. the objects to be invisible, but be opened anyways, you should make them 
  13879. visible but belonging to an invisible folder, so that the user can not find 
  13880. them even if visible. 
  13881.  
  13882.  
  13883. ΓòÉΓòÉΓòÉ 14.3.9. How are desktop object positions managed ? ΓòÉΓòÉΓòÉ
  13884.  
  13885. Read and follow the section Managing desktop objects position. 
  13886.  
  13887.  
  13888. ΓòÉΓòÉΓòÉ 14.3.10. How can I override the default logon/unlock panels ? ΓòÉΓòÉΓòÉ
  13889.  
  13890. You have to make use of the logon and lockup user exits, coding a call to your 
  13891. own logon/lockup panel display programs, which in turn call the 'EDYUTIL' 
  13892. session event launcher program in order to prefill the required input fields. 
  13893. Take into account that your presented dialog (logon or unlock) has to be system 
  13894. modal. Also note that the screen saver function will be fully active during the 
  13895. user exits processing. In any case, never forget to return system modality to 
  13896. the previous sysmodality owner once your dialog is destroyed. 
  13897.  
  13898. You can interact with the user in the following user exits : 
  13899.  
  13900.    EDY_USER_EXIT_AFTER_STARTUP
  13901.    EDY_USER_EXIT_BEFORE_LOGON_DIALOG
  13902.    EDY_USER_EXIT_BEFORE_LOGON
  13903.    EDY_USER_EXIT_BEFORE_LOGON_CHANGING_PASSWORD
  13904.    EDY_USER_EXIT_BEFORE_UNLOCK_DIALOG
  13905.    EDY_USER_EXIT_BEFORE_UNLOCK
  13906.    EDY_USER_EXIT_AFTER_UNSUCCESSFUL_UNLOCK
  13907.    EDY_USER_EXIT_AFTER_UNLOCK
  13908.    EDY_USER_EXIT_BEFORE_LOGOFF_FROM_UNLOCK
  13909.    EDY_USER_EXIT_BEFORE_SHUTDOWN_FROM_UNLOCK
  13910.  
  13911. Also, you may want to read about the SGM_USER_DLGS environment variable, to 
  13912. achieve maximum robustness in overriding the default logon/unlock dialogs. 
  13913.  
  13914.  
  13915. ΓòÉΓòÉΓòÉ 14.3.11. How can I manage object's popup restrictions for non-desktop objects ? ΓòÉΓòÉΓòÉ
  13916.  
  13917. Read the chapter about SecureEntry environment variables especially the 
  13918. environment variable SGM_WPS_NONDESKTOP. 
  13919.  
  13920.  
  13921. ΓòÉΓòÉΓòÉ 14.3.12. How can I manage the restrictions on printer spooler objects ? ΓòÉΓòÉΓòÉ
  13922.  
  13923. Read the chapter about SecureEntry environment variables especially the 
  13924. environment variable SGM_WPS_PRINTJOBS. 
  13925.  
  13926.  
  13927. ΓòÉΓòÉΓòÉ 14.3.13. I am attempting to do remote distribution or administration. What problems should I face ? ΓòÉΓòÉΓòÉ
  13928.  
  13929. All this kind of programs work by loading a 'daemon' of some sort which is the 
  13930. agent that really does the work in the background. If you are using a strict 
  13931. treelock profile, and also not starting this 'daemon' as a superuser context 
  13932. running process, then the first thing to do is to locate the name of this 
  13933. process and give it treelock access to all of your system's files. This will 
  13934. allow it to touch files such as config.sys, etc, overriding the SecureEntry 
  13935. implicit and user's restrictions. 
  13936.  
  13937. For NDM/2, read also the tip about NDM ACTIVATE on how to avoid the activate 
  13938. command from failing if using a diskette drive restrictions profile. 
  13939.  
  13940.  
  13941. ΓòÉΓòÉΓòÉ 14.3.14. How can I open Workplace objects from a user exit ? ΓòÉΓòÉΓòÉ
  13942.  
  13943. Look at the Sample user exit implementation, for a sample of the usage of the 
  13944. REXX SysOpenObject function. 
  13945.  
  13946. Note that if all you want to do is open a given object at startup or a given 
  13947. user logon time, it may be an easier choice to drag a shadow of the desired 
  13948. object to the list of shadows editor while editing the EDYSTART object in the 
  13949. NOUSER folder, or a given personal desktop profile's dynamic folder, which you 
  13950. then assign to the desired user. 
  13951.  
  13952.  
  13953. ΓòÉΓòÉΓòÉ 14.3.15. How can I remove the 'Original' menu item from shadow objects ? ΓòÉΓòÉΓòÉ
  13954.  
  13955. You can do this during after logon user exits processing by sending the 
  13956. appropriate SecureEntry setup string to the object. So, for instance 
  13957.  
  13958.  
  13959.   /* */
  13960.   If RxFuncQuery('SysLoadFuncs') Then Do
  13961.     Call RxFuncAdd 'SysLoadFuncs', 'REXXUTIL', 'SysLoadFuncs'
  13962.     Call SysLoadFuncs
  13963.   End
  13964.  
  13965.   call SysSetObjectData '<SGM_MAIN_WB_SHADOW>','EDYMENUITEM=REMOVE,ORIGINAL;'
  13966.  
  13967. Would remove the 'Original' menu item from the SecureEntry workbench popup 
  13968. menu. 
  13969.  
  13970. Note that this is an alternative to that of using the Windows restriction 
  13971. workbench for the same purpose. 
  13972.  
  13973.  
  13974. ΓòÉΓòÉΓòÉ 14.3.16. The bitmap for the background or screen saver function, does not look like working ΓòÉΓòÉΓòÉ
  13975.  
  13976. This can be for two main reasons : 
  13977.  
  13978.      The SES behavior profile is not active (either not assigned to the user 
  13979.       or group, or not present in the NOUSER directory, or not 'tested'), 
  13980.  
  13981.      Or the referred bitmap file is not present or invalid at the specified 
  13982.       path. 
  13983.  
  13984.  See also the next question, 
  13985.  
  13986.  
  13987. ΓòÉΓòÉΓòÉ 14.3.17. I have configured a NOUSER profile, but it does not get activated ΓòÉΓòÉΓòÉ
  13988.  
  13989. Machine profiles configured into the NOUSER directory are not granted to be 
  13990. activated at every sign-off, unless a profile of the same kind was assigned to 
  13991. the user or group that has signed off. After the next shutdown this profile 
  13992. will become the default one. Note that this is done for performance reasons in 
  13993. production machines. 
  13994.  
  13995. Other things to check are : 
  13996.  
  13997.      That the profile has the correct default profile file name. (the same as 
  13998.       the associated template in the TEMPLATE folder). 
  13999.  
  14000.      That the profile is of the correct type. 
  14001.  
  14002.  
  14003. ΓòÉΓòÉΓòÉ 14.3.18. How can I deactivate any new menu option for the desktop or its objects ? ΓòÉΓòÉΓòÉ
  14004.  
  14005. SecureEntry, as any other product, will always be behind in development, trying 
  14006. to 'catch' the last features incorporated to the operating system. Similarly, 
  14007. the SOM architecture allows for any third party program to enhance the function 
  14008. provided by the standard workplace by adding new menu entries, which may not 
  14009. always be desired within a protected environment as the one provided by 
  14010. SecureEntry. For this specific need, however, you can use the Windows behavior 
  14011. component and deactivate the required entries by name. 
  14012.  
  14013.  
  14014. ΓòÉΓòÉΓòÉ 14.3.19. What kind of bitmap files can I use ? ΓòÉΓòÉΓòÉ
  14015.  
  14016. Except for the SES component, desktop background bitmap, for which only OS/2 
  14017. standard bitmaps are accepted, in general the following bitmap formats are 
  14018. accepted : 
  14019.  
  14020.      OS/2 and Windows Bitmaps 
  14021.  
  14022.       The file extensions .BMP, .VGA, .BGA, .RLE, .DIB, .RL4, and .RL8 are 
  14023.       recognized as OS/2 1.1, 1.2, 2.0 or Windows 3.0 bitmaps. The newer 
  14024.       multimedia Windows bitmap format that allows 16 and 32 bits-per-plane is 
  14025.       not supported.  The files are written in OS/2 2.0/Windows 3.0 format. 
  14026.  
  14027.      CompuServe Graphics Interchange Format 
  14028.  
  14029.       The .GIF file extension is recognized as a GIF file. 
  14030.  
  14031.      ZSoft PC Paintbrush Image File Format 
  14032.  
  14033.       The .PCX file extension is recognized as a Paintbrush file. 
  14034.  
  14035.      Microsoft/Aldus Tagged Image File Format 
  14036.  
  14037.       The .TIF and .TIFF file extensions are recognized as TIFF files. 
  14038.  
  14039.      Truevision Targa/Vista Bitmap 
  14040.  
  14041.       The file extensions .TGA, .VST, and .AFI are recognized as Targa/Vista 
  14042.       files.  This class only supports 8 bit-per-plane and 24 bit-per-plane 
  14043.       images. 
  14044.  
  14045.      Amiga IFF/ILBM Interleaved Bitmap Format 
  14046.  
  14047.       The file extensions .IFF and .LBM are recognized as interleaved bitmap 
  14048.       files. 
  14049.  
  14050.      X Windows Bitmap 
  14051.  
  14052.       The .XBM file extension is recognized as a X Bitmap file. This class 
  14053.       supports X10 and X11 1bpp bitmaps.  Some .XBM files with text strings 
  14054.       inside look to be sprites or icons and are not supported. 
  14055.  
  14056.      IBM Printer Page Segment 
  14057.  
  14058.       The following file extensions .PSE, .PSEG, .PSEG38PP and .PSEG3820 are 
  14059.       recognized as PSEG files.  PSEG files are used to include image data in 
  14060.       BookMaster documents.  PSEG files only contain 1 bit-per-plane, which is 
  14061.       always ink on paper, ie: black on white. 
  14062.  
  14063.  
  14064. ΓòÉΓòÉΓòÉ 14.3.20. I can not run EDYSWLV. it hangs the session ΓòÉΓòÉΓòÉ
  14065.  
  14066. Verify that EDYSWL2.EXE is located in a directory accessible through your OS/2 
  14067. native PATH environment variable. 
  14068.  
  14069.  
  14070. ΓòÉΓòÉΓòÉ 14.3.21. I can not customize an object because it requires an Object ID ΓòÉΓòÉΓòÉ
  14071.  
  14072. Read the section About Object IDs. 
  14073.  
  14074.  
  14075. ΓòÉΓòÉΓòÉ 14.3.22. How to suppress the WarpCenter function ΓòÉΓòÉΓòÉ
  14076.  
  14077. If in your installation you will never use the WarpCenter, do the following 
  14078. changes to your CONFIG.SYS file 
  14079.  
  14080.      Remove the WARPCENTER keyword from the SET AUTOSTART sentence. 
  14081.  
  14082.      Define the line SET SGM_EDYSC_DISABLE=YES. 
  14083.  
  14084.  This will remove SecureEntry functionality and make warpcenter not to be 
  14085.  opened at startup. 
  14086.  
  14087.  Note however, that if some of your users will use warpcenter and some others 
  14088.  not, then your only option is to remove the profile EDYSC.INI from the NOUSER 
  14089.  directory, and assign appropriately a warpcenter profile to the required 
  14090.  users/groups. 
  14091.  
  14092.  
  14093. ΓòÉΓòÉΓòÉ 14.4. Miscellaneous tips ΓòÉΓòÉΓòÉ
  14094.  
  14095. This section gives generic tips for working with SecureEntry. 
  14096.  
  14097.  
  14098. ΓòÉΓòÉΓòÉ 14.4.1. What is the order in which security profiles are accessed / activated ? ΓòÉΓòÉΓòÉ
  14099.  
  14100. Each component has its own default profile settings. These settings are 
  14101. overridden by any profile for the component placed within the SecureEntry 
  14102. NOUSER path, which is in turn overridden by the the current logged on user's 
  14103. SecureEntry group profile, which is in turn overridden by any existing profile 
  14104. for the given component assigned directly to the user. 
  14105.  
  14106.  
  14107. ΓòÉΓòÉΓòÉ 14.4.2. How can I run a unattended/centralized administration policy ? ΓòÉΓòÉΓòÉ
  14108.  
  14109. Ask about UCM. UCM is a corporate administration SecureEntry plug-in product 
  14110. which allows you to administer your LANs from a Host site, among other 
  14111. features. 
  14112.  
  14113.  
  14114. ΓòÉΓòÉΓòÉ 14.4.3. How can I integrate my own network more seamlessly ? ΓòÉΓòÉΓòÉ
  14115.  
  14116. If you do not have IBM Lan server, you can run with the 'other networks' 
  14117. support that SecureEntry provides, but that is not all that can be done. If 
  14118. your network has an interface for signon/sign-off, it is quite easy to program 
  14119. an LMP (Logon modular procedure) which will sign you on to your network at 
  14120. SecureEntry signon time, synchronizing the password to the one the SecureEntry 
  14121. registry stores. Read the programmers reference in order to do so. 
  14122.  
  14123.  
  14124. ΓòÉΓòÉΓòÉ 14.4.4. Is there any administration activity log file ? ΓòÉΓòÉΓòÉ
  14125.  
  14126. Yes. The file is named EDYADMIN.LOG, and located where the environment variable 
  14127. SGM_DB points to. It is a text file which you may want to purge in a periodic 
  14128. basis. Note that you can setup what gets logged there by setting an environment 
  14129. variable in your config.sys named SGM_SL_LOGMODE with the following values : 
  14130.  
  14131.  
  14132.   SET SGM_SL_LOGMODE=ALL     : Log all activity
  14133.   SET SGM_SL_LOGMODE=UPDATES : Log only activity which modifies the database.
  14134.                                This is the default setting
  14135.   SET SGM_SL_LOGMODE=NONE    : Log no activity
  14136.  
  14137.  
  14138. ΓòÉΓòÉΓòÉ 14.4.5. Backing up a SecureEntry installation ΓòÉΓòÉΓòÉ
  14139.  
  14140. You need only to backup from the server machines (or standalone machines), the 
  14141. following files : 
  14142.  
  14143.      SecureEntryPath\NOUSER\*.* 
  14144.  
  14145.      SecureEntryPath\INSTALL\SENTRY.CNF 
  14146.  
  14147.      SecureEntryPath\DLL\EDYCUST.DLL (if any) 
  14148.  
  14149.      SecureEntryPath\DLL\EDYFILT.DLL (if any) 
  14150.  
  14151.      SecureEntryPath\EXEC\EDYCUST.CMD (if any) 
  14152.  
  14153.  Being the rest of files not specific to your installation. 
  14154.  
  14155.  
  14156. ΓòÉΓòÉΓòÉ 14.4.6. What settings can I touch from the SES config.sys entries ? ΓòÉΓòÉΓòÉ
  14157.  
  14158. Basically, the following variables are supported with its possible values by 
  14159. SecureEntry : 
  14160.  
  14161.      GUESTNAME 
  14162.  
  14163.       This environment variable defines the user name to use by SecureEntry 
  14164.       when a guest logon has been performed. The default setting is 'GUEST'. 
  14165.  
  14166.      AUTOGUEST 
  14167.  
  14168.       This environment variable tells SES to directly start in a guest logon 
  14169.       user session without launching a real logon event. Since SecureEntry SLA 
  14170.       does require a real logon event to activate and deactivate security 
  14171.       profiles, you are encouraged not to change this variable default setting 
  14172.       (value='NO'), unless you are using your own written SLA program. In case 
  14173.       you want to achieve the same effect with SecureEntry as provided, you can 
  14174.       use any proper user exit before logon to force a guest logon. 
  14175.  
  14176.      TRUSTEDPATH 
  14177.  
  14178.       This environment variable forces logon/unlock events to start 
  14179.       automatically after the corresponding logoff/lock event has been 
  14180.       processed (when value is set to 'YES'). If you set this variable to 'NO', 
  14181.       then the events will be started by a key press. 
  14182.  
  14183.      RESTARTUSERSHELL 
  14184.  
  14185.       This environment variable allows for choosing when should the second 
  14186.       PMSHELL be restarted . The 'YES' value implies that the PMSHELL is to be 
  14187.       started in a per logon basis, where the value 'NO' (default setting by 
  14188.       SecureEntry installation), indicates that PMSHELL is to be started only 
  14189.       once, at startup time. Normally this value is the one which provides for 
  14190.       best results in terms of performance. 
  14191.  
  14192.  Refer to the SES documentation for further explanation on those. 
  14193.  
  14194.  
  14195. ΓòÉΓòÉΓòÉ 14.4.7. Is there any other information available ? ΓòÉΓòÉΓòÉ
  14196.  
  14197. The following can be used to obtain further documentation about SecureEntry : 
  14198.  
  14199.      Do not forget to read the readme.doc file that comes together with the 
  14200.       present driver. 
  14201.  
  14202.      The online manual 'UCM administrator's guide' can be used as a reference 
  14203.       about installing UCM and debugging UCM related errors. 
  14204.  
  14205.      Most of the graphical programs that SecureEntry provides contain a 
  14206.       detailed online help for its operation. 
  14207.  
  14208.      There is also paper printed version of this document, which may explain 
  14209.       in more detail some of the features explained here. 
  14210.  
  14211.      The Lan Server documentation may help you understand better the 
  14212.       administration and configuration related tasks for this kind of 
  14213.       environments. 
  14214.  
  14215.      The SecureEntry 2.0 documentation is also a good reference for the 
  14216.       desktop restrictions workbench and VDM utilities, plus startup component. 
  14217.  
  14218.  
  14219. ΓòÉΓòÉΓòÉ 14.4.8. How can I provide NLS support for other than the supplied language ? ΓòÉΓòÉΓòÉ
  14220.  
  14221. You have all the necessary source material in the SecureEntry path, API\NLS 
  14222. subdirectory. You can do the necessary translations and generate the required 
  14223. object code. Note however, that if you just want to translate for the runtime 
  14224. environment (session control panels), you only have to translate the 
  14225. EDYERROR.TXT file and make a new message file EDYERROR.MSG through MKMSGF, 
  14226. placing it in the appropriate directory (SecureEntryPath\EXEC). 
  14227.  
  14228.  
  14229. ΓòÉΓòÉΓòÉ 14.4.9. How can I grant CM/2 comms sessions start in a per user basis ? ΓòÉΓòÉΓòÉ
  14230.  
  14231. The rule of thumb that SecureEntry uses for isolating user sessions is to kill 
  14232. at logoff time all processes that were started after the logon was issued. This 
  14233. may not be good enough in some cases where the base software is always up and 
  14234. running, but the user sessions (real units of work) are established within 
  14235. those. This is the case of, for instance, 3270 emulations, or other 
  14236. applications that have a quite high startup time that would penalize the signon 
  14237. performance if started at each logon. The idea for dealing with such 
  14238. applications is to use the SecureEntry provided user exits (before logoff) to 
  14239. make sure that the logical working sessions are stopped and restarted every 
  14240. time a logoff event is processed. In the case of CM/2 3270 emulators, you can 
  14241. use the tool 'EDYE3270', as provided by SecureEntry to do this 
  14242. activation/stopping automatically. 
  14243.  
  14244. Alternatively, you can use also the CM/2 command 'CMLINKS' to halt and 
  14245. reactivate the communications links, thus effectively bringing down any logical 
  14246. session that could be left opened by the outgoing user. The suggested commands 
  14247. are : 
  14248.  
  14249.  
  14250.      CMLINKS H *       to stop (halt) all links
  14251.      CMLINKS A *       to activate all links
  14252.  
  14253. Note that using this command will reset ALL links of the machine, so beware 
  14254. when using it on gateways. i.e, specify only those links you really want to 
  14255. deactivate instead of an asterisk. 
  14256.  
  14257.  
  14258. ΓòÉΓòÉΓòÉ 14.4.10. How can I avoid users to boot with the ALT-F1 combination ? ΓòÉΓòÉΓòÉ
  14259.  
  14260. There are several things you can do to avoid ALT-F1 : 
  14261.  
  14262.    1. If you want to avoid it *completely* and do not care about receiving an 
  14263.       error message, then just rename the file \OS2\BOOT\ALTF1*.SCR to anything 
  14264.       else. 
  14265.  
  14266.    2. If you want to avoid this error message, then : 
  14267.  
  14268.         a. Leave the .SCR files alone 
  14269.  
  14270.         b. Change the file \OS2\BOOT\ALTF1.CMD so that it only processes the 
  14271.            desired entries (you have control over V,M,1... options). The file 
  14272.            is a regular .CMD file, and just placing a 'goto end' in the desired 
  14273.            option routine processing part would do it. 
  14274.  
  14275.         c. If you want to avoid also the 'C' option (goto command line), then 
  14276.            note that this option uses the \OS2\BOOT\CONFIG.X file, so renaming 
  14277.            it will avoid the function to operate, and changing it to force a 
  14278.            logon would ensure it does not break the security. 
  14279.  
  14280.         d. Now, you can optionally change the ALTF1TOP.SCR file to show only 
  14281.            the options you have enabled. 
  14282.  
  14283.  
  14284. ΓòÉΓòÉΓòÉ 14.4.11. Can not run a NDM/2 ACTIVATE command ΓòÉΓòÉΓòÉ
  14285.  
  14286. NDM checks to see if there is a diskette present before accepting the activate 
  14287. command. When SecureEntry is restricting access to the floppy disk, this check 
  14288. fails normally with a more severe error, and NDM decides to cancel the activate 
  14289. command ... just in case. 
  14290.  
  14291. In order to make NDM skip this checking, set the following environment variable 
  14292. in the target machine : 
  14293.  
  14294.  
  14295.       SET ANXCHECKBOOT=NO
  14296.  
  14297. A second problem you may face, is that the activate command requires to be able 
  14298. to access and modify the config.sys file. Note that this may only happen if the 
  14299. NDM 'daemon' is running under user context (i.e, not started through 
  14300. config.sys, edystart.cmd,...). In this case,you must use in this type of 
  14301. environments, treelock profiles that override the default restriction of not 
  14302. letting any executable to modify the config.sys file for the NDM processes. You 
  14303. can do this by adding the following line to your treelock profiles : 
  14304.  
  14305.  
  14306.       F NdmPath\ANXCMCLx.EXE
  14307.  
  14308. Where NdmPath is the path where your NDM executables reside, and x is 'C' for 
  14309. NDM client machines, 'S' for NDM server machines. 
  14310.  
  14311.  
  14312. ΓòÉΓòÉΓòÉ 14.4.12. I launch the Lotus Notes Editor, but nothing hapens! ΓòÉΓòÉΓòÉ
  14313.  
  14314. Jump step by step through this list: 
  14315.  
  14316.    1. Verify you have the Java run-time installed. Open a command prompt and 
  14317.       issue the command: 
  14318.  
  14319.               java -version
  14320.  
  14321.       If you get a SYS1041 error then you either don't have the Java run-time 
  14322.       installed, or the LIBPATH and PATH statements of your CONFIG.SYS file are 
  14323.       wrong. 
  14324.  
  14325.       If the command executes successfully then verify that you have Java 
  14326.       version 1.1.7 or greater. If you have Java version 1.1.7 or greater and 
  14327.       less than 1.2.0 then you must also have Swing 1.0.3 installed. In this 
  14328.       case, verify that the environment variable CLASSPATH contains the full 
  14329.       path and file name to Java CLASSES.ZIP and Swing SWINGALL.JAR. 
  14330.  
  14331.    2. Verify you don't get any exception when loading the Java classes. Open a 
  14332.       command line, go to the SecureEntry EXEC directory and edit the file 
  14333.       EDNOTES.CMD. Put a REM in front of the line starting with: 
  14334.  
  14335.               javaw -classpath ... , or
  14336.               javapm -classpath ...
  14337.  
  14338.       and un-rem the line starting with: 
  14339.  
  14340.               REM java -verbose -classpath ...
  14341.  
  14342.       Save the changes and kick again the editor from the command line: 
  14343.  
  14344.               EDNOTES.CMD
  14345.  
  14346.       Make sure that all Java classes load. 
  14347.  
  14348.    3. Browse the file NOUSER\EDNOTES.LOG, if any, and inspect its contents to 
  14349.       get a diagnostic. 
  14350.  
  14351.  
  14352. ΓòÉΓòÉΓòÉ 14.4.13. I want to upgrade my version of Java 1.1.x to Java 1.2.0 or greater. What must I do? ΓòÉΓòÉΓòÉ
  14353.  
  14354. When you are done with the Java upgrade, you can: 
  14355.  
  14356.      Recreate the SecureEntry workbench using the program EDYCRWRK, or 
  14357.  
  14358.      Open a command line, go to the SecureEntry EXEC directory and copy the 
  14359.       file EDNOTES2.CMD over EDNOTES.CMD, which is the file used by the object 
  14360.       Lotus Notes Editor for Java. The file EDNOTES2.CMD loads the Java classes 
  14361.       from the file EDNOTES2.JAR, which must run on Java2 or greater. The file 
  14362.       EDNOTES1.CMD loads the Java classes from the file EDNOTES1.JAR, which 
  14363.       must run on Java 1.1.7.x or greater and less than Java 1.2.0. Therefore, 
  14364.       if you decide to undo the upgrade to Java2 you just need to copy the file 
  14365.       EDNOTES1.CMD over EDNOTES.CMD. 
  14366.  
  14367.  
  14368. ΓòÉΓòÉΓòÉ 14.4.14. I have gotten a PassTicket, but RACF rejects it ΓòÉΓòÉΓòÉ
  14369.  
  14370. A PassTicket may not work for one of the following reasons: 
  14371.  
  14372.    1. The user ID is wrong 
  14373.  
  14374.    2. The application ID is wrong 
  14375.  
  14376.    3. The Secured Signon application key is wrong, or it has been changed on 
  14377.       the host side by the RACF Administrator 
  14378.  
  14379.    4. It has been generated more than 10 minutes ago 
  14380.  
  14381.    5. The system clock is not sinchronized with the host's 
  14382.  
  14383.  It is likely that the computer that authenticated the PassTicket is not the 
  14384.  computer that generated it. To provide for differences in their internal 
  14385.  clocks, the algorithm allows the generated time to be 10 minutes on either 
  14386.  side of the TOD (TimeOfDay) clock of the computer that is evaluating the 
  14387.  PassTicket. 
  14388.  
  14389.  For RACF to properly evaluate PassTickets, the TOD clock must be properly set 
  14390.  to GMT rather than local time. TIME ON MAINFRAME IS SUPPOSED TO BE GMT. If 
  14391.  this is not the case, use the parameter TimeZone to allow for time zones 
  14392.  shift. 
  14393.  
  14394.  Remember that you must have RACF configured so that it accepts PassTickets as 
  14395.  an alternative to regular passwords. Besides, if the system for which you are 
  14396.  generating the PassTicket has RACF 1.9.2 or RACF 2.1 installed, make sure that 
  14397.  APAR OW03024 is installed on that system. The PTF numbers are: 
  14398.  
  14399.      UW05405 for RACF 2.1.0 
  14400.  
  14401.      UW05406 for RACF 1.9.2 
  14402.  
  14403.  
  14404. ΓòÉΓòÉΓòÉ 14.5. UCM related common situations ΓòÉΓòÉΓòÉ
  14405.  
  14406. This section contains recipes and solutions to common errors and situations 
  14407. when working with UCM. 
  14408.  
  14409.  
  14410. ΓòÉΓòÉΓòÉ 14.5.1. I get 'SQL error -805' when attempting to start the administration utilities ΓòÉΓòÉΓòÉ
  14411.  
  14412. Make sure you have created the corresponding packages and correctly bound the 
  14413. UCM administration access plans, as explained under Setting up the User 
  14414. Centralized Management workstation Note that if you have applied service to the 
  14415. UCM management workstation, it may be necessary that you rebind the plans to 
  14416. the host database. 
  14417.  
  14418.  
  14419. ΓòÉΓòÉΓòÉ 14.5.2. I get 'SLAG -8002E: Dynalink error' from the UCM Administration applications ΓòÉΓòÉΓòÉ
  14420.  
  14421.        SLAG -8002E: Dynalink error EDYUCM01.
  14422.  
  14423. This means that you do not have A DDCS/2 license. You must Purchase a DDCS/2 
  14424. license an update the nodelock file in the DB2/2 directory. 
  14425.  
  14426.  
  14427. ΓòÉΓòÉΓòÉ 14.5.3. I get 'SQL error -204...' from the UCM Administration applications ΓòÉΓòÉΓòÉ
  14428.  
  14429.        SQL error -204 "Name" is an undefined name.
  14430.  
  14431. The program does not find the UCM tables in the DB2/MVS. 
  14432.  
  14433. You must check the synonyms defined in MVS. You can use the member 
  14434. UCM.V30.DB2(CREASYNR) as an entry model with SPUFI. 
  14435.  
  14436.  
  14437. ΓòÉΓòÉΓòÉ 14.5.4. I get 'SLAG -1013E: Dynalink error' from the UCM Administration applications ΓòÉΓòÉΓòÉ
  14438.  
  14439.        SLAG -1013E: Dynalink error EDYUCM01.
  14440.  
  14441.  It could mean that you attempt to access a database alias name that could not 
  14442. be found. Ensure that the DDCS/2 system database directory is properly 
  14443. configured. Check if the environment variable SGM_UCM_DBDFT is defined in the 
  14444. UCMADM.CMD or similar file and has the correct value. 
  14445.  
  14446. Of course, do not forget to verify that the file EDYUCM01.DLL file is found 
  14447. within your libpath. 
  14448.  
  14449.  
  14450. ΓòÉΓòÉΓòÉ 14.5.5. Is there any performance tuning for UCM that I can do ? ΓòÉΓòÉΓòÉ
  14451.  
  14452.  If you plan to have many workstations or many branches in your scenario, you 
  14453. can tune the following parameter: 
  14454.  
  14455. In the VTAM major node definition for UCM in SYS1.VTAMLIST or in the 
  14456. appropriate library, define EAS = 3999. This parameter sets the maximum session 
  14457. number within that LU. This definition does not mean any resource wasted at 
  14458. all. 
  14459.  
  14460. Optionally, in the Communications Manager/2 Setup, in the DLC configuration, 
  14461. you can check the "Free unused links" check box. This will cause inactive 
  14462. sessions to become free. Note that this parameter may produce problems if you 
  14463. use CP-CP sessions, since these sessions are permanently allocated. 
  14464.  
  14465. Other than this, and for UCM specific performance tuning, please read the 
  14466. related information as explained in the appropriate chapter of the UCM 
  14467. administrators guide. 
  14468.  
  14469.  
  14470. ΓòÉΓòÉΓòÉ 14.5.6. How can I maintain standalone and Lan Server installations with UCM ? ΓòÉΓòÉΓòÉ
  14471.  
  14472. If you use the Refresh branch online procedure, then this environment is 
  14473. supported. The EDYSRV process will discard all resources information when 
  14474. downloading branch or users data to a standalone workstation. 
  14475.  
  14476.  
  14477. ΓòÉΓòÉΓòÉ 15. WHAT'S NEW !! ΓòÉΓòÉΓòÉ
  14478.  
  14479. This chapter is intended as an 'easy guide' for upgraders. It lists in 
  14480. chronological, descending order, the links to the appropriate documentation 
  14481. points where new function has been added to the product. Note that for a full 
  14482. reference of fixes and additions, we encourage you to look into the README file 
  14483. supplied within the first installation diskette image, since the ones down 
  14484. under are only what we consider main improvements to the product. 
  14485.  
  14486.      New Java APIs. 
  14487.  
  14488.      New RACF PassTicket generator. 
  14489.  
  14490.      New Lotus Notes component. 
  14491.  
  14492.      New SecureEntry log files browser utility. 
  14493.  
  14494.      Treelock \DEV\ support. Allows for restricting access to system devices. 
  14495.       Remember to specify the internal device name (i.e, \DEV\PCMCIA$ instead 
  14496.       of PCMCIA.SYS) 
  14497.  
  14498.      New support for IBM Network Station series 2800 clients, when running 
  14499.       under WSOD. 
  14500.  
  14501.      New SecureEntry/2 tutorial, distributed as a separate package file. 
  14502.  
  14503.      New Processes Auditor component for CPU usage measurements. 
  14504.  
  14505.      New NSC/2 LMP for password synchronization. 
  14506.  
  14507.      New WorkSpace On-Demand support 
  14508.  
  14509.      New Support for coexistence with other SES clients (i.e Tivoli). 
  14510.  
  14511.      New support for the RACF emulator, to be used in UCM installations. 
  14512.  
  14513.      New Public Applications component for LAN Server environments. 
  14514.  
  14515.      New sample logon and unlock dialogs 
  14516.  
  14517.      New EDYRVUCM utility to correct the change tables of the UCM Database. 
  14518.  
  14519.      New EDYQRYBR utility to query the level of all your branches. 
  14520.  
  14521.      New EDYPHOTO utilities to obtain a machine configuration image file for 
  14522.       servicing and error reporting. 
  14523.  
  14524.      New UCM Refresh branch method to update definitions of groups and 
  14525.       resources in Lan Server and new UCM Logging facility. 
  14526.  
  14527.      New included Security Enabling Services emulation. You can now install 
  14528.       SecureEntry without the real SES code. Note, however, that FP17 or 
  14529.       superior are still required if you plan to use the treelock component. 
  14530.  
  14531.      New WarpCenter component for Merlin systems : The WarpCenter component. 
  14532.  
  14533.      Increased functionality of the SES component. You can now configure the 
  14534.       desktop background, and avoid/hook specified systemwide hotkeys. Read 
  14535.       about it in the SES behavior component chapter. 
  14536.  
  14537.      New section in this document about Error codes and messages. 
  14538.  
  14539.      New Hooked objects component. 
  14540.  
  14541.      New EDYDUMP utility. 
  14542.  
  14543.      About processes and running contexts improved function. 
  14544.  
  14545.      New File integrity check SAF2GEN utility. 
  14546.  
  14547.      The Treelock component got redesigned new documentation plus several more 
  14548.       neat features, including a fully graphic profiles editor. 
  14549.  
  14550.      New Master boot record saver : EDYRWMBR utility. 
  14551.  
  14552.      The Desktop restrictions component got support for directory propagation 
  14553.       of styles, and new Merlin menu entries. 
  14554.  
  14555.      New diskette translator utility within the The Floppy restrictions 
  14556.       component. 
  14557.  
  14558.      New shortcuts component. 
  14559.  
  14560.      New EDYLOGFS utility to automatically control the logs file size. 
  14561.  
  14562.      The new Personal desktop component. 
  14563.  
  14564.      Within Setting up a backup domain controller for Lan Server you fill find 
  14565.       how to set up the machines for this new support. 
  14566.  
  14567.      The new Window list component. 
  14568.  
  14569.  Besides, and if you are a SecureEntry integrator, it is always advisable that 
  14570.  you have a look into the Environment variables section and the Programming 
  14571.  user exits one, since new environment variables and user exits are quite 
  14572.  frequently added. 
  14573.  
  14574.  
  14575. ΓòÉΓòÉΓòÉ 16. Contacting us ΓòÉΓòÉΓòÉ
  14576.  
  14577. If you have a comment or find a problem not reported in the previous 
  14578. paragraphs, we would like to hear from you... Please contact the following IDs 
  14579. : 
  14580.  
  14581.  
  14582.     SecureEntry team management
  14583.  
  14584.                Fernando Velasco  Internal : Fernando Velasco Benavente/Spain/IBM @ IBMES
  14585.                                  External : VELASCO  @ es.ibm.com
  14586.  
  14587.     Solution responsible
  14588.  
  14589.                Fernando Trius    Internal : Fernando Trius Chassaigne/Spain/IBM @ IBMES
  14590.                                  External : FTRIUS @ es.ibm.com
  14591.  
  14592.     Technical coordination
  14593.  
  14594.                Ramon Gonzalez    Internal : Ramon Gonzalez Compta/Spain/IBM @ IBMES
  14595.                                  External : RAMON_GONZALEZ @ es.ibm.com
  14596.  
  14597.  
  14598. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  14599.  
  14600. UCM default translation tables 
  14601.  
  14602. These are the translation tables used by UCM tools to translate information of 
  14603. ASCII to EBCDIC and viceversa: 
  14604.  
  14605. Translation table for ASCII to EBCDIC 
  14606.  
  14607.  0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07 /* 00 */
  14608.  0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F /* 08 */
  14609.  0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17 /* 10 */
  14610.  0x18,0x19,0x1A,0x1B,0x1C,0x1D,0x1E,0x1F /* 18 */
  14611.  0x40,0x4F,0x7F,0x69,0x5B,0x6C,0x50,0x7D /* 20 */
  14612.  0x4D,0x5D,0x5C,0x4E,0x6B,0x60,0x4B,0x61 /* 28 */
  14613.  0xF0,0xF1,0xF2,0xF3,0xF4,0xF5,0xF6,0xF7 /* 30 */
  14614.  0xF8,0xF9,0x7A,0x5E,0x4C,0x7E,0x6E,0x6F /* 38 */
  14615.  0x7C,0xC1,0xC2,0xC3,0xC4,0xC5,0xC6,0xC7 /* 40 */
  14616.  0xC8,0xC9,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6 /* 48 */
  14617.  0xD7,0xD8,0xD9,0xE2,0xE3,0xE4,0xE5,0xE6 /* 50 */
  14618.  0xE7,0xE8,0xE9,0x4A,0xE0,0x5A,0x5F,0x6D /* 58 */
  14619.  0x79,0x81,0x82,0x83,0x84,0x85,0x86,0x87 /* 60 */
  14620.  0x88,0x89,0x91,0x92,0x93,0x94,0x95,0x96 /* 68 */
  14621.  0x97,0x98,0x99,0xA2,0xA3,0xA4,0xA5,0xA6 /* 70 */
  14622.  0xA7,0xA8,0xA9,0xC0,0xBB,0xD0,0xA1,0x41 /* 78 */
  14623.  0x68,0xDC,0x51,0x42,0x43,0x44,0x47,0x48 /* 80 */
  14624.  0x52,0x53,0x54,0x57,0x56,0x58,0x63,0x67 /* 88 */
  14625.  0x71,0x9C,0x9E,0xCB,0xCC,0xCD,0xDB,0xDD /* 90 */
  14626.  0xDF,0xEC,0xFC,0x70,0xB1,0x80,0xBF,0x41 /* 98 */
  14627.  0x45,0x55,0xCE,0xDE,0x6A,0x7B,0x9A,0x9B /* A0 */
  14628.  0xAB,0xAF,0xBA,0xB8,0xB7,0xAA,0x8A,0x8B /* A8 */
  14629.  0x41,0x41,0x41,0x41,0x41,0x65,0x62,0x64 /* B0 */
  14630.  0xB4,0x41,0x41,0x41,0x41,0xB0,0xB2,0x41 /* B8 */
  14631.  0x41,0x41,0x41,0x41,0x41,0x41,0x46,0x66 /* C0 */
  14632.  0x41,0x41,0x41,0x41,0x41,0x41,0x41,0x9F /* C8 */
  14633.  0x8C,0xAC,0x72,0x73,0x74,0xDA,0x75,0x76 /* D0 */
  14634.  0x77,0x41,0x41,0x41,0x41,0x49,0x78,0x41 /* D8 */
  14635.  0xEE,0x59,0xEB,0xED,0xCF,0xEF,0xA0,0x8E /* E0 */
  14636.  0xAE,0xFE,0xFB,0xFD,0x8D,0xAD,0xBC,0xBE /* E8 */
  14637.  0xCA,0x8F,0xBF,0xB9,0xB6,0xB5,0x41,0x9D /* F0 */
  14638.  0x90,0xBD,0xB3,0xDA,0xFA,0xEA,0xE1,0x41 /* F8 */
  14639.  
  14640. Translation table for EBCDIC to ASCII 
  14641.  
  14642.  0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07 /* 00 */
  14643.  0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F /* 08 */
  14644.  0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17 /* 10 */
  14645.  0x18,0x19,0x1A,0x1B,0x1C,0x1D,0x1E,0x1F /* 18 */
  14646.  0x20,0x21,0x22,0x23,0x24,0x25,0x26,0x27 /* 20 */
  14647.  0x28,0x29,0x2A,0x2B,0x2C,0x2D,0x2E,0x2F /* 28 */
  14648.  0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37 /* 30 */
  14649.  0x38,0x39,0x3A,0x3B,0x3C,0x3D,0x3E,0x3F /* 38 */
  14650.  0x20,0xFF,0x83,0x84,0x85,0xA0,0xC6,0x86 /* 40 */
  14651.  0x87,0xDD,0x5B,0x2E,0x3C,0x28,0x2B,0x21 /* 48 */
  14652.  0x26,0x82,0x88,0x89,0x8A,0xA1,0x8C,0x8B /* 50 */
  14653.  0x8D,0xE1,0x5D,0x24,0x2A,0x29,0x3B,0x5E /* 58 */
  14654.  0x2D,0x2F,0xB6,0x8E,0xB7,0xB5,0xC7,0x8F /* 60 */
  14655.  0x80,0x23,0xA4,0x2C,0x25,0x5F,0x3E,0x3F /* 68 */
  14656.  0x9B,0x90,0xD2,0xD3,0xD4,0xD6,0xD7,0xD8 /* 70 */
  14657.  0xDE,0x60,0x3A,0xA5,0x40,0x27,0x3D,0x22 /* 78 */
  14658.  0x9D,0x61,0x62,0x63,0x64,0x65,0x66,0x67 /* 80 */
  14659.  0x68,0x69,0xAE,0xAF,0xD0,0xEC,0xE7,0xF1 /* 88 */
  14660.  0xF8,0x6A,0x6B,0x6C,0x6D,0x6E,0x6F,0x70 /* 90 */
  14661.  0x71,0x72,0xA6,0xA7,0x91,0xF7,0x92,0xCF /* 98 */
  14662.  0xE6,0x7E,0x73,0x74,0x75,0x76,0x77,0x78 /* A0 */
  14663.  0x79,0x7A,0xAD,0xA8,0xD1,0xED,0xE8,0xA9 /* A8 */
  14664.  0xBD,0x9C,0xBE,0xFA,0xB8,0xF5,0xF4,0xAC /* B0 */
  14665.  0xAB,0xF3,0xAA,0x7C,0xEE,0xF9,0xEF,0x9E /* B8 */
  14666.  0x7B,0x41,0x42,0x43,0x44,0x45,0x46,0x47 /* C0 */
  14667.  0x48,0x49,0xF0,0x93,0x94,0x95,0xA2,0xE4 /* C8 */
  14668.  0x7D,0x4A,0x4B,0x4C,0x4D,0x4E,0x4F,0x50 /* D0 */
  14669.  0x51,0x52,0xFB,0x96,0x81,0x97,0xA3,0x98 /* D8 */
  14670.  0x5C,0xF6,0x53,0x54,0x55,0x56,0x57,0x58 /* E0 */
  14671.  0x59,0x5A,0xFD,0xE2,0x99,0xE3,0xE0,0xE5 /* E8 */
  14672.  0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37 /* F0 */
  14673.  0x38,0x39,0xFC,0xEA,0x9A,0xEB,0xE9,0xFF /* F8 */
  14674.