Skip to content

Initialization, Termination, Modify Commands

During startup ZMF needs to decide whether the HLLX address space is needed at all. CMNSTART will read the Package Master for the HLL exit admin records. If no HLL exit points are active, you need to do nothing to activate the HLLX support. The following message is issued:

CMN_418I CMNSTART No active HLL exits are defined, the HLLX address
    space will not be started.

Other messages you may see:

CMN_401I CMNSTART Waiting for HLL exit address space to initialize.
CMN_402I CMNSTART Successfully connected to HLL exit address space.
CMN_409I CMNSTART Prior instance of HLLX still active, please try later.
CMN_410I CMNSTART HLL exit address space creation failed.
CMN_411I CMNSTART HLL exit address space failed to initialize, reattempt
    via ATTACH command.

The following message is issued each time the active exits table is refreshed. This occurs once at start up of the HLLX stc, and then each time an exit RELOAD is requested. You can ignore this message if everything is running as expected. Its contents may be requested by support when diagnosing problems.

CMNX023I HLLX Active exits table is at: 14328B98

You will also see the response to an internally issued DISPLAY HLLX command (see below) which shows all active HLL exit points.

During ZMF shutdown you may see:

CMN_403I CMNSTART Termination of HLL exit address space requested.
CMN_404I CMNSTART Termination of HLL exit address space complete.
CMN_405I CMNSTART Nothing heard from HLLX, unilateral termination.
The following ZMF/Sernet modify commands are available:

  • F zmfstcname,CMN,DETACH,HLLX

  • F zmfstcname,CMN,ATTACH,HLLX

Detaching HLLX will ensure that the existing (known) HLLX started task is either gone or request it to go away. We will then follow what is left of the ZMF termination process for HLLX listed above so that we are in a state as if we were initializing the HLLX address space during ZMF startup. You may need to do this if something has gone awry with the HLLX process and you are locked out of ZMF.

In response to the attach request we will go through the startup process for HLLX. If HLLX is found to be already active, we will issue the general message 315 (this message is already coded in CMNSTART and takes different text depending on which subtask is being attached):

CMN_315I CMNSTART HLLX address space is already active, no action taken.

If no active HLL exits are defined, the HLLX started task is not started and the following message is issued (similar to startup):

CMN_418I CMNSTART No active HLL exits are defined, the HLLX address space will not be started.

A further operator command:

F zmfstcname,CMN,RELOAD,HLLX

will result in the active HLLX exits table being refreshed from the definitions saved in the Package Master:

CMN_406I CMNSTART HLLX active exit table has been reloaded.

This is followed by a list of all active HLL exits, as per the DISPLAY command documented below.

If the reloaded table contains no active exits, there is no need for further HLLX support and the process will request shutdown of HLLX support. This can be reactivated by updating the exits admin and then issuing an ATTACH command or restarting ZMF.

CMN_407I CMNSTART No active HLLX exits are defined, HLLX will shut down.
CMN_408I CMNSTART Please issue ATTACH HLLX command or restart ZMF if you wish to re-activate one or more exits.
There is also a command to display which exits are currently active in the ZMF/HLLX set up: F zmfstcname,CMN,DISPLAY,HLLX

If no exits are active you will see this message:

CMN_412I There are currently no active HLL exits.

Otherwise, this set of messages will be produced, a line for each active exit:

  CMN_413I Start of HLLX active exits list:
  CMN_415I IntName Typ Env External Name             Debug Ids
  CMN_416I PCRE0001 STD REXX PNL01PRE
  CMN_417I PCRE0001 DBG REXX TST01PRE               WSER58 ,SDOWNES
  CMN_416I PCRE0101 STD REXX PNL01PST
  CMN_417I PCRE0101 DBG REXX TST01PST               WSER58 ,SDOWNES
  CMN_416I PCRE0007 STD LE PLI7PRE
  CMN_416I PCRE0107 STD REXX PNL07PST
  CMN_416I PUPD0002 STD REXX GENPUPD
  CMN_416I PUPD0102 STD REXX GENPUPD
  CMN_416I PUPD0003 STD LE PUPDGNL
  CMN_416I PUPD0103 STD LE PUPDGNL
  CMN_416I PUPD0004 STD REXX GENPUPD
  CMN_416I PUPD0104 STD REXX GENPUPD
  CMN_416I PUPD0005 STD LE PUPDGNL
  CMN_416I PUPD0105 STD LE PUPDGNL
  CMN_416I PUPD0006 STD REXX GENPUPD
  CMN_416I PUPD0106 STD REXX GENPUPD
  CMN_414I End of HLLX active exits list.

The 416 message is issued for each active standard exit definition and shows:

  • The internal exit name.

  • The fact that it is a standard exit definition.

  • Whether it is REXX or Language Environment (LE).

  • The external module name that implements the functionality.

The 417 message is issued for each active debug exit definition and shows, in addition to the 416 information, the list of up to 10 userids that will take the debug exit ahead of the standard exit.