TAA Tools
PRTDEVCFG     PRINT DEVICE CONFIGURATION TO A SOURCE FILE   TAACFGA

Note: The system command  SAVCFG has reduced the reason for  the use of
PRTDEVCFG.  The tool still has some unique advantages.

The  PRTDEVCFG  command  prints  a  copy  of the  device  configuration
objects  and copies the contents  to a source member  in a source file.
This avoids the large number  of pages that would normally  be required
to  print all of  the configuration  details.   The source  file allows
use  of the scan capability  of SEU to  find any specific configuration
object.

The following object types are included:

        *LIND      Line description
        *CTLD      Controller description
        *DEVD      Device description
        *COSD      Class-of-service description
        *MODD      Mode description
        *CFGL      Configuration list

This command  could  be part  of your  regular  backup procedure.    By
executing  the  command and  then  saving  the  source file  where  the
information  is  stored, you  would  have a  permanent  record  of your
device configuration.

To use PRTDEVCFG you must  first create a data  area and a source  file
in a library with the command:

         CRTPRTCFG    LIB(xxx)

The library must be  on the library list when the  PRTDEVCFG command is
run.

PRTDEVCFG is  a long running command and should  be submitted to batch.
The command has no parameters and would be entered as:

         PRTDEVCFG

Use SEU to view the output.

         STRSEU    SRCFILE(TAADEVCFG)
                     SRCMBR(*SELECT)

The  command can be  executed daily.   The implementation steps default
to create 7 members (MBR001,  MBR002 ...  MBR007).  A  different member
is used each  time PRTDEVCFG is executed.  When  the list is exhausted,
the  sequence starts  again with  MBR001.  The  data area  TAADEVCFG is
used to hold the name of the last member written.

The intent of 7 members assumes  that you will be running PRTDEVCFG  on
a daily  basis and therefore  have the last  7 versions of  your device
configurations  on  line.   If  you  want more  versions,  you  can add
member MBR006 etc.  to  the source file TAADEVCFG.   If you want  fewer
versions, you  can remove  MBR007 etc.   You  must have  MBR001 to  use
PRTDEVCFG.

The text  description of the member is updated  each time the member is
written  to.  The  text shows the  date and time  the PRTDEVCFG command
was executed.   The same text description  appears as the first  record
in the source file.

CRTPRTCFG Command                                     *CMD
-----------------

The  CRTPRTCFG  command  creates  the  objects used  by  the  PRTDEVCFG
command.

   LIB           The  library  where the  TAADEVCFG data  area  and the
                 TAADEVCFG source file  will exist.   The library  must
                 be on the  library list when the  PRTDEVCFG command is
                 used.

PRTDEVCFG Command                                     *CMD
-----------------

The  PRTDEVCFG  command  prints the  device  configuration  objects and
writes the  print lines  to  a member  in  the source  file  TAADEVCFG.
There are no parameters for the command.

Prerequisites
-------------

The following TAA Tools must be on your system:

      CHKJOBCTL     Check job control
      EDTVAR        Edit variable
      RTVDAT        Retrieve date
      SNDCOMPMSG    Send completion message
      SNDESCMSG     Send escape message
      SNDSTSMSG     Send status message
      WRTSRC        Write source

Implementation
--------------

The tool  is ready to  use, but  you must first  create the objects  (a
data area and a source file) in a library.

           CRTPRTCFG   LIB(xxx)

Objects used by the tool
------------------------

   Object        Type       Attribute      Src member     Src file
   ------        -----      ---------      ----------     -----------

   PRTDEVCFG     *CMD                      TAACFGA        QATTCMD
   CRTPRTCFG     *CMD                      TAACFGA2       QATTCMD
*  TAADEVCFG     *DTAARA                       No source
*  TAADEVCFG     *FILE         PF              No source
   TAACFGAC      *PGM          CLP         TAACFGAC       QATTCL
   TAACFGAC2     *PGM          CLP         TAACFGAC2      QATTCL

* These objects are created by the CRTPRTCFG command in
the library you specify.

Structure
---------

CRTPRTCFG   Cmd
   TAACFGAC2  CL pgm

PRTDEVCFG   Cmd
   TAACFGAC    CL pgm
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top