List of Receive Management Information fields

You can register file information about the file to be received (called Receive file or receive target file). For the registration method, refer to Using the Receive Management Information.

Field List

Table 4.53 List of Receive Management Information Fields

Field Name

Default Value

Setting Value

Optional

Remarks

Screen

File

File ID

RCVFILE

 

Uppercase alphanumeric characters and "_"

-

Within 50 bytes

Comment

COMMENT

 

Characters

Within 60 bytes (*1)

Basic Settings

 

File Name

FILENAME

 

Characters

-

Within 200 bytes (*2)

Registration Mode

TRANSMODE

New Creation (N)

(*3)

-

 

Error Handling

ABNORMAL

Delete (D)

(*3)

-

 

Receive Mode

RCVTYPE

Single Receive (S)

(*3)

-

 

Generational Management

GENCTL

No (N)

(*3)

-

 

No. of Generations

GENMNGNO

 

0, 2–9999

 

EBCDIC Set

CODESET

Autoconfiguration

(*3)

(*4)

EBCDIC Code Set

CODESET

(*5)

(*3)

(*6)

Successful Job ID

JOBID

 

Alphanumeric characters and "_"

Within 50 bytes

Unsuccessful Job ID

EJOBID

 

Alphanumeric characters and "_"

Within 50 bytes

Extension Settings

 

Notification

JOBWAIT

Receive Completion (T)

(*3)

 

Transfer Group ID

GRPID

 

Alphanumeric characters and "_"

Within 50 bytes

Verify Data

DATAVERIFY

No (0)

(*3)

 

Mail Interface ID

MAILID

 

Uppercase alphanumeric characters

Within 50 bytes

Cipher Key (when Forced Strong Key mode is disabled) (*7)

PASSWORD

 

Alphanumeric characters

8–20 bytes

Cipher Key (when Forced Strong Key mode is enabled) (*8)

Hexadecimal character string

-

64 digits

:

Optional

-

:

Mandatory

*1

:

On the HULFT Manager Management Console, you can enter a string of up to 60 characters. When the destination host is HULFT Ver.8.1 or higher, the size of the string that you entered will be checked based on the code set that is set in HULFT at the connection destination. When HULFT checks and confirms that the size of the string meets the condition that is given in the remarks, the characters that you entered will be saved in HULFT.

*2

:

On the HULFT Manager Management Console, you can enter a string of up to 200 characters. When the destination host is HULFT Ver.8.1 or higher, the size of the string that you entered will be checked based on the code set that is set in HULFT at the connection destination. When HULFT checks and confirms that the size of the string meets the condition that is given in the remarks, the characters that you entered will be saved in HULFT.

*3

:

For the HULFT Manager Management Console, click a setting value on the pulldown list.

*4

:

This field is displayed when HULFT Manager connects to HULFT Ver.8.1 or higher.

*5

:

The default value varies depending on the setting of HULFT Operation Language (hullang) in the System Environment Settings on the destination host.

  • When HULFT Operation Language is set to 'JPN' (Japanese)

    'Kana' (A) is set.

  • When HULFT Operation Language is set to 'ENG' (English)

    'Standard' (E) is set.

*6

:

This field is displayed when HULFT Manager connects to HULFT lower than Ver.8.1.

*7

:

This type of cipher key can be set in either of the following cases:

  • HULFT of a version lower than Ver.8.4.0 is installed on the remote host

  • HULFT Ver.8.4.0 or higher is installed and Forced Strong Key Mode (strongkeymode) is set to "0 (Disabled)" on the remote host

*8

:

This type of cipher key must be set in either of the following cases:

  • HULFT Ver.8.4.0 or higher is installed and Forced Strong Key Mode (strongkeymode) is set to "1 (Enabled)" on the remote host

Explanation of each field

This section explains the fields to be specified in the Receive Management Information. The parenthesized strings are the names of each field and you can use them as field tags in a parameter file when registering the information.

File ID (RCVFILE)

ID that identifies the Receive file

Comment (COMMENT)

Comment for the Receive file

Basic Settings

File Name (FILENAME)

Name of the Receive file

Specify the file name with a full path.

In HULFT10 Server grade environments, you can specify a file that uses network resources.

For details on networked files, refer to Windows Administration Manual.

Registration Mode (TRANSMODE)

Registration mode for the Receive file

New Creation (N):

Create new Receive files.

When you use an existing file name, an error occurs.

