Command Descriptions

This section provide explanation and usage of each command. You can use different commands to perform different functions.

–codepage

This command displays the code pages being used by the CEET. Example:

S7M5401I 15:14:38 HostCodePage:IBM-1047 NetworkCodePage:ISO8859-1

–connping –url urlName

This command pings a Connection Thread. The urlName is the URL connection ID you want to ping. The system looks for a Connection Thread with the specified URL connection id; if found, the ping command is sent to the Connection Thread.

–connstart –url urlName [–user userName] [–pwd password]

This command starts a new Connection Thread. The urlName is the URL connection ID the new Connection Thread is to be known by. The system looks for a Connection Thread with the specified URL connection id. If found, the command is ignored; otherwise a new Connection Thread is started using the specified URL connection id.

–connstop [–url urlName] | [–id id]

This command stops a Connection Thread and all associated Work Threads. The urlName is the URL connection ID to stop, the id is thread ID to stop. The system looks for a Connection Thread with the specified URL connection id, or a Work Thread with the specified id; if found, the system terminates the connection and workers as gracefully as possible.

–conntrace –[off | on]

This command enables tracing to be set on or off for all connections in the CEET. All Connection Access and Threads are affected by the setting of this command. When no option value is specified, the default value of off is used.

–display [–skip n]

This command displays the status of the CEET, listing all active threads. You can use the –skip n option to page forward in the list, or the F8 key to page forward and the F7 key to page backwards.

A sample display is shown as follows: 

S7M5400I 09:20:31 Total Thds:5 Mast Thds:1 Conn Thds:2 Work Thds:2
ID CB ADDRESS TYPE TASKID STATE URL OR LAST COMMAND
AM 000C2000 MAST CMD S7M_SUBTASK_START
0002 AC 000C2640 WORK 0000085 tibemsDestination_Destroy
0002 AS 1CB58068 WORK CMD C002 16543
C002 AC 000C2460 CONN S7M_WORK_START
C002 AS 1CB713A0 CONN CMD tcp://url-id1:7222
0001 AC 000C2280 WORK 0000074 tibemsMsgConsumer_Receive
0001 AS 1CB57E20 WORK WAIT C001 8123
C001 AC 000C20A0 CONN S7M_WORK_START
C001 AS 1CB71158 CONN CMD tcp://url-id2:7222
The first line of the display provides the following information:
  • Time of transaction execution
  • Total Thds: total number of threads running
  • Conn Thds: number of Connection Threads running
  • Work Thds: number of Work Threads running

The second line of the display contains column headings (in uppercase letters). Subsequent lines represent information about active threads. The Master Thread displays on a single line (identified by MAST in the TYPE column). Each Work or Connection Thread is represented by a pair of lines, one after the other in the listing (identified by WORK or CONN in the TYPE column).

The columns display the following thread information (from left to right):
Column Description
ID The identification of the Connection or Work Thread.

Connection Threads begin with the letter C.

CB

The type of control block.

AC – the ACMEM (CICS Application side); displays on the upper line for each thread.

AS – the ASMEM (CEET side); displays on the lower line for each thread.

AM – anchor control block in CICS Application Environment.

ADDRESS The control block address.
TYPE The type of thread.

MAST – Master Thread

CONN –Connection Thread

WORK – Work Thread.

TASKID The CICS transaction ID currently allocated to this Work Thread. 0000000 indicated an unallocated Work Thread.

Displays only for Work Threads, on the upper line.

STATE

The state of the thread.

CMD – indicates the thread will take commands from CICS.

WAIT – indicates the thread is in the TIBCO EMS library and will not take commands from CICS.

URL OR LAST

COMMAND

ID information and last command sent to the thread.

Connection Threads – the upper line displays the last command sent to the thread; the lower line displays the URL connection ID of the thread.

Work Threads – the upper line displays the last TIBCO EMS API call sent to the thread. Since the length of name of the call might exceed the width of this column, the call name begins in the STATE column. The lower line displays the ID (from the ID column) of the Connection Thread to which this Work Thread is associated, followed by a count of the TIBCO EMS API calls for the thread.

–dumpac

This command produces a dump like the one printout of all ACMEM control blocks in the CEET. ACMEM control blocks are on the CICS side of the interface. The output is sent to DDNAME CEEMSG.

–dumpall

This command produces a dump like the one printout of all the control blocks in the CEET. The output is sent to DDNAME CEEMSG.

–dumpas

This command produces a dump like the one printout of all ASMEM control blocks in the CEET. ASMEM control blocks are on the Server side of the interface. The output is sent to DDNAME CEEMSG.

–masterstart [–hostpage hostcodepage] [–netpage networkcodepage]

This command starts the Master Thread. If the Master Thread is already started, the command is ignored. Only one Master Thread can exist. The optional hostcodepage and networkcodepage parameters specify the code pages to be used when starting the CEET. These override the defaults specified in S7MACURT.

–masterstop [–force]

This command stops all threads, in the following sequence:
  1. Sends a stop command to all CEET Work Threads so they can terminate normally.
  2. Sends a stop command to all CEET Connection Threads so they can terminate normally.
  3. Sends a stop command to the Master Thread. If the Master Thread does not terminate, and you specified the –force option, the Master Thread is terminated via an Operation System Stop.

–mastertrace –[off | on]

CEET. All Master events, Connection Access, and Work Threads are affected by the setting of this command. When no option value is specified, the default value of off is used.

–posix [–tcbs]

This command displays TCBs and POSIX runtime options in the CICS region. Information is sent to screen and DDNAME CEEOUT.

–print

This command prints the status of the CEET, listing all active threads. The output is sent to DDNAME CEEOUT.

–version

This command displays the version and build timestamp of the EMS Client currently running.

–workrelease [–addr address] | [–taskid taskid]

This command releases the Work Thread based on the Work Thread address or CICS taskid as displayed using the DISPLAY option. The Work Thread is freed up and can be used by another new CICS transaction. If a user’s CICS transaction is purged, the Work Thread is not released. With this command, you can free up the Work Thread if the Work Thread is in CMD mode. If the Work Thread is in WAIT mode, the Work Thread will have to be stopped using S7MA -workstop.

–workstart –url urlName [–user userName] [–pwd password]

This command starts a new Work Thread. The urlName is the URL connection you want the Work Thread to be started on. The system looks for an existing Connection Thread with this urlName. If found, that Connection Thread is used to start the new Work Thread; otherwise, a new Connection Thread is started for this urlName and then the Work Thread is started.

–workstop [–addr address] | [–id id]

This command stops the Work Thread based on the Work Thread address as displayed using the DISPLAY option. The Work Thread is terminated. If a user CICS transaction is purged the Work Thread is not released. With this command, you can stop and free up the Work Thread—see also S7MA –workrelease—When the Work Thread is stopped the maximum running threads is reduced by one. If a CICS transaction is currently active and allocated to the Work Thread, that CICS transaction receives a status return code.