APPCCONTROL

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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.

Back to Main Index