SPLF_LIST

LANSA Composer

SPLF_LIST

This activity fills the output lists with details of all or selected spool files in a specified output queue.  Spool files in the output queue can be selected by user, user data or form type by specifying values for the corresponding parameters.

Entries in each output list correspond by index to entries in the other lists for the same spool file.

Activities that populate list variables are often followed by a LOOP processing sequence directive or other constructs to process the contents of the list.  Refer to Variables and Lists for more information about the use of list variables.

INPUT Parameters:

OUTQ : Required

This parameter specifies the name of the output queue from which the spool files are listed.

OUTQLIB : Optional

This parameter specifies the library containing the output queue from which the spool files are listed.  If not specified, a default value of *LIBL is used, meaning the library list is searched to find the output queue named in the OUTQ parameter.

SELECTUSER : Optional

If this parameter is specified, the output lists will include only the spool files for the specified user (that also meet other selection criteria).  If not specified, spool files for all users are eligible to be included.

SELECTUSERDATA : Optional

If this parameter is specified, the output lists will include only the spool files whose user data (USRDTA) matches the user data specified (and that also meet other selection criteria).  If not specified, all spool files are eligible to be included irrespective of their user data.

SELECTFORMTYPE : Optional

If this parameter is specified, the output lists will include only the spool files whose form type (FORMTYPE) matches the form type specified (and that also meet other selection criteria).  If not specified, spool files of any form type are eligible to be included.

OUTPUT Parameters:

SPLFNAMELIST :

Upon successful completion, this parameter will contain a list of the spool file names for spool files that were selected from the specified output queue.

SPLFNUMBERLIST :

Upon successful completion, this parameter will contain a list of the spool file numbers for spool files that were selected from the specified output queue.

JOBNAMELIST :

Upon successful completion, this parameter will contain a list of the job names for spool files that were selected from the specified output queue.  The job names apply to the job that created the spool files.

JOBUSERLIST :

Upon successful completion, this parameter will contain a list of the user profile names for spool files that were selected from the specified output queue.  The user profile names apply to the job that created the spool files.

JOBNUMBERLIST :

Upon successful completion, this parameter will contain a list of the job numbers for spool files that were selected from the specified output queue.  The job numbers apply to the job that created the spool files.