CRTMIPGM CREATE MI PROGRAM TAAPGMU |
The Create MI Program command creates a program from MI source. This
provides a simpler interface than the QPRCRTPG API.
A typical command would be:
CRTMIPGM PGM(lll/ppp) SRCFILE(QMISRC)
The source member with the same name as the program would be used.
The object is created with a type of *PGM and no attribute.
To understand the basics of MI programming, see the System API
Programming manual.
Each source statement is compressed. The following are eliminated:
- Comments
- Leading blanks
- Excess separator characters (more than 1)
- Ending blanks
and the remaining statement is placed in a work area of 524,288
bytes. It cannot be easily determined how many source statements can
be held in the work area. If the average source statement contained
40 bytes, a maximum of 13,100 statements could be handled in the work
area. If this area is exceeded, an escape message is issued.
Source files up to 112 bytes in length (100 bytes of data are
supported)
The CRTMIPGM supports additional parameters which are not displayed
when the initial prompt appears.
Command parameters *CMD
------------------
PGM The qualified name of the program to be created.
The library value defaults to *CURLIB.
SRCFILE The qualified name of the source file to be used.
The default is QMISRC using *LIBL. *CURLIB may also
be specified.
SRCMBR The source member which contains the MI source. The
default is *PGM meaning to use the name in the PGM
parameter.
TEXT The text to be assigned to the program. The default
is *SRCMBRTXT which means to use the same text as
assigned to the source member.
A specific text description may also be entered.
OPTION The options to be taken when the program is created.
See the QPRCRTPG API for a full discussion. The
defaults are the same as described for the API
except for:
- *LIST is the default instead of *NOLIST
- *REPLACE is the default instead of *NOREPLACE
You may leave the parameter blank to take all the
defaults or specify one of the opposing values such
as *NOLIST, *NOATR, etc.
The command prompt describes all of the valid
values. You must ensure that conflicting statements
such as OPTION(*LIST *NOLIST) are not specified.
AUT The authorization assigned to the program. The
default is *LIBCRTAUT meaning to use the default
create authority specified for the library. *ALL,
*CHANGE, *USE, and *EXCLUDE may also be specified.
Restrictions
------------
See the previous comments about how many source statements may be
entered.
Prerequisites
-------------
The following TAA Tools must be on your system:
EXTLST Extract list
HLRMVMSG HLL Remove message
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
------ ---- --------- ---------- ----------
CRTMIPGM *CMD TAAPGMU QATTCMD
TAAPGMUC *PGM CLP TAAPGMUC QATTCL
TAAPGMUR *PGM RPG TAAPGMUR QATTRPG
|
Added to TAA Productivity tools October 1, 1997