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

APPCCONTROL TRACEON
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Enables internal state tracing for the APPC subsystem.

Syntax

APPCCONTROL TRACEON
            [;TFILENAME=trace file name]
            [;TFILESIZE=record count]

Parameters

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 TRACEON 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.

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.

Description

The APPCCONTROL TRACEON command enables internal state tracing. It can be issued during run time, after the APPC subsystem has been activated. Internal state tracing records significant state changes, events and data to a disk file. The default name of the disk file is NMTCxxxx.PUB.SYS, where xxxx is a number from 0000 through 9999. This number is incremented whenever a new trace file is opened.

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.

When the APPC subsystem is activated, internal tracing is disabled by default. It can be enabled at startup by specifying TRACEON = YES in the APPCCONTROL START command. See the description of APPCCONTROL START, earlier in this chapter.

If you start up the APPC subsystem programmatically, you can enable internal tracing by setting the TraceOn parameter of the APPCStart intrinsic to 1. See Chapter 3 “Control Operator Intrinsics” for more information on control operator intrinsics.



APPCCONTROL TRACEOFF
  		 


APPCCONTROL VERSION  
Feedback to webmaster