Change Physical File Member (CHGPFM)

The Change Physical File Member (CHGPFM) command changes the attributes of a physical file member.

Restrictions:

To change a physical member, you must have object management (*OBJMGT) or object alter (*OBJALTER) authority for the physical file that contains the member, and execute (*EXECUTE) authority to the file library.
No other user may be clearing or initializing the member, nor may any user be holding the file for exclusive use. Other users may have the member open, but the changes made to the member are not reflected in any open members. For the changes in open members to be effective, first close the member (this must be a full close if the member is open SHARE(*YES)) and then open it again.

Parameters

Keyword	Description	Choices	Notes
FILE	Physical file	Qualified object name	Required, Key, Positional 1
	Qualifier 1: Physical file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, *FIRST	Required, Key, Positional 2
SRCTYPE	Source type	Simple name, SAME, NONE	Optional
EXPDATE	Expiration date for member	Date, SAME, NONE	Optional
SHARE	Share open data path	SAME, YES, *NO	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional

Top

Physical file (FILE)

Specifies physical file that contains the member to be changed.

This is a required parameter.

Qualifier 1: Physical file

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

name: Specify the name of the library to be searched.

Member (MBR)

Specifies the member to be changed.

This is a required parameter.

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

Source type (SRCTYPE)

Specifies the source type of a member if this is a source file. The source type option is a character string of no more than 10 characters representing a name. The first character must be alphabetic (including the characters $, @, or #), and the remaining characters must be alphanumeric or an underline.

Note: The user of this command must assure the validity of the source type option.

The source type option can only be used with this command to change the source type attribute of a source file member.

*SAME: The value does not change.
*NONE: No source type is specified.
simple-name: Specify the source type of a member.

Expiration date for member (EXPDATE)

Specifies the expiration date. The files cannot be overwritten until the expiration date. The expiration date must be later than or equal to the current date.

*SAME: The expiration date of the member does not change.
*NONE: The member has no expiration date.
date: Specify the date after which the member cannot be used. The date is specified in the job-date format.

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 ODP sharing value of the member 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.

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.

Examples

CHGPFM   FILE(QGPL/INV)  MBR(FEB)  EXPDATE('10/31/90')

This command changes the member named FEB in the physical file INV in the QGPL library so that the expiration date of the member is now October 31, 1990 (assuming the job date format is mm/dd/yy).