TSO Command IOF TSO Command IOF Author: Triangle Systems formatted on 1995/04/01 06:54 Contact your local technical support team for assistance This summary created by David McRitchie -------------------------------------------------------------------------------- CLIST NAME. IOF users. All TSO users -- obtaining output type. Installed command -------------------------------------------------------------------------------- IOF Interactive Output Facility -------------------------------------------------------------------------------- IOF is used to retrieve sysout data sets produced by MVS batch jobs. IOF is a product of Triangle Systems, Inc. and is marketed by Fischer-Innis Systems Corporation (1-813-643-1500). o Display the status of your batch job o Cancel a batch job o Route the output of a job o Display a return code summary for a job o Browse through individual sysout data sets o Spin off copies of sysout data sets o Release held sysout data sets o Cancel sysout data o Modify attributes of sysout data o Display input queue statistics -------------------------------------------------------------------------------- ===> TSO IOF from any ISPF panel -------------------------------------------------------------------------------- To restrict the list of displayed jobs to a particular status IOF * I Display only input jobs IOF * O Display only output jobs IOF * R Display only running jobs IOF * PURGE Display only jobs on purge queue. IOF * DUMP Display only jobs on dump queue. IOF * CONVERT Display only jobs on converter queue. IOF * FETCH Display only jobs on JTIP fetch queue. IOF * R Display only running jobs To display jobs that were submitted from node FIBERS IOF * FROM(FIBERS) To display jobs whose output is to be processed at node FIBERS IOF * TO(FIBERS) To display jobs to be executed at node FIBERS IOF * XEQ(FIBERS) To display only the input jobs of class S IOF * I(FIBERS) To display jobs of another userid IOF * USERID(xxxxx) To display jobs that are eligible to run on system H811 IOF * I SELECT(SYSID) VALUE(H811) To see your jobs sorted by IOF Sorted by jobid within jobname IOF * SORT(NULL) No sort, left as found on job queue. IOF * SORT(DEST) Sorted by jobid within jobname within DEST IOF R #T SORT(NULL)Display TSO user id's logged on IOF CLASS(2) O SORT(NULL)Display all jobs with SYSOUT=2 in Output +------------------------------------------------------------------------------+ | To simplify the usage of IOF the following clist was developed | | ===> TSO IOFIOF default * SORT(NULL) | | ===> TSO IOFIOF USERID(userid) | PREFIX(userid) default is userid | | ===> TSO IOFIOF SORT(option) default is SORT(NULL) | +------------------------------------------------------------------------------+ +------------------------------------------------------------------------------+ | A complete IOF document can be printed using SCRIPT | | 1. Edit the following dataset | | SYS6.IOF.TEXT (we are now using Release 7, and there is no current | | text) | | 2. From within EDIT Script the document to our 3800-3 page printer. | | ===> @SCRIPT down point(11) bind(4) | | 3. At a remote location specify the destination as you would on an "/*OUT- | | PUT " statement. | | ===> @SCRIPT dest(Nnn.printer) | +------------------------------------------------------------------------------+ TECHNIQUES To SNAP the 4th dataset from many jobs into one dataset 1. Under IOF select all jobs wanted -- when the first is selected then 2. Create PFK-19 under IOF as SD TRK(20 20) DA(dsnode2.dsnode3) 3. Hit PFK-19 4. Modify PFK-19 to read SD TRK(20 20) MOD DA(dsnode2.dsnode3);END 5. Hit PFK-19 and for each previously selected job 6. When list of jobs is exhausted (note SEL on each selected job) get out of IOF 7. Edit your 'userid.dsnode2.dsnode3' dataset and do what ever you wanted, if you simply wish to print you may invoke the @PRINT clist, or you may enter ==> TSO PRINTOFF dsnode2.dsnode3 SNAP has options to snap a range of pages, or a range of lines e.g. ... class(a) dest(P100E) 4 SN 1-4 P 4 snap 2000 l 4 sn 200 lines from 1000 class(a) 1 2 4 sn 4 sn 200 f 1000 class(a) 4 sn 10 pages from 309 class(a) The hex code for a page is x'8B' display =9.1 | =9. to restart IOF from within IOF Rename IOF created dataset if DA('...') not used rename AHXIMP00.IOF.LIST 'is03.ahzimp000.d901201.s02284' -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- Lastest information on IOF See TSOMODEL.PUBLIC.TEXT(IOF) -- listed below from copy 1993/01/07 taken from 1992/10/04 from broadcast message. * Release 7B of IOF is now in production. User profile values will have to be reset using the 'P' option on the IOF OPTION MENU. New panel formats will be presented and the HELP(PFK1) fully describes usage. All authorized func- tions are available. Please direct any questions or concerns to John to your IOF support person. RESETTING SORT on PROFILE to NULL * This used to be resettable through option "P". It must now be changed on the IOF Option Menu (=6.9.) and made permanent with SAVEPROF. 1. Starting from the PRIMARY option panel and an unsplit screen enter =6.9. to get into IOF and then the IOF Option Menu. 2. Next to SORT enter "NULL" (without quotes) 3. Enter "SAVEPROF" on the command line. New Panel Formats The new panels contain fields past the screen width. To access these fields for viewing or modification PFK 11(shift right) will allow these fields to display. For more information : 1. Start from the JOB SUMMARY PANEL and hit PFK 1 (Help) 2. Enter 4 on the command line and hit ENTER 3. Select the desired item # for viewing and hit ENTER 4. Repeat step 3 as desired. IOF Option Menu To display the IOF OPTION MENU 1. Activating IOF : Enter 6.9. on the ISPF MASTER APPLICATION MENU 2. Within IOF : Enter / on the command line of any IOF panel -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- IOFIOF Clist will invoke IOF with SORT(NULL) invoked --------------------------- IOF OPTION MENU ----------------------------- COMMAND ===> _ Select IOF Option: Blank - Display your jobs G - Display output groups Q - Display input queue R - Display running jobs I - Display input jobs P - Display/set IOF profile O - Display output jobs JOBNAME ===> JOBID ===> USERID ===> Display another user's jobs DEST ===> Display all jobs for a destination CLASS ===> Input class (with "I" option) ALLJOBS ===> All jobs in system (YES requires auth) SELECT ===> Selection criteria name VALUE ===> Argument for selection criteria SORT ===> NULL Name of sort algorithm for job list FROM ===> Jobs submitted from a specific node TO ===> Job destination of a specific node XEQ ===> Jobs to execute at a specific node ---------------------------- IOF HELP DISPLAY ----------------------- COMMAND ===> _ The IOF Options Menu is invoked by entering "I." on the ISPF Primary Options Menu or entering "IOF *" at TSO READY. This menu allows you to specify the selection criteria for starting an IOF session or select a profile menu that can be used to set values that will be remembered across TSO sessions. 1 Invoking the IOF Job List Menu 2 Invoking the IOF Input Queue Summary Display 3 Invoking the IOF Output Group Display 4 Invoking Job Summary Display for a specific job 5 Invoking the IOF Profile Menu 6 Specifying Selection Criteria on ISPF Option Menu 7 Specifying Selection Criteria on IOF Command 8 Returning to IOF Options Menu from within IOF Enter # of HELP item desired or END to return to IOF Options Menu. --------------------------------- IOF HELP DISPLAY ------------------------ COMMAND ===> _ To display only output groups with forms F123: IOF * G SELECT(FORMS) VALUE(F123) Additional SELECT options: SELECT Name Selection Performed ----------- ------------------------------------------------ SIZE Only groups with more records than VALUE field. FORMS Only groups with forms matching VALUE field. UCS Only groups with UCS matching VALUE field. WTRID Only groups with VALUE field as writer name. FCB Only groups with FCB matching VALUE field. CLASS Only groups with VALUE field as output class. FLASH Only groups with FLASH matching VALUE field. BUSY Only groups that are currently busy. HELD Only groups that are currently held. HARDCOPY Only groups scheduled for hard copy processing. XMIT Only groups to be transmitted to another node. DUMP Only groups scheduled for DUMP processing. Enter END to return to previous panel or QUIT (Q) to terminate HELP. -------------------------------------- IOF JOB LIST MENU ----------------------- COMMAND ===> _ ----------------------------- RUNNING JOBS ------------------------ -------JOBNAME--JOBID---ACT-HELD-SYSID------CPU-----I/O---STEP-----PROCSTEP-SWP- _ 1 IS03 T02664 H811 :31 6519 TECH IN ------------------------------ OUTPUT JOBS ------------------------ -------JOBNAME--JOBID---ACT-HELD-DEST-------GRPS---RECORDS--HELDDS-BUSY DEVICE-- _ 2 IS03TLOG J07237 AHCENTER 1 _ 3 IS03VX01 J01805 AHCENTER 5 _ 4 IS03M052 J01804 AHCENTER 4 _ 5 IS03TRK7 J01810 AHCENTER 17 _ 6 IS03ZZZ J05014 AHCENTER 4 ---------------------------- IOF HELP DISPLAY ----------------------- COMMAND ===> _ HELP for Job List Menu: 1 Select a job for output review. 2 Cancel one or more jobs. 3 Cause one or more jobs to be printed. 4 Release held sysout data sets for a job. 5 Change job print and punch destination. 6 Set job class, priority, etc. 7 Hold , release , or restart a job. 8 Produce extended job attributes display. 9 Browse all sysouts for a job 10 Manage IOF display of a long list of jobs. 11 Select a job with a large number of spun sysouts. 12 Format of IOF Job List Display. 13 Summary of action area verbs. 14 Terminate current IOF session. Enter # of HELP item desired or END to return to Job List Menu. ----------------------------- IOF JOB SUMMARY ----------------------- COMMAND ===> _ --JOBNAME---JOBID--STATUS---RAN/RECEIVED----DAY--------DEST--------COPIES--USER IS03TLOG J07237 OUTPUT 19:16 6/24/92 YESTERDAY AHCENTER 1 D.MCR --RC--STEP------PROCSTEP--PROC------COMMENTS------------------------------------ 0 PRINTLOG --------DDNAME---STEP-----STAT-ACT-GRP-CLS--RECORDS--DEST-------FORMS----COPIES- _ 1 LOG * DONE 9 6 _ 2 JCL * DONE 9 12 _ 3 MESSAGES * DONE 9 50 _ 4 SYSUT2 PRINTLOG HELD V 293 ---------------------------- IOF HELP DISPLAY ----------------------- COMMAND ===> _ Help for Job Summary Display: 1 Select one or more sysout data set(s) for browse. 2 Release a held sysout data set. 3 Cancel a held sysout data set. 4 Modify attributes of a held sysout data set. 5 Display attributes of a sysout data set. 6 Manage a job with many steps and/or sysout data sets. 7 Snap data to printer or disk data set. 8 Modify or cancel non-held sysout data sets. 9 Refresh the Job Summary display. 10 Spin copy of data set with exact same attributes. 11 Request display of SYSIN data sets for job. 12 Request display of internal JCL text for job. 13 Format of Job Summary Display. 14 Return to the Job List Panel. 15 Exit from IOF processor. 16 Summary of action area commands. Enter # of help item desired or END to return to Job Summary Panel. To eliminate previous output when job runs From JCL in SYS6.OPERATOR(DEFVSOP) //ST030 EXEC PGM=IKJEFT01 //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSTSIN DD * PROFILE MSGID IOF TECHVSOP O 1-999 C END END