變更開始

ADD_USER_INDEX_ENTRY 和 ADD_USER_INDEX_ENTRY_BINARY 程序

線上編輯

ADD_USER_INDEX_ENTRY 和 ADD_USER_INDEX_ENTRY_BINARY 程序會將單一項目新增至使用者索引 (*USRIDX)。 要新增的資料可以提供為字元或二進位資料。

對於固定長度索引，新項目的長度必須完全符合使用者索引長度，否則會發生錯誤。

程序所使用的值與「新增使用者索引登錄 (QUSADDUI)」所處理的值密切相關 API。 如需其他行為詳細資料，請參閱 API 文件。

授權: 呼叫者必須具有:
  • 對包含使用者索引之檔案庫的 *EXECUTE 權限，以及
  • 使用者索引的 *CHANGE 權限。
讀取語法圖跳過視覺化語法圖ADD_USER_INDEX_ENTRYADD_USER_INDEX_ENTRY_BINARY( USER_INDEX => 使用者索引,USER_INDEX_LIBRARY => user-index-library,取代 => 取代,入門 => 項目,索引鍵 => 關鍵)

綱目為 QSYS2。

使用者索引
包含要在其中新增登錄之使用者索引名稱的字串。
user-index-library
包含使用者索引所在之檔案庫名稱的字串。 可以是下列其中一個特殊值:
*CURLIB
使用現行檔案庫。
*LIBL
使用檔案庫清單。
取代
要執行的新增類型。
否
對於非索引鍵的索引，新項目必須是唯一的。 如果項目已在索引中，則會傳回錯誤。
對於索引鍵索引，只有在索引鍵不在使用者索引中時，才插入項目。 如果登錄不存在，則會將索引鍵及登錄資料插入使用者索引中。 如果項目已在索引中，則會傳回錯誤。
是
對於非索引鍵索引，不支援此值。
若為索引鍵索引，如果索引鍵已在使用者索引中，請取代索引登錄的登錄部分。 如果登錄不存在，則會將索引鍵及登錄資料插入使用者索引中。
項目
指定索引項目資料的字串。 缺少參數。
  • 對於 ADD_USER_INDEX_ENTRY ，輸入值是字串。
  • 對於 ADD_USER_INDEX_ENTRY_BINARY ，輸入值會被視為二進位字串。
索引鍵
指定索引項目的索引鍵的字串。 必須為索引使用者索引提供此參數。 索引鍵的長度不能超過定義的索引鍵長度。
  • 對於 ADD_USER_INDEX_ENTRY ，輸入值是字串。
  • 對於 ADD_USER_INDEX_ENTRY_BINARY ，輸入值會被視為二進位字串。
如果索引不是索引鍵，則必須省略此參數。

範例

  • 將新項目新增至非索引鍵使用者索引。
    CALL QSYS2.ADD_USER_INDEX_ENTRY(USER_INDEX => 'IX1', 
                                USER_INDEX_LIBRARY => 'APPLIB',
                                REPLACE => 'NO', 
                                ENTRY => 'Next entry');
  • 將新項目新增至含索引鍵的使用者索引。 如果索引鍵值已存在，則容許新項目改寫現有項目。
    
CALL QSYS2.ADD_USER_INDEX_ENTRY(USER_INDEX => 'USRIX1', 
                                USER_INDEX_LIBRARY => 'APPLIB', 
                                REPLACE => 'YES',
                                KEY => '00173',
                                ENTRY => 'New keyed entry');
變更結束