Trace TCP/IP Application (TRCTCPAPP)

The Trace TCP/IP Application (TRCTCPAPP) command is used by service personnel when trace information needs to be captured for one of the following TCP/IP applications: File Transfer Protocol (FTP), SMTP server, SMTP client, SMTP APIs, REXEC, TELNET/VTAPI, host servers, Distributed Data Management (DDM), Virtual Private Network (VPN), Layer Two Tunneling Protocol (L2TP), certificate services, Point-to-Point Protocol (PPP), Quality Of Service (QOS), simple Network Time Protocol (NTP), directory services, HTTP server powered by Apache or packet rules.

Restrictions: To use this command, you must have either *SERVICE special authority or be authorized to the Service Trace function through the Systems Director Navigator Application Administration support. For a given application, there could be only one trace active at a time on the system. The user must have *USE authority to the line, network interface, or network server to be traced.

When the Additional traces (ADLTRC) parameter is specified, you must have all object (*ALLOBJ) special authority or be authorized to the Trace Any User function of Systems Director Navigator Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_ALLOBJ_TRACE_ANY_USER, can also be used to change the list of users that are allowed to perform trace operations.

When the Watched job (WCHJOB) parameter is specified, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required if a generic user name is specified for the Watched job (WCHJOB) parameter.

If you specify a generic user name in the Watched job (WCHJOB) parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch any job function of Operating System through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.

You must have operational (*OBJOPR) and execute (*EXECUTE) authorities to the user exit program if specified in Trace program (TRCPGM) parameter, and execute (*EXECUTE) authority to the library where the program is located.

You must have use (*USE) authority to the message queues specified in Watched message queue (WCHMSGQ) parameter, and use (*USE) authority to the library where the message queue is located.

A trace cannot be defined to trace all job names and all users.

Note: Whenever the term host server is seen within this help text, it refers to one of the application host servers: *CENTRAL, *DTAQ, *RMTCMD, *SIGNON, *NETPRT, *SVRMAP or *DATABASE.

Parameters

Keyword Description Choices Notes
APP TCP/IP application Start of change*FTP, *SMTPSVR, *SMTPCLT, *TELNET, *VTAPI, *CENTRAL, *DTAQ, *RMTCMD, *SIGNON, *NETPRT, *SVRMAP, *DDM, *VPN, *CERTSRV, *L2TP, *PPP, *QOS, *NTP, *HTTP, *DIRSRV, *DATABASE, *PKTRULES, *POP, *MSF, *SMTPAPI, *REXEC, *DIRCLTEnd of change Required, Positional 1
SET Trace option setting *ON, *OFF, *END, *CHK Optional, Positional 2
MAXSTG Maximum storage for trace 1-16000, *APP Optional, Positional 3
TRCFULL Trace full action *WRAP, *STOPTRC Optional, Positional 4
ADLTRC Additional traces Single values: *NONE
Other values (up to 11 repetitions): *CMNARB, *CMNTRC, *DEVD, *DEVMGR, *JOB, *SOCKETS, *SRCSINK, *SYSARB, *TCPIP, *USER, *USERDEVD
Optional, Positional 5
TRCPGM Trace program Single values: *NONE
Other values: Qualified object name
Optional, Positional 6
Qualifier 1: Trace program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TITLE Trace title Character value, *DFT Optional, Positional 7
USER User profile Simple name Optional, Positional 8
MAILADR Recipient mail address Character value Optional, Positional 9
HOST Recipient host name Character value Optional, Positional 10
RMTNETADR Remote network address Element list Optional, Positional 11
Element 1: Address family *CALC
Element 2: IP address Character value
Element 3: Subnet mask or Prefix length Character value, *HOST
Element 4: Port number 1-65535, *ANY
LCLNETADR Local network address Element list Optional, Positional 12
Element 1: Address family *CALC, *UNIX
Element 2: IP address or UNIX path Character value
Element 3: Subnet mask or Prefix length *HOST
Element 4: Port number 1-65535, *ANY
DEVD Device description Generic name, name Optional, Positional 13
DEVTYPE Device type Single values: *DSP, *PRT
Other values (up to 6 repetitions): 5251, 5291, 5292, 3196, 3488, 3487, 3179, 3180, 5555, 3477, 3277, 3278, 3279, V100, 3812, 5553
Optional, Positional 14
TRCPNT Trace point Values (up to 12 repetitions): Character value Optional, Positional 15
ARGLIST Argument list Character value Optional, Positional 16
VPNSVR Virtual private network server Values (up to 2 repetitions): *KEYMGR, *CNNMGR Optional, Positional 17
CERTTYPE Certificate services type *ALL, *DCM, *KEYMGR, *SSL, *OBJSIGN, *OTHER Optional, Positional 18
DNS Domain name service *NO, *YES Optional, Positional 19
PPPCNNPRF PPP connection profile Character value Optional, Positional 20
TCPTRCDTA TCP/IP data to trace *PPPALL, *LCPNCP Optional, Positional 21
QOSTRCTYPE QOS trace type *ALL, *POLICYD, *RSVPD Optional, Positional 22
HTTPSVR HTTP server instance Character value Optional, Positional 23
INSTANCE Instance Character value, *DFT, *ALL Optional, Positional 24
TRCLVL Trace level *ERROR, *INFO, *VERBOSE Optional, Positional 25
PKTTRCPNT Packet rules trace points *TRAFFIC, *LOAD Optional, Positional 26
CFGOBJ Configuration object Name Optional, Positional 27
CFGTYPE Type *LIN, *NWI, *NWS Optional, Positional 28
WCHMSG Watch for message Single values: *NONE
Other values (up to 5 repetitions): Element list
Optional, Positional 29
Element 1: Message to watch Generic name, name, *ALL, *IMMED
Element 2: Comparison data Character value, *NONE
Element 3: Compare against *MSGDTA, *FROMPGM, *TOPGM
Element 4: Message type *ALL, *COMP, *DIAG, *ESCAPE, *INFO, *INQ, *NOTIFY, *SCOPE, *STATUS
Element 5: Relational operator *GE, *EQ, *GT, *LT, *LE
Element 6: Severity code 0-99, 00
WCHMSGQ Watched message queue Values (up to 3 repetitions): Element list Optional, Positional 30
Element 1: Message queue Single values: *SYSOPR, *JOBLOG, *HSTLOG
Other values: Qualified object name
Qualifier 1: Message queue Name
Qualifier 2: Library Name, *LIBL
WCHJOB Watched job Single values: *
Other values (up to 5 repetitions): Element list
Optional, Positional 31
Element 1: Job name Qualified job name
Qualifier 1: Job name Generic name, name
Qualifier 2: User Generic name, name
Qualifier 3: Number 000001-999999, *ALL
WCHLICLOG Watch for LIC log entry Single values: *NONE
Other values (up to 5 repetitions): Element list
Optional, Positional 32
Element 1: Major code Character value, *ALL
Element 2: Minor code Character value, *ALL
Element 3: Comparison data Character value, *NONE
Element 4: Compare against *ALL, *TDENBR, *TASKNAME, *SVRTYPE, *JOBNAME, *JOBUSR, *JOBNBR, *THDID, *EXCPID, *MODNAME, *MODRUNAME, *MODEPNAME, *MODOFFSET, *MODTSP
WCHPAL Watch for PAL entry Single values: *NONE
Other values (up to 5 repetitions): Element list
Optional, Positional 33
Element 1: System reference code Character value, *ALL
Element 2: Comparison data Character value, *NONE
Element 3: Compare against *RSCNAME, *RSCTYPE, *RSCMODEL
WCHTIMO Length of time to watch 1-43200, *NOMAX Optional, Positional 34
TRCPGMITV Time interval 1-9999, *NONE Optional, Positional 35
RUNPTY Run priority 1-99, 25 Optional, Positional 36
JOB Jobs Single values: *
Other values (up to 16 repetitions): Element list
Optional, Positional 37
Element 1: Job name Qualified job name
Qualifier 1: Job name Generic name, name, *ALL
Qualifier 2: User Generic name, name, *ALL
Qualifier 3: Number 000001-999999, *ALL

