QUERY WORKER Command

Displays a list of VM:Webgateway worker machines and their current status.

You can use the CONFIG WORKER command to add and delete worker machines.

Syntax

 QUERY WORKER [* | userid | status] 

Parameters/Options

[* | userid | status]

Specifies the worker machine or status for which you want to display information:

• Specify an asterisk to display information, sorted by userid, for all defined worker machines. This is the default.
• To display status information for a specific worker machine, specify its userid. You cannot use pattern-matching for the userid.
• To display information, sorted by userid, for those worker machines that have a specific status, specify one of the following status values:

   Status Value   Displays information for...
   ------------   ---------------------------
   ACTIVE         All workers with a current
                  status of ACTIVE          
   AVAILABLE      All workers with a current
                  status of AVAILABLE,      
                  regardless of whether     
                  the worker is logged on   
                  or not                    
   ERROR          All workers with a current
                  status of ERROR           
   NEXTAVAIL      The next worker           
                  VM:Webgateway will
                  allocate to run a CGI     
                  program or filter         
   UNAVAILABLE    All workers with a current
                  status of UNAVAILABLE 

Examples

• To display the status of all workers, enter this command from your VM userid:

  vmwebsrv query worker *

  VM:Webgateway responds:

   Userid    State       Status
   --------  ----------  ---------------
   VIWWRK01  LOGGED ON   DRAINING
   VIWWRK02  LOGGED ON   AVAILABLE
   VIWWRK03  LOGGED ON   ACTIVE
   VIWWRK04  LOGGED OFF  AVAILABLE
   VIWWRK05  LOGGED OFF  UNAVAILABLE
   VIWWRK06  LOGGED OFF  ERROR
   VIWWRK07  LOGGED ON   FORCING
   VIWWRK08  LOGGED OFF  FORCING
   

• To display the workers that have a current status of AVAILABLE, enter the following command from the VM:Webgateway service virtual machine:

  query worker available

  VM:Webgateway responds:

   Userid    State       Status
   --------  ----------  ---------------
   VIWWRK02  LOGGED ON   AVAILABLE
   VIWWRK04  LOGGED OFF  AVAILABLE