home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Collection - Online Library - January 1996 / CKITOS0196.ISO / readscrt.txt < prev    next >
Text File  |  1994-11-04  |  18KB  |  441 lines

  1. ***********************************************
  2. SOFTCOPY RECEIVER TOOL VERSION 1.3  README FILE
  3. PROGRAM NUMBER: 5648-032
  4. ***********************************************
  5.  
  6. What's new in SCRT
  7. ------------------
  8. Softcopy Receiver Tool Version 1.3  now provides the following
  9. additional functions over version 1.2, and these functions are documented
  10. in the user's guide (GC23-3663-03):
  11. o   Support for use with CD/Showcase--in that, the SCRT will detect
  12.     encrypted or 'locked' files and prevent copying.
  13. o   Support for 'types' other than Books, Bookshelves and Bookindices
  14.     (although at this time, there are no other types on the kits).
  15. o   Added flexibility for selections from the Global Select panel.
  16. o   Support for OMA 3423 device types.
  17. o   Increased error checking for SCRT/MVS target space routines.
  18.  
  19. NOTE:  If you have previously installed any other version of SCRT, you
  20. should replace that version by following the procedures described in
  21. "Installing SCRT/VM" and "Installing SCRT/MVS."
  22.  
  23. Also, if you want to use older softcopy kits on your workstation,
  24. follow the procedure found in "Installing SCRT on your hard disk (for
  25. users of early softcopy kits)."
  26.  
  27. What is SCRT?
  28. -------------
  29. The Softcopy Receiver Tool (SCRT) is included as a part of every IBM
  30. softcopy publications kit.  A softcopy publications kit is a special
  31. collection of softcopy publications distributed on tape and CD-ROM.
  32. SCRT is used to receive publications from the kit and place them into
  33. your permanent storage.
  34.  
  35. SCRT comes equipped to run on DOS, OS/2, VM/CMS, and MVS/TSO.  If you
  36. have a kit that was distributed on tape, you would use either the VM
  37. or the MVS flavor of SCRT to transfer the softcopy publications to
  38. your host storage.  If you have a kit that was distributed on CD-ROM,
  39. you could choose to transfer the files to your host or your
  40. workstation environment.  Use the following table to choose which
  41. flavor of SCRT is best suited for you:
  42.  
  43. +-------------+-------------+-------------+-------------+------------+
  44. |             | SCRT/2      | SCRT/DOS    | SCRT/VM     | SCRT/MVS   |
  45. +-------------+-------------+-------------+-------------+------------+
  46. | KIT ON TAPE |             |             | x           | x          |
  47. +-------------+-------------+-------------+-------------+------------+
  48. | KIT ON      | x           | x           | with OMA    | with OMA   |
  49. | CD-ROM      |             |             |             |            |
  50. +-------------+-------------+-------------+-------------+------------+
  51.  
  52. For CD-ROM>Host users (those needing OMA)
  53. -----------------------------------------
  54. SCRT requires the IBM S/370 and S/390 Optical Media Attach/2 (OMA) to
  55. transfer softcopy publications from a CD-ROM to a VM or MVS host.  IBM
  56. softcopy publications kits distributed on CD-ROM can be accessed as a
  57. tape volume.  The IBM S/370 and S/390 Optical Media Attach/2 provides
  58. access to the data on the CD-ROM by emulating a host tape drive.  See
  59. the user's guide for more information.
  60.  
  61. SCRT/2 and SCRT/DOS
  62. -------------------
  63. SCRT is designed to operate in any of the following DOS or OS/2
  64. environments:
  65.  
  66. o   DOS 5.0 and above
  67. o   OS/2 1.3 and above
  68.  
  69. SCRT/2 and SCRT/DOS require:
  70.  
  71. o   At least 400KB of system storage
  72. o   425KB of system memory
  73.  
  74. Additional space is required for the SCRT history file and for each
  75. publication transferred to the target drive.
  76.  
  77. Starting SCRT/2 or SCRT/DOS
  78. ---------------------------
  79. No installation is required for SCRT/2 or SCRT/DOS.  These versions of
  80. SCRT can be run directly from a CD-ROM.
  81.  
  82. When you use SCRT to receive publications, SCRT writes work files to
  83. your fixed disk as well.  These files include:
  84.  
  85. o   a profile
  86. o   temporary work files
  87. o   the history file
  88.  
  89. The profile and temporary work files are, by default, placed in C:\.
  90. To change the location of these files, see "Optional placement of SCRT
  91. work files."
  92.  
  93. 1.  To run SCRT in an OS/2 session, type:
  94.  
  95.     drive:\SCRT\EBRSCRT2
  96.  
  97.     where drive is the drive assignment for the CD-ROM.
  98.  
  99. 2.  To run SCRT in a DOS session, type:
  100.  
  101.     drive:\SCRT\EBRSCRT
  102.  
  103.     where drive is the drive assignment for the CD-ROM.
  104.  
  105.     NOTE:  Multiple OS/2 sessions of SCRT running on the same
  106.     workstation, or running SCRT/DOS and SCRT/2 sessions concurrently,
  107.     can cause errors.
  108.  
  109. 3.  The Setup Options window is displayed.
  110.  
  111. 4.  Type the drive (A-Z) of the CD containing the softcopy
  112.     publications kit.
  113.  
  114. 5.  Type the path name for the SCRT history file.  This file is used
  115.     by SCRT and we recommend that it is installed on your fixed disk
  116.     with at least 200KB of storage space.
  117.  
  118.     The history file provides a record of SCRT activity.  SCRT
  119.     displays information from the history file if you attempt to
  120.     overwrite existing files.  So, you should use the same target path
  121.     each time you start SCRT to keep your history file current.
  122.  
  123. 6.  Press ENTER to read the publication list from the CD.
  124.  
  125. 7.  SCRT is now ready to use.  Use the online help (F1) or see the
  126.     user's guide for more information.
  127.  
  128. NOTE:  You must exit and restart SCRT to display a publications list
  129. from another IBM softcopy publications kit.
  130.  
  131. Optional placement of SCRT work files
  132. -------------------------------------
  133. The profile and work files are, by default, placed in C:\.  To change
  134. the location of these files, use a text editor and edit your
  135. CONFIG.SYS file (for OS/2) or your AUTOEXEC.BAT file (for DOS) and add
  136. the following line:
  137.  
  138. SET EBRSCRT=path
  139. where path is an existing OS/2 or DOS path.
  140.  
  141. NOTE:  SCRT work files need 200KB of storage.
  142.  
  143. Installing SCRT on your hard disk (for users of early softcopy kits)
  144. --------------------------------------------------------------------
  145. Earlier softcopy collection kits did not contain the workstation
  146. versions of SCRT.  If you want to use the workstation version of SCRT
  147. with these early kits, you must install SCRT/DOS or SCRT/2 Version 1.2
  148. on to your hard disk.  To install and start SCRT on your hard disk:
  149.  
  150. 1.  Copy the following files from a newer softcopy collection kit to a
  151.     directory of your choice:
  152.  
  153.         EBRSCRT.EXE
  154.         EBRSCRT2.EXE
  155.         EBRSCRT.MSG
  156.         EBRSCRT.PNL
  157.  
  158. 2.  Run SCRT from that directory by typing:
  159.  
  160.     EBRSCRT2       (for an OS2 session)
  161.     EBRSCRT        (for a DOS session)
  162.  
  163.     NOTE:  Multiple OS/2 sessions of SCRT running on the same
  164.     workstation, or running SCRT/DOS and SCRT/2 sessions concurrently,
  165.     can cause errors.
  166.  
  167. 3.  Continue with step 4 under Starting SCRT/2 or SCRT/DOS.
  168.                                ---------------------------
  169.  
  170. SCRT/VM
  171. -------
  172. SCRT is designed to operate in any of the following VM/CMS
  173. environments:
  174.  
  175. o   VM/SP Release 5 or higher
  176. o   VM/SP HPO Release 5 or higher
  177. o   VM/XA SP Release 2 or higher
  178. o   VM/ESA Release 1.0 or higher
  179.  
  180. NOTE:  SCRT does not support the VM Shared File System.
  181.  
  182. SCRT/VM requires:
  183.  
  184. o   The IBM C/370 Runtime Library Version 1 Release 2 or higher.  If
  185.     you use BookManager/VM, you already have the IBM C/370 Runtime
  186.     Library.  PTF UN11350 must be installed if you are running the IBM
  187.     C/370 Runtime Library Version 1 Release 2. Contact your IBM
  188.     service representative for details (APAR PN08574).
  189.  
  190. o   The equivalent of one cylinder of 3380 DASD for the SCRT/VM code
  191.     files.  Additional space is required for the SCRT history file and
  192.     for each publication transferred to the target filemode.
  193.  
  194. o   Four megabytes of virtual storage to run SCRT/VM.
  195.  
  196. o   If a CD-ROM user, see "For CD-ROM>Host users (those needing OMA)"
  197.     earlier in this file.
  198.  
  199. Installing SCRT/VM
  200. ------------------
  201. To install SCRT/VM:
  202.  
  203. 1.  Log on to VM/CMS.
  204.  
  205. 2.  Mount the IBM softcopy publications tape (sequential tape or
  206.     CD-ROM).  If mounting a multi-volume set, mount volume 1 first.
  207.  
  208. 3.  Issue the following VMFPLC2 commands to install SCRT:
  209.  
  210.     Default command               Full syntax
  211.     VMFPLC2 REW                   VMFPLC2 REW (vdev
  212.     VMFPLC2 FSF 4                 VMFPLC2 FSF 4 (vdev
  213.     VMFPLC2 LOAD                  VMFPLC2 LOAD * *  fm (vdev
  214.  
  215.     Where:
  216.  
  217.     vdev is the virtual address of the attached tape device (default
  218.          is 181).
  219.     fm   is the target installation disk (default is filemode A).
  220.  
  221.     The system response should be:
  222.  
  223.         LOADING.....
  224.         EBRSCRT  IPVLIB fm
  225.         EBRSCRT  EXEC   fm
  226.         EBRSCRT  MODULE fm
  227.         EBRSCRT  EBRMSG fm
  228.         IPVMODFS MODULE fm
  229.         END-OF-FILE OR END-OF-TAPE
  230.        Ready;
  231.  
  232.     If all of the files shown are loaded, you have completed the
  233.     installation.  (The files may not be loaded in the order shown.)
  234.  
  235. Starting SCRT/VM
  236. ----------------
  237. To start SCRT on VM/CMS:
  238.  
  239. 1.  Ensure that you have R/W access to an 'A' disk.
  240.  
  241.     SCRT requires R/W access to an 'A' disk for the SCRT history file
  242.     (EBRSCRT HISTORY A) and for temporary work files.  The SCRT
  243.     history file provides a record of SCRT activity.  SCRT displays
  244.     information from the history file if you attempt to overwrite
  245.     existing files.
  246.  
  247. 2.  Enter the CMS command:
  248.  
  249.         EX EBRSCRT
  250.  
  251.     The EBRSCRT EXEC will setup the IBM C/370 Runtime environment and
  252.     start SCRT/VM.  Refer to the IBM C/370 User's Guide, SC09-1264,
  253.     for details about setting up the IBM C/370 Runtime environment.
  254.  
  255. 3.  The Setup Options window is displayed.
  256.  
  257. 4.  Type the virtual device address of the source tape (the default is
  258.     181).
  259.  
  260. 5.  If the tape is already mounted, skip to the next step; otherwise,
  261.     enter your local tape mount command on the command line.  SCRT
  262.     will pass the entered command to CMS subset.  Be sure to specify
  263.     the same virtual device address from the Setup Options window
  264.     (default 181) in your local tape mount command.
  265.  
  266.     Wait until the device is attached and the tape is mounted.  IBM
  267.     softcopy publications kits distributed on CD-ROM can be accessed
  268.     as a tape volume.  The IBM S/370 and S/390 Optical Media Attach/2
  269.     provides access to the tape on the CD-ROM by emulating a host tape
  270.     drive.  Refer to the user's guide for more information.
  271.  
  272. 6.  Press ENTER to read the publication list from the tape.
  273.  
  274.     NOTE:  You must exit and restart SCRT to display a publications
  275.     list from another IBM softcopy publications kit.
  276.  
  277. 7.  SCRT is now ready to use.  Use the online help (F1) or see
  278.     the user's guide.
  279.  
  280. SCRT/MVS
  281. --------
  282. SCRT is designed to operate in any of the following MVS/TSO
  283. environments:
  284.  
  285. o   MVS/XA (MVS/SP Version 2) with TSO/E Version 2 Release 1 or higher
  286. o   MVS/ESA (MVS/SP Version 3) with TSO/E Version 2 Release 1 or
  287.     higher
  288. o   MVS/ESA (MVS/SP Version 4) with TSO/E Version 2 Release 1 or
  289.     higher
  290.  
  291. SCRT/MVS requires:
  292.  
  293. o   The IBM C/370 Runtime Library Version 1 Release 2 or higher.  If
  294.     you use BookManager/MVS, you already have the IBM C/370 Runtime
  295.     Library.
  296. o   The equivalent of 3 cylinders of 3380 DASD for the SCRT/MVS
  297.     datasets.  Additional space is required for the SCRT history file
  298.     and for each publication transferred to the target unit/volser.
  299. o   Tape mount authority from your TSO session.
  300. o   If using multi-volume tapes, access to Bypass Label Processing
  301.     (BLP).
  302. o   Read authority to IBM softcopy publications kits.
  303.     IBM softcopy publications kits include datasets with a high-level
  304.     qualifier of IBM.  The IBM high-level qualifier may need to be
  305.     added to your MVS security system with read authority for yourself
  306.     and other SCRT users.  If you and the other SCRT users are granted
  307.     read authority to the IBM high-level qualifier you will be able to
  308.     access any dataset included with an IBM softcopy publications kit.
  309.     When SCRT transfers the datasets from the tape or CD-ROM to the
  310.     target unit/volser, the files are written using the high-level
  311.     qualifier you specify.
  312. o   If a CD-ROM user, see "For CD-ROM>Host users (those needing OMA)"
  313.     earlier in this file.
  314.  
  315. Installing SCRT/MVS
  316. -------------------
  317. To install SCRT/MVS:
  318.  
  319. 1.  Log on to MVS/TSO.
  320.  
  321. 2.  Create the following JCL:
  322.  
  323.        1 //* Replace this line with your system specific job card
  324.        2 //S1        EXEC PGM=IEBGENER
  325.        3 //SYSPRINT  DD SYSOUT=*
  326.        4 //SYSUT1    DD DSN=IBM.EBRJCL,DISP=OLD,UNIT=tttttt,
  327.        5 //             VOL=SER=vvvvvv,LABEL=(3,SL)
  328.        6 //SYSUT2    DD DSN=xxxxxxxx.EBRSCRT.INSTALL.JCL,DISP=(xxx,CATLG,DELETE),
  329.        7 //             UNIT=dddddd,DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160),
  330.        8 //             SPACE=(TRK,1)
  331.        9 //SYSIN     DD *
  332.       10    GENERATE MAXFLDS=1
  333.       11    RECORD FIELD=(80)
  334.       12 /*
  335.  
  336. 3.  Replace line 1 with your system specific job card:  jobid,
  337.     accounting information, class, msgclass, etc.
  338.  
  339. 4.  Change 'tttttt' in 'UNIT=tttttt' on line 4 to identify the tape or
  340.     CD-ROM unit.  Unit examples are as follows:
  341.  
  342.     DEVICE        EXAMPLES
  343.     address       3F0, 3F8, 4F0, 4F8, etc.
  344.     device type   3422, 3480, 3380, etc.
  345.     esoteric name PCTAPE, TAPE, DISK, SYSDA, etc.
  346.  
  347. 5.  Change 'vvvvvv' in 'VOL=SER=vvvvvv' on line 5 to the volume label
  348.     on the CD-ROM or first tape.
  349.  
  350. 6.  Change 'xxxxxxxx' in 'DSN=xxxxxxxx.EBRSCRT.INSTALL.JCL' on line 6
  351.     to a high-level qualifier you choose for the target dataset.
  352.  
  353. 7.  Change 'xxx' in 'DISP=(xxx,CATLG,DELETE)' on line 6 to NEW if the
  354.     xxxxxxxx.EBRSCRT.INSTALL.JCL dataset does not exist or to OLD if
  355.     the xxxxxxxx.EBRSCRT.INSTALL.JCL dataset does exist.
  356.  
  357. 8.  Change 'dddddd' in 'UNIT=dddddd' on line 7 to identify the target
  358.     unit.  Refer to the examples provided in step 4.
  359.  
  360. 9.  Submit the modified JCL through your normal batch-processing
  361.     system.  The job will issue a tape mount request.  Mount the IBM
  362.     softcopy publications tape (sequential tape or CD-ROM).  After the
  363.     tape is mounted, the job will allocate the required space and copy
  364.     the install JCL from the tape or CD-ROM to the dataset
  365.     xxxxxxxx.EBRSCRT.INSTALL.JCL.  Ensure that the job completes
  366.     without error.
  367.  
  368. 10. Edit the install JCL dataset and follow the instructions contained
  369.     within the JCL (add your job card and change the UNITs, VOLs, and
  370.     high-level qualifiers).  The install JCL is used to allocate space
  371.     and install SCRT.
  372.  
  373. 11. Submit the modified install JCL through your normal
  374.     batch-processing system.  The job will issue a tape mount request.
  375.     Mount the IBM softcopy publications tape (sequential tape or
  376.     CD-ROM).  After the tape is mounted, the job will install
  377.     SCRT/MVS.  Do not continue until the install job has completed
  378.     without error.
  379.  
  380. 12. Edit the installed SCRT CLIST (qualifier.EBRSCRT.EBRCLT) and
  381.     change the 'XXXXXXXX' in the 'SET SCRTHLQ = &STR(XXXXXXXX)'
  382.     statement to the high-level qualifier used for the installed SCRT
  383.     datasets.
  384.  
  385. Starting SCRT/MVS
  386. -----------------
  387. To start SCRT on MVS/TSO:
  388.  
  389. 1.  Go to a TSO command prompt and enter the TSO command:
  390.  
  391.         EX 'qualifier.EBRSCRT.EBRCLT'
  392.  
  393.     If the IBM C/370 Runtime Libraries are not accessible, you will
  394.     receive a protection exception.  Refer to the IBM C/370 User's
  395.     Guide, SC09-1264, for details about setting up the IBM C/370
  396.     Runtime Libraries.
  397.  
  398. 2.  The Setup Options window is displayed.
  399.  
  400. 3.  Type the VOLID of the softcopy publications tape (the volume
  401.     serial is printed on the tape or CD-ROM label).
  402.  
  403. 4.  Type the Source Unit (the default is PCTAPE).
  404.  
  405. 5.  Type the History File High-Level Qualifier.  This entry is for the
  406.     SCRT history file (qualifier.EBRSCRT.EBRHST).  The SCRT history
  407.     file provides a record of SCRT activity.  SCRT displays
  408.     information from the history file if you attempt to overwrite
  409.     existing datasets.  If the history file does not exist, SCRT will
  410.     create it using the high-level qualifier, unit, and VOLSER
  411.     specified.  If the history file already exists, SCRT will ignore
  412.     the unit and VOLSER specified and use the existing history file.
  413.     Use the same high-level qualifier to prevent the creation of
  414.     multiple SCRT history files.
  415.  
  416. 6.  Type the VOLSER and Unit for the SCRT history file.  (The history
  417.     file VOLSER is not a required entry.)  You must have read/write
  418.     and create authority for the history file.  SCRT will use the
  419.     history file unit/VOLSER to store SCRT temporary work files and
  420.     the SCRT profile.  The SCRT profile dataset
  421.     (userid.EBRSCRT.EBRPRF) is used to store all of the information
  422.     you enter on the Setup Options window.  The first time you start
  423.     SCRT,  message 'EBR027: User profile not found - one will be
  424.     created.' is displayed.  SCRT will create a new user profile.  The
  425.     next time you start SCRT, the entry fields in the Setup Options
  426.     window will default to the information in your SCRT profile.  Be
  427.     sure to specify a unit/VOLSER that is NOT using temporary storage.
  428.  
  429. 7.  Press ENTER to issue the tape mount request and to read the
  430.     publications list from the tape.  IBM softcopy publications kits
  431.     distributed on CD-ROM can be accessed as a tape volume.  The IBM
  432.     S/370 and S/390 Optical Media Attach/2 provides access to the tape
  433.     on the CD-ROM by emulating a host tape drive.  Refer to the
  434.     user's guide for more information.
  435.  
  436.     NOTE:  You must exit and restart SCRT to display a publications
  437.     list from another IBM softcopy publications kit.
  438.  
  439. 8.  SCRT is now ready to use.  Use the online help (F1) or see
  440.     the user's guide for more information.
  441.