pub:iviewengines
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | pub:iviewengines [2022/06/25 17:02] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | < | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====== Monitoring Outqueues with the iView Engine ====== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Setup ===== | ||
+ | |||
+ | |||
+ | < | ||
+ | iView Server | ||
+ | 10. Work with iView Servers | ||
+ | 11. Start iView Server | ||
+ | 12. End iView Subsystem | ||
+ | </ | ||
+ | |||
+ | **To setup the iView outqueue engine**, known also as **the server**, select option 10 from the iView main menu. | ||
+ | |||
+ | < | ||
+ | 7/ | ||
+ | | ||
+ | | ||
+ | Type options, press Enter. | ||
+ | 1=Select | ||
+ | | ||
+ | Opt Server | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | Select option 1 to update the IVIEWSEVER engine definition. **Current releases only support one engine named IVIEWSEVER** - do not rename the server or create a second server. | ||
+ | |||
+ | < | ||
+ | | ||
+ | 14: | ||
+ | | ||
+ | Server. . . . . . . . . . : IVIEWSEVER | ||
+ | Description: | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | At this screen you may work with the following header information: | ||
+ | |||
+ | * **Archive Out Queue / Library**: | ||
+ | Current releases only support an archive outqueue named IVIEW/ | ||
+ | |||
+ | * **Description**: | ||
+ | |||
+ | You must specify at least one line of archive recognition information: | ||
+ | |||
+ | * **Originating Outqueue / Library**: This outqueue is watched by the engine for spool files. You may specify multiple outqueues in different libraries. **Caution**: | ||
+ | |||
+ | * **Spool Attribute**: | ||
+ | < | ||
+ | - ***FORMTYPE**: | ||
+ | - ***USERID**: | ||
+ | - ***JOBNAME**: | ||
+ | - ***FILE**: test the name of the printer file. | ||
+ | - ***USERDATA**: | ||
+ | < | ||
+ | |||
+ | * **Spool Value**: | ||
+ | |||
+ | * **Archive Application**: | ||
+ | |||
+ | |||
+ | So in the above printscreen, | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Start the Engine ===== | ||
+ | |||
+ | One the engine has been defined, you may start it with option 11 from menu IVIEW. | ||
+ | |||
+ | < | ||
+ | Start iView Server (STRIVWSRV) | ||
+ | | ||
+ | Type choices, press Enter. | ||
+ | | ||
+ | iView Server . . . . . . . . . . | ||
+ | iView Job Queue . . . . . . . . | ||
+ | iView Library | ||
+ | iDocs Library | ||
+ | | ||
+ | </ | ||
+ | |||
+ | * **iView Server**: | ||
+ | * **iView job queue**: Leave unchanged as SRVJOBQ. | ||
+ | * **iView Library**: Specify the library containing the iView executables. This is normally IVIEW. | ||
+ | * **iDocs Library**: If running with iDocs specify the iDocs library, presently FMG. If not running with iDocs specify *NONE. | ||
+ | * **Enable Subsystem Logging**: Normally use *NO. *YES will cause each process in the IVIEWSBS subsystem to leave a job log. | ||
+ | |||
+ | < | ||
+ | **Very Important: (version 4.01 and later) if running the iDocs integrated version of iView library FMG must be specified as the iDocs library, as iView will presume it is able to use iPDF from an external source; iPDF is bundled with iDocs in library FMG.** | ||
+ | < | ||
+ | |||
+ | After the command completes, the **WRKACTJOB** command should show the IVIEWSBS subsystem running with 5 jobs running in it: | ||
+ | |||
+ | < | ||
+ | Opt Subsystem/ | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | |||
+ | |||
+ | ===== End the Engine ===== | ||
+ | |||
+ | Option 12 from menu IVIEW will end the IVIEWSBS subsystem. | ||
+ | |||
+ | < | ||
+ | 12. End iView Subsystem | ||
+ | </ | ||
+ | |||
+ | |||
+ | ===== Automatically Starting the iView Engine ===== | ||
+ | |||
+ | There are two scenarios to consider when setting up the iView engine to start automatically: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Starting the Engine Daily As A Scheduled Job ==== | ||
+ | |||
+ | To setup iView engine to start daily (or weekly) at a scheduled time, enter this command to run in a scheduled job: | ||
+ | |||
+ | < | ||
+ | SBMJOB CMD(STRIVWSRV IVWSRV(IVIEWSEVER) | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | (This is the iView 4.01 startup command). | ||
+ | |||
+ | Library iView must be in the library list of the job at start; consider creating a job description that contains iView library. | ||
+ | |||
+ | The user must have adequate authority; user QSECOFR is shown but is not required. | ||
+ | |||
+ | To end the iView subsystem use the ENDSBS command: | ||
+ | |||
+ | < | ||
+ | ENDSBS SBS(IVIEWSBS) OPTION(*CNTRLD) DELAY(600) | ||
+ | </ | ||
+ | |||
+ | This can be put in a scheduled job. The OPTION and DELAY parameters should be set as appropriate for the individual site. | ||
+ | |||
+ | If the above command does not work the typical cause of failure is the jobqueue. Check that the job queue is multithreaded and leads into a multithreaded batch subsystem. QS36EVOKE is multithreaded by default and leads into multithreaded subsystem QBATCH by default. On some systems sysadmins have changed the defaults or run with multiple copies of these. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Starting the Engine At IPL ==== | ||
+ | |||
+ | Some users want to start the iView engine at IPL. To do so, one must insert code into the i5's startup program. | ||
+ | |||
+ | **This work should be done by a qualified programmer.** | ||
+ | |||
+ | To determine the startup program, check the value of the system value QSTRUPPGM | ||
+ | |||
+ | < | ||
+ | dspsysval qstruppgm | ||
+ | </ | ||
+ | |||
+ | You must then find or retrieve the source to that program. You should then insert into the startup program __as late in the program as possible__ this code: | ||
+ | |||
+ | < | ||
+ | |||
+ | rmvlible fmg | ||
+ | monmsg CPF2104 | ||
+ | |||
+ | rmvlible iview | ||
+ | monmsg CPF2104 | ||
+ | |||
+ | addlible fmg *first | ||
+ | addlible iview *first | ||
+ | |||
+ | SBMJOB CMD(STRIVWSRV IVWSRV(IVIEWSEVER) | ||
+ | | ||
+ | | ||
+ | |||
+ | rmvlible fmg | ||
+ | rmvlible iview | ||
+ | |||
+ | </ | ||
+ | |||
+ | The user under which the iView subsystem is invoked must have adequate authority to run iView. | ||
+ | User QSYS, under which the startup program runs, must have authority to use the profile under which iView is invoked. | ||
+ | |||
+ | See the remarks on jobqueue under [[ iviewengines# | ||
+ | |||
+ | ===== Over Printing Removal ===== | ||
+ | |||
+ | In versions subsequent to iView 5.2 over printing removal can be enabled by setting data area DSRMVOV to Y, and disabled with a value of N. Enabling over printing removal removes over printing on the input spool file so that: | ||
+ | |||
+ | * The archived spool file does not have over printing. | ||
+ | * The spool file handed to iDocs for merge does not have over printing. | ||
+ | * The indices scraped for search values are scraped based on correct row/column locations. | ||
+ | |||
+ | |||
+ | |||
+ | ---- | ||
+ | < | ||
+ | |||
pub/iviewengines.txt · Last modified: 2022/06/25 17:02 by 127.0.0.1