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.