Open List of Spooled Files (QGYOLSPL) API


  Required Parameter Group:

1 Receiver variable Output Char(*)
2 Length of receiver variable Input Binary(4)
3 List information Output Char(80)
4 Number of records to return Input Binary(4)
5 Sort information Input Char(*)
6 Filter information Input Char(*)
7 Qualified job name Input Char(26)
8 Format of the generated list Input Char(8)
9 Error code I/O Char(*)

  Optional Parameter Group:

10 Format of filter information Input Char(8)

  Default Public Authority: *USE

  Threadsafe: No

The Open List of Spooled Files (QGYOLSPL) API generates a list of spooled files on the system. It creates a list similar to the list created by calling the List Spooled Files (QUSLSPL) API. The list can include all spooled files or those of specific users, output queues, form types, user-specified data values, statuses, printers, or specific jobs. The filtered list can then be sorted depending on the value of the sort parameter. You can specify how many list entries to return when calling this API. At a later time, you can request additional entries from the list using the Get List Entries (QGYGTLE) API. You can close this list by using the Close List (QGYCLST) API.

Note: The QTEMP library and the system portion of the library list could be different between the main job and the server job when the list is being built asynchronously. If this is a problem, request that the list be built synchronously.

For more information, see Process Open List APIs.


Differences between QUSLSPL and QGYOLSPL


Performance Impacts

Filtering on multiple values of user name, qualified output queue name, or user-specified data takes more processing power and time.

Additionally, filtering on a status or a printer device name takes more processing power and time.


Authorities and Locks

Output Queue Authority
*USE
Output Queue Library Authority
*EXECUTE

Required Parameter Group

Receiver variable
OUTPUT; CHAR(*)

The variable used to return the number of records requested (given in the number of records to return parameter) of spooled file information. See Format of Receiver Variable for a description of the layout of this parameter.

Length of receiver variable
INPUT; BINARY(4)

The length of the receiver variable.

List information
OUTPUT; CHAR(80)

Information about the list created by this program. For a description of the layout of this parameter, see Open list information format.

Number of records to return
INPUT; BINARY(4)

The number of records in the list to put into the receiver variable after filtering and sorting has been done.

If -1 is specified for this parameter the entire list is built synchronously.

If 0 is specified for this parameter the entire list is built asynchronously in a server job.

If a positive number of records to return is specified, at least that many records will be built synchronously and the remainder will be built asynchronously in a server job.

Sort information
INPUT; CHAR(*)

Information about what fields within the record of information to sort. See Format of Sort Information for a description of the layout of this parameter. Note that when sorting is requested, the entire list has to be built and sorted before any records can be returned.

Filter information
INPUT; CHAR(*)

The information in this parameter is used for filtering the list of spooled file information. For more details about filtering options, see Format of Filter Information.

Qualified job name
INPUT; CHAR(26)

The qualified job name of the job whose files are to be included in the list. This parameter can be blank. If blanks are specified, spooled files will be listed for all jobs that match the criteria specified in the filter information parameter.

The qualified job name has three parts:

Job name CHAR(10).
A specific job name or the following special value:
* Current job. The rest of the job name parameter must be blank.
User name CHAR(10).
A specific user profile name or blanks when the job name is *.
Job number CHAR(6).
A specific job number or blanks when the job name is *.

Format of the generated list
INPUT; CHAR(8)

The format of the spooled file information being returned.

You must specify one of the following:

OSPL0100 Contains the basic information about the spooled file.
OSPL0200 Contains all the information in format OSPL0100 plus additional information about the spooled file.
OSPL0300 Contains the basic information about the spooled file. This format differs from format OSPL0100 in that it provides slightly different information with less processing time.
OSPL0400 Contains the basic information about the spooled file. This format differs from format OSPL0300 in that it provides dates and times in Coordinated Universal time (UTC) instead of local job time.

The OSPL0100 format returns information faster than the OSPL0200 format.

