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.

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Name	Required, Positional 1
GROUP	Group	Values (up to 50 repetitions): Name, *ALL	Required, Positional 2
SAVF	Save file	Qualified object name	Required, Positional 3
	Qualifier 1: Save file	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
TGTRLS	Target release	Character value	Optional, Positional 4

Top

Library (LIB)

Enter the name of the OS/400 library that contains the tables in a specific group(s) to be saved.

• library-name: Specify the name of the OS/400 library that contains the groups.

Group (GROUP)

Enter the name of the group(s) to be saved.

The possible values are:

• *ALL: All groups in the library will be saved.
• group-name: 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 #.

Save file (SAVF)

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.

• Specify one of the following library values:
  • *LIBL: The library list is used to locate the save file.
  • *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.
  • library-name: Specify the name of the library where the save file is located.
• save-file-name: Specify the name of the save file.

Target release (TGTRLS)

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.

Valid values for this parameter change every release.

The possible values are:

• *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.
• *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.
• *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.
• release-level: 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.

  Valid values depend on the current version, release, and modification level, and they change with each new release.

Examples

None

Error messages

Unknown