$E Lnnnn.xxn

Function

To stop the current transmission or receipt of a job or SYSOUT data over an NJE line and requeue the data for transmission at the appropriate node.

Syntax


>>-$E--+-Lnnnn.JRn-+--+------------+---------------------------><
       +-Lnnnn.JTn-+  +-,Lnnnn.JRn-+   
       +-Lnnnn.SRn-+  +-,Lnnnn.JTn-+   
       '-Lnnnn.STn-'  +-,Lnnnn.SRn-+   
                      '-,Lnnnn.STn-'

Parameters

Lnnnn.JRn: The job receiver on line nnnn currently receiving the job. The receiver sends a negative-close record to the transmitter and immediately queues the job for purge. The job is requeued for transmission at the transmitting node.
The $HASP543 message displays the results of this command.
Lnnnn.JTn: The job transmitter on line nnnn currently transmitting the job. The transmitter stops transmitting the job and then requeues it for transmission. The job is purged at the receiving node. A job can be put into HELD queue if it is restarted (using $E command) while being transmitted. For Job transmitters, any failure other than trying to acquire the matching JR device on the other side results in the job being held. Jobs that are held must be activated with the $A command.
The $HASP522 message displays the results of this command.
Lnnnn.SRn: The SYSOUT receiver on line nnnn currently receiving the SYSOUT data. The receiver sends a negative-close record to the transmitter and purges the data already received. The SYSOUT data is requeued for transmission at the transmitting node.
The $HASP543 message displays the results of this command.

Note: Only if the SR device has received and processed the NJHeader from the sending node, JES2 issues $HASP543. If a device is active, issuing the $E command will not cause JES2 to issue $HASP659. Instead, JES2 issues message $HASP000 OK if a permission to allocate stream is sent to the receiver device. If the NJHeader has not been read in to build a job structure on the SR side, issuing $E will not generate the $HASP543.
Lnnnn.STn: The SYSOUT transmitter on line nnnn currently transmitting the SYSOUT data. The transmitter stops transmitting the data and requeues it for transmission. The SYSOUT data is purged at the receiving node.
The $HASP532 message displays the results of this command.

Authority Required

This command requires device 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, SA32-0991.

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The individual parameter descriptions list the resulting messages.

Examples

 1   $e l2.st2

  JOB00005 $HASP532 MYJOB L2.ST2 RESTARTED

The line 2 SYSOUT transmitter 2 stops transmitting the SYSOUT data for the current job and requeues the data for transmission at a later time. The SYSOUT receiver deletes any data it has already received.

 2   $e l4.jr5

  JOB00005 $HASP543 MYJOB L4.JR5 DELETED

The line 4 job receiver 5 stops receiving data from the current job and immediately queues the job for purging. The job is requeued for transmission at the transmitting node.