TRCINT (Trace Internal)

TRCINT Command syntax diagram

 

Purpose

The Trace Internal (TRCINT) command is the command interface to the Trace Licensed Internal Code service tool and is used for problem analysis. Specific types of traces are started and stopped by using this command.

While previously started internal traces are being performed, additional internal traces can be started through this command. The output created by the trace is placed in a trace table. The records from the trace table can be written to a spooled printer file, or to tape or optical media.

 

Restrictions

1. This command is shipped with public *EXCLUDE authority.
2. To use this command have *SERVICE special authority, or be authorized to the Service Trace function of Operating System/400 through iSeries Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
3. The following user profiles have private authorities to use the command:

   • QSRV

 

Required Parameters

SET

Specifies whether internal tracing is started, stopped, ended, held, or saved. Also, the user can specify whether the trace table size is changed.

*ON: The collection of internal trace records is started for the trace types specified in the TRCTYPE parameter. If the trace table already contains trace records, the new trace records are added to the table. If the table is full, the action specified in the TRCFULL parameter is taken.

If a trace table name other than *SYSDFT is specified for the TRCTBL parameter and the table does not exist, it will be automatically created.

*OFF: Collection of internal trace records requested through previous TRCINT commands stops, and the records are written to the spooled printer file QPCSMPRT.

*END: Internal tracing ends and the trace records are deleted. No spooled output is generated.

If a trace table name other than *SYSDFT is specified for the TRCTBL parameter, it will be automatically deleted.

*HOLD: Internal traces are stopped, and the collected trace records are held in the trace table. Held records can be printed later if another TRCINT command is entered that specifies SET(*OFF), or they can be put on tape or optical media if SET(*SAVE) is specified.

*SAVE: Internal traces are stopped, and the trace records are written to the tape or optical device specified by the OUTDEV parameter. The diskettes on which the records are written must be initialized in the basic exchange format (*DATA or *DATA2).

*SIZE: The size of the trace table is changed. The new size is specified in the SIZE parameter.

 

Optional Parameters

TRCTBL

Specifies the trace table to hold the collected trace data.

*SYSDFT: The system default trace table is used.

trace-table-name: Specify the name of the trace table to be used. If SET(*ON) is specified and the name specified does not match an existing trace table, a new trace table by the specified name will be created.

SIZE

Specifies the size of the trace table. This parameter can be specified only when SET(*SIZE) is specified, or if SET(*ON) is specified and tracing is not currently active for the trace table specified (TRCTBL parameter).

Note:

The storage indicated on this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). This storage is not dynamically allocated as it is needed. This storage will not be available for use by the system except to record trace-related information. Before specifying a large value on this parameter, the amount of free space in the system ASP should be checked. Use the Work with System Status (WRKSYSSTS) command to determine the amount of available free space in the system ASP. System performance degradation may result if the size of the free space in the system ASP is significantly reduced as a result of the value specified.

Element 1: Size>

*NOCHG: The trace table size is not changed. If a new trace table is specified (TRCTBL parameter), a default size of 128 kilobytes will be used.

*MAX: The trace table is set to the maximum size of 258048 megabytes.

*MIN: The trace table is set to the minimum size of 128 kilobytes.

table-size: Specify the size of the trace table in kilobytes or megabytes. Valid values range from 1 through 998000.

Element 2: Unit of Measure

Specify whether the table-size value specified for the Size element should be treated as number of kilobytes or number of megabytes.

*KB: The trace table size is specified in kilobytes. The valid range is 128 through 998000.

*MB: The trace table size is specified in megabytes. The valid range is 1 through 258048.

TRCFULL

Specifies whether the trace records wrap (replace the oldest records with new records) or tracing stops when the trace table is full. This parameter can be specified only when SET(*ON) is specified.

*NOCHG: The trace table full action is not changed. If a new trace table is specified (TRCTBL parameter), the default action is for trace records to wrap when the trace table becomes full.

*WRAP: When the trace table is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.

*STOPTRC: Tracing is stopped when the trace table is full of trace records.

TRCTYPE

Specifies the types of traces to start. The two groups of trace types are:

1. Component data trace codes: Active procedures are traced within the system.
2. General trace codes: The iSeries 400 instruction supervisor linkage, multiprogramming, transaction, or task and thread performance functions are traced.

