HOSTEDIT Command

Starts the ISPF editor.
z/OS specifics: host editor invoked

Syntax

HOSTEDIT | HED

Details

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.