CSD INQUIRERSRCE
Inquire on the attributes of a resource in a specified group in the CSD.
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.
- 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.
- When used with the ATTRIBUTES option:
- 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.