Using the WebQoS API wqsetproccls | HP WebQoS Software guide

Using the WebQoS API wq_set_proc_cls()

Table 2-8	wq_set_proc_cls() Error Codes

	Error Code	Description

	WQERR_NOTROOT	The process attempted to set the process group to
		a value that can only be accessed by root.

	WQERR_NOTREADY	PRM is not installed or not conﬁgured on the
		system.

	WQERR_OTHER	If error logging to syslog is enabled (“error” level
		for all facilities), the error is logged to a ﬁle.

	WQERR_PERMISSION	The process does not have permission to change
		to the speciﬁed process group. Make sure that the
		/etc/opt/webqos/svccls.allow ﬁle is
		conﬁgured and is not corrupt.

Multithreaded Applications

For HP-UX 10.20 (supports user-level threads only), all user-level threads within one process are in the same process group. wq_set_proc_cls() ignores scope and moves the entire process to the speciﬁed process group.

For HP-UX 11.0 (supports 1x1 kernel threads), a thread in user space corresponds to a kernel thread (also known as a Light Weight Process, LWP). LWPs may belong to different process groups. Currently, WebQoS cannot move a thread from one process group to another. Therefore, all threads in a process are in the same process group. Set scope to WQ_SCOPE_PROCESS to move all threads in a process to the speciﬁed process group.

This function is NOT thread safe. Although it can be called from a multithreaded process, the application must ensure that the function is not called by more than one thread at a time.

Example

See Appendix A , “Sample Programs, Conﬁguration, and Header Files,” on page 33 for an example.

Chapter 2