INNOVATION DATA PROCESSING logo

Welcome
to the
INNOVATION DATA PROCESSING
FTP Site

This site is for exCLUSIVE use by INNOVATION DATA PROCESSING, its Customers and Partners.

This document contains useful information on the directory setup of the INNOVATION FTP site, instructions on how to upload files to the INNOVATION FTP site, and instructions on how to IPL SAR from the INNOVATION FTP site.

Last updated: Thursday, November 2, 2017 1:52 PM

Contents

FTP Directory Structure

FTP File Download Instructions

Upload Files from a PC

Upload Using Secure File Transfer

Upload Files with FTP from z/OS Host

Notify INNOVATION at Completion of Upload

FTP Filenames

Naming Standards

Determine the IP Address of the FTP Server

IPL SAR from INNOVATION's FTP Site or Removable Media

FTP Directory Structure

The high-level directories are used for INNOVATION product specific information (e.g. fdr, fatscopy, iam) or for FTP specific functions (e.g. service, pdistr).

INNOVATION Product Directories

The high-level directories related to INNOVATION products are:

* cld CloudVTB
* fdr FDR related products
* fatscopy FATS related products
* iam IAM related products
* fdrpas FDRPAS, FDRMOVE, and FDRERASE
* fdrpasvm FDRPASVM
* upstream/zserver UPSTREAM zServer
* upstream/reservoir UPSTREAM Reservoir
* upstream/client UPSTREAM Clients

Subdirectories within these 1st level directories may include these directories (depending on the product):

* service Folders with product specific maintenance
* service / VnnLmm Version specific service and information
* service / other Generic information, maintenance (e.g. zaps, PTFs, executables)
* documentation INNOVATION software documentation distributed on DVD
* documentation/other Product presentations, help files, FYI documents, EOS versions
* icl Installation Control Library members
* jcl Job Control Library members
* webportal Used by UPSTREAM for Web Portal
* cloudvtbserver Used by CloudVTB for installation files

FTP Specific Directories

These directories are protected and require unique userid access as they are used for specialized functions.  Unauthorized entry will cause errors and possibly force you to login again or be locked out.

* upload Files uploaded by customers for use by INNOVATION staff (e.g. dumps, output listings).  Requires login using userid "anonymous" and only has write access.  The directory is not accessible when accessing the FTP site via the FTP login at http://www.fdr.com.
* itemp For European and other INNOVATION partners for their customer’s usage.  These files are only kept for 7 days.

Unauthorized access attempts will cause errors and possibly force you to login again or be locked out.

If you encounter any problems, please give us a call at (973)890-7300 or send an e-mail to: support@fdrinnovation.com.

