********************************************************************
README FILE
SOFTCOPY RECEIVER TOOL VERSION 1.3 FOR VM and MVS (also OS/390)
SOFTCOPY RECEIVER TOOL VERSION 2.3 FOR OS/2, Windows95 and WindowsNT.
PROGRAM NUMBER: 5648-032
********************************************************************
 
What's new in SCRT
------------------
Softcopy Receiver Tool Version 2.3 for OS/2 and Windows is now
available.  It offers:
 *SEND support -- uses a 3270 terminal emulator SEND command to
transfer the selected files to your chosen host.
 *FTP support --  uses File Transfer Protocol to transfer the selected
files to your chosen host.
 *NFS support --  uses Network File System to copy the selected files
to a NFS-mounted drive on your workstation.
 *COPY support -- uses standard Copy commands to copy the selected
files to any drive your workstation can access with a drive letter.
 
What is SCRT?
-------------
The Softcopy Receiver Tool (SCRT) is included as a part of every IBM
softcopy publications kit.  A softcopy publications kit is a special
collection of softcopy publications distributed on tape and CD-ROM.
SCRT is used to receive publications from the kit and place them into
your permanent storage.
 
SCRT comes equipped to run on Windows95, WindowsNT, OS/2, VM/CMS, 
MVS/TSO and and OS/390 (use SCRT/MVS).
If you have a kit that was distributed on tape, you would use either
the VM or MVS flavor of SCRT to transfer the softcopy publications
to your host storage.  If you have a kit that was distributed
on CD-ROM, you could choose to transfer the files to your host
or your workstation environment.  Use the following table to choose
which flavor of SCRT is best suited for you:
 
+-------------+-------------+-------------+-------------+------------+
|             | SCRT/2      | SCRT/WIN    | SCRT/VM     | SCRT/MVS   |
+-------------+-------------+-------------+-------------+------------+
| KIT ON TAPE |             |             | x           | x          |
+-------------+-------------+-------------+-------------+------------+
| KIT ON      | x           | x           | with OMA    | with OMA   |
| CD-ROM      |             |             |             |            |
+-------------+-------------+-------------+-------------+------------+
 
For CD-ROM>Host users (those needing OMA)
-----------------------------------------
SCRT/MVS requires the IBM S/370 and S/390 Optical Media Attach/2 (OMA) to
transfer softcopy publications from a CD-ROM to a VM or MVS host.  IBM
softcopy publications kits distributed on CD-ROM can be accessed as a
tape volume.  The IBM S/370 and S/390 Optical Media Attach/2 provides
access to the data on the CD-ROM by emulating a host tape drive.  See
the user's guide for more information.
 
SCRT/2 and SCRT/WIN
-------------------
SCRT is designed to operate in any of the following Windows or OS/2
environments:
 
o   Windows95 and above
o   WindowsNT 4.0 and above
o   OS/2 WARP V3.0 and above
 
Starting  SCRT/WIN
------------------
Do not install SCRT/WIN on your hard drive.  This version of the SCRT
should be run directly from a CD-ROM.
 
To run SCRT from a command prompt:
 
   1) Change directories to 
          drive:\SCRT\SCRTW
      where drive is the drive assignment for the CD-ROM.
 
   2) Enter EBRSCRTW
 
NOTE:  Multiple sessions of SCRT running on the same
workstation concurrently can cause errors.
 
Starting  SCRT/2
------------------
Do not install SCRT/2 on your hard drive.  This version of the SCRT
should be run directly from a CD-ROM.
 
To run SCRT from a command prompt:
 
   1) Change directories to 
          drive:\SCRT\SCRT2
      where drive is the drive assignment for the CD-ROM.
 
   2) Enter EBRSCRT2
 
NOTE:  Multiple sessions of SCRT running on the same
workstation concurrently can cause errors.
 
SCRT/VM
-------
SCRT is designed to operate in any of the following VM/CMS
environments:
 
