'\" t
.\"
.\" Copyright (c) 2012 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMDATXMON 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdatxmon\f1،
\f3txrecord\f1،
\f3genload\f1 \- عامل دامنه معیارهای کارایی txmon (معروف به PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/txmon/pmdatxmon\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
\f2tx_type\f1 ...
.br
\f3$PCP_PMDAS_DIR/txmon/txrecord\f1
[\f3\-l\f1]
.br
\f3$PCP_PMDAS_DIR/txmon/txrecord\f1
\f2tx_type servtime\f1 [\f2tx_type servtime\f1 ... ]
.br
\f3$PCP_PMDAS_DIR/txmon/genload\f1
.SH "توضیحات (DESCRIPTION)"
برنامه
.B pmdatxmon
یک عامل دامنه معیارهای کارایی (PMDA) نمونه است که تعداد اندکی از معیارهای کارایی را از یک پایشگر تراکنش شبیه‌سازی‌شده استخراج کرده و ارائه می‌دهد.
.PP
عامل txmon PMDA هم به‌صورت باینری و هم کد منبع عرضه می‌شود و با این هدف طراحی شده که کمکی برای توسعه‌دهندگان PMDA باشد؛ این PMDA نشان می‌دهد که داده‌های کارایی چگونه می‌توانند از یک برنامه کاربردی (در اینجا
.BR txrecord )
از طریق یک قطعه حافظه اشتراکی به زیرساخت PCP صادر شوند. جهت آسودگی،
.B pmdatxmon
قطعه حافظه اشتراکی را ایجاد کرده (و هنگام خروج، آن را از بین می‌برد).
.PP
آرگومان‌های
.I tx_type
برچسب‌های یکتا و دلخواهی هستند که برای شناسایی انواع گوناگون تراکنش استفاده می‌شوند.
.PP
برنامه
.B txrecord
پردازش یک یا چند تراکنش شناسایی‌شده توسط
.I tx_type
و با زمان سرویس‌دهی مشاهده‌شدهٔ
.I servtime
را شبیه‌سازی می‌کند.
.PP
با گزینهٔ
.BR \-l ،
برنامه
.B txrecord
خلاصهٔ کنونی فعالیت‌های تراکنش را از قطعه حافظه اشتراکی نمایش می‌دهد.
.PP
اسکریپت
.B genload
یک اسکریپت شل و
.BR awk (1)
است که به عنوان رابطی برای
.B txrecord
عمل می‌کند تا باری ثابت از فعالیت‌های تراکنشی شبیه‌سازی‌شده ایجاد کند.
.PP
شرح کوتاهی از گزینه‌های خط فرمان
.B pmdatxmon
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره دامنه (
.IR domain )
معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد؛ بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمامی میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل گزارش (log). به‌طور پیش‌فرض، هنگام شروع
.BR pmdatxmon ،
یک فایل گزارش به نام
.I txmon.log
در دایرکتوری جاری
.BR pmcd (1)
یعنی
.B $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر ایجاد فایل گزارش ممکن نباشد یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد (stderr) نوشته می‌شود.
.TP 5
.B \-U
حساب کاربری که عامل باید تحت آن اجرا شود. پیش‌فرض در نسخه‌های کنونی PCP حساب بدون امتیاز «pcp» است، اما در نسخه‌های قدیمی‌تر به‌طور پیش‌فرض از حساب مدیر سیستم («root») استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی txmon دسترسی داشته باشید، مراحل زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/txmon
# ./Install
.in
.fi
.ft 1
.PP
برچسب‌های
.I tx_type
از شما پرسیده خواهد شد.
.PP
اگر مایل به بازگرداندن و لغو نصب هستید، مراحل زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/txmon
# ./Remove
.in
.fi
.ft 1
.PP
برنامه
.B pmdatxmon
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا شود. اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی
.B pmdatxmon
.TP
.B $PCP_PMDAS_DIR/txmon/help
فایل متن راهنمای پیش‌فرض برای معیارهای txmon
.TP
.B $PCP_PMDAS_DIR/txmon/Install
اسکریپت نصب برای عامل
.B pmdatxmon
.TP
.B $PCP_PMDAS_DIR/txmon/Remove
اسکریپت حذف و بازگردانی برای عامل
.B pmdatxmon
.TP
.B $PCP_LOG_DIR/pmcd/txmon.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و دیگر اطلاعات از
.B pmdatxmon
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های استفاده‌شده توسط PCP به کار می‌روند. در هر نصب، فایل
.B /etc/pcp.conf
شامل مقادیر محلی برای این متغیرهاست. متغیر
.B $PCP_CONF
می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینهٔ
.B \-D
یا
.B \-\-debug
خروجی پیام‌های تشخیصی اضافی را روی
.I stderr
فعال می‌کند تا به عیب‌یابی و تفکیک خطاها کمک کند، هرچند این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان به جای کاربران نهایی در نظر گرفته شده است.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ برای دریافت فهرستی از گزینه‌های اشکال‌زدایی در دسترس و معانی آن‌ها از
.BR pmdbg (1)
با گزینهٔ
.B \-l
استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی اختصاصی
.B pmdatxmon
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	عملیات‌های حافظه اشتراکی
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmdasample (1)،
.BR pmdatrivial (1)،
.BR txmonvis (1)
و
.BR PMDA (3).

.\" control lines for scripts/man-spell
.\" +ok+ genload servtime txmon txmonvis txrecord