The Convert Source Member command converts source that exceeds 70
columns of data to a format not exceeding 70 columns. This allows a
tool such as EDTSRC to work with previously created DDS source such
as CL or DDS. The type of source must be CL, CMD, DDS, or TXT. Any
non supported source types are flagged.
You must have all rights to the source file to use CVTSRCMBR.
A typical command would be:
CVTSRCMBR SRCTYP(DDS) SRCFILE(QDDSSRC) SRCMBR(*ALL)
All members would be read and reformatted to a temporary member in
QTEMP. Any statements where data existed beyond column 70 would be
converted to two or more statements with + signs added to all but the
last statement. The temporary member would then be copied back to
the original member.
A spooled file is created with the results. Members that have been
changed are flagged as well as non-supported source types. Any
additional statements that are added receive a current source change
date. If new statements are added, all sequence numbers are reset.
If no source statements have data beyond column 70, the source member
is not changed.
For CL types and CMD source, F4 may need to be used to format the
changed statements.
Considerations
--------------
** Valid source must exist for the named type.
** If a statement already has a plus or minus sign at the end
within position 70, no change to the statement occurs.
** Statements which have data beyond position 70 may not be
correctly converted if there are multiple blanks between data.
For example, in CL and DDS if position 70 is blank, the
conversion places the plus sign 2 positions to the right of
the last non-blank in the first 70 columns. If the data after
70 begins with blanks, some blanks will be dropped from the
statement. This may cause a CRTxxx command to fail.
** The prompter may be used on the converted statements for CL
types and CMD source. In some cases the prompter will get
confused and insert a long string of blanks instead of
properly formatting the statement.
CVTSRCMBR escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTSRCMBR Command parameters *CMD
----------------------------
TYPE The type of source to be converted.
CL may be specified and will convert any of the
source types CL, CLP, CLP38, and CLLE.
CMD may be specified and will convert any of the
source type CMD.
DDS may be specified and will convert any of the
source types PF, PF38, LF, LF38, DSPF, DSPF38, PRTF,
PRTF38, BSCF38, CMNF38, ICFF, and MXDF38.
TXT may be specified to convert any of the source
types TXT, PNLGRP, SPADCT, and TBL. If a line must
be split, the last blank (assuming it is in the last
25 positions) is found and the line is split at the
blank. The new line will start in position 2.
SRCFILE The qualified name of the source file.
*LIBL is the default library name. A specific
library or *CURLIB may be entered.
SRCMBR The source member to be converted. A specific
source member, a generic name, or the special value
*ALL for all members in the source file may be
specified.
Restrictions
------------
See the considerations section.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTMBRLST Convert member list
EDTVAR Edit variable
HLRMVMSG HLL Remove message
RSNLSTMSG Resend last message
RTVDAT Retrieve date
RTVDBFA Retrieve data base file attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
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
------ ---- --------- ---------- ----------
CVTSRCMBR *CMD TAAFILH QATTCMD
TAAFILHC *PGM CLP TAAFILHC QATTCL
TAAFILHR *PGM RPG TAAFILHR QATTRPG
TAAFILHR2 *PGM RPG TAAFILHR2 QATTRPG
TAAFILHR3 *PGM RPG TAAFILHR3 QATTRPG
TAAFILHR is used for DDS conversion. TAAFILHR2 is used for CL and
CMD conversion. TAAFILHR3 is used for TXT conversion.
|