CSD INQUIRERSRCE

Inquire on the attributes of a resource in a specified group in the CSD.

CSD INQUIRERSRCE

Read syntax diagramSkip visual syntax diagramCSDINQUIRERSRCERESTYPE( cvda)ATOMSERVICEBUNDLECONNECTIONCORBASERVERDB2CONNDB2ENTRYDB2TRANDJARDOCTEMPLATEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMREQUESTMODELSESSIONSTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)ATTRIBUTES( data-area)ATTRLEN( data-area)SET( ptr-ref) ATTRLEN( data-area)

Conditions: CSDERR, INVREQ, LENGERR, NOTAUTH, NOTFND

Description

The CSD INQUIRERSRCE command queries the attributes of resources in a specified group on the CSD.

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 have 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-value)
Returns the 8-character name of the group containing the resource definition or resource definition attributes being queried.
RESID(data-value)
Returns the 8-character name of the resource definition whose attributes are being queried. Resource names such as TRANSACTION that are only four characters in length must be padded with four blanks.
RESTYPE(cvda)
Returns the resource type of the resource definition being queried. CVDA values are the resource type names.
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 INQUIRERSRCE resource command is issued or until the end of the task.

Conditions

CSDERR
RESP2 value:
1
The CSD cannot be read.
2
The CSD is defined as read-only.
3
There is no more space available in the CSD.
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.
INVREQ
RESP2 values:
1
The specified RESTYPE is not a valid resource type.
4
The RESID option contains one or more characters that are not valid for the specific resource type.
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.
NOTFND
RESP2 value:
1
The specified resource definition cannot be found.
2
The specified group cannot be found.