TCP/IP application (APP)

Specifies the TCP/IP application. This is a required parameter.

*CENTRAL
Specifies tracing for the central host server.
*CERTSRV
Specifies tracing for certificate services.
*DATABASE
Specifies tracing for the database host server.
*DDM
Specifies tracing for the Distributed Data Management (DDM) server.
*DIRSRV
Specifies tracing for directory services.
*DTAQ
Specifies tracing for the data queue host server.
*FTP
Specifies tracing for the File Transfer Protocol (FTP) server.
*HTTP
Specifies tracing for the HTTP server powered by Apache.
*L2TP
Specifies tracing for Layer Two Tunneling Protocol (L2TP).
*MSF
Specifies tracing for the Simple Mail Transport Protocol (SMTP) Mail Server Framework (MSF) exit programs.
*NETPRT
Specifies tracing for the network print host server.
*NTP
Specifies tracing for the Simple Network Time Protocol (SNTP) client.
*PKTRULES
Specifies tracing for packet rules (PKTRULES).
*POP
Specifies tracing for the Post Office Protocol (POP) server.
*PPP
Specifies tracing for the Point-to-point protocol (PPP).
*QOS
Specifies tracing for the Quality Of Service (QOS) server.
*RMTCMD
Specifies tracing for the remote command host server.
*SIGNON
Specifies tracing for the signon host server.
*SMTPCLT
Specifies tracing for the SMTP client job(s) handling outbound mail processing connections.
*SMTPSVR
Specifies tracing for the Simple Mail Transfer Protocol (SMTP) server job(s) handling inbound mail processing connections.
*SVRMAP
Specifies tracing for the port mapper host server.
*TELNET
Specifies tracing for the TELNET server.
*VPN
Specifies tracing for the Virtual Private Network (VPN) server.
*VTAPI
Specifies tracing for the virtual terminal application programming interfaces.
*SMTPAPI
Specifies tracing for job(s) that invoke SMTP APIs.
*REXEC
Specifies tracing for job(s) that invoke the REXEC application.

Trace option setting (SET)

Specifies whether the collection of trace information starts, stops, or status is presented.

*ON
The collection of trace information is started.
*OFF
The collection of trace information is stopped and the trace information is written to spooled printer files of the user. For PPP traces, the trace files are also included in the OUTQ for the designated PPP profile.
*END
Tracing is ended and all trace information is deleted. No trace information output is created.
*CHK
The status of tracing for the specified application is checked. Messages are returned indicating whether or not tracing is active for the specified TCP/IP application, the command parameters specified from the last time that TRCTCPAPP was started for this application and other information related to the collection of trace information.

Maximum storage for trace (MAXSTG)

Specifies the maximum amount of storage in kilobytes (K) used for collected trace information.

*APP
Each application type defines a default buffer size.
  • *FTP - 4096K bytes per job
  • *SMTPCLT - 16000K bytes per job
  • *SMTPSVR - 16000K bytes per job
  • *TELNET - 16000K bytes per job
  • *VTAPI - 16000K bytes per job
  • *CENTRAL - 16000K bytes per job
  • *RMTCMD - 16000K bytes per job
  • *SIGNON - 16000K bytes per job
  • *DTAQ - 16000K bytes per job
  • *NETPRT - 16000K bytes per job
  • *SVRMAP - 16000K bytes per job
  • *DATABASE - 16000K bytes per job
  • *DDM - 16000K bytes per job
  • *VPN - 16000K bytes per job
  • *PKTRULES - 16000K bytes per job
  • *L2TP - 4096K bytes per job
  • *CERTSRV - 16000K bytes per job
  • *PPP - 4096K bytes per job
  • *QOS - 4096K bytes per job
  • *NTP - 4096K bytes per job
  • *HTTP - 16000K bytes per job
  • *DIRSRV - 16000K bytes per job
  • *POP - 16000K bytes per job
  • *MSF - 16000K bytes per job
  • *SMTPAPI - 16000K bytes per job
  • *REXEC - 16000K bytes per job
1-300000
Specify the maximum amount of storage, in kilobytes, used to store trace records (one kilobyte 1024 bytes).

Trace full action (TRCFULL)

Specifies whether the trace records wrap (replace oldest records with new records) or whether the trace stops when all of the storage specified by the MAXSTG parameter has been used.

*WRAP
When the trace buffer is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.
*STOPTRC
Tracing stops when the trace buffer is full of trace records.

Additional traces (ADLTRC)

