Edit entry panel fields

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).