The OSPL0300 and OSPL0400 formats return information faster than the OSPL0100 format.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Optional Parameter Group

Format of filter information
INPUT; CHAR(8)

The format of the filter information passed in the Filter information parameter.

OSPF0100 Defines the format of the filter information when filtering on one or more of the following:
  • User name
  • Output queue name and library
  • Form type
  • User data
  • Spooled file status
  • Printer Device
OSPF0200 Defines the format of the filter information when filtering on one or more of the following:
  • User name
  • Output queue name and library
  • Spooled file status
  • Printer device
  • Form type
  • User data
  • Job system name
  • Starting spooled file creation date
  • Starting spooled file creation time
  • Ending spooled file creation date
  • Ending spooled file creation time

Format of Receiver Variable

The following tables describe the order and format of the data returned in the receiver variable.


OSPL0100 Format

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Spooled file name
10 A CHAR(10) Job name
20 14 CHAR(10) User name
30 1E CHAR(6) Job number
36 24 BINARY(4) Spooled file number
40 28 BINARY(4) Total pages
44 2C BINARY(4) Current page
48 30 BINARY(4) Copies left to print
52 34 CHAR(10) Output queue name
62 3E CHAR(10) Output queue library name
72 48 CHAR(10) User data
82 52 CHAR(10) Status
92 5C CHAR(10) Form type
102 66 CHAR(2) Priority
104 68 CHAR(16) Internal job identifier
120 78 CHAR(16) Internal spooled file identifier
136 88 CHAR(10) Device type
146 92 CHAR(2) Reserved
148 94 BINARY(4) Offset to OSPL0100 extension
152 98 BINARY(4) Length of OSPL0100 extension
156 9C CHAR(4) Reserved


Format OSPL0100 extension

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(8) Job system name
8 8 CHAR(7) Date spooled file was opened (created)
15 F CHAR(6) Time spooled file was opened (created)
21 15 CHAR(7) Date spooled file was created in UTC
28 12 CHAR(6) Time spooled file was created in UTC
34 22 CHAR(2) Reserved


Format OSPL0200

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 Everything in format OSPL0100 (not including extension)
160 A0 CHAR(7) Date spooled file was opened (created)
167 A7 CHAR(6) Time spooled file was opened (created)
173 AD CHAR(1) Printer assigned
174 AE CHAR(10) Printer name
184 B8 CHAR(7) Date spooled file was created in UTC
191 BF CHAR(6) Time spooled file was created in UTC
197 C5 CHAR(3) Reserved


Format OSPL0300

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Job name
10 A CHAR(10) User name
20 14 CHAR(6) Job number
26 1A CHAR(10) Spooled file name
36 24 BINARY(4) Spooled file number
40 28 BINARY(4) File status
44 2C CHAR(7) Date spooled file was opened (created)
51 33 CHAR(6) Time spooled file was opened (created)
57 39 CHAR(1) Spooled file schedule
58 3A CHAR(10) Job system name
68 44 CHAR(10) User data
78 4E CHAR(10) Spooled file form type
88 58 CHAR(10) Output queue name
98 62 CHAR(10) Output queue library name
108 6C BINARY(4) Auxiliary storage pool
112 70 BINARY(4) Size of spooled file
116 74 BINARY(4) Spooled file size multiplier
120 78 BINARY(4) Total pages
124 7C BINARY(4) Copies left to print
128 80 CHAR(1) Priority
129 81 CHAR(3) Reserved
132 84 BINARY(4) Internet print protocol job identifier


