ENDCMNSVR (End Communications Server)

ENDCMNSVR Command syntax diagram

 

Purpose

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 iSeries 400 display station pass-through, iSeries 400 Client Access work station function (WSF), and other 5250 emulation programs on programmable workstations.

 

Restrictions

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

 

Optional Parameters

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

*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.

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.

*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.

Example for ENDCMNSVR

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 for ENDCMNSVR

None