Get application info

4D v18


Get application info -> 戻り値

引数	型	説明
戻り値	Object	アクティブなアプリケーションのアクティビティについての情報

説明

Get application info コマンドはアクティブなアプリケーションのアクティビティと、ネットワーク設定に関する詳細な情報を格納したオブジェクト型を返します。

コマンドはスタンドアロンとクライアント/サーバー環境、どちらで実行しているアプリケーション上でも実行することが可能です。返される情報は、Get application info が実行される場所に応じて変わります。例えば、リモートの4D 上で実行された場合、返される情報はリモートワークステーションに関する情報のみになります。コマンドがサーバーで実行されるメソッドで呼び出された場合には、返される情報はサーバーの情報が返されます。

返されるオブジェクト型には、以下のプロパティが格納されます:

プロパティ 型詳細例

volumeShadowCopyStatus

文字列

ボリューム・シャドウ・コピー・サービスのステータスを返します。Windowsのみ。詳細な情報については、Windows のボリュームシャドウコピーサービスを使用するを参照してください。

取り得る値:

定数	値	コメント
vss available	available	サービスは利用可能です。
vss error	error	サービスにエラーが発生しました。
vss not available	notAvailable	サービスは利用できません。
vss update required	updateRequired	サービスは更新が必要です。

"available"

launchedAsService ブールアプリケーションがサービスとして起動していた場合にはTrueを返します。取り得る値: True、false。詳細な情報については、データベースをサービスとして登録を参照してください。 false

portID 数値 4D Server: アクティブに聞いていているポート、4D remote: リモート接続のポート。スタンドアロン環境では返されません。最小値: 1。詳細な情報については、ポート番号を参照してください。 19814

TLSEnabled ブール TLS がクライアント/サーバー通信において有効化されている場合にはTrue を返します。スタンドアロン環境では返されません。取り得る: True、False。詳細な情報については、SSLプロトコルとクライアント/サーバ接続を参照してください。 true

newConnectionsAllowed ブール 4D Server のみ。新規接続が許可されている場合にはTrue。取り得る値: True、False。詳細な情報については、新規接続許可/拒否ボタンを参照してください。 true

cpuUsage(*) 数値 4Dによって使用されているプロセッサーの割合。Mac においては、1コアあたりの数値が表示されていて、プロセッサー全体の平均値を表します。 10.03

uptime 数値ローカルの4D データベースが開かれてからの経過時間(秒単位)。リモート接続に対しては、接続が開かれてからの経過時間を返します。 143

networkInputThroughput(*) 数値アプリケーションを実行しているマシンのネットワーク入力のデータ速度(バイト/秒)。リモートモードにおいては、リモートマシンの速度が返されます。詳細な情報についてはモニタページを参照してください。 37311495

networkOutputThroughput(*) 数値アプリケーションを実行しているマシンのネットワーク出力のデータ速度(バイト/秒)。リモートモードにおいては、リモートマシンの速度が返されます。詳細な情報についてはモニタページを参照してください。 88058023

useLegacyNetworkLayer ブールアプリケーションサーバーにおいて旧式ネットワークレイヤーが使用されている場合にはTrue。スタンドアロン環境では返されません。取り得る値: True、False。詳細な情報については、旧式ネットワークレイヤーの有効化または無効化を参照してください。 false

IPAddressesToListen コレクション 4D Server のみ。その4D Server が聞いているIPアドレスを返します。詳細な情報については、IP 設定を参照してください。 ["192.168.18.12","192.168.18.10"]

IPAddressesAllowDeny コレクション 4D Server のみ。データベース設定で受け取る、あるいは拒否されているIPアドレスのコレクションを返します。詳細な情報については、IP 設定を参照してください。 [{"mode": "allow", "ip": "192.168.*"},{...}]

[ ].mode 文字列 IPアドレスが許可されているかどうかを説明するプロパティです。取り得る値: "allow" あるいは "deny" "allow"

[ ].ip 文字列 IP アドレス "192.167.1.2"

(*) Windows 上では、例えばOn Startupデータベースメソッド内でGet application info コマンドを呼び出すなどして、カウンターを事前に初期化しておく必要があります。

例題

以下のコードを実行すると、実行中のアプリケーションについての情報を格納したオブジェクトが返されます:

 C_OBJECT($appInfo)

 $appInfo:=Get application info

コードがスタンドアロン環境で実行された場合、返されたオブジェクトには(一例として)以下のような情報が格納されています:


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "uptime": 469,
    "headless": false,
    "pid": 16500,
    "networkInputThroughput": 377263157,
    "networkOutputThroughput": 12345242236 
}

コードが4D リモートクライアントで実行された場合には、返されたオブジェクトには(一例として)以下のような情報が格納されています:


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 143,
    "headless": false,
    "pid": 1550,
    "useLegacyNetworkLayer": true,
    "networkInputThroughput": 268047058,
    "networkOutputThroughput": 12207686274 
}

コードが4D Server で実行された場合には、返されたオブジェクトには(一例として)以下のような情報が格納されています:


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.016125,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 192,
    "headless": false,
    "pid": 9560,
    "useLegacyNetworkLayer": true,
    "newConnectionsAllowed": true,
    "IPAddressesToListen": [
        "192.168.18.8",
        "192.168.18.7" 
    ],

      "IPAddressesAllowDeny": [
       {"mode": "allow", "ip": "192.168.*"},
       {"mode": "deny", "ip": "192.167.15.3"},
       {"mode": "allow", "ip": "192.167.1.2" }
    ],

    "networkInputThroughput": 149014925,
    "networkOutputThroughput": 80238805 
}

参照

Execute on server
Get database parameter
Get system info
REJECT NEW REMOTE CONNECTIONS