IBM Support

Communications Trace for TCP/IP Printers (R510 and Above)

Troubleshooting


Problem

This document contains instructions for collecting a TCP/IP communications trace using the Start System Service Tools (STRSST) command.

Resolving The Problem

Caution: When experiencing problems with TCP/IP printers, it is highly recommended to discuss the problem with a representative of the Rochester Support Center before collecting a TCP/IP communications trace. The problem might be a known issue that can easily be resolved through configuration changes, printer hardware settings, or Program Temporary Fixes (PTFs). In these cases, a TCP/IP communications trace may not be required.


This document contains instructions for collecting a TCP/IP communications trace using the Start System Service Tools (STRSST) command. These instructions can be used for collecting trace for an ASCII printer (such as a *LAN 3812 device description, Remote Output Queue, PC5250 printer session or third-party emulation session) or a *LAN IPDS device description. However, a TCP/IP communications trace can also be taken using the Trace Connection (TRCCNN) command or the Start Communications Trace (STRCMNTRC) command.

For instructions on collecting a TCP/IP communications trace using the Trace Connection (TRCCNN) command, rather than using the STRSST command, refer to the following Rochester Support Center knowledgebase document:

N1019135: Running a TRCCNN Trace for LAN Printing Problems

For instructions on collecting a TCP/IP communications trace using the Start Communications Trace (STRCMNTRC) command, rather than using the STRSST command, refer to the following Rochester Support Center knowledgebase document:

N1019324: Communications Trace for TCP/IP Printers Using the STRCMNTRC Command

This document applies specifically to V5R1M0 (R510) and above.

After the TCP/IP communications trace has been collected, it can be downloaded to a PC and e-mailed to the Remote Technical Support representatives using the instructions in the following Rochester Support Center knowledgebase document:

N1019300: Copying the Text from a Spooled File Using System i Navigator

This document was last updated on 4 November 2013.




Regarding Gigabit or 1Gbps Ethernet Adapters

When attempting to trace TCP traffic through a Gigabit or 1Gbps Ethernet adapter (for example the FC2760, FC2843, FC5700 or FC5701 adapters), the Communications Trace (STRCMNTRC) utility might fail to capture adequate data due to the high rate of speed at which the interface transmits and receives data, coupled with the slow rate of speed at which the system collects trace data. An alternative for this situation is to use the Trace Connection (TRCCNN) command, which will capture all transmitted and received data on the Gigabit Ethernet line.

For instructions on collecting a trace using the TRCCNN command, refer to the following Rochester Support Center knowledgebase document:

N1019135: Running a TRCCNN Trace for LAN Printing Problems


Instructions for Collecting a TCP/IP Communications Trace Using the STRSST Command

1Use the following Work with Line Descriptions (WRKLIND) command to verify the name of your Ethernet or token-ring line description(s).

To work with Ethernet line descriptions, use the following command:

WRKLIND LIND(*ELAN)

To work with token-ring line descriptions, use the following command instead:

WRKLIND LIND(*TRLAN)

Both commands should be used because Ethernet and token-ring lines can be configured and active at the same time. Select Option 8 (Work with status) to determine if each line is active. It is recommended that a TCP/IP communications trace be configured for each active line even if Ethernet and token-ring lines are active. This is because TCP/IP data frames could be sent on one line and received on another and can sent on Ethernet and received on token-ring or vice-versa.
2On the operating system command line, use the Start System Service Tools (STRSST) command to go into the system service tools (SST). For example:

STRSST
MAIN                           OS/400 Main Menu                                
                                                             System:   S1010000
 Select one of the following:                                                  
                                                                               
      1. User tasks                                                            
      2. Office tasks                                                          
      3. General system tasks                                                  
      4. Files, libraries, and folders                                          
      5. Programming                                                            
      6. Communications                                                        
      7. Define or change the system                                            
      8. Problem handling                                                      
      9. Display a menu                                                        
     10. Information Assistant options                                          
     11. Client Access/400 tasks                                                
                                                                               
     90. Sign off                                                              
                                                                               
 Selection or command                                                          
 ===> STRSST                                                                    
                                                                               
 F3=Exit   F4=Prompt   F9=Retrieve   F12=Cancel   F13=Information Assistant    
 F23=Set initial menu                                                          
 (C) COPYRIGHT IBM CORP. 1980, 2002.              
