IOF Job Archival Facility

Introduction

Jobs can be selected for offloading from an IOF Job List Menu. Optionally, jobs can be selected for offloading by a batch job or systems task based on virtually any job identification or characteristic such as jobname, username, ownerid, age and destination.

IOF/JOBARC uses the IOF programmable interface to JES2 to drive and control the JES2 offloader devices. JES2 offloader sysout transmitters and sysout receivers execute the physical offload and upload functions. Jobs are offloaded in NJE format, thus retaining all job and sysout characteristics.

The job archival function of IOF/JOBARC can run as a batch job or started task. It can be run on a periodic basis and/or on an emergency basis when the JES2 spool system approaches saturation. The job retrieval function is initiated from a full screen ISPF display that makes it easy to select jobs to be uploaded.

To demonstrate using OFFLOAD, submit several test jobs and wait until they finish execution. Then display a Job List Menu of your jobs, including your test jobs. In the example below, the test jobs are named BR14A, BR14B and BR14C.

------------------------------ IOF Job List Menu -------------( 18 )----------- COMMAND ===> SCROLL ===> CURSOR --------------------------------- Output Jobs --------------------------------- -------JOBNAME--JOBID--ACT-STAT-OWNER----DEST/DEVICE--------RECS-HELD-DAY--TIME _ 1 BR14C J08087 ISIWAL TRISYS 28 279 15:36 _ 2 BR14B J08086 ISIWAL TRISYS 28 279 15:35 _ 3 BR14A J08085 ISIWAL TRISYS 28 279 15:35 X 4 M17TRYOP J08075 ISIWAL TRISYS 18K 279 9:35 X 5 MAKEPKG J08060 ISIWAL TRISYS 1048 278 20:38 X 6 ISIWAL T08051 ISIWAL TRISYS 41 278 15:43 X 7 MAKEPKG J08047 ISIWAL TRISYS 1047 278 11:43 X 8 M17TRYW J07853 ISIWAL TRISYS 18K 274 15:57 X 9 JARDJOIN J07755 ISIWAL TSIJFW 79 9 272 11:49

The example above shows the EXCLUDE line command being used to cause jobs 4 through 9 to be excluded from the menu. The same result can be obtained by entering in COMMAND:

        EXCL JOBNAME NB BR14

------------------------------ IOF Job List Menu -------------( 18 )----------- COMMAND ===> OFFLOAD SCROLL ===> CURSOR --------------------------------- Output Jobs --------------------------------- -------JOBNAME--JOBID--ACT-STAT-OWNER----DEST/DEVICE--------RECS-HELD-DAY--TIME _ 1 BR14C J08087 ISIWAL TRISYS 28 279 15:36 _ 2 BR14B J08086 ISIWAL TRISYS 28 279 15:35 _ 3 BR14A J08085 ISIWAL TRISYS 28 279 15:35

--------------- IOF/JOBARC Job Archival Confirmation -------------------------- COMMAND ===> Selective Job Archival is accomplished by submitting a batch job to offload all the jobs on the current Job List Menu. Verify the batch job JCL before proceeding: ===> //JOBARCH JOB S993,'WALKER',NOTIFY=ISIWAL,CLASS=K, ===> // MSGCLASS=H ===> //PROC JCLLIB ORDER=(ISIWAL.PROCLIB) ===> /*ROUTE PRINT FETCH ===> //* ===> //ARCHIVE EXEC JOBARC Instructions: Enter CANCEL to exit without submitting the archive job. Enter END command to continue the archive dialog.

• Display access to each of the jobs that is being offloaded.

• Update access to the offloader device being used.

• Update access to the offload sysout transmitter being used.

• Authority to allocate the specified directory and offload data sets.

In most shops only operators and systems programmers will have update access (the authority to start, stop and modify) to offloader devices. This in effect restricts the OFFLOAD command from most users.

• JAROPEN provides parms to define the directory and offload data sets.

• JAROFFLD provides parms to select the jobs to be offloaded. Multiple JAROFFLD commands with different selection parms can be specified for each offload job.

• JARCLOSE terminates the batch offload run

The UPLOAD command can be entered on any IOF panel to initiate the upload ISPF dialog. The initial upload dialog panel prompts for the offload directory prefix as shown below. Enter the prefix you specified in the offload dialog (or in the JAROPEN command), followed by a second level of OFFDIR.

------------------------- IOF/JOBARC Upload Utility -------------------------- COMMAND ===> Enter the IOF/JOBARC Directory Data Set Name level below. A list of all data sets beginning with this level will be displayed. Normally the second level of the dsname level should be "OFFDIR". DSNAME LEVEL ===> SYSIOF.OFFDIR If a fully qualified data set name is specified in the dsname level, the list of directories will be skipped and the list of jobs stored in the directory will be displayed directly. Enter level above and press ENTER

