CMS User's Guide (Rel 6 PLC 17 Apr81) Page 76 (76 of 493)

Paqe of GC20-1819-2 As Updated April 1, 1981 by TNL GN2S-0826 Note that if a TEXT file contains control changes for the terminal,
the edit lines may not be displayed in their true form. Therefore, it
is you do not use the editor for TEXT files, because the
results are unpredictable. Instead, use the TYPE and/or PRINT com.ands
with the HEX option to display TEXT decks. Put TEXT decks into a TXTLIB and ZAP the TXTLIB to modify the TEXT deck. FILErYPES FOR FILES The filetvpes of files created by the assembler and lanquage processors for use as temporary work files are: SYSUT1 SYSUT2 SYSUT3 SYSUT4 SYS001 SYS002 SYS003 SYS004 SYS005 SYS006 CMS all SYSUTx and SYSOOx files as temporary files.
The :MS command, executing VSAM utility functions, uses two
workfiles that have filetypes of LDTPDI1 and LDTFDI2.
Disk spa=e is allocated for temporary files on an as-needed basis.
Thev are erased when processinq is complete. If a proqram you are
executina is terminated before completion, these vorkfiles may remain on vour nisk. Vou can erase them.
The filetvpe is used by CMS commands that create files on your The CMSUT1 file is used as a workfile and is erased when the
file is When a command fails to complete execution properly,
the file mav not be erased. Note that CMSUT1 files are reserved
for system usaqe and that usinq them for your own purposes viII lead to
unpredictable results. - The :ommands, and the filenames they assign to files they create, are
listed below. COPYFILE DISK LOAD EDIT INCLUDE LOAD READCARD TAPE LOAD (J1?DATE COPYFILF DISK EDIT D"!SLDR DMSLDR D"!SLB'i READCARD TAPF. fn (the filename of the UPDATE file) PILETYPES FOR DOCUMENTATION There are two :"!s reserved filetypes that accept uppercase and lowercase input iata. are MEMO and SCRIPT. You can use MEMO files to docament notes or to write reports. The SCRIPT filetvpe is used
by the SCRIPT command, which invokes a text processor that is an IBM Installed User Proqram (IUP). SO IBM User's Guide

Page of GC20-1819-2 As Updated April 27, 1981 by TNL SN25-0828 For 5748-XE1 Filemode Letters and Numbers
The filemode field of a CMS file identifier has two characters: the
filemode letter and the filemode number. The filemode letter is
established by the ACCESS command and specifies the virtual disk on
which a file resides: A through Z. The filemode number is a number from
o to 5, which you can assign to the file when you create it or rename
it; if you do not specify it, the value defaults to 1. How you access
your disks and what filemode letters you give them with the ACCESS command depends on how you want to use the files that are on them.
For most of the reading and writing you do of files, you use your
A-disk, which is also known as your primary disk. This is a read/write
disk. You may access other disks in your configuration, or access
linked-to disks, in read-only or read/write status, depending on whether
you have a read-only or read/write link.
When you load CMS (with the IPL command), your virtual disk at
address 191 is accessed for you as your A-disk. Your virtual disk at
address 190 (the system disk) is accessed as your S-diski and the disk
at 19E is accessed as an extension of your S-disk, with a mode letter of Y. Because S- and Y-disks are accessed only for Mode S2 and Y2 files,
you must use these modes when accessing them (ACCESS 190 S * * S2, or ACCESS 19E Y * * Y2). In addition, if you have a disk defined at
address 192 and it is CMS formatted, it is accessed for you as your
D-disk. If the 192 disk has not been formatted, CMS will do it
automatically and label the minidisk ·SCRTeH'. If ACCESS is the first command issued after an IPL of the CMS system,
only the A-disk is not automatically defined. Another ACCESS command
must be issued to define the A-disk.
The actual letters you assign to any other disks (and you may
reassign the letters A, D, and Y), is arbitrary; but it does determine
the CMS search order, which is the order in which CMS searches your
disks when it is looking for a file. The order of search (when all disks
are being searched) is alphabetical: A through Z. If you have duplicate
file identifiers on different disks, you should check your disk search
order before issuing commands against that filename to be sure that you
will get the file you want. You can find out the current search order
for your virtual disks by issuing the command:
query search You can also access disks as logical extensions of other disks, for
example:
access 235 b/a
The "/A" indicates that the B-disk is to be a read-only extension of the
A-disk, and the A-disk is considered the "parent" of the B-disk. A disk
may have many extensions, but only one level of extension is allowed.
Note that if you ACCESS a disk as a logical extension and it does not
contain any files, the access will fail and will return the message: DMSACCOGOE FILE NOT FOUND Section 4. The CMS File System 51

Previous Page Next Page

Page 1GC20-1819-2_IBM_Virtual_Machine_Facility_370_CMS_Users_Guide_Rel_6_PLC_17_Apr81.pdf

Extracted Text (may have errors)

Paqe of GC20-1819-2 As Updated April 1, 1981 by TNL GN2S-0826 Note that if a TEXT file contains control changes for the terminal,
the edit lines may not be displayed in their true form. Therefore, it
is you do not use the editor for TEXT files, because the
results are unpredictable. Instead, use the TYPE and/or PRINT com.ands
with the HEX option to display TEXT decks. Put TEXT decks into a TXTLIB and ZAP the TXTLIB to modify the TEXT deck. FILErYPES FOR FILES The filetvpes of files created by the assembler and lanquage processors for use as temporary work files are: SYSUT1 SYSUT2 SYSUT3 SYSUT4 SYS001 SYS002 SYS003 SYS004 SYS005 SYS006 CMS all SYSUTx and SYSOOx files as temporary files.
The :MS command, executing VSAM utility functions, uses two
workfiles that have filetypes of LDTPDI1 and LDTFDI2.
Disk spa=e is allocated for temporary files on an as-needed basis.
Thev are erased when processinq is complete. If a proqram you are
executina is terminated before completion, these vorkfiles may remain on vour nisk. Vou can erase them.
The filetvpe is used by CMS commands that create files on your The CMSUT1 file is used as a workfile and is erased when the
file is When a command fails to complete execution properly,
the file mav not be erased. Note that CMSUT1 files are reserved
for system usaqe and that usinq them for your own purposes viII lead to
unpredictable results. - The :ommands, and the filenames they assign to files they create, are
listed below. COPYFILE DISK LOAD EDIT INCLUDE LOAD READCARD TAPE LOAD (J1?DATE COPYFILF DISK EDIT D"!SLDR DMSLDR D"!SLB'i READCARD TAPF. fn (the filename of the UPDATE file) PILETYPES FOR DOCUMENTATION There are two :"!s reserved filetypes that accept uppercase and lowercase input iata. are MEMO and SCRIPT. You can use MEMO files to docament notes or to write reports. The SCRIPT filetvpe is used
by the SCRIPT command, which invokes a text processor that is an IBM Installed User Proqram (IUP). SO IBM User's Guide

Page of GC20-1819-2 As Updated April 27, 1981 by TNL SN25-0828 For 5748-XE1 Filemode Letters and Numbers
The filemode field of a CMS file identifier has two characters: the
filemode letter and the filemode number. The filemode letter is
established by the ACCESS command and specifies the virtual disk on
which a file resides: A through Z. The filemode number is a number from
o to 5, which you can assign to the file when you create it or rename
it; if you do not specify it, the value defaults to 1. How you access
your disks and what filemode letters you give them with the ACCESS command depends on how you want to use the files that are on them.
For most of the reading and writing you do of files, you use your
A-disk, which is also known as your primary disk. This is a read/write
disk. You may access other disks in your configuration, or access
linked-to disks, in read-only or read/write status, depending on whether
you have a read-only or read/write link.
When you load CMS (with the IPL command), your virtual disk at
address 191 is accessed for you as your A-disk. Your virtual disk at
address 190 (the system disk) is accessed as your S-diski and the disk
at 19E is accessed as an extension of your S-disk, with a mode letter of Y. Because S- and Y-disks are accessed only for Mode S2 and Y2 files,
you must use these modes when accessing them (ACCESS 190 S * * S2, or ACCESS 19E Y * * Y2). In addition, if you have a disk defined at
address 192 and it is CMS formatted, it is accessed for you as your
D-disk. If the 192 disk has not been formatted, CMS will do it
automatically and label the minidisk ·SCRTeH'. If ACCESS is the first command issued after an IPL of the CMS system,
only the A-disk is not automatically defined. Another ACCESS command
must be issued to define the A-disk.
The actual letters you assign to any other disks (and you may
reassign the letters A, D, and Y), is arbitrary; but it does determine
the CMS search order, which is the order in which CMS searches your
disks when it is looking for a file. The order of search (when all disks
are being searched) is alphabetical: A through Z. If you have duplicate
file identifiers on different disks, you should check your disk search
order before issuing commands against that filename to be sure that you
will get the file you want. You can find out the current search order
for your virtual disks by issuing the command:
query search You can also access disks as logical extensions of other disks, for
example:
access 235 b/a
The "/A" indicates that the B-disk is to be a read-only extension of the
A-disk, and the A-disk is considered the "parent" of the B-disk. A disk
may have many extensions, but only one level of extension is allowed.
Note that if you ACCESS a disk as a logical extension and it does not
contain any files, the access will fail and will return the message: DMSACCOGOE FILE NOT FOUND Section 4. The CMS File System 51

Help

April 27, 1981
If you have a disk accessed as an extension of another disk, the
extension disk is automatically read-only, and you cannot write on it. You miqht access a disk as its own extension, therefore, to protect the
files on it, so that you do not accidentally write on it. For example:
access 235 bib
Another use of extensions is to extend the CMS search order. If you
issue a command requesting to read a file, for example:
type alpha plan CMS searches your A-disk for the file named ALPHA PLAN and if it does
not find it, searches any extensions that your A-disk may have. If you
have a file named ALPHA PLAN on your B-disk but have not accessed it as
an extension of your A-disk, CMS will not find the file, and you will
have to reenter the command:
type alpha plan b
Additionally, if you issue a CMS command that reads and writes a
file, and the file to be read is on an extension of a read/write disk,
the output file is written to the parent read/write disk. The EDIT
command is a qood example of this type of command. If you have a file
named FINAL LIST on a B-disk extension of a read/write A-disk, and if
you invoke the editor to modify the file with the command:
edit final list
after you have made modifications to the file, the changed file is
written onto your A-disk. The file on the B-disk remains unchanged. When you access a disk as a read-only extension, it remains an extension
of the parent disk as long as both disks are still accessed. If either
disk is released, the relationship of parent disk/extension is
terminat ed • If the parent disk is released, the extension remains accessed and
you may still read files on it. If you access another disk at the mode
letter of the oriqinal parent disk, the parent/extension relationship
remains in effect.
If you release a read-only extension and access another disk with the
same mode letter, it is not an extension of the original parent disk
unless you access it as such. For example, if you enter:
access 198 cia
release c
access 199 c
the C-disk at virtual address 199 is not an extension of your A-disk. WHEN TO SPECIFY FIIEMODE LETTERS: READING FILES When you request CMS to access a file, you have to identify it so that CMS can locate it for you. The commands that expect files of particular
52 IBM VM/370 eMS User's Guide

April 1, 1981 filetvpes (reserved filetyues) allow you to enter only the filename of
the file when you issue the command. When you execute any of these or execute a MODULE or FrEe file, searches all of your disks (usinq the standard search order) to locate the file.
The that perform this type of search are: DOSLIE EXEC Some commands
identify file. Yoa specify the filemode,
when it looks the
disk yOJ specify and vou use this
EDIT FILEDEF PRINT GLOBAL LOAD KODKAP RUN TXTLIB require you to enter the and filetype to
may specify the filemode letter; if you do not searches only your A=disk and its extensions
file. If you do specify a filemode letter, the
its extensions are searched for the file. The
way are: STATE SYNONYM TAPE DUMP TYPE UPDATE There two CMS commands that do not search extensions of disks
when for files. They are: DISK LISTPItE You must explicitly enter the filemode if you want to use these commands
to list oc dump files that are on extensions. For some commands, if you specify the filemode of a file as an
asterisk, it indicates that you either do not know or do not care what
disk the file is on and you want eMS to locate it for you. For example,
if YJU enter: listfile myfile test *
the LIsrFILE command responds by listing all files on your accessed disks MVFTLE TEST. When you specify an asterisk for the filemode
of the CDPYFILE, ERASE, or PENAME commands, CMS locates all copies of
the specified file. For example:
rename temp sort * qood sort
renames all files named TEMP SORT to GOOD SORT on all of your accessed
read/write An equal sign (=) is valid in output fileids for the RENAME ana COPYFILF commands.
For some commands, when you specify an asterisk for the filemode of a
file, stops searching as soon as it finds the first copy of the
file. example: type myfile assemble * Section The File System 53

Previous Page Next Page

Filetype MODULE SYNONYM SCRIPT! TEXT TXTLIB UPDATE UPDLOG UPDTxxxx ZAP
Command GENMOD LOADMOD MODMAP SYNONYM SCRIPT ASSEMBLE INCLUDE LOAD TXTLIB GLOBAL TITLIB UPDATE UPDATE UPDATE ZAP
March 30, 1979
Comments MODULE files created by the GEHMOD command are
nonrelocatable executable programs.
The LOADMOD commands loads a MODULE file for
execution; the MODMAP command displays a map
of entry point locations.
Contains a table of synonyms for CMS commands
and user-written EXEC and MODULE files. SCRIPT text processor input includes data and SCRIPT control words. TEXT files contain relocatable object code
created by the assembler and compilers. The LOAD and INCLUDE commands load them into
storage for execution. The TITLIB command
manipulates libraries of TEXT files.
Library members contain relocatable object
code. The TXTLIB command creates the library.
and lists or deletes existing members. The GLOBAL command identifies TITLIBs to search.
Contains UPDATE control statements for single
updates applied to source programs.
Contains a record of additions, deletions, or
changes made with the UPDATE command.
Contains UPDATE control statements for
multilevel updates.
Contains control records for the ZAP command,
which is used by system support personnel. 'SCRIPT is an IBM Installed User Program (IUP). Figure 2. Filetypes Used by CMS Commands (Part 2 of 2) OUTPUT FILES: TEXT AND LISTING Output files from the assembler and the language processors are
logically related to the source programs by their filenames. Some of
these files are permanent and some are temporary. For example, if you
issue the command:
assemble myfile CMS locates a file named MYFILE with a filetype of ASSEMBLE and the
system assembler assembles it. If the file is on your A-disk, then when
the assembler completes execution, the permanent files you have are: MYFILE ASSEMBLE A1 MYFILE TEIT A1 MYFILE LISTING A1
48 IBM VM/370 CMS User's Guide

r Filetype COpy DOSLTB DOSLNK ESERV EXEC tISTIN:; PRoe , TEXT L
April 1, 1981 Command Comments ! I MACtIB When the SSERV command copies books or macros I SSERV from DOS source statement libraries, the output I is written to COpy files, which can be addedl to CMS macro libraries with the MA:LIB command. I I DOSLIB DOS core image phases are placed in a DOSLIB by , linkage editor, invoked with the DOSLNK command.! FETCH The GLOBAL command identifies DOSLIBs to be ! GLOBAL searched when the FETCH command is executed. 1 ! DOSLKED contains linkage editor control statements for , input to the linkage editor. I I ESERV contains input control statements for the ESERV I utility program. I I LISTIO The LISTIO command with the EXEC option creates I the $LISTIO EXEC that lists system and I programmer logical unit assignments. I I ASSEMBLE Listinqs contain processor output from the ESERV! ESERV command, and compiler output from the assembler I and languaqe processors. ESEFV Contains SYSPCH output from the ESERV program, suitable for addition to a CMS MACLIB file. DOSLIE The DSERV command creates listings of the D05LKED directories of DOS libraries. The DOSLIB command, DSRRV with the MAP option produces a list of DOSLIB I members. The linkage editor map from the DOSLKEDI command is written into a MAP file. I I PSEFV The PSERV command copies procedures from DOS I procedure libraries into CMS PROC files. I I Object decks created by the assembler or I DOSLKED compilers are written into TEXT files. The RSERVI RSERV command creates TEXT files from modules in DOS I relocatable libraries. TEXT files can also be I used as input to the linkage editor. i
Figure 3. Filetypes Used in'CMS/DOS where the TEXT file contains the object code resulting from the
assembly, and the LISTING file contains the program listing generated by
the assembly. If an, TEXT or LISTING file with the same name previously
existed, it ig erased. The source input file, MYFILE ASSEMBLE A1, is
neither erased nor changed.
The of the TEXT and LISTING files produced by the assembler are same as those created by other processors and programs in CM.S. Because files are eMS files, you can use the CMS editor to
examine or modify their contents. If you want a printed copy of a LISTING file, you can use the PRINT command to print it. If you want to
examine a TEXT file, you can use the TYPE or PRINT command specifying
the HEX option.
Section 4. The CMS File System 49

Previous Page Next Page

Extracted Text (may have errors)

Help

loading