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.