Specifies additional trace(s) to be started. When the TRCTCPAPP command is invoked interactively, the user will be prompted for any options to change on each of the selected traces. This parameter is valid for all applications.

Note: Specifying *CMNARB, *DEVD, *DEVMGR, *JOB, *SYSARB, *USER or *USERDEVD is only valid when tracing the *TELNET application.

Single values

*NONE
No additional trace will be included.

Other values (up to 11 repetitions)

*CMNARB
A job-level trace of all communication arbiter jobs will be started. For more information about communication arbiters, use the Search function in the IBM i Information Center.
*CMNTRC
A communications trace will be included in the trace information for the specified application.

Note: Due to resource limitations of the I/O hardware, multi-connection PPP profiles may not produce trace data for every connection started by the PPP profile.

*DEVD
All jobs associated with the device specified for the Device description (DEVD) parameter will be traced.
*DEVMGR
All information related with Telnet device management functions will be traced.
*JOB
All jobs specified in job parameter (JOB) will be traced.
*SOCKETS
A single Sockets component trace will be included in the trace information for the specified application.
*SRCSINK
A source/sink component trace will be included in the trace information for the specified application.
*SYSARB
A job-level trace of all system arbiter jobs will be started. For more information about system arbiters, use the Search function in the IBM i Information Center.
*TCPIP
A single TCP/IP component trace will be included in the trace information for the specified application.
*USER
All information related with the user profile parameter (USER) will be traced.
*USERDEVD
All user jobs associated with the device specified for the Device description (DEVD) parameter will be traced.

Trace program (TRCPGM)

Specifies the name of a program to call for user defined trace commands and procedures. This parameter is valid for all applications.

For SET(*ON), the trace program will be called:

For SET(*OFF), the trace program will be called:

For SET(*END), the trace program will be called:

When the TRCTCPAPP CPP detects an error with the trace program, it will display the TCP4537 diagnostic message. If watch for trace event facility is active, the trace and the watch for trace event facility will be ended, and CPI3999 message will be sent to the system operator message queue with reason code 04.

There are three input parameters and one output parameter associated with the trace program. The four parameters are required:

The possible values for the Trace option setting (SET) parameter are:

The possible values for the "Application" parameter are the same as the values for the APP parameter on the TRCTCPAPP command.

The possible values for the "Error detected" parameter are:

The possible values for the "Comparison data" parameter when *MSGID is specified on "Trace option setting" parameter will be the following structure:

Offset    Type         Field
Dec Hex
 0   0    BINARY(4)    Length of trace information
 4   4    CHAR(7)      Message ID
11   B    CHAR(9)      Reserved
20  14    BINARY(4)    Offset to comparison data
24  18    BINARY(4)    Length of comparison data
 *   *    CHAR(*)      Message comparison data

The possible values for the "Comparison data" parameter when *LICLOG or *CMPDATA is specified on "Trace option setting" parameter will be the following structure:

Offset     Type         Field
Dec Hex
 0   0      BINARY(4)    Length of trace information
 4   4      CHAR(4)      LIC Log major code
 8   8      CHAR(4)      LIC Log minor code
12   C      CHAR(8)      LIC Log id (keyword DMPID on PRTINTDTA)
20  14      BINARY(4)    Offset to comparison data
24  18      BINARY(4)    Length of comparison data
 *   *      CHAR(*)      LIC log comparison data

The possible values for the "Comparison data" parameter when *ON, *OFF, *END, *INTVAL or *WCHTIMO is specified on "Trace option setting" parameter will be the following structure:

Offset     Type         Field
Dec Hex
 0   0      BINARY(4)    Length of trace information (always 4
at this time).

Allowed values for the "Comparison data" parameter when *PAL is specified for the "Trace option setting" parameter will be the following structure:

OFFSET     TYPE         FIELD
Dec  Hex
  0    0   BINARY(4)    Length of watch information
  4    4   CHAR(8)      System reference code
 12    C   CHAR(10)     Device name
 22   16   CHAR(4)      Device type
 26   1A   CHAR(4)      Model
 30   1E   CHAR(15)     Serial number
 45   2D   CHAR(10)     Resource name
 55   37   CHAR(8)      Error Log id (keyword ERRLOGID on PRTERRLOG)
 63   3F   CHAR(8)      PAL timestamp
 71   47   CHAR(4)      Reference code
 75   4B   CHAR(8)      Secondary code
 83   53   CHAR(8)      Table identifier
 91   5B   CHAR(1)      Reserved
 92   5C   BINARY(4)    Sequence
 96   60   BINARY(4)    Offset to comparison data
 100  64   BINARY(4)    Length of comparison data
 104  68   CHAR(10)     PAL compare against
 *   *     CHAR(*)      PAL comparison data

For more information on the trace exit program interface, refer to the APIs topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/

Single values

*NONE
No user supplied trace program will be called. If a watched for message or Licensed Internal Code (LIC) log entry or Product Activity Log (PAL) entry is added, or if the specified watch time limit is exceeded, the trace function ends.

Qualifier 1: Trace program

name
Specify the name of the trace program to be called.

Qualifier 2: Library

*LIBL
The library list is used to locate the program.
*CURLIB
The current library is used to locate the program. If no library is specified as the current library, the QGPL library is used.
trace-program-library
Specify the name of the library where the program is located.

Trace title (TITLE)

Specifies the title that is printed on each page of the spooled file which contains the collected trace information. This parameter is only valid when SET(*OFF) is specified.

*DFT
The default trace description title "TRCTCPAPP Output" is used.
character-value
Specify up to 50 characters to be used as the title on each page of the trace output spooled file.

User profile (USER)

Only trace information associated with a specific user profile will be collected. This parameter is only valid when APP(*FTP) is specified, or when APP(*TELNET) and ADLTRC(*USER) are specified.

name
Specify the name of the user profile for which trace information is to be collected.

Recipient mail address (MAILADR)

Only trace information associated with a specific recipient mail address will be collected. This parameter is only valid when APP(*SMTPSVR) or APP(*SMTPCLT) is specified.

character-value
The recipient mail address (up to 255 characters) must have the following format: 'userid@abc.def.com'

Recipient host name (HOST)

Only trace information associated with a specific recipient host name will be collected. This parameter is only valid when APP(*SMTPCLT) is specified.