3Type the service tools user name and password, and press the Enter key.
                Start Service Tools (STRSST) Sign On                          
                                                                               
                                            SYSTEM: S1010000                    
                                                                               
 Type choice, press Enter.                                                      
                                                                               
   Service tools user ID. . . . __________                                      
   Service tools password . . .                                                
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Note: The password is case-sensitive.                                          
                                                                               
                                                                               
 F3=Exit      F9=Change Password         F12=Cancel                            
                                                                               
4Select Option 1 (Start a service tool), and press the Enter key.
                      System Service Tools (SST)                              
                                                                               
 Select one of the following:                                                  
                                                                               
      1. Start a service tool                                                  
      2. Work with active service tools                                        
      3. Work with disk units                                                  
      4. Work with diskette data recovery                                      
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Selection                                                                      
      1                                                                         
                                                                               
 F3=Exit         F10=Command entry         F12=Cancel                          
                                                                               
5Select Option 3 (Work with communications trace), and press the Enter key.
                         Start a Service Tool                                  
                                                                               
 Warning: Incorrect use of this service tool can cause damage                  
 to data in this system.  Contact your service representative                  
 for assistance.                                                                
                                                                               
 Select one of the following:                                                  
                                                                               
      1. Product activity log                                                  
      2. Trace Licensed Internal Code                                          
      3. Work with communications trace                                        
      4. Display/Alter/Dump                                                    
      5. Licensed Internal Code log                                            
      6. Main storage dump manager                                              
      7. Hardware service manager                                              
                                                                               
                                                                               
                                                                               
                                                                               
 Selection                                                                      
      3                                                                         
                                                                               
 F3=Exit         F12=Cancel         F16=SST menu                                
                                                                               
6Press F6 to start a new trace.
                        Work with Communications Traces                        
                                                                               
 Type options, press Enter.                                                    
   2=Stop trace        4=Delete trace    6=Format and print trace              
   7=Display message   8=Restart trace                                          
                                                                               
       Configuration                                                            
 Opt   Object          Type   Trace Description      Protocol   Trace Status    
                                                                               
   (No active traces)  
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit    F5=Refresh      F6=Start trace    F10=Change size                  
 F11=Display buffer size    F12=Cancel                                          
7Set the configuration object to the name of the token-ring or Ethernet line used when printing to your printer.
Leave the type set to 1 (line).
Type in a trace description (for example, "TCP/IP Printer Trace").
Set the buffer size to 8192 KB (8M) or higher.
Leave the stop on buffer full set to N for No.
Leave the data direction set to 3 (both directions).
If running R440 operating system or later, set the beginning bytes to *MAX and leave the ending bytes set to *CALC. If running R430 OS/400 or earlier, leave the beginning bytes and the ending bytes set to *CALC.
Press the Enter key.
                                  Start Trace                                  
                                                                               
 Type choices, press Enter.                                                    
                                                                               
   Configuration object . . . . . . .   ETHLINE                                
                                                                               
   Type   . . . . . . . . . . . . . .   1           1=Line, 2=Network interface
                                                    3=Network server            
                                                                               
   Trace description  . . . . . . . .   TCP/IP PRINTER TRACE                   
                                                                               
   Buffer size  . . . . . . . . . . .   8192        128-1048576 K bytes        
                                                                               
   Stop on buffer full  . . . . . . .   N           Y=Yes, N=No                
                                                                               
   Data direction   . . . . . . . . .   3           1=Sent, 2=Received, 3=Both  
                                                                               
   Number of bytes to trace:                                                    
     Beginning bytes  . . . . . . . .   *MAX        Value, *CALC, *MAX          
     Ending bytes   . . . . . . . . .   *CALC       Value, *CALC                
                                                                               
                                                                               
 F3=Exit   F5=Refresh   F12=Cancel                                              
8The Select Trace Options screen lets you filter the trace so you are less likely to fill up the data buffer. Typically, Option 7 (IP address data) is recommended so you can collect only the data being sent to or being received from the TCP/IP address for the printer. Occasionally, Option 1 (All data) can be selected and the TCP/IP address of the printer can be specified when printing the trace.
                              Select Trace Options                              
                                                                               
 Configuration object . . . . . :   ETHLINE                                    
 Type   . . . . . . . . . . . . :   LINE                                        
                                                                               
 Select one of the following:                                                  
                                                                               
      1.  All data (no filtering)                                              
      2.  Remote controller data                                                
      3.  Remote MAC address data                                              
      4.  Remote SAP data                                                      
      5.  Local SAP data                                                        
      6.  IP protocol number                                                    
      7.  IP address data                                                      
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 Selection                                                                      
      7                                                                         
 F3=Exit     F5=Refresh      F12=Cancel                                        
                                                                               
