Master exit ITPMSTRX
The WSim master exit was added to provide user sites with the potential for additional control over the WSim simulations.
The WSim master exit is always called regardless of whether one is coded in the WSim network definition or not. You can also end the WSim simulation at any time by using WSim master exit. The master exit is given control when the WSim simulator is first brought up and when it is ended. The WSim master exit is also called at each of the other exit interfaces before calling the exit, which might have been coded in a WSim network definition.
A WSim master exit stub program is provided with the WSim product named ITPMSTRX. This module should be replaced by an installation unique WSim master exit, if one is wanted. The current stub module is link-edited REUS, RMODE 24, AMODE 31.
The standard exits parameter lists are maintained by increasing the number of flag bits from 16 to 32. The first sixteen bits are for the standard exit calls (exits coded in the WSim network definition) and the last sixteen are for the master exit calls.
Use WSim User Exits manual (SC31-8950-00) with this information to understand the parameters passed to the WSim master exit.
| Bits | 0-15 | WSim Standard Exit Call Flags |
| Bit | 0 | ON = Input, OFF = Output |
| Bit | 1 | Set ON By Exit = Stop Processing Data – SNA Only |
| Bit | 2 | Set ON By Exit = Cancel Any Outstanding Delay |
| Bit | 3 | ON = Information Exit Call |
| Bit | 4 | ON = Message Generation Exit Call |
| Bit | 5 | ON = Network Exit Call |
| Bit | 6 | ON = Normal Network Exit Call, Bit 0 Used |
| Bit | 7 | ON = Network Start-Up Exit Call |
| Bit | 8 | ON = Network Cancel Exit Call |
| Bit | 9 | ON = Network Reset Exit Call |
| Bit | 10 | ON = Operator Command Exit Call |
| Bit | 11 | ON = Operator Command Completion Exit Call |
| Bit | 12 | Not Used |
| Bit | 13 | Not Used |
| Bit | 14 | Not Used |
| Bit | 15 | Not Used |
| Bits | 16-31 | WSim Standard Exit Call Flags |
| Bit | 16 | ON = WSim Master Exit Being Called |
| Bit | 17 | ON = Start WSim Simulator Master Exit Call |
| Bit | 18 | ON = End WSim Simulator Master Exit Call |
| Bit | 19 | ON = Other WSim Simulator Master Exit Call, Bits 0-15 Define Exit Call |
| Bit | 20 | Set ON By WSim Master Exit = End WSim Simulation Now |
| Bit | 21 | Set ON By WSim Master Exit = Do Not Call WSim Master Exit Again |
| Bit | 22-31 | Not Used |
- Bit 20 can be set ON during any call to the WSim master exit and the WSim simulator will terminate with a return code of 32.
- Bit 21 can be set ON during any call to the WSim master exit and the WSim simulator will not call the WSim master exit again. The WSim master exit stub sets bit 21 ON when called for the start WSim simulator master exit call to avoid being called again.