APPCCONTROL
APPCCONTROL
Controls the operation of the Advanced Program-to-Program
Communication (APPC) subsystem. It is used to start and stop the
subsystem, control active sessions, and access
subsystem status information.
SYNTAX
APPCCONTROL START
[;TRACEON=trace option] default = NO
[;TFILENAME=trace filename] default = NMTCxxxx.PUB.SYS
[;TFILESIZE=record count] default = 4096
[;PERFON=perf option] default = NO
[;ERROPT=error option] default = [SUB]sysfail
APPCCONTROL STOP
[;TYPE=stoptype] default = [Q]uiesce
APPCCONTROL SESSIONS
;STYPE=session type name
;LIMIT=new session limit
APPCCONTROL STOPSESSION
;SID=session id
APPCCONTROL STATUS
[;STYPE=session type name] default = all session types
APPCCONTROL PERFORMANCE
[;STYPE=session type name] default = all session types
[;SID=session id] default = all session ids
APPCCONTROL TRACEON
[;TFILENAME=trace file name] default = NMTCxxxx.PUB.SYS
[;TFILESIZE=record count] default = 4096
APPCCONTROL TRACEOFF
APPCCONTROL PERFORMANCEON
APPCCONTROL PERFORMANCEOFF
APPCCONTROL VERSION
APPCCONTROL DUMP
PARAMETERS
APPCCONTROL START
[;TRACEON=trace option] default = NO
[;TFILENAME=trace file name] default = NMTCxxxx.PUB.SYS
[;TFILESIZE=record count] default = 4096
[;PERFON=perf option] default = NO
[;ERROPT=error option] default = [SUB]sysfail
trace option This parameter specifies whether APPC internal
state tracing should be enabled when the system
is started. The following choices are
available:
YES = APPC internal state tracing should be
enabled when the system is started.
NO = APPC internal state tracing should not
be enabled when the system is started.
trace filename An 8-character file name which is to contain
the trace data. The trace file will be created
in the group and account from which the
APPCCONTROL START command was issued.
record count A decimal number specifying the trace file
size in 128-word records.
perf option This parameter specifies whether APPC
performance gathering should be enabled when
the subsystem is started. The following
choices are available:
YES = APPC performance gathering should be
enabled when the subsystem is started.
NO = APPC performance gathering should not be
enabled when the subsystem is started.
error option This parameter specifies the action to be taken
when an irrecoverable internal error occurs.
The following choices are available:
SYS = A system failure will be produced.
SUB = The APPC subsystem will be brought down.
APPCCONTROL STOP
[;TYPE=stoptype] default = [Q]uiesce
stoptype This parameter specifies how to shut down the
APPC subsystem. The following choices are
available:
[K]ill = Immediate shutdown of APPC subsystem.
Conversations and LU-LU sessions will
be deactivated immediately.
[P]rotocol = Immediate shutdown of APPC subsystem
but any TP currently in
conversation will be notified before
its session is deactivated.
[Q]uiesce = Orderly shutdown of APPC subsystem,
allowing all current conversations to
be completed, but preventing any new
conversations from being allocated.
No session will be brought down
until the conversation using it has
been deallocated.
APPCCONTROL SESSIONS
;STYPE=session type name
;LIMIT=new session limit
session type name One of the session type names configured in
the APPC Configuration file.
new session limit The new session limit for the session type.
The new session limit will not be updated in
the APPC configuration file.
APPCCONTROL STOPSESSION
;SID=session id
session id A decimal number specifying the session
which is to be deactivated.
APPCCONTROL STATUS
[;STYPE=session type name] default = all session types
session type name One of the session type names configured
in the APPC Configuration file.
APPCCONTROL PERFORMANCE
[;STYPE=session type name] default = all active
session types
[;SID=session id] default = all session ids
session type name One of the session type names configured
in the APPC Configuration file.
session id A decimal number specifying the session
for which performance data is to be
displayed.
APPCCONTROL
TRACEON
[;TFILENAME=trace file name] default = NMCTxxxx.
PUB.SYS
[;TFILESIZE=record count] default = 4096
trace file name An 8-character file name which is to
contain the trace data. The trace file
will be created in the group and account
from which the APPCCONTROL TRACEON command
was issued.
record count A decimal number specifying the trace
file size in 128-word records.
APPCCONTROL
TRACEOFF
None.
APPCCONTROL
PERFORMANCEON
None.
APPCCONTROL PERFORMANCEOFF
None.
APPCCONTROL VERSION
None.
APPCCONTROL DUMP
None.
OPERATION
START - Activates all configured APPC sessions.
STOP - Deactivates all configured APPC sessions.
SESSIONS - Changes session limit of a session type.
STOPSESSION - Deactivates a session with the specified session id.
STATUS - Displays session type and transaction program
information.
PERFORMANCE - Displays session statistics and performance data.
TRACEON - Enables internal state tracing for the APPC subsystem.
TRACEOFF - Disables internal state tracing for the APPC
subsystem.
PERFORMANCEON - Enables gathering of session statistics and
performance data.
PERFORMANCEOFF - Disables gathering of session statistics and
performance data.
VERSION - Displays version information for the product.
DUMP - Dumps APPC Object to the file APPCDPxx.APPC.SYS.
EXAMPLE(S)
APPCCONTROL START
Starts the APPC subsystem with all the default parameters.
APPCCONTROL START;TFILESIZE=2000;ERROPT=SYS
Starts the APPC subsystem with a trace file that has 2000 trace
records. An APPC subsystem irrecoverable error will cause a system
fail.
APPCCONTROL STOP
Stops the APPC subsystem with the default stoptype of "quiesce".
APPCCONTROL STOP;TYPE=K
Stops the APPC subsystem with the stoptype of "kill."
APPCCONTROL SESSIONS;STYPE=LU62ST1;LIMIT=0
Changes the session limit of session type "LU62ST1" to zero. This
has the effect of shutting down the session type so that TPs cannot
allocate any conversations using "LU62ST1."
APPCCONTROL STOPSESSION;SID=30
Deactivates the session with session id "30".
APPCCONTROL STATUS
Displays session type and transaction program information for
all session types.
APPCCONTROL STATUS;STYPE=LU62ST1
Displays session type and transaction program information for
session type "LU62T1" only.
APPCCONTROL PERFORMANCE;STYPE=LU62ST1
Displays session statistics and performance data for session
type "LU62ST1".
APPCCONTROL PERFORMANCE;SID=30
Displays session statistics and performance data for session
id "30".
APPCCONTROL TRACEON;TFILENAME=KENTRACE
Enables APPC internal state tracing. Data will be traced to
the file KENTRACE.
APPCCONTROL TRACEOFF
Disables APPC internal state tracing.
APPCCONTROL PERFORMANCEON
Enables the gathering of session statistics and performance data.
APPCCONTROL PERFORMANCEOFF
Disables the gathering of session statistics and performance data.
APPCCONTROL DUMP
Dumps APPC object and stack markers to APPC dump file
APPCDPnn.APPC.SYS.