Print Queue Monitor Test

This test continuously monitors the AIX print queues and reports the number of queues in different states.

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick the desired Component type, set Performance as the Test type, choose the test from the DISABLED TESTS list, and click on the << button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : Any host system

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each host monitored.

Configurable parameters for the test
Parameter	Description
Test Period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	Refers to the port at which the specified host listens to. By default, this is NULL.
Sudo CMD	By default, the Sudo CMD parameter is set to none. This indicates that, by default, this test will report the metrics pertaining to performance of the print queues by executing the /usr/bin/ipstat command. However, in highly secure environments, the eG agent install user will not have permission to execute this command directly. In such cases, do the following: Edit the sudoers file on the target host and append an entry of the following format to it: <eG_agent_install_user> ALL=(ALL) NOPASSWD:<Command> For instance, if the eG agent install user is eguser, then the entry in the sudoers file should be: eguser ALL=(ALL) NOPASSWD: lpstat Finally, save the file. Then, when configuring the test, specify the value sudo for this parameter. This will enable the eG agent to execute the sudo/usr/bin/ipstat command and pull metrics.
Lpstat path	By default, this parameter is set to none indicating that the eG agent will run the lpstat command in its default location (/usr/bin) of the target host and collect metrics. However, if the lpstat command is available in the different location in your environment, you will have to explicitly specify the full path to the lpstat command in this text box.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Ready state	Indicates the number of queues that are currently ready to accept new jobs.	Number
Running state	Indicates the number of queues that are currently executing the jobs.	Number	The detailed diagnosis of this measure reveals the details on the name of the print queue, the job number, the names of the files to be printed, name of the user who submitted the print jobs, the number of pages that were printed, the percentage of jobs that were completed, the number of thousand-bytes blocks in the file to be printed, the number of copies of the files to be printed and the order in which the print jobs are in the queue.
Waiting state	Indicates the number of queues that are waiting to executing the jobs.	Number	The queues move to the waiting state when the printer is unable to continue printing due to insufficient papers, offline, jammed, or wiring problems.
Down state	Indicates the number of queues in the down state.	Number	In the down state, queues will accept the print jobs, but the jobs will not be processed until the queue is up. Once the queue is up, the received jobs will be executed in order. The detailed diagnosis of this measure reveals the name of the print queue and the name of the printer device.
Initialize state	Indicates the number of queues that are currently initializing.	Number	A high value for measure could indicate that many queues are currently experiencing initialization problems.
Sending state	Indicates the number of queues that are currently sending data to a remote host using the rembak command, socket program or MarkNet software.	Number
Gethost state	Indicates the number of queues in the Gethost state.	Number	In the Gethost state, the queues will be in the process of determining the requests from the external servers.
Connect state	Indicates the number of queues in the connect state.	Number	In the Connect state, the queues will be in the process of establishing connections with a remote server.
Busy state	Indicates the number of queues in the busy state.	Number
Queued state	Indicates the number of queues in the Queued state.	Number	Queued state is reported when the new job is assigned to the queue but the queue is busy in printing the another job. The detailed diagnosis of this measure reveals the details on the name of the print queue, the job number, the names of the files to be printed, name of the user who submitted the print jobs, the number of pages that were printed, the percentage of jobs that were completed, the number of thousand-bytes blocks in the file to be printed, the number of copies of the files to be printed and the order in which the print jobs are in the queue.
Other state	Indicates the number of queues in other state.	Number	The detailed diagnosis of this measure reveals the details on the name of the print queue, the job number, the names of the files to be printed, name of the user who submitted the print jobs, the number of pages that were printed, the percentage of jobs that were completed, the number of thousand-bytes blocks in the file to be printed, the number of copies of the files to be printed and the order in which the print jobs are in the queue.