This parameter can be specified only if SET(*ON) is specified. If a value other than *ON is specified on the SET parameter, TRCTYPE is ignored. Each trace type is identified by a special value or six-digit code. If a numeric value is specified, all 6 digits must be specified. Specify up to 50 trace types from those listed in Table 1.

For a complete list of trace codes and special values, position the cursor on the field for the Trace type prompt (TRCTYPE parameter), and press F4.

Table 1. Trace Code Table

Type of Trace	Trace Code
	Component or General	Special Value
MI instruction supervisor linkage (SVL)	030000	*SVL
Multi-programming level (MPL)	040000	*MPL
Transaction	080000	*TNS
Task/thread performance	090000	*TTPERF
Activation/Call	014400	*ACTCALL
MPTN - APPC over TCP/IP MPTN	014203	*APPCOVRTCP
APPC presentation services	014301	*APPCPS
APPN - all	012506	*APPNALL
APPN control point management	012501	*APPNCPM
APPN control point presentation services	012504	*APPNCPPS
APPN directory services	012502	*APPNDS
APPN location management	012505	*APPNLM
APPN management services transport	012507	*APPNMST
APPN topology and routing services	012503	*APPNTRS
Authority management	010900	*AUTMGT
Auxiliary storage management - detailed	011104	*AUXSTGALL
Auxiliary storage management	011101	*AUXSTGMGT
Byte string space management	012600	*BSSMGT
Common class input/output management (CCIOM)	011900	*CCIOM
Cluster engine	016402	*CLUE
Communications access method	015900	*CMNACCMTH
Commit management	011700	*CMTMGT
Communications trace service function	012300	*CMNTRC
Common functions	011200	*COMMON
Cryptographic services	013600	*CRPSRV
Cluster - all	016400	*CSTALL
Cluster communications	016401	*CSTCMN
Context management	011000	*CTXMGT
Debugger interpreter	014500	*DBGINT
Database management (events for all database files are traced)	010400	*DBMGT
Dependent LU Requestor (DLUR) Communication	015400	*DLUR
Display station pass-through	010804	*DSPPASTHR
Environmental recording, editing and printing (EREP)	012200	*EREP
Error log	012100	*ERRLOG
Event management	010600	*EVTMGT
Exception management	010200	*EXCMGT
Fast Response Cache Accelerator	016600	*FRCA >
Hardware resources	014700	*HDWRSC
Heap management	013400	*HEAPMGT
Independent index management	011400	*IDXMGT
Integrated File System (IFS)	014800	*IFS
Inter-process communications facility (IPCF)	012000	*IPCF
Communications answer management (ISDN)	012700	*ISDN
Journal management	011600	*JRNMGT
Link test service function	012400	*LNKTST
Load/dump (save/restore)	010801	*LODDMP
Machine observation	011300	*MCHOBS
Machine Interface (MI) Transformer	015100	*MITFMALL
MI Transformer - expression evaluation	015101	*MITFMEVAL
MI Transformer - heap operations	015102	*MITFMHEAP
MI Transformer - interpreter instructions	015103	*MITFMINT
MI Transformer - MI instructions	015104	*MITFMMI
MI Transformer - storage management operations	015105	*MITFMSTG
Module management	013100	*MODMGT
Modula-2 run time support	012800	*MOD2
Machine services control point	010802	*MSCP
Main storage management - calls	011102	*MSMCALL
Main storage management - details	011103	*MSMDTL
AS/400 Advanced 36 - all	014600	*M36ALL
AS/400 Advanced 36 - Async communications	014605	*M36ASC
AS/400 Advanced 36 - BSC communications	014604	*M36BSC
AS/400 Advanced 36 - supervisor (CSP)	014611	*M36CSP
AS/400 Advanced 36 - diskette	014607	*M36DKT
AS/400 Advanced 36 - disk	014610	*M36DSK
AS/400 Advanced 36 - internal LAN communications	014612	*M36ILAN
AS/400 Advanced 36 - printer	014609	*M36PRT
AS/400 Advanced 36 - SDLC communications	014601	*M36SDLC
AS/400 Advanced 36 - tape	014606	*M36TAP
AS/400 Advanced 36 - Token Ring communications	014602	*M36TRN
AS/400 Advanced 36 - workstation	014608	*M36WS
AS/400 Advanced 36 - X.25 communications	014603	*M36X25
NetBIOS on TCP/IP	015700	*NTBTCP
OptiConnect	015500	*OPC
Private address space environment	016100	*PASE
Performance collection services	016200	*PFRCOLSRV
Program binder	013200	*PGMBND
Program management	010300	*PGMMGT
Portability utilities	015200	*PORTUTIL
Process management	010500	*PRCMGT
Process table	015300	*PRCTBL
Pseudo terminal component	016500	*PSEUDOTERM
Power management	012900	*PWRMGT
Queue management	010700	*QMGT
Queue space management	013300	*QSMGT
Recovery management	013500	*RCYMGT
Remote support	016300	*RMTSPT
Resource management	010100	*RSCMGT
Sockets	014000	*SCK
Sockets Asynchronous and Overlapped Input/Output APIs	014002	*SCKASCIO
Sockets Network APIs	014004	*SCKNET
Other Socket APIs	014007	*SCKOTHER
MPTN AF_INET Sockets over SNA MPTN	014201	*SCKOVRMPTN
MPTN AF_INET Sockets over SNA PEC	014202	*SCKOVRPEC
Sockets Berkeley Resolver APIs	014005	*SCKRSLV
Sockets Select API	014003	*SCKSEL
Secure Sockets Layer (SSL) APIs	014006	*SCKSSL
Sockets Standard Input/Output APIs	014001	*SCKSTDIO
Signals	015600	*SIG
SMB server	015800	*SMBSVR
Space object management	011500	*SPCOBJMGT
Source/sink (device support) management	010803	*SRCSINK
Storage management - all	011105	*STGMGTALL
Streams	013900	*STM
Synchronization management	013700	*SYNCMGT
MI system call	015200	*SYSCALL
System journal management	014100	*SYSJRNMGT
Transmission Control Protocol/Internet Protocol (TCP/IP)	013800	*TCPIP
Transport Layer Interface	016000	*TLI
Transaction Management	016800	*TRXMGT>
Virtual I/O	016700	*VRTIO>
Virtual terminal management	013000	*VRTDEVMGT