Format OSPL0400

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Job name
10 A CHAR(10) User name
20 14 CHAR(6) Job number
26 1A CHAR(10) Spooled file name
36 24 BINARY(4) Spooled file number
40 28 BINARY(4) File status
44 2C CHAR(7) Date spooled file was created in UTC
51 33 CHAR(6) Time spooled file was created in UTC
57 39 CHAR(1) Spooled file schedule
58 3A CHAR(10) Job system name
68 44 CHAR(10) User data
78 4E CHAR(10) Spooled file form type
88 58 CHAR(10) Output queue name
98 62 CHAR(10) Output queue library name
108 6C BINARY(4) Auxiliary storage pool
112 70 BINARY(4) Size of spooled file
116 74 BINARY(4) Spooled file size multiplier
120 78 BINARY(4) Total pages
124 7C BINARY(4) Copies left to print
128 80 CHAR(1) Priority
129 81 CHAR(3) Reserved
132 84 BINARY(4) Internet print protocol job identifier


Format of Filter Information

Filter Information Format OSPF0100

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 BINARY(4) Number of user names
These fields are repeated for each user to filter on. The offsets vary. CHAR(10) User name
CHAR(2) Reserved
    BINARY(4) Number of output queue names
These fields are repeated for each output queue to filter on. The offsets vary. CHAR(10) Output queue name
CHAR(10) Output queue library name
    CHAR(10) Form type
    CHAR(10) User-specified data
    BINARY(4) Number of statuses
These fields are repeated for each status to filter on. The offsets vary. CHAR(10) Spooled file status
CHAR(2) Reserved
    BINARY(4) Number of printer device names
These fields are repeated for each printer device to filter on. The offsets vary. CHAR(10) Printer device name
CHAR(2) Reserved


Filter Information Format OSPF0200

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 BINARY(4) Length of filter information
4 4 BINARY(4) Offset to user name entries
8 8 BINARY(4) Number of user name entries
12 C BINARY(4) Length of user name entry
16 10 BINARY(4) Offset to output queue name entries
20 14 BINARY(4) Number of output queue name entries
24 18 BINARY(4) Length of output queue name entry
28 1C BINARY(4) Offset to spooled file status entries
32 20 BINARY(4) Number of spooled file status entries
36 24 BINARY(4) Length of spooled file status entry
40 28 BINARY(4) Offset to printer device name entries
44 2C BINARY(4) Number of printer device name entries
48 30 BINARY(4) Length of printer device name entry
52 34 CHAR(10) Form type
62 3E CHAR(10) User-specified data
72 48 CHAR(8) System name
80 50 CHAR(7) Starting spooled file create date
87 57 CHAR(6) Starting spooled file create time
93 5D CHAR(7) Ending spooled file create date
100 64 CHAR(6) Ending spooled file create time
106 6A CHAR(4) Reserved


User Name Entry

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) User name


Output Queue Name Entry

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Output queue name
10 A CHAR(10) Output queue library name


Spooled File Status Entry

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Spooled file status


Printer Device Name Entry

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(10) Printer device name


Format of Sort Information

For more details about the fields in the following table, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 BINARY(4) Number of keys to sort on
Offsets vary. These fields repeat for each sort key field. BINARY(4) Sort key field starting position
BINARY(4) Sort key field length
BINARY(2) Sort key field data type
CHAR(1) Sort order
CHAR(1) Reserved

Note: If the last 3 fields (sort key field data type, sort order, and the reserved field) are not used, then they must be set to hexadecimal zeros. This causes all the data to be treated as character data, and it is sorted in ascending order.


Field Descriptions

Auxiliary storage pool. The auxiliary storage pool in which the spooled file resides.

Valid values are:

1 *SYSTEM. System auxiliary storage pool
2-255 The number of the auxiliary storage pool.

Copies left to print. The remaining number of copies to be printed. This attribute applies to printer device type spooled files only.

Current page. The page number or record number currently being written. The page number may be lower or higher than the page number actually being printed because of buffering done by the system. For example, if the spooled file is routed to a diskette unit or the writer is currently printing job separators or file separators for the spooled file, the page number shown may be zero.

Date spooled file was created in UTC. The date, based on Coordinated Universal Time (UTC), that the file was opened in the CYYMMDD format.

C Century, where 0 indicates years 19xx and 1 indicates years 20xx.
YY Year
MM Month
DD Day

