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.