FST2 transaction

The FST2 transaction is the MainView for CICS and MainView AutoOPERATOR for CICS control transaction.

It is used internally by MainView and you can also use it from a console defined to CICS or a terminal logged onto CICS. With it you can control:

  • the MainView extractor

  • the task kill agent

  • the initialization and termination of the BBI-SS PAS communication

  • starting and stopping MainView AutoOPERATOR for CICS

  • switching the dual CMRDETL data sets immediately

  • forcing the writing of the CMRDETL VSAM buffer

  • controling program CPU timing data collection

  • controling the setting of the SMF return code from the CICS XMNOUT global exit

  • activating and deactivating session data collection

  • activating and deactivating temporary storage queue usage data collection

  • activating and deactivating transient data queue usage data collection

  • activating and deactivating web services usage data collection 

The following table describes the available FST2 transaction commands and their function.

Note

If a command is not provided for the FST2 transaction, only BBI-SS communications are established.

FST2 transaction commands

Command

Description

TERM, TRM

Terminates the MainView agents, records the MainView agent processing environment, and removes the MainView agents from the target CICS. Agents such as the extractor, task kill, and MainView AutoOPERATOR for CICS are terminated and their operating status is recorded in the BMCMVCTQ temporary storage queue. All MainView resources are discarded and released and communications with the BBI-SS PAS is terminated.

INIT, INI

Initializes the MainView agents by creating all resources, loading necessary programs, initiating communications with the BBI-SS PAS, and starting various functions, such as task kill, the extractor, and MainView AutoOPERATOR for CICS. The first time it is used in a target CICS a PLT-type initialization is performed (functions are started based on the presence of resources and settings in the CMRSOPT options table). Subsequent uses within the same running target CICS restores the environment that was recorded by the TERM process.

If the CICS target is not connected to a BBI-SS PAS at the time of the TERM function, the subsequent INIT function initiates agents based on the CMRSOPT settings.

The INIT command also accepts a 1-4 character name that identifies the BBI-SS PAS to which a communications connection is desired. Identification is specified immediately after the command (for example, FST2 INIT ssss will perform the initialization process and request a connection to the BBI-SS PAS identified by ssss).

blank

The FST2 transaction entered without a command operand initiates BBI-SS PAS communications. No other MainView agents are started.

QOFF, QOF

Shuts down the MainView for CICS extractor agent. The exit routines are disabled and the detail files are closed. No resources are discarded or released.

QON

Starts the MainView for CICS extractor agent.

RES

Restarts MainView for CICS within the target CICS by performing a FST2 TERM followed by a FST2 INIT process.

The TERM process terminates the MainView agents, records the MainView agent processing environment, and removes the MainView agents from the target CICS system. Agents such as the extractor, task kill, and MainView AutoOPERATOR for CICS are terminated and their operating status is recorded in the BMCMVCTQ temporary storage queue. All MainView resources are discarded and released, and communications with the BBI-SS PAS is terminated.

The INIT process initializes the MainView agents by:

  • Creating all resources

  • Loading necessary programs

  • Initiating communications with the BBI-SS PAS

  • Starting various functions (such as task kill, the extractor, and MainViewAutoOPERATOR for CICS)

This process restores the environment that the TERM process recorded.

If MainView for CICS is already terminated when the operator issues the RES command, the FT920I message is issued and the INIT process is performed.

The RES command does not support including a BBI-SS PAS ID for the INIT process.

SWI

Switch the dual CMRDETL data sets immediately.

FLU

Force (flush) the writing of the CMRDETL VSAM buffer.

KOFF, KOF

Terminates the MainView for CICS task kill agent.

KON

Starts the MainView for CICS task kill agent.

KRLD, KRL

Reloads the MainView for CICS task kill function. Resources are discarded, released, recreated, loaded and the KOFF and KON functions are performed.

SYSM OFF, AOFF, AOF

Terminates the MainView AutoOPERATOR for CICS agent.

SYSM ON, AON

Starts the MainView AutoOPERATOR for CICS agent.

LOFF, LOF

Terminates the MainView for CICS long running task, BCRT. This command should not be used unless directed by BMC Software's MainView for CICS support.

LON

Starts the MainView for CICS long running task, BCRT. This command should not be used unless directed by BMC Software's MainView for CICS support.

PGY, PGON

Starts the MainView for CICS Program CPU Timing facility.

PGN, PGOF

Stops the MainView for CICS Program CPU Timing facility

CSY/ CSON

Activates session/connection activity recording

CSN/ CSOFF

Deactivates session/connection activity recording

PON

Sets the XMNOUT return code to initiate SMF writing of the CICS performance records.

POF/ POFF

Sets the XMNOUT return code to terminate SMF writing of the CICS performance records.

EON

Sets the XMNOUT return code to initiate SMF writing of the CICS exception records.

EOF/ EOFF

Sets the XMNOUT return code to terminate SMF writing of the CICS exception records.

RON

Sets the XMNOUT return code to initiate SMF writing of the CICS resource records.

ROF/ ROFF

Sets the XMNOUT return code to terminate SMF writing of the CICS resource records.

TDY/ TDON

Activates transient data (TD) queue activity recording

TDN/ TDOF

Deactivates transient data (TD) queue activity recording

TSY/ TSON

Activates temporary storage (TS) queue activity recording

TSN/ TSOF

Deactivates temporary storage (TS) queue activity recording

WSY/WSONActivates web services activity recording
WSN/WSOF Deactivates web services activity recording

Note

The SMF related commands—PON, POF, EON, EOF, RON, ROF, CON, COF—modify the return code that is set by the MainView for CICS program enabled at the XMNOUT CICS global exit. The return code determines whether the record is written to the operating system SMF files. Other programs that are enabled at the XMNOUT global exit point after the MainView for CICS program, might also alter this return code.

Was this page helpful? Yes No Submitting... Thank you

Comments