CSD GETNEXTRSRCE

Description

The CSD GETNEXTRSRCE command returns the details of the next resource in a browse started by a CSD STARTBRRSRCE command.

Options

ATTRIBUTES(data-area)

Specifies the data area in which a character string containing a list of attributes of the relevant resource is returned.

See The ATTRIBUTES option for general rules for specifying attributes.

See RDO resources for details about specific attributes.

ATTRLEN(data-area)

A fullword binary field containing one of the following values:

• When used with the ATTRIBUTES option:
  • On input ATTRLEN contains the maximum length of the attributes string that the application can accept. You do not need to specify ATTRLEN if the length can be generated by the compiler from the ATTRIBUTES variable.
  • On output, ATTRLEN contains the length of the attributes string returned. The LENGERR condition is raised if the attribute string is longer than the input ATTRLEN value.
• When used with the SET option, ATTRLEN is an output-only field that is set to the length of the attributes string.

GROUP(data-area)

Specifies the 8-character name of the group being browsed.

RESID(data-area)

Returns the 8-character name of the resource definition whose attributes are returned. Resource names such as TRANSACTION that are only four characters are padded with four blanks.

RESTYPE(cvda)

Returns a CVDA value that indicates the type of the resource definition. See CICS-value data areas used by all commands for the mapping between CVDA values and their numeric equivalents.

SET(ptr-ref)

Specifies a pointer reference that is set to the address of the returned attributes string. The pointer reference is valid until the next CSD GETNEXTRSRCE resource command is issued, or until the end of the task.

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.

END

RESP2 value:

1

The CSD or the specified list contains no more groups.

ILLOGIC

RESP2 value:

1

No resource browse is in progress.

LENGERR

RESP2 value:

1

The length of the ATTRIBUTES data area as specified on the ATTRLEN option passed to CICS is negative.

2

The length of the ATTRIBUTES data area as specified on the ATTRLEN option passed to CICS is less than the amount of data to be returned.

NOTAUTH

RESP2 value:

100

The user associated with the issuing task is not authorized to use this command.