Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
Top |
Keyword | Description | Choices | Notes |
---|---|---|---|
APP | TCP/IP application | *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 | 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 |
Top |
Specifies the TCP/IP application. This is a required parameter.
Top |
Specifies whether the collection of trace information starts, stops, or status is presented.
Top |
Specifies the maximum amount of storage in kilobytes (K) used for collected trace information.
Top |
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.
Top |
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
Other values (up to 11 repetitions)
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.
Top |
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 identifier 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) Log identifier 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
Qualifier 1: Trace program
Qualifier 2: Library
Top |
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.
Top |
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.
Top |
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.
Top |
Only trace information associated with a specific recipient host name will be collected. This parameter is only valid when APP(*SMTPCLT) is specified.
Top |
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
Element 2: IP address
Element 3: Subnet mask or Prefix length
Element 4: Port number
Top |
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
Element 2: IP address or UNIX path
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
Element 4: Port number
Top |
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.
Top |
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.
Top |
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.
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.
Top |
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.
QOS allows the following argument list values:
Top |
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.
Top |
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.
Top |
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.
Top |
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.
Top |
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.
Top |
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.
Top |
This parameter will determine which HTTP server instance to trace. It is only valid and required when APP(*HTTP) is specified.
Top |
Specifies the name of the server instance to trace. This parameter is only valid when APP(*DIRSVR) is specified.
Top |
Specifies the level of granularity of the service trace. This parameter is only valid when APP(*HTTP), APP(*SMTPAPI) or APP(*REXEC) is specified.
Top |
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.
Top |
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.
Top |
Specifies the type of configuration description to trace. This parameter is only valid when ADLTRC(*CMNTRC) is specified.
Top |
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.
Single values
Element 1: Message identifier
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.
Element 3: Compare against
Specify which part of the message the comparison data specified for element 2 is to be compared against.
Element 4: Message type
Specify the message type assigned to the message to be watched.
Element 5: Relational operator
Specify one relational operator against which the message severity code is compared.
Element 6: Severity code
Specifies the severity code of the message to be watched.
Top |
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
Qualifier 1: Message queue
Qualifier 2: Library
Top |
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
Element 1: Job name
Qualifier 1: Job name
Qualifier 2: User
Qualifier 3: Number
Top |
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
Element 1: Major code
Element 2: Minor code
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.
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.
Top |
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
Other values (up to 5 repetitions)
Element 1: System reference code
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.
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.
Top |
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.
Top |
Specifies how often the trace exit program will be called.
Top |
Specifies the priority of the job where the watch session work will be run.
Top |
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
Element : Job name
Qualifier 1: Job name
Qualifier 2: User
Qualifier 3: Number
Top |
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.
Top |
Top |