Using a custom character table

This section explains how to use created custom character tables. To use a custom character table, you must store the custom character table in HULFT load module library.

Note

Specify the same data set name for STEPLIB and XREXTLIB.

[Example of JCL 1]

The following is JCL for the Send File program (XRSNDGO) for using a custom character table when you carry out the Work File Transfer with sending-side conversion:

//XRSNDGO  JOB  CLASS=A,MSGCLASS=B                                              
//XRSNDGO  EXEC PGM=XRSNDGO,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                                        
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//SYSOUT   DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
      FILE-ID=LOOPTEST                                                          
//

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
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File

*1

:

This setting is required in order to use a custom character table.

[Example of JCL 2]

The following is JCL for the Send program (XRSND) for using a custom character table when you carry out the Direct Transfer with sending-side conversion:

//HULSND   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULSND   EXEC PGM=XRSND,REGION=4096K                                          
//*             PARM='MODE=WARM'                                                
//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                           
//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

*1

:

This setting is required in order to use a custom character table.

[Example of JCL 3]

The following is JCL for the Receive program (XRRCV) for using a custom character table when you carry out receiving-side conversion:

//HULRCV   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULRCV   EXEC PGM=XRRCV,REGION=4096K                                          
//*        PARM=('MAX-CON=16,APPLNM=HULRCV,RCVRETRY=0,RCVRTIME=0,',             
//*        'JOBWTIME=15,TCPIP=TCPIP')                                           
//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=*                                                        
//

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
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
PORTGET	HULFT.PROFILE.TCPIP	PORT Management File

*1

:

This setting is required in order to use a custom character table.

[Example of JCL 4]

When HULFT acknowledges the Send Request and carries out the Work File Transfer with sending-side conversion, or when HULFT acknowledges the Send File that is issued from HULFT Manager and carries out the Work File Transfer with sending-side conversion, the JCL for the Observe program (XRACCPT) for using a custom character table is as follows:

//HULSRV   JOB  CLASS=A,MSGCLASS=B,TIME=1440                                    
//HULSRV   EXEC PGM=XRACCPT,REGION=4096K                                        
//*        PARM='MAX-CON=16,TCPIP=TCPIP,APPLNM=HULSRV'                          
//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                                                           
//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
IPGET	HULFT.HOSTS.LOCAL	IP Management File
PORTGET	HULFT.PROFILE.TCPIP	PORT Management File

*1

:

This setting is required in order to use a custom character table.

[Example of JCL 5]

The following is JCL for the Joined File Break program (XRBREAK) for using a custom character table when you split a joined file:

//XRBREAK  JOB  CLASS=A,MSGCLASS=B
//XRBREAK  EXEC PGM=XRBREAK,REGION=4096K                                        
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XREXTLIB DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRJOIN   DD   DSN=HULFT.JOIN.FILE,DISP=SHR                                    
//XRPRINT  DD   SYSOUT=*                                                        
//SYSOUT   DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
     SEQNO=1,VOL=WRKVOL                                                         
//

DD Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XREXTLIB	HULFT.LOAD	HULFT load module library (*1)
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File
XRJOIN	HULFT.JOIN.FILE	Joined File

*1

:

This setting is required in order to use a custom character table.

[Example of Procedure]

The following is a PROC to start the HULFT Management Console for using a custom character table when you carry out the Work File Transfer on the HULFT Management Console with sending-side conversion:

PROC 0                                                                          
   CONTROL FLUSH MSG LIST                                                       
   ALLOC   F(XRFILE)    DA('HULFT.FILE') SHR                             
   ALLOC   F(XRHOST)    DA('HULFT.HOST') SHR                             
   ALLOC   F(XRLOG)     DA('HULFT.LOG') SHR                              
   ALLOC   F(XRLOG1)    DA('HULFT.LOG.PATH1') SHR                        
   ALLOC   F(XRLOG2)    DA('HULFT.LOG.PATH2') SHR                        
   ALLOC   F(XRQUE)     DA('HULFT.QUEUE') SHR                            
   ALLOC   F(XRSYSIN)   DA('HULFT.PARMLIB(HULPRM)') SHR                  
   ALLOC   F(XREXTLIB)  DA('HULFT.LOAD') SHR                             
   ALLOC   F(IPGET)     DA('HULFT.HOSTS.LOCAL') SHR                      
   ISPEXEC SELECT       PGM(XRMENU2)                                            
   FREE    F(XRFILE XRHOST XRLOG XRLOG1 XRLOG2 XRQUE XRSYSIN XREXTLIB IPGET)    
END

File Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XRFILE	HULFT.FILE	Send and Receive Management File
XRHOST	HULFT.HOST	Host Information 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
XRQUE	HULFT.QUEUE	Send Control File
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File
XREXTLIB	HULFT.LOAD	HULFT load module library (*1)
IPGET	HULFT.HOSTS.LOCAL	IP Management File

*1

:

This setting is required in order to use a custom character table.