set_kernel_memory_limit

The set_kernel_memory_limit command specifies a limit on the amount of kernel memory that SNAplus2 can use at any one time. This limit enables you to ensure that memory is available for other processes on the HP-UX computer.

You can also specify the kernel memory limit when starting the SNAplus2 software; for more information, refer to the HP-UX SNAplus2 Administration Guide. If any limit was specified when starting the SNAplus2 software, this command overrides that limit.

Supplied Parameters

Parameter name Type [set_kernel_memory_limit] limit decimal

Supplied parameter is:

limit

The maximum amount of kernel memory that SNAplus2 uses at any one time, in bytes. If a SNAplus2 component attempts to allocate kernel memory that would take the total amount of memory currently allocated above this limit, the allocation attempt will fail.

To remove the limit set by a previous set_kernel_memory_limit command, specify the value 0.

Returned Parameters

No parameters are returned by SNAplus2 when this command executes successfully.

Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

No parameter errors occur for this command.

State Check

No specific state errors, other than those listed in Appendix A “Common Return Codes from snapadmin Commands” occur for this command.

Other Conditions

Appendix A “Common Return Codes from snapadmin Commands” lists combinations of primary and secondary return codes that are common to all commands.