HP 3000 Manuals HP 3000 Manuals
Modified Actions
A list of the RPG actions, the intrinsics called by them, and the
behavior under the enhancement is shown below.
Some VPLUS intrinsics that fail may not be recoverable; i.e. there is
some system failure that caused the problem. The response to these has
not been modified. A program abort may still occur if the status return
from an intrinsic call is non-zero.
SHOMSG Calls VPUTWINDOW, VSHOWFORM. If VPUTWINDOW fails,
it will put the error message in the window and
still call VSHOWFORM. On return from the latter,
the status word is placed in *VSTAT. If it is
non-zero, the error message will be placed in the
window. It then returns to the user with no abort.
The user must test *VSTAT and decide what to do.
WINDOWENH in the COMAREA may also be modified, as
in PUTMSG above.
SHOW Calls VSHOWFORM. Modifies COMAREA item SHOWCONTROL
bit 9, depending on the value in the output buffer
column 7 (blank or 'P' - the preload option). On
return from the intrinsic, it copies the COMAREA
status word to *VSTAT. If it is non-zero, it puts
an error message in the window. It then returns to
the program with no abort. The user must test
*VSTAT and decide what to do.
RDTERM Calls VREADFIELDS. The COMAREA item LOOK'AHEAD may
be modified depending on the value in the output
buffer, column 8. On return from the intrinsic, it
copies the COMAREA status word to *VSTAT. If it is
non-zero, it places an error message in the window.
It then returns to the user with no abort. The
user must test *VSTAT and decide what to do.
Chapter 13 of the HP RPG/iX Reference Manual notes
that it also calls VGETBUFFER. This is actually
done by the READ operation following the RDTERM
action. There is no change from the previous
behavior for this call.
CORERR Calls VSETERROR, VSHOWFORM, and VREADFIELDS. If
VSETERROR fails, it will put an error message in
the window and continue with VSHOWFORM. On
completion of either VSHOWFORM or VREADFIELDS, the
COMAREA status word is copied to *VSTAT. If there
is no failure, the final *VSTAT value is from
VREAD-FIELDS. If either fails, an appropriate error
message is placed in the window, and control
returns to the user with no abort. The user must
test *VSTAT and decide what to do.
SHODTA Calls VPUTBUFFER, VSHOWFORM. If VPUTBUFFER fails,
it puts an error message in the window. On return
from VSHOWFORM, the COMAREA status word is copied
to *VSTAT. If it is non-zero, an error message is
placed in the window. Control then returns to the
user with no abort. The user must test *VSTAT and
decide what to do.
PRINT Calls VPRINTFORM. On return from the intrinsic, the
COMAREA status word is copied to *VSTAT. If it is
non-zero, we also place an error message in the
window. Control returns to the user with no abort.
The user must test *VSTAT and decide what to do.
If an error has occurred and the user has specified
closing the spoolfile after each print, the close
will not be done.
CLRMSG Calls VPUTWINDOW, VSHOWFORM. Clears the window
message buffer. If the RPG output buffer column 7
= 'I' it calls VSHOWFORM. On return, the COMAREA
status word is copied to *VSTAT. If it is non-zero,
an appropriate message is placed in the window.
Control then returns to the user with no abort.
The user must test *VSTAT and decide what to do.
CHMODE Calls VTURNOFF. Puts the return status into *VSTAT.
If it is non-zero, it puts a message into the
window, and the mode is not changed. Control
returns to the user with no abort. The user must
check *VSTAT and decide what to do.
BLMODE Calls VTURNON. Puts the return status into *VSTAT.
If it is non-zero, it puts a message into the
window, and the mode is not changed. Control
returns to the user with no abort. The user must
check *VSTAT and decide what to do.