STATE, STATEW STATE/STATEW Use the STATE command to verify the existence of a OS, or DDS file
on any accessed disk; use the STATEi command to verify the existence of
a CMS, JS, or DOS file on any accessed read/write disk. Tne formats of
the STATE and STATEW commands are: r- -----, , {STATE } I STATEW L- I , fn is the filename of the file whose existence is to be verified. If
fn is specified as *, the first file found satisfying the rest of
the fileid is used.
ft is the filetype of the file whose existence is to be verified. If
ft is specified as *, the first file found satisfying the rest of
the fileid is used. fm is the filemode of the file whose existence is to be verified. If
fm is omitted, or specified as *, all your disks are searched.
1. If you issue the STATEi command specifying a file that exists on a Lead-only disk, you receive error message DMSSTT002E. 2. When you code an asterisk in the fn or ft fields, the search for
the file is ended as soon as any file satisfies any of the other
conditions. For example, the command:
state * file
executes successfully if any file on any accessed disk (including
the system disk) has a filetype of FILE.
3. To verify the existence of an OS or DOS file when DOS is set JFF, you must issue the FILEDEF command to establish a CMS file
identifier for the file. For example, to verify the existence of
the OS file TEST. DATA on an OS C-disk you could enter:
filedef check disk check list c dsn test data
state check list whaLe CHECK LIST is the CMS filename and filetype associated with
the OS data set name.
4. To verify the existence of an OS or DOS file when the CMS/DOS en,ironment is active, you must issue the DLBL command to establish
a file identifier for the file. For example, to verify the
existence of the DOS file TEST. DATA on a DOS C-disk, you could
enter:
dlbl check c dsn test data
state file check wheLe FILE CHECK is the default CMS filename and filetype (FILE
ddname) associated with the DOS file-ide Section 2. CMS :ommands 177
STATE, STATEW 5. You can invoke the STATE/STATEW command from the terminal, from an EtEC file, or as a function from a program. If STATE/STATEW is invoked as a function or from an EXEC file that has the &CONTROL NOMSG option in effect, the message DMSSTT002E FILE 'fn ft fm' NOT FOUND is not issued.
The CMS ready message indicates that the specified file exists. DMSSTT227I PROCESSING VOLUME 'no' IN DATA SET 'data set name'
The specified data set has multiple volumes; the volume being
processed is shown in the message. The STATE command treats
end-of-volume as end-of-file and there is no end-of-volume
switching. DMSSTT22AI USER LABELS BYPASSED ON DATA SET 'data set name'
The specified data set has disk user labels; these labels are skipped. DMSSTT002E DMSSTT048E DMSSTT054E DMSSTT062E DMSSTT06gE DMSSTT010E DMSSTT22gE DMSSTT253E FILE 'fn ft fm' NOT FOUND RC=28 INVALID MODE 'mode' RC=24 INCOMPLETE FILEID SPECIFIED RC=24 INVALID 'char' IN FILEID 'fn ft' RC=20 DISK 'mode' NOT ACCESSED RC=36 INVALID PARAMETER 'parameter' RC=24 UNSUPPORTED OS DATA SET, ERROR 'code'
FILE 'fn ft fm' CANNOT BE HANDLED WITH
178 VM/370 CMS Command and Macro Reference
RC=code SUPPLIED PLIST RC=88
Previous Page Next Page