Resend File

If the Send processing is interrupted due to a problem that occurs during the Send processing, HULFT writes the information on the file the Send processing of which was unsuccessful to the Send Control file (HULFT.QUEUE). When the Resend File is executed, HULFT carries out resending based on the following information that is written in the Send Control file (HULFT.QUEUE):

Host Name
File ID
Dataset Name
Resend Queue List No.

When the Resend File is executed, HULFT resends files from the point at which the Send processing was interrupted (Checkpoint Resend File). In order to start resending from the beginning of the file, define 'NP' on the XRCRD definition card.

Note

To execute the Checkpoint Resend File, all the following conditions must be fulfilled. If any of the following conditions are not fulfilled, resending starts from the beginning of the file:

The Registration Mode (TRANSMODE) in the Receive Management Information is 'R' (Replace)
The Error Handling (ABNORMAL) in the Receive Management Information is 'K' (Keep)
The Receive Mode (RCVTYPE) in the Receive Management Information is 'S' (Single Receive)

= Remarks =

You cannot resend the file that you attempted to send using instant transfer.
When you execute the Resend File, the Pre-send Job is not executed even if a Pre-send Job ID is registered. In addition, the Resend File does not support the Synchronous Transfer function or the message transmission function. However, messages that you define when you execute the Send File or the Send Request are transferred.

(1) Resend File Program (XRRSNDGO)

Program Name

XRRSNDGO

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the explanation of the System Environment Settings in Administration Manual.

Format of definition card

START-TASK=Job name of Send program (Job name for XRSND) 
OPLSELECT=Operation Log Output Option (*1)

When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs.

XRCRD Definition Card

The following shows the format of the definition card for executing the Resend File.

Format of definition card

      a            b       c            d                 e 
[xxxx...xxxx],[xxxxxxxx],[NP],[DSNAME=xxxx...xxxx][,NO=99999999]

= Remarks =

If the definition card spans two lines, use either of the following two methods to define the definition card:

Describe the first line up to column 71, and then insert a hyphen (-) in column 72. Describe the second line starting in column 1.
Describe a line up to a comma (,) that follows a parameter, insert a single-byte space, and then insert a hyphen (-) in column 71 or before.

Input contents of definition card

a. Host name

This parameter defines the name of the remote host to which you intend to execute the Resend File. (Optional)

Specify alphanumeric characters within 50 bytes for this parameter.

Defaulting this parameter sets all host names as targets.

b. File ID

This parameter defines the file ID of the file to be resent. (Optional)

Specify alphanumeric characters within 50 bytes for this parameter.

Defaulting this parameter sends the files for all file IDs that are queued in the Resend Queue with the defined remote host name.

c. NP

This parameter is defined to carry out resending from the beginning of the file. (Optional)

Defaulting this parameter carries out resending from the point at which the Send processing was interrupted (Checkpoint Resend File).

d. Dataset name

This parameter defines the data set name of the Send file that is registered as a record in the Resend Queue. (Optional)

Specify alphanumeric characters within 44 bytes, including the member name for this parameter.

Specify the data set name of the Send file that is queued in the Resend Queue for this parameter. You cannot use this parameter to dynamically specify files to be resent.

Defaulting this parameter sets all data set names as targets.

e. Resend Queue List No.

This parameter defines the serial number that HULFT assigns when HULFT registers the file in the Send Control file (HULFT.QUEUE). (Optional)

Specify a value from '1' to '99999999' for this parameter.

Defaulting this parameter sets all Resend Queue List Numbers as targets.

Note

To execute the Resend File to all Send files that are in the Resend Queue, default the XRCRD definition card when you execute the Resend File program (XRRSNDGO).
In the definition card, if you default a parameter other than the first and last parameters, you cannot omit the corresponding commas. You must include a comma between parameters.
Example 1:
Case where you specify only the Resend Queue List No. and execute the Checkpoint Resend File
```
,,,,NO=00000001
```
Example 2:
Case where you specify only the File ID and resend a file from the beginning of the file
```
,File ID,NP
```

Example of JCL

//XRRSNDGO JOB  CLASS=A,MSGCLASS=B                                              
//XRRSNDGO EXEC PGM=XRRSNDGO,REGION=4096K                                       
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRQUE    DD   DSN=HULFT.QUEUE,DISP=SHR                                        
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//SYSOUT   DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
  ZOS,LOOPTEST                                                                  
//

DD Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XRQUE	HULFT.QUEUE	Send Control File
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File

(2) Resend File Command

You can execute the Resend File by submitting the command on the console.

                                       a           b       c         d           e 
F  Job name of Send program,RESEND,[hostname][,F=fileid],[C=x][,DSN=dsname][,NO=99999999]

                                      c    f 
F  Job name of Send program,RESEND,,[C=x],M=ALL

a. Host name

This parameter defines the name of the remote host to which you execute the Resend File. (Optional)

b. File ID

This parameter defines the file ID of the file to be resent. (Optional)

c. Checkpoint Resend File

This parameter defines whether to carry out resending from the point at which the Send processing was interrupted (Checkpoint Resend File) or from the beginning of the file. (Optional)

Y:: Resend the file from the checkpoint
N:: Resend the file from the beginning of the file

Defaulting this parameter sets 'Y' (Resend the file from the checkpoint).

d. Dataset name

This parameter defines the data set name of the Send file that is registered as a record in the Resend Queue. (Optional)

e. Resend Queue List No.

This parameter defines the serial number that HULFT adds when HULFT registers the file in the Send Control file (HULFT.QUEUE). (Optional)

f. Resending of all files

This parameter is defined to default both the name of the destination host of sending and the file ID and execute a request for resending to all files in the Resend Queue. (Mandatory for resending of all files)

Note

Specify the Host Name for the first operand. When you default the Host Name, you cannot omit the corresponding commas.

Example 1:

Case where you specify only the Resend Queue List No. and execute the Checkpoint Resend File

F Job name of Send program,RESEND,,NO=00000001

Example 2:

Case where you specify only the File ID and resend a file from the beginning of the file

F Job name of Send program,RESEND,,F=File ID,C=N

= Remarks =

There is a limit on the length of commands that you can enter on the console screen.

Therefore, it is recommended that you define the Resend Queue List No. when you execute the Resend File command.