The End Communications Server (ENDCMNSVR) command is used to end the target display station pass-through server. The target display station pass-through server processes display station pass-through, iSeries Access work station function (WSF), and other 5250 emulation programs on programmable workstations.

Restriction: You must have job control (*JOBCTL) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
OPTION	How to end	*CNTRLD, *IMMED	Optional
DELAY	Controlled end delay time	1-86400, *NOMAX	Optional

Top

How to end (OPTION)

Specifies whether the target display station pass-through server is ended in an immediate or controlled manner.

The possible values are:

*CNTRLD

The server is ended in a controlled manner. Active sessions are allowed to complete their processing. New sessions are not allowed. After the specified period of time elapses, the processing for ENDCMNSVR OPTION(*IMMED) is performed.

*IMMED

The server is ended in an immediate fashion. All active sessions that were started through the target display station pass-through server are ended immediately.

Controlled end delay time (DELAY)

Specifies the amount of time (in seconds) allowed in which to complete a controlled end of the target display station pass-through server. After this period of time all the target display station pass-through server jobs are ended immediately.

The possible values are:

*NOMAX

There is no maximum amount of time to wait. The servers will not end until all active sessions end normally.

delay-time

Specify the number of seconds in which the end operation is completed. Valid values range from 1 through 86400 seconds.

Examples

Example 1: Ending Target Display Station Pass-through Server

ENDCMNSVR

This command ends the target display station pass-through server in a controlled manner. Any active sessions that are using the target display station pass-through server are not affected. New sessions are not allowed through the target display station pass-through server. Once all of the active sessions have ended, the target display station pass-through server will end.

Error messages

None