CVTWRKUSR CONVERT WRKUSRJOB TO A DATA BASE FILE TAAJOBI |
The CVTWRKUSR command creates a data base file WRKUSRP with one
record per job. The command functions as if there were an OUTFILE
parameter on WRKUSRJOB. This allows you to automate several
functions involving jobs.
A typical command would be:
CVTWRKUSR OUTLIB(QTEMP)
The command creates a file named WRKUSRP in QTEMP with one record for
each job. The model file used is TAAJOBIP in TAATOOL with a format
name of UJRCD.
You can then read the file in a CL or other HLL program.
If you request USER(*ALL) or a user other than yourself, you must
have *JOBCTL special authority.
The information is accessed using the QUSRJOBI API.
CVTWRKUSR escape messages you can monitor for
---------------------------------------------
TAA9891 No jobs to convert
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
USER The user's jobs you want output. This is the same
parameter as on WRKUSRJOB. The default is * meaning
the current job. *ALL may be specified for all
users or a name of a specific user.
If you request USER(*ALL) or a user other than
yourself, you must have *JOBCTL special authority.
STATUS The status of the jobs you want output. This is the
same parameter as on WRKUSRJOB. The default is
*ALL. You may also specify *ACTIVE, *JOBQ or *OUTQ.
JOBTYPE The job type to convert. * is the default and means
all jobs. The other supported values are
A=Autostart, B=Batch, I=Interactive, M=Monitor,
R=Spool reader, S=System job, X=Start CPF, and
W=Spool writer.
OUTLIB The library in which the file WRKUSRP will be
placed. The default is *LIBL. If the WRKUSRP file
does not already exist, a library must be specified.
OUTMBR The member of the WRKUSRP file to be used. If the
member does not exist, it is added. The default is
WRKUSRP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
File format
-----------
The file name that is output is WRKUSRP.
The model file used is TAAJOBIP with a format name of UJRCD.
To see the field names used:
DSPFMT TAAJOBIP
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CRTUSRSPC Create user space
EDTVAR Edit variable
RTVUSRSPCI Retrieve user space initialization
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ----- --------- ---------- -----------
CVTWRKUSR *CMD TAAJOBI QATTCMD
TAAJOBIP *FILE PF TAAJOBIP QATTDDS
TAAJOBIC *PGM CLP TAAJOBIC QATTCL
TAAJOBIR *PGM RPG TAAJOBIR QATTRPG
|
Added to TAA Productivity tools April 1, 1995