REXX プロシージャーまたは TSO CLIST における Z Data Tools 機能の使用

REXX プロシージャーから Z Data Tools 機能を呼び出すには、以下の構文を使用します。
HFMMAIN "$function-name-parameters"
CLIST から Z Data Tools 機能を呼び出すには、以下の構文を使用します。
HFMMAIN $function-name-parameters
パラメーターの名前と値を等号またはブランクで結合します。これらの名前と値のペアをコンマまたはブランクで分離します。例:
HFMMAIN "$DSP DSNIN='HFMUSER.TEST.KSDS1',FORMAT=HEX,KEY=000100,NLRECS=20"

REXX プロシージャー内では、すべてのプロファイルの設定はインストール時のデフォルトから取られます。Z Data Tools デフォルト・プロファイル設定変更について詳しくは、Z Data Tools Customization Guide を参照してください。

REXX exec で Z Data Tools 関数を呼び出す場合は、HFMPRINT (または SYSPRINT) が割り振られている必要があります。

例

次の例は、Z Data Tools 機能を使用する REXX プロシージャーを示します。
図 1. Z Data Tools 機能を使用する REXX プロシージャーの例
/* REXX */
/* ***************************************************/
/* Example: Execute Z Data Tools functions from REXX */
/* ***************************************************/
parse upper source environment.
address tso
"alloc f(HFMPRINT) DUMMY REUSE"
/* Set the output to a REXX stem variable FILEM.                   */  
HFMMAIN "$SET PRINTOUT=REXX"
filem.0=0                       /* discard any previous output     */
/* invoke SCS to list data sets                                    */
HFMMAIN "$SCS FUNCTION=PRINT," ,
      "DSNAME='hlq.**'"
say "SCS return code:" RC
/* Display the FILEM.n variable contents                           */
SAY ">>> SCS output:"
DO i=1 to filem.0               /* process all printed lines       */
  SAY filem.i                   /* display the printline           */
  end