The Change Physical File 2 command allows changes to one, generic, or
all physical files in a library. Only the typical parameters that
are changed by CHGPF are supported by CHGPF2. An omit list of files
may be specified.
A typical command would be:
CHGPF2 FILE(xxx/*ALL) SIZE(*NOMAX) OMITFILE(FILEA)
All physical files in the library except FILEA would be changed to
allow the maximum number of records in each member.
If a file cannot be changed (for example it may be open), the error
message is resent and the command continues onto the next file.
You must be authorized to be able to make changes to any files
specified.
An escape message would occur if all parameter values are *SAME.
An escape message would occur if not all files were changed.
CHGPF2 escape messages you can monitor for
------------------------------------------
TAA9891 All parameter values may not be *SAME.
TAA9892 Not all files changed.
TAA9896 No physical files exist.
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
FILE The qualified name of the file or files to be
changed. A single file, a generic file name, or the
special value *ALL for all physical files may be
specified. A library must be specified.
SIZE A 3 part parameter that allows the initial size in
each member, the number of records that is
automatically added, and the number of times an
increase in size is allowed. The default for each
part is *SAME.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
The initial size value can be *NOMAX or a value
between 1 and 2,147,483,646.
The increment size value may be between 0 and
32,767.
The number of increments may be between 0 and
32,767.
FRCRATIO The number of inserted, changed, or deleted records
that are processed before those records are forced
to auxiliary (permanent) storage. The default is
*SAME. If a value is entered, it must be between 1
and 99999.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
WAITFILE The number of seconds that a program will wait for
the file resources to be allocated when the file is
opened. The default is *SAME.
A number of seconds, *IMMED, or *CLS may be
specified. If a number is entered, it must be
between 1 and 99999.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
WAITRCD The number of seconds that a program will wait for a
record to be changed or deleted. The default is
*SAME.
A number of seconds, *IMMED, or *NOMAX may be
specified. If a number is entered, it must be
between 1 and 99999.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
DLTPCT The maximum percentage of deleted records that any
member may contain before a message (CPF4653) is
sent to QSYSOPR. The default is *SAME.
A number between 1 and 100 may be specified.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
REUSEDLT Whether the space used by deleted records is
reclaimed by future insert requests. The default is
*SAME.
A *YES or *NO may be specified.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
LVLCHK Whether the level identifier of the record format in
the file is checked to ensure that it is the same as
when the program was created that uses the file.
The default is *SAME.
A *YES or *NO may be specified.
See the CHGPF command parameter for when the changes
take effect and other information about the
parameter.
OMITFILES A list of up to 300 files or generic file names that
may be omitted. The default is *NONE. The default
must be *NONE if a single file is specified for the
FILE parameter.
Restrictions
------------
You must be authorized to be able to make changes to any files
specified.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKOBJ3 Check object 3
EDTVAR Edit variable
EXTLST Extract list
MOVCHRDEC Move character to decimal
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSCNT Send status count
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGPF2 *CMD TAADBKS QATTCMD
TAADBKSC *PGM CLP TAADBKSC QATTCL
|
