Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
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.
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
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.
[;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.
None.
None.
None. APPCCONTROL VERSION None.
None.
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.
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.
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".
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.
Disables APPC internal state tracing.
Enables the gathering of session statistics and performance data.
Disables the gathering of session statistics and performance data.
Dumps APPC object and stack markers to APPC dump file APPCDPnn.APPC.SYS. Back to Main Index