# 集信管理情報

集信するファイルのファイル情報を登録します。以下の登録方法があります。

- HULFT管理画面による登録

  ⇒「集信管理情報を操作する」参照

- パラメーターファイル指定によるコマンド登録

  ⇒「管理情報バッチ登録コマンド」参照

## 項目一覧

以下の表の「省略」は、HULFT管理画面による登録の場合の値です。コマンド登録の場合、省略可否がHULFT管理画面とは異なる場合があります。

コマンド登録の場合の省略可否については、「管理情報バッチ登録コマンド」を参照してください。

表2.3 集信管理情報項目一覧

項目値 | 初期値 | 設定値 | 省略 | 備考
--- | --- | --- | --- | ---
画面 | ファイル
ファイル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 | ○ |
暗号キー（高強度暗号強制モードが無効）(*3) | PASSWORD |  | 英数字 | ○ | 8～20バイト
暗号キー（高強度暗号強制モードが有効）(*4) | 16進文字列 | × | 64桁

○ | : | 省略可
× | : | 省略不可

*1 | : | オーナー名（OWNER）またはグループ名（GROUP）のどちらか一方のみの省略はできません。
*2 | : | ファイルの読み、および書きは“1”、実行は“0”となります。
*3 | : | システム動作環境設定の高強度暗号強制モード（strongkeymode）で“0（無効）”を設定した場合に設定できます。
*4 | : | システム動作環境設定の高強度暗号強制モード（strongkeymode）で“1（有効）”を設定した場合に設定する必要があります。

## 各項目の説明

集信管理情報に設定する各項目について説明します。（ ）内はパラメーターファイル使用時に指定する項目名です。

ファイルID（RCVFILE）

  集信するファイルを認識するためのID

コメント（COMMENT）

  集信するファイルに対するコメント

### 集信管理情報更新画面

ファイル名（FILENAME）

  集信するファイル

  絶対パスで指定します。

  HULFT10のEnterpriseグレードを導入した環境ではネットワーク資源を利用したファイルを指定できます。詳細は、以下を参照してください。

  HULFT10 for Linux/AIX アドミニストレーション マニュアル : ネットワークファイルについて

オーナー名（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（追加）

    : 既存ファイルの最後に受信データを追加。

    ファイルが存在しない場合は新規作成。

異常時の処置（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（自動）”が設定されます。

  この設定は、配信側ホストがEBCDIC系コードセットで、集信側変換の場合に有効です。

  = 備考 =

  “D（EBCDIC-ASPEN）”および“G（NECカナ文字）”は非推奨です。

  “D（ASPEN）”または“G（NECカナ文字）”を指定すると、変換できなくなる可能性があります。

  その他のコードセットをご利用ください。

正常時ジョブID（JOBID）

  ファイルの集信が正常終了したときに起動するジョブID

  ジョブIDの詳細は「ジョブ起動情報」を参照してください。

  省略すると、ジョブは起動されません。

異常時ジョブID（EJOBID）

  ファイルの集信が異常終了したときに起動するジョブID

  ジョブIDの詳細は、「ジョブ起動情報」を参照してください。

  省略すると、ジョブは起動されません。

### 集信管理情報更新画面（拡張）

集信完了通知（JOBWAIT）

  配信側ホストへの集信完了通知

  T（受信完了）

    : 受信完了後に通知

  J（正常時ジョブ完了）

    : 集信後正常時ジョブ完了後に通知

  省略すると“T（受信完了）”が設定されます。

転送グループID（GRPID）

  集信ファイルの転送グループID

  転送グループIDの詳細は、「転送グループ情報」を参照してください。

データ検証（DATAVERIFY）

  集信するファイルに対するデータ検証の有無

  0

    : データ検証を行わない

  1

    : データ検証を行う

  省略すると“0（データ検証を行わない）”が設定されます。

