Physical data sets for files - DSNAME

The Physical data sets for files (DSNAME) views display information about data sets associated with installed CICS files.

Supplied views

To access from the main menu, click:

CICS operations views > File operations views > Physical data sets for files

Table 1. Views in the supplied **Physical data sets for files** (DSNAME) view set
View	Notes
Physical data sets for files EYUSTARTDSNAME.BACKOUT	Back out shunted UOWs holding locks on the specified data set.
Physical data sets for files EYUSTARTDSNAME.COMMIT	Commit shunted UOWs holding locks on the specified data set
Physical data sets for files EYUSTARTDSNAME.DETAILED	Detailed information about a selected data set
Physical data sets for files EYUSTARTDSNAME.FORCE	Force shunted UOWs holding locks on the specified data set to back out or commit
Physical data sets for files EYUSTARTDSNAME.IMMQUIESCE	Quiesce the data set immediately. All existing CICS open RLS ACBs are closed, all units of work accessing the data set are abended, the file state (if it is ENABLED) is set to UNENABLED, and the data set is marked as closed. You can set the data set Busy value to WAIT or NOWAIT. Any tasks currently using the data set are immediately terminated, using the CICS task FORCEPURGE.
Physical data sets for files EYUSTARTDSNAME.QUIESCE	Quiesce the data set when all units of work that are accessing the data set have reached syncpoint. You can set the data set Busy value to WAIT or NOWAIT.
Physical data sets for files EYUSTARTDSNAME.REMOVE	Remove the association between a data set and a CICS system and deallocate the data set. A data set can be removed only if its file count is 0 and its backout status is NORMALBKOUT.
Physical data sets for files EYUSTARTDSNAME.SET	Set data set attributes according to new values specified in input fields
Physical data sets for files EYUSTARTDSNAME.TABULAR	Tabular information about currently installed data sets
Physical data sets for files EYUSTARTDSNAME.UNQUIESCE	Mark the data set as unquiesced. RLS or non-RLS ACBs can be opened. Subsequent open ACB requests are permitted in the same mode as the first open ACB. You can set the data set Busy value to WAIT or NOWAIT.

Actions

Table 2. Actions available for DSNAME views
Action	Description
BACKOUT	Back out shunted UOWs holding locks on the specified data set.
COMMIT	Commit shunted UOWs holding locks on the specified data set
FORCE	Force shunted UOWs holding locks on the specified data set to back out or commit
IMMQUIESCE	Quiesce the data set immediately. All existing CICS open RLS ACBs are closed, all units of work accessing the data set are abended, the file state (if it is ENABLED) is set to UNENABLED, and the data set is marked as closed. You can set the data set Busy value to WAIT or NOWAIT. Any tasks currently using the data set are immediately terminated, using the CICS task FORCEPURGE.
QUIESCE	Quiesce the data set when all units of work that are accessing the data set have reached syncpoint. You can set the data set Busy value to WAIT or NOWAIT.
REMOVE	Remove the association between a data set and a CICS system and deallocate the data set. A data set can be removed only if its file count is 0 and its backout status is NORMALBKOUT.
SET	Set data set attributes according to new values specified in input fields
UNQUIESCE	Mark the data set as unquiesced. RLS or non-RLS ACBs can be opened. Subsequent open ACB requests are permitted in the same mode as the first open ACB. You can set the data set Busy value to WAIT or NOWAIT.

Fields

