ELowell at 23:04, 12 July 2016

2016-07-12T23:04:57Z

← Older revision		Revision as of 23:04, 12 July 2016
Line 1:		Line 1:
	The conventions used on this page are described in [[HLI: Function ~~call list~~#Function call notation conventions\|Function call notation conventions]].		The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell at 22:10, 11 July 2016

2016-07-11T22:10:19Z

← Older revision		Revision as of 22:10, 11 July 2016
Line 1:		Line 1:
			The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell: Created page with " ==Summary==

Description

The IFHNGUP call (HANGUP) ends an IFDIAL or IFDIALN connection.

Thread type

IFDIAL

IFCALL function number..."

2016-07-07T21:29:50Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFHNGUP call (HANGUP) ends an IFDIAL or IFDIALN connection.</dd> <dt>Thread type</dt> <dd>IFDIAL</dd> <dt>IFCALL function number..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFHNGUP call (HANGUP) ends an IFDIAL or IFDIALN connection.</dd>
<dt>Thread type</dt>
<dd>IFDIAL</dd>
<dt>IFCALL function number</dt>
<dd>8</dd>
</dl>

==Syntax==
IFHNGUP | IFHNGP(RETCODE,USER_RETCODE,URC_TYPE)
<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

<table>
<tr class="head">
<th>Parameter</th>
<th>Specifies</th>
</tr>
<tr>
<td>RETCODE [O,i,r]</td>
<td>Model 204 return code, the required output parameter. The code is a binary integer value.
If the IFHNGUP call is unsuccessful, Model 204 returns an error code of 100 which indicates that the connection was lost prior to the call.</td>
</tr>
<tr>
<td>USER_RETCODE [O,i,o]</td>
<td>

Model 204 return code for the current user. The code is a binary integer value and is output only.
</td>
</tr>
<tr>
<td>URC_TYPE [I,c,o]</td>
<td>Type of return code to return in USER_RETCODE.
Return values are: 
<ul>
<li>N for return code = 0 </li>
<li>O for highest Online value </li>
<li>B for highest batch value</li>
</ul>
</td>
</tr>
</table>

==Usage notes==

USER_RETCODE and URC_TYPE parameters are optional, however, if you enter one, you must enter both.

If the connection to Model 204 was lost prior to the call to IFHNGUP, the RETCODE value returned is 0. In this case, the USER_RETCODE value returns -1, indicating that it is unknown. If an IFDIAL application explicitly includes the LOGOUT command in the CCAIN stream, the connection is disconnected and a subsequent call to IFHNGUP returns an unknown USER_RETCODE.

Use the IFHNGUP call only with an IFDIAL connection. IFHNGUP ends a connection to the Model 204 SOUL facility that was established by a call to IFDIAL or IFDIALN. 

IFHNGUP issues an IFATTN call and then sends a LOGOUT command to ensure that the caller's session is terminated. 

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
.
.
.
PROCEDURE DIVISION.
OPEN-FILES.
OPEN INPUT...
CALL "IFDIAL"...
.
.
.
CLOSE-FILES.
.
.
.
CALL "IFHNGUP" USING RETCODE.

[[Category: HLI functions]]

IFHNGUP (HLI function) - Revision history

ELowell at 23:04, 12 July 2016

ELowell at 22:10, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFHNGUP call (HANGUP) ends an IFDIAL or IFDIALN connection. Thread type IFDIAL IFCALL function number..."

ELowell: Created page with " ==Summary==

Description

The IFHNGUP call (HANGUP) ends an IFDIAL or IFDIALN connection.

Thread type

IFDIAL

IFCALL function number..."