5250 画面の到着時に実行される vHandle_ARRIVE ファンクションが含まれる画面スクリプトについては慣れ親しんでいることと思います。
どんな画面スクリプトでも、任意で vHandle_DEPART ファンクションを含むことも可能です。
これが存在する場合、この vHandle_DEPART ファンクションは、SENDKEY 操作などによって画面から離れようとしている時に呼び出されます。
これをを使用する必要がある場合は、次のようにして画面のスクリプトに追加します。
vHandle_DEPART: function()
{
var bReturn = true;
// your departure logic goes here
return(bReturn); /* ← Remember to return a Boolean success/fail value */
}, /* ← Remember to separate this function from the others with a comma */
vHandle_DEPART ファンクションの使用については、以下の点を理解しておく必要があります。
- このファンクションは通常は使用されません。このファンクションを多く使用している場合、問題の解決方法が不適切な可能性があります。
- 通常、このファンクションは、SENDKEY 操作の結果として、現在の 5250 画面がサーバーに送信されたときに呼び出されます。つまり、 (SENDKEY を送信したスクリプトなど) 他のスクリプトのいずれかがアクティブな時にこのファンクションもアクティブになる可能性があります。
- この状態で出発スクリプトで SENDKEY 操作を使用すると、失敗するか、不適切な結果となる可能性があります。ですから、このような操作を行うべきではありません。
- このファンクションは画面の送信をキャンセルすることができません。このファンクションには、画面が送信されていることが通知され、関連するものを閉じるアクションやクリーンアップ・アクションが許可されます。FALSE が返された場合、vHandle_DEPART スクリプトが失敗したことを示しています。ただし、画面送信をキャンセルする必要があるということを意味している訳ではありません。
- このファンクションは画面が送信されるたびに呼び出されます。