ELowell at 22:49, 12 July 2016

2016-07-12T22:49:49Z

← Older revision		Revision as of 22:49, 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:01, 11 July 2016

2016-07-11T22:01:21Z

← Older revision		Revision as of 22:01, 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 IFENQL call (ENQUEUE LIST) enqueues that set of records on the specified list.

Thread type

single cursor IFST..."

2016-07-06T23:09:56Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFENQL call (ENQUEUE LIST) enqueues that set of records on the specified list. </dd> <dt>Thread type</dt> <dd>single cursor IFST..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFENQL call (ENQUEUE LIST) enqueues that set of records on the specified list. </dd>
<dt>Thread type</dt>
<dd>single cursor IFSTRT thread</dd>
<dt>IFCALL function number</dt>
<dd>40</dd>
</dl>

==Syntax==
IFENQL(RETCODE,LIST_NAME,ACTION,TIME)
<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

Specify the parameters in the syntax order shown above.
<table>
<tr class="head">
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>LIST_NAME</td>
<td>[I,c,r] The list name is a required input parameter that specifies the name of a list. Specify the list as a character string.</td>
</tr>
<tr>
<td>ACTION</td>
<td>[I,i,r] The action is a required input parameter that specifies whether to enqueue on the set of records in share or exclusive mode. Specify one of the following integer values:
1 = Enqueues in share mode 
2 = Enqueues in exclusive mode 
</td>
</tr>
<tr>
<td>TIME</td>
<td>[I,i,r] The time is a required input parameter. Specify an integer value that is the number of times to retry; the wait time is in three-second periods.</td>
</tr>
</table>

==Usage notes==

On a single cursor IFSTRT thread, a subsequent call to IFPROL places the current record on the list and enqueues on the record itself with the status specified for the list. On a single cursor IFSTRT thread, a subsequent call to IFRRFL removes the record from the list and dequeues it.

On a single cursor IFSTRT thread, a call to IFLIST following a call to IFENQL dequeues the set of records currently on the list, clears the list, and places the current set on it with no enqueuing.
Note: Calls to [[IFLIST (HLI function)|IFLIST]], [[IFPROL (HLI function)|IFPROL]], and [[IFRRFL (HLI function)|IFRRFL]] do not perform any enqueuing operations if IFENQL has not first been executed.

If a call to IFENQL results in an enqueuing conflict, Model 204 waits at most three seconds and then tries again, for as many times as specified in the time parameter (the wait time is in three-second periods). After trying unsuccessfully for the number of times indicated in the time parameter, Model 204 returns a completion code of 3 to the HLI program.

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 ARGS-FOR-CALL.
05 RETCODE PIC 9(5) COMP SYNC.
05 LISTNAME PIC X(9) VALUE "CARSLIST;".
05 ACTION PIC 9(5) COMP SYNC VALUE 1.
05 TIME PIC 9(5) COMP SYNC VALUE 5.
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFENQL" USING RETCODE, LISTNAME, ACTION, TIME. 

[[Category: HLI functions]]

IFENQL (HLI function) - Revision history

ELowell at 22:49, 12 July 2016

ELowell at 22:01, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFENQL call (ENQUEUE LIST) enqueues that set of records on the specified list. Thread type single cursor IFST..."

ELowell: Created page with " ==Summary==

Description

The IFENQL call (ENQUEUE LIST) enqueues that set of records on the specified list.

Thread type

single cursor IFST..."