A new DC extended statistics section has been introduced to record CPU times in the Time of Day (TOD) format. This section has been added to the following DSECTs:
DC extended statistics consist of the following fields, as described by the #STBDS DSECT.
* * DC Extended stats * DS 2F TSBBEG DS 0D BEGINNING OF DC EXTENDED STATS TSBSYTI DS D System mode TCB CPU time in TOD TSBCPTI DS D System mode zIIP time on CP in TOD TSBZPTI DS D System mode zIIP time in TOD TSBUSTI DS D User mode time in TOD TSBTTTI DS D Total TCB CPU time in TOD TSBENTI DS D Total SRB CPU time in TOD DS 14D Reserved * * Total System mode CPU time is defined as: TSBSYTI + TSBENTI * * TSBTTTI = TSBSYTI + TSBUSTI * * SMF Non-Billable system mode time = TSBCPTI + TSBZPTI * TSBXEND DS 0D END OF DC EXTENDED STATS TSBDXLEN EQU *-TSB LENGTH OF DSECT.
Assembler application programs can retrieve these statistics for the current DC transaction by specifying a new LENGTH parameter on the #TRNSTAT macro.
COBOL and PL/I application programs can retrieve this information by specifying a new LENGTH parameter on an ACCEPT TRANSACTION STATISTICS or END TRANSACTION STATISTICS statement.
The default length for all languages is the length of the statistics returned in prior releases so that existing programs remain upwardly compatible. Existing programs will continue to use the shorter length, even if re-compiled. To retrieve all statistics including the new DC extended statistics, a program must specify a length of 560.
To facilitate use of these statistics in COBOL and PL/I applications, CA IDMS provides a new TRANSACTION-STATISTICS record definition describing the format of the information returned by ACCEPT and END TRANSACTION STATISTICS statements. You add this record description to a dictionary using the DLODPROT source member provided during installation.
The new LENGTH parameter of the #TRNSTAT DML statement enables a program to retrieve extended statistics about task-related activities.
The following diagram shows the syntax placement and values for the new LEN parameter.
►►─ #TRNSTAT ─ … ─┬──────────────────────────┬─── … ───────────────────►◄
└─ ,LEN= ─┬─ 388 ◄───────┬─┘
└─ tsb-length ─┘
This section describes the new parameter for the #TRNSTAT Assembler statement
(#TRNSTAT TYPE=ACCEPT or END requests only)
Specifies the length of the TSB to be returned to the location identified by the RECORD parameter. If LEN= is not specified, the first 388 bytes of the TSB are returned.
Specifies a register containing the length of the TSB to return; an absolute expression or a half word or full word field containing the length. The length must be an integer with a value of 388 or greater.
The new LENGTH parameter of the ACCEPT TRANSACTION STATISTICS DML statement enables a program to retrieve extended statistics about task-related activities.
The following diagram shows the syntax placement and values for the new LENGTH parameter.
►►─ ACCEPT TRANSACTION STATISTICS ─ … ─────────────────────────────────► ►─┬────────────────────────────┬──────────────────────────────────────►◄ └─ LENGTH= ─┬─ 388 ◄───────┬─┘ └─ tsb-length ─┘
This section describes the new parameter for the ACCEPT TRANSACTION STATISTICS DML statement.
Specifies the length of the TSB to be returned to the location identified by the INTO parameter.
Specifies either the symbolic name of a user-defined field that contains the length to be returned or the length expressed as a numeric constant. The length must be an integer with a value of 388 or greater.
By default, if you do not specify a tsb-length, the first 388 bytes of the TSB are returned.
The new LENGTH parameter of the END TRANSACTION STATISTICS DML statement enables a program to retrieve extended statistics about task-related activities
The following diagram shows the syntax placement and values for the new LENGTH parameter.
►►─ END TRANSACTION STATISTICS ─ … ────────────────────────────────────► ►─┬────────────────────────────┬──────────────────────────────────────►◄ └─ LENGTH= ─┬─ 388 ◄───────┬─┘ └─ tsb-length ─┘
This section describes the new parameter for the END TRANSACTION STATISTICS DML statement.
Specifies the length of the TSB to be returned to the location identified by the INTO parameter.
Specifies either the symbolic name of a user-defined field that contains the length to be returned, or the length expressed as a numeric constant. The length must be an integer with a value of 388 or greater.
By default, if you do not specify a tsb-length, the first 388 bytes of the TSB are returned.
|
Copyright © 2010 CA.
All rights reserved.
|
|