|
|
|
The USERACCT command is used to start and stop NCL CPU-time accounting. It is also used to set the SMF record ID, and parameters controlling the timing and level of SMF reporting. Some of these parameters affect the time interval and start time of SMF report generation, so they can only be set if NCL CPU-time reporting status is inactive.
This command has the following format:
USERACCT START
[ SMFRECID=smf_record_id ]
[ INTERVAL=hours_between_smf_records
[ FROM=start_time_for_first_report ]
[ MINCPU=minimum_cpu_time_to_report ] ]
USERACCT SET
[ SMFRECID=smf_record_id ]
[ INTERVAL=hours_between_smf_records
[ FROM=start_time_for_first_report ]
[ MINCPU=minimum_cpu_time_to_report ] ]
USERACCT STOP
Activates NCL CPU-time reporting. This operand controls whether SMF reports on the statistics are generated. The actual accumulation of CPU-time statistics occurs independently of the reporting process, thus CPU-time statistics are collected irrespective of whether reporting is active or inactive.
This operand is accepted only if reporting is currently inactive.
Specifies the SMF record ID to be used on SMF records that contain NCL accounting information. It is effective immediately after the command is issued, so the next record generated uses this smf-record-id value.
Default: The default SMF record ID, as specified in the SMF parameter group (enter /PARMS). (If there is no default SMF record ID and this operand is not specified, the reporting thread fails with an invalid record ID message.)
Limits: 128 through 255
Specifies the number of hours between the generations of SMF records. This operand is only allowed if NCL CPU-time reporting is inactive at the time the command is entered.
Default: 24
Limits: 0, 1, 2, 3, 4, 6, 12, and 24 (0 is equal to 24)
Specifies the base time for the calculation of intervals. The default if this operand is not entered is 00.00.00 (midnight). The time that the first SMF record is generated is calculated by adding the hours-between-smf-records value to the start-time-for-first-report value.
For example, if the hours-between-smf-records value is 4 hours, and the start-time-for-first-report value is 01.10.00 (1.10 am), and the command is entered at 08.00.00 (8.00 am), then the next report will be at 09.10.00 (9.10 am). This is because, using the base time and interval, record generation occurs at 1.10, 5.10, 9.10, 13.10, 17.10, 21.10, and 1.10 again. So, if the command is entered at 8.00 am, the next report is due at 9.10 am.
Specifies the minimum amount of CPU-time that must have been accumulated since a report was last generated for a user, before another report is generated for that user. It is effective immediately after the command is issued, and is applied on the next report.
Default: 0
Limits: CPU seconds with up to 2 decimal places (for example, 1.25 seconds).
Modifies the NCL CPU-time reporting parameters. It can be specified whether CPU-time reporting is active or inactive; however, the FROM and INTERVAL operands are accepted only when CPU-time reporting is inactive.
Stops user NCL CPU-time reporting. This operand controls whether SMF reports on the statistics are generated. The actual accumulation of user CPU-time statistics occurs independently of the reporting process, thus CPU-time statistics are collected irrespective of whether reporting is active or inactive.
This operand is accepted only if reporting is currently active. No other operands are valid in conjunction with STOP.
Note: NCL CPU-time accounting occurs independently of the report generation process. A CPU-time report for a user contains a field which shows the time at which the last report for that user was generated.
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |