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 :
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]
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).
-
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)
-
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 |