Rank Xerox Electronic Documentation Solution for Xerox Printers Laser 3270 Programmer’s Guide Doc. no. D62077 Revision 00 WARNING: This equipment generates, uses, and can radiate radio frequency energy and if not installed and used in accordance with the instruction manual, may cause interference to radio communications.
3270 Programmer’s Guide Preface Preface August 1997 Please note that all products will be referred to as the “3270 protocol converter” or simply the “converter”.This manual applies to the 3270 Protocol Converter - the advanced use and programming of it. NOTE: Not all FSL functions and functionality described in this programmer’ s guide may be supported in the products referring to this manual. Please refer to your respective user’ s guide for a precise definition of supported functionality.
270 Programmer’s Guide Preface XES 3270 Programmer’s Guide A description of how to program the product in XES mode.The manual contains a full list and description of the supported XES setup functions. The manuals describe the configuration of the 3270 Protocol Converter to a specific printer or a specific application. The reader must have basic knowledge and understanding of IBM computer systems, especially the IBM 3270 Information Display System.
3270 Programmer’s Guide Table of Contents Table of Contents Preface..............................................................................................2 Table of Contents............................................................................4 1. Introduction..................................................................................5 1.1. FSL Printer Driver ................................ ............................... 6 1.2. PCL Printer Driver ................................ ......
3270 Programmer’s Guide Introduction 1. Introduction The 3270 Protocol Converter enables any Xerox laser printer to be connected to an IBM computer system. Printer Drivers- FSL, PCL and XES With the 3270 Protocol Converter you have the option of selecting between three printer drivers, the FSL, the PCL and the XES printer driver (only up to two drivers supported at a time in any given product). All printer drivers may not be supported in all the products.
3270 Programmer’s Guide Introduction In case the converter is equipped with a serial connector, it supports serial input or output. In all three printer drivers, centronics input and output is supported. The 3270 Protocol Converter can be used with most Xerox printers . NOTE: The printer driver must be selected before you start the operation of the device. 1.1. FSL Printer Driver To select the FSL printer driver, see the User’s Guide originally supplied with your product.
3270 Programmer’s Guide Introduction Programmer’s Guide, Doc. no.
3270 Programmer’s Guide Introduction • Full IBM 3268/87 and 4214 emulations including the APL feature and all applicable RPQs (subject to restrictions of the ASCII printers). • Serial input or output (in case of serial connector) • Access to all the special facilities on your Xerox printer from the host. • Automatic input sharing between Coax, Centronics and RS (in case of serial connector) input. • Coax FSL setup via Centronics.
3270 Programmer’s Guide Introduction The settings can be downloaded as special commands from your IBM system or from a PC to the Centronics or RS 232 (in case of serial connector) input port. The converter uses these commands for its own internal setup. Initially, the settings can be downloaded to the temporary memory area (see Chapter 3. Manipulation of Temporary and Permanent Memory Areas) of the converter, where they take immediate ef fect.
3270 Programmer’s Guide Function Selection via the Line 2. Function Selection via the Line Function Selection via the Line (FSL) sequences are special commands used for the downloading of settings to the 3270 Protocol Converter . The syntax of an FSL command is shown below. "%" is the defined escape character (i.e. ESC character). See the section on "Escape Character" in the following.
3270 Programmer’s Guide Function Selection via the Line Once a character has been defined as the ESC character, it cannot be printed or used as a normal character. However, it is not necessary to have an ESC character defined permanently. When the ESC character has served its purpose, it can be deleted.
3270 Programmer’s Guide Function Selection via the Line 2.1.1. Defining Temporary Escape Character No ESC character is defined when you receive the converter. If you wish to change the settings from the host system, you will have to define the ESC character . See below how to define "%" as the temporary ESC character . NOTE: The characters "," ";" and ":" must never be used as ESC character s, as they are used as separators in escape sequences and will give unpredictable printing results.
3270 Programmer’s Guide Function Selection via the Line 2.1.2. Removing Temporary Escape Character If you wish to remove the temporary ESC character so that it may be used as a printable character, you can define it as a blank as shown below. &&?? Removing the temporaryESC character . 2.1.3. Defining Permanent Escape Character The paragraph "Defining a temporary ESC character ", only described the temporary use of the ESC character .
3270 Programmer’s Guide Function Selection via the Line 2.1.4. Removing Permanent Escape Character If you wish to remove the permanent ESC character , you will have to follow the proce dure below: 1) Set Function 48, Select Permanent Escap e Character, to "00" (No ESC character ). 2) Define a new temporary ESC character as described in "Defining a Temporary Escape Character". 3) Save the settings using the command " X1".
3270 Programmer’s Guide Function Selection via the Line NOTE: In command strings in hex pair notation, only the hexadecimal characters 0-9 and A-F are allowed. The specifying of any other character may give unpredictable printing results. Between the two leading and the trailing ESC characters all IBM control codes, spaces, and the character "," will be ignored by the converter. They may be inserted in command strings to facilitate the reading of the datastream. 2.3.
3270 Programmer’s Guide Function Selection via the Line NOTE: The apostrophe notation may also be used in the programming of Function 61, "Setup for User Strings", Function 62, "Setup for IBM Defined Strings", Function 63, "Define Logos" (FSL & PCL only), Y100 "Printer Sharing", Y90 "Define User Escape String", and the Functions Y92-94.
3270 Programmer’s Guide Manipulation of Temporary and Permanent Memory 3. Manipulation of Temporary and Permanent Memory Areas When your settings have been downloaded to the temporary memory through the FSL Functions, you may wish to save them permanently for future uses. For this purpose, special commands can be used. Once the settings have been saved, the converter will read them each time power is turned on, or when it registers a special command in the datastream. Section 3.1.
3270 Programmer’s Guide Manipulation of Temporary and Permanent Memory See Fig. 3-1 below which illustrates the interaction of the three levels. Fig.
3270 Programmer’s Guide Manipulation of Temporary and Permanent Memory 3.2. Commands for Storing and Restoring Settings The following commands allow you to manage the temporary and the permanent memory areas. You may save the temporary memory settings in the permanent memory, or you may overwrite the temporary memory settings by loading the settings from the permanent memory or the factory default area.
3270 Programmer’s Guide Manipulation of Temporary and Permanent Memory 3.2.1. Functions where power off/on is needed Function Function Function Function Function Function Function Function Function 1 7 14 15 16 17 18 24 38 Buffer Size Case Enable Graphics Baud Rate Number of Data Bits for Serial Input Parity for Serial Input Number of Stop Bits for Serial Input Port Selection IBM Communication Feature 3.2.2.
3270 Programmer’s Guide Manipulation of Temporary and Permanent Memory 3.4. Restricting Access This facility allows you to restrict access to the temporary memory and/or the permanent memory areas. The command is an FSL command which will have effect as soon as the converter receives it. See the example in the following and Function Y49 in the list of supported FSL Functions for the two printer drivers. Escape Sequence Function %Y49,0, (opt.
3270 Programmer’s Guide IBM Related Functions 4. IBM 3270 Related FunctionsSpecial Settings This chapter describes those FSL Functions specifically related to the requirements of the IBM 3270 system. SCS command related Functions, Functions which need to be stored and where powering off and on the converter is needed to inform the controller about the functionality, IBM RPQs and Intervention Required Timer (IRQ).
3270 Programmer’s Guide IBM Related Functions there are differences depending on which printer driver you have selected. For colour selected by attrubute, the Function Y62 string options for colour have to be programmed. For details you are referred to the separate FSL , PCL and XES 3270 Programmer’s Guides as the functionality of Function Y62 depends on which printer driver you have selected. For APL characters selected by attribute, characters from the APL/LU3 character table will be used. 4.1.
3270 Programmer’s Guide IBM Related Functions NOTE: If the converter is connecteddirectly to an IBM 4331 or 4361, the buffer size of 1920 characters (Function Y1=2) should be specified, due to a hard ware restriction on the mainframe. 4.3. IBM RPQ Settings The Functions 25 to 33 are similar to the RPQs you can order for an IBM 3287 or IBM 3268 printer as shown in the following table. On the IBM 4214, you may set the options from the front panel.
3270 Programmer’s Guide IBM Related Functions If formatting problems occur at the initial installation of the converter, these problems may be solved by selecting the settings matching the appropriate IBM RPQs. However, as the RPQ settings interact to a great extent, it is recommended that you contact your point of purchase for details. 4.4. IRQ Time IRQ (Intervention Required) is a 3270 command which signals to the host that action is required at the device (paper out, forms jam, etc.
3270 Programmer’s Guide IBM Related Functions • If a "BUSY" signal is received but no "DESELECT", "FAULT" or "PAPER ERROR" signal, it is handled as a busy signal. In order to completely disable the IRQ, you must set all parameters to "00" NOTE: IRQ caused by printer deselect (Y46, value 2, Hold Time Out) cannot be changed.
3270 Programmer’s Guide Serial Input 5. Serial Input NOTE: This section only applies if your product is equipped with a serial connector. The serial port is connected to the serial output on a PC or similar source to enable sharing the printer with the host. For this connection you need a spare cable ending in a 25-pole RS connector (order no. 076183).
3270 Programmer’s Guide Printer Sharing 6. Printer Sharing The 3270 converter enables printer sharing between the system and a PC. For this purpose it is possible to specify a timeout period. If, for example, the printer is receiving input on the parallel port and there is a break in the transmission of data, the other input ports will not be polled for the period specified. The factory default timeout is 20 seconds. The timeout may be changed to suit your requirements.
3270 Programmer’s Guide Translate Tables 7. Printer Initialization by User Strings This chapter covers the facilities of the converter activated by simple commands and related to special FSL Functions. The FSL Functions and the converter commands are grouped according to their tasks. 7.1. The User Strings In the converter you may save up to 8 user strings (0-7). They can be sent as follows: • When the converter is powered on (if specified in Function Y51, User Defined String(s) at Power On).
3270 Programmer’s Guide Translate Tables been programmed, you only need to enter 3 characters in the datastream to send the user string to your printer. %Z Sending user string under host control Several functions relate to the user string facility. Among these functions are: • Function Y61, Setup of User Strings, used for the defining of the user strings.
3270 Programmer’s Guide Translate Tables Here, 1A, 'ABCD' will exchange future occurences of escape 1A with ABCD. The rest of the sequence (:8F,'%Y2,8%') will exchange future occurences of escape 8F with %Y2,8% (to select 8 LPI). As there are differences between the printer drivers in connec tion with printer sharing, you are referred to either the FSL (D62071), the PCL (D62030) or the XES (D62067) 3270 Programmer’s Guides.
70 Programmer’s Guide Appendix A Appendix A: RS 232/V24 Cable Connection(serial support) Using the serial port The following connections are available in the serial plug: pin 1 pin 2 pin 3 pin 4 pin 5 pin 6 pin 7 pin 8 pin 9 NC RX data TX data DTR GND (Signal) DSR (Busy) RTS (always high) CTS N.C.
3270 Programmer’s Guide Appendix B Appendix B: List of Abbreviations APL ASCII APO A Programming Language American Standard Code of Information Interchange Automatic Page Orientation CPI CR COR Characters Per Inch Carriage Return Computer Output Reduction DSC 3270 Information Display System data stream Compatibility EBCDIC ESC Extended Binary Coded Decimal Interchange code ESCape character FF FL FMH FSL Form Feed Form Length Function Management Header Function Selection via the Line GFID Font ID
3270 Programmer’s Guide Index Index PCL Printer Driver, 6; 7 Permanent ESC Character, 13; 14 Printer Drivers FSL, 5 PCL, 5 Printer facilities, 29 User strings, 29 Printer Sharing, 28 Product features, 7 Programming the ida 270 C/RS, 8 —A— Abbreviations (List of), 33 Access (Restricting), 21 Apostrophe Notation, 15 F — — FSL Printer Driver, 6 Function Selection via the Line, 10 Apostrophe Notation, 15 Defining Permanent ESC Character, 13 ESC Character, 10 Removing Permanent ESC Character, 14 Removing Temp