e789cln Command

Purpose

Stops an HCON session and its associated resources.

Syntax

e789cln [ -N LoginName ] [ -n SessionName [ SessionName ... ] ] [ -y ]

Description

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.

Notes:

1. When a session terminates normally, the associated processes and IPC resources are removed by the hcondmn process, and the e789cln command is not needed.
2. 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.

Flags

e789cln -n ab

Examples

1. To remove a session for the current user, enter:

   e789cln -n d

   This command, after requesting and receiving confirmation, removes the current user's session d and all its associated processes.
2. To remove sessions q and x for the current user without having to confirm the removal, enter:

   e789cln -n qx -y

   This 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.
3. To remove session b for user sally , enter:

   e789cln -N sally -n b

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

4. To remove all sessions for the current user, enter:

   e789cln

   After requesting and receiving confirmation, this removes all sessions, with their associated processes, belonging to the current user.
5. To remove all sessions for HCON user michel , enter:

   e789cln -N michel

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

Files

Related Information

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.