This causes the IOF/JOBARC Directory List panel to be displayed. Each line on this display represents one offload directory. The offload date and time is displayed for each directory, along with the offload type.

------------------------ IOF/JOBARC Directory List ---------------- Row 1 of 7 COMMAND ===> Scroll ===> PAGE Line Commands: I - Include directory in offloaded jobs list. D - Delete directory and all offload data sets it references. U - Upload all jobs listed in the directory. -----Action---Offload Date----Day of Week--Day-Month------Time----Type------- _ 1998/03/02 Monday 2 March 12:44 OFFRUN _ 1998/03/02 Monday 2 March 11:22 OFFRUN _ 1998/03/02 Monday 2 March 11:21 OFFRUN _ 1998/01/22 Thursday 22 January 16:25 OFFRUN _ 1998/01/22 Thursday 22 January 15:57 OFFRUN _ 1997/12/03 Wednesday 3 December 16:08 OFFRUN _ 1997/08/18 Monday 18 August 12:32 OFFRUN ******************************* Bottom of data *******************************

The U line command on this panel causes all jobs listed in that directory to be uploaded. This command is particularly useful after the spool saturation condition that forced an emergency offload has been resolved.

The D line command deletes an offload directory and all the offload data sets that it references. Directory and offload data sets should be protected with the installation's security system to prevent unauthorized use and deletion.

The I line command causes the IOF/JOBARC Offloaded Job List panel shown below to be displayed. Each line in this display represents one offloaded job.

--------------------- IOF/JOBARC Offloaded Job List -------------- Row 1 of 173 COMMAND ===> Scroll ===> PAGE Specify generic selection field parms below to limit the jobs displayed. Line Commands: S (Select for upload) U (Upload with no confirmation) JOBNAME ===> DATE ===> SORT ===> DATE OWNER ===> ISIWAL DATEOFF ===> SORTSEQ ===> D (A or D) Act JA1197E Jobid Notify Owner Username Run-Date Retn Code Off-Date _ JA1299H J00541 ISIWAL ISIWAL WALKER 980302 0 980302 _ JOA114H J00542 ISIWAL ISIWAL WALKER 980302 0 980302 _ ISIWAL T00504 ISIWAL ISIWAL 980301 ABND S622 980302 _ ISIWAL T00409 ISIWAL ISIWAL 980227 ABND S622 980302 _ UPLODJF J00228 _ ISIWAL JFW 980223 0 980302 _ DNLOD J09983 _ ISIWAL JFW 980218 0 980302 _ JOBARCH J08783 ISIWAL ISIWAL WALKER 980122 0 980122 _ TESTJ115 J08789 _ ISIWAL WALKER 980122 0 980122 _ M77NEWPN J04739 _ ISIWAL J Walker 971027 0 980122 S OUTPUT2 J03929 _ ISIWAL WALKER 971016 0 980122 _ OUTPUT1 J03932 _ ISIWAL WALKER 971016 0 980122 ******************************* Bottom of data ********************************

This display can be modified by entering values in the selection fields at the top. In the example shown, ISIWAL is entered in the OWNER selection field. This causes all jobs not owned by owner ISIWAL to temporarily be excluded from the display.

Users can select specific jobs for upload from this display by using the U line command. Additional directory information can be displayed about a job by entering the S line command. Job OUTPUT2 is selected in the example above to produce the detailed IOF/JOBARC Job Upload Confirmation panel shown below.

------------------- IOF/JOBARC Job Upload Confirmation ---------------------- COMMAND ===> Jobname: OUTPUT2 Jobid: J03929 Notify: _ Owner: ISIWAL Account: 1 Username: WALKER Date Run: 971016 Time Run: 1251 Track Groups: 2 Destination: TRISYS Records: 5793 Held: Status: Priority: Input device: INTRDR Input Node: TRISYS Xeq sysid: TSI1 Xeq Node: TRISYS Number steps: 4 Return code: 0 Stepname: Procstep: Offload Date: 980122 Offload DSN: SYSIOF.OFFLOAD.D98022.T1557.OFFRUN Instructions: Press ENTER to select this job to be uploaded by a batch job, or END if you do not want this job to be uploaded. The batch job is not submitted until you finish selecting jobs to be uploaded.

The actual uploading is performed by a batch job or a started task. If the installation runs an IOF/JOBARC server an upload transaction is queued to the server. Otherwise, the upload dialog submits a batch job on the user's behalf to do the requested upload.

Uploaded jobs are restored to their original state by the JES2 uploader. Therefore, the owner, class, destination and other job and sysout attributes will be the same as when the job was offloaded. The IOF access required to browse or modify an uploaded job is the same as was required for the original job.