Simulator command summary

IMS Batch Terminal Simulator provides many simulator commands to support testing of various applications. Each command has default keyword values that are defined internally by IMS Batch Terminal Simulator.

Summary of simulator commands

The following table summarizes the simulator commands and shows their coded symbols.

Table 1. Simulator commands: Summary
Simulator command Function
Transaction (./T) Defines a transaction and the application program. Also used to define an alternate logical terminal.
COBOL (./C) Defines the usage of interactive debug of some languages.
Device (./D) Specifies the I/O PCB terminal-simulated device, the end-of-segment and end-of-message characters, whether a user-written output formatting routine or IMS Batch Terminal Simulator formatting is to be used, and the feature byte describing the features coded in the IMS MFS control blocks.
Environment (./E) Defines the environment that the transaction is executed in.
Output (./O) Specifies those items that are to be excluded from the IMS Batch Terminal Simulator output listing and TSO terminal display (for example, screen images, field attribute characters, application program statistics, and IMS Batch Terminal Simulator messages).
Patch (./P) Specifies a modification to be made in main storage to a particular load module.
Reader (./R) Specifies whether the simulator statements are in character or hexadecimal format.
Snap (./S) Specifies an area in main storage to be snapshot-dumped and the number of times for a particular PCB and IMS function code combination. It can also be used to set a given status code after a DL/I call.
SPA (./SPA) Specifies an SPA to be initialized for passing to the application program.
Comment (./*) Specifies the comments to be included in the printed output.
Debug commands Specifies the debugging options to diagnose problems.

Default values and syntax specifications for simulator commands

The following table provides a summary of the commands and states the defaults of the keywords, indicating the length of their operands and whether their values are coded in EBCDIC character format or in hexadecimal notation. The maximum and minimum value for a given operand (where applicable) is also indicated.

Table 2. Simulator commands: Default values and syntax specifications
Simulator command Keyword value Default value Rep Length Magnitude
Min. Max. Min. Max.
./C
(N/A)
./D LTERM IOPCB   1 8 - -
EOS *   1 1 - -
EOM $   1 1 - -
DDOF NONE   4 6 - -
TYPE     7 8 - -
SIZE     7 8 - -
LIMIT 0   1 1 - -
FEAT 7F   2 2 0 9
TRSOSI YES   1 3 - -
LUNAME DFSLU   1 17 - -
TPNAME DFSASYNC   1 64 - -
SYNCLVL C   1 1 - -
CONVTYPE M   1 1 - -
LINE DELIMIT   1 7 - -
./E APPLFE     1 8 - -
ETO NO   1 3 - -
LCI NO   1 3 - -
MAXL (X'003C')   4 4 - -
SPACE NO   1 3 - -
REATTCH NO   1 3 - -
SSID (required)   3 4 - -
KATAKANA NO   1 3 - -
SYSRQ NO   1 3 - -
PA2 (required)   3 4 - -
DT3270 NO   1 3 - -
UGN SYSDA   1 8 - -
CONNECT (N/A)   1 8 - -
ERR (N/A)   1 1 - -
MLINE 60 dec 1 5 1 32767
ECHKP YES   1 3 - -
SCNDTRX CONT   4 6 - -
USERID blank   1 8 - -
USERIND blank   1 1 - -
RCFGPN blank   1 8 - -
IODATE process date   8 8 - -
IOTIME process time   8 8 - -
IOUDATE process date   8 8 - -
IOUTIME process time   15 51 - -
UIDDREG blank   1 8 - -
SPLAPI NO   1 3 - -
NOEDIT NO   1 3 - -
IMSSUF     1 1 - -
FSSEND NO   1 3 - -
ENDROLB NO   1 3 - -
PERMLOAD NO   1 3 - -
IFIUTF NO   1 3 - -
./O APS YES   1 3 - -
SCREEN INOUT   1 5 - -
ATR YES   1 3 - -
DB YES   1 3 - -
EATR NO   1 3 - -
MSG YES   1 3 - -
SPA YES   1 3 - -
TSO YES   1 3 - -
TSOAID NO   1 3 - -
TSODB YES   1 6 - -
TSOMLVL 1   1 1 0 1
TSOMSG YES   1 6 - -
SQL ALL   1 3 - -
TSOSQL YES   1 6 - -
SQLHX NO   1 3 - -
TSOSQLHX NO   1 3 - -
IFI YES   1 3 - -
TSOIFI YES   1 3 - -
MQI ALL   1 3 - -
TSOMQI YES   1 6 - -
TSSLEN 114   1 4 0 9999
SQLOBLN (N/A)   1 4 0 9999
ELAPTIME NO   1 3 - -
REPORT NO   1 3 - -
ICALOLEN 1000   1 4 0 9999
./P MBR (required) hex 1 8 - -
CA 000000 hex 6 6 - -
PA (required)   6 6 - -
PC (X'00') hex 1 137 - -
PX (X'00')   2 137 - -
./R IP CHAR   3 4 - -
./RETURN   (N/A)          
./S MBR (required)   1 8 - -
CA 000000 hex 6 6 - -
SA (required) hex 6 6 - -
BYTES (required) dec 1 5 1 32767
PCB (required)   1 8 - -
FUNC (required)   2 4 - -
TIMES 1 dec 1 5 1 32767
STCD     2 2 - -
./SPA   (N/A)          
./T TC (required)   1 8 - -
MBR (required)   1 8 - -
PSB (PSB=MBR)   1 8 - -
PLAN (PLAN=MBR)   1 8 - -
PLC 1 dec 1 5 0 32767
SPA 0 dec 2 5 15 32767
EM (N/A)   1 8 - -
LANG ASM   3 3 - -
TYPE MSG   3 8 - -
DLITRACE *   1 255 0 9
SQLTRACE *   1 255 0 B
BCHKP NO   1 3 - -
MQITRACE *   1 255 0 B
MSGTYPE TRAN   4 6 - -
QNAME     1 48 - -
QMGRNAME     1 48 - -
REATTCH NO   1 3 - -
Note: For the ./T command, only the options for defining transactions are shown. See ./T command for the options for defining alternate logical terminals.