Data Queue APIs--Categories - FTP Directory Listing - IBM

Data Queue APIs--Categories - FTP Directory Listing - IBM Data Queue APIs--Categories - FTP Directory Listing - IBM

as400bks.rochester.ibm.com
from as400bks.rochester.ibm.com More from this publisher
30.06.2013 Views

List Objects (QUSLOBJ) API Reset date and time. The date the days-used count was last reset to zero, in system time-stamp format. If the days-used count has never been reset, the field contains hexadecimal zeros. Save active date and time. The date and time the object was last saved when the SAVACT(*LIB, *SYSDFN, or *YES) save operation was specified, in system time-stamp format. This parameter is found on the Save Library (SAVLIB), Save Object (SAVOBJ), Save Changed Object (SAVCHGOBJ), and Save Document Library Object (SAVDLO) CL commands. If the object has never been saved or if SAVACT(*NO) was specified on the last save operation for the object, the field contains hexadecimal zeros. Save command. The command used to save the object. The field is blank if the object was not saved. Save device. The type of device to which the object was last saved. The field is *SAVF if the last save operation was to a save file. The field is *DKT if the last save operation was to diskette. The field is *TAP if the last save operation was to tape. The field is *OPT if the last save operation was to optical. The field is blank if the object was not saved. Save file library name. The name of the library that contains the save file if the object was saved to a save file. The field is blank if the object was not saved to a save file. Save file name. The name of the save file if the object was saved to a save file. The field is blank if the object was not saved to a save file. Save label. The file label used when the object was saved. The variable is blank if the object was not saved to tape, diskette, or optical. The value of the variable corresponds to the value specified for the LABEL of OPTFILE parameter on the command used to save the object. Save sequence number. The tape sequence number assigned when the object was saved on tape. If the object was not saved to tape, the field contains zeros. Save size. The size of the object in bytes of storage at the time of the last save operation. The save size is equal to or smaller than the save size multiplied by the save size multiplier. The field contains zeros if the object was not saved. Save size multiplier. The value to multiply the save size by to get the true size. The value is 1 if the save size is smaller than 1 000 000 000 bytes, and 1024 if it is larger. Save volume ID. The tape, diskette, or optical volumes that are used for saving the object. The variable returns a maximum of 10 six-character volumes. The volume IDs begin in character positions 1, 8, 15, 22, 29, 36, 43, 50, 57, and 64. Each volume ID entry is separated by a single character. If the object was saved in parallel format, the separator character contains a 2 before the first volume in the second media file, a 3 before the third media file, and so on, up to a 0 before the tenth media file. Otherwise, the separator characters are blank. If more than 10 volumes are used and the object was saved in serial format, 1 is returned in the 71st character of the variable. If the object was saved in parallel format, a 2 is returned in the 71st character of the variable. Otherwise, the 71st character is blank. The field is blank if the object was last saved to a save file or if it was never saved. Select or omit status value. An indicator that determines whether objects are selected or omitted from the list based on the statuses specified. This field is useful in generating a list of objects with a certain information status, such as damaged or http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (21 of 25) [10/4/1999 2:35:54 PM]

List Objects (QUSLOBJ) API partially damaged objects. It can also be used to generate a list of all objects except objects with a certain information status, such as unauthorized objects. Valid values are: 0 Select on status value 1 Omit on status value Source file library name. The name of the library that contains the source file used to create the object. The field is blank if no source file created the object. Source file member name. The name of the member in the source file. The field is blank if no source file created the object. Source file name. The name of the source file used to create the object. The field is blank if no source file created the object. Source file updated date and time. The date and time the member in the source file was last updated. This field is in the CYYMMDDHHMMSS format where: C Century, where 0 indicates years 19xx and 1 indicates years 20xx. YY Year MM Month DD Day HH Hour MM Minute SS Second The field is blank if no source file created the object. Statuses. The status of objects to select or omit from the list of objects generated. Valid values are all of the possible values listed under the information status field (format OBJL0200). The special value * can be used to select all objects with any information status field. If optional parameter group 2 is omitted, all objects with any information status are selected. Storage. The storage status of the object data. *FREE indicates the object data is freed and the object is suspended. *KEEP indicates the object data is not freed and the object is not suspended. http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (22 of 25) [10/4/1999 2:35:54 PM]

List Objects (QUSLOBJ) API<br />

Reset date and time. The date the days-used count was last reset to zero, in system time-stamp format. If<br />

the days-used count has never been reset, the field contains hexadecimal zeros.<br />

Save active date and time. The date and time the object was last saved when the SAVACT(*LIB,<br />

*SYSDFN, or *YES) save operation was specified, in system time-stamp format. This parameter is found<br />

on the Save Library (SAVLIB), Save Object (SAVOBJ), Save Changed Object (SAVCHGOBJ), and Save<br />

Document Library Object (SAVDLO) CL commands. If the object has never been saved or if<br />

SAVACT(*NO) was specified on the last save operation for the object, the field contains hexadecimal<br />

zeros.<br />

Save command. The command used to save the object. The field is blank if the object was not saved.<br />

Save device. The type of device to which the object was last saved. The field is *SAVF if the last save<br />

operation was to a save file. The field is *DKT if the last save operation was to diskette. The field is *TAP<br />

if the last save operation was to tape. The field is *OPT if the last save operation was to optical. The field<br />

is blank if the object was not saved.<br />

Save file library name. The name of the library that contains the save file if the object was saved to a<br />

save file. The field is blank if the object was not saved to a save file.<br />

Save file name. The name of the save file if the object was saved to a save file. The field is blank if the<br />

object was not saved to a save file.<br />

Save label. The file label used when the object was saved. The variable is blank if the object was not<br />

saved to tape, diskette, or optical. The value of the variable corresponds to the value specified for the<br />

LABEL of OPTFILE parameter on the command used to save the object.<br />

Save sequence number. The tape sequence number assigned when the object was saved on tape. If the<br />

object was not saved to tape, the field contains zeros.<br />

Save size. The size of the object in bytes of storage at the time of the last save operation. The save size is<br />

equal to or smaller than the save size multiplied by the save size multiplier. The field contains zeros if the<br />

object was not saved.<br />

Save size multiplier. The value to multiply the save size by to get the true size. The value is 1 if the save<br />

size is smaller than 1 000 000 000 bytes, and 1024 if it is larger.<br />

Save volume ID. The tape, diskette, or optical volumes that are used for saving the object. The variable<br />

returns a maximum of 10 six-character volumes. The volume IDs begin in character positions 1, 8, 15, 22,<br />

29, 36, 43, 50, 57, and 64. Each volume ID entry is separated by a single character. If the object was saved<br />

in parallel format, the separator character contains a 2 before the first volume in the second media file, a 3<br />

before the third media file, and so on, up to a 0 before the tenth media file. Otherwise, the separator<br />

characters are blank. If more than 10 volumes are used and the object was saved in serial format, 1 is<br />

returned in the 71st character of the variable. If the object was saved in parallel format, a 2 is returned in<br />

the 71st character of the variable. Otherwise, the 71st character is blank. The field is blank if the object<br />

was last saved to a save file or if it was never saved.<br />

Select or omit status value. An indicator that determines whether objects are selected or omitted from the<br />

list based on the statuses specified.<br />

This field is useful in generating a list of objects with a certain information status, such as damaged or<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (21 of 25) [10/4/1999 2:35:54 PM]

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!