9If Option 7 (IP address data) was selected, set the Remote IP address to the TCP/IP address for the printer, and press the Enter key.
                            Select Remote IP Address                            
                                                                               
 Configuration object . . . . . :   ETHLINE                                    
 Type   . . . . . . . . . . . . :   LINE                                        
                                                                               
 Type choice, press Enter.                                                      
                                                                               
   Remote IP address  . . . . . .   192.168.2.123                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit     F5=Refresh      F12=Cancel                                        
10The communications trace should be active at this time. Reproduce the problem. Then, return to SST, and select Option 2 (stop trace), and press the Enter key. Press F5=Refresh to verify that the trace has stopped.
                        Work with Communications Traces                        
                                                                               
 Type options, press Enter.                                                    
   2=Stop trace        4=Delete trace    6=Format and print trace              
   7=Display message   8=Restart trace                                          
                                                                               
       Configuration                                                            
 Opt   Object          Type   Trace Description      Protocol   Trace Status    
  2     ETHLINE        LINE   TCP/IP PRINTER TRACE   ETHERNET   ACTIVE          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit    F5=Refresh      F6=Start trace    F10=Change size                  
 F11=Display buffer size    F12=Cancel                                          
11Select Option 6 (format and print trace), and press the Enter key.
                        Work with Communications Traces                        
                                                                               
 Type options, press Enter.                                                    
   2=Stop trace        4=Delete trace    6=Format and print trace              
   7=Display message   8=Restart trace                                          
                                                                               
       Configuration                                                            
 Opt   Object          Type   Trace Description      Protocol   Trace Status    
  6     ETHLINE        LINE   TCP/IP PRINTER TRACE   ETHERNET   STOPPING        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit    F5=Refresh      F6=Start trace    F10=Change size                  
 F11=Display buffer size    F12=Cancel                                      
12aIf a Remote Output Queue (RMTOUTQ), a *LAN 3812 device description, or a printer emulation session (such as PC5250) is being traced, set the data representation to 1 (ASCII).

If a *LAN *IPDS device description is being traced, set the data representation to 2 (EBCDIC).

Note: If unsure whether to set the data representation to 1 (ASCII) or 2 (EBCDIC), consult with your Rochester Support Center representative before continuing.
12bSet the format broadcast data to N for No.
Set the TCP/IP data only to Y for Yes.
Leave everything else set to the default settings.
Press the Enter key.
                           Format Trace Data                                    
                                                                               
 Configuration object   . . . . :   ETHLINE                                    
 Type   . . . . . . . . . . . . :   LINE                                        
                                                                               
 Type choices, press Enter.                                                    
                                                                               
   Controller . . . . . . . . . .   *ALL        *ALL, name                      
                                                                               
   Data representation  . . . . .   1           1=ASCII, 2=EBCDIC, 3=*CALC      
                                                                               
   Format RR, RNR commands  . . .   N           Y=Yes, N=No                    
   Format Broadcast data  . . . .   N           Y=Yes, N=No                    
   Format UI data only  . . . . .   N           Y=Yes, N=No                    
   Format SNA data only . . . . .   N           Y=Yes, N=No                    
   Format TCP/IP data only  . . .   Y           Y=Yes, N=No                    
                                                                               
   Select Ethernet data . . . . .   3           1=802.3, 2=ETHV2, 3=Both        
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit     F5=Refresh      F12=Cancel                                        
                                                                               
