Market Access Control User Manual
Version 2.4
Updated April 22, 2020

Japannext Co., Ltd. believes that the information in this publication is accurate as of its publication date.
This document may include typographical errors, omissions or technical inaccuracies. Japannext Co., Ltd. reserves theright to revise the document and to make changes without notice. Japannext Co., Ltd. acknowledges the proprietary
rights in the trademarks and product names of other companies mentioned in this document.

Contents
1.

Introduction ................................................................................................................................................3

2.

Overview.....................................................................................................................................................33.

Service Configuration .................................................................................................................................3

4.

Web Based Interface ..................................................................................................................................4
4.1.

Groups ................................................................................................................................................54.1.1.

5.

Activate/Suspend groups ...........................................................................................................54.2.

All sessions..........................................................................................................................................64.3.

Individual sessions ..............................................................................................................................84.3.1.

Activate/Suspend session ...........................................................................................................84.3.2.

Cancel orders ..............................................................................................................................8

Programmable API......................................................................................................................................95.1.

Session status .....................................................................................................................................9

5.2.

Suspend all sessions ...........................................................................................................................95.3.

Suspend individual session .............................................................................................................. 10

5.4.

Activate individual session .............................................................................................................. 10

5.5.

Suspend group ................................................................................................................................. 10

5.6.

Activate group ................................................................................................................................. 11

5.7.

Cancel Orders .................................................................................................................................. 11

Revision History ............................................................................................................................................... 12

Market Access Control User Manual1.

2020-04-22

Introduction

This document explains access to the Market Access Control (MAC) service of Japannext PTS. It describes
the service's configuration and specifies the external programmable interface. For further information andinquiries regarding MAC service, please contact Japannext PTS Technical Support via email toito@japannext.co.jp.

2.

Overview

The purpose of MAC service is to allow users to suspend trading activity on their order entry ports inemergency situations. Upon suspension, all open orders will be automatically cancelled and the trading
system will start to reject new orders. Access to the service is only available via Japannext PTS private
network. Users can choose between a web-based interface or programmable API.

3.

Service Configuration

On request, a specific instance of MAC will be created for each individual client of the service. The full list oforder entry ports covered by the MAC instance must be specified in the request. Japannext PTS will provide
a unique URL, which must be used to access the service.

3Market Access Control User Manual

4.

2020-04-22

Web Based Interface

The simplest way to use MAC is to access its web-based interface. To do so, please open the URL provided
by Japannext PTS in your web browser.

Figure 1Figure 1 shows the MAC web interface. The interface has two sections: Groups and Individual sessions.
Every action requires doing the following steps:
1. Tick legal notice acceptance check box (Figure 2)
2. Click the desired action button
3. Confirm the action in the confirmation dialog box. “OK” to proceed with the action, “Cancel” tocancel the action

Figure 24Market Access Control User Manual2020-04-22

Upon a successful action, you will receive an “OK” confirmation message as shown in Figure 3

Figure 3

4.1.

GroupsThis section describes the actions available as a group (Figure 4)

Figure 4

There are three possible values in the STATUS column:
 Active: All sessions subscribed to this group are active
 Suspended: All sessions subscribed to this group are suspended
 Intermediate: Some sessions subscribed to this group are active, and some are suspended

4.1.1. Activate/Suspend groups
When clicking on the “Activate” or “Suspend” button in the groups section, ALL the sessions subscribed tothe respective group will change their status to the one on the selected button. Refer to Figure 5 andFigure 6 for the before and after of test group JNXA as an example.

Figure 55

Market Access Control User Manual2020-04-22

Figure 64.2.

All sessions

The only action available to apply to all sessions is “Suspend All Sessions” (Figure 7). Note that there is no“Activate All Sessions” feature, suspended sessions can only be activated by group or on an individual
session basis.

Figure 7

Note that when you use this ‘Suspend All Sessions” functionality, the system will try to suspend thesessions listed one-by-one. If there is a session that is already suspended, the message “Error: Transaction
Failed” for that particular session will be displayed.
In the following example, Figure 8 shows the state before suspending all sessions. Figure 9 and Figure 10
show the action confirmation for session states, and the subsequent status screen after clicking the“Suspend All Sessions” button respectively.

6Market Access Control User Manual

Figure 8Figure 97

2020-04-22

Market Access Control User Manual2020-04-22

Figure 10

4.3.

Individual sessions

Individual sessions have two different actions available:
 Set state (Activate/Suspend) Cancel orders

4.3.1. Activate/Suspend session
To set the state of an individual session, click the “Activate” or “Suspend” button. Upon a successful
request, an “OK” message will be displayed, as shown in Figure 3.

4.3.2. Cancel orders
This action will cancel all open orders for the selected session without suspending the session.
Note that if there are no open orders, a “Transaction Failed” message will be displayed (Figure11). Thisaction is only available for active sessions.

Figure 118Market Access Control User Manual2020-04-22

IMPORTANT NOTEONLY SESSIONS WITH “C ANCEL ON DISCONNECT” FUNCTIONALITY ENABLED CAN TRIGGER THE MASS ORDERCANCELLATION WHEN THE SESSION IS SET TO “SUSPENDED ’.
ORDERS ENTERED VIA SESSIONS WITHOUT “CANCEL ON DISCONNECT ’ FUNCTIONALITY ENABLED WILL NOT BE
CANCELLED WHEN THE “SUSPEND ALL SESSIONS ” FEATURE IS ACTIVATEDCONTACT JAPANNEXT PTS FOR SUPPORT RELATING TO THE “CANCEL ON DISCONNECT” FUNCTION.

