TAA Tools
CHGLF2          CHANGE LOGICAL FILE 2                  TAADBOE

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
					

Added to TAA Productivity tools October 15, 2013


Home Page Up to Top