Specify a long filename more than 80 bytes long when transferring from z/OS to other platforms

Products

• XCOM Data Transport
• XCOM Data Transport - Windows
• XCOM Data Transport - Linux PC
• XCOM Data Transport - z/OS

Issue/Introduction

How can you specify a long filename more than 80 bytes long and eventually containing blanks when transferring from z/OS to other platforms?

Resolution

When transferring a file from XCOM for z/OS to another platform it may happen that and the filename does not fit into the line limitation of 80 bytes in SYSIN01.

You can use the continuation character '+' to split the name into two lines and start the next line in columns 2 through 16.

Take special care if the file name also contains blanks.

Let's assume the name of the destination file for a transfer is:

C:\Documents and Settings\Example\My Documents\This is a very long file name.txt

1. You can use the continuation character '+' to span the name over more than one line.
   1. Make sure that there is no blank before the '+'-sign and that the next line starts in columns 2 through 16.
   2. If you use only one pair of quotes the embedded blanks in the filename will cause a syntax error when parsing the line.
      FILE="C:\Documents and Settings\+
Example\+
My Documents\+
This is a very long file name.txt"
2. The Joblog will contain a message like this:
   
   XCOMM0106E FILE= END QUOTE MISSING OR INVALID LENGTH
XCOMM0105E Examp... DATA INVALID
XCOMM0105E My Documen... DATA INVALID
XCOMM0105E This is a... DATA INVALID
XCOMM0116E REQUEST FAILED DUE TO ERRORS
3. So, be sure to put every line into double quotes. Here is an example:
   
   FILE="C:\Documents and Settings\Example\"+
"My Documents\This is a very long file name.txt"

This example will work, too:
   
   FILE="C:\Documents and Settings\"+
"Example\"+
"My Documents\"+
"This is a very long file name.txt"