FTP'ing Data to Lexonix Technologies
Introduction
This page provides details on using the common IBM FTP program to FTP binary data off your local MVS mainframe to the Lexonix Technologies anonymous FTP site, FTP.Lexonix.com.
General Notes:
- The Lexonix anonymous FTP userid provide send-only access to the Lexonix Technologies FTP site. You will not be able to list or retrieve the Lexonix Technologies receiving directory and files -- this is to assure security to our customers who may be sending data.
- The login password for the anonymous site is strictly arbitrary -- we prefer that you use your email address (i.e. user@node) as the password.
- The Lexonix.com FTP site is a Unix server. As such character case (upper/lower) is significant for selecting the correct director/folder and output file name.
- Some customer sites employ a firewall for direct shipment of FTP data while others have no firewall or require their employees to store-n-forward data from behind the firewall to an interim node outside the firewall before then shipping it on to an outside FTP site. Please verify the type of FTP setup your company employs -- we have provided instructions for either case.
General Instructions
The following is the specific information you will need to log into the Lexonix Technologies FTP site. Its use may vary with whether and how your company has implemented its firewall.
| Host: | ftp.lexonix.com |
| User: | anonymous@lexonix.com |
| Password: | user@node |
Notes:
- Use your own email address as the "password" in place of user@node above.
- If you require an IP address instead of our site's URL value, our IP address is: 216.120.233.228
The following are the typical parameters for the IBM FTP job's INPUT DD file.
| Non-Firewall Parameters | Firewall Parameters |
|---|---|
| ftp.lexonix.com | anonymous@lexonix.com@ftp.lexonix.com user@node |
| anonymous@lexonix.com | |
| user@node | |
| CD incoming | CD incoming |
| TYPE I | TYPE I |
| PUT 'originfile' destfile | PUT 'originfile' destfile |
| QUIT | QUIT |
Notes on the parameters:
- If you get an error in the FTP job log indicating that the directory "incoming" is not recognized then you have probably failed to log onto the Lexonix site.
- The firewall version includes the first three parameters of the non-firewall version in the first parameter sent. You may also be required to login to your local firewall software before initiating these parameters and that login typically is an additional INPUT parameter prior to those shown above.
- Remember to use your email address in place of user@node
- originfile should be replaced by the data set name you are sending as known by your local system.
- destfile is the filename under which you will be depositing your data onto the Lexonix FTP site. We suggest you use a descriptive filename with company name and content indicated in the name. Any Unix/Windows filename is acceptable.
- If you have multiple files to send simply repeat the "PUT" parameter line for each file you wish to send. Remember to use different destfile filenames on each file you are sending. You can include as many "PUT" lines in your input parameter list as you wish.
- If you get an error message indicating that the "incoming" directory is not available then you are not connected to the correct FTP node. This is usually due to an error logging in and through your local firewall.
Sample FTP JCL for IBM's FTP Job
The following is a sample FTP JCL and job parameters for sending data to Lexonix from a firewall-protected site.
//... JOB (123456,xxx)
//* ftp file transfer protocol
//FTPSTEP EXEC PGM=FTP,PARM='FIREWALL'
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*,DCB=BLKSIZE=133
//INPUT DD *
anonymous@lexonix.com@ftp.lexonix.com myname@mycompany.com
CD /incoming
TYPE I
put 'input.data.set.name' outputname.bin
quit
//
Additional Information for Sending Raw SMF Data
If you are asked to send raw SMF data, you should include the line "LOCSITE RDW" in the INPUT parameters after the "TYPE I" parameter. This will send the SMF raw record images with the RDW field preserved. Without this parameter the SMF data is more difficult to process.