DSNAMED - Data set details

The DSNAMED view shows detailed information about a data set associated with installed CICS files.

Note:
Full data set information is not available when the open status of one or more files in the data set is CLOSED.

Availability

The DSNAME view is available all managed CICS systems.

Access

Issue command:
DSNAMED dataset sysname

dataset
is the name of a data set that is associated with installed CICS files.

sysname
is the name of the CICS® system where the data set is located. The CICS system must be within the current scope.

Hyperlink from:
the Dataset Name field of a DSNAME, LOCFILE, or CMDTD view.

Figure 65 is an example of the DSNAMED view.

Figure 65. The DSNAMED view
 27FEB2005  18:26:19 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =DSNAME===DSNAMED==EYUPLX01=EYUPLX01=27FEB2005==18:26:11====CPSM===========1
     Dataset Name...          PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD
     CICS System....                                     EYUMAS1A
     Access Method..                                         VSAM
     Availability...                                    AVAILABLE
     Object Type....                                         BASE
     Base Dataset...          PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD
     File Count.....                                            1
     Validity Check.                                        VALID
     Backout Status.                                  NORMALBKOUT
     Forward Rec Log                                           -1
     Recovery Status                                 UNDETERMINED
     Backup Type....                                 UNDETERMINED
     Recovery LogStream                                       N/A
     Lost Locks                                               N/A
     Quiesce State..                                          N/A
     Retained Locks.                                  NOTRETAINED
 
 

Action commands

Table 130 shows the action commands you can issue from the DSNAMED view. The overtype field is shown in Table 131.

The action commands and overtype field for the DSNAMED view are available for all managed CICS systems for which DSNAMED is valid, except as noted in Table 131.

Table 130. DSNAMED view action commands
Primary command Line command Description
QUIesce QUI Displays the Quiesce State for Dataset input panel (Figure 63), which lets you specify whether the data set is to be immediately quiesced, quiesced when all units of work that are accessing the data set have reached syncpoint, or unquiesced.
REMove REM Removes the association between the data set and its CICS system and deallocates the data set. A data set can be removed only if its file count is 0 and its backout status is NORMALBKOUT.
ReSetLocks RSL (VSAM only.) Purges shunted unit of work log records for backout-failed and commit-failed unit of work that hold locks on the data set, and releases the retained locks. All records relating to this data set are removed from the system log and all retained record locks held for the data set are released.
Notes:
  1. This command cannot be used for shunted in-doubt units of work that hold locks on the data set. Before you issue the ReSetLocks command, use the UOW action command to resolve the in-doubt unit of work.
  2. When a ReSetLocks action fails during the commit phase, the units of work revert to being shunted as commit-failed.
n/a SET Sets a data set attribute according to the new value you specify in an overtype field (see Table 131).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
UOW UOW Displays the Shunted UOWs Holding Locks on Dataset input panel (Figure 64), which lets you specify whether a shunted in-doubt unit of work that holds a lock on this data set should be backed out, committed, forced, or retried.

Table 131. DSNAMED view overtype fields
Field name Values
Availability AVAILABLE | UNAVAILABLE (VSAM only).
Backout Status NORMALBKOUT | FAILEDBKOUT (VSAM only)
Cannot be modified in systems running the CICS TS for OS/390.

Hyperlinks

Table 132 shows the hyperlink field on the DSNAMED view.

Table 132. DSNAMED view hyperlink field
Hyperlink field View displayed Description
Base Dataset DSNAMED Detailed view of the base data set.
[[ Contents Previous Page | Next Page Index ]]