Running the Send program (XRSND)

Run the Send program (XRSND) in advance to carry out the Send processing.

To run the Send program (XRSND), create and execute JCL according to the following description.

(1) Send Program (XRSND)

Program Name

XRSND

Execution parameters (for EXEC statement)

The parameter shown below defines whether or not to delete the records in both the Send Queue and the Resend Queue before running the Send program (XRSND):

[MODE={WARM|COLD|COLD2|COLD3}]

WARM

WARM start

Specifying this parameter keeps the records in the Send Queue and in the Resend Queue, and then runs the Send program (XRSND).

COLD

COLD start

Specifying this parameter deletes the records in the Resend Queue and the corresponding Send work files, and then runs the Send program (XRSND).

COLD2

COLD start 2

Specifying this parameter deletes the records in the Send Queue and the corresponding Send work files, and then runs the Send program (XRSND).

COLD3

COLD start 3

Specifying this parameter deletes the records in both the Send Queue and the Resend Queue and all the corresponding Send work files, and then runs the Send program (XRSND).

If you omit this parameter, the setting of Send Start Mode (SND-START-MODE) in the System Environment Settings is used.

XRSYSIN Definition Card

The XRSYSIN definition 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

PORTNO=Receive Port No. 
TASK-CNT=Send Startup Task Count 
SNDBNO=I/O Buffer Count for Sending 
TCPIP=Address Space Name of TCP/IP 
TASK-ABEND=Abend Processing of Send Subtask 
DOMAIN=Local Domain Name 
HSTCHA=Case Options for Local Host Name or Local Domain Name 
DATACHK=Data Count Check 
RETRY=Retry Count on Connection Error 
TIMEOUT=Socket Read Timeout 
RCVOVER-RTY=Receive Multiplex Level Over Retry 
CLEARMODE=Post-send Clear Mode 
ENDERRMODE=Send Transfer Error Handling 
LOGDELTHRESHOLD=Log Deletion Threshold 
LOGKEEPCOUNT=Log Keep Count 
EBCDIC=Conversion between EBCDIC Codes 
PSCHG=Pack Zone Conversion 
GAIJIFILE=Use Custom Character Table 
GAIJIERR=Process when Custom Character has not been Registered 
INIT-UNIT=UNIT Name of Send Files and Receive Files 
JLIB1=Subsequent Job Addition Step STEPLIB Settings 1 
JLIB2=Subsequent Job Addition Step STEPLIB Settings 1 
JLIB3=Subsequent Job Addition Step STEPLIB Settings 1 
JELIB1=Subsequent Job Addition Step STEPLIB Settings 2 
JELIB2=Subsequent Job Addition Step STEPLIB Settings 2 
JELIB3=Subsequent Job Addition Step STEPLIB Settings 2 
SNDRETRY=Retry Count for Accessing Send Files 
SNDRTIME=Retry Interval for Accessing Send Files 
EUCSP=Space Code Mode During EUC Code Conversion 
KEISSPMODE=KEIS Em-size Space mode 
SOCKERR-AUTORETRY=Retry Count on Auto Resending 
RETRYTIME=Retry Count on Auto Resending or Connection Error 
MSGDYNPARM=Message Dynamic Parameter Specification 
CIPHERTYPE=Encryption Scheme 
DEFER=Deferred Mount 
JCLRETRY=JCL Library Retry Count 
JCLRTIME=JCL Library Retry Interval 
PROCTRANSTYPE=Framed Message Transfer Type 
CNVLENCHK=Handling of Data Exceeded Max Length after Code Conversion 
CONSMSG=User-Specific Message 
OUTSTSKID=Output Subtask ID 
OPLSELECT=Operation Log Output Option (*1) 
HULLANG=HULFT Operation Language 
DATEFMT=Date Format 
SNDSOCKSIZE=Socket Buffer Size for Data Sending 
RCVSOCKSIZE=Socket Buffer Size for Data Receiving 
SND-SEQNO-THRESHOLD=Send SEQ No. Threshold 
RESND-QUELISTNO-THRESHOLD=Resend Queue List No. Threshold 
TTMODE=Transfer Preference 
TTRCVOMIT=Result Handling of Receiving 
TTRCVFILOUTPUT=Output Receive File 
TTPRESNDJOB=Execute Pre-send Job 
TTSNDJOB=Execute Post-send Job 
TTRCVJOB=Execute Post-receive Job 
TTSNDRCVLOG=Output Results to Transfer Logs 
CNSSELECT=Console Message Output Option 
CS4TRNSFR=Code Set for Transfer 
HULCHARSET=HULFT Character Set 
TERMLICENSEKEY=Term License Key 
SERIALNO=Serial Number 
PRODUCTKEY=Product Key 
INDOPTVAR=Indicator Options for Environment Variable 
SND-START-MODE=Send Start Mode 
CONSOLELOG=Output Toggles By Message Severity Level 
CONS-MSGFILTER=Message Filter File 
CONTROL-FILE=System Control File 
STRONGKEYMODE=Forced Strong Key mode
CODE-CONVERSION-LOCATION=Storage for Code Conversion Table
SYSFILEOUTPUTMODE=System File Output Mode

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

 

Example of JCL

//HULSND   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULSND   EXEC PGM=XRSND,REGION=4096K                         
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
[//XREXTLIB DD  DSN=HULFT.LOAD,DISP=SHR]                                        
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//XRQUE    DD   DSN=HULFT.QUEUE,DISP=SHR                                        
//XRLOG    DD   DSN=HULFT.LOG,DISP=SHR                                          
//XRLOG1   DD   DSN=HULFT.LOG.PATH1,DISP=SHR                                    
//XRLOG2   DD   DSN=HULFT.LOG.PATH2,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                           
//SYSUDUMP DD   SYSOUT=*                                                        
//                                                                              

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

XREXTLIB

HULFT.LOAD

HULFT load module library (*1)

XRFILE

HULFT.FILE

Send and Receive Management File

XRHOST

HULFT.HOST

Host Information File

XRQUE

HULFT.QUEUE

Send Control File

XRLOG

HULFT.LOG

Send and Receive Log File ID Key File

XRLOG1

HULFT.LOG.PATH1

Send and Receive Log Host Name Key File

XRLOG2

HULFT.LOG.PATH2

Send and Receive Log Date Key File

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File

IPGET

HULFT.HOSTS.LOCAL

IP Management File

SYSTCPD

TCPIVP.TCPPARMS(TCPDATA)

TCPIP.DATA Data Set

*1

:

If you specify conversion of custom characters on the host on the sending side using a custom character table, you must add the library in which the custom character table is stored. For details on custom character tables, refer to Administration Manual.

Note

When you run the Send program (XRSND), do not execute the START command with an identifier on the console.

= Remarks =

Under ordinary circumstances, register JCL as a cataloged procedure and run it by using the START command.