Table 3. Fields in DSNAME views
Field	Attribute name	Description
Access method	ACCESSMETHOD	The access method used with this data set: BDAM, VSAM, or NOTAPPLIC.
Availability status	AVAILABILITY	For VSAM data sets, indicates whether or not the data set is available. Input Values: AVAILABLE, UNAVAILABLE, RREPL
Type of backup	BACKUPTYPE	Indicates the type of backup used for this data set. Values are: DYNAMIC - The data set is eligible for 'backup-while-open' (BWO) processing; that is, a data set manager with the required function can take a backup of the data set while it is open for output. The data set can also be backed up while it is closed. The data set is eligible for BWO and it is accessed in non-RLS mode. If the data set is opened in RLS mode, you need to look in the VSAM catalog to find out whether the data set is eligible for BWO. NOTAPPLIC is returned as the BACKUPTYPE for data sets opened RLS mode. NOTAPPLIC - The data set has not been opened by the CICS region in which the command is issued, or the data set is BDAM or a VSAM PATH. Also, if the data set has been opened in RLS mode, NOTAPPLIC is returned. The VSAM catalog should be referred to get the BWO status. STATIC - The data set is accessed in non-RLS mode, and is not eligible for BWO processing. All CICS files open for output against this data set must be closed before a data set manager, can take a backup copy. UNDETERMINED - Returned for base files if RECOVSTATUS is UNDETERMINED.
Base data set name	BASEDSNAME	For a VSAM path, the name of the base data set with which the path is associated. For a VSAM base data set, this name is the same as the primary data set name.
Backout status	BKOUTSTATUS	For VSAM data sets, indicates the backout status of the data set as one of: NORMALBKOUT, FAILEDBKOUT , FAILINGBKOUT, or NOTAPPLIC
Data set name	DSNAME	The name of the data set.
Number of file definitions that reference data set	FILECOUNT	The number of different file definitions that currently refer to this data set name. This value does not indicate whether any of the files have used the data set during this CICS session.
Journal number	FWDRECOVLOG	For VSAM data sets with a recovery status of FWDRECOVABLE, the ID of the journal that is used to log updates.
Forward recovery log stream name	FWDRECOVLSN	For VSAM data sets with a recovery status of FWDRECOVABLE, the ID of the journal that is used to log updates.
Replication Logging	LOGREPSTATUS	For VSAM data sets, indicates whether this data set has been defined to have replication logging. Valid values are: LOGREPLICATE, NOLOGREPLICA, NOTAPPLIC
Lost locks status	LOSTLOCKS	Indicates whether there are lost locks for this data set. The valid values are: NOLOSTLOCKS - The data set has no lost locks. REMLOSTLOCKS - .The data set has lost locks. RECOVERLOCKS - The data set has lost locks and therefore is unavailable. NOTAPPLIC - This is not an RLS data set, or the data set has not been opened by the CICS region in which the command is issued.
Data set type	OBJECT	For VSAM data sets, indicates whether this data set is a base data set containing records (BASE), a path to another data set (PATH), or (NOTAPPLIC) if the dataset has not been opened by this CICS region, or if it is a BDAM dataset.
Record level sharing (RLS) quiesce state	QUIESCESTATE	The RLS quiesce state of the data set. The information is obtained from the ICF catalog entry for the data set. Valid input values are: Quiesced - A data set has been quiesced. RLS ACBs cannot open against the data set and no CICS region has an RLS ACB currently open against this data set. However, the data set can be opened in non-RLS mode. Unquiesced - This is the normal value for a data set that is not quiescing or has not been quiesced. It indicates that RLS or non-RLS ACBs can be opened against the data set, the mode being established by the first open. After an ACB is opened in one mode, other ACBs can be opened only in the same mode.
Recovery status	RECOVSTATUS	Indicates the recovery characteristics of the data set as follows: FWDRECOVABLE - All updates to the data set are logged for both backout and forward recovery NOTAPPLIC - This is a BDAM data set or a VSAM path, or the data set has not been opened by the CICS region in which the command is issued. 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 files associated with this data set have been opened, or because the only files opened were defined as coupling facility data tables or as user-maintained data tables (where the recovery attributes are independent of the associated data set).
Retained record locks status	RETLOCKS	Indicates whether or not there are any retained locks as a result of deferred recovery work for this data set. Valid values are: RETAINED, NORETAINED and NOTAPPLIC.
Data set validity status	VALIDITY	For VSAM data sets, indicates whether the data set name has been validated against the VSAM catalog by opening a file against that data set (VALID or INVALID). If this value is INVALID, the recovery status of the data set cannot be determined.