JOUT - examine batch output at the terminal.
Syntax:
jout [snumb|*|sid]
Verbs
ACTIVITY nn
DIRECT id
DIRECT ONL
DONE
EPRINT rc
HOLD
LIST
NOPROCESS code
PRINT rc
REDIRECT from to
RELEASE
REMOVE command
REPROCESS xxx
SCAN rc
STATUS [JOB|ALL|xxx]
URGENCY nn
Examples:
jout * use last snumb generated from this userid.
jout a001t use a001t as snumb
jout use last generated snumb.
Options
- *
- tells JOUT to examine the output of the most recent batch job
submitted.
- snumb
- tells JOUT to examine the output of the batch job with the
given SNUMB.
- sid
- tells JOUT to examine the SYSOUT entry with the given SYSOUT ID.
This is useful when several SYSOUT jobs have the same SNUMB.
The SYSOUT ID may be determined with the BW or JSTS command.
Description:
You can use JOUT to inspect batch output that is waiting
in the system output spool files (SYSOUT), provided that
you specified JOUT disposition for the job when you submitted it from TSS.
If your job is still running, JOUT will print the job's status and return.
If your job has been released from the system, either at your request
or because it has been printed, JOUT responds with "output not found".
You get "output busy" if another terminal has the same job in JOUT or
if the job is printing.
JOUT types "function ?" when it has made a connection to your batch
output and is ready to accept your command verbs.
Verbs at "function ?" level
- <carriage return>
- JOUT will print "please direct, release, or hold before exit".
You must select one of the mentioned verbs to leave JOUT.
- ACTIVITY nn
- selects the activity within the job that you wish to examine.
The activity number is initially 01.
Verbs that apply to a report code must specify only those report
codes shown by the LIST verb in the current activity.
- LIST
- shows the report codes present for the activity.
A report code is either a two digit number or
"$$" (meaning the execution report).
Although the LIST verb may respond with "no reports",
you can always look at report code "$$".
If your job aborted for any reason, report code "$$"
is a good place to look for clues to the cause.
- PRINT rc
- prints report code "rc" at the terminal.
Strings of two or more blanks are truncated to one blank.
- EPRINT rc
- is the same as "PRINT rc", except that strings of multiple blanks are
left as is (not compressed).
- RELEASE
- exits from JOUT and releases the output from the system.
Your listing goes away for good.
- HOLD
- exits from JOUT, but keeps the output in the system
to be printed or released later.
Output will be held for later JOUTing, even if it was not originally
being held for JOUT.
- DIRECT ONL
- exits from JOUT and directs the output to the printer.
You may use "dire onl" as a short form.
Note that if you misspell "onl", the output will not be printed until
the operator forces it online or you go back into JOUT and
re-enter the request spelled correctly.
- DIRECT id
- exits JOUT and directs the output to the remote station
indicated by "id".
- SCAN rc
- calls the SCAN subsystem, a kind of primitive
editor for batch output, to look at report code "rc".
JOUT's "scan" is similar to what is described in "expl scan",
but there are the following differences:
- the BATCH, REM, and BYE verbs are not supported.
- dumps can be scanned by answering the "forms ?" question with "dump".
- NOPROCESS code
- tells JOUT not to process all or part of the output.
The "code" is a three-character keyword indicating
which output is to be discarded.
Possible codes are:
ALL -- discard all print and punch
APR -- discard ASCII print
APN -- discard ASCII punch
ASC -- discard all ASCII print and punch
BCD -- discard all BCD print and punch
BPR -- discard BCD print
BPN -- discard BCD punch
PRT -- discard all print
PNC -- discard all punch
Ixx -- discard all for remote ID xx
RMT -- discard all remote
ONL -- discard all online
The code "DEVyyy" discards all output intended for online
device "yyy".
Codes may be concatenated, as in
NOPROCESS APRONL
which discards all ASCII print online.
- REPROCESS code
- tells SYSOUT to process the material indicated by "code".
The possible "codes" are the same for NOPROCESS.
- REDIRECT from to
- tells the system to redirect output from one device to another.
The "from" and "to" values are codes like those recognized for NOPROCESS.
For example,
redirect BPR APR
redirects BCD printer output to an ASCII printer.
If you want to redirect ASCII printer output to a BCD printer,
you must use the command
redrc APR BPR
- REMOVE command
- erases the effect of a NOPROCESS, REPROCESS, or REDIRECT command.
For example, if you say
NOPROCESS BPR
to stop processing of BCD printer output,
REMOVE NOPROCESS BPR
will reverse the effects of the NOPROCESS command.
- STATUS JOB
- displays information on the job you are examining: when the job
entered SYSOUT, how long it's been there, the output urgency, the SID,
the number of blinks the job is using, and the job level flags.
Possible flag values are:
W -- wide carriage needed
R -- reprocessing allowed
J -- JOUT wanted
I -- I/O error while writing $$
U -- unpurged job
- STATUS ALL
- displays the same information as STATUS JOB, plus each of the output
type/destinations of the job, and the activities and report
codes contained in each of these type/destination words.
It also displays the following type/destination flags:
S -- started
F -- finished
C -- tape copy requested
P -- tape purge requested
D -- REDIRECT applied
R -- REPROCESS verb applied
N -- NOPROCESS applied
T -- transliteration allowed
- STATUS code
- displays only information about the type of output referenced
by "code".
Valid codes are the same as for NOPROCESS.
- URGENCY xx
- lets you change the output urgency of the job.
An urgency of 0 indicates that the job is to be held "forever"
(i.e. until the urgency is changed to a non-zero value).
Anyone may set the urgency as high as 5; if the job had a higher
urgency at the time you invoked JOUT, you may set it to that
urgency.
To set even higher urgencies, you must have the appropriate privileges.
- DONE
- quits JOUT.
The output being examined will be delivered to its intended
destination (e.g. the printer).
Bugs:
The message "direct or release" usually indicates that
JOUT got into a bad state while you were using SCAN.
To recover, leave JOUT and enter it again.
The same goes for "system error - restart",
except that you don't have any choice.
See Also:
expl scan
expl bw
expl lstw
Copyright © 2000, Thinkage Ltd.