Implementing User Programs › Send Parameter Lists to the Subsystem

Send Parameter Lists to the Subsystem

When a call is made to an NCL procedure using the SUBSYS facility, parameters are passed to that procedure. These parameters are passed in a list which can be in an old or a new format.

Note: For more information about the old parameter format, see the description of &CALL in the Network Control Language Reference Guide.

The new parameter list format is available for direct call-attach and is specified in the PARMLIST=NEW operand of the SUBSYS DEFINE command. The new format provides the following:

• Called programs can determine whether or not they have been called with an old or new format list.
• Provides more information about the environment. There are sections that describe the current product region, USER, and NCL processes.
• Additional NCL process termination, initialization, and shutdown calls.
• NCL process correlators which allow you to be independent of the shared NCL process correlator by writing reentrant SUBSYS code.
• Callback application program interface (API) entry point that your program can use to send messages back to the region.

The PARMLIST format is described in the distributed macro, $NMNCPL.

Note: The new format PARMLIST is compatible with high-level languages that use standard IBM linkage conventions.