13If the TCP/IP address was already specified for the printer when starting the trace, leave the IP address set to *ALL. Otherwise, set the IP address to the TCP/IP address for the printer. Press the Enter key to print the communications trace.
                          Select IP addresses to format                        
                                                                               
 Configuration object   . . . . :   ETHLINE                                    
 Type   . . . . . . . . . . . . :   LINE                                        
                                                                               
 Type choices, press Enter.                                                    
                                                                               
   IP address . . . . . . . . . .   192.168.2.123    *ALL, address              
                                                                               
   IP address . . . . . . . . . .   *ALL             *ALL, address              
                                                                               
   Port . . . . . . . . . . . . .   *ALL             *ALL, 1-65535              
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit     F5=Refresh      F12=Cancel                          
14If successful, a message is shown at the bottom of the screen that states, Format of trace data complete. Exit SST, and display or print the resulting spooled file.
                                           Format Trace Data                                    
                                                                               
 Configuration object   . . . . :   ETHLINE                                    
 Type   . . . . . . . . . . . . :   LINE                                        
                                                                               
 Type choices, press Enter.                                                    
                                                                               
   Controller . . . . . . . . . .   *ALL        *ALL, name                      
                                                                               
   Data representation  . . . . .   1           1=ASCII, 2=EBCDIC, 3=*CALC      
                                                                               
   Format RR, RNR commands  . . .   N           Y=Yes, N=No                    
   Format Broadcast data  . . . .   N           Y=Yes, N=No                    
   Format UI data only  . . . . .   N           Y=Yes, N=No                    
   Format SNA data only . . . . .   N           Y=Yes, N=No                    
   Format TCP/IP data only  . . .   Y           Y=Yes, N=No                    
                                                                               
   Select Ethernet data . . . . .   3           1=802.3, 2=ETHV2, 3=Both        
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit     F5=Refresh      F12=Cancel                                        
 Format of trace data complete                        
15Use one of the following options to find and send in the spooled file:

oThe resulting QPCSMPRT spooled file can be found by using the Work with Job (WRKJOB) command and taking Option 4 (Work with spooled files) or by using the following WRKJOB command with the Option (OPTION) parameter set to *SPLF:

WRKJOB JOB(*) OPTION(*SPLF)

After the QPCSMPRT spooled file has been found, it can then be printed, faxed through Facsimile Support/400 (FAX/400), or converted to PDF format and emailed through IBM Infoprint Server.
oThe QPCSMPRT spooled file can also be found within IBM iSeries Navigator or Operations Navigator by going into the Basic Operations > Printer Output container and bringing up the Printer Output - Include dialog box. Set the User to same user profile used to collect the trace (or to Current user if you were signed on with your own user profile), set everything else to All, and then click on the OK button.

After the QPCSMPRT spooled file has been found, it can be copied to the PC by dragging it to the Microsoft Windows Desktop or to a folder within Windows Explorer.

Note: To bring up the Printer Output - Include dialog box when using R520 iSeries Access for Windows, select View > Customize this View > Include... on the iSeries Navigator menu bar or press the F11 key. To bring up the Printer Output - Include dialog box when using R510 Client Access Express for Windows, select Options > Include... on the Operations Navigator menu bar. For more information, refer to the following Rochester Support Center knowledgebase document:

N1019300: Copying the Text from a Spooled File Using System i Navigator
16It is strongly recommended that the communications trace be left on the on the system just in case the Rochester Support Center must print the trace again using different options. However, when the trace is no longer required, go back into SST, select Option 4 (delete trace), and press the Enter key.
                               Work with Communications Traces                        
                                                                               
 Type options, press Enter.                                                    
   2=Stop trace        4=Delete trace    6=Format and print trace              
   7=Display message   8=Restart trace                                          
                                                                               
       Configuration                                                            
 Opt   Object          Type   Trace Description      Protocol   Trace Status    
  4     ETHLINE        LINE   TCP/IP PRINTER TRACE   ETHERNET   STOPPED        
                                                                               
                                                                               
                                                                               
                                                                               -----------------
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
 F3=Exit    F5=Refresh      F6=Start trace    F10=Change size                  
 F11=Display buffer size    F12=Cancel                                          
                                                                             

[{"Product":{"code":"SWG60","label":"IBM i"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"Print","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"5.4.5;6.1;6.1.1;7.1;5.1.0;5.2.0;5.3.0;5.3.5;5.4.0;6.1.0;7.1.0","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}},{"Product":{"code":"SSC3X7","label":"IBM i 6.1"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":" ","Platform":[{"code":"","label":null}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSC52E","label":"IBM i 7.1"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":" ","Platform":[{"code":"","label":null}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}}]

Historical Number

24001353

Document Information

Modified date:
18 December 2019

UID

nas8N1019451