15.10 - Miscellaneous Housekeeping Columns - Teradata Database

Teradata Database Resource Usage Macros and Tables

Product
Teradata Database
Release Number
15.10
Published
April 2016
Language
English (United States)
Last Update
2018-05-17
dita:mapPath
Resource_Usage_Macros_15_10.ditamap
dita:ditavalPath
ft:empty

These columns provide statistics on current logging characteristics.

Column Name Mode Description Data Type
GmtTime n/a Greenwich Mean Time is not affected by the Daylight Savings Time adjustments that occur twice a year. FLOAT
NodeType n/a Type of node, representing the per node system family type. CHAR(8)
PPId n/a
  • On SLES 10 or earlier systems, this column identifies the performance period. The PPId is a mapping of the internal performance period value (ranges 0 to 7) to a RSS value (ranges 0 to 1). A PPId of 0 maps to the value 0, and the PPId of 1 maps to the values 1 through 7.
  • On SLES 11 or later systems, this column is not valid and returns a zero value.
BYTEINT
VprType n/a Type of vproc (for example, AMP, PE, and MISC). Rows reported as vproc type of MISC contain data for all vproc types other than the AMP and PE vproc types. CHAR(4)
AMPCount n/a Number of AMPs on the Node. AMPCount is used to divide columns that are reporting data from all the AMPs. This allows the ResSpsView view to report the data columns on a per AMP basis. SMALLINT
RowIndex1 n/a
  • On SLES 10 or earlier systems, this column contains the PGId.

    The PGId identifies the PG. There is a one to one mapping between a PG ID and a WD ID at any point in time.

    The mapping between PG ID and WD ID can be determined by looking at the Teradata Viewpoint Workload Designer portlet.

    The PG ID value ranges from 0 to 250, while the value of a WD ID is not in a specific range (that is, the value is incremented and not reused).

  • On SLES 11 or later systems, this column contains the pWDid. The pWDid value ranges from 0 to 255.

    When running SLES 11 or later systems in the ResPs macro outputs, the RowIndex1 column displays as PGid, instead of pWDid. For sample outputs of the ResPs macros, see Resource Usage Macros.

SMALLINT
WDId track WD ID.

The default PGs (System, L, M, H, R) have no associated WD and will have a WDID of zero in the table. Only PGs with a name that has “PGWL” (SLES 10) or “TDWMWD” (SLES 11 or higher) in it have a nonzero WDID.

Resource usages of the workload definition (WD) to which a job instance was assigned can be obtained by joining the DBC.DBQLUtilityTbl table and DBC.ResSPSView on the WDID column for the duration of the job instance.

The example below calculates the sums of IOTA (I/O token allocation) columns.

SELECT SUM(FullPotentialIota), SUM(CodPotentialIota), SUM(UsedIota)
FROM DBC.ResSpsView S,
     DBC.DBQLUtilityTbl U
WHERE S.WDID = U.WDID
  AND U.UtilityName = 'MULTLOAD'
  AND U.UserName = 'USER1'
  AND U.JobEndTime = TIMESTAMP '2013-04-19 16:48:14.98'
  AND S.TheDate >= CAST(Phase1StartTime AS DATE)
  AND S.TheTime >= ((EXTRACT(HOUR FROM Phase1StartTime) * 10000) +
                    (EXTRACT(MINUTE FROM Phase1StartTime) * 100) +
                    (EXTRACT(SECOND FROM Phase1StartTime)))
  AND S.TheDate <= CAST(Phase2EndTime AS DATE)
  AND S.TheTime <= ((EXTRACT(HOUR FROM Phase2EndTime) * 10000) +
                    (EXTRACT(MINUTE FROM Phase2EndTime) * 100) +
                    (EXTRACT(SECOND FROM Phase2EndTime)));
FLOAT
Secs n/a Actual number of seconds in the log period represented by this row. Normally, this value is the same as NominalSecs, but can be different in three cases:
  • The first interval after a log rate change
  • A sample logged late because of load on the system
  • System clock adjustments affect reported Secs

Useful for normalizing the count statistics contained in this row, for example, to a per-second measurement.

SMALLINT
CentiSecs n/a Number of centiseconds in the logging period. This column is useful when performing data calculations with small elapsed times where the difference between centisecond-based data and whole seconds results in a percentage error. INTEGER
NominalSecs n/a Specified or nominal number of seconds in the logging period. SMALLINT
NCPUs n/a Number of CPUs on this node.

This column is useful for normalizing the CPU utilization column values for the number of CPUs on the node. This is especially important in coexistence systems where the number of CPUs can vary across system nodes.

SMALLINT
Active max Controls whether or not the rows will be logged to the resource usage tables when Active Row Filter Mode is enabled.

If Active is set to a non-zero value, the row contains data columns.

If Active is set to a zero value, none of the data columns in the row have been updated during the logging period.

FLOAT
TheTimestamp n/a Number of seconds since midnight, January 1, 1970.

This column is useful for aligning data with the DBQL log.

BIGINT
PM_CPU_COD n/a Platform Metering CPU COD value in one tenths of percent. For example, a value of 500 represents a PM CPU COD value of 50%.

The value is set to 1000 if the PM CPU COD is disabled.

SMALLINT
WM_CPU_COD n/a Workload Management CPU COD value in one tenths of a percent. For example, a value of 500 represents a WM CPU COD value of 50.0%.

The value is set to 1000 if the WM CPU COD is disabled.

WM CPU COD is not supported on SLES 10. Its value is set to 1000 on SLES 10.
SMALLINT
PM_IO_COD n/a Platform Metering I/O COD value in whole percent values for the entire system. For example, a value of 50 represents a PM I/O COD value of 50%.

The value is set to 100 if the PM I/O COD is disabled.

SMALLINT
WM_IO_COD n/a Workload Management I/O COD value in whole percent. For example, a value of 50 represents a WM I/O COD value of 50.0%.

The value is set to 100 if the WM I/O COD is disabled.

WM I/O COD is not supported on SLES 10. Its value is set to 100 on SLES 10.
SMALLINT
VPId track Virtual partition ID.

Only one VpId is associated with a pWDid and VprType row at any point in time. There can be multiple pWDid values associated with a VPId.

This column is valid on SLES 11 or later systems only.
FLOAT