End CICS User (ENDCICSUSR)

The end CICS user (ENDCICSUSR) command shuts down a CICS shell and specifies what happens to active work being processed by that CICS shell.

Only the OS/400 job associated with the CICS shell is ended; the underlying OS/400 job will still be active. As an example, if an OS/400 user issued the STRCICSUSR command from the main menu, and then issued ENDCICSUSR from another OS/400 session, the OS/400 session that was used to issue the STRCICSUSR would be returned to the main menu.

Parameters

Keyword	Description	Choices	Notes
JOB	Job name	Qualified job name	Required, Positional 1
	Qualifier 1: Job name	Name
	Qualifier 2: User	Name
	Qualifier 3: Number	000000-999999
CTLRGN	Control region	Communications name	Required, Positional 2
OPTION	How to end	CNTRLD, IMMED	Optional, Positional 3
DELAY	Delay time, if *CNTRLD	1-99999, 30	Optional, Positional 4

Top

Job name (JOB)

The name of the OS/400 job associated with the CICS shell that is to be shut down. If no CICS shell job qualifier is given, all of the OS/400 jobs currently in the OS/400 are searched for the simple OS/400 job name. If more than one of the specified OS/400 job names is found, a message is issued and a qualified OS/400 job name must be specified.

The possible JOB values are:

job-name: The name of the OS/400 job associated with the CICS shell that is to be shut down.
user-name: The name of the OS/400 user associated with the CICS shell that is to be shut down.
job-number: The number of the OS/400 job that is associated with the CICS shell that is to be shut down.

Control region (CTLRGN)

The name of the CICS control region associated with the CICS shell. The name of the control region is also known as the CICS system ID.

control-region: The length is four characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or $, @, or #.

How to end (OPTION)

Identifies the method used to shut down the CICS shell.

The possible OPTION values are:

*CNTRLD: The CICS shell will be shut down if it is idle or when the CICS transaction that is currently being executed is completed.
*IMMED: The CICS shell is shut down immediately. Any CICS transaction that is being executed is not allowed to perform any cleanup. This option might cause undesirable results and, therefore, should be used only after a controlled shutdown has been unsuccessful.

Delay time, if *CNTRLD (DELAY)

Indicates the amount of time (in seconds) that is allowed to complete the controlled CICS shell shutdown. If this amount of time is exceeded and the CICS shell shutdown is not complete, the CICS shell is shut down immediately.

time-delay: Valid values are in the range 1 through 99999.