Event code 34 — command line equivalent event

Purpose

This event allows a member language to process a command line equivalent string. Runtime options can be changed and the parameter list to pass to the main program can be changed.

Syntax

Call CEEEVnnn (34, ocb_addr, R1_at_entry, plist) 
POINTER   *ocb_addr;
POINTER   *R1_at_entry;
POINTER   *plist;
ocb_addr (input)
The address of an OCB.
R1_at_entry (input)
The R1 value passed to CEEINT.
plist (output)
The address of the argument list to be interpreted as the inbound parameter.

Usage notes

  • The OCB passed to this event will contain the IBM-supplied defaults, system-level defaults, region-level defaults, and programmer defaults merged.
  • Only the member identified by the member ID in the INPL is called when the reqcmdequ flag in the main options word of the INPL is ON.
  • This event has limited capabilities. There is a fixed stack available and a partially initialized CAA. No Language Environment callable services can be used from this event.
  • Members which change a runtime option should change the corresponding OCB where_set field to PROGRAM_INVOCATION, which will cause the options report to show "Invocation command" for that option.
  • Members which support main programs being called with a nonsupported parameter list can use this event to do their own command-line equivalent processing.
Parent topic: Event handler calls