 |
» |
|
|
|
Activates the APPC subsystem and all APPC sessions configured
for automatic activation. Syntax | |
I32 I16V CA I16V
APPCStart (ReturnCode [,TraceOn] [,TFileName] [,TFileSize]
I16V I16V
[,PerformanceOn] [,Erropt]) |
Parameters | |
- ReturnCode
Required. 32-bit signed integer;
output. Indicates the result of the intrinsic execution. The
ReturnCode consists of two 16-bit fields: an information field, containing
the number of an APPC warning or error message, and a subsystem
field, containing the number of the subsystem that generated the
message. If both fields contain zeros, the intrinsic executed successfully, and
there are no messages. For more information, see "Return
Codes" at the beginning of this chapter. Appendix A “Messages” contains a list of all return codes returned by the
APPC subsystem, their causes, and the actions you should take to
resolve any problems. - TraceOn
Optional. 16-bit signed integer;
input. Specifies whether or not internal state tracing will be performed. Internal
tracing records significant state changes, events and data to a
disk file. Possible values are as follows: - 1
Internal state tracing is enabled. Tracing will
remain on until the APPCCONTROL TRACEOFF command is issued or until the APPC subsystem is stopped. - 0
Internal state tracing is disabled. Tracing will
remain off until the APPCCONTROL TRACEON command is issued.
Default: 0 (tracing disabled) - TFileName
Optional. 8-character ASCII
array, left justified and padded with blanks. This parameter specifies
the name of the trace file, which will be created in the logon group and
account of the user who ran the calling program. A valid name is
up to 8 alphanumeric characters long and begins with a letter. The default trace file name is NMTCxxxx.PUB.SYS, where xxxx is a number from 0000 through 9999. This number is
incremented whenever a new trace file is created. - TFileSize
Optional. 16-bit signed integer;
input. A decimal number, from 0 through 32767, specifying the size
of the trace file, in 128-word records. When TFileSize has been reached, trace records are overwritten, starting
at the beginning of the file. Default: 4096 - PerformanceOn
Optional. 16-bit signed integer;
input. This parameter causes the APPC subsystem to gather performance statistics
during run time. These statistics are displayed when you issue the
APPCCONTROL PERFORMANCE command. Once the APPC subsystem is active, statistics gathering
can be enabled and disabled with the APPCCONTROL PERFORMANCEON and APPCCONTROL PERFORMANCEOFF commands, described in Chapter 2 “Interactive Control Operator Commands” Possible values for the PerformanceOn parameter are as follows: - 1
Performance statistics gathering is enabled. - 0
Performance statistics gathering is disabled.
Default: 0 (Performance statistics
gathering disabled) - Erropt
Optional. 16-bit signed integer;
input. This parameter specifies the action taken when an irrecoverable internal
error occurs. Possible values are as follows: - 1
System shutdown. The system is brought down when
an irrecoverable error occurs. - 2
Subsystem shutdown. Only the APPC subsystem is brought
down when an irrecoverable error occurs.
Default: 2 (Subsystem shutdown)
|
