TAA Tools
CVTSBSD         CONVERT SUBSYSTEM DESCRIPTION          TAASYSV

The  Convert Subsystem  Description  command converts  the  information
about  a   Subsystem  Description  to  one  or   more  outfiles.    All
information  may  be  converted or  a  specific type  (such  as Routing
Entries).  Each type is converted to a separate outfile.

A typical command would be:

             CVTSBSD       SBSD(xxx) OUTLIB(yyy)

All of  the subsystem  description  information would  be converted  to
separate  files in  the  specified library.    If the  outfiles do  not
currently  exist in the  library, they  would be created.   The default
of REPLACE(*YES)  would  cause  any  existing outfiles  to  be  cleared
before writing the information.

The  SBSPOOL outfile  contains  one  record per  pool  as  well as  the
CRTSBSD parameter values for MAXJOBS, SGNDSPF, etc.

Each  outfile contains  information about the  system it  was converted
from and  the  subsystem  so that  multiple  subsystems  from  multiple
files can be combined into a single outfile.

Each outfile  has  multi-member capability.   The  same  value for  the
OUTMBR parameter is used for each file that is output.

The  values from  CRTSBSD such as  SGNDSPF can  be retrieved  using the
TAA Tool RTVSBSD.

List of outfiles and formats
----------------------------

    Type        Outfile name     Model file     Format name
    ----        ------------     ----------     -----------

    *RTGENT     SBSRTGENT        TAASYSVP       RTGENT
    *CMNENT     SBSCMNENT        TAASYSVQ       CMNENT
    *RMTLOC     SBSRMTLOC        TAASYSVS       RMTLOC
    *AUTOSTR    SBSAUTSTR        TAASYSVT       AUTOSTR
    *PRESTR     SBSPRESTR        TAASYSVU       PRESTR
    *WRKSTNNAM  SBSSTNNAM        TAASYSVV       STNNAM
    *WRKSTNTYP  SBSSTNTYP        TAASYSVW       STNTYP
    *JOBQENT    SBSJBQENT        TAASYSVX       JBQENT
    *POOL       SBSPOOL          TAASYSVY       POOLRCD

CVTSBSD  escape messages you can monitor for
--------------------------------------------

None.  Escape messages from based on functions will be re-sent.

APIs used
---------

The QWDRSBSD API is used for SBSPOOL.

The QWDSLJBQ API is used SBSJBQENT.

The QWDLSBSE API is used for all other outfiles.

Command parameters                                    *CMD
------------------

   SBSD          The  qualified  name of  the subsystem  description to
                 be converted.   The library  value defaults to  *LIBL.
                 *CURLIB may also be used.

   OUTLIB        The library  where the outfiles  will be created.   If
                 the  outfile  already  exists,  the REPLACE  parameter
                 determines if it  will be  cleared before writing  any
                 data.  The library cannot be TAATOOL.

   TYPE          The  subsystem type  of information  to be  converted.
                 *ALL   is  the  default  to   output  all  information
                 meaning a  separate outfile  will be  output for  each
                 type.

                 A  specific  type  may be  chosen  from  the  list  of
                 *POOL,  *RTGENT, *CMNENT, *RMTLOC,  *AUTOSTR, *PRESTR,
                 *WRKSTNNAM, , *WRKSTNTYP, or *JOBQENT.

   OUTMBR        The  name of the  member to be  used for each outfile.
                 The  default is  *OUTFILE  meaning  to  use  the  same
                 member name as the outfile being written to.

                 A  specific member name  may be  used.   If specified,
                 the  same member  name is  used for each  outfile that
                 is output.  For example,  you could use a member  name
                 which is  the same  name as the  subsystem description
                 being converted.

   REPLACE       Whether  to clear  an existing outfile  before writing
                 data to it.  *YES is the default.

                 If  *YES  is   specified  and  a   specific  type   is
                 requested  such as  *RTGENT, only  the  data from  the
                 Routing Entry outfile is cleared.

                 *NO  may  be specified  to  add  data  to an  existing
                 outfile.

   CVTTIME       Whether  to use the time  that the CVTSBSD command was
                 run for  all outfiles  or the time  that each  outfile
                 was  output.   Each  outfile  is  created by  separate
                 calls to APIs.

                 *YES  is the default  so that all  outfiles created by
                 a single use  of CVTSBSD will  have a consistent  time
                 value  in  every  record output.    This  is  slightly
                 misleading  in that  it will  take several  seconds to
                 create all of  the outfiles, but  allows a  consistent
                 value.

                 *NO may be specified  to cause the time value  of each
                 outfile record  to more closely reflect  when each API
                 was run to access the information.

Restrictions
------------

None.

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

The following TAA Tools must be on your system:

     CRTDUPPF        Create duplicate physical file
     CRTUSRSPC       Create user space
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTSBSD       *CMD                   TAASYSV       QATTCMD
   TAASYSVC      *PGM       CLP         TAASYSVC      QATTCL
   TAASYSVR      *PGM       RPG         TAASYSVR      QATTRPG
   TAASYSVR2     *PGM       RPG         TAASYSVR2     QATTRPG
   TAASYSVR3     *PGM       RPG         TAASYSVR3     QATTRPG
   TAASYSVR4     *PGM       RPG         TAASYSVR4     QATTRPG
   TAASYSVR5     *PGM       RPG         TAASYSVR5     QATTRPG
   TAASYSVR6     *PGM       RPG         TAASYSVR6     QATTRPG
   TAASYSVR7     *PGM       RPG         TAASYSVR7     QATTRPG
   TAASYSVR8     *PGM       RPG         TAASYSVR8     QATTRPG
   TAASYSVR9     *PGM       RPG         TAASYSVR9     QATTRPG
   TAASYSP       *FILE      PF          TAASYSVP      QATTDDS
   TAASYSQ       *FILE      PF          TAASYSVQ      QATTDDS
   TAASYSS       *FILE      PF          TAASYSVS      QATTDDS
   TAASYST       *FILE      PF          TAASYSVT      QATTDDS
   TAASYSU       *FILE      PF          TAASYSVU      QATTDDS
   TAASYSV       *FILE      PF          TAASYSVV      QATTDDS
   TAASYSW       *FILE      PF          TAASYSVW      QATTDDS
   TAASYSX       *FILE      PF          TAASYSVX      QATTDDS

Structure
---------

The following RPG programs output the corresponding file:

         RPG Program    TAATOOL file    User file
         -----------    ------------    ---------

         TAASYSVR       TAASYSVP        SBSRTGENT
         TAASYSVR2      TAASYSVQ        SBSCMNENT
         TAASYSVR3      TAASYSVS        SBSRMTLOC
         TAASYSVR4      TAASYSVT        SBSAUTSTR
         TAASYSVR5      TAASYSVU        SBSPRESTR
         TAASYSVR6      TAASYSVV        SBSSTNNAM
         TAASYSVR7      TAASYSVW        SBSSTNTYP
         TAASYSVR8      TAASYSVX        SBSJBQENT
         TAASYSVR9      TAASYSVY        SBSPOOL
					

Added to TAA Productivity tools July 1, 1999


Home Page Up to Top