IFCOUNT (HLI function) - Revision history

JAL: /* Usage notes */ link repair

2016-09-01T23:11:04Z

Usage notes: link repair

← Older revision		Revision as of 23:11, 1 September 2016
Line 53:		Line 53:
	<p>		<p>
	The IFCOUNT call is valid on <I>all</I> types of IFSTRT threads. You must specify the found set to be counted on a multiple cursor IFSTRT thread. On a single cursor IFSTRT thread, IFCOUNT returns the count for the set that is current. </p>		The IFCOUNT call is valid on <I>all</I> types of IFSTRT threads. You must specify the found set to be counted on a multiple cursor IFSTRT thread. On a single cursor IFSTRT thread, IFCOUNT returns the count for the set that is current. </p>
	<p class="note"><b>Note:</b> The count that is returned by the IFCOUNT call is written to the Model 204 audit trail if RK lines are written to the journal. For information about Model 204 journals and audit trails, see [[Tracking system activity]].</p>		<p class="note"><b>Note:</b> The count that is returned by the IFCOUNT call is written to the Model 204 audit trail if RK lines are written to the journal. For information about Model 204 journals and audit trails, see [[Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)\|Tracking system activity]].</p>

	==Coding example (COBOL)==		==Coding example (COBOL)==

ELowell at 22:07, 12 July 2016

2016-07-12T22:07:36Z

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

2016-07-11T21:08:44Z

← Older revision		Revision as of 21:08, 11 July 2016
Line 1:		Line 1:
	~~==IFCOUNT~~ call ~~-mc,sc==~~		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 "==IFCOUNT call -mc,sc== ==Summary==

Description

The IFCOUNT call (COUNT) counts the number of records in a found set or list and returns the record count in..."

2016-07-05T21:42:23Z

Created page with "==IFCOUNT call -mc,sc== ==Summary== <dl> <dt>Description</dt> <dd>The IFCOUNT call (COUNT) counts the number of records in a found set or list and returns the record count in..."

New page

==IFCOUNT call -mc,sc==

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFCOUNT call (COUNT) counts the number of records in a found set or list and returns the record count in an output parameter.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>14</dd>
</dl>

==Syntax==
IFCOUNT|IFCNT(RETCODE,COUNT,SET_QUAL)
<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>COUNT</td>
<td>[O,i,r] The count parameter is a required parameter that specifies the location of the output parameter for the return count value. Specify an integer variable. Model 204 returns the record count as a fullword binary number.</td>
</tr>
<tr>
<td>SET_QUAL</td>
<td>[I,c,r] The set qualifier is available only for use with a multiple cursor IFSTRT thread and it is required for specifying the record set or list whose records will be counted. Specify a character string using either one of the following formats:
{IN label | ON [LIST] listname}
where:

<var class="term">label</var> is the name of a saved IFFIND, IFFNDX, IFFWOL, or IFFAC compilation from the previously compiled call that established the record set. 

<var class="term">listname</var> specifies the name of a list.
Note: The set qualifier is not a valid parameter for use with a single cursor IFSTRT thread.
</td>
</tr>
</table>

==Usage notes==

Use the IFCOUNT call to count the records in a found set. IFCOUNT returns a value of 0 for a null set. You can use IFCOUNT after an IFFIND call having a completion code of 0 to check for a null set. 

The IFCOUNT call is valid on all types of IFSTRT threads. You must specify the found set to be counted on a multiple cursor IFSTRT thread. On a single cursor IFSTRT thread, IFCOUNT returns the count for the set that is current. 
Note: The count that is returned by the IFCOUNT call is written to the Model 204 audit trail if RK lines are written to the journal. For information about Model 204 journals and audit trails, see [[Tracking system activity]].

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 ARGS-FOR-CALL COMP SYNC.
05 RETCODE PIC 9(5).
05 COUNT PIC 9(5).
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFCOUNT" USING RETCODE, COUNT.

[[Category: HLI functions]]

IFCOUNT (HLI function) - Revision history

JAL: /* Usage notes */ link repair

ELowell at 22:07, 12 July 2016

ELowell at 21:08, 11 July 2016

ELowell: Created page with "==IFCOUNT call -mc,sc== ==Summary== Description The IFCOUNT call (COUNT) counts the number of records in a found set or list and returns the record count in..."

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

Description

The IFCOUNT call (COUNT) counts the number of records in a found set or list and returns the record count in..."