Starting the Terminal Interface Manager

The Terminal Interface Manager is a VTAM® application that must be started (following the start of VTAM itself) before users can access it. Follow these steps to start it:

Copy the EQAYSESM member of the data set hlq.SEQASAMP to the SYS1.PROCLIB data set, making any changes required by your installation.
Make sure that the Terminal Interface Manager load modules, EQAYSESM and EQAYTRMM, reside in an APF authorized library (these module can be found in the hlq.SEQAAUTH data set). This is required to allow access to functions to validate users by login credentials.
Start the Terminal Interface Manager using the START command from the console. The START command can be added to the COMMNDxx member of SYS1.PARMLIB to start the Terminal Interface Manager when the system is IPLed.
The user ID associated with the STARTED class entry in RACF® for the Terminal Interface Manager started task must have an OMVS segment defined. This enables the started task to use the POSIX thread functions.

The Terminal Interface Manager load module accepts six parameters, which you can provide by using the OPTS substitution variable on the START command or in the EQAYSESM PROC definition. You can code the parameters in any sequence and all of them are optional. The following list describes the parameters:

-a acbname: Specifies an alternate VTAM ACB name for the Terminal Interface Manager to open. For more information about this parameter, see Example: Defining the VTAM EQAMVnnn and Terminal Interface Manager APPL definition statements when z/OS Debugger runs on four LPARs.
-m: Instructs the Terminal Interface Manager not to fold passwords to upper case. If your security product is set up to use mixed-case passwords, and Terminal Interface Manager does not accept them, code this parameter.
-p pattern-string: Specifies a naming pattern for the TEST runtime options data set. You can use this parameter to override the default naming pattern. pattern-string must contain the string &USERID for substitution purposes. Otherwise, an error will be recognized and the default naming pattern &USERID.DBGTOOL.EQAUOPTS will be used.
-s: Instructs the Terminal Interface Manager to provide an entry field on each Terminal Interface Manager panel, in which the user can enter a session manager escape sequence.
+T: Display detailed trace messages for the Terminal Interface Manager. Do not use this parameter unless instructed by IBM® support personnel.
-r: Start Terminal Interface Manager in repository mode. This enables users to register to debug IMS transactions or DB/2 stored procedures that are started by a generic user ID.
See DLAYDBGXRF for additional customization required when using this option.

The following example starts the Terminal Interface Manager for alternate ACB EQASESS2 and instructs it to provide an extra entry field for use with a session manager:

START EQAYSESM,OPTS='-a EQASESS2 -s'

Using the MODIFY operator command to display a list of Terminal Interface Manager users

Console operators can list the users who are currently logged on to the Terminal Interface Manager by using the z/OS® MVS system MODIFY command. The list of users contains the user ID, the terminal LU that each user requests, and the job information if the user is currently in a z/OS Debugger session.

The syntax of the MODIFY command is:

The following list describes the parameters of the MODIFY APPL=LIST command:

tim-stc-name: Is the name of the started task or job that is running the Terminal Interface Manager.
ALL: Lists all users who are logged on to the Terminal Interface Manager.
SESS: Only lists users who are logged on to the Terminal Interface Manager and are currently in a z/OS Debugger session.
IMS: Only lists users who are logged on to the Terminal Interface Manager and are currently in a z/OS Debugger session for an IMS message processing program.

Example

MODIFY EQAYSESM,APPL=LIST ALL

Example output

EQA9896I z/OS Debugger TIM USERS                        
  USER ID    FLAGS    TERMINAL   JOBNAME
  --------   ------   --------   --------
  USRT002    I        TRMLU006   MPRCI10X
  USRT001    B        T1302      USRT001A
  USRT003    L        TRMLU004   **NONE**
-----------------------------------------
L=LOGGED ON, NOT IN SESSION
I=IN SESSION; IMS JOB
B=IN SESSION; BATCH OR DB/2 JOB