Retrieves information about an object that is associated with a File Definitions (FD) stanza entry.

Sintaxe:

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

In TXSeries for Multiplatforms, the INQUIRE DSNAME command returns information about an object that is associated with a File Definition (FD) stanza entry.
This definition can represent a file on the Structured ile Server (SFS) server or a DB2^(R) table.

Comentários:

You can also browse through all the objects that are associated with files that are installed in your system.
To do this, use the browse options (START, NEXT, and END) on INQUIRE DSNAME commands.

Opções:

ACCESSMETHOD(cvda)
• Returns a CVDA value that indicates the access method that was used with this data set.
• The CVDA values are:
  • BDAM
    • The access method that is used is Basic Direct Access Method (BDAM).
  • VSAM
    • The access method that is used is emulated Virtual System Access Method (VSAM).
• TXSeries for Multiplatforms always returns the VSAM value.

BACKUPTYPE(cvda)
• Returns a CVDA value that identifies the type of backup that is used for this data set.
• The CVDA values are:
  • DYNAMIC
    • The data set is eligible to be backed up while it is open; this is called backup while open (BWO) processing.
    • All files are READONLY. The data set can also be backed up while it is closed.
  • STATIC
    • All CICS files that are open for output against this data set must be closed before a backup.
    • The files are not READONLY.
  • UNDETERMINED
    • The backup type is not known because no files that are associated with this data set have been opened.
• For TXSeries for Multiplatforms, a value of UNDETERMINED is always returned.

BKOUTSTATUS(cvda)
• Returns a CVDA value that identifies the backout status of the data set.
• Backout occurs when one of the files taht is associated with the data set is defined as recoverable and a transaction that has updated the file fails.
• The CVDA values are:
  • FAILEDBKOUT
    • An attempt to back out has failed, and file integrity is possibly lost.
  • FAILINGBKOUT
    • An attempt to back out has failed, and not all associated files have completed closing.
  • NORMALBKOUT
    • All backouts have been successful, or a backout has not been necessary.
• TXSeries for Multiplatforms always returns the NORMALBKOUT value.

BASEDSNAME(data-value)
• When the object of the inquiry is a path, the value that is returned is the 44-character name of the base cluster that is associated with a VSAM path.
• When the object is a VSAM data set, this option returns the same value as the value that the DSNAME option returns.
• For TXSeries for Multiplatforms, the returned value is always the same as the DSNAME value.

DSNAME(data-value)
• Specifies the 44-character identifier of the object about which you are inquiring.
• The object must be associated with a file definition that is installed in CICS.
• For TXSeries for Multiplatforms, the returned value is the name that is specified in the BaseName field of the FD stanza entry.

FILECOUNT(data-area)
• Returns a 32-bit binary field indicating the number of installed file definitions that refer to this data set.
• For TXSeries for Multiplatforms, the returned value indicates the number of alternate indexes that have been defined.
• This is because the file definitions all have the same BaseName attribute, but different IndexName attributes.

FWDRECOVLOG(data-area)
• Returns the number of the journal that is used to record the information that is required for forward recovery.
• The value is in 16-bit binary form.
• TXSeries for Multiplatforms always returns a null value for this option.
• Because the actual null value returned depends on the format of the user-defined data area, see Null values for a full description of the different types of null values.

OBJECT(cvda)
• Returns a CVDA value that indicates the type for the object of the inquiry.
• Two types are possible:
  • A VSAM path definition that links an alternate index to its base cluster
  • A VSAM data set that contains records that are either key-sequenced data set (KSDS), an entry-sequenced data set (ESDS), or a relative record data set (RRDS)
• The CVDA values that indicate these types are:
  • BASE
    • This is a data set that contains records that are either KSDS, ESDS, or RRDS.
  • PATH
    • This is a path.

RECOVSTATUS(cvda)
• Returns a CVDA value identifying the recovery characteristics of the data set.
• THE CVDA values are:
  • FWDRECOVABLE
    • All updates to the data set are logged for both backout and forward recovery.
  • NOTAPPLIC
    • This is a VSAM path.
  • NOTRECOVABLE
    • Updates to the data set are not logged.
  • RECOVERABLE
    • All updates to the data set are logged for backout.
  • UNDETERMINED
    • The recovery status is unknown because no file that is associated with this data set has been opened.
• TXSeries for Multiplatforms does not return the FWDRECOVABLE or UNDETERMINED values.

VALIDITY(cvda)
• Returns a CVDA value that identifies whether the data set has been opened successfully.
• THE CVDA values are:
  • INVALID
    • The data set name has not been validated either because validation has not yet occurred or validation has failed.
  • VALID
    • The data set name has been validated.
• You cannot find out what the value is for the RECOVSTATUS option of a data set unless the VALIDITY option has a setting of VALID.

Condições:

DSNNOTFOUND
• RESP2 values:
  • The data set cannot be found (RESP2=1).

END
• RESP2 values:
  • No more resource definitions exit for this type (RESP2=2).

ILLOGIC
• RESP2 values:
  • You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress (RESP2=1).