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
|
