IFUTBL (HLI function)

From m204wiki
Jump to navigation Jump to search

The conventions used on this page are described in Function call notation conventions.

Summary

Description
The IFUTBL call (USER TABLE) resets the specified Model 204 UTABLE (user table) parameters.
Thread type
multiple cursor IFSTRT, single cursor IFSTRT
IFCALL function number
64

Syntax

IFUTBL(RETCODE,PARM_LIST)

Compile-only form
Not available
Execute-only form
Not available

Specify the parameters in the syntax order shown above.

Parameter Description
RETCODE [O,i,r] The Model 204 return code is a required output parameter. The code is a binary integer value.
PARM_LIST [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:

parm1 is the name of the user table parameter to be reset, and parm2 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.

value1 is the new value for the specified parameter in the first pair, and value2 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.

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 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.