Defining and starting AXM system services

The authorized cross-memory (AXM) server environment provides the runtime environment for CICS data sharing server regions. You must define and start AXM system services to run any of the CICS data sharing servers.

About this task

To establish AXM cross-memory connections for an MVS image, you must define an MVS subsystem called AXM. You can choose to create the subsystem statically or dynamically.

Procedure

  • To define the MVS subsystem statically, add an entry with the required parameters to the IEFSSNxx member of SYS1.PARMLIB:
    SUBSYS SUBNAME(AXM) INITRTN(AXMSI)
    Defining AXM in the IEFSSNxx member ensures that AXM system services automatically become available when you IPL MVS.

    The AXM subsystem initialization routine, AXMSI, sets up the appropriate definitions from the master scheduler region. Note that AXM uses the subsystem definition only as a means of scheduling AXM initialization in the master scheduler address space. The MVS subsystem interface for AXM is not activated or used.

  • To define the MVS subsystem dynamically, enter the following command:
    SETSSI ADD,SUBNAME=AXM,INITRTN=AXMSI

    If initialization of the AXM subsystem fails for any reason, for example, because of an error in the command or because AXMSI is not in a linklist library, MVS does not allow another attempt because the subsystem is then already defined. In this case, use a different subsystem name, such as AXM1, because AXM does not rely on a specific subsystem name. If you start AXM successfully the first time, further attempts are ignored.

What to do next

When the AXM subsystem has started successfully, you can create a data sharing server.