暗号キー（高強度暗号強制モードが無効）（PASSWORD）

  データを復号するキー

  暗号化されたデータを復号する場合に指定します。

  相手ホストの配信管理情報に設定されている暗号キーと同じ暗号キーを設定してください。異なる暗号キーを設定した場合、データは正しく復号されません。

  また、集信側で暗号キーが指定されていても配信側の配信管理情報で暗号キーが指定されていない場合、集信側の暗号キーの設定は無視されます。

暗号キー（高強度暗号強制モードが有効）（PASSWORD）

  データを復号するキー

  暗号化されたデータを復号する場合に指定します。

  相手ホストの配信管理情報に設定されている暗号キーと同じ暗号キーを設定してください。異なる暗号キーを設定した場合、データは正しく復号されません。

  暗号キーの値を必ず指定してください。配信側が高強度暗号強制モードでない場合は転送エラーになります。

## 設定時の注意点

ファイルID

ファイルID（RCVFILE）に“_INSTANT_TRANSFER_”というファイルIDは登録できません。

登録モード、集信形態、世代管理の指定

集信管理情報での指定できる組み合わせは以下のとおりです。

表2.5 集信管理情報の組み合わせ

登録モード | 異常時処置 | 集信形態
--- | --- | ---
単一集信（S） | 複数集信（M）
世代管理 | 世代管理 | 世代管理 | 世代管理
あり（Y） | なし（N） | あり（Y） | なし（N）
新規作成（N） | 削除（D） | ○ | ○ |  |
保存（K） |  | ○ |  |
復元（R） |  | ○ |  |
置き換え（R） | 削除（D） | ○ | ○ |  |
保存（K） |  | ○ |  |
復元（R） |  | ○ |  |
追加（M） | 削除（D） |  | ○ |  |
保存（K） |  | ○ |  | ○
復元（R） |  | ○ |  |

○ | : | 組み合わせ可
空欄 | : | 組み合わせ不可

異常時の処置

- “D（削除）”指定時の留意点

  - 登録モードで“N（新規作成）”を選択した場合、集信ファイルがすでに存在してエラーになると、存在していたファイルは削除しません。

  - システム動作環境設定の転送関連ファイルの削除モード（trnsfr_file_del）に“復元不可能モード（1）”を指定していた場合、処理中に集信データを削除する必要があるときは、復元不可能な状態で削除されます。

- “K（保存）”指定時の留意点

  - 集信形態で“S（単一集信）”、登録モードで“M（追加）”を選択した場合、集信中に何らかの異常が発生すると、異常が発生する前までの集信データは追加書きされます。

  - 集信形態で“M（複数集信）”を選択した場合、一時ファイルへの集信中に異常が発生すると、そこまでの集信データは集信ファイルに書かれません。また、一時ファイルを集信ファイルにコピー中に異常が発生すると、そこまでの集信データは追加書きされてしまいます。よって、アプリケーションプログラムでデータの重複をチェックする仕組みが必要となります。

- “R（復元）”指定時の留意点

  システム動作環境設定の転送関連ファイルの削除モード（trnsfr_file_del）に“復元不可能モード（1）”を指定していた場合、転送が失敗したときに削除する集信ファイルは復元不可能となります。また、転送が成功したときに削除するバックアップファイルは復元不可能となります。

集信形態

- “M（複数集信）”指定時の留意点

  - 集信中にデータは一時ファイルに格納され、集信完了後に集信ファイルにコピーされるので運用に十分な注意が必要です。

  - システム動作環境設定の転送関連ファイルの削除モード（trnsfr_file_del）に“復元不可能モード（1）”を指定していた場合、処理中に集信したデータを削除する必要があるときは、復元不可能な状態で削除されます。

世代管理（GENCTL）

システム動作環境設定の転送関連ファイルの削除モード（trnsfr_file_del）に“復元不可能モード（1）”を指定していた場合、処理中に集信したデータを削除する必要があるときは、復元不可能な状態で削除されます。

集信完了通知

