3.11 Invoking the IBM i Spooled File Facilities

This feature is only available for the IBM i Data/Application Server. In order to use the Spool File Facility, it must be enabled using the LANSA Web Administrator.

You can launch any of the Spooled File facilities directly by entering the parameters in your call to the LANSAWEB CGI script program.

To retrieve the page for entry of spool file selection criteria, use the following parameter:

PRINT

For example:

http://www.lansa.com/cgi-bin/lansaweb?PRINT

To retrieve a list of spool files a PRINTLIST request is entered with the selection criteria as follows:

PRINTLIST+<user_name>+<output_queue>+<outq_library>+<form>+<userdata>+<status>

Note that each parameter is delimited by the plus (+) character.

<user_name> is the name of the owner of the spool files which are to be shown in the list. This may be a specific user or *ALL.

<output_queue> is the name of the output queue which contains the spooled files which are to be shown in the list. This may be the name of a specific output queue or *ALL.

<outq_library> is the library which contains the output queue previously specified. This may be a specific library name, *LIBL or *CURLIB.

<form> is the form type of the spooled files which are to be shown in the list. This may be a specific form type, *ALL or *STD.

<userdata> is the user data of the spooled files which are to be shown in the list. This may be a specific user data information or *ALL. User data can contain lower case values. If you wish to enter a lower case value, enclose the parameter in single quotation marks.

<status> is the spooled file status which is to be used for selection of spool files. This value may be one of the following:

*ALL

*CLOSED

*DEFERRED

*FINISHED

*HELD

*MESSAGE

*OPEN

*PENDING

*PRINTING

*READY

*SAVED

*SENDING

*WRITING

 

 

 

 

For example:

http://www.LANSA.com/CGI-BIN/LANSAWEB?PRINTLIST+GROUPAUSR+qprint+*LIBL+*ALL+*ALL+*ALL
or

http://www.lansa.com/CGI-BIN/LANSAWEB?PRINTLIST+GROUPAUSR+*ALL+*LIBL+*ALL+'ListH5'+*ALL

 

To display a spooled file, a REPORT request plus details which identify the spooled file are entered as follows:

REPORT+<job_name>+<user_name>+<job_number>+<spool_filename>+<spool_file_number>+<from_page>+<to_page>

Note that each parameter is delimited by the plus (+) character. The details that identify the spooled file are similar to those on the IBM i command DSPSPLF.

<job_name> is the name of the job which created the spooled file.

<user_name>  is the name of the user profile under which the job which created the spooled file was run.

<job_number> is the system assigned job number of the job which created the spooled file.

<spool_filename>  is the name of the spooled file to be displayed.

<spool_file_number> is the number of the job's spooled file that is to be displayed.

<from_page>  is an optional parameter and may contain the number of the first page you wish to display. If this parameter is not provided it is assumed to be 1.

<to_page>  is an optional parameter and may contain the number of the last page you wish to display. If this parameter is not provided it is assumed to be the final page of the spooled file.

For example:

http://www.lansa.com/CGI-BIN/LANSAWEB?REPORT+WEB0000001+WEBUSER+'092926'+QPJOBLOG+'0001'+'1'+'2'