GetDestinationList関数
出力先(スプールサーバ)の一覧を取得します。
形式
------------------宣言部------------------ 01 EURPMPARAMDEST. 02 DESTNUM PIC 9(9) COMP-X VALUE n. 02 DESTS OCCURS n TIMES. 03 DESTNAME PIC X(80) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 03 SERVERADDR PIC X(15) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 03 COMMENT PIC X(256) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 01 RTNCODE PIC S9(9) BINARY. ------------------実行部------------------ call 'GetDestinationList' USING BY REFERENCE EURPMPARAMDEST RETURNING RTNCODE.
パラメタ
戻り値
RTNCODE
終了コードが設定されます。終了コードについては,「10.4.1 エラー情報一覧」を参照してください。
DESTNUM
取得された出力先の数が格納されます。
DESTS
パラメタDESTNUMに設定されたn個分の出力先情報を,戻り値DESTNAME,SERVERADDR,COMMENTに格納します。出力先情報の数がn個に満たない場合は,戻り値DESTNUMに取得された個数の出力先情報が返され,戻り値DESTNUM+1番目以降の領域は不定になります。出力先情報の数がn個より多い場合は,パラメタDESTNUMに指定したn個の出力先情報が返されます。
DESTNAME
出力先情報の出力先名が設定されます。
SERVERADDR
出力先情報のスプールサーバのIPアドレスが設定されます。
COMMENT
出力先情報の説明が設定されます。
呼び出し例
出力先の一覧を取得する,呼び出し例を次に示します。
------------------宣言部------------------ 01 EURPMPARAMDEST. 02 DESTNUM PIC 9(9) COMP-X VALUE 120. 02 DESTS OCCURS 120 TIMES. 03 DESTNAME PIC X(80) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 03 SERVERADDR PIC X(15) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 03 COMMENT PIC X(256) VALUE SPACE. 03 FILLER PIC X(1) VALUE LOW-VALUE. 01 RTNCODE PIC S9(9) BINARY. ------------------実行部------------------ DISPLAY '<出力先一覧(GetDestinationList)>' CALL 'GetDestinationList' USING BY REFERENCE EURPMPARAMDEST RETURNING RTNCODE DISPLAY RTNCODE IF RTNCODE = ZERO THEN DISPLAY '正常終了' DISPLAY DESTNUM PERFORM VARYING IX1 FROM 1 BY 1 UNTIL IX1 > DESTNUM DISPLAY DESTNAME(IX1) DISPLAY SERVERADDR(IX1) DISPLAY COMMENT(IX1) END-PERFORM ELSE DISPLAY 'エラー発生' END-IF