com.ibm.as400.access
Class SpooledFileList

java.lang.Object
  |
  +--com.ibm.as400.access.PrintObjectList
        |
        +--com.ibm.as400.access.SpooledFileList
All Implemented Interfaces:
java.io.Serializable

public class SpooledFileList
extends PrintObjectList
implements java.io.Serializable

The SpooledFileList class is used to build a list of AS/400 spooled file objects of type SpooledFile. The list can be filtered by formtype, output queue, user, ending date, ending time, or user data.

See Also:
SpooledFile, Serialized Form

Constructor Summary
SpooledFileList()
          Constructs a SpooledFileList object.
SpooledFileList(AS400 system)
          Constructs a SpooledFileList object.
 
Method Summary
 java.lang.String getEndDateFilter()
          Returns the end create date filter.
 java.lang.String getEndTimeFilter()
          Returns the end create date filter.
 java.lang.String getFormTypeFilter()
          Returns the formtype list filter.
 java.lang.String getJobSystemFilter()
          Returns the create job system filter.
 java.lang.String getQueueFilter()
          Returns the output queue filter.
 java.lang.String getStartDateFilter()
          Returns the create start date filter.
 java.lang.String getStartTimeFilter()
          Returns the create date filter.
 java.lang.String getUserDataFilter()
          Returns the user data list filter.
 java.lang.String getUserFilter()
          Returns the user ID list filter.
 void setEndDateFilter(java.lang.String endDateFilter)
          Sets the end date filter.
 void setEndTimeFilter(java.lang.String endTimeFilter)
          Sets the end time filter.
 void setFormTypeFilter(java.lang.String formTypeFilter)
          Sets the formtype list filter.
 void setJobSystemFilter(java.lang.String jobSystemFilter)
          Sets the create job system filter.
 void setQueueFilter(java.lang.String queueFilter)
          Sets the output queue filter.
 void setStartDateFilter(java.lang.String startDateFilter)
          Sets the create start date filter.
 void setStartTimeFilter(java.lang.String startTimeFilter)
          Sets the create start time filter.
 void setUserDataFilter(java.lang.String userDataFilter)
          Sets the user data list filter.
 void setUserFilter(java.lang.String userFilter)
          Sets the user ID list filter.
 
Methods inherited from class com.ibm.as400.access.PrintObjectList
addPrintObjectListListener, addPropertyChangeListener, addVetoableChangeListener, close, getObject, getObjects, getSystem, isCompleted, openAsynchronously, openSynchronously, removePrintObjectListListener, removePropertyChangeListener, removeVetoableChangeListener, resetAttributesToRetrieve, resetFilter, setAttributesToRetrieve, setSystem, size, waitForItem, waitForListToComplete
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SpooledFileList

public SpooledFileList()
Constructs a SpooledFileList object. The AS/400 system must be set later. This constructor is provided for visual application builders that support JavaBeans. It is not intended for use by application programmers.
See Also:
PrintObjectList.setSystem(com.ibm.as400.access.AS400)

SpooledFileList

public SpooledFileList(AS400 system)
Constructs a SpooledFileList object. It uses the system name specified. The default list filter will list all spooled files for the current user on the specified system.
Parameters:
system - The AS/400 on which the spooled files exist.
Method Detail

getFormTypeFilter

public java.lang.String getFormTypeFilter()
Returns the formtype list filter.

getQueueFilter

public java.lang.String getQueueFilter()
Returns the output queue filter.

getUserFilter

public java.lang.String getUserFilter()
Returns the user ID list filter.

getUserDataFilter

public java.lang.String getUserDataFilter()
Returns the user data list filter.

getJobSystemFilter

public java.lang.String getJobSystemFilter()
Returns the create job system filter.

getEndDateFilter

public java.lang.String getEndDateFilter()
Returns the end create date filter.

getEndTimeFilter

public java.lang.String getEndTimeFilter()
Returns the end create date filter.

getStartDateFilter

public java.lang.String getStartDateFilter()
Returns the create start date filter.

getStartTimeFilter

public java.lang.String getStartTimeFilter()
Returns the create date filter.

setFormTypeFilter

public void setFormTypeFilter(java.lang.String formTypeFilter)
                       throws java.beans.PropertyVetoException
Sets the formtype list filter.
Parameters:
formTypeFilter - The form type the spooled file must to be included in the list. It cannot be greater than 10 characters. The value can be any specific value or any of these special values:
  • *ALL - Spooled files with any form type will be included in the list.
  • *STD - Spooled files with the form type *STD will be included in the list.
The default is *ALL.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setQueueFilter

public void setQueueFilter(java.lang.String queueFilter)
                    throws java.beans.PropertyVetoException
