5.3.13 SETBYNAME
SETBYNAMEコマンドは、現在のaXesターミナル画面のフィールド値を、フィールド名（任意でサブ・フィールドのインデックス）で参照して設定し、（オプションとして）現在のaXes画面データをaXesターミナル・サーバーに送信することもできます。これは5250ターミナルでタイプする時と似ています。
フィールドRTNSIGとRTNSCREENの値を交換するには、コマンド文字列内でSERVICE_EXCHANGE(*FIELD)を指定する必要があります。
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
SETBYNAME |
NAME |
画面フィールド名 |
必須。このキーワードには、設定する値のフィールド名を指定します。この名前には、ユーザー定義名(CONNECTコマンドでaXesプロジェクト名が指定された場合)またはaXesのフィールド識別子のいずれかを指定できます。 |
|
VALUE |
値 |
必須。このキーワードには指定のフィールドに設定する値を指定します。 |
|
INDEX |
0 値 |
任意。このフィールド名がサブファイルに含まれている場合、このキーワードには取得する属性のフィルードの現在の画面上のインスタンスのインデックスを指定します。サブファイルのスクロール位置にかかわらず、現画面の最初のインスタンスはインデックス1になります。ユーザーのプログラムがサブファイルのフィールドを処理しないといけない場合は、１画面ごとに処理をしてSENDコマンドを利用してROLL_UP/ROLL_DOWNを送信します。(これは5250ターミナルのユーザーが行わなければならない動作と同じです） |
|
SENDKEY |
ENTER |
任意。このキーワードに値が指定された場合、コマンドは（フィールド値が正常に設定された後に）ここに指定のファンクション・キーを使ってaXesターミナル・サーバーに現在のaXes画面データを送信します。 |
|
|
F1 - F24 |
|
|
|
HELP |
|
|
|
|
|
|
|
PAGE_UP |
|
|
|
PAGE_DOWN |
|
|
|
ROLL_UP |
|
|
|
ROLL_DOWN |
|
|
|
|
デフォルト。送信操作なし。 |
|
RTNSIG |
フィールド名 |
任意。処理後に表示される画面の画面署名を受け取るJSMとクライアント・プログラムとの間で交換されたフィールド名を指定します。 |
|
RTNSCREEN |
フィールド名 |
任意。処理後に表示される画面の画面名を受け取るJSMとクライアント・プログラムとの間で交換されたフィールド名を指定します。CONNECTコマンドでaXesプロジェクト名が指定された場合、画面名はユーザー定義の名前で、画面に1つの名前が割り当てられます。それ以外の場合は画面署名が戻されます。 |
例
SETBYNAME NAME(FLD001) VALUE(ABC001) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)