The DSNAMED view shows detailed information about a data set associated with installed CICS files.
The DSNAME view is available all managed CICS systems.
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.
Figure 65 is an example of 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
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.
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:
|
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. |
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. |
Table 132 shows the hyperlink field on the DSNAMED view.
Hyperlink field | View displayed | Description |
---|---|---|
Base Dataset | DSNAMED | Detailed view of the base data set. |