5.4.5 エージェント機能のパラメタ一覧及びファイル容量の見積もり(共通)

エージェント機能のすべての処理には,パラメタが関連付けられています。また,エージェント登録情報ファイル及びエージェント実行情報ファイルはパラメタで構成されています。したがってファイルの容量は,パラメタに設定する値を足した値になります。ここでは,エージェントのパラメタ一覧,及びファイル容量の見積もりについて説明します。

<この項の構成>
(1) エージェント機能のパラメタ一覧
(2) ファイル容量の見積もり

(1) エージェント機能のパラメタ一覧

エージェント機能に関連付けられているパラメタ一覧を,表5-3及び表5-4に示します。エージェント関連のコマンド,エージェントログ,及びエージェントのメッセージで表示されるパラメタを知る場合などに参照してください。パラメタは,エージェント登録情報(登録時の情報)とエージェント実行情報(実行時の情報)に分けて示しています。

表5-3 エージェント登録情報のパラメタ

パラメタ名説  明データの属性
AgtRegNameエージェント名最大64バイトの任意文字
AgtRegUser登録ユーザ情報ユーザID最大30バイトの任意文字
(ただし,両端に「"」ダブルクォーテーションを使用する場合は,最大32バイトの任意文字)
AgtRegPassパスワード
AgtRegGroup登録グループ情報ユーザID最大30バイトの英数字
AgtRegGPassパスワード
AgtRegDate登録日時日付
AgtRegTime時刻
AgtExeAuthエージェント実行権限
AgtRefAuthエージェント実行結果取得権限
AgtCommentコメント最大255バイトの任意文字
AgtConDBType接続先情報接続データベース種別
AgtConDBNameデータベース識別名
AgtConDBHost実行予約日時データベースホスト名
AgtRsvDate日付
AgtRsvTime時刻
AgtRsvDay曜日
AgtRsvRet繰り返し
AgtResWrite実行結果保存形態
AgtRegInParm可変実行条件
AgtSQLTextSQLテキスト
AgtHeaderTextヘッダテキスト
AgtRetNumリトライ情報リトライ回数(回)
AgtRetIntリトライ間隔(秒)
注※
次の文字はシステムの予約語のため使用できません。
「=」,「:」,「;」,「/」,「"」,「*」,「+」,「-」,「<」,「>」,「,」

表5-4 エージェント実行情報のパラメタ

パラメタ名説  明データの属性
AgtPriority優先度
AgtRegLimitエージェント存続期限
AgtResLimitエージェント実行結果の保存期限
AgtRegInfo登録時のインフォメーション
AgtExeNameエージェント実行名
AgtExeNoteメモ最大64バイトの任意文字
AgtExeUser実行ユーザ情報ユーザID最大30バイトの任意文字
AgtExePassパスワード(ただし,両端に「"」ダブルクォーテーションを使用する場合は,最大32バイトの任意文字)
AgtStatus実行状況状態
AgtExePID実行プロセスID
AgtErrMSGメッセージ
AgtExeSDate実行日時日付
AgtExeSTime時間
AgtRsvCDateカレントタイマ
実行待ち日時
日付
AgtRsvCTime時刻
AgtOutType実行結果情報出力先種別
AgtOutName出力名
AgtOutSize出力サイズ
AgtOutColCntカラム情報
AgtOutColSizeカラムサイズ
AgtOutRecCntレコード数
AgtOutRecSizeレコードサイズ
AgtExeInfo実行時のインフォメーション
AgtExeInParm可変実行条件
登録情報に従うパラメタその他のエージェント情報
注※
次の文字はシステムの予約語のため使用できません。
「=」,「:」,「;」,「/」,「"」,「*」,「+」,「-」,「<」,「>」,「,」

(2) ファイル容量の見積もり

エージェント登録情報ファイル及びエージェント実行情報ファイルは,次に示す概算式で容量を見積もります。概算式中のそれぞれの値は,表5-5及び表5-6に示すパラメタの見積もり値を使用して求めます。

概算式中の値は次のように求めます。求めるときには,表5-5,及び表5-6で示す値を使用してください。DABAGTは,DABroker動作環境定義ファイルのエージェント機能の使用で指定する作業ディレクトリです。DABroker動作環境定義ファイルについては,次の箇所を参照してください。

UNIXの場合:「3.4 DABrokerの動作環境の設定

Windowsの場合:「4.4 DABroker環境設定

[図データ]

表5-5 エージェント登録情報ファイルのパラメタ及び見積もり値

パラメタ名固定部(バイト)可変部可変部の範囲(バイト)見積もり長(バイト)
最大最小通常最大最小通常
AgtRegName14RN64120781534
AgtRegUser14RU3218461522
AgtRegPass14RP321846022
AgtRegGroup15RG321847023
AgtRegGPass15GP321847023
AgtRegDate1410101010242424
AgtRegTime148888222222
AgtExeAuth14222216016
AgtRefAuth14222216016
AgtComment14CM25518269022
AgtConDBType162222181818
AgtConDBName16DN255182711724
AgtConDBHost16DH255182711724
AgtRsvDate141010101024024
AgtRsvTime14555519019
AgtRsvDay13222215015
AgtRsvRet13222215015
AgtResWrite15222217017
AgtSQLText14ST32767150327811564
AgtRegInfo14RI25518269022
合計287 340245517934311143466
(凡例)
CM:コメント長
DH:データベースホスト名
DN:接続先データベース名称長
GP:グループパスワード
RI:登録インフォメーション長
RG:グループID
RN:エージェント登録名称長
RP:エージェント登録時のユーザパスワード長
RU:エージェント登録時のユーザID長
ST:SQLテキスト長
※:DABrokerが設定する項目
通常の値は,各可変名称及びSQLテキストは次の値で計算しています。
可変名称:8文字(エージェント名は2バイトコード10文字)
SQLテキスト:50バイト

表5-6 エージェント実行情報ファイルのパラメタ及び見積もり値

パラメタ名固定部(バイト)可変部可変部の範囲(バイト)見積もり長(バイト)
最大最小通常最大最小通常
AgtExeName1416161616303030
AgtExeNote14ET6412078034
AgtExeUser14EU3218461522
AgtExePass14EP321846022
AgtStatus131214312271625
AgtExePID134614191417
AgtErrMSG13051210525013
AgtExeSDate1510101010252525
AgtExeStime158888232323
AgtRsvCDate15CD10101025025
AgtRsvCTime15CT55520020
AgtOutType143333171717
AgtOutName14302551302691544
AgtOutSize14OS1014241518
AgtOutColCnt16CC1014261720
AgtOutColSize17CS1014271821
AgtOutRecCnt16RC1014261720
AgtOutRecSize17RS1014271821
AgtExeInfo14EI25518269022
合計277 1272671621549240439
(凡例)
CC:カラム情報数
CD:タイマ実行待ちの場合設定(10バイト固定)
CS:カラム情報サイズ
CT:エージェントタイマ実行待ちの場合設定(5バイト固定)
EI:実行インフォメーション
EP:エージェント実行時のユーザパスワード長
ET:メモ長
EU:エージェント実行時のユーザID長
OS:実行結果のサイズ(10進文字長)
RC:レコード情報数
RS:レコード情報サイズ
※:状況に応じてDABrokerが設定する項目
通常の値では,各可変名称及びシステム可変値は次の値で計算しています。
可変名称:8文字(メモは2バイトコード10文字)
システム可変値:平均長