Administrative Commands

TIBCO EMS Client for z/OS (CICS) provides an administrative transaction (S7MA) for controlling and monitoring various functions.

Command Syntax

The command syntax is as follows:

S7MA -command {-option | [-option value] | ...}

S7MA is followed by a hyphenated command, followed by one or more hyphenated command options. Some command options require a value. In addition, some commands have no options.

Case Sensitivity

You can issue commands from the CICS command line or the console (if supported by your CICS installation). Most CICS terminals only support uppercase text; however, you might have to use lowercase text; for example, user names and passwords for a secure TIBCO EMS server are case sensitive. The following parameters are provided to convert input text to lowercase or uppercase, and can be used in combination on the command line:
  • –L or -l (translates to lowercase)
  • –U or -u (translates to uppercase)

For example, you specify the following commands on the command line:

S7MA –connstart –l –url SAMPLEURL -u -user sampleid

The resulting URL can be translated to sampleurl and the user can be translated to SAMPLEID.

Note that these parameters are useful for –url, -user, and –pwd. However, values for these cannot be mixed-case text, since such text is not supported by the S7MA transaction. For example, if a user is mixed-case, (such as MyUserName ), consult your administrator to change it to lowercase or uppercase.