Replace (R):

Replace the content of an existing file with received data.

A new file is created if the file does not exist.

Append (M):

Append the received data to the end of the existing files.

A new file is created if the file does not exist.

When Receive Mode (RCVTYPE) is set to 'Single Receive (S)' and Registration Mode (TRANSMODE) is set to 'Append (M)' and an error occurs during receiving, Receive data obtained before the occurrence of the error will be appended.

Error Handling (ABNORMAL)

Handling of the Receive file when the Receive processing fails

Delete:

Delete the Receive file.

Keep:

Keep the Receive file as it is when the Receive processing fails.

Restore:

Back up the Receive file before the Receive processing starts and restore the Receive file from the backup if the Receive processing fails.

If the Receive file does not exist before the Receive processing starts, HULFT operates in the same way as when you specify 'Delete.'

Receive Mode (RCVTYPE)

Specify how the Receive file or Receive files are received

Single Receive (S):

File is received from a single host.

Multiple Receive (M):

File is received from multiple hosts and one file is created.

If you specify 'Multiple Receive (M),' you must specify 'Append (M)' for Registration Mode and 'Keep (K)' for Error Handling (ABNORMAL).

Generational Management (GENCTL)

Select whether to apply a generational management to the Receive file

No (N):

Generational management is disabled.

Yes (Y):

Generational management is enabled.

When you specify 'Yes (Y),' specify the following settings:

  • 'New Creation (N)' or 'Replace (R)' for Registration Mode

  • 'Delete (D)' for Error Handling

No. of Generations (GENMNGNO)

Number of generations used for managing the Receive file

The setting value is valid only when Generational Management (GENCTL) is set to 'Yes (Y).'

EBCDIC Set (CODESET)

Specify Type-EBCDIC Code Set that is used for the conversion of single-byte codes

Specify the EBCDIC Set for the sending-side host.

This field is displayed when HULFT Manager connects to HULFT Ver.8.1 or higher.

  • Autoconfiguration (0)

  • Katakana (A)

  • Lower Case (B)

  • ASCII (C)

  • ASPEN (D)

  • Japan (Latin) for IBM (E)

  • Japan (Latin) Extended for IBM (F)

  • NEC Katakana (G)

  • Japan (Katakana) Extended for IBM (H)

  • Simplified Chinese Extended (I)

  • User Table 1 (V)

  • User Table 2 (W)

  • User Table 3 (X)

Omitting this field sets 'Autoconfiguration (0).'

This setting is valid when the host on the sending side uses the Type-EBCDIC Code Set and you specify receiving-side conversion.

EBCDIC Code Set (CODESET)

Specify Type-EBCDIC Code Set that is used for the conversion of single-byte codes

Specify the EBCDIC Set for the sending-side host.

This field is displayed when HULFT Manager connects to HULFT lower than Ver.8.1.

  • Kana (A)

  • Lower Case (B)

  • ASCII (C)

  • ASPEN (D)

  • Standard (E)

  • Standard Extension (F)

  • NEC Kana (G)

  • Kana Extension (H)

  • User Table 1 (V)

  • User Table 2 (W)

  • User Table 3 (X)

This setting is valid when the host on the sending side is a Type MF-IBMi host and when you specify receiving-side conversion.

If you omit this setting, the default value varies depending on the setting of HULFT Operation Language (hullang) in the System Environment Settings on the destination host.

  • When HULFT Operation Language is set to 'JPN' (Japanese)

    'Kana' (A) is set.

  • When HULFT Operation Language is set to 'ENG' (English)

    'Standard' (E) is set.

For details on HULFT Operation Language, refer to Windows Administration Manual.

Successful Job ID (JOBID)

ID of the job to be started when the Receive processing of the file ends successfully

For details on job IDs, refer to List of Job Information fields.

If omitted, HULFT does not start the specified job.

Unsuccessful Job ID (EJOBID)

ID of the job to be started when the Receive processing of the file ends unsuccessfully

For details on job IDs, refer to List of Job Information fields.

If omitted, HULFT does not start the specified job.

Extension Settings

Notification (JOBWAIT)

Receive completion notification to be sent to the host on the sending side

Receive Completion (T):

Notify after completion of the Receive processing

Successful Job Completion (J):

Notify upon completion of the successful job (job to be executed in normal situation) after the Receive processing

Omitting this field sets 'Receive Completion (T).'

