FST2 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.
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:
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/WSON | Activates 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.
Comments
Log in or register to comment.