com.ibm.as400.access

Class SCS5256Writer

  • All Implemented Interfaces:
    Closeable, Flushable, Appendable
    Direct Known Subclasses:
    SCS5224Writer


    public class SCS5256Writer
    extends OutputStreamWriter
    The SCS5256Writer class writes an SCS 5256 data stream to an output stream, translating characters into bytes of the specified CCSID. SCS5256Writer is the simplest SCS generator. It supports text, carriage return, line feed, new line, form feed, Absolute Horiz/Vert positioning, Relative Horiz/Vert positioning, and Set Vertical Format.
    Version:
    1.1
    See Also:
    OutputStreamWriter
    • Field Summary

    • Constructor Summary

      Constructors 
      Constructor and Description
      SCS5256Writer(OutputStream out)
      Deprecated. 
      Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
      SCS5256Writer(OutputStream out, int ccsid)
      Deprecated. 
      Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
      SCS5256Writer(OutputStream out, int ccsid, AS400 system)
      Constructs a SCS5256Writer.
      SCS5256Writer(OutputStream out, String encoding)
      Deprecated. 
      Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
    • Constructor Detail

      • SCS5256Writer

        public SCS5256Writer(OutputStream out)
        Deprecated. Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
        Constructs a SCS5256Writer. The default encoding will be used.
        Parameters:
        out - An OutputStream.
      • SCS5256Writer

        public SCS5256Writer(OutputStream out,
                     int ccsid)
                      throws UnsupportedEncodingException
        Deprecated. Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
        Constructs a SCS5256Writer.
        Parameters:
        out - An OutputStream.
        ccsid - The name of the target CCSID to be used.
        Throws:
        UnsupportedEncodingException - If ccsid is invalid.
      • SCS5256Writer

        public SCS5256Writer(OutputStream out,
                     String encoding)
                      throws UnsupportedEncodingException
        Deprecated. Replaced by SCS5256Writer(OutputStream, int, AS400). Any SCS5256Writer object that is created without specifying an AS400 system object on its constructor may not behave as expected in certain environments.
        Constructs a SCS5256Writer.
        Parameters:
        out - An OutputStream.
        encoding - The name of the target encoding to be used.
        Throws:
        UnsupportedEncodingException - If encoding is invalid.

    • Method Detail

      • absoluteHorizontalPosition

        public void absoluteHorizontalPosition(int column)
                                        throws IOException
        Moves the print position to the column specified. Moving beyond the right end of the page will cause an error on the printer.
        Parameters:
        column - The new horizontal print position. Valid values are 0 to the maximum print position as set in the SetHorizontalFormat method. A value of 0 causes a no-op. The number of columns on a line is dependent on the current character width (CPI) and the width of the page.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • absoluteVerticalPosition

        public void absoluteVerticalPosition(int line)
                                      throws IOException
        Moves the print position to the line number specified. Moving above the current line causes a form feed and move to the specified line on the next page.
        Parameters:
        line - The new vertical print position. Valid values are 0 to the current forms length as specified by the SetVerticalFormat method. A value of 0 causes a no-op. If the value is less than the current line, the forms are moved to the specified line of the next logical page.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • carriageReturn

        public void carriageReturn()
                            throws IOException
        Adds a carriage return control to the stream.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • endPage

        public void endPage()
                     throws IOException
        Ends current page. The application MUST use this method to end the current page after the page data has been written.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • getEncoding

        public String getEncoding()
        Returns the name of the encoding being used by this stream. It may return null if the stream has been closed.
        Overrides:
        getEncoding in class OutputStreamWriter
      • lineFeed

        public void lineFeed()
                      throws IOException
        Adds a line feed control to the stream.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • newLine

        public void newLine()
                     throws IOException
        Adds a new line control to the stream.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • relativeHorizontalPosition

        public void relativeHorizontalPosition(int chars)
                                        throws IOException
        Moves the print position the number of characters specified. Moving beyond the right end of the page will cause an error on the printer.
        Parameters:
        chars - The number of character widths to move. Valid values are 0 to the maximum print position minus the current column. The maximum print position is the current CPI * 13.2 inches. A value of 0 causes a no-op.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • relativeVerticalPosition

        public void relativeVerticalPosition(int lines)
                                      throws IOException
        Moves the print position the number of lines specified.
        Parameters:
        lines - The number of lines to move down the page. Valid values are 0 to the last logical line on the page. A value of 0 causes a no-op.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • setHorizontalFormat

        public void setHorizontalFormat(int NumOfChars)
                                 throws IOException
        Sets the Horizontal Format. This specifies the maximum number of characters on the line.
        Parameters:
        NumOfChars - The maximum number of characters. Valid values are 0 to 255. A value of 0 causes horizontal format to be set to the printer default.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • setVerticalFormat

        public void setVerticalFormat(int NumOfLines)
                               throws IOException
        Sets the Vertical Format. This specifies the maximum number of lines on the page. Note that when the printer executes this command the current line number on the printer is set to 1. Also, the combination of LPI and Vertical Format should not exceed 159 cm (63.75 inches). Changing the Line Density changes where the maximum line is on the physical page.
        Parameters:
        NumOfLines - The maximum number of lines. Valid values are 0 to 255. A value of 0 causes vertical format to be set to the printer default.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • write

        public void write(char[] databuffer,
                 int offset,
                 int length)
                   throws IOException
        Writes a portion of an array of characters.
        Overrides:
        write in class OutputStreamWriter
        Parameters:
        databuffer - The buffer of characters.
        offset - The offset from which to start writing characters.
        length - The number of characters to write.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • write

        public void write(int c)
                   throws IOException
        Writes a single character.
        Overrides:
        write in class OutputStreamWriter
        Parameters:
        c - The character to write.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • write

        public void write(String str)
                   throws IOException
        Writes a string.
        Overrides:
        write in class Writer
        Parameters:
        str - The string to write.
        Throws:
        IOException - If an error occurs while communicating with the system.
      • write

        public void write(String str,
                 int offset,
                 int length)
                   throws IOException
        Writes a portion of a string.
        Overrides:
        write in class OutputStreamWriter
        Parameters:
        str - The string to write.
        offset - The offset from which to start writing characters.
        length - The number of characters to write.
        Throws:
        IOException - If an error occurs while communicating with the system.