TS_SETBYNAME
TS_SETBYNAMEアクティビティは、現在のaXesターミナル画面のフィールド値を、フィールド名(オプションとしてサブ・フィールドのインデックス)で参照して設定し、(オプションとして)現在のaXes画面データをaXesターミナル・サーバーに送信することもできます。5250ターミナルでタイプする時と似ています。
INPUTパラメータ:
AXHANDLE :必須
このパラメータには、このアクティビティが動作するaXesターミナル・サーバー・セッションを識別する接続ハンドルの値を指定してください。接続ハンドルの値は、TS_CONNECTアクティビティで受け取ることができます。
AXNAME :必須
このパラメータに、値が設定されるフィールド名を指定します。この名前は(TS_CONNECTアクティビティでaXesプロジェクト名が指定された場合)ユーザー定義名またはaXesフィールド識別子です。
AXINDEX :任意
フィールドにサブ・ファイルが含まれている場合、このパラメータに、値が設定される現画面フィールドのインスタンスのインデックスを指定することができます。サブ・ファイルのスクロール位置にかかわらず、現在の画面の最初のインスタンスはインデックス1になります。自身の処理シーケンスがサブ・ファイルのフィールドを処理しないといけない場合、一度に1画面を処理し、TS_SENDアクティビティを使って、(5250ターミナル・ユーザーが行うのと同様)ROLL_UPやROLL_DOWNを送信します。
AXSCREENVALUE :必須
このパラメータで指定の画面フィールドに設定する値を指定します。
AXKEY :任意
このパラメータで、オプションとしてaXesターミナル・サーバーに現在のaXes画面を送信する際のファンクション・キーを指定できます。次の値はどれでも使用できます。指定されない場合は、何も送信されません。
*ENTER
*F1 - *F9
*F10 - *F24
*PAGE_UP,
*PAGE_DOWN
*ROLL_UP, *ROLL_DOWN
*HELP, *PRINT
OUTPUTパラメータ:
AXSCREEN :
正常に終了すると、このパラメータには結果のaXes 5250の画面名または署名が格納されます。画面名は、aXesプロジェクト名がTS_CONNECTアクティビティで指定された場合のユーザー定義の名前で、画面に割り当てられるものです。それ以外の場合は画面署名が戻されます。(注意:AXKEYパラメータでファンクション・キー値が指定された場合のみ、このアクティビティの実行で現在表示されている5250画面が影響をうけたり変更したりします。)