PI_PTS

Ops Center Analyzer REST API Reference Guide
Version
11.0.x
Audience
anonymous
Part Number
MK-99ANA003-18

The PI_PTS record stores the performance data indicating the read and write status of each port of the storage system. This is a multi-instance record.

Collection Interval

Note that if you are monitoring a VSP 5000 series storage system and the Access Type is 3 or 4, you cannot collect performance information about mainframe systems.

Note:

The items in (1) and (2) below all have the same field name (PORT_NUMBER), but the values output to the items in (1) are different from those output to the items in (2).

  1. the PORT_NUMBER field of the PD_PTC record or the PI_PTS record
  2. the PORT_NUMBER field of the PI_MPTS record or the PI_PTSX record

For this reason, if you want to check whether the port information of one record matches that of another, check the PORT_NAME field.

60

Key Field

PORT_NUMBER

Lifetime

From when the port is set up to when it is removed.

Fields

Field Name

Description

 Access Type

Format

AVG_IO_RATE1

Average frequency of read and write operations for the storage system port (number of times per second).

 1, 2, 3, 4

float

AVG_XFER_RATE1

Average read and write transfer speed for the storage system port (MB per second).

 1, 2, 3, 4

float

CHA_NAME

Name of the channel adapter or channel board.

 1, 2, 3, 4

string(16)

INITIATOR_AVG_IO_RATE3

Average frequency of read and write operations for the storage system port (number of times per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_AVG_XFER_RATE3

Average read and write transfer speed for the storage system port (MB per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_MAX_IO_RATE3, 4

Maximum frequency of read and write operations for the storage system port (number of times per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_MAX_XFER_RATE3, 4

Maximum read and write transfer speed for the storage system port (MB per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_MIN_IO_RATE3, 4

Minimum frequency of read and write operations for the storage system port (number of times per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_MIN_XFER_RATE3, 4

Minimum read and write transfer speed for the storage system port (MB per second) (total number of initiator and external ports).2

 1, 2

float

INITIATOR_TOTAL_IO_COUNT

This field cannot be used because it is reserved.

 --

--

INITIATOR_TOTAL_MBYTES

This field cannot be used because it is reserved.

 --

--

INPUT_RECORD_TYPE

Record type identifier, which is always set to PTS.

 1, 2, 3, 4

string(8)

INTERVAL

Interval (in seconds) at which information is collected.

 1, 2, 3, 4

ulong

MAX_IO_RATE1, 4, 5

Maximum frequency of read and write operations for the storage system port (number of times per second).

 1, 2, 3, 4

float

MAX_XFER_RATE1, 4, 5

Maximum read and write transfer speed for the storage system port (MB per second).

 1, 2, 3, 4

float

MIN_IO_RATE1, 4

Minimum frequency of read and write operations for the storage system port (number of times per second).

 1, 2

float

MIN_XFER_RATE1, 4

Minimum read and write transfer speed for the storage system port (MB per second).

 1, 2

float

PORT_NAME

Name of the storage system port.

 1, 2, 3, 4

string(64)

PORT_NUMBER

Number of the storage system port.

 1, 2, 3, 4

string(8)

PORT_ROLE
The role which assigned to this port:
  • Target
  • Initiator
  • RCU Target
  • External
  • Bidirectional
  • (Null string) : If the port type is FICON
 1, 2

string(16)

READ_IO_COUNT

This field cannot be used because it is reserved.

 --

--

READ_IO_RATE

This field cannot be used because it is reserved.

 --

--

READ_MBYTES

This field cannot be used because it is reserved.

 --

--

READ_RESPONSE_RATE

This field cannot be used because it is reserved.

 --

--

READ_TOTAL_RESPONSE

This field cannot be used because it is reserved.

 --

--

READ_XFER_RATE

This field cannot be used because it is reserved.

 --

--

RECORD_TIME

Time (in GMT) at which data was collected from the storage system and the record was created.

 1, 2, 3, 4

time_t

TOTAL_IO_COUNT

This field cannot be used because it is reserved.

 --

--

TOTAL_MBYTES

This field cannot be used because it is reserved.

 --

--

WRITE_IO_COUNT

This field cannot be used because it is reserved.

 --

--

WRITE_IO_RATE

This field cannot be used because it is reserved.

 --

--

WRITE_MBYTES

This field cannot be used because it is reserved.

 --

--

WRITE_RESPONSE_RATE

This field cannot be used because it is reserved.

 --

--

WRITE_TOTAL_RESPONSE

This field cannot be used because it is reserved.

 --

--

WRITE_XFER_RATE

This field cannot be used because it is reserved.

 --

--

Notes:

  1. If the port type is ESCON or FICON, this value can be collected only for when the storage system is VSP 5000 series, VSP G1000 (80-03 or later), G1500, or VSP F1500.
  2. If the value of the PORT_ROLE field is not Bidirectional, the value will be 0.
  3. If the storage system is VSP G1000, G1500, or VSP F1500, the value cannot be collected.
  4. If the value set for Collection Interval is greater than 60, the value will be an average value.
  5. If the Access Type is 3 or 4, the value will be an average value.