Resend Request

If the Receive processing is interrupted due to a problem that occurs during the Receive processing, you can execute the Resend Request.

Before you run the Resend Request program (XRRSNDRQ), you must run the Receive program (XRRCV) on the local host as well as the Send program (XRSND) and the Observe program (XRACCPT) on the remote host.

When the Resend Request is executed, HULFT receives files from the point at which the Receive processing was interrupted (Checkpoint Resend Request).

In order to start the Receive processing from the beginning of the file, define 'NP' on the XRCRD definition card.

Resend Request Program (XRRSNDRQ)

Program Name

XRRSNDRQ

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the following:

HULFT10 for zOS Administration Manual : Explanation of each field

Format of definition card

HOST-NAME=Local Host Name 
DOMAIN=Local Domain Name 
RETRY=Retry Count on Connection Error 
HSTCHA=Case Options for Local Host Name or Local Domain Name 
TIMEOUT=Socket Read Timeout 
TCPIP=Address Space Name of TCP/IP 
OPLSELECT=Operation Log Output Option (*1) 
SNDSOCKSIZE=Socket Buffer Size for Data Sending 
RCVSOCKSIZE=Socket Buffer Size for Data Receiving

*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.

XRCARD Definition Card

Format of definition card

   a             b        c 
xxxx...xxxx ,[xxxxxxxx] [,NP]

= 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 on which you execute the Resend Request. (Mandatory)

Specify alphanumeric characters within 50 bytes for this parameter.

b. File ID

This parameter defines the file ID for which you execute the Resend Request. (Optional)

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

When you default this parameter, of the file IDs that are queued in the Resend Queue on the remote host that you specified for the Host name and to which you intend to execute the Resend Request, all the files that are specified to be sent to the local host are sent.

c. NP

This parameter is defined to resend the file from the beginning of the file. (Optional)

Defaulting this parameter resends the file from the point at which the Send processing was interrupted (Checkpoint Resend Request).

Note
  • When you default the File ID, be sure to include the corresponding commas on the definition card.

    Example:

    Case where you carry out resending from the beginning of the file without defining the File ID

    HOST01,,NP

  • Defaulting this definition card executes the Resend Request to all hosts that are registered in the Host Information.

  • To execute the Checkpoint Resend Request, 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 =

When you execute the Resend Request, the Pre-send Job is not executed even if the Pre-send Job ID is registered. In addition, the Resend Request does not support the Synchronous Transfer function or the message transmission function. However, messages and long messages that you define when you execute the Send File or the Send Request are transferred.

Example of JCL

//XRRSNDRQ JOB  CLASS=A,MSGCLASS=B                                              
//XRRSNDRQ EXEC PGM=XRRSNDRQ,REGION=4096K                                       
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//IPGET    DD   DSN=HULFT.HOSTS.LOCAL,DISP=SHR                                  
//*SYSTCPD DD   DSN=TCPIVP.TCPPARMS(TCPDATA),DISP=SHR                           
//SYSOUT   DD   SYSOUT=*                                                        
//XRCARD   DD   *                                                               
  ZOS,LOOPTEST                                                                  
//                                                                              

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

XRFILE

HULFT.FILE

Send and Receive Management File

XRHOST

HULFT.HOST

Host Information File

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File

IPGET

HULFT.HOSTS.LOCAL

IP Management File

SYSTCPD

TCPIVP.TCPPARMS(TCPDATA)

TCPIP.DATA Data Set