home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / netdor3.zip / DISK_11 / IMAGE10.ZIP / BOOK / GIME.INF (.txt) < prev    next >
OS/2 Help File  |  1993-09-30  |  10KB  |  300 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About... ΓòÉΓòÉΓòÉ
  3.  
  4.  Title 
  5.  
  6.                       GIME Version 1.11
  7.  
  8.                       (C) Copyright IBM Corp. 1990, 1993.  All rights reserved.
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  12.  
  13. No longer will the overworked OS/2 LAN user have to remember archaic and 
  14. cryptic resource names, or have to worry about which drive letter is free. GIME 
  15. will do this and so much more for you. 
  16.  
  17. GIME has been tested and works well under OS/2 1.1 EE through OS/2 1.30.1 EE, 
  18. and OS/2 2.x systems running IBM LAN Requester, and OS/2 TCP/IP. 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 3. Syntax ΓòÉΓòÉΓòÉ
  22.  
  23. The following describes the GIME syntax: 
  24.  
  25.                                                ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  26.                                                                  Γöé
  27. gime ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ  Γöé
  28.             Γöé            Γöé       Γöé          Γöé      Γöé           Γö£ΓöÇΓöÇΓöÿ
  29.             Γö£ΓöÇ resource ΓöÇΓöñ       ΓööΓöÇ device ΓöÇΓöÿ      ΓööΓöÇ /option ΓöÇΓöÿ
  30.             Γöé            Γöé
  31.             ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ ? ΓöÇΓöÇΓöÇΓöÇΓöÿ
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 4. Resource Alias Resolution ΓòÉΓòÉΓòÉ
  35.  
  36. GIME provides the user with the ability to setup aliases for commonly used 
  37. server resources.  GIME also autmatically searches all servers in the current 
  38. domain for a shared resource which matches a specified resource alias.  This 
  39. This section discusses the way in which GIME resolves resource aliases, and how 
  40. the user may setup Resource Alias Definition Files. 
  41.  
  42. If the resource netname specified by a GIME parameter is not a UNC resource, 
  43. then it is a resource alias which must be resolved.  The resolution strategy 
  44. follows: 
  45.  
  46.   1. All NETALIAS.LST files along the DPATH and the NETALIAS.PATH are searched 
  47.      until a match is found or until all files are exhausted.  See the 
  48.      "Resource Alias Definition Files (NETALIAS.LST)" for further details. 
  49.  
  50.   2. If a match is not found in the NETALIAS.LST files, then GIME compares the 
  51.      alias against all shared resources of all accessible servers in the 
  52.      current domain, until a match is found or until all shared resources are 
  53.      exhausted. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 5. Resource Alias Definition Files (NETALIAS.LST) ΓòÉΓòÉΓòÉ
  57.  
  58. By default, the resource alias definitions should be placed in the file 
  59. NETALIAS.LST, which should be in a subdirectory specified in your DPATH. A 
  60. sample NETALIAS.LST file is given below: 
  61.  
  62. CORE      \\YKCOS01\CORE01     /D=C:       /P=CONFID   Core alias num 1
  63. OS2TOOLS  \\OS2TOOLS\OS2TOOLS              /P=OS2PASS  OS2 Tools Alias
  64. 3812      \\PRNTSERV\3812QUE   /D=LPT1                 OS2 Tools Alias
  65. MYALIAS   \\MYSERVER\MYALIAS                           Alias on myserver
  66. RS6000    myrs6000:/home/user  /FS=NFS                 RS-6000 NFS alias
  67. OS213     OS213                /FS=SERVICE /P=CONFID   SRVIFS alias
  68.  
  69. Note:  Each entry consists of the alias, followed by one or more spaces, 
  70. followed by the actual resource, followed by one or more spaces, followed by 
  71. one or more optional options parameters, followed by an optional comment. 
  72.  
  73. A user may have multiple NETALIAS.LST files in their DPATH.  For example, a 
  74. user may have a personal NETALIAS.LST file which has only a few entries in one 
  75. subdirectory in the DPATH, and a public NETALIAS.LST file (on a file server) 
  76. which has many entries.  GIME will attempt to resolve a resource alias by 
  77. searching all NETALIAS.LST files it finds along the DPATH, stopping at the 
  78. first resolution or once all files have been exhausted. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 6. Environment Variables ΓòÉΓòÉΓòÉ
  82.  
  83. A user may override or set GIME options and characteristics by using the 
  84. following environment variables: 
  85.  
  86.  o NETALIAS.FILE 
  87.  
  88.    The default NETALIAS.LST file name may be overridden by either the /A= 
  89.    command parameter, see the Syntax section for further details, or via the 
  90.    environment variable NETALIAS.FILE. The NETALIAS.FILE environment variable 
  91.    may specify a full file spec (eg d:\path\file.ext) or a file name only. If 
  92.    only the file name is given, the file will be searched for along the DPATH. 
  93.    The NETALIAS.FILE environment variable also overrides the /A parameter. 
  94.  
  95.    Note:  Throughout this document the resource alias definition file will be 
  96.    referred to as the NETALIAS.LST file.  Keep this in mind if you are using a 
  97.    different file name. 
  98.  
  99.  o NETALIAS.PATH 
  100.  
  101.    The NETALIAS.PATH environment variable may be used to specify where the 
  102.    NETALIAS.LST file(s) may be found.  If the NETALIAS.PATH environment 
  103.    variable exists, it will be searched before the DPATH. 
  104.  
  105.  o GIME.USE.<fs> 
  106.  
  107.    The GIME.USE.<fs> can be used to define the attach command for any IFS. 
  108.  
  109.    For example, the attach command for NFS might look like the following: 
  110.  
  111.       SET GIME.USE.NFS=mount {drive} {alias}
  112.  
  113.    You may specify multiple GIME.USE.<fs> environment variables to fully 
  114.    profile all installed file system attach commands. 
  115.  
  116.    Note:  The GIME.USE.<fs> environment variable setting may include the 
  117.    following strings which will be replaced as follows: 
  118.  
  119.       {drive}    - Replaced by drive to be used in the attachment.
  120.       {alias}    - Replaced by resource to be attached to.
  121.       {password} - Replaced by password specified.
  122.  
  123.  o GIME.DROP.<fs> 
  124.  
  125.    The GIME.DROP.<fs> can be used to define the drop command for any IFS. 
  126.  
  127.    For example, the drop command for NFS might look like the following: 
  128.  
  129.       SET GIME.DROP.NFS=umount {drive}
  130.  
  131.    You may specify multiple GIME.DROP.<fs> environment variables to fully 
  132.    profile all installed file system drop commands. 
  133.  
  134.    Note:  The GIME.DROP.<fs> environment variable setting may include the 
  135.    following strings which will be replaced as follows: 
  136.  
  137.       {drive}    - Replaced by drive to be dropped.
  138.       {alias}    - Replaced by resource to be dropped.
  139.       {password} - Replaced by password specified.
  140.  
  141.    Note:  Any of the above environment variables may be set by default in the 
  142.           GIME Control File.  Environment variable defaults will override 
  143.           Control File defaults, thus allowing users to personalize GIME via 
  144.           environment variables while simultaneously allowing a network 
  145.           administrator to setup GIME defaults via a remote GIME.CTL file. 
  146.  
  147.    See the Sample Control File section for further details. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ 7. Sample Control File ΓòÉΓòÉΓòÉ
  151.  
  152. GIME will search for the Control File, GIME.CTL, along the DPATH when it is 
  153. executed.  The Control File may include default GIME Environment Variable 
  154. settings.  Actual environment variable settings will override anything profiled 
  155. in the GIME.CTL file. 
  156.  
  157. The following displays the contents of a sample GIME.CTL file which profiles 
  158. the GIME environment variables for describing alternate File System attach and 
  159. drop commands: 
  160.  
  161. GIME.USE.SERVICE=srvattch {device} {alias}
  162. GIME.DROP.SERVICE=srvattch {device} /D
  163. GIME.USE.NFS=mount {device} {alias}
  164. GIME.DROP.NFS=umount {device}
  165. GIME.USE.LCSF=drvattch {device} {alias}
  166. GIME.DROP.LCSF=drvdetch {device}
  167.  
  168. Note:  View the Environment Variables section for a full description of all 
  169. supported GIME environment variables. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  173.  
  174. Provide limited on-line help. 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  178.  
  179. Specifies the resource to assign.  The resource parameter may be either a UNC 
  180. Resource or a GIME Resource Alias.  The definition for each resource type 
  181. follows: 
  182.  
  183.  UNC Resource Any resource which has the form \\server\\alias.  For example: 
  184.            \\YKCOS01\CORE01 
  185.  
  186.  GIME Resource Alias Any resource which does not start with the '\\' 
  187.            characters.  GIME resolves this resource alias to a UNC resource if 
  188.            it can be found in the NETALIAS.LST file.  See the Resource Aliases 
  189.            section for further details. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  193.  
  194. May be any of the following: 
  195.  
  196.  A: - Z:   If a drive letter is given, GIME will assign the specified resource 
  197.            to the specified drive letter. 
  198.  
  199.  COMx:     If a COM port is given, GIME will assign the specified resource to 
  200.            the specified serial communications port. 
  201.  
  202.  LPTx:     If an LPT port is given, GIME will assign the specified resource to 
  203.            the specified parallel communications port. 
  204.  
  205.  <None>    If no device parameter is specified, GIME will assume that you are 
  206.            assigning a resource which requires a drive and assign it to the 
  207.            first available drive it finds (searching from the end of the drive 
  208.            list). 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  212.  
  213. The options field may contain any 'sensible' combination of the following: 
  214.  
  215.  /A        Used to display aliases profiled in NETALIAS.LST files.  If used as 
  216.            the sole parameter to GIME, the contents of all found NETALIAS.LST 
  217.            files will be displayed.  If used in conjunction with a use or drop 
  218.            request, only those aliases found up to the resolved alias will be 
  219.            displayed. 
  220.  
  221.            Use this feature as a way to debug from which NETALIAS.LST file an 
  222.            alias is being resolved. 
  223.  
  224.  /A=filename Used to override the default alias name of NETALIAS.LST.  The 
  225.            filename entry may specify a full file spec (eg d:\path\file.ext) or 
  226.            a file name only. If only the file name is given, the file will be 
  227.            searched for along the DPATH.  See the Resource Aliases section for 
  228.            further details. 
  229.  
  230.  /B        Used to override the default free drive search strategy.  If 
  231.            specified, this option will force the search to start at the 
  232.            beginning of the drive list. 
  233.  
  234.  /D        Instructs GIME to drop the specified resource or device.  If no 
  235.            resource or device has been specified, GIME will interactively allow 
  236.            you to drop all LAN resources currently in use. 
  237.  
  238.  /F        Forces GIME to perform whatever you are telling it to do.  This is 
  239.            necessary if you want GIME to assign a preassigned drive resource to 
  240.            another drive. 
  241.  
  242.  /FS=installable file system Used to specify a resources Installable File 
  243.            System (IFS) type.  The default type is LAN. 
  244.  
  245.            GIME has been enhanced to perform attachments and drops for any 
  246.            number of Installable File Systems.  However, GIME really only knows 
  247.            how to perform attachments and drops for LAN resources.  For other 
  248.            IFS types, the required attach and drop commands must be profiled 
  249.            either via environment variables or the GIME Control File, GIME.CTL. 
  250.  
  251.            See the Environment Variables section for further details on the 
  252.            profiling of FS attach and drop commands. 
  253.  
  254.  /P=password When using resources from domains other than the logon domain it 
  255.            is required that you specify a password if your password on said 
  256.            domain is different than the password used for logon.  The password 
  257.            field is case insensitive. 
  258.  
  259.            Note:  LAN resource passwords should be considered IBM Confidential. 
  260.  
  261.  /Q        Instructs GIME to perform its task without prompting the user (all 
  262.            'would-be' prompts are assumed answered positively) and without 
  263.            unnecessary output formatting.  This mode is useful if calling GIME 
  264.            from a REXX exec. 
  265.  
  266.  /R        When assigning a resource, this parameter instructs GIME to assign 
  267.            the specified resource without attaching it to a local device.  When 
  268.            dropping a resource this parameter instructs GIME to drop the 
  269.            specified resource that is not attached to a device. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  273.  
  274. A resolve file entry options parameter may be any of the following: 
  275.  
  276.  /D=device The local device to use for the attachment of the resource alias. 
  277.            This parameter is overridden if the user supplies a local device via 
  278.            the GIME command.  See the Syntax section for a description of valid 
  279.            device parameters. 
  280.  
  281.  /P=password When using resources from domains other than the logon domain it 
  282.            is required that you specify a password if your password on said 
  283.            domain is different than the password used for logon.  The password 
  284.            field is case insensitive. 
  285.  
  286.            Note:  LAN resource passwords should be considered IBM Confidential. 
  287.  
  288.  /FS=installable file system Used to specify a resources Installable File 
  289.            System (IFS) type.  The default type is LAN. 
  290.  
  291.            GIME has been enhanced to perform attachments and drops for any 
  292.            number of Installable File Systems.  However, GIME really only knows 
  293.            how to perform attachments and drops for LAN resources.  For other 
  294.            IFS types, the required attach and drop commands must be profiled 
  295.            either via environment variables or the GIME Control File, GIME.CTL. 
  296.  
  297.            See the Environment Variables subsection of the Resource Aliases 
  298.            section for further details on the profiling of FS attach and drop 
  299.            commands. 
  300.