Date spooled file was opened (created). The date, based on local job time, that the file was opened in the CYYMMDD format.

C Century, where 0 indicates years 19xx and 1 indicates years 20xx.
YY Year
MM Month
DD Day

Device type. The type of device for which the spooled file is intended. The possible values are PRINTER or DISKETTE.

Ending spooled file create date. The date, based on local job time, that 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 one of the following special values:

*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.
date All spooled files with a create date and time equal to or later than the starting spooled file create date and time and less than or equal to the ending spooled file create date and time are to be returned.

The date format CYYMMDD is defined as follows:

C Century, where 0 indicates years 19xx and 1 indicates years 20xx.
YY Year
MM Month
DD Day

Ending spooled file create time. The time, in local job time, that 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.

The time format HHMMSS is defined as follows:

HH Hour
MM Minutes
SS Seconds

File status. The status of the file. The following list of values is used to describe the status of the file:

1 RDY The file is available to be written to an output device by a writer.
2 OPN The file has not been processed completely and is not ready to be selected by a writer.
3 CLO The file has been processed completely by a program, but SCHEDULE(*JOBEND) was specified. The job that produced the spooled file has not finished.
4 SAV The file has been written and then saved. This file remains saved until it is released.
5 WTR This file currently is being produced by the writer on an output device.
6 HLD The file has been held.
7 MSGW This file has a message that needs a reply or needs an action to be taken.
8 PND This file is pending (waiting) to be printed.
9 PRT The file has been sent to the printer completely, but the print complete status has not been sent back.
10 FIN This spooled file is no longer in the system. These spooled files are included in the list of spooled files only if the qualified job name is specified.
11 SND This spooled file is being sent or has been sent to a remote system.
12 DFR This spooled file has been deferred from printing.

Form type. The type of forms that should be loaded on the printer before this spooled file is printed or spooled files whose form type matches this value are included in the list. This attribute applies to printer device type spooled files only. This field can be used in conjunction with the user, output queue and library, user-specified data, status, device fields and qualified job name parameter to subset the list of all the spooled files.

The following special values can be used for the form type:

*ALL Spooled files are included in the list regardless of the value for form type.
*STD Only files that specify the standard form type are included in the list.

Internal job identifier. The internal identifier for the job. Only the IBM® i APIs use this identifier, not any other interface on the system. The identifier is not valid following an initial program load (IPL). If you attempt to use it after an IPL, an exception occurs. This identifier is always valid when used with the internal spooled file identifier as input to IBM i APIs. For spooled files which have been detached from their jobs or which are on independent disk pools, this value is not valid as input to some IBM i APIs, such as the Retrieve Job Information (QUSRJOBI) API, that take this value without the internal spooled file identifier.

Internal spooled file identifier. The input value that other programs use to improve the performance of locating the spooled file on the system. Only the spooled file APIs use this identifier, not any other interface on the system. The identifier is not valid following an initial program load (IPL) or if the spooled file has been moved between auxiliary storage pools (ASPs). If you attempt to use an invalid internal spooled file identifier, an exception occurs.

Internet print protocol job identifier. The IPP job identifier assigned by the system based on the output queue to which the file was added or moved. This value ranges from 1 to 2147483647 and is not guaranteed to be unique for a given output queue.

Job name. The name of the job that owns the spooled file.

Job number. The number of the job that owns the spooled file.

Job system name. The name of the system where the job that created the spooled file ran.

Length of filter information. The number of bytes of the fixed portion for the filter information provided. If this value is greater than 106, the extra bytes must be set to hexidecimal zeros.

Length of OSPL0100 extension. The size, in bytes, of the OSPL0100 format extension.

Length of output queue name entry. The size, in bytes, of the output queue name entry. The minimum allowed size is 20. The value of this field will be used by the API to find the next output queue name entry.

Length of printer device name entry. The size, in bytes, of the printer device name entry. The minimum allowed size is 10. The value of this field will be used by the API to find the next printer device name entry.

