CSD STARTBRRSRCE

Start a browse of the resources in a specified group.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

CSD STARTBRRSRCE

Read syntax diagramSkip visual syntax diagramCSDSTARTBRRSRCEGROUP( data-value)

Conditions: CSDERR, ILLOGIC, NOTAUTH. NOTFND

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The CSD STARTBRRSRCE command starts a browse of all the resource definitions in a specified group.

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

GROUP(data-value)
Specifies the 8-character name of the group to be browsed.

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 resource browse or a conflicting browse 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:
2
The specified group cannot be found.