# Compaq OpenVMS
DCL ディクショナリ

前へ | 次へ | 目次 | 索引

# F$GETENV (Alpha のみ)

> 指定されたコンソール環境変数の値を戻します。

## 形式

> F$GETENV (項目リスト)

## 戻り値

指定されたコンソール環境変数の値を戻します。システムがコンソール・モードである場合，ユーザはコンソール環境変数を修正することができます。このレキシカル関数を使用することで，システムが稼動中に変数の内容を読み取ることができます。

## 引数

> ### 項目リスト

> 定義されているコンソール環境変数名は次のとおりです。

> Auto_action, Boot_dev, Bootdef_dev, Booted_dev, Boot_file, Booted_file, Boot_osflags, Booted_osflags, Boot_reset, Dump_dev, Enable_audit, License, Char_set, Language, Tty_dev

## 説明

> 指定されたコンソール環境変数の値を戻します。

##

### 例

#1
    $ dump_device = f$getenv("dump_dev")
    $ write sys$output "The dump device for this system is ", dump_device

> この関数は，システムのダンプ装置を表示します。

# F$GETJPI

> $GETJPI システム・サービスを呼出し，指定されたプロセスに関する情報を戻します。

> 同じグループ内の他のプロセスに関する情報を得るためには， GROUP 特権が必要です。システム内の他のプロセスに関する情報を得るためには，WORLD 特権が必要です。

## 形式

> F$GETJPI (pid，項目)

## 戻り値

要求する項目に応じて，整数または文字列となります。各項目に戻される値のデータ・タイプを 表 DCLI-7 に示します。

## 引数

> ### pid

> 情報が戻されるプロセスの識別番号。プロセス識別の値（pid）は文字列式として指定します。 pid 引数を指定する場合，先行する 0 は省略できます。

> 空文字列を指定すると，現在のプロセスに対する操作となります。

> $GETJPI システム・サービスでは pid 引数にワイルドカード文字を使用できますが， F$GETJPI 関数では使用できません。プロセスの識別番号の一覧を得るには，F$PID 関数を使用します。

> ### 項目

> 戻されるプロセス情報のタイプ。文字列式として指定します。 表 DCLI-7 の項目から 1 項目を指定します。

## 説明

> $GETJPI システム・サービスを呼び出し，指定したプロセスの情報を戻します。 $GETJPI システム・サービスで指定することができる，すべての項目の情報を戻します。 $GETJPI システム・サービスについての詳細は『OpenVMS System Services Reference Manual』を参照してください。

> ターゲット・プロセスが中断されている，または MWAIT (資源待ち) 状態の場合， F$GETJPI レキシカル関数は，ゼロまたは空文字列を戻します。また，要求された項目は，プロセスの仮想アドレス空間に格納されます。

> F$GETJPI 関数を使用すると，プロセスが自動的にファイルをアンシェルブするかどうかが分かります。

> STS2 項目コードを指定すると, F$GETJPI は 32 ビットの数値を戻します。この数値を 2 進形式に変換すると，シンボル・ビット位置 PCB$V_NOUNSHELVE の数字により，省略時の設定でアンシェルブするかどうかが分かります。このビットが 1 であれば，自動アンシェルブはオフになり，このビットが 0 であれば，自動アンシェルブがオンになります。

> F$GETJPI 関数に指定する項目, 戻される情報, およびその情報のデータ・タイプを 表 DCLI-7 に示します。

