End RJE Session (ENDRJESSN)

End RJE Session

The ENDRJESSN command ends communications with the host subsystem in either a controlled or an immediate manner.

Error messages for ENDRJESSN

*ESCAPE Messages

RJE0003: RJE session &1 is not active.
RJE0063: RJE session &1 is already ending.
RJE0147: RJE did not find message file QRJEMSG.

Parameters

Keyword	Description	Choices	Notes
SSN	Active RJE session	Name	Required, Positional 1
OPTION	Cancel	CNTRLD, IMMED	Optional, Positional 2
DELAY	Delay time in sec, if *CNTRLD	0-99999, *NOLIMIT	Optional, Positional 3
IDLETIME	Idle time in minutes	0-99, 0	Optional

Top

Cancel (OPTION)

Specifies whether the session is ended in a controlled manner (allowing RJE to perform end processing), or it is canceled immediately.

The possible values are:

*CNTRLD: The session ends in a controlled manner. BSC sessions send a SIGNOFF command to the host subsystem before ending communications. When an end-of-file is received from the host subsystem for each active printer and punch device, and an end-of-file is sent to the host subsystem for each active reader job, RJE ends communications.
RJE continues to send and receive printer, punch, reader, and message data until the output and input streams are completed. A new SBMRJEJOB command request is honored until the idle time has elapsed. After that, reader job queues for the session are held.
*IMMED: The session ends immediately, meaning the programs that are running are not allowed to perform any cleanup. Reader job queues for the session are held. This option may cause undesirable results if data has been partially updated and, therefore, should be used only after a controlled ending has been attempted unsuccessfully.
Note: For BSC, the /*SIGNOFF command is not sent to the host subsystem. This will cause the session to end abnormally, and may result in the logging of error messages on the host.

Delay Time (DELAY)

Specifies the number of seconds allowed for the controlled ending. If the amount of time specified has passed and the end processing is not complete, the session being processed is ended immediately.

The possible values are:

*NOLIMIT: A controlled ending process has no time limit.
delay-time-in-seconds: Specify the number of seconds of delay time. Valid values range from 0 through 99999 seconds. When the delay time has elapsed, the end request is changed to an immediate end request. The delay time countdown begins when the command is processed.

Idle Time (IDLETIME)

Specifies the number of minutes the session remains idle before it ends in a controlled manner.

The possible values are:

0: The idle time value is zero. All reader job queues for the session are put on hold.
idletime-in-minutes: Specify the number of minutes that the session remains idle after the files are closed. The idle time countdown begins following the end-of-file of the last file that is sent or received, and is reset each time data becomes available for sending or receiving. If any input streams have started but not ended (except for console input streams), the idle time countdown does not begin. Valid values range from 0 through 99 minutes.

If an ENDRJESSN command specifies a controlled ending, its IDLETIME parameter overrides that of the session description. If it specifies an immediate ending, the IDLETIME value of the session description is ignored.