2.6.9.5 イベント定義命令(相手側ジョブ起動,相手側DB格納,相手側コード変換)

Linkexpress 運用ガイド

目次索引

第2章業務定義機能

> 2.6 業務定義命令

> 2.6.9 業務定義の命令一覧

2.6.9.5 イベント定義命令(相手側ジョブ起動,相手側DB格納,相手側コード変換)

[機能説明]

相手側ジョブ起動のイベントは、相手システムにあるジョブの起動を依頼します。この場合はイベント種別を指定するオペランドに"prtappls"を指定します。ジョブ連携の詳細については、「1.3 ジョブ連携機能」を参照してください。

また、相手側DB格納のイベントも同様のイベント定義命令を使用します。なお、相手側DB格納イベントで使用するジョブについては「2.4.11 DB格納イベントで利用するジョブをカストマイズ」を、相手側コード変換イベントを使用するジョブについては「2.4.12 コード変換イベントで使用するジョブをカストマイズ」を参照してください。

[記述形式]

lxdevent   name=イベント名
          [wait=(待ち合わせイベント名[, 待ち合わせ条件])
            [ ・・・ wait=(待ち合わせイベント名[,待ち合わせ条件])]]
           event=(prtappls,ジョブ名)
          [retry=(イベントリトライ回数,イベントリトライ間隔[,イベントリトライ単位])]
           partner=相手システム名
          [prtkind=相手システム種別]
          [prtsecur=(相手側利用者名[,[相手側パスワード][,相手側グループ名]])]
          [jobparm="ジョブパラメタ"]
          [jobtime=ジョブ結果待ち時間]
          [normalcode=(完了コード,[完了コード] ・・・ )]
          [sctldir=スロット情報ディレクトリ名]
          [tokenlbl=トークンラベル]
          [tokenpwd=トークンパスワード]
          [version=SSLプロトコルバージョン]
          [certenvdir=証明書運用管理ディレクトリ名]
          [cartnname=サイト証明書のニックネームリスト]
          [jobrsp=ジョブ結果通知の有無]

参照

name、wait、event、retry、partner、prtkind、prtsecur、jobparm、jobtime、normalcode、sctldir、tokenlbl、tokenpwd、version、certenvdir、cartnname、jobrsp

[注意事項]

起動ジョブの実行権限については、「導入ガイド」の「9.2.1 セキュリティチェックの実行契機」を参照してください。なお、相手システムがPCサーバの場合、"prtsecurオペランド" で指定する相手側利用者名がAdministratorグループに所属している必要があります。
ジョブ結果通知を相手システム（ジョブ実行側）から待ち合わせる場合、ジョブ結果監視時間（jobtimeオペランド）の指定を推奨します。ジョブ結果の時間監視せずとした場合、相手システム側でジョブ結果通知（lxrspjobコマンドなど）に失敗などすると、本イベントが無応答状態になります。このような場合、ジョブ結果の時間監視を行うことで、本イベントを復帰（エラー分類：50、エラーコード：60）することが可能です。
Linkexpressでは、以下のジョブを起動することができません。
- ［プラットホーム共通］
  - 対話型のジョブ
- ［PCサーバ上のジョブを起動する場合］
  - ウィンドウが存在するジョブ（notepadなど）
  - ATコマンドの実行で正常動作しないジョブ
    また、ジョブ起動したプログラムからは、ネットワークドライブ、プリンタなどの資源にアクセスできません。
- ［UNIXサーバ上のジョブを起動する場合］
  - 制御端末が必要なコマンド（passwdなど）
  - フルスクリーン系のコマンド（viなど）
PCサーバ上のジョブを起動する場合、システムの環境変数が引き継がれます。path環境変数など、ジョブ独自の環境変数が必要な場合は、ジョブの内部で環境変数を変更してください。
UNIXサーバ上のジョブを起動する場合、環境変数、umask値、標準出力、および標準エラー出力は、Linkexpressサーバを起動した環境（RCスクリプト、またはコンソール・端末）を引き継ぎます。ジョブ起動に指定する利用者のシェル環境（.profile、.chsrc など）は引き継ぎません。
また、ジョブの実行に必要な環境変数、およびジョブからのファイルアクセスに必要なumask値は、Linkexpressサーバを起動するRCシェルまたはコンソール・端末の実行環境に設定するか、またはジョブ内に設定してください。
ジョブからの標準出力、および標準エラー出力は、Linkexpressサーバを起動したコンソール・端末に出力されます。Linkexpressサーバ起動後に端末を終了している場合は、出力がEIOのエラーとなる可能性があります。このため、ジョブからの標準出力、および標準エラー出力は、一時ファイルなどにリダイレクトするなどの考慮を行ってください。
なお、コンソール・端末がロック・ハングしている場合は、標準出力、および標準エラー処理で待ち状態になるため、ジョブが完了できなくなりますので、注意してください。
LinkexpressクライアントはファイアウォールをまたがってLinkexpressサーバと通信することはできません。相手側DB格納イベントまたは相手側コード変換イベントの相手システムとの通信路にファイアウォールがある場合は、コマンドで業務を登録するか、相手側ジョブ起動イベントで代用してください。
相手側DB格納イベントまたは相手側コード変換イベントの場合、prtkindオペランドは指定できません。
相手システムがグローバルサーバ/PRIMEFORCEの場合、ジョブ結果通知は行えません。
通信パスがSANの場合、本イベントは利用できません。
retryオペランドのイベントリトライ単位は、Linkexpress V5.0L10相当以降で指定可能です。
jobrspオペランドは、Linkexpress V5.0L10相当以降で指定可能です。

2.6.9.5 イベント定義命令(相手側ジョブ起動,相手側DB格納,相手側コード変換)

[機能説明]

[記述形式]

[注意事項]

関連項目