|
The MOVE primary command moves a
sequential data set, member of a partitioned data set, or z/OS® UNIX file
into the data being edited.
If no options are specified with
the MOVE command, the Edit/View Move panel is displayed.
Syntax
>>-MOVE--+------------------+----------------------------------><
'-| move_options |-'
move_options
|--+-member---+--+-----------------------+--+--------+----------|
+-(member)-+ | (1) | +-ASCII--+
+-dsname---+ '-+-AFTER--+--label-----' +-EBCDIC-+
'-pathame--' '-BEFORE ' '-UTF8---'
Notes: - If you don't specify the position using a label, you must
specify the position by using an A or B line command.
- member
- A member of the ISPF library or partitioned data set you are editing.
- dsname
- A partially qualified or fully qualified data set name. If the
data set is partitioned you can include a member name in parentheses
or select a member from a member list.
- pathname
- The pathname for a z/OS UNIX regular file or directory.
If a directory is specified, a directory selection list is displayed,
allowing you to select the file to be moved. (Also, see Specifying z/OS UNIX pathnames with edit primary and macro commands.)
- AFTER
- The data is moved after the line with the specified label.
- BEFORE
- The data is moved before the line with the specified label.
- label
- Label identifying the line where the data is to be copied. It
can be either a label that you define or one of the editor-defined
labels, such as .ZF or .ZL.
- ASCII, EBCDIC, UTF8
- When one of these keywords is supplied, if the data is using a
different character set to that designated by the keyword, the data
being moved in from the external file is converted from the character
set designated by the keyword to the character set specified for the
file being edited or to the terminal character set.
The label can be either
a label you define or one of the editor-defined labels, such as .ZF and .ZL.
If you have not defined a label and the editor-defined labels are
not appropriate for your purpose, use the A (after) or B (before)
line command to specify the data's destination.
If the data
set, member, or z/OS UNIX file that you are editing is
empty, you do not need to specify a destination for the data being
moved.
Note: If the member name or data set name is less than
8 characters and the data set you are editing is partitioned, a like-named
member is copied. If a like-named member does not exist, the name
is considered to be a partially qualified data set name.
Description MOVE adds data that already
exists to the data set, member, or z/OS UNIX file that you are editing.
Use MOVE if you want to move data rather than copy it from one data
set, member, or z/OS UNIX file to another.
The
member, sequential data set, or z/OS UNIX file is deleted after the move.
For a concatenated sequence of ISPF libraries, the deletion occurs
only if the member was in the first library.
To move data into
an empty data set, member, or z/OS UNIX file:
- On the command line, type:
MOVE member
or:
MOVE dsname
or:
MOVE pathname
The
member, dsname, and path name operands are optional. If you do not
specify the name of a member, data set, or z/OS UNIX file
to be moved, the Edit Move panel appears. Enter the data set, member
name, or z/OS UNIX file on this panel.
- Press Enter. The data is moved.
To move data into a data set, member,
or z/OS UNIX file that is not empty:
- On the command line, type:
MOVE member AFTER | BEFORE label
or:
MOVE dsname AFTER | BEFORE label
or:
MOVE pathname AFTER | BEFORE label
The
member, dsname, and path name operands are optional.
The AFTER
label and BEFORE label operands are optional, also. However, if the
data set, member, or z/OS UNIX file that is to receive the
moved data is not empty, you must specify a destination for the moved
data. Therefore, if you do not use a label, substitute either the
A (after) or B (before) line command as the destination of the moved
data. However, a number indicating that the A or B command should
be repeated cannot follow the line command.
If the data set,
member, or z/OS UNIX file is not empty and you do not specify
a destination, a "MOVE/COPY Pending" message is displayed in
the upper-right corner of the panel and the data is not moved. When
you type a destination and press Enter, the data is moved.
- Press Enter. If you entered the name of a member, data set , or z/OS UNIX file,
the member, data set, or z/OS UNIX file is moved. Otherwise, the
Edit Move panel appears. See the previous example for more information.
See Copying and moving data if
you need more information.
Examples These steps show how you can move
data when you omit the member name and the editor panels appear:
- Type MOVE on the command line and specify the
destination of the operation. In Figure 1,
the data is to be moved after line 000400, as specified
by the A (after) line command.
Figure 1. Member before data is moved File Edit Edit_Settings Menu Utilities Compilers Test Help
───────────────────────────────────────────────────────────────────────────────
EDIT USERSID.TEST(DESTDATA) - 01.01 Columns 00001 00072
Command ===> move Scroll ===> PAGE
****** ***************************** Top of Data ******************************
==MSG> -Warning- The UNDO command is not available until you change
==MSG> your edit profile using the command RECOVERY ON.
000100 $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
000200 This is the member into which the lines are to be moved.
000300 +---------------------+
a00400 | |
000500 | |
000600 | |
000700 | |
000800 +---------------------+
000810
000900 $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
001000
****** **************************** Bottom of Data ****************************
F1=Help F2=Split F3=Exit F5=Rfind F6=Rchange F7=Up
F8=Down F9=Swap F10=Left F11=Right F12=Cancel
- When you press Enter, the Edit/View Move panel appears. Specify
the data you want moved.
This example (Figure 2)
moves the data set member named TODATA.
Figure 2. Edit Move panel (ISREMOV1) Menu RefList Utilities Help
──────────────────────────────────────────────────────────────────────────────
Edit/View Move
Command ===>
"Current" Data Set: USERSID.TEST(DESTDATA)
From ISPF Library:
Project . . . PDFTDEV
Group . . . . USERSID . . . . . . . . .
Type . . . . MSGGEN
Member . . . (Blank or pattern for member selection list)
From Other Partitioned or Sequential Data Set, or z/OS UNIX file:
Name . . . . . TEST(TODATA) +
Volume Serial (If not cataloged)
Data Set Password . . (If password protected)
Data Conversion option
1. EBCDIC
2. ASCII
3. UTF-8
Press ENTER key to move. (Member or sequential data set may be deleted)
Enter END command to cancel move.
F1=Help F2=Split F3=Exit F4=Expand F7=Backward F8=Forward
F9=Swap F10=Actions F12=Cancel
- Figure 3 shows the contents of the
TODATA member which is moved into the original data set. This panel
is shown only for this example, so you can see the data that is being
moved. It is not displayed during a move sequence.
Figure 3. Data set to be moved EDIT USERSID.TEST(TODATA) - 01.00 Columns 00001 00072
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
==MSG> -Warning- The UNDO command is not available until you change
==MSG> your edit profile using the command RECOVERY ON.
000100 +----------------+
000200 | This is the |
000300 | material to |
000400 | be created in |
000500 | another member |
000600 +----------------+
****** **************************** Bottom of Data ****************************
⋮
- When you press Enter, the editor moves the data and displays a
short message in the upper right corner of the panel. Figure 4 shows the result of using MOVE.
Figure 4. Member after data has been moved File Edit Edit_Settings Menu Utilities Compilers Test Help
───────────────────────────────────────────────────────────────────────────────
EDIT USERSID.TEST(DESTDATA) - 01.01 Member TODATA moved
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
==MSG> -Warning- The UNDO command is not available until you change
==MSG> your edit profile using the command RECOVERY ON.
000100 $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
000200 This is the member into which the lines are to be moved.
000300 +---------------------+
000400 | |
000410 +----------------+
000420 | This is the |
000430 | material to |
000440 | be created in |
000450 | another member |
000460 +----------------+
000500 | |
000600 | |
000700 | |
000800 +---------------------+
000810
F1=Help F2=Split F3=Exit F5=Rfind F6=Rchange F7=Up
F8=Down F9=Swap F10=Left F11=Right F12=Cancel
|