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

March 30, 1979
44.2 IBM VM/370 eMS User's Guide

The LISTFILE command allows you to request similar lists. If yc
specify an asterisk for a filename or filetype, all of the files of that
filename or filetype are listed. There is an additional feature that you
can use with the LISTFILE command, to obtain a list of all the files
that have a filename or filetype that begin with the same character
string. For example:
listfile t* assemble
produces a list of all files on your A-disk whose filenames begin with
the letter T. The command:
listfile tr* a*
produces a list of all files on your A-disk whose filenames begin with
the letters TR and whose filetypes begin with the letter A.
The COPYFILE, RENAME, and SORT commands allow you to enter output file
identifiers as equal signs (=), to indicate that it is the same as the
corresponding input file identifier. For example:
copyfile myprog assemble b = = a
copies the file MYPROG ASSEMBLE from your B-disk to your A-disk, and
uses the same filename and filetype as specified in the input fileid for
those positions in the output fileid.
Similarly, if you enter the command:
rename temp * b perm
all files with a filename of TEMP are renamed to have filenames of PERM; the existing filetypes of the files remain unchanged.
What Are Reserved Filetypes? For the purposes of most CMS commands, the filetype field is used merely
as an identifier. Some filetypes, though, have special uses in CMS; these are known as "reserved filetypes."
Nothing prevents you from assigning any of the reserved filetypes to
files that are not being used for the specific CMS function normally
associated with that filetype.
Some reserved filetypes also have special significance to the CMS editor. When you use the EDIT command to create a file with a reserved
filetype, the editor assumes various default characteristics for the
file, such as record length and format, tab settings, translation to
uppercase, truncation column, and so on.
Section 4. The CMS File system 45

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)

March 30, 1979
44.2 IBM VM/370 eMS User's Guide

The LISTFILE command allows you to request similar lists. If yc
specify an asterisk for a filename or filetype, all of the files of that
filename or filetype are listed. There is an additional feature that you
can use with the LISTFILE command, to obtain a list of all the files
that have a filename or filetype that begin with the same character
string. For example:
listfile t* assemble
produces a list of all files on your A-disk whose filenames begin with
the letter T. The command:
listfile tr* a*
produces a list of all files on your A-disk whose filenames begin with
the letters TR and whose filetypes begin with the letter A.
The COPYFILE, RENAME, and SORT commands allow you to enter output file
identifiers as equal signs (=), to indicate that it is the same as the
corresponding input file identifier. For example:
copyfile myprog assemble b = = a
copies the file MYPROG ASSEMBLE from your B-disk to your A-disk, and
uses the same filename and filetype as specified in the input fileid for
those positions in the output fileid.
Similarly, if you enter the command:
rename temp * b perm
all files with a filename of TEMP are renamed to have filenames of PERM; the existing filetypes of the files remain unchanged.
What Are Reserved Filetypes? For the purposes of most CMS commands, the filetype field is used merely
as an identifier. Some filetypes, though, have special uses in CMS; these are known as "reserved filetypes."
Nothing prevents you from assigning any of the reserved filetypes to
files that are not being used for the specific CMS function normally
associated with that filetype.
Some reserved filetypes also have special significance to the CMS editor. When you use the EDIT command to create a file with a reserved
filetype, the editor assumes various default characteristics for the
file, such as record length and format, tab settings, translation to
uppercase, truncation column, and so on.
Section 4. The CMS File system 45

Help