FTP File Download Instructions

  1. From the INNOVATION DATA PROCESSING web site, click on the Customer Login link in the upper left of any page on the web site.
    Quicklinks Menu
  2. On the CUSTOMER LOGIN web page, select either FTP LOGIN or HTTPS LOGIN, enter your access code and click the Login button.  You are now logged into the INNOVATION FTP site (ftp://idp1.fdrinnovation.com) or the INNOVATION HTTPS site (https://idp2.fdrinnovation.com).  If you do not have an access code, click on the Register for Customer Site Access link to request one.
    Customer Login
  3. Select the directory of the desired product.
  4. Next, select the subdirectory for the type of data you wish to download (e.g. service for maintenance, documentation for manuals).
  5. Locate the file that you wish to download.
  6. Click on the file.  Depending on your browser and your browser settings:
    • The file is displayed, or
    • You are asked to either Open it or Save it.
  7. When the file is "Open", go to "File" and do "Save As"; (doing "Save" uses the system default location for the save).
  8. Select the location where you want the file saved and click Save.

This completes the file download section.

Upload Files from a PC

Please read this entire document before transferring information to the INNOVATION DATA PROCESSING FTP server.

Any files that contain HIPAA related data, sensitive, or privileged data should be uploaded with SFTP for greater security, instead of regular FTP.  If your company's security requirements require this type of transfer, go to the section "Upload Using Secure File Transfer".

Option 1 (HTTP Web Transfer Client):

Open Internet Explorer, Click on Tools ->, Compatibility view settings.  Add website idp1.fdrinnovation.com, click Add, and click Close

In the browser window type: http://idp1.fdrinnovation.com:8050

Username:  anonymous

Password:  **your*email*address**  (ex: jsmith@abc.com)

Option 2 (FTP Client on a PC):

To upload to INNOVATION’s FTP site (idp1.fdrinnovation.com), you must login using userid anonymous using an FTP client or command prompt window.  You must use a 3rd party FTP access software or know how to use the FTP commands from a command prompt.

Open a command prompt window to execute FTP:

ftp idp1.fdrinnovation.com

At this point, you should see:

Connected to idp1.fdrinnovation.com.
220-WELCOME TO THE INNOVATION DATA PROCESSING FTP SITE
220-This site is for exclusive use by Innovation Data Processing, its customers and partners.
220-Please read the information found in this link before using this site.
220-http://idp1.fdrinnovation.com/webi/navftp.html
User (idp1.fdrinnovation.com:(none)):

When it prompts for a USER, enter anonymous.

User (idp1.fdrinnovation.com:(none)): anonymous
331 Password required for anonymous.

When it prompts for a PASSWORD, enter your email address.

331 Password required for anonymous. **your*email*address**  (ex: jsmith@abc.com)
230 Login OK. Proceed.
ftp>

You will only have 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

If you are directly transferring a printable file, enter the command, "ascii" or allow it to default to ASCII.

Review the “FTP Filenames” section to determine the target file name to specify.  Then use the PUT subcommand to transfer your file(s):

put file.name **target*file*name**

Do NOT use blanks( ), minus(-), plus(+) or quotes(') in the file name.

If you have multiple files to transmit, use a separate PUT command for every file.

Finally, enter quit to end the FTP process.

This is an example of an FTP session to transfer an FDREPORT listing saved as file fdreport_listing.txt in the /documents directory on the PC and uploaded to the FTP site as fdreport_#123456_listing.txt in ascii format.  The command line prompt displays the local directory that you are in.  If not in the correct directory, use a cd command to get into the directory where your file exists.

C:Users\userid> cd documents

C:Users\userid\Documents> ftp idp1.fdrinnovation.com
Connected to idp1.fdrinnovation.com.
...
User (idp1.fdrinnovation.com:)): anonymous
Password:
230 Login OK. Proceed.
ftp> ascii
200 Type set to A.
ftp> put fdreport_listing.txt fdreport_#123456_listing.txt
200 Command okay.
150 Opening ASCII mode data connection for fdreport_#123456_listing.txt.
226 Transfer complete. 19321 bytes transferred. 19321 bps.
ftp: 19321 bytes sent in 0.03Seconds 568.26Kbytes/sec.
ftp> quit

This completes the upload files section.  Continue to the Notify INNOVATION at Completion of Upload section.

Upload Using Secure File Transfer

Secure File Transfer is a separate protocol packaged with SSH that works over a secure connection.  This should only be used if your corporation or business requires this type of connection for transmitting data.

Option 1 (HTTPS Web Transfer Client):

Open Internet Explorer, Click on Tools ->, Compatibility view settings.  Add website idp2.fdrinnovation.com, click Add, and click Close

In the browser window type: https://idp2.fdrinnovation.com

Username:  anonymous

Password:  **your*email*address**  (ex: jsmith@abc.com)

Option 2 (SSH Client on PC):

If you cannot use HTTPS and need to use SSH2 (requires a client such as CuteFTP or WinSCP (http://winscp.net/eng/download.php), our Secure FTP server is idp2.fdrinnovation.com (IP address 207.140.179.116 Port 22

Login credentials same as Option 1.

Option 3 (OpenSSH Client on Mainframe):

If you want to transfer directly from your z/OS system. You will need IBM Ported Tools for z/OS OpenSSH support or some other product that supports OpenSSH.

Login credentials same as Option 1.

Upload Files with FTP from z/OS Host

Please read this entire document before transferring information to the INNOVATION DATA PROCESSING FTP server.

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, follow the instructions in this document for preparing the files; you then need to transfer the files to a PC or UNIX system with an Internet connection and use an FTP program to transfer them from there.

Printable or Fixed-Format Data Files

Any files that contain HIPAA 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 (go to section "Compress the File").  If file compression does not meet your company’s security requirements, the files need to be transferred using a secure file transfer.  After compressing any large files (for space and transfer savings), go to section "Upload Using Secure File Transfer".

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 section "Transfer the File with FTP".

If the file to be transferred is not printable text, 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".

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 the IBM program AMATERSE or TRSMAIN before sending them.  Examples of this type of file include FDR backups, binary GTF trace data, and programs.

For most of these types of files, the IBM compression program AMATERSE or TRSMAIN is preferable since it reduces the transfer time.  Skip to the section "Compress the File".

For load modules, or for whole PDS’s including the directory, use the TSO TRANSMIT command.  If your system is older than z/OS 1.9 (z/OS 1.9 and above includes AMATERSE), and you do not have TRSMAIN and cannot install it quickly, skip to the section “Prepare the File with TSO TRANSMIT”.

Compress the File

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 website for use on older systems.  In addition to compression, AMATERSE and TRSMAIN convert 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 z/OS system.

To get TRSMAIN, go to IBM’s TRSMAIN Utility Web Page.

To compress a file with AMATERSE (or TRSMAIN), use JCL similar to:

//PACK     EXEC  PGM=AMATERSE,PARM=PACK          (or PGM=TRSMAIN)
//SYSPRINT DD  SYSOUT=*
//SYSUT1   DD  DISP=SHR,DSN=inputdsn             (if TRSMAIN use INFILE)
//SYSUT2   DD  DISP=(,CATLG),DSN=outputdsn,      (if TRSMAIN use OUTFILE)
//             UNIT=SYSALLDA,SPACE=(CYL,(300,125),RLSE)

For TRSMAIN, add a STEPLIB if needed.

Skip to section "Transfer the File with FTP".

Prepare the File with TSO TRANSMIT

The TSO TRANSMIT command takes any file, in any format (including PDS members or whole PDS's), and converts it into a fixed-format binary file (RECFM=FB,LRECL=80) that can be FTP’d.  It includes in the output file the information necessary to recreate the input file in its original format on another z/OS system, but it does NOT compress the data.

From TSO READY or ISPF Option 6, issue:

TRANSMIT x.x DA('inputdsn') OUTDA(outputdsn)

Skip to section “Transfer the File with FTP”.

Transfer the File with FTP

From TSO READY or ISPF Option 6, enter the TSO command:

ftp idp1.fdrinnovation.com

At this point, you should see something similar to this:

EZA1450I IBM FTP CS
EZA1554I Connection to: idp1.fdrinnovation.com 207.140.179.16 port: 21.
220-WELCOME TO THE INNOVATION DATA PROCESSING FTP SITE
220-This site is for exclusive use by Innovation Data Processing, its customers and partners.
220-Please read the information found in this link before using this site.
220 http://idp1.fdrinnovation.com/webi/navftp.html
EZA1459I NAME (idp1.fdrinnovation.com:user):

When it prompts for a NAME, enter anonymous .

EZA1459I NAME (idp1.fdrinnovation.com:user):
anonymous
EZA1701I >>> USER anonymous
331 Password required for anonymous.
EZA1789I PASSWORD:

When it prompts for a PASSWORD, enter your email address.

EZA1789I PASSWORD:
**your*email*address**  (ex: jsmith@abc.com)
EZA1701I >>> PASS
230-Login OK. Proceed.
EZA1460I Command:

You will only have 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

If you are directly transferring a printable file, enter the command, "ascii" or allow it to default to ASCII.

Review the “FTP Filenames” section to determine the target file name to specify.  Then use the PUT subcommand to transfer your file(s):

put 'zos.file.name' **target*file*name**

Remember that if you omit the quotes around the z/OS file name TSO usually prefixes it with your TSO userid.  If you use quotes, then you must use the second operand of the PUT command to remove them from the file that gets uploaded.

Do NOT use blanks( ), minus(-), plus(+) or quotes(') in the second operand of the PUT command.

This is an example of an FTP session using the READY prompt to transfer a file prepared by TRSMAIN and saved as file FDR.S0C1.TERSED on the mainframe.  This file is uploaded to the FTP site as fdr_#123456_s0c1.trs in binary format.

READY
ftp idp1.fdrinnovation.com
EZA1450I IBM FTP CS VnRnn
EZA1554I Connecting to: idp1.fdrinnovation.com 207.140.179.16 port: 21.
...
EZA1459I NAME (idp1.fdrinnovation.com:user): anonymous
EZYA1701I >>> USER anonymous
331 Password required for anonymous.
EZA1789I PASSWORD:

EZA1701I >>> PASS
230 Login OK. Proceed.
EZA1460I Command:
binary
EZA1701I >>> TYPE I
200 Type set to I.
EZA1460I Command:
put 'fdr.s0c1.tersed' fdr_#123456_s0C1.trs
EZA1701 >>> PORT 192,168,250.nnn.nnn.nnn
200 Command okay.
EZA1701I >>> STOR fdr_#123456_s0c1.trs
150 Opening BINARY mode data connection for fdr_#123456_s0c1.trs
226 Transfer complete. 29777280 bytes transferred. 29777280 bps.
EZA1617I 29777280 bytes transferred in 0.430 seconds. Transfer rate 69249.44 K bytes/sec.
EZA1460I Command:
quit
EZA1701I >>> QUIT
221 Service closing control connection.

This completes the file transfer section.  Continue to the Notify INNOVATION at Completion of Upload section.

Notify INNOVATION at Completion of Upload

When the UPLOAD has completed, send an e-mail to support@fdrinnovation.com.  Please provide us with:

  1. A point of contact:
    • Name,
    • Company, and
    • Phone Number
  2. Which site you uploaded the file(s) to:
    • idp1.fdrinnovation.com
    • idp2.fdrinnovation.com
  3. The file name(s) and associated file information that was/were uploaded:
    • The original file name(s) on the z/OS host
    • The original file attributes(s) (e.g. number of tracks/cylinders allocated, DSORG, RECFM, LRECL, and BLKSIZE)
    • The number of tracks/cylinders allocated for the file(s) created by AMATERSE, TRSMAIN, or TRANSMIT, if used
    • The name of the uploaded file on the FTP site

Do NOT use blanks( ), minus(-), plus(+) or quotes(') in the file name.

This completes the file upload section.

FTP Filenames

Do NOT use blanks( ), minus(-), plus(+) or quotes(') in the file name.

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 in the /UPLOAD directory containing the data.

These file types are disallowed for upload to the FTP server:

Extension Description
.bat Batch file
.com Command
.exe Directly executable program
.js JavaScript file
.jse JavaScript executable file
.msh Mesh file
.msh1 Microsoft shell script file
.msh1xml Windows power shell script file
.msh2 Microsoft shell script file
.msh2xml Microsoft powershell script file
.mshxml Microsoft XML typedata file
.pif Program information file
.ps1 PowerShell script
.ps1xml PowerShell file
.ps2 Windows Shell script file
.ps2xml PowerShell file
.psc1 PowerShell console file
.psc2 PowerShell script file
.reg OLE registration file
.scr

Script file source

.vb Visual basic .Net source file
.vbe VBScript encoded script file
.vbs VBScript script file
.ws Web site
.wsc Windows script components
.wsf Windows script file
.wsh Windows script host

Files with the following suffixes as part of the file name are 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 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.  The maximum length of each index is 8 characters.

Do NOT use blanks( ), minus(-), plus(+) or quotes(') in the file name.

One of the indexes should be your company number preceded by a number sign "#" so that we can identify whom the file is for and 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.  In one of the levels you should also indicate what INNOVATION product group that this problem is with.  The choices are:

Product Group
CLOUDVTB
FATSCOPY
FDR
FDRERASE
FDRPAS
FDRSOS
IAM
UPSTREAM

Examples:

trsmain_#013579_fdr_stuff.trs

sysudump_#089012_iam.txt

terse_#123654_fats_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 filename to insure that the z/OS allocation will be successful:

LR_????     or    LRECL_????

BLK_????    or    BLKSIZE_????

RFM_????    or    RECFM_????

Example:

fdr_report_recfm_vb_lrecl_255_blk_3120.txt

Will be allocated with LRECL=255, RECFM=VB, BLKSIZE=3120, and downloaded (using ascii)

Naming Standards

Directories in /service Directory

The /service directory in each of the product directories contains directories identified by the product version and level.  Within these directories are the files related to that specific product version and level.  The format of the names for these directories is:

vnnlmm

Where:

nn           is the 2-digit product version

mm         is the 2-digit product level

Documentation

INNOVATION naming standards for files in the documentation folder exist so that customers and INNOVATION staff can locate the most current documentation.  The product manual names are in the format:

product_Vversion_title(mmm_dd_yyyy).type

For example:

FDR_V54L83_Volume_1(Jun_08_2015).pdf

IAM_V92_Install_Supplement(Feb_29_2014).pdf

FATSCOPY_V49L29_How_To_Guide(Jan_05_2015).pdf

Other documentation (e.g. Share presentations) may be named as appropriate for the document.  No BLANKS are permitted in the file name.

Determine the IP Address of the FTP Server

There may be circumstances when the Host Name (idp1.fdrinnovation.com) cannot be located either because the computer you are using is not setup for DNS lookup or because of corporate firewalls.  In these cases, you will need to specify the IP Address instead of the Host Name.  The IP address of the INNOVATION FTP server is 207.140.179.16.  However, if this IP address does not work, this is a method to determine the Host Name.

From a command prompt, type NSLOOKUP idp1.fdrinnovation.com
At this point you should see something like:

Server:  google.com
Address:  8.8.8.8

Non-administrative answer:
Name:    idp1.fdrinnovation.com
Address:  207.140.179.16

IPL SAR from INNOVATION's FTP Site or Removable Media

A specially formatted version of SAR can be IPLed from an FTP site or removable media 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) to connected to the Internet and must be able to contact the FTP site without interference from a firewall.

All INNOVATION documentation DVDs created since September 2005 contain an IPLable copy of SAR in the root directory (the version of SAR current at the time the DVD was created).  If you received the distribution on a DVD, that DVD also contains an IPLable copy of SAR in the root directory. The INNOVATION FTP site also contains the current SAR.

IPL SAR from FTP or Removable Media

To IPL from FTP or Removable Media, use your HMC to:

  1. Select "Groups", then select "Defined CPCs".
  2. Select the image (LPAR) that you want to load.  Activate the LPAR, if necessary.
  3. On the CPC Recovery menu, select "Load from Removable Media or server".
    • For a CD/DVD, select the HMC CD-ROM/DVD drive as the source and insert the media.
    • For FTP, select FTP server as the source, enter "idp1.fdrinnovation.com" as the host computer, "saripl" as the userid, and "S@ripl$1" as the password.  If the HMC cannot find idp1.fdrinnovation.com, refer to section Determine the IP Address of the FDR Server to determine the IP address and enter this value instead.
  4. A list of available programs appear.  Select SAR.INS as the program to load and it will IPL!
  5. Continue with "SAR IPL Step 3" of the SAR IPL procedure.

If you do not have a documentation DVD or distribution DVD and cannot use FTP from your HMC, you can access the INNOVATION FTP site from any PC to copy the SAR files to a CD/DVD and use the CD/DVD to IPL:

  1. Use your PC FTP client program to access idp1.fdrinnovation.com if your FTP client program cannot find idp1.fdrinnovation.com, refer to section Determine the IP Address of the FDR Server to determine the IP address and enter this value instead.
  2. Use "saripl" as the userid and "S@ripl$1" as the password.
  3. Copy files "sar.ins" and "SAR.IPL" to a CD/DVD.
  4. Follow the IPL SAR from FTP or Removable Media instructions above.

SAR IPL Step 3

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.

The following paragraph appears in the manual as part of the general procedure for SAR IPL, but does not apply to the case of IPL from FTP or Removable Media.

However, if the CONSOLE UNIT was specified via FDRSARLR (see Section 15.22), the operator messages 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 is 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, appears on the console, and the cursor is 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 positions the cursor to the next response.  SAR displays a line of valid responses for the current option.  The process option messages are detailed in Section 15.04 of the FDR manual.

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 begins when all of the processing options have been specified.  Successful conclusion of the requested function is indicated by an "FDR999 SAR SUCCESSFULLY COMPLETED" message.  Other conditions are indicated by appropriate messages to the operator console and hardcopy device.

This concludes this document.