character-value
Specify the recipient host name (up to 255 characters). The name must have the following format: 'abc.def.com'

Remote network address (RMTNETADR)

The user may limit the amount of information collected by entering an address family, remote TCP/IP address, subnet mask and port number. This parameter is only valid when APP(*FTP), APP(*SMTPSVR), APP(*DDM), APP(host server), APP(*TELNET), APP(*VTAPI) or APP(*L2TP) is specified. Note: The only valid filter for L2TP is the IP address element.

Element 1: Address family

*CALC
The filter is AF_INET for IPv4 addresses. The filter is AF_INET6 for IPv6 addresses.

Element 2: IP address

character-value
Specify the remote TCP/IP address for which trace information is to be collected. Specify either an IPv4 or an IPv6 address.

Element 3: Subnet mask or Prefix length

*HOST
Tracing will be done for only the IP address specified as the second element of this parameter. For IPv4, this will specify a subnet mask of 255.255.255.255. For IPv6 this will specify a prefix length of /128.
character-value
Specify the IPv4 subnet mask or IPv6 prefix length for which trace information is to be collected.

Element 4: Port number

*ANY
The TCP/IP port number defaults to *ANY which implies traffic associated with any port on the remote system (and qualified by the IP address and subnet mask) will be traced.
1-65535
Specify the port number to be used. If a number is specified, a subnet mask value must also be specified.

Local network address (LCLNETADR)

The user may limit the amount of information collected by entering an address family, local TCP/IP address, subnet mask and port number. This parameter is only valid when APP(*DDM), APP(host server), APP(*TELNET) or APP(*VTAPI) is specified.

Element 1: Address family

*CALC
The filter is AF_INET for IPv4 addresses. The filter is AF_INET6 for IPv6 addresses.
*UNIX
The filter for AF_UNIX address family. Note that *UNIX is a valid choice for only APP(*DDM) or APP(host server).

Element 2: IP address or UNIX path

character-value
When *CALC is specified for element 1 of this parameter, specify the local TCP/IP address for which trace information is to be collected. Specify either an IPv4 or an IPv6 address.

When *UNIX is specified for element 1 of this parameter, specify the UNIX path for which trace information is to be collected. Note that an UNIX-path can be entered for only APP(*DDM) or APP(host server).

Element 3: Subnet mask or Prefix length

*HOST
Tracing will be done for only the IP address specified as the second element of this parameter. For IPv4, this will specify a subnet mask of 255.255.255.255. For IPv6 this will specify a prefix length of /128.
character-value
Specify the IPv4 subnet mask or IPv6 prefix length for which trace information is to be collected.

Element 4: Port number

*ANY
The TCP/IP port number defaults to *ANY which implies traffic associated with any port on the local system (and qualified by the IP address and subnet mask) will be traced.
1-65535
Specify the port number to be used. If a number is specified, a subnet mask value must also be specified.

Device description (DEVD)

The user may limit the amount of information collected by entering a device description name. Once the device description is associated with a given TELNET or VTAPI session, all trace information associated with it will be collected. This parameter is only valid when APP(*TELNET) or APP(*VTAPI) is specified.

name
Specify the name of a device description for which trace information is to be collected.
generic-name
Specify a generic name for device descriptions for which trace information is to be collected. A generic name is a character string of one or more characters followed by an asterisk (*); for example, CMN*. If a generic name is specified, then all device descriptions with names that begin with the generic name, and for which the user has authority, will have trace information collected.

Device type (DEVTYPE)

One or more valid device types may be specified. Only the trace information associated with activity for those devices will be traced. If *DSP or *PRT is specified, no other values may be entered for this parameter. This parameter is only valid when APP(*TELNET) or APP(*VTAPI) is specified.

*DSP
The information collected is only for display device types.
*PRT
The information collected is only for printer device types.
device-type
The information collected is only for the specified device types. Up to six types may be specified. The valid types include: 5251, 5291, 5292, 3196, 3488, 3487, 3179, 3180, 5555, 3477, 3277, 3278, 3279, V100, 3812 and 5553.

Trace point (TRCPNT)

You can limit the trace points that are placed in the trace buffer by entering the list of those trace points for this parameter. Up to 12 trace points may be specified. This parameter is only valid when APP(*TELNET), APP(*VTAPI), APP(*DDM) or APP(host server) is specified.

character-value
Specify the trace point identifier. Each trace point identifier may be up to 8 characters.

For TELNET/VTAPI trace points, specify 'TG#xxxxx', 'TG+xxxxx' or 'TG-xxxxx' where 'xxxxx' defines the specific trace point. The following TELNET/VTAPI trace points can also be specified: TGTELM, TGTELO, TGEXCP, TGREQPO, TGRIO, TGRPO, TGUTIL, TGVTERM, TGVTIN, TGVTINI, TGVTM or TGVTOUT.

For host/DDM server trace points, specify 'Qcccxxxx' where 'ccc' is the component ID of the host/DDM server and 'xxxx' defines the specific trace point.

Argument list (ARGLIST)

Only trace information associated with this specific argument list will be included in the trace information collected. The argument list contains data like the debug level and special trace requests. This parameter is only valid when APP(*VPN), APP(*QOS), APP(*PKTRULES), APP(*PPP) or APP(*DIRSRV) is specified.

character-value
Specify the argument list (up to 255 characters).

QOS allows the following argument list values:

lvl=1
The lvl=1 argument logs errors that are associated with system operations. One example might be that the system is out of memory. The result of these types of errors is that the QoS server will not be able to run.
lvl=2
The lvl=2 argument includes all lvl=1 information. In addition, the lvl=2 argument logs internal errors identified with the operation of the QOS server. The usual cause of these types of errors is that unexpected errors have been encountered in a server operation. A lvl=2 error is considered a condition for an APAR.
lvl=3
The lvl=3 argument includes all lvl=1 and lvl=2 information. In addition, the lvl=3 argument logs the basic operational activities of the QoS server. Examples might be the loading of rules or the sending of a STRTCPSVR SERVER(*QOS) RESTART(*QOS) command.
lvl=4
The lvl=4 argument includes all lvl=1, lvl=2 and lvl=3 information. In addition, the lvl=4 argument logs all traced activities of the QoS server.

Virtual private network server (VPNSVR)

