DEFLATE compression

If you use DEFLATE compression in HULFT, you can specify environment variables in the CEEOPTS statement and adjust the threshold to use zEDC.

To adjust the threshold, use "_HZC_DEFLATE_THRESHOLD" (compression) and "_HZC_INFLATE_THRESHOLD" (expand) of the environment variables.

To use zEDC for all DEFLATE requests, specify "1" for the environment variable.

To perform DEFLATE compression with the OS settings, you do not need to set the environment variable, and thus you do not need to specify the CEEOPTS DD status. In this case, HULFT uses OS setting values to perform DEFLATE compression.

For details, refer to the following z/OS manuals:

  • z/OS Language Environment Programming Guide

  • Integrated Accelerator for zEDC

Startup JCL for the Send program

The example of startup JCL for the Send program is shown below.

[Example of JCL]

To use zEDC for all DEFLATE requests ("1" specified for the environment variable)

//HULSND JOB CLASS=A,MSGCLASS=B,TIME=1440                                       
//HULSND EXEC PGM=XRSND,REGION=4096K                                            
//* PARM='MODE=WARM'                                                            
//STEPLIB  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=TCPIP.V3R4.TCPIP.DATA,DISP=SHR                              
//CEEOPTS  DD   DSN=HULFT.CEEOPTS.SND,DISP=SHR     (*1)                         
//SYSUDUMP DD SYSOUT=*                                                          
//                                                                              

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

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

CEEOPTS

HULFT.CEEOPTS.SND

(*1)

*1

:

Set the environment variable

 

The attributes of the file that you create are shown below.

 

Attribute

Organization

Record Format

Record Length

Block Size

PS

FB

80

Any

 

[Example of HULFT.CEEOPTS.SND]

 

ENVAR("_HZC_DEFLATE_THRESHOLD=1")

 

Parameter Name

Value

Description

_HZC_DEFLATE_THRESHOLD=1

ENVAR

Threshold value for zEDC usage (unit: byte)

Startup JCL for the Receive program

The example of startup JCL for the Receive program is shown below.

[Example of JCL]

To use zEDC for all DEFLATE requests ("1" specified for the environment variable)

//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                                         
//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                                
//CEEOPTS  DD   DSN=HULFT.CEEOPTS.RCV,DISP=SHR     (*1)                         
//SYSUDUMP DD   SYSOUT=*                                                        
//                                                                              

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

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

CEEOPTS

HULFT.CEEOPTS.RCV

(*1)

*1

:

Set the environment variable

 

The attributes of the file that you create are shown below.

 

Attribute

Organization

Record Format

Record Length

Block Size

PS

FB

80

Any

 

[Example of HULFT.CEEOPTS.RCV]

 

ENVAR("_HZC_INFLATE_THRESHOLD=1")

 

Parameter Name

Value

Description

_HZC_INFLATE_THRESHOLD=1

ENVAR

Threshold value for zEDC usage (unit: byte)