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

APPCCONTROL STOP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Deactivates all APPC sessions, writes out performance data to the log file (if performance statistics gathering is enabled and APPC subsystem logging is configured), and brings down the APPC subsystem.

Syntax

APPCCONTROL STOP [;TYPE=StopType]

Parameters

StopType

Indicates the manner in which you wish the APPC subsystem to be shut down. Valid choices are as follows:

K[ILL]

Immediate shutdown of the APPC subsystem. Any conversations will be terminated immediately. All APPC sessions will also be terminated immediately. User TPs will not be terminated.

P[ROTOCOL]

Immediate shutdown of the APPC subsystem, pending notification of any transaction program currently in conversation. Once a TP has been notified, its session is terminated.

Q[UIESCE]

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.

Default: QUIESCE

Description

Try to use APPCCONTROL STOP with the TYPE=Q parameter; this will ensure orderly shutdown of the APPC subsystem. If it is not possible to wait for current conversations to complete, escalate the shutdown type to TYPE=P (protocol shutdown). A TYPE=P shutdown ensures that resources used by the APPC subsystem for conversations are successfully returned to the system before shutdown. If TYPE=P does not work, use TYPE=K.

This command shuts down APPC sessions only; any LU-LU sessions being used with other SNA Services remain active.

NOTE: This command will not terminate any transaction programs. Users must terminate any transaction programs that are still active after their sessions have been terminated.

You can shut down the APPC subsystem programmatically by calling the APPCStop intrinsic, described in Chapter 3 “Control Operator Intrinsics”

Feedback to webmaster