CMS FILE:
FILENAME
===>
IF NOT LINKED, SPECIFY:
OWNER'S 10
===>
DEVICE ADDR.===>
READ PASSWORD
===>
UPDATE PASSWORD===>
Figure 50. File utility menu
LINK ACCESS MODE
===>
If option "S" (specify new SPF library) ;s selected, a menu is displayed to allow specification of SPF library attributes and location (minidisk), link access mode for update, and correspond-ing CMS filetype/filename (Figure 51). Default values are pre-entered based on what the user last entered, or based on the last "display file information" request (whichever occurred most recently). The user may overtype the displayed defaults.
See Appendix B for guidelines in specifying SPF libraries.
If option
"un
(unspecify SPF library) is selected, a confirmation menu is displayed to ensure that the user did not select this option by mistake. As directed in the menu, the user must then press either the ENTER key to confirm or the End PF key to cancel.Either action causes a return to the previous menu.
106 SPF/CMS PROGRAM REFERENCE MANUAL
Option
"un
causes the information about the SPF library to be purged from the SPF catalog, but it does not cause the associated file(s) to be deleted.If option "R" (rename file or SPF library) is selected, a menu is displayed to allow the user to enter the new file or SPF library identification (Figure 52). The user may type the new identifi-er(s) and press ENTER (to rename), or press the End PF key to cancel. Either action causes a return to the previous manu.
If option "0" (delete file or SP~ library) is selected, a confir-mation menu is displayed to ensure that the user did not select this option by mistake. As directed in the menu, the user must then press either the ENTER key to confirm or the End PF key to cancel. Either action causes a return to the previous menu.
If an SPF library is specified, option "0" causes the library to be unspecified and the associated file(s) to be deleted (erased).
If no option is specified (blank to display file or SPF library information), the location, characteristics, and current space utilization of the specified library or file are displayed (Figure 53). The user may return to the previous menu by pressing either the ENTER or End PF key.
--- SPECIFY NEW SPF LIBRARY ---SPF LIBRARY NAME: NEWPROJ.MASTER.ASSEMBLE
SPF LIBRARY ATTRIBUTES:
ORGANIZATION
===>
SRECORD FORMAT
===>
FRECORD LENGTH
===>
80SPF LIBRARY LOCATION:
OWNER'S 10
===>
STEPHENSDEVICE ADDR.
===>
5FELINK ACCESS MODE FOR UPDATE:
MODE LETTERS
===>
M_(S
=
SET OF FILES, M=
MACLIB, T=
TXTLIB) (F=
FIXED, V=
VARIABLE)(1 - 32767 BYTES) (BLANK FOR YOUR USERID) (BLANK FOR '191') (M, W, OR MW) FOR ORGANIZATION S (SET OF FILES):
FILETYPE
===>
(BLANK CAUSES SPF TO GENERATE A NAME) FOR ORGANIZATION M OR T (MACLIB OR TXTLIB):FILENAME
===>
(BLANK CAUSES SPF TO GENERATE A NAME)Figure 51. File utility - specify new SPF library
UTILITIES (OPTION 3) 107
--- RENAME SPF LIBRARY
---~---SPF LIBRARY NAME: ---~---SPFDEMO.XXX.COBOL SPF LIBRARY LOCATION:
OWNER'S ID: SPRINGER DEVICE ADDR: 195 NEW SPF LIBRARY NAME:
PROJECT
===>
LIBRARY
===>
TYPE
===>
Figure 52. File utility - rename SPF library
_--- SPF LIBRARY INFORMATION ---SPF LIBRARY NAME: ---SPFDEMO.MYLIB.PLI
SPF LIBRARY ATTRIBUTES:
ORGANIZATION: M RECORD FORMAT: F RECORD LENGTH: 80 SPF LIBRARY LOCATION:
OWNER'S ID: STEPHENS DEVICE ADDR: 5FE SPF LIBRARY ACCESSIBILITY:
(S
=
SET OF FILES, M=
HACLIB, T=
TXTLIB) (F = FIXED, V = VARIABLE)LINK ACCESS MODE FOR UPDATE: MW EQUIVALENT FILE DATA:
CMS FILE 10: DEMOPLI HACLIB
Figure 53. File utility - display information
108 SPF/CMS PROGRAM REFERENCE MANUAL
MOVE/COPY UTILITY (OPTION 3.3)
When this option is selected (utility option 3), a menu is dis-played which allows the user to specify the "from" file (and mem-ber if it is an SPF library, MACLIB, or TXTLIB), and to indicate an action to be performed (Figure 54 top). Possible actions are:
CP - Copy file or member(s) and print MP - Move file or member(s) and print C - Copy without printing
M - Move without printing
When ENTER is pressed, a second menu is displayed which allows the user to specify the "to" file (Figure 54 bottom). If the "to"
file is an SPF library, MACLIB, or TXTLIB, the option to replace like-named members (YES or NO) must be specified. If the "to"
file is sequential, a disposition (OLD or MOD) must be specified.
A disposition of OLD causes an existing file to be rewritten. A disposition of MOD causes the "from" data to be appended to the end of an existing "to" file.
Any SPF library or CMS file may be specified for either the "from"
or "to" file, but the same SPF library, MACLIB, or TXTLIB may not be specified as both the "from" and "to" file.
If the "to" file is a CMS file which does not currently exist, a new file will be created with the same attributes as the "from"
file. If the "to" file is an SPF library, it must have been pre-viously specified via option 3.2 (specify SPF library).
If "move" is indicated and the "from" file is an SPF library, MACLIB, or TXTLIB, the selected member(s) will be deleted in the
"from" file after they hav~ been successfullY copied to the "to"
file. If "move" is indicated and the "from" file is a sequential CMS file, the entire "from" file will be deleted after its con-tents have been successfully copied to the "to" file. If "copy"
is indicated, no deletions will occur.
If "print" is indicated for either move or copy, source listing(s) will be recorded in the SPF list file. If the "to" file is an SPF library, MACLIB, or TXTLIB, a listing of each new or replaced mem-ber will be recorded. If the "to" file is a sequential CMS file, a listing of its entire contents will be recorded after the informa-tion has been successfully copied.
The following rules apply for specifying member names if the
"from" file is an SPF library, MACLIB, or TXTLIB:
• Specifying a valid "from" member name causes a single member to be moved or copied.
• Leaving the "from" member name blank causes a member listing to be displayed (after the second menu has been displayed).
• Specifying a "from" member name of asterisk (*) causes all members to be moved or copied.
If the "to" file is an SPF library, MACLIB, or TXTLIB, the "to"
member name must be specified for the following conditions:
• The "from" file is a sequential eMS file.
• A single member is to be moved or copied and the member is to be renamed in the "to" file. (Members may also be renamed from the member listing, see below.)
In all other cases, the "to" member should be left blank.
UTILITIES (OPTION 3) 109
--- MOVE/COPY UTILITY ---SELECT OPTION
===>
CCP - COPY FILE OR MEMBER(S) AND PRINT C - COPY WITHOUT PRINT MP - MOVE FILE OR MEMBER(S) AND PRINT M - MOVE WITHOUT PRINT SPECIFY "FROM" FILE BELOW, THEN PRESS ENTER TO SPECIFY "TO" FILE
FROM SPF LIBRARY:
PROJECT