This section explains the Entire Systems Management Adapter startup parameters.

The following topics are covered:

• Parameters without Default Value

• Example Parameter File

• Startup Parameters in Alphabetical Order

You must edit the parameter file as part of the installation procedure. This includes customizing parameter values to suit your site. Thereafter, you can modify parameters as required for customization purposes to reflect changing conditions at your site. After each modification of the parameter member, you must restart the Entire Systems Management Adapter to pick up the changes.

---

Parameters without Default Value

Unspecified parameters take the default value. The parameters listed below have no default value and must be specified:

• JOBSERVER

• NODE

Example Parameter File

NODE=199
IDENTIFIER=PRODUCTION-NODE
AUTOLOG=YES                   Def.: YES      YES|NO
CDATALEN=1024                 Def.: 0 K      Size of COMMON-DATA MP
CLIENT-CODE-PAGE=ISO8859F     Def.: ISO8859F
CONACCESS=WRITE               Def.: NONE     Access NONE|READ|WRITE
EVENTLEN=1024                 Def.: 0 K      Size of EVENTING MP
HOST-CODE-PAGE=EDF04F         Def.: EDF04F   Host code page
* JOB-CLASS=TSOSBAT           Def.: TSOSBAT  P.ESA: JOB-CLASS
* JOB-ELEM=P.ESA              Def.: none     Startup SDF-P procedure
* JOB-LIB=$SAG.ESAnnn.JOBS    Def.: none     LIB containing P.ESA
* JOB-NAME-CONS=XCON199       Def.: XCON199  P.ESA: JOB-NAME ESACONS
* JOB-NAME-EMAIL=XEML199      Def.: XEML199  P.ESA: JOB-NAME ESAMAIL
* JOB-NAME-EVENT=XEVT199      Def.: XEVT199  P.ESA: JOB-NAME ESAEVTM
* JOB-NAME-SERVER=XSRV199     Def.: XSRV199  P.ESA: JOB-NAME ESASERV
* JOB-RUN-PRIORITY=255        Def.: STD      P.ESA: RUN-PRIORITY=n
* JOB-START-OPTION=SOON       Def.: IMMEDIATELY     START=*str
* JOB-TIME=NO                 Def.: NO       P.ESA: CPU-LIMIT=*str
* JOBENT=YES                  Def.: NO       Privileged $JOBENT?
LANGUAGE=E                    Def.: E        Language code E|G
LOOP=0                        Def.: 0 SEC    Loop time limit
MSGLEVEL=I                    Def.: I        Message level I|W|E
NABS=100                      Def.: 10       Number attached buffers
NONACT=30                     Def.: 60 MIN   User non-activity time
NUMCONSMSG=2048               Def.: 1024     Number CONSOLE MSG entries
NUMFAT=256                    Def.: 128      Number Fast Access Tables
NUMMAIL=256                   Def.: 0        Number E-MAIL Entries
NUMTASK=1                     Def.: 4        Number SERVER Tasks
NUMUSER=128                   Def.: 128      10 - 512 USER CBs
PRODUCT=M                     No default     M = LMS
READ-LOCKED-FILE=YES          No default     Read locked file? *NEW*
RECALL=NO                     Def.: YES      Recall migrated files
SDF=YES                       Def.: NO       Internal use of SDF CMDs
* SDF-P=YES                   Def.: NO       Internal use of SDF-P
SECURITY=BS2                  Def.: NONE     User security
SERVER-DYN=YES                Def.: NO       Dynamic SERVER Management
SERVER-MAX=16                 Def.: 16       Max # SERVER
SERVER-MIN=1                  Def.: 1        Min # SERVER
SERVER-NONACT=5               Def.: 10 MIN   SERVER non-activity time
SERVER-QUEUE-DEPTH=2          Def.: 5        Depth of SERVER input Q
SMTP-HOST=mailhost            No default     SMTP Host (Mail gateway)
SMTP-PORT=25                  Def.: 25       SMTP port number
SPOOL=BS2                     Def.: BS2      BS2|NONE
SYSTEM-COMMAND-USER=TSOS      No default     Users granted for SYSTEM-COMMAND
* TAPES=NO                    Def.: NO       Tape support
TCP-PORT=3931
TRACE=PREP                    Def.: PREP     PREP|YES|NO
TRACE-LEN=1024                Def.: 8 K      Size of TRACE MP
TRACE-SAV=YES                 Def.: YES      Save traces at exit
* VIEWSEC=NONE                Def.: NONE     View processor exit
JOBCONS=*LIBRARY-ELEMENT(LIBRARY=$SAG.ESAvrs.JOBS,ELEMENT=E.ESACONS)
JOBEMAIL=*LIBRARY-ELEMENT(LIBRARY=$SAG.ESAvrs.JOBS,ELEMENT=E.ESAMAIL)
JOBEVENT=*LIBRARY-ELEMENT(LIBRARY=$SAG.ESAvrs.JOBS,ELEMENT=E.ESAEVTM)
JOBSERVER=*LIBRARY-ELEMENT(LIBRARY=$SAG.ESAvrs.JOBS,ELEMENT=E.ESASERV)
PRMCONS=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
PRMEMAIL=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
PRMEVENT=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
PRMSERVER=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)

Startup Parameters in Alphabetical Order

The startup parameter descriptions are listed in alphabetical order by their names:

• AUTOLOG

• CDATALEN

• CLIENT-CODE-PAGE

• CONACCESS

• EOR-JOBNAME-WITH-NODE

• EVENTLEN

• HOST-CODE-PAGE

• IDENTIFIER

• JOB-CLASS

• JOBCONS

• JOB-ELEM

• JOBEMAIL

• JOBENT

• JOBEVENT

• JOB-LIB

• JOB-NAME-CONS

• JOB-NAME-EMAIL

• JOB-NAME-EVENT

• JOB-NAME-SERVER

• JOB-RUN-PRIORITY

• JOB-START-OPTION

• JOB-TIME

• JOBSERVER

• LANGUAGE

• LOCAL-HOST

• LOOP

• MSGLEVEL

• NABS

• NODE

• NONACT

• NUMCONSMSG

• NUMFAT

• NUMMAIL

• NUMTASK

• NUMUSER

• PRMCONS

• PRMEMAIL

• PRMEVENT

• PRMSERVER

• PRODUCT

• READ-LOCKED-FILE

• RECALL

• SDF

• SDF-P

• SECURITY

• SERVER-DYN

• SERVER-MAX

• SERVER-MIN

• SERVER-NONACT

• SERVER-QUEUE-DEPTH

• SMTP-HOST

• SMTP-PORT

• SPOOL

• SYSTEM-COMMAND-USER

• TAPES

• TCP-HOST

• TCP-PORT

• TRACE

• TRACE-LEN

• TRACE-SAV

• VIEWSEC

AUTOLOG

Type	Default
Optional	YES

Specifies automatic logon to the Entire Systems Management Adapter at the start of the Natural session.

Possible options:

Option	Explanation
YES	No password check is done as part of the Entire Systems Management Adapter logon, as long as the specified user ID matches the internal Natural user ID. An implicit logon is performed if the first user request is not a logon call.
NO	No logon to the Entire Systems Management Adapter is performed at the start of the Natural session, but note that if an external security system is installed, a logon to the Entire Systems Management Adapter including user ID and password is always required.

CDATALEN

Type	Default
Optional	0

The maximum size (in K bytes) of the common data pool. A value greater than 0 must be specified if the view COMMON-DATA is to be used.

CLIENT-CODE-PAGE

Type	Default
Optional	ISO8859F

This parameter is used to define the client code page of the Linux x64 clients. See also parameter HOST-CODE-PAGE. For a detailed description, refer to the XHCS manual (Extended Host Code Support).

CONACCESS

Type	Default
Optional	NONE

Specifies the access capability of the Entire Systems Management Adapter node to the Console Task.

Possible options:

Option	Explanation
NONE	Default. Console Task will not be activated. The view CONSOLE can, therefore, only be used for the functions WTO and WTOR.
READ	Console Task will be activated if the parameter JOBCONS is specified. All retrieval functions of the view CONSOLE can be used.
WRITE	Same as for READ option, but operator commands can also be issued by using the view CONSOLE.

Write access can be restricted to certain users and commands, using the exit USERCSEC. For more information, see Security Considerations.

EOR-JOBNAME-WITH-NODE

Type	Default
Optional	NO

This parameter allows you to manipulate the composition of job names for Entire Operations tasks. If multiple Entire Operations monitors are running on the same machine, you may define this parameter value to YES. However, please consult Software AG support staff before adding or changing this parameter.

Possible options:

Option	Explanation
YES	The NODE parameter value is used to replace the rightmost three bytes of the EOR job names. If the value of NODE is greater than 999, the rightmost five bytes of the job names are used for the NODE value.
NO	The job names supplied by EOR are used without any modification.

EVENTLEN

Type	Default
Optional	0

Size of eventing memory pool in Kbytes. If the view EVENTING is to be used, you must specify a value of 3 or greater.

HOST-CODE-PAGE

Type	Default
Optional	EDF04F

This parameter is used to define the target character set for the Entire Systems Management Adapter for requests of Linux x64 clients and for any input data in view SEND-EMAIL. See also parameter CLIENT-CODE-PAGE.

Possible options:

Option	Explanation
EDF03DRV	Coded character set (CCS) EBCDIC.DF.03 ISO-7-bit German
EDF03IRV	Coded character set (CCS) EBCDIC.DF.03 ISO-7-bit International
EDF041	Coded character set (CCS) EBCDIC.DF.04 ISO-8-bit International
EDF04DRV	Coded character set (CCS) EBCDIC.DF.04 ISO-8-bit German
EDF04F	Coded character set (CCS) EBCDIC with EURO symbol (ISO code variant ISO 8859-15)

IDENTIFIER

Type	Default
Optional	None

String to identify the node. Maximum length is 50 bytes. This string can be retrieved from the field NODE-ID in the view SYSTEM-INFO.

JOB-CLASS

Type	Default	Maximum Value Length
Optional	TSOSBAT	8 bytes

Specifies the job class for the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOBCONS

Type	Default	Maximum Value Length
Optional	None	120 bytes

Specifies the location of the job control to start the Console Task. For details, see UCON Interface.

Possible options:

Option	Explanation
filename	Enter job is saved as file. The startup parameter SDF is omitted or set to NO to use ISP format, or set to YES to use SDF format.
library(element)	Enter job is saved as LMS element. The startup parameter SDF is omitted or set to NO to use ISP format.
*LIBRARY-ELEMENT(LIBRARY=library, ELEMENT=element)	Enter job is saved as LMS element. The startup parameter SDF is set to YES.

JOB-ELEM

Type	Default	Maximum Value Length
Optional	None	64 bytes

Specifies the LMS element name of type J to run the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOBEMAIL

Type	Default	Maximum Value Length
Optional	None	120 bytes

Specifies the location of the job control to start the E-Mail Manager Task.

For more information about E-Mail administration, see Run E-Mail Client.

Possible options:

Option	Explanation
filename	Enter job is saved as file. The startup parameter SDF is omitted or set to NO to use ISP format, or set to YES to use SDF format.
library(element)	Enter job is saved as LMS element. The startup parameter SDF is omitted or set to NO to use ISP format.
*LIBRARY-ELEMENT(LIBRARY=library, ELEMENT=element)	Enter job is saved as LMS element. The startup parameter SDF is set to YES.

JOBENT

Type	Default
Optional	None

This parameter is used to control the usage of privileged code for submitting jobs by Entire Systems Management Adapter.

Possible options:

Option	Explanation
YES	Entire Systems Management Adapter will execute privileged code to submit jobs.
NO	Entire Systems Management Adapter will not execute privileged code to submit jobs.
Not specified	Entire Systems Management Adapter will execute privileged code for submitting jobs on systems with encrypted passwords.

JOBEVENT

Type	Default	Maximum Value Length
Optional	None	120 bytes

Specifies the location of the job control to start the Eventing Task. The view EVENTING is only available if this task is running.

Possible options:

Option	Explanation
filename	Enter job is saved as file. The startup parameter SDF is omitted or set to NO to use ISP format, or set to YES to use SDF format.
library(element)	Enter job is saved as LMS element. The startup parameter SDF is omitted or set to NO to use ISP format.
*LIBRARY-ELEMENT(LIBRARY=library, ELEMENT=element)	Enter job is saved as LMS element. The startup parameter SDF is set to YES.

JOB-LIB

Type	Default	Maximum Value Length
Optional	None	54 bytes

Specifies the LMS library that finds the SDF-P procedure (defined by JOB-ELEM) to run the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method (activated by parameter SDF-P=YES).

JOB-NAME-CONS

Type	Default	Maximum Value Length
Optional	XCON199	8 bytes

Specifies the job name of the Console Task if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOB-NAME-EMAIL

Type	Default	Maximum Value Length
Optional	XEML199	8 bytes

Specifies the job name of the E-Mail Manager Task if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOB-NAME-EVENT

Type	Default	Maximum Value Length
Optional	XEVT199	8 bytes

Specifies the job name of the Eventing Task if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOB-NAME-SERVER

Type	Default	Maximum Value Length
Optional	XSRV199	8 bytes

Specifies the job name of the Server Task if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

JOB-RUN-PRIORITY

Type	Default	Maximum Value Length
Optional	STD	3 bytes

Specifies the run priority of the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

For details, refer to operand RESOURCES=*PARAMETERS(RUN-PRIORITY=value) of command ENTER-PROCEDURE.

JOB-START-OPTION

Type	Default	Maximum Value Length
Optional	IMMEDIATELY	17 bytes

Specifies the start option of the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

For details, refer to operand SCHEDULING-TIME=*PARAMETERS(START=value) of command ENTER-PROCEDURE.

JOB-TIME

Type	Default	Maximum Value Length
Optional	NO	5 bytes

Specifies the CPU limit of the ESA tasks if Entire Systems Management Adapter is using the SDF-P startup method activated by parameter SDF-P=YES.

For details, refer to operand RESOURCES=*PARAMETERS(CPU-LIMIT=value) of command ENTER-PROCEDURE.

JOBSERVER

Type	Default	Maximum Value Length
Required	None	120 bytes

Needs at least one Server Task to handle user requests. If this parameter is omitted, the Entire Systems Management Adapter terminates with an error message.

Possible options:

Option	Explanation
filename	Enter job is saved as file. The startup parameter SDF is omitted or set to NO to use ISP format, or set to YES to use SDF format.
library(element)	Enter job is saved as LMS element. The startup parameter SDF is omitted or set to NO to use ISP format.
*LIBRARY-ELEMENT(LIBRARY=library, ELEMENT=element)	Enter job is saved as LMS element. The startup parameter SDF is set to YES.

LANGUAGE

Type	Default
Optional	E

Specifies the language for console messages.

Possible options:

Option	Explanation
E	Default. Console messages appear in English.
G	Console messages appear in German.

LOCAL-HOST

Type	Default	Maximum Value Length
Optional	None	160 bytes

Specifies the domain name. In combination with the LOGON-ID, the parameter is used as sender address in SEND-EMAIL requests. You should use LOCAL-HOST only if there are difficulties in using the existing host name setting of the local machine.

LOOP

Type	Default
Optional	0

Determines the amount of CPU time (in seconds) which can be used by Entire Systems Management Adapter servers. The default value of zero (0) means there is no limit and no CPU time is recorded for display using the NATPROC-USER view.

We recommend setting this parameter to 200 to allow CPU times to be collected without interfering with long-running programs. If you receive the 5537 time limit error, you can increase this value.

MSGLEVEL

Type	Default
Optional	I

Specifies which message is to be written to the system messages protocol.

Possible options:

Option	Explanation
E | 3	Error. Only error messages are written. Information and warnings are suppressed.
W | 2	Warning. Suppresses the logging of startup parameters, as well as the messages indicating a user non-activity time-out.
I | 1	Info. All messages are written.

NABS

Type	Default
Optional	10

The number of attached buffers to be used. An attached buffer is an internal buffer used for interregion communication. An attached buffer pool will be allocated of a size equal to the value specified here multiplied by 4112.

NODE

Type	Default
Required	There is no default. n must be a value greater than or equal to 1 and less than or equal to 65535.

The Entire Systems Management Adapter DBID. It must be unique for each Entire Systems Management Adapter node.

NONACT

Type	Default
Optional	60

The non-activity time (in minutes). If a user has not issued a request to the Entire Systems Management Adapter during this time interval, the user is logged off, and the resources of the user will be freed.

NONACT=0 is rejected as invalid parameter value.

NUMCONSMSG

Type	Default
Optional	1024

This parameter defines the size of the table collecting console messages in number of messages. The value must be between 0 and 65535.

NUMFAT

Type	Default
Optional	128

Number of Fast Access Tables (minimum 0, maximum 256, size per table 8K). These tables are used for READ-FILE requests to cache the number of records per block for SAM files. Once a Fast Access Table is created for a SAM file, it improves the performance of accessing this file directly per RECORD-NUMBER.

NUMFAT=0 is used to disable this feature of READ-FILE.

NUMMAIL

Type	Default
Optional	0

Number of E-Mail control and data entries temporarily saved in E-Mail memory pool. This storage is needed for Interprocess Communication between ESASERV and ESAMAIL tasks of Entire Systems Management Adapter. The size of the E-Mail memory pool is defined by 32 bytes for one control block entry plus 1024 bytes for one data block entry multiplied by the NUMMAIL value. Maximum is 4096 entries.

For more information about E-Mail administration, see Run E-Mail Client.

NUMTASK

Type	Default
Optional	4

Number of tasks to be started for user requests as part of the Entire Systems Management Adapter initialization.

If Dynamic Server Management is enabled, NUMTASK specifies the number of Server Tasks started during initialization of Entire Systems Management Adapter.

For detailed information, see Dynamic Server Management.

NUMUSER

Type	Default
Optional	128

Number of ESA users (minimum 10, maximum 512). This value specifies the maximum number of users working in parallel. Please note that the length of a user session is fixed by the NONACT parameter.

PRMCONS

Type	Default	Maximum Value Length
Optional	None	120 bytes

Parameters for Enter of Console Task. If startup parameter SDF is set to YES, you must specify the values in SDF syntax.

PRMEMAIL

Type	Default	Maximum Value Length
Optional	None	120 bytes

Parameter for /ENTER of E-Mail Manager Task. If startup parameter SDF is set to YES, you must specify the values in SDF syntax.

PRMEVENT

Type	Default	Maximum Value Length
Optional	None	120 bytes

Parameters for Enter of Eventing Task. If startup parameter SDF is set to YES, you must specify the values in SDF syntax.

PRMSERVER

Type	Default	Maximum Value Length
Optional	None	120 bytes

Parameters for Enter of Server Task(s). If startup parameter SDF is set to YES, you must specify the values in SDF syntax.

PRODUCT

Type	Default
Optional	None

Name of additional library management systems. You must specify the parameter for each supported subsystem. Currently the only possible value is M for LMS.

READ-LOCKED-FILE

Type	Default
Optional	None

This parameter is used to control the usage of privileged code for opening locked SAM files by the Entire Systems Management Adapter.

Possible options:

Option	Explanation
YES	The Entire Systems Management Adapter will execute privileged code to open locked SAM files for reading records.
NO	The Entire Systems Management Adapter will not execute privileged code to open locked SAM files for reading records.
Not specified	The Entire Systems Management Adapter will execute privileged code for opening locked SAM files.

RECALL

Type	Default
Optional.	YES

Specifies whether migrated datasets can be recalled.

Possible options:

Option	Explanation
YES	Default. Migrated datasets can be recalled automatically.
NO	Migrated datasets cannot be recalled automatically.

SDF

Type	Default
Optional	NO

Specifies if SDF syntax is to be used for internal commands. If you specify YES, all JCL-related startup parameters must contain SDF syntax.

Possible options:

Option	Explanation
YES	SDF syntax is to be used.
NO	Default. ISP syntax is to be used.

SDF-P

Type	Default
Optional	NO

Use this parameter to control the startup method of Entire Systems Management Adapter.

Possible options:

Option	Explanation
YES	To run the various ESA tasks, Entire Systems Management Adapter is using the SDF-P procedure specified by the following parameters: JOB-ELEM JOB-LIB For the definition of more task specific attributes, the following parameters are available: JOB-CLASS JOB-NAME-CONS JOB-NAME-EMAIL JOB-NAME-EVENT JOB-NAME-SERVER JOB-RUN-PRIORITY JOB-START-OPTION JOB-TIME
NO	To run the various ESA tasks, Entire Systems Management Adapter is using the job control specified by parameters: JOBCONS JOBEMAIL JOBEVENT JOBSERVER

SECURITY

Type	Default
Optional	None

The security system in use.

Possible options:

Option	Explanation
NONE	No security system is used.
BS2	User ID and password are checked against TIAM user ID definitions in BS2000 (TSOSJOIN).
USER	Example exit USERLSEC must be modified to solve security considerations at your site.

SERVER-DYN

Type	Default
Optional	NO

Specifies if Dynamic Server Management has to be activated. This value can be changed dynamically via operator command.

For further information, see Dynamic Server Management.

Option	Explanation
YES	Dynamic Server Management is enabled at startup time.
NO	Dynamic Server Management is disabled at startup time.

SERVER-MAX

Type	Default
Optional	16

Specifies the maximum number of server tasks running in Entire Systems Management Adapter. This value is considered by the Dynamic Server Management as maximum capacity for a high workload. For further information, see Dynamic Server Management.

The following rule applies:

1 <= SERVER-MAX  <= 16 SERVER-MIN <= NUMTASK <= SERVER-MAX

SERVER-MIN

Type	Default
Optional	1

Specifies the minimum number of server tasks running in Entire Systems Management Adapter. This value is considered by the Dynamic Server Management as minimum capacity for a low workload. For further information, see Dynamic Server Management.

The following rule applies:

1 <= SERVER-MIN  <= 16 SERVER-MIN <= NUMTASK <= SERVER-MAX

SERVER-NONACT

Type	Default
Optional	10

Server non-activity time (in minutes). This value is considered by the Dynamic Server Management only. If a server has not been dispatched during this time interval, and no active request is assigned to that server, and SERVER-MIN is lower than the number of servers currently active, this server  will be stopped.

This value must be greater than zero.

For further information, see Dynamic Server Management .

SERVER-QUEUE-DEPTH

Type	Default
Optional	5

Server queue depth. This value is considered by the Dynamic Server Management only. If a new request (user command) arrives, and the number of assigned requests to the server with the lowest workload is greater or equal this value, and SERVER-MAX is higher than the number of servers currently active, a new server will be started to handle that request.

This value must be greater than zero.

For further information, see Dynamic Server Management .

SMTP-HOST

Type	Default	Maximum Value Length
Optional	There is no default.	120 bytes

Specifies the host name used as mail gateway. This is a DNS name. SEND-EMAIL view cannot work without specifying a valid value for this startup parameter. Contact your mail administrator to determine this host name.

For more information about E-Mail administration, see Run E-Mail Client.

SMTP-PORT

Type	Default
Optional	25

The SMTP port number used on the mail gateway. SEND-EMAIL view cannot work without specifying a valid value for this startup parameter. Contact your mail administrator to determine this port number.

For more information about E-Mail administration, see Run E-Mail Client.

SPOOL

Type	Default
Optional	BS2

Specifies the spooling system in use.

Possible options:

Option	Explanation
NONE	No SPOOL interface
BS2	BS2000 Spool

SYSTEM-COMMAND-USER

Type	Default	Maximum Value Length
Optional	There is no default.	160 bytes

This parameter specifies a list of user IDs authorized to use view SYSTEM-COMMAND.

User exit USERSSEC is called during execution of view SYSTEM-COMMAND only if parameter SYSTEM-COMMAND-USER is NOT specified. Otherwise, USERSSEC is ignored.

Possible options:

Option	Explanation
userID1[,userID2[,userIDn]]	List of authorized user IDs.
NONE	No userID is authorized.

TAPES

Type	Default
Optional	NO

Specifies whether your site allows access to mounted tapes from any Natural session.

Possible options:

Option	Explanation
YES	Access to mounted tapes allowed.
NO	Access to mounted tapes not allowed.

TCP-HOST

Type	Default
Optional	0.0.0.0

Defines the address of the network interface on which Entire Systems Management Adapter listens for connection requests. If TCP-HOST is not specified or set to 0.0.0.0, Entire Systems Management Adapter listens on any attached interface adapter of the system.

Possible options:

Option	Explanation
0.0.0.0	Listens on any attached network interface adapter.
hostname	Listens on IP address resolved for specified hostname.
IP address	Listens on specified IP address.

TCP-PORT

Type	Default
Optional	3930

The TCP/IP port number on which the Entire Systems Management Adapter listens for connection requests. If not specified, the default value of 3930 is used.

TRACE

Type	Default
Optional	PREP

Specifies how to set up the TRACE environment.

Possible options:

Option	Explanation
YES	TRACE environment is activated at ESA startup.
PREP	TRACE environment will be initialized, but not started yet.
NO	TRACE environment is completely deactivated.

If the YES or PREP option is specified, the TRACE activity can be manipulated via operator command to start or stop traces dynamically.

For further information, see Creating Trace Data for Diagnostic Purposes.

TRACE-LEN

Type	Default
Optional	8

Specifies the size of the trace memory pool (in Kbytes). This value is considered only if you define TRACE=YES or TRACE=PREP.

For further information, see Creating Trace Data for Diagnostic Purposes.

TRACE-SAV

Type	Default
Optional	YES

TRACE-SAV controls the trace save routine at exit.

Possible options:

Option	Explanation
YES	TRACE data buffers will be saved.
NO	TRACE data buffers will not be saved.

For further information, see Creating Trace Data for Diagnostic Purposes.

VIEWSEC

Type	Default
Optional	NONE

The name of the view security exit to limit usage of views to a list of user IDs. A sample exit named USERVSEC is supplied as source member on the installation tape.

Possible options:

Option	Explanation
name	Name of the view security exit. Example exit USERVSEC must be modified to solve the security considerations at your site.
NONE	Default. View security exit is not activated.