Transfer Group ID (GRPID)

Transfer group ID of the Receive file

For details on transfer group IDs, refer to List of Transfer Group Information fields.

Verify Data (DATAVERIFY)

Specify whether to verify the data of the file to be received.

No (0):

Do not verify data

Yes (1):

Verify data

Omitting this field sets 'No (0).'

Mail Interface ID (MAILID)

Mail Interface ID when the email is issued after files are received

When you omit this field, HULFT does not interface with email.

Cipher Key (when Forced Strong Key mode is disabled) (PASSWORD)

Key that HULFT uses when decrypting the data

Specify this field to decrypt encrypted data.

Set the same cipher key as the one set in the Send Management Information of the remote host.

If no cipher key is set in the Send Management Information on the sending-side host, the cipher key is not used even when it is set on the receiving-side host.

If the cipher keys are not identical, data is not decrypted correctly.

Cipher Key (when Forced Strong Key mode is enabled) (PASSWORD)

Key that HULFT uses when decrypting the data

Specify this field to decrypt encrypted data.

Set the same cipher key as the one set in the Send Management Information of the remote host.

If the cipher keys are not identical, data is not decrypted correctly.

Points to be noted when configuring settings

File ID

You cannot specify "_INSTANT_TRANSFER_" for File ID (RCVFILE).

Specification of Registration Mode, Receive Mode, and Generational Management

The combinations that can be specified in the Receive Management Information are as follows:

Table 4.54 Combinations of Settings in Receive Management Information

Registration Mode

Error Handling

Receive Mode

Single Receive

Multiple Receive

Generational Management

Generational Management

Generational Management

Generational Management

Enabled

Disabled

Enabled

Disabled

New Creation

Delete

 

 

Keep

 

 

 

Restore

 

 

 

Replace

Delete

 

 

Keep

 

 

 

Restore

 

 

 

Append

Delete

 

 

 

Keep

 

 

Restore

 

 

 

:

Combination that can be specified

Blank

:

Combination that cannot be specified

Error Handling

  • Point to be noted when specifying 'Delete (D)'

    • When 'New Creation (N)' is selected for Registration Mode, if an error occurs because the Receive file already exists, the existing file is not deleted.

    • If "Unrecoverable Mode (1)" is specified for Transfer-Related File Deletion Mode (trnsfr_file_del) in the System Environment Settings, and you need to delete Receive data during the processing, you cannot recover the deleted data.

  • Point to be noted when specifying 'Keep (K)'

    When 'Multiple Receive (M)' is selected for Receive Mode, if there is an error when receiving in a temp file, the received data up to the point of error is not written in the Receive file. However, if there is an error while copying the temp file into the Receive file, the received data up to that point is added. Therefore, there should be a function embedded in your application program to check for duplicate data.

  • Points to be noted when specifying "Restore (R)"

    If "Unrecoverable Mode (1)" is specified for Transfer-Related File Deletion Mode (trnsfr_file_del) in the System Environment Settings, you cannot recover a receive file that is deleted when a transfer fails. In addition, you cannot recover a backup file that is deleted when a transfer completes successfully.

Receive Mode

  • Point to be noted when specifying 'Multiple Receive (M)'

    • You must be careful when carrying out the operation, because during the Receive processing, the data is stored in a temporary file and is copied to the Receive file after the Receive processing is complete.

    • If "Unrecoverable Mode (1)" is specified for Transfer-Related File Deletion Mode (trnsfr_file_del) in the System Environment Settings, and you need to delete data that is received during the processing, you cannot recover the deleted data.

Generational Management

If "Unrecoverable Mode (1)" is specified for Transfer-Related File Deletion Mode (trnsfr_file_del) in the System Environment Settings, and you need to delete data that is received during the processing, you cannot recover the deleted data.

Notification

When 'Successful Job Completion' (J) is specified for Notification (JOBWAIT), a time-out may occur on the remote host, because the remote host does not receive the completion notification until the Post-receive Job ends. Be sure to take this into account when you set the time-out period.

Replacement Message

You can replace variables with messages in the fields that are listed below.

If you use the environment variables from $MSG0 to $MSG5 and from $MSGL0 to $MSGL1 inside the fields below, the variables are replaced with messages when the receiving is carried out. The messages may be assigned by the Send Request command on the receiving side or by the Send File command on the sending side.

  • Receive File Name

  • Transfer Group ID

  • Successful Job ID

  • Mail Interface ID

