This
site is for explicit use by Innovation Data Processing, its customers and
partners.
This document contains useful information describing the directory structure of the Innovation Data Processing FTP site, instructions on how to download from the site and upload to the site, also detailed instructions on how to IPL SAR from the Innovation Data Processing FTP site. Updated on-09/03/2010
If you encounter any problems using this site, please call us at (973) 890-7300 or send E-mail.
Select topic of interest from the following links:
Uploading
Files from mainframe
IPLing
SAR from FTP site or CD
Directory structure under /Public for downloads is as follows:
DOWNLOAD
IMASPZAPs and PTFs
MANUALS
Innovation Software Documentation
PRESENTATIONS
Product Presentations
NOTE(S): All other directories are protected. Unauthorized entry will cause errors and possibly force you to login again.
The DOWNLOAD directory is NOT used by the Innovation product delivery system. The delivery system’s E-mails will direct you to the location of the distribution product file.
1) Accessing FTP site from Innovation’s Web Page:
a)
On the FTP LOGIN web page, enter your access
code, and click on Login.
If you do not have an access code, click on “Register for FTP Site Access” on the
CUSTOMER TECHNICAL SUPPORT and FTP ACCESS web page to request one.
If you are NOT using the Innovation web site to access the Innovation FTP site, you will need to get an FTP USERID and PASSWORD from Innovation, please call us at (973) 890-7300 or send E-mail.
2) From the /Download directory, select the subdirectory for the desired product and version.
3) Locate the file that you wish to download.
4) Click on the file. Now depending on your browser, and your browser settings:
a) The file will be displayed, or
b) You will be asked to either “Open” it or “Save” it.
5) When the file is “Open”, go to “File” and do “Save As” (doing “Save” uses system default).
6) Select the location where you want the file to be saved to and click Save.
This completes the download section.
If your mainframe has an Internet connection that allows you to FTP files from the mainframe, you can FTP documentation files and other data directly from your mainframe to Innovation’s FTP site. If not, you can follow the instructions in this document for preparing the files, but then you will need to transfer the files to a PC or UNIX system with an Internet connection by using an FTP client. Skip to the section “Uploading files from PC” below.
PRINTABLE OR FIXED-FORMAT DATA FILES
Any files that contain HIPPA related data, sensitive or privileged data, large fixed-format binary files, such as SVC dumps and SYSMDUMPs, and large printable files should be compressed before transfer using the IBM program AMATERSE or TRSMAIN. If file compression does not meet your company’s security requirements, then connect to SFTP.FDRINNOVATION.COM (207.140.179.117), with an SSH client such as PSFTP or WinSCP. You cannot use a regular FTP client. The SFTP server is running GlobalSCAPE EFT Server Enterprise. Skip to the section “Compress the file” below.
You can get at Winscp http://winscp.net/eng/download.php or PSFTP(PSSFTP.EXE) at http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
If the file to be transferred contains only printable text, and is not too large (suggested 10 MB max), then you can transfer it directly, in ASCII mode, regardless of whether the records are fixed, variable, or undefined length. Examples of this type of file include SYSUDUMP/SYSABEND dumps, job listings, control statement files, and listings formatted by IPCS from SVC dumps and GTF traces. Skip to the section “Transfer the file with FTP” below.
If the file to be transferred is not printable text, but contains only fixed-length records (RECFM=F or FB), and is not too large (suggested 10 MB max), then you can transfer it directly, in binary mode.
Examples of this type of file include small SVC DUMPs. Skip to the section “Transfer the file with FTP” below.
VARIABLE-FORMAT AND UNDEFINED-FORMAT BINARY DATA FILES
Files that are not printable text, and contain variable-length or undefined-length records (RECFM=V or VB or U), cannot be transferred directly to our FTP site; you must convert them to a fixed format with the TSO TRANSMIT command or by using the IBM AMATERSE or TRSMAIN program before sending them. Examples of this type of file include FDR backups, binary GTF trace data, and programs.
For most such files, the IBM compression program is preferable since it will reduce the transfer time. Skip to the section “Compress the file” below.
For load modules, or for whole PDS’s including the directory, use the TSO TRANSMIT command. You can also use TRANSMIT if your system is at a lower level than z/OS 1.9, and you do not have TRSMAIN, and cannot install it quickly. Skip to the section “Prepare the file with TSO TRANSMIT” below.
AMATERSE is a file compression program that is included in z/OS 1.9 and above. TRSMAIN is an older version of AMATERSE that can be downloaded from the IBM web site for use on older systems. In addition to compression, AMATERSE or TRSMAIN converts the input file to a fixed-format binary file (RECFM=FB,LRECL=1024) and includes in the output file the information necessary to recreate the input file in its original format on another MVS system.
To get TRSMAIN to go IBM’s Web Page.
JCL Example:
//PACK EXEC PGM=TRSMAIN,PARM=PACK
//STEPLIB DD ..if required
//SYSPRINT DD SYSOUT=*
//INFILE DD DISP=SHR,DSN=inputdsn (If AMATERSE – SYSUT1)
//OUTFILE DD DISP=(,CATLG),DSN=outputdsn, (If AMATERSE – SYSUT2)
// UNIT=SYSALLDA,SPACE=(CYL,(300,125),RLSE)
Skip to the section “Transfer the file with FTP” at the bottom.
PREPARE THE FILE WITH TSO TRANSMIT
The TSO TRANSMIT command will take any file, in any format (including PDS members or whole PDS's), and convert it into a fixed-format binary file (RECFM=FB,LRECL=80) that can be FTPed. It includes in the output file the information necessary to recreate the input file in its original format on another MVS system, but it does NOT compress the data.
From TSO READY or ISPF Option 6, issue:
TRANSMIT X.X DA(‘inputdsn’) OUTDA(‘outputdsn’)
The “X.X” is required but is ignored.
“inputdsn” is the original MVS dataset. It can be any sequential file or a PDS (in which case TRANSMIT will invoke IEBCOPY to convert it to a sequential unloaded copy, then process that copy for TRANSMIT). If you omit the quotes, TSO will usually prefix it with your TSO USERID.
“outputdsn” is the dataset to be created in TRANSMIT format. It does not need to exist; TRANSMIT will allocate it. If you omit the quotes, TSO will usually prefix it with your TSO USERID.
From TSO READY or ISPF Option 6, enter the TSO command:
ftp ftp.fdrinnovation.com
When it prompts you for NAME, enter “anonymous”. When it prompts you for PASSWORD, enter your email address.
At this point, you should see:
>>> USER anonymous
331 Anonymous access allowed, send identity (email name) as password.
>>> PASS
230-WELCOME TO THE INNOVATION DATA PROCESSING FTP SITE
Followed by a screen full of welcome and instructive information and then:
230 User anonymous logged in.
Command:
During login you will be placed into our /UPLOAD directory and will have only WRITE access to this directory, not READ.
If you are transferring a binary file, including any file that has been prepared with AMATERSE, TRSMAIN or TRANSMIT, enter the command
binary
NOTE: If you are directly transferring a printable file, enter the command, “ascii” or allow it to default to ASCII.
Use the PUT subcommand to transfer your file(s) to the /UPLOAD directory:
put ‘mvs.file.name’ ftp.file.name
Remember that if you omit the quotes around the MVS file name TSO will usually prefix it with your TSO USERID.
NOTE: Please do NOT use blanks or QUOTES in the FTP file name.
Go to the section “finished” at the bottom.
FTP FILENAMES
Your Innovation representative will probably give you guidance on the output file names to use. Innovation uses an automated process to retrieve files from the FTP server. Filenames that follow the guidelines can be automatically retrieved with fewer errors almost as soon as they are placed on the server. If viewing the file requires a mainframe utility, like IPCS please do not ZIP the file or create a subdirectory under /UPLOAD containing the data.
Files with the following suffixes as part of the file name will be downloaded and allocated using default attributes.
|
Suffix |
Description |
TYPE |
RECFM |
LRECL |
BLKSIZE |
|
.txt |
Printable files |
ASCII |
No default |
No default |
N/A |
|
.trs |
Files prepared with AMATERSE or TRSMAIN |
BIN |
FB |
1024 |
N/A |
|
.xmi or .xmit |
Files prepared with TSO TRANSMIT |
BIN |
FB |
80 |
N/A |
|
.bin |
Other fixed-format binary files |
BIN |
No default |
No default |
No default |
|
.sdmp or .mdmp |
svcdump or sysmdump |
BIN |
FBS |
4160 |
|
Separate indexes with underscores or periods. Max length of each index is 8
characters. Please
do NOT use blanks or QUOTES in the FTP
file name.
One of the indexes should be an identifier (the USERID or name of the Innovation technician working on your problem, or the problem number (Call Log Number), or your company number preceded by a number sign (#) so that we can identify who the file is for or where it came from. For reasons of confidentiality and privacy, please do not include your company name in the file name. Every Innovation customer has a 6-digit company number; if you wish, you can use your company number, preceded by a number sign (#), as the second index level of the file name. If you do not know your company number, your Innovation representative can give it to you.
Examples:
Text.bruceb.fdrjob.sysout.data.txt
trsmain_L5402_fdrjob_stuff.trs
sysudump_#789012_depot_fdrdmp.txt
terse_#123654_s878.trs
If the allocation attributes cannot be inferred from the suffix listed above, you should include any or all of the following in the FTP file name to insure that the MVS allocation will be successful:
LR_???? or LRECL_????
BLK_???? or BLKSIZE_????
RFM_???? or RECFM_????
Examples:
fdr_report_recfm_vb_lrecl_255_blk_3120.txt – will be allocated with LRECL=255, RECFM=VB, BLKSIZE=3120, and downloaded (using ascii)
Uploading to the Innovation Data Processing’s FTP site, you must login as anonymous using a FTP client or command prompt window.
Open a command prompt window to execute FTP:
ENTER- ftp ftp.fdrinnovation.com
- anonymous
- your email address (example: smith@cbs.com)
- binary (skip this step if you uploading a text file)
- put filename.ext (file will be put into our /Upload directory)
If you have multiple files to transmit, use multiple PUT commands.
Finally, enter “quit” to end the FTP connection.
Then call us at (973) 890-7300 or send an E-mail to tell us the name(s) of the file(s) that you have created and which site you uploaded to FTP.fdrinnovation.com or SFTP.fdrinnovation.com. It will be very helpful to us if you also tell us the name(s) of the original file(s) on the MVS host, and their original attributes (number of tracks/cylinders allocated, DSORG, RECFM, LRECL, and BLKSIZE), as well as the number of tracks/cylinders allocated for the file created by AMATERSE, TRSMAIN or TRANSMIT, if used. If you send an E-mail, please address it to the person working on the problem.
A specially formatted version of SAR can be IPLed from a CD or from a FTP site using a special load function on the HMC (Hardware Management Console) of your system. Note that IPLing from FTP requires that the SE (the Support Element inside your processor that controls its operation) must be connected to the Internet and must be able to contact the FTP site without interference from a firewall.
All Innovation documentation CDs created since September 2005 contain an IPLable copy of SAR in the root directory (the version of SAR current at the time the CD was created). The Innovation FTP site also contains the current SAR).
To IPL from the CD or FTP use your HMC to:
1) Select “Groups”, then select “Defined CPCs”
2) On the CPC Recovery menu, select “Single System Operations” then select the CPC containing the image (LPAR) on which SAR is to be loaded; this opens a screen with a HMC session for the SE (Support Element) for that CPC. This step is not necessary on an MP3000.
3) Select the image (LPAR) that you want to load. Activate the LPAR if necessary.
4) Go to the CPC Recovery menu for the SE
5) Select "Load from CD-ROM or Server"
6) For the CD, select the HMC CD-ROM drive as the source and insert the CD
7) For FTP, select FTP Server as the source, enter “207.140.179.17” as the host computer, “saripl” as the userid, and “saripl” again as the password
8) A list of available programs will appear. Select SAR.INS by selecting OK, and then select OK for all subsequent requests.
9) Continue with “Step 3” of the IPL procedures below.
If you do not have a documentation CD and cannot use FTP from your SE, you can access the Innovation FTP site from any PC, copy the SAR files to a CD, and use the CD to IPL:
1) Use your PC FTP client program to access ftp.fdrinnovation.com or IP address “207.140.179.17”
2) Use “saripl” as the userid and also the password
3) Copy files “sar.ins” and “SAR.IPL” to a CD
4) Follow the IPL instructions above
Here is the Step 3 referenced above:
When the IPL successfully completes, the processor should enter a wait state with a code of X 'FFFF’ in the last two bytes of the PSW indicating SAR is waiting to identify a console. At this time you can select the SAR console by pressing the ENTER key on a display console.
However, if the CONSOLE UNIT was specified via FDRSARLR (Section 15.22), the operator messages will automatically appear on the console specified, if it is available and if it responds to console commands. If more than one console unit address was specified, each will be tried in turn. If none of the specified consoles responds, SAR acts as if no console unit was specified.
SAR IPL STEP 4
The SAR menu, showing the default options, will now appear on the console, and the cursor will be positioned to the first option. For each option, you must press ENTER to accept the default or overtype the default with the desired value and press ENTER. If the response is valid, SAR will position the cursor to the next response. SAR will display a line of valid responses for the current option. The process option messages are detailed in Section 15.04.
NOTE: SAR does not operate in true full screen mode. Do not use the cursor keys to move around the screen. In addition, the ERASE EOF key is not supported; if the remainder of a line is to be blanked out, it must be done using the space bar.
IT IS ALWAYS NECESSARY TO PRESS
ENTER ONCE FOR EACH OPTION THAT THE CURSOR POSITIONS TO, WHETHER OR NOT THE
DEFAULTS ARE ACCEPTED.
You can configure SAR to bypass some or all of the options, accepting the preset defaults without prompting. See member $$SAR in the FDR ICL (Installation Control Library) for details.
SAR IPL STEP 5
All devices needed for this execution should be available and ready. You may pre-mount Input or output tape volumes if you like, or SAR will prompt you to mount them when required.
SAR IPL STEP 6
The DUMP, RESTORE, or CLIP will begin when all of the processing options have been specified. Successful conclusion of the requested function will be indicated by an “FDR999 SAR SUCCESSFULLY COMPLETED” message. Other conditions are indicated by appropriate messages to the operator console and hardcopy device.