Length of spooled file status entry. The size, in bytes, of the spooled file status entry. The minimum allowed size is 10. The value of this field will be used by the API to find the next spooled file status entry.

Length of user name entry. The size, in bytes, of the user name entry. The minimum allowed size is 10. The value of this field will be used by the API to find the next user name entry.

Number of printer device names. The number of printer device names to filter on. The value specified must be greater than or equal to 1 for filter format OSPF0100. The value specified must be greater than or equal to 0 for filter format OSPF0200. With filter format OSPF0200, a value of 0 (*ALL) indicates spooled files are included in the list regardless of the printer device name.

Spooled files whose assigned printer device matches one of the printer device names specified are included in the list.

Number of keys to sort on. The number of fields within the record structure to sort on. If 0 is specified, the list is not sorted.

Number of output queue name entries. The number of output queues to filter on. The value specified must be greater than or equal to 1.

Spooled files whose output queue matches one of the output queues specified are included in the list.

Number of output queue names. The number of output queues to filter on. The value specified must be greater than or equal to 0. A value of 0 indicates spooled files are included in the list regardless of the output queue the spooled file resides on.

Spooled files whose output queue matches one of the output queues specified are included in the list.

Number of spooled file status entries. The number of spooled file statuses to filter on. The value specified must be greater than or equal to 0. A value of 0 indicates spooled files are included in the list regardless of the status of the spooled file.

Spooled files whose current status matches one of the statuses specified are included in the list.

Number of statuses. The number of spooled file statuses to filter on. The value specified must be greater than or equal to 1.

Spooled files whose current status matches one of the statuses specified are included in the list.

Number of user name entries. The number of user names to filter on. The value specified must be greater than or equal to 0. A value of 0 indicates spooled files are included in the list regardless of the user name.

Spooled files owned by one of the user profile names specified are included in the list.

Number of user names. The number of user names to filter on. The value specified must be greater than or equal to 1.

Spooled files owned by one of the user profile names specified are included in the list.

Offset to OSPL0100 extension. The offset, in bytes, from the beginning of the structure, to the OSPL0100 format extension.

Offset to output queue name entries. The offset, in bytes, from the beginning of the structure, to one or more output queue name entries.

Offset to printer device name entries. The offset, in bytes, from the beginning of the structure, to one or more printer device name entries.

Offset to spooled file status entries. The offset, in bytes, from the beginning of the structure, to one or more spooled file status entries.

Offset to user name entries. The offset, in bytes, from the beginning of the structure, to one or more user name entries.

Output queue library name. The name of the library where the output queue resides.

The following special values can be used for the output queue library name when filtering:

*CURLIB The current library for the current job.
*LIBL The library list of the current job.

Output queue library name. The library where the output queue is located.

Output queue name. The name of the output queue to filter on or the name of the output queue in which the spooled file is located. At least one output queue or special value must be specified. This field can be used in conjunction with the user, form type, user-specified data, status, device fields and qualified job name parameter to subset the list of all the spooled files.

The following special value is used for the output queue name when filtering:

*ALL Spooled files are included in the list regardless of the output queue. When this value is specified, the output queue library name must be blanks.The field Number of output queue names must be set to 1 when using filtering information format OSPF0100. The field Number of output queue name entries must be set to 0 to signify *ALL when using filtering information format OSPF0200.

Printer assigned. Set to 1 when the spooled file is assigned to a specific printer. In this case, the printer name field contains the name of the assigned printer. Set to 2 when the spooled file is assigned to multiple printers. In this case, the printer name is set to blanks. Set to 3 when the spooled file is not assigned to a printer. In this case, the printer name is set to blanks. This attribute applies to printer device type spooled files only.

