FST2 transaction
The FST2 transaction is the
BMC AMI Ops Monitor for CICS
and
BMC AMI Ops Automation for CICS
control transaction.
It is used internally by BMC AMI Ops and you can also use it from a console defined to CICS or a terminal logged onto CICS. With it you can control:
- The BMC AMI Opsextractor
- The task kill agent
- The initialization and termination of the BBI-SS PAS communication
- Starting and stopping BMC AMI Ops Automation 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.
Command | Description |
|---|---|
TERM, TRM | Terminates the BMC AMI Ops agents, records the BMC AMI Ops agent processing environment, and removes the BMC AMI Ops agents from the target CICS. Agents such as the extractor, task kill, and BMC AMI Ops Automation for CICS are terminated and their operating status is recorded in the BMCMVCTQ temporary storage queue. All BMC AMI Ops resources are discarded and released and communications with the BBI-SS PAS is terminated. |
INIT, INI | Initializes the BMC AMI Ops 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 BMC AMI Ops Automation 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 BMC AMI Ops agents are started. |
QOFF, QOF | Shuts down the BMC AMI OpsM for CICS extractor agent. The exit routines are disabled and the detail files are closed. No resources are discarded or released. |
QON | Starts the BMC AMI OpsM for CICS extractor agent. |
RES | Restarts BMC AMI OpsM for CICS within the target CICS by performing a FST2 TERM followed by a FST2 INIT process. The TERM process terminates the BMC AMI Ops agents, records the BMC AMI Ops agent processing environment, and removes the BMC AMI Ops agents from the target CICS system. Agents such as the extractor, task kill, and BMC AMI Ops Automation for CICS are terminated and their operating status is recorded in the BMCMVCTQ temporary storage queue. All BMC AMI Ops resources are discarded and released, and communications with the BBI-SS PAS is terminated. The INIT process initializes the BMC AMI Ops agents by:
This process restores the environment that the TERM process recorded. If BMC AMI OpsM 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 BMC AMI OpsM for CICS task kill agent. |
KON | Starts the BMC AMI OpsM for CICS task kill agent. |
KRLD, KRL | Reloads the BMC AMI OpsM 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 BMC AMI Ops Automation for CICS agent. |
SYSM ON, AON | Starts the BMC AMI Ops Automation for CICS agent. |
LOFF, LOF | Terminates the BMC AMI OpsM for CICS long running task, BCRT. This command should not be used unless directed by BMC support. |
LON | Starts the BMC AMI OpsM for CICS long running task, BCRT. This command should not be used unless directed by BMC support. |
PGY, PGON | Starts the BMC AMI OpsM for CICS Program CPU Timing facility. |
PGN, PGOF | Stops the BMC AMI OpsM 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 |