LTA Disk Files
Each LTA Agent can have multiple active disk files with a maximum of five per agent in the Substation ES region. Disk files to be used by the LTA Agents must have a corresponding DD Name on the LOGDSK-DDN or TRCDSK-DDN keyword.
WARM or COLD Options
- The COLD option, which 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.
- The WARM option, which 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.
Reuse
- If you specify Y for the -WRAP keyword, that means that when all the files for the Agent are full, the oldest information is overwritten. This option is recommended for trace files with a high volume of recorded information or if old information does not need to be kept or archived. Y is the suggested value for testing and development environments.
- If you specify N for the -WRAP keyword and a file is full, the Agent switches to the next available file. The file that is deemed full must be archived or the file reset if the file is to be reused.
The default value of the keywords is N, meaning not to reuse the disk file until the data is archived (offloaded) or reset.
You can view the information on the status of the trace files on disk with the SHOW,TRCSTATS<,ALL> operator command.
Search and Display Facility
If log and trace information is written to disk files, you can view the recorded information online in the Substation ES panels.
File Selection Panel
SXLP001 ------------------------- Log Viewer --------------------------------- Command ===> ISPF Log: Project . . . . . ________ Group . . . . . . ______________________________________ Type . . . . . . ________ Other VSAM Cluster Name: Cluster Name . . 'TIBQA.SXS.V2R7M0.FY.LOG.DISKF1' Display Format ===> 2 (1, 2) Direction ===> F (F-Forward B-Backward) Number to Read ===> 9999 (Number to read initially) VSAM Debug ===> (0 - 4) Pgm Debug ===> (0 - 4) Enter END command to terminate.
The following table describes the fields in this panel.
Field | Description |
---|---|
ISPF Log | This field specifies a log to view either by providing values for Project, Group, and Type; or by specifying a fully qualified cluster name in the Other VSAM Cluster Name field. If this field is nonblank, the value for the Other VSAM Cluster Name field is in effect. |
Display Format | Format 1 is one recorded entry per line (truncated if necessary). Format 2 is a two-line display with the description on the second line. |
Direction | This field has two options: Forward and Backward. Backward starts with the most recently recorded entries and reads backward for the specified number of records, thus showing the most current activity. |
Number to Read | This field specifies the number of recorded entries to display. If you do not specify a value, the default of 200 is in effect. |
VSAM Debug | This field defines the debugging levels for the VSAM access routines. Do not change this value unless requested by authorized TIBCO personnel. The default is 0 (zero). |
Pgm Debug | Defines the debugging levels for the ISPF interface program. Do not change this value unless requested by authorized TIBCO personnel. The default is 0 (zero). |
SXLP002---------------------- Log Entries ------------------------ Row 1 of 29 Command ===> Scroll ==> PAGE Sel Time Type Msg Id RC Rsn Message - ------------- ---- -------- ---- ---- -------------------------------------- 11:09:54.0919 154 SXG1600I 0 0 Log Agent Starting - Logging to TIBLOG 11:09:54.1126 154 SXG1800I 0 0 Parameter Log Agent Starting - Logging 11:09:54.4368 154 SXS1000I 0 0 Starting ~ TIBCO Substation (ES) for O 11:09:54.4596 154 SXS1009I 0 0 Substation (ES) - Version 2.0.0 11:09:54.7894 154 SXG2801I 0 0 Initialized ~ Substation ES - Admin & 11:09:55.0454 154 SXG2800I 0 0 Starting ~ Substation ES - Transformer 11:09:55.0479 0 SXT5717I 0 0 Trace level 1, 10 work threads; Cfg:TI 11:09:55.2871 154 SXG2801I 0 0 Initialized ~ Substation ES - Transfor 11:09:55.3874 154 SXG2800I 0 0 Starting ~ Substation ES - CICS Interf 11:09:55.4673 154 SXC3000I 0 0 CICSTS4G - Connect IICICS to CICS Regi 11:09:55.5539 154 SXC3001I 0 0 CICSTS4G - Connect IICICS to CICS Regi 11:09:55.5590 154 SXG2801I 0 0 Initialized ~ Substation ES - CICS Int 11:09:55.5950 156 SXC3400I 0 0 CICSTS4G - Started CICS EXCI Session ( 11:09:55.6130 156 SXC3400I 0 0 CICSTS4G - Started CICS EXCI Session ( 11:09:55.6352 154 SXG2800I 0 0 Starting ~ Substation ES - IMS Interfa 11:09:55.6612 154 SXI4000I 0 0 A01IMSG - Connect IIIMS to IMS Region 11:09:55.7283 154 SXI4001I 0 0 A01IMSG - Connect IIIMS to IMS Region 11:09:55.7326 154 SXG2801I 0 0 Initialized ~ Substation ES - IMS Inte 11:09:55.7336 154 SXS1001I 0 0 Initialized ~ Substation ES for IVP's 11:09:55.8350 154 SXG1801I 0 0 Parameter Log closed 11:09:55.8362 154 SXS2120I 0 0 (B) HiMark:0 Occ:1024 Incr:0 Curr:0 11:09:55.8363 154 SXS2121I 0 0 (F) Stress Levels Strt:768 Slow:819 St 11:09:55.8408 154 SXS2120I 0 0 (A) HiMark:410 Occ:1024 Incr:102 Curr: 11:09:55.8504 154 SXG2806I 0 0 Activated ~ Substation ES - CICS Inter 11:09:55.8521 154 SXG2806I 0 0 Activated ~ Substation ES - Transforme 11:09:55.8525 0 SXT5036I 0 0 All transformer tasks are Good To Go 11:09:55.8525 154 SXG2806I 0 0 Activated ~ Substation ES - Admin & Op 11:09:55.8531 154 SXG2806I 0 0 Activated ~ Substation ES - IMS Interf 11:09:55.8610 154 SXG2806I 0 0 Activated ~ Substation ES for IVP's ******************************* Bottom of data ********************************
The following table describes the fields in the panel.
Field | Description |
---|---|
Sel | If you specify S in the input column, a pop-up panel with all the values that relate to the selected message is displayed. |
Time | This field shows the time this message was recorded by the LTA Agent. |
Type | This field shows the code of the internal message type. |
Msg Id | This field shows the message identifier. |
RC | This field shows the return code associated with the message. |
Rsn | This field shows the reason code associated with the message. |
Message | This is the initial part of the message description. The entire message is displayed if you select the pop-up panel. |
The following table describes the fields in the panel.
Field | Description |
---|---|
Msg Id | This is an eight-character message identifier. |
Type | This is the internal message type. |
Date | This is the date on which this message was recorded by the LTA Agent. |
Time | This is the time at which this message was recorded by the LTA Agent. |
Union id | This is the representation of what message fields were recorded for this entry. See TIBCO Substation ES Messages and Codes for a description. |
GRIN | This is the internal Global Resource Identification Number. |
Proc Id | This is the internal process identifier, which identifies a Substation ES task or sub-task. |
Thread | This is the thread of Substation ES that issued the message. |
Stck | This is the internal 64-bit Store Clock value, which uniquely identifies this message. |
RC | This is the return code associated with the message. |
Reason | This is the reason code associated with the message. |
Message | This is a complete message description and can be in multiple lines, if necessary. |