Step for creating client trace output

LPR trace output is sent to SYSOUT and can be displayed on the LPR client console. Figure 1 is a sample of an LPR trace created by way of TSO with the following command:

LPR soto.files(lpconfig) (p prt1 h 9.67.113.60 TRACE

Figure 1. Example of LPR trace output (Part 1 of 2)

EZB0915I Begin "LPR" to printer "prt1" at host "9.67.113.60"
 1 
EZB1057I Loaded translation table from "TCP31S.STANDARD.TC PXLBIN".
EZB0920I Requesting TCP/IP service at 96155 18:52:53
EZB0921I Granted TCP/IP service at 96155 18:52:53
EZB0922I Resolving 9.67.113.60 at 96155 18:52:53
EZB0924I Host 9.67.113.60 name resolved to 9.67.113.60 at 96155 18:52:53
EZB0925I TCP/IP turned on.
EZB0926I Host "MVSA" Domain "TCP.RALEIGH.IBM.COM" TCPIP Service Machine TCP31S
EZB0927I Trying to open with local port 721 to foreign host address 9.67.113.60
 2 
EZB0928I Connection open from local port 721 to foreign host address 9.67.113.60
EZB0961I Control file name is cfA827MVSA
EZB0962I Data file name is dfA827MVSA Port Number=721. Remote IP Addr=9.7.113.60
 3 
EZB0916I Sending command 2 argument: prt1  Port Number=721. Remote IP Addr=9.67.113.60
EZB0917I Command successfully sent  Port Number=721. Remote IP Addr=9.67.113.60
EZB1012I Receiving ACK Port Number=721. Remote IP Addr=9.6 7.113.60
EZB1013I ReceiveACK: TRUE for byte value 00 Port Number=721. Remote IP Addr=9.67.113.60
EZB0997I Byte size check starts at 96155 18:52:54
EZB0998I Byte size check ends at 96155 18:52:54
EZB0999I Send command starts at 96155 18:52:54 Port Number=721.   Remote IP Addr=9.67.113.60
 4 
EZB0916I Sending command 3 argument:7434 dfA827MVSA Port Number=721. Remote IP Addr=9.67.113.60
EZB0917I Command successfully sent Port Number=721. Remote IP Addr=9.67.113.60
 5 
EZB1012I Receiving ACK  Port Number=721. Remote IP Addr=9.67.113.60
 5 
EZB1013I ReceiveACK: TRUE for byte value 00 Port Number=721. Remote IP Addr=9.67.113.60
EZB1000I Send command ends at 96155 18:52:55 Port Number=721. Remote IP Addr=9.67.113.60
 6 
EZB1001I Send data starts at 96155 18:52:55  Port Number=721. Remote IP Addr=9.67.113.60
 6 
EZB1002I Send data ends at 96155 18:52:56 Port Number=721. Remote IP Addr=9.67.113.60
EZB1003I Send ACK starts at 96155 18:52:56 Port Number=721. Remote IP Addr=9.67.113.60
EZB1014I Sending ACK Port Number=721. Remote IP Addr=9.67. 113.60
 7 
EZB1015I ACK successfully sent Port Number=721. Remote IP Addr=9.67.113.60
EZB1004I Send ACK ends at 96155 18:52:56 Port Number=721. Remote IP Addr=9.67.113.60
EZB1012I Receiving ACK Port Number=721. Remote IP Addr=9.6 7.113.60
 8 
EZB1013I ReceiveACK: TRUE for byte value 00 Port Number=721. Remote IP Addr=9.67.113.60
 9 
EZB1009I Data file sent. Port Number=721. Remote IP Addr=9.67.113.60
EZB1011I Queuing control line "HMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "PTCPUSR4"
EZB1011I Queuing control line "JTCPUSR4.SOTO.FILES(LPCONFIG)"
EZB1011I Queuing control line "CMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "LTCPUSR4"

Figure 2. Example of LPR trace output (Part 2 of 2)

 10 
EZB1011I Queuing control line "fdfA827MVSA"
EZB1011I Queuing control line "UdfA827MVSA"
EZB1011I Queuing control line "NTCPUSR4.SOTO.FILES/LPCONFIG"
 11 
EZB0916I Sending command 2 argument: 153 cfA827MVSA Port Number=721.   Remote IP Addr=9.67.113.60
EZB0917I Command successfully sent Port Number=721. Remote IP Addr =9.67.113.60
EZB1012I Receiving ACK  Port Number=721. Remote IP Addr=9.6 7.113.60
 12 
EZB1013I ReceiveACK: TRUE for byte value 00 Port Number=721. Remote IP Addr=9.67.113.60
 13 
EZB1017I Control data sent Port Number=721. Remote IP Addr=9.67.113.60
EZB1014I Sending ACK Port Number=721. Remote IP Addr=9.67. 113.60
EZB1015I ACK successfully sent Port Number=721.   Remote IP Addr=9.67.113.60
EZB1012I Receiving ACK Port Number=721. Remote IP Addr=9.6 7.113.60
 14 
EZB1013I ReceiveACK: TRUE for byte value 00  Port Number=721. Remote IP Addr=9.67.113.60
 15 
EZB1018I Control file sent  Port Number=721. Remote IP Addr=9.67.113.60

Following are short descriptions of the numbered items in the trace:

1

Indicates the translation table used by the LPR client. In this print request, no translation tables were defined by the person submitting the request.

2

Indicates LPR port used to connect to the LPD server with the IP address 9.67.113.60. The LPR port range is from 721 through 731.

3

Indicates the LPR command sent to the LPD server identifying the name of the print queue where the output was sent. See RFC1179 for details on commands and subcommands issued between LPR and LPD.

4

Indicates the command that provided the LPD print server with the byte size (7434) and name of the data file (dfA827MVSA) that was sent.

The character string dfA indicates that this was a data file.
The number 827 was the three-digit job number that was randomly generated by the LPR client or specified in the LPR command using the JNUM option.
MVSA was the name of the host from which the print request came.

5

Indicates the client is waiting for the LPD server to acknowledge the sending command in item 4 . The message on the following line (TRUE (00)) indicates that the client received an acknowledgment. A FALSE message or any value other than zero terminates the LPR print request.

6

Indicates that the LPR client started and then stopped sending the data file.

7

Indicates that the LPR client notified the LPD server, by way of an acknowledgment, that the complete file was sent. The LPR client waits for the server to acknowledge receipt of the entire data file.

8

Indicates that the client received an acknowledgment from the server that the entire data field was received.

9

Confirms that the data file was sent to the LPD server.

10

Specifies one of the several control records sent by the LPR client. (The records are described in detail in RFC1179.) This control record is mandatory and represents the name of the data file created by the LPD server. The name is preceded by the filter specified on the LPR command. The letter f denotes the default filter.

11

Specifies the byte size (153) and the name of the control file (cfA827MVSA) that was sent.

12

Indicates that the LPD server received the command and expected the control file to be sent.

13

Indicates that the LPR client sent the control file and an acknowledgment that it finished sending the entire file. The last line in the block indicates that the client was waiting for an acknowledgment from the server.

14

TRUE (00) indicates that the client received an acknowledgment from the LPD server that the control file was received.

15

Confirms that the control file was sent to the LPD server. The job was then terminated.

Figure 3 is a sample LPR trace showing a print request in which the FILTER X option was specified on the LPR command. Since the LPD server does not support this type of filter, it rejects the print request. (For an example of an LPD trace that shows that this job was rejected, see Figure 2.) The LPR trace does not show an error because it can send a print request to non-IBM® LPDs that support other filters (for example, FILTER X). For detailed information about filters, see RFC1179 and to z/OS Communications Server: IP Configuration Reference.

The trace was produced using the following command issued through TSO by user ID TCPUSR4:

LPR test (p TIANNA h 9.67.113.60 filter x TRACE

Figure 3. Example of LPR trace with filter x option

 1 
EZB0915I Begin "LPR" to printer "TIANNA" at host "9.67.113.6  0"
EZB1057I Loaded translation table from "TCP31S.STANDARD.TCPXLBIN".
EZB0920I Requesting TCP/IP service at 96155 19:22:15
EZB0921I Granted TCP/IP service at 96155 19:22:15
EZB0922I Resolving 9.67.113.60 at 96155 19:22:15
EZB0924I Host 9.67.113.60 name resolved to 9.67.113.60 at 96155 19:22:15
EZB0925I TCP/IP turned on.
EZB0926I Host "MVSA" Domain "TCP.RALEIGH.IBM.COM" TCPIP Service Machine TCP31S
EZB0927I Trying to open with local port 721 to foreign host address 9.67.113.60
EZB0928I Connection open from local port 721 to foreign host address 9.67.113.60
⋮
 2 
EZB1009I Data file sent.  Port Number = 721.   Remote IP Addr  = 9.67.113.60
 3 
EZB1011I Queuing control line "HMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "PTCPUSR4"
EZB1011I Queuing control line "JTCPUSR4.TEST"
EZB1011I Queuing control line "CMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "LTCPUSR4"
 4 
EZB1011I Queuing control line "xdfA947MVSA"
EZB1011I Queuing control line "UdfA947MVSA"
EZB1011I Queuing control line "NTCPUSR4.TEST"
EZB0916I Sending command 2 argument: 122 cfA947MVSA  Port Number = 721. Remote IP Addr = 9.67.113.60
EZB0917I Command successfully sent  Port Number = 721. Remote IP Addr = 9.67.113.60
⋮
 5 
EZB1018I Control file sent  Port Number = 721. Remote IP Ad dr = 9.67.113.60

Following are short descriptions of the numbered items in the trace:

1: Indicates that the print request was issued to a printer named TIANNA at IP address 9.67.113.60.
2: Indicates that the data file was sent. The error was not recognized until the LPD server tried to process the print job. (See Figure 2.)
3: Indicates control commands sent to the LPD server. For details about these commands, see RFC1179.
4: Represents the name of the data file. The character string xdf indicates that the x filter was used.
5: Indicates that the control file was sent to the LPD server. The job was then terminated.

Figure 4 is a sample showing a print request using the following command lpr test (p njeSOTO host MVSA without the TRACE option. The output shows an error because the printer name was not entered entirely in capital letters.

Figure 4. Example of LPR output with unknown printer

 1 
EZB1006E Host MVSA did not accept printer name njeSOTO.
             Port Number = 721  Remote IP Addr = 9.67.113.60
 2 
EZB1049E Send printer command did not receive ACK.  ACK message = .
             Port = 721.   Remote IP Addr = 9.67.113.60

Following are short descriptions of the numbered items in the trace.

1: Indicates that a SERVICE statement for a printer named njeSOTO did not exist in the LPD server configuration file.
2: Indicates that the LPD server did not send a positive response to the LPR client. The job was then terminated.

Figure 5 is a sample LPR trace output produced with the following command the JNUM option and variable, along with the LANDSCAPE and TRACE options:

lpr test (p TIANNA host 9.67.113.60 JNUM 111 LANDSCAPE TRACE

The trace output shows the scanning that occurred to identify the first available port.

Figure 5. Example of LPR trace with JNUM, LANDSCAPE, and TRACE options

 1 EZB0988I PostScript program is 635 bytes
EZB0915I Begin "LPR" to printer "TIANNA" at host "9.67.113.60"
EZB1057I Loaded translation table from "TCP31S.STANDARD.TCPXLBIN".
EZB0920I Requesting TCP/IP service at 96155 19:35:12
EZB0921I Granted TCP/IP service at 96155 19:35:12
EZB0922I Resolving 9.67.113.60 at 96155 19:35:12
EZB0924I Host 9.67.113.60 name resolved to 9.67.113.60 at 96155 19:35:12
EZB0925I TCP/IP turned on.
EZB0926I Host "MVSA" Domain "TCP.RALEIGH.IBM.COM" TCPIP Service Machine TCP31S
 2 EZB0927I Trying to open with local port 721 to foreign host a ddress 9.67.113.60
EZB0927I Trying to open with local port 722 to foreign host address 9.67.113.60
EZB0927I Trying to open with local port 723 to foreign host address 9.67.113.60
EZB0927I Trying to open with local port 724 to foreign host address 9.67.113.60
 3 EZB0928I Connection open from local port 724 to foreign host  address 9.67.113.60
 4 EZB0961I Control file name is cfA111MVSA
EZB0962I Data file name is dfA111MVSA  Port Number = 724.   Remote I P Addr = 9.67.113.60
EZB0916I Sending command 2 argument: TIANNA  Port Number = 724.   Remote IP Addr = 9.67.113.60
⋮
EZB1009I Data file sent.  Port Number = 724.   Remote IP Addr = 9.67 .113.60
EZB1011I Queuing control line "HMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "PTCPUSR4"
EZB1011I Queuing control line "JTCPUSR4>TEST"
EZB1011I Queuing control line "CMVSA.TCP.RALEIGH.IBM.COM"
EZB1011I Queuing control line "LTCPUSR4"
 5 EZB1011I Queuing control line "fdfA111MVSA"
EZB1011I Queuing control line "UdfA111MVSA"
EZB1011I Queuing control line "NTCPUSR4.TEST"
EZB0916I Sending command 2 argument: 122 cfA111MVSA  Port Number = 7 24.

Following are short descriptions of the numbered items in the trace:

1: Indicates that the LPR client inserted a landscape header, written in postscript, at the beginning of the data file.
2: Indicates that the LPR client was attempting to use the first available client port. The port range for the LPR client is 721 through 731. If no ports are available, an error message is displayed.
3: Indicates that a connection was opened using port 724.
4: Indicates that the value specified for JNUM (111) was used to build the control and data file names.
5: Indicates the name of the file containing the three-digit job number that was used with the file name sent to the print server.

Following is a clipping of the header that was inserted into the data file. For more information about header files, see z/OS Communications Server: SNA Customization.

%!PS-Adobe-2.0
    614 25 translate 90 rotate .88 .76 scale /n 1 def /fs 10 def /ls 11. 2 def /ld l

Figure 6 is a sample of LPR trace output for the following command with the XLATE option:

LPR test (p TIANNA h MVSA trace xlate GXS

In this sample, the server was not running, so the connection was not established. For detailed information about using and creating your own translate tables, see z/OS Communications Server: SNA Customization

Figure 6. Example of LPR trace with XLATE option

EZB0915I Begin "LPR" to printer "TIANNA" at host "MVSA"
 1 
EZB1057I Loaded translation table from "TCPUSR4.GXS.TCPXLBIN" .
EZB0920I Requesting TCP/IP service at 96155 20:04:14
EZB0921I Granted TCP/IP service at 96155 20:04:15
 2 
EZB0922I Resolving MVSA at 96155 20:04:15
 3 
EZB0924I Host MVSA name resolved to 9.67.113.60 at 96155 20:0 4:17
EZB0925I TCP/IP turned on.
EZB0926I Host "MVSA" Domain "TCP.RALEIGH.IBM.COM" TCPIP Service Machine TCP31S
EZB0927I Trying to open with local port 721 to foreign host address 9.67.113.60
 4 
EZB1051E Failed to Open connection to Port Number = 515.  Return
             Code = -1.   Error Number = 61.  Port Number = 721.
             Remote IP Addr = 9.67.113.60

Following are short descriptions of the numbered items in the trace:

1: Indicates the name of the translation table used by the LPR client. To avoid problems such as errors and data corruption, be sure that the LPD server is using the equivalent code pages.
2: Indicates the time the LPR client started trying to resolve the specified host name. The LPR client checks the name server table, the site, and address information files to resolve the host name.
3: Indicates the amount of time the LPR client took to resolve the specified host name. To reduce the amount of time, use the host IP address instead of the host name.
4: Indicates that the connection was not established. (In this sample, the LPD server was not running.) For a list of error numbers and their definitions, see z/OS Communications Server: IP and SNA Codes.