Specifying DFHSIT macro parameters

Start of changeYou should code the DFHSIT parameters and keywords in uppercase, except for parameters where case is important. For example, any parameter that specifies the name of an HFS directory is case sensitive.End of change

Table 17. The DFHSIT macro parameters
  DFHSIT [TYPE={CSECT|DSECT}]
    [,ADI={30|number}]
    [,AIBRIDGE={AUTO|YES}]
    [,AICONS={NO|YES|AUTO}]
    [,AIEXIT={DFHZATDX|DFHZATDY|name}]
    [,AILDELAY={0|hhmmss}]
    [,AIQMAX={100|number}]
    [,AIRDELAY={700|hhmmss}]
    [,AKPFREQ={4000|number}]
    [,APPLID=({DBDCCICS|name1}[,name2])]
    [,AUTCONN={0|hhmmss}]
    [,AUTODST={NO|YES}]
Start of change End of change Start of change End of change Start of change[,AUTORESETTIME={NO|YES}]End of change
    [,AUXTR={OFF|ON}]
    [,AUXTRSW={NO|ALL|NEXT}]
 
[,BMS=({MINIMUM|STANDARD|FULL}[,COLD][
     [,{UNALIGN|ALIGN}][,{DDS|NODDS}])]
    [,BRMAXKEEPTIME={86400|number}]
    [,CDSASZE={0K|number}]
    [,CICSSVC={216|number}]
    [,CILOCK={NO|YES}]
    [,CLSDSTP={NOTIFY|NONOTIFY}]
    [,CLT=xx]
    [,CMDPROT={YES|NO}]
[,CMDSEC={ASIS|ALWAYS}
    [,CONFDATA={SHOW|HIDETC}]
    [,CONFTXT={NO|YES}]
[Start of changeCRLPROFILE=PROFILENAMEEnd of change]
    [,CSDACC={READWRITE|READONLY}]
    [,CSDBKUP={STATIC|DYNAMIC}]
    [,CSDBUFND=number]
    [,CSDBUFNI=number]
    [,CSDDISP={OLD|SHR}]
    [,CSDDSN={name}]
    [,CSDFRLOG=number]
   
[,CSDINTEG={UNCOMMITTED|CONSISTENT|
          REPEATABLE}]
    [,CSDJID={NO|number}]
    [,CSDLSRNO={1|number|NONE|NO}]
    [,CSDRECOV={NONE|ALL|BACKOUTONLY}]
    [,CSDRLS={NO|YES}]
    [,CSDSTRNO={2|number}]
    [,CWAKEY={USER|CICS}]
    [,DAE={NO|YES}]
    [,DATFORM={MMDDYY|DDMMYY|YYMMDD}]
    [,DB2CONN={NO|YES}]
    [,DBCTLCON={NO|YES}]
[,DEBUGTOOL={NO|YES}]
    [,DFLTUSER={CICSUSER|userid}]
    [,DIP={NO|YES}]
    [,DISMACP={YES|NO}]
[,DOCCODEPAGE={037|codepage}]
    [,DSALIM={5M|number}]
    [,DSHIPIDL={020000|hhmmss}]
    [,DSHIPINT={120000|hhmmss}]
    [,DSRTPGM={NONE|DFHDSRP|program-name|EYU9XLOP}]
    [,DTRPGM={DFHDYP|program-name}]
    [,DTRTRAN={CRTX|name|NO}]
    [,DUMP={YES|NO}]
    [,DUMPDS={AUTO|A|B}]
    [,DUMPSW={NO|NEXT}]
    [,DURETRY={30|number-of-seconds|0}]
    [,ECDSASZE={0K|number}]
    [,EDSALIM={30M|number}]
    [,EJBROLEPRFX=ejbrole-prefix]
    [,ENCRYPTION={WEAK|MEDIUM|Start of changeSTRONGEnd of change}]
    [,EODI={E0|xx}]
    [,ERDSASZE={0K|number}]
    [,ESDSASZE={0K|number}]
    [,ESMEXITS={NOINSTLN|INSTLN}] (SIT macro only)
    [,EUDSASZE={0K|number}]
    [,FCT={NO|xx|YES}]
    [,FEPI={NO|YES}]
    [,FLDSEP={‘    ’|‘xxxx’}]
    [,FLDSTRT={‘ ’|‘x’}]
    [,FORCEQR={NO|YES}]
    [,FSSTAFF={YES|NO}]
    [,FTIMEOUT={30|nn}]
    [,GMTEXT={‘WELCOME TO CICS’|‘text’}]
    [,GMTRAN={CSGM|CESN|name}]
[,GNTRAN={NO|transaction-id}]
    [,GRNAME=name]
   
[,GRPLIST={DFHLIST|name|(name[,name2][,name3][,name4])}]
    [,GTFTR={OFF|ON}]
    [,HPO={NO|YES}] (SIT macro only)
    [,ICP=COLD]
    [,ICV={1000|number}]
    [,ICVR={5000|number}]
    [,ICVTSD={500|number}]
Start of change End of change Start of change End of change Start of change[,IIOPLISTENER={YES|NO}]End of change
[,INFOCENTER={‘infocenter_url’}
   
[,INITPARM=(pgmname_1=‘parmstring_1’
       [, .... ,pgmname_n=‘parmstring_n’])]
    [,INTTR={ON|OFF}]
    [,IRCSTRT={NO|YES}]
    [,ISC={NO|YES}]
    [,JESDI={30|number}]
    [,JVMCCPROFILE={DFHJVMCC|profile}]
    [,JVMCCSIZE={24M|number}]
    [,JVMCCSTART={AUTO|YES|NO}]
    [,JVMPROFILEDIR={/usr/lpp/cicsts/cicsts31/JVMProfiles|directory}]
    [,KEYRING={‘key-database-path-name’}
    [,LGDFINT={30|number}]
    [,LGNMSG={NO|YES}]
    [,LLACOPY={YES|NO|NEWCOPY}]
    Start of change[,LOCALCCSID={037|CCSID}]End of change
    [,LPA={NO|YES}]
    [,MAXJVMTCBS={5|number}]
    [,MAXOPENTCBS={Start of change12End of change|number}]
    [,MAXSOCKETS=number]
Start of changeStart of change[MAXSSLTCBS={8|numberEnd of change}]End of change
    Start of change[,MAXXPTCBS={5|number}]End of change
    [,MCT={NO|YES|xx}]
    [,MN={OFF|ON}]
    [,MNCONV={NO|YES}]
    [,MNEVE={OFF|ON}]
    [,MNEXC={OFF|ON}]
    [,MNFREQ={0|hhmmss}]
    [,MNPER={OFF|ON}]
    [,MNRES={OFF|ON}]
    [,MNSUBSYS={null|xxxx}]
    [,MNSYNC={NO|YES}]
    [,MNTIME={GMT|LOCAL}]
    [,MQCONN={NO|YES}]
    [,MROBTCH={1|number}]
    [,MROFSE={ NO|YES}]
    [,MROLRM={NO|YES}]
    [,MSGCASE={MIXED|UPPER}]
    [,MSGLVL={1|0}]
    [,MXT={5|number}]
    [,NATLANG=(E,x,y,z,...)]
    [,NCPLDFT={DFHNC001|name}]]
    [,OPERTIM={120|number}]
    [,OPNDLIM={10|number}]
    [,PARMERR={INTERACT|IGNORE|ABEND}]
    [,PDI={30|number}]
    [,PDIR={NO|YES|xx}]
[,PGAICTLG={MODIFY|NONE|ALL}]
[,PGAIEXIT={DFHPGADX|name}]
[,PGAIPGM={INACTIVE|ACTIVE}]
    [,PGCHAIN=character(s)]
    [,PGCOPY=character(s)]
    [,PGPURGE=character(s)]
    [,PGRET=character(s)]
    [,PLTPI={NO|xx|YES}]
    [,PLTPISEC={NONE|CMDSEC|RESSEC|ALL}]
    [,PLTPIUSR=userid]
    [,PLTSD={NO|xx|YES}]
    [,PRGDLAY={0|hhmm}]
    [,PRINT={NO|YES|PA1|PA2|PA3}]
    [,PRTYAGE={32768|number}]
    [,PSBCHK={NO|YES}]
    [,PSDINT={0|hhmmss}]
    [,PSTYPE={SNPS|MNPS}]
    [,PVDELAY={30|number}]
    [,QUIESTIM={240|number}]
    [,RAMAX={256|number}]
    [,RAPOOL={ 50|value1|(value1,value2,FORCE)}]
    [,RDSASZE={0K|number}]
    [,RENTPGM={PROTECT|NOPROTECT}]
    [,RESP={FME|RRN}]
[,RESSEC={ASIS|ALWAYS}
    [,RLS={NO|YES}
    [,RLSTOLSR={NO|YES}
   
[,RMTRAN=({GMTRAN-name|name1}
         [,{GMTRAN-name|name2}])]
    [,RRMS={NO|YES}]
    [,RST={NO|xx|YES}]
    [,RSTSIGNOFF={NOFORCE|FORCE}]
    [,RSTSIGNTIME={500|time}]
    [,RUWAPOOL={NO|YES}]
    [,SDSASZE={0K|number}]
    [,SDTRAN={CESD|name_of_shutdown_tran|NO}]
  [,SEC={YES|NO}]
  [,SECPRFX={NO|YES|prefix}]
    [,SKRxxxx=‘page-retrieval-command’]
[,SNSCOPE={NONE|CICS|MVSIMAGE|SYSPLEX}]
    [,SPCTR={(1,2|1[,2][,3])|ALL|OFF}]
    [,SPOOL={NO|YES}]
    [,SRBSVC={215|number}]
    [,SRT={1¢|YES|xx|NO}]
    [,SSLDELAY={600|number}]
    [,SSLTCBS={8|number}]
    [,START={AUTO|INITIAL|COLD|STANDBY}]
    [,STARTER={NO|YES}] (SIT macro only)
    [,STATRCD={OFF|ON}]
    [,STGPROT={NO|YES}]
    [,STGRCVY={NO|YES}]
    [,STNTR={1|(1[,2][,3])|ALL|OFF}]
    [,SUBTSKS={0|1}]
    [,SUFFIX=xx] (SIT macro only)
    [,SYDUMAX={999|number}]
    [,SYSIDNT={CICS|name}]
    [,SYSTR={ON|OFF}]
    [,TAKEOVR={MANUAL|AUTO|COMMAND}]
   
[,TBEXITS=([name1][,name2][,name3]
          [,name4][,name5][,name6])]
    [,TCP={YES|NO}]
    [,TCPIP={NO|YES}]
    [,TCSACTN={NONE|UNBIND]FORCE}]
    [,TCSWAIT={4|number|NO|NONE|0}]
    [,TCT={NO|xx|YES}]
    [,TCTUAKEY={USER|CICS}]
    [,TCTUALOC={BELOW|ANY}]
    [,TD=({3|number1}[,{3|number2}])]
    [,TDINTRA=({NOEMPTY|EMPTY}]
    [,TRANISO={NO|YES}]
    [,TRAP={OFF|ON}]
    [,TRDUMAX={999|number}]
    [,TRTABSZ={16|number}]
    [,TRTRANSZ={16|number}]
    [,TRTRANTY={TRAN|ALL}]
  [,TS=([COLD][,{0|3|value-1}][,{3|value-2}])]
    [,TST={NO|YES|xx}]
    [,UDSASZE={0K|number}]
    [,UOWNETQL=user_defined_value]
    [,USERTR={ON|OFF}]
    [,USRDELAY={30|number}]
    [,VTAM={YES|NO}]
    [,VTPREFIX={\|character}]
    [,WEBDELAY={5|time_out,60|keep_time}]
    [,WRKAREA={512|number}]
    [,XAPPC={NO|YES}]
    [,XCMD={YES|name|NO}]
    [,XDB2={NO|name}]
    [,XDCT={YES|name|NO}]
    [,XEJB={YES|NO}]
    [,XFCT={YES|name|NO}]
    [,XJCT={YES|name|NO}]
    [,XLT={NO|xx|YES}]
    [,XPCT={YES|name|NO}]
    [,XPPT={YES|name|NO}]
    [,XPSB={YES|name|NO}]
    [,XRF={NO|YES}]
    [,XTRAN={YES|name|NO}]
    [,XTST={YES|name|NO}]
[,XUSER={YES|NO}]
     
    You must terminate your macro parameters with the following END statement.
     
  END DFHSITBA

Initialization parameters that cannot be coded in the DFHSIT macro

There are some CICS® system initialization parameters that you cannot define in the DFHSIT macro. These parameters can be supplied only at CICS startup time in any of these three ways:

  1. In the PARM parameter of the EXEC PGM=DFHSIP statement
  2. In the SYSIN data set defined in the startup job stream
  3. Through the system operator’s console

The system initialization parameters that you cannot define in the DFHSIT macro are shown in Figure 33.

For information about coding system initialization parameters in PARM, SYSIN, or at the console, see Processing system initialization parameters.

Figure 33. System initialization parameters you cannot code in the DFHSIT macro
    CDSASZE={0K|number}
    CHKSTRM={CURRENT|NONE}
    CHKSTSK={CURRENT|NONE}
    ECDSASZE={0K|number}
    ERDSASZE={0K|number}
    ESDSASZE={0K|number}
    EUDSASZE={0K|number}
    JVMLEVEL0TRACE={ALL(EXCEPTION)|user override string}
    JVMLEVEL1TRACE={ALL(ENTRY,EXIT)|user override string}
    JVMLEVEL2TRACE={ALL|user override string}
    JVMUSERTRACE={NONE|user override string}
    NEWSIT={YES|NO}
    OFFSITE={NO|YES}
    PRVMOD={name|(name,name...name)}
    RDSASZE={0K|number}
    SDSASZE={0K|number}
    SIT=xx
    START=(option,ALL)
    UDSASZE={0K|number}

Defining CICS resource table and module keywords

Table 18 shows the system initialization keywords for those CICS resources that:

Table 18. Summary of resources with a suffix, a dummy load module, or a COLD option
DFHSIT keyword  1  Default  2  Suffix  3  Dummy  4  COLD start  5 
BMS FULL - - COLD
CLT - xx - -
DIP NO - program -
FCT YES xx - -
ICP - - - COLD
MCT NO xx  6  -
PDIR NO xx - -
PLTPI NO xx - -
PLTSD NO xx - -
RST NO xx - -
SRT YES xx - -
TCT YES xx table -
TS - - - COLD
TST NO xx - -
XLT NO xx - -

Notes:

 1  When the DFHSIT keyword is specified with more than one value, these values must be enclosed within parentheses: for example, BMS=(FULL,COLD).

 2  The Default column indicates the default value for the keyword in the DFHSIT macro.

For keywords with the suffix option, if you code YES in the SIT, an unsuffixed version of the table or program is loaded. For example, TCT=YES results in a table called DFHTCT being loaded. You can also select an unsuffixed module or table at CICS startup by specifying keyword=, or keyword=YES. For example, if you code:

FCT=, or FCT=YES

blanks are appended to DFHFCT, and these unsuffixed names are used during initialization.

The result of specifying keyword=, as a system initialization parameter through PARM, SYSIN, or CONSOLE is not necessarily the same as in the DFHSIT macro. For example, TST=, (or omitted altogether) when coding the DFHSIT macro is taken to mean TST=NO, but TST=, through any of the other three methods is the same as TST=YES.

 3  The Suffix column indicates whether you can code a suffix. (xx indicates that a suffix can be coded.)

A suffix can be any 1 or 2 characters, but you must not use DY, and you cannot use NO as a suffix.

If you code a suffix, a table or program with that suffix appended to the standard name is loaded.

 4  The Dummy column indicates whether a dummy version of the program or table is loaded if you code NO. In some cases, coding NO for the operand associated with the table results in a dummy program. For more information about the effect of this option, see Selecting versions of CICS programs and tables.

 5  The COLD start column indicates whether the resource can be forced to start COLD. (COLD indicates that the resource can be cold started individually).

i1.TST and cold start Ensure that you cold start temporary storage or the whole system if you make any change to the TST.

If COLD is coded, it can be overridden only by coding START=(...,ALL) as a system initialization parameter. For more information about this option, see topic ALL.

For more information about CICS table and program selection, see Selecting versions of CICS programs and tables.

 6  If you code MCT=NO, the CICS monitoring domain builds dynamically a default monitoring control table. This ensures that default monitoring control table entries are always available for use when monitoring is on and a monitoring class is active.

Related tasks
Specifying CICS system initialization parameters
The default system initialization table
Assembling the SIT
Selecting versions of CICS programs and tables
Processing system initialization parameters
Related concepts
System initialization parameters for open TCBs
Related reference
The system initialization parameter descriptions
[[ Contents Previous Page | Next Page Index ]]