15.10 - Customizing HSISPB - Teradata Tools and Utilities

Teradata Tools and Utilities for IBM z/OS Installation Guide

prodname
Teradata Tools and Utilities
vrm_release
15.10
created_date
August 2016
category
Installation
featnum
B035-3128-086K
The USERMOD sample for the Host System Interface System Parameter Block (HSISPB) is TDU0001 in dbcpfx.SAMPLIB. HSISPB controls certain functions within Teradata Director Program and Call-Level Interface version 1.
Before making any modifications to HSISPB, review the sections that describe modification of HSISPB and the documentation about the TDP INITIAL commands in Teradata Director Program Reference, B035-2416.

HSISPB is generated by assembling a program that invokes the HSISPB macro parameters provided by Teradata.

A set of default values (listed below) is provided to use in creating HSISPB during installation. To change the default values, first check whether the defaults can be changed using the TDP INITIAL commands.

If that solution is not feasible, create a USERMOD to modify the HSISPB file.

The following example shows the entire HSISPB file, set to the default parameters:

HSISPB   TITLE ’SYSTEM PARAMETER BLOCK’ 
       COPY TDPGBLS GLOBAL SET PARMS 
       COPY TDPSETS INITIALIZE SET SYMBOLS 
       HSISPB TYPE=CSECT,                                     X
                DLYTIME=300, 5 MIN REMINDER OF COMMUNIC.LOSS  X
                INSTID=’DEFAULT HSISPB &SYSDATE &SYSTIME’,    X
                JWT=4,       4 MIN FOR JOB WAIT TIME          X
                SMFID=200,   TDP SMF RECORD ID                X
                TDP=TDP0,    DEFAULT TDP                      X
                TIMEMSG=NO,  DON’T SYNCH SERVER’S TIME        X 
                TEST=NO      NO TRACE
       END

The following table lists the macro parameters used by HSISPB.

Parameter Value Description
DLYTIME 1 to 32768 (default=300) Interval, in seconds, at which reminders are issued that all communication with the Teradata Server has been lost
For compatibility with prior releases, this parameter may also be specified as ARMI.
INSTID 1 to 40 characters Installation name
JWT 0 to 99 (default=4) Interval, in minutes, at which TDP schedules activity in the address space of the user

This prevents job termination (522 abends) during long requests. This value is to be set less than or equal to the JWT parameter in PARMLIB member SMFPRMxx.

SMFID 128 to 255 (default=200) SMF record number used to record accounting and performance data
For SMF recording, the interval is recognized as hours and minutes. Convert hours and minutes to only minutes for TDP use.
TDP TDPn The default TDPn (0-9, A-Z, #, @, $) to be used by the application that uses this HSISPB (if another tdpid is not supplied with the logon request)
TIMEMSG YES or NO (default=NO) Synchronizes the time on the Teradata server to the time on z/OS
  • NO prevents synchronization
  • YES allows synchronization
This parameter should only be set for one of the TDPs that access the Teradata Database.
TEST YES or NO (default=NO) Enables (YES) or disables (NO) tracing of logons and logoffs to the operator console