3 11 Invoking the iSeries Spool File Facilities

LANSA Web Functions

3.11 Invoking the iSeries Spool File Facilities

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

You can launch any of the Spool 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 spool 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 spool 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 spool 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 spool 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 spool file, a REPORT request plus details which identify the spool 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 spool file are similar to those on the OS/400 command DSPSPLF.

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

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

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

<spool_filename>  is the name of the spool 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 spool file.

For example:

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