HULFT may not be able to replace the variables with the messages correctly and the transfer may fail, depending on the language settings on the host on the sending side.

For points to be noted on message transmission, refer to Windows Administration Manual.

Receive File Name

  • When specifying any of the following, specify 'Single Receive (S)' as Receive Mode:

    • '$SNDFILE'

    • '$MSG0' to '$MSG5'

    • '$MSGL0' to '$MSGL1'

  • If specifying '$SNDFILE' or '$SNDPATH' causes the size of the Receive file name to exceed the size that can be specified in the management information, an error occurs before receiving.

  • You cannot specify any character after '$SNDFILE.'

  • By specifying '$SNDFILE,' the Send file name of the sending side is set to the Receive file name.

  • When the host on the sending side is HULFT for Windows, if you specify '$SNDPATH,' the path name of the host on the sending side is set as the path name of the Receive file.

  • When the sending side is not HULFT for Windows, conversion of '$SNDPATH' will not be carried out.

  • When you replace the Receive file name, the transfer may fail because the Receive file name may not be replaced correctly with the Send file name on the host on the sending side depending on the language settings on the host on the sending side. For details, refer to Windows Administration Manual.

  • When using '$SNDPATH,' specify '$SNDFILE' at the same time. You cannot specify only '$SNDPATH.'

  • The naming conventions for using the Send File Name as the Receive File Name are as follows.

    Table 4.55 File Naming Conventions

    Host Type

    Receive File Name (Windows)

    Send File Name

    $SNDPATH$SNDFILE

    $SNDFILE

    c:\usr\$SNDFILE

    Mainframe

     

    Sequential Organization File

    HULFT.DAT.SND.F01

    HULFT.DAT.SND.F01

    HULFT.DAT.SND.F01

    c:\usr\HULFT.DAT.SND.F01

    Partitioned Organization File

    HULFT.DAT.F02(SND)

    HULFT.DAT.SND.F02

    HULFT.DAT.SND.F02

    c:\usr\HULFT.DAT.SND.F02

    UNIX or Linux

     

    /hulft/dat/snd.f03

    snd.f03

    snd.f03

    c:\usr\snd.f03

    Windows

     

    c:\hulft\dat\snd.f04

    c:\hulft\dat\snd.f04

    snd.f04

    c:\usr\snd.f04

    IBM i

     

    hulft/f05(snd)

    snd.f05

    snd.f05

    c:\usr\snd.f05

When HULFT receives Chinese language data from a Type MF-IBMi host

When HULFT Manager connects to HULFT Ver.8.1 or higher to receive Chinese language data from a Type MF-IBMi host, specify 'Simplified Chinese Extended (I)' for EBCDIC Set (CODESET).

Make sure that 'GB18030 (G)' or 'UTF-8 (8)' is specified for Code Set for Transfer (cs4trnsfr) in the System Environment Settings.

Behavior of the operation when "Autoconfiguration" is specified for EBCDIC Set

When HULFT Manager connects to HULFT Ver.8.1 or higher, you can specify 'Autoconfiguration (0)' for EBCDIC Set.

When you specify "Autoconfiguration (0)" for EBCDIC Set (CODESET), the setting value for the EBCDIC Set that is actually used in the single byte code conversion during file transfer is determined as follows.

Table 4.56 Setting value that is automatically determined for the EBCDIC Set

Code Set for Transfer (KCODETYPE) for Host on Receiving Side

Code Set for Transfer (KCODETYPE) for Host on Sending Side

UTF-8

SHIFT-JIS

EUC-JP

GB18030

IBM Kanji

JEF

IBM
Simplified Chinese

SHIFT-JIS

-

-

-

F

A

EUC-JP

-

-

-

F

A

UTF-8

-

-

-

-

F

A

I

GB18030

-

-

I

-

:

The setting value of the EBCDIC Set is not used in code conversion during file transfer.

Blank

:

For these combinations, code conversion cannot be executed during file transfer.

A

:

Katakana

F

:

Japan (Latin) Extended for IBM

I

:

Simplified Chinese Extended

 

For details on Code Set for Transfer (cs4trnsfr) in which the code set of the destination host is registered in the System Environment Settings, refer to Windows Administration Manual.

For details on Code Set for Transfer (KCODETYPE) in which the code set of the host on the sending side is registered, refer to List of Host Information fields.