Change ICF File (CHGICFF)

The Change Intersystem Communications Function File (CHGICFF) command changes the attributes of the ICF file.

Only the information specified on this command can be changed. If the data description specifications (DDS) used to create the file are changed, the ICF file must be re-created for the changes to be made in the file.

Parameters

Keyword	Description	Choices	Notes
FILE	ICF communication file	Qualified object name	Required, Key, Positional 1
	Qualifier 1: ICF communication file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
ACQPGMDEV	Program device to acquire	Character value, SAME, NONE	Optional
MAXPGMDEV	Maximum program devices	1-256, *SAME	Optional
LVLCHK	Record format level check	SAME, YES, *NO	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional
MAXRCDLEN	Maximum record length	1-32767, SAME, CALC	Optional
WAITFILE	Maximum file wait time	1-32767, SAME, IMMED, *CLS	Optional
WAITRCD	Maximum record wait time	1-32767, SAME, NOMAX, *IMMED	Optional
DTAQ	Data queue	Single values: SAME, NONE Other values: Qualified object name	Optional
	Qualifier 1: Data queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
SHARE	Share open data path	SAME, NO, *YES	Optional

Top

ICF communication file (FILE)

Specifies the intersystem communications function (ICF) file to be changed.

This is a required parameter.

Qualifier 1: ICF communication file

name: Specify the name of the ICF file.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library is used to locate the ICF file. If no library is specified as the current library for the job, QGPL is used.
name: Specify the library where the ICF file is located.

Program device to acquire (ACQPGMDEV)

Specifies which program device is acquired when the file is opened.

*SAME: The name of the acquired program device does not change.
*NONE: The file is opened without a program device being acquired. All program devices used with this file must be explicitly acquired before input/output operations can be started with them.
character-value: Specify the name of the first program device that is acquired when the file is opened.

Maximum program devices (MAXPGMDEV)

Specifies the maximum number of program device entries that can be added to the intersystem communications function (ICF) file.

*SAME: The value does not change.
1-256: Specify the maximum number of program device entries.

Record format level check (LVLCHK)

Specifies whether the level identifiers of the record formats in this device file are checked when the file is opened by a program.

*SAME: The value does not change.
*YES: The level identifiers of the record formats are checked when the file is opened. If the level identifiers are not all the same or they have not been specified in the program, an open error message is sent to the program that tried to open the file.
*NO: The level identifiers of the record formats are not checked when the file is opened.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME: The text (if any) does not change.
*BLANK: No text is specified.
character-value: Specify no more than 50 characters of text, enclosed in apostrophes.

Maximum record length (MAXRCDLEN)

Specifies the maximum record length used when the file is opened.

*SAME: The maximum record length does not change.
*CALC: The length calculated for the largest record in the file is used when the file is opened.
1-32767: Specify the maximum record length. If the record length is less than the length calculated for the largest record in the file, the calculated value is used.

Maximum file wait time (WAITFILE)

Specifies the number of seconds that the program waits for the file resources to be allocated when the file is opened. If the file resources cannot be allocated within the specified wait time, an error message is sent to the program.

*SAME: The wait time does not change.

*IMMED: The program does not wait. Immediate allocation of file resources is required.

*CLS: The job default wait time is used as the wait time for the file resources to be allocated.
1-32767: Specify the number of seconds to wait for file resources to be allocated.

Maximum record wait time (WAITRCD)

Specifies the number of seconds the program waits for the completion of a read-from-invited-devices operation to a multiple device file in a high-level language program. Refer to the high-level language reference manual to determine when a file is treated as a multiple device file. The program performing the read operation waits for the input form all invited devices currently accessing the file. If a record is not returned from any of the invited program devices in the specified amount of time, a notify message is sent to the program. This parameter has no effect on an input operation directed to a single device.

*SAME: The wait record value does not change.
*NOMAX: There is no limit on the amount of time the program waits for completion of the read-from-invited device operation.

*IMMED: The program does not wait. If a record is not available when the read-from-invited-devices operation is done, a notify message is sent to the program.

1-32767: Specify the number of seconds that the program waits for completion of the read-from-invited-device operation.

Data queue (DTAQ)

Specifies the data queue on which entries are placed. The specified data queue must have a minimum length of 80 characters. The data queue need not exist when the display file is created since the name specified for this parameter is not evaluated until the file is used.

Note: Keyed data queues are not supported for this parameter. If a keyed data queue is specified, a run-time error will occur; but because it is not required that a data queue exist at the time the command is issued, the error will not be flagged.

Single values

*SAME: The data queue name does not change.
*NONE: No data queue is specified.

Qualifier 1: Data queue

name: Specify the name of the data queue on which entries are placed.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library is used to locate the data queue. If no library is specified as the current library, QGPL is used.
name: Specify the library where the data queue is located.

Share open data path (SHARE)

Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.

*SAME: The value specified in the file does not change.

*NO: The ODP is not shared with other programs in the routing step. A new ODP for the file is created and used every time a program opens the file.

*YES: The same ODP is shared with each program in the job that also specifies *YES when it opens the file.

Examples

CHGICFF   FILE(ICFHIST)  MAXPGMDEV(10)

This command changes the maximum number of program devices that can be added to the ICF file ICFHIST.