SPAZIO MFTS DP v2.5 ManagementConsoleGuide

advertisement
SPAZIO MFT/S for Distributed Platforms
Management Console Guide
Version 2 Release 5
EMAFTM089/03 - July 2012
SPAZIO MFT/S for Distributed Platforms
Management Console Guide
Date of issue
Reference number
Brief description
May 2012
EMAFTM089/01
First Edition – ver. 2.5
June 13 , 2012
EMAFTM089/02
Updated section 6.2.1
July 17 , 2012
EMAFTM089/03
Updated section 1.4.1
th
th
Copyright © 2012 Primeur Ltd. All rights reserved.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or
translated into any other language in whole or in part, in any form or by any means, whether it be
electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Primeur
Ltd.
Primeur Ltd may revise this publication from time to time without notice. A new release of this manual
contains changes made to the product since the previous version.
The software product that this manual documents is the exclusive property of Primeur Ltd. The use of this
software is governed by the license agreement that accompanies the product. The following conditions
must be observed in all cases:
„
The product may be used only on the number of computers for which the client is licensed.
„
The client may make only one copy of the product, and this only for backup purposes.
„
The client may not reverse engineer, decompile, or disassemble the product.
„
The client may not loan, rent or lease neither the product, nor any of the documentation or user
manuals related to the product, whether this is for free or for a fee.
Primeur Ltd warrants that the product will perform substantially in accordance with the accompanying
product manual(s). Primeur Ltd disclaims all other warranties either expressed or implied. Primeur Ltd
and its suppliers shall not be liable for any damages whatsoever (including damages for loss of business
profits, business interruption, loss of business information or other pecuniary loss) arising out of the use
of, or inability to use, the product.
SPAZIO, SPAZIO MFT/S, SPAZIO Orchestration Suite, SPAZIO FTFI, SPAZIO Messaging & Queuing,
SPAZIO M&Q, SPAZIO File Transport, SPAZIO Data Extract, SPAZIO Legacy Interface, SPAZIO Data
Secure, SPAZIO DSSP, SPAZIO DSMQ, SPAZIO Data Compress, SPAZIO JMS and THEMA are
trademarks of Primeur Ltd. Other brands and their products are trademarks or registered trademarks of
their respective holders and should be noted as such.
Company Headquarters
Corso Paganini 3
16125 Genova
Italy
Tel:
Fax:
+39 010 27811
+39 010 8684913
Web:
Mail:
www.primeur.com
[email protected]
Local Agent
Table of Contents
Table of Contents
i About this Manual
Purpose
Reader
Area Covered
Recommended Use
Related Publications
Limitations
Conventions
v v v v vi vi vii viii Chapter 1 SPAZIO Management Console
1.1 Functionality
1.2 Installation
1.2.1 Hardware Requirements
1.2.2 Software Requirements
1.2.3 Installation Procedure
1.2.4 License
1.3 Console Interface
1.3.1 Menu Bar and Drop-down Menus
1.3.2 Toolbar
1.3.3 Connecting to a node
1.3.4 Workspace
1.3.5 Apply Bar
1.3.6 Status Bar
1.4 Configuration
1.4.1 Remote Node Configuration
1.4.2 Local Node Configuration
1 2 3 3 3 3 5 6 6 7 7 8 10 11 11 11 14 Chapter 2 Node Management
2.1 Setting runtime options
2.1.1 General Options
2.1.2 Applying changes to the options
2.2 Modify a Node
2.3 View and Set the Security properties of a Node
17 17 17 18 18 27 Chapter 3 Network Manager
3.1 Network Manager Folder
3.1.1 Toolbar
3.1.2 Workspace
3.2 Local Site
3.2.1 List the Queue Managers
3.2.2 Add a Queue Manager
3.2.3 Remove a Queue Manager
3.2.4 Modify a Queue Manager
3.2.5 View Queue Manager’s properties
3.2.6 Add a Startup Application
3.2.7 Modify a Startup Application
3.2.8 Remove a Startup Application
3.3 Remote Site
3.3.1 FTP Site
3.3.2 FTP/S Site
3.3.3 SFTP Site
29 29 29 29 31 31 31 37 37 37 39 41 41 42 42 55 70 SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
i
Table of Contents
3.3.4 SPAZIO Site
3.3.5 PESIT Site
3.4 Server Connection
3.4.1 DMZ Driver
3.4.2 FTP Server
3.4.3 FTP/S Server
3.4.4 SFTP Server
3.4.5 HTTP Server
3.4.6 PESIT Line
3.4.7 SPAZIO Lines
86 109 112 112 117 133 153 173 176 177 Chapter 4 Transmission Monitoring
4.1 Transmission Monitoring Folder
4.1.1 Toolbar
4.1.2 Workspace
4.2 View Transport Master
4.2.1 View Session Summary from a Queue Manager
4.2.2 View Queue Session Details
4.2.3 View File Session Details
4.3 View Transport Slave
4.4 View Transport Pull
4.5 Transport Master Actions
4.5.1 File Session
4.5.2 Queue session
4.5.3 Queue Manager Actions
4.6 Transport Slave Actions
4.6.1 File Session
4.6.2 Queue Session
4.6.3 Queue Manager Actions
4.7 Transport Pull Actions
4.7.1 File Session
4.7.2 Queue session
4.7.3 Queue Manager Actions
195 195 195 195 196 196 198 199 201 203 205 205 205 206 206 206 206 207 207 207 208 208 Chapter 5 File Management
5.1 File Management Folder
5.1.1 Toolbar
5.1.2 Workspace
5.2 File Management Options
5.2.1 General Options
5.2.2 File Properties
5.2.3 Colors
5.3 System administration operations
5.3.1 Queue Managers
5.3.2 Queue
5.3.4 DQLs
5.3.5 User Classes
5.4 File Manager operations
5.4.1 Open a Queue
5.4.2 View a list of the files contained in a queue
5.4.3 View the properties of a file
5.4.4 View the contents of a file
5.4.5 Dispatch a file
5.4.6 Acquire a file
5.4.7 Delete a file
209 209 209 210 211 211 213 215 215 215 220 230 237 240 241 242 243 245 246 253 254 Chapter 6 Event Management
6.1 The Event Management Folder
6.1.1 Toolbar
6.1.2 Workspace
255 255 255 255 SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
ii
EMAFTM089/03
Table of Contents
6.2 Static Event
6.2.1 Create an Event Definition
6.2.2 Remove an Event Definition
6.2.3 Update an Event Definition
6.2.4 Add a queue to an Event Definition
6.2.5 Remove a queue from an Event Definition
6.2.6 Lock and Unlock an Event Definition
6.3 Dynamic Event
6.3.1 Create an Event Definition
6.3.2 Remove an Event Definition
6.3.3 Update an Event Definition
6.3.4 Add a queue to an Event Definition
6.3.5 Remove a queue from an Event Definition
6.3.6 Lock and Unlock an Event Definition
6.4 Event Instances
6.4.1 View the properties of an Event Instance
6.4.2 Remove an Event Instance
256 256 266 266 267 267 268 268 268 281 282 282 283 283 284 284 286 Chapter 7 Security Management
7.1 Access control for SPAZIO Management Console
7.1.1 Enable Access Control Security
7.1.2 Disable Access Control Security
7.1.3 Modify Access Control Security
7.1.4 Users and Groups
7.1.5 Login procedure
7.2 Node-level security
7.2.1 Node permissions
7.2.2 Changing access rights for groups
7.2.3 Setting Groups’ access rights
7.2.4 Setting Users’ access rights
7.2.5 Removing groups
7.3 Queue Manager-level security
7.3.1 Accessing Queue Manager security management
7.3.2 Queue Manager permissions
7.3.3 Default Queue permissions
7.3.4 Default DQL permissions
7.4 Queue and DQL-level security
7.4.1 Queue permissions
7.4.2 DQL permissions
287 287 287 288 288 290 296 298 298 299 300 302 304 305 305 306 307 308 309 309 311 Chapter 8 Log Management
8.1 Introduction
8.2 Log Management Folder
8.2.1 Toolbar
8.3 Log Management Options
8.4 Extended Log View
8.4.1 View Details of a Session
8.4.2 Apply a filter to Session List
313 313 313 313 313 314 315 317 Appendix A Communication Lines
A.1 List communication Lines
A.2 View the properties of a Communication Line
A.3 Activate an inactive Communication Line
A.4 Deactivate an active Communication Line
321 321 322 323 323 Appendix B Transport Class Management
B.1 View and Set Transport Definitions
B.2 Transport Class
325 325 328 Appendix C Typical Configuration
345 SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
iii
Table of Contents
C.1 Spazio as Client using PR4
C.1.1 Configuration of a SPAZIO Remote Node of the ISCL type
C.1.2 Creating a remote queue
C.1.3 Dispatching a file
C.2 SPAZIO as FTP/S Server
C.3 SPAZIO as FTP/S Client
345 346 350 350 351 352 SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
iv
EMAFTM089/03
About this Manual
Purpose
This manual is an introduction to the SPAZIO Management Console user
interface. This is the GUI that allows Windows-based configuration on
Distributed Platforms and administration of all the SPAZIO nodes.
Reader
This manual is provided for the SPAZIO system administrator. It is assumed
that the reader has reasonable knowledge of SPAZIO and of the relevant
Windows operating systems.
Programming knowledge is not required, but any familiarity with SPAZIO
objects from the point of view of using, installing or configuring SPAZIO
would be an advantage.
Area Covered
The manual is organized as follows:
„
Chapter 1: SPAZIO Management Console: Getting Started describes the
graphical interface for Windows-based SPAZIO administration.
„
Chapter 2: Node Management describes how to set SPAZIO Management
Console options and how to connect to a node.
„
Chapter 3: Network Manager describes configuration operations that can be
performed using SPAZIO Management Console.
„
Chapter 4: Transmission Monitoring describes transmission operations
performed using SPAZIO Management Console.
„
Chapter 5: File Management describes file management operations that can
be performed using SPAZIO Management Console
„
Chapter 6: Event Management describes how to create events using SPAZIO
Management Console.
„
Chapter 7: Security Management describes how security is implemented
through SPAZIO Management Console.
„
Chapter 8: Log Management describes how to view details of any active or
inactive Spazio session.
„
Appendix A: Communication Lines describes describe the operations that
you can perform on Communication Lines belonging to a node using
SPAZIO Management Console.
„
Appendix B: Transport Class Management describes how to manage
Transport Definitions and Transport Classes.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
v
About This Manual
„
Appendix C: Typical Configuration describes some common SPAZIO
MFT/S configurations.
Recommended Use
This manual should be read by any SPAZIO user who has to perform system
administration tasks. The reader will find the SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide particularly helpful for
understanding the configuration of a SPAZIO environment.
Related Publications
A comprehensive suite of manuals is provided to support the implementation
and usage of SPAZIO MFT/S.
These manuals are divided into three categories:
„
z/OS - manuals for the z/OS Mainframe platform
„
Distributed platforms - manuals for non-Mainframe platforms including
SPAZIO workstation
„
General - manuals for both the Mainframe and non-Mainframe platforms.
The key manuals for z/OS are:
„
SPAZIO MFT/S for z/OS: Installation and Configuration Guide
„
SPAZIO MFT/S for z/OS: System Administrator’s Guide
„
SPAZIO MFT/S for z/OS: File Transport User's Guide
„
SPAZIO MFT/S for z/OS: Messages and Codes
„
SPAZIO MFT/S for z/OS: Extended Event Manager Administrator's Guide
„
SPAZIO MFT/S for z/OS: Application Log Administrator's Guide
The key manuals for Distributed Platforms are:
„
SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide
„
SPAZIO MFT/S for Distributed Platforms: System Administrator’s Guide
„
SPAZIO MFT/S for Distributed Platforms: File Transport User's Guide
„
SPAZIO MFT/S for Distributed Platforms: SPXP Transports
„
SPAZIO MFT/S for Distributed Platforms: SPFAB Service Containe
„
SPAZIO MFT/S for Distributed Platforms: Management Console Guide
„
SPAZIO MFT/S for Distributed Platforms: Extended Event Manager
Administrator's Guide
„
SPAZIO MFT/S for Distributed Platforms: Messages and Codes
„
SPAZIO MFT/S for Distributed Platforms: Static Agenda User's Guide
„
SPAZIO MFT/S for Distributed Platforms: SPAZIO DMZ Gateway
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
vi
EMAFTM089/03
About This Manual
The key general manuals are:
„
Data Secure for SPAZIO MFT/S (DSSP) Installation, Configuration and User
Guide
„
Data Secure for SPAZIO MFT/S Open Protocols (DSSP Open) Installation,
Configuration and User Guide
„
AAA Security for Spazio MFT/S (A3SP): Installation, Configuration and User's
Guide
Limitations
SPAZIO only supports the use of the STANDARD ASCII table in the
following:
„
pathnames
„
Description fields
The STANDARD ASCII table includes the following characters:
„
0123456789
„
abcdefghijklmnopqrstuvwxyz
„
ABCDEFGHIJKLMNOPQRSTUVWXYZ
„
!"#$%&'()*+,-./:;<=>[email protected][\]^_`{|}~
The names of queues, remote queues and distribution queue lists (DQL) can
only include the following characters:
„
0123456789
„
abcdefghijklmnopqrstuvwxyz
„
ABCDEFGHIJKLMNOPQRSTUVWXYZ
„
./-%
The names of user classes can only include the following characters:
„
0123456789
„
abcdefghijklmnopqrstuvwxyz
„
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Use of accented characters, special punctuation and so on is not supported.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
vii
About This Manual
Conventions
Sometimes "Distributed Platforms" is abbreviated as DP.
The following are common styles that may appear in the manuals.
Typographical styles change the appearance of certain areas of text. The
instances where different styles are used and what these styles mean is
explained below:
Italics
Cross-references to other manuals appear in italic font. For example: SPAZIO
MFT/S for Distributed Platforms: Installation and Configuration Guide.
Courier font
This style illustrates system code or text. It may be input that needs to be
entered by the programmer exactly as illustrated or output from the system.
For example:
correlation id
Text in Courier font surrounded by a box with shading represents a listing.
For example:
* PRINTOUT QUEUED *
Text in Courier font surrounded by a box, without shading represents a
screen. For example:
PRIMEUR ----------------------FUNCTION ===> _
T M 1 0
0
1
2
3
4
5
6
7
8
9
PARAMETERS
QUEUES
CLASSES
FILE UTILITIES
MESSAGE UTILITIES
TRANSFER
LISTS
TRANSMISSION MONITORING
SYSTEM LOG INQUIRY
ACTIVITIES CONTROL
-------------------- SPAZB
----Userid : PRIAMPO
Date
: 98/02/21
Time
: 14:40
Defines User and System parameters
Defines User Queues
Defines Classes
File Utility functions
Message Utility functions
Transfers Files to/from Q_Manager
Defines Distribution Lists
Monitors Transmission Status
Displays System Log data
Activities control
M
T
X
PRODUCT MAINTENANCE
TUTORIAL
EXIT
Inquiries/lists installed PTFs
Displays TM10 manual
Quits TM10 transaction
Text that appears in this format is important information and
should be read in all cases.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
viii
EMAFTM089/03
Chapter 1
SPAZIO Management Console
SPAZIO Management Console is a Windows tool that allows you to perform
configuration and administration tasks on SPAZIO nodes from a Windows
PC.
It is typically useful where the remote SPAZIO MFT/S system that you wish
to administrate is located on a platform that does not support a graphical
environment.
The application has a standard Windows GUI that provides an intuitive and
user friendly interface to SPAZIO file transfer operations. In this way,
SPAZIO Management Console acts as a client application allowing you to
connect to SPAZIO servers (Queue Managers) running on multi-platform
remote systems (AS/400, UNIX, etc.).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
1
SPAZIO Management Console
1.1
Functionality
The operations that you can carry out with SPAZIO Management Console can
be categorized as follows:
„
Network management operations (configuration of the Spazio Network:
local and remote node).
„
System Administration operations on SPAZIO objects (creating and
deleting queues, DQLs, user classes).
„
File Transfer operations (send and receive files using SPAZIO).
„
Transport monitoring operations (view, stop, resume File/Message
transport sessions that have taken place on a local or remote Queue
Manager).
„
Event management operations (define and modify events together with
their trigger conditions and associate these events with queues).
„
Security Management operations (listing, setting and modifying security
settings).
„
Log Management operations (view details of any active or inactive
SPAZIO session).
NOTE: if two SPAZIO Management Consoles connect simultaneously to
the same remote node, or if CfgAgent is not active on the node (see
SPAZIO MFT/S for Distributed Platforms: Installation and Configuration
Guide, Chapter 9), network management and security management
operations will be disabled.
In these cases the following dialog box appears:
By clicking OK you can connect to the selected node for administrative
purposes.
This chapter describes the SPAZIO Management Console user interface, while
the following chapter provides detailed instructions for performing each of
the available operations.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
2
EMAFTM089/03
SPAZIO Management Console
1.2
Installation
The following sections provide information on installing SPAZIO Management
Console.
NOTE: il setup del prodotto SPAZIO MFT/S Server su Windows prevede
l’installazione automatica di SPAZIO Management Console.
1.2.1
1.2.2
Hardware Requirements
„
Intel Pentium IV 2 GHz or higher
„
2 GByte RAM
„
500 Mb Hard Disk space (for installation and setup)
Software Requirements
Windows XP
„
Windows XP Professional
Windows x86/x64 bit
1.2.3
„
Windows 2003 Server Standard Edition
„
Windows 2003 Server Enterprise Edition
„
Windows 2003 Enterprise Edition Cluster
„
Windows 2008 Server Standard Edition
„
Windows 2008 Server Enterprise Edition
„
Windows 2008 R2 Standard Edition
„
Windows 2008 R2 Enterprise Edition
„
Windows 7 Professional
Installation Procedure
SPAZIO Management Console is distributed on CD-ROM. In order to install the
product:
1
Log on with the administrator privileges.
2
Insert the SPAZIO Management Console CD-ROM in the CD drive.
3
Double-click the Spazio MFTS Management Console.exe icon.
The start dialog box of the installation appears.
4
By clicking Next push-button, the following dialog box appears.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
3
SPAZIO Management Console
5
Insert the User Name, the Company Name and check the option for the
installation.
6
By clicking Next push-button, the Choose Destination Location dialog box
appears: destination directory where you want to install SPAZIO
Management Console (i.e.: C:\Program Files\Primeur) could be specified
by clicking the Browse push-button. This directory will be created if it
does not already exist.
NOTE: If the SPAZIO MFT/S Server product is installed on the machine,
you must choose a destination directory other than the home directory of
the SPAZIO MFT/S Server.
7
By clicking Next push-button, the following dialog box appears.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
4
EMAFTM089/03
SPAZIO Management Console
8
Click on Finish button to exit installation wizard.
NOTE: the setup of the SPAZIO MFT/S product requires the installation of
SPAZIO Management Console (see SPAZIO MFT/S for Distribuited
Platforms: Installation and Configuration Guide, section 3.2.2).
1.2.4
License
SPAZIO Management Console is a licensed application.
The SPAZIO Management Console License file (spazio.lic) will be issued by
Primeur apart and must be placed in the installation folder (e.g. C:\Program
Files\Primeur\Spazio Management Console /spazio.lic).
The license file is not included in the installation packages.
NOTE: SPAZIO Management Console does not require a license if the
product SPAZIO MFT/S Server is present on the machine.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
5
SPAZIO Management Console
1.3
Console Interface
When you open SPAZIO Management Console, the following screen appears:
This screen is made up of the following areas:
1.3.1
Menu Bar and Drop-down Menus
This lets you access the following SPAZIO Management Console menus: File,
Edit, Action, View, Help.
When SPAZIO Management Console starts:
„
the File menu contains the following active item:
Item
Description
Exit
Allows the user to close the SPAZIO
Management Console
„
the Edit menu doesn’t contain any active items.
„
the Action menu contains the following active items:
Item
Description
Connect to Node
Connect to a Local or Remote Node
Lines
Management
Allows you to activate and deactivate SPAZIO
Communication Lines. For further details see
Appendix A.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
6
EMAFTM089/03
SPAZIO Management Console
„
„
Item
Description
Transport Class
Management
Allows you to define/modify/delete SPAZIO
Transport Classes. For further details see
Appendix B.
Client Nodes
Management
Allows you to configure the Management
Console locally and to define/modify/delete
connections to remote nodes.
the View menu contains the following active items:
Item
Description
Security
Security settings
Options
Access user-defined program settings
the Help menu contains the following active item:
Item
Description
About
Display information on the program
NOTE: the remaining items are explained in the sections in where the
items in question are active.
1.3.2
Toolbar
The toolbar contains a number of buttons that provide point-and-click access
to most SPAZIO Management Console operations.
When SPAZIO Management Console starts, the toolbar contains only one active
button, but this can change depending on which folder is selected.
The following table describes the function of the button and the equivalent
menu command:
Button
1.3.3
Function
Menu Command
Connect to a Node
Action – Connect
to Node..
Connecting to a node
1
Click the
button, or choose Action – Connect to Node.
2
Select the Node
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
7
SPAZIO Management Console
3
Click on Connect.
4
If security is enabled for the selected node the following dialog box
appears:
Enter the correct User ID and Password, and click OK to connect.
1.3.4
Workspace
This is the main part of the GUI, and is divided into two panels:
„
The SPAZIO folders panel
„
The Properties or Contents panel
The left panel contains the names of SPAZIO folders. Each folder groups
together a set of operations that can be performed on the SPAZIO objects.
The right panel contains the properties and/or the contents of the object
selected in the left panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
8
EMAFTM089/03
SPAZIO Management Console
The following screen image shows the range of objects that can be displayed
in the left panel of the workspace:
If the CfgAgent is not configured on the remote node (see SPAZIO MFT/S for
Distribuited Platforms: Installation and Configuration Guide, Chapter 9), or the
node is already connected to another SPAZIO Management Console, the objects
visible in the left panel of the workspace are the following:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
9
SPAZIO Management Console
1.3.4.1 Performing operations on SPAZIO objects
SPAZIO Management Console allows you to perform a wide range of
operations on SPAZIO objects. In general, to perform an operation on an
object:
„
Select the object or folder in the left panel of the screen
„
Perform the operation by
‰
Clicking the relevant button on the toolbar
‰
Choosing a menu command from the menu bar
‰
Right-clicking the object and selecting a command from the pop-up
menu.
NOTE: some operations can be activated using all three of the above
methods while others may be available through only one or two actions.
1.3.5
Apply Bar
SPAZIO Management Console allows you to configure remote nodes and
activate the changes using the Apply button at the bottom left of the window.
This button is active when you have to confirm changes, otherwise it is
disabled. When you click Apply, the following screen appears:
If you click Yes, SPAZIO automatically restarts and SPAZIO Management
Console disconnects.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
10
EMAFTM089/03
SPAZIO Management Console
If you modify the configuration without applying it, and you try to open File
Management, the following screen appears:
Click OK to apply the configuration.
1.3.6
Status Bar
This bar contains:
1.4
„
the name of the currently selected object
„
the current account
„
the current date
„
the current time
Configuration
Before you can use SPAZIO Management Console, you must provide some
basic configuration information.
Given that the purpose of the application is to allow you to perform
administrative tasks on SPAZIO objects belonging to Queue Managers on
remote nodes, you must provide SPAZIO Management Console with the
details of the names and locations of these entities.
When you wish to modify the configuration, you must be the system
administrator, because the configurations are stored in the registry.
1.4.1
Remote Node Configuration
If the SPAZIO Management Console and SPAZIO MFT/S Server are
installed on the same machine, the Remote Node folder will contain the
configuration for the connection to the server node by default.
1.4.1.1 Add a remote node
1
Select Action – Client Nodes Management
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
11
SPAZIO Management Console
2
If you click on the Add button, the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Node Name
Name of the node
Node Type OS390
Check only for OS390 node type
Server Address
IP address of the remote system
Server Port
Value of the remote port used for the
outgoing connections.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
12
EMAFTM089/03
SPAZIO Management Console
3
Click on the Add QM button to add a Queue Manager. The following
dialog box appears:
4
Enter the queue manager name and clik OK.
5
Click on the Apply button.
6
Click OK.
Once you have inserted and saved the changes to the SPAZIO Management
Console configuration, in order to activate them you need to close and then
restart SPAZIO Management Console.
1.4.1.2 Modify a remote node
1
Select Action – Client Nodes Management
The following window appears:
2
Select the node you want to edit and click the Edit button
3
The window of the selected node appears and you can make your
changes.
4
Click on the Apply button.
5
Click OK.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
13
SPAZIO Management Console
1.4.1.3 Delete a remote node
1
Selezionare Action – Client Nodes Management
The following window appears:
1.4.2
2
Select the node you want to delete and click the Delete button
3
The following window appears:
4
Click Yes to delete the node, or No to abort the operation.
5
Click OK.
Local Node Configuration
1
Selezionare Action – Client Nodes Management
2
Select the Local Node tab.
The following window appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
14
EMAFTM089/03
SPAZIO Management Console
3
You can modify the value of the Client Name
4
To modify the Line Configuration, click on the Edit button. The following
dialog box appears:
You can modify the following fields in the tab:
Field
Description / Values
Server Port
Value of the local port to use for outgoing
connections
Default Timeout
Line Time-out
Trace Level
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
15
SPAZIO Management Console
5
Click on the Apply button
6
Click OK.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
16
EMAFTM089/03
Chapter 2
Node Management
SPAZIO Management Console lets you connect to one node at a time using the
Primeur PR4 protocol. When you connect to a node, the tree-view in the left
panel of the interface screens contains the connected node. This means that
SPAZIO Management Console gives you a local (graphical) view of a remote
node exactly as though you were sitting at the remote machine in question.
2.1
Setting runtime options
You can customize your SPAZIO Management Console session through a series
of user-modifiable options. To access these options, choose View – Options.
2.1.1
General Options
When you click on View – Options, the following window appears:
The following table describes the properties listed:
Menu Item
Description
Node connection
timeout
Node connection timeout. Default 600 seconds.
QM connection
timeout
QM connection timeout. Default 600 seconds.
Auto Refresh
interval
Set the Auto Refresh interval.
Client Trace
Level
Trace Level for the Management Console
Value
Description
0
No trace
1
Minimal trace
2
Normal trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
17
Node Management
Menu Item
Description
Most Detailed trace
3
The General Options tab allows you to enable/disable:
2.1.2
„
the use of login dialog boxes when connecting to a node. If this option is
not checked, you will not see the following box when you try to connect
to a node (unless the node is protected):
„
display all the properties of the objects defined in the Network Management
folder. If this option is not checked, you will see only the values specified
by the user in the configuration of the object.
Applying changes to the options
After you have modified any fields in the two tabs of the Options dialog box,
click Apply and then OK to enforce the changes.
If you wish to exit the operation without applying the changes, click Cancel.
2.2
Modify a Node
When you are connected to a node, you can customize it as follows:
1
Right-click on the Node.
2
Select Modify Node . The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
NodeName
Name of the node
Trace
Trace Level for the Node.
Value
Description
0
Spazio Trace disabled
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
18
EMAFTM089/03
Node Management
Field
Description / Values
1
Spazio Trace enabled
Default: 0
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName.
3
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
MaxWaitShutting
Maximum waiting time (in seconds) during
the shutdown phase, before forcing a stop.
Values: from 60 to 900.
Default: 120.
SpDFileMax
Maximum size on disk of the generic SPAM
file (for example: session catalog file).
Default: 5000000.
MaxDirNodes
Maximum number of direct nodes (in the
SPAZIO License File)
MaxQMs
Maximum number of Queue Managers on
the local node.
Max.: 4
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
19
Node Management
Field
Description / Values
MaxQmSess
Maximum number of sessions (SA - session
agent) on a local Queue Manager (in SPAZIO
License File). Static behavior is configured
through the following DynamicSA and
MaxStaticSa parameters.
Default: 256
DynamicSA
Session agent management
Value
Description
0
Default. Queue Manager also
handles static (pre-started) SA, for
a maximum of MaxStaticSA.
Static session agents do not
terminate their execution at the
end of a session, but wait for a
new request.
1
MaxStaticSA
Queue Manager handles only
dynamic SA.
Maximum number of static SA on a local
Queue Manager (maximum number of
MaxQmSess).
For DynamicSA = 1, it is 0.
MaxClientIscSess
Maximum number of ISC sessions in a client
process (1 per thread)
Default: 256
Max.: 2048
MaxSAThread
Max. threads for each static SA on a local QM
(max. min(MaxQmSess,MaxClientIscSess),
Default 1 (single-thread))
MaxTrans
Maximum total number of active transactions
including PR4
Max.: 256
MaxActInTrans
Maximum number of active input
transactions including PR4
Max.: 128
Default: 48
MaxActOutTrans
Maximum number of active output
transactions including PR4
Max.: 192
Default: 48
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
20
EMAFTM089/03
Node Management
Field
Description / Values
MaxCommLines
Maximum number of communication lines.
Max.: 16
Default: 8
MaxConvCommLines
Maximum number of Input and Output
conversations on each communication line (in
SPAZIO License File).
Limitations for the number of conversations
on a line: besides the limits imposed by the
license and by the configuration, the number
of conversations per line must be such that
the sum of the conversations defined on each
line is less than 32767.
Default: 64
MaxSMonMTrasp
Maximum number of Message Transport
Agents managed by the Transport Monitor
Max.: 32
Default: 4
MaxSMonFTrasp
Maximum number of File Transport Agents
managed by the Transport Manager
Max: 256
Default: 8
MaxSMonRQueues
Maximum number of Remote Queues on all
local Queue Managers managed by the
Transport Monitor (in SPAZIO License File)
Default: 200
MaxSMonMTrQM
Maximum number of Message Transport
Agents concurrently active towards the same
Queue.
Max: 32.
Default: 32.
MaxSMonFTrQM
Maximum number of File Transport Agents
concurrently active towards the same Queue.
Max: 256
Default: 256
MaxExistQue
Maximum number of queues under a Queue
Manager (in SPAZIO License File)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
21
Node Management
Field
Description / Values
MaxOpenQue
Maximum number of open queues in a
session
Max.: 1000
Default: 32
MaxOpenFil
Maximum number of open files in a session
Max.: 128
Default: none
QCatMax
Maximum size of the disk file for the Queues
Catalogue (see SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide,
Appendix B).
A queue entry gets 1K.
Max.: 100000000 (about 100 Mb)
Default: 8000000
UsClCatMax
Maximum size of the disk file for the User
Classes Catalogue (see SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide, Appendix B).
A user class entry gets 0.5K.
Max.: 10000000 (about 10 Mb).
Default: 200000
DQLCatMax
Maximum size of the disk file for the DQL
Catalogue (see SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide,
Appendix B).
A DQL entry gets 0.3K.
Max.: 10000000 (about 10 Mb)
Default: 400000
MaxQFileDepth
Maximum number of files in a queue
(in SPAZIO License File)
Default: 100000
MaxQMsgDepth
Maximum number of messages in a queue
(in SPAZIO License File)
Default: 10000
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
22
EMAFTM089/03
Node Management
Field
Description / Values
MaxClassPSize
Maximum size of a Persistent Repository (on
disk) for a Storage Class (see SPAZIO MFT/S
for Distributed Platforms: Installation and
Configuration Guide, Appendix A).
One entry (file/msg) gets 2K.
Max.: 2000000000 (about 2 Gb)
Default: 2000000000
MaxClassNPSize
Maximum size of a Non-Persistent
Repository (in memory) for a Storage Class.
(see SPAZIO MFT/S for Distributed Platforms:
Installation and Configuration Guide, Appendix
A).
Max.: 2000000 (about 2 Mb)
Default: 500000
MaxQmEventLevel
MaxQmEventParall
Maximum Event Manager level for all local
Queue Managers (in SPAZIO License File)
Value
Description
0
No Queue Manager Event
Management
1
Basic Queue Manager Event
Management
2
Extended Queue Manager Event
Management
Valid only for extended Event Manager.
Maximum parallelism of Restartable Event
Instances that can currently be active.
Max.: 16
Default: 8
MaxQmEvent
Maximum number of Event Instances that
can be validated (or in validation queue).
Max.: 8000
Default: 8000
MaxIntEvent
Maximum number of Internal Queue
Manager Events. (Used to implement get-inwait on a queue).
Max.: 4000
Default: 100
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
23
Node Management
Field
Description / Values
MaxQueIntEvent
Maximum number of Queues with Internal
Queue Manager Events.
Max.: 256
Default: 64
MaxEventInQue
Maximum number of Event Definitions (of
validation type 1) associated to the same
queue.
Max.: 128
Default: 32
MaxQueEvent
Maximum number of Queues with Event
Definitions (of validation type 1).
Max.: 1024
Default: 32
MaxEvDefinitions
Maximum number of static Event Definitions
for each Queue Manager (any validation
type.
Max.: 256
Default: 64
MbCompact
BinPath
Archive compaction activation mode.
Value
Description
0
Default. Explicit compaction is
not performed
1
Explicit Mailbox
Path for SPAZIO executable files.
Maximum 256 characters.
Default: $SPAZIO/bin.
CfgPath
Path for SPAZIO Configuration files.
Maximum 256 characters.
Default: $SPAZIO/cfg.
ErrPath
Path for Error files.
Maximum 256 characters.
Default: $SPAZIO/err.
DataPath
Path for SPAZIO catalogs.
Maximum 256 characters.
Default: $SPAZIO/spdata.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
24
EMAFTM089/03
Node Management
Field
Description / Values
LogPath
Path for SPAZIO Log.
Maximum 256 characters.
Default: $SPAZIO/log.
TracePath
Path for SPAZIO Trace files.
Maximum 256 characters.
Default: $SPAZIO/trace.
TempPath
Path for SPAZIO temporary files.
Maximum 256 characters.
Default: $SPAZIO/temp.
HiddenPath
Path used for atomic acquisition (see SPAZIO
MFT/S for Distributed Platforms: Installation
and Configuration Guide - section 4.11 and
Appendix D).
Default: $SPAZIO/temp.
Config Agent Port
Specify the local port to be used for the
connection with the SPAZIO Management
Console.
Default: 7000.
Config Agent Trace
Trace level for Configuration Agent
Value
Description
0
Default. No trace
1
Minimal trace
2
Normal trace
3
Most detailed trace
DstkTracefile
Specify full pathname of the trace file
generated if the Dstk trace system is enabled.
Default: Tracefile =
$SPAZIO/trace/dstk-$PID.trc
DstkTraceLevel
Trace Level for DSTK System
Value
Description
-4
For irreversible fatal errors. Use
this log level before process shutdown, usually required for these
kind of errors.
-3
An internal error has occurred.
User intervention is usually
required to recover the problem.
-2
A dangerous situation is likely to
occur.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
25
Node Management
Field
Description / Values
-1
Informative message (i.e. DSTK
Version, configuration, operating
system, ...)
0
Explicit messages to be written to
the trace file
1
DSTK API call/return traces.
2
Like the previous one but with
verbose parameters with full
values
3
Debug information for the
internal behavior of the functions.
4
The maximum debug level.
5
FULL DUMP of every buffer in
binary and ASCII mode.
For further details see Data Secure for SPAZIO
(DSSP) Installation, Configuration and User
Guide
SSL Peer Log
SSL X.509 Certificate Subject logging of
remote peers for auditing purposes. The
generated log is in CSV format, ready to be
imported into an external DBMS or simply
analyzed through a Spreadsheet.
Default: $SPAZIO/log/dssp-ssl.log
For further details see Data Secure for SPAZIO
MFT/S (DSSP) Installation, Configuration and
User Guide).
SSL Peer Dir
SSL X.509 Certificate store of remotely
exchanged credentials. All exchanged
Certificates will be stored in the directory
indicated by the following parameter.
Certificate names will be encoded in
md5/b64 format in order to avoid name
conflicts.
Default: D:$SPAZIO/dssp/peers
For further details see Data Secure for
SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
26
EMAFTM089/03
Node Management
Field
Description / Values
SSH Peer Log
SSH X.509 Certificate Subject or PublicKey
logging of remote peers for auditing
purposes. The generated log is in CSV format,
ready to be imported into an external DBMS
or simply analyzed through a Spreadsheet.
Default: $SPAZIO/log/dssp-ssh.log
For further details see Data Secure for SPAZIO
MFT/S (DSSP) Installation, Configuration and
User Guide).
SSH Peer Dir
SSH X.509 Certificate or PublicKey store of
remotely exchanged credentials.
All exchanged Certificates and PublicKeys
will be stored in the directory indicated by
the following parameter. Certificate names
and PublicKeys will be encoded in md5/b32
format in order to avoid name conflicts.
Default: $SPAZIO/dssp/peers
SposTrace
5
2.3
For further details see Data Secure for SPAZIO
MFT/S (DSSP) Installation, Configuration and
User Guide).
Global Trace level. Sets Trace level for every
SPOS process. May be changed while system
is running: new global trace level is active
after some new process has started.
Value
Description
0
Default. errors only
1
Errors and warnings
2
Extremely verbose trace
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
View and Set the Security properties of a Node
To view or change the security properties of a node, select the node and
choose View – Security or right-click the queue and choose Security.
Refer to Chapter 7: Security Management for details on how to set and modify
the permissions.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
27
Node Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
28
EMAFTM089/03
Chapter 3
Network Manager
The Network Manager folder, SPAZIO Management Console allows you to
configure the local and remote nodes and to activate the changes through the
Apply button at the bottom left of the window and restart Spazio.
3.1
3.1.1
Network Manager Folder
Toolbar
The toolbar contains only one button. The following table describes the
function of the button and the equivalent menu command:
Button
3.1.2
Function
Menu Command
Connect to a Local or Remote node
Action – Connect
to Node..
Workspace
When you open the Network Management folder, the following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
29
Network Manager
Sites contains the definitions of the Local Queue Managers and remote sites of
the current node.
Server Connection contains a list of the servers that can be activated on current
node. Whether or not these can be activated depends on the contents of the
SPAZIO License File.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
30
EMAFTM089/03
Network Manager
3.2
Local Site
In the Local Site folder, SPAZIO Management Console allows you to manage the
applications controlled by Spazio Monitor and the Queue Managers of the
current node.
3.2.1
3.2.2
List the Queue Managers
1
Select Local Site folder
2
The list of local Queue Managers of the current node appears under the
folder and in the right panel:
Add a Queue Manager
1
Right-click on the Local Site folder.
2
Select Add . The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
QmName
Name of the current Queue Manager
Startup
Start-up mode for the Queue Manager:
Value
Description
1
Default: Manual
2
Automatic
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
31
Network Manager
Field
Description / Values
Trace
Trace Level for the Queue Manager.
Value
Description
0
Default. No trace
1
Minimal trace
2
Normal trace
3
Most Detailed trace
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
QmFilePref
Options for the QM
Value
Description
0
Preference for Internal Format for
files in queues
1
Preference for File System Format
for files in queues
Default: 0
QmOptions
Other options for the QM
Value
Description
0
No recovery trace
1
Leave recovery trace
Default: 0
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
32
EMAFTM089/03
Network Manager
Field
Description / Values
MaxQMSess
Max. number of active sessions (Local Session
Agents)
Default: 8
FastIndex
Virt Catalog
Option to use FAST_INDEX SPAM for
Storage Classes. This improves performance,
but involves more work in the case of a
system failure.
Value
Description
0
Default . Normal use of SPAM
(i.e. modifications to indexes are
normally flushed on disk).
1
Use the FAST_INDEX SPAM
option in storage class (i.e.
modifications to indexes are not
flushed on disk)
Use of the VIRT SPAM option for Queue
Manager catalogs (i.e. queue, user class and
DQL catalogs). This improves performance,
but involves more work in the case of a
system failure.
Value
Description
0
Default . Normal use of SPAM for
Queue Manager catalogs (data
and index of SPAM file are kept
on disk).
1
Use the VIRT SPAM option (data
and index of SPAM file are kept
in main memory until the file is
closed) for Queue Manager
catalogs.
This provides better performance
but more work is necessary in the
case of a system failure.
MaxExistQue
Maximum number of queues under the
Queue Manager. Maximum as in SPAZIO
License File, or as defined in the node (see
Section 2.3).
Default: 100000
MaxOpenQue
Maximum number of open queues in a
session. Maximum as in SPAZIO License File,
or as defined in the node (see Section 2.3).
Default: 16
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
33
Network Manager
Field
Description / Values
MaxOpenFil
Maximum number of open files in a session.
Maximum as in SPAZIO License File, or as
defined in the node (see Section 2.3).
Default: 16
MaxUsrClass
Maximum number of User Classes in a
session.
Max: 1000
Default: 32
QCatMax
Maximum size of the Queue Catalog disk file.
A queue entry gets 1 Kb. Maximum as in
SPAZIO License File, or as defined in the
node (see Section 2.3).
Default: 200000
SPAZIO takes the minimum value amongst
those specified in the node (see Section 2.3).
UsClCatMax
Maximum size of the User Class Catalog disk
file. Maximum as in SPAZIO License File, or
as defined in the node (see Section 2.3).
Default: 30000
A queue entry gets 0.5 Kb
DQLCatMax
Maximum size of the DQL Catalog disk file.
Maximum as in SPAZIO License File, or as
defined in the node (see Section 2.3).
Default: 60000
A DQL entry gets 0.3 kb
MaxQFileDepth
Maximum number of files in the queue.
Maximum as in SPAZIO License File, or as
defined in the node (see Section 2.3).
Default: 100000
MaxQMsgDepth
Maximum number of messages in the queue.
Maximum as in SPAZIO License File, or as
defined in the node (see Section 2.3).
Default: 10000
QmDir
Directory name for internal Queue Manager
files. Maximum 8 characters. Default: first 8
characters of Queue Manager name.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
34
EMAFTM089/03
Network Manager
Field
Description / Values
QmClean
Instructions for the Queue Manager Cleaner
process (the process that removes expired
files and messages from Queue Manager
queues).
QmCleanInt
Value
Description
0
Default. No clean
1
Clean when the Queue Manager
starts up.
2
Clean when the Queue Manager
starts up, and then at regular
intervals
Interval (in hours) between execution cycles
of Queue Manager Cleaner process.
Minimum: 1
Maximum: 168
Default: 3
QmCleanOpts
QmSessClean
QmSessCleanOpts
Option for Cleaner process of Queue
Manager
Value
Description
0
Default . Application Log
disabled, Session Trace disabled
1
Application Log available
2
Session Trace available (Trace
level=3 used in connect to QM)
3
Application Log and Session
Trace available
Instructions for the Queue Manager Session
Cleaner process. This process eliminates
Restart Session files for Sessions in restart
that have not been used for at least
QMSessClExpDay days.
Value
Description
0
No clean (default)
1
Clean only first time
2
Repeated clean every day, also
first time
Option for Session Cleaner process of QM
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
35
Network Manager
Field
Description / Values
Value
Description
0
Default. Application Log
disabled, Session Trace disabled
1
Application Log available
2
Session Trace available (Trace
level=3 used in connect to QM)
3
Application Log and Session
Trace available
Number of days after which a Restart Session
(also Thema slave) is considered as expired
and therefore to be removed by the Queue
Manager Session Cleaner process.
QmSessClExpDay
Range: [1...365]
Default: 30.
370 is a special value for cleaning all Restart
Sessions.
QmEventManagLevel
QmEventTraceLevel
ResManInt
Event Manager Level for this Queue
Manager.
Value
Description
0
No Queue Manager Event
Manager
1
Basic Queue Manager Event
Manager
2
Extended Queue Manager Event
Manager
Optional. Use this parameter to enable and
disable the trace only for the Event Manager
on this Queue Manager.
Value
Description
0
No trace
1
Trace
Interval of the RM loop asking for Tx
outcome (in minutes). It is used only in cases
of the external Transaction Manager.
Range: [3, ..., 180]
Default: 10
5
Click Next to create the Queue Manager or Cancel to abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
36
EMAFTM089/03
Network Manager
6
3.2.3
3.2.4
3.2.5
To activate this new Queue Manager you have to click Apply at the
bottom left of the window and restart Spazio.
Remove a Queue Manager
1
Right-click the Queue Manager you want to delete.
2
Select Remove . The following screen appears
3
Click Yes to delete the Queue Manager, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio
Modify a Queue Manager
1
Right-click the Queue Manager you want to modify.
2
Select Modify.
3
The window of the selected Queue Manager appears and you can make
your changes (see Section 3.2.2 for details about the fields).
4
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
View Queue Manager’s properties
1
Select Local Site folder
2
Select the Queue Manager.
In the right panel the properties of the Queue Manager are displayed
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
37
Network Manager
The following table describes the properties:
Field
Description / Values
Startup mode
Startup mode
Value
Description
1
Manual
2
Automatic
Trace Level
Trace Level
Value
Description
0
No trace
1
Minimal trace
2
Normal Trace
3
Most Detailed trace
Max number of
concurrent
sessions
Max number of concurrent sessions on a local
Queue Manager
Max number of
queues
Max number of queues in a local Queue
Manager
Max number of user
classes
Max number of user classes in a local Queue
Manager
Max dimension of
Queue catalogue on
disk
Maximum size of the Queue Catalogue file
on disk.
Max dimension of
user class
catalogue on disk
Maximum size of the User Class Catalogue
file on disk.
Max dimension of
DQL catalogue on
disk
Maximum size of the DQL Catalogue file on
disk.
Max number of
files in a queue
Max number of files in a queue of a local
Queue Manager
Value
Description
No clean
Clean when the Queue Manager
1
starts up.
Clean when the Queue Manager
2
starts up, and then at regular
intervals.
Time, in hours, between successive cycles of
the Queue Manager Cleaner process.
0
Cleaning interval
(in hours)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
38
EMAFTM089/03
Network Manager
3.2.6
Add a Startup Application
1
Click on the Local Site folder.
2
The Startup Application folder appears:
3
Right- click the Startup Application folder and select Add.
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
Application name
Name of Application X (without the .exe
extension)
Application
parameter
Optional.
Parameter list.
Maximum 256 characters.
Default: blank.
Application type
Optional.
Type for Application X:
Value
Description
1
Start only
2
Start and final kill
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
39
Network Manager
Field
4
Description / Values
3
Start and final STOP message
(default)
4
Start and final SHUTDOWN
message. SPAZIO waits for
SUICIDE message from the
application.
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
Field
Description / Values
Impersonate user
Mandatory to configure the impersonation
feature.
The application should run with in
impersonation.
Maximum 256 characters.
Default: blank.
For details see SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide,
Appendix B and SPAZIO MFT/S for Distributed
Platforms: Static Agenda User's Guide.
Impersonate
group/domain
Mandatory on Unix to configure the
impersonation feature.
User's Group or Domain.
Maximum 256 characters.
Default: blank.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
40
EMAFTM089/03
Network Manager
Field
Description / Values
For details see SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide,
Appendix B and SPAZIO MFT/S for Distributed
Platforms: Static Agenda User's Guide.
E2E Configuration
path
Mandatory if impersonation is configured
and the application must use a DSSP
environment different from the one used by
the Spazio user. It must point to a cfg
directory containing the DSSP configuration
files.
User's DSSP environment path.
Maximum 256 characters.
Default: blank.
For details see SPAZIO MFT/S for Distributed
Platforms: Installation and Configuration Guide,
Appendix B and SPAZIO MFT/S for Distributed
Platforms: Static Agenda User's Guide.
3.2.7
5
Click OK to add the application or Cancel to abort the operation.
6
To activate this new Application, you have to click Apply at the bottom
left of the window and restart Spazio.
Modify a Startup Application
1
Right click the Application you want to modify.
2
Select Modify Application.
The window of the selected Application appears and you can make your
changes (see Section 3.2.6 for details about the fields).
3
Fill in the fields you want to change.
4
To activate the changes, you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: It is not possible to modify the application spcmdinvoker.
3.2.8
Remove a Startup Application
1
Right click on the Application and select Remove Application. The
following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
41
Network Manager
2
Select Yes to remove the application or No to abort the operation.
3
To activate the change, you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: It is not possible to remove the application spcmdinvoker
configured for startup of the management console (see Section 1.1).
3.3
Remote Site
In the Remote Site folder, the SPAZIO Management Console allows you to
define the remote sites (SPAZIO nodes and non-SPAZIO nodes) for the
current node.
Different remote sites are represented by different icons:
„
FTP, FTPS, SFTP and PESIT Sites are indicated by the
icon when
SPAZIO plays the role of a protocol client application that sends files
stored on a remote queue to a remote protocol server instance (Master)
„
FTP, FTPS and SFTP Sites are indicated by the
icon when SPAZIO
plays the role of a protocol client application that receives files from a
remote protocol server instance and stores them on a local or remote
queue (Pull)
„
SPAZIO Sites are indicated by the icon when SPAZIO plays the role of
a protocol client/server application that sends/receives files from/to a
remote SPAZIO node.
„
The remote nodes that are not recognized by SPAZIO Management Console
are indicated by the icon
3.3.1
.
FTP Site
The following section describes how to configure an FTP Master/Pull.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
3.3.1.1 Add an FTP Master
An FTP Master is a client protocol application that sends files stored on a
remote queue to an FTP Server.
The following steps describe how to add an FTP Master:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
42
EMAFTM089/03
Network Manager
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Master. The following dialog box appears:
4
Enter a name for the destination FTP Server in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
6
Field
Description / Values
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
Click Next. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
43
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the
destination FTP Server.
Port
TCP/IP port on which the destination FTP
Server is listening.
User
User and password that will be used to access
the destination FTP Server.
Password
To insert password click on the
InitialDir
icon.
Directory where the target files must be
stored, if omitted the userhome directory (as
defined on the FTP Server) will be used. The
directory name can be specified using the
following macros that will be expanded at
runtime:
Macro
Description
${USER}
The login user name
${QUEUE}
Remote Queue Destination
Queue Name
Remote Queue Destination
Queue Manager name
Name of the file on the target FTP Server; the
name can be specified using macros that will
be expanded at runtime.
${QMGR}
FileName
Macro
Description
${USER}
The login user name
${DATE}
Current date in
YYYYMMMDD format
${TIME}
Current time in HHMMSS
format
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
44
EMAFTM089/03
Network Manager
Field
Description / Values
${INTNUM}
Internal File Number
${DESCR}
File Description
${CORRID}
Correlation Identifier
${DESTNAME}
Destination Filename
excluding the extension (e.g.
for C:\mydata\readme.txt,
DESTNAME="readme")
${DESTEXT}
Destination Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
DESTEXT="txt")
${DOTDESTEXT}
Destination Filename
Extension including the
initial dot (e.g. for
C:\mydata\readme.txt,
DOTDESTEXT=".txt")
${DESTDRIVE}
Destination Filename
Windows Drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTDRIVE="C:")
${DESTBASE}
Destination Parent
Directory excluding the
Windows drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTBASE="mydata")
${ORIGNAME}
Original Filename
excluding the extension
(e.g. for
C:\mydata\readme.txt,
ORIGNAME="readme")
${ORIGEXT}
Original Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
ORIGEXT="txt")
${DOTORIGEXT}
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
45
Network Manager
Field
Description / Values
Original Filename
Extension including the
initial dot (e.g. for
C:\mydata\readme.txt,
DOTORIGEXT=".txt")
${ORIGDRIVE}
Original Filename
Windows Drive, if it exists
(e.g. for
C:\mydata\readme.txt,
ORIGDRIVE="C:")
${ORIGBASE}
Original Parent Directory
excluding the Windows
drive, if it exists (e.g. for
C:\mydata\readme.txt,
ORIGBASE="mydata")
${QUEUE}
Remote Queue Destination
Queue Name
${QMGR}
Remote Queue Destination
Queue Manager Name
${SELECTOR(xxx)}
SPAZIO Selector xxx.
The selector is written
according to SpJMS syntax.
For a list of the available
selectors refers to SPAZIO
MFT/S for DP: File Transport
User's Guide, section 3.9.2
7
Fill in the relevant fields.
8
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
46
EMAFTM089/03
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
Mode
Switch to select file transfer mode.
Value
Description
active
Active mode file transfer: the
client establishes a control
connection to the server and the
server establishes a data
connection back to the client.
passive
Passive mode file transfer: the
client establishes both a control
connection and a data
connection to the server.
ActiveDataLocalAdd
ress
Local TCP/IP address of the FTP client as
seen by the server. In active mode file
transfers, this address is provided by the
client to the server through the PORT
command, and it is used by the server to
establish a data connection back to the
originating client.
ActiveDataLocalInP
ortRange
Local port range that the FTP client can use
for active mode file transfers. In active mode
file transfers, one available port from the
specified range is selected by the client and
provided to the server through the PORT
command. It is then used by the server to
establish a data connection back to the
originating client.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
47
Network Manager
Field
Description / Values
CharEncoding
Character encoding used in the control
Channel, if omitted default ISO-8859-1
encoding will be used, alternative values can
be found here:
http://java.sun.com/j2se/1.5.0/docs/api/java/nio/ch
arset/Charset.html
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
Data type to use in the data channel.
DataType
Disposition
Value
Description
ascii
ASCII data type
binary
Binary data type
auto
Inherit ASCII/Binary data type
from SPAZIO File Descriptor.
Disposition policy when creating files on the
target FTP Server file system.
Value
Description
replace
Create a new file or replace an
existing one
Create a new file or replace an
existing one but upload the file
using a temporary file name
(e.g.
.filename.part.yyymmddhhmmsscc.
dat) and rename it at the end of
the transfer.
Generate a new file with a
unique name (via the FTP STOU
command)
stagedr
eplace
unique
append
ScriptFile
9
Append current file to an
existing one (via the FTP APPE
command)
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to provided developer javadoc
documentation.
Click OK to add the FTP Master, or Cancel to abort the operation.
10 If you click OK, the following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
48
EMAFTM089/03
Network Manager
Click Yes to add the password, or Cancel to abort the operation.
11 To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.1.2
Add an FTP Pull
An FTP Pull is a protocol client application that receives files from an FTP
Server and stores them on a local or remote queue.
The following steps describe how to add an FTP Pull:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Pull. The following dialog box appears:
4
Enter a name for the source FTP Server in the Server Name field.
5
Click Next. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
49
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the source
FTP Server.
Port
TCP/IP port on which the source FTP Server
is listening.
User
User and password that will be used to access
the source FTP Server.
Password
To insert password click on the
Directory where the target files must be
acquired from, if omitted the user home
directory (as defined on the FTP Server) will
be used. The directory name can be specified
using the following macros that will be
expanded at runtime:
InitialDir
Macro
Description
${USER}
The login user name
${QUEUE}
Target Queue Name
${QMGR}
Target Queue Manager Name
FileFilter
File selection filter (including "*" and "?"
wildcards) used to identify which files must
be transferred from the FTP Server to Spazio
MFT/S queue
Spazio.DestQueueMa
nager
Name of the local queue manager hosting the
target queue where transferred files will be
stored.
Spazio.DestQueue
Name of the target queue where transferred
files will be stored.
Spazio.Sender
Value of the Sender attribute for the file.
If this value is not specified the file Sender
will be set to the name of the user used to log
in with the remote system
User Class for the file. If not specified this
value will not be set.
Spazio.UserClass
Max number of attempts that the Pull
performs to download a file. When the
MaxAttempts is reached the Pull will be shut
down. If MaxAttempts is set to zero or a
negative value an infinite number of attempts
is performed
MaxAttemps
6
icon.
Fill in the relevant fields.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
50
EMAFTM089/03
Network Manager
7
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Enabled
Switch to disable a pull without removing it.
Value
Description
true
Pull is enabled
Pull is disabled
Switch to select when a pull is started.
false
StartupMode
Value
Description
automatic
Pull is started when the line is
started
manual
Pull is started manually
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
Mode
Switch to select file transfer mode.
Value
Description
active
Active mode file transfer: the
client establishes a control
connection to the server and the
server establishes a data
connection back to the client.
passive
Passive mode file transfer: the
client establishes both a control
connection and a data
connection to the server.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
51
Network Manager
Field
Description / Values
ActiveDataLocalAdd
ress
Local TCP/IP address of the FTP client as
seen by the server. In active mode file
transfers, this address is provided by the
client to the server through the PORT
command, and it is used by the server to
establish a data connection back to the
originating client.
ActiveDataLocalInP
ortRange
Local port range that the FTP client can use
for active mode file transfers. In active mode
file transfers, one available port from the
specified range is selected by the client and
provided to the server through the PORT
command. It is then used by the server to
establish a data connection back to the
originating client.
CharEncoding
Character encoding used in the control
Channel, if omitted default ISO-8859-1
encoding will be used, alternative values can
be found here:
http://java.sun.com/j2se/1.5.0/docs/api/java/nio/ch
arset/Charset.html
DataType
Data type to use in the data channel.
Value
Description
ascii
ASCII data type
binary
Binary data type
auto
ASCII if the target file name
extension is included in
DataFileExts setting, Binary
otherwise.
DataFileExts
Comma separated list of file extensions (e.g.
"txt,csv,xml") that are to be handled as data
(vs binary) when downloaded from server
FileFilterMode
Criteria to use to get the list of files to acquire.
Value
Description
regular
Default value, get the list using
the NLST command
raw
Fallback configuration to use if
the regular mode is not able to
see some files in remote site.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
52
EMAFTM089/03
Network Manager
Field
Disposition
Description / Values
This option requires a heavier
network traffic but is able to
avoid possible problems with
the parsing of non standard
format directory listing (e.g.
when some files in the directory
listing output appear to be
skipped because of parsing
errors).
File disposition policy to adopt for the source
file upon successful transfer,.
Value
Description
delete
Remove original source file
Archive original source file
archive
ArchiveDest
keep
Generate a new file with a
unique name (via the FTP STOU
command)
append
Leave the original file in place
and unchanged
Name of an existing directory on the FTP
Server (distinct from the one specified in
InitialDir), where successfully processed
files will be moved.
Files in the archive dir will have a timestamp
prepended to their original file name.
PollingSecs
Idle interval in seconds between two polling
of current source.
Spazio.EventString
Events that can be activated when a pull has
been completed or aborted.
Supported event parameters are: EVFNM(),
EVFGR(), EVCNM() and EVCGR().
For a complete description of these event
parameters please refer to SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
AttemptsIntervalSe
cs
Interval to sleep before retrying to download
a file after an error. This parameter is ignored
if MaxAttempts is set to zero.
ScriptFile
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to user manual and provided developer
javadoc documentation
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
53
Network Manager
8
Click OK to add the FTP Pull, or Cancel to abort the operation.
9
If you click OK, the following screen appears:
Click Yes to add the password, or Cancel to abort the operation.
10 To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.3.1.3 Remove an FTP Site
1
Right-click the FTP Site (Master/Pull) you want to delete.
2
Select Remove (Master/Pull) . The following screen appears:
3
Click Yes to delete the FTP Site, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.1.4 Modify an FTP Site
1
Right-click the FTP Site (Master/Pull) you want to modify.
2
Select Modify (Master/Pull).
The window of the selected FTP Site appears and you can make your
changes (see Section 3.3.1.1 for the FTP Master fields and Section 3.3.1.2 for
FTP Pull fields).
3
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: the fields Hostname and Port cannot be modified.
3.3.1.4 View and Set the Default properties of an FTP Site
1
Right-click the FTP Master/Pull.
2
Select Modify Default (Master/Pull).
Now you can view and modify the Default properties.
See sections 3.3.1.1and 3.3.1.2 for further details.
3
Click OK to modify default properties, or Cancel to abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
54
EMAFTM089/03
Network Manager
4
3.3.2
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
FTP/S Site
The following section describes how to configure an FTP/S Master/Pull.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
3.3.2.1 Add an FTP/S Master
A FTP/S Master is a client protocol application that sends files stored on a
remote queue to an FTP/S Server.
The following steps describe how to add an FTP/S Master:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Master. The following dialog box appears:
4
Enter a name for the destination FTP/S Server in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
55
Network Manager
The following table explains the fields in the tab:
6
Field
Description / Values
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
Click Next. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the
destination FTP/S Server.
Port
TCP/IP port on which the destination FTP/S
Server is listening.
User Password
User and password that will be used to access
the destination FTP/S Server.
To insert password click on the
InitialDir
FileName
icon.
Directory where the target files must be
stored, if omitted the userhome directory (as
defined on the FTP/S Server) will be used.
The directory name can be specified using the
following macros that will be expanded at
runtime:
Macro
Description
${USER}
The login user name
${QMGR}
Remote Queue Destination
Queue Manager Name
${QUEUE}
Remote Queue Destination
Queue Name
Name of the file on the target FTP/S Server,
the name can be specified using the following
macros that will be expanded at runtime.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
56
EMAFTM089/03
Network Manager
Field
Description / Values
Macro
Description
${USER}
The login user name
${DATE}
Current date in
YYYYMMMDD format
${TIME}
Current time in HHMMSS
format
${INTNUM}
Internal File Number
${DESCR}
File Description
${CORRID}
Correlation Identifier
${DESTNAME}
Destination Filename
excluding the extension
(e.g. for
C:\mydata\readme.txt,
DESTNAME="readme")
${DESTEXT}
Destination Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
DESTEXT="txt")
${DOTDESTEXT}
Destination Filename
Extension including the
initial dot (e.g. for
C:\mydata\readme.txt,
DOTDESTEXT=".txt")
${DESTDRIVE}
Destination Filename
Windows Drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTDRIVE="C:")
${DESTBASE}
Destination Parent
Directory excluding the
Windows drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTBASE="mydata")
${ORIGNAME}
Original Filename
excluding the extension
(e.g. for
C:\mydata\readme.txt,
ORIGNAME="readme")
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
57
Network Manager
Field
Description / Values
${ORIGEXT}
Original Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
ORIGEXT="txt")
${DOTORIGEXT}
Original Filename
Extension including the
initial dot (e.g. for
C:\mydata\readme.txt,
DOTORIGEXT=".txt")
${ORIGDRIVE}
Original Filename
Windows Drive, if it exists
(e.g. for
C:\mydata\readme.txt,
ORIGDRIVE="C:")
${ORIGBASE}
Original Parent Directory
excluding the Windows
drive, if it exists (e.g. for
C:\mydata\readme.txt,
ORIGBASE="mydata")
${QUEUE}
Remote Queue Destination
Queue Name
${QMGR}
Remote Queue Destination
Queue Manager Name
${SELECTOR(xxx)}
SPAZIO Selector xxx.
The selector is written
according to SpJMS syntax.
For a list of the available
selectors refer to SPAZIO
MFT/S for Distribution
Platforms: File Transport
User's Guide, section 3.9.2
7
Fill in the relevant fields.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
58
EMAFTM089/03
Network Manager
8
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Mode
Switch to select file transfer mode.
Value
Description
active
Active mode file transfer: the
client establishes a control
connection to the server and the
server establishes a data
connection back to the client.
passive
Passive mode file transfer: the
client establishes both a control
connection and a data
connection to the server.
CharEncoding
Character encoding used in the control
Channel, if omitted default ISO-8859-1
encoding will be used, alternative values can
be found here:
http://java.sun.com/j2se/1.5.0/docs/api/java/nio/ch
arset/Charset.html
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
SSL Control
Required mode for SSL/TLS connection:
Value
Description
explicit
Establish an explicit SSL/TLS
connection (via AUTH
command), recommended.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
59
Network Manager
Field
Description / Values
implicit
SSLAuthenticationP
rotocol
SSLData
DataType
Establish an implicit SSL/TLS
connection, most FTP/S
Servers will listen for implicit
connections on port 990,
reconfigure your Conn.Port
parameter as needed.
Protocol required.
Value
Description
TLS
Preferred and recommended
protocol for using FTP/S
SSL
Alternative (older) protocol
Protection required for SSL/TLS data
channel:
Value
Description
protected
Data channel is protected
cleartext
Data channel is left in clear
text.
Data type to use in the data channel.
Value
Description
ascii
ASCII data type
binary
Binary data type
Inherit ASCII/Binary data type
from SPAZIO File Descriptor.
Disposition policy when creating files on the
target FTP/S Server file system.
auto
Disposition
Value
Description
replace
Create a new file or replace an
existing one
Create a new file or replace an
existing one but upload the file
using a temporary file name
(e.g.
.filename.part.yyymmddhhmmsscc.
dat) and rename it at the end of
the transfer.
Generate a new file with a
unique name (via the FTP STOU
command)
stagedr
eplace
unique
append
Append current file to an
existing one (via the FTP APPE
command)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
60
EMAFTM089/03
Network Manager
9
Field
Description / Values
ScriptFile
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to provided developer javadoc
documentation.
Click OK to add the FTP/S Master. The following screen appears:
Click Yes to add the password.
10 The following dialog box appears:
The following table explains the fields:
Field
Description / Value
ClientAuth
SSL Client Authentication
Value
Description
false
Client doesn't support
authentication with
X.509 Certificates
true
Client supports authentication
with X.509 Certificates
For a complete description of the parameters
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: it is possible to set the values for the
ClientAuth parameter by right-clicking on the
FTP/S Master.
ServerHostMatch SSL X.509 Server Subject CN matching with
hostname/IP.
Value
Description
true
The remote hostname/IP address
is checked syntactically against
the "CN" field of X.509 Subject
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
61
Network Manager
false
The remote hostname/IP address
is not checked syntactically against
the "CN" field of X.509 Subject
For a complete description of the parameter please
refer to Data Secure for SPAZIO MFT/S (DSSP)
Installation, Configuration and User Guide.
To insert the value click on the
icon.
11 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: A new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
12 Export/Import X.509 Certificate (see Sections 3.3.2.6 and 3.3.2.7).
3.3.2.2 Add an FTP/S Pull
A FTP/S Pull is a protocol client application that receives files from an FTP/S
Server and stores them on a local or remote queue.
The following steps describe how to add an FTP/S Pull:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Pull. The following dialog box appears:
4
Enter a name for the source FTP/S Server in the Server Name field.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
62
EMAFTM089/03
Network Manager
5
Click Next. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the source
FTP/S Server.
Port
TCP/IP port on which the source FTP/S
Server is listening.
UserPassword
User and password that will be used to access
the source FTP/S Server.
To insert password click on the
InitialDir
icon.
Directory where the target files must be
acquired from, if omitted the user home
directory (as defined on the FTP/S Server)
will be used. The directory name can be
specified using the following macros that
will be expanded at runtime:
Macro
Description
${USER}
The login user name
${QUEUE}
Target Queue Name
${QMGR}
Target Queue Manager Name
FileFilter
File selection filter (including "*" and "?"
wildcards) used to identify which files are to
be transferred from the FTP/S Server to
Spazio MFT/S queue.
Spazio.DestQueueMa
nager
Name of the local queue manager hosting the
target queue where transferred files will be
stored.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
63
Network Manager
Field
Description / Values
Spazio.DestQueue
Name of the target queue where transferred
files will be stored.
Spazio.Sender
Value of the Sender attribute for the file.
If this value is not specified the file Sender
will be set to the name of the user used to log
in with the remote system
User Class for the file. If not specified this
value will not be set.
Spazio.UserClass
Max number of attempts that the Source
performs to download a file. When the
MaxAttempts is reached the Source will be
shut down. If MaxAttempts is set to zero or a
negative value an infinite number of attempts
is performed
Max Attempts
6
Fill in the relevant fields.
7
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Enabled
Switch to disable a pull without removing it.
StartupMode
Value
Description
true
Pull is enabled
false
Pull is disabled
Switch to select when a pull is started.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
64
EMAFTM089/03
Network Manager
Field
Description / Values
automatic
Pull is started when the line is
started
manual
Pull is started manually
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
Mode
Switch to select file transfer mode.
Value
Description
active
Active mode file transfer: the
client establishes a control
connection to the server and
the server establishes a data
connection back to the client.
Passive mode file transfer: the
client establishes both a
control connection and a data
connection to the server.
Character encoding used in the control
Channel, if omitted default ISO-8859-1
encoding will be used, alternative values can
be found here:
http://java.sun.com/j2se/1.5.0/docs/api/java/nio/ch
arset/Charset.html
Data type to use in the data channel.
passive
CharEncoding
DataType
Value
Description
ascii
ASCII data type
binary
Binary data type
auto
ASCII if the target file name
extension is included in
DataFileExts setting, Binary
otherwise.
DataFileExts
Comma separated list of file extensions (e.g.
"txt,csv,xml") that are to be handled as data
(vs binary) when downloaded from server.
FileFilterMode
Criteria to use to get the list of files to acquire.
Value
Description
regular
Default value, get the list
using the NLST command
raw
Fallback configuration to use
if the regular mode is not able
to see some files in remote
site.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
65
Network Manager
Field
Description / Values
This option requires a heavier
network traffic but is able to
avoid possible problems with
the parsing of non standard
format directory listing (e.g.
when some files in the
directory listing output
appear to be skipped because
of parsing errors).
File disposition policy to adopt for the source
file upon successful transfer
Disposition
Value
Description
delete
Remove original source
Archive original source file
archive
Leave the original file in place
and unchanged
Name of an existing directory on the FTP/S
Server (distinct from the one specified in
InitialDir), where successfully processed files
will be moved. Files in the archive dir will
have a timestamp prepended to their original
file name.
keep
ArchiveDest
PollingSecs
Idle interval in seconds between two polling
of current source.
Spazio EventString
Events that can be activated when a pull has
been completed or aborted.
Supported event parameters are: EVFNM(),
EVFGR(), EVCNM() and EVCGR().
For a complete description of these event
parameters please refer to SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
AttemptsIntervalSe
cs
Interval to sleep before retrying to download
a file after an error. This parameter is ignored
if MaxAttempts is set to zero.
ScriptFile
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to provided developer javadoc
documentation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
66
EMAFTM089/03
Network Manager
9
Click OK to add FTP/S Pull. The following screen appears:
Click Yes to add the password.
10 The following dialog box appears:
The following table explains the fields:
Field
Description / Value
ClientAuth
SSL Client Authentication
Value
Description
false
Client doesn't support
authentication with X.509
Certificates
true
Client supports authentication
with X.509 Certificates
For a complete description of the parameters
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: It is possible to set the values for the
ClientAuth parameter by right-clicking on the
FTP/S Pull.
ServerHostMatch
SSL X.509 Server Subject CN matching with
hostname/IP.
Value
Description
true
The remote hostname/IP
address is checked syntactically
against the "CN" field of X.509
Subject
false
The remote hostname/IP
address is not checked
syntactically against the "CN"
field of X.509 Subject
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
67
Network Manager
Field
Description / Value
To insert the value click on the
icon.
12 To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: A new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
13 Export/Import X.509 Certificate (see Sections 3.3.2.6 and 3.3.2.7).
3.3.2.3 Remove an FTP/S Site
1
Right-click the FTP/S Site (Master/Pull) you want to delete.
2
Select Remove (Master/Pull) . The following screen appears:
3
Click Yes to delete the FTP/S Site, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.2.4 Modify an FTP/S Site
1
Right-click the FTP/S Site (Master/Pull) you want to modify.
2
Select Modify (Master/Pull).
The window of the selected FTP/S Site appears and you can make your
changes (see Section 3.3.2.1 for the FTP/S Master fields and Section 3.3.2.2
for FTP/S Pull fields).
3
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: The fields Hostname and Port cannot be modified.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
68
EMAFTM089/03
Network Manager
3.3.2.5 View and Set the Default properties of an FTP/S Site
1
Right-click the FTP/S Master/Pull.
2
Select Modify Default (Master/Pull).
Now you can view and modify the Default properties.
See sections 3.3.2.1 and 3.3.2.2 for further details.
3
Click OK to modify default, or Cancel to abort the operation.
4
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.2.6 Export X.509 Client Certificate
1
Right-click the FTP/S Site
2
Select Export X.509 Client Certificate. The following screen appears:
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
69
Network Manager
3.3.2.7 Import X.509 Server Certificate
3.3.3
1
Right-click the FTP/S Site
2
Select Import X.509 Server Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
SFTP Site
The following section describes how to configure an SFTP Master/Pull.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
3.3.3.1 Add an SFTP Master
An SFTP Master is a client protocol application that sends files stored on a
remote queue to an SFTP Server.
The following steps describe how to add an SFTP Master:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Master. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
70
EMAFTM089/03
Network Manager
4
Enter a name for the destination SFTP Server in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
6
Field
Description / Values
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
Click Next. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the
destination SFTP Server.
TCP/IP port on which the destination SFTP
Server is listening.
User and password that will be used to access
the destination SFTP Server.
Port
User Password
To insert password click on the
icon.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
71
Network Manager
Field
InitialDir
Description / Values
Directory where the target files are to be
stored, if omitted the userhome directory (as
defined on the SFTP Server) will be used. The
directory name can be specified using the
following macros that will be expanded at
runtime:
Macro
Description
${USER}
The login user name
${QUEUE}
Remote Queue Destination
Queue Name
Remote Queue Destination
Queue Manager Name
Name of the file on the target SFTP Server.
The name can be specified using the
following macros that will be expanded at
runtime.
${QMGR}
FileName
Macro
Description
${USER}
The login user name
${DATE}
Current date in
YYYYMMMDD format
${TIME}
Current time in HHMMSS
format
${INTNUM}
Internal File Number
${DESCR}
File Description
${CORRID}
Correlation identifier
${DESTNAME
}
Destination Filename
excluding the extension (e.g.
for C:\mydata\readme.txt,
DESTNAME="readme")
${DESTEXT}
Destination Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
DESTEXT="txt")
${DOTDESTEXT}
Destination Filename
Extension including the
initial dot (e.g. for
C:\mydata\readme.txt,
DOTDESTEXT=".txt")
${DESTDRIVE}
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
72
EMAFTM089/03
Network Manager
Field
Description / Values
Destination Filename
Windows Drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTDRIVE="C:")
${DESTBASE}
Destination Parent
Directory excluding the
Windows drive, if it exists
(e.g. for
C:\mydata\readme.txt,
DESTBASE="mydata")
${ORIGNAME}
Original Filename
excluding the extension
(e.g. for
C:\mydata\readme.txt,
ORIGNAME="readme")
${ORIGEXT}
Original Filename
Extension excluding the
initial dot (e.g. for
C:\mydata\readme.txt,
ORIGEXT="txt")
${DOTORIGEXT}
Original Filename Extension
including the initial dot (e.g.
for C:\mydata\readme.txt,
DOTORIGEXT=".txt")
${ORIGDRIVE}
Original Filename Windows
Drive, if it exists (e.g. for
C:\mydata\readme.txt,
ORIGDRIVE="C:")
${ORIGBASE
}
Original Parent Directory
excluding the Windows
drive, if it exists (e.g. for
C:\mydata\readme.txt,
ORIGBASE="mydata")
${QUEUE}
Remote Queue Destination
Queue Name
${QMGR}
Remote Queue Destination
Queue Manager Name
${SELECTOR(xxx)}
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
73
Network Manager
Field
Description / Values
SPAZIO file selector xxx.
The selector is written
according to SpJMS syntax.
For a list of the available
selectors please refer to
SPAZIO MFT/S for Distributed
Platforms: File Transport User's
Guide, section 3.9.2.
7
Fill in the relevant fields.
8
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
DataType
Data type to use in the data channel.
Disposition
Value
Description
ascii
ASCII data type
binary
Binary data type
auto
Inherit ASCII/Binary data type
from SPAZIO File Descriptor.
Disposition policy when creating files on the
target SFTP Server file system.
Value
Description
replace
Create a new file or replace an
existing one
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
74
EMAFTM089/03
Network Manager
Field
ScriptFile
9
Description / Values
Create a new file or replace an
stagedr
eplace
existing one but upload the file
using a temporary file name
(e.g.
.filename.part.yyymmddhhmmsscc.
dat) and rename it at the end of
the transfer
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to provided developer javadoc
documentation.
Click OK to add the Site. The following screen appears:
Click Yes to add the password.
10 The following dialog box appears:
The following table explains the fields:
Field
Description / Value
ClientAuth
SSH Client Authentication
Value
Description
false
Client only send its Password to
the Server for being authenticated
true,publickey
Client only send its Public Key to
the Server for being authenticated
true,x509
Client only send its X509
certificate to the Server for being
authenticated
false,passwd,publickey,x509
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
75
Network Manager
Field
Description / Value
Client send its Public key or its
X509 Certificate or its Password to
the Server for being
authenticated. The first valid
credential is used
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
ServerAuth
icon.
SSH Server Validation.
Value
Description
false
Server credentials are considered
trusted by default and not
checked against Certificate DB
PKHOST/CA sections
true,x509
X509 Certificate is checked
against Certificate DB CA sections
true,publickey
Public key is checked against
Certificate DB PKHOST section
true,publickey,x509
Public key or X509 validation are
checked against Certificate DB
PKHOST or CA sections
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: it is possible to set the values for the
ServerAuth parameter by right-clicking on the
SFTP Master.
ServerHostMatch
SSH X.509 Server Subject CN matching with
hostname/IP address.
Value
true
Description
The remote hostname/IP
address is checked syntactically
against the "CN" field of the
X.509 Subject
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
76
EMAFTM089/03
Network Manager
Field
Description / Value
The remote hostname/IP
address is not checked
syntactically against the "CN"
field of the X.509 Subject
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
false
To insert the value click on the
icon.
11 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
12 Export/Import X.509 Certificate (see Sections 3.3.3.6 and 3.3.3.7)
13 Export/Import Public Key (see Sections 3.3.3.8 and 3.3.3.9).
3.3.3.2 Add an SFTP Pull
A SFTP Pull is a client protocol application that receives files from an SFTP
Server and stores them on a local or remote queue.
The following steps describe how to add an SFTP Pull:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Pull. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
77
Network Manager
4
Enter a name for the source SFTP Server in the Server Name field.
5
Click Next. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Hostname
Hostname or TCP/IP address of the
destination SFTP Server.
Port
TCP/IP port on which the destination SFTP
Server is listening.
User
User and password that will be used to access
the destination SFTP Server.
Password
To insert password click on the
InitialDir
icon.
Directory where the target files are to be
stored, if omitted the userhome directory (as
defined on the SFTP Server) will be used. The
directory name can be specified using the
following macros that will be expanded at
runtime:
Macro
Description
${USER}
The login user name
${QUEUE}
Target Queue Name
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
78
EMAFTM089/03
Network Manager
Field
Description / Values
${QMGR}
Target Queue Manager Name
FileFilter
File selection filter (including "*" and "?"
wildcards) used to identify which files are to
be transferred from the SFTP Server to the
target queue.
Spazio.DestQueueMa
nager
Name of the local queue manager hosting the
target queue where transferred files will be
stored.
Spazio.DestQueue
Name of the target queue where transferred
files will be stored.
Spazio.Sender
Value of the Sender attribute for the file.
If this value is not specified the file Sender
will be set to the name of the user used to log
in with the remote system
Spazio.UserClass
User Class for the file. If not specified this
value will not be set.
Max Attempts
Max number of attempts that the Source
performs to download a file. When the
MaxAttempts is reached the Source will be
shut down. If MaxAttempts is set to zero or a
negative value an infinite number of
attempts is performed
6
Fill in the relevant fields.
7
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
79
Network Manager
Field
Description / Values
Enabled
Switch to disable a pull without removing it.
Value
Description
true
Pull is enabled
false
Pull is disabled
Switch to select when a pull is started.
StartupMode
Value
Description
automa
tic
Pull is started when the line is
started
manual
Pull is started manually
SessionTimeoutSec
Seconds after which a session will time out
and be closed by the server.
DataType
Data type that must be associated to the
binary downloaded file (SFTP protocol only
supports binary mode) when inserted in
Spazio MFT/S. No conversion is attempted,
but the DataType is just asserted and set in
the Spazio File Descriptor.
Value
Description
Ascii
ASCII data type
Binary
Binary data type
Auto
ASCII if the target file name
extension is include in
DataFileExts setting, Binary
otherwise.
DataFileExts
Comma separated list of file extensions (e.g.
"txt,csv,xml") that are to be handled as data
(vs binary) when downloaded from SFTP
server.
FileFilterMode
File selection filter (including "*" and "?"
wildchars) used to identify which files are to
be transferred from the SFTP Server to Spazio
MFT/S queue.
Disposition
File disposition policy to adopt for the source
file upon successful transfer,
Value
Description
delete
Remove original source file
Archive original source file
archive
keep
Leave the original file in place
and unchanged
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
80
EMAFTM089/03
Network Manager
Field
Description / Values
ArchiveDest
Name of an existing directory on the SFTP
Server (distinct from the one specified in
InitialDir), where successfully processed
files will be moved.
Files in the archive dir will have a timestamp
prepended to their original file name.
PollingSecs
Idle interval in seconds between two polling
of current source.
Spazio.EventString
Events that can be activated when a pull has
been completed or aborted.
Supported event parameters are: EVFNM(),
EVFGR(), EVCNM() and EVCGR().
For a complete description of these event
parameters please refer to SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
8
AttemptsIntervalSe
cs
Interval to sleep before retrying to download
a file after an error. This parameter is ignored
if MaxAttempts is set to zero.
ScriptFile
Optional custom jython script file that can be
provided to alter default behavior. For more
information about the scripting feature please
refer to the user manual and provided
developer javadoc documentation
Click OK to add the Site. The following screen appears:
Click Yes to add the password.
NOTE: the password is inserted in the Password Database at Run Time.
9
The following dialog box appears:
The following table explains the fields:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
81
Network Manager
Field
Description / Value
ClientAuth
SSH Client Authentication
Value
Description
false
Client only send its Password to
the Server for being authenticated
true,publickey
Client only send its Public Key to
the Server for being authenticated
true,x509
Client only send its X509
certificate to the Server for being
authenticated
false,passwd,publickey,x509
Client send its Public key or its
X509 Certificate or its Password to
the Server for being
authenticated. The first valid
credential is used
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
ServerAuth
icon.
SSH Server Validation.
Value
Description
false
Server credentials are considered
trusted by default and not
checked against Certificate DB
PKHOST/CA sections
true,x509
X509 Certificate is checked
against Certificate DB CA sections
true,publickey
Public key is checked against
Certificate DB PKHOST section
true,publickey,x509
Public key or X509 validation are
checked against Certificate DB
PKHOST or CA sections
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
82
EMAFTM089/03
Network Manager
Field
Description / Value
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: it is possible to set the values for the
ServerAuth parameter by right-clicking on the
SFTP Pull.
ServerHostMatch
SSH X.509 Server Subject CN matching with
hostname/IP address.
Value
true
Description
The remote hostname/IP
address is checked syntactically
against the "CN" field of the
X.509 Subject
The remote hostname/IP
address is not checked
syntactically against the "CN"
field of the X.509 Subject
For a complete description of the parameter
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
false
To insert the value click on the
icon.
10 To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
11 Export/Import X.509 Certificate (see Sections 4.3.3.6 and 4.3.3.7).
3.3.3.3 Remove an SFTP Site
1
Right-click the SFTP Site (Master/Pull) you want to delete.
2
Select Remove (Master/Pull) . The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
83
Network Manager
3
Click Yes to delete the SFTP Site, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.3.4 Modify an SFTP Site
1
Right-click the SFTP Site (Master/Pull) you want to modify.
2
Select Modify (Master/Pull).
The window of the selected SFTP Site appears and you can make your
changes (see Section 3.3.3.1 for the SFTP Master fields and Section 3.3.3.2
for SFTP Pull fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: the fields Hostname and Port cannot be modified.
3.3.3.5 View and Set the Default properties of an SFTP Site
1
Right-click the SFTP Master/Pull.
2
Select Modify Default (Master/Pull).
Now you can view and modify the Default properties.
See Sections 3.3.3.1and 3.3.3.2 for further details.
3
Click OK to modify default, or Cancel to abort the operation.
4
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.3.6 Export X.509 Client Certificate
1
Right-click the SFTP Site
2
Select Export X.509 Client Certificate. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
84
EMAFTM089/03
Network Manager
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
3.3.3.7 Import X.509 Server Certificate
1
Right-click the SFTP Site.
2
Select Import X.509 Server Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
85
Network Manager
3.3.3.8 Export Client Public Key
The Export Client Public Key operation is not supported by SPAZIO
Management Console, but can be performed using the utility tokedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.3.3.9 Import Server Public Key
The Import Server Public Key operation is not supported by SPAZIO
Management Console, but can only be performed using the utility certedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.3.4
SPAZIO Site
The following section describes how to configure a remote SPAZIO Node.
For further details see SPAZIO MFT/S for Distributed Platforms: Installation and
Configuration Guide.
3.3.4.1 Add TCP Node
When SPAZIO sends files to a remote SPAZIO node configured with a
TCP/IP line, it is necessary to define a TCP Node.
The following steps describe how to add a TCP Node:
1
Right-click on Remote Site
2
Select Add SPAZIO Site. The following pop-up menu appears:
3
Select TCP Node. The following dialog box appears:
4
Enter the Remote Node name in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
86
EMAFTM089/03
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
6
Click Next. The following dialog box appears:
7
Enter the Remote Queue Manager in the Qm Name field
8
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
87
Network Manager
The following table explains the fields in the tab:
Field
Transport Class
9
Description / Values
Default Transport Class for the Remote
Node. For further details see SPAZIO MFT/S
for Distributed Platforms: Installation and
Configuration Guide.
Click Next.
If there is at least one TCP line, the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name.
To select the line click on the
icon.
Time out
Line Time-out used by output conversations
towards the remote node.
Address
The address attribute contains:
Value
Description
Address
IP address of the remote
system
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
88
EMAFTM089/03
Network Manager
Field
Description / Values
Remote Port
Value of the remote port to
use for outgoing
connections
To insert the fields click on the
icon.
If there is no TCP line, the following dialog box appears before:
For details on the fields see Section 3.4.7.1.
10 Fill in the relevant fields.
11 Click OK to add the Node, or Cancel to abort the operation.
12 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.3.4.2 Add ISC Node
When SPAZIO sends/receive files to/from a remote SPAZIO node
configured with a ISC line, it is necessary to define a ISC Node.
The following steps describe how to add a ISC Node:
1
Right-click on Remote Site
2
Select Add SPAZIO Site. The following pop-up menu appears:
3
Select ISC Node. The following dialog box appears:
4
Enter the Remote Node name in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
89
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
6
Click Next. The following dialog box appears:
7
Insert the Remote Queue Manager name in the Qm Name field.
8
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
90
EMAFTM089/03
Network Manager
The following table explains the fields in the tab:
Field
Transport Class
Description / Values
Default Transport Class for the Remote
Node.
For further details see SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
9
Click Next.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
91
Network Manager
If there is at least one ISC line the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name
To select the line click on the
icon.
Time out
Line Time-out used by output conversations
towards the remote node.
Address
The address attribute contains:
Value
Description
Address
IP address of the remote
system
Remote Port
Value of the remote port to
use for outgoing
connections
To insert the fields click on the
icon.
If there is no ISC line, the following dialog box appears before:
For details on the fields see Section 3.4.7.2.
10 Fill in the relevant fields.
11 Click OK to add the node, or Cancel to abort the operation.
12 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
92
EMAFTM089/03
Network Manager
3.3.4.3 Add ISC/PPS Node
When SPAZIO sends/receives files to/from a remote SPAZIO node
configured with an ISC line with Point-to-Point Security, it is necessary to
define an ISC/PPS Node.
The following steps describe how to add an ISC/PPS Node:
1
Right-click on Remote Site
2
Select Add SPAZIO Site. The following pop-up menu appears:
3
Select ISC/PPS Node. The following dialog box appears:
4
Enter the Remote Node name in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
93
Network Manager
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
6
Click Next. The following dialog box appears:
7
Insert the Remote Queue Manager name in the Qm Name field.
8
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Transport Class
9
Description / Values
Default Transport Class for the Remote
Node. For further details see SPAZIO MFT/S
for Distributed Platforms: Installation and
Configuration Guide.
Click Next.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
94
EMAFTM089/03
Network Manager
If there is at least one ISC/PPS, the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name
To select the line click on the
icon.
Time out
Line Time-out used by output conversations
towards the remote node.
Address
The address attribute contains:
Address
IP address of the remote system
Remote
Port
Value of the remote port to use
for outgoing connections
To insert the fields click on the
icon.
If there is no a ISC/PPS line, the following dialog box appears before:
For details about the fields see Section 3.4.7.3.
10 Fill in the relevant fields.
11 Click OK to add the node, or Cancel to abort the operation.
12 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
95
Network Manager
14 Export/Import X.509 Certificate (see Sections 3.3.4.10 and 3.3.4.11).
3.3.4.4 Add ISCL Node
When SPAZIO sends/receives files to/from a remote SPAZIO node
configured with an ISCL line, it is necessary to define an ISCL Node.
The following steps describe how to add an ISCL Node:
1
Right-click on Remote Site
2
Select Add SPAZIO Site. The following pop-up menu appears:
3
Select ISCL Node. The following screen appears:
4
Enter the Remote Node name in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
96
EMAFTM089/03
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
6
Click Next. The following dialog box appears:
7
Insert the Remote Queue Manager name in the Qm Name field
8
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Transport Class
Description / Values
Default Transport Class for the Remote
Node.
For further details see SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
97
Network Manager
9
Click Next.
If there is at least one ISCL line the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name.
To select the line click on the
icon.
Time out
Line Time-out used by output conversations
towards the remote node.
Address
The address attribute contains:
Address
IP address of the remote system
Remote
Port
Value of the remote port to use
for outgoing connections
To insert the fields click on the
icon.
If there is no ISCL line, the following dialog box appears before:
For details about the fields see Section 3.4.7.4.
10 Fill in the relevant fields.
11 Click OK to add the Node, or Cancel to abort the operation.
12 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
98
EMAFTM089/03
Network Manager
3.3.4.5 Add ISCL/PPS Node
When SPAZIO sends/receives files to a remote SPAZIO node configured
with an ISCL line with Point-to-Point Security, it is necessary to define an
ISCL/PPS Node.
The following steps describe how to add an ISC/PPS Node:
1
Right-click on Remote Site
2
Select Add SPAZIO Site. The following pop-up menu appears:
3
Select ISCL/PPS Node…. The following dialog box appears:
4
Enter the Remote Node name in the Node Name field.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
99
Network Manager
Field
Description / Values
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
6
Click Next. The following dialog box appears:
7
Insert the Remote Queue Manager name in the Qm Name field
8
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Transport Class
Description / Values
Default Transport Class for the Remote
Node.
For further details see SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
9
Click Next.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
100
EMAFTM089/03
Network Manager
If there is at least one ISCL/PPS line the following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name.
To select the line click on the
icon.
Time out
Line Time-out used by output conversations
towards the remote node.
Address
The address attribute contains:
Address
IP address of the remote system
Remote
Port
Value of the remote port to use
for outgoing connections
To insert the fields click on the
icon.
If there is no ISCL/PPS line, the following dialog box appears before:
For details on the fields see Section 3.4.7.5.
10 Fill in the relevant fields.
11 Click OK to add the Node, or Cancel to abort the operation.
12 To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
101
Network Manager
12 Export/Import X.509 Certificate (see Sections 3.3.4.10 and 3.3.4.11).
3.3.4.6 Add PR5 Node
When SPAZIO sends/receives files to/from a remote SPAZIO node
configured with a PR5 line, you need to define a PR5 Node.
The following steps describe how to add a PR5 Node:
1
Right-click on Remote Site.
2
Select Add SPAZIO Site. The following pop-up menu appears:
1
Select PR5 Node…. The following dialog box appears:
Select Yes only if you wish to administrate the remote node, or to
send/receive also using the PR4 protocol (for further details see SPAZIO
MFT/S for Distributed Platforms: SPXP Transports).
2
The following dialog box appears:
5
Enter the Remote Node name in the Node Name field.
6
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
102
EMAFTM089/03
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
SysName
SPAZIO System Name.
Maximum 8 characters.
Default: first 8 characters of NodeName.
MaxParallMTrasp
Maximum number of parallel message
transports towards the direct node.
MaxParallFTrasp
Maximum number of parallel file transports
towards the direct node.
7
Click Next. The following dialog box appears:
8
Insert the Remote Queue Manager name in the Qm Name field.
9
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
103
Network Manager
The following table explains the fields in the tab:
Field
Transport Class
Description / Values
Default Transport Class for the Remote
Node.
For further details see SPAZIO MFT/S for
Distributed Platforms: Installation and
Configuration Guide.
10 Click Next.
If the option chosen in step 3 is No, jump to step 12.
Otherwise, if there is at least one ISCL line the following dialog box
appears:
The following table explains the fields in the tab:
Field
Description / Values
Line Name
Symbolic Line name.
To select the line click on the
icon.
Time out
Line Timeout used by outgoing conversations
to the remote node.
Address
The address attribute contains:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
104
EMAFTM089/03
Network Manager
Field
Description / Values
Address
IP address of the remote system
Remote
Port
Number of the remote port to be
used for outgoing connections
To insert the fields click on the
icon.
If there is no ISCL line, the following dialog box appears first:
For details on the fields see Section 3.4.7.4.
11 Fill in the relevant fields.
12 Click Next. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Pr5 Master
Hostname
Hostname or TCP/IP address of the
destination PR5 Server.
Pr5 Master Port
TCP/IP port on which the destination PR5
Server is listening.
Pr5 Master Enabled
Switch to disable a remote node without
removing it.
13 Click OK to add the Node, or Cancel to abort the operation.
14 To activate the configuration, you have to click Apply at the bottom left of
the window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
105
Network Manager
3.3.4.7 Add a Queue Manager to a Remote Node
1
Right click on the Remote Node to which you want add a Remote Queue
Manager
2
Select Add Queue Manager…. The following dialog box appears:
3
Insert the Remote Queue Manager name.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the field:
Field
Description / Values
Transport Class
Default Transport Class for the Remote
Node.
6
Click OK to add the Queue Manager, or click Cancel to abort the
operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.3.4.8 Modify a Remote Node
1
Right-click the Remote Node you want modify.
2
Select Modify Remote Node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
106
EMAFTM089/03
Network Manager
The window of the selected Remote Node appears and you can make
your changes (see Section 3.3.4.1 to Section 3.3.4.4 for the fields).
3
Click OK to confirm the changes or Cancel to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.4.9 Modify a Line for a Remote Node
1
Right-click the Remote Node you want modify the line.
2
Select Modify Remote Line.
The window of the Line for the selected Remote Node appears and you
can make your changes (see Section 3.3.4.1 to Section 3.3.4.4 for the fields).
3
Click OK to confirm the changes or Cancel to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.4.10 Remove a Remote Node
1
Right-click the Remote Node you want to delete.
2
Select Remove Remote Node . The following screen appears
3
Click Yes to delete the Remote Node, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.3.4.11 Export X.509 Client Certificate
1
Right-click the ISC/ISCL PPS Node
2
Select Export X.509 Client Certificate. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
107
Network Manager
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
3.3.4.12 Import X.509 Server Certificate
1
Right-click the ISC/ISCL PPS Node
2
Select Import X.509 Server Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
108
EMAFTM089/03
Network Manager
3.3.5
PESIT Site
The following section describes how to configure a PESIT Master.
3.3.5.1 Add a PESIT Master
A PESIT Master is a client protocol application that sends files stored on a
remote queue to a PESIT Server.
The following steps describe how to add a PESIT Master:
1
Right-click on Remote Site.
2
The following dialog box appears:
3
Select Master. The following dialog box appears:
4
Enter a name for the destination PESIT Server in the Node Name field.
5
Click Next.
If there is one PESIT line the following dialog box appears:
The following table explains the field in the Address attribute:
Field
Description / Values
Address
TCP/IP address of the destination PESIT
Server
Remote Port
TCP/IP port on which the destination PESIT
Server is listening
Local ID
Identifier of the local PESIT node.
Default: local Queue Manager Name
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
109
Network Manager
Field
Description / Values
Remote ID
Identifier of the destination PESIT node.
Default: remote Queue Manager Name
To insert the fields click on the
icon.
The following table explains the fields in the Advanced tab:
Field
Description / Values
MaxParallFtrasp
Maximum number of parallel file transports
towards the PESIT Server
Transport Class
Default Transport Class for the PESIT Site
If there is no PESIT line, the following dialog box appears before:
For details on the fields see Section 3.4.6.1.
6
Fill in the relevant field.
7
Click OK to add the Node, or Cancel to abort the operation.
8
To activate the configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: if there isn’t any PESIT line and you create a PESIT remote site
master, automatically, a PESIT line is created.
3.3.5.2 Remove a PESIT Site
1
Right-click the PESIT Site Master you want to delete.
2
Select Remove Master . The following screen appears:
3
Click Yes to delete the PESIT Site, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
110
EMAFTM089/03
Network Manager
3.3.5.3 Modify a PESIT Site
1
Right-click the PESIT Site Master you want to modify.
2
Select Modify Master.
The window of the selected PESIT Master appears and you can make
your changes (see Section 3.3.5.1 for the PESIT Master fields).
3
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
111
Network Manager
3.4
Server Connection
In the Server Connection folder, SPAZIO Management Console allows you to
define the servers that can be activated on the current node. Activation of
these servers depends on what is specified in the Spazio license.
3.4.1
DMZ Driver
The section below describes how to configure a Spazio DMZ Driver.
Spazio DMZ Driver is a SSH client installed on the intranet which is able to
establish a secure connection with a SSH server deployed in the DMZ (Spazio
DMZ Agent), which will be used by the agent at runtime to transfer files.
For further details see SPAZIO MFT/S for Distributed Platforms: SPAZIO DMZ
Gateway.
NOTE: it is not possible to create more than one DMZ Driver.
3.4.1.1 Add a DMZ Driver
1
Right-click on the DMZ folder.
2
Select Add DMZ Driver. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
InternalListening
Address
Spazio DMZ Agent TCP/IP address or
hostname where the agent is listening for
commands.
InternalCommandPo
rt
Spazio DMZ Agent listening port.
ExternalListening
Address
Spazio DMZ Agent TCP/IP address or
hostname where ports are opened for
tunneling incoming connections from the
external interface
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
112
EMAFTM089/03
Network Manager
User
Username connecting to Spazio DMZ Agent.
Default: NodeName
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
ReconnIntervalSecs
Interval in seconds between connection
attempts to the Spazio DMZ Agent.
Default: 30
ReconnAttempts
Number of connection attempts to the Spazio
DMZ Agent.
Default: -1 means infinite attempts
Trace
Trace level.
Value
Description
NO
No tracing enabled
YES
Normal tracing enabled
ALL
Detailed enabled
TraceFile
Output trace file name; this file is created in
the SPAZIO trace directory
TraceFileNumber
If specified and > 1, it specifies the number of
backup files used when rolling.
5
Click OK to create the Spazio DMZ Driver, or Cancel to abort the
operation.
6
Enable System Routes (see Section 3.4.1.2).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
113
Network Manager
To activate this change you have to click Apply at the bottom left of the
window and restart SPAZIO.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
User's PIN for accessing the token is required in the following dialog
box:
7
Export/Import X.509 Certificate (see Sections 3.4.1.5 and 3.4.1.6).
8
Export/Import PublicKey (see Sections 3.4.1.7 and 3.4.1.8).
3.4.1.2 System Routes
System routes are routes associated with transport protocols supported and
configured on the node. For these routes the user should only specify which
of them need to be activated.
1
Click on the DMZ driver, the System Route icon appears.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
114
EMAFTM089/03
Network Manager
2
Click on the System Route icon, the list of the routes appears:
3
To activate a System Route, right-click on the name.
3.4.1.3 Modify a DMZ Driver
1
Right-click the DMZ Driver.
2
Select Modify.
The window of the selected DMZ Driver appears and you can make your
changes (see Section 3.4.1.1 for the DMZ Driver fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
115
Network Manager
3.4.1.4 Remove a DMZ Driver
1
Right-click the DMZ Driver
2
Select Remove. The following screen appears:
3
Click Yes to delete the DMZ Driver, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.1.5 Export X.509 DMZ Driver Certificate
1
Right-click the DMZ folder.
2
Select Export X.509 Client Certificate. The following screen appears:
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
3.4.1.6 Import X.509 DMZ Agent Certificate
1
Right-click the DMZ Driver
2
Select Import X.509 Server Certificate. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
116
EMAFTM089/03
Network Manager
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation.
5
The following screen appears:
3.4.1.7 Export DMZ Driver Public Key
The Export Client Public Key operation is not supported by SPAZIO
Management Console, but can be performed using the utility tokedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.4.1.8 Import DMZ Agent Public Key
The Import Server Public Key operation is not supported by SPAZIO
Management Console, but can only be performed using the utility certedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.4.2
FTP Server
The following section describes how to configure SPAZIO MFT/S as an FTP
Server.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
3.4.2.1 Add an FTP Server
1
Right-click on the FTP folder.
2
Select Add FTP Server. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
117
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
ListeningAddress
TCP/IP address on which the FTP Server will
listen. If IP 0.0.0.0 is provided, it will listen on
any available address.
ListeningPort
TCP/IP port on which the FTP Server will
listen
SessionTimeoutSec
Seconds after which a session will time out and
be closed by the server
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Enabled
Switch to disable the server without removing
it.
Value
Description
true
Definition is enabled
false
Definition is disabled
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
118
EMAFTM089/03
Network Manager
Field
Description / Values
MaxSessions
Maximum number of parallel sessions that will
be served
ActiveDataConnLoc
alAddress
Local address to be used by the FTP Server for
active mode file transfers when performing
outgoing data connections to the client. This is
typically not set.
ActiveDataConnLoc
alOutPort
Local port to be used by the FTP Server for
active mode file transfers when performing
outgoing data connections to the client.
PassiveDataConnLo
calAddress
Local TCP/IP address of the FTP Server as
seen by a remote client. In passive mode file
transfers, this address is provided by the
server to the client in a PASV command (set
passive mode command) response, and it is
used by the client to establish a data
connection back to the originating server.
PassiveDataConnLo
calInPortRange
Local port range the FTP Server can use for
passive mode file transfers. In passive mode
file transfers, one available port from the
specified range is selected by the server and
sent to the client in a PASV command (set
passive mode command) response, it is then
used by the client to establish a data
connection back to the originating server
UsersFile
File contains all per-user configurations for the
FTP Server.
Default: spxp.users.properties
NOTE: If you have several server components
installed that require different configurations
for the same users, you can create a server
specific user configuration file. For more
details see SPAZIO MFT/S for Distributed
Platforms: SPXP Transports.
5
Click OK to confirm the creation, or Cancel to abort the operation.
6
Add FTP Users (see Section 3.4.2.2).
7
To activate this change you have to click Apply and restart Spazio.
3.4.2.2 Modify an FTP Server
1
Right-click the FTP Server you want to modify.
2
Select Modify.
The window of the selected FTP Server appears and you can make your
changes (see Section 3.4.2.1 for the FTP Server fields).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
119
Network Manager
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.2.3 Remove an FTP Server
1
Right-click the FTP Server
2
Select Remove. The following screen appears:
3
Click Yes to delete the FTP Server, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.2.4 Users and Virtual File System
When SPAZIO MFT/S plays the role of an FTP Server, administrators are
provided with some items of information that determine:
„
Who is entitled to gain access to SPAZIO MFT/S over that protocol
„
Which credential to use for accessing SPAZIO MFT/S resources
„
How SPAZIO MFT/S resources (queues and files) should be exposed for
each user.
Because when connecting to the server, the userid and password specified by
the client application are used to access to the SPAZIO Objects, and the user
is presented with a virtual file system (VFS) structure, i.e. a directory
hierarchy that does not exist on the real file system but is rendered at run
time by SPAZIO and can be navigated as a normal file system.
Each user can have several explicit VFS directories associated with its
configuration.
Each explicit VFS directory is mapped to a SPAZIO MFT/S object or group of
objects. The SPAZIO MFT/S objects that can be mapped to a VFS directory
are:
„
Queue: The virtual path will contain all the files in the queue.
„
Queue Manager: The virtual path will show all the queues in the queue
manager as subdirectories. These directories will be populated with the
files present in each queue.
„
Node: The virtual path will show the list of queue managers defined in
the local SPAZIO MFT/S node as subdirectories. The content of each
queue manager will be as specified in previous section.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
120
EMAFTM089/03
Network Manager
For further details see the manual SPAZIO MFT/S for Distributed Platforms:
SPXP Transports.
View and Set Default properties for Users
1
Select the Users folder
2
The Default properties for Users are displayed in the right panel:
3
Right-click on Users folder and select Modify Default.
4
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
HomeDirectory
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
121
Network Manager
Field
GetDisposition
FileRendering
Description / Values
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
Replace
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
leave
Files are left on the underlying
queue
Remove
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
flatCorrelId
Files with the same CorrelId
are shown as different
elements of the same virtual
directory. The first element
in queue is identified by the
CorrelId value while others
are identified by a unique
name made up of the
internalNumber appended
to the CorrelId and
separated by a dot
(CorrelId.InternalNumber)
nestedCorrelId
If files with the same
CorrelId are present in
current queue they are
represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the
list of files with the
specified CorrelId. Files in
that sub directory are
identified with the
InternalNumber.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
122
EMAFTM089/03
Network Manager
Field
Description / Values
destFileName
FileBrowsing
Files with the same
Destination File Name are
shown as different elements
of the same virtual
directory. The first element
in queue is identified by the
Destination File Name
value while others are
identified by a unique name
made of the
InternalNumber appended
to the Destination File
Name and separated by a
dot
(destFileName.InternalNu
mber)
Policy used to optionally limit the visibility of
files when listing or downloading.
Value
Description
All
All files can be listed and
downloaded
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.:
when an FTP client performs a
GET) or when they are acquired
by any other Spazio utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
123
Network Manager
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
*
All the protocols
NONE
No protocols allowed
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
Right-click on the Users folder and select Modify Default VFS.
9
The following dialog box appears:
The following table explains the field:
Field
Description / Values
DirMapping
Name of the SPAZIO MFT/S queue to be
mapped to the HomeDirectory explicit VFS
directory or one of the following macros and
special functions
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name that
is the same as the login user name.
NOTE: The QMgr parameter of
the current user has not been set
to '*' but with the Queue Manager
name.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
124
EMAFTM089/03
Network Manager
Field
Description / Values
${QUEUE(<queueName)}
The virtual path will contain all
files in the queue.
NOTE: The QMgr parameter of
the current user has not been set
to '*' but with the Queue Manager
name.
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: The QMgr parameter of
the current user has not been set
to '*' but with the Queue Manager
name.
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue
${NODE}
The virtual path will show the list
of queue managers defined in the
local SPAZIO MFT/S node as
subdirectories. The content of each
queue manager will be as specified
in previous section.
10 Click OK to confirm the changes, or Cancel to abort the operation
11 To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: The Default properties for the Users are the values that will be used
at runtime for users that do not have their own user specific configuration
or for users that do not have a specific parameter set in their own user
specific configuration.
NOTE: If you have used the same UserFile for all the servers defined (FTP,
FTP/S and SFTP), all the users will share the same Default Properties.
Add a User
1
Right-click on the Users folder.
2
Select Add User. The list of the defined Users appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
125
Network Manager
3
Select the User you want to add and click OK.
4
The User is now displayed in the left panel:
5
Click on the User. The left column now displays the Virtual File System
folder. The right column displays the properties for the user:
6
Click on the Virtual File System folder, the default VFS appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
126
EMAFTM089/03
Network Manager
7
To activate this change you have to click Apply and restart Spazio.
Add a Virtual File System for a User
1
Select the Users folder.
2
Select the User you wish to add a VFS.
3
Select the VFS folder.
4
Right-click on the VFS folder and select Add Virtual File System.
5
The following dialog box appears:
6
Insert a virtual path for the User.
7
Click OK. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
127
Network Manager
The following table explains the field:
Field
Description / Values
DirMapping
Name of the SPAZIO MFT/S queue to be
mapped to the VFS Path explicit VFS directory
or one of the following macros and special
functions.
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name that
is the same as the login user name.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name.
${QUEUE(<queueName)}
The virtual path will contain all
files in the queue.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name.
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name.
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue
${NODE}
The virtual path will show the list
of queue managers defined in the
local SPAZIO MFT/S node as
subdirectories. The content of each
queue manager will be as specified
in previous section.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
128
EMAFTM089/03
Network Manager
8
Insert the value and click OK to add the Virtual File System or Cancel to
abort the operation.
9
To activate this change you have to click Apply and restart Spazio.
Modify Properties for the User
1
Select the Users folder.
2
Select the User for which you wish to update the properties.
3
Right-click on the User and select Modify.
4
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
GetDisposition
Value
Description
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
Replace
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
129
Network Manager
Field
FileRendering
Description / Values
leave
Files are left on the underlying
queue
Remove
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
flatCorrelI
d
Files with the same CorrelId are
shown as different elements of
the same virtual directory. The
first element in queue is
identified by the CorrelId value
while others are identified by a
unique name made up of the
internalNumber appended to
the CorrelId and separated by a
dot (CorrelId.InternalNumber)
nestedCorre
lId
If files with the same CorrelId
are present in current queue
they are represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the list
of files with the specified
CorrelId. Files in that sub
directory are identified with the
InternalNumber.
destFileNam
e
Files with the same Destination
File Name are shown as
different elements of the same
virtual directory.
The first element in queue is
identified by the Destination File
Name value while others are
identified by a unique name
made of the InternalNumber
appended to the Destination File
Name and separated by a dot
(destFileName.InternalNumber)
FileBrowsing
Policy used to optionally limit the visibility of files
when listing or downloading.
Value
Description
All
All files can be listed and
downloaded
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
130
EMAFTM089/03
Network Manager
Field
Description / Values
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.: when
an FTP client performs a GET)
or when they are acquired by
any other Spazio utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
Field
Description / Values
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
*
All the protocols
NONE
No protocols allowed
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
131
Network Manager
Field
Description / Values
HomeDirectory
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
Modify a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to modify the VFS.
3
Select the VFS folder.
4
Right click on the VFS and select Modify.
5
The following dialog box appears:
6
Make the change (see section above for the field).
7
Click OK to confirm the change, or Cancel to abort the operation.
8
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a User
1
Select the Users folder.
2
Right click on the User you wish to remove.
3
Select Remove.
4
The following dialog box appears:
5
Click Yes to confirm the delete, or No to abort the operation.
6
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
132
EMAFTM089/03
Network Manager
Remove a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to remove the VFS.
3
Select the VFS folder.
4
Right click on the VFS and select Remove.
5
The following dialog box appears:
6
Click Yes to confirm the delete, or No to abort the operation.
7
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: you can remove the default VFS only when you have created a new
one.
3.4.2.5 Enable/Disable Anonymous Access
The FTP protocol allows for a special user named anonymous for which
special password validation semantics are enforced.
When connecting to an FTP Server allowing anonymous user access the
password that is optionally specified by the client will not be checked by the
server.
SPAZIO as FTP Server allows the use of the anonymous user, provided that a
user named anonymous with fixed password anonymous is configured in the
SPAZIO Authentication Provider.
For further details see A3SP Installation, Configuration and User Guide.
To enable Anonymous Access, you have to:
3.4.3
1
Right-click on the FTP server.
2
Select Enable Anonymous Access.
3
To activate this change you have to click Apply and restart Spazio.
FTP/S Server
The following section describes how to configure SPAZIO MFT/S as FTP/S
Server.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
133
Network Manager
3.4.3.1 Add an FTP/S Server
1
Right-click on the FTPS folder.
2
Select Add FTPS Server. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
ListeningAddress
TCP/IP address on which the FTP/S Server
will listen; if IP 0.0.0.0 is provided, it will listen
on any available address.
ListeningPort
TCP/IP port on which the FTP/S Server will
listen.
SessionTimeoutSec
Seconds after which a session will time out and
be closed by the server.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Enabled
Switch to disable the server without
removing it.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
134
EMAFTM089/03
Network Manager
Field
Description / Values
Value
Description
true
Definition is enabled
false
Definition is disabled
MaxSessions
Maximum number of parallel sessions that
will be served
PassiveDataConnLoc
alAddress
Local TCP/IP address of the FTP/S Server as
seen by a remote client. In passive mode file
transfers, this address is provided by the
server to the client in a PASV command (set
passive mode command) response, and it is
used by the client to establish a data
connection back to the originating server.
PassiveDataConnLoc
alInPortRange
Local port range the FTP/S Server can use for
passive mode file transfers. In passive mode
file transfers, one available port from the
specified range is selected by the server and
sent to the client in a PASV command (set
passive mode command) response, it is then
used by the client to establish a data
connection back to the originating server.
SSL Control
Required mode for SSL/TLS connection:
SSLAuthenticationP
rotocol
Value
Description
explicit
Establish an explicit SSL/TLS
connection (via AUTH
command), recommended.
implicit
Establish an implicit SSL/TLS
connection, most FTP/S
Servers will listen for implicit
connections on port 990,
reconfigure your Conn.Port
parameter as needed.
Protocol required.
Value
Description
TLS
Preferred and recommended
protocol for using FTP/S
SSL
Alternative (older) protocol
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
135
Network Manager
Field
UsersFile
Description / Values
File contains all the per-user configurations
for the FTP/S Server.
Default: spxp.users.properties
NOTE: if you have several server
components installed that require different
configurations for the same users, you can
create a server specific user configuration
file. For more details see SPAZIO MFT/S for
Distributed Platforms: SPXP Transports
5
Click OK to confirm the creation. The following dialog box appears:
The following table explains the fields:
Field
Description / Value
ClientAuth
SSL Client Authentication
Value
Description
false
Password authentication.
true
Password and X509 Certificate
authentication
For a complete description of the parameter please
refer to Data Secure for SPAZIO MFT/S (DSSP)
Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: it is possible to set the values for the
ClientAuth parameter by right clicking on the
FTP/S Server.
6
Click OK to confirm the creation, or Cancel to abort the operation.
7
Add FTP/S Users (see Section 3.4.2.2).
8
To activate this change you have to click Apply and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
The user's PIN for accessing the token is required in the following
dialog box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
136
EMAFTM089/03
Network Manager
9
Export/Import X.509 Certificate (see Sections 3.4.3.4 and 3.4.3.5).
3.4.3.2 Modify an FTP/S Server
1
Right-click the FTP/S Server you want to modify.
2
Select Modify.
The window of the selected FTP/S Server appears and you can make
your changes (see Section 3.4.3.1 for the FTP/S Server fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.3.3 Remove an FTP/S Server
1
Right-click the FTP/S Server
2
Select Remove. The following screen appears:
3
Click Yes to delete the FTP/S Server, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.3.4 Export X.509 Server Certificate
1
Right click on the FTPS folder.
2
Select Export X.509 Server Certificate. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
137
Network Manager
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
3.4.3.5 Import an X.509 Client Certificate
1
Right click the FTPS server.
2
Select Import X.509 Client Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
138
EMAFTM089/03
Network Manager
3.4.3.6 Users and Virtual Files
When SPAZIO MFT/S plays the role of an FTP/S Server, administrators are
provided with some items of information that determine:
„
Who is entitled to gain access to SPAZIO MFT/S over that protocol
„
Which credential to use for accessing SPAZIO MFT/S resources
„
How SPAZIO MFT/S resources (queues and files) should be exposed for
each user.
Because when connecting to the server, the userid and password specified by
the client application are used to access to the SPAZIO Objects, and the user
is presented with a virtual file system (VFS) structure, i.e. a directory
hierarchy that does not exist on the real file system but is rendered at run
time by SPAZIO and can be navigated as a normal file system.
Each user can have several explicit VFS directories associated with its
configuration.
Each explicit VFS directory is mapped to a SPAZIO MFT/S object or group of
objects. The SPAZIO MFT/S objects that can be mapped to a VFS directory
are:
„
Queue: The virtual path will contain all the files in the queue.
„
Queue Manager: The virtual path will show all the queues in the queue
manager as subdirectories. These directories will be populated with the
files present in each queue.
„
Node: The virtual path will show the list of queue managers defined in the
local SPAZIO MFT/S node as subdirectories. The content of each queue
manager will be as specified in previous section.
For further details see the manual SPAZIO MFT/S for Distributed Platforms:
SPXP Transports.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
139
Network Manager
View and Set Default properties for Users
1
Select the Users folder
2
The Default properties for Users are displayed in the right panel:
3
Right-click on Users folder and select Modify Default.
4
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
HomeDirectory
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
Value
Description
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
140
EMAFTM089/03
Network Manager
Field
Description / Values
Replace
GetDisposition
FileRendering
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
leave
Files are left on the underlying
queue
Remove
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
flatCorrelId
Files with the same CorrelId
are shown as different
elements of the same virtual
directory. The first element
in queue is identified by the
CorrelId value while others
are identified by a unique
name made up of the
internalNumber appended
to the CorrelId and
separated by a dot
(CorrelId.InternalNumber)
nestedCorrelId
If files with the same
CorrelId are present in
current queue they are
represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the
list of files with the
specified CorrelId. Files in
that sub directory are
identified with the
InternalNumber.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
141
Network Manager
Field
Description / Values
destFileName
FileBrowsing
Files with the same
Destination File Name are
shown as different elements
of the same virtual
directory. The first element
in queue is identified by the
Destination File Name
value while others are
identified by a unique name
made of the
InternalNumber appended
to the Destination File
Name and separated by a
dot
(destFileName.InternalNu
mber)
Policy used to optionally limit the visibility of
files when listing or downloading.
Value
Description
All
All files can be listed and
downloaded
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.:
when an FTP/S client performs
a GET) or when they are
acquired by any other Spazio
utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
142
EMAFTM089/03
Network Manager
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
*
All the protocols
NONE
No protocols allowed
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
Right-click on the Users folder and select Modify Default VFS.
9
The following dialog box appears:
The following table explains the field:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
143
Network Manager
Field
DirMapping
Description / Values
Name of the SPAZIO MFT/S queue to be
mapped to the HomeDirectory explicit VFS
directory or one of the following macros and
special functions
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name
that is the same as the login user
name.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QUEUE(<queueName)}
The virtual path will contain all
files in the queue.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue
${NODE}
The virtual path will show the list
of queue managers defined in the
local SPAZIO MFT/S node as
subdirectories. The content of
each queue manager will be as
specified in previous section.
10 Click OK to confirm the changes, or Cancel to abort the operation
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
144
EMAFTM089/03
Network Manager
11 To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: The Default properties for the Users are the values that will be used
at runtime for users that do not have their own user specific configuration
or for users that do not have a specific parameter set in their own user
specific configuration.
NOTE: If you have used the same UserFile for all the servers defined (FTP,
FTP/S and SFTP), all the users will share the same Default Properties.
Add a User
1
Right-click on the Users folder.
2
Select Add User. The list of the defined Users appears:
3
Select the User you want to add and click OK.
4
The User is now displayed in the left panel:
5
Click on the User. The left column now displays the Virtual File System
folder. The right column displays the properties for the user:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
145
Network Manager
6
Click on the Virtual File System folder, the default VFS appears
7
To activate this change you have to click Apply and restart Spazio.
Add a Virtual File System for a User
1
Select the Users folder.
2
Select the User you wish to add a VFS.
3
Select the VFS folder.
4
Right-click on the VFS folder and select Add Virtual File System.
5
The following dialog box appears:
6
Insert a virtual path for the User.
7
Click OK. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
146
EMAFTM089/03
Network Manager
The following table explains the field:
Field
Description / Values
DirMapping
Name of the SPAZIO MFT/S queue to be
mapped to the VFS Path explicit VFS
directory or one of the following macros and
special functions.
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name
that is the same as the login user
name.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QUEUE(<queueName)}
The virtual path will contain all
files in the queue.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: the QMgr parameter of
the current user has not been set
to '*' but with the Queue
Manager name.
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
147
Network Manager
Field
Description / Values
${NODE}
The virtual path will show the
list of queue managers defined in
the local SPAZIO MFT/S node as
subdirectories. The content of
each queue manager will be as
specified in previous section.
8
Insert the value and click OK to add the Virtual File System or Cancel to
abort the operation.
9
To activate this change you have to click Apply and restart Spazio.
Modify Properties for the User
1
Select the Users folder.
2
Select the User for which you wish to update the properties.
3
Right-click on the User and select Modify.
4
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
Value
Description
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
148
EMAFTM089/03
Network Manager
Field
Description / Values
Replace
GetDisposition
FileRendering
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
Leave
Files are left on the underlying
queue
Remove
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
flatCorrelI
d
Files with the same CorrelId are
shown as different elements of
the same virtual directory. The
first element in queue is
identified by the CorrelId value
while others are identified by a
unique name made up of the
internalNumber appended to
the CorrelId and separated by a
dot (CorrelId.InternalNumber)
nestedCorre
lId
If files with the same CorrelId
are present in current queue
they are represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the list
of files with the specified
CorrelId. Files in that sub
directory are identified with the
InternalNumber.
destFileNam
e
Files with the same Destination
File Name are shown as
different elements of the same
virtual directory.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
149
Network Manager
Field
Description / Values
The first element in queue is
identified by the Destination File
Name value while others are
identified by a unique name
made of the InternalNumber
appended to the Destination File
Name and separated by a dot
(destFileName.InternalNumber)
FileBrowsing
Policy used to optionally limit the visibility of
files when listing or downloading.
Value
Description
All
All files can be listed and
downloaded
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.:
when an FTP client performs a
GET) or when they are acquired
by any other Spazio utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
150
EMAFTM089/03
Network Manager
Field
Description / Values
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
HomeDirectory
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
*
All the protocols
NONE
No protocols allowed
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
Modify a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to modify the VFS.
3
Select the VFS folder.
4
Right click on the VFS and select Modify.
5
The following dialog box appears:
6
Make the change (see section above for the field).
7
Click OK to confirm the change, or Cancel to abort the operation.
8
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a User
1
Select the Users folder.
2
Select the User you wish to remove.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
151
Network Manager
3
Select Remove.
4
The following dialog box appears:
5
Click Yes to confirm the delete, or No to abort the operation.
6
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to remove the VFS.
3
Select the VFS folder.
4
Select the VFS and select Remove.
5
The following dialog box appears:
6
Click Yes to confirm the delete, or No to abort the operation.
7
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: you can remove the default VFS only when you have created a new
one.
3.4.3.7 Enable/Disable Anonymous Access
The FTP/S protocol allows for a special user named anonymous for which
special password validation semantics are enforced.
When connecting to an FTP/S Server allowing anonymous user access the
password that is optionally specified by the client will not be checked by the
server.
SPAZIO as FTP/S Server allows the use of the anonymous user, provided
that a user named anonymous with fixed password anonymous is configured
in the SPAZIO Authentication Provider.
For further details see A3SP Installation, Configuration and User Guide.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
152
EMAFTM089/03
Network Manager
To enable Anonymous Access, you have to:
3.4.4
1
Right-click on the FTP/S server.
2
Select Enable Anonymous Access.
3
To activate this change you have to click Apply and restart Spazio.
SFTP Server
The following section describes how to configure SPAZIO MFT/S as an SFTP
Server.
For further details see SPAZIO MFT/S for Distributed Platforms: SPXP
Transports.
3.4.4.1 Add an SFTP Server
1
Right-click on the SFTP folder.
2
Select Add SFTP Server. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
ListeningAddress
TCP/IP address on which the SFTP Server will
listen. If IP 0.0.0.0 is provided, it will listen on
any available address.
ListeningPort
TCP/IP port on which the SFTP Server will
listen.
SessionTimeoutSec
Seconds after which a session will time out and
be closed by the server.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
153
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
Enabled
Switch to disable the server without removing
it.
Value
Description
true
Definition is enabled
false
Definition is disabled
MaxSessions
Maximum number of parallel sessions that will
be served.
UsersFile
File contains all per-user configurations for the
SFTP Server.
Default: spxp.users.properties
NOTE: If you have several server components
installed that require different configurations
for the same users, you can create a server
specific user configuration file. For more
details see SPAZIO MFT/S for Distributed
Platforms: SPXP Transports.
5
Click OK to confirm the creation. The following dialog box appears:
The following table explains the fields:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
154
EMAFTM089/03
Network Manager
Field
Description / Value
ClientAuth
SSH Client Authentication.
If you want to validate remote users through a list
of allowed types of authentication, the possible
values are:
Value
Description
false
Password authentication
false,passwd,publickey
Password or Public Key
authentication
false,passwd,x509
Password or X509 Certificate
authentication
false,publickey,x509
Public key or X509
Certificate authentication
false,passwd,publickey,x509
Password, Public Key or
X509 Certificate
authentication
If you want to validate remote users requiring
more than one type of authentication, the possible
values are:
Value
Description
true
Public key authentication
true,x509
X509 Certificate
authentication
true,publickey
Public key authentication
true,passwd,publickey
Password and Public key
authentication
true,passwd,x509
Password and X509
Certificate authentication
true,passwd,publickey,x509
Password and Public key
authentication or Password
and X509 Certificate
authentication
For a complete description of the parameter please
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
155
Network Manager
refer to Data Secure for SPAZIO MFT/S (DSSP)
Installation, Configuration and User Guide.
To insert the value click on the
icon.
NOTE: it is possible to set the values for the
ClientAuth parameter by right clicking on the
SFTP Server.
ServerAuth
SSH Server Authentication.
Value
Description
false
Server support Password
and Public key
authentication mechanism
true,x509
Server support Password
and X509 Certificate
authentication mechanism
true,
publickey,
x509
Server support Password
and Public key and X509
Certificate authentication
mechanism
For a complete description of the parameters
please refer to Data Secure for SPAZIO MFT/S
(DSSP) Installation, Configuration and User Guide.
To insert the value click on the
icon.
6
Click OK to confirm the creation, or Cancel to abort the operation.
7
Add SFTP Users (see Section 3.4.2.2).
8
To activate this change you have to click Apply and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
The user's PIN for accessing the token is required in the following
dialog box:
9
Export/Import X.509 Certificate (see Sections 3.4.4.3 and 3.4.4.4).
10 Export/Import Public Key (see Sections 3.4.4.5 and 3.4.4.6).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
156
EMAFTM089/03
Network Manager
3.4.4.2 Modify an SFTP Server
1
Right-click the SFTP Server you want to modify.
2
Select Modify.
The window of the selected SFTP Server appears and you can make your
changes (see Section 3.4.4.1 for the SFTP Server fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.4.3 Remove an SFTP Server
1
Right-click the SFTP Server
2
Select Remove. The following screen appears:
3
Click Yes to delete the SFTP Server, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.4.4 Export X.509 Server Certificate
1
Right click on SFTP folder.
2
Select Export X.509 Server Certificate. The following screen appears:
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
157
Network Manager
3.4.4.5 Import an X.509 Client Certificate
1
Right-click the SFTP Server
2
Select Import Client Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
3.4.4.6 Export Server Public Key
The Export Server Public Key operation is not supported by SPAZIO
Management Console, but can be performed using the utility tokedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.4.4.7 Import Client Public Key
The Import Client Public Key operation is not supported by SPAZIO
Management Console, but can only be performed using the utility certedit.
For details see Data Secure for SPAZIO MFT/S (DSSP) Installation,
Configuration and User Guide).
3.4.4.8 Users and Virtual File System
When SPAZIO MFT/S plays the role of an FTP, FTP/S or SFTP Server,
administrators are provided with some items of information that determine:
„
Who is entitled to gain access to SPAZIO MFT/S over that protocol
„
Which credential to use for accessing SPAZIO MFT/S resources
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
158
EMAFTM089/03
Network Manager
„
How SPAZIO MFT/S resources (queues and files) should be exposed for
each user.
Because when connecting to the server, the userid and password specified by
the client application are used to access to the SPAZIO Objects, and the user
is presented with a virtual file system (VFS) structure, i.e. a directory
hierarchy that does not exist on the real file system but is rendered at run
time by SPAZIO and can be navigated as a normal file system.
Each user can have several explicit VFS directories associated with its
configuration.
Each explicit VFS directory is mapped to a SPAZIO MFT/S object or group of
objects. The SPAZIO MFT/S objects that can be mapped to a VFS directory
are:
„
Queue: The virtual path will contain all the files in the queue.
„
Queue Manager: The virtual path will show all the queues in the queue
manager as subdirectories. These directories will be populated with the
files present in each queue.
„
Node: The virtual path will show the list of queue managers defined in
the local SPAZIO MFT/S node as subdirectories. The content of each
queue manager will be as specified in previous section.
For further details see the manual SPAZIO MFT/S for Distributed Platforms:
SPXP Transports.
View and Set Default properties for Users
1
Select the Users folder
2
The Default properties for Users are displayed in the right panel:
3
Right-click on Users folder and select Modify Default.
4
The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
159
Network Manager
The following table explains the fields:
Field
Description / Values
HomeDirectory
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
GetDisposition
FileRendering
Value
Description
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
Replace
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
Leave
Files are left on the underlying
queue
Remove
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
160
EMAFTM089/03
Network Manager
Field
FileBrowsing
Description / Values
flatCorrelId
Files with the same CorrelId
are shown as different
elements of the same virtual
directory. The first element
in queue is identified by the
CorrelId value while others
are identified by a unique
name made up of the
internalNumber appended
to the CorrelId and
separated by a dot
(CorrelId.InternalNumber)
nestedCorrelId
If files with the same
CorrelId are present in
current queue they are
represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the
list of files with the
specified CorrelId. Files in
that sub directory are
identified with the
InternalNumber.
destFileName
Files with the same
Destination File Name are
shown as different elements
of the same virtual
directory. The first element
in queue is identified by the
Destination File Name
value while others are
identified by a unique name
made of the
InternalNumber appended
to the Destination File
Name and separated by a
dot
(destFileName.InternalNu
mber)
Policy used to optionally limit the visibility of
files when listing or downloading.
Value
Description
All
All files can be listed and
downloaded
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
161
Network Manager
Field
Description / Values
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.:
when an FTP client performs a
GET) or when they are acquired
by any other Spazio utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
162
EMAFTM089/03
Network Manager
Field
SFTPDataFileEx
ts
Description / Values
*
All the protocols
NONE
No protocols allowed
Comma separated list of file extensions (e.g.
"txt,csv,xml") that are to be handled as data (vs
binary) when sent by an SFTP client to SPAZIO
MFT/S SFTP Server.
No conversion is attempted, but the DataType is
just asserted and set in the SPAZIO MFT/S file
descriptor.
SFTPDataFileNe
wLine
EOL of the files stored in the source SFTP client.
Possible values are:
Value
Description
CRLF
EOL used by Windows
platforms
LF
EOL used by Unix machines
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
Right-click on the Users folder and select Modify Default VFS.
9
The following dialog box appears:
The following table explains the field:
Field
Description / Values
DirMapping
Name of the SPAZIO MFT/S queue to be
mapped to the HomeDirectory explicit VFS
directory or one of the following macros and
special functions
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name that
is the same as the login user name.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QUEUE(<queueName)}
The virtual path will contain all
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
163
Network Manager
Field
Description / Values
files in the queue.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue
${NODE}
The virtual path will show the list
of queue managers defined in the
local SPAZIO MFT/S node as
subdirectories. The content of each
queue manager will be as specified
in previous section.
10 Click OK to confirm the changes, or Cancel to abort the operation
11 To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: the Default properties for the Users are the values that will be used
at runtime for users that do not have their own user specific configuration
or for users that do not have a specific parameter set in their own user
specific configuration.
NOTE: if you have used the same UserFile for all the servers defined (FTP,
FTP/S and SFTP), all the users will share the same Default Properties.
Add a User
1
Right-click on the Users folder.
2
Select Add User. The list of the defined Users appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
164
EMAFTM089/03
Network Manager
3
Select the User you want to add and click OK.
4
The User is now displayed in the left panel:
5
Click on the User. The left column now displays the Virtual File System
folder. The right column displays the properties for the user:
6
Click on the Virtual File System folder, the default VFS appears
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
165
Network Manager
7
To activate this change you have to click Apply and restart Spazio.
Add a Virtual File System for a User
1
Select the Users folder.
2
Select the User you wish to add a VFS.
3
Select the VFS folder.
4
Right-click on the VFS folder and select Add Virtual File System.
5
The following dialog box appears:
6
Insert a virtual path for the User.
7
Click OK. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
166
EMAFTM089/03
Network Manager
The following table explains the field:
Field
Description / Values
DirMapping
Name of the SPAZIO MFT/S queue to be mapped
to the VFS Path explicit VFS directory or one of
the following macros and special functions
Value
Description
${USER}
The virtual path will contain all
files in the queue with a name that
is the same as the login user name.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QUEUE(<queueName)}
The virtual path will contain all
files in the queue.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QLIST(<filterSpec>)}
SPAZIO MFT/S node structure
rendering, as explained in the
previous section.
NOTE: the QMgr parameter of the
current user has not been set to '*'
but with the Queue Manager
name
${QMGR(<qmgrName>)}
The virtual path will show all
queues in the queue manager as
subdirectories. These directories
will be populated with the files
present in each queue
${NODE}
8
The virtual path will show the list
of queue managers defined in the
local SPAZIO MFT/S node as
subdirectories. The content of each
queue manager will be as specified
in previous section.
Insert the value and click OK to add the Virtual File System or Cancel to
abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
167
Network Manager
9
To activate this change you have to click Apply and restart Spazio.
Modify Properties for the User
1
Select the Users folder.
2
Select the User for which you wish to update the properties.
3
Right-click on the User and select Modify.
4
The following dialog box appears:
The following table explains the fields:
Field
Description / Values
QMgr
Queue Manager associated with the user when
accessing Servers. When the property is set to the
special value "*" no static association between a
user and a queue manager will be performed at
runtime.
PutDisposition
Policy used when storing files on a Spazio MFT/S
queue mapped to an explicit VFS directory.
GetDisposition
Value
Description
Enqueue
Files are queued on the
underlying queue; under no
circumstances can a file
overwrite an existing one.
Replace
If the underlying queue already
contains a file with a CorrelId
the same as the currently stored
file, the latter file will overwrite
the existing one.
Policy used when retrieving files from a queue
mapped to an explicit VFS directory.
Value
Description
Leave
Files are left on the underlying
queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
168
EMAFTM089/03
Network Manager
Field
Description / Values
Remove
FileRendering
FileBrowsing
Files are removed from the
queue.
Policy used to select how to render files when
listing or downloading.
Value
Description
flatCorrelId
Files with the same CorrelId
are shown as different
elements of the same virtual
directory. The first element
in queue is identified by the
CorrelId value while others
are identified by a unique
name made up of the
internalNumber appended
to the CorrelId and
separated by a dot
(CorrelId.InternalNumber)
nestedCorrelId
If files with the same
CorrelId are present in
current queue they are
represented by a
subdirectory of the current
virtual path named as the
CorrelId and containing the
list of files with the
specified CorrelId. Files in
that sub directory are
identified with the
InternalNumber.
destFileName
Files with the same
Destination File Name are
shown as different elements
of the same virtual
directory. The first element
in queue is identified by the
Destination File Name
value while others are
identified by a unique name
made of the
InternalNumber appended
to the Destination File
Name and separated by a
dot
(destFileName.InternalNu
mber)
Policy used to optionally limit the visibility of
files when listing or downloading.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
169
Network Manager
Field
Description / Values
Value
Description
All
All files can be listed and
downloaded
Unread
Files marked as read in Spazio
repository are ignored and they
cannot be listed or downloaded
by clients. Please note that
Spazio marks files as read when
they are downloaded (e.g.:
when an FTP client performs a
GET) or when they are acquired
by any other Spazio utilities
5
Make the changes.
6
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
Field
Description / Values
Protocols
Comma separated list protocols over which the
user is authorized to establish connections with
SPAZIO MFT/S.
Value
Description
FTP
FTP protocol
FTPS
FTPS protocol
SFTP
SFTP protocol
*
All the protocols
NONE
No protocols allowed
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
170
EMAFTM089/03
Network Manager
Field
Description / Values
HomeDirectory
Initial VFS directory where the user will be
positioned after the connection, the name can be
specified using the ${USER} macro that will be
expanded at runtime with the actual login user
name.
7
Click OK to confirm the changes, or Cancel to abort the operation.
8
To activate the changes you have to click Apply at the bottom left of the
window and restart Spazio.
Modify a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to modify the VFS.
3
Select the VFS folder.
4
Select the VFS and select Modify.
5
The following dialog box appears:
6
Make the change (see section above for the field).
7
Click OK to confirm the change, or Cancel to abort the operation.
8
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a User
1
Select the Users folder.
2
Select the User you wish to remove.
3
Select Remove.
4
The following dialog box appears:
5
Click OK to confirm the delete, or Cancel to abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
171
Network Manager
6
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a Virtual File System for a User
1
Select the Users folder.
2
Select the User for which you wish to remove the VFS.
3
Select the VFS folder.
4
Select the VFS and select Remove.
5
The following dialog box appears:
6
Click OK to confirm the delete, or Cancel to abort the operation.
7
To activate the change you have to click Apply at the bottom left of the
window and restart Spazio.
NOTE: you can remove the default VFS only when you have created a new
one.
3.4.4.9 Enable/Disable Anonymous Access
The SFTP protocol allows for a special user named anonymous for which
special password validation semantics are enforced.
When connecting to an SFTP Server allowing anonymous user access the
password that is optionally specified by the client will not be checked by the
server.
SPAZIO as SFTP Server allows the use of the anonymous user, provided that
a user named anonymous with fixed password anonymous is configured in
the SPAZIO Authentication Provider.
For further details see A3SP Installation, Configuration and User Guide.
To enable Anonymous Access, you have to:
1
Right-click on the SFTP server.
2
Select Enable Anonymous Access.
3
To activate this change you have to click Apply and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
172
EMAFTM089/03
Network Manager
3.4.5
HTTP Server
The following section describes how to configure SPAZIO MFT/S as HTTP
Server.
For further details see SPAZIO MFT/S for Distributed Platforms: Installation and
Configuration Guide.
3.4.5.1 Add a HTTP Server
1
Right-click on the HTTP folder.
2
Select Add. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Bind Address
The IP address or host name to which the
server listens in order to receive the HTTP
request. For example, it is used when a server
with multiple network interfaces is used.
The value ‘*’ specifies that the HTTP server is
listening to all network interfaces.
Http Server Port
HTTP server listening port (for example: 8080)
Communication
Port
TCP communication port between SPAZIO
HTTP processes (for example: 9090).
TraceLevel
Level of detail in the trace file.
Value
Description
0
Only errors
1 - 3
Trace
4
Debug
5
Dump buffer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
173
Network Manager
Field
Description / Values
Max Trace File
Size
Maximum size of the trace file in Mbytes
Root Dir
Root directory containing the html pages.
Example: c:\spazio\spazio\http\html.
Error sDir
Root directory containing the html error pages.
Example: c:\spazio\http\html\errors.
Tmp Dir
Temporary directory where temporary files to
be extracted from or inserted in queues are
stored. Example: c:\spazio\http\tmp.
Mime Filename
File with the associations between the file
name extension and MIME type. Example:
c:\spazio\http\mime.types.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Max Trace Files
Number of copies of the backup trace file.
http with ssl
Flag which specifies whether or not the line is
secure (HTTPS).
Ssl certificate
Value
Description
True
HTTPS line
False
HTTP line
SSL certificate.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
174
EMAFTM089/03
Network Manager
Field
Description / Values
Ssl Key
File containing the keys for the HTTPS server
(it could be the same as the certificate if this
also contains the keys).
Disposition Type
This parameter sets the mode in which the
downloaded file will be handled by the
browser.
Value
Description
inline
The file will be displayed in
the browser window if a
plugin that can handle the file
type is found.
attachment
Default. The browser asks
which application should be
used to open the file or where
to save the file.
5
Click OK to confirm the creation, or Cancel to abort the operation.
6
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.5.2 Modify a HTTP Server
1
Right-click the HTTP Server you want to modify.
2
Select Modify.
The window of the selected HTTP Server appears and you can make
your changes (see Section 3.4.5.1 for the HTTP Server fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.5.3 Remove a HTTP Server
1
Right-click the HTTP Server
2
Select Remove. The following screen appears:
3
Click Yes to delete the HTTP Server, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
175
Network Manager
3.4.6
PESIT Line
The following section describes how to configure a PESIT line, which is used
for communicating with other PESIT nodes.
3.4.6.1 Add a PESIT Line
1
Right-click on the PESIT folder.
2
Select Add Pesit Line. The following dialog box appears :
The following table explains the fields in the tab:
Field
Description / Values
Name
Symbolic name for the line.
Startup
Startup Mode.
Trace
Value
Description
1
Manual
2
Default. Automatic
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
MaxInConv
Max. input conversations concurrently active
Parameters
The Parameters attribute contains:
Mailbox
Name
Name of PESIT layer instance.
Local Port
Value of the local port to use
for incoming connections.
Default: sitmbx0
Default: 51200
Local
Initiator
Port
Value of the local port to use
for initiator connectionss.
Default: 51201
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
176
EMAFTM089/03
Network Manager
Field
Description / Values
Local
Debug Port
Value of the local port to use
for debug connections.
Default: 51202
To insert the fields click on the
icon.
3
Fill in the relevant fields.
4
Click OK to create the line or Cancel to abort the operation.
5
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: It’s possible to create at most one PESIT Line.
3.4.6.2 Modify PESIT Line
1
Right-click the PESIT Line you want to modify.
2
Select Modify.
The window of the selected PESIT Line appears and you can make your
changes (see Section 3.4.6.1 for the PESIT Line fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.6.3 Remove a PESIT Line
3.4.7
1
Right-click the line
2
Select Remove. The following screen appears:
3
Click Yes to delete the line, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO Lines
The following section describes how to configure native SPAZIO lines, which
are used for communicating with other SPAZIO nodes.
For further details see SPAZIO MFT/S for Distributed Platforms: Installation and
Configuration Guide.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
177
Network Manager
3.4.7.1 Add a TCP Line
1
Right-click on the SPAZIO folder.
2
Select Add TCP Line. The following dialog box appears :
The following table explains the fields in the tab:
Field
Description / Values
Name
Symbolic name for the line.
Startup
Startup Mode.
Value
Description
1
Manual
2
Default. Automatic
Trace level
Trace
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
TimeOut
Line Time-out.
Direction
Communication direction
Value
Description
I
Input only
O
Output Only
A
Input and output
The Parameters attribute contains:
Parameters
Local
Port
Value of the local port to use for
incoming connections. It must be
unique for each line.
To insert the fields click on the
3
icon.
Fill in the relevant fields.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
178
EMAFTM089/03
Network Manager
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Type
Driver type (Fix value TCP)
MaxConv
Max. line conversations concurrently active
MaxInConv
Max. input conversations concurrently active
MaxOutConv
Max. output conversations concurrently active.
5
Click OK to create the line or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.4.7.2 Add an ISC Line
1
Right-click on the SPAZIO folder.
2
Select Add ISC Line. The following dialog box appears:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
179
Network Manager
Field
Description / Values
Name
Symbolic name for the line
Startup
Startup Mode
Trace
Value
Description
1
Default . Manual
2
Automatic
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
TimeOut
Line Time-out
Direction
Communication direction
Parameters
Value
Description
I
Input only
O
Output Only
A
Input and output
The Parameters attribute contains:
Protocol
Specifies the protocol that will be
used by the line.
Local
Port
Value of the local port to use for
incoming connections. It must be
unique for each line.
Keep
Alive
Optional.
Number of seconds the link is
kept alive on idle (no
conversations). The value must be
greater than 31.
Default : 1200.
Echo
Optional.
Enables/disables periodic
exchanging of an echo frame
between the two nodes on the
line.
Default: on.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
180
EMAFTM089/03
Network Manager
Field
Description / Values
Polling
Optional.
Wait interval between reading
one command and the next, only
for the sender process on this line.
Default: no wait.
Bind
Address
Optional.
Bind
Timeout
Optional.
On a machine with more than one
network card, and therefore with
more than one IP address, it is
possible to specify which IP
address is to be used as a
reference.
Maximum time to wait to receive
the bind frame.
Default: 20 seconds.
Max
Client
Maximum number of client
connections the line will ever
accept.
Default: 1024.
To insert the fields click on the
icon
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
181
Network Manager
Field
Description / Values
Type
Driver type (Fix value ISC)
MaxConv
Max. line conversations concurrently active
MaxInConv
Max. input conversations concurrently active
MaxOutConv
Max. output conversations concurrently active
5
Click OK to create the line or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.4.7.3 Add an ISC/PPS Line
1
Right-click on the SPAZIO folder
2
Select Add ISC PPS Line. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Name
Symbolic name for the line.
Startup
Startup Mode.
Trace
Value
Description
1
Default. Manual
2
Automatic
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
TimeOut
Line Time-out-
Direction
Communication direction-
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
182
EMAFTM089/03
Network Manager
Field
Parameters
Description / Values
Value
Description
I
Input only
O
Output Only
A
Input and output
The Parameters attribute contains:
Protocol
Specifies the protocol that will be
used by the line.
Local
Port
Value of the local port to use for
incoming connections. It must be
unique for each line.
Keep
Alive
Optional.
Number of seconds the link is
kept alive on idle (no
conversations). The value must be
greater than 31.
Default : 1200.
Echo
Optional.
Enables/disables periodic
exchanging of an echo frame
between the two nodes on the
line.
Default: on.
Polling
Optional.
Wait interval between reading
one command and the next, only
for the sender process on this line.
Default: no wait.
Bind
Address
Optional.
Bind
Timeout
Optional.
On a machine with more than one
network card, and therefore with
more than one IP address, it is
possible to specify which IP
address is to be used as a
reference.
Maximum time to wait to receive
the bind frame.
Default: 20 seconds.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
183
Network Manager
Field
Description / Values
Max
Client
Maximum number of client
connections the line will ever
accept.
Default: 1024.
To insert the fields click on the
3
icon.
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Type
Driver type (Fix value ISC)
MaxConv
Max. line conversations concurrently active
MaxInConv
Max. input conversations concurrently active
MaxOutConv
Max. output conversations concurrently active
4
Click OK to create the line or Cancel to abort the operation.
5
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn’t exist.
The user's PIN for accessing the token is required in the following
dialog box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
184
EMAFTM089/03
Network Manager
6
Export/Import X.509 Certificate (see Section 3.4.6.8 and 3.4.6.9).
3.4.7.4 Add an ISCL Line
1
Right-click on the SPAZIO folder.
2
Select Add ISCL Line. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Name
Symbolic name for the line
Startup
Startup Mode
Trace
Value
Description
1
Manual
2
Default. Automatic
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
TimeOut
Line Time-out
Direction
Communication direction
Value
Description
I
Input only
O
Output Only
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
185
Network Manager
Field
Description / Values
A
Parameters
Input and output
The Parameters attribute contains:
Protocol
Specifies the protocol that will be
used by the line.
Local
Port
Value of the local port to use for
incoming connections. It must be
unique for each line.
Keep
Alive
Optional.
Number of seconds the link is
kept alive on idle (no
conversations). The value must be
greater than 31.
Default : 1200.
Echo
Optional.
Enables/disables periodic
exchanging of an echo frame
between the two nodes on the
line.
Default: on.
Polling
Optional.
Wait interval between reading
one command and the
next, only for the sender process
on this line.
Default: no wait.
Bind
Address
Optional.
Bind
Timeout
Optional.
On a machine with more than one
network card, and therefore with
more than one IP address, it is
possible to specify which IP
address is to be used as a
reference.
Maximum time to wait to receive
the bind frame.
Default: 20 seconds.
Max
Client
Maximum number of client
connections the line will ever
accept.
Default: 1024.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
186
EMAFTM089/03
Network Manager
Field
Description / Values
To insert the fields click on the
icon.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Type
Driver type (Fixed value ISCL)
MaxConv
Max. line conversations concurrently active
MaxInConv
Max. input conversations concurrently active
MaxOutConv
Max. output conversations concurrently active
5
Click OK to create the line or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
3.4.7.5 Add an ISCL/PPS Line
1
Right-click on the SPAZIO folder.
2
Select Add ISCL PPS Line. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
187
Network Manager
The following table explains the fields in the tab:
Field
Description / Values
Name
Symbolic name for the line
Startup
Startup Mode
Trace
Value
Description
1
Manual
2
Default. Automatic
Trace level
Value
Description
0
Default. No trace
1
Minimal Trace
2
Normal trace
3
Most Detailed Trace
TimeOut
Line Time-out
Direction
Communication direction
Parameters
Value
Description
I
Input only
O
Output Only
A
Input and output
The Parameters attribute contains:
Protocol
Specifies the protocol that will be
used by the line.
Local
Port
Value of the local port to use for
incoming connections. It must be
unique for each line.
Keep
Alive
Optional.
Number of seconds the link is
kept alive on idle (no
conversations). The value must be
greater than 31.
Default : 1200.
Echo
Optional.
Enables/disables periodic
exchanging of an echo frame
between the two nodes on the
line.
Default: on.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
188
EMAFTM089/03
Network Manager
Field
Description / Values
Polling
Optional.
Wait interval between reading
one command and the
next, only for the sender process
on this line.
Default: no wait.
Bind
Address
Optional.
Bind
Timeout
Optional.
On a machine with more than one
network card, and therefore with
more than one IP address, it is
possible to specify which IP
address is to be used as a
reference.
Maximum time to wait to receive
the bind frame.
Default: 20 seconds.
Max
Client
Maximum number of client
connections the line will ever
accept.
Default: 1024.
To insert the fields click on the
icon.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
189
Network Manager
Field
Description / Values
Type
Driver type (Fixed value ISCL)
MaxConv
Max. line conversations concurrently active
MaxInConv
Max. input conversations concurrently active
MaxOutConv
Max. output conversations concurrently active
5
Click OK to create the line or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: a new self-signed certificate (together with the corresponding
RSA key-pair) is generated inside the Token, if it doesn't exist.
The user's PIN for accessing the token is required in the following
dialog box:
3.4.7.6 Add a PR5 Server
1
Right-click on the SPAZIO folder.
2
Select Add PR5. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
PR5 Server
Listening Port
TCP/IP port on which the destination PR5
Server is listening.
Trace
Trace Level
Value
Description
ALL
Detailed tracing enabled
NO
No tracing enabled
PROTOCOL
Only tracing of native protocol
verbs enabled
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
190
EMAFTM089/03
Network Manager
Field
Description / Values
YES
Normal tracing enabled
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Trace File Name
Output trace file name
Trace File Size
KByte
If specified and different from 0, it enables
rolling of log files when they become bigger
than the number of bytes specified
Trace File Number
If specified and > 1, it specifies the number of
backup files used when rolling
PR5 Default Isc
Proxy Port
Listening port of the PR4 ISC/ISCL line
associated to the specified remote SPSysName,
IPAddress or hostname.
PR5 Default
Master Port
TCP/IP port on which a destination PR5
Server is listening.
5
Click OK to create the line or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
NOTE: it is not possible to create more than one PR5 server.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
191
Network Manager
3.4.7.7 Modify SPAZIO Line
1
Right-click the SPAZIO Line you want to modify.
2
Select Modify.
The window of the selected SPAZIO Line appears and you can make your
changes (see Section 3.4.7.1 to 3.4.7.6 for the SPAZIO Line fields).
3
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.7.8 Remove a SPAZIO Line
1
Right-click the line
2
Select Remove. The following screen appears:
3
Click Yes to delete the line, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
3.4.7.9 Export X.509 Client Certificate
1
Right click on the SPAZIO folder.
2
Select Export X.509 Client Certificate. The following screen appears:
3
Insert the name for the certificate and click Save.
NOTE: the certificate is exported in DER format.
4
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
192
EMAFTM089/03
Network Manager
3.4.7.10 Import an X.509 Client Certificate
1
Right click the ISC/PPS Line.
2
Select Import X.509 Client Certificate. The following dialog box appears:
3
Select the certificate.
4
Click OK to import the certificate, or Cancel to abort the operation
5
The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
193
Network Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
194
EMAFTM089/03
Chapter 4
Transmission Monitoring
In the Transmission Monitoring folder, the SPAZIO Management Console allows
you to view session details of File/Message transport sessions that have
taken place on a local or remote Queue Manager and their respective Queues.
4.1
4.1.1
Transmission Monitoring Folder
Toolbar
This bar contains a number of buttons that provide point-and-click access to
most Transmission Monitoring operations. The following table describes the
function of each button and the equivalent menu command:
Button
4.1.2
Function
Menu Command
Connect to a Local or Remote node
Action – Connect to
Enable
Action - Enable
Disable
Action – Disable
Stop
Action – Stop
Resume
Action - Resume
Delete an existing object
Action - Remove
Create a new object
Action - Create
Force Delete
Action – Force Delete
Workspace
When you open the Transmission Monitoring folder, the list of the Queue
Managers of the current node is displayed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
195
Transmission Monitoring
When you open a particular Queue Manager 3 folders are displayed: Master,
Slave and Pull which group together the File/Message transport sessions
that have taken place on the Queue Manager and their respective Queues.
4.2
View Transport Master
SPAZIO Management Console lets you view session properties associated to a
Queue Manager transport route. It also allows you to view session details
associated with a Queue on a selected Queue Manager.
4.2.1
View Session Summary from a Queue Manager
1
Select Transmission Monitoring folder.
2
This displays a list of possible Queue Managers to view:
3
Click on the Queue Manager you wish to view.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
196
EMAFTM089/03
Transmission Monitoring
4
Click on the Master icon. The left column now displays a list of possible
Queue Manager Routes to display for the selected Queue Manager. The
right panel displays a session summary for each Queue Manager.
The following table describes the properties listed:
Property
Description
Remote QM
Remote Queue Manager name
Address type
Queue Manager Address Type
Status
Queue Manager Status.
Can be enabled or disabled
5
Pending
Number of pending Message/File transfers
Executing
Number of executing Message/File transfers
Failed
Number of failed Message/File transfers
Completed
Number of completed Message/File transfers
Hold
Number of holding Message/File transfers
Terminating
Number of terminating Message/File transfers
To view a specific session summary, select a Queue manager. A list of
Remote Queues is displayed in the left panel. The right panel displays the
session summary for the selected queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
197
Transmission Monitoring
The following table describes the Queue properties.
4.2.2
Property
Description
Remote Queue
Remote Queue name
Address type
Remote Address type
Queue Status
Remote Queue status
Pending
Number of pending Message/File transfers
Executing
Number of executing Message/File transfers
Failed
Number of failed Message/File transfers
Completed
Number of completed Message/File transfers
Hold
Number of holding Message/File transfers
Terminating
Number of Terminating Message/File transfers
View Queue Session Details
1
Click on any of the Remote Queues listed in the left panel.
2
The right panel now displays the session details between the two Queue
Managers and their respective Queues.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
198
EMAFTM089/03
Transmission Monitoring
The following table describes the Session properties.
Property
Description
File Name
File Name
Transport Name
Session Transport Name
Transport Type
Session Transport Type
Internal Number
Internal Number
User Class
Use Class
Message/File Id
Message\File ID
Status
Queue Status.
Can be enabled or disabled
4.2.3
Correlation Id
Correlation ID
Start Date/Time
Start Date/Time of message/file transfer
Interrupt
Date/Time
Interrupt Date/Time of message/file transfer
CC
Completion code
RC
Reason code
Priority
Priority
Error Side
Error side
Internal Session
Internal session ID.
View File Session Details
Each queue displayed contains a list of files which have been used in a
transfer session. SPAZIO Management Console allows you to view the details
of each of these message/file transfer sessions.
1
Double-click on the file in the right panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
199
Transmission Monitoring
2
The right panel displays Session Details for the selected File/Message
transfer session.
The following table describes the session properties.
Property
Description
Internal Number
Internal Number
Message/File Id
Message/file ID
QM
Queue Manager
Queue
Queue Type
Queue address
Type
Queue Address Type
User Class
User Class
CC
Completion code
Correlation ID
Correlation ID
Deliv From
Delivered from
Deliv to
Delivered to
Error Side
Error side
Ext Ftr CC
Ext Ftr Completion code
Ext Ftr RC
Ext Ftr Reason code
Extension code
Session extension code
Internal Session
Internal session number
Interrupt Date
Session Interrupt Date
Last Blk/Msg
Last Blk/Msg size
Last Rec Tr
Last record Trace
Modality
Session Modality
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
200
EMAFTM089/03
Transmission Monitoring
4.3
Property
Description
Original Byte Tr
Original Byte to be Transported
Original ID
Original ID
Original Size
Original Message/File size
Priority
Session priority
RC
Reason Code
Real Byte Tr
Actual Byte Transported
Real size
Actual Message/File size
Retry Number
Number of Session retries
Start date
Session Start date
Status
Transport Status
Total Blk/Msg
Total Blk/Msg size
Transport name
Session transport name
Transport Type
Session Transport type
User Class
User Class.
View Transport Slave
SPAZIO Management Console allows you to view the session details associated
with a Slave Transport.
1
Select the Transmission Monitoring folder.
2
This displays a list of possible Queue Managers to view:
3
Click on the Queue Manager you wish to view.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
201
Transmission Monitoring
4
Select the Slave icon. A remote Queue Manager is then displayed.
5
To view a specific session summary, select a Queue manager. A list of
Local Queues is displayed in the left panel. The right panel displays the
session summary for the selected queue.
The following table describes the Queue properties.
Property
Description
Remote Queue
Local Queue name
Address type
Local Address type
Queue Status
Local Queue status
Pending
Number of pending Message/File transfers
Executing
Number of executing Message/File transfers
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
202
EMAFTM089/03
Transmission Monitoring
4.4
Property
Description
Failed
Number of failed Message/File transfers
Completed
Number of completed Message/File transfers
Hold
Number of holding Message/File transfers
Terminating
Number of Terminating Message/File transfers
View Transport Pull
SPAZIO Management Console allows you to view the session details associated
with a Pull Transport.
This is usually associated with an FTP, FTP/S, SFTP Server.
1
Select the Transmission Monitoring folder.
2
This displays a list of possible Queue Managers to view:
3
Click on the Queue Manager you wish to view.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
203
Transmission Monitoring
4
Select the Pull icon. The local Queue Manager is then displayed.
5
To view a specific session summary, select a Queue Manager. A list of
Local Queues is displayed in the left panel. The right panel displays the
session summary for the selected queue
The following table describes the Queue properties.
Property
Description
Remote Queue
Local Queue name
Address type
Local Address type
Queue Status
Local Queue status
Pending
Number of pending File transfers
Executing
Number of executing File transfers
Failed
Number of failed File transfers
Completed
Number of completed File transfers
Hold
Number of holding File transfers
Terminating
Number of Terminating File transfers
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
204
EMAFTM089/03
Transmission Monitoring
4.5
4.5.1
Transport Master Actions
File Session
By selecting one of the File/Message transfer sessions, SPAZIO Management
Console enables the following actions: Stop, Resume, Delete, New Transport
and Force Delete for each file transfer Session.
Property
Description
Stop
Stop the selected transport
Resume
Restart the selected transport
Delete
Delete the selected transport
New Transport
Create a new transport (not enabled)
Force Delete
Force the deletion of the selected transport
These actions can be accessed via the toolbar or by clicking on Action in the
Menu.
4.5.2
Queue session
By selecting one of the Remote Queue, SPAZIO Management Console enables
the following actions: Enable, Disable, Stop, Resume, New Transport,
Delete and Force Delete for each file transfer session in the queue.
Property
Description
Enable
Enable the transports in the queue
Disable
Disable the transports in the queue
Stop
Stop all the transports in the selected queue
Resume
Resume all the transports in the selected queue
New Transport
Create a new transport for all the transports failed in
the selected queue
Delete
Delete all the transports in the selected queue
Force Delete
Force the deletion of the transports in the selected
queue
These actions can be accessed via the toolbar, or by right clicking on the
selected remote queue or by clicking on Action in the menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
205
Transmission Monitoring
4.5.3
Queue Manager Actions
By selecting one of the Remote Queue Manager, SPAZIO Management Console
enables the following actions: Enable, Disable, Stop, Resume, Delete and
Force Delete for each file transfer session towards that Queue Manager.
Property
Description
Enable
Enable the transports to the selected Queue Manager
Disable
Disable the transports to the selected Queue Manager
Stop
Stop all the transports to the selected Queue Manager
Resume
Resume all the transports to the selected Queue
Manager
Delete
Delete all the transports to the selected Queue
Manager
Force Delete
Force the deletion of the transports to the selected
Queue Manager
These actions can be accessed via the toolbar, or by right clicking on the
selected remote queue manager or by clicking on Action in the menu.
4.6
4.6.1
Transport Slave Actions
File Session
By selecting one of the File/Message transfer sessions, SPAZIO Management
Console enables the following actions: Delete and Force Delete for each file
transfer Session.
Property
Description
Delete
Delete the selected transport
Force Delete
Force the deletion of the selected transport.
These actions can be accessed via the toolbar or by clicking on Action in the
menu.
4.6.2
Queue Session
By selecting one of the Local Queues, SPAZIO Management Console enables
the following actions: Delete and Force Delete for each file transfer session in
the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
206
EMAFTM089/03
Transmission Monitoring
Property
Description
Delete
Delete all the transports in the selected queue
Force Delete
Force the deletion of the transports in the selected
queue
These actions can be accessed via the toolbar or by right clicking on the
selected remote queue, or by clicking on Action in the menu.
4.6.3
Queue Manager Actions
By selecting one of the Remote Queue Managers, SPAZIO Management Console
enables the following actions: Delete and Force Delete for each file transfer
session originating from that Queue Manager.
Property
Description
Delete
Delete all the transports from the selected Queue
Manager
Force Delete
Force the deletion of the transports from the selected
Queue Manager
These actions can be accessed via the toolbar, or by right clicking on the
selected remote queue manager or by clicking on Action in the menu.
4.7
4.7.1
Transport Pull Actions
File Session
By selecting one of the File/Message transfer sessions, SPAZIO Management
Console enables the following actions: Delete and Force Delete for each file
transfer Session.
Property
Description
Delete
Delete the selected transport
Force Delete
Force the deletion of the selected transport
These actions can be accessed via the toolbar or by clicking on Action in the
Menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
207
Transmission Monitoring
4.7.2
Queue session
By selecting one of the Local Queues, SPAZIO Management Console enables
the following actions: Delete and Force Delete for each file transfer session in
the queue.
Property
Description
Delete
Delete all the transports in the selected queue
Force Delete
Force the deletion of the transports in the selected
queue
These actions can be accessed via the toolbar, or by right clicking on the
selected remote queue or by clicking on Action in the menu.
4.7.3
Queue Manager Actions
By selecting one of the Remote Queue Managers, SPAZIO Management Console
enables the following actions: Delete and Force Delete for each file transfer
session to that Queue Manager.
Property
Description
Delete
Delete all the transports to the selected Queue
Manager
Force Delete
Force the deletion of the transports to the selected
Queue Manager
These actions can be accessed via the toolbar, or by right clicking on the
selected remote queue manager or by clicking on Action in the menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
208
EMAFTM089/03
Chapter 5
File Management
In the File Management folder SPAZIO Management Console allows you to
perform certain administration tasks for both Local and Remote SPAZIO
nodes, and send and receive files through the use of SPAZIO technology.
5.1
5.1.1
File Management Folder
Toolbar
This bar contains a number of buttons that provide point-and-click access to
most File Management operations. The following table describes the function
of each button and the equivalent menu command:
Button
Function
Menu Command
Connect to a Local or Remote node
Action – Connect to node
Activate an object
Action - Activate
Deactivate an object
Action - Deactivate
Connect to a Queue Manager
Action - Connect
Disconnect from a Queue Manager
Action - Disconnect
Create a new object
Action - Create
Delete an existing object
Action - Remove
Properties information
None
Contents
None
Apply a node filter
None
Acquire an object
File - Acquire
Dispatch an object
File – Dispatch
Cut
Edit – Cut
Copy
Edit – Copy
Paste
Edit – Paste
Large Icon View
View – Large Icon View
Small Icon View
View – Small Icon View
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
209
File Management
Button
5.1.2
Function
Menu Command
List View
View – List View
Details View
View – Details View
Refresh
None
View
None
Workspace
When you open the File Management folder, a list of the Queue Managers of
the current node is displayed:
The operations that you can perform on Queue Managers are described the
following sections.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
210
EMAFTM089/03
File Management
5.2
File Management Options
You can customize your File Management session through a series of usermodifiable options. To access these options, choose View – File Management
Options. The dialog box that appears contains three tabs, General, File
Properties and Colors.
5.2.1
General Options
5.2.1.1 Acquisition Policy
This option lets you decide how to handle the deletion of files that have been
acquired from a queue. The four choices are:
„
Do not delete the file after the acquisition
If this option is chosen, files will not be automatically deleted from
queues following acquisition. This is the default option. In the context of
SPAZIO file acquisitions, this type of operation is also known as browsing.
„
Delete the file without confirmation
If this option is chosen, files will be deleted from queues as soon as they
are acquired.
„
Ask confirmation before the acquisition
If this option is chosen, a dialog box will appear before you acquire a file,
asking you to confirm that you want to delete it from the queue once it is
acquired:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
211
File Management
„
Ask confirmation after the acquisition
If this option is chosen, a dialog box will appear after you acquire a file,
asking you to confirm that you want to delete it from the queue:
5.2.1.2 Show FileId in hexadecimal format
If you check this option, the FileID file attribute will be shown in hexadecimal
format. This option is unchecked by default.
5.2.1.3 Sender
You can enter a name (maximum 8 characters) which will be attached to any
files you dispatch as the Sender attribute. The default sender is FGATE.
5.2.1.4 View time
Here you can enter a value between 0 and 30. The default value is 0. If you
enter a value greater than 0, one of the following information boxes will
appear whenever you dispatch or acquire a file:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
212
EMAFTM089/03
File Management
These boxes will remain open for the number of seconds that you specify in
the View time field.
5.2.2
File Properties
The second tab in the Options dialog box contains a checklist of file
attributes. When you view file details in the right (Files) panel of the
workspace, a list of attributes is provided for each file. Through this tab, you
can select/deselect the details that you want to be displayed for each file.
The first four items are not modifiable and are always checked, but you can
choose to select or deselect any of the rest. When you later view a list of the
files contained in a queue, each item selected here will be listed for each file.
The Select All and Deselect All buttons provide a quick way to check or
uncheck all selectable items.
The following table describes each property:
Item
Description
Correlation ID
Correlation ID of the file.
File ID
File ID of the file.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
213
File Management
Item
Description
Internal Number
SPAZIO Internal number of the file.
Class
Storage class of the file.
Arrival Date
Date that the file arrived in the destination
queue.
Arrival Time
Time that the file arrived in the destination
queue.
Put Date
Date the file was put in the original queue.
Put Time
Time that the file was put in the original
queue.
First Read Date
Date that the file was first read from the
queue.
First Read Time
Time that the file was first read from the
queue.
Last Read Date
Date that the file was last read from the
queue.
Last Read Time
Time that the file was last read from the
queue.
Sender
Sender of the file.
Bytes
Size of the file in bytes.
Object Type
The type of data object in the queue.
Original File Name
Name with which the file was dispatched to
a queue.
Destination File Name
Name assigned to the file at destination.
File Type
The type of the file: whether it is INTERNAL
or EXTERNAL, and whether it is DATA or
BINARY
Expiry Date
Date at which the file in the queue expires.
Expiry Time
Time at which the file in the queue expires.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
214
EMAFTM089/03
File Management
5.2.3
5.3
Colors
System administration operations
In the File Management folder, SPAZIO Management Console allows you to
perform the following administration tasks:
5.3.1
„
List Queue Managers, Queues, DQLs
„
View the properties of Queue Managers, Queues, DQLs
„
Activate/deactivate Queue Managers
„
Connect to/disconnect from Queue Managers
„
Create/delete Queues, DQLs, and User Classes
„
View and set security permissions for Queue Managers, and default
security permissions for Queues and DQLs belonging to a specific Queue
Manager.
Queue Managers
The sections below describe the operations that you can perform on Queue
Managers.
NOTE: Queue Managers are created (or, more precisely, defined) in
Network Manager. See chapter 3 for further details.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
215
File Management
5.3.1.1 List Queue Managers
5.3.1.2
1
Click the File Management folder:
2
The Queue Managers are listed.
View the properties of a Queue Manager
1
2
Click a Queue Manager
A series of properties is displayed in the right panel of the workspace:
The following table explains the parameters listed in the right panel:
Property
Description / Values
Active
Whether the Queue Manager is active or
not:
Startup mode
Value
Description
True
The Queue Manager is active.
False
The Queue Manager is not active.
Start-up mode for the Queue Manager:
Value
Description
1
Manual
2
Automatic
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
216
EMAFTM089/03
File Management
Property
Description / Values
Max number of
concurrent
sessions
The maximum number of simultaneously
active Queue Manager sessions
Trace Level
Trace Level for the Queue
Manager.
Value
Description
0
No trace
1
Minimal trace
2
Normal trace
3
Most Detailed trace
Max number of
Queues
Maximum number of Queues under the
Queue Manager.
Max number of user
classes
Maximum number of user classes in a
session.
Max dimension of
Queue catalogue on
disk
Maximum size of the Queue Catalogue file
on disk.
Max dimension of
user class
catalogue on disk
Maximum size of the User Catalogue file on
disk.
Max dimension of
DQL catalogue on
disk
Maximum size of the DQL Catalogue file on
disk.
Max number of
files in a Queue
Maximum number of files in a Queue
belonging to this Queue Manager.
Cleaning policy
Directions for the Queue Manager Cleaner
process.
Cleaning Interval
(in hours)
Value
Description
0
No clean
1
Clean when the Queue Manager
starts up.
2
Clean when the Queue Manager
starts up, and then at regular
intervals.
Time, in hours, between successive cycles of
the Queue Manager Cleaner process.
NOTE: these properties are read-only. Their values are assigned and
modified in the Network Manager folder. See Chapter 3 for further details.
5.3.1.3
Activate an inactive Queue Manager
You can activate a Queue Manager if it is:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
217
File Management
„
Not connected.
„
Not active (the Active property of the Queue Manager is False).
To activate a selected Queue Manager, click the Activate button
toolbar, or right-click on the Queue Manager and select Activate.
5.3.1.4
on the
Deactivate an active Queue Manager
You can deactivate a Queue Manager if it is:
„
Not connected
„
Active (the Active property of the Queue Manager is True).
To deactivate a selected Queue Manager, click the Deactivate button
the toolbar, or right-click on the Queue Manager and select Deactivate.
on
5.3.1.5 Connect to a Queue Manager
1
Select the Queue Manager.
2
Click the Connect button
in the toolbar or right-click on the Queue
Manager and select Connect.
3
The Connect to Queue Manager box appears:
4
If a User ID and password is required, enter them in the dialog box:
5
The Queue Manager is connected, and the Queue Manager contents are
displayed in the left panel (the Queue Manager properties are also listed
in the right panel):
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
218
EMAFTM089/03
File Management
5.3.1.6 Disconnect from a Queue Manager
1
Select the Queue Manager.
2
Click on the Disconnect button
on the toolbar or right-click on the
Queue Manager and select Disconnect.
5.3.1.7 View the Security properties of a Queue Manager
1
Right-click a Queue Manager to display the following pop-up menu:
2
Click Security.
3
The following box appears:
5.3.1.7.1 Queue Manager Security
1
To view or set permission information on the Queue Manager, click the
Permissions button in the Permissions area:
2
If you do not have the correct permissions for this operation, the
following message appears:
3
Refer to Chapter 8: Security Management for details on how to set and
modify the permissions.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
219
File Management
5.3.1.7.2 Queue Manager default Queue security
1
To view or set permission information on the default permissions for
Queues under the current Queue Manager, click the Permissions button
in the Default Queue Permissions area:
2
If you do not have the correct permissions for this operation, the
following message appears:
3
Refer to Chapter 8: Security Management for details on how to set and
modify the permissions.
5.3.1.7.3 Queue Manager default DQL security
5.3.2
1
To view or set permission information on the default permissions for
DQLs under the current Queue Manager, click the Permissions button in
the Default DQL Permissions area:
2
If you do not have the correct permissions for this operation, the
following message appears:
3
Refer to Chapter 8: Security Management for details on how to set and
modify the permissions.
Queue
The sections below describe the operations that you can perform on queues
belonging to a Queue Manager on a local or remote node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
220
EMAFTM089/03
File Management
5.3.2.1 List Queues
1
Click the Queues folder in the left panel of the screen.
2
The queues belonging to the current Queue Manager are displayed:
Local queues are indicated by the
icon.
3
5.3.2.2
icon, and remote queues by the
The queues are also listed in the right panel:
Create a Local Queue
1
Select the Queues folder.
2
Click the
button on the toolbar or right-click on the Queue folder and
select Create Queue. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
221
File Management
3
Enter a name for the queue in the Queue Name field.
4
Optionally, enter a description of the queue in the Description field.
5
Make sure that Local is selected as the Queue Type.
6
Select Queue Mode, Default Input Open Option and File Default User
Class.
The following table explains the fields in the tab:
7
Field
Description / Values
Queue Name
Name of the current Queue
Queue Description
Queue Description
Queue Type
Queue Type
Queue Mode
It specifies if the queue can be opened for input
several times concurrently.
Default Input
Open Option
It identifies the default way in which a queue
should be opened for input
File Default User
Class
It identifies the default user class when putting
files and getting files from queue.
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Storage Class
Storage class to be associated with the new
queue
Max File Depth
Maximum number of files that can be
contained in the queue.
Max Message Depth
Maximum number of messages that can be
contained in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
222
EMAFTM089/03
File Management
Field
Description / Values
Max Message Length
Maximum length of messages that may be
inserted in the queue.
Default Priority
Default priority of the Message\File put to
the queue
Default
persistence of
messages
Persistence assigned to messages written to
this queue that had no persistence specified
when they were written.
Message Delivery
Sequence
Mode in which messages are delivered
Inhibit Get
Operation
Inhibit Put
Operation
8
Value
Description
FIFO
Delivered using First In First
Out mechanism. MVS only
Priority
Based
Delivered using a priority
based mechanism
Whether GET operations are blocked for the
queue:
Value
Description
True
GET operations are blocked.
False
GET operations are not
blocked.
Whether PUT operations are blocked for the
queue:
Value
Description
True
PUT operations are blocked.
False
PUT operations are not
blocked.
Read Password
Read password associated with the queue
(allows files and messages to be read from
the queue).
Write Password
Write password associated with the queue
(allows files and messages to be inserted in
the queue).
Set Password
Set password associated with the queue
(allows the queue to be modified or deleted).
Click OK to create the queue, or Cancel to abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
223
File Management
5.3.2.3 Create a Remote Queue
1
Select the Queues folder.
2
Click the
button on the toolbar or right-click on the Queue folder and
select Create Queue. Select Remote as the Queue Type in the box that
appears:
3
Enter a name for the queue in the Queue Name field.
4
Optionally enter a description of the queue in the Description field.
5
Indicate Remote Queue Manager and Remote Queue and select Queue
Mode, Default Input Open Option and File Default User Class.
The following table explains the fields in the tab:
Field
Description / Values
Remote Queue
Manager:
Name
Identifies the name of the remote Queue
Manager to which the remote queue belongs.
User Id
User identifier with which the transport
identifies itself to the remote Queue Manager.
Password
Password with which the transport identifies
itself to the remote Queue Manager.
Remote Queue:
Name
It identifies the name of the remote queue
corresponding to the queue to be created.
Password
Write password for remote queues in the
remote Queue Manager.
Type
Queue Type
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
224
EMAFTM089/03
File Management
Field
Description / Values
LOCAL
Local Queue
MODEL
ALIAS
REMOTE
Remote Queue
UNKNOWN
Address Type
Address Type
Value
Description
Spazio 2
Spazio System
Local Automatic
Remote Automatic
6
Queue Mode
It specifies if the queue can be opened for input
several times concurrently.
Default Input
Open Option
It identifies the default way in which a queue
should be opened for input
File Default
User Class
It identifies the default user class when putting
files and getting files from queue.
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Storage Class
Storage class to be associated with the new
queue
Max File Depth
Maximum number of files that can be
contained in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
225
File Management
Field
Description / Values
Max Message Depth
Maximum number of messages that can be
contained in the queue.
Max Message Length
Maximum length of messages that may be
inserted in the queue.
Default Priority
Default priority of the Message\File put to
the queue
Default
persistence of
messages
Persistence assigned to messages written to
this queue that had no persistence specified
when they were written.
Message Delivery
Sequence
Mode in which messages are delivered
Value
Description
FIFO
Delivered using First In First
Out mechanism.
MVS only.
Priority
Based
Priority Based
Whether GET operations are blocked for the
queue:
Inhibit Get
Operation
Value
Description
True
GET operations are blocked.
False
GET operations are not
blocked.
Whether PUT operations are blocked for the
queue:
Inhibit Put
Operation
Value
Description
True
PUT operations are blocked.
Force Default
Class For Files
PUT operations are not
blocked.
Read password associated with the queue
(allows files and messages to be read from
the queue).
Write password associated with the queue
(allows files and messages to be inserted in
the queue).
Set password associated with the queue
(allows the queue to be modified or deleted).
Force all files put to the queue to use the
default user class
Force Default
Class For Messages
Force all messages put to the queue to use the
default user class
False
Read Password
Write Password
Set Password
8
Click the Delivery Mode tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
226
EMAFTM089/03
File Management
The following table explains the fields in the Delivery Mode tab.
It identifies how messages/files are written to the remote Queue
Manager, once they have been written on the local Queue Manager.
Allowed values:
Field
Delivery Mode
Description
The delivery mode for the queue (immediate
or within an interval or class)
Hold
Optional.
Alternate to Immediate, Interval, Use
Transport Class parameters.
Deferred delivery.
Files/messages remain in the local Queue
Manager. They are transmitted to the
remote Queue Manager only on request.
This mode is valid only for MVS nodes.
Immediate
Optional.
Alternative to Hold, Interval, Use Transport
Class parameters.
Immediate delivery.
All messages/files written on the local
Queue Manager are immediately
delivered to the remote Queue Manager.
If selected, the Max Delivery Time field
appears that identifies the maximum time
interval, in seconds, between the writing
of a message/file in the local Queue
Manager and its send to the remote Queue
Manager (max. 86400, a day).
This mode is valid only for MVS nodes.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
227
File Management
Field
Description
Interval
Optional.
Alternative to Hold, Immediate, Use Transport
Class parameters.
Identifies the time of the day at which the
delivery of a message/file starts and ends.
If selected, two fields appear and the user
must indicate the values in the format
HHMMSS.
This mode is valid only for MVS nodes.
Use Transport Class
Optional.
Alternative to Hold, Immediate, Interval
parameters.
The user can specify a transport class,
different from the default transport class,
to be used for files contained in this queue.
Value
Description
Use Default
Transport
Class
Use the current
default user class
Use
Destination QM
Default
Transport
Class
Default Transport
Class of their
destination queue
manager
Use Transport
Class
Specify a Transport
Class to be used
Transport Success Event
Event Name
Event used after a successful transport
Group Name
Group used after a successful transport
Transport Failure Event
Event Name
Event used after a failed transport
Group Name
Group used after a failed transport
Custom Delivery mode
Guaranteed Delivery
Order
Guaranteed Delivery Order
Restart Interval
Interval specified between restart attempts
Restart Max Number
Maximum number of restarts that can be
attempted.
If Delivery Mode is set to Use Transport
Class, this value is ignored, since it will
be taken directly from the Transport Class
specified for the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
228
EMAFTM089/03
File Management
Field
Description
If Delivery Mode is other than Class (Hold,
Immediate, Interval), this value can be
specified.
The range of values is [0 – 10000]. The
value 0 sets the value to the default (for
SPAZIO the default is 6).
Sync Level
Number of blocks (in the case of a file) or
number of messages before a Sync (ACK1)
is requested in the transport. Default: 10
Files
Transport Name
File Transport Name
Transport Timeout
File Transport Timeout
Transport Prestarted
File Transport Prestarted
Messages
9
Transport Name
Messages Transport Name
Transport Timeout
Messages Transport Name
Transport Prestarted
Messages Transport Name
Select the relevant option.
10 Click OK to create the queue, or Cancel to abort the operation.
NOTE: if the user specifies an incorrect password when defining a remote
queue, subsequent transmissions to this queue will fail (status "Failed").
Normally transmissions in "Failed" status require manual intervention by
the user (New Transport) in order to restart them. In this case, however, it is
enough to specify the correct password in the definition of the remote
queue and the transmissions will restart and complete automatically.
5.3.2.4 Remove a Queue
1
Select a local or remote queue.
2
Click the
3
The Remove Queue dialog box appears:
4
If no Set password was assigned to the queue, leave the Password field
blank. If a Set password is required, enter the correct password.
5
The queue is now deleted.
button on the toolbar.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
229
File Management
5.3.2.5 View and Set the Security properties of a Queue
To view or change the security properties of a queue, select the queue and
choose View – Security or right-click the queue and choose Security.
Refer to Chapter 7: Security Management for details on how to set and modify
the permissions.
5.3.4
DQLs
The sections below describe the operations that you can perform on DQLs
(Destination Queue Lists) belonging to a Queue Manager on a Local Node in
the File Management folder.
A DQL is a SPAZIO object that groups together a set of queues to which you
want to send files or messages. In SPAZIO you can add an item to a DQL by
naming a destination queue and its Queue Manager.
NOTE: all queues of a DQL must also belong to the same storage class. If
a DQL item is a Queue Manager queue type (M queue type), all the other
DQL queues must belong to the default storage.
5.3.4.1 List DQLs
1
Click the DQLs folder in the left panel of the screen.
2
The DQLs belonging to the current Queue Manager are displayed:
3
The DQLs are also listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
230
EMAFTM089/03
File Management
5.3.4.2 View the general properties of a DQL
1
Click a DQL.
2
If the
button on the toolbar is already selected, the properties of the
DQL are listed in the right panel:
The properties listed are the name of the DQL, possibly a brief description
and the date a time at which the DQL was created.
5.3.4.3 View the items contained in a DQL
1
Click a DQL.
2
button on the toolbar is already selected, the items contained in
If the
the DQL are displayed in the right panel:
The various objects are displayed hierarchically, using the familiar icon
representations of queues and Queue Managers.
5.3.4.4 Create a DQL
The easiest way to explain DQL creation is through a simple example. The
following sections describe the creation of a DQL called dql2.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
231
File Management
Requirements for the example DQL
The following are the requirements for the example DQL dql2:
„
It must include two queues under Queue Manager BORODIN called
FRMQMGR1 and FRMMVSND
„
It must include one queue under Queue Manager MVSNODE called
FRMQMGR1
„
Read, Write and Set passwords must be specified for the DQL.
NOTE: in this example, two queues share the same name (FRMQMGR1).
This is possible since both queues belong to different Queue Managers.
Create the new DQL object
The first step is to create a new (empty) DQL, providing a name, description
(optional) and various passwords (optional). In this case the DQL will be
called dql2. Read, Write and Set passwords will be specified.
The following steps describe how to create this DQL:
1
Select the DQLs folder under the relevant Queue Manager.
2
Click the
3
The New DQL dialog box appears:
button on the toolbar.
The following table explains the fields and buttons in the New DQL dialog
box:
Field
Description / Values
Name
Name of the DQL.
Description
Brief description of the DQL.
Password
DQL password
Read
Read password associated with the DQL.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
232
EMAFTM089/03
File Management
Field
Description / Values
Write
Write password associated with the DQL (allows
files and messages to be inserted in the DQL).
Set
Set password associated with the DQL (allows the
DQL to be modified or deleted).
Insert Sibling
Insert an item in the DQL that is at the same
hierarchical level as the currently selected item.
Insert Child
Insert an item in the DQL that is at the next
hierarchical level below the currently selected item.
Show Details
Open a further panel listing details of each DQL
item.
Hide Details
Close the above panel.
OK
Accept the current input and proceed to the next
operation.
Cancel
Cancel the current input.
4
Fill in the relevant fields in the New DQL dialog box:
5
Click OK to continue, or Cancel to abort the operation.
Add items to the DQL
The rest of this section describes how to add items to the DQL. To follow the
example described previously, the steps involved are:
„
Add a Queue Manager BORODIN as a child of the DQL dql2.
„
Add a Local Queue FRMQMGR1 as child of Queue Manager BORODIN.
„
Add a Local Queue FRMMVSND as a sibling of Local Queue
FRMQMGR1.
NOTE: FRMMVSND could equally be inserted as another child of
BORODIN.
„
Add a second Queue Manager MVSNODE as a child of the DQL dql2.
NOTE: MVSNODE could equally be inserted as a sibling of BORODIN.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
233
File Management
„
Add a Local Queue also called FRMQMGR1 as child of Queue Manager
FRMMVSND.
The following steps describe these procedures:
1
To enter the first item in the DQL, click Insert Child.
2
The DQL Item dialog box appears:
3
Type BORODIN (the name of the first Queue Manager containing
destination queues for the DQL) in the Name field.
4
Leave the Address Type as the default 0, indicating SPAZIO 2.
5
Select the object type (in this case Queue Manager) from the list in the
Type field.
6
Queue Manager BORODIN is now added to the DQL:
7
Next, select Queue Manager BORODIN, and click the Insert Child button.
8
The DQL Item box appears again:
9
Type FRMQMGR1 (the name of the first destination queue under Queue
Manager BORODIN) in the Name field.
10 Leave the Address Type as the default 0, indicating SPAZIO 2.
11 Select the object type (in this case Local Queue) from the list in the Type
field.
12 Click OK.
13 The queue FRMQMGR1 is now added to the DQL:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
234
EMAFTM089/03
File Management
The next queue to be added, FRMMVSND, is also under Queue Manager
BORODIN, and so can be considered a sibling of FRMQMGR1:
14 Select FRMQMGR1.
15 Click the Insert Sibling button to open the DQL Item dialog box:
16 Type FRMMVSND (the name of the second destination queue under Queue
Manager BORODIN) in the Name field.
17 Leave the Address Type as the default SPAZIO 2.
18 Select the object type (in this case Generic Queue) from the list in the
Type field.
19 Click OK.
20 The queue FRMMVSND is now added to the DQL:
21 To complete the DQL, select dql2:
22 Click the Insert Child button to open the DQL Item dialog box:
23 Type MVSNODE (the name of the next Queue Manager containing a
destination queue for the DQL) in the Name field.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
235
File Management
24 Leave the Address Type as the default SPAZIO 2.
25 Select the object type (in this case Queue Manager) from the list in the
Type field.
26 Click OK.
27 Queue Manager MVSNODE is now added to the DQL:
28 Next, select Queue Manager MVSNODE, and click the Insert Child
button.
29 The DQL Item box appears again:
30 Type FRMQMGR1 (the name of the destination queue under Queue
Manager BORODIN) in the Name field.
31 Leave the Address Type as the default 0, indicating SPAZIO 2.
32 Select the object type (in this case Local Queue) from the list in the Type
field.
33 Click OK.
34 The queue FRMQMGR1 is now added to dql2 and the DQL is complete.
35 Click the Show Details button to open an additional panel listing details
for each item in the DQL:
Click Hide Details to close the lower panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
236
EMAFTM089/03
File Management
5.3.4.5 Remove a DQL
1
Select the DQL that you want to delete in the left panel of the workspace.
2
Click the
3
The Remove DQL dialog box appears:
4
If the DQL is protected by a Set password, type it in the Password field
(otherwise, leave the field blank).
5
Click OK to proceed with deletion, or Cancel to cancel the operation.
button on the toolbar.
5.3.4.6 View and Set the Security properties of a DQL
1
Right click the relevant DQL in the left panel of the workspace
2
Choose Security from the pop-up menu:
3
Refer to Chapter 8: Security Management for details on how to set and
modify the permissions.
5.3.4.7 Modify a DQL
5.3.5
1
Right click the relevant DQL in the left panel of the workspace
2
Choose Modify from the pop-up menu:
3
Refer to Section 6.2.5.4 Create a DQL for details on how to modify the
properties.
User Classes
The sections below describe the operations that you can perform on User
Classes belonging to a Queue Manager on a Local or Remote Node in the File
management folder.
5.3.5.1 List User Classes
1
Click the User Classes folder in the left panel of the screen.
2
The User Class under the current Queue Manager are displayed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
237
File Management
3
The User Classes are also listed in the right panel:
5.3.5.2 View the properties of a User Class
1
Click a User Class in the left panel.
2
The properties of the User Class are listed in the right panel:
3
The User Class properties are described in the following table:
Property
Description / Values
Description
Brief description of the User class.
Expiry after put
Specifies an interval after which objects
inserted in the queue will expire.
Expiry after read
Specifies an interval after which objects read
from the queue will expire.
Name
Name of the User Class.
Object Set Name
Object Set name
Queue Set Name
Queue Set name
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
238
EMAFTM089/03
File Management
5.3.5.3 Create a User Class
1
Select the User Classes folder.
2
Click the
button on the toolbar. The following screen appears:
The following table explains the fields in the tab:
Field
Description / Values
User Class Name
Name of the new User Class (maximum 4
alphanumeric characters)
Description
Brief description of the User Class.
Queue Set Name
Queue set name
Object Set Name
Object set name
Expiry after put
Specifies an interval after which objects
inserted in the queue will expire.
The selection box lets you choose a time unit
for the specified interval.
The choices are:
Expiry after read
„
Minutes
„
Hours
„
Days
Specifies an interval after which objects read
from the queue will expire.
The selection box lets you choose a time unit
for the specified interval. The choices are:
Type
„
Minutes
„
Hours
„
Days
User Class type
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
239
File Management
Field
Description / Values
Value
Description
Permanent
Permanent User
class
Dynamic Allocation
3
Priority Deletion
Mode
Priority Deletion
enforced
Forced External
File
When a record is
inserted on a Local
queue it forces the
file to be external.
MVS only
Force Internal
Format
When a record is
inserted on a Local
queue it forces the
file to be written in
an internal format.
DP only.
Fill in the relevant fields and click OK to create the User Class, or Cancel
to cancel the operation.
5.3.5.4 Remove a User Class
5.4
1
Select a User Class in the left panel of the workspace.
2
Click the
button on the toolbar.
File Manager operations
SPAZIO Management Console allows you to perform the following File
Management operations:
„
View list of the files (and their attributes) stored in a queue
„
View the properties of a files in a queue
„
View the contents of a file stored in a queue
„
Dispatch a file to a queue
„
Acquire a file from a queue
„
Delete files stored in a queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
240
EMAFTM089/03
File Management
5.4.1
Open a Queue
Each queue is managed by a Queue Manager. In order to open a queue, you
must first connect to its Queue Manager (see Section 5.3.1.5).
You must connect to a Queue Manager before you can view or perform
operations on queues and files.
It’s possible to filter the list of queues (see Section 5.3.2.1).
5.4.1.1 List Queues
To list the queues belonging to a Queue Manager:
1
Connect to a Queue Manager (see Section 5.3.1.5).
2
Click on Queues folder and then you will see the defined queues in the left
panel of the workspace:
Local Queues are represented by the icon, whereas Remote Queues (that is,
queues that point to other queues on remote nodes) are represented by the
icon.
5.4.1.2 Queue Filter operations
To filter the list of queues, right-click on the Queue folder under the current
Queue Manager and select Set Filter in the pop-up menu:
The following window appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
241
File Management
Enter the Queue Filter string and the Address Type Filter in the dialog box.
5.4.1.3
Unfilter a Queue list
To unfilter the list of Queues right-click on the Queue folder under the
current Queue Manager and select Set Filter in the pop-up menu:
The following window appears:
Enter blank in Queue Filter and click OK.
5.4.1.4 Open a Queue
To open a queue, simply select the queue from the list.
5.4.2
View a list of the files contained in a queue
If you want to see the files contained in a queue, you must click on the queue
and click the
button. The right panel of the workspace will contain a list
of the files in that queue.
How the files are displayed depends on the options checked in the View
menu:
5.4.2.1
View a list of files as icons and file names
If Large Icons, Small Icons or List is selected, you will see an icon and a file
name for each file in the queue.
The icons are:
for a data file
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
242
EMAFTM089/03
File Management
for a binary file
5.4.2.2
View a list of file names and file details
If, however, you have selected Details in the View menu, then a list of
attributes or characteristics is also displayed for each file.
The properties are explained in Section 6.3.3.
5.4.3
View the properties of a file
This function lets you view a series of properties associated with a file in a
queue.
To view file properties:
1
Select a file from the Files panel of the workspace
2
Right-click and select Property from the pop-up menu.
The box that appears contains three tabs: General, Default Priority and
Modality. The following sections describe the contents of these tabs.
5.4.3.1
General properties
This tab provides information on the various identifiers associated with the
file, its Class, Sender, type and size.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
243
File Management
The following table describes the file’s general options:
5.4.3.2
Item
Description
Correlation ID
Correlation ID of the file.
File ID
File ID of the file.
Internal Number
SPAZIO Internal number of the file.
Class
Storage class of the file.
Sender
Sender of the file
Bytes
Size of the file in bytes.
Object Type
The type of data object in the queue.
Original File Name
Name with which the file was dispatched to
a queue.
Destination File Name
Name assigned to the file at destination.
Type
The type of the file: whether it is INTERNAL
or EXTERNAL, and whether it is DATA or
BINARY
Records
Size of the file in records.
Default Priority
This tab provides various dates and times associated with the file.
The following table describes the file’s Default Priority options:
Item
Description
First Read
Date and time that the file was first read from
the queue.
Last Read
Date and time that the file was last read from
the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
244
EMAFTM089/03
File Management
5.4.3.3
Item
Description
Expiry
Date and time at which the file in the queue
expires.
Rename
Date and time at which the file in the queue is
renamed.
Modality
This tab provides various the modality of the file.
5.4.4
View the contents of a file
This function lets you read the contents of a file directly from the queue,
without first having to acquire it. To view the file contents, there must be an
application associated with the file name as it appears in the Correlation ID
field.
To view the contents of a file:
1
Select a file from the Files panel of the workspace.
2
Click the
button, or choose File – View. (Alternatively, right-click the
file and choose View from the menu that appears, or simply double-click
the file)
3
If the Correlation ID field contains a filename of a type that is associated to
an application on the user’s system, then the file is opened in that
application so that you can view the contents.
4
If, however, the Correlation ID field contains a filename of a type that is
not associated to any application on the user’s system, then the following
error message appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
245
File Management
5.4.5
Dispatch a file
When you dispatch a file, you put it into a specific queue, from where it may
be acquired (or forwarded to another queue).
The next sections look at the three ways that you can dispatch a file to a
queue.
5.4.5.1
Point-and-click method
1
Connect to a Queue Manager (see Section 5.3.1.5).
2
Select the queue to which you want to dispatch the file.
3
Click the
button, or choose File – Dispatch.
(Alternatively, you can right-click the queue and choose Dispatch from
the menu that appears.)
4
The Open dialog box appears:
The files contained in the current directory are displayed.
5
button or the down arrow
Click the
up or down to other directories.
in the Look in box to browse
6
Click on the file that you want to dispatch. The name of this file now
appears in the File name text box.
7
Click Open.
8
The File Descriptor dialog box now appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
246
EMAFTM089/03
File Management
9
Fill in the relevant fields and modify default options as required. The
following table explains the fields in the above box:
Field
Description
File ID
File ID of the file.
Correlation
ID
Correlation ID of the file.
Comment
Short description of the file. Maximum 64
characters.
Destination
File
Used only for external files, typically in the form of
a file path x:\…..\…..\xxxxxxxx.xxx
User Class
Optional. User class to be associated with the file.
Sender
Name of the sender.
Priority
Priority to be assigned to the file in the queue
(default=0, must be a numeric value in the range 0
to 255)
Compressed
The file to be dispatched is compressed.
File Type
Specifies whether a file is to be dealt with as a text
or binary file.
Record Type
Value
Description
Binary
Specifies a binary file (default).
Data
Specifies a data file.
Specifies the record type of the file.
Value
Description
Fixed
The file has a fixed length record
structure.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
247
File Management
Field
Description
Variable
The file has a variable length record
structure.
Stream
The file is stream type.
Record Mandatory if the Record Type is Fixed. It specifies
Length either the length of fixed-length records, or the
maximum length of variable-length records.
Max Record Meaningful for Record Type = Variable Length.
Length It specifies the maximum length of variable-length
records.
End of Record Only specified if File Type = DATA.
End-of-record marker.
Value
Description
None
According to platform
CRLF
CR + LF
LF
LF
End of file
Only specified if File Type = DATA.
End-of-file marker.
Expiry after
put
The length of time (in minutes, hours or days) that
a file remains in a queue after it has been put there
before it expires.
Expiry after
read
The length of time (in minutes, hours or days) that
a file remains in a queue after it has been read
before it expires.
Directives
File handling directives.
Value
Description
Compress
Request the file to be compressed
before it is dispatched to the
queue.
External at
sources
The file is taken directly from the
file system and transferred to a
target queue, writing only a
pointer to the queue.
External at
destination
The file is written directly to the
target file system, writing only
the pointer information to the
destination queue.
10 Click the External tab if the file is to be handled as “external;”
11 Select the target system type.
According to the selected system type different types of information are
required.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
248
EMAFTM089/03
File Management
If the system type is MINI, the following window appears:
Fill in the relevant fields. The following table explains the field in the
above box:
Field
Description
Path
Path of the file in the target file system, typically in
the form x:\…..\…..\xxxxxxxx.xxx
If the system type is MVS Sequential, the window appears as follows:
Fill in the relevant fields. The following table explains the fields in the
above box:
Field
Description
Dataset name
Destination file name
Organization
Organization type
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
249
File Management
Field
Description
Disposition
NOTE: this and other disposition/multiversioning parameters are applicable only where
you are putting a file in a remote queue and wish
to specify instructions on how to create the file at
destination.
Disposition (DISP) to be used when creating file on
the target system:
Normal
Disposition
Value
Description
NONE
Default behavior
REPLACE
Overwrite
CREATE
Create if it does not
already exist
REPLACE_NO_CREATE
Overwrite - do not create
if it doesn't exist
Normal disposition.
Values:
Value
NONE
CATLG
UNCATLG
KEEP
DELETE
Conditional
disposition
Conditional disposition
Values:
Value
NONE
CATLG
UNCATLG
KEEP
DELETE
Space (in
bytes)
Space in bytes to allocate.
Space
attributes
Values:
Value
Description
RLSE
Request to free excessive space at close
CONTIG
Space allocation mode
MXIG
Alternative to the preceding and
following
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
250
EMAFTM089/03
File Management
Field
Description
ALX
Alternative to the preceding fields
Serial number
Volume serial number
Unit
Volume device type
File Format
File format:
Value
Description
F
Fixed length records
FB
Fixed length blocked
V
Variable length records
VB
Variable length blocked
Record Length
Fixed record length for F or FB format.
Maximum variable record length for V or VB format
Block Size
Block length. From 1 to 32767
Expiration
Values:
Value
Description
Date
End of validity date in YYYYDDD
format
Period
Days of validity in DDDD format
None
No expiration
12 Click the ACK tab if you wish to use acknowledgements.
The following box appears:
Fill in the relevant fields. The following table explains the fields in the
above box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
251
File Management
Field
Description
Acknowledge on Put
If checked, the application returns a
message (in the Reply Queue of the
Reply Queue Manager) when the file is
inserted in the queue
Acknowledge on Browse
If checked, the application returns a
message (in the Reply Queue of the
Reply Queue Manager) when the file is
consulted
Acknowledge on Get
If checked, the application returns a
message (in the Reply Queue of the
Reply Queue Manager) when the file is
read and removed from the queue
Negative Acknowledge
for missing delivery
If checked, the application returns a
message (in the Reply Queue of the
Reply Queue Manager) if the delivery
time expires before the file is put on the
queue.
Negative Acknowledge
for expiration
If checked, the application returns a
message (in the Reply Queue of the
Reply Queue Manager) if the expiry after
put time expires.
Reply Queue Manager
Name of the Queue Manager where the
ACK message should be written.
The user can specify a different Reply
Queue Manager from the Queue
Manager where the ACKs are generated.
In this case, such ACKs are written in the
Queue Manager that generates them, in
a remote queue, created automatically,
with the same name as the specified
Reply Queue Manager and address type
1 (SPAZIO System Queue queue type).
Reply Queue
Name of the Queue where the ACK
message is to be written.
Reply Queue Password
Write password for the Queue specified
in the previous field.
13 Click OK to proceed (or Cancel to cancel the dispatch operation).
14 The following box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
252
EMAFTM089/03
File Management
This box will be displayed for the number of seconds specified in the
View time field, or until you click OK.
15 The file is now dispatched to the relevant queue.
5.4.5.2
Copy and paste method
Finally, you can begin a file dispatch operation by copying a file from a
browser such as Windows Explorer and pasting it to the relevant queue. To do
this:
1
Select a file in the file browser.
2
Copy the file (for example using CTRL+C, or by clicking the Copy button).
3
In Queues folder, select the queue to which you want to dispatch the file.
4
Click the
button, or choose File – Paste.
Follow steps 8 to 12 in Section 5.3.5.1.
5.4.6
Acquire a file
When you acquire a file, you extract it from a queue and save it to your hard
drive. The following steps describe how to do this:
1
Connect to the relevant Queue Manager (see Section 5.3.1.5).
2
Select the queue containing the file that you want to acquire.
3
Select the file that you want to acquire from the Files panel of the
workspace.
4
Click the
button, or choose File – Acquire.
(Alternatively, right-click a file and choose Acquire from the menu that
appears).
5
The Save As dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
253
File Management
5.4.7
6
If you wish, you can browse up or down to other directories using the
button, or by clicking the down arrow in the Save In box.
7
Insert a name for the file to be acquired in the File Name textbox.
8
Click Save (or Cancel to cancel the acquire operation).
Delete a file
To delete a file from a queue:
1
Connect to the relevant Queue Manager (see Section 5.3.1.5).
2
Select the queue containing the file that you want to delete.
3
Select the file that you want to delete from the Files panel of the
workspace.
4
Click the
button, or choose File – Delete. (Alternatively, right-click
the file you want to delete and choose Delete from the menu that
appears).
5
The following dialog box appears:
6
Click Yes to delete the file, No to cancel deletion.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
254
EMAFTM089/03
Chapter 6
Event Management
In the Event Management folder SPAZIO Management Console allows you to
define and modify events together with their trigger conditions and to
associate these events with queues. It is likewise possible to modify
definitions and queue associations.
6.1
6.1.1
The Event Management Folder
Toolbar
The toolbar contains only one button. The following table describes the
function of the button and the equivalent menu command:
Button
6.1.2
Function
Menu Command
Connect to a Local or Remote node
Action – Connect
to Node..
Workspace
When you open Event Management folder, the list of the Queue Manager of
the current node is displayed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
255
Event Management
If you click on a Queue Manager, you will see three folders: Static Events,
Dynamic Events, Event Instances.
In the Static Events folder you can manage static events definitions, which
are loaded into events catalogue when you start SPAZIO.
In the Dynamic Events folder, you can manage dynamic event definitions,
which are loaded into events catalogue while SPAZIO is running.
In the Event Instances folder, you can see the instances of events.
For more details, see SPAZIO MFT/S for Distributed Platforms: Event Manager
Guide
6.2
Static Event
The section below describes the operations that you can perform on Static
Events.
6.2.1
Create an Event Definition
1
Right-click on Static Events folder under the current Queue Manager.
2
The following dialog box appears
This gives you the option of creating a Basic or Extended Event Definition.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
256
EMAFTM089/03
Event Management
6.2.1.1 Basic Event Definition
1
Select Basic from the previous menu
2
The following dialog box appears:
The following table describes the fields:
Field
Description / Values
Group Name
Event group name (char. 8), Mandatory
Name
Event name (char. 8), Mandatory
Description
This is an optional field composed of up to 64
characters containing the description of the
message or file in question
Command Type
Value
Description
COMM
execute SPOS process named
CommName; (CommParam passed in
BeginProc Area)
PROC
send SPOS message (with event
triggering specifications) to a SPOS
process registered with name
CommName; (CommParam passed in
SPOS message)
SHELL
Execute generic process or command
shell named CommName (CommParam
in command line)
Command
Name of process/shell script to activate or name of
a registered SPOS process to trigger. Mandatory
Command
Parameter
Parameter line to be passed or sent via a SPOS
message.
Parameter substitution:
?QUEUE?
Name of Queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
257
Event Management
Field
Description / Values
?QMANAGER?
This protected field contains the
name of the Queue Manager to
which the user User ID can
connect
?EV_ID?
Event ID
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?
Sender
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
?FIRST_DATE? Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME? Time when the event was first
scheduled (format HHMMSS)
3
If you click on Advanced, you can modify the other parameters:
The following table describes the fields in the tab:
Field
Description / Values
Persistence
Value
Description
1
Persistent.
2
Volatile (default)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
258
EMAFTM089/03
Event Management
Field
Description / Values
Entry Type
Type.
Value
Description
M
Message
P
Persistent Message
N
Non – Persistent Message
F
File
A
All types (default)
MessageFile ID
Message file ID
Correlation ID
This optional field is composed of up to 8
characters containing the correlation identifier of
the message or file in question
User Class
This optional field is composed of up to 4
characters containing the user class of the message
or file in question
Sender
This optional field is composed of up to 8
characters containing the sender of the message or
file in question
4
Click OK to create the event, or Cancel to abort the operation.
5
To activate this new Event Definition you have to click Apply and restart
Spazio.
6.2.1.2 Extended Event Definition
1
Select Extended from the Create Event definition menu.
2
The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
259
Event Management
The following table describes the fields:
Field
Description / Values
Group Name
Event group name (char. 8), Mandatory
Name
Event name (char. 8), Mandatory
Description
This is an optional field composed of up to 64
characters containing the description of the
message or file in question
Command Type
Value
Description
COMM
execute SPOS process named
CommName; (CommParam passed in
BeginProc Area)
PROC
send SPOS message (with event
triggering specifications) to a SPOS
process registered with name
CommName; (CommParam passed in
SPOS message)
SHELL
Execute generic process or command
shell named CommName (CommParam
in command line)
Command
Name of process/shell script to activate or name
of a registered SPOS process to trigger.
Mandatory
Command
Parameter
Parameter line to be passed or sent via a SPOS
message. Mandatory.
Parameter substitution (where ValidationType = 1
or 2):
?QUEUE?
Name of Queue
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EV_ID?
Event ID
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?
Sender
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
260
EMAFTM089/03
Event Management
Field
Description / Values
?FIRST_DATE?
Date when the event was
first scheduled (format
YYYYMMDD)
?FIRST_TIME?
Time when the event was
first scheduled (format
HHMMSS)
Parameter substitution (where ValidationType = 3
or 5)
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EV_ID?
Event ID
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
?FIRST_DATE?
Date when the event was
first scheduled (format
YYYYMMDD)
?FIRST_TIME?
Time when the event was
first scheduled (format
HHMMSS)
Parameter substitution (where ValidationType =
4) - New event parameters:
?GRNAME?
Group Name
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EVNAME?
Event Name
?EV_ID?
Event ID
?FIRST_DATE? Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME? Time when the event was first
scheduled (format HHMMSS)
?SESS_ID?
Session identifier
Parameter substitution (where ValidationType =
4) – Originating event parameters:
?INFO?
User Info
?EE?
Completion Code
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
261
Event Management
Field
Description / Values
?RC?
User return code
?TERM_CODE?
Originating event
Termination Code:
complete/abort (max. 4
decimal char.)
?REASON_CODE?
Originating event Reason
Code (max. 8 decimal char.)
?RETURN_CODE?
Originating event Return
Code (max. 8 decimal char.)
?QUEUE?
Queue
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?,
Sender
?OLDPAR?
Validation Type
Validation Type
Value
Description
1
Associated to specific queues (default)
2
Associated to any queue
3
Calendar specification (day, week,
month, year)
4
Triggered by other event
5
Starting with Queue Manager
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
262
EMAFTM089/03
Event Management
The following table describes the fields in the tab:
Field
Description / Values
Persistence
Value
Description
1
Persistent.
2
Volatile (default)
Entry Type
Type. Values:
Value
Description
M
Message
P
Persistent Message
N
Non – Persistent Message
F
File
A
All types (default)
MessageFile ID
Message File ID
Correlation ID
This optional field is composed of up to 8
characters containing the correlation identifier of
the message or file in question.
User Class
This optional field is composed of up to 4
characters containing the user class of the message
or file in question.
Sender
This optional field is composed of up to 8
characters containing the sender of the message or
file in question.
Restart
Restart type of the process started/triggered by
events.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
263
Event Management
Field
Description / Values
1
No restart (default)
2
Restart (it is also persistent)
Retry Number
In case of restart: Maximum number of retries in
re-scheduling a failed process managed in restart.
0: unlimited, default: 6
Retry Interval
In case of restart: Interval, in seconds, between
retries in re-scheduling a failed process managed
in restart.
Values: [120 ...14400]
Default: 480
Max
Parallelism
Max. parallelism of processes managed in restart
by the Event Manager. Default 0 (i.e., no
parallelism limit).
Priority
Priority in scheduling the event: 1-10. Default 5
Policy
Policy of event management.
Value
Description
0
Immediate scheduling (if possible)
(Default)
1
Scheduling only in specified interval
(at least 3 minutes)
Begin Hour
Interval
Starting hour of the interval, 0-23.
Mandatory, if Policy = 1.
Begin Minute
Interval
Starting minute of the interval, 0-59.
Mandatory, if Policy = 1.
End Hour
Interval
Ending hour of the interval, 0-23.
Mandatory, if Policy = 1.
End Minute
Interval
Ending minute of the interval, 0-59.
Mandatory, if Policy = 1.
Locked Flag
Value
Description
1
Locked (when locked no event
instance can be activated)
0
Unlocked (Default)
Calendar
Policy
Mandatory where ValidationType is 5 (Calendar
Specification). Values:
Value
Description
1
Daily (default)
2
Weekly
3
Monthly
4
Yearly
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
264
EMAFTM089/03
Event Management
Field
Description / Values
5
Day
Day of Week Monthly
Day of the week, month, year: 1-N . Default 1.
NOTE:
day of week - 1: Sunday, 2: Monday, ..., 7:
Saturday
day of month - 31: last day of month
day of year - 365 or 366: last day of year
Day Modifier
Value
Description
1
Any day (default)
2
No Sunday
3
No Saturday or Sunday
4
Only Saturday
5
Only Saturday or Sunday
6
1st day of week (sDay) in month
(CalendarPolicy = 5)
7
2nd day of week (sDay) in month
(CalendarPolicy = 5)
8
3rdday of week (sDay) in month
(CalendarPolicy = 5)
9
4thday of week (sDay) in month
(CalendarPolicy = 5)
10
Last day of week (sDay) in month
(CalendarPolicy = 5)
Abort Group
Name
Event group name (char. 8) of another event to be
scheduled if the event fails. Default NONE.
Abort Event
Name
Event name (char. 8) of another event to be
scheduled if the event fails. Default NONE.
Complete Group
Name
Event group name (char. 8) of another event to be
scheduled if the event is completed successfully.
Default NONE.
Complete Event
Name
Event name (char. 8) of another event to be
scheduled if the event is completed successfully.
Default NONE.
5
Click OK to create the event
6
To activate this new Event Definition you have to click Apply and restart
Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
265
Event Management
6.2.2
Remove an Event Definition
There are two different ways to remove an Event Definition:
Select and Remove an Event Definition
1
Right-click on the event. The following pop-up menu appears:
2
Select Remove event definition… . The following screen appears:
3
Click on Yes to confirm, No to abort the operation.
4
To activate this change you have to click Apply and restart Spazio.
Remove an Event Definition by Name
6.2.3
1
Right-click on Static Event folder. The following pop-up menu appears:
2
Select Remove Event Definition
3
Insert group name and event name
4
Click on Remove to confirm, or Cancel to abort the operation
5
To activate this change you have to click Apply and restart Spazio.
Update an Event Definition
1
Select a particular Event Definition you wish to update.
2
Right click on the Event Definition. The following pop-up menu appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
266
EMAFTM089/03
Event Management
3
Select Update Event Definition…
The windows of the selected event appear and you can make your
changes. Refer to Section 7.2.1 for the relevant explanations.
6.2.4
6.2.5
4
Click OK to confirm the changes, Cancel to abort the operation.
5
To activate the changes you have to click Apply and restart Spazio.
Add a queue to an Event Definition
1
Select a particular Event Definition to which you want to add a new
Queue.
2
Right click on the Event Definition. The following pop-up menu appears:
3
Select Add Queue.
4
Insert the Queue Name.
5
Click OK to add the queue or Cancel to abort the operation.
6
To activate the changes you have to click Apply and restart Spazio.
Remove a queue from an Event Definition
1
Select a particular Event Definition from which you want to remove a
Queue.
2
Right click on the Event Definition. The following dialog box appears:
3
Select Remove Queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
267
Event Management
6.2.6
6.3
4
Insert the details of the Queue to be removed.
5
Click Remove to confirm, or Cancel to abort the operation.
6
To activate the changes you have to click Apply and restart Spazio.
Lock and Unlock an Event Definition
1
Select a particular Event Definition you want to Lock.
2
Right click on the Event Definition. The following dialog box appears:
3
Select Lock or Unlock as required.
4
To activate the changes you have to click Apply and restart Spazio.
Dynamic Event
The section below describes the operations that you can perform on Dynamic
Events.
6.3.1
Create an Event Definition
1
Right-click on Dynamic Events folder under the current Queue Manager
or click on Action-Create Event Definition.
2
The following dialog box appears
This gives you the option of creating a Basic or Extended Event Definition.
6.3.1.1 Basic Event Definition
1
Select Basic from the previous menu
2
The following window appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
268
EMAFTM089/03
Event Management
The following table describes the fields in the General tab:
Field
Description / Values
Name
Event name (char. 8), Mandatory
Group Name
Event group name (char. 8), Mandatory
Description
This is an optional field composed of up to 64
characters containing the description of the
message or file in question
Command Type
Value
Description
COMM
execute SPOS process named
CommName; (CommParam passed in
BeginProc Area)
PROC
send SPOS message (with event
triggering specifications) to a SPOS
process registered with name
CommName; (CommParam passed in
SPOS message)
SHELL
Execute generic process or command
shell named CommName (CommParam
in command line)
Command
Name of process/shell script to activate or name of
a registered SPOS process to trigger. Mandatory
Parameter
Parameter line to be passed or sent via a SPOS
message. Mandatory.
Parameter substitution:
?QUEUE?
Name of Queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
269
Event Management
Field
Persistence
3
Description / Values
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EV_ID?
Event ID
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?
Sender
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
?FIRST_DATE?
Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME?
Time when the event was first
scheduled (format HHMMSS)
Value
Description
No
Volatile (default)
Yes
Persistent.
Click on the Advanced (Queue) tab.
The following table describes the fields of the Advanced (Queue) tab.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
270
EMAFTM089/03
Event Management
Field
Description / Values
Condition
Value
Description
Yes
Specify Conditions
No
Do not specify Conditions
Value
Description
File
File
Message
Message
Value
Description
Close
Output
End-of-writing. The event is to
be triggered when a message or
file is written on the Queue
Manager
Close Input
End-of-reading. The event is to
be triggered when a message or
file is read from the Queue
Manager
Open Output
Start-of-writing. The event is to
be triggered when a message or
file starts being written into the
Queue Manager
Entry Type
File Flag
Correlation Id
This is an optional field composed of up to 24
characters containing the correlation identifier of
the message or file in question.
The event is validated when a file or message
with the specified Correlation Id is read or
written from or to the connected Queue Manager,
according to the value of OPEN/ CLOSE field, if
specified.
User Class
This is an optional field composed of up to 4
characters containing the user class of the
message or file in question.
The event is validated when a file or message
belonging to the specified user class is read or
written from or to the connected Queue Manager,
according to the value of OPEN/ CLOSE field, if
specified.
Sender
This is an optional field composed of up to 8
characters containing the sender of the message
or file in question.
The event is validated when a file or message sent
by the specified sender is read or written from/to
the connected Queue Manager, according to the
value of OPEN/ CLOSE field, if specified.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
271
Event Management
Field
Description / Values
Queue Name
Queue name. The string can have up to 48
characters
Address type of the queue to which the message
or file in question belongs. Values:
Address Type
Value
Description
S
SPAZIO
Q
SPAZIO Queue Manager
I
IBM MQSeries
M
Microsoft
L
Local automatic
R
Remote Automatic
6.3.1.2 Extended Event Definition
1
Select Extended from the Create Event definition menu.
2
The following window appears:
The following table describes the fields of the General tab:
Field
Description / Values
Name
Event name (char. 8), Mandatory
Group Name
Event group name (char. 8), Mandatory
Description
This is an optional field composed of up to 64
characters containing the description of the
message or file in question.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
272
EMAFTM089/03
Event Management
Field
Description / Values
The event is validated when a file or message with
the specified description is read or written from or
to the connected Queue Manager, according to the
value of File Flag field in the Advanced(Queue)
tab, if specified.
Command Type
Parameter
Value
Description
COMM
Execute SPOS process named
CommName; (CommParam
passed in BeginProc Area)
SPROC
Send SPOS message (with
event triggering specifications)
to a SPOS process registered
with name CommName;
(CommParam passed in SPOS
message)
SHELL
execute generic process or
command shell named
CommName (CommParam in
command line)
Parameter line to be passed or sent via a SPOS
message. Mandatory.
Parameter substitution (where ValidationType = 1 or
2):
?QUEUE?
Name of Queue
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EV_ID?
Event ID
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?
Sender
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
?FIRST_DATE?
Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME?
Time when the event was first
scheduled (format HHMMSS)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
273
Event Management
Field
Description / Values
Parameter substitution (where ValidationType = 3 or
5)
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EV_ID?
Event ID
?GRNAME?
Group name
?EVNAME?
Event Name
?SESS_ID?
Session identifier
?FIRST_DATE?
Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME?
Time when the event was first
scheduled (format HHMMSS)
Parameter substitution (where ValidationType = 4) New event parameters:
?GRNAME?
Group Name
?QMANAGER?
This protected field contains
the name of the Queue
Manager to which the user
User ID can connect
?EVNAME?
Event Name
?EV_ID?
Event ID
?FIRST_DATE?
Date when the event was first
scheduled (format YYYYMMDD)
?FIRST_TIME?
Time when the event was first
scheduled (format HHMMSS)
?SESS_ID?
Session identifier
Parameter substitution (where ValidationType = 4) –
Originating event parameters:
?INFO?
User Info
?EE?
Completion Code
?RC?
User return code
?TERM_CODE?
Originating event Termination
Code: complete/abort (max. 4
decimal char.)
?REASON_CODE? Originating event Reason Code
(max. 8 decimal char.)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
274
EMAFTM089/03
Event Management
Field
Description / Values
?RETURN_CODE? Originating event Return Code
(max. 8 decimal char.)
?QUEUE?
Queue
?CLASS?
Class
?INT_NUM?
Internal number.
?MF_ID?
Message/File identifier
?CORR_ID?
Correlation identifier
?SENDER?,
Sender
?OLDPAR?
Validity Dates
Start date and end date of the event
Policy
Value
Description
Immediate
Immediate scheduling (if
possible). Default
Interval
Scheduling only in specified
interval – specified in the next
two parameters.
Once the validation criteria are
matched, the event is
scheduled as soon as possible
at a time within the range
specified by fields Scheduled
Begin time and Scheduled
End time.
Minimum interval time of 180
seconds.
Scheduled
Begin time
Time from which the event can be scheduled.
Scheduled End
time
Time up to which the event can be scheduled
(format HHMMSS).
Persistence
Value
Description
Yes
Persistent
No
Volatile (default)
Value
Description
Yes
Restart (it is also persistent)
No
No restart (default)
Retry Number
In case of restart: Maximum
number of retries in rescheduling a failed process
managed in restart. 0:
unlimited, Default 6.
Restart
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
275
Event Management
Field
Validation
Type
3
Description / Values
Retry Interval
In case of restart: Interval, in
seconds, between retries in
re-scheduling a failed
process managed in restart.
Values: [120 ...14400]
Default. 480
Max Parall
Max. parallelism of
processes managed in restart
by the Event Manager.
Default 0 (i.e., no
parallelism limit)
Priority
Priority in scheduling the
event: 1-10. Default 5
Value
Description
Queue
Associated to specific
queues (default)
Any Queue
Associated to any queue
Time
Calendar specification (day,
week, month, year)
Event
Triggered by other event
Monitor
Starting with Queue
Manager
Click on the Advanced (Queue) tab.
The following table describes the fields of the Advanced (Queue) tab.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
276
EMAFTM089/03
Event Management
Field
Description/Values
Condition
Value
Description
Yes
Specify conditions
No
Do not specify conditions
Value
Description
File
File
Message
Message
Value
Description
Close
Output
End-of-writing. The event is to be
triggered when a message or file is
written on the Queue Manager.
Close
Input
End-of-reading. The event is to be
triggered when a message or file is
read from the Queue Manager.
Open
Output
Start-of-writing. The event is to be
triggered when a message or file
starts being written into the Queue
Manager.
Entry Type
File Flag
Correlation Id
This is an optional field composed of up to 24
characters containing the correlation identifier of
the message or file in question.
The event is validated when a file or message with
the specified Correlation Id is read or written from
or to the connected Queue Manager, according to
the value of OPEN/CLOSE field, if specified.
User Class
This optional field is composed of up to 4
characters containing the user class of the message
or file in question.
Sender
This is an optional field composed of up to 8
characters containing the sender of the message or
file in question.
The event is validated when a file or message sent
by the specified sender is read or written from/to
the connected Queue Manager, according to the
value of OPEN/ CLOSE field, if specified.
Queue Name
Queue name. The string can have up to 48
characters.
Address Type
Address type of the queue to which the message
or file in question belongs. Values:
Value
Description
S
SPAZIO
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
277
Event Management
Field
Description/Values
Q
SPAZIO Queue Manager
I
IBM MQSeries
M
Microsoft
L
Local automatic
R
Remote Automatic.
NOTE: the Validation type specified in the General Tab, has the effect
of changing the available parameters in the Advanced tab. Each
selection and its resulting Advanced tab is explained below.
Selecting Validation type as Any Queue displays the following Advanced
tab:
The following table describes the fields of the Advanced (AnyQueue) tab.
Field
Description/Values
Condition
Value
Description
Yes
Specify conditions
No
Do not specify conditions
Value
Description
File
File
Message
Message
Value
Description
Entry Type
File Flag
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
278
EMAFTM089/03
Event Management
Field
Correlation Id
Description/Values
Close
Output
End-of-writing. The event is to be
triggered when a message or file is
written on the Queue Manager
Close
Input
End-of-reading. The event is to be
triggered when a message or file is
read from the Queue Manager
Open
Output
Start-of-writing. The event is to be
triggered when a message or file starts
being written into the Queue Manager
This is an optional field composed of up to 24
characters containing the correlation identifier of
the message or file in question.
The event is validated when a file or message with
the specified Correlation Id is read or written from
or to the connected Queue Manager, according to
the value of OPEN/ CLOSE field, if specified.
User Class
This optional field is composed of up to 4
characters containing the user class of the message
or file in question.
Sender
This is an optional field composed of up to 8
characters containing the sender of the message or
file in question.
The event is validated when a file or message sent
by the specified sender is read or written from/to
the connected Queue Manager, according to the
value of OPEN/ CLOSE field, if specified.
Selecting Validation as Event displays the following Advanced tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
279
Event Management
The following table describes the fields of the Advanced (Event) tab.
This event is triggered by the following event, in case of abort:
Group Name
Event group name (char. 8). Default NONE
Event Name
Event name (char. 8). Default NONE
This event is triggered by the following event, in case of completion:
Group Name
Event group name (char. 8). Default NONE
Event Name
Event name (char. 8). Default NONE.
Selecting Validation as Time displays the following Advanced tab.
The following table describes the fields of the Advanced (Event) tab.
Field
Description / Values
Calendar Policy
Mandatory where ValidationType is 3 (Calendar
Specification). Select one of the following values:
Daily
Weekly
Monthly
Yearly
Day of Week Monthly
Day
Day of the week, month, year: 1-N . Default 1.
NOTE:
day of week - 1: Sunday, 2: Monday, ..., 7:
Saturday
day of month - 31: last day of month
day of year - 365 or 366: last day of year
Day Modifier
Enabled
Allows you to enable or disable the Day Modifier
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
280
EMAFTM089/03
Event Management
Field
Description / Values
If Day Modifier is enabled, you can select one of
the following values, excluding holidays:
No Sunday
No Saturday nor Sunday
Only Sunday
Only Saturday or Sunday
or select one of the following values, including
certain weeks of the month:
1st ... 4th Week of Month
Last Week of Month
6.3.2
Remove an Event Definition
There are two different ways to remove an Event Definition:
Select and Remove an Event Definition
1
Right-click on the event. The following pop-up menu appears:
2
Select Remove event definition
3
Click on Yes to confirm, No to abort the operation.
Remove an Event Definition by Name
1
Right-click on Static Event folder. The following pop-up menu appears:
2
Select Remove Event Definition.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
281
Event Management
6.3.3
3
Insert group name and event name.
4
Click on Remove to remove the event or Cancel to abort the operation.
Update an Event Definition
1
Select a particular Event Definition you wish to update.
2
Right click on the Event Definition or click Action in the menu Bar. The
following dialog box appears:
3
Select Update Event Definition….
The windows of the selected event appear and you can make your
changes. Refer to Section 6.3.1 for the relevant explanations.
4
6.3.4
Click OK to confirm the changes, Cancel to abort the operation.
Add a queue to an Event Definition
1
Select a particular Event Definition to which you want to add a new
Queue.
2
Right click on the Event Definition. The following dialog box appears:
3
Click on Add Queue….
5
Insert the queue details. Click Add to update the Event Definition.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
282
EMAFTM089/03
Event Management
6.3.5
6.3.6
Remove a queue from an Event Definition
1
Select a particular Event Definition from which you want to remove a
Queue.
2
Right click on the Event Definition. The following dialog box appears:
3
Click on Remove Queue.
6
Insert the details of the Queue to be removed.
7
If the queue is non-existent or cannot be removed the following dialog
box appears:
Lock and Unlock an Event Definition
1
Select a particular Event Definition you want to Lock.
2
Right click on the Event Definition. The following dialog box appears:
4
Select Lock or Unlock as required.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
283
Event Management
6.4
Event Instances
Instances of active events are listed in the Event Instances folder.
6.4.1
View the properties of an Event Instance
•
2
Click an Event Instance
A series of properties is displayed in the right panel of the workspace.
The following table describes the fields in the tab:
Field
Description / Values
Name
Event name
Group Name
Event group name
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
284
EMAFTM089/03
Event Management
Field
Description / Values
Status
Status
Value
Description
I
initial state, event created
Q
event queued, to become ready
R
restartable event, waiting to be
(re)activated in restart mode
A
restartable event, active in restart
mode
F
restartable event, aborted or failed
(max retry reached) to be deleted
C
event completed - to be deleted
Resulting
Parameters
Parameter line passed or sent via a SPOS
message.
Validation Type
Validation type.
Value
Description
1
Associated to specific queues
(default)
Associated to any queue
2
4
Calendar specification (day, week,
month, year)
Triggered by other event
5
Starting with Queue Manager
3
Queue Name
Queue Name
Address Type
Queue Address Type
User Class
User Class
Internal Number
Internal Number
Message/File ID
Message/File ID
Correlation ID
Correlation ID
Sender
Sender of the file
Ready to
schedule
Parameter that indicates whether the event is
ready to be scheduled.
Lock Status
Value
Description
1
If the value of the Policy parameter
is "immediate"
0
If the value of the Policy parameter
is "interval"
Lock Status (when locked, no event instance can
be activated)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
285
Event Management
6.4.2
Field
Description / Values
Session
Session
Max Retry
Maximum number of retries in re-scheduling a
failed process managed in restart
Retry Done
Number of retries done
Retry Interval
Interval, in seconds, between retries in rescheduling a failed process managed in restart
First Execution
Date
First Execution Date
First Execution
Time
First Execution Time
Last Execution
Date
Last Execution Date
Last Execution
Time
Last Execution Time
Return Code
Return Code
Reason Code
Reason Code
User Return Code
User Return Code.
Remove an Event Instance
1
Select a particular Event Instance which you want to remove.
2
Right click on the Event Instance and click on Remove.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
286
EMAFTM089/03
Chapter 7
Security Management
SPAZIO Management Console provides comprehensive security functionality
through highly configurable access rights to a range of SPAZIO objects at
various levels:
„
Login - access to the SPAZIO Management Console program itself is limited
to those users with appropriate access rights.
„
Nodes - at the top level, access rights for SPAZIO users can be configured
for each node in the network.
„
Queue Managers - access rights for SPAZIO users can be defined for
individual Queue Managers. At this level, you can also specify default
Queue and DQL permissions, which will be inherited by all Queues and
DQLs created under a specific Queue Manager.
„
Queues and DQLs - access rights for existing Queues and DQLs can be
modified.
NOTE: in order to perform security setting you must be part of the Spazio
Administrators group.
7.1
Access control for SPAZIO Management Console
Basic authentication is required in order to access SPAZIO Management
Console, whether you wish to perform security management or any other
operations (for example, those described in Chapter 6 of this manual).
In the absence of an authentication provider, SPAZIO MFT/S uses a filebased authentication plugin as an authentication provider.
For further details see AAA Security for Spazio MFT/S (A3SP): Installation,
Configuration and User's Guide.
7.1.1
Enable Access Control Security
If Access Control Security is disabled, you can enable it as follows:
1
Right-click on the Security Management folder. The following pop-up
menu appears:
2
Select Enabled Security. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
287
Security Management
3
Click OK.
4
The Access Control List folder appears under the Security Management
folder.
5
Click on Access Control List folder, the User and Group folders appear.
6
Now you can add User and Group (see Sections 7.1.4.1 and 7.1.4.5).
7
To activate the access control you have to click Apply and restart Spazio.
NOTE: If Access Control Access is disabled, the Access Control List folder
is not visible under the Security Management folder.
7.1.2
7.1.3
Disable Access Control Security
1
Right-click on the Access Control List folder. The following pop-up menu
appears:
2
Select Modify. The following dialog box appears:
3
Click on Advanced and set Enable Security false
4
To activate this change you have to click Apply and restart Spazio.
Modify Access Control Security
1
Right-click on the Access Control List folder.
2
Select Modify. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
288
EMAFTM089/03
Security Management
The following table explains the fields:
Field
Description / Values
Server Port
Port on which the A3SP Server is listening.
Trace Level
3
A3SP trace level
Value
Description
0
No trace
1
Minimal trace
2
Normal trace
3
Most detailed trace
If you click on Advanced, you can modify the other parameters:
The following table explains the fields:
Field
Description / Values
Enable Security
Define whether security is enabled or disabled.
Spazio Admin
Group
Value
Description
True
Security enabled
False
Security disabled
Defines the Spazio Security Administration
group.
Default: Spazio Administrators.
Spazio User
Group
Spazio MFT/S uses Spazio Administrators and
Spazio Users built-in groups for security
enforcement.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
289
Security Management
Field
Description / Values
This key allows to define a Spazio Administrators
alias name. If specified, in place of Spazio User
group, A3SP refers to the specified group name.
X509 username
Defines the X509 certificate field to be used as
username in the X509 authentication process. The
X509.username value is used for finding the
LDAP user entry on which the X509 credential
will be authenticated.
Validity
Timeout
Timeout in seconds
Database file
Define the internal database files pathname used
by A3SP. It can include environment variables
with the syntax %VAR%.
Must be unique for all Spazio MFT/S
installation.
Trace File
The absolute path name of trace file. It can include
environment variables with the syntax %VAR%.
Default: %SPAZIO%/trace/a3tk.trc
Trace File
Rolling
If enabled trace file rolling will be performed.
Trace Max
Rolling Files
Is the maximum size allowed for rolling files.
Default: true
Default: 10000KB
3
Click OK to modify the Access Control List or Cancel to abort the
operation.
4
To activate the change you have to click Apply and restart Spazio.
For more details about the fields see AAA Security for Spazio MFT/S (A3SP):
Installation, Configuration and User's Guide.
7.1.4
Users and Groups
When you start SPAZIO Management Console, you are requested for a User ID
and Password.
In the Access Control folder, SPAZIO Management Console allows to manage
users and groups on a file based authentication repository.
The possible actions on users and groups are as follows:
„
define / list / lock / unlock / reset /delete SPAZIO MFT/S user
accounts
„
define /list / remove users and groups on file based user repository
„
bind user to a group on file based repository.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
290
EMAFTM089/03
Security Management
If SPAZIO MFT/S is configured to use user repositories other than file based,
the security officer should use the user repository proprietary management
tools to perform users and group repository management.
NOTE: in order to access to the Access Control folder, you must be part of
the Spazio Administrators group.
NOTE: all the operations in the Access Control folder are dynamic, so it’s
not necessary to restart SPAZIO to apply them.
7.1.4.1 Spazio Users, Spazio Everyone and Spazio Administrators Groups
Default security configuration use the default file based authentication plugin
as authentication provider.
In the default repositories are defined:
„
Spazio Administrators group
„
Spazio Users group
„
Spazio Everyone group
If the Spazio Everyone group is defined, it is possible to connect to SPAZIO
without providing credentials, but if they are provided they will be verified.
If the Spazio Everyone group has been removed, when you start SPAZIO
Management Console, you are requested for a User ID and Password.
NOTE: it is not possible to delete the Spazio Administrators group or the
Spazio Users group.
NOTE: if at least one Administrator User is not present, it is not possible to
delete the Spazio Everyone group.
7.1.4.2 List Groups
1
Click on Security Management folder.
2
Click on Access Control List folder.
3
Click on Group folder.
4
Groups are listed under the Group folder and also in the right panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
291
Security Management
To see the group associated with a particular user, you have to:
5
Click on Security Management folder.
6
Click on Access Control List folder.
7
Click on User folder. The list of the users appears.
8
Click on the user. The group associated with the user is displayed in the
right panel.
7.1.4.3 List Users
To list the Users, you have to:
1
Click on Security Management folder.
2
Click on Access Control List folder.
3
Click on Users folder.
4
Users are listed under the User folder and also in the right panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
292
EMAFTM089/03
Security Management
To list Users belonging to a particular group, you have to:
1
Click on Security Management folder.
2
Click on Access Control List folder.
3
Click on Group folder. The list of the groups appears.
4
Select the group. Users belonging to this group are listed in the right
panel.
NOTE: users and groups are created dynamically without having to click
the Apply button.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
293
Security Management
7.1.4.4 Adding Groups
1
Click on the Security Management folder.
2
Click on the Access Control List folder.
3
Right-click on the Group folder. The following pop-up menu appears:
4
Select Add Group. The following dialog box appears:
5
Insert a name for the group.
6
Click Add to create the group or Cancel to abort the operation.
7.1.4.5 Adding Users
1
Click on the Security Management folder.
2
Click on the Access Control List folder.
3
Right-click on the User folder. The following pop-up menu appears:
4
Select Add User. The following dialog box appears:
5
Insert Username, Password and Password confirm.
6
Click OK to add the user or Cancel to abort the operation.
7.1.4.6 Binding Users to a Group
Each User must belong to a specific group. To bind a user to a group you
need to do the following:
1
Right-click on the user. The following pop-up menu appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
294
EMAFTM089/03
Security Management
2
Select Bind/Unbind group. The following screen containing a list of the
defined groups appears:
3
Select a group.
4
Click OK bind the user to the group or Cancel to abort the operation.
NOTE: if at least one other Administrator User is not present, it is not
possible to unbind Spazio Administrator group from a user.
7.1.4.7 Remove Users
1
Right-click on the user. The following pop-up menu appears:
2
Select Remove user…
3
The following dialog box appears:
4
Click Yes to delete the User, or No to abort the operation.
7.1.4.8 Remove Groups
1
Right-click on the group and select Remove group…
2
The following dialog box appears:
3
Click Yes to delete the User, or No to abort the operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
295
Security Management
7.1.4.9 Change password
7.1.5
1
Right-click on the user. The following pop-up menu appears:
2
Select Set password.
3
The following dialog box appears:
4
Insert Username, Password and Password Confirm.
5
Click OK to set password or Cancel to abort the operation.
Login procedure
1
Start SPAZIO Management Console.
2
Enter the required user name and password:
3
Click on OK.
NOTE: if you have checked the Always show login dialog box for the
connections option (see Section 2.1.1: General Options), your SPAZIO
Management Console will always begin with the Access Denied dialog box.
If you enter SPAZIO Management Console as an Administrator, SPAZIO allows
you to open all the folder in SPAZIO Management Console. If your account
doesn’t belong to the Spazio Administrator group, then you can manage only
Transmission Monitoring, File Management and Event Management folders. In
this case, when you open SPAZIO Management Console, the following screen
appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
296
EMAFTM089/03
Security Management
If the Spazio Everyone group is in the Group folder, you can enter SPAZIO
Management Console with blank user and blank password. In this case you can
manage all SPAZIO Management Console folders.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
297
Security Management
7.2
Node-level security
SPAZIO Management Console allows you to set and modify access rights for
the Node object. Section 7.2.1: Node permissions describes the various types of
access that can be specified for a Node. Sections 7.3.2 to 7.3.5 explain how to
associate specific permissions with user groups, how to modify these rights
and how to add/remove users or groups from the access list for a specific
Node.
7.2.1
Node permissions
As you will see later, SPAZIO Management Console lets you manipulate
security permissions at the level of individual access rights (through the
Special Access option), or by specifying pre-defined sets of rights (No Access,
Operator and Full Control options).
7.2.1.1 Table of access rights for Nodes
The following table lists the access rights that can be specified for Nodes:
Option
Code
Description
Set Node Properties
Sp
The user or group members can set the
properties of the Node.
Get Node Properties
Gp
The user or group members can read
the properties of the Node.
Get Node Objects
So
The user or group members can list the
objects on the Node (Queue Managers,
Queues etc.).
Set Node Objects
Go
The user or group members can set the
properties of objects on the Node
(Queue Managers, Queues etc.).
Delete Node Objects
Do
The user or group members can delete
objects on the Node.
Connect
C
The user or group members can
connect to the node.
Get Node
Permissions
Ge
The user or group members can read
permissions associated with the Node.
Change Node
Permissions
Ce
The user or group members can change
permissions associated with the Node.
Take Node Ownership
T
The user or group members can take
ownership of the node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
298
EMAFTM089/03
Security Management
7.2.1.2 Types of Node access
Four preset types of access are available for Nodes:
7.2.2
„
No Access - all access rights to the Node are disabled for a specific user or
group.
„
Full Control - all access rights to the Node are granted for a specific user
or group.
„
Operator - all access rights except Get Node Permissions, Set Node
Permissions and Take Node Ownership are granted for a specific user or
group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.2.1.1, or to specify Full Control, for a specific user or
group.
Changing access rights for groups
1
Right-click a node in the left panel of the screen and choose Security…
from the pop-up menu (or select a node in the left panel of the screen and
choose View - Security ... from the menu bar).
2
The Security screen appears:
3
The Name column contains a list of groups for which access rights to the
Node have been defined.
The Rights column specifies the access rights granted for each group,
either as an access type (for example, No Access) or as a string of
concatenated access codes (for example, SpGpSoGoDoC). These access
rights, codes and types are explained in sections 7.2.1.1 and 7.2.1.2 above).
4
Select a group from the list in the Name column.
5
Click the down-arrow in the Type of Access box and select the type of
access you want to grant to the group from the drop down menu (the
available options are explained in Section 7.2.1.2 above).
6
If you choose Special Access the following box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
299
Security Management
Choose either of the following:
7.2.3
‰
Full Control (all access rights are granted)
‰
Other (only those rights that you check are granted)
7
Click OK to proceed, or Cancel to cancel the operation. You now return to
the initial Security screen.
8
Click Apply to enforce the changes, or Cancel to cancel the operation.
Setting Groups’ access rights
1
Right-click a node in the left panel of the screen and choose Security…
from the pop-up menu (or select a node in the left panel of the screen and
choose View - Security ... from the menu bar).
2
The Security screen appears:
3
Click Add ...
4
The Add Users and Groups box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
300
EMAFTM089/03
Security Management
5
Select a group from the Names area.
6
To see a list of users belonging to the group, you can click the Show Users
button. The list appears in the Names area:
7
With relevant group selected, click Add.
8
The group now appears in the Add Names area.
9
Click the down-arrow in the Type of Access box and select the type of
access you want to grant to the group from the drop down menu (the
available options are explained in Section 7.2.1.2 above).
10 If you choose Special Access the following box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
301
Security Management
Choose either of the following:
‰
Full Control (all access rights are granted)
‰
Other (only those rights that you check are granted)
Click OK to proceed, or Cancel to cancel the operation. You now return to
the initial Add Users and Groups screen.
11 Click OK to enforce the changes, or Cancel to cancel the operation.
12 If you clicked OK, the group is now added with a specific set of access
rights.
7.2.4
Setting Users’ access rights
1
Right-click a node in the left panel of the screen and choose Security…
from the pop-up menu (or select a node in the left panel of the screen and
choose View - Security ... from the menu bar).
2
The Security screen appears:
3
Click Add.
4
The Add Users and Groups box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
302
EMAFTM089/03
Security Management
5
Select a group from the Names area and click Show Users.
6
The users belonging to the selected group are listed in the Names area:
7
Select a user and click Add.
8
The user now appears in the Add Names area.
9
Click the down-arrow in the Type of Access box and select the type of
access you want to grant to the user from the drop down menu (the
available options are explained in Section 7.2.1.2 above).
10 If you choose Special Access the following box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
303
Security Management
Choose either of the following:
‰
Full Control (all access rights are granted)
‰
Other (only those rights that you check are granted)
Click OK to proceed, or Cancel to cancel the operation. You now return to
the initial Add Users and Groups screen.
11 Click OK to enforce the changes, or Cancel to cancel the operation.
12 If you clicked OK, the user is now added with a specified set of access
rights.
7.2.5
Removing groups
1
Right-click a node in the left panel of the screen and choose Security…
from the pop-up menu (or select a node in the left panel of the screen and
choose View - Security ... from the menu bar).
2
The Security screen appears:
3
The Name column contains a list of groups for which access rights to the
Node have been defined.
4
Select a group from the list in the Name column.
5
Click the Remove button to remove the group from the list of groups with
access rights to the Node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
304
EMAFTM089/03
Security Management
7.3
Queue Manager-level security
At Queue Manager level, SPAZIO Management Console lets you manage access
to three security objects:
7.3.1
„
Queue Managers - you can set and change access rights for a given
Queue Manager
„
Queues (default) - by setting default permissions for queues, you are
specifying a series of security features that will be applied to all queues
created under the current Queue Manager.
„
DQLs (default) - by setting default permissions for DQLs, you are
specifying a series of security features that will be applied to all DQLs
created under the current Queue Manager.
Accessing Queue Manager security management
To perform Queue Manager security management:
1
Connect to a Queue Manager in the folder of File Management in the left
panel of the screen.
2
Right-click the Queue Manager and choose Security… from the pop-up
menu (or select the Queue Manager and choose View - Security ... from
the menu bar).
3
The Security Properties screen appears:
4
You can now choose one of the following sets of Queue Manager security
operations by clicking the relevant Permissions button:
‰
View or set permissions for the Queue Manager (Permissions) - see
Section 7.3.2 for details.
‰
View or set default permissions for the Queues belonging to the
Queue Manager (Default Queue Permissions) - see Section 7.3.3 for
details.
‰
View or set default permissions for the DQLs belonging to the Queue
Manager (Default DQL Permissions) - see Section 7.3.4 for details.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
305
Security Management
7.3.2
Queue Manager permissions
The following sections list the various access rights and access types (groups
of access rights) that can be associated with Queue Managers.
Setting for Queue Managers is performed in the same way as it is for Nodes
(see Sections 7.2.2 to 7.2.5).
7.3.2.1 Table of access rights for Queue Managers
The following table lists the access rights that can be specified for Queue
Managers:
7.3.2.2
Option
Code
Description
Set Queue Manager
Properties
Sp
The user or group members can set
the properties of the Queue Manager.
Get Queue Manager
Properties
Gp
The user or group members can read
the properties of the Queue Manager.
Create Queue
Cq
The user or group members can create
Queues under the Queue Manager.
Create DQL
Cd
The user or group members can create
DQLs under the Queue Manager.
Create User Class
Cu
The user or group members can create
User Classes under the Queue
Manager.
Connect
C
The user or group members can
connect to the Queue Manager.
Get Queue Manager
Permissions
Ge
The user or group members can read
permissions associated with the
Queue Manager.
Change Queue Manager
Permissions
Ce
The user or group members can
change permissions associated with
the Queue Manager.
Take Queue Manager
Ownership
T
The user or group members take
ownership of the Queue Manager.
Types of Queue Manager access
Four preset types of access are available for Queue Managers:
„
No Access - all access rights to the Queue Manager are disabled for a
specific user or group.
„
Full Control - all access rights to the Queue Manager are granted for a
specific user or group.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
306
EMAFTM089/03
Security Management
7.3.3
„
Read - Connect and Get Queue Manager Properties rights are granted for a
specific user or group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.3.2.1, or to specify Full Control, for a specific user or
group.
Default Queue permissions
The following sections list the various access rights and access types (groups
of access rights) that can be set as defaults for Queues belonging to a given
Queue Manager.
Setting default permissions for Queues is performed in the same way as it is
for Nodes (see Sections 7.2.2 to 7.2.5).
7.3.3.1 Table of access rights for Queues
The following table lists the access rights that can be specified as defaults for
Queues:
Option
Code
Description
Delete Data Object
Do
The user or group members can delete
files or messages from Queues.
Peek Data Object
Po
The user or group members can read
files or messages in Queues (without
removing them).
Write Data Object
Wo
The user or group members can put
files or messages in Queues.
Set Queue Properties
Sp
The user or group members can set
the properties of Queues.
Get Queue Properties
Gp
The user or group members can read
the properties of Queues.
Delete Queue
D
The user or group members can delete
Queues.
Get Queue
Permissions
Ge
The user or group members can read
the permissions associated with
Queues.
Change Queue
Permissions
Ce
The user or group members can
change permissions associated with
Queues.
Take Queue Ownership
T
The user or group members can take
ownership of Queues.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
307
Security Management
7.3.3.2 Types of default Queue access
Five preset types of access may be specified as the default type of access for
Queues belonging to a particular Queue Manager:
7.3.4
„
No Access - all access rights to the Queue are disabled for a specific user
or group.
„
Full Control - all access rights to the Queue are granted for a specific user
or group.
„
Insert - Write Data Object and Get Queue Properties rights are granted for a
specific user or group.
„
Receive - Delete Data Object, Peek Data Object, Write Data Object and Get
Queue Properties rights are granted for a specific user or group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.3.3.1, or to specify Full Control, for a specific user or
group.
Default DQL permissions
The following sections list the various access rights and access types (groups
of access rights) that can be set as defaults for DQLs belonging to a given
Queue Manager.
Setting default permissions for DQLs is performed in the same way as it is for
Nodes (see Sections 7.2.2 to 7.2.5).
7.3.4.1 Table of access rights for DQLs
The following table lists the access rights that can be specified as defaults for
DQLs:
Option
Code
Description
Write Data Object
Wo
The user or group members can write
messages or files to DQLs.
Set DQL Properties
Sp
The user or group members can set
the properties of DQLs.
Get DQL Properties
Gp
The user or group members can read
the properties of DQLs.
Delete DQL
D
The user or group members can delete
DQLs.
Get DQL Permissions
Ge
The user or group members can read
the permissions associated with
DQLs.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
308
EMAFTM089/03
Security Management
Option
Code
Description
Change DQL
Permissions
Ce
The user or group members can
change permissions associated with
DQLs.
Take DQL Ownership
T
The user or group members can take
ownership of DQLs.
7.3.4.2 Types of default DQL access
Four preset types of access may be specified as the default type of access for
DQL belonging to a particular Queue Manager:
7.4
„
No Access - all access rights to the DQL are disabled for a specific user or
group.
„
Full Control - all access rights to the DQL are granted for a specific user
or group.
„
Insert - Write Data Object and Get Queue Properties rights are granted for a
specific user or group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.3.4.1, or to specify Full Control, for a specific user or
group.
Queue and DQL-level security
SPAZIO Management Console allows you to modify access rights for
individual Queues and DQLs under a Queue Manager.
Section 7.4.1: Queue permissions describes the various types of access that can
be specified for a Queue.
Section 7.4.2: DQL permissions describes the various types of access that can be
specified for a DQL.
NOTE: security options can not be specified for Queues or DQLs at
creation time. Instead, each Queue or DQL created assumes the default
permissions associated with its Queue Manager (see Sections 7.3.3 and
7.3.4).
7.4.1
Queue permissions
The following sections list the various access rights and access types (groups
of access rights) that can be associated with Queues.
Setting permissions for Queues is performed in the same way as it is for
Nodes (see Sections 7.2.2 to 7.2.5).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
309
Security Management
7.4.1.1
Table of access rights for Queues
The following table lists the access rights that can be specified for Queues:
7.4.1.2
Option
Code
Description
Delete Data Object
Do
The user or group members can delete
files or messages from the Queue.
Peek Data Object
Po
The user or group members can read
files or messages in the Queue
(without removing them).
Write Data Object
Wo
The user or group members can put
files or messages in the Queue.
Set Queue Properties
Sp
The user or group members can set
the properties of the Queue.
Get Queue Properties
Gp
The user or group members can read
the properties of the Queue.
Delete Queue
D
The user or group members can delete
the Queue.
Get Queue
Permissions
Ge
The user or group members can read
the permissions associated with the
Queue.
Change Queue
Permissions
Ce
The user or group members can
change permissions associated with
the queue.
Take Queue Ownership
T
The user or group members can take
ownership of the Queue.
Types of Queue access
Five preset types of access may be specified for a Queue:
„
No Access - all access rights to the Queue are disabled for a specific user
or group.
„
Full Control - all access rights to the Queue are granted for a specific user
or group.
„
Insert - Write Data Object and Get Queue Properties rights are granted for a
specific user or group.
„
Receive - Delete Data Object, Peek Data Object, Write Data Object and Get
Queue Properties rights are granted for a specific user or group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.4.1.1, or to specify Full Control, for a specific user or
group.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
310
EMAFTM089/03
Security Management
7.4.2
DQL permissions
The following sections list the various access rights and access types (groups
of access rights) that can be associated with DQLs.
Setting permissions for DQLs is performed in the same way as it is for Nodes
(see Sections 7.2.2 to 7.2.5).
7.4.2.1 Table of access rights for DQLs
The following table lists the access rights that can be specified for DQLs:
Option
Code
Description
Write Data Object
Wo
The user or group members can write
messages or files to the DQL.
Set DQL Properties
Sp
The user or group members can set
the properties of the DQL.
Get DQL Properties
Gp
The user or group members can read
the properties of the DQL.
Delete DQL
D
The user or group members can delete
the DQL.
Get DQL Permissions
Ge
The user or group members can read
the permissions associated with the
DQL.
Change DQL
Permissions
Ce
The user or group members can
change permissions associated with
the DQL.
Take DQL Ownership
T
The user or group members can take
ownership of the DQL.
7.4.2.2 Types of DQL access
Four preset types of access may be specified for DQLs:
„
No Access - all access rights to the DQL are disabled for a specific user or
group.
„
Full Control - all access rights to the DQL are granted for a specific user
or group.
„
Insert - Write Data Object and Get Queue Properties rights are granted for a
specific user or group.
„
Special Access - allows you to grant one or more of the access rights
specified in Section 7.4.2.1, or to specify Full Control, for a specific user or
group.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
311
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
312
EMAFTM089/03
Chapter 8
8.1
Log Management
Introduction
Log Management folder allows you to view details of any active or inactive
Spazio session.
8.2
8.2.1
Log Management Folder
Toolbar
This bar contains a number of buttons that provide point-and-click access to
most Log Management operations. The following table describes the function
of each button and the equivalent menu command:
Button
8.3
Function
Menu Command
Connect to a Local or Remote node
Action – Connect to node
Filter
Action – View - Filter
Refresh
None
Session Detail
None
Log Management Options
You can customize your Log Management session through a series of usermodifiable options. To access these options, choose View menu.
By clicking Log Management Options, the following appears, that contains
the Color options for the current node:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
313
Log Management
This tab contains the following options:
Item
Description
Failed Session
Change the font color of a failed Session
Failed Operation
Change the font color of a failed operation
After you have modified any fields in the this tab, click Apply and then OK
to enforce the changes.
If you wish to exit the operation without applying the changes, click Cancel.
8.4
Extended Log View
This function lets you view session properties associated with a particular
session. To view session properties:
1
Select the Log Management folder.
2
This displays a list of Sessions in the panel
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
314
EMAFTM089/03
Log Management
8.4.1
View Details of a Session
To view the details of a particular session, complete the step described in
section 8.3 Extended Log View.
1
Select from the session you wish to view from the right panel; below
The following table describes the properties listed:
Property
Description
Session Id
Session ID
Level
Session Class
RecClass
Record Class
Family
Product family
ElabCode
Elaboration Code
RecCode
Record Code
Date
Connection Date
Time
Connection Time
TimeZone
Time
CC
Completion code
RC
Return code
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
315
Log Management
Property
Description
SetId
Character set. Platform-dependent value:
Value
ASCII
EBCDIC
UNICODE
2
Encoding
Integer Encoding
CurVersion
Current Spazio version
RecLen
Length of application log record (prefix included)
ExtRecLen
Extended Record Length
To view the details of the session go to the View menu and select Details.
Alternatively view the session by clicking on the Details icon provided on
the Log Manager toolbar
The following window is displayed, to display more session properties
click Next:
This table contains the following fields
Property
Description
CodedcharSetId
Code character set ID
Encoding
Integer Encoding
DataRecLength
Data record length
Date
Current Date
Family
Product Family
Level
Session Level
Class
Session Class
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
316
EMAFTM089/03
Log Management
8.4.2
Property
Description
SessionId
Session ID
Elaboration Code
Session elaboration code
Record Type
Record type
Version
Application version
CC
Completion Code
RC
Reason Code
Obj Handle
Object handle
File Handle
File handle
Options
Session Options
Q_Manager
Current Queue Manger
SessionId
Session ID
Group Name
Group Name
User Id
User ID
Original Q_Manager
Original Session Queue Manger
Processing Code
Processing code
Transid
Transport ID
Node Name\IP
Address
Node IP address
Apply a filter to Session List
The Log Management folder allows log sessions to be filtered according to
numerous criteria.
To apply a session filter you must select from the Filter option from the View
menu. Alternatively select the Filter button from the toolbar.
The following window is displayed
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
317
Log Management
The first tab in the Options dialog box contains the following options for
filtering Sessions.
Property
Description
Period
Value
Description
Start Date
Session Start Date
End Date
Session End Date
Start Time
Session Start Time
End Time
Session End Time
Value
Description
All
Filter using all completion codes
(default)
OK
Filter using completion code OK
Not OK
Filter using Completion code Not
OK
Completion
Code
SessionId
Filter using session ID
Max Items
Filter using the Max number of items in a Session
Elaboration
Code
Filter using a Session elaboration Code
External Token
Filter using a specified External Token
The second tab in the Filter dialog box contains the Elaboration Type
options for filtering:
This allows you to filter using the following Elaboration Types.
„
All System Applications (no expiry)
„
All System Applications (with expiry)
„
All File System applications
„
Routers System Applications
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
318
EMAFTM089/03
Log Management
„
Acquirers System Applications
„
SP10 without MLIST
„
All Administration Applications
„
All Message Transfer System Applications
„
External File Transfer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
319
Log Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
320
EMAFTM089/03
Appendix A
Communication Lines
The sections below describe the operations that you can perform on
Communication Lines belonging to a node using SPAZIO Management
Console.
A.1
List communication Lines
1
Click on Action. The following pop-up menu appears:
2
Select Lines Management. The following screen appears:
The communication lines are listed in the left panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
321
Communication Lines
A.2
View the properties of a Communication Line
1
Click on a communication line in the left panel of the workspace.
2
The properties of the selected line are displayed in the right panel:
The following table explains the communication line properties:
Property
Description / Values
Name
Symbolic name of the Communication Line.
Type
Physical connection type of SPAZIO driver:
Active
Whether or not the line is currently active:
Direction
Value
Description
True
The line is active.
False
The line is not active.
Direction of communication:
Value
Description
I
Input only
O
Output only
A
Input and output
Status
Status of the communication line
Startup Mode
Start-up options.
Trace Level
Value
Description
1
Manual
2
Automatic
Trace level for the Communication Line:
Value
Description
0
No trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
322
EMAFTM089/03
Communication Lines
Property
A.3
A.4
Description / Values
1
Minimal trace
2
Normal trace
3
Most detailed trace
Timeout
Timeout in seconds (for inbound connection).
Max Conversations
Maximum number of conversations on the
line.
Max Input
Conversations
Maximum number of outgoing conversations
on the line.
Max Output
Conversations
Maximum number of incoming conversations
on the line.
Num Active
Conversations
Number of active conversations on the line.
Num Active Input
Conversations
Number of active incoming conversations on
the line.
Num Active Output
Conversations
Number of active outgoing conversations on
the line.
Param
Port values.
Activate an inactive Communication Line
1
Right-click on a communication line in the left panel of the workspace.
The following pop-up menu appears:
2
Select Activate.
Deactivate an active Communication Line
1
Right-click on a communication line in the left panel of the workspace.
The following pop-up menu appears:
2
Select Deactivate.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
323
Communication Lines
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
324
EMAFTM089/03
Appendix B
Transport Class Management
In the Transport Class Management, SPAZIO Management Console allows to
manage Transport Definitions and Transport Classes.
B.1
View and Set Transport Definitions
1
Choose Action – Transport Class Management.
2
Click the Transport Class folder in the left of the workspace.
3
The Transport Definitions are listed in the right panel
4
Click on Modify on the toolbar. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
File Transport
Agent Number
Maximum number of File Transport Agents
managed by the Transport Monitor.
Message Transport
Agent Number
Maximum number of Message Transport
Agents managed by the Transport Monitor.
Startup
Start-up mode for the Transport Monitor
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
325
Transport Class Management
Field
Description / Values
Value
Description
1
Manual
2
Automatic
Default: 2
Specifies, for each state, the time (expressed in
hours) after which SPAZIO will delete the
restart record.
Restart Record
Clean
Value
Description
Transfer
Completed
Minimum: 1
Maximum: 168
Default: 1
Transfer
failed
Minimum: 1
Maximum: 720
Default: 168
Transfer
completed
not closed
Minimum: 1
Maximum: 168
Default: 1
Transfer
cancelled
Minimum: 0
Maximum:48
Default: 1
To insert the fields click on the
icon.
This parameter overrides the parameters
Output Transmission File Clean and Input
Transmission File Clean (see Advanced
Parameter List)
5
Fill in the relevant fields.
6
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
326
EMAFTM089/03
Transport Class Management
The following table explains the fields in the tab:
Field
Description / Values
Trace
Trace Level
Check Interval
Value
Description
0
Default . No trace
1
Minimal trace
2
Normal trace
3
Detailed trace
Interval between internal check activities.
Value
Description
0
Normal (120 seconds)
1
Short (60 seconds)
2
Long (300 seconds)
Default: 0
Output
Transmission File
Clean
Directions for the cleaning of output
transmission files in state completed or
failed.
Value
Description
0
No Clean
1
Clean only first time
2
Repeated clean
Default: 0
Input
Transmission File
Clean
Directions for the cleaning of input
transmission files in state completed or
failed, when possible.
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
327
Transport Class Management
Field
Description / Values
0
No Clean
1
Clean only first time
2
Repeated clean
Default: 0
File Clean
Interval
Interval, expressed in hours, between
consecutive file cleaning cycles for files in
transmission and reception.
Default: 3
B.2
5
Click OK to modify the properties or Cancel to abort the operation.
6
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
Transport Class
When you create a remote queue, that is, a queue that has an associated
destination queue, you can choose a transport class for the queue.
The transport class specifies the type of transport, for message and files, that
will be used to transport files and messages from the sender queue to the
destination one. Moreover, the transport class specifies the parameters that
the transport monitor and the transport will use to manage transfer from the
queue in question.
The sections below describe how you can use SPAZIO Management Console to
perform operation on Transport Classes defined on the current node.
B.2.1
View a Transport Class
1
Choose Action – Transport Class Management.
2
The Transport Protocols defined on the current node are displayed in the
left panel:
3
Click a Transport Protocol in the left panel of the workspace.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
328
EMAFTM089/03
Transport Class Management
4
The Transport Classes associated with this Transport Protocol are
displayed in the left panel.
5
Click a transport class in the left panel of the workspace.
The properties of the selected class are displayed in the right panel.
B.2.2
Add a Transport Class
Several transport protocols can be used:
„
SPAZIO protocol (PR4)
This is the native SPAZIO protocol to transfer a file to a SPAZIO Server:
„
‰
FPR4 is the code name for the PR4 file transport
‰
MPR4 is the code name for the PR4 message transport
FTP protocol
Protocol to transfer a file to an FTP Server:
‰
„
FFTP is the code name for the master file transport
FTPS protocol
Protocol to transfer a file to an FTPS Server:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
329
Transport Class Management
‰
„
FTPS is the code name for the master file transport
STPS protocol
Protocol to transfer a file to an SFTP Server:
‰
„
SFTP is the code name for the master file transport
PESIT protocol
Protocol to transfer a file to a PESIT Server:
‰
B.2.2.1
PSIT is the code name for the master file transport
Add a PR4 Transport Class
1
Choose Action – Transport Class Management
2
Click on Add on the toolbar.
3
Select FPR4 Class. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Class Name
Class name.
Maximum 8 characters.
Description
Description of the class.
File Transport
Agent Name
File Transport Agent Name (Fix value FPR4).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
330
EMAFTM089/03
Transport Class Management
Field
Description / Values
File Transport
Parallelism
File Transport parallelism on a single queue.
Range: [1-4]. Default: 1.
File Transport
Parameter
The Parameter attribute contains:
Leave file
Value
Description
ON
Do not delete the file after a
successful transfer.
OFF
Delete the file after a
successful transfer (Default)
Queue
Parallelism
Max. parallel file transports
on the remote queue.
Range:[ 0-256]
Default: 1
Event on
completion
Name of event to fire on
completion.
Group Event
on
completion
Group of event to fire on
completion.
Event on
failure
Name of event to fire on
failure.
Group Event
on failure
Group of event to fire on
failure.
Write
Statitics
Enable writing file transfer
statistics on file
STR_FTRA_STAT.log
Value
Description
ON
Enable
OFF
Disable (Default)
Compress
block
Enable block compression
during transmission
Value
Description
ON
Enable
OFF
Disable (Default)
To insert the fields click on the
icon.
Message transport
Agent Name
Message Transport Agent Name (Fix Value
MPR4).
Message Transport
Parallelism
Message Transport parallelism on a single
queue. Range: [1-4]. Default: 1.
Message Transport
Parameter
The Parameter attribute contains:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
331
Transport Class Management
Field
Description / Values
Message
Timeout
Get message Timeout.
Queue
Parallelism
Max. parallel message
transports on the remote
queue.
Range: [ 0-32].
Default:1
Default:0
To insert the fields click on the
Queue
Parallelism
icon.
Max. parallel message
transports on the remote
queue.
Range: [ 0-32].
Default:1
4
Fill in the relevant fields.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Retry number
Number of retries permitted.
Retry interval
Interval specified between retries.
Policy
Scheduling policy:
Value
Description
0
Immediate delivery
1
Delivery within specified
interval
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
332
EMAFTM089/03
Transport Class Management
Field
Hour begin
interval
Minute begin
interval
B.2.2.2
Description / Values
Hour of interval start.
Range: [0 - 23]
Minute of interval start.
Range: [0 - 59]
Hour end interval
Hour of interval end.
Range: [0 - 23]
Minute end
interval
SyncLevel
Minute of interval end
Range: [0 - 59]
Number of blocks (in case of files) or number of
messages before requesting a Sync (ACK1) by
the Transport Agent.
Default: 10
Transport Agent
timeout
Timeout for Transport Agents.
6
Click OK to create the class or Cancel to abort the operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
Add a FTP Transport Class
1
Choose Action – Transport Class Management.
2
Click on Add on the toolbar .
3
Select FFTP Class. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
333
Transport Class Management
The following table explains the fields in the tab:
Field
Description / Values
Class Name
Class name.
Maximum 8 characters.
Description
Description of the class.
File Transport
Agent Name
File Transport Agent Name. (Fix Value FFTP)
File Transport
Parallelism
File Transport parallelism on a single queue.
Range: [1-4]. Default: 1
File Transport
Parameter
The Parameter attribute contains:
Leave file
Value
Description
ON
Do not delete the file after a
successful transfer.
OFF
Delete the file after a
successful transfer (Default)
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
Event on
completion
Name of event to fire
on completion.
Group Event on
completion
Group of event to fire
on completion.
Event on failure
Name of event to fire
on failure.
Group Event on
failure
Group of event to fire
on failure.
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
To insert the fields click on the
icon.
4
Fill in the relevant fields.
5
If you click on Advanced, you can modify the other parameters:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
334
EMAFTM089/03
Transport Class Management
The following table explains the fields in the tab:
Field
Description / Values
Retry number
Number of retries permitted.
Retry interval
Interval specified between retries.
Policy
Scheduling policy:
Value
Description
0
Immediate delivery
Delivery within specified
interval
Hour of interval start.
Range: [0 - 23]
Minute of interval start.
Range: [0 - 59]
1
Hour begin
interval
Minute begin
interval
Hour end interval
Hour of interval end.
Range: [0 - 23]
Minute end
interval
Minute of interval end
Range: [0 - 59]
6
Click OK to create the class or Cancel to abort the operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
335
Transport Class Management
B.2.2.3
Add a FTPS Transport Class
1
Choose Action – Transport Class Management.
2
Click on Add on the toolbar .
3
Select FTPS Class. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Class Name
Class name.
Maximum 8 characters.
Description
Description of the class.
File Transport
Agent Name
File Transport Agent Name. (Fix Value FTPS)
File Transport
Parallelism
File Transport parallelism on a single queue.
Range: [1-4]. Default: 1
File Transport
Parameter
The Parameter attribute contains:
Leave file
Value
Description
ON
Do not delete the file after a
successful transfer.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
336
EMAFTM089/03
Transport Class Management
Field
Description / Values
OFF
Delete the file after a
successful transfer (Default)
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
Event on
completion
Name of event to fire
on completion.
Group Event on
completion
Group of event to fire
on completion.
Event on failure
Name of event to fire
on failure.
Group Event on
failure
Group of event to fire
on failure.
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
To insert the fields click on the
icon.
4
Fill in the relevant fields.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
337
Transport Class Management
Field
Description / Values
Retry number
Number of retries permitted.
Retry interval
Interval specified between retries.
Policy
Scheduling policy:
Value
Description
0
Immediate delivery
Delivery within specified
interval
Hour of interval start.
Range: [0 - 23]
Minute of interval start.
Range: [0 - 59]
1
Hour begin
interval
Minute begin
interval
B.2.2.4
Hour end interval
Hour of interval end.
Range: [0 - 23]
Minute end
interval
Minute of interval end
Range: [0 - 59]
6
Click OK to create the class or Cancel to abort the operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
Add a SFTP Transport Class
1
Choose Action – Transport Class Management
2
Click on Add on the toolbar.
3
Select SFTP Class. The following dialog box appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
338
EMAFTM089/03
Transport Class Management
The following table explains the fields in the tab:
Field
Description / Values
Class Name
Class name.
Maximum 8 characters.
Description
Description of the class.
File Transport
Agent Name
File Transport Agent Name. (Fix Value SFTP)
File Transport
Parallelism
File Transport parallelism on a single queue.
Range: [1-4]. Default: 1
File Transport
Parameter
The Parameter attribute contains:
Leave file
Value
Description
ON
Do not delete the file after a
successful transfer.
OFF
Delete the file after a
successful transfer (Default)
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
Event on
completion
Name of event to fire
on completion.
Group Event on
completion
Group of event to fire
on completion.
Event on failure
Name of event to fire
on failure.
Group Event on
failure
Group of event to fire
on failure.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
339
Transport Class Management
Field
Description / Values
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
Queue
Parallelism
To insert the fields click on the
icon.
4
Fill in the relevant fields.
5
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
Field
Description / Values
Retry number
Number of retries permitted.
Retry interval
Interval specified between retries.
Policy
Scheduling policy::
Value
Description
0
Immediate delivery
Delivery within specified
interval
Hour of interval start.
Range: [0 - 23]
Minute of interval start.
Range: [0 - 59]
1
Hour begin
interval
Minute begin
interval
Hour end interval
Hour of interval end.
Range: [0 - 23]
Minute end
interval
Minute of interval end
Range: [0 - 59]
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
340
EMAFTM089/03
Transport Class Management
B.2.2.5
6
Click OK to create the class or Cancel to abort the operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
Add a PESIT Transport Class
1
Choose Action – Transport Class Management
2
Click on Add on the toolbar.
3
Select PSIT Class. The following dialog box appears:
The following table explains the fields in the tab:
Field
Description / Values
Class Name
Class name.
Maximum 8 characters.
Description
Description of the class.
File Transport
Agent Name
File Transport Agent Name. (Fix Value PSIT)
File Transport
Parallelism
File Transport parallelism on a single queue.
Range: [1-4]. Default: 1
Note: for FIFO policy for files, FParallTr = 1
File Transport
Parameter
The Parameter attribute contains:
Leave file
Value
Description
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
341
Transport Class Management
Field
Description / Values
ON
Do not delete the file after a
successful transfer.
OFF
Delete the file after a
successful transfer (Default)
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
Event on
completion
Name of event to fire
on completion.
Group Event on
completion
Group of event to fire
on completion.
Event on failure
Name of event to fire
on failure.
Group Event on
failure
Group of event to fire
on failure.
Queue
Parallelism
Max. parallel file
transports on the
remote queue.
Range:[ 0-256]
Default: 1
To insert the fields click on the
icon.
3
Fill in the relevant fields.
4
If you click on Advanced, you can modify the other parameters:
The following table explains the fields in the tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
342
EMAFTM089/03
Transport Class Management
Field
Description / Values
Retry number
Number of retries permitted.
Retry interval
Interval specified between retries.
Policy
Scheduling policy:
Value
Description
0
Immediate delivery
Delivery within specified
interval
Hour of interval start.
Range: [0 - 23]
Minute of interval start.
Range: [0 - 59]
1
Hour begin
interval
Minute begin
interval
B.2.3
Hour end interval
Hour of interval end.
Range: [0 - 23]
Minute end
interval
Minute of interval end
Range: [0 - 59]
6
Click OK to create the class or Cancel to abort the operation.
7
To activate this configuration you have to click Apply at the bottom left of
the window and restart Spazio.
Modify a Transport Class
1
Click on the transport class you want to modify
2
Click on Modify on the toolbar
The window of the selected class appears and you can make your changes
(see from Section B.2.2.1to B.2.2.5 for the transport class fields).
3
B.2.4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
Remove a Transport Class
1
Click on the transport class you want to delete
2
Click on Delete on the toolbar. The following screen appears:
3
Click Yes to delete the class, or No to abort the operation.
4
To activate this change you have to click Apply at the bottom left of the
window and restart Spazio.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
343
Transport Class Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
344
EMAFTM089/03
Appendix C
Typical Configuration
This chapter explains some common SPAZIO MFT/S configurations:
„
SPAZIO as Client using PR4 (see section 3.3.4)
„
SPAZIO as FTP Client (see section 3.3.1)
„
SPAZIO as FTP Server (see section 3.4.2)
For more details see Chapter 3 of this manual and SPAZIO MFT/S for
Distributed Platforms: Installation and Configuration Guide.
You wish to configure the following scenario:
C.1
Spazio as Client using PR4
In order to send a file to a SPAZIO node, you need to:
„
Configure a Remote SPAZIO Site of type ISCL.
„
Define a remote queue to the Remote SPAZIO Site.
„
Dispatch the file to the remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
345
Typical Configuration
C.1.1
Configuration of a SPAZIO Remote Node of the ISCL type
To configure a SPAZIO Remote Node of the ISCL type simply perform the
following steps:
1
Click on the Network Manager folder.
2
Click on the Sites folder.
3
Right click on the Remote Site folder.
4
Select Add SPAZIO Site and ISCL Node.
5
Insert the node name LNXNODE and click Next.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
346
EMAFTM089/03
Typical Configuration
6
Insert the Queue Manager name LNXQM and click Next.
7
If there are no ISCL lines, you need to insert values in the following fields:
‰
Name: ISCL3
‰
Startup: 2
‰
Trace: 0
‰
TimeOut: 300
‰
Direction: A
‰
Parameters: click on the
button to insert:
Protocol: TCP
Local Port: 6002
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
347
Typical Configuration
8
9
If there is at least one ISCL line, the values you need to insert are the
following:
‰
Line Name: click on the
‰
Time out: 120
button to select the ISCL line
To insert the Address, click on the
‰
Address: 192.168.160.343
‰
Remote Port: 6023
button. Insert:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
348
EMAFTM089/03
Typical Configuration
10 Click OK.
11 Click OK. At this point the creation is complete and the SPAZIO Remote
node is listed in the Remote Site folder:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
349
Typical Configuration
C.1.2
Creating a remote queue
To define a remote queue to the Remote SPAZIO Site, proceed as follows:
1
Click on the File Management folder
2
Right-click on the Queue Manager and select Connect
3
Right-click on the Queue folder and select Create Queue
4
Insert the Queue Name and select Remote as the Queue Type.
Insert the parameters related to the Remote Queue Manager and the
remote queue and click OK.
5
C.1.3
The new remote queue now appears in the Queues folder.
Dispatching a file
It is now possible to send a file to the SPAZIO remote node that we have
just configured. Simply right-click on the remote queue and select
Dispatch.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
350
EMAFTM089/03
Typical Configuration
C.2
SPAZIO as FTP/S Server
To configure a FTP/S Server, simply carry out the following steps:
1
Click on the Network Manager folder
2
Click on the Server Connection folder
3
Right click on the FTPS folder and select Add FTPS Server
4
Insert the value for the following parameters:
‰
Listening Address: 0.0.0.0
‰
Listening Port: 2122
‰
Session Timeout Sec: 180
5
Click Next.
6
Click on the
button to insert a value for ClientAuth and
ServerHostMatch.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
351
Typical Configuration
7
C.3
Click OK. The creation is complete and the Server is listed in the Server
Connection folder:
SPAZIO as FTP/S Client
To configure an FTP/S Master, simply carry out the following steps:
1
Click on the Network Manager folder.
2
Click on the Site folder.
3
Right click on the Remote Site folder and select Add FTPS Site and
Master.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
352
EMAFTM089/03
Typical Configuration
4
Insert the Node Name: SRVFTPS and click Next.
5
Insert the values for the following parameters:
‰
Hostname: 192.168.2.107
‰
Port: 22
‰
User: ftpuser
‰
InitialDir: blank
‰
FileName: ${ORIGNAME}${INTNUM}${DOTORIGEXT}
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
353
Typical Configuration
6
To insert the password click the
7
Click OK and Next.
8
Click Yes if you want to confirm creation, allowing the password to be
saved in Password Database.
button.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
354
EMAFTM089/03
Typical Configuration
9
Click on the
button to insert a value for ClientAuth and
ServerHostMatch.
10 Click OK. Creation is now complete and the FTP/S Master is listed in the
Remote Site folder:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
EMAFTM089/03
355
Typical Configuration
To create a remote queue and to send a file to the FTP/S site that has just
been created, see Sections B.1.2 and B.1.3.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: Management Console Guide
356
EMAFTM089/03
Download
Related flashcards
Create Flashcards