AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
目的
指定在函數 REPORT 區塊內或產生預設報告時 (若未指定 REPORT 區塊) 要進行處理的表格列數。
資料庫語言環境使用此變數,限制傳回的列數,如此可大幅改進大型結果組的執行效能。 此變數與 START_ROW_NUM 可將大型結果組的查詢分割成較小的表格, 每一個表格有其自己的 HTML 頁。
使用 DEFINE 陳述式或 @DTW_ASSIGN() 函數,指定這個變數的值。
值
RPT_MAX_ROWS="ALL"|"0"|"number"
值 | 說明 |
---|---|
ALL | 顯示在沒有限制由函數呼叫所產生的表格中的列數。所有列數都會顯示。 |
0 | 指定表格中所有的列數都會被顯示。 這個值同於指定 ALL。 |
number | 一個正整數,用於顯示在由函數 call 區塊產生的表格中的列數。
如果 FUNCTION 區塊包含 REPORT 及 ROW 區塊, 則這個數字所指定的是執行 ROW 的次數。 |
範例
範例 1:在 DEFINE 陳述式中定義 RPT_MAX_ROWS
%DEFINE RPT_MAX_ROWS="20"
以上的方法可將任何函數所傳回的列數限制為 20。
範例 2:使用 HTML 輸入,以針對 HTML 套表定義變數
要傳回的列數上限 (0 表示沒有限制): <input type="text" name="rpt_max_rows" size=3 />
以上幾行可以置於 FORM 標籤中, 讓應用程式使用者設定他們希望讓查詢所傳回的列數。