Resend Request Issuance command

You can use the Resend Request Issuance command to request resending a file when receiving the file failed for some reason.

Before you execute the Resend Request Issuance command, make sure that the Send Acknowledge job and the Observe job are running on the remote host and that the Receive Acknowledge job is running on the local host.

By default, the Resend Request Issuance command allows you to receive data from the point (in data) where the error occurred (Checkpoint Resend Request). To receive the file from the beginning, specify parameter "NP".

Program interface

CALL Library name/UTLRECV PARM(['LIB=Library name'] 'R' 'H=hostname' 
   ['F=fileid'] ['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.

R

Resend Request (Mandatory)

H=hostname

Name of remote host to which you submit a request for resending (Mandatory)

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

F=fileid

File ID that is used for the Resend Request (Optional)

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

When omitted, HULFT sends all the files in the Resend Queue that are addressed to the host that you specified.

NP

Resend Request started from the beginning (Optional)

When omitted, Checkpoint Resend Request is executed.

G

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

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Resend Request 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 Request 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 Request, the following conditions must be fully met: If one of the following conditions is not satisfied, HULFT carries out resending from the beginning:

  • 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)

  • 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 Request, HULFT does not execute the 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

UTLRECV HOSTNAME( ) FILEID( ) RESEND( ) CHKP( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

HOSTNAME

Name of remote host to which you submit a request for resending (Mandatory)

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

FILEID

File ID that is used for the Resend Request (Optional)

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

When omitted, HULFT sends all the files in the Resend Queue that are addressed to the host that you specified.

RESEND

Resend Request (Mandatory)

*NO :

Do not submit the Resend Request.

*YES :

Submit the Resend Request.

Specify "*YES" whenever you submit the Resend Request.

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.