Sets the output queue filter.
Parameters:
queueFilter - The library and output queues on which to list spooled files. The format of the queueFilter string must be in the format of /QSYS.LIB/libname.LIB/queuename.OUTQ where
libname is the library name that contains the queues to search. It can be a specific name or one of these special values:
  • %CURLIB% - The server job's current library
  • %LIBL% - The server job's library list
  • %ALL% - All libraries are searched. This value is only valid if the queuename is %ALL%.
queuename is the name of an output queues to search. It can be a specific name or the special value %ALL%. If it is %ALL%, then the libname must be %ALL%.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setJobSystemFilter

public void setJobSystemFilter(java.lang.String jobSystemFilter)
                        throws java.beans.PropertyVetoException
Sets the create job system filter. The name of the system where the job, specified in the qualified job name parameter, was run. This parameter can be used in conjunction with the user name, qualified output queue name, form type, user-specified data, auxiliary storage pool, starting spooled file create date, starting spooled file create time, ending spooled file create date, ending spooled file create time, or qualified job name parameters to return a partial list of all the spooled files. The list of spooled files returned is sorted by status, output priority, date, and time. The following special values are supported for this parameter:
Parameters:
setJobSystemFilter -
*ALL The returned list is not to be filtered based on job system name. *CURRENT Only spooled files created on the current system are to be returned. Only spooled files created on the system specified are to be returned.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setEndDateFilter

public void setEndDateFilter(java.lang.String endDateFilter)
                      throws java.beans.PropertyVetoException
Sets the end date filter. The date the spooled file was created on the system. If the Starting spooled file create date field is set to *ALL, then this field must be set to blanks. If a date has been specified for the Starting spooled file create date field, then this field must be set to a valid date. The date must be in the CYYMMDD format or the following special value:
Parameters:
endDateFilter -
date All spooled files with a create date and time equal to or later than the starting spooled file create date are to be returned.
  • *LAST - All spooled files with a create date and time equal to or later than the starting spooled file create date are to be returned.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setEndTimeFilter

public void setEndTimeFilter(java.lang.String endTimeFilter)
                      throws java.beans.PropertyVetoException
Sets the end time filter. The time the spooled file was created on the system. This field must be set to blanks when special value *ALL is used for field Starting spooled file create date or when special value *LAST is used for field Ending spooled file create date. This field must have a value set if a date is specified for field Ending spooled file create date. The time must be in the HHMMSS format.
Parameters:
endTimeFilter -
time All spooled files with a create date and time equal to or later than the starting spooled file create date are to be returned.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setStartDateFilter

public void setStartDateFilter(java.lang.String startDateFilter)
                        throws java.beans.PropertyVetoException
Sets the create start date filter. The date the spooled file was created on the system. This parameter can be used in conjunction with the user name, qualified output queue name, form type, user-specified data, auxiliary storage pool, job system name, starting spooled file create time, ending spooled file create date, ending spooled file create time, or qualified job name parameters to return a partial list of all the spooled files. The list of spooled files returned is sorted by status, output priority, date, and time. The date must be in the CYYMMDD format or one of the following special values:
Parameters:
startDateFilter -
date All spooled files with a create date and time equal to or later than the starting spooled file create date are to be returned. *ALL The returned list is not to be filtered based on spooled file create date and spooled file create time. *FIRST All spooled files starting with the earliest create date and time and less than or equal to the ending spooled file create date and time are to be returned.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setStartTimeFilter

public void setStartTimeFilter(java.lang.String startTimeFilter)
                        throws java.beans.PropertyVetoException
Sets the create start time filter. This parameter can be used in conjunction with the user name, qualified output queue name, form type, user-specified data, auxiliary storage pool, job system name, starting spooled file create date, ending spooled file create date, ending spooled file create time, or qualified job name parameters to return a partial list of all the spooled files. The list of spooled files returned is sorted by status, output priority, date, and time. This parameter must be set to blanks when special value *ALL or *FIRST is used for parameter Starting spooled file create date. This parameter must have a value set if a date is specified for parameter Starting spooled file create date. The time must be in the HHMMSS format. The time format HHMMSS is defined as follows:
Parameters:
startTimeFilter -
time All spooled files with a create date and time equal to or
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setUserFilter

public void setUserFilter(java.lang.String userFilter)
                   throws java.beans.PropertyVetoException
Sets the user ID list filter.
Parameters:
userFilter - The user or users for which to list spooled files. The value cannot be greater than 10 characters. The value can be any specific user ID or any of these special values:
  • *ALL - Spooled files created by all users will be included in the list.
  • *CURRENT - Spooled files created by the current user only will be in the list.
The default is *CURRENT.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.

setUserDataFilter

public void setUserDataFilter(java.lang.String userDataFilter)
                       throws java.beans.PropertyVetoException
Sets the user data list filter.
Parameters:
userDataFilter - The user data the spooled file must have for it to be included in the list. The value can be any specific value or the special value *ALL. The value cannot be greater than 10 characters. The default is *ALL.
Throws:
java.beans.PropertyVetoException - If the change is vetoed.