Nlynx ETU400 ALOCATB Command

ETU400 User Guide 011603 10-2

ALOCATB Command

Parameter description Parameter name Parameter values

Qualified file name QFNAME micro file name

Display status message? DSPSTSMSG *YES or *NO

The ALOCATB command allocates (creates) an empty file on the micro.

QFNAME The name of the micro file to be allocated. For additional

information, see 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.

Contents

Main SOFTWARE LICENSE AGREEMENT Page Page Legal Notices This document is for use with the NLynx Technologies ETU/400 product. 2000 NLynx Technologies, Inc. All rights reserved. Warning: PREFACE Trademark Recognition. About This Guide Who Should Use This Guide? How This Guide is Organized INTRODUCTION 1-1 INSTALLING ETU 2-1 USING ETU 3-1 LEARNING ABOUT ETU 4-1 TRANSFERRING FILES 5-1 TRANSLATING FILES 6-1 WORKING WITH PC FUNCTIONS 7-1 MODIFYING TRANSLATION TABLES 8-1 ADVANCED ETU FEATURES 9-1 ETU COMMAND REFERENCE 10-1 INSIDE ETU A-1 APPENDIX C B-1 ETU COMPATIBILITY B-1 CREATING DDS SPECIFICATIONS C-1 APPENDIX D D-1 CREATING F&I SPECIFICATIONS D-1 ERROR MESSAGES: NATIVE MODE E-1 ASCII-EBCDIC PRINTABLE CHARACTERS F-1 SYSTEM/36-MODE COMMANDS G-1 INTERNATIONAL TRANSLATION TABLES H-1 ETU AUTOMATION I-1 ETU THROUGHPUT CONSIDERATIONS J-1 Page Chapter 1 INTRODUCTION Welcome to ETU What ETU Can Do for You Inventory Checklist Security Considerations Hardware and Software Requirements Hardware Requirements Software Requirements Features of Version 5.02 Features of Version 5.041 Features of Version 5.5 Features of Version 5.6 Notes to Mac Users Compatibility with Non-ES32 Emulation Products Native Mode and System/36 Mode Page Chapter 2 INSTALLING ETU Page Installing ETU Installing the ETU Software target-library save-translations existing-library target-library existing-library save-translations Page Registering Your Host System Using ETU During the Evaluation Period Obtaining Your Host Registration Number Entering the Registration Code Re-installing ETU Removing ETU From Your Host System Installing ETU For International Users Technical Support The ETU Compatibility Diskette: For Non-ES32 Emulation Products Who Could Use IBMTRAN? Copying IBMTRAN To Your Hard Drive Starting ETU When Using IBMTRAN Exiting IBMTRAN Alternative Method to Start and Exit IBMTRAN Chapter 3 USING ETU Page Starting ETU A Note About User 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 Running ETU Commands Using the Menu Entering Commands on the Command Line Using the Command Prompts Using Mac Directory Dialog Boxes Recalling ETU Commands Request Definitions Types of Processing Interactive ETU Commands Batch ETU Commands About Microcomputer Files File Formats PC-DOS Apple Mac Chapter 4 LEARNING ABOUT ETU Page What is ETU? Data Transfer Data Translation Other ETU Functions About Transferring Files Micro and Host File Names 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 Page Using Microcomputer Data Formats Page Part Two Running ETU Chapter 5 TRANSFERRING FILES Page Transferring Data Files Transferring Data Files From Host to a Microcomputer: FROM3XB Example Page Transferring Data Files From a Microcomputer to the Host: The TO3XB Command TO3XB Example Transferring Print Files Transferring a Host Spool File to a PC Print File: About Host Spool Files PRTFROM3X Example Page Transferring a PC Print File to the Host: PRTTO3X Example Transferring Host Programs Transfer Host Programs to a Microcomputer: The PGMFROM3XB Command PGMFROM3XB Example Transfer Host Programs to the Host: PGMTO3XB Example Chapter 6 TRANSLATING FILES Page Why Use the Translation Commands Translation Commands Can Run in Batch Mode Translation Commands Can Be Run From a Host Terminal Translation Commands Reduce Modem Time Translating Data Files Translating a Microcomputer File to a Host Format: The XLATEFROM Command XLATEFROM Example Page Translating a Host File to Microcomputer Format: XLATETO Example Translating Print Files Translating PC Print Files: The PRTXFRMPC Command PRTXFRMPC Example Page Translating Host Spool Files: The PRTXTOPC Command PRTXTOPC Example Chapter 7 WORKING WITH PC FUNCTIONS Page Rename a Micro File: The RENAMEB Command RENAMEB Example Figure 7-1 The RENAMEB prompt screen Allocate a Micro File: The ALOCATB Command ALOCATB Example Delete an Existing File: The DELETEB Command DELETEB Example Test for the Existence of a Micro File: The TESTB Command TESTB Example Chapter 8 MODIFYING TRANSLATION TABLES Page About Translation Tables Modifying a Translation Table Make a Copy of the Original Table Editing the Translation Table Translation Table Record Format Position in the Record Functions (Record Fields) Number of FROM Characters Maximum Number of Table Entries Page Page Sample Translation Table Compiling the New Translation Member Naming the New Member ETU400 User Guide 011603 Chapter 9 ADVANCED ETU FEATURES Page Multiple-device Transfer Transferring From Multiple Micros Page Using PWRTO3XB Transferring a Host File to Multiple Micros Micro-to-micro Transfers The PCFROMPC Command Page The PCTOPC Command Transferring Files Between Multiple Maces Mac File Transfer Examples If InterAxcess is located at the root level of the hard drive If InterAxcess is one or more folders deep Record and Field Selection About Creating Auxiliary Storage Pools Transferring Selected Fields Page 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 Saving Request Definitions Re-using Request Definitions Page Performing Batch Transfers Batch Transfer Example Time and Date Scheduling Time and Date Scheduling Example Page Chapter 10 ETU COMMAND REFERENCE ALOCATB Command DELETEB Command EDITTABLE Command Page EDTUDF Command EDTUDF Notes FROM3XB Command Page Page FROM3XB Notes PCFROMPC Command Warning: PCTOPC Command Page PGMFROM3XB Command PGMTO3XB Command PRTFROM3X Command ETU400 User Guide 011603 Figure 10-1 The PRTFROM3X Translate prompt screen The screen that you get with 2=Copyprt & Transfer The screen you get with 1=Copyprt Figure 10-2 The PRTFROM3X Transfer prompt screen PRTTO3X Command Page PRTXFRMPC Command Page PRTXTOPC Command Page Page PWRDELETEB Command PWRFROM3XB Command Page + Page Page Page PWRRENAMEB Command PWRTO3XB Command Page Page Page Page Page RENAMEB Command SBMBATXFER Command SBMSCHJOB Command Before You Begin To Schedule a Job STRSEU Command Page TESTB Command TO3XB Command Page Page Page VWSAVRQS Command VWSAVRQS Notes Page XLATEFROM Command Page Page XLATETO Command Page Page Page Part Four Appendices Appendix A INSIDE ETU Page Editing User-defined Menu Options EDTUDF Parameters EDTUDF Example Configuring the Audit Trail The CFGAUDIT Parameters 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 Page Page Using ETU 5.01 and above with Autokey Batch Files Modifying an Autokey Batch File Example Page Page Creating DDS Specifications Page Page Page ETU400 User Guide 011603 ETU400 User Guide 011603 Page ETU400 User Guide 011603 Page Page Page Page Page Page Page Page Page Creating F & I Specifications Page Page Page Page Page Page Page Page Page Page Page Page Page Page USR MESSAGES: TRANSFER PROBLEMS: USER MESSAGES: Page Page Page Page Page Page Page Page Page CPF MESSAGES: Page Page Page SYS MESSAGES: Page OCL PROBLEMS Page Page Page Page Page Page Page Page Page Page Page Page Page Starting ETU in System/36 Mode The ETU36 Menu Page Running ETU in System/36 Mode Native Commands Not Supported in the System/36 Mode System/36-mode Commands and Native Mode Equivalents Page Page DELETE Procedure Page FILEFRPC Procedure Page Page FILETOPC Procedure Page LIBRFRPC Procedure Page Page LIBRTOPC Procedure Page Page PRNTFRPC Procedure Page PRNTTOPC Procedure Page RENAME Function TESTFILE Procedure XLT36FIL Procedure Page XLT36PRT Procedure Page XLTPCFIL Procedure Page XLTPCPRT Procedure Page Installing International Translation Table Appendix I ETU Automation ETU400 Automation AUTOMATION MECHANISMS SBMBATXFER SBMSCHJOB Page Page ETU THROUGHPUT CONSIDERATIONS What kind of throughput can I expect? Page Page GLOSSARY