HPlogo APPC Subsystem on MPE XL Node Manager's Guide: HP 3000 MPE/iX Computer Systems > Chapter 2 Interactive Control Operator Commands

APPCCONTROL START

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Activates the APPC subsystem. Any APPC sessions configured for automatic activation will be established when the subsystem is activated

Syntax

APPCCONTROL START
           [;TRACEON=tracing option]
           [;TFILENAME=trace file name]
           [;TFILESIZE=record count]
           [;PERFON=performance option]
           [;ERROPT=error option]

Parameters

tracing option

Enables or disables APPC subsystem internal state tracing. Internal tracing records significant state changes, events, and data to a disk file.

YES

APPC subsystem internal state tracing is enabled.

NO

APPC subsystem internal state tracing is disabled.

If tracing is enabled at subsystem startup, it can be turned off during run time by issuing the APPCCONTROL TRACEOFF command. If tracing is disabled at subsystem startup, it can be turned on during run time by issuing the APPCCONTROL TRACEON command.

Default: NO

trace file name

An 8-character name consisting of alphanumeric characters and beginning with a letter. A trace file with this name will be created in the group and account from which the APPCCONTROL START command was issued.

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.

A new trace file is created whenever tracing is enabled, at subsystem startup with the TRACEON parameter, or during run time with the APPCCONTROL TRACEON command. To start a new trace file without bringing down the APPC subsystem, turn tracing off and back on again with the APPCCONTROL TRACEOFF and APPCCONTROL TRACEON commands.

record count

A decimal number, from 0 through 32767, specifying the trace file size, in 128-word records. Once the record count has been reached, trace records are overwritten starting at the beginning of the file.

Default: 4096.

performance option

Enables or disables the gathering of APPC subsystem performance statistics. These statistics are displayed when you issue the APPCCONTROL PERFORMANCE command.

YES

APPC subsystem performance statistics are gathered during run time.

NO

APPC subsystem performance statistics are not gathered.

Once the APPC subsystem is active, statistics gathering can be enabled and disabled during run time with the APPCCONTROL PERFORMANCEON and APPCCONTROL PERFORMANCEOFF commands, described earlier in this chapter.

Default: NO

error option

This parameter specifies the action taken when an irrecoverable subsystem internal error occurs. Possible values are as follows:

SYS

If ERROPT=SYS is specified, the system will be brought down when an irrecoverable internal error within the APPC subsystem occurs, and a full system dump will be taken.

SUB

If ERROPT=SUB is specified, only the APPC subsystem will be brought down when an irrecoverable internal error occurs within the APPC subsystem.

Hewlett-Packard recommends that you specify ERROPT=SUB so that the rest of the system can remain active when there is a problem with the APPC subsystem. However, if an APPC subsystem problem cannot be found, your HP representative may ask you to specify ERROPT=SYS so that a system dump is taken when the internal error occurs.

Default: ERROPT=SUB

Description

The APPCCONTROL START command activates the APPC subsystem and all APPC sessions configured for automatic activation. (See Chapter 4 “APPC Subsystem Configuration” of this manual for more information on configuring the APPC subsystem.)

You can activate the APPC subsystem programmatically by calling the APPCStart intrinsic, described in Chapter 3 “Control Operator Intrinsics”

NOTE: The APPCCONTROL START command will not cause the activation of the SNA link product. The SNA link product must be explicitly activated using the SNACONTROL START command.
Feedback to webmaster