CSD STARTBRGROUP

Start a browse of the groups in the CSD or of the groups in a list.

CSD STARTBRGROUP

Read syntax diagramSkip visual syntax diagramCSDSTARTBRGROUPLIST( data-value)

Conditions: CSDERR, ILLOGIC, NOTAUTH, NOTFND

Description

The CSD STARTBRGROUP command starts a CSD group browse. The browse can be of all the groups in the CSD, or of all the groups in a specified list.

Rules for concurrent browses

There are four distinct types of browse that can be used on the CSD:
  1. LIST browse of all the lists in the CSD.
  2. ALL GROUPS browse of all the groups in the CSD.
  3. GROUPS IN LIST browse of all the groups in a specified list.
  4. RESOURCE browse of all resources in a specified group.
The rules that govern concurrent browses in the same transaction are as follows:
  • Browses of the same type are not allowed together.
  • The LIST and ALL GROUPS browse are not allowed together.
  • The GROUPS IN LIST and RESOURCE browses are not allowed together.
The ILLOGIC condition is raised if these rules are broken.

For example, it is permitted to browse all groups in the CSD and, as each one is returned, browse all of the resources in that group.

Options

LIST(data-value)
Specifies the 8-character name of a list to which the browse is to be limited. If you do not specify this option, all groups in the CSD are returned on the browse.

Conditions

CSDERR
RESP2 value:
1
The CSD cannot be read.
4
The CSD is being used by another CICS system and is not configured for sharing.
5
Insufficient VSAM strings (CSDSTRNO system initialization parameter value) are available to run the EXEC CICS CSD command.
ILLOGIC
RESP2 value:
2
A browse of the same type or a conflicting type is already in progress.
NOTAUTH
RESP2 value:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 value:
3
The specified list cannot be found.