5250 ALLY TM Intelligent Protocol Converter 5250 ALLY MODE TM Users Guide and Reference AGILE 875 Alfred Nobel Drive Hercules, CA 94547-1899 TEL (510) 724-1600 TEL (800) 538-1634 FAX (510) 724-9624 Customer Support: FAX (510) 724-2222 E-MAIL tech@agileinc.
Page ii AGILE 5250 ALLY Users Guide and Reference Copyright Information ©1995 AGILE All rights reserved. Copyright protection claimed includes all forms and matters of copyrightable material and information now allowed by statutory or judicial law or hereinafter granted. AGILE is a registered trademark of AGILE. 5250 ALLY and all other AGILE products mentioned in this publication are trademarks of AGILE.
PREFACE Page iii About AGILE In 1978 IBM and the word compatible were rarely found together, but IBMs mainframe customers wanted a less expensive, more flexible printing solution than IBM offered them. They wanted value, performance and features that only ASCII printers could provide. They wanted freedom of choice.
Page iv AGILE 5250 ALLY Users Guide and Reference Also From AGILE 5250 OPTIMA An intelligent protocol converter that enables serial and parallel ASCII and EBCDIC printers to be attached to a System/3X or AS/400 midrange computer. Up to three twinax addresses are supported. Its alternate host feature allows the midrange host and PC to share the same printer without an A/B switch.
PREFACE Page v AGILE Product Warranty Standard Warranty AGILE warrants to the original purchaser that this product will be free from defects in materials and workmanship and in good working order per the functional specifications current at the time of shipment for a period of two (2) years from the date of shipment to the purchaser.
Page vi AGILE 5250 ALLY Users Guide and Reference downtime or delay, labor repair or material costs, injury to person or property, or any similar or dissimilar consequential or inconsequential loss or damage resulting from this product, its use, or arising out of any breach of warranty, even if AGILE or an authorized AGILE dealer has been advised of the possibility of such damage, or for any claim by any other party.
PREFACE Page vii FCC Statement This equipment generates, uses and can radiate radio frequency energy. If it is not installed and used in strict accordance with AGILEs instructions, it may cause interference to radio and television reception.
Page viii AGILE 5250 ALLY Users Guide and Reference About the AGILE 5250 ALLY The AGILE 5250 ALLY is a powerful, easy-to-use, intelligent protocol converter/printer interface controller that enables an industry-standard, parallel, ASCII or EBCDIC printer to be attached to an IBM AS/400 or a System 34, 36 or 38. The alternate host port allows the attached printer to be shared with a PC, PC LAN, file server, print sharing device, protocol converter or another parallel-attached alternate host input device.
PREFACE Page ix Programmable function strings, computer output reduction (COR) and user-editable font correspondence tables are also standard features. The unit is user-configurable for full SCS formatting support on virtually any printer. Throughput is rated at 35 logical pages per minute at 100% print density in IBM emulation, or 55 logical pages per minute at 100% print density in 275 emulation. 100% print density is defined as 132 columns by 66 lines, for a total of 8712 characters per page.
Page x AGILE 5250 ALLY Users Guide and Reference 5250 ALLY Features and Specifications Host Systems Supported IBM AS/400 IBM System 34/36/38 IBM Specifications SCS/DCA FFT data stream support Twinax cable attachment (AWM 2498) to AS/400 or System/3X computer system Input/Output Ports IBM Twinax Port 2 DB-25 Parallel Ports (1 input, 1 output) Host Interface Intelligent T connector with automatic termination/cablethrough One twinax address (session/logical unit) with automatic address val
PREFACE Page xi Programmability Twinax host data stream Alternate host data stream 5250 ALLY front panel User Programmable Function Strings (PFSs) 512 PFSs dynamically allocated up to 20K bytes total Transparency IBM 35h ASCII 03h (in IBM emulation mode) Xerox Metacode 35h (in IBM emulation mode) i-data pseudo transparency (in IBM emulation mode) Xerox 36h (in Xerox 275 emulation mode) MPI pseudo transparency (in Xerox 275 emulation mode) Translation Translation tables can be selecte
Table of Contents Preface Copyright Information ................................................................................ ii Release Notes .............................................................................................. ii About AGILE ............................................................................................. iii Also From AGILE ...................................................................................... iv 5250 OPTIMA ........................................
Page xvi AGILE 5250 ALLY Users Guide and Reference Space Requirements .......................................................................... 1-3 Electrical Requirements .................................................................... 1-3 Operating Environment .................................................................... 1-3 Unpacking ................................................................................................ 1-4 Package Contents ........................................
TABLE OF CONTENTS Page xvii 3 Twinax Modes ........................................................................ 1-16 4 Twinax Timeout ...................................................................... 1-17 Configuring the Parallel Out Printer Port .............................................. 1-17 5 Printer Configurations Available ............................................ 1-18 Configuring the Parallel In Alternate Host Port ....................................
Page xviii AGILE 5250 ALLY Users Guide and Reference 46 Vertical Movement ............................................................... 2-11 47-49 Resolution ........................................................................ 2-12 4A-4D Offset.............................................................................. 2-13 4E Percentage Vertical Reduction in COR ............................... 2-15 4F CPI/Font Order .....................................................................
TABLE OF CONTENTS Page xix 05 EBCDIC to PC ...................................................................... 3-15 06 EBCDIC to PostScript .......................................................... 3-16 07 Xerox 275 Protocol Converter EBCDIC to ASCII .............. 3-17 08 User Table 1 .......................................................................... 3-18 09 User Table 2 .......................................................................... 3-19 0A User Table 3 ...............
Page xx AGILE 5250 ALLY Users Guide and Reference 16 P 16CPI ................................................................................. 4-14 17 P 17CPI ................................................................................. 4-14 18 L 5CPI ................................................................................... 4-15 19 L 8CPI ................................................................................... 4-15 1A L 10CPI ............................................
TABLE OF CONTENTS Page xxi 44 DEST1 ................................................................................... 4-26 45 DEST2 ................................................................................... 4-26 46 DEST3 ................................................................................... 4-26 4B JOBSTRT ............................................................................. 4-26 4C JOBEND ...........................................................................
Page xxii AGILE 5250 ALLY Users Guide and Reference Step 5: Configuration Test .............................................................. 5-34 Step 6: Twinax Host Test................................................................ 5-34 Step 7: Alternate Host Test ............................................................. 5-34 Other Issues ..................................................................................... 5-34 Orientation .........................................................
TABLE OF CONTENTS Page xxiii 0601 PFS Suppression .............................................................. A-15 0602 Form Feed Suppression ................................................... A-16 0603 Change Form Feed to New Line ..................................... A-17 0604 Logical Not Commands ................................................... A-17 0605 Job Restart to Form Feed Translation ............................. A-18 0606 Metacode Transparency ................................
Page xxiv AGILE 5250 ALLY Users Guide and Reference Justify Text Field (JTF) ..................................................................B-22 Set Justify Mode (SJM) ..................................................................B-23 Set Horizontal Margins (SHM) ......................................................B-24 Set Presentation Page Size (SPPS) .................................................B-25 Set Single Line Distance (SSLD) ...................................................
CHAPTER 1 GETTING STARTED Overview / Objectives This chapter provides information on installing the AGILE 5250 ALLY. Sections of this chapter provide instructions regarding: Choosing a location for the 5250 ALLY Physical interfacing to the host System, printer and alternate host Configuring the 5250 ALLY for communication with the host System, printer and alternate host All physical interfacing should be performed before the 5250 ALLY is turned on.
Page 1-2 AGILE 5250 ALLY Users Guide and Reference The commands can control all formatting aspects, including orientation and paper size, the amount of justification and special print features like bolding and underlining. Industry-standard printers are not capable of understanding or interpreting either the commands or the hexadecimal values representing printable characters.
CHAPTER 1 GETTING STARTED Page 1-3 Selecting a Location The compact size, quiet operation and attractive styling of the 5250 ALLY allow it to be placed in almost any location with a flat, stable surface. For ease of operation and servicing, it is recommended that it be installed near the printer. If the printer has a large enough flat surface, the 5250 ALLY may be placed there for convenience.
Page 1-4 AGILE 5250 ALLY Users Guide and Reference Unpacking After removing the 5250 ALLY from the shipping container, inspect the unit for any damage in shipment. Immediately report any damage to the freight carrier. Save the packing container. MODE 6287 ALLY PLUS TM 5250 ALLY User’s Manual AC Power Adapter TM MODE 5250 ALLY Parallel Printer Cable Package Contents After unpacking the 5250 ALLY, please check that all of the following items have been included.
CHAPTER 1 GETTING STARTED Page 1-5 Important Safety Instructions/Precautions Follow these important safety precautions: Read these instructions carefully before turning on the 5250 ALLY and before plugging the unit into a power outlet. Disconnect the power plug by pulling the plug, not the cord. Never use the unit if it has been damaged or exposed to excessive moisture. Never open the cover of the 5250 ALLY.
Page 1-6 AGILE 5250 ALLY Users Guide and Reference AGILE P/N Description 830650-1 830680-1 Parallel Output (DB-25 S/Centronics 36) Parallel Alternate Host (DB-25 P/DB-25 P) Parallel Port Pin-Outs The pin-outs for the parallel ports are as follows: 13 12 11 10 9 8 7 6 5 4 3 2 1 25 24 23 22 21 20 19 18 17 16 15 14 1. Strobe 2. Data 1 3. Data 2 4. Data 3 5. Data 4 6. Data 5 7. Data 6 8. Data 7 9. Data 8 10. Printer Acknowledge 11. Busy 12. Paper Error 13.
CHAPTER 1 GETTING STARTED Page 1-7 Connecting to the Host System The 5250 ALLY can be connected via its twinax T adapter to any IBM 5250 protocol device (AS/400, System/3X or remote controller) that has an address configured as an IBM 3812 (SCS Mode), 4214, 5219, 5224, 5225 or 5256 printer. To connect the 5250 ALLY to the host System or remote controller twinax line: 1. Attach the twinax T cable adapter to the DB-15 connector located on the right side of the rear panel of the 5250 ALLY.
Page 1-8 AGILE 5250 ALLY Users Guide and Reference 4. To cable through, simply connect to the other side of the twinax adapter. Otherwise, the adapter will automatically terminate the twinax line. Connecting the Printer Use the PARALLEL OUT PRINTER port to connect the 5250 ALLY to the printer. A parallel output cable is included with the 5250 ALLY. The cable supplied by AGILE may be used, or if a standard Centronics parallel cable is already connected to the printer, it may be used instead.
CHAPTER 1 GETTING STARTED Page 1-9 3. Insert the Centronics DB-25 parallel end of the AGILE printer cable into the PARALLEL OUT PRINTER port of the 5250 ALLY. This port is located to the left of the rear panel. 4. Tighten the thumbscrews until the connection is firm, but do not overtighten. Connecting the Alternate Host The 5250 ALLY supports an optional alternate host. The alternate host may share the attached printer with the host System.
Page 1-10 AGILE 5250 ALLY Users Guide and Reference 3. Insert the other end of the AGILE alternate host cable into the PARALLEL IN ALTERNATE HOST port of the 5250 ALLY. 4. Tighten the thumbscrews until the connection is firm, but do not overtighten. Connecting the 5250 ALLY to Power Now that the 5250 ALLY has been connected to the printer and alternate host device, it may be connected to the power outlet. 1. Connect the female end of the power cord to the DC IN power receptacle of the 5250 ALLY. 2.
CHAPTER 1 GETTING STARTED LED: Page 1-11 The Light-Emitting Diode is used to display information regarding the current status of the 5250 ALLY. (Refer to Chapter 5 Maintenance & Troubleshooting for a complete description of the meaning of the various flashing states of the decimal point and digital display.) MODE: The MODE button is used to select among various operating states of the 5250 ALLY.
Page 1-12 AGILE 5250 ALLY Users Guide and Reference 4 Twinax Timeout This mode is used to select the twinax timeout period. After selecting Mode 4, the LED will display an underscore (_). The user must then press the MODE button until the LED displays the number of the desired timeout period (0=1 second, 1=5 seconds, 2=10 seconds, 3=15 seconds, 4=30 seconds, 5=45 seconds, 6=1 minute). After two seconds, the twinax timeout value will change, and the unit will return to Normal Operating Mode.
CHAPTER 1 GETTING STARTED Page 1-13 8 Translation Table Selection This mode is used to select the translation table to be used with each type of data handled by the 5250 ALLY. After selecting Mode 8, the LED will display an underscore (_). The user must then press the MODE button until the LED displays the number for the data type to be translated (0=twinax data, 3=alt host data, 6=5250 ALLY data, and 7=Xerox font downloads).
Page 1-14 AGILE 5250 ALLY Users Guide and Reference C Power-On Reset The 5250 ALLY will Reset and return to Normal Operating Mode. Configuration changes will not be saved to flash memory. D Reset to Factory Defaults All configuration options will be reset to factory defaults, and the 5250 ALLY will return to Normal Operating Mode. E External Loop Test IMPORTANT: Please refer to Chapter 5 Maintenance & Troubleshooting before performing this test.
CHAPTER 1 GETTING STARTED Page 1-15 1 Twinax Addressing The user must choose an address that does not conflict with an existing device on the twinax line. The default factory configuration for the twinax address is 1. If using this address, no address selection is needed. To change the address, press the MODE button until the LED reads 1. After two seconds, the LED will display an underscore (_). Then press the MODE button until the LED displays the number of the appropriate address (0-6).
Page 1-16 AGILE 5250 ALLY Users Guide and Reference Changing a twinax ports emulation, like changing its address, causes the 5250 ALLY to end communication on that address, change the emulation, then reestablish communication on that address. The 5250 ALLY will not do this if the address is currently in use; the twinax address must timeout before the 5250 ALLY will end communication on the address.
CHAPTER 1 GETTING STARTED Page 1-17 Changing a twinax ports mode, like changing its address, causes the 5250 ALLY to end communication on that address, change the mode, then reestablish communication on the address, unless the address is currently in use. The twinax address must timeout before the 5250 ALLY will end communication on the address.
Page 1-18 AGILE 5250 ALLY Users Guide and Reference If the printer attached to the 5250 ALLY is among the supported printer configurations in the 5250 ALLY flash memory (see below), configuring the output port can be as simple as loading the appropriate configuration. Loading a printer configuration sets the appropriate timing and loads the appropriate format, translation and PFS/GFID information.
CHAPTER 1 GETTING STARTED Page 1-19 0F. EBCDIC diagnostic. A diagnostic-only printer configuration, for EBCDIC printers, that prints the name of each PFS as it is invoked by the data stream, rather than using the PFS to format the document 10. Epson FX printer 11. Generic. A printer configuration that is used as the basis for creating a configuration when the configuration for the users printer is not included in the 5250 ALLY EEPROM (default) 12. Hewlett-Packard LaserJet II printer 13.
Page 1-20 AGILE 5250 ALLY Users Guide and Reference 6 Alternate Host Modes The mode selection tells the 5250 ALLY what to do with the data it receives from the alternate host. This should be set to Transparent (the default) except for diagnostic purposes. 0. IBM printer emulation. 1. SCS dump. 2. Xerox 275 twinax protocol converter emulation. 4. Transparent (default). 5. Hex dump. To select a mode, press the MODE button on the 5250 ALLY front panel until the LED reads 6.
CHAPTER 1 GETTING STARTED Page 1-21 To change the timeout period, press the MODE button on the 5250 ALLY front panel until the LED reads 7. After two seconds, the LED will display an underscore (_). Then press the MODE button until the LED displays the number of the appropriate timeout period (0-6). After two seconds, the timeout period will be changed and the unit will return to Normal Operating Mode.
Page 1-22 AGILE 5250 ALLY Users Guide and Reference 2. ASCII to EBCDIC 3. EBCDIC to EBCDIC 4. EBCDIC to HP LaserJet (Roman 8 extended ASCII) 5. EBCDIC to PC (standard PC extended ASCII character set) 6. EBCDIC to PostScript (IsoLatin1 extended ASCII character set) 7. Xerox 275 protocol converter EBCDIC to ASCII 8. User Table 1 9. User Table 2 A.User Table 3 B.User Table 4 C.User Table 5 D.User Table 6 E.User Table 7 F.
CHAPTER 1 GETTING STARTED Page 1-23 Summary The 5250 ALLY should now be up and running and ready for printing with the users configuration requirements set and permanently stored in the flash memory. Unless the System (twinax address, alternate host or printer) changes, this configuration procedure will not have to be performed again. For many applications, this will be all that is necessary to install and use the 5250 ALLY.
CHAPTER 2 ADVANCED CONFIGURATION Overview Configuring the 5250 ALLY changes the way in which it handles the data stream from the twinax host or alternate host before the data is sent to the printer. The configuration option parameters allow the user to change the twinax address and printer emulation, the mode and timeout periods of the host and alternate host, the translation tables used by the host and alternate host, and a variety of printer specifications.
Page 2-2 AGILE 5250 ALLY Users Guide and Reference A configuration consists of several parts: An output port configuration/printer driver, including PFS/GFID definitions (P%), translation table selections (Group 60) for all input options, font information (PP & PL) and all printer configuration options (Groups 40-50) Definitions for each character in all sixteen translation tables (#) Twinax configuration options (Group 00) Alternate host configuration options (Group 30) Output Port Configuration
CHAPTER 2 ADVANCED CONFIGURATION Page 2-3 Changing Configuration Option Parameters The command for changing all parameters in the 5250 ALLY begins with the text !AGILE!, the configuration trigger. (The trigger is not case sensitive; it may be entered either in upper or lower case letters.) The trigger is followed eventually by a semicolon (;), the configuration terminator.
Page 2-4 AGILE 5250 ALLY Users Guide and Reference Configuration Defaults The 5250 ALLY is shipped from the factory with a given set of parameters called defaults. The default configuration will allow most operators to use the 5250 ALLY after making few, if any, configuration changes.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-5 Configuration Groups The 5250 ALLY configuration options are organized into four groups: Twinax (Group 00), Alternate Host (Group 30), Printer (Group 40-50) and Translation (Group 60). Group numbers and option numbers that are not included are reserved for configuration compatibility with other AGILE products with feature sets that are different than the 5250 ALLY.
Page 2-6 AGILE 5250 ALLY Users Guide and Reference 02 Printer Emulations The 5250 ALLY in IBM emulation mode acts like a printer. In IBM emulation mode, the user must tell the 5250 ALLY which printer it will emulate. The selected emulation must match the device to which the System has been configured to print. Changing the printer emulation, like changing the twinax address, causes the 5250 ALLY to end communication, change the emulation, then reestablish communication on the port.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-7 SCS dump mode is used to tell the 5250 ALLY to print a formatted hexadecimal report, including an interpretation of the SCS and DCA commands, of the incoming EBCDIC data from the twinax host. Refer to Chapter 5 Maintenance & Troubleshooting for a printout of a sample SCS dump. Xerox 275 emulation mode is an emulation of a Xerox 275 twinax protocol converter.
Page 2-8 AGILE 5250 ALLY Users Guide and Reference Alternate Host Configuration (Group 30) Alternate host configuration has only three options: Mode, Timeout and special options for Xerox printers. Xerox special options are described in Appendix A Interfacing Xerox Printers. 31 Alternate Host Modes The mode selection tells the 5250 ALLY what to do with the data it receives from the alternate host. The default mode is Transparent.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-9 Printer Configuration (Group 40-50) Configuring the printer port can be as simple as loading the configuration from the 5250 ALLY flash memory. This configuration specifies the format information, translation tables, PFS codes, GFIDs and timing values appropriate for the printer. Once the printer configuration is loaded, the user may change any of these settings.
Page 2-10 AGILE 5250 ALLY Users Guide and Reference !AGILE!40=10; !AGILE!40=11; !AGILE!40=12; !AGILE!40=13; !AGILE!40=14; !AGILE!40=15; !AGILE!40=16; !AGILE!40=17; Epson FX printer Generic printer.
CHAPTER 2 ADVANCED CONFIGURATION !AGILE!43=00; !AGILE!43=01; !AGILE!43=02; !AGILE!43=03; !AGILE!43=04; !AGILE!43=05; !AGILE!43=06; Page 2-11 1 second 5 seconds (default) 10 seconds 15 seconds 30 seconds 45 seconds 1 minute 44 Carriage Return at Form Feed Some printers automatically perform a Carriage Return (CR) when they receive a Form Feed (FF) command, while other printers do not perform this function. This option provides users with two choices.
Page 2-12 AGILE 5250 ALLY Users Guide and Reference 47-49 Resolution The horizontal resolution option is used only for performing the horizontal offset as defined in Option 4A. Choose the smallest size the printer is capable of accepting. The vertical resolution option is used for performing the vertical offset as defined in Option 4B. It is also used by the 5250 ALLY to calculate the parameter value to insert into PFS 0D VERMOVE.
CHAPTER 2 ADVANCED CONFIGURATION !AGILE!49=00; !AGILE!49=01; !AGILE!49=02; !AGILE!49=03; !AGILE!49=04; !AGILE!49=05; Page 2-13 1 line max. vertical resolution (default) 72 units max. vertical resolution 127 units max. vertical resolution 255 units max. vertical resolution 299 units max. vertical resolution No max. vertical resolution 4A-4D Offset The horizontal offset and vertical offset options allow the user to offset all printing from the left and top edges of the paper, respectively.
Page 2-14 AGILE 5250 ALLY Users Guide and Reference !AGILE!4B=01; !AGILE!4B=02; !AGILE!4B=03; !AGILE!4B=04; !AGILE!4B=05; !AGILE!4B=06; !AGILE!4B=07; !AGILE!4B=08; !AGILE!4B=09; !AGILE!4B=0A; !AGILE!4B=0B; !AGILE!4B=0C; !AGILE!4B=0D; !AGILE!4B=0E; !AGILE!4B=0F; !AGILE!4B=10; !AGILE!4B=11; !AGILE!4B=12; !AGILE!4B=13; !AGILE!4B=14; !AGILE!4B=15; No vertical offset (default) .05 inch vertical offset .10 inch vertical offset .15 inch vertical offset .20 inch vertical offset .25 inch vertical offset .
CHAPTER 2 ADVANCED CONFIGURATION !AGILE!4D=01; !AGILE!4D=02; !AGILE!4D=03; !AGILE!4D=04; !AGILE!4D=05; !AGILE!4D=06; !AGILE!4D=07; !AGILE!4D=08; !AGILE!4D=09; !AGILE!4D=0A; !AGILE!4D=0B; !AGILE!4D=0C; !AGILE!4D=0D; !AGILE!4D=0E; !AGILE!4D=0F; !AGILE!4D=10; !AGILE!4D=11; !AGILE!4D=12; !AGILE!4D=13; !AGILE!4D=14; !AGILE!4D=15; Page 2-15 No COR vertical offset .05 inch COR vertical offset .10 inch COR vertical offset .15 inch COR vertical offset .20 inch COR vertical offset .25 inch COR vertical offset .
Page 2-16 AGILE 5250 ALLY Users Guide and Reference 4F CPI/Font Order This option specifies the order in which the 5250 ALLY will send PFSs to the printer when it receives a command from the System to change both the font and the characters per inch. One setting tells the 5250 ALLY to send the PFS to set the CPI at the printer first, and then to set the font. This is the normal (default) setting.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-17 52 Page Resetting When this option is activated, the 5250 ALLY will reset all formatting option parameters at the beginning of each page sent to the printer (i.e., all PFSs required for correct formatting of the page are resent to the printer). The use of this option is necessary only if the user mixes System commands with printer commands in the data stream, an action strongly discouraged by AGILE.
Page 2-18 AGILE 5250 ALLY Users Guide and Reference When determining the appropriate orientation, the System tells the 5250 ALLY which drawer to use, and the 5250 ALLY assumes that the PFS for that drawer has been set correctly.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-19 Calculate Page Orientation The 02 (portrait), 03 (landscape) and 04 (COR) options allow overriding of all system orientation requests. Is the Setting of Option 54 = 02, 03 or 04? Yes Use Orientation Specified Regardless of System Requests. No The 5250 ALLY supports only portrait, landscape and COR (Computer Output Reduction) orientations; it does not support “reverse” portrait or landscape orientations. Rotations of 0 or 180 degrees are both portrait.
Page 2-20 AGILE 5250 ALLY Users Guide and Reference 55-58 Paper Sources (Drawers) For each possible source drawer that the printer can use, the user must specify its width, height and rotation. Each of the four drawers can be used to define any possible envelope or paper size and rotation, regardless of the name of the drawer. The names of the four source drawers are Paper 1, Paper 2, Paper 3 and Envelope.
CHAPTER 2 ADVANCED CONFIGURATION Page 2-21 Height Find the largest dimension of the paper in the drawer. For example, if the paper in the drawer is 8 1/2 X 11 inches, select 11 inches. If the size of the page is not one of the sizes listed here, choose the next smallest size. If the paper is smaller than all of the choices, choose the smallest available size. To program these options: !AGILE!5501=00; !AGILE!5501=01; !AGILE!5501=02; !AGILE!5501=03; Paper 1 length is 8.
Page 2-22 AGILE 5250 ALLY Users Guide and Reference !AGILE!5502=00; !AGILE!5502=01; !AGILE!5502=02; Paper 1 rotation is portrait (default) Paper 1 rotation is landscape Paper 1 rotation is COR !AGILE!5602=00; !AGILE!5602=01; !AGILE!5602=02; Paper 2 rotation is portrait (default) Paper 2 rotation is landscape Paper 2 rotation is COR !AGILE!5702=00; !AGILE!5702=01; !AGILE!5702=02; Paper 3 rotation is portrait (default) Paper 3 rotation is landscape Paper 3 rotation is COR !AGILE!5802=00; !AGILE!5802=
CHAPTER 3 CHARACTER CODE TRANSLATION Overview The data stream that is sent from the AS/400, System/3X or alternate host device is not forwarded directly through the AGILE 5250 ALLY to the printer. Rather, all characters must first pass through the appropriate character code translation table. If the data format that the printer uses is the same as the format in which the source device sends data, then the data should be routed through a pass-through table (either ASCII to ASCII or EBCDIC to EBCDIC).
Page 3-2 AGILE 5250 ALLY Users Guide and Reference 00. ASCII to ASCII (default for 5250 ALLY & alternate host) 01. EBCDIC to ASCII (default for twinax translation) 02. ASCII to EBCDIC 03. EBCDIC to EBCDIC 04. EBCDIC to HP LaserJet (Roman 8 extended ASCII) 05. EBCDIC to PC (standard PC extended ASCII character set) 06. EBCDIC to PostScript (IsoLatin1 extended ASCII character set) 07. Xerox 275 protocol converter EBCDIC to ASCII 08. User Table 1 09. User Table 2 0A. User Table 3 0B. User Table 4 0C.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-3 Once the appropriate table for each input/output device combination has been determined, send one of the commands listed in the following sections to select the appropriate table.
Page 3-4 AGILE 5250 ALLY Users Guide and Reference 63 Alternate Host Translation If the alternate host device is a PC, the user should choose one of the ASCII tables (00 or 02). Most users operate the printer in ASCII mode, so the default is the ASCII to ASCII pass-through table.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-5 67 Xerox EBCDIC Font Download Translation The table selected here is automatically invoked when the 5250 ALLY encounters a Xerox font download in the data stream. The user should select table 0F if operating a Xerox printer in ASCII mode. The EBCDIC pass-through table (03) should be selected if the user is operating a Xerox printer in EBCDIC mode.
Page 3-6 AGILE 5250 ALLY Users Guide and Reference The table shows that the output value for the input value of 'C1' is '41.' (This is an uppercase A in ASCII.) When this table is selected, an uppercase EBCDIC A received by the 5250 ALLY is translated into an uppercase ASCII A and sent to the printer. Editing a Translation Table The appropriate translation table for the input/output device combinations may not exist. If this is the case, the user will have to edit an existing table.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-7 where nn represents the number of the table to set to default values.
Page 3-8 AGILE 5250 ALLY Users Guide and Reference Downloading a Single Translation Table Value Downloading a change to a single translation table position value uses the following format.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-9 Alternate Hosts and Character Translation When using an alternate host, the only function that the 5250 ALLY performs is to send the data through a translation table (and to send PFS 04 INITALT to the printer upon receipt of data from the alternate host). Although the translation tables can translate both printable (40h - FFh in EBCDIC) and unprintable characters (00h - 3Fh), the user will usually need to translate only printable characters.
Page 3-10 AGILE 5250 ALLY Users Guide and Reference Translation Tables 00 ASCII to ASCII This is a pass-though table. It is the default translation table for 5250 ALLY-generated data (tests and reports) and for alternate host data.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-11 01 EBCDIC to ASCII This table is the default translation table for twinax data.
Page 3-12 AGILE 5250 ALLY Users Guide and Reference 02 ASCII to EBCDIC This table can be used for alternate host data if using a Xerox printer running in EBCDIC mode.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-13 03 EBCDIC to EBCDIC This table can be used to translate twinax data if using a Xerox printer running in EBCDIC mode.
Page 3-14 AGILE 5250 ALLY Users Guide and Reference 04 EBCDIC to HP LaserJet This table translates twinax data for printers that use Roman 8 extended ASCII.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-15 05 EBCDIC to PC This table translates twinax data for printers that use the standard PC extended ASCII character set.
Page 3-16 AGILE 5250 ALLY Users Guide and Reference 06 EBCDIC to PostScript This table translates twinax data for printers that use the IsoLatin1 extended ASCII character set.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-17 07 Xerox 275 Protocol Converter EBCDIC to ASCII This table is used to translate twinax data if the 5250 ALLY has been configured to emulate a Xerox 275 protocol converter (Mode 3-2, or !AGILE!03=02;), and if the printer is configured for the ASCII character set. The user should also set the printer emulation to 5225 or 5256 (Mode 2-4 or 2-5, or !AGILE!02=04; or !AGILE!02=05;).
Page 3-18 AGILE 5250 ALLY Users Guide and Reference 08 User Table 1 The user may edit and use this table for any purpose.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-19 09 User Table 2 The user may edit and use this table for any purpose.
Page 3-20 AGILE 5250 ALLY Users Guide and Reference 0A User Table 3 The user may edit and use this table for any purpose.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-21 0B User Table 4 The user may edit and use this table for any purpose.
Page 3-22 AGILE 5250 ALLY Users Guide and Reference 0C User Table 5 The user may edit and use this table for any purpose.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-23 0D User Table 6 The user may edit and use this table for any purpose.
Page 3-24 AGILE 5250 ALLY Users Guide and Reference 0E User Table 7 The user may edit and use this table for any purpose.
CHAPTER 3 CHARACTER CODE TRANSLATION Page 3-25 0F Xerox EBCDIC Font Download to ASCII This is a table used to translate Xerox EBCDIC fonts for use on an ASCII printer.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Overview The 5250 ALLY has a total PFS storage of 20K bytes. Programmable Function Strings (PFSs) are used by the AGILE 5250 ALLY to control all functions that vary from printer to printer. Whenever some special formatting or control function is required, the 5250 ALLY looks up the appropriate PFS and sends it to the printer. For example, if the System requests emphasized printing, the 5250 ALLY looks up and sends PFS 23 BOLD ON.
Page 4-2 AGILE 5250 ALLY Users Guide and Reference Editing PFSs To edit an existing PFS, load a supported printer configuration, either from the front panel as described in Chapter 1 Getting Started, or with the twinax or alternate host data stream, as described in Chapter 2 Advanced Configuration. If a printer configuration has already been loaded as part of the users configuration process, this step is unnecessary.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-3 The 5250 ALLY will also allow the user to enter the PFS definitions using normal, printable characters, rather than as hexadecimal. The characters must be entered between quote marks (") to distinguish them from hexadecimal commands. For instance, PFS 23 BOLD ON could also have been entered as follows: !AGILE!P%23=1B "b"; Since the Escape character is not printable, it must be entered as a hexadecimal value.
Page 4-4 AGILE 5250 ALLY Users Guide and Reference Parameters Within PFSs To perform their functions, a few PFSs require a parameter that specifies a variable value. The 5250 ALLY allows only one such parameter per PFS. Parameters can take one of five formats (see below), but usually the format will be in decimal (base 10). Both the decimal format and the hexadecimal format parameters are sent through a 5250 ALLY character code translation table.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS _h _d _b _H _L Page 4-5 hexadecimal decimal byte HiLoWord LoHiWord The following example defines PFS 0D VERMOVE for a Xerox (XES/ UDK) printer. !AGILE!0D=1B 72 64 _d 20; This command translates as Esc r d [insert decimal parameter] (Space). GFIDs IBM systems refer to fonts using numbers from 00001 to 65534. These numbers are called GFIDs, or global font identifiers. (Sometimes they are referred to as font identifiers, FIDs or typestyle numbers.
Page 4-6 AGILE 5250 ALLY Users Guide and Reference Before changing any GFID, print a Portrait FID Report and/or Landscape FID Report using Mode 9-5 or 9-6, respectively, as described in Chapter 1 Getting Started. These reports will send the printer the number of each GFID along with its definition in both hexadecimal and ASCII (or EBCDIC) formats. After changing GFIDs, print the reports again to verify that they are correct.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-7 4. The printer may not be listed in the supported configurations. The user may want to build a table from scratch. 5. The user may want to evoke a PFS or printer command using a System font request. Since the Escape sequence can be composed of any characters, it is not restricted to font selection Escape sequences. As such, GFIDs can be used as an extension to the PFS capacity of the 5250 ALLY.
Page 4-8 AGILE 5250 ALLY Users Guide and Reference 00 INITIBM This PFS is empty by default in all printer configurations. Use this to initialize the printer to a known state for communication with twinax printer emulation-generated data. For instance, the user can clear the margins, set movement units, turn off bolding, underlining, scripting, emphasis, etc. This PFS is sent to the printer after PFS 01 INITTWN is sent, if using IBM emulation mode (!AGILE!03=00;).
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-9 06 INITALY This PFS is defined in all printer configurations except Generic. Use this to set the printer to a known font, orientation and margins for 5250 ALLYgenerated output. This PFS is sent to the printer before the 5250 ALLY prints any of the reports that are printed using Mode 9 Tests and Reports. 07 FF Form Feed. This PFS is defined in all printer configurations. This should eject the old page and start a new page.
Page 4-10 AGILE 5250 ALLY Users Guide and Reference This is not normally used with laser printers, and it is only used when some type of PFS Suppression is active or when Option 46 Vertical Movement has been set to Line Feed (!AGILE!46=02;). Normally, the 5250 ALLY sends PFS 0D VERMOVE to control all vertical movement. 0A PORT Print page in portrait orientation.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-11 0E LINEDEN This is used to set the line density at the printer. This PFS is sent to the printer whenever the System changes the line density setting in response to an SCS Set Line Density or Set Single Line Distance command. Although the 5250 ALLY normally performs vertical movement at the printer using PFS 0D VERMOVE, there are two reasons that the printer may need to know the actual line density. 1.
Page 4-12 AGILE 5250 ALLY Users Guide and Reference If the printer is capable of printing any font at any pitch (CPI), then this PFS should set the pitch for the current font. If a specific font is needed to achieve 5 CPI, then this PFS should be defined to select that font. If Option 4F CPI/Font Order is set to 00 (!AGILE!4F=00;), then this PFS will be sent before the GFID for the font is sent.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-13 13 P PSCPI Print with proportional spacing in portrait orientation. This PFS is sent to the printer when the 5250 ALLYs page orientation algorithm has selected a portrait orientation, and when the System has requested proportional spacing (using either an SCS Set Character Density command or an SCS Set FID through GFID command).
Page 4-14 AGILE 5250 ALLY Users Guide and Reference If the printer is capable of printing any font at any pitch (CPI), then this PFS should set the pitch for the current font. If a specific font is needed to achieve 15 CPI, then this PFS should be defined to select that font. If Option 4F CPI/Font Order is set to 00 (!AGILE!4F=00;), then this PFS will be sent before the GFID for the font is sent.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-15 18 L 5CPI Print 5 characters per inch in landscape orientation. This PFS is sent to the printer when the 5250 ALLYs page orientation algorithm has selected a landscape orientation, and when the System has requested a font with a pitch of 5 CPI or less (using either an SCS Set Character Density command or an SCS Set FID through GFID command).
Page 4-16 AGILE 5250 ALLY Users Guide and Reference If the printer is capable of printing any font at any pitch (CPI), then this PFS should set the pitch for the current font. If a specific font is needed to achieve 10 CPI, then this PFS should be defined to select that font. If Option 4F CPI/Font Order is set to 00 (!AGILE!4F=00;), then this PFS will be sent before the GFID for the font is sent.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-17 1D L 15CPI Print 15 characters per inch in landscape orientation. This PFS is sent to the printer when the 5250 ALLYs page orientation algorithm has selected a landscape orientation, and when the System has requested a font with a pitch of greater than 12 but less than or equal to 15 CPI (using either an SCS Set Character Density command or an SCS Set FID through GFID command).
Page 4-18 AGILE 5250 ALLY Users Guide and Reference If the printer is capable of printing any font at any pitch (CPI), then this PFS should set the pitch for the current font. If a specific font is needed to achieve 17 CPI, then this PFS should be defined to select that font. If Option 4F CPI/Font Order is set to 00 (!AGILE!4F=00;), then this PFS will be sent before the GFID for the font is sent.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-19 Example: 12 CPI (systems CPI value) x 13.2 inches (systems expected page width) = 158 columns. 158 columns ÷ 10 inches (actual paper width) = 15 CPI. 22 COR 15 Select a landscape font greater than or equal to 20 pitch.
Page 4-20 AGILE 5250 ALLY Users Guide and Reference 25 BSBOLD1 and 26 BSBOLD2 Backspace bold. These PFSs are sent to the printer in response to an SCS Begin Emphasis command, or when a character-Backspace-same character sequence or a text-Carriage Return-same text sequence is detected in the data stream. PFS 25 and PFS 26 are used only for printers that are otherwise incapable of bold printing.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-21 2B SUBS ON Turn on subscript mode. This can be the result only of a direct System request for subscripting using the SCS Subscript command. If the user defines this PFS with the printers Subscript On command, only one level of subscripting will be supported. If the user defines this PFS with the printers relative downward movement command, multiple levels of subscripting will be supported.
Page 4-22 AGILE 5250 ALLY Users Guide and Reference 30 MEDQUAL This PFS is sent to the printer when the System has selected a medium quality print mode using the SCS Page Presentation Media command with the pq parameter set to 01h. This is normally applicable only for dot matrix printers. The user can use this PFS to control any mode of operation of the printer. Start that mode of operation by selecting the appropriate print mode at the System.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-23 34 TUMBLE Print in duplex (double-sided) mode for documents that are to be bound at the top of the page (selected by sending the SCS Page Presentation Media command with the dx parameter set to 03h). If the System is printing in duplex mode, it will insert an additional Form Feed into the data stream if necessary at the end of print jobs.
Page 4-24 AGILE 5250 ALLY Users Guide and Reference 39 PORTCUT Use cut feed paper (sheet feed). PORTCUT and LANDCUT are the only settings allowed by the System if the printer is configured as an IBM 3812 laser printer (!AGILE!02=00;). If the System specifies cut feed paper with the SCS Set Printer Setup command, and if the printer is in portrait mode, then this PFS will be sent to the printer. Afterward, one of the drawerselect PFSs above will be sent to select the paper source drawer.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-25 3E LPAPER 3 Use paper from source/drawer 3. This PFS is sent to the printer at the beginning of each landscape page when the System has sent an SCS Page Presentation Media command with the sd parameter set to 03h. It uses format information from Option 57 Paper 3. 3F L ENVEL Use paper from source/drawer 4.
Page 4-26 AGILE 5250 ALLY Users Guide and Reference 43 JOG OUT Move paper output tray to the other position (when the printer can output paper to two positions). This is sometimes referred to as output offsetting.
CHAPTER 4 PROGRAMMABLE FUNCTION STRINGS Page 4-27 4C JOBEND This PFS is not normally used. It is triggered at the end of a print job from the System. The user may define this in any appropriate way. 4D TIMEOUT This PFS is sent to the printer before switching hosts after the configuration-defined timeout period. This is not the result of a System request. It is intended primarily so users can define a cleanup procedure to be executed before switching hosts (e.g., send a Form Feed to the printer).
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Diagnostics When the AGILE 5250 ALLY either powers up or is Reset (Mode A from the front panel, or !AGILE!=POR; via the data stream), it performs a set of diagnostics on the internal hardware. These diagnostics include a ROM checksum test to ensure that the ROM has not been corrupted, a RAM test, and an internal loop test.
Page 5-2 AGILE 5250 ALLY Users Guide and Reference Twinax Addressing After power-on hardware diagnostics and during twinax initialization, the twinax port is monitored to check the 5250 ALLY twinax configuration against the actual port configuration. Before the 5250 ALLY will begin communication on the twinax address, it monitors the line to ensure that the selected address is not being used by another device on the twinax network.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-3 Twinax Error Log The 5250 ALLY makes a log of any twinax hardware errors it encounters on the physical twinax line. Most errors encountered are parity errors caused by faulty cabling or termination. This feature is useful for diagnosing the cause of twinax errors. The twinax error log can be printed using Mode 9-8.
Page 5-4 AGILE 5250 ALLY Users Guide and Reference SCS Dump Mode ----------------------------------------------------------------------------5250 ALLY V1.00 Sep 1 1995, 11:49:36 COPYRIGHT (C) BY AGILE. SCS / DCA Formatted Report, Page - 1.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-5 Printing Reports (Mode 9) The 5250 ALLY will print nine tests and reports that allow the user to verify that the unit is functioning properly, and that the configuration settings are correct. If experiencing problems with the unit, it is helpful to start solving them by first printing and checking these reports: 0. Printer Test 1. Configuration Report 2. Translation Table Report 3. PFS Report 4. PFS Test 5. Portrait Font ID Report 6.
Page 5-6 AGILE 5250 ALLY Users Guide and Reference Printer Test (Mode 9-0) The Printer Test is a repeating set of characters that demonstrates that the printer is operating correctly and that the interface is properly connected. The following is a sample report: ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-7 Configuration Report (Mode 9-1) This two-page report lists each 5250 ALLY configuration option setting, with the exception of the translation tables, PFS definitions and GFIDs. The following is a sample Configuration Report: ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-8 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED. Configuration Report - Page 2 of 2 ----------------------------------------------------------------------------5500 5501 5502 5600 5601 5602 5700 5701 5702 5800 5801 5802 59 - - Paper 1 Width - 8.50 inch - Paper 1 Length - 11.00 inch - Paper 1 Rotation - Portrait - Paper 2 Width - 8.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-9 Translation Table Report (Mode 9-2) This eight-page report will print all sixteen translation tables. ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-10 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-11 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-12 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-13 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-14 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-15 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-16 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-17 PFS Report (Mode 9-3) This report will print a list of all PFSs. Unlike PFS Test, this will report the actual definitions for the PFSs rather than samples of the results of the PFS definitions. Use this test in conjunction with PFS Test. In this sample report, the PFSs listed are for Xerox XES mode printers. The column on the left shows the names of the PFSs. The middle column shows the hexadecimal value of the PFS.
Page 5-18 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-19 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-20 AGILE 5250 ALLY Users Guide and Reference PFS Test (Mode 9-4) This report will print a test sample of several of the 5250 ALLY PFSs. For each PFS, see that it has been implemented properly by looking at the effect on the text that follows the PFS name. For example, to test PFS 12 P 10CPI, the report will print This line of text is in 10 CPI, using the appropriate font as defined in the PFS.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-21 Portrait Font ID Report (Mode 9-5) This report will print a portrait font correspondence table. The fonts listed in this sample are for Xerox XES mode printers set to ASCII character coding. The following is a sample report: ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-22 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-23 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-24 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-25 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-26 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-27 Landscape Font ID Report (Mode 9-6) This report will print a landscape font correspondence table. The fonts listed in this sample are for Xerox XES mode printers set to ASCII character coding. The following is a sample report: ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-28 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-29 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-30 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-31 ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
Page 5-32 AGILE 5250 ALLY Users Guide and Reference ----------------------------------------------------------------------------AGILE 5250 ALLY V1.00 COPYRIGHT (C) 09/01/95 BY AGILE. ALL RIGHTS RESERVED.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-33 Troubleshooting This guide is intended as a quick reference for identifying and correcting the most likely causes of problems encountered when installing or troubleshooting the AGILE 5250 ALLY. Step 1: Power ❏ 5250 ALLY Check that the 5250 ALLY is connected to a power source and that the power switch and front panel LED are on. Refer to Chapter 1 Getting Started: Selecting a Location, Connecting the 5250 ALLY to Power and Starting Up.
Page 5-34 AGILE 5250 ALLY Users Guide and Reference Step 3: Configuration Perform the basic configuration steps outlined in Chapter 1 Getting Started: Basic Port Configuration. Pay particular attention to Configuring the Parallel Out Printer Port. Step 4: Printer Test Verify that the printer is operating correctly and that the interface is properly connected by sending a Printer Test to the printer.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-35 ALLY will invoke COR and automatically rotate the job to a landscape orientation. To prevent COR output, refer to Chapter 2 Advanced Configuration: Printer Configuration (Group 40-50), and change the settings of Options 5502, 5602, 5702 and 5802. ❏ Xerox 4235 Printer Duplexing When duplex printing on the 4235 printer, program PFS 4C JOB END with the DUPLEX SIDE SELECT (szyi1d) command.
Page 5-36 AGILE 5250 ALLY Users Guide and Reference The AGILE Bulletin Board System To upload files or download a new configuration, call the AGILE BBS: 1. Load the communications software. 2. Set up the modem: Baud rate: Fastest setting available (AGILE supports speeds of up to 28.8 with both V.FC and V.34 modems) Data bits: 8 Stop bits: 1 Parity: None 3. Dial 15107248073. If using a line with Call Waiting, dial *70,15107248073 to disable Call Waiting. 4.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-37 Press F to display the File menu Press L to List files Press 1 to go to File area 1 (AGILE software download area) Press M to Mark the file Type the number of the file to be downloaded Press D to Download the file Press D to confirm the download Perform the local download procedure according to your communications software instructions 8.
Page 5-38 AGILE 5250 ALLY Users Guide and Reference Next, insert the diskette with the new code into a PC connected to the 5250 ALLY alternate host port. At the users PC prompt, type codeload ally5250. The new code will be loaded to the 5250 ALLYs flash memory. During the process, the user will see something similar to the following on the PC screen: XTRA Coad load utility 1.0 Copyright (C) 1995 Agile Inc. Load address: c000 Loading file: ally5250.
CHAPTER 5 MAINTENANCE & TROUBLESHOOTING Page 5-39 If an X appears on the screen instead of a 0, an error has occurred in the code load process. Contact AGILE Technical Support for instructions if an error appears. Other Files Contained in the Self-Extracting Archive Readme.txt is an explanation of how to use the files contained in the archive. The user may read this file with any program that can read test files. Param.
APPENDIX A INTERFACING XEROX PRINTERS Introduction The AGILE 5250 ALLY provides extensive special support for Xerox printers in XDPM and XPPM modes. XDPM mode is also referred to as XES mode or UDK mode. XES mode is the native Xerox print mode for Xerox 2700, 3700, 4030, 4045 and 4213 printers. The XDPM mode option on the 4235 also provides the XES command set. XPPM mode is available on Xerox centralized printers such as the 4050, 4090, 4850, etc. XPPM mode is also available on the 4235.
Page A-2 AGILE 5250 ALLY Users Guide and Reference XES Mode The XES command set used by older Xerox printers allows more functionality than the SCS command set used by IBM printers. For example, the XES command set allows overlay forms, APA (All-PointsAddressable) graphics, special fonts for barcodes or logos, and downloading of fonts and forms from the host System. All XES commands consist of printable text. Each command is initiated with a special character called the UDK (User-Defined Key).
APPENDIX A INTERFACING XEROX PRINTERS Page A-3 The 5250 ALLY provides several methods that allow SCS and XES documents to coexist in the same environment. Coexistence In order to eliminate the formatting conflicts that can arise when using XES commands to control document formatting, the 5250 ALLY provides two special modes of operation, one called PFS (Programmable Function String) suppression mode, and the other called FF (Form Feed) suppression mode.
Page A-4 AGILE 5250 ALLY Users Guide and Reference Well-Formed XES Jobs The XES command set provides several commands that are used to declare the beginning of a print job. Each of these commands declares the beginning of a different type of job. The XES command set also includes a command to end the print job. This users manual uses the term well-formed to refer to an XES print job that uses XES commands to delimit the beginning and end of a print job.
APPENDIX A INTERFACING XEROX PRINTERS Page A-5 Auto Form Feed Suppression Auto FF suppression is initiated in the same way as Auto PFS suppression, although there is a separate configuration option to select whether or not this occurs. Because Auto FF suppression is particularly useful for form download jobs, it is possible to configure FF suppression to be initiated by s+Md or s+Nd (both of which initiate a form-based job) but not s+Pd or s+Qd.
Page A-6 AGILE 5250 ALLY Users Guide and Reference Input to 5250 ALLY: Output from 5250 ALLY: s+Pd s+Pd ...(commands and text)... ...(commands and text)... (inserted by System) (Form Feed is removed) ...(commands and text)... ...(commands and text)... s+Pd ...(commands and text)... ...(commands and text)... (inserted by System) (Form Feed is removed) ...(commands and text)... ...(commands and text)...
APPENDIX A INTERFACING XEROX PRINTERS Page A-7 Input to 5250 ALLY: Output from 5250 ALLY: s+Pd s+Pd ...(commands and text)... ...(commands and text)... (inserted by System) (Form Feed is removed) ...( commands and text)... ...(commands and text)... s+Md s+Md ...(commands and text)... ...(commands and text)... (inserted by System) (Form Feed is removed) ...(commands and text)... ...(commands and text)...
Page A-8 AGILE 5250 ALLY Users Guide and Reference use ¬¬}}} to terminate FF suppression mode send the FF use ¬¬{{{ to reinitiate the FF suppression mode. For this reason, AGILE recommends the use of these commands only for existing applications and documents. New applications and documents should use the Auto PFS/FF suppression modes. Special Formatting Problems This section discusses some additional issues regarding data stream conflicts.
APPENDIX A INTERFACING XEROX PRINTERS Page A-9 1. A job from one source defines and uses a UDK character, but does not end its job with a s+Xd to undefine the UDK character. 2. A second job from the System that does not define or use a UDK character tries to use the previously defined UDK character as a printable character. In this case, the failure that will occur in step 2 is actually caused by the first job not following the rules.
Page A-10 AGILE 5250 ALLY Users Guide and Reference Auto UDK termination The 5250 ALLY also allows multiple XES commands to occur on one line of text from the host System, even if those commands normally require line endings. The 5250 ALLY understands the XES command set, and it will insert the line endings for any commands that require them.
APPENDIX A INTERFACING XEROX PRINTERS Page A-11 1/1440-inch units. The Xerox printer allows line density to be set only in 1/300-inch units. For some System-supported line densities, the closest line density in 1/300-inch would be in error. This error would accumulate as text moves down the page. The 5250 ALLY normally maintains vertical positioning information in the systems 1/1440-inch resolution. Each line of text is placed within one-half pixel of its correct position.
Page A-12 AGILE 5250 ALLY Users Guide and Reference Downloading Font Correspondences The 5250 ALLY supports the use of the Logical Not command used to download font correspondences from the host System. The general format for this command is: ¬¬(((x on=fontname ))) where: x is any digit. It is ignored. o is either P for Portrait or L for Landscape. This character specifies in which of the two font correspondence tables the entry should be placed.
APPENDIX A INTERFACING XEROX PRINTERS Page A-13 This example performs the same function as the previous example. Multiple entries can be separated either by line endings or by commas. For example: ¬¬(((0 11=Titan10iso-P,11=Titan10iso-L 87=LetterGothic12iso-P,87=LetterGothic12iso-L ))) This example creates four new entries in the font correspondence tables two for the landscape table, and two for the portrait table.
Page A-14 AGILE 5250 ALLY Users Guide and Reference Xerox Options The previous sections described the options available on the 5250 ALLY that are used to assist the user in interfacing the host System to Xerox printers. This section lists the specific options available and describes the special modes invoked by these options. For more information about how these modes can be used to help solve any specific problems, please refer to the previous sections of this appendix.
APPENDIX A INTERFACING XEROX PRINTERS Page A-15 Auto PFS suppression: This option causes the 5250 ALLY automatically to suppress all PFSs except the INIT, CR, LF and FF PFSs at the beginning of an XDPM print job. The XDPM job is delimited by one of the job start commands: s+Pd, s+Qd, s+Md, or s+Nd. This setting is useful only for XDPM data streams. Suppress PFSs: This option causes the 5250 ALLY to suppress all PFSs for the data streams received on the twinax address.
Page A-16 AGILE 5250 ALLY Users Guide and Reference Suppress Form Feeds in form-based jobs: This option is similar to the Auto Form Feed suppression option, except that the 5250 ALLY starts suppression only for form-based jobs. Form-based jobs are started with s+Md and s+Nd. The Form Feed suppression mode is terminated with the job reset command: s+Xd. This setting is useful only for XDPM data streams.
APPENDIX A INTERFACING XEROX PRINTERS Page A-17 Remove Logical Not commands: This option specifies that Logical Not commands are to be removed from the data stream, i.e., neither printed nor acted upon. This mode is useful for debugging data streams, but it is primarily intended to assist the user in migrating existing documents that use Logical Not commands to the 5250 ALLYs more powerful Auto PFS and FF suppression modes.
Page A-18 AGILE 5250 ALLY Users Guide and Reference The 5250 ALLY has two different modes of transparency for use in passing Metacode from the host System to the printer. The 5250 ALLYs normal handling of transparent data is to remove the data from the transparent packet and to send the data to the printer. XPPM printers, however, require that they receive the data in a transparent packet.
APPENDIX A INTERFACING XEROX PRINTERS Page A-19 Line Feed movement is Line Feed: This option specifies that the 5250 ALLY should use Line Feeds to move from line to line. This causes the line density to be based upon the current fonts height. Regardless of the setting of this option, the 5250 ALLY always uses Line Feeds when any type of PFS suppression is active.
APPENDIX B SCS/DCA COMMAND SUMMARY Overview The AGILE 5250 ALLY, like the IBM printers it emulates, accepts SCS (SNA Control String) and DCA - FFT (Document Content Architecture Final Form Text) commands. These commands control formatting of the text and other printer functions. The 5250 ALLYs IBM printer emulation uses the printer configuration and the PFS definitions to simulate the appropriate behavior on the output device (usually a printer).
Page B-2 AGILE 5250 ALLY Users Guide and Reference Command: Null (NUL) Format: 00 Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: No operation is performed. No character is printed. IBMEMUL: No operation. 275EMUL: NUL is sent to printer. Command: ASCII Transparency (ATRN) Format: 03 nn [ASCII data] Printers: IBM printer emulation on 3197 display station Action: The following nn bytes of data are sent directly to the printer. The nn parameter counts the number of following bytes.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-3 Command: Required New Line (RNL) Format: 06 Printers: 3812, 5219 Action: Resets the indent level to the left margin, performs a Carriage Return (CR) and a Line Feed (LF). If the current print position is on the last line of the logical page, an automatic Form Feed (FF) is performed, and printing continues on the first line of the next page. Most IBM host system print spoolers use the Form Feed character to delimit and count pages.
Page B-4 AGILE 5250 ALLY Users Guide and Reference Command: Superscript (SPS) Format: 09 Printers: 3812, 5219 Action: Causes the current print position to move up one-half line distance. On the 5219, only one level of superscript is supported. On the 3812, multiple levels of superscript are supported. IBMEMUL: Same as the 3812. PFS 2D SUPS ON is sent to the printer once for each superscript level.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-5 Command: Form Feed (FF) Format: 0C Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: Moves the current print position to the top line of the next logical page. The print position is restored to the current indent level, or to the left margin if there is no indent. Most IBM host system print spoolers use the Form Feed character to delimit and count pages. For this reason, only Form Feed should be used to move to a new page.
Page B-6 AGILE 5250 ALLY Users Guide and Reference Command: New Line (NL) Format: 15 Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: Performs a Carriage Return (CR) and a Line Feed (LF). If the current print position is on the last line of the logical page, it performs an automatic Form Feed (FF), and printing continues on the first line of the next page. Most IBM host system print spoolers use the Form Feed character to delimit and count pages.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-7 Command: Back Space (BS) Format: 16 Printers: 3812, 5219 Action: Causes the current print position to be moved one character to the left. On the 3812, Back Space can cause the current print position to move to the left of the logical left margin. On the 5219, Back Space will not move to the left of the logical left margin unless a Release Left Margin (RLM) command has been received on the current print line. IBMEMUL: Same as the 5219.
Page B-8 AGILE 5250 ALLY Users Guide and Reference Command: Word Underscore (WUS) Format: 23 Printers: 3812, 5219 Action: Causes the preceding word to be underscored.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-9 Command: Line Feed (LF) Format: 25 Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: Moves the print position down one line. The character position is not changed. If the current print position is the last line of the logical page, it performs an automatic Form Feed (FF), and printing continues at the current position on the first line of the next page. Most IBM host system print spoolers use the Form Feed character to delimit and count pages.
Page B-10 AGILE 5250 ALLY Users Guide and Reference Command: Set Horizontal Format (SHF) Format: 2B C1 nn hh Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: Sets the horizontal Maximum Print Position (MPP) to the value of the hh parameter. If the hh parameter is 00h, or if the hh parameter is omitted, the default value for MPP is calculated as 13.2 inches x the current CPI setting. For the 3812, setting the hh parameter to 01h also sets MPP to the default value.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-11 Command: Set Line Density (SLD) Format: 2B C6 nn ld Printers: 3812, 4214, 5219, 5224, 5225 Action: Sets the height of one line of print to be the value of the ld parameter divided by 72 inches. For the 4214, if the value of the ld parameter is greater than 48h, a default value of 0Ch (6 lines per inch) will be used. For the 5219, ld parameter values other than 12h (4 lines per inch), 0Eh (5.
Page B-12 AGILE 5250 ALLY Users Guide and Reference Command: Set Graphic Error Action (SGEA) Format: 2B C8 nn gg uu Printers: 3812, 4214, 5219, 5224, 5225, 5256 Action: Sets both the replacement character and the action to be performed when a non-printable graphic is encountered. The gg parameter specifies the character with which to replace the non-printable graphic. If the gg parameter is omitted or invalid (non-printable), the value defaults to a hyphen (60h).
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-13 Command: Set Coded Graphic character set though Local ID (SCGL) Format: 2B D1 nn 81 id Printers: 3812, 4214, 5219, 5224, 5225 Action: Selects the character set used for subsequent printing.
Page B-14 AGILE 5250 ALLY Users Guide and Reference Command: Set GCGID through GCID (SCG) Format: 2B D1 nn 01 gcgc cpcp Printers: 3812, 5219 Action: Sets the character set used to map subsequent text. The gcgc parameter specifies the Graphic Character set Global ID (GCGID). The cpcp parameter specifies the Code Page Global ID (CPGID). The 3812 discards the gcgc parameter. IBMEMUL: No operation. 275EMUL: No operation.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-15 Command: Set FID through GFID (SFG) Format: 2B D1 nn 05 gfid fntw ps Printers: 3812, 5219 Action: Selects the font and spacing used for subsequent text. The gfid parameter specifies the Global Font ID (GFID) or typestyle number to be used. The fntw parameter divided by 1440 specifies the character width in inches (Characters Per Inch equals 1440 divided by the fntw parameter).
Page B-16 AGILE 5250 ALLY Users Guide and Reference If the current orientation is either portrait or landscape, then the font selection process has two steps.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-17 Command: Begin Emphasis (BES) Format: 2B D1 nn 8A ca Printers: 3812 Action: Activates the continuous emphasis function. It emphasizes characters by overlaying them with the same pel pattern displaced by two pels horizontally. The ca parameter is ignored. IBMEMUL: Same as IBM. If Option 51 Bolding is set to 00 (!AGILE!51=00;), PFS 23 BOLD ON is sent to the printer before the text to be bolded.
Page B-18 AGILE 5250 ALLY Users Guide and Reference Command: Release Left Margin (RLM) Format: 2B D2 nn 0B Printers: 3812, 5219 Action: Release Left Margin (RLM) is used to indicate to the printer that Back Spaces (BS) and Unit Back Spaces (UBS) are allowed to go to the left of the logical left margin.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-19 Command: Set Line Spacing (SLS) Format: 2B D2 nn 09 ls Printers: 3812, 5219 Action: Specifies the line spacing to be used for subsequent text. The ls parameter specifies the number of half-lines to Space. The distance of a full line is determined by the value most recently set either by the Set Line Density (SLD) command or by the Set Single Line Distance (SSLD) command. IBMEMUL: Same as IBM.
Page B-20 AGILE 5250 ALLY Users Guide and Reference Command: Set Initial Conditions (SIC) Format: 2B D2 nn 45 ic Printers: 3812, 5219 Action: This command resets all system-changeable settings to one of two sets of default values. The ic parameter specifies the initial condition of the printers settings. An ic value of FFh specifies the Data Processing condition set (DP); an ic value of 01h specifies the Word Processing condition set (WP). DP WP Page Width 13.2 inches 8.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-21 printer, ensuring that the last logical page from one job and the first logical page of the next job are not printed on the same physical page. When the 5250 ALLY is calculating automatic page orientation, the setting of the initial condition set determines how page size will be calculated. If the ic parameter is set to 01h (Word Processing), then the page size is determined by the settings of the last received Set Presentation Page Size (SPPS) command.
Page B-22 AGILE 5250 ALLY Users Guide and Reference Command: Justify Text Field (JTF) Format: 2B D2 nn 03 rere pr Printers: 3812, 5219 Action: Specifies that a field of text is to be justified. Text to be justified follows the command. Justification ends at the next Justify Text Field (JTF), Carriage Return (CR), New Line (NL), Required New Line (RNL), Interchange Record Separator (IRS), Form Feed (FF) or Required Form Feed (RFF) command.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-23 Command: Set Justify Mode (SJM) Format: 2B D2 nn 0D st pr Printers: 3812, 5219 Action: Set Justify Mode is used to activate and deactivate justification. The st parameter specifies whether justify mode is to be activated or deactivated. An st value of 00h means no change. An st value of 01h means activate justify mode. An st value of 02h means deactivate justify mode.
Page B-24 AGILE 5250 ALLY Users Guide and Reference Command: Set Horizontal Margins (SHM) Printers: 3812, 5219 Format: 2B D2 nn 11 lmlm rmrm Action: Specifies the left and right margins for subsequent printing. The lmlm parameter specifies the left margin position in 1/1440-inch units. The rmrm parameter specifies the right margin position in 1/1440-inch units. Both the lmlm and rmrm parameters are relative to the physical left edge of the page.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-25 Command: Set Presentation Page Size (SPPS) Format: 2B D2 nn 40 wdwd htht Printers: 3812, 5219 Action: Specifies the physical size of the page. This deactivates the auto new line function. The auto new page function is deactivated if the htht parameter is not omitted. The wdwd parameter specifies the physical width of the page. The htht parameter specifies the physical height of the page.
Page B-26 AGILE 5250 ALLY Users Guide and Reference Command: Set Single Line Distance (SSLD) Format: 2B D2 nn 15 ldld Printers: 3812, 4214, 5219 Action: Specifies in 1/1440-inch units the distance between subsequent print lines. This command overrides the last Set Single Line Distance or Set Line Density (SLD) command. Set Single Line Distance has the same effect as Set Line Density, with the exception that the units are different.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-27 Command: Set Character Density (SCD) Format: 2B D2 nn 29 00 cp Printers: 3812, 4214, 5219, 5224, 5225 Action: Specifies the character density in characters per inch (CPI) for subsequent text. The cp parameter specifies CPI. For the 4214, values of 00h (no change), 05h (5CPI), 0Ah (10CPI), 0Ch (12 CPI) and 10h (16.7 CPI) are valid.
Page B-28 AGILE 5250 ALLY Users Guide and Reference If the current orientation is landscape, one of the following PFSs will be sent to the target printer to invoke the appropriate CPI value: 18 L 5CPI (CPI≤5), 19 L 8CPI (CPI≤8>5), 1A L 10CPI (CPI≤10>8), 1B L PSCPI (proportional spacing), 1C L 12CPI (CPI≤12>10), 1D L 15CPI (CPI≤15>12), 1E L 16CPI (CPI≤16>15) or 1F L 17CPI (CPI>16).
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-29 For two-byte numbers the following values are valid: Hex value: Color: 0000 Black (or other ribbon color) 0001 Blue 0002 Red 0003 Pink/Magenta 0004 Green 0005 Turquoise/Cyan 0006 Yellow 0007 White 0008 Black 0009 Dark Blue 000A Orange 000B Purple 000C Dark Green 000D Dark Turquoise 000E Mustard 000F Grey 0010 Brown FF00 Default FF01 Blue FF02 Red FF03 Pink FF04 Green FF05 Turquoise/Cyan FF06 Yellow FF07 Black
Page B-30 AGILE 5250 ALLY Users Guide and Reference Command: Page Presentation Media (PPM) Format: 2B D2 nn 48 xxxx fc sd do dd pq dx Printers: 3812, 4214, 5219 Action: Specifies parameters regarding the paper. The fc parameter specifies the forms control. A value of 00h means no change to current setting; 01h specifies paper; 02h specifies envelopes. For the 3812, the value 02h is not supported. The sd parameter specifies the paper source drawer.
APPENDIX B SCS/DCA COMMAND SUMMARY IBMEMUL: Page B-31 Same as IBM, except that the 5250 ALLY will perform COR even if it has been disallowed with this command. The 5250 ALLY uses the fc and sd parameters to select a source paper drawer simply by adding two (2) to the sd parameter if a forms-type of envelope (fc=02h) is requested. The 5250 ALLY recognizes up to four source drawers on the target printer called Paper 1, Paper 2, Paper 3 and Envelope.
Page B-32 AGILE 5250 ALLY Users Guide and Reference The qq parameter controls the print quality at the target printer by sending one of the PFSs 2F LOWQUAL (qq=03h), 30 MEDQUAL (qq=01h) or 31 HIQUAL (qq=02h). These PFSs are sent to the printer only if the print quality setting is changed. Many target printers (specifically dot matrix) place limitations on print quality, proportional spacing, font and/or print enhancement combinations.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-33 Command: Set Printer Setup (SPSU) Format: 2B D2 nn 4C xx pf xx si Printers: 3812, 5219 Action: Specifies both the paper feed technique and the print setup to be used. The pf parameter specifies the paper feed technique. Valid values are 00h (no change), 01h (manual feed), 02h (tractor feed) and 03h (automatic cut sheet feed). The si parameter is a string of up to 60 bytes that is used to indicate the printer setup to the operator.
Page B-34 AGILE 5250 ALLY Users Guide and Reference Command: Set Exception Action (SEA) Format: 2B D2 nn 85 e1 a1 e2 a2... Printers: 3812, 5219 Action: Set Exception Action is used to specify the action to be taken for each of the exception condition levels. The parameters en and an must be specified in pairs. From zero to 4 pairs can be supplied. The en parameter specifies an exception condition level.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-35 Command: Set Text Orientation (STO) Format: 2B D3 nn F6 caca lala Printers: 3812 Action: This command is used to specify character and line rotation for subsequent text. The caca parameter specifies character rotation angle and is not supported on the 3812. The lala parameter specifies the text line rotation angle.
Page B-36 AGILE 5250 ALLY Users Guide and Reference Command: Begin Underscore (BUS) Format: 2B D4 nn 0A 01 bp Printers: 3812, 5219 Action: The Begin Underscore command specifies that all subsequent text is to be underscored until the next End Underscore command is received. The bp parameter specifies the set of characters for which to bypass underscoring.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-37 Command: Begin Overstrike (BOS) Format: 2B D4 nn 72 ch bp gcgc cpcp Printers: 3812, 5219 Action: Starts character overstrike mode. After a Begin Overstrike command is received, all characters printed (except bypassed characters), are overstruck until an End Overstrike command is received. The ch parameter is the character to use for overstriking. The bp parameter specifies the set of characters for which to bypass overstriking.
Page B-38 AGILE 5250 ALLY Users Guide and Reference Command: Load Alternate Characters (LAC) Format: 2B FE nn mm ch i1 i2 i3 i4 i5 i6 i7 i8 i9 [i10]... Printers: 4214, 5224, 5225 Action: Specifies new character bit images for selected characters. The parameters ch and i1 through i9 (or i10) must be specified in sets (10 or 11 bytes per set). The mm parameter specifies the image type for all character images defined with the command.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-39 The printing mechanism of the 4214 prints characters only as 8 x 10. If character bit image information is loaded with 8 x 9 mode (mm=01h), the 9th slice of the image is automatically copied into the 10th slice, to expand the character width to 10 slices. The 5225 is not capable of printing solid black areas for more than 5 minutes. Permanent damage to the 5225 may result if the printer is made to print solid black areas for more than 5 minutes.
Page B-40 AGILE 5250 ALLY Users Guide and Reference Command: Absolute Horizontal Print Position (AHPP) Format: 34 C0 ah Printers: 3812, 4214, 5219, 5224, 5225, 5226 Action: Causes the current print position to move to the column specified by the parameter ah. Valid values are in the range of 01h to the current setting of Maximum Print Position (MPP), inclusive.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-41 Command: Relative Horizontal Print Position (RHPP) Format: 34 C8 rh Printers: 3812, 4214, 5219, 5224, 5225, 5226 Action: Causes the current print position to be moved horizontally rh character positions to the right. Any value that does not cause the print position to exceed the Maximum Print Position (MPP) is valid. If the rh parameter value is 00h, this command performs no operation. This command causes no change to the vertical position.
Page B-42 AGILE 5250 ALLY Users Guide and Reference Command: Transparent (TRN) Format: 35 nn [data] Printers: 4214, 5224, 5225 Action: Causes the printer to enter a transparent printer mode, where the subsequent nn characters are not checked for control codes. This command allows printing of the bit images previously associated with control characters by the Load Alternate Characters (LAC) command.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-43 Command: Subscript (SBS) Format: 38 Printer: 3812, 5219 Action: Causes the current print position to move down one-half line distance. On the 5219, only one level of superscript is supported. On the 3812, multiple levels of superscript are supported. IBMEMUL: Same as the 3812. PFS 2B SUBS ON is sent to the printer once for each subscript level.
Page B-44 AGILE 5250 ALLY Users Guide and Reference Command: Required Form Feed (RFF) Format: 3A Printers: 3812, 5219 Action: Performs the same function as the Form Feed (FF) control and restores the print position to the left margin. On the 3812, RFF causes the current page to print. IBMEMUL: Same as IBM. 275EMUL: No operation. Command: Substitute (SUB) Format: 3F Printers: 3812, 5219 Action: Prints the hyphen (-) graphic. IBMEMUL: Same as IBM. 275EMUL: No operation.
APPENDIX B SCS/DCA COMMAND SUMMARY Page B-45 Command: Numeric Space (NSP) Format: E1 Printers: 3812, 5219 Action: Prints the standard Space graphic. It is processed like Space (SP), but it is not recognized as a word delimiter, and it is not increased in width during formatting. IBMEMUL: Same as IBM. 275EMUL: No operation.
APPENDIX C PSEUDO TRANSPARENCY Introduction Most ASCII and EBCDIC printers have features that are not available on IBM midrange printers. If the users application software is aware that the destination of the data may be a non-IBM printer attached to a protocol converter, the application can send printer commands that will activate the printers advanced features. Printer commands must be sent to the printer without being modified by the System or the protocol converter.
Page C-2 AGILE 5250 ALLY Users Guide and Reference The transparent packet itself consists of two trigger characters, the data to be sent to the printer without translation, and one trigger character that is used to terminate the transparent packet.
GLOSSARY A A/B switch A switch that allows input devices to share a printer. AC adapter Converts alternating current to direct current. AFP Advanced Function Printing. AFPDS Advanced Function Printing Data Stream. Alternate host Input device other than the twinax host that can use the printer attached to the 5250 ALLY, such as a PC, network server, print sharing device or even another protocol converter. ASCII American Standard Code for Information Interchange.
Page G-2 AGILE 5250 ALLY Users Guide and Reference Buffer A block of internal memory that stores information until it is ready to be used. Byte A unit of information consisting of eight binary bits. Character codes are often represented in bytes. C Carriage Return A control character that (unless set to be interpreted as a line end) causes the printer to begin printing at the left margin of the current line.
GLOSSARY Page G-3 D Data stream Information transmitted between the host system and the 5250 ALLY. DB-25 A plug with 25 male or female pins. Decimal A base 10 numbering system. Default Formatting configurations that are present and are used automatically when no other information is available. Delimit To mark the beginning and end of a character string. Diagnostic A routine designed to verify the operation of a system and to find a malfunction in a device.
Page G-4 AGILE 5250 ALLY Users Guide and Reference F FCC Federal Communications Commission. FF Form feed. Firmware The pre-programmed EPROMs installed in the 5250 ALLY (the internal software). Form feed A control code that instructs the printer to process the current page and print it; a page end. The physical transport of paper to the beginning of a new page. G GDDM Graphical Data Display Manager. An IBM graphics software product. GML Graphic Machine Language.
GLOSSARY Page G-5 I IBM The worlds largest manufacturer of computing equipment. IBM 35 Hex transparency A standard form of transparency used in SCS data streams. IFS Interchange file separator. IGS Interchange group separator. Initialization To preset to proper starting values. Input The introduction of data from an input device to the computers main memory. Input device A unit used to enter data.
Page G-6 AGILE 5250 ALLY Users Guide and Reference LM Left margin. Logical buffer RAM used to display a displayable or printable image. Logical Unit Number A number assigned to a physical device for identification purposes. M Margin The number of spaces between the edges of a page and the beginning of text. Maximum presentation line The number of the last physical line on the page. Maximum presentation position The number of the rightmost character position on the physical page.
GLOSSARY Page G-7 Output Data transferred from a computers internal storage to an output device. Output device A unit that takes data output from a computer and presents it in the form desired by the user. Overstrike A DisplayWrite/400 function in which two characters may be printed in the same presentation position. P Page control The method by which page boundaries (margins) are determined. Page control may be done either by the host application or by the 5250 ALLY.
Page G-8 AGILE 5250 ALLY Users Guide and Reference Protocol A set of rules governing the format of data and the control of information interchange between two communicating devices. Protocol converter A device that takes input in one data communications format and outputs the data in another communications format. PSF Print Services Facility. R RAM Random access memory. Used for temporary storage of information.
GLOSSARY Page G-9 Space A print position where no character is printed. SVF Set vertical format. T Tab A carriage control that specifies output columns and rows. Terminator A character or sequence of characters that indicates the end of a data string that is variable in length. Timer A configuration option that determines how long an idle host or alternate host controls an output port. TM Top margin. Top margin The topmost position on a page where a character can be printed.
Page G-10 AGILE 5250 ALLY Users Guide and Reference Xerox A large manufacturer of computers, printers, peripherals and other electronic equipment. XES Xerox Escape Sequence. The native print mode for Xerox 2700, 3700, 4030, 4045 and 4213 printers. Also available on 4235 printers in XDPM.