Pg. of GC20-1819-2 Rev March 30, 1979 by Supp. SD23-9024-1 for 5748-XX8 DISK LOGICAL BLOCK SIZE II£.§ 2314 21 11 5 3330-11 149 86 44 3340 50 26 11 3350 45 25 13 3310 55 29 15 3370 216 114 59
How eMS Files Get Their Names When you create a CMS file, you can give it any filename and filetype
you wish. rules for forming filenames and filetypes are: • The filename and filetype can each be from one to eight characters. • The valid characters are A-Z, 0-9, and $, I, a. When you enter a command line into the VM/370 system, VM/370 always
translates your input line into uppercase characters. So, when you
specify a file identifier, you can enter it in lowercase.
Remember that, by default, the t and m characters are line editing symbols in VM/370i when you use them to identify a file, you must
precede them with the logical escape symbol (").
The third field in the file identifier, the filemode, indicates the
mode letter (A-Z) currently assigned to the virtual disk on which you
want the file to reside. When you use the CMS editor to create a file,
and you do not specify this field, the file you create is written on
your A-disk, and has a filemode letter of A.
The filemode letter, for any file, can change during a terminal
session. For example, when you log on, your virtual disk at address 191
is accessed as your A-disk, so a file on that disk named SPECIAL EVENTS has a file identifier of: SPECIAL EVENTS A
If, however, you later access another disk as your A-disk, and access
your 191 as your B-disk, then this file has a file identifier of: SPECIAL EVENTS B DUPLICATING FILENAMES AND FILETYPES You can give the same filename to as many files on a given disk as you
want, as long as you assign them different filetypes. Or you can create
many files with the same filetype but different filenames.
For the most part, filenames that you choose for your files have no
special significance to CMS. If, however, you choose a name that is the same as the name of a CMS command, and the file that you assign this
name to is an executable module or EXEC procedure, then you may encounter difficulty if you try to execute the CMS command whose name
you duplicated.
44 IBM VM/370 CMS User's Guide

Pg. of GC20-1819-2 Rev March 30, 1979 by SUppa SD23-9024-1 for 5748-118 For an explanation of how CMS id.ntifies a command namS, see "CftS Command Search Order" later in this section. Many CMS commands allow you to specify one or more of the fields in a
file identifier as an asterisk (*) or equal sign (=), which identify
files with similar fileids. Some CMS commands that manipulate disk files allOW you to enter the filename and/or filetype fields as an asterisk (*), indicating that all
files of the specified filename/filetype are to be mOdified. These
commands are: COPYFILE ERASE RENAME TAPE DUMP For example, if you specify:
erase * test a
all files with a filetype of TEST on your A-disk are erased.
Section 4. The CftS File System 44.1

Previous Page Next Page

FILETYPES FOR CMS COMMANDS Reserved filetypes sometimes indicate how the file is used in the CES system: the filetype ASSEMBLE, for example, indicates that the file is
to be used as input to the assembler; the filetype TEXT indicates that
the file is in relocatable object form, and so on. Many CMS commands
assume input files of particular filetypes, and require you to enter
only the filename on the command line. For example, if you enter:
synonym test CMS searches for a file with a filetype of SYNONYM and a filename of TEST. A file named TEST that has any other filetype is ignored. Some CMS commands create files of particular filetypes, using the
filename you enter on the command line. The language processors do this
as well; if you are recompiling a source file, but wish to save previous
output files, you should rename them before executing the command.
Figure 2 lists the filetypes used by CMS commands and describes how
they are used. Figure 3 lists the filetypes used by CES/DOS commands.
In addition to these CMS filetypes, there are special filetypes
reserved for use by the language processors, which are IBM program
products. These filetypes, and the commands that use them, are: COBOL, SYMDMP, TESTCOB FORTRAN, FREEFORT, FTnn001, TESTFORT PLI, PLIOPT VSBASIC, VSBDATA £9!mgQg§ COBOL, FCOBOL, TESTCOB FORTRAN, FORTGI, FORTHX GOFORT, TESTFORT DOSPLI, PLIC, PLICR, PLIOPT VSBASIC For details on how to use these filetypes, consult the appropriate
program product documentation.
46 IBM VM/370 eMS User's Guide

Pg. of GC20-1819-2 Rev March 30, 1979 by Supp. SD23-9024-1 for 5748-XX8 Filetype AMSERV ASM3705 ASSEMBLE AUXxxxx CNTRL COpy DIRECT EXEC HELPCMS HELPCP HELPDEBU HELPEDIT HELPMENU HELPMSG LISTING LKEDIT LOADLIB MACLIB MACRO MAP Command AMSERV ASM3705 GEN 3705 ASSEMBLE UPDATE UPDATE MACLIB
DIRECT EXEC GEN3705 LISTFILE HELP AMSERV ASSEMBLE ASM3705 LKED
LKED GLOBAL MACLIB
MACLIB INCLUDE LOAD MACLIB TAPE TXTLIB Comments
Contains VSAM access method services control
statements to be executed with the AMSERV command. Used by system programmers to generate the 3704/3705 control program.
Contains source statements for assembler
language programs.
Points to files that contain UPDATE control
statements for multiple updates.
Lists files that either contain UPDATE control
statements or point to additional files.
Can contain COpy control statements and macros
or copy files to be added to MACLIBs.
Contains entries for the VM/370 user directory
file. The system operator controls this file.
Can contain sequences of CMS or user-written
commands, with execution control statements.
Contains descriptive information for CP and CMS commands, messages, and menu lists.
Listings are produced by the assembler and
the language processors as well as the AMSERV command.
Contains the listing created during the
generation of the 3704/3705 control program.
Is a library of 3704/3705 control program
load modules created during 3704/3705 control
program generation.
Library members contain macro definitions or
copy files; the MACLIB command creates the
library, and lists, adds, deletes, or replaces
members. The GLOBAL command identifies which
macro libraries should be searched during an
assembly or compilation.
Contains macro definitions to be added to a CMS macro library (MACLIB). Maps created by the LOAD and INCLUDE commands
indicate entry point locations; the MACLIB, TXTLIB, and TAPE commands produce MAP files. L- ___________________________________________________________________________ J Figure 2. Filetypes Used by CMS Commands (Part 1 of 2) Section 4. The CMS File System 47

Previous Page Next Page

Extracted Text (may have errors)

Help

loading