Groupmax Workflow - Library Version 6プログラミングガイド
![[目次]](FIGURE/CONTENT.GIF)
![[用語]](FIGURE/GLOSS.GIF)
![[索引]](FIGURE/INDEX.GIF)
![[前へ]](FIGURE/FRONT.GIF)
(1) 通信環境の設定
Groupmax Workflowでは,ネットワーク環境にTCP/IPを使用しています。このため,次に示す通信環境の設定が必要です。
- サーバのIPアドレスの登録
ログイン関数でIPアドレスを指定せずにサーバ名を指定する場合,/etc/hostsファイル,又はDNS(Domain Name System)のデータベースにWorkflowサーバのワークフローサーバのIPアドレスを設定します。HOSTSファイルには,サーバのIPアドレスを次の形式で追加してください。
- 形式
サーバのIPアドレス サーバのホスト名 サーバのホスト名の別名
- オペランド
サーバのIPアドレス
サーバのIPアドレスを記述します。
サーバのホスト名
サーバのホスト名を英数字,ハイフン又はピリオドからなる文字列で,記述します。(但し数字のみの名称は指定できません。)ログイン関数によっては,サーバ名を8文字までに限定しています。利用する関数の仕様を確認の上サーバ名を記述してください。
サーバのホスト名の別名
サーバのホスト名の別名を記述します。別名は省略してもかまいません。
- サービス名の登録
(a) Workflow Serverの複数サービス機能を使用しない場合のSERVICESファイルの設定方法
通信設定ファイル(/etc/services)に,Groupmax Workflowのサービス名,ポート番号,およびプロトコル名を記述します。通信設定ファイルの記述形式を次に示します。
- 形式
サービス名 ポート番号/プロトコル名
- オペランド
- サービス名
- Workflowのサービス名は,「workflow」と記述します。
- ポート番号
- Workflowのポート番号は,「40076」と記述します。
- プロトコル名
- 「tcp」と記述します。
- 記述例
workflow 40076/tcp
(b) Workflow Serverの複数サービス機能を使用する場合
SERVICESファイルの設定方法を次に示します。
- 形式
サービス名 ポート番号/プロトコル名
- オペランド
- サービス名
- 環境変数「GMAXWFSERVICE」に指定するサービス名を記述します。
- サービス名は31バイト以内の文字列で指定してください。
- ポート番号
- 接続するWorkflow Serverのセットアップ時に設定したポート番号を記述します。ポート番号はWorkflow以外が使用するポート番号と重ならないように設定してください。
- プロトコル名
- 「tcp」と記述します。
- 記述例
workflow 40076/tcp
workflow2 40077/tcp
Workflow Serverの複数サービス機能を使用する場合,通信設定ファイルにそれぞれのWorkflow Serverが使用するサービス名とポート番号を指定してください。サーバライブラリを使用する場合,環境変数「GMAXWFSERVICE」でサービス名を指定してください。
なお,環境変数「GMAXWFSERVICE」に値が指定されていない場合,サービス名「workflow」で指定されているポート番号を使用してWorkflow Serverにログインします。
(2) 作業ディレクトリの設定
作業ディレクトリとはサーバライブラリが利用する一時ファイルの格納先のディレクトリのことです。作業ディレクトリはサーバライブラリを使用になる環境に合わせて指定する必要があります。
作業ディレクトリは次の2つの環境変数で指定します。
| 環境変数名 |
指定する内容 |
| GMAXWFTMP |
作業ディレクトリを指定します。絶対パスで指定してください。 |
| GMAXWFTMPTYPE |
作業ディレクトリのサブディレクトリの構成の種別を指定します。 |
- 作業ディレクトリの指定
作業ディレクトリを指定するには,環境変数GMAXWFTMPを使用してください。指定しない場合は, HI-UX/WE2版サーバライブラリでは作業ディレクトリとして"/Flowmate/tmp"を使用します(HP-UX版サーバライブラリでは作業ディレクトリとして"/opt/Flowmate/tmp"を使用します)。作業ディレクトリにはアプリケーションプログラムを実行するユーザの更新権限が必要です。
- 作業ディレクトリの構成の種別の指定
環境変数GMAXWFTMPTYPEで作業ディレクトリの構成の種別を指定します。環境変数には次の2つを指定できます。
| 環境変数への指定値 |
概要 |
| "USERID" |
Workflow Server NT/2000版に接続する場合に指定します。 |
| "SESSION" |
Workflow Server HI-UX/WE2版またはHP-UX版に接続する場合に指定します。 |
環境変数の指定がないまたは,環境変数に値が無い場合,"USERID"が指定されたときの動作をします。
- 1.環境変数GMAXWFTMPTYPEに"USERID"を指定した場合
- 環境変数GMAXWFTMPTYPEに"USERID"を指定した場合は,作業ディレクトリの下にログイン関数で指定されたユーザIDのディレクトリを作成します。このためログインユーザ数の延べ数がOSのサブディレクトリ作成上限を超えた場合,作業ディレクトリが作成できずエラーリターンします。ログインユーザ数の延べ数がOSのサブディレクトリ作成上限をこえないよう運用管理者がログインユーザID毎に作成されるディレクトリの延べ数を定期的に監視し,作業ディレクトリ下のユーザID単位のディレクトリを削除してください。ディレクトリの削除は,Workflow Serverに接続しているプログラムをすべて終了した後に行ってください。
- 2.環境変数GMAXWFTMPTYPEに"SESSION"を指定した場合
- 環境変数GMAXWFTMPTYPEに"SESSION"を指定した場合は,ログインしたWorkflow ServerのIPアドレスとWorkflow Serverが管理しているセッション番号のディレクトリを作成します。但し,この指定は接続するWorkflow ServerがHI-UX/WE2版又はHP-UX版の時のみ有効となります。Windows NT/2000版ワークフローサーバに接続する場合は,この指定は無効になります。接続先のWorkflow ServerのIPアドレスが変更となり,元のIPアドレスのWorkflow Serverにログインしなくなる場合には,作業ディレクトリ/_ftp_ディレクトリ下のIPアドレス名称で作成されているディレクトリを削除してください。
- 作成・使用するディレクトリの比較を以下に示します
| ログイン関数名称 |
作成・使用するディレクトリ |
| 環境変数:GMAXWFTMPTYPE |
| 指定なし |
値なし |
USERID |
SESSION |
左記以外 |
| HwfStartUpWorkflow |
作業ディレクトリ/_ftp_/ユーザID |
作業ディレクトリ/_ftp_/IPアドレス/セッション番号 |
作業ディレクトリ/_ftp_/ユーザID |
| HwfLoginWorkflow HwfStartUpWorkflowSV HwfAdStartUp(管理者ライブラリ) |
作業ディレクトリ/ユーザID(※1)/_ftp_/ユーザID |
作業ディレクトリ/_ftp_/IPアドレス/セッション番号 |
作業ディレクトリ/ユーザID(※1)/_ftp_/ユーザID |
- (※1)
- 当該ディレクトリは,環境変数「GMAXWFTMP」の指定がないときにのみ作成されます。また,「GMAXWFTMP」の指定がない場合,ログイン結果(成功/失敗)にかかわらず作成されます。
- 環境変数「GMAXWFTMPTYPE」指定値の変更による不要ディレクトリの削除について
環境変数「GMAXWFTMPTYPE」指定値を変更する場合は,使用しなくなった不要なディレクトリを削除する必要があります。以下の表を参考にして不要なディレクトリを削除してください。不要なディレクトリを削除する際は,事前に当該マシンからWorkflow Serverに接続しているアプリケーションプログラムをすべて終了させてください。
| GMAXWFTMPTYPEの指定値 |
削除する必要があるディレクトリ |
| 変更前 |
変更後 |
| "SESSION" |
|
作業ディレクトリ下の "_ftp_" ディレクトリを削除してください。 |
|
"SESSION" |
作業ディレクトリ下の "_ftp_" ディレクトリ,およびユーザID単位のディレクトリを削除してください。 |
- アプリケーションプログラムを複数実行する場合の注意事項
同一マシン上でサーバライブラリのアプリケーションプログラムを複数同時に実行する場合,アプリケーションプログラムごとに異なる作業ディレクトリを指定するようにしてください。
- オンラインマニュアルの参照
- サーバライブラリのオンラインマニュアルを参照するには,次の環境変数を設定する必要があります。
- LANG
- 環境変数LANGに"ja_JP.SJIS"を設定してください。
- MANPATH
- 環境変数MANPATHに"/Flowmate/man"を追加してください。
(b) アプリケーションのコンパイル
アプリケーションをコンパイルするときは,次のライブラリとオプションを指定してください。
- アーカイブ・ライブラリ
- ライブラリ
- サーバライブラリだけ使用する場合
/Flowmate/lib/libbwfsapi.a
/Flowmate/lib/libbwfsapi2.a
/lib/libm.a
- サーバライブラリとサーバ管理者ライブラリを同時に使用する場合(※1)
/Flowmate/lib/libbwfsapi.a
/Flowmate/lib/libbwfsadmi.a
/Flowmate/lib/libbwfsadmi2.a 又は /Flowmate/lib/libbwfsapi2.a (※2)
/lib/libm.a
- 注※1
- サーバライブラリとサーバ管理者ライブラリを同時に使用するには,両製品のバージョン・リビジョン番号が一致している必要があります。
- ただし,修正バージョンは一致していなくてもかまいません。
- (例) バージョンがそれぞれ 06-00 と 06-00-/A の組み合わせは同時に使用できます。
- バージョンがそれぞれ 05-00 と 06-00 の組み合わせは同時に使用できません。
- 注※2
- ファイルの日付が新しい方を使用してください。同じ日付の場合,どちらか一つを使用してください。どちらを使用してもかまいません。
- オプション
- -I/Flowmate/include
- -D_HIUX_SOURCE
- -Aa
(c) 他製品との組み合わせ使用の禁止
一つのアプリケーションプログラム上で,以下の製品のどれかと組み合わせて使用しないようにお願いいたします。
| 形名 |
製品名称 |
| P-1646-7C4 |
Document Manager Development Kit Version 6 |
| P-1646-7C3 |
Document Manager Development Kit Version 5 |
| P-1646-7C2 |
Document Manager Development Kit Version 3 |
| P-1646-7C1 |
Document Manager Development Kit Version2.0 |
| P-1646-291 |
GroupInfoshare/Development Kit |
(a) オンラインマニュアルの参照
サーバ管理者ライブラリのオンラインマニュアルを参照するには,次の環境変数を設定する必要があります。
- LANG
- 環境変数LANGに"ja_JP.SJIS"を設定してください。
- MANPATH
- 環境変数MANPATHに"/opt/Flowmate/man"を追加してください。
(b) アプリケーションプログラムのコンパイル
アプリケーションプログラムをコンパイルするときは,次のライブラリとオプションを指定してください。
- アーカイブ・ライブラリ
- ライブラリ
- サーバライブラリだけ使用する場合
/opt/Flowmate/lib/libbwfsapi.a
/opt/Flowmate/lib/libbwfsapi2.a
/lib/libm.a
- サーバライブラリとサーバ管理者ライブラリを同時に使用する場合(※1)
/opt/Flowmate/lib/libbwfsapi.a
/opt/Flowmate/lib/libbwfsadmi.a
/opt/Flowmate/lib/libbwfsadmi2.a 又は /opt/Flowmate/lib/libbwfsapi2.a (※2)
/lib/libm.a
- 注※1
- サーバライブラリとサーバ管理者ライブラリを同時に使用するには,両製品のバージョン・リビジョン番号が一致している必要があります。
- ただし,修正バージョンは一致していなくてもかまいません。
- (例) バージョンがそれぞれ 06-00 と 06-00-/A の組み合わせは同時に使用できます。
- バージョンがそれぞれ 05-00 と 06-00 の組み合わせは同時に使用できません。
- 注※2
- ファイルの日付が新しい方を使用してください。同じ日付の場合,どちらか一つを使用してください。どちらを使用してもかまいません。
- オプション
- -I/opt/Flowmate/include
- -D_HPUX_SOURCE
- -Aa
(c) HP-UXを使用する場合の注意事項
アーカイブ・ライブラリを使用する場合は,HP-UX 10.20又はHP-UX 11.0でコンパイルして使用できます。
(d) 他製品との組み合わせ使用の禁止
一つのアプリケーションプログラム上で,以下の製品のどれかと組み合わせて使用しないようにお願いいたします。
| 形名 |
製品名称 |
| P-1B46-7C41 |
Document Manager Development Kit Version 6 |
| P-1B46-7C31 |
Document Manager Development Kit Version 5 |
| P-1B46-7C21 |
Document Manager Development Kit Version 3 |
| P-1B46-7C11 |
Document Manager Development Kit Version2.0 |
| P-1B46-2911 |
GroupInfoshare/Development Kit |
(a) オンラインマニュアルの参照
サーバ管理者ライブラリのオンラインマニュアルを参照するには,次の環境変数を設定する必要があります。
- LANG
- 環境変数LANGに"Ja_JP"を設定してください。
- MANPATH
- 環境変数MANPATHに"/opt/Flowmate/man"を追加してください。
(b) アプリケーションプログラムのコンパイル
アプリケーションプログラムをコンパイルするときは,次のライブラリとオプションを指定してください。
- アーカイブ・ライブラリ
- ライブラリ
- サーバライブラリだけ使用する場合
/opt/Flowmate/lib/libbwfsapi.a
/opt/Flowmate/lib/libbwfsapi2.a
/lib/libm.a
- サーバライブラリとサーバ管理者ライブラリを同時に使用する場合(※1)
/opt/Flowmate/lib/libbwfsapi.a
/opt/Flowmate/lib/libbwfsadmi.a
/opt/Flowmate/lib/libbwfsadmi2.a 又は /opt/Flowmate/lib/libbwfsapi2.a (※2)
/lib/libm.a
- 注※1
- サーバライブラリとサーバ管理者ライブラリを同時に使用するには,両製品のバージョン・リビジョン番号が一致している必要があります。
- ただし,修正バージョンは一致していなくてもかまいません。
- (例) バージョンがそれぞれ 06-00 と 06-00-/A の組み合わせは同時に使用できます。
- バージョンがそれぞれ 05-00 と 06-00 の組み合わせは同時に使用できません。
- 注※2
- ファイルの日付が新しい方を使用してください。同じ日付の場合,どちらか一つを使用してください。どちらを使用してもかまいません。
- オプション
- -I/opt/Flowmate/include
- -D_AIX5L_SOURCE
- -qlanglvl=ansi
- -qchars=signed
- -qdbcs -qmbcs
All Rights Reserved. Copyright (C) 2001, 2015, Hitachi, Ltd.