Specifies whether the trace information is to be collected for the VPN key manager or the VPN connection manager. If no value is specified for this parameter, trace information is to be collected for both the VPN key manager and the VPN connection manager. This parameter is only valid when APP(*VPN) is specified.

*KEYMGR
Filtering of trace information is done to include the VPN key manager.
*CNNMGR
Filtering of trace information is done to include the VPN connection manager.

Certificate services type (CERTTYPE)

Only trace information associated with a specific certificate services type will be included in the captured trace information. This parameter is only valid when APP(*CERTSRV) is specified.

*ALL
No filtering of trace information is done for certificate services type.
*DCM
Filtering of trace information is done to include only the DCM certificate services type.
*KEYMGR
Filtering of trace information is done to include only the VPN key manager certificate services type.
*SSL
Filtering of trace information is done to include only the SSL certificate services type.
*OBJSIGN
Filtering of trace information is done to include only the OBJSIGN certificate services type.
*OTHER
Filtering of trace information is done to include only a certificate services type not listed above.

Domain name service (DNS)

Specifies whether only trace information associated with domain name service (DNS) resolution will be collected. This parameter is only valid when APP(*SMTPCLT) is specified.

*NO
No filtering of trace information is done for DNS resolution.
*YES
Trace information includes only trace points associated with DNS resolution.

PPP connection profile (PPPCNNPRF)

Trace information associated with a specific PPP connection profile will be collected. The default trace information provided is one joblog and one connection dialog spooled file (containing the PPP dialog trace) for each connection started by the PPP connection profile, one copy of the PPP profile settings, and one copy of the line description used by the profile. When selected by the user there could also be one SRCSINK component trace per connection, one Communications trace per connection and a single TCPIP component trace. This parameter is required when APP(*PPP) is specified.

character-value
Specify the PPP connection profile for which trace information is to be collected.

TCP/IP data to trace (TCPTRCDTA)

Specifies what additional data will be collected when ADLTRC(*TCPIP) is selected. This parameter is only valid when APP(*PPP) is specified. If APP(*PPP) is specified and ADLTRC(*TCPIP) is not specified, this parameter will be ignored.

*PPPALL
All data on the PPP connection will be traced.
*LCPNCP
Only LCP and NCP data on the PPP connection will be traced.

QOS trace type (QOSTRCTYPE)

Only trace information associated with a specific QOS trace type will be included in the trace information collected. This parameter is only valid when APP(*QOS) is specified.

*ALL
Filtering of trace information is done to include both servers.
*POLICYD
Filtering of trace information is done to include the QOS policy server.
*RSVPD
Filtering of trace information is done to include the RSVP (Resource reSerVation Protocol) server.

HTTP server instance (HTTPSVR)

This parameter will determine which HTTP server instance to trace. It is only valid and required when APP(*HTTP) is specified.

Instance (INSTANCE)

Specifies the name of the server instance to trace. This parameter is only valid when APP(*DIRSVR) is specified.

*DFT
The default server instance is traced. When APP(*DIRSVR) is specified, the QUSRDIR server instance will be traced.
*ALL
All instances of the server that are currently running are traced.
character-value
Specify the name of the server instance to be traced. Up to 32 characters may be specified.

Trace level (TRCLVL)

Specifies the level of granularity of the service trace. This parameter is only valid when APP(*HTTP), APP(*SMTPAPI) or APP(*REXEC) is specified.

*ERROR
The service trace will contain trace records for all error return codes or exception conditions.
*INFO
The service trace will contain *ERROR level trace records as well as trace records for entry and exit points from application level APIs and API parameters.
*VERBOSE
The service trace will contain *INFO level trace records as well as trace records for debugging control flow or data corruption.

Packet rules trace points (PKTTRCPNT)

Specifies a keyword that represents trace point values which will be displayed when the Trace Internal (TRCINT) panel is displayed. This parameter is only valid when APP(*PKTRULES) and ADLTRC(*TCPIP) are specified.

*TRAFFIC
The following trace points for packet filter evaluation will be displayed on the Trace Internal panel: 8110-8111, 8120-8123 and 8420.
*LOAD
The following trace points for the audit and load of rules will be displayed on the Trace Internal panel: 8100-8105 and 8430-8438.

Configuration object (CFGOBJ)

Specifies the configuration object to trace. The object can be either a line description, a network interface description, or a network server description. This parameter is only valid when ADLTRC(*CMNTRC) is specified.

name
Specify the name of the configuration object to be traced.

Type (CFGTYPE)

Specifies the type of configuration description to trace. This parameter is only valid when ADLTRC(*CMNTRC) is specified.

*LIN
The type of configuration object is a line description.
*NWI
The type of configuration object is a network interface description.
*NWS
The type of configuration object is a network server description.

Watch for message (WCHMSG)

Specifies up to five message identifiers which are to be watched for. If a value other than *NONE is specified, you must specify where to watch for the message on the WCHMSGQ parameter. When the watched for message is added to the specified message queue or log, the trace exit program is called; if no trace exit program is defined, the trace stops.

Note: Moved and resent messages will not be watched. Only the original instance of the message can be watched.

Note: Watching for message id CPF1124 or CPF1164 will be ignored in job QSCWCHPS (which handles watch processing). A user exit program will not be triggered when CPF1124 or CPF1164 is issued in job QSCWCHPS.

Single values

*NONE
No messages will be watched.

Element 1: Message identifier

*ALL
All messages are to be watched. This includes stored messages and immediate messages. Be aware that watching for all messages might cause performance degradation on your system. Use it cautiously.
*IMMED
All immediate or impromptu messages will be watched.
generic-name
Specify the generic message identifier to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic message name specifies all messages with message identifiers that begin with the generic prefix.
name
Specify the 7-character message identifier to be watched.

Element 2: Comparison data

Specify comparison data to be used if a message matching the specified message is added to the specified message queue or log. If the message data, the "From program" or the "To program" includes the specified text, the watched for condition is true. If the message data, the "From program" or the "To program" does not contain the specified text, the trace function continues.

*NONE
No comparison data is specified. If a message matching the specified message is added to the specified message queue or log, the watched for condition is true.
character-value
Specify the text string used to compare against the message data, the "From program" or the "To program" of the watched for message. This text is case sensitive and can be quoted in order to specify imbedded or trailing blanks.

