THIS IS JUST AN EXAMPLE OF THE FTP INSTRUCTIONS FOR DOWNLOAD.
THEY WILL NOT WORK!!
You MUST complete the request form at REQUEST FORM,
and then we will mail you the actual ip address, userid, and password
=====================================================================
Subject: RE: ftp Instructions for MXG Version VV.RR
To DOWNLOAD the MXG Version VV.RR Source Library:
ip address: 111.222.333.444
userid uuuuuuu
pw pppppppp
note: userid and password characters may be mixed case.
Contents of these instructions:
1. Choice of Files to Download from ftp site
2. Duration of ftp
3. Choice of ftp direct to MVS or to pc/workstation first
4. If you have ftp problems
5. After the successful download
APPENDIX A. Example JCL for MVS-OS/390-z/OS batch ftp job
APPENDIX B. Example ftp from Windows command prompt
APPENDIX C. Example TSO ftp session
APPENDIX D. Example MVS-only download and un-TERSE terVVRR.ter
APPENDIX E. Example MVS-only, PKZIP for MVS unzip of ebcVVRR.zip:
1. Choice of Files to Download from ftp site:
a. IEBUPDTE-format, EBCDIC text, sequential ("the MXG tape") file used
on EBCDIC systems (MVS-z/OS,VM,etc.) as input to IBM's PGM=IEBUPDTE
to create the MXG Source Library, an MVS PDS with 6890 members.
ebcVVRR.ebc (210,511,840) EBCDIC IEBUPDTE FORMAT, FTP DIRECT TO MVS.
ebcVVRR.zip ( 21,955,504) ZIPPED, FTP TO WORKSTATION, UNZIP, THEN TO MVS.
b. IEBUPDTE-format, ASCII text, sequential ("the MXG tape") file used
on ASCII systems (PCs,Linux,unix) as input to MXG's IEBUPDTE.SAS
program to create the MXG Source Directory's 6890 individual files.
Transfer as binary, see member IEBUPDTE for instructions.
This used to be the only choice for ASCII execution of MXG.
ascVVRR.asc (124,787,863) ASCII IEBUPDTE FORMAT,FTP TO PC/WORKSTATION
ascVVRR.zip ( 19,369,173) ZIPPED ABOVE
c. Zipped file of all 7095 files in ASCII in the MXG Source Directory.
This is the righteous file to download for ASCII execution of MXG,
since you only have to unzip the directory, no rename, no hassles.
dirVVRR.zip ( 21,673,214) ASCII SOURCE DIRECTORY ZIPPED, FOR ASCII EXECUTION.
d. MVS-Only TERSEd file; see APPENDIX D for JCL example.
terVVRR.ter ( 23,???,???) EBCDIC TERSED (COMPRESSED), FOR MVS EXECUTION ONLY.
2. The duration depends on your line speed and zip/unzipped file:
the 175MB unzipped EBCDIC (safest choice for z/OS):
- on a 1.44mbit T1 (500MB/hr) ==> 15 minutes
- or a 56kbit dial-up line ==> 7 hours
the 20MB tersed or zipped files:
- on a 1.44mbit T1 (500MB/hr) ==> 2 minutes
- or a 56kbit dial-up line ==> 51 minutes
"Safest choice" only because there is no character conversion,
for MVS execution; if you download a zip and/or ascii version,
and then upload to z/OS, you put yourself at the mercy of the
character translation table in your ftp/upload program.
3. You can ftp direct to your MVS host, or to a pc/workstation first:
ftp ebcVVRR.ebc directly into an MVS Sequential File, with attributes:
DSN=MXG.MXGVVRR.EBC,RECFM=FB,LRECL=80,BLKSIZE=27920,SPACE=(CYL,(380,50))
as a binary ftp transfer (i.e., no conversion, since it is EBCDIC now).
or,
ftp the ebcVVRR.zip to your pc/workstation as binary, unzip it there,
and then "upload" to your MVS System using TSO tools like IND$FILE,
RHUMBA, or ftp, but the "upload" to MVS must also be binary, that is:
specify both NOCRLF and NOEBCDIC, into an MVS Sequential File with
RECFM=FB,LRECL=80,BLKSIZE=27920,SPACE=(CYL,(275,50))
You must enable the "Passive Transfer" option of your ftp product or
your browser; without that option set, you can get timeouts and/or
disconnects after starting a transfer.
You can also use your browser to access the ftp site for download; the
syntax is to open ftp://111.222.333.444 (note ftp: not http:)
and you will be prompted for userid and password.
If your browser hangs, or you do not get the logon popup window, or your
browser reports "530 Sorry no ANONYMOUS access allowed", or if your site
has a proxy server or firewall that forbids the popup window for userid
and password, you should be able to connect using the full syntax to
include userid and password: ftp://userid:password@ipaddress
ftp://uuuuuuu:pppppppp@111.222.333.444
4. If you have ftp problems:
If you have any problems, try first to ftp from a different site (like
www.sas.com) - if you are unable to ftp from other places, then it may
be a restriction in your company's proxy server and/or firewall, and
you need to resolve with your security/network folks (or you can, at
any time, just give up, and request shipment of a tape or CD!).
With hundreds of ftp transfers, only a handful of sites had problems,
and all were internal proxy server issues that were resolved internally.
We do NOT recommend downloading ASCII to a workstation and uploading to
MVS, because translation from ASCII to EBCDIC varies between uploading
packages, and you may have to globally edit the uploaded EBCDIC text
with country-unique characters (US Dollar Sign versus English Pound).
5. After the succesful download:
After the ftp, then, use that MVS file as the //SYSIN
dataset in your PGM=IEBUPDTE job to create the MXG Source PDS:
//STEP1 EXEC PGM=IEBUPDTE,PARM=NEW
//SYSPRINT DD DUMMY
//SYSIN DD DSN=MXG.MXGVVRR.EBC,DISP=SHR
//SYSUT2 DD DSN=MXG.MXGVVRR.SOURCLIB,VOL=SER=XXXXXX,
// DISP=(NEW,CATLG),
// UNIT=3390,DCB=(RECFM=FB,LRECL=80,BLKSIZE=27920),
// SPACE=(CYL,(275,50,1199))
For ASCII Execution of MXG:
ftp the dirVVRR.zip file to your ASCII platform as binary,
then unzip into your \MXGVVRR\sourclib directory.
For any platform:
Once you create DSN=MXG.MXGVVRR.SOURCLIB on MVS, or the directory on
ASCII ("the MXG Source PDS library), all of the remaining installation
instructions are in member INSTALL, and member JCLINSTL has the JCL
example to complete the installation.
Herbert W. Barry Merrill, PhD
President-Programmer
MXG Software
Merrill Consultants
Dallas, Texas, USA
214 351 1966 x 7
barry@mxg.com
www.mxg.com
Appendix A. - Example JCL for an MVS-OS/390-z/OS batch ftp job.
//MXGFTP JOB (ACCOUNTS,NNNN),CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//FTPMXG EXEC PGM=FTP,PARM='(EXIT'
//SYSPRINT DD SYSOUT=*,DCB=BLKSIZE=133
//SYSABEND DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//FTPOUT DD SYSOUT=*
//* NOTE: below password must be mixed case.
//* userid and file name can be either case.
//* other text can also be either case.
//SYSIN DD *
111.222.333.444
uuuuuuu pppppppp
quote PASV
BINARY
LOCSITE LRECL=80 RECFM=FB BLKSIZE=27920
LOCSITE UNIT=SYSDA PRIMARY=5000 SECONDARY=300
GET ebcVVRR.ebc 'MXG.MXGVVRR.EBC' (replace
CLOSE
QUIT
"PASV" for Passive Mode prevents timeouts, 99% of the time, but
but one site's firewall rejected the request, and they had
to remove the quote PASV to make their ftp work.
Do not use line numbers for the //SYSIN text; they will cause
errors like: ZA1553E Invalid port number. Open fails.
Appendix B. - Example ftp from a Windows command prompt:
(file sizes in example output may not be current size)
You can issue the DOS ftp command from a command prompt under
Windows to download the MXG file.
The sequence of your inputs and ftp's responses, with some comments,
are shown below. You will select one of the files, and tell ftp where
on your hard drive you want the downloaded file to be stored.
C:\>ftp
ftp> ope 111.222.333.444
Connected to 111.222.333.444.
220 Serv-U FTP Server v4.0 for WinSock ready...
USER (111.222.333.444:(NONE)): MXGVVRR
331 User name okay, need password.
Password:
230 User logged in, proceed.
ftp> ls
200 PORT Command successful.
150 Opening ASCII mode data connection for /bin/ls.
-- the list of files at the ftp site are shown
-- you will only need to download the one you want
ascVVRR.asc
ascVVRR.zip
dirVVRR.zip
ebcVVRR.ebc
ebcVVRR.zip
226 Print of File List complete.
ftp: 65 bytes received in 0.00Seconds 65000.00Kbytes/sec.
-- the next "ftp" commands actually are local commands,
-- and will determine where the downloaded file will be
-- stored on your local machine.
ftp> lcd
Local directory now C:\.
ftp> lcd c:\download
Local directory now C:\download.
ftp> binary
200 Type set to I.
-- now, name which file you want to "get"
ftp> get ebcVVRR.zip
200 PORT Command successful.
150 Opening BINARY mode data connection for ebcVVRR.zip.
226 Transfer complete.
ftp: 18937334 bytes received in 110.99Seconds 170.62Kby/sec.
ftp> quit
221 Goodbye!
Appendix C. - Example TSO ftp session:
EZA1450I IBM FTP CS V1R2
EZA1466I FTP: using IBMTCP05
EZA1456I Connect to ?
111.222.333.444
EZA1554I Connecting to: 111.222.333.444 port: 21.
220 Serv-U FTP Server v4.0 for WinSock ready...
EZA1459I NAME (111.222.333.444:CPT4187):
uuuuuuu
EZA1701I >>> USER uuuuuuu
331 User name okay, need password.
EZA1789I PASSWORD:
EZA1701I >>> PASS
230 User logged in, proceed.
EZA1460I Command:
binary
EZA1701I >>> TYPE I
200 Type set to I.
EZA1460I Command:
LOCSITE LRECL=80 RECFM=FB BLKSIZE=27920
EZA1460I Command:
LOCSITE UNIT=SYSDA PRIMARY=5000 SECONDARY=300
EZA1460I Command:
get ebcVVRR.ebc 'MXG.MXGVVRR.EBC'
EZA1701I >>> PORT 199,14,219,100,6,229
200 PORT Command successful.
EZA1701I >>> RETR ebcVVRR.ebc
150 Opening BINARY mode data connection for ebcVVRR.ebc (128376160 by).
EZA1485I 8040960 bytes transferred.
...
EZA1485I 128152800 bytes transferred.
226 Transfer complete.
EZA1617I 128376160 bytes transferred 162 sec.
EZA1460I Command:
close
EZA1701I >>> QUIT
221 Goodbye!
EZA1460I Command:
quit
Appendix D. - MVS-Only Example, Download TERSEd file:
//DPTVVRR JOB WHATEVER WORKS,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//* This alternative is for those who have successfully used FTP JCL
//* to download MXG from the Merrill Consultants FTP server
//*--------------------------------------------------------------------
//* This two step job is all that is required to download and create
//* the MXG Sourclib PDS from the TERSEd file.
//*
//* STEP1 - FTP the TERSEd file from MXG ftp site to your mainframe.
//* STEP2 - Uncompress that downloaded file into new MXG PDS
//*
//* Site specific DSNs are specfied in GET command of STEP1 which
//* must be the same as input to STEP2
//* The DSNAME of your new Sourclib PDS is in STEP2
//*
//* LRECL should not be changed in STEP1 and must remain 1024
//*
//* This JCL is MiXeD case; do not number the lines of text.
//*
//* Addition info about TRSMAIN available from IBM
//* http://techsupport.services.ibm.com/390/trsmain.html
//*--------------------------------------------------------------------
//STEP1OF2 EXEC PGM=FTP,PARM='(EXIT=4'
//SYSPRINT DD SYSOUT=*,DCB=BLKSIZE=133
//SYSABEND DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//FTPOUT DD SYSOUT=*
//SYSIN DD *
111.222.333.444
uuuuuuu pppppppp
BINARY
LOCSITE LRECL=1024 RECFM=FB BLKSIZE=6144 UNIT=SYSDA
LOCSITE PRIMARY=5000 SECONDARY=300
GET terVVRR.ter 'MXG.MXGVVRR.TERSED' (replace CLOSE QUIT
//STEP2OF2 EXEC PGM=TRSMAIN,PARM='UNPACK'
//SYSPRINT DD SYSOUT=*,DCB=(LRECL=133,BLKSIZE=12901,RECFM=FBA)
//INFILE DD DSN=MXG.MXGVVRR.TERSED, <- File from FTP above
// DISP=SHR
//OUTFILE DD DSN=MXG.MXGVVRR.SOURCLIB, <- New MXG SOURCLIB PDS
// DISP=(NEW,CATLG,DELETE),
// UNIT=3390,DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
// SPACE=(CYL,(275,50,1199))
Appendix E. - MVS-Only Example, PKZIP for MVS unzip of ebcVVRR.zip:
If you cannot ftp direct to MVS, but you have PKZIP for MVS, you can ftp
the ebcVVRR.zip to your PC, as binary, passive mode, then upload to your
"MVS" system, binary, passive mode, and then use this JCL to unzip that file:
//ZIPIT01 EXEC PGM=PKUNZIP,
// PARM='-CALLMODE(BATCH)'
//STEPLIB DD DSN=OEM.PKWARE.RVV.LOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSIN DD *
-ACTION(EXTRACT)
-ARCHIVE(highlevel.ebcVVRR.zip)
-UNZIPPED_DSN(**,highlevel.EBCVVRR.UNZIPPED)
-OUTFILE_VOLUMES(volser)
-DATA_TYPE(BINARY)
-SAVE_LRECL(Y)
Then JCLINST job (IEBUPDTE) using the UNZIPPED file as //SYSUT1