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.INTF 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-REMOTE {N | Yes, No} Optional.

The LOG2-REMOTE parameter specifies whether Substation ES messages are to be written to a remote application of the z/OS system.

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} 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.

If you do not specify a value, the default value 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.

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.

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.
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} 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.

If you do not specify a value, the default value 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.

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.