ELowell at 21:39, 2 May 2016

2016-05-02T21:39:37Z

← Older revision		Revision as of 21:39, 2 May 2016
Line 439:		Line 439:
	<p>		<p>
	For more information about how IFAM4 sets the job step return code, see [[HLI: Job requirements#IFAM4 jobs: Job errors and ABENDs\|IFAM4 jobs: Job errors and ABENDs]].</p>		For more information about how IFAM4 sets the job step return code, see [[HLI: Job requirements#IFAM4 jobs: Job errors and ABENDs\|IFAM4 jobs: Job errors and ABENDs]].</p>

			==See also==
			{{Template: HLI reference topic list}}

	[[Category: Host Language Interface]]		[[Category: Host Language Interface]]

ELowell at 19:07, 25 April 2016

2016-04-25T19:07:48Z

← Older revision		Revision as of 19:07, 25 April 2016
Line 2:		Line 2:
	==Overview==		==Overview==
	<p>		<p>
	This topic describes the completion codes that ~~may~~ be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:</p>		This topic describes the completion codes that might be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:</p>
	<ul>		<ul>
	<li>		<li>
Line 30:		Line 30:
	<tr class="head">		<tr class="head">
	<th>Code</th>		<th>Code</th>
	<th>~~Call(s)~~</th>		<th>Calls</th>
	<th>Description</th>		<th>Description</th>
	</tr>		</tr>
Line 141:		Line 141:
	<tr class="head">		<tr class="head">
	<th>Code</th>		<th>Code</th>
	<th>~~Call(s)~~</th>		<th>Calls</th>
	<th>Description</th>		<th>Description</th>
	</tr>		</tr>
Line 440:		Line 440:
	For more information about how IFAM4 sets the job step return code, see [[HLI: Job requirements#IFAM4 jobs: Job errors and ABENDs\|IFAM4 jobs: Job errors and ABENDs]].</p>		For more information about how IFAM4 sets the job step return code, see [[HLI: Job requirements#IFAM4 jobs: Job errors and ABENDs\|IFAM4 jobs: Job errors and ABENDs]].</p>

	[Category: Host Language Interface]		[[Category: Host Language Interface]]

ELowell: Created page with " ==Overview==
This topic describes the completion codes that may be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:<..."

2016-04-25T19:05:22Z

Created page with " ==Overview== This topic describes the completion codes that may be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:<..."

New page

==Overview==

This topic describes the completion codes that may be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:
<ul>
<li>
Return codes for HLI calls</li>
<li>
Job run ABEND codes</li>
</ul>

This topic presents the codes in the following tables: 
<ul>
<li>
[[#Completion return codes 0-3|Completion return codes 0-3]] lists completion codes that are returned by Model 204 to the host language application program for operations which completed normally, or with a warning. RETCODE is 0, 1, 2, and 3.</li>
<li>
[[#Completion return codes 4 and greater|Completion return codes 4 and greater]] lists completion codes that usually indicate that a call was unsuccessful. RETCODE is greater than or equal to 4.</li>
<li>
[[#Job run ABEND codes|Job run ABEND codes]] lists completion codes that are generated for severe errors that cause the HLI job run to abend. </li>
</ul>


For more information about individual completion return codes for conditions that are unique to a specific function call, refer to the usage notes for the particular call.

==Completion return codes 0-3==

The following table describes the completion codes that are returned by Model 204 to the host language application program for operations which completed normally, or with a warning. RETCODE is 0, 1, 2, and 3.
<table>
<caption>Completion return codes 0-3</caption>
<tr class="head">
<th>Code</th>
<th>Call(s)</th>
<th>Description</th>
</tr>
<tr>
<td rowspan="5" colspan="1">0</td>
<td>IFATTN</td>
<td>IFDIAL connection completed.</td>
</tr>
<tr>
<td>IFCHKPT</td>
<td>Checkpointing status depends on which function code is specified in the call:
<ul>
<li>Function code is 0: Checkpoint not currently in progress, parameter 3 unaltered.</li>
<li>Function code is 1: Checkpoint successfully initiated.</li>
<li>Function code is 3: Checkpoint successfully completed.</li>
</ul>
</td>
</tr>
<tr>
<td>IFDIAL 
IFDIALN
</td>
<td>IFDIAL connection established.</td>
</tr>
<tr>
<td>IFHNGUP</td>
<td>IFDIAL connection dropped.</td>
</tr>
<tr>
<td>All except IFCHKPT</td>
<td>Function completed successfully.</td>
</tr>
<tr>
<td rowspan="6" colspan="1">1</td>
<td>IFCHKPT</td>
<td>Checkpointing status depends on which function code is specified in the call:
<ul>
<li>Function code is 0: Checkpoint in progress, parameter 3 set to its ID.</li>
<li>Function code is 2: Checkpoint completed successfully, parameter 3 set to its ID.</li>
</ul>
</td>
</tr>
<tr>
<td>IFGET 
IFFTCH</td>
<td>Nonnumeric value could not be converted, or integer portion of the value is too large for output area. Errors may occur for B, P, F, and Z edit formats.</tr>
<tr>
<td>IFMORE</td>
<td>Nonnumeric value could not be converted, or integer portion of the value is too large for output area. Errors may occur for B, P, F, and Z edit formats.</td>
</tr>
<tr>
<td>IFREAD</td>
<td>Call IFWRITE next to provide Model 204 with input.</td>
</tr>
<tr>
<td>IFSTRT 
(IFAM1)</td>
<td>Illegal call. Thread already exists.</td>
</tr>
<tr>
<td>IFWRITE</td>
<td>Call IFWRITE next to provide Model 204 with input.</td>
</tr>
<tr>
<td rowspan="7" colspan="1">2</td>
<td>IFCHKPT</td>
<td>Checkpoint request timed out. Checkpoint not taken.</td>
</tr>
<tr>
<td>IFFLS</td>
<td>The file indicator was used to identify the file of the current record and no current record was found.</td>
</tr>
<tr>
<td>IFFTCH</td>
<td>Indicates no more records to fetch in the current set.</td>
</tr>
<tr>
<td>IFREAD</td>
<td>Call IFREAD next to get more output from Model 204.</td>
</tr>
<tr>
<td>IFRPRM and IFSPRM</td>
<td>TBO has been enabled or disabled for a file such that the group of files in the job violates the restriction that TBO files may not open for update while any non-TBO file is open on a read-only thread. The parameter reset was successful, but the M204.0498 error was issued and the file is closed.</td>
</tr>
<tr>
<td>IFWRITE</td>
<td>Call IFREAD next to get more output from Model 204.</td>
</tr>
<tr>
<td>Any other call</td>
<td>Indicates no records in the current set.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">3</td>
<td>IFCHKPT</td>
<td>Caller is not allowed to wait for checkpoints. Call ignored.</td>
</tr>
<tr>
<td>All except IFCHKPT</td>
<td>Return code number reserved for future use, or control of necessary resource could not be obtained and call may be reexecuted.</td>
</tr>
</table>

==Completion return codes 4 and greater==

The following table describes the completion codes which usually, but not always, indicate that a call was unsuccessful. RETCODE is greater than or equal to 4.
Note: The error message is written to the Model 204 journal and is available to the application program using the IFGERR call.
<table>
<caption>Completion return codes 4 and greater</caption>
<tr class="head">
<th>Code</th>
<th>Call(s)</th>
<th>Description</th>
</tr>
<tr>
<td>4</td>
<td>All calls</td>
<td>Error message has been produced. For more information about conditions that are unique to a specific function call, refer to the Notes for the particular call.
</tr>
<tr>
<td rowspan="2" colspan="1">5</td>
<td>IFCHKPT</td>
<td>Checkpoint not active during recovery. Call ignored.</td>
</tr>
<tr>
<td>Compiled IFAM calls</td>
<td>The name used by an E (execute) call has not been defined.</td>
</tr>
<tr>
<td>6</td>
<td>Compiled IFAM calls</td>
<td>The name used by an E (execute) call or standard compile and execute call has been defined by an incompatible function.

IFGET, IFMORE, and IFPUT specs can be shared, but they cannot be referred to by IFFIND calls. Similarly, IFFIND compilations cannot be referred to by IFGET-type calls. IFFIND and IFFNDX cannot share specs.
</td>
</tr>
<tr>
<td>7</td>
<td>Compiled IFAM calls</td>
<td>Not enough space exists to compile the current call. Error message indicates which server table is full. Use IFFLUSH to recover from this condition.

Many Host Language Interface calls not directly affected by the Compiled IFAM feature use space in QTBL and VTBL. These functions return a code of 4 if either table fills.
</td>
</tr>
<tr>
<td rowspan="2" colspan="1">10</td>
<td>IFBREC 
IFSTOR 
IFPUT 
IFUPDT</td>
<td>For an updating call where the FILEMODL file option is set to NUMERIC VALIDATION, Model 204 encountered invalid values for BINARY and FLOAT numeric field types. For more information about FILEMODL, see [[Field attributes#File model feature|File model feature]].

For information about binary and float values, see [[Data maintenance#Storing data in fields|Storing data in fields]].
</td>
</tr>
<tr>
<td>All calls</td>
<td>The function has been cancelled. The transaction is automatically backed out and control is returned to the application program.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">12</td>
<td>IFREAD and IFWRITE</td>
<td>IFREAD called when IFWRITE was expected, or IFWRITE called when IFREAD was expected.</td>
</tr>
<tr>
<td>IFREAD</td>
<td>No output ready from Model 204; call IFWRITE to provide more input. The answer area is not altered.</td>
</tr>
<tr>
<td>15</td>
<td>IFEFCC and IFERLC</td>
<td>An updating function received an error when there was no conflict to search for.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">40</td>
<td>IFBOUT</td>
<td>An IFBOUT was issued from a read-only thread. IFBOUT is only valid on update threads.</td>
</tr>
<tr>
<td>All calls</td>
<td>Function requires update privileges, but none were granted. Issue IFSTRT with thread update privileges and give file or group password with update privileges.</td>
</tr>
<tr>
<td>50</td>
<td>All calls (IFAM2 and IFAM4)</td>
<td>An updating function was issued on a thread which has been quiesced for checkpointing by a previous call to IFCHKPT.</td>
</tr>
<tr>
<td>60</td>
<td>All calls</td>
<td>No current file or group. Function cannot complete.</td>
</tr>
<tr>
<td>61</td>
<td>All calls</td>
<td>Function attempted against file or group with broken FISTAT setting. Function cannot complete.</td>
</tr>
<tr>
<td>80</td>
<td>All calls in IFAM1</td>
<td>No current thread.
<ul>
<li>For IFSTRT support, call IFSTRT.</li>
<li>For IFDIAL support, call IFSETUP.</li>
</ul>
</td>
</tr>
<tr>
<td rowspan="3" colspan="1">90</td>
<td>IFDIAL 
IFDIALN</td>
<td>An IFDIAL connection already exists for this application program. The attempt to establish more than one simultaneous connection for this application is ignored.</td>
</tr>
<tr>
<td>IFSTRT in IFAM1</td>
<td>Illegal call to IFSTRT. A thread already exists.</td>
</tr>
<tr>
<td>IFSTRT in IFAM2 and IFAM4</td>
<td>Model 204 is not yet available for user processing. Recovery may still be in progress. Call IFSTRT again.</td>
</tr>
<tr>
<td>95</td>
<td>IFDTHRD and IFSTHRD</td>
<td>Nonexistent new thread specified. Call ignored.</td>
</tr>
<tr>
<td>96</td>
<td>IFDTHRD</td>
<td>New thread is already current thread and thus is not detached.</td>
</tr>
<tr>
<td rowspan="7" colspan="1"> 100</td>
<td>in IFAM1</td>
<td>LOGIN failed.</td>
</tr>
<tr>
<td>in IFAM2 and IFAM4</td>
<td>No current thread exists. Call IFSTRT.</td>
</tr>
<tr>
<td>IFATTN</td>
<td>The connection was lost.</td>
</tr>
<tr>
<td>IFHNGUP</td>
<td>The connection was lost prior to call.</td>
</tr>
<tr>
<td>IFREAD</td>
<td>No current Model 204 connection exists or the connection is lost.</td>
</tr>
<tr>
<td>IFSTRT in IFAM2 and IFAM4</td>
<td>LOGIN failed.</td>
</tr>
<tr>
<td>IFWRITE</td>
<td>No current Model 204 connection exists or the connection is lost.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">101</td>
<td>IFDIAL in IFAM1</td>
<td>Invalid BATCH204 module loaded. Check STEPLIB for correct release.</td>
</tr>
<tr>
<td>IFSTRT in IFAM1</td>
<td>Failure to dynamically load the IFAM1 load module, because the entry point was specified incorrectly when relinking.</td>
</tr>
<tr>
<td>200</td>
<td>IFBREC 
IFPUT 
IFSTOR 
IFUPDT</td>
<td>A uniqueness violation has occurred (field level constraint). A UNIQUE violation corresponds to errors handled by ON FCC ON units in SOUL. For information about ON units, see [[Subroutines#On units 2|On units 2]].</td>
</tr>
<tr>
<td>202</td>
<td>IFPUT 
IFSTOR 
IFUPDT</td>
<td>An AT-MOST-ONE violation occurred (field level constraint). An AT-MOST-ONE violation corresponds to errors handled by ON FCC ON units in SOUL. For information about ON units, see [[Subroutines#On units 2|On units 2]].
</td>
</tr>
<tr>
<td>260</td>
<td>IFOPEN</td>
<td>A file or group could not be opened.</td>
</tr>
<tr>
<td>300</td>
<td>All calls</td>
<td>Thread restarted in Host Language Interface Model 204 service program. Call lost.</td>
</tr>
<tr>
<td>325</td>
<td>in IFAM2</td>
<td>IQB not large enough. Adjust the Model 204 parameters LIBUFF, LOBUFF, and IFAMBS as necessary.</td>
</tr>
<tr>
<td>350</td>
<td>in IFAM2</td>
<td>Invalid string length. Adjust the Model 204 parameters LIBUFF and LOBUFF as necessary.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">400</td>
<td>IFSTRT and IFSETUP in IFAM2 and IFAM4</td>
<td>Invalid language code.</td>
</tr>
<tr>
<td>Other calls in IFAM2 and IFAM4</td>
<td>Invalid parameter list.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">500</td>
<td>IFCALL</td>
<td>Invalid function number passed to IFCALL.</td>
</tr>
<tr>
<td>in IFAM1 using IFDIAL</td>
<td>Invalid function called.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">800</td>
<td>in IFAM2 and IFAM4</td>
<td>No Host Language Interface Model 204 threads currently available. Try again later or increase number of defined threads.</td>
</tr>
<tr>
<td>IFDIAL</td>
<td>All Model 204 IFDIAL connections are busy. Check to see that the proper number of IODEV=29 initialization statements were included for the Host Language Interface Model 204 service program.</td>
</tr>
<tr>
<td rowspan="3" colspan="1">1000</td>
<td>IFFNSH</td>
<td>Normal return code from IFFNSH. (See 1<var class="term">nnn</var>.)</td>
</tr>
<tr>
<td>in IFAM2 and IFAM4</td>
<td>The application program disconnected from Model 204 normally.</td>
</tr>
<tr>
<td>All other calls</td>
<td>Model 204 is no longer available.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">1001</td>
<td>in IFAM2 and IFAM4</td>
<td>Host Languages Interface Model 204 service program is not up, the Host Language interface is halted or drained, or no host language threads were defined in Model 204 This may indicate that the IFAM4 load module was link-edited without the REUS option.</td>
</tr>
<tr>
<td>IFDIAL</td>
<td>Host Language Interface Model 204 is not up, or no IODEV=39 statements were included in initialization, or CRAM channel name does not exist. Connection is impossible.</td>
</tr>
<tr>
<td>1002</td>
<td>in IFAM2</td>
<td>Insufficient SQA or CSA space to use CRAM connection.</td>
</tr>
<tr>
<td rowspan="2" colspan="1">1003</td>
<td>in IFAM2 and IFAM4</td>
<td>Insufficient memory in the IFAM application to allocate the necessary control blocks.</td>
</tr>
<tr>
<td>IFDIAL 
IFDIALN</td>
<td>Not enough memory for CRAM open.</td>
</tr>
<tr>
<td>1004</td>
<td>in IFAM2</td>
<td>An initial IFCSA call was not made.</td>
</tr>
<tr>
<td>1<var class="term">nnn</var></td>
<td>IFFNSH in IFAM1</td>
<td>IFFNSH returns 1000 and the highest Model 204 journal error message return code encountered during the run.</td>
</tr>
</table>

==Job run ABEND codes==

The follwing table describes the user ABEND completion codes that are generated when Model 204 detects severe errors and abends the HLI application program job run.
<table>
<caption>Job run ABEND codes</caption>
<tr class="head">
<th>Code</th>
<th>Job type</th>
<th>Description</th>
</tr>
<tr>
<td>100</td>
<td>IFAM1</td>
<td>CCASNAP DD statement is missing.</td>
</tr>
<tr>
<td>250</td>
<td>IFAM2 and IFAM4</td>
<td>Invalid parameter list. Completion code could not be set.</td>
</tr>
<tr>
<td>1000</td>
<td>IFAM2</td>
<td>Serious CRAM error. Save all output from application and Host Language Interface Model 204 service program for Technical Support personnel.</td>
</tr>
</table>

For more information about how IFAM4 sets the job step return code, see [[HLI: Job requirements#IFAM4 jobs: Job errors and ABENDs|IFAM4 jobs: Job errors and ABENDs]].

[Category: Host Language Interface]

HLI: Model 204 completion and ABEND codes - Revision history

ELowell at 21:39, 2 May 2016

ELowell at 19:07, 25 April 2016

ELowell: Created page with " ==Overview== This topic describes the completion codes that may be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:<..."

ELowell: Created page with " ==Overview==
This topic describes the completion codes that may be encountered when using the Model 204 HLI facility. There are two broad categories of completion codes:<..."