1. Manuals
  2. Brands
  3. Nlynx Manuals
  4. Software
  5. ETU400
  6. User manual

Nlynx ETU400 User Manual

As/400 file transfer utility
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
ETU400
User Guide
AS/400 File Transfer Utility
i

Advertisement

Table of Contents
loading

Related Manuals for Nlynx ETU400

Summary of Contents for Nlynx ETU400

  • Page 1 ETU400 User Guide AS/400 File Transfer Utility...

  • Page 2: Software License Agreement

    The following definitions apply to the terms as they appear in this Agreement: * "NLynx" means NLynx Technologies, Inc. acting by and through one or more of its subsidiaries in its Network Systems group. * "You" and "Your" refer to any person or entity that acquires or uses this Package.
  • Page 3 Software. * Translate or create derivative works based on the Software. * Remove, obscure, or alter any notice of the NLynx copyright or other proprietary rights related to the Software. * Sub-license, sell, lend, rent, or lease the Software or any portion of the Software, or use it for any purpose other than Your internal purposes.
  • Page 4 You must, however, return all copies of the Software; along with a copy of Your paid invoice, to NLynx within 90 days of the date You receive the Software. This warranty gives You specific legal rights; in some jurisdictions You may have other rights under certain statutes which imply non-excludable warranties.
  • Page 5 This document is for use with the NLynx Technologies ETU/400 product. No part of this document may be copied in any form or by any means without prior written consent of NLynx Technologies. All software, firmware and downloadable operating code described herein or used by the products described herein are copyrighted by and shall remain the property of NLynx Technologies.
  • Page 6 3XTwin, 3XTwin/2, 3XPlus, 3XPlus/2, 3XMate, 3XMate/2, 3XMate-Laptop, Multi-Twin, MacTwin, and 3XTwin-Laptop are registered trademarks of Emerald Technology, Inc., an NLynx Technologies company. ETU is a trademark of Emerald Technology, Inc., an NLynx Technologies company. InterAxcess is a trademark of KMW, an NLynx Technologies company.
  • Page 7 ETU and the AS/400. You will find all ETU commands listed in alphabetical order, along with the functions and the parameters associated with each command. Part Four: Appendices The appendices include supplementary technical information, followed by an index. ETU400 User Guide 011603...

  • Page 8: Table Of Contents

    Legal Notices © 2000 NLynx Technologies, Inc. All rights reserved. PREFACE Trademark Recognition. About This Guide Who Should Use This Guide? How This Guide is Organized INTRODUCTION Welcome to ETU What ETU Can Do for You Inventory Checklist Security Considerations...
  • Page 9 Host File Type Data Description Specifications About Translating Files How Data is Stored Using Translation Tables ETU Translation Table Members Using Translation Tables with the Mac Using Microcomputer Data Formats ETU400 User Guide 011603 3-10 3-10 3-10 3-11 3-11 3-11 3-11...
  • Page 10 Translating PC Print Files: The PRTXFRMPC Command PRTXFRMPC Example Translating Host Spool Files: The PRTXTOPC Command PRTXTOPC Example WORKING WITH PC FUNCTIONS Rename a Micro File: The RENAMEB Command ETU400 User Guide 011603 5-10 5-11 5-12 5-12 5-12 5-13 5-14 6-11...
  • Page 11 Field Selection -- Example 1 Field Selection -- Example 2 Transferring Selected Records Record Selection -- Example1 Record Selection -- Example 2 Entry and Exit Programs Example Deleting Files After Transfer ETU400 User Guide 011603 8-10 8-10 9-10 9-10 9-10 9-11 9-12...
  • Page 12 PRTXTOPC Command PWRDELETEB Command PWRFROM3XB Command PWRRENAMEB Command PWRTO3XB Command RENAMEB Command SBMBATXFER Command SBMSCHJOB Command Before You Begin To Schedule a Job STRSEU Command ETU400 User Guide 011603 9-20 9-20 9-22 9-23 9-24 9-25 10-1 10-2 10-3 10-4 10-6...
  • Page 13 APPENDIX C ETU COMPATIBILITY About This Appendix Using ETU 5.01 and above with Autokey Batch Files Modifying an Autokey Batch File – Example CREATING DDS SPECIFICATIONS About This Appendix ETU400 User Guide 011603 10-47 10-48 10-52 10-52 10-54 10-57 10-61...
  • Page 14 Starting ETU in System/36 Mode The ETU36 Menu Running ETU in System/36 Mode Native Commands Not Supported in the System/36 Mode System/36-mode Commands and Native Mode Equivalents ALLOCATE Procedure COMPILE Procedures DELETE Procedure EDITABLE Procedure ETU400 User Guide 011603 E-15 E-19 E-21...
  • Page 15 Installing International Translation Table Appendix I ETU AUTOMATION ETU400 Automation AUTOMATION MECHANISMS SBMBATXFER SBMSCHJOB ETU THROUGHPUT CONSIDERATIONS ETU THROUGHPUT CONSIDERATIONS What kind of throughput can I expect? ETU400 User Guide 011603 G-10 G-13 G-15 G-18 G-21 G-23 G-25 G-26 G-27...

  • Page 16: Getting Started

    Part One Getting Started “Getting Started” is intended for all users of ETU. It describes how to install and how to use ETU. If you are new to ETU, you will be introduced to concepts and terms that will help you master it. Installing ETU Using ETU Learning About ETU...

  • Page 17: Introduction

    Welcome to ETU What ETU Can Do For You Inventory Checklist Security Considerations Hardware and Software Requirements Hardware Requirements Software Requirements Features of Versions Notes to Mac Users Compatibility with Non-NLynx ES32 products Native Mode and System/36 Mode INTRODUCTION Chapter 1...

  • Page 18: Welcome To Etu

    ETU Function Install ETU Use all ETU commands (other than the power commands) Use ETU Power commands Configure Audit Trail ETU400 User Guide 011603 Security Profile Required QSECOFR *PUBLIC QSECOFR, or a user profile with *ALLOBJ authority, or any user who...

  • Page 19: Inventory Checklist

    One of the following sets of storage media containing the ETU software: six 5.25-inch diskettes' one reel-to-reel tape, one tape cartridge, or one CDROM. If this item is missing, contact NLynx Customer Service at 888-NLynx67 from 8:30 to 5:30 Central Standard Time. Security Considerations When you first receive ETU, there are some functions that can only be performed by the system security officer (QSECOFR).

  • Page 20: Hardware And Software Requirements

    MacMidrange Client or TCP/Axcess by NLynx Technologies, Inc. Note: Many older products, including DOS, Unix, and Windows 3.1 will work with ETU also, but they are not supported by NLynx Technologies. Rule of thumb, if it worked in the past, and the operating system was not upgraded, it will probably still work.

  • Page 21: Features Of Version 5.02

    The RMVETU command has been reimplemented. The RMVETU command, which gracefully removes ETU from your AS/400, has been reimplemented. See Appendix A for details. This version of ETU is compatible with most of the earlier versions. ETU400 User Guide 011603...

  • Page 22: Features Of Version 5.041

    IBM PTF SP36296 made the Restore Objects OS/400 command work the same as in V3R6. Version 5.04.1 of ETU 400 RISC accommodates either V3R6 or V3R7, so that the PTF is not required. This makes the installation much easier. ETU400 User Guide 011603...

  • Page 23: Features Of Version 5.5

    6. Changed the build command so that no checking is done for the version of ETU - had to keep changing it each time we built a new version. 7. There is no longer default install library - user must specify at installation. ETU400 User Guide 011603...

  • Page 24: Features Of Version 5.6

    Mac Users: This is how Mac-specific information is presented. Compatibility with Non-ES32 Emulation Products ETU is currently only supported with NLynx Techologies ES32 emulation. There once was a DOS Compatibility disk with a program called IBMTRAN that enabled any emulation to work. This software only works with other DOS software using serial COM ports.

  • Page 25: Part One, Getting Started

    Part One, Getting Started “Getting Started” is intended for all users of ETU. It describes how to Installing ETU Using ETU Learning About ETU ETU400 User Guide 011603...

  • Page 26: Installing Etu

    About This Chapter Installing ETU Installing the ETU Software Registering Your Host System Obtaining Your Host Registration Number Completing the Host Registration Procedure Re-installing ETU Removing ETU From Your Host System Installing ETU For International Users The ETU Compatibility Diskette: For DOS-only Non-ES32 Emulation Products Who Should and Can Use IBMTRAN Copying IBMTRAN To Your Hard Drive...

  • Page 27: About This Chapter

    ETU software on the AS/400. This chapter explains: • how to install the ETU software; • how to register ETU with NLynx Technologies; • how to determine if you need the IBM Compatibility Diskette in order to run ETU. ETU400 User Guide 011603...

  • Page 28: Installing The Etu Software

    To install ETU on the AS/400, you will follow these basic steps: • load the ETU software; • register your copy of ETU with NLynx Technologies • complete the registration procedure on the AS/400. NOTE: Before installing ETU, you must sign on to the AS/400 as the security officer (QSECOFR).
  • Page 29 (the files TRANSLATE and MACTAB) in versions of ETU prior to 5.01, and wish to keep those translation tables for use with version 5.01. The default is (*NO) which does not keep the ETU400 User Guide 011603 device-name ) VOL(*MOUNTED) target-library )
  • Page 30 ETU400 User Guide 011603...

  • Page 31: Registering Your Host System

    NLynx Technologies during this 30-day period to allow unlimited use of the software on your host system. NOTE: Once you receive your ETU host registration number from NLynx Technologies, you may not return ETU for a refund.

  • Page 32: Obtaining Your Host Registration Number

    The ETU version (for example, 5.02) The name of your company, a person to contact, and a phone number. FAX or phone the above information to NLynx Technologies between the hours of 8:30 a.m. and 5:30 p.m., Central Time, Monday through Friday.

  • Page 33: Removing Etu From Your Host System

    8:30 – 5:30 CST. Toll-free 1-888-NLynx67 (Technical Support Hotline) We will provide answers and support by email for product that is not under warranty if you use the Technical Support Contact Form at http://www.nlynx.com/html/contacttechnicalsupport.htm http://www.nlynx.com/html/tb-etu.htm Technical Bulletins for ETU are located at ETU400 User Guide 011603...

  • Page 34: The Etu Compatibility Diskette: For Non-Es32 Emulation Products

    Andrew products: 3XTwin, 3XPlus, 3XPlus-X.25, 3XMate, 3XTwin- Laptop, 3XMate-Laptop, Multi-Twin, or MacTwin. Additionally products in the NLynx Systems ES/95 family do not need it, and products in the NLynx Technologies ES32 family do not need it. NOTE: IBMTRAN runs only under DOS and isn't intended for use with Windows, OS/2, UNIX, or the Apple Mac.

  • Page 35: Starting Etu When Using Ibmtran

    You can also load IBMTRAN by typing ibmtran. This variation returns to DOS, thus bypassing the intermediate screen described above. This may be helpful for use in batch files where you want to perform a file transfer and then exit out of IBMTRAN. ETU400 User Guide 011603 2-10...

  • Page 36: Using Etu

    About This Chapter Starting ETU A Note About Authorization The ETU Main Menu The ETU Utilities Menu The ETU Commands Main Menu: File Transfer Commands Main Menu: ETU Power Commands Utilities Menu: Microcomputer Commands Utilities Menu: File Translation Commands Utilities Menu: Translation Table Commands Running ETU Commands Using the Menu...

  • Page 37: About This Chapter

    • how to use the ETU menu; • how to enter ETU commands; • about using ETU with PC or Apple Mac files. Once you have read this chapter, continue with Chapter 4, Learning About ETU. ETU400 User Guide 011603...

  • Page 38: Starting Etu

    If you don't have the authority to use a certain command, it won't display on the ETU menu, nor will you be able to run the command from the command line. See Appendix A, Inside ETU, for more information about user authorization with ETU. ETU400 User Guide 011603...

  • Page 39: The Etu Main Menu

    Figure 3-1 The ETU Main Menu Menu - WSMENUS Emulator Transfer Utility AS/400 NLRISCLIFF COPYRIGHT (C) 1998 - NLynx Systems ETU Functions 1. Host file to PC file 2. Host program to PC file 3. Host spool file to PC prt file 4.

  • Page 40: The Etu Utilities Menu

    Figure 3-2 The ETU Utilities Menu Menu - WSMENUS Emulator Transfer Utility AS/400 NLRISCLIFF COPYRIGHT (C) 1998 NLynx Systems PC Functions 1. Allocate NEW PC file 2. Rename PC file 3. Delete PC file 4. Test for existence of PC file Translation Functions 8.

  • Page 41: The Etu Commands

    Utilities Menu: Translation Table Commands These commands allow advanced users to change the translation tables supplied with ETU. They are discussed in Chapter 8, Modifying Translation Tables. Option 1. STRSEU ETU400 User Guide 011603 Option 4. TO3XB Option 5. PGMTO3XB Option 6.

  • Page 42: Running Etu Commands

    ..Member name: ..Qualified file name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Name, *FILE 0-9989...

  • Page 43: Using The Command Prompts

    Mac System Software User's Guide. NOTE: If you cancel from a dialog box, you receive an ETU user message giving you the option to CANCEL or GO. Select CANCEL to return to the WSMENUS options. ETU400 User Guide 011603...

  • Page 44: Request Definitions

    NOTE: When you save a PWRFROM3XB request definition, note that special values shouldn't be used in the Comparison Value prompt in the Record Selection parameter. See PWRFROM3XB command in Chapter 10, Command Reference for more details on the special values. ETU400 User Guide 011603...

  • Page 45: Types Of Processing

    The ETU power commands can also be submitted to batch by using SBMJOB or the ETU utility SBMBATXFER (submit batch transfer). The power commands are PWRDELETEB, PCFROMPC, PCTOPC, PWRFROM3XB, PWRRENAMEB, and PWRTO3XB. ETU400 User Guide 011603 3-10...

  • Page 46: About Microcomputer Files

    NOTE: If you enter an ETU command on the command line or in a CL procedure, you must place single quote marks (') around the microcomputer's path and file name. For example, 'C:\SUBDIR1\EXAMPLE.TXT’ ETU400 User Guide 011603 SUBDIR1 EXAMPLE.TXT FOLDER1...

  • Page 47: Learning About Etu

    Transferring Data to Host Files Record Length Host File Type Data Description Specifications About Translating Files How Data is Stored Using Translation Tables ETU Translation Table Members Using Translation Tables With the Mac Using Microcomputer Data Formats ETU400 User Guide 011603 Chapter 4...

  • Page 48: About This Chapter

    It explains how data is stored on the host and the microcomputer, and how ETU makes it possible to transfer data between the two systems. The information you provide when you transfer and translate files using ETU is also explained in this chapter. ETU400 User Guide 011603...

  • Page 49: What Is Etu?

    ETU, and to perform other advanced functions such as transferring files to multiple devices, transferring selected records, and using entry and exit programs. To learn more about these commands, see Chapter 8, Modifying Translation Tables, and Chapter 9, Advanced ETU Features. ETU400 User Guide 011603...

  • Page 50: About Transferring Files

    You can transfer one specific member by including the member name, or you can use the default, *FILE, which transfers the member with the same name as the host file name. ETU400 User Guide 011603...

  • Page 51: Transferring Data To Host Files

    A source physical file is a file that can be read by the AS/400 Source Entry Utility (SEU). *SAVF A file type that provides a means of storing AS/400 objects on line. To use *SAVF, RECL (record length) must be 528 and TRANSLATE (*NONE). ETU400 User Guide 011603...

  • Page 52: Appendix C

    As a consequence, the DDS member you specify will not be used in the transfer and the data may not appear on the host as you expected. Appendix C in this guide explains how to create DDS on the AS/400. ETU400 User Guide 011603...

  • Page 53: About Translating Files

    It translates data between ASCII and EBCDIC, and it also reformats the data into one of the various microcomputer file formats. To perform the ASCII-to-EBCDIC translation, ETU uses translation tables, which are explained on the following page. The different microcomputer file formats are explained on page 4-11. ETU400 User Guide 011603...

  • Page 54: Using Translation Tables

    (either TRANSLATE or MACTAB) and the translation member name (for example, ETOA1) at the TRANSFILE prompt. If these standard tables do not meet the needs of a specific application, you may change them. For more information about creating and modifying translation tables, see Chapter 8. ETU400 User Guide 011603...

  • Page 55: Etu Translation Table Members

    PC, with no carriage return line feed. The PC application is expected to read for a fixed record length. ATOE1M The ASCII-to-EBCDIC Mac fixed- and variable-length translation member. ETU400 User Guide 011603 Trailing Trailing...

  • Page 56: Using Translation Tables With The Mac

    If you do translate the file using these commands, you must specify a translation table. For these commands, Mac users that use a translation table with these commands must change the TRANSLATE parameter to MACTAB. ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Name, *FILE, *FIRST, *LAST...
  • Page 57 Table 4-2 ETU Commands in which the translation table file name is optional ETU Command FROM3XB PRTTOPC TO3XB PRTFRMPC PWRFROM3XB PWRTO3XB ETU400 User Guide 011603 ETU Main Menu Option 4-11...

  • Page 58: Using Microcomputer Data Formats

    ASCII Text format (*TEXT) Basic Sequential format (*BASICS) ETU400 User Guide 011603 ASCII Text is a character-oriented format. Use *TEXT with files created with any kind of word processing program or text editor. BASIC Sequential format is a standard method of storing data on the PC or Mac.

  • Page 59: Creating Dds Specifications

    See the IBM manual AS/400 Programming: Data Description Specifications Reference, SC21-9620, for information on creating DDS specifications. ETU400 User Guide 011603 TAB format is the same as BASIC Sequential, except that tab characters, rather than commas, separate the fields. Data in a *TAB format...
  • Page 60 “Running ETU” is intended for all users of ETU. It introduces each ETU command and describes how to use the commands. An example of how to use each command is also provided. Transferring Files Translating Files Working with PC Functions Modifying Translation Tables Advanced ETU Features ETU400 User Guide 011603...

  • Page 61: Transferring Files

    The PRTTO3X Command PRTTO3X Example Transferring Host Programs Transferring a Host Programs to a Microcomputer: The PGMFROM3X Command PGMFROM3X Example Transferring a PC Program to a Host Program: The PGMTO3X Command PGMTO3X Example ETU400 User Guide 011603 TRANSFERRING FILES Chapter 5...

  • Page 62: About This Chapter

    PGMFROM3XB--Transfers compiled host programs to the micro. • PGMTO3XB--Transfers compiled host programs from the micro to the host. This chapter is an introduction to the file transfer commands. Refer to Chapter 10, ETU Command Reference, for complete information about a particular command. ETU400 User Guide 011603...

  • Page 63: Transferring Data Files

    1. Choose option 1 from the ETU Main menu. The FROM3XB screen displays. 2. Enter the host file name at the File name prompt: sales Use the default, *LIBL, as the library name. *LIBL searches all libraries in your library list for the specified file. ETU400 User Guide 011603...
  • Page 64 Member name: ..Qualified file name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Name, *FILE, *FIRST, *LAST... *YES, *NO...

  • Page 65: Transferring Data Files From A Microcomputer To The Host:

    ..Member name: ..Qualified file name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 translate(*none) Name *LIBL Name, *LIBL *FILE Name, *FILE...

  • Page 66: To3Xb Example

    8. Enter the microcomputer file name at the Qualified file name prompt: c:\sales\january\report1.doc 9. Once you have entered the appropriate information, press ENTER to start the command. ETU will transfer the data to the host and translate it as you specified. ETU400 User Guide 011603...

  • Page 67: Transferring Print Files

    CPYSPLF, translate the file for the PC, and prompt you for the PC file in which to transfer the data. NOTE: Always use the translation table member ETOA1 in file TRANSLATE with this command. This table transfers spool files from EBCDIC to ASCII. ETU400 User Guide 011603...
  • Page 68 Library name: ..Member name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL TRANSLATE Name, TRANSLATE, MACTAB *LIBL...
  • Page 69 The name of the PC file to which the data will be transferred is also displayed. You can change the file name or leave it at the default. The default is C:\PCPRINT.LST. Press ENTER to begin the transfer operation. ETU400 User Guide 011603 Library: *LIBL 1=Copyprt 2=Copyprt & Transfer...

  • Page 70: Transferring A Pc Print File To The Host:

    Translation table file name: . . Library name: ..Translation table member name: F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL 1-255 6, 8, 4, 9 10, 12, 15 1-198...

  • Page 71: Prtto3X Example

    4. Use the defaults for all other parameters. 5. Once you have entered the appropriate information, press ENTER. The PC print file will be transferred to the host and placed on the output queue USER1. ETU400 User Guide 011603 5-11...

  • Page 72: Transferring Host Programs

    Library name: ..Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F13=How to use this display ETU400 User Guide 011603 Name, generic* *LIBL Name, *LIBL *YES *YES, *NO F10=Additional parameters F12=Cancel...

  • Page 73: Pgmfrom3Xb Example

    3. Enter the host program and library name at the Program name prompt. For the program, enter: beta1 For the library, enter: user 4. Once you have entered the appropriate information, press ENTER and the program will transfer to the PC. ETU400 User Guide 011603 5-13...

  • Page 74: Transfer Host Programs To The Host:

    Library name: ..Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 QGPL Character value *YES *YES, *NO F12=Cancel F13=How to use this display Bottom...
  • Page 75 4. Once you have entered the appropriate information, press ENTER and the program will transfer to the host. This concludes this chapter on how to transfer files between the host and the PC. For more information on each command see Chapter 10, Command Reference. ETU400 User Guide 011603 5-15...

  • Page 76: Translating Files

    Translating a Host File to Microcomputer Format: The XLATETO Command XLATETO Example Translating Print Files Translating PC Print Files: The PRTXFRMPC Command PRTXFRMPC Example Translating Host Spool Files: The PRTXTOPC Command PRTXTOPC Example ETU400 User Guide 011603 TRANSLATING FILES Chapter 6...

  • Page 77: About This Chapter

    The advantages to using the translation commands are described on the following page. If you are new to ETU, you should read Chapter 4, Learning About ETU, prior to reading this chapter. ETU400 User Guide 011603...

  • Page 78: Why Use The Translation Commands

    You still have to transfer the file over the modem, but by translating the file on the host prior to sending it to the micro, or after receiving it from the micro, you can save both time and money. ETU400 User Guide 011603...

  • Page 79: Translating Data Files

    This allows the record to be read by Source Entry Utility (SEU) after it is translated. Specify *YES for the SRCSEQ parameter to add the sequence number and date field. ETU400 User Guide 011603...

  • Page 80: Xlatefrom Example

    Job description: ..Library name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Character value, *FILE, *LAST Name *LIBL...
  • Page 81 6. At the Type of translate prompt, enter the translation type: *tab 7. Enter the name of the translation table for ASCII-to-EBCDIC translations: atoe1 Use the defaults for all the other parameters. 8. Once you have entered the appropriate information, press ENTER to start the command. ETU400 User Guide 011603...

  • Page 82: Translating A Host File To Microcomputer Format:

    ..Field translation definition: Library name: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Name, *FILE, *ALL, *FIRST... Name *LIBL...

  • Page 83: Xlateto Example

    8. Leave the Record length at its default of 0. At the Job description prompt, enter the name of the job description that the job use: user 9. Once you have entered the appropriate information, press ENTER to start the command. ETU400 User Guide 011603...

  • Page 84: Translating Print Files

    Translation table file name: . . Library name: ..Translation table member name: F3=Exit F4=Prompt F5=Refresh F24=More keys PRTXFRMPC Example ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Character value, *FILE Name *LIBL Name, *LIBL...
  • Page 85 The translation job will be sent to a job queue. After the file is translated, the print file will be sent to the USERX output queue and will automatically print when it reaches the top of the queue. ETU400 User Guide 011603 6-10...

  • Page 86: Translating Host Spool Files:

    PAGE SIZE Length--lines/page: "PAGE WINDOW"...FROM column: . . TO column: ... F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name *LIBL Name, *LIBL *FILE Name, *FILE *COPYPRT, *TRANSLATE QPRINT...

  • Page 87: Prtxtopc Example

    9. Once you have entered the appropriate information, press ENTER to start the command. When the job is complete, the file will be transferred to the PC. For more information on the commands discussed in this chapter, see Chapter 10, ETU Command Reference. ETU400 User Guide 011603 6-12...

  • Page 88: Working With Pc Functions

    The RENAMEB Command RENAMEB Example Allocate a Micro File: The ALOCATB Command ALOCATB Example Delete an Existing File The DELETEB Command DELETEB Example Test For the Existence of Micro File: The TESTB Command TESTB Example ETU400 User Guide 011603 Chapter 7...
  • Page 89 Four commands are discussed in this chapter. The commands and their functions are listed for you here: • RENAMEB--Renames an existing microcomputer file; • ALOCATB--Allocates (creates) a new microcomputer file; • DELETEB--Deletes an existing microcomputer file; • TESTB--Tests for the existence of a microcomputer file. ETU400 User Guide 011603...

  • Page 90: Rename A Micro File:

    Qualified file name: ..New micro file name: ..Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 *YES *YES, *NO F12=Cancel F13=How to use this display Bottom...

  • Page 91: Allocate A Micro File:

    Allocate a micro file: (ALOCATB) Type choices, press Enter. Qualified file name: ..Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 *YES *YES, *NO F12=Cancel F13=How to use this display Bottom...

  • Page 92: Delete An Existing File:

    Qualified file name: ..Notify operator: ..Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 *YES *YES, *NO *YES *YES, *NO F12=Cancel F13=How to use this display...

  • Page 93: Deleteb Example

    You will be notified whether or not the file is found. 5. Press ENTER to start the DELETEB command. ETU will delete the file on the PC and notify you if the file is not found by sending a message to your display. ETU400 User Guide 011603...

  • Page 94: Test For The Existence Of A Micro File:

    Notify operator: ..LDA position for file size: Display status messages ?: . . . F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 *YES *YES, *NO, *LDA 1-1012 *YES *YES, *NO F12=Cancel...

  • Page 95: Modifying Translation Tables

    About This Chapter About Translation Tables Modifying a Translation Table Make a Copy of the Original Table Editing the Translation Table Translation Table Record Format Sample Translation Table. Compiling the New Translation Table Member Naming the New Member ETU400 User Guide 011603...

  • Page 96: About This Chapter

    EDITTABLE. These commands are explained in this chapter and in Chapter 10, ETU Command Reference. Appendix F, ASCII-EBCDIC Printable Characters, lists the ASCII and EBCDIC characters and their hexadecimal equivalents. Refer to Appendix F when modifying a translation table. ETU400 User Guide 011603...

  • Page 97: About Translation Tables

    ATOE3 ETOA1M Translation Tables ETOA2M ATOE1M ETU400 User Guide 011603 The EBCDIC-to-ASCII character translation member producing a variable length record, with carriage return and line feed added after the last byte of data in each record. Trailing blanks are stripped.

  • Page 98: Modifying A Translation Table

    EDITTABLE is option 21 on the ETU Utilities menu. Once you compile the new translation table, you can use it to translate files. Each step in this process is described on the following pages. ETU400 User Guide 011603...

  • Page 99: Make A Copy Of The Original Table

    Action to be taken before or after the scan/replace • Pad characters for EBCDIC-to-ASCII translations • End-of-file character in ASCII-to-EBCDIC translations • End-of-record character in ASCII-to-EBCDIC translations The record format for the translation table source file is shown in Table 8-2. ETU400 User Guide 011603...
  • Page 100 The FROM HEX table size limits are listed in Table 8-3. Table 8-3 FROM HEX Table Size Limits Number of Maximum Number of Table Entries FROM Characters *TEXT ETU400 User Guide 011603 *DIF *BASICS *TAB...
  • Page 101 TO HEX characters. For example: FROM HEX 0D0A Another example, writing AAAB before padding with nulls: FROM HEX TO HEX 0D0A ETU400 User Guide 011603 Comment If CR/LF then pad and write Comment If CR/LF, write record Comment If CR/LF...
  • Page 102 (positions 3 through 18) must be blank. The only valid entries on this statement are the TO HEX characters and comments. Comment statements -- Comment statements can be included in the translation table source by coding ** in positions 1 and 2. ETU400 User Guide 011603...

  • Page 103: Sample Translation Table

    ATOE1 in the file TRANSSRC in the library containing ETU. It can be printed with the Source Entry Utility. Figure 8-4 Sample ASCII-to-EBCDIC Translation Table FROM HEX TO HEX 0DOA ETU400 User Guide 011603 Comments Omit unprintable characters Numeric Characters Alphabetic characters CR/LF; End-of-record...

  • Page 104: Compiling The New Translation Member

    If you don't intend for the new table to replace the original table, then be sure to give the new table a unique name. Then, each time you translate a file using the new translation table, be sure you specify the new table name in the TRANSMBR prompt. ETU400 User Guide 011603 8-10...

  • Page 105: Advanced Etu Features

    Record Selection - Example 2 Entry and Exit Programs - Example Delete Files After Transfer Saving Request Definitions Re-using Request Definitions Performing Batch Transfers Batch Transfer – Example Time and Date Scheduling – Example ETU400 User Guide 011603 Chapter 9...

  • Page 106: About This Chapter

    For more information on the transferring and translating files with these commands, see the FROM3XB and TO3XB commands in Chapter 5. The commands associated with the features in this chapter are described in detail in Chapter 10, Command Reference. ETU400 User Guide 011603...

  • Page 107: Multiple-Device Transfer

    PWRTO3XB multiple device transfer are described below. Qualified file name MICLST ETU400 User Guide 011603 micro file to multiple micros (PCTOPC); The name of the micro file. In order to transfer a file from multiple micros, the file must be identically named (including the path) on each micro.
  • Page 108 PRT2AD3, the file and member are both named PRT2AD3. You must specify Data Description Specifications when you request *MULTI in the TOFILE parameter. ETU400 User Guide 011603 signed on. Each device you transfer from must be powered on, have emulation loaded, and be at the AS/400 sign- on screen.

  • Page 109: Using Pwrto3Xb

    You must either use the host function to rename the first files sent to the host, or specify the option ADDRPL (*ADD). Note that ADDRPL (*ADD) combines data from multiple micro files in a single data file on the host. ETU400 User Guide 011603...

  • Page 110: Transferring A Host File To Multiple Micros

    PWRFROM3XB multiple-device transfers are described below. FRMFILE Qualified File Name MICLIST ETU400 User Guide 011603 The name of the host file that you want to transfer. The name of the file on the micro to which to transfer the file. Any path name you enter must already exist on the micro (ETU does not create subdirectories).

  • Page 111: Micro-To-Micro Transfers

    (device 1, device 2, etc.). As a result, the files sent in the second transfer will overwrite the data sent in the first transfer. To avoid this, use PWRRENAMEB to rename the files resulting from the first transfer. ETU400 User Guide 011603...
  • Page 112 Qualified file name MICLST1 MICLST2 ETU400 User Guide 011603 The name of the file to be transferred. If you are transferring a file from multiple micros, the file name, including the path name, must be identical on each micro.

  • Page 113: The Pctopc Command

    QFNAME1 MICLST1 MICLST2 ETU400 User Guide 011603 The name of the micro file to be transferred. If you are transferring a file to multiple micros, the file name, including the path name, must be identical on each micro.

  • Page 114: Transferring Files Between Multiple Maces

    Before attempting to transfer files using multiple Maces, verify that the following elements are identical on each involved Mac: • the location of InterAxcess (NLynx Technologies’ Mac emulator), whether it's located on the hard drive or several folders deep; •...

  • Page 115: If Interaxcess Is One Or More Folders Deep

    Test resides in the folder Training, and again, the colon before Training represents the hard drive. Once the transfer is complete, the receiving Maces will each have a new file named Test in their Training folders. ETU400 User Guide 011603 The Apps folder 9-11...

  • Page 116: Record And Field Selection

    You can also specify the order in which the data will reside in the micro file. For each field you select to transfer, supply information to the following parameters, found under the heading FLDSEL (field selection) on the PWRFROM3XB prompt screen. The parameters are: ETU400 User Guide 011603 9-12...
  • Page 117 Field name Key field Ascending or descending Specifies whether the records are sorted in ETU400 User Guide 011603 The name of the field you want to transfer. may transfer up to 25 fields. Specifies whether the field is to be a key field.

  • Page 118: Field Selection -- Example 1

    5. Descending field is not used because the Key Field value is *NONE. When you execute this command, the file will transfer to the PC. The only fields that transfer are the employee name and phone number. The information will be sorted into alphabetical order. ETU400 User Guide 011603 9-14...

  • Page 119: Field Selection -- Example 2

    4. In the second prompt, for field name, enter EMPNAM. For key field, enter *KEY2. This sorts any employees who earn the same salary in alphabetical order. Enter *ASC to sort the employees from A to Z. ETU400 User Guide 011603 9-15...

  • Page 120: Transferring Selected Records

    However, due to a limitation in the AS/400 operating system, a saved request definition with a comparison value as described will not work properly. ETU400 User Guide 011603 Relates one test case to another. The first test case must use *IF. The default, *NONE, transfers all records in the file.

  • Page 121: Record Selection -- Example1

    Enter *GE (greater than or equal to) as the relational operator. For the comparison value, enter 5. When you initiate the command, all records meeting both sets of criteria will be transferred to the PC. ETU400 User Guide 011603 9-17...

  • Page 122: Entry And Exit Programs

    When you execute the PWRFROM3XB command, the following events occur in the order shown: • the entry program runs and updates the payroll file; • the file is transferred to the PC; • the exit program runs sending a message to the system operator. ETU400 User Guide 011603 9-18...

  • Page 123: Deleting Files After Transfer

    *YES in the DLTFILE parameter. With the PWRTO3XB command, the file on the micro is deleted after it is transferred to the host. To do this, enter *YES as the value for the DLTFILE parameter. ETU400 User Guide 011603 9-19...

  • Page 124: Saving Request Definitions

    Options: 1= Execute 4= Delete Rqs name Cmd name PWRTO3XB F1= Unfold/Fold F3= Exit The options and the actions they represent are: ETU400 User Guide 011603 2= Submit to batch 3= Change 5= Extended view Cmd parms QFNAME1('c:\bootlog.txt') MICLST(NLRISCLIF... 9-20...
  • Page 125 FROM3XB or TO3XB. Change Delete Extended view Fold/Unfold ETU400 User Guide 011603 Interactively runs the command using the saved definition. Prompts for the job description parameters and submits the request to batch. Batch commands cannot be longer than 256 characters. In order to...

  • Page 126: Performing Batch Transfers

    Specifies whether the job will be held or not once it is placed in the job queue. The default is *NO. To hold the job, enter *YES. You must then manually release the job. ETU400 User Guide 011603 Name *JOBD...

  • Page 127: Batch Transfer – Example

    7. Enter the name of the device to which the file will be transferred: prt3ad1 8. Press ENTER to execute the command. The PCFROMPC command will be submitted to the default job queue, QBATCH. ETU400 User Guide 011603 9-23...

  • Page 128: Time And Date Scheduling

    NOTE: In order for the scheduling function to work, the job scheduling program JOBSCHED, must be active on the AS/40 subsystem QINTER. See the SBMSCHJOB command in Chapter 10 for information on starting JOBSCHED. ETU400 User Guide 011603 00-24, *IMMED 00-59...

  • Page 129: Time And Date Scheduling – Example

    Press ENTER after you enter the appropriate information, and the PWRFROM3XB prompt screen displays. 7. Enter the transfer information in the PWRFROM3XB prompt and press ENTER. The job is submitted to the job queue and will be released at the specified time. ETU400 User Guide 011603 9-25...

  • Page 130: Command Reference

    Part Three Command Reference “Command Reference” is an alphabetical presentation of al AS/400 native mode ETU commands and the parameters and values associated with each command. 10-1 Command Reference ETU400 User Guide 011603 9-26...

  • Page 131: Etu Command Reference

    PRTXTOPC Command PWRDELETEB Command PWRFROM3XB Command PWRRENAMEB Command PWRTO3XB Command RENAMEB Command SBMBATXFER Command SBMSCHJOB Command - To Schedule a Job STRSEU Command TESTB Command TO3XB Command VWSAVRQS Command - VWSAVRQS Notes XLATEFROM Command XLATETO Command ETU400 User Guide 011603 10-1...

  • Page 132: Alocatb Command

    About Microcomputer Files in Chapter 3. DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name...

  • Page 133: Deleteb Command

    This is done by sending a message to your message queue. *YES DSPSTSMSG Displays program status messages during the execution of the command. *YES ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name NOTIFY *YES or *NO...

  • Page 134: Edittable Command

    The qualified file name of the physical file to contain the compiled table. It is created if not found. The default file is TRANSLATE in the library containing the ETU programs. ETU400 User Guide 011603 Parameter name Parameter values SRCMBR...
  • Page 135 The name of the library containing the TRANSFILE. *LIBL is a valid library. TRANSMBR The member name for the compiled table. If the default of *SRCMBR is specified, the name used will be the same as the one specified for the SRCMBR parameter. ETU400 User Guide 011603 10-5...

  • Page 136: Edtudf Command

    Function parameter. Each time you choose the menu option, the command executes using the same values for the parameters as specified when the user-defined function was created. ETU400 User Guide 011603 The Edit User-defined Functions parameters 10-6...

  • Page 137: Edtudf Notes

    ENTER. Extended view allows you to display function strings that are longer than 20 positions. If the function is longer than 20 positions, it will appear on the EDTUDF screen followed by an ellipsis (...). ETU400 User Guide 011603 10-7...

  • Page 138: From3Xb Command

    FRMMBR The FRMFILE member name. You can enter the member name or one of the following values: *FILE *FIRST ETU400 User Guide 011603 Parameter name Parameter values FRMFILE host file name translation table member name...
  • Page 139 ETOA1M). The Mac tables are also shipped in a file called MACTAB. The members in this file do not have the M at the end of the name (for example, ETOA1). ETU400 User Guide 011603 Transfers the last member arrival sequence in the file.
  • Page 140 The default is *NO. To save the request definition, specify *YES and enter the request name you desire. Request Name ETU400 User Guide 011603 The record length of the FRMFILE file is used. The record length for the translation work file.

  • Page 141: From3Xb Notes

    ASCII-to-EBCDIC translation process by specifying STRIP (*YES). If the data was translated prior to using the FROM3XB command, with the XLATETO or PRTXTOPC commands, you must code the FROM3XB parameters STRIP and TRANSLATE as follows: strip(*no), translate(*no) ETU400 User Guide 011603 10-11...

  • Page 142: Pcfrompc Command

    Each micro from which you transfer data must be powered on, have emulation loaded, and have the AS/400 sign-on screen displayed. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name...
  • Page 143 Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 The name of the SAVRQS request definition. The request name can be up to ten characters long.

  • Page 144: Pctopc Command

    The default is *NO. To save the request definition, specify *YES and enter the request name you desire. Request Name ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name...
  • Page 145 DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 10-15...

  • Page 146: Pgmfrom3Xb Command

    AS/400 you're transferring the program to by running the SAVOBJ command. To access the SAVOBJ command, press F10 from when prompting the PGMFROM3XB command. ETU400 User Guide 011603 Parameter name Parameter values QFNAME...

  • Page 147: Pgmto3Xb Command

    The library containing the program. The default is *LIBL. DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name host program name...

  • Page 148: Prtfrom3X Command

    The name of the library containing the TRANSFILE. *LIBL is valid. TRANSMBR The TRANSFILE member name. The default name is ETOA1, an EBCDIC-to-ASCII table supplied with ETU. ETU400 User Guide 011603 Parameter name Parameter values OUTQ output queue name *LIBL...
  • Page 149 Qualified file name: ..> 'C:\PCPRINT.LST' F3=Exit F4=Prompt F5=Refresh F24=More keys The screen that you get with 2=Copyprt & Transfer ETU400 User Guide 011603 . > PCPRINT Name QTEMP Name, *LIBL F12=Cancel F13=How to use this display...

  • Page 150: Prtto3X Command

    AS/400 print queue. The default is 10. WIDTH The width of the forms being printed. Valid entries are 1 through 198. The default value is 132. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name...
  • Page 151 The qualified file name of the translation table file to be used. The default is TRANSLATE. Library The name of the library containing the TRANSFILE. *LIBL is the default. TRANSMBR The TRANSFILE member name. The default name is ATOE3, an ASCII-to-EBCDIC table supplied with ETU. ETU400 User Guide 011603 10-21...

  • Page 152: Prtxfrmpc Command

    The library containing the output queue. *LIBL is the default. LINES The number of lines per page for the new print job being added to the AS/400 print queue. The default is 66. ETU400 User Guide 011603 Parameter name Parameter values FILE Host file name...
  • Page 153 The qualified file name of the translation table file to be used. The default is TRANSLATE. Library The name of the library containing the TRANSFILE. *LIBL is the default. TRANSMBR The TRANSFILE member name. The default name is ATOE3, an ASCII-to-EBCDIC table supplied with ETU. ETU400 User Guide 011603 10-23...

  • Page 154: Prtxtopc Command

    The AS/400 file name to contain the translated print data. Library The library containing the PCDATA file. The default is *LIBL. PCMBR The PCDATA member name. The default is *FILE (same name as PCDATA). ETU400 User Guide 011603 Parameter name Parameter values PCDATA Host file name *LIBL library name...
  • Page 155 The column of the printed report on which to begin translation. This can be used to restrict the copying of either sensitive data, or data that has no meaning for the ETU400 User Guide 011603 the AS/400 file name of the the number of the spooled the name of the job that The number assigned to the job by the system.
  • Page 156 The qualified file name of the translation table file to be used. The default is TRANSLATE. Library The name of the library containing the TRANSFILE. *LIBL is valid. TRANSMBR The TRANSFILE member name. The default member is ETOA1, an EBCDIC-to-ASCII table supplied with ETU. ETU400 User Guide 011603 10-26...

  • Page 157: Pwrdeleteb Command

    You are not notified if the file is not found. DSPSTSMSG Displays program status messages during the execution of the command. *YES Status messages are displayed (the default). Status messages are not displayed. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name MICLIST *REQUESTER...

  • Page 158: Pwrfrom3Xb Command

    Member name Record length Field name Key field Ascending or descending Record selection Relationship Field to be tested Relational operator ETU400 User Guide 011603 Parameter name Parameter values FRMFILE host file name translation table member name *LIBL library name FRMMBR...
  • Page 159 The parameters for the PWRFROM3XB command are described below. FRMFILE The file name of the AS/400 file to be transferred to the micro. Library name Member name ETU400 User Guide 011603 numeric value or ‘alphabetic value’ ENTRYPGM program name *LIBL...
  • Page 160 *TEXT *DIF *BASICS *TAB *NONE ETU400 User Guide 011603 Transfers the file to the micro from which the Translates the host file into ASCII text format. This is the default. Translates the host file into DIF format. Translates the host file into BASIC Sequential format.
  • Page 161 The record length of the translation work file. Valid entries are: *FILE record ETU400 User Guide 011603 The name of the SAVRQS request definition. The request name can be up to ten characters long. (To recall the saved request, use the ETU command VWSAVRQS.)
  • Page 162 NOTE: Record selection can be used only with externally described files. Relationship ETU400 User Guide 011603 May be from 1 to 9989 bytes long. The name of the field to be transferred. The default, *ALL, transfers all the fields in the file.
  • Page 163 Displays program status messages during the execution of the PWRFROM3XB command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 all records in the file. The other relationships are *AND, *OR, *ANDIF, *ORIF and are used in situations where more than one test case is performed.

  • Page 164: Pwrrenameb Command

    Renames the file on the micro with this device name. DSPSTSMSG Displays program status messages during the execution of the command. *YES Status messages are displayed (the default). Status messages are not displayed. ETU400 User Guide 011603 Parameter name Parameter values QFNAME1 micro file name NEWFIL new file name...

  • Page 165: Pwrto3Xb Command

    Member name DDS or F&I file name Library name Member name Entry program Library name Exit program Library name Display status message? ETU400 User Guide 011603 Parameter name Parameter values QFNAME1 micro file name MICLIST *REQUESTER device name TOFILE host file name...
  • Page 166 (the micro data is stored together in one member), or into multiple files each with one member. File name ETU400 User Guide 011603 Transfers the file from the micro from which the command is initiated. device name.
  • Page 167 *TEXT *DIF *BASICS *TAB *NONE ETU400 User Guide 011603 from which it was transferred. Transfers the files into multiple host files. Data Description Specifications (DDS) must be specified when using *MULTI as the value in the TOFILE parameter.
  • Page 168 RECL. The data is folded (this is the default). ETU400 User Guide 011603 currently exists on the micro. A physical file is created. RECL or FLDDEFFILE is used to create the data file. (This is the default.)
  • Page 169 Library name Member name ETU400 User Guide 011603 The name of the SAVRQS request definition. The request name can be up to ten characters long. (To recall the saved request, use the ETU command VWSAVRQS.)
  • Page 170 Displays program status messages during the execution of this command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 same name as the source file. The name of the library containing the specified program.

  • Page 171: Renameb Command

    QFNAME parameter is used. DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 Parameter name Parameter values QFNAME1 micro file name...

  • Page 172: Sbmbatxfer Command

    NOTE: If you are submitting one of the ETU power commands to batch, you must change the default value, *REQUESTER, in the power command to the actual device address you will use. ETU400 User Guide 011603 Parameter name Parameter values...

  • Page 173: Sbmschjob Command

    The time at which the job is processed depends on the number of jobs ahead of it in the job queue. ETU400 User Guide 011603 Parameter name Parameter values...

  • Page 174: To Schedule A Job

    NOTE: The time you specify for the SBMSCHJOB command is the time the job will be released, but not necessarily the time the job will be processed. The time at which the job is processed depends on the number of jobs ahead of it in the job queue. ETU400 User Guide 011603 10-44...

  • Page 175: Strseu Command

    The name of the source physical file member to be edited or created. The default value depends on whether you specify the SRCFILE parameter. *PRV *SELECT source file member name ETU400 User Guide 011603 Parameter name Parameter values SRCFIlE TRANSSRC *PRV...
  • Page 176 You can enter a description that identifies the source member. The description can be up to 50 characters. The default is *BLANK. ETU400 User Guide 011603 Specifies that the same source type is used as when the member was edited.

  • Page 177: Testb Command

    NOTIFY (*LDA). DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 Parameter name Parameter values QFNAME micro file name NOTIFY...

  • Page 178: To3Xb Command

    The qualified file name of the AS/400 file into which the micro data is to be written. Library The name of the library containing the TOFILE. The default is *LIBL. You must specify an existing library ETU400 User Guide 011603 Parameter name Parameter values TOFILE host file name...
  • Page 179 Note that SRCSEQ can be specified even if the file is not translated, in which case untranslated data would be sequenced. ETU400 User Guide 011603 A physical file is created. The value entered in RECL is used to create the data file. This is the default.
  • Page 180 (DDS), or an RPG source file containing F and I specifications. ETU400 User Guide 011603 and is to be translated for the AS/400. This is the default. The qualified file resides in DIF format and is to be translated for the AS/400.
  • Page 181 (To recall the saved request, use the ETU command VWSAVRQS.) DSPSTSMSG Displays program status messages during the execution of the command. The default is *YES. To turn the messages off, enter *NO. ETU400 User Guide 011603 10-51...

  • Page 182: Vwsavrqs Command

    Rqs name Cmd name PWRTO3XB F1= Unfold/Fold F3= Exit ETU400 User Guide 011603 Interactively runs the command using the saved definition. Prompts for the job description parameters and submits the request to batch. Only the ETU power commands may be submitted to batch; not the FROM3XB or TO3XB commands.
  • Page 183 ETU400 User Guide 011603 10-53...

  • Page 184: Xlatefrom Command

    To use XLATEFROM, you must have executed the TO3XB command with the FILETYPE, SRCSEQ, and TRANSLATE parameters coded as follows: filetype(*data) PCDATA The (host) file name containing the untranslated micro data. ETU400 User Guide 011603 Parameter name Parameter values PCDATA PC data file on the host *LIBL...
  • Page 185 The type of file translation that is to occur. *TEXT *DIF *BASICS *TAB ETU400 User Guide 011603 Do not add the sequence number/date field. The record length is equal to that specified. *NO is the default. Add the sequence number/date field. Actual record length is 12 greater than the specified record length.
  • Page 186 The FLDDEFFILE member name. You can enter the member name or one of the following values: *FILE ETU400 User Guide 011603 The data is folded (this is the default). The data is truncated, if necessary. Transfers the member with the same name as the FLDEFFILE (the default value).

  • Page 187: Xlateto Command

    Record length File Type Job description Library name Field translation definition Library name Member name ETU400 User Guide 011603 Transfers the first member (arrival sequence)in the file. Transfers the last member (arrival sequence)in the file. Parameter name Parameter values FRMFILE...
  • Page 188 Specifies the type of file translation that is to be performed: *TEXT *DIF ETU400 User Guide 011603 Translates the member with the same name as the FRMFILE file (the default). Translates all members in the file into one member. *ALL is not valid with *DIF translation.
  • Page 189 When transferring a *TEXT file or any other file that was previously defined with DDS or F&I specs, use the default, *NONE, or its equivalent, *DDS. ETU400 User Guide 011603 Converts the file to BASIC Sequential format. Converts the file to BASIC Sequential format with tab characters as the delimiters.
  • Page 190 *FILE - FLDEFFILE file (the default value). *FIRST *LAST ETU400 User Guide 011603 The FLDDEFFILE member name. You can enter the Transfers the member with the same name as the Transfers the first member (arrival sequence) in the file.

  • Page 191: Glossary

    The “Appendices” provide reference and supplemental information. Inside ETU ETU Compatibility Creating DDS Specifications Creating F & I Specifications ETU Error Messages EBCDIC/ASCII Printable Characters System/36-mode Commands International Translational Tables ETU Automation ETU Throughput Considerations GLOSSARY INDEX ETU400 User Guide 011603 10-61...

  • Page 192: Appendix A

    Checking the Audit Trail Working With ETU Security Granting Authority to a Command Revoking Authority From a Command Regranting Authority to a Previously Revoked Command Securing Devices on the AS/400 Removing ETU From the AS/400 ETU400 User Guide 011603 Appendix A INSIDE ETU...

  • Page 193: About This Chapter

    Some tasks you can perform with the ETU utilities include: • adding user-defined menu options to the ETU menu; • changing how the ETU audit trail is configured; • granting and revoking authority to the ETU commands; • removing ETU from your AS/400. ETU400 User Guide 011603...

  • Page 194: Editing User-Defined Menu Options

    Main menu. NOTE: In order for the new menu option to display on the ETU Main menu, you must exit the ETU menu (press F3) and re-display the ETU menu by issuing the WSMENUS command. ETU400 User Guide 011603...

  • Page 195: Edtudf Parameters

    Specifies how the command will execute when selected from the ETU Main menu. *PMT *EXE ETU400 User Guide 011603 Valid entries are: Displays the prompt screen for the command specified in the Function parameter. Before the user-defined function can be executed, you must define the command request by entering values into the appropriate parameters.

  • Page 196: Edtudf Example

    7. Press Enter to add the user-defined function. 8. Press F3 to end the command and return to the Main ETU menu. For more information on EDTUDF, see Chapter 10, ETU Command Reference. ETU400 User Guide 011603...

  • Page 197: Configuring The Audit Trail

    . . . Library name: ..Hold spool file: ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 *YES *YES, *NO QPRINT Name *LIBL Name, *LIBL *YES...

  • Page 198: The Cfgaudit Parameters

    Determines whether the audit trail entries are placed on the output queue on hold status or are released to the printer. The default, *YES, places the entries on hold. To have the entries go directly to a printer, enter *NO. ETU400 User Guide 011603...

  • Page 199: Checking The Audit Trail

    Unsuccessful Not able to acquire device Unsuccessful Invalid return code from device during transfer Unsuccessful Invalid return code from device during decode Unsuccessful Invalid return code from device during allocate Unsuccessful Device Error Description A description of the file transfer operation. ETU400 User Guide 011603...

  • Page 200: Working With Etu Security

    It is not necessary to grant authority to commands other than the power commands. These commands can be used by all users because of their *PUBLIC object authority. ETU400 User Guide 011603 To revoke the power commands from...

  • Page 201: Revoking Authority From A Command

    To regrant authority to a power command, use the GRTOBJAUT command just as you would when first granting authority. To regrant authority to a non-power command, use the RVKOBJAUT command with *EXCLUDE as the value in the AUTHORITY parameter. ETU400 User Guide 011603 A-10...

  • Page 202: Securing Devices On The As/400

    30, all users have the authority to access all devices. To exclude a device from a user, follow standard system protocol for limiting device authority on the AS/400. For more information about securing devices, see AS/400 Security Concepts and Planning, SC21-8083. ETU400 User Guide 011603 A-11...

  • Page 203: Removing Etu From The As/400

    2. Enter the RMVETU command on the AS/400 command line and prompt (press F4): rmvetu The RMVETU prompt screen displays. 3. Enter the name of the AS/400 library containing the ETU programs. 4. Press ENTER. The ETU objects stored in the specified library are deleted. ETU400 User Guide 011603 A-12...

  • Page 204: Etu Compatibility

    Appendix B ETU COMPATIBILITY About this Appendix Using ETU with Autokey Batch Files Modifying an Autokey Batch File – Example ETU400 User Guide 011603...

  • Page 205: About This Appendix

    Autokey batch files that were used with earlier versions of ETU not to execute properly. This appendix explains which types of Autokey batch files may need to be modified, as well as how to modify them. ETU400 User Guide 011603...

  • Page 206: Using Etu 5.01 And Above With Autokey Batch Files

    4[FLX] instead of 16[FLX]. Use any text editor or word processor to change the batch file. This change enables the Autokey batch file to be compatible with versions of ETU later than 5.0. ETU400 User Guide 011603...

  • Page 207: Creating Dds Specifications

    Appendix C CREATING DDS SPECIFICATIONS About This Appendix Creating DDS Specifications ETU400 User Guide 011603...
  • Page 208 For example, you should know the field name, field length, and whether the field is numeric or alphabetic. This appendix shows you how to create DDS specs with PDM by providing an example for you to follow. ETU400 User Guide 011603...
  • Page 209 Harry Potter Vice President Gandalf Wizard Information Systems Manager Table C-1 Field definitions for file SAMPLE Field Name Field Length NAME TITLE SALARY CITY ETU400 User Guide 011603 45301 34500 57500 42300 32400 24300 00700 43200 23400 42300 76700 66600...
  • Page 210 Select one of the following: 1. Work with libraries 2. Work with objects 3. Work with members 9. Work with user-defined options Selection or command ===> F3=Exit F4=Prompt F12=Cancel F18=Change defaults ETU400 User Guide 011603 F9=Retrieve F10=Command entry (C) COPYRIGHT IBM CORP. 1981, 1996.
  • Page 211 DDS. If you are unsure, consult your system administrator. This example uses QGPL, the general purpose library. In the Member Name prompt, type SAMPLE. Press ENTER. ETU400 User Guide 011603 QDDSSRC Name, F4 for list *LIBL...

  • Page 212: File

    9=Save Member Type BASICTST QDSIGNON SAMPLDDS Parameters or command ===> F3=Exit F4=Prompt F9=Retrieve F10=Command entry ETU400 User Guide 011603 NLRISC Position to ..6=Print 13=Change text 14=Compile Text sample DDS spec F5=Refresh F23=More options 7=Rename 15=Create module...

  • Page 213: Library

    ..Text 'description' ..F3=Exit F4=Prompt F5=Refresh F24=More keys ETU400 User Guide 011603 Name, *PRV QGPL Name, *LIBL, *CURLIB, *PRV SAMPLE Name, *PRV, *SELECT *SAME Name, *SAME, BAS, BASP...
  • Page 214 ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ''''''' ****************** End of data *********************************************** F3=Exit F4=Prompt F5=Refresh F16=Repeat find F17=Repeat change Member SAMPLE added to file QGPL/QDDSSRC. ETU400 User Guide 011603 Edit F9=Retrieve F10=Cursor F11=Toggle F24=More keys...
  • Page 215 0001.00 ****************** End of data ************************************************ Prompt type . . . Name Type Functions F3=Exit F4=Prompt F5=Refresh F12=Cancel F23=Select prompt ETU400 User Guide 011603 Edit Sequence number . . . Name Length RECORD F11=Previous record F24=More keys 0001.00 Data Decimal...
  • Page 216 Columns . . . : QGPL/QDDSSRC SEU==> SAMPLE FMT PF ...A...T.Name++++++RLen++TDpB...Functions+++++++++++++++++++++++++++ *************** Beginning of data ********************************************* IP01.00 R RECORD 030107 ****************** End of data ************************************************ F3=Exit F4=Prompt F5=Refresh F16=Repeat find F17=Repeat change ETU400 User Guide 011603 Edit F9=Retrieve F10=Cursor F11=Toggle F24=More keys C-10...
  • Page 217 Type the number 17 in the Length prompt (be sure to press FIELD EXIT to move to the next field). Type the letter A in the Data Type prompt. Press ENTER. ETU400 User Guide 011603 Edit Sequence number . . . Name...
  • Page 218 Type the number 35 in the Length prompt (be sure to press FIELD EXIT to move to the next prompt.) Type an A in the Data Type prompt. Press ENTER. ETU400 User Guide 011603 Edit Sequence number . . . Name...
  • Page 219 Type the number 8 in the Length prompt (be sure to press FIELD EXIT to move to the next field.) Type an S in the Data Type prompt. Type the number 2 in the Decimal Positions prompt. Press ENTER. ETU400 User Guide 011603 Edit Sequence number . . . Name Length...
  • Page 220 Type the number 16 in the Length prompt (be sure to press FIELD EXIT to move to the next field.) Type an A in the Data Type prompt. Press ENTER. ETU400 User Guide 011603 Edit 8S 2 Sequence number . . .
  • Page 221 ****************** End of data **************************************************** Prompt type . . . Name Type Functions F3=Exit F4=Prompt F5=Refresh F12=Cancel F23=Select prompt ETU400 User Guide 011603 Edit 8S 2 Sequence number . . . Name Length F11=Previous record F24=More keys ''''''' Data Decimal...
  • Page 222 Return to editing ..Go to member list ..F3=Exit F4=Prompt F5=Refresh ETU400 User Guide 011603 Y=Yes, N=No SAMPLE Name, F4 for list QDDSSRC...
  • Page 223 SAMPLDDS SAMPLE Parameters or command ===> F3=Exit F4=Prompt F9=Retrieve F10=Command entry Member SAMPLE in file QGPL/QDDSSRC changed with 5 records. ETU400 User Guide 011603 NLRISC Position to ..6=Print 13=Change text 14=Compile Text sample DDS spec...

  • Page 224: Creating F&I Specifications

    Appendix D CREATING F&I SPECIFICATIONS About This Appendix Creating DDS Specifications ETU400 User Guide 011603...
  • Page 225 For example, you should know the field name, field length, and whether the field is numeric or alphabetic. This appendix shows you how to create F&I specs with SEU by providing an example for you to follow. ETU400 User Guide 011603...

  • Page 226: Name

    Harry Potter Vice President Gandalf Wizard Information Systems Manager Table D-1 Field definitions for file SAMPLE Field Name Field Length NAME TITLE SALARY CITY ETU400 User Guide 011603 45301 34500 57500 42300 32400 24300 00700 43200 23400 42300 76700 66600...
  • Page 227 Enter SAMPLE for the source member name. Enter RPG for the source type. The source for F&I specs is always RPG. Text 'description' is an optional field you can use to identify the F&I source member. ETU400 User Guide 011603 QRPGSRC Name, *PRV QGPL...
  • Page 228 The file name can be the same as the PC file name, although it's not necessary that it is. This example uses file name SAMPLE, which in this case is the same as the PC file name. ETU400 User Guide 011603 Sequence number . . . FSAMPLE...
  • Page 229 ****************** End of data ************************************************* Prompt type . . . Data area ...+... 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ETU400 User Guide 011603 The Type entry is not H, F, E, L, DISK Sequence number . . .

  • Page 230: Type

    This example uses filename SAMPLE. Type the letters NS for No Sequence in columns 15 and 16. After you press Enter, the input specification you've just created moves to the top of the screen. ETU400 User Guide 011603 F11=Previous record F24=More keys...
  • Page 231 Column 6 is the Form Type and must contain the letter I, which designates this record as an input specification. Use columns 44 through 47 to enter the beginning position of the Name field. This field starts at position 1. ETU400 User Guide 011603 DISK Sequence number . . . F11=Previous record...
  • Page 232 This field ends in position 17. Use columns 53 through 58 to title the field for reference. This example calls the field NAME. After you press Enter, the input specification you've just created moves to the top of the screen. ETU400 User Guide 011603...
  • Page 233 Column 6 is the Form Type and must contain the letter I, which designates this record as an input specification. Use columns 44 through 47 to enter the beginning position of the Job Title field. This field starts at position 18. ETU400 User Guide 011603 DISK 17 NAME Sequence number . . .
  • Page 234 This field ends in position 52. Use columns 53 through 58 to title the field for reference. This example calls the field TITLE. After you press Enter, the input specification you've just created moves to the top of the screen. ETU400 User Guide 011603 D-11...
  • Page 235 Column 6 is the Form Type and must contain the letter I, which designates this record as an input specification. Use columns 44 through 47 to enter the beginning position of the Salary field. This field starts at position 53. ETU400 User Guide 011603 DISK 17 NAME 52 TITLE Sequence number .
  • Page 236 ****************** End of data ************************************************* Prompt type . . . Data area ...+... 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 F3=Exit F4=Prompt F5=Refresh ETU400 User Guide 011603 DISK 17 NAME 52 TITLE 602SALARY Sequence number . . . F11=Previous record Edit 0006.00...
  • Page 237 Press the Tab key to move to the field to be changed, make any appropriate changes, and press ENTER. ETU400 User Guide 011603 D-14...
  • Page 238 F3=Exit F4=Prompt F5=Refresh For more information about F&I specifications, please refer to the IBM AS/400 Languages: Systems Application Architecture AD/Cycle RPG/400 Reference Manual SC09-1349-00. ETU400 User Guide 011603 Y=Yes, N=No SAMPLE Name, F4 for list QRPGSRC Name, F4 for list...

  • Page 239: Error Messages: Native Mode

    Appendix E ERROR MESSAGES: NATIVE MODE ETU400 User Guide 011603...

  • Page 240: About This Appendix

    This appendix lists the ETU error messages that are most likely to occur when you use ETU. The messages appear in order of their ETU message number, which precedes each message. For each message, you will find the error message number, message text, and possible causes and Solutions. ETU400 User Guide 011603...

  • Page 241: Usr Messages

    3. Type the error message (USR####) in the 'Position to . . .' field and press <Enter>. NOTE: If the error message does not show up here, it is not an ETU error message. NOTE: For CPF messages that are not in this document follow the above procedure using WRKMSGF QCPFMSG. ETU400 User Guide 011603...

  • Page 242: Transfer Problems

    Go to the folder on the driver where the actual file to be transferred exists. Right-click on it and select Properties to make certain it is not. The file name and folder can be long, and the extension up to 3 characters long, and have spaces. ETU400 User Guide 011603...

  • Page 243: User Messages

    The program you specified in the PGMTO3XB transfer in the library you specified already exists on the host. SOLUTION: If you want to overwrite the old host program with the new one, press G. This will permanently delete the old program. If you want to cancel the transfer request, press C. ETU400 User Guide 011603...
  • Page 244 The "OPEN FILE" command sent to the PC emulator failed because the file name specified was not found in the current directory on the PC disk/diskette. SOLUTION: Use the native command mode for ETU400. Correct the error and retry the command. PROBLEM: "USR1256 ETU transfer failed" sometimes tied with message: "COD0006 AA Unsuccessful.
  • Page 245 SOLUTION: Replace the diskette or specify a different disk drive. CAUSE: Virus protection software prevents the writing. SOLUTION: Disable the Virus protection software or the feature that prevents disk writing. ETU400 User Guide 011603...
  • Page 246 The PC file you specified was not found on the current PC disk or diskette. For micro to host file transfers, the micro file and directory (path) names specified must match exactly with the actual file and directory names. SOLUTION: Change the directory name (path) and retry the file transfer. ETU400 User Guide 011603...
  • Page 247 The values specified for the FILETYPE and TRANSLATE parameters are not compatible with each other SOLUTION: If the value for the FILETYPE parameter is *SAVF, the value for the TRANSLATE parameter must be *NO. USR8257 For FILETYPE equal to *SAVF, RECL must be equal to O or 528. CAUSE: ETU400 User Guide 011603...
  • Page 248 The values specified for the FILETYPE and RECL parameters are not compatible with each other. SOLUTION: If the value for the FILETYPE parameter is ~SAVF, the value for the RECL parameter must be O or 528. ETU400 User Guide 011603 E-10...
  • Page 249 While reading the DIF header statements, the DATA header item was not encountered or was incorrectly specified. SOLUTION: Check that the DATA record is followed by a record containing 0,0 and another record containing "". ETU400 User Guide 011603 E-11...
  • Page 250 PC file. PROBLEM “USR9985 Default data-area not found”. CAUSE: The library containing the ETU programs is not in your library list. SOLUTION: Add the library containing the ETU programs to your library list. ADDLIBLE PCTRAN ETU400 User Guide 011603 E-12...
  • Page 251 "Enter" key (rather than "Hot Keying" to DOS and loading the compatibility program) when the Copyright screen is displayed. ETU is currently only supported with NLynx/Decision Data’s ES32 emulation. There once was a DOS Compatibility disk with a program called IBMTRAN that enabled any emulation to work. This software only works with other DOS software using serial COM ports.
  • Page 252 Do not key inside the emulation screen during a transfer. Do not press <Enter> on the message regarding the number of day’s left. CAUSE: This could happen if the disk just got full. SOLUTION: Check the disk space on the PC. ETU400 User Guide 011603 E-14...

  • Page 253: Cpf Messages

    10 - Change the file name in the distributed data management (DDM) file with a Change DDM File (CHGDDMF) command or use the necessary procedures to make the file exist on the remote system. 11 - Change the library name in the distributed data management (DDM) file with a Change ETU400 User Guide 011603 E-15...
  • Page 254 Century format, and then transfer to the AS400 using P (packed) instead of L. PROBLEM: Adv36 running SSP and OS400 environment. OS400 side running. CPF5149 IO error was detected Xlation. ETU400 - is launched by WSMENUS. File is located on the QS36F library. CAUSE: QS36F is not in the library list.
  • Page 255 14 -- The length of a variable length field is not valid or the data in a substring variable is not valid. 15 -- A date value is greater than the maximum allowed value. 16 -- A date value is less than the minimum allowed value. ETU400 User Guide 011603 E-17...
  • Page 256 If the field name is *N, the field name is not known or is a default value. 25 -- Hash value cannot be computed for the requested query. ETU400 User Guide 011603 E-18...

  • Page 257: Sys Messages

    OCL's third. 5) If it's the S/36 ENVIRONMENT the files will usually be found in libraryQS36F (unless someone altered the default S/36EE file library – check with command DSPS36 and look at S/36 Environment Variables). ETU400 User Guide 011603 E-19...
  • Page 258 The installation requires some privileges that require the use of the security officer privileges. There is no work around as these capabilities are external to ETU and is intrinsic to the SSP. If a person lost the Security Officer password, the whole drive would have to be reformatted. ETU400 User Guide 011603 E-20...

  • Page 259: Ocl Problems

    On a command line, type PRTXTOPC and press F4. Use *TRANSLATE as the Action to perform. After successfully defining the parameters and submitting the command, use F9 to retrieve the command for the batch file transfer. Next use PWRFROM3XB to perform the actual transfer. ETU400 User Guide 011603 E-21...
  • Page 260 Select the Session menu, then Properties. • Select the API tab. • Make certain there is a check in Enable ETU. • Also make certain that the CL script is called by the PC that is running our emulation. ETU400 User Guide 011603 E-22...
  • Page 261 The library where the file exists is not in the library list. The file that you are trying to transfer is already open on the PC side. User does not have ETU support on his PC emulation. ETU400 User Guide 011603 E-23...
  • Page 262 The name of your device can be seen under the Menu – WSMENUS in the upper left. If you use F9 to replay the command the parameter to fix is MICLST. The device that you are going to use for the *REQUESTOR must be connected and at the signon screen. ETU400 User Guide 011603 E-24...
  • Page 263 SOLUTION: There is supposed to be a way to get around this using the SHARE command, however you can make two completely separate procedures; one to create the files and one to transfer the files. ETU400 User Guide 011603 E-25...

  • Page 264: Ascii-Ebcdic Printable Characters

    Appendix F ASCII-EBCDIC PRINTABLE CHARACTERS ETU400 User Guide 011603...
  • Page 265 About This Appendix This appendix lists the ASCII and EBCDIC characters and their hexadecimal equivalents. Use this table when you create or modify an ETU translation table. ETU400 User Guide 011603...
  • Page 266 ETU400 User Guide 011603 EBCDIC ASCII (space) " &...
  • Page 267 ETU400 User Guide 011603 (space) â ä à á å ç ñ ¢ < & é ê ë è í î ï ì ß ¬ â Ä à á Å Ç Ñ ¦...
  • Page 268 ETU400 User Guide 011603 > ø É ê ë è í î ï > " ø ¦...
  • Page 269 ETU400 User Guide 011603...
  • Page 270 ETU400 User Guide 011603...

  • Page 271: System/36-Mode Commands

    Appendix G System/36-mode Commands This appendix contains the commands used to emulate ETU36. ETU400 User Guide 011603...
  • Page 272 For this reason, System/36-specific commands are available in ETU/400. This appendix describes how to access the System/36-mode menu and how to execute the commands. Finally, this appendix describes each command available in Sytem/36 mode, listed in alphabetical order. ETU400 User Guide 011603...
  • Page 273 Figure G-1 The ETU36 menu Menu - ETU36 Emulator Transfer Utility S/36 COPYRIGHT (c) 1998, NLynx Systems PC Functions 1. Allocate New PC File 2. Rename PC File 3. Delete PC File 4.
  • Page 274 PRNTTOPC procedure. executes the FILEFRPC procedure. executes the LIBRFRPC procedure. executes the PRNTFRPC procedure. executes the EDITABLE procedure. executes the COMPILE procedure. The ETU36 procedures are described alphabetically in this chapter starting on page G-6. ETU400 User Guide 011603...
  • Page 275 System/36-mode commands ALLOCATE DELETE COMPILE FILEFRPC FILETOPC LIBRFRPC LIBRTOPC PRNTFRMPC PRNTTOPC RENAME TESTFILE XLT36FIL XLT36PRT XLTPCFIL XLTPCPRT ETU400 User Guide 011603 Their native mode equivalents ALOCATB DELETEB STRSEU TO3XB FROM3XB PGMTO3XB PGMFROM3XB PRTTO3X PRTFROM3X RENAMEB TESTB XLATETO PRTTOPC XLATEFROM PRTXFRMPC...
  • Page 276 The ALLOCATE procedure allocates a new file on the workstation. workstation file name ETU400 User Guide 011603 is the name of the workstation file to be allocated. For additional information, see “Workstation File Name” on page ____.
  • Page 277 If you execute the COMPILE procedure, it calls the native-mode ETU command EDITTABLE (used to compile the translate source member). See the EDITTABLE command in Chapter 10 for more information. ETU400 User Guide 011603...
  • Page 278 The DELETE procedure deletes a file on the workstation. workstation file name notify Mac Users: ETU400 User Guide 011603 The name of the workstation file to be deleted. For additional information, see “Workstation File Name” on page ____. Specifies whether you should be notified with a halt message if the workstation file is not found in the directory (optional).
  • Page 279 If you execute the EDITABLE function, it calls the native-mode ETU command STRSEU (used to edit the source member). See the STRSEU command in Chapter 10 for more information. ETU400 User Guide 011603...

  • Page 280: Filefrpc Procedure

    *NONE The FILEFRPC procedure transfers a file from the workstation to the AS/400, optionally translating the file into an AS/400 file format. workstation file name AS/400 label ETU400 User Guide 011603 xlate size record len2 1000 record len1 xlate size...
  • Page 281 (optional) is the number of records in the temporary work file used in the translation process. The default value is 1000. ETU400 User Guide 011603 (optional) is the record length of the target AS/400 file (“AS/400 label”). This value defaults to 128.
  • Page 282 The default is NO. spec lib (optional) is the library containing the field definition member (“input specs”), and the translate table member (“xlat table”). If left blank this parameter defaults to the current library. ETU400 User Guide 011603 G-12...

  • Page 283: Filetopc Procedure

    AS/400 file. *TEXT (or *YES)the file is to be translated into an *DIF *BASICS *TAB *SAVE *NONE ETU400 User Guide 011603 xlate file , xlate size , record len ETOA1 1000 , workstation file name xlate table ,...
  • Page 284 (“xlat table”). If left blank this parameter defaults to the current library. workstation file name the data from the AS/400. For additional information, see “Workstation File Name” on page 4-2. ETU400 User Guide 011603 is the name of the workstation file to receive G-14...

  • Page 285: Librfrpc Procedure

    YES, member name The LIBRFRPC procedure transfers and optionally translates a workstation file into library members on the AS/400. workstation file name record len1 ETU400 User Guide 011603 xlate file , xlate size , record len2 ETOA1 1000 , truncate...
  • Page 286 (optional) specifies whether or not (YES or NO respectively) to replace an existing library member without a warning message. The default value is NO. ETU400 User Guide 011603 the file is to be translated into an ASCII text format. the file is to be translated into a...
  • Page 287 Specify S for source and P for procedure. The default value is S. file size (optional) is the work file size for the “add ctl” process. This defaults to “xlat size”. ETU400 User Guide 011603 G-17...

  • Page 288: Librtopc Procedure

    (object type *SAVF) from the host. member lib (optional) is the name of the AS/400 library from which to extract the specified members. The default value is the current library. ETU400 User Guide 011603 member type PROC LIBRARY SOURCE file size...
  • Page 289 See Chapter 4, “File Transfer Facility,” for more information on creating F and I RPG specifications. ETU400 User Guide 011603 ASCII text format. the file is to be translated into a DIF format.
  • Page 290 (“xlat table”). If left blank, this parameter defaults to the current library. workstation file name the library members from the AS/400. For additional information, see “Workstation File Name” on page 4-2. ETU400 User Guide 011603 is the name of the workstation file to receive G-20...

  • Page 291: Prntfrpc Procedure

    (optional) specifies whether a forms alignment halt will be issued on the printer's console for this report. The default is NO. Hold (optional) specifies whether the report will be “held” ETU400 User Guide 011603 ,,, #copies forms id , 10 hold...
  • Page 292 (optional) specifies the width in columns of the file to be printed. Width may be 132 (the default) or 198. translate table (optional) specifies the name of the printer translation table you wish to use. The default is ATOE3. ETU400 User Guide 011603 G-22...

  • Page 293: Prnttopc Procedure

    If omitted, no action will be taken on the spool item. date (optional) is the date of the AS/400 COPYPRT file “AS/400 label” (YMD format). ETU400 User Guide 011603 spool name , xlat file , qualifier ETOA1 Fxxx...
  • Page 294 “from window”) is valid. The default value is 132. workstation file name the print file from the AS/400. For additional information, see “About Microcomputer Files” on page 3- ETU400 User Guide 011603 is the name of the workstation file that receives G-24...

  • Page 295: Rename Function

    The new file name field is 80 characters to make it consistent with other workstation-file-name fields. Mac Users: The directory dialog box is unavailable for the RENAME option on the ETU36 menu. ETU400 User Guide 011603 G-25...

  • Page 296: Testfile Procedure

    The remaining 8 bytes contain the workstation file size, if the file is found. The default is NOTIFY. ETU400 User Guide 011603 is the name of the workstation file to be tested. start at the specified LDA offset,...

  • Page 297: Xlt36Fil Procedure

    (until specifically deleted), and specifying J will result in the file being automatically deleted at the end of the current AS/400 job. The default value is T. ETU400 User Guide 011603 date AS/400 label2, , xlate file , xlate size...
  • Page 298 (“input specs”), and the translate table member (“xlat table”). If left blank this parameter defaults to the current library. ETU400 User Guide 011603 the file is to be translated into an ASCII text format. the file is to be translated into a DIF format.

  • Page 299: Xlt36Prt Procedure

    Blank is the default, meaning “Do not change the print status.” date-1 optional) is the date of the AS/400 COPYPRT file “AS/400 label1”. ETU400 User Guide 011603 spool name Fxxx AS/400 label1, mode , AS/4oo label2,...
  • Page 300 (optional) is the print column position of the report(s) on which to end translation. Any number from 1 to 198 is valid (it must be equal to or larger than the number specified in “from window”). The default value is 132. ETU400 User Guide 011603 G-30...

  • Page 301: Xltpcfil Procedure

    Allowed values are T or J. Specifying T results in the file existing indefinitely (until specifically deleted), and specifying J will result in the file being automatically deleted at the end of the current AS/400 job. The default value is T. ETU400 User Guide 011603 date xlate file ATOE1 truncate...
  • Page 302 (“input specs”), and the translate table member (“xlat table”). If left blank this parameter defaults to the current library. ETU400 User Guide 011603 the file is to be translated into an ASCII text format. the file is to be translated into a DIF format.

  • Page 303: Xltpcprt Procedure

    The default is NO. hold (optional) specifies whether the report will be “held” on the print spool until the operator releases it for printing. The default is NO. ETU400 User Guide 011603 date forms id , cpi , lpi ,...

  • Page 304: International Translation Tables

    Appendix H INTERNATIONAL TRANSLATION TABLES ETU400 User Guide 011603...

  • Page 305: Installing International Translation Table

    Installing International Translation Table NLynx Technologies now supports sixteen languages for the ETU/400 file transfer programs on the AS/400 host computer: Country Belgian French Canadian French Danish French German Italian Norwegian Portuguese Swiss French Swiss German Spanish Finnish Swedish U.K. English U.S.

  • Page 306: Appendix I

    This section is intended as an explanation of the considerations that one must make when one is trying to automate file transfers using ETU400. It is usually easier to handle the function of automating the process on the AS/400 itself, vs. using PC macros.

  • Page 307: Automation Mechanisms

    *YES. When you want to resubmit the command, type VWSAVRQS on a command line to bring it up. See page 9-17 and 10-56 of the ETU400 User Guide for specifics. SBMBATXFER This command allows you to post a transfer from the AS/400 to a PC that has ES32 with ETU enabled, and is at the signon screen.
  • Page 308 ETU commands: PWRFROM3XB, PWRTO3XB, PCFROMPC, and PCTOPC, as well as non-ETU commands that can be submitted to a batch. See page 9-21 and 10-47 of the ETU400 User Guide for specifics. ETU400 User Guide 011603...

  • Page 309: Etu Throughput Considerations

    Appendix J ETU THROUGHPUT CONSIDERATIONS ETU400 User Guide 011603...

  • Page 310: What Kind Of Throughput Can I Expect?

    What can I do to improve the throughput? ANSWER: Move to a faster connection. Perform the transfer during times when the system and or network are not so busy. Specify the exact form length and/or record length. ETU400 User Guide 011603...
  • Page 311 By the way, our ES/TCP has IFS support built in. QUESTION: What are the pros and cons of using ETU400? ANSWER: ETU is menu-driven and easy to use. ETU supports CSV translation Basic Sequential, or Differential translation.
  • Page 312 QUESTION: How would I use ETU400 and FTP? ANSWER: If you use ETU reasonably often and wish the file transfers quicker, for say files that are over 100,000 records, this is a way to do it. 1. Use ETU to only translate the file. Put the translated file in your private library. Don't use QTEMP.
  • Page 313 DIF format EBCDIC character set ETU400 User Guide 011603 GLOSSARY To create a file on the microcomputer. Application Program Interface. The interface (calling conventions) by which an application program accesses operating system and other services.
  • Page 314 System/36 mode Tab format Text format ETU400 User Guide 011603 Format and Input specifications. A means of creating internal file definitions on the AS/400. ETU supports F&I specs. The AS/400 computer and its peripherals. An interface program for PCs that is included with ETU.

Table of Contents