# Managing groups - IBM - AS/400

A resource definition group comprises a number of resource definitions that are used together in a CICS control region. You should create a group before you create the resource definitions for that group. The group name should go in the system initialization table.

Using the CRTCICSGRP command

Notes:

1. This parameter is valid only when RECOVER(*YES) is specified.
2. All parameters preceding this point can be specified positionally.

Function
Use the Create CICS/400 Group (CRTCICSGRP) command to create all tables associated with a group.

Required parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that will contain the group.
Possible values are:
*CURLIB: The current library will contain the group. If no library is specified as the current library, the QGPL library is used.
library-name:Specify the name of the OS/400 library that will contain the group.
3. Group (GROUP)
4. Enter the name of the group to be created.
group-name:The group name 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$, @, or #.

Optional parameters

1. Description (TEXT)
2. Enter the text that describes the group.
Possible values are:
*BLANK: No text will be associated with the group.
text:Specify a character string of up to 50 characters to describe the group. Enclose the string in apostrophes to use leading or trailing blanks.
3. Recover (RECOVER)
4. Specifies whether or not to attempt to restore the group that has been previously damaged.
Note: All this function does is make sure that all tables are available to this group. Therefore, this parameter only has an effect on an already-existing group.
Possible values are:
*NO: Do not attempt to recover the group.
*YES: Attempt to recover the group.
5. Clear file (CLRGROUP)
6. Specifies whether or not to erase all entries from all tables for this group.
Note: This parameter only has an effect on an already-existing group.
Possible values are:
*NO: Do not clear the group.
*YES: Clear the group.

Examples
CRTCICSGRP LIB(CICSWORK) GROUP(ACCT) TEXT(’CICS/400 sample applications group.’)

This command creates a group ACCT located in OS/400 library CICSWORK that will hold the resource definitions for the sample transaction ACCT.

Using the CHGCICSGRP command
Flowchart

Notes:

1. All parameters preceding this point can be specified positionally.

Function
Use the Change CICS/400 Group (CHGCICSGRP) command to change the text describing all tables associated with a group.

Required parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that contains the group. Possible values are:
*LIBL: The library list is used to locate the first OS/400 library that contains the group.
*CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
library-name:The name of the OS/400 library that contains the group.
3. Group (GROUP)
4. Enter the name of the group to be changed.
group-name:The group name 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$, @, or #.

Optional parameters

1. Description (TEXT)
2. Enter the text that describes the group.
Possible values are:
*SAME: The text associated with the group is not changed.
*BLANK: No text will be associated with the group.
text:Specify a character string of up to 50 characters to describe the group. Enclose the string in apostrophes to use leading or trailing blanks.

Examples
CHGCICSGRP LIB(CICSWORK) GROUP(ACCT) TEXT(’CICS/400 sample applications group.’)This command changes the descriptive text of resource definitions created for group ACCT in OS/400 library CICSWORK.

Using the DLTCICSGRP command

Flowchart

Notes:

1 All parameters preceding this point can be specified positionally.

Function
Use the Delete CICS/400 Group (DLTCICSGRP) command to delete all tables associated with a group. The tables may be at any release level.

Required parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that contains the group. Possible values are:
*LIBL: The library list is used to locate the first OS/400 library that contains the group.
*CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
library-name:The name of the OS/400 library that contains the group.
3. Group (GROUP)
4. Enter the name of the group to be deleted.
group-name: The group name 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$, @, or #.

Examples
DLTCICSGRP LIB(CICSWORK) GROUP(ACCT)

This command deletes group ACCT located in OS/400 library CICSWORK.

Using the INSCICSGRP command
Flowchart

Notes:

1. All parameters preceding this point can be specified positionally.

Function
Use the Install CICS/400 Group (INSCICSGRP) command to define all entries in the tables within the group, to the runtime resource table definitions for the active CICS/400 control region. This command is run as a batch job to install dynamically both new and amended resource definition entries into the CVT, PCT, PPT, TCS, and TCT. Up to 200 entries of each type may be installed using this command.