Element 3: Compare against

Specify which part of the message the comparison data specified for element 2 is to be compared against.

*MSGDATA
The comparison data will be compared against the message replacement data.
*FROMPGM
The comparison data will be compared against the name of the program sending the message, or the name of the ILE program that contains the procedure sending the message.
*TOPGM
The comparison data will be compared against the name of the program the message was sent to, or the name of the ILE program that contains the procedure the message was sent to.

Element 4: Message type

Specify the message type assigned to the message to be watched.

*ALL
All the message types are to be watched. This includes completion, command, diagnostic, escape, informational, inquiry, notify, reply, request, sender's copy, scope and status message types.
*COMP
A completion message is to be watched.
*DIAG
A diagnostic message is to be watched.
*ESCAPE
An escape message is to be watched.
*INFO
An informational message is to be watched.
*INQ
An inquiry message is to be watched.
*NOTIFY
A notify message is to be watched.
*SCOPE
A scope message is to be watched.
*STATUS
A status message is to be watched.

Element 5: Relational operator

Specify one relational operator against which the message severity code is compared.

*GE
Greater than or equal.
*EQ
Equal.
*GT
Greater than.
*LT
Less than.
*LE
Less than or equal.

Element 6: Severity code

Specifies the severity code of the message to be watched.

00
The severity code assigned to the message to be watched for is 00.
Severity-code
Specify a value, ranging from 00 through 99, as the severity level associated with the message to be watched.

Watched message queue (WCHMSGQ)

Specifies where to watch for the message identifiers specified for the Watch for message (WCHMSG) parameter. You can specify to watch the message being added to the system operator message queue, the history log, other message queues, and job logs. Up to three message queues or special values can be specified.

Element 1: Message queue

Single values

*SYSOPR
Watch messages added to the system operator message queue (QSYSOPR message queue in library QSYS).
*HSTLOG
Watch messages added to the history log QHST.
*JOBLOG
Watch messages added to the job logs of jobs specified by the WCHJOB parameter.

Qualifier 1: Message queue

name
Specify the name of the message queue to watch.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
name
Specify the name of the library where the message queue is located.

Watched job (WCHJOB)

Specifies the job whose job log is watched for the messages specified on the WCHMSG parameter. The specified job will only be watched if *JOBLOG is specified on the WCHMSGQ parameter. Up to five job names may be specified.

Single values

*
Only the job log of the job that issued this trace command is watched.

Element 1: Job name

Qualifier 1: Job name

generic-name
Specify the generic name of the job to be watched. A generic name is a character string of one or more characters followed by an 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.
name
Specify the name of the job to be watched.

Qualifier 2: User

generic-name
Specify the generic name of the user name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with the specified job name and with user names that begin with the generic prefix.
name
Specify the name of the user of the job to be watched.

Qualifier 3: Number

*ALL
All jobs with the specified job name and user name are watched.
000001-999999
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 a generic user name qualifier is specified.

Watch for LIC log entry (WCHLICLOG)

Specifies up to five Licensed Internal Code (LIC) log entry identifiers which are to be watched for. Each LIC log entry contains a major and a minor code. The watched for condition will be met if a LIC log entry is added that matches the specified major and minor codes and any comparison data specified. When the watched for log entry is added to the LIC log, the trace exit program is called, even when the comparison data specified does not match; if no trace exit program is defined, the trace stops.

Single values

*NONE
No LIC log entries will be watched for.

Element 1: Major code

*ALL
Any LIC log entry major code will be considered to be a match. If *ALL is specified for the major code, you cannot specify *ALL for the LIC log entry minor code.
character-value
Specify the LIC log major code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Element 2: Minor code

*ALL
Any LIC log entry minor code will be considered to be a match. If *ALL is specified for the minor code, you cannot specify *ALL for the LIC log entry major code.
character-value
Specify the LIC log minor code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.

Element 3: Comparison data

Specify comparison data to be used if a log entry matching the specified major and minor codes is added to the Licensed Internal Code (LIC) log. If this text is found in the LIC log entry data fields of the watched for log entry, the watched for condition is true. If this text is not found in the LIC log entry data fields of the watched for log entry and no exit program is specified on the TRCPGM parameter, the trace function continues. If the log entry matches the specified major and minor codes and an exit program is specified on the TRCPGM parameter, but the entry data does not contain the specified text, the exit program is called to determine if the trace should continue or stop.

*NONE
No comparison data is specified. If a LIC log entry matching the specified major and minor codes is added to the LIC log, the watched for condition is true.
character-value
Specify the text string used to compare against the entry data of the watched for log entry. If this text is found in the LIC log entry data field specified for element 4, the watch condition is considered to be true. This text is case sensitive. If *ALL is specified in the LIC log compare against field, the LIC log fields which will be compared are TDE number, task name, server type, job name, user ID, job number, thread ID, exception ID, LIC module compile timestamp, LIC module offset, LIC module RU name, LIC module name, LIC module entry point name. The comparison data cannot be used to match across two fields, and can match an entire field or a substring of any field.

When watching for an exception ID, all four hexadecimal digits of the exception ID must be specified. Also, the prefix MCH may be specified if you want to compare only against the exception ID field and avoid possible substring matches with the other fields.

Element 4: Compare against

Specify which part of the LIC log the comparison data specified for element 3 is to be compared against.

