Reform Capture Agents

From FabSoft
Jump to: navigation, search

Because the Reform Spooler monitors one directory for text/ASCII or other file types to appear, your application needs a way to place these files in the spooler directory. Reform comes with capture utilities to make this possible by seamlessly linking to all operating systems and applications.

Generally, a typical workflow would look like the following:

ReformCapture1.PNG


Data is sent from the printing application to the Reform server via a capture utility. Generally, the Reform Printer will be used to capture data from applications and send it to Reform for processing. Additionally, the LPR server/TCP IP capture utilities can be used to process data sent from hosted solutions (Unix/Linux/AS400), whereas MOST can be used to capture jobs scanned from MFPs.

Reform Printer

Installation

  1. Browse to the address (either hostname or IP address) of the Reform Server
    Example: If the Reform Server's IP address is 192.168.0.76, then you would browse to \\192.168.0.76\ from within Windows.
  2. Double click on the shared printer named ReformPrn.
  3. When prompted to install the driver, select Install Driver.
  4. 15px-Yes check.svg.png Done – The Reform VDP Printer will now be available to print from in Windows (see Printing to the Reform Printer).

Printing to the Reform Printer

  • From any Windows application that allows printing, select Reform VDP Printer on <Reform Server Address> from the list of available printers.
    2018-07-31 11-25-23.png

Generic Text File

Printing to a Generic Text File

Some form systems, such as accounting systems and others, are capable of writing to files at printing time. To use this option, the user would select from their system the option to print a file, and then specify a file name. This file name should be the same as the name of the Reform form that has been pre-defined in the Reform editor, and the location should be the same as the Spooler directory defined in Reform Setup. It is recommended to increment or make the file extension unique.

Reading from a Common Text File or Temporary Print File

Some form systems, such as accounting systems and others, create print files in a temporary or defined directory. Many software manufacturers make an interface to Reform. Please consult your form system manufacturer for such interface information. The setup window can be customized to fit many types of output text files.

TCP/IP (Port 9100)

To capture a data streams being sent from a host application to the printer via a standard TCP/IP connection (by default port 9100 is used), the Reform 9100 Port Capture Utility should be used on the Reform Server. In this scenario, the Host system must first be configured to print the Server running the Capture Utility. Typically, the host system will be directed to the Reform Server by specifying the IP address of the server in the print settings. Once the host system is configured, The 9100 capture utility should be started on the Server. 9100 Port Capture Utility resides in Reform’s Miscellaneous folder.

  1. To start Port 9100 Capture utility, double click on the file named 9100PortCapture.exe found in <Reform Directory>\Misc\
    Captureutil1.png
  2. Click on the Setup button just below the menu bar. A new window will open. Typically the files should be saved to Reform’s Spooler folder. Click the Ok button when the desired setting have been entered.
    2018-08-02 13-31-45.png
  3. Click the Start or Stop buttons to begin/end data capture over port 9100.
  4. Now that the port 9100 capture has been configured and started, you will see a log of any data streams that are sent to the server over port 9100 appear in the application window.

Once the application has been configured and data is successfully reaching the Reform server's spooler directory, you will want to close out of this application and enable/start the service named RM_TCPCapture15. This will allow data capture without needing to have the application interface open (see instructions below).

Enable TCP/IP Capture Service

Pictogram voting info.svg.png  Note
The 9100 Port Capture utility (9100PortCapture.exe) must be closed before starting the service, as only one process can bind to port 9100 at a time.
  1. Open the Windows Services by pressing ⊞ Windows Key + R, then enter services.msc and press the OK button. The Windows Services interface will open.
  2. Find the service named RM_TCPCapture15 from the list of services, then right click on it and select Properties.
  3. Change the Startup Type to Automatic, then click the Apply button.
  4. Click the Start button to start the service.
  5. Click the OK button to close the window. You can also exit out of the Windows Services interface at this point.
  6. 15px-Yes check.svg.png Done — the service has now been started and is listening for data over port 9100.

AS/400, System 36, System 38

The AS/400 capture method is referred to as Inbound Connectivity. Inbound Connectivity is the process of redirecting an application’s print stream into a file so the Reform Spooler can automatically process the information.

Methods used to accomplish Inbound Connectivity

