Joined File Split command

The files that are joined and then transferred can be split and output into separate files. When the command outputs the data into files, HULFT carries out Code Conversion for the joined file based on the information specified at the time the files were joined and on the parameters that are specified.

Format of command

utlbreak -infile filename [-codeset {0|A-I|V-X}] [-shift {c|s}] [-r] [-b] 
       {[-seqnbr number [-outfile filename]...] 
        |[-tgtfile filename [-outfile filename]...] 
        |[-from number] [-to number] [-dir directory]}

Explanation of the parameters

-infile filename

Specify the joined file name (Mandatory)

Specify a file name within 256 bytes.

Both relative and full path formats are valid.

-codeset

Specify the EBCDIC set (Optional)

0:

Autoconfiguration

A:

Katakana (EBCDIC Katakana)

B:

Lower Case (EBCDIC Lower Case)

C:

ASCII (EBCDIC-ASCII)

D:

ASPEN (EBCDIC-ASPEN)

E:

Japan (Latin) for IBM

F:

Japan (Latin) Extended for IBM

G:

NEC Katakana

H:

Japan (Katakana) Extended for IBM

I:

Simplified Chinese Extended

V:

User Table 1

W:

User Table 2

X:

User Table 3

Omitting this parameter sets '0' (Autoconfiguration).

-shift

Specify how HULFT handles shift codes when carrying out Code Conversion (Optional)

c:

Remove shift codes

s:

Convert shift codes into space codes (ASCII:0x20)

Omitting this parameter sets 'c.'

-r

Specify the replacement of an output destination file (Optional)

If omitted, an error occurs when a file with the same name as the split target file name already exists.

-b

Parameter to control whether to output messages when HULFT splits the file (Optional)

If omitted, a message appears each time splitting is complete.

-seqnbr number -outfile filename

Parameter to split the joined file according to the specified sequence numbers in the joined file (Optional)

Specify a number within the range from '1' to '9999' in '-seqnbr.'

Specify an output file name within 256 bytes in '-outfile.'

When you omit '-outfile,' HULFT automatically generates an output file name, based on the joined file name. For details, refer to Naming conventions for output files.

You can repeat the specification up to a maximum of 10 times.

-tgtfile filename -outfile filename

Parameter to split the file according to the file names specified in the joined file (Optional)

Specify a file name within 256 bytes in '-tgtfile.'

Specify an output file name within 256 bytes in '-outfile.'

When you omit '-outfile,' HULFT automatically generates an output file name, based on the joined file name. For details, refer to Naming conventions for output files.

You can repeat the specification up to a maximum of 10 times. For '-tgtfile,' specify the file name that appears when the content of the joined file is displayed. For details, refer to Joined File Display command.

-from number -to number

Parameter to split the file by specifying a range of sequence numbers that are in the joined file (Optional)

Specify a value from '1' to '9999.'

When you omit '-from,' all the numbers up to the number specified in '-to' become targets.

When you omit '-to,' all the numbers from the number specified in '-from' become targets.

HULFT automatically generates an output file name based on the name of the joined file. For details, refer to Naming conventions for output files.

-dir directory

Specify the folder in which to generate the split files (Optional)

Specify the name within 256 bytes.

If you omit this parameter, HULFT splits the file in the folder where the joined file is stored.

When you specify the parameter '-outfile,' the specification overrides the specification of '-dir.'

Note

• You cannot specify '-seqnbr' or '-tgtfile' at the same time as '-from -to.'

• Use '-outfile' in combination with either '-seqnbr' or '-tgtfile.'

  When you specify '-from -to,' you cannot use '-outfile.'

• Be sure to specify '-seqnbr,' '-tgtfile,' or '-from -to'

• When you omit the parameter "-codeset" or when you specify "0" (Autoconfiguration), the setting value for the EBCDIC Set that is used in the code conversion during the split processing is determined as follows.

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

  Code Set for Transfer of Host on Splitting Side	Code Set for Transfer of Host on Joining Side
  	UTF-8	SHIFT-JIS	EUC-JP	GB18030	IBM Kanji	JEF	IBM Simplified Chinese
  SHIFT-JIS	-	-	-		F	A
  UTF-8	-	-	-	-	F	A	I
  GB18030	-			-			I

  -	:	The setting value of the EBCDIC Set is not used in code conversion during the processing for splitting a joined file.
  Blank	:	For these combinations, code conversion cannot be executed during the splitting of a joined file.
  A	:	EBCDIC Katakana
  F	:	Japan (Latin) Extended for IBM
  I	:	Simplified Chinese Extended

  For details on Code Set for Transfer (cs4trnsfr) with which the code set of the host on the splitting side is registered in the System Environment Settings, refer to the following:

  HULFT10 for Windows Administration Manual : Code Conversion

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

• You cannot use the Joined File Split command for networked files that are used in HULFT10 Server grade environments.

Remarks

• If you specify '-dir,' HULFT creates output files in the specified folder.

  If you omit '-dir,' HULFT creates the split files in the folder where the joined file is stored.

• You can repeat the specification of '-seqnbr' or '-tgtfile' up to a maximum of 10 times.

• 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 was split during the processing, you cannot recover the deleted data.