How-TO Use STM module tool While the audience is gathering. During breaks etc. Simple messages can be added in bold and white letters on the dark blue sea, eg. ”Welcome!”, ”Back at 15.15” How-TO Use STM module tool

HOW-TO Use STM Module Tool This HOW-TO describes how STM Module Tool can be used to test services and applications.

STM Module Tool The STM Module Tool is a windows application that connects to the private side of a SMA VIS implementation. Thus, the tool requires a VIS instance with a private REST interface according to SMA implementation. An instance can be created by SMA, if you don’t use one of the existing, e.g. need a special ship or a private instance. The private side follows the VIS Private REST Technical Design that can be found on Developer Forum. http://s3-eu-west-1.amazonaws.com/stm-stmvalidation/uploads/20170403113238/VIS-REST-Design-Private-STM-Project_v2.2-.docx The source code for The STM Module Tool can be found in GitHub https://github.com/SeaTrafficManagement/StmModuleMockup A Windows executable can be found at Project Place https://service.projectplace.com/pp/pp.cgi/r1562953493

STM Module Tool in technical context VIS Instance, e.g. STM Validation Centre STM Module Tool Private side Public side SSC SeaSWIM (internet) Public side SSC Public side SSC

Start the application Save all files on local disk Execute the file: STM.StmModule.Simulator.exe

Configure the application Specify MCP environment (Development|Staging|Production) Specify instance (as named in serviceinstance url suffix) Auto download messages to folder on disk if appropriate

Handle and publish your own Voyageplan Handle and publish your own Portcall message callService API Get uploaded messages Find and consume external VIS services Show map Notifications from your VIS Select instance and environment View service instance log

Overview – Voyageplans Publish your route to your VIS, set access and select subscribers on your route Retrieve all currently published voyage plans Publish new voyage plan List of published voyageplans Selected RTZ content Handle subscriptions on selected RTZ Publish selected RTZ Show selected RTZ on map Delete selected RTZ from VIS Handle access to selected RTZ

Overview PCM

Overview – Find Service Find service instance in Service Registry and consume. Can find all services, but can only consume service instances based on VIS Design. Service instance description as registered in MCP

Find Service ”rules” Free text search cannot be combined with other fields. Free text will override all other search attributes If all attributes are empty, all services will be listed * can in some fields be used as wildcard (e.g. Keywords) Area search Search for all services related to a graphical object. WKT format http://arthur-e.github.io/Wicket/sandbox-gmaps3.html See HOW-TO Register service and HOW-TO Search along a route on PP for more information

Functions Search for service to consume Get voyage plans from service (e.g. ship) Upload voyage plan (RTZ) to service Upload text message (TXT) to service Upload area message (S124) to service Request to be subscriber to voyage plans Remove subscription

Functions Read Notifications Get received messages from VIS Show on map Get received messages from SPIS Get messages from past (history)

Functions Publish voyage plan to VIS and subscribers Show on map Load list of published voyage plans in VIS Nominate actor to voyage plan Authorize organisation/actor to voyage plan Add service as subscriber on voyage plan Remove subscriber on voyage plan Remove access to voyage plan

Functions Test schema validity on RTZ (v1.1STM) Visualize RTZ on map Test schema validity on TXT (v1.3) Test schema validity on S124 (v0.0.7) Test schema validity on PCM (v0.0.16)

Functions Send PCM message to PortCDM

Functions Reply on message Receive message (RTZ,TXT,S124,PCM) Copy and paste into editor or upload window Edit message Find service to upload to Upload message

At the end – you could add text in black like ”Thank You !”