z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

oedit
Option
Usage notes
Environment Variable
Exit Values
–r xx Set the record length to be edited for fixed length text files. xx is the record
length.
If –r xx is specified, the file will be processed as variable length but loaded
into the editor as fixed length records and saved as fixed length records.
This lets you convert a variable length file to fixed length. If any lines are
longer than the specified record length, the edit session will not load the file
and will issue the customary message that a line is too long.
1. oedit attempts to load the file into a VB255 session. If this is an ISPF that
supports wide edit (such as ISPF 4.1) and any line exceeds 235 characters, the
width for the new session is the length of the longest line plus 25% to allow for
some expansion.
2. The COPY command cannot copy in files that have records wider than the edit
session.
3. oedit attempts to open an existing file as read/write. If this fails, it will attempt
opening the file read-only to allow the user to view the file. Changes made in
this mode cannot be saved to the file. If changes are made, the edit session
must be ended using the ISPF CANCEL primary command. However, you can
use the ISPF CREATE and REPLACE primary commands to save all or part of
the changed file to another file before you CANCEL the edit session.
4. oedit passes the effective UID of its process to the TSO session. If the EUID
does not match the EUID of the TSO process, the OEDIT TSO command will
attempt to set the effective UID of the TSO process to that of the shell
command prior to loading the file.
5. You cannot use oedit if you used rlogin or telnet to access the z/OS shell.
6. The TSO region size must be large enough to hold the size of the file to be
edited.
7. Two ISPF variables are available to edit macros:
v HFSCWD this variable contains the path name for the directory in which the
file being edited resides.
v HFSNAME this variable contains the name of the file being edited.
BPXWPERM
Specifies the default open permissions used by oedit. Permissions are
specified in octal format. No validation is done on the supplied permissions
and the number will be used as the file mode on an open() call. If the file
already exists the permissions are not changed. If the environment variable
is not set, oedit will work as before using 0700 as the default permissions.
0 The TSO/E OEDIT command was invoked for each file specified.
1 Failure because oedit could not access at lease one file because single
quotes or parentheses were used in the filename.
2 Failure because oedit could not set 3270 passthrough mode.
464 z/OS V1R9.0 UNIX System Services Command Reference