QSub is a
Windows® program to submit "cards" to a Hercules "virtual" card
reader. QSub also allows you to edit the "deck" before submitting it to
Hercules. This is particularly useful for editing "decks" using
PC based software, for submitting data generated by PC applications or
submitting JCL to Hercules running on the same or a different PC.
Using QSub and QScan (an output viewer), I am able to do some
serious work
without having to sign on to TSO, sometimes for days. All of the
jobs were
submitted via QSub and result viewed via QScan.
New Features added in QSub 1.3.0
Added "Hercules" and "Edit" to the menu bar.
Add Edit functions to find and replace text.
Changed application to remove the .INI file and store
options in the Windows registry.
The card reader must be defined in the Hercules config file
with
SOCKDEV,ASCII, TRUNC and EOF options.
A Windows® PC which meets the requirements
for Hercules.
Operating Systems Tested
Since QSUB is interacting with Hercules, I suspect
that it will work with any operating system that runs under
Hercules. The following operating systems were tested:
Tur(n)key MVS 3.8j system with JES2.
MVT 21.6 with ASP.
DOS/360 Release 26.2 with and without POWER.
If you try QSUB with any other operating system, please let
me
know if QSub works or not.
QSub with is a little tricky to use with DOS/360 without
POWER. DOS/360 requires the operator to load the cards in the
reader and the
press ENTER on the console each time the card reader needs to be
started.
With POWER, the JCL will spool and begin
execution as soon as spooling is complete. Without
POWER, be sure to press the ENTER key on the console to start
the job running. A "time out" may occur if you wait too long from
starting the submit and pressing enter. A problem I
encountered with DOS was how to handle an aborted job. On a real
360, when the job aborted, I would remove the unread part of the deck
from the
card reader and then run a EOJ card.
Update Hercules card
reader definition
In
order to submit a "deck" to Hercules card reader, the Hercules config
statements for the card reader must be like this segment.
where:
EDFRV37 is the name or IP address of the Windows® PC Hercules is
executing on. In this example, EDFRV37 is the network ID for my
PC where Hercules is running. The name "localhost" or IP address
127.0.0.1 can be used if
Hercules and QSub are executing on the same PC. For Hercules
running on a remote system, use the IP address (i.e. 192.168.0.8) of
that system.
:
3505 is the port address Hercules is waiting for input.
Note - the IP address and port id are also specified in a the
Hercules Menu option. The defaults are "127.0.0.1" and "3505" and
will
work for most
users. If you are need to change the IP address or port id, edit
hercules config and
the adjust the items in the "Hercules" menu option.
Running QSUB
Click on the
QSUB icon and
you should see a screen like this.
Usage
Most of the
options and menus
are self explanatory so I won’t belabor the obvious.
File->Open
will read the selected file into the edit window.
File->Open/Trim will read the selected file. Columns
73-80 will be truncated and then the file displayed. If you save
the file in the edit window, the sequence numbers will be lost.
File->Save will write the data in the window back to the
original file.
File->Save as will prompt for a file name and then save
the window into that file.
File->Submit will allow you to select a file to submit to
Hercules. Unlike the "Submit JCL" button, the JCL will be submitted
directly from the file. There is no impact on the edit window.
Hercules->Address allows you to change the IP address of
the Hecules system you wish to submit the job to.
Hercules->Port allows you to change the port at the IP
address of the Hercules system you wish to submit the job to.
Edit-> opens the edit menu that gives access to the
extended edit capabilities.
View->Small sets the windox box size to a small size.
View->Large sets the window box size to a large size.
The "Submit JCL" button will submit the file in the
window
with
out saving the original.
Apply 5 sec. delay, when checked, causes QSub to pause 5
seconds before starting to submit the "cards" to the host OS. Normally
the delay is not needed but
if you are running an OS like DOS/360 without power where you have to
perform console
function to start the reader. Use is optional for MVS JES2 and MVT ASP.
Editing JCL
The editing capabilites are limited to simple
insert, delete, cut,
paste, find, find all, replace, replace next, replace all and
uppercase. Editing functions are available using "right
clicking" or via the Edit menu option (see left).
For the find and replace functions, the text should be entered in the
boxes on the bottom of the screen. The find and replace routines
are case sensitive. Since most mainframe functions use caps, I
added the upcase function to translate selected text or the entire
window to upper case.
Macro Facility
Macros are lines in the file (and the window) which start with
"%%" in column 1. Unless noted, no other text should appear
on the linr following the macro. Supported macros are:
%%ucase
%%lcase
%%asis
%%include
Ucase, lcase and asis indicate if the JCL is to have case
conversion or not. The macro itself is not submitted.
Ucase, which is the default, indicates all data submitted should be
translated to uppercase before being submitted. Lcase indicates
all data submitted should be translated to lower case. Asis
indicates no case translation is desired.
"Cards" can be included using the "%%INCLUDE"
statement. The "%%" must start in column 1. A fully
qualified file name must start in column 11. Nothing else should
be entered in the line. Nested %%INCLUDEs are not supported in
this version of QSub.
Example:
%%INCLUDE c:\stuff\to\include.txt
Submitting JCL
Clicking on either File->Submit or the Submit Box results in
the file being scanned for
macros. The macros will be applied only to the data as it is being sent
to Hercules. The original
file or the JCL in the window will not be altered.
A Note on Files
All files processed by QSub are assummed to be "card images" -
80 characters or less. Records less than 80 characters will be
padded with spaces to 80 characters. Records longer than 80 character
will be truncated by Hercules to 80 character provided the TRUNC option
is specified. If TRUNC is not specified, a number of things may
go wrong. I suggest ALWAYS use the TRUNC option.
The maximum number of records in the edit window depends on
QSub, which limits edit window size 102400 bytes (or at
least 12300 card images). %%Included files do not count in this
limitation.
A spooling system (i.e MVS JES2 or DOS POWER) limits your
submission to available spool space.
A non-spooling system (i.e. MVS direct read or DOS/360
without POWER) has no limit.
Please visit our online support forum to download our software offerings.
and
you should see a screen like this.
The editing capabilites are limited to simple
insert, delete, cut,
paste, find, find all, replace, replace next, replace all and
uppercase. Editing functions are available using "right
clicking" or via the Edit menu option (see left). 