Skip to content

Editing Components in ChangeMan ZMF

As delivered by Serena, ChangeMan ZMF uses IBM’s ISPF line editor when you edit a change package component. If you have questions about using the ISPF editor, press PF1 for a tutorial. The tutorial includes information about the following subjects:

  • General introduction

  • Edit entry panel

  • Display screen format

  • Scrolling data

  • Sequence numbering

  • Display modes (CAPS/HEX/NULLS)

  • Tabbing (hardware/software/logical)

  • Edit profiles

  • Edit line commands

  • Edit primary commands

  • Labels and line ranges

  • Ending an edit session

Ending an Edit Session

When you edit a package component in ChangeMan ZMF, you actually work with a temporary ChangeMan ZMF utility data set that has been populated from the staging library member that you want to change.

When you exit from your edit session, ChangeMan ZMF takes you through several steps to make sure you want to commit the changes you made and replace the staging library member with your edited text.

  1. The contents of your temporary edit file are compared to the contents of the original member in the staging library and a line-by-line comparison is displayed. If you cancel your changes after viewing the compare listing, the member in the staging library is not replaced. Alternatively, you can choose to keep your editing changes and go on to the next step.

  2. If you decide to keep your edit changes, and if the component you edited is not included in any other active packages, the member in the staging library is replaced with your edited content.

  3. If you decide to keep your editing changes, and if the component you edited is included in other active packages, ChangeMan ZMF shows you a list of those packages. The list includes the TSO ID of the last person who acted on the component in each package. You can then contact those developers to ensure that your work is coordinated with theirs. If you are satisfied that cross-package conflicts do not exist, you can choose to keep your editing changes. The member in the staging library is then replaced.

    Alternatively, you can cancel your changes. In the latter case, the staging library member is not replaced.

Automatic Edit Recovery

Because you do not edit a component directly in the staging library, the ISPF edit SAVE command is blocked in ChangeMan ZMF edit sessions. This prevents confusion about whether you are saving your changes to the staging library member.

If your ISPF session is interrupted by a system problem or by cancellation of your TSO session, and if you have RECOVERY ON in your ISPF Profile, ISPF sets a recovery pending indicator.

Note

If your Change Man Administrator sets EDIT STAGING RECOVERY MODE ON to Y in application administration, an initial edit macro sets RECOVERY ON in your ISPF profile when you start each edit session.

When you connect to ChangeMan ZMF, it looks for an ISPF recovery pending condition involving a ChangeMan ZMF temporary edit data set. If ChangeMan ZMF detects such a condition, the Primary Option Menu is skipped and the Edit Recovery panel is displayed.

CMNEDRC1 ------------------------- EDIT - RECOVERY -------------------------
COMMAND ===>_____________________________________________________________
                *****************************************
                * EDIT AUTOMATIC RECOVERY               *
                *****************************************

The following dataset was being edited when a system failure or
task abend occurred:

DATASET: CMNTP.SERT6.BASE.ACTP.CPY(ACPCPY00)

INSTRUCTIONS:

Press ENTER key to continue editing dataset, or
Enter END or CANCEL command to cancel recovery of the dataset.

The recommended procedure is:

  1. Press Enter to resume the edit session.

  2. Immediately press PF3 to end the edit session, which saves the edited content into the staging library.

  3. The Primary Option Menu is then displayed.

    ChangeMan ZMF does not have the same information about a recovered edit as it does for an edit session you initiated from within ChangeMan ZMF. When you end a recovered edit session, ChangeMan ZMF does not display the compare listing or a concurrent development warning.

Manual Edit Recovery

If your ISPF session is not terminated, but the started task running ChangeMan ZMF is stopped or your ChangeMan ZMF session times out, the changes you made in a ChangeMan ZMF edit session are not saved to the staging library. Since ISPF did not end, there is no pending recovery indicator for ChangeMan ZMF to find when you connect again.

However, the utility data set containing your edits is not scratched, as it would be after a normal end to an edit session. You can use that utility data set to recover your editing changes. Follow this procedure:

  1. Ask your ChangeMan ZMF Administrator what naming convention is used for edit session utility data sets. The default convention (starting with ChangeMan ZMF 5.5) is:

    \&ZUSER.&ASID.\#ttttttt.\#ttttttt.xxx

    where:

    • \&ZUSER is the TSO userid.

    • \&ASID is the user address space ID.

    • ttttttt...ttttttt is the binary time-of-day to nearest microsecond.

    • xxx is the ChangeMan ZMF library type.

  2. Use the ISPF Data Set List Utility (=3.4) to list all of your ChangeMan ZMF temporary data sets in the catalog.

  3. Edit the last temporary edit data set on the list, and verify that it contains the component you were editing when your ChangeMan ZMF session was terminated.

  4. Cut all lines in the temporary edit data set.

  5. Connect to ChangeMan ZMF, and edit the component you were working on when your session was terminated.

  6. Delete all of the lines in the component, then paste the lines cut from the temporary edit data set.

  7. Press PF3 to end the edit session, and carefully examine the compare listing to make sure you have recovered your changes correctly.

  8. Continue the normal procedure to end a ChangeMan ZMF edit session until the edited component is saved to the staging library.