October 1998
Newsletter

IOFTech    Maintenance   Release8G       Newsletters    Doc    FAQ    Contact    Home

IOF Job Archival Facility

Topics

Introduction

IOF Job Archival and Retrieval facilities make it easy to offload jobs from the JES2 spool. Offloaded jobs are automatically managed and can conveniently be selected for uploading from an ISPF dialog. IOF/JOBARC interfaces to JES2 offloaders which perform the offload and upload functions.

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.

Section 26 of the IOF/TSO Installation Guide provides a detailed description of how to run IOF Job Archival and Retrieval.

Selecting Specific Jobs to Offload

The easiest way to select specific jobs to be offloaded is to use the Job List Menu OFFLOAD command. This command schedules all jobs that are being displayed on the menu to be offloaded. Jobs that you don't want to offload can be excluded from the menu with the EXCLUDE command.

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
to exclude all jobnames NOT BEGINNING with the characters BR14. Any combination of line and primary EXCLUDE and UNEXCLUDE commands can be used to manipulate the list of jobs to be offloaded. The jobs being displayed when the OFFLOAD command is entered will be scheduled to be offloaded.

 ------------------------------ 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

The Offload Dialog

The OFFLOAD command initiates the offload dialog which prompts for the necessary offload parms. You must verify and correct the offload job JCL on the first dialog panel shown below.

--------------- 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.

In the example above, the JOBARC cataloged procedure is being used. It resides in the ISIWAL.PROCLIB data set. This procedure runs batch TSO and must have SYSPROC and SYSTSPRT DD statements. See Section 26 of the IOF/TSO Installation Guide for a full description of the JOBARC cataloged procedure. A sample cataloged procedure is shown below.


   //JOBARC   PROC
   //BATCHTSO EXEC PGM=IKJEFT1B,REGION=1000K
   //SYSTSPRT DD   SYSOUT=*
   //SYSPROC  DD   DSN=IOF.IOFT7D0.CLIST,DISP=SHR

The offload procedure allocates two new MVS data sets:

The second screen of the offload dialog lets you specify offload options and the allocation characteristics for the directory data set.

----- IOF/JOBARC Offloader and Directory Data Set Options -------------------
COMMAND ===>

   Select offloader and directory parms in the fields below:

 DISP     ===> DELETE     Disposition of offloaded jobs (KEEP, HOLD, DELETE)
 OFFNBR   ===> 1          Offloader number to use for offloading
 SYSOUT   ===> A          Sysout class for offload report file

 PREFIX   ===> SYSIOF     Directory data set name prefix
 SUFFIX   ===> OFFRUN     Directory data set name suffix

   Optionally specify additional directory data set parms below:

 UNIT     ===> SYSALLDA   Directory unit type (DISK, SYSDA, etc.)
 TRACKS   ===> 2          Directory size in tracks
 VOLSER   ===>            Specific directory volume serial number
 STORCLAS ===>            Directory SMS storage class
 MGMTCLAS ===>            Directory SMS management class
 DATACLAS ===>            Directory SMS data class

   Press END to continue the dialog
      or CANCEL to terminate the dialog.                                     

The third screen of the offload dialog lets you specify the allocation characteristics for the offload data set. You normally would specify that you want to offload to a tape. For ease in testing with the sample offload, we specify SYSDA unit type for the offload data set in the example below.

----------- IOF/JOBARC Job Archival Offload Data Set Parms -------------------
COMMAND ===>

   Select offload data set parms in the fields below:

 PREFIX   ===> SYSIOF     Offload data set data set name prefix
 SUFFIX   ===> OFFRUN     Offload data set data set name suffix
 UNIT     ===> SYSDA      Offload data set unit type (CART, TAPE, SYSDA, etc.)

   Optionally specify additional offload data set parms below:

 LABEL    ===> SL         Type of volumn label (SL or NL)
 RETPD    ===> 999        Retention period in days
 PROTECT  ===> N          SAF protection (Y or N)
 TRACKS   ===> 5          Offload data set size in tracks (required for DASD)
 VOLSER   ===>            Specific offload data set volume serial number
 STORCLAS ===>            Offload data set SMS storage class
 MGMTCLAS ===>            Offload data set SMS management class
 DATACLAS ===>            Offload data set SMS data class

   Instructions: Enter CANCEL to exit without submitting the archive job.
                 Enter END to submit batch job to archive all selected jobs.

Select the allocation characteristics for the offload data set on the panel above and press the END key. A batch job is submitted to cause all the jobs displayed on the Job List Menu when the OFFLOAD command was issued to be scheduled for offload.

Authority Required to Offload

The offload job runs under the userid of the user who initiated the offload dialog. In order for the offload job to run successfully, this userid must have the following IOF authority:

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.

Automated Batch Offloading

IOF Job Archival also provides the following commands for automated batch offloading: See Section 26 of the IOF/TSO Installation Guide for a full description all IOF Job Archival commands along with several specific examples.

The Upload Dialog

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.

Authority Required to Upload

The authority to display offload directories is controlled by the installation's security system. Any user who has the authority to display the directories and the authority to submit batch jobs can queue an upload transaction to a server to cause any job to be uploaded. If the server is not being used, control access to the JES2 offloader and JES2 offload sysout receiver also is required.

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.


Triangle Systems, Inc. PO Box 12752, Research Triangle Park, NC 27709
Email
IOFTech@Triangle-Systems.Com