Printer device name. The name of the printer device to filter on. At least one printer device name or special value must be specified. This field can be used in conjunction with the user, output queue and library, form type, user-specified data, status fields and the qualified job name parameter to subset the list of all the spooled files. This field is not valid for format OSPL0100 and will be ignored for format OSPL0300 unless the only filtering requested is for a single printer device name. Note: For filtering information format OSPF0100, the first 10 characters contain the printer device, and the next 2 characters are reserved.

The following special value can be used for the device name:

*ALL Spooled files are included in the list regardless of the device name. When this value is specified, the Number of printer device names to filter on must be 1.

Printer name. The name of the printer the spooled file has been assigned to print on. This attribute applies to printer device type spooled files only.

Priority. The priority of the spooled file. The priority ranges from 1 (highest) to 9 (lowest).

Reserved. Reserved field. Must be set to hexadecimal or binary zero.

Size of spooled file. The spooled file size. Multiply this field by the spooled file size multiplier field to get the size of the spooled file in number of bytes. The size of the spooled file is the data stream size plus the spooled file's attributes, plus the "overhead" storage used to store the spooled file's data stream.

Sort key field data type. Data type of field to sort. Refer to QLGSORT API for information about the list of data types available.

Sort key field length. The length of the field to sort on.

Sort key field starting position. Within the record of information, the starting position of the field to sort on.

Sort order. Used to specify if the list should be sorted in ascending or descending order according to the key.

Spooled file form type. The type of form to load in the printer to print this file.

Spooled file name. The name of the spooled file in the list entry.

Spooled file number. The number of the spooled file in the list entry.

Spooled file schedule. The schedule of the spooled file. Valid values are:

1 The spooled file is schedule immediate. A spooling writer can process the spooled file immediately.
2 The spooled file is schedule file end. A spooling writer cannot process the spooled file until it has been closed.
3 The spooled file is schedule job end. A spooling writer cannot process the spooled file until the job of the spooled file has ended.

Spooled file size multiplier. The number to multiply the size of spooled file field to get the size of the spooled file in number of bytes.

Spooled file status. The spooled file status to filter on.

Refer to the QUSLSPL API for possible values for the spooled file status. At least one status or special value must be specified. This field can be used in conjunction with the user, output queue and library, form type, user-specified data, device fields and the qualified job name parameter to subset the list of all the spooled files.

Note: When using filter format OSPF0100, the first 10 characters contain the status, and the next 2 characters are reserved.

The following special values can be used for the spooled file status:

*ALL Spooled files are included in the list regardless of the current status. The field Number of statuses must be set to 1, when using filter information format OSPF0100. The field Number of spooled file status entries must be set to 0 to signify *ALL when using filter information format OSPF0200.
*CLOSED The file has been completely processed by a program, but SCHEDULE(*JOBEND) was specified. The job that produced the spooled file has not finished.
*DEFERRED This spooled file has been deferred from printing.
*SENDING This spooled file is being sent or has been sent to a remote system.
*FINISHED This spooled file is no longer in the system. These spooled files are included in the list of spooled files only if the qualified job name is specified.
*HELD The file has been held.
*MESSAGE This file has a message that needs a reply or needs an action to be taken.
*OPEN The file has not been completely processed and is not ready to be selected by a writer.
*PENDING This file is pending (waiting) to be printed.
*PRINTER The file has been completely sent to the printer, but the print complete status has not been sent back.
*READY The file is available to be written to an output device by a writer.
*SAVED The file has been written and then saved. This file remains saved until it is released.
*WRITING This file is currently being produced by the writer on an output device.

Starting spooled file create date. The date, based on local job time, that the spooled file was created on the system. The date must be in the CYYMMDD format or one of the following special values:

*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.
date All spooled files with a create date and time equal to or later than the starting spooled file create date and time and less than or equal to the ending spooled file create date and time are to be returned.

The date format CYYMMDD is defined as follows:

YY Year
MM Month
DD Day
C Century, where 0 indicates years 19xx and 1 indicates years 20xx.

