Visit Azul.com Support

zing-ps Command-Line Options

Looking for Zing? The Azul Zing Virtual Machine is now Azul Zulu Prime Builds of OpenJDK and part of Azul Platform Prime. Learn more.

The memory management functions of the Azul Zulu Prime System Tools (ZST) are performed automatically when a Azul Zulu Prime Builds of OpenJDK (Azul Zulu Prime JVM) instance runs a Java application. The zing-ps command returns a snapshot of current Azul Zulu Prime JVM memory usage. It displays information about active Azul Zulu Prime JVM processes, system behavior, and Azul Zulu Prime JVM memory usage.

zing-ps is installed automatically when ZST is installed. It is run from the command line. Use this command before you install, update, or restart the ZST or modify the ZST configuration.

This tool does not collect history. To collect zing-ps information over time, use a while loop to run the zing-ps command at specified time increments, for example every 10 seconds, and log the data generated. Then use the logged data in a numbers-to-graph tool, such as Excel to generate graphs.

For quick reference, at the command line, type:

 $ zing-ps --help 

The zing-ps command usage is:

 usage: azps [-s] [-o] [-b] [-m] [-h] [-p pid] [-d] [-e] [-x] [-c] [-n] [-a] [-j] [-l] [--comma] [-partition P] [-f] [-V] [-zpv] 

Where –

Command Description

-s

Print the memory summary.

-o

Print the overall upper limit for reserve-at-launch partitions. -o used without -s prints only overall upper limit information. -o used with -s adds overall upper limit to the memory summary.

Units:

-b

Print values in units of bytes.

-m

Round byte values to megabytes.

-h

Round byte values to multiples of powers of 1024 and print suffix.

Process information:

-p [PID]

Print info about specific process.

-d

Suppress printing of per process detail.

Best effort account information:

-e

Print details about best effort account.

Select fields, information and format to print:

-x

Print extended process detail.

-c

Print only the command.

-n

Print only the name from the command.

-a

Print the arguments following the command.

-j

Print selected portions of the command.

-l

Print the legend.

--comma

Comma separated tabular format.

Memory information:

-partition P

Print memory accounting information for Partition P, where P is a partition number between 0 and 15.

-f

Suppress printing of memory information.

Version information:

-V

Print the ZST version.

-zpv

Print the zing-ps version.

Some options are mutually exclusive. Many options can be used in combination. See Format Command Option Samples for listing of mutually exclusive options.