o   VM/SP Release 5 or higher
o   VM/SP HPO Release 5 or higher
o   VM/XA SP Release 2 or higher
o   VM/ESA Release 1.0 or higher
 
NOTE:  SCRT does not support the VM Shared File System.
 
SCRT/VM requires:
 
o   The IBM C/370 Runtime Library Version 1 Release 2 or higher. 
 
o   The equivalent of one cylinder of 3380 DASD for the SCRT/VM code
    files.  Additional space is required for the SCRT history file and
    for each publication transferred to the target filemode.
 
o   Four megabytes of virtual storage to run SCRT/VM.
 
o   If a CD-ROM user, see "For CD-ROM>Host users (those needing OMA)"
    earlier in this file.
 
Installing SCRT/VM
------------------
To install SCRT/VM:
 
1.  Log on to VM/CMS.
 
2.  Mount the IBM softcopy publications tape (sequential tape or
    CD-ROM).  If mounting a multi-volume set, mount volume 1 first.
 
3.  Issue the following VMFPLC2 commands to install SCRT:
 
    Default command               Full syntax
    VMFPLC2 REW                   VMFPLC2 REW (vdev
    VMFPLC2 FSF 4                 VMFPLC2 FSF 4 (vdev
    VMFPLC2 LOAD                  VMFPLC2 LOAD * *  fm (vdev
 
    Where:
 
    vdev is the virtual address of the attached tape device (default
         is 181).
    fm   is the target installation disk (default is filemode A).
 
    The system response should be:
 
        LOADING.....
        EBRSCRT  IPVLIB fm
        EBRSCRT  EXEC   fm
        EBRSCRT  MODULE fm
        EBRSCRT  EBRMSG fm
        IPVMODFS MODULE fm
        END-OF-FILE OR END-OF-TAPE
       Ready;
 
    If all of the files shown are loaded, you have completed the
    installation.  (The files may not be loaded in the order shown.)
 
Starting SCRT/VM
----------------
To start SCRT on VM/CMS:
 
1.  Ensure that you have R/W access to an 'A' disk.
 
    SCRT requires R/W access to an 'A' disk for the SCRT history file
    (EBRSCRT HISTORY A) and for temporary work files.  The SCRT
    history file provides a record of SCRT activity.  SCRT displays
    information from the history file if you attempt to overwrite
    existing files.
 
2.  Enter the CMS command:
 
        EX EBRSCRT
 
    The EBRSCRT EXEC will setup the IBM C/370 Runtime environment and
    start SCRT/VM.  Refer to the IBM C/370 User's Guide, SC09-1264,
    for details about setting up the IBM C/370 Runtime environment.
 
3.  The Setup Options window is displayed.
 
4.  Type the virtual device address of the source tape (the default is
    181).
 
5.  If the tape is already mounted, skip to the next step; otherwise,
    enter your local tape mount command on the command line.  SCRT
    will pass the entered command to CMS subset.  Be sure to specify
    the same virtual device address from the Setup Options window
    (default 181) in your local tape mount command.
 
    Wait until the device is attached and the tape is mounted.  IBM
    softcopy publications kits distributed on CD-ROM can be accessed
    as a tape volume.  The IBM S/370 and S/390 Optical Media Attach/2
    provides access to the tape on the CD-ROM by emulating a host tape
    drive.  Refer to the user's guide for more information.
 
6.  Press ENTER to read the publication list from the tape.
 
    NOTE:  You must exit and restart SCRT to display a publications
    list from another IBM softcopy publications kit.
 
7.  SCRT is now ready to use.  Use the online help (F1) or see
    the user's guide.
 
SCRT/MVS
--------
SCRT is designed to operate in any of the following environments:
 
o   MVS/XA (MVS/SP Version 2) with TSO/E Version 2 Release 1 or higher
o   MVS/ESA (MVS/SP Version 3) with TSO/E Version 2 Release 1 or
    higher
o   MVS/ESA (MVS/SP Version 4) with TSO/E Version 2 Release 1 or
    higher
o   OS/390 V1R1.0 or higher
 
SCRT/MVS requires:
 
o   The IBM C/370 Runtime Library Version 1 Release 2 or higher.  If
    you use BookManager/MVS, you already have the IBM C/370 Runtime
    Library.
o   The equivalent of 3 cylinders of 3380 DASD for the SCRT/MVS
    datasets.  Additional space is required for the SCRT history file
    and for each publication transferred to the target unit/volser.
o   Tape mount authority is required.  This can be granted by your
    systems programmer using RACF class TSOAUTH, MOUNT profile.
o   If using a kit with multiple volumes, the user ID must have
    Bypass Label Processing (BLP) authority.
o   Read authority to IBM softcopy publications kits.
    IBM softcopy publications kits include datasets with a high-level
    qualifier of IBM.  The IBM high-level qualifier may need to be
    added to your MVS security system with read authority for yourself
    and other SCRT users.  If you and the other SCRT users are granted
    read authority to the IBM high-level qualifier you will be able to
    access any dataset included with an IBM softcopy publications kit.
    When SCRT transfers the datasets from the tape or CD-ROM to the
    target unit/volser, the files are written using the high-level
    qualifier you specify.
o   If a CD-ROM user, see "For CD-ROM>Host users (those needing OMA)"
    earlier in this file.
 
Installing SCRT/MVS
-------------------
To install SCRT/MVS:
 
1.  Log on to MVS/TSO.
 
2.  Create the following JCL:
 
    If CD-ROM:
       1 //* Replace this line with your system specific job card
       2 //S1        EXEC PGM=IEBGENER
       3 //SYSPRINT  DD SYSOUT=*
       4 //SYSUT1    DD DSN=IBM.EBRJCL,DISP=OLD,UNIT=tttttt,
       5 //             VOL=SER=vvvvvv,LABEL=(3,SL)
       6 //SYSUT2    DD DSN=xxxxxxxx.EBRSCRT.INSTALL.JCL,DISP=(xxx,CATLG,DELETE),
       7 //             UNIT=dddddd,DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160),
       8 //             SPACE=(TRK,1)
       9 //SYSIN     DD *
      10    GENERATE MAXFLDS=1
      11    RECORD FIELD=(80)
      12 /*
    If tape:
       1 //* Replace this line with your system specific job card
       2 //S1        EXEC PGM=IEBGENER
       3 //SYSPRINT  DD SYSOUT=*
       4 //SYSUT1    DD DSN=IBM.EBRJCL,DISP=OLD,UNIT=tttttt,
       5 //             VOL=SER=vvvvvv,LABEL=(3,SL)
       6 //SYSUT2    DD DSN=xxxxxxxx.EBRSCRT.INSTALL.JCL,DISP=(xxx,CATLG,DELETE),
       7 //             UNIT=dddddd,DCB=*.SYSUT1,
       8 //             SPACE=(TRK,1)
       9 //SYSIN     DD *
      10    GENERATE MAXFLDS=1
      11    RECORD FIELD=(80)
      12 /*
 
3.  Replace line 1 with your system specific job card:  jobid,
    accounting information, class, msgclass, etc.
 
4.  Change 'tttttt' in 'UNIT=tttttt' on line 4 to identify the tape or
    CD-ROM unit.  Unit examples are as follows:
 
    DEVICE        EXAMPLES
    address       3F0, 3F8, 4F0, 4F8, etc.
    device type   3422, 3480, 3380, etc.
    esoteric name PCTAPE, TAPE, DISK, SYSDA, etc.
 
5.  Change 'vvvvvv' in 'VOL=SER=vvvvvv' on line 5 to the volume label
    on the CD-ROM or first tape.
 
6.  Change 'xxxxxxxx' in 'DSN=xxxxxxxx.EBRSCRT.INSTALL.JCL' on line 6
    to a high-level qualifier you choose for the target dataset.
 
7.  Change 'xxx' in 'DISP=(xxx,CATLG,DELETE)' on line 6 to NEW if the
    xxxxxxxx.EBRSCRT.INSTALL.JCL dataset does not exist or to OLD if
    the xxxxxxxx.EBRSCRT.INSTALL.JCL dataset does exist.
 
8.  Change 'dddddd' in 'UNIT=dddddd' on line 7 to identify the target
    unit.  Refer to the examples provided in step 4.
 
9.  Submit the modified JCL through your normal batch-processing
    system.  The job will issue a tape mount request.  Mount the IBM
    softcopy publications tape (sequential tape or CD-ROM).  After the
    tape is mounted, the job will allocate the required space and copy
    the install JCL from the tape or CD-ROM to the dataset
    xxxxxxxx.EBRSCRT.INSTALL.JCL.  Ensure that the job completes
    without error.
 
10. Edit the install JCL dataset and follow the instructions contained
    within the JCL (add your job card and change the UNITs, VOLs, and
    high-level qualifiers).  The install JCL is used to allocate space
    and install SCRT.
 
11. Submit the modified install JCL through your normal
    batch-processing system.  The job will issue a tape mount request.
    Mount the IBM softcopy publications tape (sequential tape or
    CD-ROM).  After the tape is mounted, the job will install
    SCRT/MVS.  Do not continue until the install job has completed
    without error.
 
12. Edit the installed SCRT CLIST (qualifier.EBRSCRT.EBRCLT) and
    change the 'XXXXXXXX' in the 'SET SCRTHLQ = &STR(XXXXXXXX)'
    statement to the high-level qualifier used for the installed SCRT
    datasets.
 
Starting SCRT/MVS
-----------------
To start SCRT on MVS/TSO:
 
1.  Go to a TSO command prompt and enter the TSO command:
 
        EX 'qualifier.EBRSCRT.EBRCLT'
 
    If the IBM C/370 Runtime Libraries are not accessible, you will
    receive a protection exception.  Refer to the IBM C/370 User's
    Guide, SC09-1264, for details about setting up the IBM C/370
    Runtime Libraries.
 
2.  The Setup Options window is displayed.
 
3.  Type the VOLID of the softcopy publications tape (the volume
    serial is printed on the tape or CD-ROM label).
 
4.  Type the Source Unit (the default is PCTAPE).
 
5.  Type the History File High-Level Qualifier.  This entry is for the
    SCRT history file (qualifier.EBRSCRT.EBRHST).  The SCRT history
    file provides a record of SCRT activity.  SCRT displays
    information from the history file if you attempt to overwrite
    existing datasets.  If the history file does not exist, SCRT will
    create it using the high-level qualifier, unit, and VOLSER
    specified.  If the history file already exists, SCRT will ignore
    the unit and VOLSER specified and use the existing history file.
    Use the same high-level qualifier to prevent the creation of
    multiple SCRT history files.
 
6.  Type the VOLSER and Unit for the SCRT history file.  (The history
    file VOLSER is not a required entry.)  You must have read/write
    and create authority for the history file.  SCRT will use the
    history file unit/VOLSER to store SCRT temporary work files and
    the SCRT profile.  The SCRT profile dataset
    (userid.EBRSCRT.EBRPRF) is used to store all of the information
    you enter on the Setup Options window.  The first time you start
    SCRT,  message 'EBR027: User profile not found - one will be
    created.' is displayed.  SCRT will create a new user profile.  The
    next time you start SCRT, the entry fields in the Setup Options
    window will default to the information in your SCRT profile.  Be
    sure to specify a unit/VOLSER that is NOT using temporary storage.
 
7.  Press ENTER to issue the tape mount request and to read the
    publications list from the tape.  IBM softcopy publications kits
    distributed on CD-ROM can be accessed as a tape volume.  The IBM
    S/370 and S/390 Optical Media Attach/2 provides access to the tape
    on the CD-ROM by emulating a host tape drive.  Refer to the
    user's guide for more information.
 
    NOTE:  You must exit and restart SCRT to display a publications
    list from another IBM softcopy publications kit.
 
8.  SCRT is now ready to use.  Use the online help (F1) or see
    the user's guide for more information.
