If you don’t know for sure, whether your job completed successfully, or it failed(and the reason why it failed). MVS Operating System prints messages to a log, as the job is processed. These run-time messages which get recorded to the log, helps track, if the Job completed successfully or it failed. Further, they also contain error-messages that point out why the job fails.
To see the print output/log of any Batch Job, you use a software called SDSF. SDSF stands for Spooler Display and Search Facility – its a software for seeing the output in the Spool.
What is Spool? Well, generally, the log of a Job, when it runs on Mainframes, are to be sent to a printer. But prior to sending the log to the printer, the logs have to wait(buffered) in a staging area(in a queue), because hundreds of jobs complete every minute, and the logs gotta be printed. Not all logs can be printed at once. The logs have to wait in a Queue/staging area. This staging area is called Spool(Queue). The Mainframe printer will pick up the log from the spool one-by-one and print it.
Before TSO and SDSF was invented, you couldn’t see the output till the time, it got printed. Waiting for it to get printed, could take hours on end. Now-a-days, TSO makes this easy, it’s possible to view the logs in the Spool(Queue).
![Image122[1]](http://lh4.ggpht.com/_sQvdFWqMlMg/S3Rd5bSmS5I/AAAAAAAACak/VrZZyreYoxo/Image122%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image122[1]")
To view the log of a Job in the Spool(Queue), type START SDSF and press <Enter>. This shows the shows the SDSF Screen. To see the log of Job, you must type ST on the SDSF menu and press <Enter>.
![Image128[1]](http://lh4.ggpht.com/_sQvdFWqMlMg/S3Rd_XDGAjI/AAAAAAAACaw/5lXQejUJ4YM/Image128%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image128[1]")
A list of the logs for all jobs in Spool(Output Queue) is displayed. By default, this list will displayed only those jobs submitted via your TSO User-id. For example, if my TSO User-id is AGY0157, it will display all jobs starting with(prefix) AGY0157*.
![Image131[1]](http://lh6.ggpht.com/_sQvdFWqMlMg/S3afpt1NLNI/AAAAAAAACdM/jRZmkn7bJoQ/Image131%5B1%5D_thumb%5B2%5D.png?imgmax=800 "Image131[1]")
The screen displays a list of logs of all jobs, you have submitted. For each job that you submit, there is an entry, and it shows various details like the job-name, owner, class and priority.
If your job is complete, and its log is ready to be dispatched to the printer, the log is on the PRINT Queue. On the other hand, if the job is still running, then it is still in the EXECUTION Queue.
Mostly, all jobs that you submit, their logs would be dumped here in the Spool. To view the contents any particular job log, you can type ? against the job=name and press <Enter>. This takes you inside the log.
![Image132[1]](http://lh4.ggpht.com/_sQvdFWqMlMg/S3aftzJKCII/AAAAAAAACdU/DTP5zEd2wyY/Image132%5B1%5D_thumb%5B4%5D.png?imgmax=800 "Image132[1]")
The log(print output) of a job, contains several sections or Listings. You can type S(Show) against each Listing, and view the contents of it.
The Input Queue and Output Queue are analogous to the run-ways on an Airport. The Input Queue is runway from where the Jobs take-off. After their flight is complete, the jobs land on the runway called the Output Queue.But who's the Air Traffic Controller(ATC) on this Airport?
The JES(Job Entry Sub-System) is a software that manages the Input Queue and Output Queue. The JES acts like Traffic Controllers(Traffic cops). Without them, two airplanes or jobs could collide. The JES is a part of the MVS Operating System that decides, what time a job can takeoff safely from the Input Queue(Takeoff runway). Thus, it monitors the traffic in the Input Queue(Runway) and prepares the time-table, a chart or a schedule for Jobs entering the system.
On the Input Queue side, the JES(Job Entry Subsystem) welcomes all Jobs that enter into the Input Queue, reads the Jobs' JCL, converts it into an internal format known to MVS, and schedules the job for takeoff at 2 o’clock or 3 o’clock, till the Job takes off, and begins its flight(execution).
Sometimes, on the Output Queue(Staging area) side contains logs(outputs) of old jobs. Such old logs(print outputs) of a job, are deleted from time-to-time periodically by JES. So, JES ensures that the Output Queue clean and tidy.
The JES Message Log would contain messages, as shown in the below Snap. You can click here to see the JES Message Log in the ordinary Text-Format.
![Image133[1]](http://lh6.ggpht.com/_sQvdFWqMlMg/S3-EgtjU8jI/AAAAAAAACe8/g_QmK27R_cg/Image133%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image133[1]")
The Job Entry Subsystem(JES) reads the Job’s JCL Statements. My Job had 24 lines of JCL Code, so JES reports this as 24 cards read.
Once the job takes off from the Input Queue, it executes, and lands at Output Queue. The log(print output) of Job, is referred as SYSOUT. This contains 125 lines of text. JES reports this as 125 SYSOUT Print records. This implies, the log(print output) of the job, contains 125 lines of text, in the Output Queue(Staging area), waiting to get printed.
Look at the snap below. In the JCL-Listing, MVS numbers the JCL Statements that you submitted as part of the job. You can click here to see the JCL-Listing in an ordinary Textual-Format.
![Image134[1]](http://lh4.ggpht.com/_sQvdFWqMlMg/S3-EnOQE_9I/AAAAAAAACfE/DcQly8fMD2I/Image134%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image134[1]")
The JESYSMSG Listing contains Memory Allocation and Cleanup Messages. ALLOC tells you which devices and how much memory was allocated for the job-step. As you know, one step runs one program. It also informs you about the CPU time required to process a Job-step. Every Job-step leaves behind a trail, a COND CODE in the range of 0000 to 4095. The below picture shows how the JESYSMSG-Listing looks. You may also click here, to see the JESYSMSG-Listing in ordinary textual-format.
![Image135[1]](http://lh4.ggpht.com/_sQvdFWqMlMg/S3-EvZCPOOI/AAAAAAAACfM/tOtSxii4z2k/Image135%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image135[1]")
But apart from this , when you want to write your own extra notes to the logs(diary), you code a SYSOUT=* parameter on the DD Statement. For the 3-step job-stream that I have written, I have set the //SYSUT2 DD statement to point to the logs. This means that, the outputs of //STEP01 and //STEP03 shall be jotted down in the logs. The first step prints/copies the contents of the Unsorted Input file to the log. The second step
These are the contents of the Unsorted Input File, written to the log -
![Image136[1]](http://lh6.ggpht.com/_sQvdFWqMlMg/S3-4PlQogKI/AAAAAAAACf4/JC2VPGwEV0A/Image136%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image136[1]")
These are the contents of the Sorted Output, written to the log. Click here to see the Sorted-Output in Text-Format.
![Image137[1]](http://lh5.ggpht.com/_sQvdFWqMlMg/S3-4T1ie3II/AAAAAAAACgA/QUdJ-Jq4Rpc/Image137%5B1%5D_thumb%5B3%5D.png?imgmax=800 "Image137[1]")
|