289 lines
12 KiB
HTML
289 lines
12 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Create CICS Map (CRTCICSMAP)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CRTCICSMAP.Top_Of_Page"></a>
|
|
<h2>Create CICS Map (CRTCICSMAP)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CRTCICSMAP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTCICSMAP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTCICSMAP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTCICSMAP"></a>
|
|
<p>The Create CICS MAP (CRTCICSMAP) command allows you to create BMS physical and symbolic maps.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTCICSMAP.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTCICSMAP.CICSMAP"><b>CICSMAP</b></a></td>
|
|
<td valign="top">Map object name</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Map object name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTCICSMAP.SRCFILE"><b>SRCFILE</b></a></td>
|
|
<td valign="top">Map source file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Map source file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QMAPSRC</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTCICSMAP.SRCMBR"><b>SRCMBR</b></a></td>
|
|
<td valign="top">Map source member name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*MAP</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTCICSMAP.LMAPSRC"><b>LMAPSRC</b></a></td>
|
|
<td valign="top">Symbolic map source file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Symbolic map source file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*DEFAULT</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *LIBL, <b><u>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTCICSMAP.LMAPMBR"><b>LMAPMBR</b></a></td>
|
|
<td valign="top">Symbolic map source member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*MAP</u></b></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCICSMAP.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace output objects</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCICSMAP.TGTRLS"><b>TGTRLS</b></a></td>
|
|
<td valign="top">Target release</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTCICSMAP.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SRCMBRTXT</u></b>, *BLANK</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTCICSMAP.CICSMAP"></a>
|
|
<h3>Map object name (CICSMAP)</h3>
|
|
<p>Specifies the qualified name of the generated 3270 or 5250 CICS BMS map.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<ul>
|
|
<li>*CURLIB: Specifies the library in which the output physical map will residue.
|
|
</li>
|
|
<li><b>library-name:</b> Specify the name of the library in which the physical map is located.
|
|
</li>
|
|
</ul>
|
|
<p><b>map-name:</b> Specify the name of the generated map file.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If a suffix operand is specified, the suffix is attached automatically to the name.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.SRCFILE"></a>
|
|
<h3>Map source file (SRCFILE)</h3>
|
|
<p>Specifies the qualified name of the input BMS map source from which the 3270 or 5250 maps are created.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<ul>
|
|
<li>*LIBL: All libraries in the user and system portions of the job's library list are searched.
|
|
</li>
|
|
<li>*CURLIB: The current library is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</li>
|
|
<li><b>library-name:</b> Specify the name of the library where the BMS map source file is located.
|
|
</li>
|
|
</ul>
|
|
<p>QMAPSRC: If a BMS map source file is not specified, the supplied source file QMAPSRC contains the map source.
|
|
</p>
|
|
<p><b>source-map-name:</b> Specify the name of the BMS map source from which the physical map file is created.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.SRCMBR"></a>
|
|
<h3>Map source member name (SRCMBR)</h3>
|
|
<p>Specifies the name of the source file that contains the CICS map source.
|
|
</p>
|
|
<ul>
|
|
<li>*MAP: Specifies that the CICS map source is in the source file member that has the same member name as that specified in the CICSMAP parameter.
|
|
</li>
|
|
<li><b>source-map-member-name:</b> Specify the name of the source file member that contains the CICS map source.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.LMAPSRC"></a>
|
|
<h3>Symbolic map source file (LMAPSRC)</h3>
|
|
<p>Specifies the qualified name of the output source file which will contain the symbolic map as either a COBOL copybook or a C header file.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<ul>
|
|
<li>*LIBL: All libraries in the user and system portions of the job's library list are searched.
|
|
</li>
|
|
<li>*CURLIB: The current library is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</li>
|
|
<li><b>library-name:</b> Specify the name of the library where the logical map will be generated.
|
|
</li>
|
|
</ul>
|
|
<p>The possible symbolic source file values are:
|
|
</p>
|
|
<ul>
|
|
<li>*DEFAULT: The source file name will default according to the value specified on the LANG parameter in the map source.
|
|
<p>If LANG=COBOL then a source file name of QLBLSRC will be used.
|
|
</p>
|
|
<p>If LANG=C then a source file name of H will be used.
|
|
</p>
|
|
<p>If no LANG parameter is specified in the map source, then COBOL will be assumed and the source file name will be QLBLSRC.
|
|
</p>
|
|
</li>
|
|
<li><b>source-file-name:</b> Specify the name of the source file to which the language specific source statements should be copied.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.LMAPMBR"></a>
|
|
<h3>Symbolic map source member (LMAPMBR)</h3>
|
|
<p>Specifies the name of the source file member that contains the symbolic map source. If this parameter is not specified, the map name specified on the CICSMAP parameter is used.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Care should be taken when using this parameter to make sure that you don't specify the same fully qualified name of a source member as that of an existing one; otherwise, you will replace the one that is already there.
|
|
</p>
|
|
<ul>
|
|
<li>*MAP: Specifies that the symbolic map's source member name is the same as the name specified in the CICSMAP parameter.
|
|
</li>
|
|
<li><b>source-member-name:</b> Specify the name of the source file member to which the symbolic map source statements should be copied.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.REPLACE"></a>
|
|
<h3>Replace output objects (REPLACE)</h3>
|
|
<p>Specifies whether a CICS BMS map is created when there is an existing CICS BMS map of the same name in the same library.
|
|
</p>
|
|
<ul>
|
|
<li>*YES: A CICS BMS map is created. If there is a CICS BMS map of the same name in the specified library, it is replaced.
|
|
</li>
|
|
<li>*NO: A CICS BMS map is not created if a CICS BMS map of the same name already exists in the specified library.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.TGTRLS"></a>
|
|
<h3>Target release (TGTRLS)</h3>
|
|
<p>Specifies the release level of the operating system on which you intend to use the object being created. In the examples given for the *CURRENT and *PRV values, and when specifying the target-release value, the format VxRxMx is used specify release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V3R6M0 is Version 3, Release 6, Modification 0.
|
|
</p>
|
|
<p>Valid values for this parameter change every release.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*CURRENT: The object is to be used on the release of the operating system currently running on your system. The object can also be used on a system with any subsequent release of the operating system installed.
|
|
</li>
|
|
<li>*PRV: The object is to be used on the previous release with modification level 0 of the operating system. The object can also be used on a system with any subsequent release of the operating system installed.
|
|
</li>
|
|
<li><b>release-level:</b> Specify the release level in the format VxRxMx. The object can be used on a system with the specified release or with any subsequent release of the operating system installed.
|
|
<p>Valid values depend on the current version, release, and modification level, and they change with each new release.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTCICSMAP.TEXT"></a>
|
|
<h3>Text (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the new CICS definition.
|
|
</p>
|
|
<ul>
|
|
<li>*SRCMBRTXT: The text is taken from the source file member being used to create the CICS map. Text for a database source member can be added or changed using the Source Entry Utility (STRSEU) command, or by using either the Add Physical File Member (ADDPFM) or Change Physical File Member (CHGPFM) command. If the source file is an inline file or a device file, the text is blank.
|
|
</li>
|
|
<li>*BLANK: No text is specified.
|
|
</li>
|
|
<li><b>description:</b> Specify no more than 50 characters of text, enclosed by apostrophes.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CRTCICSMAP.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CRTCICSMAP.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTCICSMAP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|