DSNAMES - Data sets summary

The DSNAMES view shows summarized information about data sets associated with installed CICS files. DSNAMES is a summary form of the DSNAME view.

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 for all managed CICS systems.

Access

Issue command:
DSNAMES [dataset]

Where the parameters are the same as those for DSNAME (see DSNAME - Data sets).

Select:
FILE from the OPERATE menu, and DSNAMES from the FILE submenu.
Summarize:
Issue the SUM display command from a DSNAME or DSNAMES view.

The DSNAMES view looks like the DSNAME view shown in Figure 62 with one addition: the Count field. This field appears next to the CICS System field, and indicates how many resources were combined to form each line of summary data.

By default, the view is summarized by CICS® system. If you place the cursor on a field of data and issue the SUM display command, the view is summarized by the data in that field.

Action commands

Table 133 shows the action commands you can issue from the DSNAMES view. These action commands affect all of the resources that were combined to form the summary line of data. The overtype field is shown in Table 134.

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

Table 133. DSNAMES view action commands
Primary command Line command Description
n/a 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.
n/a REM Removes the association between a data set and a 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
dataset sysname
RSL (VSAM only.) Purges shunted unit of work log records for backout-failed and commit-failed units 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 134).
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.
n/a 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 134. DSNAMES view overtype field
Field name Values
Backout Status NORMALBKOUT | FAILEDBKOUT (VSAM only)
Cannot be modified in systems running the CICS TS for OS/390.

Hyperlinks

From the DSNAMES view, you can hyperlink from the Count field to the DSNAME view to expand a line of summary data. The DSNAME view includes only those resources that were combined to form the specified summary line.

[[ Contents Previous Page | Next Page Index ]]