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 if you need information about entering patterns.

Name

Any fully qualified data set name or z/OS® UNIX file path name.

For more details about the Name field, see the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I.

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 specify a workstation file name, for example C: \AUTOEXEC.BAT, in this field.

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 the topics about Initial Macros and the IMACRO primary command in the z/OS ISPF Edit and Edit Macros for more details.

Profile Name

The name of an edit profile, which you can use to override the default edit profile. See the topics about Edit Profiles and the edit environment in the z/OS ISPF Edit and Edit Macros.

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 Macro 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

When you select this field with a "/", it specifies that the editor 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. The minimum length can be changed using the SAVE_LENGTH edit macro command. The editor always includes a blank at the end of a line if the length of the record is zero or eight.

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.

For ASCII or UTF-8 z/OS UNIX files, the editor breaks up data into records using the ASCII linefeed character (X'0A') and the ASCII 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.

It is not necessary to use the Data Encoding option when the z/OS UNIX file is tagged with a CCSID of 819 or 1208. If ISPF detects the file is tagged with CCSID 819 or 1208, it converts the data from ASCII or UTF-8 to the CCSID of the terminal. When the file is saved, ISPF ensures the file is tagged with a CCSID of 819 or 1208.