管理情報バッチ登録コマンド
各管理情報の登録および変更は、登録（変更）したい内容を事前にパラメーターファイル（定義カード）として作成し、管理情報バッチ登録コマンドの実行時に指定することにより、パラメーターファイルの内容に従って登録（変更）を行います。
下記の設定を満たしていない場合、管理情報は正しく登録されません。
-
コマンドラインで実行する場合
エミュレーターの設定（「ホスト・コード・ページ」）と、このコマンドを実行するジョブのCCSID（コード化文字セット識別コード）とパラメーターファイルのCCSID（コード化文字セット識別コード）が下記のいずれかを満たすように設定してください。
【設定1】
-
エミュレーターの設定とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）に65535を設定する
-
パラメーターファイルのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
【設定2】
-
エミュレーターの設定とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）に65535を設定する
-
パラメーターファイルのCCSID（コード化文字セット識別コード）に65535を設定する
【設定3】
-
エミュレーターの設定とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
パラメーターファイルのCCSID（コード化文字セット識別コード）は任意
-
-
バッチジョブで実行する場合
このコマンドを実行するバッチジョブのCCSID（コード化文字セット識別コード）とパラメーターファイルのCCSID（コード化文字セット識別コード）が下記のいずれかを満たすように設定してください。
【設定1】
-
バッチジョブのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
パラメーターファイルのCCSID（コード化文字セット識別コード）は任意
【設定2】
-
バッチジョブのCCSID（コード化文字セット識別コード）に65535を設定する
-
パラメーターファイルのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクターセットを一致させる
-
プログラムインターフェイス
CALL ライブラリー名/UTLIUPDT PARM(['LIB=ライブラリー名'] 'F=filename' ['R'] ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])
パラメーター説明
- LIB=ライブラリー名
-
HULFTがインストールされているライブラリー名（省略時値 HULFT）
先頭英字の10バイト以内の英数字で指定します。
- F=filename
-
パラメーターファイル名（省略不可）
「ライブラリー名/ファイル名(メンバー名)」の形式で指定します。
- R
-
変更を行う場合に指定（省略可）
すでに同一IDが存在する場合、管理情報が変更されます。同一IDが存在しない場合、新規登録になります。
省略すると必ず新規登録になるため、同一IDが存在するとエラーメッセージを出力し、該当するIDの登録をスキップして次のIDを登録します。
- G
-
管理情報バッチ登録コマンドが出力するエラーメッセージの表示抑制（省略可）
省略するとエラーメッセージが表示されます。
- OUTPUT=filename
-
管理情報バッチ登録コマンドが出力するエラーメッセージの出力先（省略可）
「ライブラリー名/ファイル名(メンバー名)」の形式で指定します。
省略するとエラーメッセージは出力されません。
ログファイルのレコード保持件数は無制限です。
- EXIT CL変数名
-
管理情報バッチ登録コマンドが出力するエラーコードの受け取りとCL変数名（省略可）
EXITとCL変数名は連続して指定してください。
異常終了の場合のみ、エラーコードをCL変数へセットします。
省略するとエラーコードはセットされません。
コマンドインターフェイス
UTLIUPDT PARMFILE( ) PARMMBR( ) REPLACE( ) LIBRARY( ) MSG( ) FILE( ) MBR( )
パラメーター説明
- PARMFILE
-
パラメーターファイルのライブラリー名とファイル名（省略不可）
「ライブラリー名/ファイル名」の形式で指定します。
それぞれ先頭英字の10バイト以内の英数字で指定します。
- PARMMBR
-
パラメーターファイルのメンバー名（省略時値 *FILE）
- REPLACE
-
変更を行う場合に指定（省略時値 *NO）
- *NO
-
: 同一IDが登録されている場合はエラー
- *YES
-
: 同一IDが登録されている場合は内容を更新
- LIBRARY
-
HULFTがインストールされているライブラリー名（省略時値 HULFT）
先頭英字の10バイト以内の英数字で指定します。
- MSG
-
エラーメッセージの表示抑制（省略時値 *YES）
- *NO
-
: エラーメッセージを表示しない
- *YES
-
: エラーメッセージを表示する
- FILE
-
エラーメッセージ出力先ファイルのライブラリー名とファイル名（省略可）
「ライブラリー名/ファイル名」の形式で指定します。
それぞれ先頭英字の10バイト以内の英数字で指定します。
省略するとエラーメッセージは出力されません。ログファイルのレコード保持件数は無制限です。
- MBR
-
エラーメッセージ出力先ファイルのメンバー名（省略時値 *FILE）
先頭英字の10バイト以内の英数字で指定します。
パラメーターファイルの記述形式
パラメーターファイルの記述形式は下記のとおりです。
-
「*」で始まる行はコメントです。また、0x7Bで始まる行もコメントになります。
ただし、0x7Bはコードセットによって表示される文字が変わります。
日本語コードセットの場合、0x7Bは「#」と表示されます。
-
管理情報パラメーターファイル生成コマンド（UTLIGEN）で出力されるパラメーターファイルでは、コメント行の先頭文字は「*」で出力されます。
-
「END」行で1つの管理情報の終了を表します。
-
各項目は、「項目=設定値」の形式で指定してください。「=」の前後にスペースを記述することはできません。
-
1行に1項目、指定してください。
-
[]で囲まれている項目は省略することができます。省略時の値については「管理情報の設定」を参照してください。
-
{}で囲まれた設定値は、いずれかを選択してください。
-
_（フルスペルの指定以外の下線）の文字だけの指定も可能です。
パラメーターファイルは、レコード長224バイト以上かつ、2バイト文字セットが使用可能であるファイルを使用してください。
-
配信管理情報パラメーターの形式
配信管理情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「配信管理情報」を参照してください。
SNDFILE=ファイルID FILENAME=配信ファイル名 [INTERVAL=転送間隔] [BLOCKLEN=転送ブロック長] [BLOCKCNT=転送ブロック数] COMP={NO|1|2|3} ……………………………………………………… 圧縮方式 [DEFLATELEVEL={S|D|C}] ……………………………………………… DEFLATEレベル [TRANSPRTY=転送優先度] CHARTYPE={0|A|B|C|D|E|F|G|H|I|V|W|X} ……………………… EBCDICセット TRANSTYPE={FORMAT|BINARY|TEXT|MULTI} ……………………………… 転送タイプ [SHIFTTRANSACT={Y|N|S|C}] …………………………………………… シフトコードの扱い [SPCUT={S|N}] ……………………………………………………… 後続文字カット [KJCHNGE={S|R|N}] ………………………………………………… コード変換先 [CLEAR={K|C|D|L}] ………………………………………………… 配信ファイルの扱い [PREJOBID=配信前ジョブID] [JOBID=正常時ジョブID] [ERRJOBID=異常時ジョブID] [FMTID=フォーマットID|マルチフォーマットID] [DBID=連携DBID] GRPID=転送グループID [PASSWORD=暗号キー] [COMMENT=コメント] END注意- 転送ブロック長に“6”～“127”の値を指定している場合は、自動的にHULFT Ver.7の下限値“128”として配信管理情報に登録されます。
- ファイルIDに“_INSTANT_TRANSFER_”は指定できません。
- システム動作環境設定の高強度暗号強制モード（STRONGKEYMODE）を“1（有効）”に設定した場合、暗号キーは64桁の16進文字列（A～F、0～9の文字）で指定してください。
-
集信管理情報パラメーターの形式
集信管理情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「集信管理情報」を参照してください。
RCVFILE=ファイルID FILENAME=集信ファイル名 RECORDLEN=集信ファイルのレコード長 CHANGETYPE={0|A|B|C|D|E|F|G|H|I|V|W|X} ……………………… EBCDICセット TRANSMODE={NEW|REP|MOD} …………………………………… 登録モード ABNORMAL={DELETE|KEEP|RESTORE} …………………………… 異常時の処置 RCVTYPE={S|M} ………………………………………………… 集信形態 GENCTL={YES|NO} ……………………………………………… 世代管理 [GENMNGNO=世代管理数] [JOBID=正常時ジョブID] [ERRJOBID=異常時ジョブID] [GRPID=転送グループID] [JOBWAIT={J|T}] …………………………………………… 集信完了通知 [PASSWORD=暗号キー] [DATAVERIFY={0|1}] ………………………………………… データ検証 [COMMENT=コメント] END注意- ファイルIDに“_INSTANT_TRANSFER_”は指定できません。
- システム動作環境設定の高強度暗号強制モード（STRONGKEYMODE）を“1（有効）”に設定した場合、暗号キーは64桁の16進文字列（A～F、0～9の文字）で指定してください。
-
ジョブ起動情報パラメーターの形式
ジョブ起動情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「ジョブ起動情報」を参照してください。
JOB=ジョブID JOBDESC=ジョブ記述 JOB DEF ジョブ名1 ： ： （5個まで指定可能） ： ジョブ名5 DEFEND [COMMENT=コメント] END -
詳細ホスト情報パラメーターの形式
詳細ホスト情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「詳細ホスト情報」を参照してください。
HOST=ホスト名 HOSTTYPE={HOST|LINUX|WIN|IBMI} ………………………… ホスト種 KCODETYPE={SHIFT-JIS|JEF|EUC|IBM|UTF-8|GB18030|CH-S} ………… 転送コードセット JISYEAR={78|83} …………………………………………………… 日本語規格 [RCVPORT=集信ポートNo.] [REQPORT=要求受付ポートNo.] [HOSTSPSNUM=ホスト別配信多重度] [MYPROXYNAME=PROXYサーバ名] [MYPROXYPORT=PROXYポートNo.] [SENDPERMIT={Y|N}] ……………………… 送信要求・再送要求受付許可 [HULJOBPERMIT={Y|N}] …………………… 集信後ジョブ結果参照要求受付許可 [HULSNDRCPERMIT={Y|N}] ………………… ジョブ実行結果通知受付許可 [HULRJOBPERMIT={Y|N}] …………………… リモートジョブ実行受付許可 [ALLOWINSTTRANS={Y|N}] …………………… 簡易転送受付許可 [USRNOTIFY={Y|N}] ………………………………………………… ユーザーの通知 [HUL7MODE={Y|N}] ………………………………………………… HULFT7通信モード [COMMENT=コメント] END= 備考 =ホスト種のパラメーターには、HULFT10以前に指定していた以下の値も指定できます。
-
UNIX
-
NT
-
AS400
-
-
転送グループ情報パラメーターの形式
転送グループ情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「転送グループ情報」を参照してください。
GRP=転送グループID SERVER DEF ホスト名1 ： ： （48個まで指定可能） ： ホスト名48 DEFEND [COMMENT=コメント] END -
フォーマット情報パラメーターの形式
フォーマット情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「フォーマット情報」を参照してください。
FMT=フォーマットID FORMAT DEF 項目名1 開始位置1 バイト数1 項目タイプ1 小数部桁数1 ： ： （1000個まで指定可能） ： 項目名1000 開始位置1000 バイト数1000 項目タイプ 1000 小数部桁数1000 DEFEND [COMMENT=コメント] END-
開始位置を省略する場合には「*」を入力してください。省略すると1つ前の項目の開始位置とバイト数を足した値になります（自動計算）。
-
1フォーマットの各項目の区切りはスペースで行ってください。
-
項目タイプ「X」「I」「F」「N」「M」については、小数部桁数に「0」を指定してください。
注意「FORMAT DEF」～「DEFEND」内のコメントを記載する場合、先頭文字に「*」を使用することはできません。
先頭文字に「*」を使用すると項目名として扱われます。
コメントを記載する場合は、先頭文字に0x7Bを使用してください。ただし、0x7Bはコードセットによって表示される文字が変わります。日本語コードセットの場合、0x7Bは「#」と表示されます。
-
-
マルチフォーマット情報パラメーターの形式
マルチフォーマット情報を登録、変更するためのパラメーターファイルの形式は下記のとおりです。
各項目の詳細は「マルチフォーマット情報」を参照してください。
MFMT=マルチフォーマットID KEYSTART=キー開始位置 KEYLEN=キー長 [DFMTID=デフォルトフォーマットID] MFORMAT DEF キー値1 フォーマットID1 ： ： （20個まで指定可能） ： キー値20 フォーマットID20 DEFEND [COMMENT=コメント] END各キー値とフォーマットIDの区切りはスペースで行ってください。
記述例
* SEND INFORMATION SNDFILE=F0000001 FILENAME=MYLIB/HULFT(JINJI) INTERVAL=0 BLOCKLEN=4096 BLOCKCNT=3 COMP=N TRANSPRTY=50 TRANSTYPE=M CHARTYPE=A KJCHNGE=S SHIFTTRANSACT=S CLEAR=K *PREJOBID= JOBID=J0000001 *ERRJOBID= *DBID= GRPID=GRP1 FMTID=MFORMAT1 PASSWORD=RPC4523A COMMENT=PERSONNEL INFORMATION FILE END * RECEIVE INFORMATION RCVFILE=F0000001 FILENAME=MYLIB/HULFT_R(JINJI_R) RECORDLEN=1024 CHANGETYPE=A TRANSMODE=R ABNORMAL=K RCVTYPE=S GENCTL=N JOBID=J0000002 *ERRJOBID= GRPID=GRP1 PASSWORD=RPC4523A JOBWAIT=T DATAVERIFY=0 COMMENT=PERSONNEL INFORMATION FILE END * JOB INFORMATION JOB=J0000001 JOBDESC=MYLIB/JOBD JOB DEF SNDMSG MSG(SEND-SUCCESS) TOUSR(*SYSOPR) DEFEND COMMENT=JOB(PERSONNEL INFORMATION FILE) END * HOST INFORMATION HOST=AS400 HOSTTYPE=I KCODETYPE=I JISYEAR=83 RCVPORT=30000 REQPORT=31000 HOSTSPSNUM=20 SENDPERMIT=Y HULJOBPERMIT=Y HULSNDRCPERMIT=Y HULRJOBPERMIT=Y USRNOTIFY=N COMMENT=AS400 HOST END * TRANSFER GROUP INFORMATION GRP=GRP1 SERVER DEF AS400 DEFEND COMMENT=AS400 GROUP END * FORMAT INFORMATION FMT=FORMAT01 FORMAT DEF CODE * 4 9 0 NAME * 20 X 0 AGE * 2 9 0 SEIBETU * 2 9 0 ADDRESS * 30 X 0 TEL * 11 X 0 SYOZOKU * 16 X 0 NAISEN * 10 X 0 DEFEND COMMENT=KEY-0001 FORMAT(PERSONNEL INFORMATION FILE) END * MULTI-FORMAT INFORMATION MFMT=MFORMAT1 KEYSTART=1 KEYLEN=4 DFMTID=DEFAULT MFORMAT DEF 0001 FORMAT01 0002 FORMAT02 0003 FORMAT03 0004 FORMAT04 0005 FORMAT05 0006 FORMAT06 0007 FORMAT07 DEFEND COMMENT=PERSONNEL INFORMATION FILE END