Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Operations and Administration : Configuration

Configuration
TIBCO Mainframe Service Tracker provides facilities and standard MVS methods for configuring and administering the product. The software contains partitioned data set (PDS) members that consist of a default set of parameters, which are normally sufficient to activate the product.
For a list of the parameters to customize during installation, see Customization and Startup.
Configuration parameters are in the members SXKPHAWK and SXKPRV.
Parameter Syntax
Each configuration parameter contains a keyword, which specifies how to implement a particular function and its associated value. Keywords, which are alphanumeric with no spaces or blanks (low values), must start in column 1 of the input record. For PDS member input parameters, you must separate keyword values with an equal sign (=).
Keyword Values
You must specify keyword values in the valid format. Keywords can be uppercase, lowercase, or mixed case; and are usually in one of the following formats:
A string or sentence with embedded spaces. Be sure to enclose the entire string or sentence within single quotation marks (for example, ’TIBCO Software Inc.’). This string is truncated if it exceeds the maximum length.
 
Comments
You can insert comments or comment lines between parameters or after keyword values. A comment follows the first space, as in JCL comments. An entire comment line begins with an asterisk in column 1.
Main Parameters
Table 11 describes the main parameters in TIBCO Mainframe Service Tracker.
 
Table 11 Main Parameters
The identity of the associated subsystem. The value must be unique for each instance of TIBCO Mainframe Service Tracker on a logical partition (LPAR). You can also specify the value in the parm field of the EXEC statement, preceded with -S, for example, -SSXKS. If you specify the value in both the parm field and control member, the value in the latter takes precedence.
A job name or job-name prefix that specifies the job or jobs to be monitored by the Tracker Server. MONJOB supports up to 50 entries.
Component Parameters
Table 12 describes the parameters and values that define their characteristics and behavior. Typically, you construct multiple component parameter statements. You can only specify those statements after the COMPONENT control statement.
 
The component within TIBCO Mainframe Service Tracker. Each component represents a single subtask. The value cannot be blank.
MAIN – The main task
TASK – The task manager task
CONSOLE – The console handler, which stops and modifies commands
SUBSYSTM – Creation and termination of a subsystem, which monitors job activities
SUBSMCL – The Smart Client interface
HAWKCNTL – Hawk control routines
HAWKPRC – Hawk processing routines
JOBTRACK – Information tracking of job and job steps
RVSEND – Parameters for publishing z/OS event messages through Rendezvous
RVLISTEN – The parameter for listening to RESEND requests
RVDISPCH – The parameter for dispatching events
0 – Always published regardless of the value.
1 – Errors only or exceptions that do not happen in normal processing.
2 – Major events, such as startup and shutdown; major connections; and unusual but expected events.
3 – More common events.
4 – Detailed trace of processing that describes all events as they occur.
5 – Hex displays of control blocks and data structures.
The name of a component defined as ATTACHTYPE=SHRQ, which functions as a recipient of work messages.
The name of a component defined as ATTACHTYPE=SHRQ, which functions as a source of work messages.
An identifier with which the console modify commands specify the receiving component.
The amount of time (in microseconds) to wait for TIBCO Mainframe Service Tracker to initialize. The maximum value is 2000000000.
Default: 10000000
The amount of time (in microseconds) to wait for TIBCO Mainframe Service Tracker to terminate. The maximum value is 2000000000.
Default: 2000000
The ATTACHTYPE=NONE setting causes TIBCO Mainframe Service Tracker to bypass the related component. That is, the related component is not attached or processed during this invocation of TIBCO Mainframe Service Tracker.
Rendezvous Parameters
Table 13 describe the parameters of the component RVSEND. You can only specify these statements after the RVSEND COMPONENT control statement.
The daemon used by the RVSEND component to publish z/OS event messages. The syntax is host:port, where:
host is the URL or IP address of the machine on which the Rendezvous daemon runs.
port is the TCP port.
Default: tibtrk.jobstep
Default: tibtrk.logmsg
Default: tibtrk.resend.response
Default: tibtrk.resend.request
Hawk Parameters
Table 14 describes the Hawk component parameters. For details on Hawk parameters, see the TIBCO Hawk Installation and Configuration manual.
Table 14 Hawk Parameters 
host is the URL or IP address of the machine on which the Rendezvous daemon runs.
port is the TCP port.
NETWORK (Optional)
Default: TIBCO-TRACKER
Default: TIBCO TRACKER for Bushmen
Default: 3000000
SYSLOG Parameters
Table 15 describes the SYSLOG parameters.
Table 15 SYSLOG Parameters 
A SYSLOG message ID or a prefix of the message ID to be tracked and reported by the Tracker Server, for example:
LOGMSGID=$HASP37*
LOGMSGID=$HASP100
LOGMSGID supports up to 50 entries.
A word or a portion of the SYSLOG message to be tracked and reported by the Tracker Server, for example:
LOGCHAR='$HASP373 INIT'
LOGCHAR=Security
LOGCHAR supports up to 50 entries.
JOBTRACK Parameter
Table 16 describes a JOBTRACK parameter.
z/OS Subsystem Parameters
Table 17 describe the z/OS subsystem parameters.
Default: SXKASINI
Default: SXKASFUN
Default: The subsystem ID with JXAC appended, for example, SXK1JXAC
Default: The subsystem ID with JXJI appended, for example, SXK1JXJI
Subsystem Control Parameters
Table 18 describes the subsystem control parameters, which you enter without an equal sign or a value. They are stand-alone keywords, similar to TRK or CYL in JCL.
Log and Trace Parameters
Table 19 describes the log and trace parameters.
 
