ELowell at 19:41, 13 July 2016

2016-07-13T19:41:49Z

← Older revision		Revision as of 19:41, 13 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 23:04, 11 July 2016

2016-07-11T23:04:37Z

← Older revision		Revision as of 23:04, 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: ELowell moved page IFUTBL (HLI) function to IFUTBL (HLI function): fixing title typo

2016-07-08T23:13:28Z

ELowell moved page IFUTBL (HLI) function to IFUTBL (HLI function): fixing title typo

← Older revision	Revision as of 23:13, 8 July 2016
(No difference)

ELowell: Created page with " ==Summary==

Description

The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters.

Thread type

multiple c..."

2016-07-08T23:00:44Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters.</dd> <dt>Thread type</dt> <dd>multiple c..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>64</dd>
</dl>

==Syntax==
IFUTBL(RETCODE,PARM_LIST)

<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 a required output parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>PARM_LIST</td>
<td>[I,c,r] The parameter list is a required input parameter that specifies the name and value pair for each user table parameter whose value is reset. Specify a character string using the following format:
parm1=value1 [,parm2=value2...];

where:

<var class="term">parm1</var> is the name of the user table parameter to be reset, and <var class="term">parm2</var> is the name of a second parameter to be reset. Additional parameters may be specified in a name-value pair. Specify the keyword name of any of the following UTABLE parameters: HTLEN, LNTBL, LVTBL, LFSCB, LPDLST, LXTBL, LFTBL, LQTBL, LGTBL, LSTBL, LITBL, LTTBL, MAXHDR, MAXTRL.

<var class="term">value1</var> is the new value for the specified parameter in the first pair, and <var class="term">value2</var> is the new value for the specified parameter in the second pair. A value is required for each name that is specified in the list. Values can be specified in decimal form, such as 193, or in hexadecimal form, such as X'C1'. For example, the specification MAXHDR=128 is equivalent to MAXHDR=X'80'.

You can specify more than one name=value pair, separating each by a comma or a blank. 
</td>
</tr>
</table>

==Usage notes==
Use the IFUTBL call to reset certain user table parameters, which enables you to change the size of Model 204 server tables. The IFUTBL call is not available in IFAM1, but is valid on all types of IFSTRT threads in IFAM2 and IFAM4. 

Note: If the size of FTBL or XTBL is changed, any open file or group is closed. Changing the size of any table causes any compiled calls and %variables to be flushed.

For information about server tables and calculation of server table sizes, see [[Defining the runtime environment (CCAIN)#Server tables|Server tables]].

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
05 UTABLE PIC X(12) VALUE 'MAXHDR=128;'.
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFUTBL" USING RETCODE, UTABLE.

[[Category: HLI functions]]

IFUTBL (HLI function) - Revision history

ELowell at 19:41, 13 July 2016

ELowell at 23:04, 11 July 2016

ELowell: ELowell moved page IFUTBL (HLI) function to IFUTBL (HLI function): fixing title typo

ELowell: Created page with " ==Summary== Description The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters. Thread type multiple c..."

ELowell: Created page with " ==Summary==

Description

The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters.

Thread type

multiple c..."