IFSPRM (HLI function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFSPRM call (SET PARAMETER) sets the value of one or more specified Model 204 parameters.</dd> <dt>Thread type</dt> <dd>multiple...")
 
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions|Function call notation conventions]].


==Summary==
==Summary==

Latest revision as of 19:39, 13 July 2016

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

Summary

Description
The IFSPRM call (SET PARAMETER) sets the value of one or more specified Model 204 parameters.
Thread type
multiple cursor IFSTRT, single cursor IFSTRT
IFCALL function number
26

Syntax

IFSPRM(RETCODE,PARM_LIST,FILE_SPEC)

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 the required first 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 Model 204 parameter whose value is to be set. Specify a character string using the following format:

parm1=value1 [,parm2=value2...];

where:

parm1 is the name of the Model 204 parameter to be set, and parm2 is the name of a second parameter to be set. Additional parameters may be specified in a name-value pair. Specify the keyword name of the Model 204 system, file or user parameter.

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, in hexadecimal form, such as X'C1', or in character form, such as C'A'. For example, the specification OPENCTL=128 is equivalent to OPENCTL=X'80'.

You can specify more than one name=value pair, separating each by a comma or a blank.

FILE_SPEC [I,s,o] The file specification is an optional input parameter for use only with a multiple cursor IFSTRT thread for specifying the name of the file for which the Model 204 file parameter is set. Specify the Model 204 file name as a short character string using the following format:

IN [FILE] filename;

The specified file must be open on the thread; otherwise, the call is unsuccessful and Model 204 returns a completion code equal to 4.

Usage notes

Use the IFSPRM call to set or, in effect, to reset certain Model 204 system, file or user parameters. The IFSPRM call is valid for resetting individual file parameters only in file context, not for a group. The IFSPRM call is equivalent to the IFRPRM call and IFSPRM follows the same basic rules for specifying parameter settings as the Model 204 RESET command.

The IFSPRM call is valid on all types of IFSTRT threads. Note that the file context can change on a multiple cursor thread. If a Model 204 file parameter is specified for PARM_LIST and the file specification parameter (FILE_SPEC) is omitted, IFSPRM sets the value for the default file on the thread.

Note: Use IFSPRM with caution to avoid resetting sensitive parameters that might affect the entire operating environment. For information about Model 204 parameters, see List of Model 204 parameters.

Coding example (COBOL)

WORKING-STORAGE SECTION. 01 CALL-ARGS. 05 RETCODE PIC 9(5) COMP SYNC. 05 SET PIC X(12) VALUE 'OPENCTL=128;'. . . . PROCEDURE DIVISION. . . . CALL "IFSPRM" USING RETCODE, SET.