$P CNVT - Prevent JES2 from converting jobs and shuts down conversion phase processing

Function

The $P CNVT stops the selection of new work by the JCL conversion phase and when all jobs have completed conversion, terminates the converter subtasks (in both the JES2 address space when JOBDEF INTERPRET=INIT and in the JES2CI address spaces when JOBDEF INTERPRET=JES).

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.

Processing considerations

$P CNVT stops all JES2 converters from selecting new work and shuts down all conversion subtasks on this member. This impacts all conversion processing (batch jobs, started tasks, and TSO logon). Highlighted message “$HASP2222 CNVT DRAINING” is displayed while JES2 is in this state and is removed when the $S CNVT command is processed. Message “$HASP2223 All converters drained” is issued when all the converter subtasks have shut down (in either the JES2 or JES2CI address space).

Once the HASP2223 message is displayed, all JES2 conversion processing has stopped and all converter PROCLIB data sets have been closed on this member. An installation could now safely compress a PROCLIB data set without concerns that it would impact a job that is actively converting.

The $DMEMBER command indicates whether a $P CNVT is in effect.

When the converter subtask is terminated via a $P CNVT, the load modules used by the converter (IEFVH1, IEFNB903, and IEFITSP) are removed from storage. When the converter subtasks are restarted after a $S CNVT, those modules are re-loaded. If service was applied to those modules (and LLA had be refreshed), then the updated versions of those modules are loaded.

Scope

Single member. The values are in effect for this member only.

Messages

The $HASP000 message indicates the command has been accepted.

The $HASP2222 message indicates that no jobs will be selected for execution on this member until a $S CNVT command is issued.

The $HASP2223 message indicates that all converter subtasks on this member have been shut down.