The Find Spooled File command can assist when you are trying to find
a spooled file, but you are not sure of the name, the job, the form
type, etc. FNDSPLF allows you to identify one, generic, or all
output queues that should be searched for whatever information you
have such as the form type or some string of characters within the
form type. Most of the selection options supported by FNDSPLF allow
this type of searching.
You must have *ALLOBJ and *SPLCTL authority to use FNDSPLF.
The system provides a similar function with WRKSPLF, but this is only
effective if you know the full (or for some parameters generic) value
to be searched for.
Assume you know a spooled file exists with a name that contains the
letters ABC. The ABC value may be at the beginning of the name, at
the end of the name, or embedded in the name such as DEFABCX. Assume
you want to search all output queues. The command to be entered
would be:
FNDSPLF OUTQ(*ALL/*ALL) SPLF(ABC)
If there are too many spooled files that meet the criteria, but you
know the job name contains the characters PAY, specify the command
as:
FNDSPLF OUTQ(*ALL/*ALL) SPLF(ABC) JOB(PAY)
By default, the QEZJOBLOG and QEZDEBUG output queues are not
searched. If a large number of spooled files exist to be searched,
the performance can be slow as the attributes of each spooled file in
a specified output queue must be converted to an output file and then
scanned. If you know the output queue, it is better to specify it.
Sequence of output
------------------
The sequence of the output should be the same as that shown by
WRKSPLF. The files in a RDY status appear first. The files in a HLD
status appear last. Within each status value, the output priority
determines the order.
FNDSPLF escape messages you can monitor for
--------------------------------------------
TAA9891 No output queues were found to be searched
Escape messages from based on functions will be re-sent.
FNDSPLF Command parameters *CMD
--------------------------
OUTQ The qualified name of the output queue be searched.
A specific output queue, a generic name, or the
special value *ALL may be specified.
The qualified library name defaults to *LIBL. A
specific library or the special values *ALL or
*CURLIB may be entered. Specifying OUTQ(LIB1/*ALL)
may be used to search all spooled files in the LIB1
library.
See also the OMITOUTQ parameter.
SPLF The spooled file name to be searched for. *ALL is
the default for all spooled file names. Any
characters of a valid name may be entered to allow a
scan.
JOB The job name to be searched for. *ALL is the
default for all job names. Any characters of a
valid name may be entered to allow a scan.
USER The user name to be searched for. *ALL is the
default for all user names. Any characters of a
valid name may be entered to allow a scan.
FORMTYPE The form type to be searched for. *ALL is the
default for all form types. Any characters may be
entered to allow a scan.
USRDTA The user data to be searched for. *ALL is the
default for all user data. Any characters may be
entered to allow a scan.
STATUS The status of the spooled file to be searched for.
*ALL is the default for all status values. *RDY,
*HLD, or *SAV may be entered.
OUTPTY The output priority of the spooled file to be
searched for. *ALL is the default for all output
priorities. A value of 1 to 9 may be entered.
STRDATE The start date to be used. The STRDATE and ENDDATE
values are used to form a range to check each
spooled file for when it was opened.
*START is the default meaning any date. *CURRENT
(today's date) or a specific date may be entered in
job format.
ENDDATE The end date to be used. The STRDATE and ENDDATE
values are used to form a range to check each
spooled file for when it was opened.
*END is the default meaning any date. *CURRENT
(today's date) or a specific date may be entered in
job format.
USRDFNDTA Up to 20 bytes to search the 'user defined data'
value which is 255 bytes. *ALL is the default for
all 'user defined data'. Any characters may be
entered to allow a scan.
OMITOUTQ A list of up to 10 output queues that will be
omitted. The default is *DMPLOG meaning any output
queues named QEZDEBUG or QEZJOBLOG will be omitted.
*NONE or a specific output queue name must be
specified if you want to search QEZDEBUG or
QEZJOBLOG.
Note there is no library qualifier. Any output
queue name entered will be bypassed regardless of
the library it is found in.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
You must have *ALLOBJ special authority to use FNDSPLF.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKSPLCTL Check *SPLCTL special authority
CVTOBJD4 Convert object description 4
CVTOUTQ Convert output queue
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list 2
RTVDAT Retrieve date
RTVVALA Retrieve value attributes
RTVSYSVAL3 Retrieve system value 3
SCNVAR Scan variable
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
FNDSPLF *CMD TAASPPG QATTCMD
TAASPPGC *PGM CLP TAASPPGC QATTCL
TAASPPGC2 *PGM CLP TAASPPGC2 QATTCL
TAASPPGR *PGM RPG TAASPPGR QATTRPG
|
