Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 4 Encoded File Transfers : The File Transfer Process

The File Transfer Process
The file transfer process involves using a translation utility, S6BBRNLS/hrnbrnls, that changes the character fields in row occurrences from one code page representation to another. The procedure is as follows:
1.
2.
3.
4.
5.
6.
Further details on each of these steps are provided in the following sections.
Step 1: Define the Input File
Define the input file by using the BATCHLOAD_CARDS tool to create a control file. For more information on this tool, refer to TIBCO Object Service Broker Shareable Tools. The control file can also be created manually using a text editor.
When building the control file, there are several considerations that should be taken into account. For more information, refer to the S6BBRNLS/hrnbrnls utility as described in TIBCO Object Service Broker for z/OS Utilities or TIBCO Object Service Broker for Open Systems Utilities.
Step 2: Run S6BBRNLS/hrnbrnls Against the Input File
Using the control file, run S6BBRNLS/hrnbrnls against the input file. For detailed information on the S6BBRNLS/hrnbrnls utility, refer to TIBCO Object Service Broker for z/OS Utilities or TIBCO Object Service Broker for Open Systems Utilities.
 
The code page specified for the input file is checked to ensure it is supported by TIBCO Object Service Broker. If not, the request is rejected.
Step 3: Check Audit Log
As part of the process, an audit log file is produced. This file is an activity report containing information and warning and error messages as well as run statistics. Always inspect this report before using the output file in another process. Should you encounter problems requiring TIBCO Support services, the audit log is always be required (either hardcopy or file).
Step 4: Run Sort on Output File, if Required
If S6BBRNLS/hrnbrnls indicates that translation changed the sequence of the translated file, a sort is necessary before the file can be loaded using S6BBRTBL/hrnbrtbl. If no sort is available on Windows or Solaris, you must translate the file on the z/OS platform and sort it prior to using File Transfer Protocol (FTP) to move the file back to Windows or Solaris.
If a field is eligible for translation and is also a parameter or primary key field, be aware that the output file could require sorting after translation. If such fields exist in the input file, we recommended that translation and sorting be done on z/OS prior to porting to Windows or Solaris if the file is to be ported in this way.
Step 5: Transfer Output File to Appropriate Platform
Copy the output files to the destination platform or move the file using File Transfer Protocol (FTP).
Step 6: Load Output File Using S6BBRTBL/hrnbrtbl Utility
For information on the S6BBRTBL/hrnbrnls utility and its use, refer to TIBCO Object Service Broker for z/OS Utilities or TIBCO Object Service Broker for Open Systems Utilities.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved