# System Startup Parameters (SSPs)

You can specify the SSPs in the PARM parameter associated with the `EXEC` statement, which is in the Substation ES startup JCL or procedure. By default, the SSPs are specified in the PDS member named `SXSSSP$1`, which is located in the library referenced by the DD name `TIBPARM`.

If no SSPMEM parameter is specified in the `PARM` statement and no member `SXSSSP$1` exists, Substation ES supplies default values for all required parameters. Optionally, you can specify certain keywords and values that pertain to the SSP in the PARM parameter for starting Substation ES.

All keyword values in the PARM parameter of the JCL must be prefixed by an en dash or minus sign (-). Keyword values are separated from keywords by one or more spaces. The following example shows the PARM parameter of an `EXEC` statement:

`PARM='-SSPMEM SXSSSP$1 -logfmt 2 -trcfmt 3'`

In this example, the parameter members for Substation ES are in the `USERHLQ.PARM` library.

Note: Only certain SSP values in the PARM parameter of the `EXEC` statement override the values in the SSP member.

The following table lists the SSPs. In the syntax of the following parameters, the default values, if any, are listed to the left of the vertical separator bar ( | ).

System Startup Parameters
Parameter | Description
--- | ---
SSPMEM {SXSSSP$1 | SSP member name} | Optional. The SSPMEM parameter specifies the name of the SSP member. This member contains the keywords and values for the Log, Tracing, and Auditing agents; specific values for Substation ES; and reference to the main SIP member of Substation ES. If you do not specify a value, the default value applies.
SIPMEM {SXSSIP$1 | SIP member name} | Optional. The SIPMEM parameter specifies the name of the main SIP member. This member contains the values for the main task initialization, the common values for Substation ES, and the reference to the interfaces that can be started by the initialization routines. If you do not specify a keyword and value for this SSP, the default value applies.
LOG2-SYSLOG {20 | 0, 4, 8, 20} | Optional. The LOG2-SYSLOG parameter specifies the severity of Substation ES log messages printed to the z/OS `SYSLOG`. This parameter provides automation tools that pick up and react to Substation ES messages. The valid values are as follows: 0: print all log entries. 4: print all messages that are warnings or a greater severity. 8: print all messages of that severity and higher or those that are suffixed with E, C, or F and written to the Substation ES log. 20: print nothing in addition to the z/OS `SYSLOG`.
LOGDDN {TIBLOGPR | DDName} | Optional. The LOGDDN parameter specifies the DD name of the data set to which formatted log information is written. If you do not specify a value, the default value applies.
LOGDEST {Print | Print, Disk, Stream} | Optional. The LOGDEST parameter specifies the location to which the output for log entries is routed. The valid values are as follows: P: formatted Print format. This is a formatted print file, similar to `SYSPRINT`. D: disk file. This is a VSAM RRDS disk file formatted for Substation ES. S: using the z/OS system logger stream name. If you do not specify a value, the default value P applies. The DD name selected for routing to a Print file is specified by the value of the LOGDDN keyword. The DD name selected for routing to a Disk file is specified by the value of the LOGDSK-DDN keyword. The z/OS System Logger Stream name is specified by the value of the LOGSTREAM-ID keyword.
LOGFMT {2 | 1,2,3} | Optional. The LOGFMT parameter specifies the log format. The valid values are as follows: 1: short format output. 2: short format output with information on the Substation ES location. 3: detailed format output. If you do not specify a value, the default value applies. If log information for Substation ES is routed to a Print file, this value determines the edit format that displays the routed information. For details about logging, see the TIBCO Substation ES Operations and Administration manual.
LOGDBLVL {0 | 0-5} | Optional. The LOGDBLVL parameter specifies the level of debug information that is generated for the log. The valid values range from 0 through 5. If you do not specify a value, the default value applies. The LTA agents of Substation ES have their own internal debugging facility. This value must always be the default or specified as 0 unless TIBCO Support requires the output. If you specify a non-zero value, the DD Name `TIBLOGDB` is required in the startup procedure. The output is directed to `SYSOUT`. Note: A certain amount of overhead and many lines of output are produced if this value is greater than 1.
LOGDSK-DDN {DDName} | Optional. The LOGDSK-DDN parameter specifies the DD name of a data set for logging Substation ES messages, errors, and general information to disk. You can specify up to five `LOGDSK-DDN` entries for each SSP member.
LOGDSK-START {Warm | Warm, Cold} | Optional. The LOGDSK-START parameter specifies whether the information written to the log data set is kept across Substation ES instances. An instance ends when Substation ES is shut down or terminated. COLD: Indicates that previously recorded information is overwritten. All disk files for the specified Agent are reset to empty and the existing information within these files cannot be accessed again. The information is lost. WARM: Indicates that when Substation ES starts, the information recorded in the previous executions is retained and new information is recorded following the most recent entry in the last used file. The information is retained.
LOGDSK-WRAP {N | Yes, No} | Optional. The LOGDSK-WRAP parameter specifies whether the information written to the log data set is overwritten if the data set is deemed full. The valid values are as follows: Yes: if all the data sets defined and used as log data sets are full, the latest information is overwritten. No: no information is overwritten. If all the data sets are full, the disk facility is disabled and information recorded to `SYSOUT`. That means that the `LOGDEST` value is automatically switched to P at run time.
SYSLOG-MEM={Name } | Optional. The SYSLOG-MEM parameter specifies the Tibco Mainframe Logger member name. This member contains the common values for the Tibco Mainframe Logger. If you do not specify a keyword and a value for the SYSLOG-MEM, the Logger function will be turned off.
TRCDDN {TIBTRCPR | DDName} | Optional. The TRCDDN parameter specifies the DD name of a data set to which trace and debug information is written. If you do not specify a value, the default value applies.
TRCFMT {3 | 1, 2, 3} | Optional. The TRCFMT parameter specifies the format for the logged trace information. The valid values are as follows: 1: short format output. 2: short format with information on the Substation ES location. 3: detailed format output. If you do not specify a value, the default value applies. If Substation ES trace information is routed to a Print file, this value determines the edit format that displays the routed information. For more information about tracing, see the TIBCO Substation ES Operations and Administration manual.
TRCDEST {Print | Print, Disk, Stream} | Optional. The TRCDEST parameter specifies the location to which the output for trace entries is routed. The valid values are as follows: P: Formatted Print format. This is a formatted print file, similar to SYSPRINT. D: Substation disk file. This is a VSAM RRDS disk file formatted for Substation ES. S: using the z/OS System Logger Stream name. If you do not specify a value, the default value P applies. The DD name selected for routing to a Print file is specified by the value of the TRCDDN keyword. The DD name selected for routing to a Disk file is specified by the value of the TRCDSK-DDN keyword. The z/OS System Logger Stream name is specified by the value of the TRCSTREAM-ID keyword.
TRCDBLVL {0 | 0-5} | Optional. The TRCDBLVL parameter specifies the trace debug level. The valid range is 0 through 5. The Substation LTA agents have their own internal debugging facility. This value must always be the default or specified as 0 unless TIBCO Support requires the output. If you do not specify a value, the default value applies. If you specify a non-zero value, the DD Name `TIBTRCDB` is required in the startup procedure of Substation ES. The output is directed to `SYSOUT`. Note: A certain amount of overhead and many lines of output are produced if this value is greater than 1.
TRCDSK-DDN {DDName} | Optional. The TRCDSK-DDN parameter specifies the DD name of a data set for trace information. Substation ES traces, dumps, messages, errors, and general information are written to disk. You can specify up to five `TRCDSK-DDN` entries for each SSP member.
TRCDSK-START {Warm | Warm, Cold} | Optional. The TRCDSK-START parameter specifies whether the information written to the `Trace` data set is kept across instances of Substation ES. An instance ends when Substation ES is shut down or terminated.
TRCDSK-WRAP {N | Yes, No} | Optional. The TRCDSK-WRAP parameter specifies whether the information written to the `Trace` data set is overwritten if the data set is deemed full. The valid values are as follows: Yes: if all the data sets defined and used as `Trace` data sets are full, the latest information is overwritten. No: no information is overwritten. If all the data sets are full, the disk facility is disabled and information is recorded to `SYSOUT`. That means that the `TRCDEST` value is automatically switched to `P` at run time.

Copyright © TIBCO Software Inc. All rights reserved.