|
You can specify a concatenated sequence of up to four ISPF libraries,
but the libraries must have been previously allocated to ISPF with
the Data Set utility (3.2).
The fields on this panel are: - Project
- The common identifier for all ISPF libraries belonging to the
same programming project.
- Group
- The identifier for the particular set of ISPF libraries; that
is, the level of the libraries within the library hierarchy.
You
can specify a concatenated sequence of up to four existing ISPF libraries.
The
editor searches the ISPF libraries in the designated order to find
the member and copies it into working storage. If the editor does
not find the member in the library, it creates a new member with the
specified name.
When you save the edited member, the editor
places or replaces it in the first ISPF library in the concatenation
sequence, regardless of which library it was copied from.
- Type
- The identifier for the type of information in the ISPF library.
- Member
- The name of an ISPF library or other partitioned data set member.
Leaving this field blank or entering a pattern causes PDF to display
a member list. See z/OS ISPF User's Guide Vol I for
information about entering patterns.
- Data Set Name
- Any fully qualified data set name, such as USERID.SYS1.MACLIB,
VSAM data set name, or z/OS® UNIX file path name. If you include
your TSO user prefix (defaults to user ID), you must enclose the data
set name in apostrophes. However, if you omit the TSO user prefix
and apostrophes, your TSO user prefix is automatically added to the
beginning of the data set name.
If you specify a VSAM data set,
ISPF checks the configuration table to see if VSAM support is enabled.
If it is, the specified tool is invoked. If VSAM is not supported
by the configuration settings, an error message is displayed.
- Volume Serial
- A real DASD volume or a virtual volume residing on an IBM® 3850 Mass Storage System. To access 3850 virtual volumes,
you must also have MOUNT authority, which is acquired through the
TSO ACCOUNT command.
- Workstation File:
- If you have made a connection to the workstation, you can also
specify a workstation file name, for example C:\AUTOEXEC.BAT, on the
Edit Entry Panel. Or you can specify which environment (host or workstation)
should be used to edit a data set. With these options, one of four
editing situations can occur:
- Edit a Host Data Set on the Host
The editor searches the ISPF
libraries in the designated order to find the member and copy it into
working storage. If you specified a nonexistent member of an ISPF
library, a new member is created with the specified name.
When
you save the edited member, the editor places or replaces it in the
first ISPF library in the concatenation sequence, regardless of which
library it was copied from.
- Edit a Host Data Set on the Workstation
The editor searches
the ISPF libraries in the designated order to find the member and
copy it into working storage. The data set name is converted to a
workstation file name, and that name is appended to the workstation's
current working directory. The host data set is transferred to the
workstation, and the working file is then passed to the user's chosen
edit program.
When you finish the edit session, the working
file is transferred back to the host and stored in the first ISPF
library in the concatenation sequence.
- Edit a Workstation File on the Host
The editor searches the
workstation filesystem to find the file and copy it into working storage.
The workstation file name is converted to a host data set name, and,
if greater than 44 characters, it is truncated to be 44. The workstation
file is transferred to the host, where you can edit it.
When
you finish the edit session, the working file is transferred back
to the workstation and stored.
- Edit a Workstation File on the Workstation
This edit proceeds
as it normally does on your workstation.
- Initial Macro
- You can specify a macro to be processed before you begin editing
your sequential data set or any member of a partitioned data set.
This initial macro allows you to set up a particular editing environment
for the Edit session you are beginning. This initial macro overrides
any IMACRO value in your profile.
If you leave the Initial Macro
field blank and your edit profile includes an initial macro specification,
the initial macro from your edit profile is processed.
If
you want to suppress an initial macro in your edit profile, type NONE in
the Initial Macro field. See Initial macros and IMACRO—Specify an Initial Macro for more details.
- Profile Name
- The name of an edit profile, which you can use to override the
default edit profile. See the description in What is an edit profile?.
- Format Name
- The name of a format definition or blank if no format is to be
used.
- Data Set Password
- The
password for OS password-protected data sets. This is not your RACF® password.
- Record Length
- Applicable when editing a z/OS UNIX file. ISPF normally treats z/OS UNIX files
as having variable length records. This field allows you to specify
a record length which is used by the editor to load the records from
the file into the edit session as fixed-length records. When the file
is saved, it is saved with fixed-length records. The Record Length
field allows you to convert a variable-length file to fixed length.
The value specified in this field must be able to accommodate the
largest record in the file. If the editor finds a record that is larger
than the length specified, an error message is displayed and the edit
session does not proceed.
- Line Command Table
- Use this field to define a set of user line commands that you
can use during the edit session. The table you specify can be generated
using the ISPF table editor and contains the line commands that you
wish to have available and associates each line command with an edit
macro that will be run if the line command is entered during the edit
session.
- Confirm Cancel/Move/Replace
- When you select this field with a "/", a confirmation panel displays
when you request one of these actions, and the execution of that action
would result in data changes being lost or existing data being overwritten.
- For MOVE, the confirm panel is displayed if the data to be moved
exists. Otherwise, an error message is displayed.
- For REPLACE, the confirm panel is displayed if the data to be
replaced exists. Otherwise, the REPLACE command functions like the
edit CREATE command, and no confirmation panel is displayed.
- For CANCEL, the confirmation panel is displayed if any data changes
have been made, whether through primary commands, line commands, or
typing.
Note: Any commands or data changes pending at the time the
CANCEL command is issued are ignored. Data changes are "pending" if
changes have been made to the displayed edit data, but no interaction
with the host (ENTER, PF key, or command other than CANCEL) has occurred.
If no other changes have been made during the edit session up to that
point, the confirmation panel is not displayed.
- Mixed Mode
- When you select this field with a "/", it specifies
that the editor look for shift-out and shift-in delimiters surrounding
DBCS data. If you do not select it, the editor does not look for mixed
data.
- Edit on Workstation
- You can select this option to use your workstation as the editing
environment for whichever host data set or workstation file you want
to edit.
- Preserve VB record length
- You can select this option to cause the editor to store the original
length of each record in variable-length data sets and when a record
is saved, the original record length is used as the minimum length
for the record.
- Data Encoding
- You can use this option to select whether to edit data as ASCII
(CCSID 819) or UTF-8 (CCSID 1208). When you select a value for this
option, the editor uses the selected CCSID in converting the data
to the CCSID for the terminal.
You can also specify this option
when creating a new file to contain ASCII or UTF-8 data.
For z/OS UNIX files,
the editor breaks up data into records using the ASCII (and UTF-8)
linefeed character (X'0A') and the ASCII (and UTF-8) carriage
return character (X'0D') as the record delimiter. The linefeed
and carriage return characters are removed from the data loaded into
the editor, but written back to the file when the data is saved. When
the file is saved, ISPF ensures the file is tagged with a CCSID of
819 (or 1208).
|