Stopping the Session

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 16 Call Level Interface Functions : Stopping the Session – STOPSS

Stopping the Session – STOPSS

Syntax

For the syntax of all Call Level Interface functions, see Call Level Interface Specification and HRNHLLTM Module Parameters.

Calling Parameters

When your client program has no active streams, it stops the session by specifying STOPSS as the OPERATION parameter. All other parameters, except RETURN-DATA and RETURN-CODE, are null.

•

After stopping the session, the client program can subsequently start another session, possibly with different session parameters.

•

If no sessions exist, the client program can stop the Execution Environment.

Sample Code

COBOL Call

COPY HRNHLWAC

COPY HRNHLIST

.

.

CALL 'HRNHLLTM' USING HRNHLLWA 'STOPSS'

HRN-NULL-LIST HRN-NULL-LIST HRN-NULL-LIST HRN-NULL-LIST

HRN-RETURN-DATA HRN-RETURN-CODE.

.

Non Re-entrant Assembler Call

.

CALL HRNHLLTM,(HRNHLLWA,C'STOPSS',0, X

0,0,0,DATA,CODE),VL

.

.

DATA DS CL159 REASON CODE FROM HRNHLLTM

CODE DS F RETURN CODE FROM HRNHLLTM

Returned Values

Return Code

Description

0

STOPSS request succeeded.

9

STOPSS request failed. The first four bytes of the RETURN-DATA parameter are set to the reason code. Refer to Call Level Interface Reason Codes.

Return Code	Description
0	STOPSS request succeeded.
9	STOPSS request failed. The first four bytes of the RETURN-DATA parameter are set to the reason code. Refer to Call Level Interface Reason Codes.