Running the Observe program (XRACCPT)

Run the Observe program (XRACCPT) in advance to acknowledge requests from remote hosts.

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

(1) Observe Program (XRACCPT)

Program Name

XRACCPT

Execution parameters (for EXEC statement)

= Remarks =

The execution parameters (for EXEC statement) are to ensure compatibility with lower versions.

Under ordinary circumstances, use the System Environment Settings.

If you specify both the execution parameters (for EXEC statement) and the System Environment Settings, the parameter specifications are used.

For details on the definitions of the System Environment Settings, refer to the explanation of the System Environment Settings in Administration Manual.

      a                 b               c              d 
[APPLNM=xxxxxxxx][,MAX-CON=999][,TIMEOUT=999999][,TCPIP=xxxxx]

a. Observe application name

Define the Observe application name that you defined in the PORT management file (HULFT.PROFILE.TCPIP). (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 Observe Application Name (APT-APPLNM) in the System Environment Settings is used.

b. Maximum number of requests that HULFT can acknowledge simultaneously

This parameter defines the maximum number of requests that HULFT can acknowledge simultaneously. (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 Maximum Simultaneous Requests (APT-MAXCON) in the System Environment Settings is used.

c. 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 Observe Socket Read Timeout (APT-TIMEOUT) in the System Environment Settings is used.

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

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

START-TASK=Job Name of Send Program 
UNIT=UNIT Name of Send Work Files 
PORTNO=Receive Port No. 
TCPIP=Address Space Name of TCP/IP 
HOST-NAME=Local Host Name 
DOMAIN=Local Domain Name 
HSTCHA=Case Options for Local Host Name or Local Domain Name 
RESENDDEL=Criteria to Delete Resend Queue 
PREFIX=First Modifier of Send Work Files 
RECLEN=Shiftcode Mode for Send Files 
CMPBLK=Work File Block Length for Compression 
JOBTIME=Job Timeout for Pre-send Job 
TIMEOUT=Socket Read Timeout 
CLEARMODE=Post-send Clear Mode 
STATUSDISPLAY=Status Display Selection 
LOGDELTHRESHOLD=Log Deletion Threshold 
LOGKEEPCOUNT=Log Keep Count 
PSCHG=Pack Zone Conversion 
PSASCII=Sign for ASCII 
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 
WORKVOLMODE=Work Volume Mode 
JESC=JES Command Acronym 
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 
MSGDYNPARM=Message Dynamic Parameter Specification 
RECV-TASK=Receive Task Name 
REQWAITMODE=Wait Synchronous Observe Mode 
JCLRETRY=JCL Library Retry Count 
JCLRTIME=JCL Library Retry Interval 
APTHSTCHK=Observe Host Check 
USRIDCHKMODE=User ID/Password Check 
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 
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 
APT-APPLNM=Observe Application Name 
APT-MAXCON=Maximum Simultaneous Requests 
APT-TIMEOUT=Observe Socket Read Timeout 
ALLOWSNDREQ=Allow Send/Resend Request from Unregistered Host 
ALLOWPOSTRJOBRSLT=Allow Post-Receive Job Result Inquiry from Unregistered Host 
ALLOWJOBRSLTNTFY=Allow Job Result Notification Request from Unregistered Host 
ALLOWRMTJOBEXE=Allow Remote Job Execution Request from Unregistered Host 
INSTTRANSCODCNV=Instant Transfer Code Conversion Side 
INSTTRANSEBCDIC=Instant Transfer EBCDIC Set 
INSTTRANSCMDQUE=Send Control File to Issue Instant Transfer 
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

//HULSRV   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULSRV   EXEC PGM=XRACCPT,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                                    
//INDD     DD   DSN=HULFT.PARMLIB(HULAPT),DISP=SHR                              
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRPASSWD DD   DUMMY                                                           
//*SYSTCPD DD   DSN=TCPIVP.TCPPARMS(TCPDATA),DISP=SHR                           
//IPGET    DD   DSN=HULFT.HOSTS.LOCAL,DISP=SHR                                  
//PORTGET  DD   DSN=HULFT.PROFILE.TCPIP,DISP=SHR                                
//SYSOUT   DD   SYSOUT=*                                                        
//SYSUDUMP DD   SYSOUT=*                                                        
//CEEDUMP  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

INDD

HULFT.PARMLIB(HULAPT)

Observe Definition File

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File

SYSTCPD

TCPIVP.TCPPARMS(TCPDATA)

TCPIP.DATA Data Set

IPGET

HULFT.HOSTS.LOCAL

IP Management File

PORTGET

HULFT.PROFILE.TCPIP

PORT Management File

*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 Observe program (XRACCPT), do not execute the START command with an identifier on the console.

= Remarks =

  • For details on the contents that are defined in the lines that start with '//INDD' in the example of JCL, refer to the explanation of the Observe definition in Administration Manual.

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