1. Removed old ini file format support
2. Removed Windows CE detection
3. Changed messages for memory corruption and to abort QScan when this condition is detected
4. added code to extract rtf files
5. added prompt before overwriting a .txt or .rtf file

Full Revision History

---

If you have any questions or suggestions, please visit our online support forum.

---

Requirements

• Hercules 3.04 or later.
• The printer(s) must be defined in the Hercules config file with the CRLF option.
• At least one of the following Operating Systems:
1. MVS 3.8j system with JES2
   
2. DOS/360 Release 26.2 with or without POWER.
   
3. MVT 21.6 with ASP

Since HASP and ASP evolved into JES2 and JES3 respectively, I suspect that QScan might be able to support MVT with HASP and MVS with JES3 already.  I have not been able to verify this.  If you have working HASP or JES3 system, try QScan and let me know the results.

---

Host Operating System Dependencies

MVS 3.8j with JES2

QScan was designed to work with output produced with the Tur(n)key JES2PARM default of:
        &PRIDCT=33                           LOCAL SEPARATOR PAGE LINE COUNT
This results in separator page with the jobname and number with the large block letters.  QScan also use works with the value of PRIDCT=1. QScan V1.4.1 has not  been tested with any other values of PRIDCT.  If you try it, drop me a line on my support page and let me know how it works (or didn't work).

DOS/360

The LIST option must be on by default.  Do not use the '// OPTION NOLIST' since this will suppress the JCL from printing. Detecting start of job is a little tricky under DOS/360.  QScan looks for the text '// JOB ' on the first line of each page printed.  The job ends when another job is detected or end of file is detected.  The default separator page, if enabled, prints several lines of asterisks.  The separator is not used for job detection. 

MVT with ASP

An unmodified version of the "ASP MVT" distribution was used for testing QScan.

---

Possible Future Enhancements

• Support for JES3. 
  
• Support for DOS/VS....
• Support for (gasp) VM.
  

---

Installing QScan 1.6.0

To install QScan 1.6.0, click on the file you downloaded (QScan-1-6-0-Setup.exe) and answer the questions.  After the install is completed, if you selected the desktop icon, you should see the following icon on your desktop.

A default QScan.ini file is supplied.  If it does not exist, when you run QScan a QScan.ini file will be created in the same directory as QSCAN.EXE. This file contains the setting for the printers and some of the options.

I don’t suggest changing this .ini file except via QSCAN. The INI file is written whenever you exit via the FILE->EXIT  or via the "X" close.
 

---

Usage

Click on the QSCAN icon and you should see a list of jobs in your virtual output bin (assuming you have output).

 

1. Most of the options and menus are self explanatory so I won’t belabor the obvious. 
2. If Hercules is running while QScan is open, you may need to do a File->Refresh to rebuild the job selection list in case any additional jobs are added to the bin.
3. File->Extract to File will copy all the output for the job that is being displayed to a file.  The file will be created in the same directory as the main print files.  For JES2, the file name will be jobname-J####.txt
   
4. File->Extract to RTF will copy all the output for the job that is being displayed to a RTF format file.  The file will be created in the same directory as the main print files.  For JES2, the file name will be jobname-J####.rtf. The RTF format may be openned by MSWord or OpenOffice to print. The RTF is formated to be as close to the layout of a 1403 printer.
   
5. File->Browse will copy all the output  for the job that is being  displayed to a file.  Notepad will be launched to view the entire printout rather than the restricted view provided by QScan.
6. View menu allows you to change the window size.
   
7. The Asc radiobuttons indicate that the job list dropdown is displayed in oldest to newest sequence.  Desc displays the job list in newest to oldest sequence.
8. The two Max fields allow you to specify the maximum number of lines or characters to display. Due to memory restrictions, only a finite number of output may be displayed. You can type over these to change the maximum. For OS type of LOG, the last maximum number of lines is displayed. For all others, the first maximum number of lines is displayed.

---

Defining  Printers

Click on the File Menu -> Printers and will display the following.

 
The Printers drop down lists all of the Hercules printers defined to QScan.  Note the printers listed are the default printers, which just happens to be my configuration.  Since your system is different than mine, you will need to change the printers.

You may use the Add Printer, Change Printer or Remove Printer to change the drop down list of printers and the files associated with the printers.

When QScan is started, the first printer on the list is the selected by default.  In this example, MVS JES2 00E is the first printer accessed.

Clicking on Add, Change or Remove Printer results in a screen similar to the one below.

The top part of the screen shows all of the printers defined, the hardare unit number, the operating system and the Hercules text file associated with the printer.

To change or delete a printer, click on the number in the left most column.  The printer will be marked as deleted or an area to change the information will be displayed.  To add a printer, click on an unused number. 

Determine Hercules printer file locations

In order to connect the Hercules printers to QScan, the Hercules config statements for the printers must point to disk files accessible to your Windows system.  This is a segment of a Hercules config file.

Adding a Printer

• Click on the File->Add Printer drop down.
• Click on a "blank" line number.
• Fill in the printer information and select the file. Use the Browse button to find the file.
• Save it.

Changing a Printer

• Click on the File->Change Printer drop down.
• Click on a the line number for the printer you want to change.
• Change the printer information.  Use the Browse button to find the file.
• Save it.

Delete a Printer

• Click on the File->Delete Printer drop down.
• Click on the line number for the printer you want to delete.
• Save it.

---

Hardcopy output

Once a file is saved via File->Extract to RTF, you may open it with any other Windows application to view or print it. The RTF is generated with landscape orientation and top/bottom margins of .2 inches and left/right margins of .4 inches. The font is 8pt Courier New. MS Word and Open Office can open an .RTF file.

Once a file is saved via File->Extract, you may open it with any other Windows application to view or print it. Here are some suggestions  on how to print it:

Using MS Word

• Open the print file.
• change the paper orientation to landscape.
• change you view to page view
• change the font for the entire document to "courier new 8 pt"
• change the left and right margins to ".4"
• change the top and bottom margins to ".2"

At this point, you should have something that looks like it was printed on 1403 printer.

---

Revision History

New Features added in QScan 1.5.0

---

New Features added in QScan 1.4.1

---

New Features added in QScan 1.4.0

---

New Features added in QScan 1.3.1

---

New Features added in QScan 1.3.0

---

Features Added in QScan 1.2.2

Due to memory constraints, there is a limit on the size (i.e number of lines) which can be viewed by QScan.  To circumvent this restriction, a new file option (browse w/NotePad) was added.  This option copies the job to a temp file and opens it in NotePad.  Be sure and uncheck NotePad's word wrap option.

The screen size can be changed by the View menu.

A Queue refresh is performed upon starting QScan.

Miscellaneous fixes were also applied for reliable operation.

A new installer was created  to help insure all of the files are installed (and uninstalled) correctly.

---

If you have any questions or suggestions, please visit our online support forum.

---