Stops an HCON session and its associated resources.
e789cln [ -N LoginName ] [ -n SessionName [ SessionName ... ] ] [ -y ]
The e789cln command stops a Host Connection Program (HCON) session or sessions and cleans up the associated resources. The e789cln command is used to clean up Interprocess Communication (IPC) resources and session processes left after abnormal termination of an HCON session or sessions.
The e789cln command stops the e789x session process and removes the IPC queues associated with each session.
For each invocation of HCON (each execution of the e789 command, file transfer, or API), a shared memory segment is created or attached to. If all sessions associated with a given invocation of HCON are removed, the e789cln command removes the associated shared memory segment.
If all sessions associated with a given e789 process are removed, the e789cln command stops the e789 process as well.
The e789cln command removes only the IPC resources and session processes associated with the HCON sessions specified with the -n flag. If the -n flag is not specified, the e789cln command removes resources for all sessions initiated by the current user or the user designated by the -N flag.
The e789cln command requests confirmation before stopping the sessions, unless the -y flag is used.
- When a session terminates normally, the associated processes and IPC resources are removed by the hcondmn process, and the e789cln command is not needed.
- Either the current user or the user specified by the -N LoginName flag must be defined as an HCON user. Thus, a user with root user authority (who may or may not be an HCON user) can use the -N flag to remove sessions belonging to an HCON user. Nonroot authority users, however, can remove only their own sessions.
|Specifies the HCON user whose sessions are to be removed. A user with root user authority can use this flag to remove sessions belonging to any HCON user; nonroot users can remove only their own sessions. If the -N flag is not specified, the e789cln command removes sessions of the HCON user who invokes the command.
|-n SessionName[SessionName ...]
|Specifies one or more session names for which processes are to be removed. If multiple session names are specified, they should not be separated by spaces. For example, to remove sessions a and b , enter:
|Instructs the e789cln command to stop the specified sessions without requesting confirmation. If the -y flag is not used, the command awaits confirmation before stopping the specified sessions.
e789cln -n dThis command, after requesting and receiving confirmation, removes the current user's session d and all its associated processes.
e789cln -n qx -yThis removes the current user's sessions q and x and all their associated processes. The -y flag instructs the command not to wait for confirmation.
e789cln -N sally -n bAfter requesting and receiving confirmation, this command removes session b for user sally , along with all associated processes.
Note: This form of the e789cln command can be run only by user sally or by a user with root authority.
e789clnAfter requesting and receiving confirmation, this removes all sessions, with their associated processes, belonging to the current user.
e789cln -N michelAfter requesting and receiving confirmation, this removes all sessions, with their associated processes, for user michel .
Note: This form of the e789cln command can be run only by user michel or by a user with root authority.
|Contains the e789cln command.
The e789 command initiates HCON emulator sessions. The fxfer command transfers files between a local system and a host system connected by HCON.
HCON Processes describes the hcondmn subsystem.
Stopping Interrupted HCON Sessions with the e789cln Command.