ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/compi.htm

203 lines
13 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="CL module compiler listings" />
<meta name="abstract" content="When you create a CL module, you can create various types of listings using the OPTION and OUTPUT parameters on the Create Control Language Module (CRTCLMOD) command." />
<meta name="description" content="When you create a CL module, you can create various types of listings using the OPTION and OUTPUT parameters on the Create Control Language Module (CRTCLMOD) command." />
<meta name="DC.subject" content="CL procedure, compiler listing, example, compiler listing, sample program" />
<meta name="keywords" content="CL procedure, compiler listing, example, compiler listing, sample program" />
<meta name="DC.Relation" scheme="URI" content="crpro.htm" />
<meta name="DC.Relation" scheme="URI" content="errco.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtclmod.htm" />
<meta name="DC.Relation" scheme="URI" content="errco.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="compi" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>CL module compiler listings</title>
</head>
<body id="compi"><a name="compi"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CL module compiler listings</h1>
<div><p>When you create a CL module, you can create various types of listings
using the OPTION and OUTPUT parameters on the <span class="cmdname">Create Control Language
Module (CRTCLMOD)</span> command.</p>
<div class="section"><p>The OPTION parameter values and their meanings are: </p>
<ul><li>*GEN or *NOGEN <p>Whether a module is to be created (*GEN is the default).</p>
</li>
<li>*XREF or *NOXREF <p>Whether a listing of cross-references to variables
and data references in the source input is to be produced (*XREF is the default).</p>
</li>
</ul>
</div>
<div class="section"><p>The OUTPUT parameter values and their meanings are: </p>
<ul><li>*PRINT - print listing</li>
<li>*NONE - no compiler listing</li>
</ul>
</div>
<div class="section"><p>The listing created by specifying the OUTPUT parameter is called
a <em>compiler listing</em>. The following shows a sample compiler listing.
The callout numbers refer to descriptions following the listing.</p>
</div>
<div class="example"> <div class="fignone"><pre> <span><strong>1</strong></span> <span><strong>2</strong></span> <span><strong>3</strong></span>
5722SS1 V5R3M0 041231 Control Language MYLIB/DUMPER SYSNAME 05/06/00 11:12:55 Page 1
Module . . . . . . . . . . . . . . . . . . . . : DUMPERR
Library . . . . . . . . . . . . . . . . . . : MYLIB
Source file . . . . . . . . . . . . . . . . . : QCLSRC
Library . . . . . . . . . . . . . . . . . . : MYLIB
Source member name . . . . . . . . . . . . . : DUMPERR 05/06/94 10:42:26 <span><strong>4</strong></span>
Source printing options . . . . . . . . . . . : *XREF *NOSECLVL *NOEVENTF
Module logging . . . . . . . . . . . . . . . : *JOB
Replace module object . . . . . . . . . . . . : *YES
Target release . . . . . . . . . . . . . . . : V5R3M0
Authority . . . . . . . . . . . . . . . . . . : *LIBCRTAUT
Sort sequence . . . . . . . . . . . . . . . . : *HEX
Language identifier . . . . . . . . . . . . . : *JOBRUN
Text . . . . . . . . . . . . . . . . . . . . : Test program
Optimization . . . . . . . . . . . . . . . . : *NONE
Debugging view . . . . . . . . . . . . . . . : *STMT
Enable performance collection . . . . . . . . : *PEP
Compiler . . . . . . . . . . . . . . . . . . : IBM iSeries Control Language Compiler <span><strong>5</strong></span>
<span><strong>6</strong></span> Control Language Source
SEQNBR *...+... 1 ...+... 2 ...+... 3 ...+... 4 ...+... 5 ...+... 6 ...+... 7 ...+... 8 ...+... 9 ...+. DATE <span><strong>8</strong></span>
100- PGM 05/06/94
200- DCL &amp;ABC *CHAR 10 VALUE('THIS') 05/06/94
300- DCL &amp;XYZ *CHAR 10 VALUE('THAT') <span><strong>7</strong></span> 05/06/94
400- DCL &amp;MNO *CHAR 10 VALUE('OTHER') 05/06/94
500- CRTLIB LB(LARRY) 05/06/94
* CPD0043 30 Keyword LB not valid for this command. <span><strong>9</strong></span>
600- DLTLIB LIB(MOE 05/06/94
* CPD0013 30 A matching parenthesis not found.
700- MONMSG CPF0000 EXEC(GOTO ERR) 05/06/94
800- ERROR: 05/06/94
900- CHGVAR &amp;ABC 'ONE' 05/06/94
1000- CHGVAR &amp;XYZ 'TWO' 05/06/94
1100- CHGVAR &amp;MNO 'THREE' 05/06/94
1200- DMPCLPGM 05/06/94
1300- ENDPGM 05/06/94
* * * * * E N D O F S O U R C E * * * * *
5722SS1 V5R3M0 040201 Control Language MYLIB/DUMPER SYSNAME 05/06/00 11:12:55 Page 2
Cross Reference
Declared Variables
Name Defined Type Length References
&amp;ABC 200 *CHAR 10 900
&amp;MNO 400 *CHAR 10 1100
<span><strong>10</strong></span>
&amp;XYZ 300 *CHAR 10 1000
Defined Labels
Label Defined References <span><strong>11</strong></span>
ERR ****** 700
* CPD0715 30 Label 'ERR ' does not exist.
ERROR 800
* * * * * E N D O F C R O S S R E F E R E N C E * * * * *
5722SS1 V5R3M0 040201 Control Language MYLIB/DUMPER SYSNAME 05/06/04 11:12:55 Page 3
Message Summary
Severity
Total 0-9 10-19 20-29 30-39 40-49 50-59 60-69 70-79 80-89 90-99 <span><strong>12</strong></span>
3 0 0 0 3 0 0 0 0 0 0
Module DUMPERR not created in library MYLIB. Maximum error severity 30. <span><strong>13</strong></span>
* * * * * E N D O F M E S S A G E S U M M A R Y * * * * *
* * * * * E N D O F C O M P I L A T I O N * * * * *</pre>
</div>
</div>
<div class="section"><div class="p"><em>Title:</em> <dl><dt class="dlterm"><span>1</span></dt>
<dd>The program number, release, modification level and date of i5/OS™.</dd>
<dt class="dlterm"><span>2</span></dt>
<dd>The date and time of the compiler run.</dd>
<dt class="dlterm"><span>3</span></dt>
<dd>The page number in the listing.</dd>
</dl>
</div>
</div>
<div class="section"><div class="p"><em>Prolog:</em> <dl><dt class="dlterm"><span>4</span></dt>
<dd>The parameter values specified (or defaults if not specified) on the
Create Control Language Module (CRTCLMOD) command. If the source is not in
a database file, the member name, date, and time are omitted.</dd>
<dt class="dlterm"><span>5</span></dt>
<dd>The name of the compiler.</dd>
</dl>
</div>
</div>
<div class="section"><div class="p"><em>Source:</em> <dl><dt class="dlterm"><span>6</span></dt>
<dd>The sequence numbers of lines (records) in the source. A dash following
a sequence number indicates that a source statement begins at that sequence
number. The absence of a dash indicates that a statement is the continuation
of the previous statement.</dd>
<dt class="dlterm"></dt>
<dd>Comments between source statements are handled like any other source statement
and have sequence numbers.</dd>
<dt class="dlterm"><span>7</span></dt>
<dd>The source statements.</dd>
<dt class="dlterm"><span>8</span></dt>
<dd>The last date the source statement was changed or added. If the source
is not in a database file, or the dates have been reset using RGZPFM, the
date is omitted.</dd>
<dt class="dlterm"><span>9</span></dt>
<dd>If an error is found during compilation and can be traced to a specific
source statement, the error message is printed immediately following the source
statement. An asterisk (*) indicates the line contains an error message.
The line contains the message identifier, severity, and the text of the message.</dd>
</dl>
</div>
</div>
<div class="section"><div class="p"><em>Cross-References:</em> <dl><dt class="dlterm"><span>10</span></dt>
<dd>The symbolic variable table is a cross-reference listing of the variables
validly declared in the program. The table lists the variable, the sequence
number of the statement where the variable is declared, the variable's attributes,
and the sequence numbers of statements that refer to the variable.</dd>
<dt class="dlterm"><span>11</span></dt>
<dd>The label table is a cross-reference listing of the labels validly defined
in the program. The table lists the label, the sequence number of the statement
where the label is defined, and the sequence numbers of statements that refer
to the label.</dd>
</dl>
</div>
</div>
<div class="section"><p><em>Messages:</em></p>
</div>
<div class="section"><p>This section is not included in the sample listing because no
general error messages were issued for the sample module. If there were general
error messages for this module, this section would contain, for each message,
the message identifier, the severity, and the message.</p>
</div>
<div class="section"><p><em>Message Summary:</em> </p>
<dl><dt class="dlterm"><span>12</span></dt>
<dd>A summary of the number of messages issued during compilation. The total
number is given along with totals by severity.</dd>
<dt class="dlterm"><span>13</span></dt>
<dd>A completion message is printed following the message summary.</dd>
</dl>
</div>
<div class="section"><p>The title, prologue, source, and message summary sections are
always printed for the *SOURCE option. The cross-reference section is printed
if the *XREF option is specified. The message section is printed only if general
errors are found.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="crpro.htm" title="A CL source procedure must be compiled into a module and bound into a program before it can be run.">Compile CL procedures</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="errco.htm" title="The types of errors that are detected at compile time include syntax errors, references to variables and labels not defined, and missing statements.">Common errors when compiling</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/crtclmod.htm">Create CL Module (CRTCLMOD) command</a></div>
</div>
</div>
</body>
</html>