# Managing group list resource definitions - IBM - AS/400

Each resource definition must belong to a group and each group must belong to a group list. The group list table (GLT) must itself be assigned to a group. The library and group of the GLT is specified in the SIT and will be used at system startup to select the required resource definitions.

You can create more than one GLT, but each GLT must be assigned to a different group. Only the GLT named in the SIT will be used at system startup. At startup, each entry in the GLT is read and the resources installed from those groups, excluding the GLT and the SIT. If you want to install any resources belonging to the group named in the GLTGRP parameter of the SIT, then you must add the name of that group to its own GLT.

Each GLT entry specifies:

• The library name and group name of the GLT
• The library name and group name of a group to be installed at system startup

Flowchart

Notes:

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

Function

Required parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that contains the CICS/400 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 which the GLT entry is to be added.
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 #.
5. Install library (INSLIB)
6. The name of the OS/400 library that contains the group to be used when starting the control region. This is also known as the first part of the name of the GLT entry.
Note: When INSLIB(QCICS) is specified, then the INSGRP must be an IBM CICS/400 group.
Possible values are:
*LIBL: The library list for the job that is associated with the control region is used to locate the group.
*CURLIB: The current library for the job that is associated with the control region is used to locate the group. If no library is specified as the current library, the QGPL library is used.
library-name: Specify the name of the library where the group is located.
7. Install group (INSGRP)
8. The group to be used when starting the control region, that contains the tables. This is also known as the second part of the name of the GLT entry.

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

Note: When INSLIB(QCICS) is specified, then this must be one of the IBM groups.
The following describes which group is used to install which optional supplied transactions:

Group Supplied Transaction
AEGCLI CCIN - CICS Client INstall
CTIN - CICS Terminal INstall
AEGEDF CEBR - Browse Temporary Storage Queues
CEDF - Execution Diagnostic Facility
AEGINTER CECI - Command-Level Interpreter Facility
CECS – Command - Level Syntax-Checking Facility
AEGISC CMPX - Local Queuing Shipped
CPMI - Mirror Transaction
CRSR - Relay Transaction
CRTE - Transaction Routing
AEGOPER CEMT - Master Terminal Facility
AEGSPI CEDA - Resource Definition Online Facility

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

LIB(SAMPLE1)

GROUP(ACCT)

INSLIB(QCICS)

INSGRP(AEGEDF)
This command adds a GLT entry called QCICS AEGEDF to group ACCT in OS/400 library SAMPLE1.

Using the DSPCICSGLT command
Flowchart

Notes:

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

Function
Use the Display CICS/400 Group List Table (DSPCICSGLT) command to display a GLT entry. You can only view this entry; you can neither make changes to it nor delete it.

Optional parameters

1. Library (LIB)
2. Enter the name of the OS/400 library that contains the CICS/400 group.
Possible values are:
*LIBL: The library list is used to locate the first OS/400 library that contains the CICS/400 group.
*CURLIB: The current library contains the CICS/400 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 containing the GLT entry to be displayed.
Possible values are:
*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 #.
5. Install library (INSLIB)
6. Enter the name of the OS/400 library that contains the group to be listed.
Possible values are:
*FIRST: Display the first GLT entry that matches the INSGRP parameter value.
*ALL: Display all of the GLT entries that match the INSGRP parameter value.
*LIBL: Display all of the GLT entries that have *LIBL specified and that match the INSGRP parameter value.
*CURLIB: Display all of the GLT entries that have *CURLIB specified and that match the INSGRP parameter value.
library-name:The library 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 #.
generic*-inslib:Specify the generic name of the OS/400 library. A generic name is a string of one or more characters followed by an (*); for example, ABC*. If a generic name is specified, then all GLT entries with an OS/400 library name beginning with the generic name, and matching the INSGRP parameter value, are shown. If an asterisk is not included with the generic name, the system assumes the value to be the complete OS/400 library name.
7. Install group (INSGRP)
8. Enter the name of the group to be listed.
Possible values are:
*FIRST: Display the first GLT entry that matches the INSLIB parameter value.
*ALL: Display all of the GLT entries that match the INSLIB parameter value.
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 #. generic*-insgrp:Specify the generic name of the group. A generic name is a string of one or more characters followed by an asterisk(*); for example, ABC*. If a generic name is specified, then all GLT entries with a group name beginning with the generic name, and matching the INSLIB parameter value, are shown. If an asterisk is not included with the generic name, the system assumes the value to be the complete group name.
9. Location of output (OUTPUT)
10. Enter the location of the output from the DSPCICSFCT command.
Possible values are:
*: The output is either displayed (if requested by an interactive job) or printed with the job spool output (if requested by a batch job).
*PRINT: The output is printed with the job spool output.