The first method uses AS/400 native functions and is called Line Printer Requester and Line Printer Daemon or LPR/LPD for short. The AS/400 printer Output Queue is redirected to a remote printing device LPR. This printing device is the Reform Printer driver that resides on a Windows computer LPD. This method uses TCP/IP to connect the AS/400 and the Windows computer.

Reform15 VDP 216.png

Create AS/400 Output Queue

  1. To Create an AS/400 Output Queue, type in CRTOUTQ at the AS/400 command prompt and then press F4, followed by F10.
  2. Once the Create Output Queue screen appears, fill it in from the example below, the Output queue can be any name. In this example we used TESTPRT04, but you should use a name the means something to the solution.
    As400 0.png

Remove Printer Codes

In order to remove printer codes you must first edit the WSCST object.

  1. To retrieve the WSCST object type in RTVWSCST at the AS/400 command prompt.
    As400 1.png
  2. Press Enter to end this section.
  3. Type in strseu srcfile(qusrsys/qtxtsrc) srcmbr(textonly) at the AS/400 command prompt. This will open up the WSCST object in a text editor.
    As400 3.png
  4. Remove the lines for INITPRT, SPACE and CARRTN, when finish your results should look like:
    As400 4.png
  5. To save the changes to WSCST object type in CRTWSCST at the AS/400 command prompt.
  6. Press Enter to end this section.

Configure AS/400 Output Queue

To change an AS/400 Output Queue, type in CHGOUTQ at the AS/400 command prompt.

  1. Change the Output Queue setting to direct the output stream to a Network IP.
    As400 6.png
  2. Press the Page-Down key to view the next screen.
  3. This screen allows you to specify the IP address of the computer that will be running the Reform Spooler. In the example below, the Reform Spooler is running on a computer with an IP address of 10.0.0.233.
    As400 7.png
  4. Press the Page-Down key to view the next screen.
    As400 8.png
  5. Press the Page-Down key to view the next screen.
    As400 9.png


Unix and Linux Operating Systems

Configuring Unix & Linux

The Unix and Linux capture method is referred to as Inbound Connectivity. Inbound Connectivity is the process of redirecting an application’s print stream into a file so that the Reform Spooler can automatically process the information.

Methods used to accomplish Inbound Connectivity

The first method uses Unix/Linux native functions, and is called Line Printer Requester and Line Printer Daemon, or LPR/LPD for short. The Unix/Linux printer Output Queue is redirected to a remote printing device LPR. This printing device is the Reform Printer driver that resides on a Windows computer LPD. This method uses TCP/IP to connect the Unix or Linux machine to the Windows computer.

The second method uses file transfer to allow the Reform Spooler to process your print streams. First, create a directory on the UNIX file server and call it "ReformSpooler" or something to that effect. This directory will serve as a shared directory between the UNIX machines and the Windows machine running the Reform Spooler. In Reform setup, change the Spooler Directory Location to the shared spooler location on the UNIX file server or the Windows machine. The UNIX applications will need to redirect their printouts to this shared spooler directory in order for Reform to detect and process the output files. There are many utilities on the market to make the connection between the UNIX and Windows computers; the two that we recommend are:

Sambawww.samba.org
FacetWin by FacetCorpwww.facetcorp.com

Reform15 VDP 219.png

Setting up a Unix LPR Printer

SCO Unix

  1. Go to scoadmin >> Printers >> Printer Manager.
  2. Go to Printer >> Add Remote >> Unix.

The Host name is the IP address of the windows computer running the Reform Spooler.

The Printer name is reformprn.

Your Unix screen should look like the following, though the Host IP address may differ:

----------------------------- Add Remote UNIX Printer ------------------------------------------

Host 192.168.0.3______________________________________| [ Select... ]

Printer reformprn ____________________________________| [ Select... ]

[ ] Use extended remote printing protocol

[ OK ] [ Cancel ] [ Help ]
Pictogram voting info.svg.png  Note

In some systems like AIX you cannot use an IP address for the host address. Instead, you must add a name to the Host file, this host file is usually located in the /etc/ directory.

Example: In the HOST file you have REFORM 192.168.0.3. When you add your printer queue you would use the name REFORM instead of the IP address.

Setting up a Linux LPR Printer

