Convert OutQ to Remote OutQ (CVTOUTQRMT)

The Convert OutQ to Remote OutQ (CVTOUTQRMT) command converts one or more existing OUTQs (output queues) into a "remote outq". The remote OUTQ name will be the same as the local OUTQ and will be qualified to the remote system name specified on the RMTSYS parameter.

This command is intended to assist with migration efforts. When installing a new system, it is often desireable to move the existing SPOOL files from the old system to the new system. While the recommended method (as of v6r1 and later) is to use the SAVE/RESTORE commands, this may not always be possible due to tape compatibility issues or venue (location) of the new system, or perhaps time constraints.

This command allows you to convert all your existing OUTQs (on the old system) into remote OUTQs that point at the same output queue name on the new system. Then once your network connection has been established, start the writer and your SPOOL files will "move themselves" to the new system.

Parameters

Keyword	Description	Choices	Notes
OUTQ	OUTQ names to change to remote	Qualified object name	Required, Positional 1
	Qualifier 1: OUTQ names to change to remote	Generic name, name, *ALL
	Qualifier 2: Library	Name, LIBL, USRLIBL, CURLIB, ALL, *ALLUSR
RMTSYS	Remote System or IP	Character value	Required, Positional 2
HOLD	HOLD OUTQ after conversion	YES, NO	Optional, Positional 3
OMIT	OUTQ name(s) to omit	Single values: NONE Other values (up to 300 repetitions): Generic name, name, Q	Optional, Positional 4

Top

OUTQ names to change to remote (OUTQ)

Specify the name of the local OUTQ or *ALL to be converted to a remote output queue. Each output queue is located and passed to the RMTPRTQ parameter of the CHGOUTQ command. For example, if printer QPRINT in QUSRSYS is included, then output queue QPRINT in QUSRSYS is changed with the RMTPRTQ('QUSRSYS/QPRINT') parameter. In addition the RMTSYS parameter is included.

This is a required parameter.

Qualifier 1: OUTQ names to change to remote

*ALL: All local output queues are converted so they point to a remote output queue.
generic-name: Specify the generic name of the output queues to be converted to remote output queues.
name: Specify a specific output queue to be converted to a remote output queue.

Remote System or IP (RMTSYS)

Specifies the remote system associated with the remote output queue. This name is passed to the RMTSYS paramter of the CHGOUTQ command.

This is a required parameter.

character-value: Specify the <...>

Hold OUTQ after conversion (HOLD)

Specify the writer status after the output queue is changed to a remote output queue.

*YES: The remote output queue is held.
*NO: The remote output queue is released.

OUTQ name(s) to omit (OMIT)

Specifies output queue names to be omitted from the command/conversion.

Single values

*NONE: All output queues whose names match the OUTQ parameter are converted.

Other values (up to 300 repetitions)

Q*: Output Queues whose names beging with the letter "Q" are not converted. This is the default. To include "Q" output queues, remove this entry.
generic-name: Specify up to 300 generic output queue names to be omitted from the conversion process.
name: Specify up to 300 non-generic output queue names to be omitted from the conversion process.

Examples for CVTOUTQRMT

Example 1: Simple Command Example

 CVTOUTQRMT OUTQ(QUSRSYS/*ALL) RMTSYS(NEW720) STS(*HOLD) OMIT(Q*)

This command converts all output queues in the QUSRSYS library that do NOT begin with the letter "Q". The remote system is "NEW720" and the output queue status is HOLD(*YES). Under the covers, the following CHGOUTQ command is run for each OUTQ:

 >> CHGOUTQ QUSRSYS/MYOUTQ RMTSYS(NEW720) RMTPRTQ('QUSRSYS/MYOUTQ') HOLD(*YES)

The MYOUTQ name is a place holder for your actual OUTQ names.