Troubleshooting
Problem
This document provides step-by-step instructions on how to change the TCP/IP address in a Remote Output Queue (RMTOUTQ) when the IP address is being changed in the printer hardware.
This document also provides information on creating or changing a host table entry and how to change a RMTOUTQ to specify a host name rather than specifying an IP address.
This document also provides information on creating or changing a host table entry and how to change a RMTOUTQ to specify a host name rather than specifying an IP address.
Diagnosing The Problem
- Remote Output Queues (RMTOUTQs) can be configured to specify a host name in the Remote system (RMTSYS) parameter or a TCP/IP address in the Internet address (INTNETADR) parameter (which requires setting the RMTSYS parameter to *INTNETADR). If they are configured to specify an IP address, then the IP address specified in the RMTOUTQ must to be changed whenever the IP address is changed in the printer or print server hardware.
Step-by-step instructions for changing the IP address in a RMTOUTQ are provided in the section titled Changing the TCP/IP Address Specified in a Remote Output Queue (RMTOUTQ).
- RMTOUTQs can instead be configured to specify a host name rather than an IP address, and that host name can either be defined in a host table entry on the IBM i or on a DNS or DHCP server on the Local Area Network (LAN).
Step-by-step instructions for changing a RMTOUTQ to use a host name are provided in the section titled Changing a Remote Output Queue (RMTOUTQ) to Use a Host Name instead of a TCP/IP Address.
- If the host name is to be defined on the IBM i, then refer to the section titled Creating a Host Table Entry for use with a Remote Output Queue (RMTOUTQ), which provides step-by-step instructions for creating a host table entry for the IP address.
- If the IP address is changed in the printer or print server hardware, then follow the instructions in the section titled Deleting and Recreating a Host Table Entry with a new TCP/IP Address, which provides step-by-step instructions for deleting the host table entry and creating a host table entry for the new IP address.
- If the host name is defined on a DNS or DHCP server, then anytime the IP address is changed in the printer or print server hardware, the host name should be updated in the DNS or DHCP server. In this case, no change is needed in the RMTOUTQ settings. However, you may find that the remote writer needs to be ended and restarted, or you may need to use the Verify TCP/IP Connection (VFYTCPCNN or PING) command to verify that the IBM i is able to resolve to the correct IP address using the host name.
Note: Starting in V6R1M0 and PTF SI31363, the Remote system (RMTSYS) parameter can be set to host name, an IPV4 TCP/IP address or an IPV6 TCP/IP address. In this case, the RMTSYS parameter setting of *INTNETADR and the Internet address (INTNETADR) parameter are obsolete, though they can still be specified because support for RMTSYS(*INTNETADR) and the INTNETADR is being maintained for compatibility with previous releases.
Resolving The Problem
- Changing the TCP/IP Address Specified in a Remote Output Queue (RMTOUTQ)
If the RMTOUTQ is configured to use a host name, no change to the output queue description is necessary. After the TCP/IP address is changed in the printer hardware, change the TCP/IP address in the corresponding host table, DNS Server, or DHCP Server. Then, end and start the remote writer again.
If the RMTOUTQ is configured with the RMTSYS parameter set to *INTNETADR and a TCP/IP address specified in the INTNETADR parameter, the RMTOUTQ does not need to be deleted and re-created. It can instead be changed to point to a new IP address by doing the following:
If the RMTOUTQ is configured with the RMTSYS parameter set to *INTNETADR and a TCP/IP address specified in the INTNETADR parameter, the RMTOUTQ does not need to be deleted and re-created. It can instead be changed to point to a new IP address by doing the following:
|
1.
|
Use the End Writer (ENDWTR) command to end the writer, for example: ENDWTR WTR(rmtoutq-name) If a spooled file is sitting in SND (Sending) status on the output queue because the IP address has already been changed in the printer or print server hardware, then set the When to end writer (OPTION) parameter to *IMMED to force the writer to end without first processing the spooled file that is waiting to be sent. For example: ENDWTR WTR(rmtoutq-name) OPTION(*IMMED) Note: The writer can also be ended by doing a "WRKWTR WTR(*ALL)", typing Option 4 (End) next to the writer and pressing the F4 (Prompt) Key, setting the When to end writer (OPTION) parameter to *IMMED, and then pressing the Enter key. |
| 2. | Change the TCP/IP address in the printer hardware, then verify that the system is able to successfully ping the new printer IP address by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS('new-printer-ip-address') |
| 3. | Use the Work with Output Queue Description (WRKOUTQD) command to display the output queue description, for example: WRKOUTQD OUTQ(library-name/rmtoutq-name) |
| 4. | Press the F13 (Change) Key to bring up the Change Output Queue (CHGOUTQ) command. |
| 5. | Press the F10 (Additional Parameters) Key, press the Page Down Key, and then press the Enter Key repeatedly until the Internet address (INTNETADR) parameter is displayed, set the Internet address (INTNETADR) parameter to specify the new printer IP address, and then press the Enter Key until the CHGOUTQ command is complete. Note: If running V6R1M0 with PTF SI31363, the printer IP address can be specified in the Remote system (RMTSYS) parameter rather than specifying it in the Internet address (INTNETADR) parameter. |
| 6. | If the RMTOUTQ has the Writers to autostart (AUTOSTRWTR) parameter set to 1, then the writer will be started automatically when the CHGOUTQ command is complete; otherwise, use the Start Remote Writer (STRRMTWTR) command to start the writer again. |
- Changing a Remote Output Queue (RMTOUTQ) to Use a Host Name instead of a TCP/IP Address
If the RMTOUTQ is currently configured to point directly to the printer or print server IP address, it can be changed to refer to a host name instead by doing the following:
| 1. | Use the End Writer (ENDWTR) command to end the writer, for example: ENDWTR WTR(rmtoutq-name) If a spooled file is sitting in SND (Sending) status on the output queue because the IP address has already been changed in the printer or print server hardware, then set the When to end writer (OPTION) parameter to *IMMED to force the writer to end without first processing the spooled file that is waiting to be sent. For example: ENDWTR WTR(rmtoutq-name) OPTION(*IMMED) Note: The writer can also be ended by doing a "WRKWTR WTR(*ALL)", typing Option 4 (End) next to the writer and pressing the F4 (Prompt) Key, setting the When to end writer (OPTION) parameter to *IMMED, and then pressing the Enter key. |
| 2. | Change the TCP/IP address in the printer hardware, then verify that the system is able to successfully ping the new printer IP address by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS('new-printer-ip-address') |
| 3. | a) If the host name has been setup on a DNS or DHCP server, verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) b) If the name is to be configured on the IBM System i, follow the instructions in the section titled Creating a Host Table Entry for use with a Remote Output Queue (RMTOUTQ) below, then verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) |
| 4. | Use the Work with Output Queue Description (WRKOUTQD) command to display the output queue description, for example: WRKOUTQD OUTQ(library-name/rmtoutq-name) |
| 5. | Press the F13 (Change) Key to bring up the Change Output Queue (CHGOUTQ) command. |
| 6. | Set the Remote system (RMTSYS) parameter to the host name configured for the printer or print server, and then press the Enter Key until the CHGOUTQ command is complete. Note: If running V6R1M0 with PTF SI31363, the printer IP address can be specified in the Remote system (RMTSYS) parameter rather than specifying it in the Internet address (INTNETADR) parameter. |
| 7. | If the RMTOUTQ has the Writers to autostart (AUTOSTRWTR) parameter set to 1 then the writer will be started automatically when the CHGOUTQ command is complete; otherwise, use the Start Remote Writer (STRRMTWTR) command to start the writer again. |
- Creating a Host Table Entry for use with a Remote Output Queue (RMTOUTQ)
A host table entry can be created through the Configure TCP/IP (CFGTCP) command by doing the following:
| 1. | Type the Configure TCP/IP (CFGTCP) command and take Option 10 (Work with TCP/IP host table entries). | |
| 2. | Type Option 1 (Add) on the top entry, type the printer or print server IP address in the Internet Address field and then press the Enter key. | |
| 3. | Type the printer host name in the Host names (HOSTNAME) parameter. Type a Plus Sign ("+") in the "+ for more values" field if multiple host names will be assigned to this IP address (such as specifying "ibm6400" and "ibm6400.mycompany.com"). | |
| 4. | Type a description in the Text 'description' (TEXT) parameter, if desired. | |
| 5. |
|
|
| 6. | Verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) |
Or, you can do the following:
| 1. | Create the host table entry by using the Add TCP/IP Host Table Entry (ADDTCPHTE) command, for example: ADDTCPHTE INTNETADR('new-printer-ip-address') HOSTNAME((printer-host-name)) TEXT('Description of host name') |
| 2. | Verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) |
- Deleting and Re-creating a Host Table Entry with a new TCP/IP Address
Host table entries on an IBM System i are defined by IP address, not host name. Therefore, if the IP address is changed in the printer or print server hardware and a host name is defined on the IBM i, then the host table entry must be deleted for the old TCP/IP address and then re-created for the new TCP/IP address. This can be done through the Configure TCP/IP (CFGTCP) command by doing the following:
| 1. | Type the Configure TCP/IP (CFGTCP) command and take Option 10 (Work with TCP/IP host table entries). |
| 2. | Press the Page Down Key or press the F17 (Position to) key to position to the host table entry for the old TCP/IP address. |
| 3. | Type Option 4 (Remove) on the host table entry, and press the Enter key to remove it. |
| 4. | Type Option 1 (Add) on the top entry, type the printer or print server IP address in the Internet Address field and then press the Enter key. |
| 5. | Type the printer host name in the Host names (HOSTNAME) parameter. Type a Plus Sign ("+") in the "+ for more values" field if multiple host names will be assigned to this IP address (such as specifying "ibm6400" and "ibm6400.mycompany.com"). |
| 6. | Type a description in the Text 'description' (TEXT) parameter, if desired. |
| 7. | Press the Enter key, and verify that the host table entry has been created. |
| 8. | Verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) |
Or, you can do the following:
| 1. | Remove the host table entry using the Remove TCP/IP Host Table Entry (RMVTCPHTE) command, for example: RMVTCPHTE INTNETADR('old-printer-ip-address') |
| 2. | Create the host table entry by using the Add TCP/IP Host Table Entry (ADDTCPHTE) command, for example: ADDTCPHTE INTNETADR('new-printer-ip-address') HOSTNAME((printer-host-name)) TEXT('Description of host name') |
| 3. | Verify that the system is able to successfully ping the printer host name by using the Verify TCP/IP Connection (VFYTCPCNN or PING) command, for example: PING RMTSYS(printer-host-name) |
References:
For more information on configuring a Remote Output Queue (RMTOUTQ), please refer to the following document: Configuring a Remote Output Queue (RMTOUTQ)
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CJHAA2","label":"Print-\u003EPrinter Configurations-\u003ERemote Output Queue"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
More support for:
IBM i
Component:
Print->Printer Configurations->Remote Output Queue
Software version:
All Versions
Operating system(s):
IBM i
Document number:
643227
Modified date:
31 December 2024
UID
nas8N1018705
Manage My Notification Subscriptions