FTP From MFRM to Windows: Check for the input file ...

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Hi,
I have to FTP a mainframe file to windows server. I have to prepare an FTP job which can also track the return code of FTP. I mean to track whether the FTP got successful or not. I raised this question in this forum few days ago in the following link - http://ibmmainframes.com/viewtopic.php?t=35022.
As suggested by Superk and Robert (I believe), I used the EXIT parameter to trap the FTP code. But now the problem is -
Suppose, you have misspelled a filename in mainframe and you have to FTP that very file to windows server. I wish to trap this error but my existing JCL fails to do so. For clarity, I am sending you the JCL I am using -

Robert Sample · Posted: Wed Oct 15, 2008 11:00 pm

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Thanx Rober for your quick reply ...
The original file whose name I changed to do the test. I am not very much aware of the fact but is it possible that even if I miss-spelled the file name, the job will pick up the file present in that particular label mentioned in the job?

Robert Sample · Posted: Wed Oct 15, 2008 11:45 pm

Since the tape is labeled, the file name in JCL must match the file name on tape or the job won't run -- if the tape were unlabeled you wouldn't get that check. I don't remember the abend that is generated but the job definitely doesn't run.

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

OK! The original name of the tape file was - SYS3.QPP1D.ARCH.D08154.T123242.F01 and I changed the second qualifier only to TESTD. So the new name (manipulated) becomes - SYS3.TESTD.ARCH.D08154.T123242.F01. And after FTP, I checked in the server and I found that the information that has been FTPed, belong to the original file. Am I missing something?
And I also checked in repository (A dump of CA tool, I believe; I don't know the name) and found that there is no file with the name SYS3.TESTD.ARCH.D08154.T123242.F01. Robert again, am I missing something? Why does it happen to me?

Robert Sample · Posted: Thu Oct 16, 2008 12:12 am

All I can say is that 37,935 bytes were transferred from somewhere ... check the JESMSGLG for the job and see if the file name shows up.

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

I checked the JESMSG and it is saying the following -

dick scherrer · Posted: Thu Oct 16, 2008 2:23 am

Hello,

What i believe you are missing is that on tape only the last 17 bytes of the dsn were used to identify the dataset. . .

You changed something early in the dsn. Try your test again changing the last bit of the dsn instead.

Robert Sample · Posted: Thu Oct 16, 2008 3:23 am

Good catch, dick -- I used to use that a lot but haven't had to work much with tape dataset names lately!

gcicchet · Posted: Thu Oct 16, 2008 5:59 am

Hi,

if the dataset is cataloged, then just specify the dataset name and disposition.

This should result in a JCL error if dataset is mispelled.

Gerry

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Hey thanks Dick and Robert! But I have a question - How did you (Dick) find the fact that the last 17 bytes of the dsn were used to identify the dataset. How did you get to know this? This is just for my curiosity ...

By the way, I assumed a scenario that while FTPing a file from mainframe to windows server, suppose the connection got lost. What will happen then? Do I receive a non-zero return code? Hope u r getting what I wish to mean ...

Robert Sample · Posted: Thu Oct 16, 2008 6:30 pm

In the DFSMS bookshelf, there's a manual called Using Magnetic Tape. In this manual is laid out the format of the various tape labels. Part of the description is:

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Hey Robert, thanks a lot man! Hey dnt mind - I wish to get a confirmation/ suggestion from you.
As you mentioned earlier while FTPing a file if the connection is lost, we will receive a JCL RC. So we no need to take care of that issue seperately if I code the following -

Robert Sample · Posted: Thu Oct 16, 2008 6:44 pm

Correct -- the (EXIT causes the JCL return code to be set based on what the FTP commands do.

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Thanks a lot Robert ...

dick scherrer · Posted: Thu Oct 16, 2008 7:10 pm

Hello,

Robert Sample · Posted: Thu Oct 16, 2008 7:17 pm

Glad to help dick ... it doesn't seem to be well-known but the 17-character tape name limit can be quite helpful at times.

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Hey I am back

- Obviously again with a question (May sound to u little silly)! Guys suppose I receive a JCL RC = 1954, how can I calculate the FTP return code from this?
And guys do you know any site where different FTP return-codes are listed down?

Robert Sample · Posted: Thu Oct 16, 2008 8:27 pm

I don't know that you can go from a JCL return code to an FTP code since multiple FTP codes could map to a single JCL return code. The FTP code is actually a two-byte FTP subcommand code followed by the 3-byte FTP reply code. In the Communications Server bookshelf, the IP User's Guide and Commands manual gives the FTP subcommand codes while the IP and SNA Codes manual contains the FTP reply codes. The FTP reply codes are pretty much dictated by the RFC document and are standard across platforms, although there can be some differences in wording for given reply codes.

As I said earlier, the FTP subcommand code and reply code are concatenated together to form a 5-digit number. This number is then converted into a JCL return code by dividing by 4096 and taking the remainder. If you have 1954 as a JCL return code, you don't know how many times 4096 was removed from the FTP code to get 1954. If I had to guess, I'd say 26530 was the FTP code -- PASS command had some error generated.

jain.eti · New User Joined: 23 Jan 2007 Posts: 25 Location: delhi

Thanks a lot Robert

Pedro Bravo · New User Joined: 30 Mar 2011 Posts: 3 Location: Mexico

Hi, I saw the answer about 27426 (5 digits) return code. In other case I've the 2934 (4 digits) JCL RC. Can you help me to kwon how trasnlate this code to FTP return code (5 digits).

Thanks & regards

Robert Sample · Posted: Wed Mar 30, 2011 9:52 pm

FTP generates a subcommand code of 2 digits and a reply code of 3 digits to create the 5-digit value. Since JCL is limited to a range of 0 to 4095 for step condition codes, the 5-digit code is treated modulo 4096 to create the step condition code. Hence 2934 could be 2934, 7030, 11126, .... If you know which command was being executed, you can find the subcommand code for it and that will tell you precisely which 5-digit code was generated. Most likely your job was doing a PUT (subcommand code 27) and got a 510 response from the FTP server (which is not on the standard list of reply codes, which jumps from 504 to 530). 27510 modulo 4096 is 2934.

And by the way, you should not be replying to a thread inactive for 2 1/2 years -- you should post your own question with its own subject line.