Examples
DSPCICSGLT

LIB(SAMPLE1)

GROUP(ACCT)
This command displays the first GLT entry located in group ACCT in OS/400 library SAMPLE1.

Using the RMVCICSGLT command
Flowchart

Function
Use the Remove CICS/400 Group List Table (RMVCICSGLT) command to delete an entry from the GLT.

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 CICS/400 group.
*CURLIB: The current library contains the CICS/400 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 containing the GLT entry is to be removed.
Possible values are:
*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 #.
5. Install library (INSLIB)
6. Identifies the first part of the GLT entry to be removed. This is also known as the OS/400 library that contains the group to be used when starting the control region.
Possible values are:
*FIRST: Remove the first GLT entry that matches the INSGRP parameter value.
*ALL: Remove all of the GLT entries that match the INSGRP parameter value.
*LIBL: Remove all of the GLT entries that have *LIBL specified and that match the INSGRP parameter value.
*CURLIB: Remove all of the GLT entries that have *CURLIB specified and that match the INSGRP parameter value.
library-name:The library 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 #.
generic*-inslib:Specify the generic name of the OS/400 library. A generic name is a string of one or more characters followed by an (*); for example, ABC*. If a generic name is specified, then all GLT entries with an OS/400 library name beginning with the generic name, and matching the INSGRP parameter value, are removed. If an asterisk is not included with the generic name, the system assumes the value to be the complete OS/400 library name.
7. Install group (INSGRP)
8. Identifies the second part of the GLT entry to be removed. This is also known as the group to be used when starting the control region.
Possible values are:
*FIRST: Remove the first GLT entry that matches the INSLIB parameter value.
*ALL: Remove all of the GLT entries that match the INSLIB parameter value.
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 #.
generic*-insgrp:Specify the generic name of the group. A generic name is a string of one or more characters followed by an asterisk(*); for example, ABC*. If a generic name is specified, then all GLT entries with a group name beginning with the generic name, and matching the INSLIB parameter value, are removed. If an asterisk is not included with the generic name, the system assumes the value to be the complete group name.

Examples
RMVCICSGLT

LIB(SAMPLE1)

GROUP(ACCT)

INSLIB(QCICS)

INSGRP(AEGEDF)
This command removes the GLT entry called QCICS AEGEDF, located in group ACCT in OS/400 library SAMPLE1.

Using the WRKCICSGLT command
Flowchart

Notes:
1 All parameters preceding this point can be specified positionally.
Function
Use the Work with CICS/400 Group List Table (WRKCICSGLT) command to list entries in the GLT. You can remove copy or display entries, or add new entries to the list.

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 the first OS/400 library that contains the CICS/400 group.
*CURLIB: The current library contains the CICS/400 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 containing the GLT entries to be listed.
Possible values are:
*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 #.
5. Install library (INSLIB)
6. Enter the name of the first part of the GLT entry to be listed. This could also be known as the OS/400 library that contains the group to be used when starting the CICS/400 control region.
Possible values are:
*ALL: List all the GLT entries that match the INSGRP parameter value.
*FIRST: List the first GLT entry that matches the INSGRP parameter value.
*LIBL: List all GLT entries that have *LIBL specified and that match the INSGRP parameter value.
*CURLIB: List all GLT entries that have *CURLIB specified and that match the INSGRP parameter value.
library-name:The library 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 #.
generic*-inslib:Specify the generic name of the OS/400 library. A generic name is a string of one or more characters followed by an (*); for example, ABC*. If a generic name is specified, then all GLT entries with the OS/400 library name beginning with the generic name, and matching the INSGRP parameter value, are listed. If an asterisk is not included with the generic name, the system assumes the value to be the complete OS/400 library name.
7. Install group (INSGRP)
8. Enter the name of the second part of the GLT entry to be listed. This could also be known as the group to be used when starting the CICS/400 control region.
Possible values are:
*ALL: List all GLT entries that match the INSLIB parameter value.
*FIRST: List the first GLT entry that matches the INSLIB parameter value. 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 #.
generic*-insgrp:Specify the generic name of the group. A generic name is a string of one or more characters followed by an asterisk(*); for example, ABC*. If a generic name is specified, then all GLT entries with the group name beginning with the generic name, and matching the INSLIB parameter value, are listed. If an asterisk is not included with the generic name, the system assumes the value to be the complete group name.

Examples
WRKCICSGLT

LIB(SAMPLE1)

GROUP(ACCT)
This command lists all GLT entries located in group ACCT in OS/400 library SAMPLE1.