home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ALMCPY.ZIP / ALMCPY.TXT
Text File  |  1992-03-06  |  5KB  |  84 lines
  1.      Since little documentation seems to be publicly available for
  2. ALMCOPY as released in the ES 402 EEP, I have included some information
  3. available from an earlier release of ALM to facilitate its installation
  4. and use.  This information is based upon installation instructions I
  5. received when we licensed ALMCOPY 5.4B from IBM almost two years ago.
  6. I have used this method to upload the MODULEs and EXEC's for the ES
  7. applet, and it DID work.
  8.      For starters, please recognize that the ALMCOPY.ZIP file found on
  9. diskette 1 of the ES package includes both workstation AND VM-host files.
  10. The file types can be determined by the extensions.  An explanation is
  11. included below:
  12.  
  13.     PC-extension = .MOD    Host MODULE file
  14.     PC-extension = .EXC    Host EXEC file
  15.     PC-extension = .REX    Host REXXEXEC file
  16.     PC-extension = .NAM    Host NAMES file
  17.     PC-extension = .EXE    PC executable file
  18.     PC-extension = .DLL    PC DLL file
  19.     PC-extension = .C      Source code for ALMCOPY front-end
  20.     PC-entension = .H      Header files for ALMCOPY front-end
  21.     PC-extension = .MSC    Make file for ALMCOPY front-end
  22.  
  23.    Now that you know where the files belong and what they are, there are
  24. are some special considerations you MUST observe to get everything up
  25. to the VM host properly.  First, be aware that the modules included in the
  26. ALMCOPY.ZIP file are in a TERSED format.  This means that they were "packed"
  27. on the VM host before being downloaded for inclusion in the ALMCOPY.ZIP
  28. file.  This was done to preserve the MODULE characteristics defined for the
  29. file on VM when it was compiled and linked.  Also, please note that the
  30. .EXC, .REX and .NAM files are also in a TERSED format.  Now for the good
  31. part!  To upload these guys and make them usable, do the following:
  32.   1.  Upload these modules with SEND to your favorite VM host.
  33.       When you upload them, do NOT specifiy ASCII-EBCDIC translation as
  34.       these files are BINARY!!!!  Also, you MUST specify an LRECL size of
  35.       1024.  Your PC command should look like this:
  36.           SEND ACXFR56B.MOD A:ACXFR56B MODPACK A ( LRECL 1024 <enter> etc..
  37.   2.  When you upload these files, use the following conventions for the
  38.       VM filetype specification...... concatenate PACK to the PC file
  39.       extension. IOW - ACXFR56B.MOD becomes ACXFR56B MODPACK,
  40.       ALMCOPY5.REX becomes ALMCOPY5 REXPACK, etc.......
  41.   3.  Once you have the files uploaded, do a FILELIST on your A-Disk
  42.       (or wherever you uploaded your files to) as follows:
  43.          FILELIST * *PACK <enter>
  44.       This should give you a list of the files you just uploaded from
  45.       your PC.  Now, you need to unpack them.
  46.   4.  With your cursor next to the first file, type the following VM
  47.       command to "UNPACK" the files.
  48.           COPYFILE / = filetype = ( UNPACK <enter>
  49.       You should use the following conventions for specifying the
  50.       appropriate filetype:
  51.            MODPACK = MODULE   REXPACK=REXXEXEC  EXCPACK=EXEC
  52.            NAMPACK=NAMES
  53.   5.  PF3 your way back to a RUNNING state after successfully unpacking
  54.       all of your ALMCOPY files.
  55.   6.  Voila!  You're done...  Now, drop back to the PC, make sure that
  56.       ALMCOPY.DLL is in your LIBPATH, and do the following:
  57.           ALMCOPY ALMCOPY.* Hx:= = = <enter>
  58.             (where x: is your Host session identifier).
  59.       Watch the fun!  ALMCOPY is smart enough to recognize that different
  60.       files should be handled in different fashions.  It is smart enough
  61.       to know that .EXE and .DLL files should be uploaded as binary files
  62.       and does it automatically!  The secret is the ALMCOPYX NAMES file
  63.       on the host.  ALMCOPY uses this file to figure out file name
  64.       extension conversions on VM, binary vs. ASCII uploads, etc....
  65.  
  66.       ALMCOPY has a number of processing options which I assume will be
  67. documented in the GA release.  Hopefully, IBM will take the ALMCOPY
  68. documentation and turn it into an .INF file for VIEWing purposes.
  69.    ***** Dave Whittle, are you reading this????? *****
  70.  
  71.      Please don't interpret this entry in the forum as comprehensive.  I
  72. assure you it is NOT!  However, this will at least get it installed for you,
  73. and allow you to begin trying it out.  Hopefully, as usage questions
  74. arise, various existant (sp?) users will chime in with answers.  I'll
  75. chime in as well, and hopefully contribute my experiences with the tool.
  76.      Try ALM out, I think you'll find it an extremely versatile tool.  If
  77. you have access to an IBM SE, ask him/her about it.  Chances are, they
  78. probably use it everyday!
  79.  
  80. Good luck!
  81.  
  82. Toby Pennycuff
  83. American Airlines
  84.