Midrange News for the IBM i Community

Convert Output Queues to Remote OutQ Published by: Bob Cozzi on 19 Apr 2012 view comments

CVTOUTQRMT - Convert Output Queues to Remote OutQ

The CVTOUTQRMT command transforms an existing output queue into a Remote Output queue. The remote outq will be the same name as the output being changed. That is if the local output queue name is MYPRINT in QUSRSYS, the RMTPRTQ parameter is set to RMTPRTQ('QUSRSYS/MYPRINT').

This command is primarily used when migrating from one system to another where you want to transfer the existing SPOOL Files to the new system. CVTOUTQRMT will convert the existing Output Queues into Remote Output Queues so that the system will automatically send the SPOOL files to the new system.

You can convert a single output queue, a list of output queues using a generic name, or all output queues in the library specified. The library parameter is also as flexible, in that it supports an actual library name, *LIBL, *ALLUSR, *CURLIB, *USRLIBL, or *ALL.

To use CVTOUTQRMT, type the command on the Command line, then press F4 to prompt it. You will see a display similar to the following:

SENDOBJ Prompter 1 or 2

The OUTQ parameter can be a single output queue name, a generic name, or *ALL. Virtually any library value that is supported by the DSPOBJD command is supported by the OUTQ parameter of the CVTOUTQRMT command. The outq names are used when changing the outq to a remote outq. The RMTPRTQ parameter is set to RMTPRTQ('outqLib/outqName') where OUTQLIB is the name of the library containing the output queue and OUTQNAME is the output queue's name.

The RMTSYS parameter accepts an entry from your system's DNS, HOSTS table, or an IP address. This is the remote system assigned to the RMTSYS atribute for the output queue when it is changed into a Remote Output Queue.

The STATUS parameter indicates if the OUTQ should be held or released after it is transformed into a remote output queue. In order to change the output queue to a remote outq, CVTOUTQRMT holds the outq temporarily. If STATUS(*HOLD) is specified, the outq remains held after the conversion is performed. If STATUS(*RLS) is specified, the outq is released after the conversion is performed.

The OMIT parameter allows you to identify up to 300 output queue names to omit from the command. For example, if you need to convert all the output queues in the QUSRSYS library to remote output queues, and specify OMIT(Q*) for the OMIT parameter, all output queues in QUSRSYS except those that start with the letter "Q" are converted.

The CVTOUTQRMT command is part of the COZTOOLS library available for public beta testing beginning May 1st, 2012 and becoming available for general use in early August.


  • IBM i v5r4 or later.

Components Included:

  1. CVTOUTQRMT - Command Definition Object
  2. CVTOUTQRMT - CL Command Processing Program

Return to midrangenews.com home page.
Sort Ascend | Descend