APPC Subsystem on MPE/XL Node Manager's Guide (30294-90007)

Chapter 3 69
Control Operator Intrinsics
APPCStop
APPCStop
Deactivates the APPC subsystem and all active APPC sessions.
Syntax
I32 I16V
APPCStop ( ReturnCode [, StopType ])
Parameters
ReturnCode Required. 32-bit signed integer; output. Indicates the
result of the intrinsic execution. The
ReturnCode
consists of two 16-bit fields: an information field,
containing the number of an APPC warning or error
message, and a subsystem field, containing the number
of the subsystem that generated the message. If both
fields contain zeros, the intrinsic executed successfully,
and there are no messages. For more information, see
“Return Codes” at the beginning of this chapter.
Appendix A , “Messages,” contains a list of all return
codes returned by the APPC subsystem, their causes,
and the actions you should take to resolve any
problems.
StopType Optional. 16-bit signed integer; input. Specifies the
type of subsystem shutdown (Kill, Protocol, or Quiesce).
Allowable values are as follows:
1 Kill. All active sessions will be
terminatedimmediately.Conversations
using the sessions will not be allowed to
complete. TPs will not be terminated,
so users must terminate their TP
processes when the subsystem goes
down.
2 Protocol. All active sessions will be
terminated, pending notification of any
transaction programs currently in
conversation. Once the active TPs have
been notified, their sessions will be
terminated. TPs will not be terminated.
3 Quiesce. Orderly shutdown of the
APPC subsystem, allowing all current
conversations to be completed but
preventing any new conversations from
being allocated. No APPC session will