OpenTP1 Version 7 Tester and UAP Trace User's Guide
9.2.2 mcftules (start of a logical terminal test)
(1) Syntax
mcftules [-e "[backout] [trace] [swmsg] [errevt]
[execap] [holdlimit]"]
-l logical-terminal-name
|
(2) Function
Sets the specified logical terminal in test mode and starts testing.
Enter the mcftules command only after shutdown of connection and completion of all message send and receive.
(3) Options
- -e
Specify the test mode options.
Enclose two or more flag arguments with quotation marks (") and delimit each flag argument by inserting a space.
- Flag arguments:
- backout
- Restores the resources used in a transaction to pre-test status at completion of the transaction.
- When this flag argument is omitted, updated resources are used in their current status and are not restored to pre-test status.
- trace
- Collects MHP trace information during processing of a transaction in test mode.
- When this flag argument is omitted, no MHP trace information is collected.
- swmsg
- Invalidates messages sent by the MHP during processing of a transaction in test mode.
- Messages sent by the following functions issued by the test MHP are invalidated:
- dc_mcf_send function (message send)
- dc_mcf_sendsync function (synchronous message send)
- dc_mcf_resend function (message resend)
- When this flag argument is omitted, messages sent by the above functions are effective.
- errevt
- Suppresses error event activation if an error event occurs during testing. The following error events are suppressed:
- ERREVT1 (MCF event that reports detection of an invalid application name)
- ERREVT2 (MCF event that reports discarding of a message at abnormal termination before issue of the dc_mcf_receive function)
- ERREVT2 (MCF event that reports discarding of a message generated at automatic shutdown)
- ERREVT3 (MCF event that reports UAP abnormal termination at abnormal termination during MHP execution)
- When this flag argument is omitted, activation of the above error events is not suppressed.
- execap
- Invalidates branch application startup messages issued by a transaction in test mode.
- When this flag argument is omitted, branch application startup messages are effective.
- holdlimit
- Suppresses MHP automatic shutdown should a transaction in test mode terminate abnormally.
- When this flag argument is omitted, MHP automatic shutdown is not suppressed.
- -l logical-terminal-name ~<identifier of 1-8 characters>
Specify the name of the logical terminal at which to start testing.
You cannot use an asterisk (*) or a prefix character string plus an asterisk (prefix-character-string*) to specify a group of logical terminal names.
Only one logical terminal name can be specified.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.