Change Logical File Member (CHGLFM)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Logical File Member (CHGLFM) command changes the attributes of a logical file member.

Top

Parameters

Keyword Description Choices Notes
FILE Logical file Qualified object name Required, Key, Positional 1
Qualifier 1: Logical file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Logical file member Name, *FIRST Required, Key, Positional 2
SHARE Share open data path *SAME, *YES, *NO Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional
Top

Logical file (FILE)

Specifies the logical file that contains the member to be changed.

This is a required parameter.

Qualifier 1: Logical file

name
Specify the name of the logical 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 for the job is used to locate the file. If no library is specified as the current library, QGPL is used.
name
Specify the name of the library to be searched.
Top

Logical file member (MBR)

Specifies the name of the member to be changed.

*FIRST
The first member of the specified file is used.
name
Specify the name of the logical file member to be changed.
Top

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 member's ODP sharing value 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.
Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text that describes the member does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Examples

CHGLFM   FILE(*CURLIB/INV)  MBR(FEB)
         TEXT('Logical file member for FEB')

The command changes the text for the member named FEB in the logical file INV that is found in the specified current library.

Top

Error messages

*ESCAPE Messages

CPF3288
Member &3 file &1 in &2 not changed.
Top