Mainframe Path Start learning free
Beginner7 min readLesson 1 of 3

What IOF is and how to start it

IOF (Interactive Output Facility) is a vendor product, an alternative to IBM's SDSF, for looking at the JES2 spool: jobs waiting to run, jobs running, and the output of finished jobs. You start it from ISPF or TSO, usually with the IOF command, and filter by job name so you only see what you need.

Where IOF fits

From a submitted job to output you can read
You submit JCLSUBMIT, or a scheduler does it
JES2Queues, runs and collects output
The spoolWhere job output is kept
IOF or SDSFYour window onto the spool

When a job runs, JES2 writes its messages and printed output to the Spool. IOF and SDSF are two tools for looking at the spool. Some sites have only one, some have both. The ideas are the same: find the job, open it, read the output. IOF is sold today by Fischer International and runs under TSO and CICS.

Starting IOF

You typeWhereResult
IISPF primary menu (site dependent)The IOF Option Menu
IOFTSO, or TSO IOF from any ISPF panelYour own jobs, or the option menu, depending on your site's setup
IOF PAYRUN01TSOJobs called PAYRUN01
IOF PAY*TSOJobs whose names start with PAY
IOF *TSOYour jobs, skipping the option menu

In job name patterns, * at the end matches any number of characters and + matches exactly one, so PAYRUN+1 matches PAYRUN01 and PAYRUN11. Exactly how IOF is installed varies, so if I does nothing on your ISPF menu, try TSO IOF.

The Option Menu

IOF Option Menu, simplified
  IOF Option Menu
COMMAND ===> _

   blank  Your jobs              G    Output groups
   I      Input (waiting) jobs   LOG  System log
   R      Running jobs           M    System monitor
   O      Output jobs            P    Your IOF profile
   H      Held output

   JOBNAMES ===> PAY*
   (what you can see depends on your authority)

Type HELP on any IOF panel for help with that panel, and QT for the built-in Quick Trainer tutorials. Both are worth a few minutes in your first week.

TRY IT YOURSELF

Which TSO command lists every job whose name starts with PAY?

Show a hint

IOF, a space, then a pattern with a trailing asterisk.

Show the solution

IOF PAY*

Examples are for learning. Run commands and jobs only on a system you are authorised to use, such as a training or test system, and never on production without approval.

Common mistakes

Assuming IOF and SDSF show different data

Both read the same JES2 spool. Only the panels and commands differ.

Listing every job on the system

Filter by job name or owner. Huge lists are slow and it is easy to act on the wrong row.

Thinking a job vanished because you cannot see it

You may not have authority to see it, or it may have been purged. Ask before resubmitting.

What you will see at work

Key terms

Check your understanding.
Take this lesson's quiz and save your progress. Free.

Take the lesson quiz
The job list and the job summary →