5.

Programmable API

The primary MAC functionality can also be used via API.
A HTTP/1.1 POST request is sent to the MAC service (e.g. via the curl command) with the variable “mode”
set to “api” and other optional parameters.
The reply will be in JSON format. An empty value returned indicates that the MAC service is not currentlyavailable. Examples of use cases of the available commands are as follows:

5.1.

Session status

To query the status of all configured sessions simply send an empty request to the service:curl -X POST -k -d "mode=api" http://X.X.X.X/

Sample reply:[{"session": "QJNXn1", "status": "active"},{"session": "QJNXn2", "status": "active"},{"session": "QJNXn3", "status": "active"},{"session": "QJNXn4", "status": "active"},{"session": "TN11226A", "status": "active"},{"session": "TN11226B", "status": "active"},{"group": "JNXA", "status": "active"},{"group": "JNXB", "status": "active"},{"group": "JNXC", "status": "active"}]

5.2.

Suspend all sessions$ curl -X POST -k -d "suspend_all=S&mode=api" http://X.X.X.X/

Sample reply:[{"session": "QJNXn1", "status": "suspended"},{"session": "QJNXn2", "status": "suspended"},{"session": "QJNXn3", "status": "suspended"},9Market Access Control User Manual2020-04-22{"session": "QJNXn4", "status": "suspended"},{"session": "TN11226A", "status": "suspended"},{"session": "TN11226B", "status": "suspended"},{"group": "JNXA", "status": "suspended"},{"group": "JNXB", "status": "suspended"},{"group": "JNXC", "status": "suspended"}]5.3.

Suspend individual session

To suspend an individual session, add the “set_state=S” and “session_id=<session-name>” parameters to
the request:$ curl -X POST -k -d "set_state=S&session_id=QJNXn1&mode=api" http://X.X.X.X/

Sample reply:[{"session": "QJNXn1", "status": "suspended"},{"session": "QJNXn2", "status": "active"},{"session": "QJNXn3", "status": "active"},{"session": "QJNXn4", "status": "active"},{"session": "TN11226A", "status": "active"},{"session": "TN11226B", "status": "active"},{"group": "JNXA", "status": "intermediate"},{"group": "JNXB", "status": "active"},{"group": "JNXC", "status": "active"}]

5.4.

Activate individual session

To activate an individual session, add the “set_state=A” and “session_id=<session-name>” parameters to
the request:$ curl -X POST -k -d "set_state=A&session_id=QJNXn4&mode=api" http://X.X.X.X/

Sample reply:[{"session": "QJNXn1", "status": "suspended"},{"session": "QJNXn2", "status": "suspended"},{"session": "QJNXn3", "status": "suspended"},{"session": "QJNXn4", "status": "active"},{"session": "TN11226A", "status": "suspended"},{"session": "TN11226B", "status": "suspended"},{"group": "JNXA", "status": "suspended"},{"group": "JNXB", "status": "suspended"},{"group": "JNXC", "status": "intermediate"}]

5.5.

Suspend group

To suspend all sessions in a group, add the “set_groupstate=S” and “group=<group-name>” parameters to
the request:$ curl -X POST -k -d "set_groupstate=S&group=JNXB&mode=api" http://X.X.X.X/
10

Market Access Control User Manual2020-04-22

Sample reply:[{"session": "QJNXn1", "status": "suspended"},{"session": "QJNXn2", "status": "suspended"},{"session": "QJNXn3", "status": "suspended"},{"session": "QJNXn4", "status": "active"},{"session": "TN11226A", "status": "suspended"},{"session": "TN11226B", "status": "active"},{"group": "JNXA", "status": "suspended"},{"group": "JNXB", "status": "suspended"},{"group": "JNXC", "status": "active"}]

5.6.

Activate group

To re-activate all sessions in a group, add the “set_groupstate=S” and “group=<group-name>” parameters
to the request:$ curl -X POST -k -d "set_groupstate=A&group=JNXC&mode=api" http://X.X.X.X/

Sample reply:[{"session": "QJNXn1", "status": "suspended"},{"session": "QJNXn2", "status": "suspended"},{"session": "QJNXn3", "status": "suspended"},{"session": "QJNXn4", "status": "active"},{"session": "TN11226A", "status": "suspended"},{"session": "TN11226B", "status": "active"},{"group": "JNXA", "status": "suspended"},{"group": "JNXB", "status": "suspended"},{"group": "JNXC", "status": "active"}]

5.7.

Cancel Orders

All open orders for a session will be canceled. Note that “0” is returned when there are no orders available
to cancel.
$ curl -X POST -k -d "cxl_session_orders=X&session_id=QJNXn4&mode=api"
http://X.X.X.X

Sample reply (success):[result: 1]

Sample reply (No open orders/fail):[result: 0]

11

Market Access Control User Manual

Revision HistoryDate2013-02-15
2013-02-25
2014-01-09
2014-08-11
2014-10-22
2018-02-01
2020-04-01
2020-04-22

VersionDescription
1.0
Initial revision
1.1
Update purpose section
Added activate screen case
1.2
Added API mode section
2.0
Changed service name to Market Access Control
2.1
Added group suspend and activate feature to GUI and API
2.2
Added Cancel Orders options in GUI and API
2.3
Change company name
2.4
Add additional GUI screenshots
Add caption to all images
Re-organize GUI samples

12

2020-04-22