17.00 - The HSHSPBC Area - IBM CICS Interface for Teradata

IBM CICS Interface for Teradata® Reference

prodname
IBM CICS Interface for Teradata
vrm_release
17.00
created_date
June 2020
category
Programming Reference
featnum
B035-2448-220K

The CICS-only data area module called HSHSPBC, included in the delivered interface and assembled during installation, enables a system administrator to manage globally CLIv2 memory usage in a CICS region.

He or she can specify in HSHSPBC the maximum number of free control blocks and buffers maintained on the free chain. (HSHSPB defines free chains for CLI control blocks, as well as up to eight different buffer sizes. Each buffer pool is independently managed and CLI uses a modified best-fit algorithm to assign buffers.)

Allocations can be changed, as required, with the CICS command transaction DMEM.

During initialization, DBCCICS initializes the headers of the free chains based on the setting in HSHSPBC.

The HSHSPBC does not replace the HSHSPB for CICS. HSHSPBC is used in addition to the HSHSPB. For information on HSHSPB, see Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems (B035-2417).

The following table lists the parameters supplied to the HSHSPBC macro.

Parameters Supplied to the HSHSPBC Macro 
Name Description
HSHSPBC TRX=(init,max), Maximum concurrent CLIv2 TRXs.
SES=(init,max), Maximum concurrent CLIv2 sessions.
REQ=(init,max), Maximum concurrent CLIv2 requests.
TSC=(init,max), Maximum concurrent CLI TRXs.
RCB=(init,max), Maximum concurrent CLI sessions.
BUF1=(size,init,max),

BUF2=(size,init,max),

BUF3=(size,init,max),

BUF4=(size,init,max),

BUF5=(size,init,max),

BUF6=(size,init,max),

BUF7=(size,init,max),

BUF8=(size,init,max)

Response/Fetch buffer pools:

up to 8 pools may be specified. If free chain empty, buffers dynamically added up to maximum. If maximum exceeded, buffer will be FREEMAINed when released.

Legal ‘size’s: 256-32767.

END Assembler end statement (required).

The following table defines the parameters supplied to the HSHSPBC macro.

Definitions of Parameters Supplied to the HSHSPBC Macro 
Name Description
TRX TRX if omitted, defaults to 0. Valid range: 0-9999.
SES SES if omitted, defaults to 0. Valid range: 0-32767.
REQ REQ if omitted, defaults to 0. Valid range: 0-32767.
TSC TSC if omitted, defaults to 0. Valid range: 0-32767.
RCB RCB if omitted, defaults to 0. Valid range: 0-9999.