Starting spooled file create time. The time, in local job time, that the spooled file was created on the system. This field must be set to blanks when special value *ALL or *FIRST is used for field Starting spooled file create date. This field must have a value set if a date is specified for field Starting spooled file create date. The time must be in the HHMMSS format.

The time format HHMMSS is defined as follows:

HH Hour
MM Minutes
SS Seconds

System name. The name of the system where the job that created the spooled file ran. The following special values are supported for this field:

*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.
job-system-name Only spooled files created on the system specified are to be returned.

Time spooled file was created in UTC. The time, in Coordinated Universal Time (UTC), that the file was opened in the HHMMSS format.

HH Hour
MM Minute
SS Second

Time spooled file was opened (created). The time, in local job time, that the file was opened in the HHMMSS format.

HH Hour
MM Minute
SS Second

Total pages. The total number of pages or number of records for a particular spooled file.

User data. The 10 characters of user-specified data that describe the file.

User name. The name of the user that owns the spooled file or the name of the user to filter on. At least one user name or special value must be specified. This field can be used in conjunction with the output queue and library, form type, user-specified data, status, device fields and qualified job name parameter to subset the list of all the spooled files.

Note: When using filtering information format OSPF0100, the first 10 characters contain the user name, and the next 2 characters are reserved.

The following special values can be used for the user name to filter on:

*ALL Spooled files are included in the list regardless of the creating user profile. The field Number of user names must be set to 1 when using filtering format OSPF0100. The field Number of user name entries must be set to 0 to signify *ALL when using filtering format OSPF0200.
*CURRENT Spooled files owned by the current user profile are included in the list.

User-specified data. Only spooled files whose user-specified data or file name match this value are included in the list. This field can be used in conjunction with the user, output queue and library, form type, status, device fields and qualified job name parameter to subset the list of all the spooled files.

The special value supported is:

*ALL Spooled files are included in the list regardless of the value for user-specified data.

Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3330 E Necessary resource not available.
CPF3342 E Job &5/&4/&3 not found.
CPF3343 E Duplicate job names found.
CPF335D E Job system name is not valid.
CPF335E E Starting spooled file create date is not valid.
CPF335F E Starting spooled file create time is not valid.
CPF336C E Starting spooled file create time is not blank.
CPF336D E Ending spooled file create date is not valid.
CPF336E E Ending spooled file create date is not blank.
CPF336F E Ending spooled file create time is not valid.
CPF337A E Ending spooled file create time is not blank.
CPF3C19 E Error occurred with receiver variable specified.
CPF3C21 E Format name &1 is not valid.
CPF3C30 E Library name &1 is not valid for output queue *ALL.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF9801 E Object &2 in library &3 not found.
CPF9802 E Not authorized to object &2 in &3.
CPF9803 E Cannot allocate object &2 in library &3.
CPF9807 E One or more libraries in library list deleted.
CPF9808 E Cannot allocate one or more libraries on library list.
CPF9810 E Library &1 not found.
CPF9820 E Not authorized to use library &1.
CPF9830 E Cannot assign library &1.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.
GUI0002 E &2 is not valid for length of receiver variable.
GUI0009 E &1 is not valid for number of statuses.
GUI0011 E &1 is not valid for number of user names.
GUI0012 E &1 is not valid for number of output queue names.
GUI0024 E &1 is not valid for number of keys to sort on.
GUI0025 E &1 is not valid for sort key field starting position.
GUI0026 E &1 is not valid for sort key field length.
GUI0027 E &1 is not valid for number of records to return.
GUI0042 E &1 is not valid for status.
GUI0078 E *ALL cannot be specified with another value.
GUI0079 E *ALL cannot be specified with another value.
GUI0080 E *ALL cannot be specified with another value.
GUI0081 E *ALL cannot be specified with another value.
GUI0108 E Filter information is not valid. Reason code &1.
GUI0121 E Printer name cannot be specified when format OSPL0100 is requested.

API introduced: V3R6

[ Back to top | Print APIs | APIs by category ]