HPlogo APPC Subsystem on MPE XL Node Manager's Guide: HP 3000 MPE/iX Computer Systems > Chapter 3 Control Operator Intrinsics

APPCStop

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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 terminated immediately. 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 be brought down until the conversation using it has been deallocated. When the conversation has completed, the session will be terminated. TPs will not be terminated.

Default: 3 (Quiesce)

Description

The APPCStop intrinsic is used to shut down the APPC subsystem by deactivating all active APPC sessions. If possible, you should specify a StopType of 3 (Quiesce). If you cannot wait for all conversations to end before shutting down the subsystem, specify a StopType of 2 (Protocol), to ensure that resources are returned to the system before shutdown. If a protocol shutdown does not work, specify a StopType of 1 (Kill).

NOTE: APPCStop does not terminate any active transaction programs. Users must terminate their TP processes when the subsystem goes down.

The APPCStop intrinsic performs the same function as the control operator command APPCCONTROL STOP.

Return Codes

    0 = Successful completion
-1002 = Parameter error
-1004 = Too many parameters specified
-1005 = Syntax error
-1006 = Redundant parameter
-1007 = Missing parameter after equal sign
-1008 = Missing or invalid delimiter
-1009 = Parameter out of bounds
-1010 = User missing NM capability
-1017 = Invalid StopType parm value
-1064 = Resource Manager error - subsystem shutdown failed
-1065 = Control Operator internal error
-1072 = APPC subsystem not active
Feedback to webmaster