*ALL
The LIC log comparison data will be compared against all the fields described below.
*TDENBR
The LIC log comparison data will be compared against the number of the task dispatching element (TDE) which requested the LIC log entry.
*TASKNAME
The LIC log comparison data will be compared against the name of the task which requested the LIC log entry. Task name is blank (hex 40s) if the LIC log entry is not requested by a task.
*SVRTYPE
The LIC log comparison data will be compared against the type of server that requested the LIC log entry. Server type is blank (hex 40s) if the LIC log entry is not requested by a server.
*JOBNAME
The LIC log comparison data will be compared against the name of the job which requested the LIC log entry. LIC job name is blank (hex 40s) if the LIC log entry is not requested by a job.
*JOBUSR
The LIC log comparison data will be compared against the user name of the job which requested the LIC log entry. LIC user name is blank (hex 40s) if the LIC log entry is not requested by a job.
*JOBNBR
The LIC log comparison data will be compared against the job number (000001-999999) to further qualify the job name and user name of the job which requested the LIC log entry. LIC job number is blank (hex 40s) if the LIC log entry is not requested by a job.
*THDID
The LIC log comparison data will be compared against the thread which requested the LIC log entry. Thread identifier is binary zeros if the LIC log entry is not requested by a thread.
*EXCPID
The LIC log comparison data will be compared against the exception that caused the LIC log entry to be requested. This is a 2-byte hexadecimal field formed by concatenating to the high-order 1-byte exception group number a low-order 1-byte exception subtype number. Exception identifier is binary zeros if the LIC log entry is not requested as a result of an exception.
*MODNAME
The LIC log comparison data will be compared against the LIC module name which requested the LIC log entry. If the module name is greater than 64 characters, the LIC module name is truncated to 64 characters.
*MODRUNAME
The LIC log comparison data will be compared against the LIC module replacement unit name. LIC module RU name is always in upper case EBCDIC.
*MODEPNAME
The LIC log comparison data will be compared against the name of the entry point which requested the LIC log entry. If the entry point name is greater than 128 characters, the LIC module entry point name is truncated to 128 characters.
*MODOFFSET
The LIC log comparison data will be compared against the byte offset into the LIC module text which requested the LIC log entry.
*MODTSP
The LIC log comparison data will be compared against the timestamp of when the LIC module was compiled. The format for this field is the system time-stamp format.

Watch for PAL entry (WCHPAL)

Specifies up to five Product Activity Log (PAL) entries which are to be watched for. When the watched for PAL occurs, the trace exit program is called; if no trace exit program is defined, the trace stops.

Single values

*NONE
No PAL entries will be watched for.

Other values (up to 5 repetitions)

Element 1: System reference code

*ALL
Any system reference code will be considered to be a match.
character-value
Specify the system reference code (SRC) to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the eight-digit code. A question mark is a wildcard character that will match any digit in that position. Up to seven wildcard characters can be specified. You can also specify a generic SRC that is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic SRC specifies all PAL entries with system reference codes that begin with the generic prefix.

Element 2: Comparison data

Specify comparison data to be used if a PAL entry matching the specified system reference code occurs. If the field specified in element 3 matches the specified text, the watched for condition is true. If the field specified in element 3 does not match the specified text, the watch function just continues.

*NONE
No comparison data is specified. If a PAL entry matching the specified system reference code occurs, the watched for condition is true.
character-value
Specify the text string used to compare against the field specified in element 3 of the watched for PAL entry. This text is case sensitive.

You can specify question mark (?) and asterisk (*) wildcard characters in the text string. A question mark is a single-character wildcard and will match any character in the same position. For example, '??123' will match any value that is five characters long and ends with '123'. Multiple question mark wildcard characters can be specified for the comparison data value.

An asterisk is a multiple-character wildcard character. You can specify a single asterisk wildcard character at the end of the comparison data value. For example, 'ABC*' will match any value that begins with the letters 'ABC'.

Element 3: Compare against

Specify which part of the PAL entry the comparison data specified for element 2 is to be compared against.

*RSCNAME
The comparison data will be compared against the name of the physical device that has the entry in the log. A resource name is assigned at first by the system, but may have been changed to a new value by a user.
*RSCTYPE
The comparison data will be compared against the number or word used to identify a product.
*RSCMODEL
The comparison data will be compared against the numbers or letters used to identify the feature level of a product with a given type.

Length of time to watch (WCHTIMO)

Specifies the time limit, in minutes, for watching for a message or a Licensed Internal Code (LIC) log entry or a Product Activity Log (PAL) entry. When the specified amount of time has elapsed, the trace exit program is called (if one was specified on the TRCPGM parameter), the trace is ended, and message CPI3999 is sent to the system operator message queue.

*NOMAX
There is no time limit for watching for a particular message or LIC log entry or PAL entry.
1-43200
Specify the number of minutes that the trace will be active while none of the watched for conditions have been met. You can specify up to 43200 minutes (30 days).

Time interval (TRCPGMITV)

Specifies how often the trace exit program will be called.

*NONE
No time interval is specified. The trace exit program will not be called because a time interval has elapsed.
1-9999
Specify the interval of time, in seconds, of how often the trace exit program will be called. This must be less than the amount of time specified for the Length of time to watch (WCHTIMO) parameter.

Run priority (RUNPTY)

Specifies the priority of the job where the watch session work will be run.

25
A job priority of 25 will be used.
1-99
Specify the run priority of the job. For more information on job run priority, refer to the Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/

Job name (JOB)

Specifies which jobs are to be traced. This parameter is only valid when APP(*SMPTAPI) or APP(*REXEC) is specified, or when APP(*TELNET) and ADLTRC(*JOB) are specified.

Single values

*
Only the job that issues the TRCTCPAPP (Trace TCP/IP application) command is to be traced.

Element : Job name

Qualifier 1: Job name

generic-name
Specify the generic name of the jobs to be traced. A generic name is a character string of one or more characters followed by an 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.
*ALL
All jobs names with the specified job user name are traced. *ALL for the job name is considered to be a generic job specification because it will trace all jobs that meet the job user name qualifiers that you specified.
name
Specify the name of the job to be traced. Up to sixteen job names may be specified.

Qualifier 2: User

generic-name
Specify the generic user name of the jobs from which trace records are to be collected. A generic name is a character string of one or more characters followed by an 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.
*ALL
All job user name with the specified job name are traced. *ALL for the job user name is considered to be a generic job specification because it will trace all jobs that meet the job name qualifiers that you specified.
name
Specify the user name of the job to be traced.

Qualifier 3: Number

*ALL
All jobs with the specified job name and user name are traced. *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.
000001-999999
Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name qualifier or generic user name qualifier is specified.

Examples

Example 1: Starting Trace for Database

TRCTCPAPP   APP(*DATABASE)  SET(*ON)  TRCPNT(QZDA1050 QZDA1060)
            LCLNETADR(*CALC
                      '9.130.69.22'
                      '255.255.255.255' 8471)
            ADLTRC(*CMNTRC)  TRCPGM(PGMLIB/PROG1)
            CFGOBJ(TESTLIN)  CFGTYPE(*LIN)