集信完了通知（JOBWAIT）に“J（正常時ジョブ完了）”を指定すると、集信後ジョブが終了するまで集信側から配信側に完了通知がされないため、配信側でタイムアウトが発生する可能性があります。タイムアウト時間の設定に注意してください。

メッセージの置換

以下の項目に“$MSG0”～“$MSG5”または“$MSGL0”～“$MSGL1”を指定すると、送信要求時に指定したメッセージや配信側より送信されたメッセージに置換します。

- 集信ファイル名

- 転送グループID

- 正常時ジョブID

相手ホストの言語設定によっては、メッセージの置換が正しく行われず、転送に失敗する場合があります。

メッセージ送信の注意点については、以下を参照してください。

HULFT10 for Linux/AIX アドミニストレーション マニュアル : メッセージ送信

集信ファイル名

- 以下のいずれかを指定するときは、集信形態に“S（単一集信）”を指定してください。

  - “$SNDFILE”

  - “$MSG0”～“$MSG5”

  - “$MSGL0”～“$MSGL1”

- 配信ファイル名に2バイトコードが含まれる場合、エラーとなります。

- “$SNDFILE”の後に文字は指定できません。

- “$SNDFILE”を指定することにより、配信側の配信ファイル名を集信ファイル名とします。

- 配信側がHULFT for UNIX/Linuxの場合、“$SNDPATH”を指定することにより、配信側のパス名を集信ファイルのパス名とします。

- 配信側がHULFT for UNIX/Linux以外の場合、“$SNDPATH”は変換されません。

- 集信ファイル名を置換する場合、相手ホストの言語設定によっては、配信側の配信ファイル名を集信ファイル名に正しく置換できず、転送に失敗することがあります。

  詳細は、以下を参照してください。

  HULFT10 for Linux/AIX アドミニストレーション マニュアル : 集配信関連設定

- “$SNDPATH”を使用する場合は、“$SNDFILE”も同時に指定してください。“$SNDPATH”のみでは指定できません。

- 配信ファイル名を集信ファイル名とする際の命名規則を以下に示します。

  表2.6 ファイル命名規則

  機種 | 集信ファイル名（LinuxまたはAIX）
  --- | ---
  配信ファイル名 | $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
  LinuxまたはAIX
  | /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
  Container
  | /hulft/dat/snd.f06 | /hulft/dat/snd.f06 | snd.f06 | /usr/snd.f06

MF-IBMi系機種から中国語データを集信する場合

EBCDICセット（CODESET）に“I（中国語簡体字拡張）”を設定してください。

システム動作環境設定の転送コードセット（cs4trnsfr）に“G（GB18030）”または“8（UTF-8）”が設定されていることを確認してください。

EBCDICセットを“自動”に設定した場合の動作

EBCDICセット（CODESET）に“0（自動）”を設定した場合、ファイル転送時の1バイトコード変換で実際に使用されるEBCDICセットの値は、以下のように決定されます。

表2.7 自動的に決定されるEBCDICセットの値

自ホストの転送コードセット | 相手ホストの転送コードセット
--- | ---
UTF-8 | SHIFT-JIS | EUC-JP | GB18030 | IBM 漢字 | JEF | IBM 簡体字
SHIFT-JIS | － | － | － | × | F | A | ×
EUC-JP | － | － | － | × | F | A | ×
UTF-8 | － | － | － | － | F | A | I
GB18030 | － | × | × | － | × | × | I

－ | : | EBCDICセットの値は、ファイル転送時のコード変換で使用されない
× | : | ファイル転送時にコード変換できない組み合わせ
A | : | EBCDICカナ文字
F | : | IBM英小文字拡張
I | : | 中国語簡体字拡張

自ホストのコードセットを登録するシステム動作環境設定の転送コードセット（cs4trnsfr）の詳細は、以下を参照してください。

HULFT10 for Linux/AIX アドミニストレーション マニュアル : コード変換関連設定

相手ホストのコードセットを登録する転送コードセット（KCODETYPE）の詳細は、「詳細ホスト情報」を参照してください。