About This Chapter | Nlynx ETU400 specification

About This Chapter

This chapter explains the ETU translation commands. These commands are used in conjunction with the ETU transfer commands. If, when you transfer a file, you specify no translation, you will translate it using one of the commands described in this chapter.

There are four ETU translation command:

•XLATEFROM--Translates a microcomputer ASCII file to a host physical file format. This is for use with micro files that were previously transferred to the host using the TO3XB command with *NONE as the translation type;

•XLATETO--Translates a host physical file to ASCII. You can then transfer the file to the micro using the FROM3XB command with *NONE as the translation type;

•PRTXFRMPC--Translates a host print file to a PC print file format prior to transferring the file with the PRTFROMPC command;

•PRTXTOPC--Translates a PC print file to a host print file format after you transfer the file to the host with the PRTTOPC command.

These commands can be run interactively from the micro, or in batch mode from any micro or host terminal.

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

6-2

Image 77

Nlynx ETU400 manual About This Chapter

Contents

ETU400 Permitted and Intended Uses Definitions Prohibited Uses Limited Warranty NLynx Technologies, Inc. All rights reserved Legal Notices Preface Trademark Recognition How This Guide is Organized About This GuideWho Should Use This Guide? Introduction Using ETU Transferring Files Modifying Translation Tables 10-1 ETU Command Reference Creating DDS Specifications Appendix D Creating F&I Specifications International Translation Tables Getting Started Chapter Introduction What ETU Can Do for You Welcome to ETUETU Function Security Profile Required Qsecofr Security Considerations Inventory Checklist Software Requirements Hardware and Software RequirementsHardware Requirements Features of Version Features of Version Features of Version Compatibility with Non-ES32 Emulation Products Native Mode and System/36 Mode Part One, Getting Started Installing ETU About This Chapter Installing the ETU Software Installing ETU ELIBNAMexisting-librarySVTRANLsave-translations Old versions, since most users do not modify these tables Registering Your Host System Using ETU During the Evaluation Period Obtaining Your Host Registration Number Re-installing ETUEntering the Registration Code Dspsysval sysvalqsrlnbr Technical Support Installing ETU For International UsersRemoving ETU From Your Host System Who Could Use IBMTRAN? ETU Compatibility Diskette For Non-ES32 Emulation ProductsCopying Ibmtran To Your Hard Drive IBMTRAN.EXE Exiting Ibmtran Starting ETU When Using IbmtranAlternative Method to Start and Exit Ibmtran Ibmtran PC-DOS Using ETU About This Chapter Starting ETU Nlriscliff ETU Main Menu ETU Utilities Menu ETU Commands Entering Commands on the Command Line Running ETU CommandsUsing the Menu Using Mac Directory Dialog Boxes Using the Command Prompts Request Definitions Recalling ETU Commands Batch ETU Commands Interactive ETU CommandsTypes of Processing Strseu Apple Mac About Microcomputer FilesFile Formats Learning about ETU About This Chapter Data Transfer What is ETU?Data Translation Other ETU Functions Micro and Host File Names About Transferring Files Host File Type Transferring Data to Host FilesRecord Length Data Description Specifications How Data is Stored About Translating Files Translate Using Translation Tables ETU Translation Table Members Mactab Using Translation Tables with the Mac FROM3XB Prttopc TO3XB Prtfrmpc PWRFROM3XB PWRTO3XB Using Microcomputer Data Formats Vectors Tab format *TAB DIF format *DIFTuples DATA0,0 Running ETU Transferring Files About This Chapter FROM3XB Example Transferring Data FilesTransferring Data Files From Host to a Microcomputer FROM3XB prompt screen TO3XB prompt screen Filetype*data srcseq*no translate*none TO3XB Example About Host Spool Files Transferring Print FilesTransferring a Host Spool File to a PC Print File User1 PRTFROM3X Example PRTFROM3X Print Queue Screen ATOE3 Transferring a PC Print File to the Host PRTTO3X Example Transferring Host Programs Transfer Host Programs to a Microcomputer PGMFROM3XB Command Beta1 PGMFROM3XB Example PGMTO3XB prompt screen Transfer Host Programs to the Host Userpgm PGMTO3XB Example Translating Files About This Chapter Translation Commands Can Run in Batch Mode Why Use the Translation CommandsTranslation Commands Can Be Run From a Host Terminal Translation Commands Reduce Modem Time Filetype*data, srcseq*no, translate*no Translating Data Files Rs132 Xlatefrom Example Tab Home1 Strip*no translate*no Translating a Host File to Microcomputer Format Xlateto Example Prtxfrmpc Example Translating PC Print Files Prtxfrmpc CommandTranslating Print Files ETU400 User Guide Last Translating Host Spool Files Prtxtopc Command Print2 Prtxtopc ExampleCopyprt Letter2 Working with PC Functions ETU400 User Guide Renameb Example Rename a Micro File Renameb Command\data.pgm Data1.pgm \reports\sales.feb Allocate a Micro File Alocatb CommandAlocatb Example Deleteb prompt screen Delete an Existing File Deleteb Command \report\fiscal.doc Deleteb Example \datafile.doc Test for the Existence of a Micro File Testb CommandTestb Example Modifying Translation Tables About This Chapter About Translation Tables Modifying a Translation Table Translation Table Record Format Make a Copy of the Original TableEditing the Translation Table Text DIF Basics TAB To HEX End-of-Record Action Translate Before/AfterPad Character Comments End-of-File Action XBA PAD EOR EOF Comments Sample Translation TableOmit unprintable characters Numeric Characters Naming the New Member Compiling the New Translation Member Advanced ETU Features About This Chapter Qualified file name Multiple-device TransferTransferring From Multiple Micros Multi Member nameFile PRT2AD3 Using PWRTO3XB Frmfile Transferring a Host File to Multiple Micros Micro-to-micro Transfers Pcfrompc Command MICLST1 QFNAME1 Pctopc Command TrainingTest Transferring Files Between Multiple MacesMac File Transfer Examples If InterAxcess is one or more folders deep Transferring Selected Fields Record and Field SelectionAbout Creating Auxiliary Storage Pools Key field Field name Field Selection -- Example Salary Employee name Relationship Transferring Selected RecordsField to be tested Relational operator Record Selection -- Example Record Selection -- Example1 Example Entry and Exit Programs Deleting Files After Transfer Saving Request Definitions Re-using Request Definitions Fold/Unfold Execute Submit Batch Transfer prompt screen Performing Batch Transfers Qbatch Batch Transfer ExamplePcfrompc Time and Date Scheduling Enter Time and Date Scheduling ExampleNight Command Reference ETU Command Reference Parameter description Parameter name Parameter values Alocatb CommandQfname Dspstsmsg Notify Deleteb Command Mac Tables Edittable CommandPC-DOS Tables 10-5 Edtudf Command Edtudf Notes FROM3XB Command 10-9 10-10 Strip*no, translate*no FROM3XB Notes MICLIST2 Pcfrompc CommandMICLIST1 XXXXXXXX.XX Pctopc Command 10-15 Tgtrls Current PGMFROM3XB CommandPGM PGMTO3XB Command ET0A1 PRTFROM3X CommandOutq PRTFROM3X Translate prompt screen PRTTO3X Command 10-21 Pcmbr Prtxfrmpc Command Library LPI Prtxtopc Command 10-25 10-26 Miclist Requester Pwrdeleteb Command PWRFROM3XB Command Exitpgm Entrypgm 10-30 10-31 10-32 10-33 Pwrrenameb Command PWRTO3XB Command 10-36 10-37 10-38 10-39 10-40 Renameb Command Sbmcmdname Sbmbatxfer CommandJobd Userprf Before You Begin Sbmschjob CommandSbmcmd Today To Schedule a Job Source file member name Strseu CommandPC-DOS Members Mac Members 10-46 YES Testb Command Flddeffile YES TO3XB CommandTruncate 10-49 10-50 10-51 Vwsavrqs Notes Vwsavrqs CommandSubmit to batch Change 10-53 MBR Xlatefrom CommandJobd YES DDS 10-55 10-56 Jobd SRC Xlateto CommandPcdata Last 10-58 10-59 10-60 Creating F & I Specifications Creating DDS SpecificationsETU Error Messages System/36-mode Commands Appendix a Inside ETU About This Chapter Editing User-defined Menu Options Mode Edtudf Parameters Edit User-defined Functions Edtudf ExampleEdtudf Pmt Figure A-1 The Cfgaudit prompt screen Configuring the Audit Trail Cfgaudit Parameters Checking the Audit Trail Grtobjaut Granting Authority to a CommandWorking with ETU Security Rvkobjaut Revoking Authority From a CommandRegranting Authority to a Previously Revoked Command Unable to open display file with device specified Securing Devices on the AS/400 Rmvetu Removing ETU From the AS/400 Appendix B ETU Compatibility About This Appendix Modifying an Autokey Batch File Example Using ETU 5.01 and above with Autokey Batch FilesETU ENT ETU Appendix C Creating DDS Specifications About This Appendix Field Name Field Length Field Type Decimal Positions Creating DDS Specifications Figure C-2 The AS400 PDM screen Figure C-3 The Select Members screen Figure C-4 The Work With Members screen Figure C-5 The Start Source Entry Utility screen Figure C-6 The SEU Edit screen Figure C-7 The SEU Edit Screen after F4 prompt Figure C-8 The SEU Edit Screen Figure C-9 SEU Edit screen Figure C-10 The SEU Edit screen Figure C-11 The SEU Edit screen Figure C-12 The SEU Edit screen Figure C-13 The SEU Edit screen Figure C-14 The SEU Exit screen Figure C-15 The PDM screen Appendix D Creating F&I Specifications About This Appendix Creating F & I Specifications Figure D-2 The Start Source Entry Utility screen Figure D-3 The SEU Edit screen Figure D-4 The SEU Edit screen for line ETU400 User Guide Figure D-5 The SEU Edit screen for line ETU400 User Guide Figure D-6 SEU Edit screen for line ETU400 User Guide Figure D-7 SEU Edit screen for line Figure D-8 SEU Edit screen for line ETU400 User Guide Figure D-9 The SEU Exit screen Appendix E Error Messages Native Mode About This Appendix USR Messages Transfer Problems User Messages USR1255 File &1 was not found on the PC disk/diskette USR4001 The PC disk/diskette is full Transfer ended Timing problem Or on ETU36 Solution Host file you specified could not be found Addlible Pctran Only known cause was a remote controller Trying to type during a transfer CPF Messages QS36F is not in the library list CPF5035 Data mapping error on member ETU400 User Guide SYS Messages Problem OCL Problems Problem Change it back and IPL Etunew Problem Appendix F ASCII-EBCDIC Printable Characters About This Appendix Ebcdic Ascii 100 101 102 103 104 105 106 107 108 ETU400 User Guide 202 CA 203 CB 204 CC 205 CD 206 CE 207 CF 208 D0 221 DD 222 DE 223 DF 224 E0 225 E1 Appendix G System/36-mode Commands About This Appendix Strs36 Starting ETU in System/36 ModeETU36 Menu ETU400 User Guide Native Commands Not Supported in the System/36 Mode Running ETU in System/36 ModeSystem/36-mode Commands and Native Mode Equivalents Menu ETU36, your ETU library name ETU36 Allocate Allocate Procedure Compile Procedures Workstation file name Delete ProcedureNotify Mac Users Editable Procedure Text ATOE1 Filefrpc ProcedureBasics TAB Save None Retain Record len1Reformat Text or *YES Input specs Record len2Truncate Spec lib Date Filetopc ProcedureText ETOA1 ETU400 User Guide YES DIF Librfrpc Procedure Replace Xlat sizeLib name File size Add ctlMember type Proc Librtopc ProcedureLibrary ALL Source Partall Remove ctl ETU400 User Guide Prntfrpc Procedure Width Procedure Prnttopc ProcedureSpool name Qualifier ETU400 User Guide Rename Function Testfile Procedure AS/400 label2 XLT36FIL ProcedureAS/400 label1 Performedthe default Date-1 XLT36PRT ProcedureFunction To window Date-2From window Xltpcfil Procedure Basic Sequential format with Xltpcprt Procedure Appendix H International Translation Tables Country Installing International Translation TableRstobj OBJSRCxx Savlibnewtable DEVdevice-name RSTLIByyyyyy Crttable SRCxx TRANLIBlibrary-name Appendix ETU400 Automation Automation Mechanisms ETU400 User Guide Appendix J ETU Throughput Considerations What kind of throughput can I expect? What other options are there to ETU? How would I use ETU400 and FTP? Ascii character set AllocateBatch processing Data transfer Host system System/36 modeInteractive processing Job queue