IBM i Job Queue is not working, verify that it is started, check for errors

Follow

Issue 

Zend Job Queue is not working.  PHP scripts may return a message similar to this:

Unable to connect socket to /usr/local/zendsvr6/tmp/jobqueue.sock . No such file or directory

Or there may be no message at all.  This article tells how to verify the Job Queue is running and check for errors.

Environment

Zend Server 6 or 7 running on any version of IBM i.

Resolution

In the Zend Server administrative interface in your web browser, at address http://<your IBMi ip address>:10081 , please navigate to the Configurations -> Components tab. Find Zend Job Queue on the list. Check the status. By default, the Zend Job Queue status should be 'Loaded'.

If the status is 'Off', please check the check box on the left to select Zend Job Queue, and then click the 'Enable' button. When prompted to restart Zend Server, please click the 'Restart' icon to complete the task. The 'Restart' icon is in the uper right, and looks like a couple of arrows chasing each other around in a circle. Please note that 'Restart' will stop and restart Apache, so for a couple of minutes your web site will be unavailable. So, consider scheduling this task for a time when usage is low.

If the status is 'Error', please check the messages field to see what further action needs to be taken.

Common situations that may prevent successful start up follow:

Step 1. Zend Server needs to be restarted (see above for instructions on using the 'Restart' icon).

Step 2. The license is for Zend Server Basic, or the license is expired. The Job Queue requires a current Zend Server license for the Professional, Enterprise, or Developer edition. To learn more about the differences between Zend Server for IBM i editions, please visit this web page:

Zend Server for IBM i Editions Chart

To obtain a license for Zend Server, please contact your Zend Account Manager.

Step 3. The Zend Job Queue daemon job needs to be started on the IBM i. From the 5250 command line:

 WRKACTJOB SBS(ZENDSVR6) 

Check for two entries on the 'Work with Active Jobs' display that look like this:

ZSJOBQMNG    QTMHHTTP    BCI      .0  PGM-watchdog   ZSJOBQMNG    QTMHHTTP    BCI      .0  PGM-jqd   

If they are missing, please go to the Zend Server for IBM i Service Menu:

 GO ZENDSVR6/ZSVMENU 

Then use option '13. Job Queue Management Menu'. Then use option '1. Start Job Queue'.

Return to the 'Work with Active Jobs' display to verify that the Job Queue daemon jobs have started.

Step 4. By default, the Job Queue daemon is set up to start automatically any time the ZENDSVR subsystem is started.

To control which Zend Server daemons start up when the ZENDSVR subsystem is started, please make sure ZENDSVR6 is in your library list, and then run this command:

 ZSAUTOJOB 

This command displays the following screen:

                       Autostart Job Settings (ZSAUTOJOB)

Type choices, press Enter.

Monitor daemon (Y/N) . . . . . . > Y
Java Bridge daemon (Y/N) . . . . > N
Job Queue daemon (Y/N) . . . . . > Y
Deployment daemon (Y/N) . . . . > Y
Prngd daemon (Y/N) . . . . . . . > N
Zend Server Daemon (Y/N) . . . . > Y

Flag services that are desired to start up automatically with a 'Y'. Flag services that are not desired to start up automatically with an 'N'. Please make sure that the Job Queue daemon is flagged 'Y'. Press enter for changes to take effect.

After using ZSAUTOJOB, please run this command:

 CHGDTAARA DTAARA(ZENDSVR6/ZAUTOJOB (7 1)) VALUE('1') 

Step 5. If none of the above steps resolve the issue, please run the Support Tool and send the output to us. This article tells how:

How to run the Support Tool on IBM i

Have more questions? Submit a request

Comments

Powered by Zendesk