home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / LNVREM.ZIP / LNREMSRC.EXE / README.LCH < prev   
Text File  |  1993-11-10  |  9KB  |  323 lines
  1.                      REMOTE APPLICATION LAUNCH TOOL
  2.  
  3. The LAN NetView remote application launch tool is a user-written tool
  4. that can be used by a LAN NetView Manage operator to launch applications
  5. on remote OS/2 workstations which have LAN NetView Enabler installed. 
  6.  
  7. HOW IT WORKS
  8.  
  9. The remote launch tool is registered with the LAN NetView View component
  10. and called from the 'Application action' menu item of a management
  11. collection or system object.  If it is called from a system object, it
  12. operates only on that system.  If it is called from a management
  13. collection object, it operates against all selected systems in the
  14. management collection.
  15.  
  16. When the tool is invoked, it reads an ASCII file supplied by the user. 
  17. This file, which is described in detail below, contains commands to be
  18. issued against a remote OS/2 workstation and descriptions of those
  19. commands.  The tool displays the descriptions and allows the system
  20. administrator to select one.  When that happens, the tool retrieves the
  21. network id and system id from the View component and, if the system
  22. contains a LAN NetView system agent, it calls the LAN NetView remote
  23. command line interface command, SVRUNCMD, to execute the command which
  24. corresponds to the selected command description.
  25.  
  26. For example, the command file may contain an entry to run MYBACKUP.CMD
  27. with a corresponding label of "Run daily backup".  The system
  28. administrator will see only the label and, if it is selected, the tool
  29. will use SVRUNCMD to run the MYBACKUP.CMD on the remote node.
  30.  
  31. RUNTIME PACKAGE
  32.  
  33. The runtime remote launch tool package consists of the following files:
  34.  
  35.  
  36.  
  37.  
  38.  readme.lch
  39.  This file.
  40.  
  41.  
  42.  lnremlch.hlp
  43.  The View help file.
  44.  
  45.  
  46.  lnremlch.reg
  47.  The View registration file.
  48.  
  49.  
  50.  lnremlch.dll
  51.  An execution file.
  52.  
  53.  
  54.  lnuiutil.dll
  55.  An execution file.
  56.  
  57.  
  58.  decode.dll
  59.  An execution file.
  60.  
  61.  
  62.  lnremlch.fil
  63.  The remote launch command file.
  64.  
  65.  
  66. INSTALLING THE RUNTIME CODE
  67.  
  68. Follow these steps to install the remote launch tool runtime modules.
  69.  
  70. 1.   Copy the lnremlch.reg file to \lnv\bin.
  71.  
  72. 2.   Copy the .dll files to a directory in your LIBPATH.
  73.  
  74. 3.   Copy the lnremlch.hlp file to a directory defined by your HELP
  75.      environment variable.
  76.  
  77. 4.   Copy the lnremlch.fil file to a directory defined by your PATH
  78.      environment variable.
  79.  
  80. 5.   Ensure that the LAN NetView Manage View component is not running.
  81.  
  82. 6.   Change to the \lnv\bin directory and enter the command:
  83.  
  84.           lnvreg lnremlch.reg
  85.  
  86.      If the remote launch tool has been previously installed, this
  87.      command will fail with an appropriate message.  That's OK, because
  88.      it should not be installed more than once.
  89.  
  90. 7.   Edit the lnremlch.fil file to add the command which you want to
  91.      issue.
  92.  
  93.  
  94. COMMAND FILE (lnremlch.fil) FORMAT
  95.  
  96. The command file can be edited using your favorite ASCII editor.  Each
  97. line has the following syntax shown below.  Note that parameters can be
  98. specified in any order, the characters to the left of the = can be in
  99. any case and the parameter delimiter can be either / or -.
  100.  
  101. /c="my cmd" /m="menu text" /s /o=output_file_path_and_name /t=timeout
  102.  
  103.      Where:
  104.  
  105.      /c="my cmd" is a required parameter that specifies the command
  106.      string to be executed on the remote node.  If there are imbedded
  107.      spaces, then the command string must be bracketed with "".  Any
  108.      command string acceptable to SVRUNCMD may be used.
  109.  
  110.      /m="menu text" is an optional parameter that specifies the
  111.      description to be displayed for this command.  If this parameter
  112.      is not specified, the command string will be used for the
  113.      description.
  114.  
  115.      /s specifies that the SVRUNCMD session should stay alive after
  116.      SVRUNCMD returns.  If this parameter is not specified, SVRUNCMD
  117.      will be executed in s session that ends as soon as SVRUNCMD
  118.      returns.  If this parameter is specified, then SVRUNCMD will be
  119.      executed in a session that remains after SVRUNCMD has finished
  120.      execution.  In this case the system administrator must enter
  121.      "exit" in order to end the session.  This parameter is useful if
  122.      the command will return information that the system administrator
  123.      must review.
  124.  
  125.      /o=output_file_path_and_name is an optional parameter that
  126.      specifies a file to receive the output from SVRUNCMD.
  127.  
  128.      /t=timeout specifies the timeout that SVRUNCMD should use when
  129.      executing this command.
  130.  
  131.  
  132. SOURCE PACKAGE
  133.  
  134. In addition to the runtime package, the source package contains these
  135. files:
  136.  
  137.  
  138.  
  139.  
  140.  lnremlch.mak
  141.  The make file for the lnremlch.dll module.
  142.  
  143.  
  144.  lnremlch.csc
  145.  The SOM source file for the lnremlch.c file.
  146.  
  147.  
  148.  lnremlch.c
  149.  The source file for the lnremlch.dll file.  This
  150.  file is originally produced by the SOM compiler
  151.  and modified to add the method logic.
  152.  
  153.  
  154.  lnremlch.h
  155.  The main include file for the lnremlch module.
  156.  This file is produced by the SOM compiler.
  157.  
  158.  
  159.  lnremlch.ih
  160.  The SOM implementation include file for the 
  161.  lnremlch module.  This file is produced by the
  162.  SOM compiler.
  163.  
  164.  
  165.  lnremlch.def
  166.  The module definition file for the lnremlch.dll
  167.  module.  This file is created by the SOM
  168.  compiler and edited to add the statements 
  169.  required by View.
  170.  
  171.  
  172.  lnremlch.lib
  173.  The import library for lnremlch.dll.  This file
  174.  is created by running the IMPLIB utility against
  175.  lnremlch.def.
  176.  
  177.  
  178.  lnnosagt.dlg
  179.  A dialog file used to build the lnremlch
  180.  resource module.
  181.  
  182.  
  183.  lnnocmd.dlg
  184.  A dialog file used to build the lnremlch
  185.  resource module.
  186.  
  187.  
  188.  lnrcerr.dlg
  189.  A dialog file used to build the lnremlch
  190.  resource module.
  191.  
  192.  
  193.  lnremdlg.h
  194.  An include file used to build the lnremlch
  195.  resource module.
  196.  
  197.  
  198.  lnremlch.rc
  199.  The main source file for the lnremlch resource
  200.  module.
  201.  
  202.  
  203.  lnremlch.res
  204.  The lnremlch resource module, built by running
  205.  the resource compiler, RC, against the
  206.  lnremlch.rc file.
  207.  
  208.  
  209.  lnremlch.ipf
  210.  The IPFC source file used to build the .hlp
  211.  file.
  212.  
  213.  
  214.  lnh.h
  215.  A common include file.
  216.  
  217.  
  218.  lnuiutil.mak
  219.  The make file for the lnuiutil.dll module.
  220.  
  221.  
  222.  lnuiutil.c
  223.  The source file for the lnuiutil.dll module.
  224.  
  225.  
  226.  lnuiutil.def
  227.  The module definition file for the lnuiutil.dll
  228.  module.
  229.  
  230.  
  231.  lnuiutil.lib
  232.  The import library file for the lnuiutil.dll
  233.  module, produced by running IMPLIB against the
  234.  lnuiutil.def file.
  235.  
  236.  
  237.  gcdlg.dlg
  238.  A dialog file used to build the lnuiutil
  239.  resource module.
  240.  
  241.  
  242.  lnuidlg.h
  243.  An include file used to build the lnuiutil
  244.  resource module.
  245.  
  246.  
  247.  lnuiutil.rc
  248.  The main source file for the lnuiutil resource
  249.  module.
  250.  
  251.  
  252.  lnuiutil.res
  253.  The lnuiutil resource module, built by running
  254.  the resource compiler, RC, against the
  255.  lnuiutil.rc file.
  256.  
  257.  
  258.  decode.mak
  259.  The make file for the decode.dll module.
  260.  
  261.  
  262.  decode.c
  263.  The main source file for the decode.dll module.
  264.  
  265.  
  266.  decode.lnk
  267.  The link response file for the decode.dll
  268.  module.
  269.  
  270.  
  271.  decode.def
  272.  The module definition file for the decode.dll
  273.  module.
  274.  
  275.  
  276.  decode.lib
  277.  The import library for the decode.dll module,
  278.  built by running the IMPLIB utility against the
  279.  decode.def file.
  280.  
  281.  
  282.  
  283. INSTALLING THE SOURCE CODE
  284.  
  285. Copy the source files to your source directory.
  286.  
  287.  
  288. BUILD INSTRUCTIONS
  289.  
  290. In order to build the modules which make up the tool it is necessary to
  291. have the LAN NetView toolkit and the OS/2 2.0 or 2.1 toolkit installed
  292. on the development machine.  Before building the modules, edit the .mak
  293. and .lnk files to make sure that the hard-coded paths point to the
  294. appropriate directories on your build machine.  Ensure that the
  295. appropriate environment variables (INCLUDE, ETC, TMP, and the SOM
  296. compiler environment variables) are set up.  Refer to the LAN NetView
  297. Programmers Guide and the LAN NetView User Interface Programmers Guide
  298. for more information.
  299.  
  300. The lnremlch.dll module contains the SOM classes necessary to interface
  301. with the View APIs.  It uses class definitions from the \lnv\etc\sc
  302. directory and include files from the \lnv\include directory.  Build the
  303. lnremlch.dll module using the information in the LAN NetView User
  304. Interface Programmers Guide.  Note that the make file for this module
  305. assumes that the SOM compiler environment variables have been set and
  306. that the SOM compiler has been executed against the lnremlch.csc file
  307. at least once before the make file is executed.  It also assumes that
  308. the resource compiler has been used to create a .res file before the
  309. make file is executed.  
  310.  
  311. The lnuiutil.dll module is a Presentation Manager utility program module
  312. which contains services called by the lnremlch.dll module.  Use the PM
  313. samples from the OS/2 toolkit as a reference when building this module. 
  314. Note that the make file for this module assumes that the resource
  315. compiler has been executed to create a .res file before this make file
  316. is executed.  
  317.  
  318. The decode.dll module contains XOM routines to parse XMP parameter
  319. structures.  It uses the include files in the \lnv\include directory. 
  320. Build the decode.dll module using the information from the LAN NetView
  321. Programmers Guide and the LAN NetView Programmers reference.  Note that
  322. the make file for this module uses a linker response file.
  323.