The Change Logical File 2 command allows a change of one or more
logical files. Not all parameters from CHGLF are supported. CHGLF2
simplifies making mass changes to logical files. For a more complete
understanding of the parameters, see the help text for CHGLF. A
logical file owned by one of the system profiles may not be changed.
You must have *ALLOBJ special authority to use CHGLF2.
A typical command would be:
CHGLF2 FILE(ABC/*ALL) WAITRCD(45)
All Logical files in library ABC would be changed so that the WAITRCD
value is set to 45. All other values in logical files would remain
unchanged.
At least one of the values to be changed must be other than the
default of *SAME.
An arrival sequence access path cannot be changed for MAINT,
FRCACCPTH, RECOVER, or FRCRATIO. A diagnostic message will be sent
and the file will not be changed.
If a logical file access path is shared, the sharing file will not be
changed for parameters MAINT, FRCACCPTH, and RECOVER. An
informational message will appear and a completion will be sent
describing that the logical file is changed even though it may not
be.
CHGLF2 escape messages you can monitor for
------------------------------------------
TAA9891 The command failed. Diagnostic messages
will exist.
TAA9892 Not all values to be changed can be *SAME
Escape messages from based on functions will be re-sent.
CHGLF2 Command parameters *CMD
-------------------------
FILE The qualified name of the logical file to be
changed. A single logical file, a generic name, or
the special value *ALL may be used.
A specific library name must be entered.
MAXMBRS The maximum number of members that may exist in the
file. *SAME is the default. A number between 1 and
32767 may be entered or the special value *NOMAX.
ACCPTHSIZ The access path size to be used. *SAME is the
default. *MAX4GB or *MAX1TB may be entered.
MAINT The access path maintenance type. *SAME is the
default. *IMMED, *REBLD, or *DLY may be entered.
RECOVER The access path recovery type. *SAME is the
default. *NO, *AFTIPL, or *IPL may be entered.
FRCACCPTH Whether to force the changed access path to
auxiliary storage. *SAME is the default. *YES or
*NO may be entered.
FRCRATIO The number of records changed or added to the file
before forcing them to auxiliary storage. *SAME is
the default. A number between 1 and 32767 may be
entered or the special value *NONE.
WAITFILE The number of seconds to wait to open the file if it
is in use. *SAME is the default. A number between
1 and 32767 may be entered or the special values
*IMMED or *CLS.
WAITRCD The number of seconds to wait if a record cannot be
allocated for update or deletion. *SAME is the
default. A number between 1 and 32767 may be
entered or the special values *IMMED or *NOMAX.
Restrictions
------------
You must have *ALLOBJ special authority to use CHGLF2.
A logical file owned by one of the system profiles may not be
changed.
An arrival sequence access path cannot be changed for MAINT,
FRCACCPTH, RECOVER, or FRCRATIO. A diagnostic message will be sent
and the file will not be changed.
If a logical file access path is shared, the sharing file will not be
changed for parameters MAINT, FRCACCPTH, and RECOVER. An
informational message will appear and a completion will be sent
describing that the logical file is changed even though it may not
be.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKIBMPRF Check IBM profile
CHKOBJ3 Check object 3
EDTVAR Edit variable
RSNLSTMSG Resend last message
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGLF2 *CMD TAADBOE QATTCMD
TAADBOEC *PGM CLP TAADBOEC QATTCL
|
