Under
z/OS, this command
temporarily suspends the current SAS session and starts a session
of the ISPF editor or browser. Under other operating environments,
it invokes other host-specific editors.
Note: The HOSTEDIT command works
only if you have invoked SAS from the ISPF environment.
You can execute the
HOSTEDIT command from the command line of any SAS window that involves
the SAS Text Editor, such as the Program Editor, Log, Output, and
Notepad windows, among others.
When the ISPF EDIT session
begins, the screen displays the contents of the window from which
it was invoked. Depending on how the window was defined when it
was created, one of the following actions occurs:
-
If the window can be edited, you
are placed in an ISPF EDIT session editing the contents of the window.
You can then use the standard ISPF EDIT commands to edit the text
or to call up any of the ISPF EDIT models, and you can save changes
back to the window from which the HOSTEDIT command was issued.
-
If the window is read only, you
are placed in an ISPF BROWSE session that displays the contents of
the window.
-
If the window cannot be edited
by the host editor, a message to that effect appears in the window,
and no other action occurs.
Special text attributes
such as color or highlighting are lost during a host editing session.
When the HOSTEDIT command is issued from a window that contains text
with these attributes, a dialog box appears. The dialog box gives
you the option of either continuing or ending the HOSTEDIT command.
When you have finished
editing in the ISPF EDIT session, do one of the following:
-
To save the contents back to the
window, issue the END command.
-
To discard the changes that you
made, issue the CANCEL command.
-
To save the contents of the window
to an external file, use the standard ISPF EDIT commands such as CREATE
or REPLACE. Then issue the END or CANCEL command, depending on whether
you also want to save the changes back to the window.
In each case, you are
returned to the window in the SAS session that was suspended.