Resend File Issuance command

If a problem occurs during sending-side transferring and the sending operation is interrupted, information about the failed file transfer is stored to the Resent Queue file. You can issue a Resend File request for any file whose information is stored in the Resend Queue file.

The Resend File usually sends data from the point (in data) where the error occurred (Checkpoint Resend File). To resend from the beginning of the file instead, specify the parameter "NP".

= Remarks =

For an instant transfer, resending cannot be performed.

Program interface

CALL library name/UTLSEND PARM(['LIB=library name'] ['F=fileid'] 
 {'R'|'R=hostname'} ['FILE=filename'] ['NP'] ['G'] ['OUTPUT=filename'] 
 ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

F=fileid

File ID that is used for resending (Optional)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

When omitted, all file IDs stored in the Resend Queue are targeted by this command.

R|R=hostname

Resend File (Mandatory)

When you specify the host name, HULFT executes the Resend File, addressing to the specified host name. When you specify only R parameter, all the hosts in the Resend Queue will become the targets of this command.

Specify the host name as an alphanumeric character string of 68 bytes or less.

FILE=filename

File ID that is used for resending (Optional)

For a physical data file, specify the name in the format of Library name/File name(Member name). For an archive file, specify the name in the format of Library name/File name.

When omitted, all the file names in the Resend Queue become the targets of this command.

Specify the file names that have already been placed in the Resend Queue. This is not a parameter that dynamically specifies a file to resend.

NP

Resend file from the beginning (Optional)

When omitted, HULFT executes Checkpoint Resend File.

G

Control of error messages that the Resend File command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Resend File command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Resend File command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must immediately follow the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

Note

To perform Checkpoint Resend File, the following conditions must be fully met: If one of the following conditions is not satisfied, HULFT carries out resending from the beginning:

The Registration Mode in the Receive Management Information is set to "N" (New Creation) or "R" (Replace)
Error Handling in the Receive Management Information is set to "K" (Keep)
The Receive Mode in the Receive Management Information is set to "S" (Single Receive)
The Receive file is a physical data file

= Remarks =

When issuing Resend File, HULFT does not execute pre-send job even if its job ID is registered. Besides, the Synchronous Transfer function and the Message Transmission function are not available. However, the messages that are specified on executing the Send File or the Send Request are taken over.

Command interface

UTLSEND HOSTNAME( ) FILEID( ) RSDFILE( ) RSDMBR( ) RSDFATR( ) CHKP( ) LIBRARY( ) 
MSG( ) FILE( ) MBR( )

Explanation of parameters

HOSTNAME

Name of the remote host which is the destination of resending (Mandatory)

Specify this parameter as an alphanumeric character string of 68 bytes or less.

If "*ALL" is specified, all the host names on the Resend Queue become the target of this command.

FILEID

File ID that is used for resending (Optional)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

When omitted, all file IDs stored in the Resend Queue are targeted by this command.

RSDFILE

File ID that is used for resending (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, all the file names in the Resend Queue become the targets of this command.

RSDMBR

Member name of the file to resend ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

When omitted, the same file name as the file that is specified for the RSDFILE parameter is used.

RSDFATR

Attribute of the file to resend (*PF by default)

*PF :: Physical file
*SAVF :: Archive file

If you specify "*SAVF" for this parameter, HULFT does not use the value of the RSDMBR.

CHKP

Specification of checkpoint ("*YES" by default)

*NO :: Resend File started from the beginning.
*YES :: Resend File started from the point where an error occurred.

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.