The values for the parameters that specify the diagnostic level (such as DBGLVLALL) ranges from 0 through 5, where 0 is none and 5 is verbose unless otherwise specified, as with DBGLVLALL-WTO.
Valid Values: 0 through 5
The default diagnostic level for the intertask messages for all components. SRW stands for send-receive-wait. The recommended value is 2.
Valid Values: 0 through 5
The diagnostic level for write-to-operator (WTO) messages issued by the subsystem functions routines and the SMF exits.
1 – Allow error messages
2 – Show major events, such as one-time starting messages
3 – Show major events, such as one-time starting messages
4 – Activity messages for the requested jobs
5 – Activity messages for all jobs
LOGDDN (optional)
The Data Definition (DDName) of the data set in which the formatted log information is written. DDName must appear in the Tracker Server’s startup procedure.
Default: TIBLOG
LOGFMT (optional)
The log format. When log information for the Tracker Server is routed to a print file, this value determines the edit format in which to display the routed information.
1 – Short format output
2 – Short format with information on the location of the Tracker Server
LOGROUTE (optional)
The location to which the output for log entries is routed. The DDName selected for routing to a print file is specified by the value of the LOGDBUGDD keyword. The DDName selected for routing to a disk file is specified by the value of the LOGDISK1|LOGDISK2|LOGDISK3|LOGDISK4|LOGDISK5 keywords.
P(rint) – Formatted print format: a formatted print file, similar to SYSPRINT.
D(isk) – Disk file: a VSAM [virtual storage access method] RRDS [Relative Record Data Set] disk file formatted for the Tracker Server.
Note: P is the only valid option in the current release.
LOGDBGDDN (optional)
The DDName of the data set in which LTA [Logging, Tracing, and Auditing] agents of the Tracker Server internal debugging information is written. The DDName must appear in the Tracker Server’s startup procedure, if required, for the debugging messages to be displayed.
Default: LOGDEBUG
LOGDBGLVL (optional)
The trace debug level. The LTA agents of the Tracker Server have their own internal debugging facility. Always leave this value as the default (1) unless TIBCO Support requires the output. The DDName LOGDBGDDN is required in the startup procedure if you specify a nonzero value. The output is directed to SYSOUT.
Valid Values: 0 through 5
Note: A value of greater than 1 produces overhead and many lines of output.
TRCDDN (optional)
The DDName of a data set in which Tracker Server-formatted trace information is written. This name must appear in the Tracker Server’s startup procedure.
Default: TIBTRACE
TRCFMT (optional)
The format for logged trace information. When trace information is routed to a print file, this value determines the format in which to display the routed information.
1 – Short format output
2 – Short format with Tracker location information
TRCROUTE (optional)
The location to which the output for trace entries is routed. The DDName selected for routing to a print file is specified by the value of the TRCDDNAM keyword. The DDName selected for routing to a disk file is specified by the value of the TRCDISK1|TRCDISK2|TRCDISK3|TRCDISK4|TRCDISK5 keywords.
P(rint) – Formatted print format: a formatted print file, similar to SYSPRINT.
D(isk) – Disk file: VSAM RRDS disk file formatted for TIBCO Mainframe Service Tracker.
Note: P is the only valid option in Release 1.0.0.
TRCDBGDDN (optional)
The DDName of a data set into which LTA agents of the Tracker Server’s internal trace information is written. This name must appear in Tracker Server’s startup procedure, if required, for the debug messages to be displayed.
Default: TRCDEBUG
TRCDBGLVL (optional)
The trace debug level. The LTA Agents have their own internal debugging facility. Always leave this value as the default (1) unless TIBCO Support requires the output. The DDName LOGDBGDDN is required in the startup procedure if you specify a nonzero value. The output is directed to SYSOUT.
Valid Values: 0 through 5
Note: A value of greater than 1 produces overhead and many lines of output.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved