RTVJOBAPI RETRIEVE JOB API TAAJOCH
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