JAL: add category

2018-04-20T21:03:25Z

add category

← Older revision		Revision as of 21:03, 20 April 2018
Line 86:		Line 86:
	.		.
	CALL "IFENQ" USING RETCODE, RESOURCE, ACTION, TIME. </p>		CALL "IFENQ" USING RETCODE, RESOURCE, ACTION, TIME. </p>

			[[Category: HLI functions]]

ELowell at 23:03, 6 July 2016

2016-07-06T23:03:59Z

← Older revision		Revision as of 23:03, 6 July 2016
Line 1:		Line 1:
	~~==IFENQ call -mc,sc==~~

	==Summary==		==Summary==

ELowell: Created page with "==IFENQ call -mc,sc== ==Summary==

Description

The IFENQ call (ENQUEUE) enqueues on the arbitrary resource name specified.

Thread type

mult..."

2016-07-06T23:03:35Z

Created page with "==IFENQ call -mc,sc== ==Summary== <dl> <dt>Description</dt> <dd>The IFENQ call (ENQUEUE) enqueues on the arbitrary resource name specified.</dd> <dt>Thread type</dt> <dd>mult..."

New page

==IFENQ call -mc,sc==

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFENQ call (ENQUEUE) enqueues on the arbitrary resource name specified.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>39</dd>
</dl>

==Syntax==
<p class="syntax">IFENQ(RETCODE,RESOURCE,ACTION,TIME)</p>
<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

<p>Specify the parameters in the syntax order shown above. </p>
<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>RESOURCE</td>
<td>[I,s,r] The resource is a required input parameter that specifies the name of the resource to be enqueued. Specify a short character string up to 32 characters in length. You can specify any data in the input string except for 32 bytes of binary zeroes.</td>
</tr>
<tr>
<td>ACTION</td>
<td>[I,i,r] The action is a required input parameter that specifies whether to enqueue on the named resource in share or exclusive mode. Specify one of the following integer values:
<p>1 = Enqueues in share mode </p>
<p>2 = Enqueues in exclusive mode </p>
</td>
</tr>
<tr>
<td>TIME</td>
<td>[I,i,r] The time is a required input parameter. Specify an integer value that is the wait time in seconds.</td>
</tr>
</table>

==Usage notes==
<p>All users share an internal enqueuing table and should develop standard resource naming conventions to make arbitrary resource enqueuing effective.</p>

==Completion return code (RETCODE)==
<p>
Model 204 returns the following completion codes for IFENQ:</p>
<table>
<tr class="head">
<th>Code</th>
<th>Condition</th>
</tr>
<tr>
<td>0</td>
<td>Resource was enqueued successfully.</td>
</tr>
<tr>
<td>3</td>
<td>Control of the requested resource could not be obtained within the specified time limit.</td>
</tr>
</table>
<p>
If the first attempt to enqueue on the specified resource fails, Model 204 waits the number of seconds specified in the time parameter, then tries again. If the second attempt to enqueue fails, Model 204 returns a completion code of 3 to the HLI program.</p>
<p>
For more information, see the [[ENQRETRY parameter]].</p>

==Coding example (COBOL)==
<p class="code">WORKING-STORAGE SECTION.
01 ARGS-FOR-CALL.
05 RETCODE PIC 9(5) COMP SYNC.
05 RESOURCE PIC X(9) VALUE "CUSTFILE;".
05 ACTION PIC 9(5) COMP SYNC VALUE 1.
05 TIME PIC 9(5) COMP SYNC VALUE 10.
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFENQ" USING RETCODE, RESOURCE, ACTION, TIME. </p>

IFENQ (HLI function) - Revision history

JAL: add category

ELowell at 23:03, 6 July 2016

ELowell: Created page with "==IFENQ call -mc,sc== ==Summary== Description The IFENQ call (ENQUEUE) enqueues on the arbitrary resource name specified. Thread type mult..."

ELowell: Created page with "==IFENQ call -mc,sc== ==Summary==

Description

The IFENQ call (ENQUEUE) enqueues on the arbitrary resource name specified.

Thread type

mult..."