JOB

Specifies the name of a job (job-number/user-name/job-name) which is used to determine whether the trace record is collected. Only trace records which are generated in the specified job(s) are collected. A list of up to ten qualified job names can be specified. The trace record will be collected if it was generated from a job that matches any of the qualified job name values.

Single Value

*NOCHG: If any qualified job names had been specified for the JOB parameter on a previous TRCINT command for an active trace, the job name filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL/*ALL/*ALL for the JOB parameter.

Job Name

*ALL: All trace records generated by the defined trace are collected, regardless of what job name the trace record was generated from.

generic*-job-name: Specify the generic name of the job from which trace records are to be collected. A generic name is a character string of one or more characters followed by and asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.

job-name: Specify the name of the job from which trace records are to be collected.

Job User Name

*ALL: All trace records generated by the defined trace are collected, regardless of what job user name the trace record was generated from.

generic*-user-name: Specify the generic user name of the job from which trace records are to be collected. A generic name is character string of one or more characters followed by and asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with user names that begin with the generic prefix.

user-name: Specify the name of the user of the job from which trace records are to be collected.

Job Number

*ALL: All trace records generated by the defined trace are collected, regardless of what job number the trace record was generated from. *ALL for the job number is considered to be a generic job specification because it will trace all jobs that meet the job name and job user name qualifiers that you specified.

job-number: Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or generic user name is specified.

SLTTHD

Specifies a thread identifier number which is used to determine whether the trace record is collected. Only trace records which are generated in the specified thread(s) are collected. There can be only one job that has thread IDs associated with it. It must be the first qualified job name specified for the JOB parameter, and the job must be active.

*NOCHG: If any thread identifiers had been specified for the SLTTHD parameter on a previous TRCINT command for an active trace, the thread ID filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL for this parameter.

*ALL: All trace records generated by the defined trace are collected, regardless of what thread ID the trace record was generated from.

*SELECT: A list of thread identifiers is shown from which you can select up to twenty threads. Trace records from any of the selected thread identifiers are to be collected. *SELECT is only valid if the TRCINT command is run in an interactive job.

thread-identifier: Specify the identifier of the thread from which trace records are to be collected. Up to twenty thread identifiers can be specified.

SVRTYPE

Specifies the server type attribute for a job or task which is used to determine whether the trace record is collected. Only trace records which are generated in a job or task with the specified server type are collected.

*NOCHG: If a value was specified for the server type on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.

*ALL: All trace records generated by the defined trace are collected, regardless of the server type attribute of the job or task the trace record was generated from.

generic*-server-type: Specifies the generic server type for which trace records are to be collected. A generic name is character string of one or more characters followed by and asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic server type specifies all jobs with a server type that begins with the generic prefix.

server-type: Specify the server type for which trace records are to be collected. A list of up to five server types can be specified.

TASK

Specifies the name of a Licensed Internal Code (LIC) task which is used to determine whether the trace record is collected. Only trace records which are generated from the specified LIC task are collected.

*NOCHG: If a value was specified for the task name (TASK parameter) on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for the task name.

*ALL: All trace records generated by the defined trace are collected, regardless of what LIC task the trace record was generated from.

generic*-task-name: Specify the generic name of the LIC tasks for which trace records are to be collected. A generic name is a character string of one or more characters followed by and asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic task name specifies all tasks with task names that begin with the generic prefix.

task-name: Specify the name of the LIC task for which trace records are to be collected. Up to ten LIC task names can be specified.

TASKNBR

Specifies the task number of a Licensed Internal Code (LIC) task which is used to determine whether the trace record is collected. Only trace records which are generated in the specified LIC task are collected.

*NOCHG: If a value was specified for the task number on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.

*ALL: All trace records generated by the defined trace are collected, regardless of the task number of the LIC task the trace record was generated from.

task-number: Specify a LIC task number for which trace records are to be collected. A list of up to ten task numbers can be specified.

SLTTRCPNT

Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be included. Trace records for trace points not specified on SLTTRCPNT will not be collected. If SLTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are being collected.

Note: This parameter and the OMTTRCPNT parameter are mutually exclusive. SLTTRCPNT cannot be specified for an active trace table that is using OMTTRCPNT to exclude specific trace points.

*NOCHG: The list of trace points for which trace records are being collected does not change.

trace-point-qualifier: Specify a single trace point qualifier or a range of trace point qualifiers whose trace records are to be included. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.

OMTTRCPNT

Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be excluded. Trace records for all trace points not specified on OMTTRCPNT will be collected. If OMTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are not being collected.

Note:

This parameter and the SLTTRCPNT parameter are mutually exclusive. OMTTRCPNT cannot be specified for an active trace table that is using SLTTRCPNT to include only specific trace points.

*NOCHG: The list of trace points for which trace records are being excluded does not change.

trace-point-qualifier: Specify a single trace point qualifier or a range of trace point qualifiers whose trace records are to be excluded. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.

STOPTRCPNT

Specifies one or more trace points which, if they are encountered, will cause collection of trace records to stop. The trace table records are not deleted and can later be written to a spooled file or an output device by invoking TRCINT with SET(*OFF) or SET(*SAVE).

Up to four trace points may be specified. Tracing will be stopped if any of the specified trace points match a trace record being added to the specified trace table.

A specified trace point can have either two parts (trace point type and trace point qualifier) or five parts (trace point type, trace point qualifier, trace point entry number, trace point entry offset, and trace point match value). A two-part condition will stop trace data collection if any trace record is collected for the specified trace point. A five-part condition will stop trace data collection only if the specified trace point match value exactly matches the data at the specified trace point entry offset.

Single Value

*NOCHG: The list of stop trace points associated with the trace table does not change.

Element 1: Trace Point Type

Specify the two-character trace point type.

Element 2: Trace Point Qualifier

Specify the trace point qualifier number. Valid numbers are 0 to 65535

Element 3: Trace Point Entry Number

Specify the trace point entry number.

Element 4: Trace Point Entry Offset

Specify the offset (in hexadecimal) in the trace point entry.

Element 5: Trace Point Match Value

Specify the match value to be compared to the trace record data. The match value may be specified in character or hexadecimal. Character strings will be converted to the equivalent hexadecimal strings.

JOBTYPE

Specifies the types of jobs for which trace data is being collected for use in the batch job trace report. A maximum of 11 of the following job types can be traced, or one of the single values *NONE or *ALL can be specified. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.

Note:

The value *DFT includes the values *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ and *BCI. The value *BCH includes the values *EVK, *MRT, *PDJ, *PJ, and *BCI.

*DFT: Batch and autostart job types are traced.

*ASJ: Autostart job types are traced.

*BCH: Batch job types are traced.

*EVK: Jobs started (evoked) by a procedure start request are traced.

*INT: Interactive jobs are traced.

*MRT: Multiple requester terminal job types are traced.

*RDR: Reader job types are traced.

*SBS: Subsystem monitor job types are traced.

*SYS: System job types are traced.

*WTR: Writer job types are traced.

*PDJ: Print driver job types are traced.

*PJ: Prestart job types are traced.

*BCI: Batch Immediate job types are traced.

*NONE: No job types are traced.

*ALL: All of the job types listed above are traced.

JOBTRCITV

Specifies the time (in CPU seconds) between each collection of the job trace data. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.

0.5: A time slice interval value of 0.5 CPU seconds is used.

number-of-seconds: Specify a time slice interval value ranging from 0.1 through 9.9 CPU seconds.

TCPDTA

Specifies whether a subset of TCP/IP and/or Sockets trace data should be collected. This parameter can be specified only if TRCTYPE(*TCPIP) or TRCTYPE(013800) is specified or if one or more of the sockets trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER, or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of TCP/IP or Sockets trace data is done for that element. For example, if *UDP is specified for element 1, only trace records where the UDP protocol is used are collected. If no value is specified for element 1, trace records using all TCP/IP protocols are collected.

If no values are specified for any element of TCPDTA and tracing of TCP/IP or Sockets data was not already active, no filtering of TCP/IP or Sockets trace data is done. If tracing of TCP/IP or Sockets data was already active and no TCPDTA values are specified, previous data filtering values will remain in effect.

Element 1: Protocol

Specify a TCP/IP protocol to be traced.

*TCP: Enable trace for transmission control protocol.

*UDP: Enable trace for user datagram protocol.

*ICMP: Enable trace for internet control message protocol.

*IGMP: Enable trace for internet group management protocol.

*ARP: Enable trace for address resolution protocol. This will only apply for TCP/IP.

*ICMP6: Enable trace for internet control message protocol version 6.>

Element 2: Local Ports

Specify one or two local port numbers for which trace data is collected.

Element 3: Remote Ports

Specify one or two remote port numbers for which trace data is collected.

Element 4: Local IP Address

Specify a local internet protocol address.>

Element 5: Remote IP Address

Specify a remote internet protocol address.>

Element 6: Line Description Name

Specify the name of a line description for which TCP/IP trace data is to be collected.

Element 7: Line Type

Specify whether the collection of trace information should be restricted to the specified line type.

*PPP: The collection of trace information is restricted to Point-to-point lines.

*OPC: The collection of trace information is restricted to Opticonnect.

SCKDTA

Specifies whether a subset of Sockets trace data should be collected. This parameter can be specified only if one or more of the socket trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of Sockets trace data is done for that element. For example, if *INET is specified for element 1, only trace records where the AF_INET address family is used are collected. If no value is specified for element 1, trace records using all socket address families are collected.

If no values are specified for any element of SCKDTA and tracing of Sockets data was not already active, no filtering of Sockets trace data is done. If tracing of Sockets data was already active and no SCKDTA values are specified, previous data filtering values will remain in effect.

The subset values specified on the SCKDTA parameter are used in combination with any subset values specified on the TCPDTA parameter to generate the complete subsetting criteria.

Element 1: Address Family

Specify a sockets address family for which trace data is collected.

*INET: Enable trace for AF_INET address family.

*UNIX: Enable trace for AF_UNIX and AF_UNIX_CCSID address families.

*TELEPHONY: Enable trace for AF_TELEPHONY address family.

*NETBIOS: Enable trace for AF_NETBIOS address family.

Element 2: Socket Type

Specify a socket type for which trace data is collected.

*STREAM: Enable trace for SOCK_STREAM (full-duplex stream) socket type.

*DGRAM: Enable trace for SOCK_DGRAM (datagram) socket type.

*RAW: Enable trace for SOCK_RAW (direct to network protocol) socket type.

*SEQPACKET: Enable trace for SOCK_SEQPACKET (full-duplex sequenced packet) socket type.

Element 3: Descriptor Number

Specify one or two socket descriptor numbers for which trace data is collected.

Element 4: Socket Option

Specify a socket option for which trace data is collected.

*SODEBUG: Applications with the SO_DEBUG Socket Option set on will have trace data collected.

DEV

Specifies the names of the devices for which the associated internal events are traced. This parameter can be specified only if TRCTYPE(*SRCSINK) or TRCTYPE(010803) is specified. Up to 16 device names may be specified.

The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the DEV parameter, you cannot enter values for the other parameters.

The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:

• specifying SET(*ON) multiple times for the same trace table
• specifying *ALLDEV on the CTL parameter
• specifying *ALLCTL on the LIN parameter

*NONE: No devices are traced by this command.

device-name: Specify the name of the device for which the internal trace is started. The device name must be the same as the name specified in the associated device description.

CTL

Specifies the names of the controllers for which the associated internal events are traced. This parameter is valid only if TRCTYPE(*SRCSINK) or TRCTYPE(010803) is specified. Up to 16 controller names may be specified.

The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the CTL parameter, you cannot enter values for the other parameters.

The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:

• specifying SET(*ON) multiple times for the same trace table
• specifying *ALLDEV on the CTL parameter
• specifying *ALLCTL on the LIN parameter

Single Value

*NONE: No controllers are traced by this command.

Element 1: Controller Name

controller-name: Specify the name of the controller for which the internal trace is started. The controller name must be the same as the name specified in the associated controller description.

Element 2: Tracing of Attached Devices

Specifies if the devices on a controller are traced.

*NODEV: No attached devices for the specified controller are traced.

*ALLDEV: All attached devices for the specified controller are traced. The attached devices do not count toward the maximum of 16 source/sink objects that can be named on the DEV, CTL, LIN, NWI and NWS parameters. However, the attached devices do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.

LIN

Specifies the names of the lines for which the associated internal events are traced. This parameter is valid only if TRCTYPE(*SRCSINK) or TRCTYPE(010803) is specified. Up to 16 line names may be specified.

The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.

The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:

• specifying SET(*ON) multiple times for the same trace table
• specifying *ALLDEV on the CTL parameter
• specifying *ALLCTL on the LIN parameter

Single Value

*NONE: No lines are traced by this command.

Element 1: Line Name

line-name: Specify the name of the line for which the internal trace is started. The line name must be the same as the name specified in the associated line description.

Element 2: Tracing of Attached Controllers

Specifies if the controllers on a line are traced.

*NOCTL: No attached controllers for the specified line are traced.

*ALLCTL: All attached controllers for the specified line are traced. The attached controllers do not count toward the maximum of 16 source/sink objects that can be named on the DEV, CTL, LIN, NWI and NWS parameters. However, the attached controllers do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.

NWI

Specifies the names of the network interfaces for which the associated internal events are traced. This parameter can be specified only if TRCTYPE(*SRCSINK) or TRCTYPE(010803) is specified. Up to 16 network interface names may be specified.

The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the NWI parameter, you cannot enter values for the other parameters.

The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:

• specifying SET(*ON) multiple times for the same trace table
• specifying *ALLDEV on the CTL parameter
• specifying *ALLCTL on the LIN parameter

*NONE: No network interfaces are traced by this command.

network-interface-name: Specify the name of the network interface for which the internal trace is started. The network interface name must be the same as the name specified in the associated network interface description.

NWS

Specifies the names of the network servers for which the associated internal events are traced. This parameter can be specified only if TRCTYPE(*SRCSINK) or TRCTYPE(010803) is specified. Up to 16 network server names may be specified.

The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the NWS parameter, you cannot enter values for the other parameters.

The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:

• specifying SET(*ON) multiple times for the same trace table
• specifying *ALLDEV on the CTL parameter
• specifying *ALLCTL on the LIN parameter

*NONE: No network servers are traced by this command.

network-server-name: Specify the name the network server for which the internal trace is started. The network server name must be the same as the name specified in the associated network server description.

RSRCNAME

Specifies the name of the hardware resource for which the associated internal events are traced. This parameter can be specified only if TRCTYPE(014700) or TRCTYPE(011900) is specified. >A maximum of ten hardware resource names may be specified.

*NONE: No hardware resource is traced by this command.

hardware-resource-name: Specify the name of a hardware resource for which the internal trace is started.

OUTDEV

Specifies the device description name of the tape or optical device on which the held trace records are written. This parameter must be specified if SET(*SAVE) is specified; otherwise it is ignored.

TASKINF

Specifies whether information for all licensed internal code (LIC) tasks is written to a spooled file or output device. This parameter can be specified if SET(*OFF) or SET(*SAVE) is specified.

*TRCREF: Write information only for LIC tasks that were referenced by trace records in the specified trace table.

*ALL: Write information for all LIC tasks that were in existence while the trace was active.

Examples for TRCINT

Example 1: Starting Component Data Traces and Call Traces

TRCINT  SET(*ON)  TRCTYPE(010100 010400 050500 051200)

This command starts component data traces and call traces for resource management and database. Database operations associated with database files are used to collect component data trace records.

Example 2: Tracing Lines and Controllers

TRCINT  SET(*ON)  TRCTYPE(*SRCSINK) TRCTBL(*SYSDFT)
        DEV(WS1 WS2 WS3)
        CTL((C1) (C2)) LIN((L1) (L2))

This command starts component data traces for source/sink management (device support) operations involving the devices WS1, WS2, and WS3, lines L1 and L2, and controllers C1 and C2.

Example 3: Stopping Traces and Clearing Trace Table

TRCINT  SET(*END)  TRCTBL(*SYSDFT)

This command stops all traces and deletes the trace records from the system default trace table.

Example 4: Tracing Communications Trace Service Function

TRCINT  SET(*ON)  TRCTYPE(*CMNTRC)

This command starts component data traces for the communications trace service function.

Example 5: Using Job Filtering Capability

TRCINT  SET(*ON) TRCTBL(MYFTPTRACE) TRCTYPE(*TCPIP)             
   JOB(QTCP/QTFTP*)                                        

This command starts a TCP/IP trace and will only collect trace records for trace points collected in jobs with user name QTCP and job names that begin with the prefix QTFTP. Trace records will be stored in trace table MYFTPTRACE.>

Error messages for TRCINT

*ESCAPE Messages

CPD3683

TRCFULL parameter only valid with SET(*ON).

CPD3685

SLTTRCPNT or OMTTRCPNT parameters are mutually exclusive.

CPD3686

TCPDTA only valid if TRCTYPE(*TCPIP) is specified.

CPD3688

Job types (JOBTYPE) parameter only valid with TRCTYPE(*MPL).

CPD3689

Job trace interval (JOBTRCITV) parameter only valid with TRCTYPE(*MPL)

CPD368A

Cannot change trace point selection criteria for active trace table.

CPD36C0

OUTDEV parameter only valid with SET(*SAVE).

CPD36C1

SIZE parameter only valid with SET(*ON) or SET(*SIZE).

CPD36CD

TASKINF parameter only valid with SET(*OFF) or SET(*SAVE).

CPD3983

Range of parameter SIZE not valid.

CPD3990

User number qualifier not valid.

CPD3991

Job, thread identifier or task not active.

CPF3515

Too many trace requests or objects.

CPF3516

Trace table is full.

CPF3517

Cannot specify *SELECT for the thread ID to include.

CPF3518

End time and date earlier than start time and date.

CPF3659

Total of specified CTL, DEV, LIN, NWI, and NWS greater than allowed.

CPF3679

Service function returned completion code &1 qualifier &2.

CPF368A

Trace table size not changed.

CPF3683

Error occurred trying to open printer file.

CPF3684

Error occurred while trying to close a print file.

CPF3685

Error occurred while data being put to print file.

CPF3686

Service function ended with error message.

CPF3687

Error occurred while trying to open file.

CPF3688

Error occurred while tape or diskette file being closed.

CPF3689

Error occurred while writing data to tape or diskette.

CPF3692

Error occurred while trying to write data to tape or diskette.

CPF3693

Service function ended because error occurred.

CPF3694

Cannot start service function.

CPF3695

No trace tables exist.

CPF3696

No traces recorded.

CPF3697

Trace type parameter value missing.

CPF7A11

Trace table &1 not found.

CPF7A13

Trace table cannot be created.

CPF7A15

Trace buffer must be cleared.

CPF7A17

Trace already being active.

CPF7A1A

Cannot change trace point selection criteria for active trace table.

CPF7A1C

IP address not valid.