CICS Environment Variables

CICS_SIT=sit-name

sit-name

The name of the CICS SIT to use for the enterprise server region.

ES_ABORT_PLTPI_ERROR={YN|NY|YY}

YN

Abort on PGMIDERR.

NY

Abort on ABEND.

YY

Abort on PGMIDERR or ABEND.

ES_CICS_SINGLE={Y|N}

Y

A user can only log on once.

N

The same user may sign on to multiple terminals with CICS.

ES_CICS_SINGLE=Y

ES_CLASS_XPCT={YES|NO|class-name

YES

ACICSPCT is the default PCT class.

NO

Security for PCTs is bypassed.

class-name

The name of a class to override the default PCT ACICSPCT class.

ES_CLASS_XPCT=YES

ES_CLASS_XCMD={YES|NO|class-name}

YES

CICS CMD is the default CMD class.

NO

Security for CMDs is bypassed.

class-name

The name of a class to override the default CMD CICSCMD class.

ES_CLASS_XCMD=YES

ES_CLASS_XDCT={YES|NO|class-name}

YES

DCICSDCT is the default DCT class.

NO

Security for DCTs is bypassed.

class-name

The name of a class to override the default DCT DCICSDCT class.

ES_CLASS_XDCT=YES

ES_CLASS_XFCT={YES|NO|class-name}

YES

FCICSFCT is the default FCT class.

NO

Security for FCTs is bypassed.

class-name

The name of a class to override the default PCT FCICSFCT class.

ES_CLASS_XFCT=YES

ES_CLASS_XJCT={YES|NO|class-name}

YES

JCICSJCT is the default JCT class.

NO

Security for JCTs is bypassed.

class-name

The name of a class to override the default JCT JCICSJCT class.

ES_CLASS_XJCT=YES

ES_CLASS_XPPT={YES|NO|class-name}

YES

MCICSPPT is the default PPT class.

NO

Security for PPTs is bypassed.

class-name

The name of a class to override the default PPT MCICSPPT class.

ES_CLASS_XPPT=YES

ES_CLASS_XPSB={YES|NO|class-name}

YES

PCICSPSB is the default PSB class.

NO

Security for PSBs is bypassed.

class-name

The name of a class to override the default PSB PCICSPSB class.

ES_CLASS_XPSB=YES

ES_CLASS_XRES={YES|NO|class-name}

YES

RCICSRES is the default RES class.

NO

Security for DOCTEMPLATEs is bypassed.

class-name

The name of a class to override the default RES RCISRES class.

ES_CLASS_XRES=YES

ES_CLASS_XTST={YES|NO|class-name}

YES

SCITST is the default TST class.

NO

Security for TSTs is bypassed.

class-name

The name of a class to override the default TST SCITST class.

ES_CLASS_XTST=YES

ES_CLASS_XTRAN={YES|NO|class-name}

YES

TCICSTRN is the default TRAN class.

NO

Security for TRANs is bypassed.

class-name

The name of a class to override the default TRAN TCICSTRN class.

ES_CLASS_XTRAN=YES

ES_CSKL_NO_MSG_CONSOLE=ON

ON

CSKL does not write message to console.log.

ES_CWS_WSBIND_COMP={Y|N}

Y

Enables support for COMP declarations in CICS applications.

N

Support for COMP declarations is disabled for CICS applications.

ES_CWS_WSBIND_COMP=N

ES_DISABLE_DFLTUSR_SIGNON=Y

Y

Disables the mfuser auto-logon after starting Enterprise Server administration via your MFDS internal security account.

ES_ECI_MAX_RESP=resp-size

resp-size

A decimal from 1 to 16777215 representing the maximum expected response size in bytes.

ES_ESM_CMDSEC=YES

YES

CICS overrides the CMDSEC option, and always calls its command security checking routine to issue the appropriate call to the SAF interface.

ES_ESM_IDPW_CASE=xy

x

Specifies the case for the user ID. Use one of the following:

U	All upper case
L	All lower case
M	Mixed case and case-sensitive

y

Specifies the case for the password. Use one of the following:

U	All upper case
L	All lower case
M	Mixed case and case-sensitive

For the legacy behavior for CICS, the user ID and the password are used as supplied possibly filtered by the upper-case translation configuration of the sign-on transaction.

For ESMAC and IMS, the legacy behavior is that, first, the user ID and password are used as supplied. If the authentication fails, the user ID is folded to upper case and used again. If this fails as well, both the user ID and the password are folded to upper case and then used.

ES_ESM_IDPW_CASE=UM

ES_ESM_PLTPISEC={NONE|CMDSEC|RESSEC|ALL}

NONE

No security checking is performed on PLT initialization programs.

CMDSEC

CICS performs command security checking only.

RESSEC

CICS performs resource security checking only.

ALL

CICS performs both command and resource security checking.

ES_ESM_PLTPISEC=NONE

ES_ESM_PLTPIUSR=userid

userid

The user ID for CICS to use for security checking for PLT programs that run during CICS initialization.

The user ID specified must have appropriate authorization to access all the resources used by the programs as determined by the ES_ESM_PLTPISEC environment variable.

ES_ESM_RCF={A|C|N|S|T|Y}

A

A combination of options T, C, and S.

C

Use RACF for ETO terminal command authorization.

N

RACF does not perform sign-on, transaction, or command authorization.

S

Use RACF for static and ETO terminal command authorization. Includes option C.

T

Use RACF for sign-on and transaction authorization.

Y

A combination of options T and C.

ES_ESM_RCF=N

ES_ESM_RESSEC=ALWAYS

ALWAYS

CICS processing always performs resource level security checking irrespective of the RLS security setting on the transaction definition.

ES_ESM_SECPRFX={NO|YES|prefix}

NO

Use no prefixes.

YES

Uses prefix resource names with the CICS region user ID.

prefix

Define a prefix for resource names as an alphanumeric string that starts with an alphabetic character, and is one to eight upper-case characters in total.

ES_ESM_SECPRFX=NO

ES_ESM_XUSER={NO|YES}

NO

No surrogate user checking is performed.

YES

Perform surrogate user checking wherever such checks are permitted.

ES_ESM_XUSER=YES

ES_EUSA_SIZE=number

number

A numeric value representing the number of MB to allocate for the extended user storage area.

ES_EUSA_SIZE=16

ES_INQFILE_RETURN={DSN|PCN}

DSN

The DSN is returned. For an alternative file, the BASEDSNAME is the DSNAME of the BASE file.

PCN

The PC name of the file (truncated at 44 characters) is returned if the file is open, or if FCT fix-up has been performed. Otherwise, the dataset name is returned.

ES_INQFILE_RETURN=PCN

ES_JES_FREE_SSTM_SYSOUT={Y|N}

Y

Free the memory assigned to store details about each CICS spool file.

N

Do not free the memory assigned to store details about each CICS spool file.

ES_JES_FREE_SSTM_SYSOUT=N

Setting ES_JES_FREE_SSTM_SYSOUT=Y helps to avoid problems with receiving out of memory errors when creating multiple new files.

ES_LE370_SUPPORT=Y

Y

Enables LE support.

ES_LEGACY_ECI=Y

Y

Micro Focus ECI is used.

ES_MFASM_SUPPORT={Y|N}

Y

Assembler supported for CICS server regions.

N

No Assembler supported for CICS server regions.

ES_MFASM_SUPPORT=N

ES_MQ_1PC={[Y|y|Yes|T|True]|[N|n|No|F|False}

Y|y|Yes|T|True

The ESMQXA switch module operates in one-phase commit mode.

N|n|No|F|False

The ESMQXA switch module operates in two-phase commit mode.

ES_MQ_1PC=F

ES_MQ_XA={D|S}

D

Use a dynamic XA structure

S

Use a static XA structure.

ES_MQ_XA=D

ES_SURROGATE_JOB_USER=ON

ON

The user ID that started the enterprise server region is used in the job submission.

Micro Focus recommends that you use the Advanced Region Properties page in the Enterprise Server Common Web Administration (ESCWA) interface to configure this environment variable. See Advanced Region Properties for more information.

ES_TEST_TRANCLASS={Y|N}

Y

Activate transaction class support.

N

Do not activate transaction class support.

ES_TEST_TRANCLASS=N

ES_TRANCLASS_CWI={TCPIPSERVICE|URIMAP}

TCPIPSERVICE

Prioritize and limit TCPIPSERVICE transactions.

URIMAP

Prioritize and limit URIMAP transactions.

ES_TRANCLASS_CWI=TCPIPSERVICE

ES_TSC_AGGREGATE=wait-time,{Y|N|D}

wait-time

The time in milliseconds to wait for additional flush requests to accumulate.

Y

Use aggregate data store flush-buffers-to-disk operations

N

Do not aggregate

D

Disable flush operations.

ES_USR_DFLT_CICS=userid

userid

An alternative default user name.

ES_USR_DFLT_CICS=CICSUSER

ES_XA_ABEND=RECYCLE

RECYCLE

Recycles non-batch SEPs when a severe error is returned by an xa-start by an Oracle switch.

TXMAPP=path-name

path-name

The full path to the location of the BMS load module.

TXTRANP=path-name

path-name

The full path to the location of the CICS application object files.

USSCONFIG=cipher-path

cipher-path

The absolute path to the cipher suite specification file or files.