Linux Redhat 7.2 KDE
Navigate to System > Printer Manager, and adjust the following settings:
First Dialog
  • Queue Name: ReformPrinter
  • Type: Unix Printer LPD
Second Dialog
  • Server: <Windows IP #>
  • Queue: reformprn
    Pictogram voting info.svg.png  Note: the Windows IP # is typically the IP address of the windows computer running the Reform Spooler.
Third Dialog
  • Printer: Text Only Printer
Linux (other)

Other Linux systems can edit the printcap file directly. The queue name in the printcap file located in the /etc/printcap/ directory should look like the following:

 ReformPrinter:\

 :sh:\

 :ml=0:\

 :mx=0:\

 :sd=/var/spool/lpd/ReformPrinter:\

 :af=/var/spool/lpd/ReformPrinter/ReformPrinter.acct:\

 :rm=192.168.0.3:\

 :rp=reformprn:\

 :lpd_bounce=true:\

 :if=/usr/share/printconf/util/mf_wrapper:
Pictogram voting info.svg.png  Note

Change the rm ip # to reflect your Windows IP address.

AIX LPR Setup instructions

  • Enter the following command:
    # vi /etc/hosts
  • In vi, add an entry for Reform with IP address being that of windows machine that is running Reform.
    Example: If your Reform server's IP address were 192.168.0.76 you would add the line REFORM 192.168.0.76
  • To insert a new line move down to the location and press [ESC] + [Shift] + [i]

To quit and save press [ESC], then type wq

Vi command

Text input mode can be used to enter and delete new text in your file. Below is a table showing the various key sequences to place you into text input mode as well as those to return to command mode and perform operation while in text input mode. When you are in text input mode, everything you type will be placed into your document until you press the [ESC] key.
Key Action
[a] Insert after cursor A Append to end of line
[i] Insert before cursor I Insert at beginning of line
[o] Insert line below cursor O Insert one line above cursor
[ENTER] Add a new line [Backspace] Move back one character
[CTRL] + [H] Move back one character
[CTRL] + [I] Insert a tab
[CTRL] + [T] Move to next tab setting
[ESC] Returns to command mode
[CTRL] + [V] Quote next character
[CTRL] + [J] Move down one line
[CTRL] + [W] Move back one word

Add a Standard Remote Print Queue

  • Type or select values in entry fields.
  • Press Enter AFTER making all desired changes.
  •   [Entry Fields]
    1. Name of QUEUE to add    [reformprn]
    2. HOSTNAME of remote server    [reform]
    3. Name of QUEUE on remote server   [reformprn]
    4. Type of print spooler on remote server   AIX Version 3 or 4
      Backend TIME OUT period <minutes>
      Send control file first?    []
      To turn on debugging, specify output file pathname no
      DESCRIPTION of printer on remote server  [reform]

Quick test:

At the AIX prompt:

lp –d reform /etc/hosts

you should see a file appear in the \Reform…\Spooler directory

Note make sure the Reform Spooler is off or in the stop position.


Trouble Shooting:

On the Reform windows machine go to DOS prompt:

Type ipconfig

Note this should return the IP address that you specified in the AIX host file.

Windows Type NETSTAT –NA

Note you should see a port 515 that is in the listening state, if not the TCP/IP Print windows service may not be running. To check windows service go to Control Panel >> Administration Tools >> Services.

AIX prompt type lpstat –preformprn to see that status of the job

AIX prompt ping the windows machine by typing:

ping reform

Note if ping fails the /etc/hosts table may have the wrong IP number, the IP number should be the same as the ipconfig results from the windows machine.

Configuring the Reform Printer

Note: Before proceeding, you must install the Reform Printer on the machine running Reform. See the section titled ’Reform Printer Driver’ in this manual for Reform Printer installation instructions.

Once the Reform Printer has been installed, it must be configured to accept print jobs. To do so, follow the steps below:

Open your Windows Control Panel on the machine running Reform (Start >> Control Panel), and double-click Reform Port Monitor Setup.

Click the Advanced tab, and make sure the box labeled ’Enable LPD (Line Printer Daemon)’ is checked, as illustrated below.

Reform15 VDP 220.png

Click OK to exit the Reform Port Monitor Setup.