Running the Receive program (XRRCV)

Program Name

XRRCV

Execution parameters (for EXEC statement)

           a            b         c        d           e               f        
[APPLNM=xxxxxxxx][,MAX-CON=999][,RECCHK][,RWAIT][,RCVRETRY=9999][,RCVRTIME=99999] 
                        g              h               i          j       k     
                [,JOBWTIME=9999][,TIMEOUT=999999][,TCPIP=xxxxx][,SMS][,CHRSET=x]

a. Receive application name

Define the Receive application name that you defined in the PORT management file (HULFT.PROFILE.TCPIP) for this parameter. (Optional)

Set an alphanumeric string within 8 bytes that starts with an uppercase alphabetic character for this parameter.

If you omit this parameter, the setting of Receive Application Name (RCV-APPLNM) in the System Environment Settings is used.

b. Receive Multiplex Level

This parameter defines the maximum number of Receive subtasks that HULFT can issue at the same time. (Optional)

Set a value from '1' to '100' for this parameter.

Setting this parameter as "0" sets "16". When you set a value that exceeds the maximum value for this parameter, the program operates in the same way as when you set '100.'

If you omit this parameter, the setting of Receive Multiplex Level (RCV-MAXCON) in the System Environment Settings is used.

c. Receive record length check

Define this parameter to end the Receive processing with an error if the record length of the received data exceeds the record length of the Receive file. (Optional)

If you omit this parameter, the setting of Receive Record Length Check (RCV-RECCHK) in the System Environment Settings is used.

d. Handling of Receive files while in use

This parameter defines for HULFT to wait if other Receive processing is using the Receive file until that Receive processing is complete, and then to carry out the Receive processing. (Optional)

If you omit this parameter, the setting of Handling of Receive Files While in Use (RCV-FILE-WAIT) in the System Environment Settings is used.

e. Retry count for Receive files

This parameter defines the retry count for retry attempts that HULFT makes if another job is using the Receive file. Set a value from '0' to '9999' for this parameter. (Optional)

If you omit this parameter, the setting of Retry Count for Receive File (RCV-FILE-RETRY) in the System Environment Settings is used.

f. Retry interval for Receive files

This parameter defines the retry interval for retry attempts that HULFT makes if another job is using the Receive file. Set a value for this parameter from '0' to '32760' in seconds. (Optional)

If you omit this parameter, the setting of Retry Interval for Receive File (RCV-FILE-RTIME) in the System Environment Settings is used.

To define the retry interval for Receive files, the retry count for Receive files must be set as a value from '1' to '9999.'

g. Job execution time-out for Post-receive Job

This parameter defines the job time-out for the Post-receive Job when you specify 'J' (Successful Job Completion) for the Notification (RCVEND-NOTICE). Set a value from '1' to '1440' in minutes for this parameter. (Optional)

Setting this parameter as "0" sets "15". When you set a value that exceeds the maximum value for this parameter, the program operates in the same way as when you set '1440.'

If you omit this parameter, the setting of Post-Receive Job Execution Timeout (RCV-JOBWTIME) in the System Environment Settings is used.

If a time-out occurs, HULFT separates the Post-receive Job from the Receive processing and sends a job time-out notification to the host on the sending side.

h. Socket read time-out

This parameter defines the socket read time-out in seconds. (Optional)

Set a value from '10' to '259200' for this parameter.

If you omit this parameter, the setting of Socket Read Timeout (RCV-TIMEOUT) in the System Environment Settings is used.

i. Address space name of TCP/IP

This parameter defines the address space name of TCP/IP. (Optional)

Set an alphanumeric string within 8 bytes that starts with an uppercase alphabetic character for this parameter.

If you omit this parameter, the setting of Address Space Name of TCP/IP (TCPIP) in the System Environment Settings is used.

j. Data set search method

This parameter defines for HULFT to search the catalog to determine if the Receive data set (Receive file) exists. (Optional)

If you omit this parameter, the setting of Search Scope for Receive File (RCV-FILE-SEARCH) in the System Environment Settings is used.

k. Pad character selection

This parameter defines the pad character code that HULFT uses to pad trailing blank parts that come after the record for text transfer or for the Receive processing of a fixed-length file. (Optional)

0:

Pad with NULL

S:

Pad with space code

If you omit this parameter, the setting of Pad Character (RCV-CHRSET) 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.

RCVBNO= I/O Buffer Count for Receiving 
TGRPCHK=Transfer Group Check 
HSTCHK=Host Check 
LOGDELTHRESHOLD=Log Deletion Threshold 
LOGKEEPCOUNT=Log Keep Count 
EBCDIC=Conversion between EBCDIC Codes 
PSCHG=Pack Zone Conversion 
PSEBCDIC=Sign for EBCDIC 
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 
MSGDYNPARM=Message Dynamic Parameter Specification 
CIPHERTYPE=Encryption Scheme 
JCLRETRY=JCL Library Retry Count 
JCLRTIME=JCL Library Retry Interval 
PROCTRANSTYPE=Framed Message Transfer Type 
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 
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 
LISTEN=Queue of Pending Connect 
RCV-APPLNM=Receive Application Name 
RCV-MAXCON=Receive Multiplex Level 
RCV-RECCHK=Receive Record Length Check 
RCV-FILE-WAIT=Handling of Receive Files While in Use 
RCV-FILE-SEARCH=Search Scope for Receive File 
RCV-FILE-RETRY=Retry Count for Receive File 
RCV-FILE-RTIME=Retry Interval for Receive File 
RCV-JOBWTIME=Post-Receive Job Execution Timeout 
RCV-CHRSET=Pad Character 
RCV-TIMEOUT=Socket Read Timeout 
ALLOWINSTTRANS=Allow Instant Transfer from Unregistered Host 
INSTTRANSRCVUNIT=Instant Transfer Receive File Unit 
INSTTRANSRCVSPACE=Instant Transfer Receive File Capacity 
INSTTRANSMFRCVORG=Inter-Mainframe Instant Transfer Receive Attribute Value Source 
INSTTRANSDSNLST=Instant transfer receive file naming file 
INSTTRANSVOLLST=Instant transfer receive volumes file 
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

Example of JCL

//HULRCV   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULRCV   EXEC PGM=XRRCV,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                                         
//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                              
//PORTGET  DD   DSN=HULFT.PROFILE.TCPIP,DISP=SHR                                
//SYSUDUMP DD   SYSOUT=*                                                        
//