集信管理情報
集信するファイルのファイル情報を登録します。以下の登録方法があります。
-
HULFT管理画面による登録
-
パラメータファイル指定によるコマンド登録
(1) 項目一覧
以下の表の「省略」は、HULFT管理画面による登録の場合の値です。コマンド登録の場合、省略可否がHULFT管理画面とは異なる場合があります。
コマンド登録の場合の省略可否については、「管理情報バッチ登録コマンド」を参照してください。
項目値 |
初期値 |
設定値 |
省略 |
備考 |
||
---|---|---|---|---|---|---|
画面 |
ファイル |
|||||
ファイルID |
RCVFILE |
|
大文字英数字 |
× |
50バイト以内 |
|
コメント |
COMMENT |
|
文字 |
○ |
60バイト以内 |
|
集信管理情報更新画面 |
||||||
|
ファイル名 |
FILENAME |
|
英数字 |
× |
200バイト以内 |
オーナー名 |
OWNER |
|
英数字 |
○ |
14バイト以内(*1) |
|
グループ名 |
GROUP |
|
英数字 |
○ |
14バイト以内(*1) |
|
パーミッション |
PERM |
(*2) |
0、1 |
○ |
|
|
登録モード |
TRANSMODE |
|
N、R、M |
× |
|
|
異常時の処置 |
ABNORMAL |
|
D、K、R |
× |
|
|
集信形態 |
RCVTYPE |
|
S、M |
× |
|
|
世代管理 |
GENCTL |
|
Y、N |
× |
|
|
世代管理数 |
GENMNGNO |
|
0、 2~9999 |
○ |
|
|
EBCDICセット |
CODESET |
0 |
0、A~I、V~X |
○ |
|
|
正常時ジョブID |
JOBID |
|
英数字 |
○ |
50バイト以内 |
|
異常時ジョブID |
EJOBID |
|
英数字 |
○ |
50バイト以内 |
|
集信管理情報更新画面(拡張) |
||||||
|
集信完了通知 |
JOBWAIT |
T |
J、T |
○ |
|
転送グループID |
GRPID |
|
英数字 |
○ |
50バイト以内 |
|
データ検証 |
DATAVERIFY |
0 |
0、1 |
○ |
|
|
暗号キー |
PASSWORD |
|
英数字 |
○ |
8~20バイト |
|
暗号キー |
16進文字列 |
× |
64桁 |
○ |
: |
省略可 |
× |
: |
省略不可 |
*1 |
: |
オーナー名(OWNER)またはグループ名(GROUP)のどちらか一方のみの省略はできません。 |
*2 |
: |
ファイルの読み、および書きは“1”、実行は“0”となります。 |
*3 |
: |
システム動作環境設定の高強度暗号強制モード(strongkeymode)で“0(無効)”を設定した場合に設定できます。 |
*4 |
: |
システム動作環境設定の高強度暗号強制モード(strongkeymode)で“1(有効)”を設定した場合に設定する必要があります。 |
(2) 各項目の説明
集信管理情報に設定する各項目について説明します。( )内はパラメータファイル使用時に指定する項目名です。
- ファイルID(RCVFILE)
-
集信するファイルを認識するためのID
- コメント(COMMENT)
-
集信するファイルに対するコメント
集信管理情報更新画面
- ファイル名(FILENAME)
-
集信するファイル
絶対パスで指定します。
HULFT8のEnterpriseグレードを導入した環境ではネットワーク資源を利用したファイルを指定できます。詳細は、「アドミニストレーション マニュアル」のネットワークファイルの説明を参照してください。
- オーナー名(OWNER)
-
集信ファイルの所有者
システムに登録されている所有者名を設定してください。
注意-
一般ユーザでHULFTの運用を行う際、オーナー名(OWNER)を指定する場合は、集信デーモンを起動したユーザのユーザ名を指定してください。別のユーザ名を指定すると、集信ファイルの作成に失敗する場合があります。
-
オーナー名(OWNER)またはグループ名(GROUP)のどちらか一方のみの省略はできません。
-
オーナー名(OWNER)を省略した場合、集信デーモンを起動したユーザのユーザ名で集信ファイルが作成されます。
-
- グループ名(GROUP)
-
集信ファイルのグループ名
システムに登録されているグループ名を設定してください。
注意-
一般ユーザでHULFTの運用を行う際、グループ名(GROUP)を指定する場合は、集信デーモンを起動したユーザが所属しているグループ名を指定してください。別のグループ名を指定すると、集信ファイルの作成に失敗する場合があります。
-
オーナー名(OWNER)またはグループ名(GROUP)のどちらか一方のみの省略はできません。
-
グループ名(GROUP)を省略した場合、集信デーモンを起動したユーザのグループ名で集信ファイルが作成されます。
-
- パーミッション(PERM)
-
ファイルの読み、書き、実行の許可モード
- 0
-
: 権限無し
- 1
-
: 権限有り
省略すると、以下の値が設定されます。
表2.4 ファイルの許可モードの初期値
読み
書き
実行
オーナー
1
1
0
グループ
1
1
0
その他
1
1
0
- 登録モード(TRANSMODE)
-
集信するファイルの登録方法
- N(新規作成)
-
: 集信ファイルを新規作成。
同名のファイルがすでに存在している場合はエラー。
- R(置き換え)
-
: 既存のファイル内容を受信データに置き換え。
ファイルが存在しない場合は新規作成。
- M(追加)
-
: 既存ファイルの最後に受信データを追加。
ファイルが存在しない場合は新規作成。
集信形態が“S(単一集信)”で登録モードに“M(追加)”を指定した場合、集信中に何らかの異常が発生すると、異常が発生する前までの集信データは追加書きされてしまいます。
- 異常時の処置(ABNORMAL)
-
集信に失敗したときの集信ファイルの処置
- D(削除)
-
: 集信ファイルを削除
- K(保存)
-
: 集信が失敗した時点の集信ファイルを保持
- R(復元)
-
: 集信開始前に集信ファイルをバックアップし、集信が失敗したらバックアップを復元
集信開始前に集信ファイルが存在しなかった場合は“D(削除)”と同じ動作
- 集信形態(RCVTYPE)
-
集信するファイルの集信形態
- S(単一集信)
-
: 単一ホストからファイルを集信
- M(複数集信)
-
: 複数ホストからファイルを集信し、1つのファイルを作成
“M(複数集信)”を指定するときは、登録モードに“M(追加)”を、異常時の処置に“K(保存)”を指定してください。
- 世代管理(GENCTL)
-
集信ファイルの世代管理の有無
- N
-
: 世代管理なし
- Y
-
: 世代管理あり
“Y(世代管理あり)”を指定するときは、登録モードに“N(新規作成)”または“R(置き換え)”を、異常時の処置に“D(削除)”を指定してください。
- 世代管理数(GENMNGNO)
-
集信ファイルの世代管理数
世代管理に“Y(世代管理あり)”を指定した場合に指定します。世代管理に“N(世代管理なし)”を指定した場合は、“0”を指定します。
- EBCDICセット(CODESET)
-
1バイトコードを変換するときに使用するEBCDIC系コードセット
配信側ホスト(相手ホスト)のEBCDICセットを指定します。
- 0
-
: 自動
- A
-
: EBCDICカナ文字
- B
-
: EBCDIC英小文字
- C
-
: EBCDIC-ASCII
- D
-
: EBCDIC-ASPEN
- E
-
: IBM英小文字
- F
-
: IBM英小文字拡張
- G
-
: NECカナ文字
- H
-
: IBMカナ文字拡張
- I
-
: 中国語簡体字拡張
- V
-
: ユーザテーブル1
- W
-
: ユーザテーブル2
- X
-
: ユーザテーブル3
省略すると“0(自動)”が設定されます。
この設定は、配信側ホストがMF-IBMi系機種で、集信側変換の場合に有効です。
- 正常時ジョブID(JOBID)
-
ファイルの集信が正常終了したときに起動するジョブID
ジョブIDの詳細は「ジョブ起動情報」を参照してください。
省略すると、ジョブは起動されません。
- 異常時ジョブID(EJOBID)
-
ファイルの集信が異常終了したときに起動するジョブID
ジョブIDの詳細は、「ジョブ起動情報」を参照してください。
省略すると、ジョブは起動されません。
集信管理情報更新画面(拡張)
- 集信完了通知(JOBWAIT)
-
配信側ホストへの集信完了通知
- T(受信完了)
-
: 受信完了後に通知
- J(正常時ジョブ完了)
-
: 集信後正常時ジョブ完了後に通知
省略すると“T(受信完了)”が設定されます。
- 転送グループID(GRPID)
-
集信ファイルの転送グループID
転送グループIDの詳細は、「転送グループ情報」を参照してください。
- データ検証(DATAVERIFY)
-
集信するファイルに対するデータ検証の有無
- 0
-
: データ検証を行わない
- 1
-
: データ検証を行う
省略すると“0(データ検証を行わない)”が設定されます。
- 暗号キー(高強度暗号強制モードが無効)(PASSWORD)
-
データを復号するキー
暗号化されたデータを復号する場合に指定します。
相手ホストの配信管理情報に設定されている暗号キーと同じ暗号キーを設定してください。異なる暗号キーを設定した場合、データは正しく復号されません。
また、集信側で暗号キーが指定されていても配信側の配信管理情報で暗号キーが指定されていない場合、集信側の暗号キーの設定は無視されます。
- 暗号キー(高強度暗号強制モードが有効)(PASSWORD)
-
データを復号するキー
暗号化されたデータを復号する場合に指定します。
相手ホストの配信管理情報に設定されている暗号キーと同じ暗号キーを設定してください。異なる暗号キーを設定した場合、データは正しく復号されません。
暗号キーの値を必ず指定してください。配信側が高強度暗号強制モードでない場合は転送エラーになります。
(3) 設定時の注意点
ファイルID
ファイルID(RCVFILE)に“_INSTANT_TRANSFER_”というファイルIDは登録できません。
登録モード、集信形態、世代管理の指定
集信管理情報での指定できる組み合わせは以下のとおりです。
登録モード |
異常時処置 |
集信形態 |
|||
---|---|---|---|---|---|
単一集信(S) |
複数集信(M) |
||||
世代管理 |
世代管理 |
世代管理 |
世代管理 |
||
あり(Y) |
なし(N) |
あり(Y) |
なし(N) |
||
新規作成(N) |
削除(D) |
○ |
○ |
|
|
保存(K) |
|
○ |
|
|
|
復元(R) |
|
○ |
|
|
|
置き換え(R) |
削除(D) |
○ |
○ |
|
|
保存(K) |
|
○ |
|
|
|
復元(R) |
|
○ |
|
|
|
追加(M) |
削除(D) |
|
○ |
|
|
保存(K) |
|
○ |
|
○ |
|
復元(R) |
|
○ |
|
|
○ |
: |
組み合わせ可 |
空欄 |
: |
組み合わせ不可 |
集信形態
-
“M(複数集信)”指定時の留意点
集信中にデータは一時ファイルに格納され、集信完了後に集信ファイルにコピーされるので運用に十分な注意が必要です。
異常時の処置
-
“D(削除)”指定時の留意点
登録モードで“N(新規作成)”を選択した場合、集信ファイルがすでに存在してエラーになると、存在していたファイルは削除しません。
-
“K(保存)”指定時の留意点
集信形態で“M(複数集信)”を選択した場合、一時ファイルへの集信中に異常が発生すると、そこまでの集信データは集信ファイルに書かれません。また、一時ファイルを集信ファイルにコピー中に異常が発生すると、そこまでの集信データは追加書きされてしまいます。よって、アプリケーションプログラムでデータの重複をチェックする仕組みが必要となります。
集信完了通知
集信完了通知(JOBWAIT)に“J(正常時ジョブ完了)”を指定すると、集信後ジョブが終了するまで集信側から配信側に完了通知がされないため、配信側でタイムアウトが発生する可能性があります。タイムアウト時間の設定に注意してください。
メッセージの置換
以下の項目に“$MSG0”~“$MSG5”または“$MSGL0”~“$MSGL1”を指定すると、送信要求時に指定したメッセージや配信側より送信されたメッセージに置換します。
-
集信ファイル名
-
転送グループID
-
正常時ジョブID
相手ホストの言語設定によっては、メッセージの置換が正しく行われず、転送に失敗する場合があります。
メッセージ送信の注意点については「アドミニストレーション マニュアル」を参照してください。
集信ファイル名
-
以下のいずれかを指定するときは、集信形態に“S(単一集信)”を指定してください。
-
“$SNDFILE”
-
“$MSG0”~“$MSG5”
-
“$MSGL0”~“$MSGL1”
-
-
配信ファイル名に2バイトコードが含まれる場合、エラーとなります。
-
“$SNDFILE”の後に文字は指定できません。
-
“$SNDFILE”を指定することにより、配信側の配信ファイル名を集信ファイル名とします。
-
配信側がHULFT for UNIX/Linuxの場合、“$SNDPATH”を指定することにより、配信側のパス名を集信ファイルのパス名とします。
-
配信側がHULFT for UNIX/Linux以外の場合、“$SNDPATH”は変換されません。
-
集信ファイル名を置換する場合、相手ホストの言語設定によっては、配信側の配信ファイル名を集信ファイル名に正しく置換できず、転送に失敗することがあります。
詳細は、「アドミニストレーション マニュアル」を参照してください。
-
“$SNDPATH”を使用する場合は、“$SNDFILE”も同時に指定してください。“$SNDPATH”のみでは指定できません。
-
配信ファイル名を集信ファイル名とする際の命名規則を以下に示します。
表2.6 ファイル命名規則
機種
集信ファイル名(UNIXまたはLinux)
配信ファイル名
$SNDPATH$SNDFILE
$SNDFILE
/usr/$SNDFILE
Mainframe
順編成ファイル
HULFT.DAT.SND.F01
HULFT.DAT.SND.F01
HULFT.DAT.SND.F01
/usr/HULFT.DAT.SND.F01
区分編成ファイル
HULFT.DAT.F02(SND)
HULFT.DAT.SND.F02
HULFT.DAT.SND.F02
/usr/HULFT.DAT.SND.F02
UNIXまたはLinux
/hulft/dat/snd.f03
/hulft/dat/snd.f03
snd.f03
/usr/snd.f03
Windows
c:\hulft\dat\snd.f04
snd.f04
snd.f04
/usr/snd.f04
IBMi
hulft/f05(snd)
snd.f05
snd.f05
/usr/snd.f05
MF-IBMi系機種から中国語データを集信する場合
EBCDICセット(CODESET)に“I(中国語簡体字拡張)”を設定してください。
システム動作環境設定の転送コードセット(cs4trnsfr)に“G(GB18030)”または“8(UTF-8)”が設定されていることを確認してください。
EBCDICセットを“自動”に設定した場合の動作
EBCDICセット(CODESET)に“0(自動)”を設定した場合、ファイル転送時の1バイトコード変換で実際に使用されるEBCDICセットの値は、以下のように決定されます。
自ホストの転送コードセット |
相手ホストの転送コードセット |
||||||||
---|---|---|---|---|---|---|---|---|---|
UTF-8 |
SHIFT-JIS |
EUC-JP |
GB18030 |
IBM |
JEF |
KEIS |
NEC |
IBM |
|
SHIFT-JIS |
- |
- |
- |
× |
F |
A |
D |
G |
× |
EUC-JP |
- |
- |
- |
× |
F |
A |
D |
G |
× |
UTF-8 |
- |
- |
- |
- |
F |
A |
D |
G |
I |
GB18030 |
- |
× |
× |
- |
× |
× |
× |
× |
I |
- |
: |
EBCDICセットの値は、ファイル転送時のコード変換で使用されない |
× |
: |
ファイル転送時にコード変換できない組み合わせ |
A |
: |
EBCDICカナ文字 |
D |
: |
EBCDIC-ASPEN |
F |
: |
IBM英小文字拡張 |
G |
: |
NECカナ文字 |
I |
: |
中国語簡体字拡張 |
自ホストのコードセットを登録するシステム動作環境設定の転送コードセット(cs4trnsfr)の詳細は、「アドミニストレーション マニュアル」を参照してください。
相手ホストのコードセットを登録する転送コードセット(KCODETYPE)の詳細は、「詳細ホスト情報」を参照してください。