The  Retrieve  Job API  tool  is  a  program that  adopts  the  QSECOFR
profile  to  allow  retrieval from  the  QUSRJOBI  API formats  without
having  *JOBCTL  special authority.   The  program  is used  by several
tools that  allow a  user to display  jobs that  are not  his own  (the
user cannot work with the jobs).

The program  is available to  the public.   This is deemed  safe enough
because:

  **   The  program  requires a  parameter  list, that  cannot  be used
       effectively without writing a program.

  **   The  parameter  list   requires  knowing   the  internal   JOBID
       assigned by  the system which  can only  be retrieved by  use of
       another  API  (this is  not the  same  value as  the  job number
       assigned by the system).

  **   The  information  returned  is  for  'read  only'  purposes  and
       includes only information that is available on DSPJOB.

A typical use of the program would be:

     E                    WRK       500  1               Work array
     .
     IWRKDS       DS
     I                                        1 500 WRK
     .
     C* Use another API to determine the internally assigned JOBID
     .
     C* Call the RTVJOBAPI TAA Tool
     C                     CALL 'TAAJOCHC'             20  Rtv job info
     C                     PARM           WRKDS            Work area
     C                     PARM 'JOBI0200'FORMAT  8        Work area
     C                     PARM           JOBID   6        Job ID
     C* Handle any errors
     C   20                DO                              Not found

The information placed in  the WRKDS data structure (and  WRK array) is
defined  in  the  System API  Reference  manual  for  the QUSRJOBI  API
formats.

Command parameters                                    *CMD
------------------

No command exists.

Restrictions
------------

None.

Prerequisites
-------------

None.

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   TAAJOCHC      *PGM       CLP         TAAJOCHC      QATTCL