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

You must define and format LTA disk files before they can be used.

## WARM or COLD Options

Information recorded to disk files can be kept or overwritten across multiple restarts of Substation ES. This feature is available if you specify the appropriate value on the `LOGDSK-START` and `TRCDSK-START` keywords. The default is to retain information. Two options are available:

- 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

The LTA Agents can reuse currently full disk files without offloading information. This feature is available if you specify the appropriate value on the `LOGDSK-WRAP` and `TRCDSK-WRAP` keywords. Two options are available:

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

Note: If all the files for an Agent are full, Substation ES suspends operations and reroutes information to the formatted print file. If that fails, the applicable LTA Agent is disabled. Avoid having LTA Agent files become full by archiving their information in a timely manner. Currently, no automatic archiving is available.

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.

To access the LTA display panels:

1. Execute the following command:

   TSO EX ’USERHLQ.CLIST(SXGSSPNL)’

2. Select Option 2, LTA Search and Display Facility.

   The following describes the related 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.

File Selection Panel Fields
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).

LTA Multiple Entry Panel

    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.

LTA Multiple Entry Panel Fields
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.

LTA Message Pop-up Panel

The following table describes the fields in the panel.

LTA Message Pop-up 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.

Copyright © TIBCO Software Inc. All rights reserved.