Error Message :
On z/OS if the data is truncated during a Managed File Transfer (MFT) to the z/OS machine, the transfer does NOT fail.
Whenever data is written into a dataset on z/OS, it uses the Record Length (LRECL) which specifies the maximum length (in bytes) of each record (line) in the dataset.
If an attempt is made to write a record into a dataset where the length is greater than the LRECL of the dataset, the system will issue an error message similar to this:
EDC5003I Truncation of a record occurred During an I/O operation.
When a File Transfer (FT) job (object type, JOBF) is used to transfer data to z/OS, the data written into the dataset may be truncated. If it is, the task should fail (ENDED_NOT_OK) and the File Transfer Report should contain the appropriate error message. In Automic FT protocol version 1, it did function this way and the job failed. However, in FT protocol version 2 such truncations are not recognized and the Task does NOT fail. Instead the JOBF ends with an ENDED_OK status, even though records were truncated.
Automic File Transfer Protocol
The FT protocol version 1 was used with the Agent version 8 and below. If one or both of the Agents used in the FT are lower than version 9, protocol version 1 is used automatically.
As of version 9 the new FT protocol (version 2) was introduced. As soon as both Agents involved in the FT are on version 9 or higher, the newer FT protocol is used by default.
In addition, it’s possible to change the default by setting the protocol version with the parameter FT_Version in the Host Characteristic of the Agent:
FT_Version = 1 means the Agent will use the old protocol.
FT_Version = 2 means the Agent will use the new protocol. Agent versions needs to be 9 or higher.
Our recommendation is to use the newer protocol, FT protocol version 2.
InvestigationHere an example to help better understand this issue.
20151013/132308.977 - U2002039 Successfully established connection with '192.168.115.101:49362' (socket handle = '4').20151013/132308.986 - U2000006 Connection to Agent 'VWGSUP11(4,ID=13)' was successfully established.20151013/132309.587 - U2000134 Thread '*FT(4129308)' started.20151013/132309.974 - U0011411 FT '4129308(oid=0)': Receiving file 'UC4SCJ.SIS.TEST.FILE1.TXT'.20151013/132320.001 - U2000135 Thread '*FT(4129308)' ended.
2015-10-13 15:25:08 - U0011124 Selection started with filter '\\vwgsup11\c$\UC4_FT\test.file1.txt' ...2015-10-13 15:25:08 - U0011125 '\\vwgsup11\c$\UC4_FT\test.file1.txt'2015-10-13 15:25:08 - U0011126 Files selected: '1'.2015-10-13 15:25:09 - U0011133 OK '27' Bytes, '4' Records for file '\\vwgsup11\c$\UC4_FT\test.file1.txt'->'UC4SCJ.SIS.TEST.FILE1.TXT' transferred. Duration '00:00:01'.2015-10-13 15:25:09 - U0011408 FT '4129308': FileTransfer completed.
<Please see attached file for image>
20151013/132506.701 - U2002039 Successfully established connection with '192.168.115.101:49450' (socket handle = '4').20151013/132506.712 - U2000006 Connection to Agent 'VWGSUP11(4,ID=17)' was successfully established.20151013/132507.187 - U0011407 FT '4129309': FileTransfer with partner 'VWGSUP11' started.20151013/132507.303 - U0011411 FT '4129309': Receiving file 'UC4SCJ.SIS.TEST.FILE1.TXT'.20151013/132507.425 - fwrite(...,//'UC4SCJ.SIS.TEST.FILE1.TXT') error 3: EDC5003I Truncation of a record occurred during an I/O operation.20151013/132507.425 - U0011414 Error while writing to file '//'UC4SCJ.SIS.TEST.FILE1.TXT''. Error code: '3h', error description: ''.20151013/132507.718 - U0011409 FT '4129309': FileTransfer ended abnormally.
2015-10-13 15:27:07 - U0011134 ERROR ' 40' bytes, incorrect transfer of ' 4' records for file '\\vwgsup11\c$\UC4_FT\test.file1.txt'->'UC4SCJ.SIS.test.file1.txt'. Duration '00:00:01'.2015-10-13 15:27:07 - U0011414 Error while writing to file '//'UC4SCJ.SIS.TEST.FILE1.TXT''. Error code: '3h', error description: ''.
<Please see attached file for image>
Root Cause: FileTransfer into zOS don't fail even if records have been truncated. Expected behavior is to stop transfer with ENDED_NOT_OK status and to write an error message into FileTransfer report.
OS Version: N/A
Update to a fix version listed below or a newer version if available.
Fix Status: Released
Component(s): Agent MVS
Automation Engine 12.1.0 - Available
Automation Engine 12.0.2 - Available
Automation Engine 11.2.5 - Available
Automation Engine 11.1.6 - Available
AE 10.0.8 HF4 - Available
Use FT protocol version 1. This can be set by setting the FT_Version parameter to 1. This parameter is located in the Host Characteristics.
Note: If one or both of the Agents used for the FT is version 8 or older, the default setting for FT_Version is already 1.