Install the Utility

The TSO Command Interface Utility can be implemented in two ways - as a command processor, or as a called program.

Invoking the MIMTSO program from a TSO session as a command processor allows you to directly append the desired command to the MIMTSO command. The MIMTSO program will immediately be executed, the appended command will then be executed, and the result will be return to the TSO session.
Invoking the MIMTSO CLIST from a TSO session as a called program requires you to invoke the MIMTSO CLIST first. Once the MIMTSO CLIST executes, you will be presented with a READY prompt indicating that you can then present commands to CA MIM for execution.

Follow the installation instructions for the specific method in which you would like to invoke the TSO Command Interface Utility.

To install the interface as a command processor

Add the MIM APF-Authorized loadlib that contains the MIMTSO program so that it will be automatically found through LINKLST search processes.

Authorize the TSO service facility to call the MIMTSO program as a command processor by adding the MIMTSO program name to the AUTHCMD and AUTHPGM statements in SYS1.PARMLIB(IKJTSOxx).
If you are running CA MIC and would like to issue commands to any system in the MICplex, then you will need to add a CA MIC LINK command for each TSO user ID desiring this ability. Here is a sample:
```
LINK TSOUSER=OPER1  SYSID=ALL  AUTH=MASTER
```
This sample LINK command allows the TSO userid “OPER1” to issue any command to any system in the MICplex.

Example: Local Command

MIMTSO @DISPLAY SYSTEMS

Where @ is the CA MIM command character.

Example: Global Command

MIMTSO @SYSB @DISPLAY SYSTEMS

Where the SYSB is the CA MIM name of an external system.

To install the interface as a called program

Customize the LIBRARY parameter in the sample MIMTSO CLIST found in the data set CAI.CBTDCLS0 so that it points to your CA MIM APF-authorized loadlib.
Copy the updated MIMTSO CLIST to a CLIST library that is automatically searched for TSO users. The search order for CLIST libraries is defined using the //SYSPROC DD statement found in the logon procedure of each TSO user.
Authorize the TSO service facility to call the MIMTSO program as a command processor by adding the MIMTSO program name to the AUTHCMD and AUTHPGM statements in SYS1.PARMLIB(IKJTSOxx).
If you are running CA MIC and would like to issue commands to any system in the MICplex, then you will need to add a CA MIC LINK command for each TSO user ID desiring this ability. Here is a sample:
```
LINK TSOUSER=OPER1  SYSID=ALL  AUTH=MASTER
```
This sample LINK command will allow the TSO userid OPER1 to issue any command to any system in the MICplex.
To invoke the CLIST, you would enter:
```
%MIMTSO
```
%

Specifies the TSO CLIST command character

MIMTSO

Specifies the CLIST name

Following is an example of MIMTSO when executed on a system where CA MII and CA MIA are running in separate address spaces:
```
	MIM/TSO command interface (11.6      CTD1150)
      THE FOLLOWING MIM TASKS ARE ACTIVE:
           MIAPROC   USES COMMAND PREFIX(:       )
           MIIPROC   USES COMMAND PREFIX(&       )
      MIMTSO     
```