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