Configuring Your Product › Customizing the Option for ISPF › Relationships Between the Option for ISPF and ISPF/PDF › Edit Relationships › Command Front-Ends

Command Front-Ends

The Option for ISPF dynamically front‑ends several ISPF/PDF Edit primary commands with CA Panvalet Option for ISPF program macros.

A list of these commands and the corresponding program macros follows:

While in CA Panvalet Option for ISPF Edit, you can invoke these edit commands from user‑written edit macros. You can do this by coding the edit macro according to normal ISPF/PDF macro syntax. The Option for ISPF front‑end automatically gets control and performs the request. For example, the statement in a user‑written macro to perform a CA Panvalet Option for ISPF Edit COPY function would read as one of the following:

ISREDIT COPY panmbr AFTER linenbr

ISREDIT !PVCOPY panmbr AFTER linenbr

When invoking Edit functions from a user‑written macro with the Option for ISPF, note the following:

• When the Option for ISPF function completes, shared variables PVRC and PMSG contain the return code and message ID (eight bytes in character format). The user macro must first VGET these variables from the shared pool to determine the success of the function.

  The following values are returned in PVRC:

  • 0 (No errors)
  • 4 (Non‑critical error such as an INCLUDE expand error)
  • 8 (Critical error, function not performed)
  • ‑1 (Internal error)
• The Option for ISPF Edit MOVE, COPY, CREATE, and REPLACE functions do not pass control to the ISPF/PDF Edit routines if you omit the member name, as they do when you invoke them from the primary command line. Use BUILTIN to perform ISPF/PDF MOVE, COPY, CREATE, and REPLACE functions.

  Note: You cannot use BUILTIN to override any of the Option for ISPF front‑ends except MOVE, COPY, CREATE, and REPLACE.

• User‑written edit macros can check dialog variable PACT to determine if the Edit in progress is the Option for ISPF or not. PACT is set to Y during an Option for ISPF Edit.