> 表 DCLI-7 F$GETJPI 項目
> 項目 | データ・ タイプ | 戻される情報
> --- | --- | ---
> ACCOUNT | 文字列 | アカウント名文字列（後ろの空白を含め 8 文字）
> APTCNT | 整数値 | アクティブなページ・テーブル数
> ASTACT | 整数値 | アクティブな非同期システム・トラップ(AST)のアクセス・モード
> ASTCNT | 整数値 | 残りの AST 制限
> ASTEN | 整数値 | AST が有効なアクセス・モード
> ASTLM | 整数値 | AST 上限値
> AUTHPRI | 整数値 | ALTPRI 特権のないプロセスが $SETPRI システム・サービスで獲得できる最高優先順位
> AUTHPRIV | 文字列 | プロセスでの使用を認められた特権
> BIOCNT | 整数値 | 残りのバッファード I/O 制限
> BIOLM | 整数値 | バッファード I/O 上限値
> BUFIO | 整数値 | プロセス・バッファード I/O 操作回数
> BYTCNT | 整数値 | 残りのバッファード I/Oバイト回数制限
> BYTLM | 整数値 | バッファード I/O バイト回数制限
> CLINAME | 文字列 | 現在のコマンド言語インタプリタ。常にDCLを戻す。
> CPULIM | 整数値 | プロセス CPU 時間の上限
> CPUTIM | 整数値 | CPU 時間。1/100 秒単位で示される。
> CREPRC_FLAGS | 整数値 | プロセスを作成する $CREPRC 呼び出しの stsflg引数により指定されるフラグ
> CURPRIV | 文字列 | 現在のプロセス特権
> DFPFC | 整数値 | 省略時のページ・フォルト・クラスタ・サイズ
> DFWSCNT | 整数値 | 省略時のワーキング・セット・サイズ
> DIOCNT | 整数値 | 残りの直接 I/O 制限
> DIOLM | 整数値 | 直接 I/O 上限値
> DIRIO | 整数値 | プロセスの直接 I/O 操作回数
> EFCS | 整数値 | ローカル・イベント・フラグ 0--31
> EFCU | 整数値 | ローカル・イベント・フラグ 32--63
> EFWM | 整数値 | イベント・フラグ待ちマスク
> ENQCNT | 整数値 | 残りのロック要求制限
> ENQLM | 整数値 | ロック要求上限値
> EXCVEC | 整数値 | 例外ベクタのリストのアドレス
> FAST_VP_SWITCH | 整数値 | ベクタ・コンテキスト・スイッチの損失なしで非アクティブ・ベクタ・プロセッサを使用可能にする，ベクタ命令を発行した回数
> FILCNT | 整数値 | 残りのオープン・ファイル制限
> FILLM | 整数値 | オープン・ファイル上限値
> FINALEXC | 整数値 | 最終例外ベクタのリストのアドレス
> FREP0VA | 整数値 | プログラム・リージョン(p0 空間)の終わりにある最初のフリー・ページ (イメージが実行されていない場合はなし)
> FREP1VA | 整数値 | コントロール・リージョン(p1 空間)の終わりにある最初のフリー・ページ
> FREPTECNT | 整数値 | 仮想メモリの拡張に使用可能なページ数
> GPGCNT | 整数値 | ワーキング・セットでのグローバル・ページ数
> GRP | 整数値 | 利用者識別コード(UIC)のグループ番号
> HOME_RAD (Alpha のみ) | 整数値 | ホーム・リソース・アフィニティ・ドメイン (RAD) を返す。 AlphaServer GS160 システムでのみサポート
> IMAGECOUNT | 整数値 | プロセスでラン・ダウンされたイメージ数
> IMAGNAME | 文字列 | 現在のイメージのファイル名
> IMAGPRIV | 文字列 | 現在のイメージをインストールした特権
> JOBPRCCNT | 整数値 | ジョブに所有されるサブプロセス数
> JOBTYPE | 整数値 | ジョブ・ツリーのルートにあるプロセスの実行モード
> LAST_LOGIN_I | 文字列 | 最後に会話型ログインをした時刻(ログインしたときに報告された値)
> LAST_LOGIN_N | 文字列 | 最後に非会話型ログインをした時刻(ログインしたときに報告された値)
> LOGIN_FAILURES | 整数値 | 現在のセッションを開始する前に起きたログイン失敗数 (ログインしたときに報告された値)
> LOGIN_FLAGS | 整数値 | ログイン手順に関連した追加情報を含むロングワード・ビットマスク
> LOGINTIM | 文字列 | プロセス作成時刻
> MASTER_PID | 文字列 | 現在のジョブのプロセス・ツリーの一番上のプロセスの識別番号(PID)
> MAXDETACH | 整数値 | プロセスの所有者であるユーザに許可された，独立プロセスの最大数
> MAXJOBS | 整数値 | プロセスの所有者であるユーザに許可された，実行中のプロセスの最大数
> MEM | 整数値 | 利用者識別コード(UIC)のメンバ番号
> MODE | 文字列 | 現在のプロセス・モード (BATCH,INTERACTIVE, NETWORK, または OTHER)
> MSGMASK | 整数値 | 省略時のメッセージ・マスク
> MULTITHREAD | 整数値 | (sysgen 設定により制限されている)プロセスに対する現在の設定
> NODENAME | 文字列 | プロセスが実行中である OpenVMS Cluster の名前
> NODE_CSID | 整数値 | プロセスが実行中である OpenVMS Cluster のクラスタ ID
> NODE_VERSION | 文字列 | プロセスが実行中である OpenVMS Cluster のオペレーティング・システムのバージョン番号
> OWNER | 文字列 | プロセス所有者のプロセス識別番号
> PAGEFLTS | 整数値 | ページ・フォルトの回数
> PAGFILCNT | 整数値 | 残りのページング・ファイル制限
> PAGFILLOC | 整数値 | ページング・ファイルの記憶位置
> PARSE_STYLE_PERM (Alpha のみ) | 文字列 | $SET_PROCESS_PROPERTIESW によって設定された値
> PARSE_STYLE_IMAGE (Alpha のみ) | 文字列 | $SET_PROCESS_PROPERTIESW によって設定された値
> PGFLQUOTA | 整数値 | ページ・ファイル上限値(最大仮想ページ数)
> PHDFLAGS | 整数値 | フラグ・ワード
> PID | 文字列 | プロセス識別番号
> PPGCNT | 整数値 | プロセス・ページ数
> PRCCNT | 整数値 | プロセスが所有するサブプロセス数
> PRCLM | 整数値 | サブプロセス制限値
> PRCNAM | 文字列 | プロセス名
> PRI | 整数値 | プロセスの現在の優先順位
> PRIB | 整数値 | プロセスの基本優先順位
> PROC_INDEX | 整数値 | プロセスの索引番号
> PROCESS_RIGHTS | 文字列 | 利用者識別コードを含むプロセスのローカル・ライト・リスト。この項目コードはコンマ(,) で区切られた識別子名のリストを戻す。
> PROCPRIV | 文字列 | プロセスの省略時の特権
> RIGHTSLIST | 文字列 | すべてのプロセス・ライト・リスト。これは PROCESS_RIGHTS と SYSTEM_RIGHTS を加えたもとの同等。この項目コードはコンマ(,) で区切られた識別子名のリストを戻す。
> RIGHTS_SIZE | 整数値 | ライト・リストをバッファリングするために必要なバイト数。このリストにはシステム・ライト・リストとプロセス・ライト・リストの両方が含まれる。
> SHRFILLM | 整数値 | プロセスが属するジョブに許可された，オープンな共用ファイルの最大数
> SITESPEC | 整数値 | 1 プロセスあたりのサイト固有のロングワード
> SLOW_VP_SWITCH | 整数値 | すべてのベクタ・コンテキスト・スイッチを使用して非アクティブ・ベクタ・プロセッサを使用可能にする，ベクタ命令を発行した回数
> STATE | 文字列 | プロセスの状態
> STS | 整数値 | プロセス状態フラグの最初のロングワード
> STS2 | 整数値 | プロセス状態フラグの2番目のロングワード
> SWPFILLOC | 整数値 | スワップ・ファイルの記憶位置
> SYSTEM_RIGHTS | 文字列 | プロセスのシステム・ライト・リスト。この項目コードはコンマ(,) で区切られた識別子名のリストを戻す。
> TABLENAME | 文字列 | プロセスの現在のコマンド言語インタプリタ(CLI)・テーブルのファイル指定
> TERMINAL | 文字列 | 会話型ユーザのログイン・ターミナル名(1〜7 文字)
> TMBU | 整数値 | 終了メールボックスのユニット番号
> TQCNT | 整数値 | 残りのタイマ・キュー・エントリ制限
> TQLM | 整数値 | タイマ・キュー・エントリ制限値
> TT_ACCPORNAM | 文字列 | プロセスと関連するターミナルのアクセス・ポート名
> TT_PHYDEVNAM | 文字列 | プロセスと関連するターミナルの物理装置名
> UAF_FLAGS | 整数値 | プロセスを所有するユーザの利用者登録ファイル(UAF) 記録からのフラグ
> UIC | 文字列 | プロセスのユーザ識別コード(UIC)
> USERNAME | 文字列 | ユーザ名文字列(後ろの空文字を含めて12文字)
> VIRTPEAK | 整数値 | 仮想アドレスの最大サイズ
> VOLUMES | 整数値 | 現在マウントされているボリュームの数
> VP_CONSUMER | 論理値 | プロセスがベクタ消費であるかを示すフラグ
> VP_CPUTIM | 整数値 | ベクタ・カスタマとして累算したプロセスの合計時間
> WSAUTH | 整数値 | 認可された最大ワーキング・セット・サイズ
> WSAUTHEXT | 整数値 | 認可された最大ワーキング・セット超過値
> WSEXTENT | 整数値 | 現在のワーキング・セット超過値
> WSPEAK | 整数値 | ワーキングセット最大値
> WSQUOTA | 整数値 | ワーキング・セット・サイズの制限値
> WSSIZE | 整数値 | プロセスの現在のワーキング・セット・サイズ

> $GETJPI 関数を使用して，空プロセスまたはスワッパ・プロセスの情報を要求する場合は，以下の項目を除いて, 表 DCLI-7 にある任意の項目を指定できます。

> ACCOUNT | BYTLM | ENQCNT | ENQLM
> EXCVEC | FILCNT | FILM | FINALEXC
> IMAGNAME | LOGINTIM | MSGMASK | PAGFILCNT
> PGFLQUOTA | PRCCNT | PRCLM | PROCPRIV
> SITESPEC | TQCNT | TQLM | USERNAME
> VIRTPEAK | VOLUMES | WSPEAK |

##

### 例

#1
    $ NAME = F$GETJPI("3B0018","USERNAME")
    $ SHOW SYMBOL NAME
      NAME = "JANE        "

> この例は，F$GETJPI 関数を使用して， 3B0018 というプロセス番号の利用者名を得る方法を示しています。利用者名には，NAME というシンボルが割り当てられます。

前へ | 次へ | 目次 | 索引