Save CICS Group (SAVCICSGRP)

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

Library (LIB)

Enter the name of the IBM i library that contains the tables in a specific group(s) to be saved.

• library-name: Specify the name of the IBM i 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 both the release level of the operating system on which the CICS group object are being saved, and the format of the CICS resource tables. Such format changes per product release and exists only for compatibility reasons.

CICS officially only support up to 2 previous release.

The possible values are:

• Element 1: Target release.

  Indicates the release used to save the objects associated to the CICS group. The resultant file can be restored with the Restore Object (RSTOBJ) command.

  The scheme VxRxMx is used, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V7R2M0 is Version 7, Release 2, Modification 0.

  • *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.
  • release-level: Specify the release level in the scheme 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.

• Element 2: Tables Format.

  Indicates to which format the resource tables are to be converted. Each format corresponds to one of the CICS previous releases, down to V4R4M0.

  o This value is provided only for compatibility reasons.

  o CICS officially only support up to 2 previous releases.

  • *TGTRLS: The format used matches with the value defined in the target-release.
  • format-release: Specify the format used to convert the resource tables of the CICS group. Each one is associated with an specific CICS release, in the scheme Fvrm, where v is the version, r the release and m the modification level, down to F440. For example, *F510 refers to CICS V5R1M0.

Examples

Error messages