ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/savcicsgrp.htm

176 lines
7.1 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Save CICS Group (SAVCICSGRP)</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="SAVCICSGRP.Top_Of_Page"></a>
<h2>Save CICS Group (SAVCICSGRP)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>
<ul><li>Batch job (*BATCH)</li>
<li>Interactive job (*INTERACT)</li>
<li>Batch program (*BPGM)</li>
<li>Interactive program (*IPGM)</li>
<li>Batch REXX procedure (*BREXX)</li>
<li>Interactive REXX procedure (*IREXX)</li>
<li>Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)</li>
</ul><b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#SAVCICSGRP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SAVCICSGRP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SAVCICSGRP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SAVCICSGRP"></a>
<p>The Save CICS groups(SAVCICSGRP) command causes the specified groups in the library to be saved by using the SAVOBJ system command. When TGTRLS has a previous release value, then resource definition tables for the specified groups are converted to a previous release of CICS in the QTEMP library and then saved from the QTEMP library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SAVCICSGRP.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"><a href="#SAVCICSGRP.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SAVCICSGRP.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top">Values (up to 50 repetitions): <i>Name</i>, *ALL</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SAVCICSGRP.SAVF"><b>SAVF</b></a></td>
<td valign="top">Save file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 3</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Save file</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>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SAVCICSGRP.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 4</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SAVCICSGRP.LIB"></a>
<h3>Library (LIB)</h3>
<p>Enter the name of the OS/400 library that contains the tables in a specific group(s) to be saved.
</p>
<ul>
<li><b>library-name:</b> Specify the name of the OS/400 library that contains the groups.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVCICSGRP.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group(s) to be saved.
</p>
<p>The possible values are:
</p>
<ul>
<li><b>*ALL:</b> All groups in the library will be saved.
</li>
<li><b>group-name:</b> The name of the group may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVCICSGRP.SAVF"></a>
<h3>Save file (SAVF)</h3>
<p>Enter the name of the save file (in library-name/save-file-name format) that is used to contain the saved groups. The save file should be empty.
</p>
<ul>
<li>Specify one of the following library values:
<ul>
<li>*LIBL: The library list is used to locate the save file.
</li>
<li>*CURLIB: The current library for the job is used to locate the save file. If no library is specified as the current library, the QGPL library is used.
</li>
<li><b>library-name:</b> Specify the name of the library where the save file is located.
</li>
</ul>
</li>
<li><b>save-file-name:</b> Specify the name of the save file.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SAVCICSGRP.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 saved. 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, V5R3M0 is Version 5, Release 3, 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>*OLDREL: The resource definition tables of the specified groups are converted to be used on releases of CICS no longer officially supported. The range allowed is from V4R5M0 to V3R1M0. Due to the operating system restrictions, the resulting save file object must be restored and manually saved again every n-2 releases with the SAVOBJ command until reach the specified target-release value. P.
</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="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SAVCICSGRP.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SAVCICSGRP.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#SAVCICSGRP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>