This command will start tracing for the database host server. Tracing information associated with the AF_INET address family, a local TCP/IP address of 9.130.69.22, a subnet mask of 255.255.255.255, port number of 8471 and trace points of QZDA1050 and QZDA1060 will be collected. A communication trace will be included in the trace information. TESTLIN is the name of the configuration object to trace. This object is a line (*LIN) description. Trace program PROG1 in library PGMLIB, with its user-defined trace commands and procedures, will be called. Tracing for the other TCP applications is not affected.

Example 2: Starting Trace for Database using IPv6 Address

TRCTCPAPP   APP(*DATABASE)  SET(*ON)
            LCLNETADR(*CALC
                      '1080:8:800:417A:1::'
                      *HOST)

This command will start tracing for the database host server using *INET6 filter, a local address of 1080:8:800:417A:1:: and prefix length of /128.

Example 3: Check Status of Database Tracing

TRCTCPAPP   APP(*DATABASE)  SET(*CHK)

This command is used to check the status of the tracing for the database host server job. Assume that the last command entered was from "Example 1" above. The format of the response to this command would be a set of messages that would look similar to the following:

TCP45B7 TRCTCPAPP APP(*DATABASE) SET(*ON)
                  TRCPNT(QZDA1050 QZDA1060)
                  LCLNETADR(*CALC '9.130.69.22'
                            '255.255.255.255' 8471)
                  MAXSTG(*DFT) TRCFULL(*WRAP) ADLTRC(*CMNTRC)
                  TRCPGM(PGMLIB/PROG1) CFGOBJ(TESTLIN)
                  CFGTYPE(*LIN)
TCP45B1 Tracing active for *DATABASE at 20:15:14 on 03/15/01 by
        043432/TRCUSER/QPADEV000B.
TCP45B2 Data capture begun for *DATABASE.
TCP45B3 Data buffer wrapped for *DATABASE.

Example 4: Ending Database Connection Tracing

TRCTCPAPP   APP(*DATABASE)  SET(*OFF)

This command first ends any currently active application trace for the database host server, followed by ending the TCP/IP component trace. If tracing was active, output trace records are formatted and placed into a spool file. A similar message will be found in the user's joblog:

TCP45B8 Trace data for application DATABASE formatted: QZDA001915.

If tracing is not active, then the following message will be returned to the user:

TCP4580 Tracing off, SET(*OFF) not valid.

Example 5: Starting Trace for Packet Rules

TRCTCPAPP   APP(*PKTRULES)  SET(*ON)
            ARGLIST('DebugLvl=1 TraceLvl=2')
            ADLTRC(*TCPIP)  PKTTRCPNT(*LOAD)

This command will start tracing for packet rules. Tracing information associated with the specific argument list will be collected. A component trace will be included in the trace information, using trace points of 8100-8105 and 8430-8438. Tracing for the other TCP applications is not affected.

Example 6: Starting Trace for FTP

TRCTCPAPP   APP(*FTP)  SET(*ON)
            RMTNETADR(*CALC '9.130.69.16'
                      '255.255.255.255' 5000)

This command will start tracing for the FTP server. Tracing information associated with the AF_INET address family, a remote TCP/IP address of 9.130.69.16, a subnet mask of 255.255.255.255 and port number of 5 will be collected. Tracing for the other TCP applications is not affected.

Example 7: Starting Trace for FTP using IPv6 Address

TRCTCPAPP   APP(*FTP)  SET(*ON)
            RMTNETADR(*CALC
                      '2001:0DB8:0::0:1428:57AB')

This command starts tracing the FTP server using AF_INET6 filter and IPv6 remote network address 2001:0DB8:0::0:1428:57AB.

Example 8: Starting Trace for TELNET

TRCTCPAPP   APP(*TELNET)  SET(*ON)  DEVD(QPADEV*)

This command will start tracing for the TELNET server. Trace information will be collected for all device descriptions with names that begin with "QPADEV". The user must have authority to these specific device descriptions. Tracing for the other TCP applications is not affected.

Example 9: Starting Trace for TELNET using IPv6 Address

TRCTCPAPP   APP(*TELNET)  SET(*ON)
            RMTNETADR(*CALC
                      'FE80::210:11FF:FE76:7800)

This command will start tracing for the TELNET server using AF_INET6 filter and IPv6 remote network address FE80::210:11FF:FE76:7800.

Example 10: Starting Trace for Analyzing a Device Problem

TRCTCPAPP APP(*TELNET) SET(*ON)
          ADLTRC(*DEVD *JOB *CMNARB *SYSARB)
          DEVD(MYDEVICE)
          JOB((*ALL/*ALL/MYSBS1) (*ALL/*ALL/MYSBS2))

This command will trace all the jobs that will be associated with the device description MYDEVICE, which is encountering a device problem. The command will start tracing for the TELNET server. Trace information is collected for all user jobs associated with device description MYDEVICE. Trace information is collected for the TELNET device manager jobs. Trace information is collected for all jobs that were supplied in the JOB parameter. In this example, all jobs with the name MYSBS1 and MYSBS2 will be traced, where MYSBS1 is the subsystem that displays the sign on screen for interactive device sessions and MYSBS2 is the subsystem jobs transfer to when a user signs on. Trace information is also collected for the system jobs that interact with display devices, which are all the QCMNARB and QSYSARB system jobs.

Example 11: Starting Trace for a HTTP Server Instance

TRCTCPAPP APP(*HTTP) SET(*ON) INSTANCE(HTTP1)

This command traces the HTTP server instance named HTTP1.

Example 12: Starting Trace for a Directory Services Server Instance

TRCTCPAPP APP(*DIRSRV) SET(*ON) INSTANCE(DIRSRV1)

This command traces the Directory Services server instance named 'DIRSRV1'.

Example 13: Starting Trace for Default Directory Services Server Instance

TRCTCPAPP APP(*DIRSRV) SET(*ON) INSTANCE(*DFT)

The default server instance (QUSRDIR) is traced.

Example 14: Starting Trace for one of the SMTP APIs

TRCTCPAPP APP(*SMTPAPI) SET(*ON) TRCLVL(*VERBOSE)
          JOB(044235/TOCUSR/QPADEV000G)

This command traces one of the SMTP API applications using a trace level of verbose and specifying the qualified job 044235/TOCUSR/QPADEV00G.

Error messages

*ESCAPE Messages

TCP4595
Trace not started.