If the table entry is already defined in the runtime resource table definitions, via either the control region start (STRCICS command) or a previous INSCICSGRP command issued for the control region, the table entry replaces the existing runtime resource table definition if it is currently not in use. You can install new entries, but not amended entries, for the following tables:

• Destination control table
• File control table
• Journal control table

The INSCICSGRP CL command ignores the following tables in the group:

• Group list table
• System initialization table
• Temporary storage table

Required parameters

1. CICS control region (CTLRGN)
2. Enter the name of the active CICS/400 control region that the table entries are to be defined to the runtime resource table definitions.
control-region:The control region name may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or$, @, or #.
3. Library (LIB)
4. Enter the name of the OS/400 library that contains the group. Possible values are:
*LIBL: The library list is used to locate the first OS/400 library that contains the group.
*CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
library-name:The name of the OS/400 library that contains the group.
5. Group (GROUP)
6. Enter the name of the group to be installed.
group-name:The group name 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$, @, or #.

Examples

INSCICSGRP CTLRGN(PURC) LIB(CICSWORK) GROUP(ACCT)

This command defines the table entries located in group ACCT in OS/400 library CICSWORK to the runtime resource definition for the active CICS/400 control region PURC.

Using the SAVCICSGRP command
Flowchart

Notes:

1. LIB(QTEMP) may not be used with TGTRLS(*PRV).

2. A maximum of 50 repetitions.

3. All parameters preceding this point can be specified positionally.

Function
The Save CICS/400 Groups (SAVCICSGRP) command causes the specified groups in the library to be saved by using the SAVOBJ system command. The objects can be saved for use on either the current release or a supported previous release. The supported previous releases are the last release of the previous version and the previous release of the current version. The required release is specified in the TGTRLS parameter.

When TGTRLS has a previous release value, resource definition tables for the specified groups are converted to the previous release of CICS/400 and placed in the QTEMP library. The resource definitions in the QTEMP library are saved in the file specified in the SAVF parameter.

Groups containing resource tables that specify features that are not supported in the previous release are not saved.

Optional parameters

1. Library (LIB)
2. 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.
3. Group (GROUP)
4. Enter the name of the group(s) to be saved.
Possible values are:
*ALL: All groups in the library will be saved(except those containing resource tables that specify features that are not supported on the target release).
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 #.
5. Save file (SAVF)
6. 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 must be empty, that is, either newly allocated or cleared using the CLRSAVF CL command. Otherwise the SAVOBJ command will fail.
Possible values are:
*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.
7. Target release (TGTRLS)
8. Enter the release of CICS/400 on which you intend to save the object.
Possible values are:
*CURRENT: The object is to be used on the release of CICS/400 currently running on your system. For example, if Version 5 Release 2 is running on the system, *CURRENT means you intend to use the object on a system with Version 5 Release 2 installed.
*PRV: The object is to be used on a supported previous release of the CICS/400 system. For example, if Version 5 Release 2 is running on your system, *PRV means you intend to use the object on a system with Version 5 Release 1 installed.
release-level:Specify the release in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R1M0 is version 5, release 1, modification level 0. The object can be used on a system with the specified release. Valid values depend on the current version, release, and modification level,and they change with each new release.

Using the WRKCICSGRP command
Flowchart

Notes:

1. All parameters preceding this point can be specified positionally.

Function
Use the Work with CICS/400 Group (WRKCICSGRP) command to list all groups in the OS/400 library. This command allows new groups to be created, and existing groups to be changed, deleted, installed, recovered, and saved.

Optional parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that contains the group.
Possible values are:
*LIBL: The library list is used to locate all of the groups that are in the OS/400 libraries specified in the OS/400 library list.
*CURLIB: The current library contains the group. If no library is specified as the current library, the QGPL library is used.
library-name:Specify the name of the OS/400 library that contains the group.
3. Group (GROUP)
4. Enter the name of the group to work with.
Possible values are:
*ALL: All the groups that are associated with the OS/400 library are listed.
*FIRST: No group is specified. The first group found is used.
group-name:The group name 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$, @, or #.

Examples
WRKCICSGRP LIB(CICSWORK)

This command lists group ACCT in library CICSWORK.