Download SPAZIO MFTS DistPlatf v2.5 SysAdminGuide...
SPAZIO MFT/S for Distributed Platforms System Administrator's Guide Version 2 Release 5
EMAFTM082/01 - September 2010
SPAZIO MFT/S for Distributed Platforms System Administrator’s Guide
Date of issue
Reference number
Brief description
September 2010
EMAFTM082/01
First edition - ver. 2.5
Copyright © 2010 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
Contents
Contents About this Manual Purpose Reader Area Covered Recommended Use Related Publications Limitations Conventions Chapter 1 SPAZIO Administrator: Getting Started 1.3 Opening SPAZIO Administrator 1.4 The SPAZIO Administrator Interface 1.4.1 Title Bar 1.4.2 Menu Bar and Drop-down Menus 1.4.3 Toolbar 1.4.4 Workspace 1.4.5 Status Bar 1.5 Closing SPAZIO Administrator
i iv iv iv iv v v vi vii 1 1 3 3 3 6 6 8 8
Chapter 2 Using SPAZIO Administrator 2.1 Introduction 2.1.1 Local node administration 2.1.2 Remote node administration 2.2 Notes on Using SPAZIO Administrator 2.2.1 A note for users who are new to Windows 2.3 System administration operations 2.3.1 Queue Managers 2.3.2 Queues 2.3.3 DQLs 2.3.4 User Classes 2.3.5 Communication Lines 2.3.6 Transport Definitions (Local Node only) 2.3.7 Classes By Name (Local Node only) 2.3.8 Classes by Protocol (Local Node only) 2.3.9 Tasks (Local Node only) 2.4 Setting SPAZIO Administrator options 2.5 SPAZIO Administrator Help
9 9 9 9 10 10 10 10 18 33 42 45 49 50 52 54 55 56
Chapter 3 Security Management 3.1 Introduction 3.2 Logging in to SPAZIO Administrator 3.2.1 Access control for SPAZIO Administrator 3.2.2 Login procedure 3.3 Node-level security 3.3.1 Node permissions 3.3.2 Changing access rights for groups 3.3.3 Adding groups and setting their access rights 3.3.4 Adding users and setting their access rights 3.3.5 Removing groups 3.4 Queue Manager-level security 3.4.1 Accessing Queue Manager security management
57 57 57 57 57 58 58 59 60 62 63 64 64
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
i
Contents
3.4.2 Queue Manager permissions 3.4.3 Default Queue permissions 3.4.4 Default DQL permissions 3.5 Queue and DQL-level security 3.5.1 Queue permissions 3.5.2 DQL permissions
65 66 67 69 69 70
Chapter 4 Transport Manager 4.1 Introduction 4.2 A note for users who are new to Windows applications 4.3 View or modify Transport Manager runtime options 4.3.1 General options 4.3.2 Startup options 4.3.3 Applying changes to the options 4.4 Connecting to a Queue Manager 4.4.1 Connect to a Queue Manager 4.5 View Transport Route Details (Master) 4.5.1 View Session Summary from a Queue Manager 4.5.2 View Queue Session Details 4.5.3 View file Session Details 4.6 View Transport Session Summary (Slave) 4.7 View Transport Session Summary (Pull) 4.8 File Session Options 4.9 Queue Session Options
73 73 73 73 73 74 75 75 75 76 76 78 79 81 81 82 82
Chapter 5 Log Viewer 5.1 Introduction 5.2 A note for users who are new to Windows applications 5.3 View or modify Log Manager runtime options 5.3.1 General options 5.3.2 Startup options 5.3.3 Color 5.3.4 Applying changes to the options 5.4 Connecting to a Queue Manager 5.4.1 Connect to a Queue Manager 5.5 Extended Log View 5.5.1 View Details of a Session 5.5.2 Apply a filter to Session List
83 83 83 83 83 84 85 85 85 85 87 88 90
Chapter 6 SPAZIO Administrator Terminal 6.1 Introduction 6.1.1 Functionality 6.2 Installation 6.3 The SPAZIO Administrator Terminal interface 6.4 Opening SPAZIO Administrator Terminal 6.5 The Main Screen 6.6 Local Node Management 6.6.1 Current Node Management 6.6.2 Transport Monitor Management 6.6.3 Application Log Management 6.6.4 Connection to Queue Manager 6.7 Remote Node Management 6.7.1 Current Node Management 6.7.2 Transport Monitor Management 6.7.3 Application Log Management 6.7.4 Connection to Queue Manager 6.7.5 Exit 6.8 Closing SPAZIO Administrator Terminal
93 93 93 94 95 95 96 97 98 133 149 155 209 210 210 210 210 210 211
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
ii
EMAFTM082/01
Contents
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
iii
About this Manual
Purpose This manual is a guide to SPAZIO Managed File Transfer/Secure (SPAZIO MFT/S) system administration for distributed platforms. It primarily provides the reader with a description of the SPAZIO Administrator graphical interface for use in Windows environments, and its menu-driven counterpart, SPAZIO Administrator Terminal, for use in non-Windows environments. The manual provides a step-by-step description of system administration tasks, for example:
Creating Queues, DQLs and User Classes
Viewing information on existing SPAZIO objects
User intervention such as activating/deactivating Queue Managers, Communication Lines and the Transport Monitor, as well as setting trace levels for these objects
Listing, setting and modifying security settings.
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 or UNIX 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 Administrator: Getting Started describes the graphical interface for Windows-based SPAZIO administration.
Chapter 2: Using SPAZIO Administrator describes the range of operations that can be performed using SPAZIO Administrator.
Chapter 3: Security Management describes how security is implemented through SPAZIO Administrator.
Chapter 4: Transport Manager describes how to view session details of File/Message transport session.
Chapter 5: Log Viewer describes how to to view details of any active or inactive SPAZIO session.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
iv
About this Manual
Chapter 6: SPAZIO Administrator Terminal describes the menu-driven interface available for non-Windows environments.
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 related to the z/OS Mainframe platform
Distributed platforms - manuals related to the non-Mainframe platforms including SPAZIO workstation
General - manuals related both the Mainframe and non-Mainframe platforms.
The key manuals for z/OS are:
SPAZIO MFT/S for z/OS: Customization 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: 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: Management Console Guide
SPAZIO MFT/S for Distributed Platforms: Release Notes
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
v
About this Manual
The key general manuals are:
Data Secure for SPAZIO (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 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
!"#$%&'()*+,-./:;?@[\]^_`{|}~
The names of the queues, remote queues and distribution queue lists (DQL) can only include the following characters:
0123456789
abcdefghijklmnopqrstuvwxyz
ABCDEFGHIJKLMNOPQRSTUVWXYZ
./-%
The names of the 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: System Administrator's Guide
vi
EMAFTM082/01
About this Manual
Conventions Sometimes "Distributed Platforms" is abbreviated 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: Developer’s 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
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
vii
About this Manual
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: System Administrator's Guide
viii
EMAFTM082/01
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
ix
Chapter 1 Started
SPAZIO Administrator: Getting
SPAZIO Administrator is a graphical utility for the administration of a SPAZIO network. The program provides the SPAZIO system administrator with a user-friendly hierarchical view of the objects that make up the network. This chapter describes the SPAZIO Administrator user interface, while the following chapter provides detailed instructions for performing each of the available operations. NOTE A menu-driven interface, SPAZIO Administrator Terminal, provides similar functionality for non-windows users. Chapter 6: SPAZIO Administrator Terminal describes the program in detail.
1.3
Opening SPAZIO Administrator 1
Make sure that SPAZIO is installed and running.
2
Click Start – Programs – Primeur – Spazio Server - Spazio Administrator, or click the SPAZIO Administrator icon on the desktop.
3
The following screen appears:
4
The initial login box appears next:
If required, enter the correct user ID and password:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
1
SPAZIO Administrator: Getting Started
5
Click OK. SPAZIO Administrator now opens.
NOTE If you try to open SPAZIO Administrator, and SPAZIO is either not installed or not running, the following error message appears:
Click “OK”. If required enter the correct user ID / password combination in the initial login box. SPAZIO Administrator opens, displaying the following icon in the lefthand panel:
To retry starting SPAZIO Administrator (for example, after first starting SPAZIO) right-click this item and click “Retry” in the menu that appears. If SPAZIO is running, SPAZIO Administrator starts up and the initial login box appears again.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
2
EMAFTM082/01
SPAZIO Administrator: Getting Started
1.4
The SPAZIO Administrator Interface When you open SPAZIO Administrator, the following screen appears (the Main screen):
This screen is made up of the following areas:
1.4.1 Title Bar This displays the name of the program, and contains three buttons on the right which you can use to
1.4.2
Minimize the window
Maximize / restore the window
Close the window (and the program)
Menu Bar and Drop-down Menus This lets you access the three SPAZIO Administrator menus: Action, View and Help.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
3
SPAZIO Administrator: Getting Started
1.4.2.1 Action menu The Action menu contains the following items:
Menu Item
Description
Expand
Expand an item to display its contents
Collapse
Collapse an item to hide its contents
Activate
Activate an object
Deactivate
Deactivate an object
Connect
Connect to a local or remote Queue Manager
Disconnect
Disconnect from a local or remote Queue Manager
Create
Create a new object
Modify
Modify an existing object
Remove
Delete an existing object
Set trace level
Set the trace level for an object. When the cursor is placed over this item, a sub-menu appears containing the following options: Option
Description
No Trace
No trace is set for the object.
Trace level 1
Minimal trace
Trace level 2
Normal trace
Trace level 3
Most detailed trace
Connect to Node
Connect to a Local or Remote Node
Stop Spazio
End SPAZIO
Exit
Exit from SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
4
EMAFTM082/01
SPAZIO Administrator: Getting Started
1.4.2.2 View menu The View menu contains the following items:
Menu Item
Description
Toolbar
Display / hide the toolbar
Status Bar
Display / hide the status bar
Description
Display / hide object descriptions
Security
Access security settings
Default Queue Security
Access default queue security settings
Default DQL Security
Access default DQL security settings
Options
Access user-defined program settings
1.4.2.3 Help Menu The Help menu contains the following items:
Menu Item
Description
Contents
Display on-line help contents
Search For Help On
Search the on-line help index
About Spazio Administrator
Display information on the program
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
5
SPAZIO Administrator: Getting Started
1.4.3
Toolbar
This bar contains a number of buttons that provide point-and-click access to most SPAZIO Administrator operations. The following table describes the function of each button and the equivalent menu command: Button
1.4.4
Function
Menu Command
Connect to a Local or Remote node
Action - Expand
Expand an item to display its contents
Action - Expand
Collapse an item to hide its contents
Action - Collapse
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
Show DQL information
none
Display DQL structure (items)
none
Apply a node filter
none
Workspace This is the main part of the GUI, and is divided into two panels:
The SPAZIO Objects panel
The Properties or Contents panel
The left panel contains the names of SPAZIO objects. The right panel contains the properties and/or the contents of the object selected in the left panel. The range of objects that can be displayed in the left panel differs for local and remote nodes, as the following screen images show:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
6
EMAFTM082/01
SPAZIO Administrator: Getting Started
Local Node Objects
Remote Node Objects
1.4.4.1 Expanding / collapsing SPAZIO objects and folders When SPAZIO Administrator starts, the objects in the left panel are all collapsed. That is, the only icons visible are those representing the nodes in the network. To see the contents of a node, or any object in the left panel of the screen you must expand it by performing one of the following actions:
Click the object
If there is a “+” symbol to the left of the object, click this
Right-click the object and choose Expand from the pop-up menu
If the object is selected but collapsed, choose Action – Expand
To collapse an expanded object or folder
Click the “–“ symbol to the left of the object
Right-click the object and choose Collapse from the pop-up menu
Select the object and choose Action – Collapse
1.4.4.2 Performing operations on SPAZIO objects SPAZIO Administrator allows you to perform a wide range of operations on SPAZIO objects. These operations are listed in Chapter 2: Using SPAZIO Administrator. 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
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
7
SPAZIO Administrator: Getting Started
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.4.5
Status Bar
This bar contains various items of information
1.5
The name of the currently selected object, or a status message such as Connecting …
The current date
The current time
Closing SPAZIO Administrator To close SPAZIO Administrator, click the close button choose Action – Exit.
on the title bar, or
If one or more Queue Managers are connected, they are automatically disconnected by the close operation.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
8
EMAFTM082/01
Chapter 2
2.1
Using SPAZIO Administrator
Introduction SPAZIO Administrator allows you to perform certain administration tasks for both Local and Remote SPAZIO nodes as follows:
2.1.1
2.1.2
Local node administration
View the name and contents of the node.
List Queue Managers, Queues, DQLs, Communication Lines, Line Conversations Transport Classes, Transport Agents, and Tasks.
View the properties of Queue Managers, Queues, DQLs, Communication Lines, Line Conversations, the Transport Monitor, Transport Classes, Transport Agents, and Tasks.
Activate/deactivate Queue Managers, Communication Lines and the Transport Monitor.
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.
Set trace levels for Queue Managers, Communication Lines and the Transport Monitor.
Remote node administration
View the name and contents of the node.
List Queue Managers, Queues, DQLs and Line Addresses.
View the properties of Queue Managers, Queues, DQLs, and Line Addresses.
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
9
Using SPAZIO Administrator
2.2 2.2.1
Notes on Using SPAZIO Administrator A note for users who are new to Windows As described in Chapter 1: SPAZIO Administrator – Getting Started, many commands can be activated through a variety of mechanisms, including drop-down menus, pop-up or right-click menus, buttons and icons. Throughout this chapter, in most cases only the simplest methods of performing an operation are documented (e.g. clicking a particular button on the toolbar). See Chapter 1: SPAZIO Administrator – Getting Started for an overview of available menus and buttons.
2.3
System administration operations Sections 2.3.1 to 2.3.9 describe the range of operations that SPAZIO Administrator allows you to perform on the various SPAZIO objects (Queue Managers, Queues, DQLs, User Classes, Communication Lines, the Transport Monitor, Transport Classes, Transport Agents, and Tasks) on both Local and Remote Nodes. NOTE: SPAZIO Administrator does not permit the same range of operations for Remote Node objects as it does for Local Node objects. The differences in functionality are clearly indicated throughout the rest of this chapter.
2.3.1
Queue Managers The sections below describe the operations that you can perform on local Queue Managers using SPAZIO Administrator. NOTE: Queue Managers are created (or, more precisely, defined) through the SPAZIO configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
10
EMAFTM082/01
Using SPAZIO Administrator
2.3.1.1 List Queue Managers
2.3.1.2
1
If the contents of the Node are not already expanded, click the Node icon in the left panel of the workspace (the Local Node is the first node listed).
2
Next, expand the Queue Managers folder:
3
The Queue Managers are listed.
View the properties of a Queue Manager 1
Click a Queue Manager.
2
A series of properties is displayed in the right panel of the workspace:
The following table describes these properties: Property
Description / Values
Name
Name of the Queue Manager
Active
Whether the Queue Manager is active or not: Value
Description
True
The Queue Manager is active.
False
The Queue Manager is not active.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
11
Using SPAZIO Administrator
Property
Description / Values
Options
Options for the Queue Manager.
Startup mode
Start-up mode for the Queue Manager: Value
Description
1
Manual
2
Automatic
Max number of concurrent sessions
The maximum number of simultaneously active Queue Manager sessions.
Prestarted Session Agents
Pre-started session agents.
Trace Level
Trace level for the Queue Manager. Values: Value
Description
0
No trace
1
Minimal trace
2
Normal trace
3
Most detailed trace
Option for using a single index on storage classes:
Single Index
Value
Description
True
Option is switched on.
False
Option is switched off.
Option to use the SPAM FAST_INDEX for storage classes. Faster, but involves more work in the case of a system failure:
Optimize indices for speed
Value
Description
True
Option is switched on.
False
Option is switched off.
Option to use the SPAM VIRT file for Queue Manager catalogues. Faster, but involves more work in the case of a system failure:
Catalogues in virtual memory only
Value
Description
True
Option is switched on.
False
Option is switched off.
Max number of Queues
Maximum number of Queues under the Queue Manager.
Max number of open Queues per session
Maximum number of Queues open in a session.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
12
EMAFTM082/01
Using SPAZIO Administrator
Property
Description / Values
Max number of open files per session
Maximum number of files open in a session.
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 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.
Max number of messages in a Queue
Maximum number of files in a Queue belonging to this Queue Manager.
Directory for the Queue Manager files
Name of the directory where Queue Manager files are stored.
Cleaning policy
Directions for the Queue Manager Cleaner process. Values: Value
Description
0
Cleaning interval (in hours) Event Manager level
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. Level of the Event Manager: Value
Description
1
Basic
2
Extended
Number of storage classes
Total number of storage classes defined on the Queue Manager.
Number of events definitions
Number of event definitions for the Queue Manager.
Number of default events
Number of default events defined for the Queue Manager.
Number of Queues with events
Number of Queues belonging to the Queue Manager that have events defined for them.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
13
Using SPAZIO Administrator
Property
Description / Values
Number of event instances
The total number of instances of events.
Max number of dynamic events
Maximum number of dynamic events for the Queue Manager.
Max number of Queues with dynamic events
Maximum number of queues with dynamic events.
Remote Nodes The only property displayed for a Queue Manager on a Remote Node is the Name. NOTE: for SPAZIO Administrator, these properties are read-only. Their values are assigned and modified through the configuration process (see SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for details).
2.3.1.3 Activate an inactive Queue Manager (Local Node only) You can activate a Queue Manager if it is
Not connected (see section 2.3.1.5), and
Not active (the Active property of the Queue Manager is False – see section 2.3.1.2)
To activate a selected Queue Manager, click the Activate button toolbar.
2.3.1.4
on the
Deactivate an active Queue Manager (Local Node only) You can deactivate a Queue Manager if it is
Not connected (see section 2.3.1.5), and
Active (the Active property of the Queue Manager is True – see section 2.3.1.2)
To deactivate a selected Queue Manager, click the Deactivate button the toolbar.
on
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
14
EMAFTM082/01
Using SPAZIO Administrator
2.3.1.5 Connect to a Queue Manager 1
Select the Queue Manager.
2
Click the Connect button
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 both panels (the Queue Manager properties are also listed in the right panel):
on the toolbar.
2.3.1.6 Disconnect from a Queue Manager
2.3.1.7
1
Select the Queue Manager.
2
Click the Disconnect button
on the toolbar.
Set the Trace Level for a Queue Manager (Local Node only) 1
Select the Queue Manager.
2
Choose Action – Set Trace Level.
3
The following sub-menu appears:
4
Set the trace level by clicking one of the options.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
15
Using SPAZIO Administrator
The following table explains the trace levels: Trace Level
Description
No trace
No trace will be performed.
Trace level 1
Minimal trace
Trace level 2
Normal trace
Trace level 3
Most detailed trace
2.3.1.8 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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
16
EMAFTM082/01
Using SPAZIO Administrator
2.3.1.8.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 3: Security Management for details on how to set and modify the permissions.
2.3.1.8.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 3: Security Management for details on how to set and modify the permissions.
2.3.1.8.3 Queue Manager default DQL security 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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
17
Using SPAZIO Administrator
2.3.2
2
If you do not have the correct permissions for this operation, the following message appears:
3
Refer to Chapter 3: Security Management for details on how to set and modify the permissions.
Queues The sections below describe the operations that you can perform on queues belonging to a Queue Manager on a local or remote node using SPAZIO Administrator.
2.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
icon, and remote queues by the
The queues are also listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
18
EMAFTM082/01
Using SPAZIO Administrator
2.3.2.2 View the properties of a Local Queue 1
Click a local queue to display its properties in the right panel:
The local queue properties are described in the following table: Property
Description / Values
Name
Name of the Queue.
Type
Queue Type
Description
A user-defined description of the queue.
Storage Class
The storage class associated with the queue.
Address Type
The address type of the queue. Value
Description
0
SPAZIO. Default.
Current Message Depth
The number of messages currently in the queue.
Creation
Date and time that the queue was created.
Update
Date and time that the queue was last updated.
Inhibit Get
Whether GET operations are blocked for the queue. Values:
Inhibit Put
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
19
Using SPAZIO Administrator
Property
Description / Values False
PUT operations are not blocked.
Shareability
Whether the queue is shareable: TRUE or FALSE
Default Input Open Option
Whether the queue is opened for input by default
Persistence
Whether the queue is persistent: TRUE or FALSE
Priority
Selection priority of the queue. Number in the range1-10. Default = 5
Open Input Count
The number of times that the queue has been opened for input
Open Output Count
The number of times that the queue has been opened for output
File Default User Class
The default user class for files in the queue.
Max File Depth
The maximum number of files that the queue can contain.
Max File Length
The maximum size of files that may be contained in the queue.
Message Default User Class
The default user class for messages in the queue.
Max Message Depth
Maximum number of messages that may be contained in the queue
Max Message Length
The maximum length of messages that may be contained in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
20
EMAFTM082/01
Using SPAZIO Administrator
2.3.2.3 View the properties of a Remote Queue 1
Click a remote queue in the left panel
2
Its properties are listed in the right panel. The remote queue properties are described in the following table:
Property
Description / Values
Name
Name of the Queue.
Type
Queue Type
Description
A user-defined description of the queue.
Storage Class
The storage class associated with the queue.
Address Type
The address type of the queue. Value
Description
0
SPAZIO. Default.
Current Message Depth
The number of messages currently in the queue.
Creation
Date and time that the queue was created.
Update
Date and time that the queue was last updated.
Inhibit Get
Whether GET operations are blocked for the queue:
Inhibit Put
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
21
Using SPAZIO Administrator
Property
Description / Values False
PUT operations are not blocked.
Shareability
Whether the queue is shareable: TRUE or FALSE
Default Input Open Option
Whether the queue is opened for input by default
Persistence
Whether the queue is persistent: TRUE or FALSE
Priority
Selection priority of the queue. Number in the range1-10. Default = 5
Open Input Count
The number of times that the queue has been opened for input
Open Output Count
The number of times that the queue has been opened for output
File Default User Class
The default user class for files in the queue.
Max File Depth
The maximum number of files that the queue can contain.
Max File Length
The maximum size of files that may be contained in the queue.
Message Default User Class
The default user class for messages in the queue.
Max Message Length
The maximum length of messages that may be contained in the queue.
Max Message Depth
Maximum number of messages that may be contained in the queue
Remote Queue Manager
Name of the remote Queue Manager that owns the queue to which this “remote queue” points.
Remote Queue
Name of the queue belonging to a remote Queue Manager to which this “remote queue” points.
Remote Queue Address type
The Address Type of the remote queue
Remote Queue Type
The type of the remote queue.
Remote User Id
User ID associated with the remote Queue Manager.
Transport Class
The transport class associated with the remote queue.
File Transport Type
File Transport type associated with the remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
22
EMAFTM082/01
Using SPAZIO Administrator
Property
Description / Values
Message Transport Type
Message Transport type associated with the remote queue.
Delivery Mode
The delivery mode for the queue (immediate or within an interval or class)
Start of Delivery
Start of delivery period
End of Delivery
End of delivery period
File Transport Timeout
Timeout for file transport.
Message Transport Timeout
Timeout for message transport.
File Transport parallelism
Maximum number of current active transports.
Message Transport parallelism
Maximum number of current active transports.
Transport Priority
Priority in selecting the queue (only for remote queues).
Max Delivery interval
Maximum length of the delivery interval
Max Restart Retry
Maximum number of restarts that can be attempted.
Restart Interval
The interval specified between restart attempts.
Synchronization 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
Successful Event Group
Name of the Event Group to which the following parameter belongs.
Successful Event Name
Name of the Event to be executed in case of success in reaching the remote Queue Manager.
Failure Event Group
Name of the Event Group to which the following parameter belongs.
Failure Event Name
Name of the Event to be executed in case of failure in reaching the remote Queue Manager.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
23
Using SPAZIO Administrator
2.3.2.4 Create a Local Queue 1
Select the Queues folder.
2
Click the
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.
button on the toolbar. The following screen appears:
The following table explains the fields: 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
24
EMAFTM082/01
Using SPAZIO Administrator
7
Click the Advanced tab:
The following table explains the fields in the Advanced tab: Field
Description / Values
Storage Class
Storage class to be associated with the new queue. For further details, see section 2.3.2.8.
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.
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
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
25
Using SPAZIO Administrator
Field
Description / Values
Inhibit Put Operation
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).
8
Fill in the relevant fields.
9
Click OK to create the queue, or Cancel to abort the operation.
2.3.2.5 Create a Remote Queue 1
Select the Queues folder.
2
Click the button on the toolbar. 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
26
EMAFTM082/01
Using SPAZIO Administrator
The following table explains the fields: Field
Description / Values
Remote Queue Manager: Name
It 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
LOCAL MODEL ALIAS REMOTE UNKNOWN Address Type
Address Type Value
Description
Spazio 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.
Click the Advanced tab:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
27
Using SPAZIO Administrator
The following table explains the fields in the Advanced tab: Field
Description / Values
Storage Class
Storage class to be associated with the new queue. For further details, see section 2.3.2.8.
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.
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
Value
Description
FIFO
Delivered using First In First Out mechanism. MVS only.
Priority Based
Priority Based
Whether GET operations are blocked for the queue: Value
Description
True
GET operations are blocked.
False
GET operations are not blocked.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
28
EMAFTM082/01
Using SPAZIO Administrator
Field
Description / Values
Inhibit Put Operation
Whether PUT operations are blocked for the queue: 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
7
Fill in the relevant fields.
8
Click the Delivery Mode tab:
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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
29
Using SPAZIO Administrator
Field
Description
Delivery Mode 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. Alternate 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. Optional. Alternate to Hold, Immediate, Use Transport Class parameters. It 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.
Interval
This mode is valid only for MVS nodes. Use Transport Class
Optional. Alternate 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
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
30
EMAFTM082/01
Using SPAZIO Administrator
Field
Description 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
Optional. 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. 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 Transport Name
Messages Transport Name
Transport Timeout
Messages Transport Name
Transport Prestarted
Messages Transport Name
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
31
Using SPAZIO Administrator
9
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.
2.3.2.6 Delete 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.
2.3.2.7 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 3: Security Management for details on how to set and modify the permissions.
2.3.2.8 Storage Class A Storage Class is applied to a Queue Manager and specifies the attributes (in particular the data catalogue path and the maximum number of files that can be stored in a queue) that characterize the queues belonging to the Queue Manager to which such class is applied. A Storage Class must be defined in the SPQM.INI configuration file and is made up of the following attributes:
Identifier (ClassId)
Name (ClassName)
Description (ClassDesc)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
32
EMAFTM082/01
Using SPAZIO Administrator
Path where directories CLASS and DATA of the Storage Class in QM, are appended (ClassPath)
Maximum size of disk file of persistent object entry repository - entries for persistent messages and files in queues (RepPMax)
Maximum size of memory file of volatile object entry repository - entries for non-persistent messages in queues (RepNPMax)
Maximum size of disk file of persistent message body repository - entries for persistent messages in queues (MsgBodyPMax)
Maximum size of memory file of volatile message body repository - entries for non-persistent messages in queues (MsgBodyNPMax)
Maximum size of disk file of file information entry repository - entries for files in queues (FileInfoPMax)
Example (SPQM.INI) . . ClassId_1 ClassName_1 ClassDesc_1 ClassPath_1 RepPMax_1 RepNPMax_1 MsgBodyPMax_1 MsgBodyNPMax_1 FileInfoPMax_1 . .
2.3.3
= = = = = = = = =
1 CLASS1 FIRST_CLASS 40000000 1000000 20000000 800000 10000000
DQLs The sections below describe the operations that you can perform on DQLs (Destination Queue Lists) belonging to a Queue Manager on a Local or Remote Node using SPAZIO Administrator. 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 class that is the first defined in SPQM.INI.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
33
Using SPAZIO Administrator
2.3.3.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:
2.3.3.2 View the general properties of a DQL 1
Click a DQL.
2
button on the toolbar is already selected, the properties of the If 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.
2.3.3.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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
34
EMAFTM082/01
Using SPAZIO Administrator
The various objects are displayed hierarchically, using the familiar icon representations of queues and Queue Managers.
2.3.3.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.
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.
Structure of the example DQL The following diagram represents the DQL to be created:
DQL: SALESDQL
Queue Manager: JFK
Local Queue: FROMLIN
Queue Manager: HEATHROW
Local Queue: FROMHRW
Local Queue: FROMLIN
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
35
Using SPAZIO Administrator
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.
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
36
EMAFTM082/01
Using SPAZIO Administrator
Field
Description / Values
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.)
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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
37
Using SPAZIO Administrator
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.
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. 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: System Administrator's Guide
38
EMAFTM082/01
Using SPAZIO Administrator
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. 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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
39
Using SPAZIO Administrator
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. 24 Leave the Address Type as the default SPAZIO. 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. 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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
40
EMAFTM082/01
Using SPAZIO Administrator
Click Hide Details to close the lower panel.
2.3.3.5 Delete 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.
2.3.3.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 3: Security Management for details on how to set and modify the permissions.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
41
Using SPAZIO Administrator
2.3.3.7 Modify a DQL
2.3.4
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 2.3.3.4 Creating 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 using SPAZIO Administrator.
2.3.4.1 List User Classes 1
Click the User Classes folder in the left panel of the screen.
2
The queues under the current Queue Manager are displayed:
3
The User Classes are also listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
42
EMAFTM082/01
Using SPAZIO Administrator
2.3.4.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:
The User Class properties are described in the following table: Property
Description / Values
Name
Name of the User Class.
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.
Expiry after read
Specifies an interval after which objects read from the queue will expire.
2.3.4.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 New User Class dialog box:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
43
Using SPAZIO Administrator
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 Value
Description
Permanent
Permanent User class
Dynamic Allocation
3
Prioritary Deletion Mode
Prioritary 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
44
EMAFTM082/01
Using SPAZIO Administrator
2.3.4.4 Delete a User Class
2.3.5
1
Select a User Class in the left panel of the workspace.
2
Click the
button on the toolbar.
Communication Lines The sections below describe the operations that you can perform on Communication Lines belonging to a local Queue Manager using SPAZIO Administrator. Limited functionality is also available for Remote Nodes. NOTE: communication lines are created (or, more precisely, defined) through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.
2.3.5.1 List Communication Lines 1
Click the Lines folder (on Remote Nodes, this folder is labeled Line Addresses) in the left panel of the screen.
2
The communication lines defined on the current node are displayed in the left panel:
3
The communication lines are also listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
45
Using SPAZIO Administrator
2.3.5.2 View the properties of a Communication Line 1
Click a communication line in the left panel of the workspace.
2
The properties of the selected line are displayed in the right panel:
The first item in the list is the Conversations folder. This is explained in section 2.3.5.5. 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
Direction
Value
Description
TCP
TCP/IP
ISCL
ISCL (various protocols)
Whether or not the line is currently active: 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
46
EMAFTM082/01
Using SPAZIO Administrator
Property
Description / Values Value
Description
1
Manual
2
Automatic
Trace level for the Communication Line:
Trace Level
Value
Description
0
No trace
1
Minimal trace
2
Normal trace
3
Most detailed trace
Timeout
Timeout in seconds (for inbound connection).
Driver Handle
Communication driver handle
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
Local Address
Local IP Address
Remote Nodes The following are the only properties listed for Line Address objects on Remote Nodes: Property
Description / Values
Name
Symbolic name of the communication line.
Address
Destination address (IP or other) of the Communication Line.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
47
Using SPAZIO Administrator
2.3.5.3 Activate an inactive Communication Line (Local Node only) 1
Select the communication line in the left panel of the workspace.
2
If the Active property of the line is False (see section 2.2.5.2), click the button on the toolbar.
2.3.5.4 Deactivate an active Communication Line (Local Node only) 1
Select the communication line in the left panel of the workspace.
2
If the Active property of the line is True (see section 2.2.5.2), click the button on the toolbar.
2.3.5.5 List the conversations on a Communication Line (Local Node only) 1
Select the communication line in the left panel of the workspace.
2
Click the Conversations folder under the line.
3
Conversations on that line are listed in the left panel:
4
The conversations are also listed in the right panel:
2.3.5.6 View the properties of a Communication Line conversation (Local Node only) 1
Select the communication line conversation in the left panel of the workspace.
2
The properties of the conversation are listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
48
EMAFTM082/01
Using SPAZIO Administrator
The following table explains the above properties: Property
Description / Values
ID
Identifier for the conversation.
Remote Node Name
Name of the remote node on the receiving end of the conversation. If the Direction property of the conversation is I (Input), then this property has the value .
Direction
The direction of the conversation: Value
Description
I
Input (incoming).
O
Output (outgoing).
Active
True or False value indicating whether the conversation is active or not.
Status
Status of the conversation
Client Handle
Client process handle
Conversation Handle
Conversation process handle
2.3.5.7 Set the Trace Level for a Communication Line (Local Node only)
2.3.6
1
Select the communication line in the left panel of the workspace.
2
Choose Action – Set Trace Level.
3
The following sub-menu appears:
4
Set the trace level by clicking one of the options.
Transport Definitions (Local Node only) The sections below describe the operations that you can perform on the Transport Definitions on the Local Node using SPAZIO Administrator.
2.3.6.1 View the properties of the Transport Definitions 1
Click the Transport Definitions folder in the left panel of the workspace.
2
The contents and properties of the Transport Definition are listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
49
Using SPAZIO Administrator
The first two items in the list are the Classes by Name folder (see section 2.3.7 Transport Classes) and the Classes By Protocol folder (see section 2.3.8 Transport Agents).
2.3.6.2 Activate the Transport Definitions 1
Select the Transport Definition folder in the left panel of the workspace.
2
If the Active property of the Transport Definitions is False, click the button on the toolbar.
2.3.6.3 Deactivate the Transport Definitions 1
Select the Transport Definitions folder in the left panel of the workspace.
2
If the Active property of the Transport Definitions is True, click the button on the toolbar.
2.3.6.4 Set the Trace Level for the Transport Definitions
2.3.7
1
Select the Transport Definitions folder in the left panel of the workspace.
2
Choose Action – Set Trace Level.
3
The following sub-menu appears:
4
Set the trace level by clicking one of the options.
Classes By Name (Local Node only) The sections below describe how you can use SPAZIO Administrator to perform operations on Transport Classes defined on the local Node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
50
EMAFTM082/01
Using SPAZIO Administrator
NOTE: Transport Classes are defined through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.
2.3.7.1 List Transport Classes 1
Click the Classes by Name folder in the left panel of the workspace.
2
The Transport Classes defined on the current node are displayed in the left panel:
3
The Transport Classes are also listed in the right panel
2.3.7.2 View the properties of a Transport Class 1
Select a Transport Class in the left panel of the workspace.
2
The properties of the class are listed in the right panel:
The following table explains the above properties: Property
Description / Values
Name
Name of the Transport Class.
Priority
Selection priority of the queue. Number in the range1-10. Default = 5
Delivery Mode
Queue Delivery Mode. Values:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
51
Using SPAZIO Administrator
Property
Protocol Name
2.3.8
Description / Values Value
Description
0
Immediate delivery.
1
Delivery after interval.
File Transport Protocol t used by the class.
Classes by Protocol (Local Node only) The sections below describe how you can use SPAZIO Administrator to perform operations on Transport Protocols defined on the local Node. NOTE: Transport Agents are configured through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.
2.3.8.1 List Transport Agents 1
Click the Classes by Protocol folder in the left panel of the workspace.
2
The Transport Protocols defined on the current node are displayed in the left panel:
3
The Transport Protocols are also listed in the right panel.
2.3.8.2 View the properties of a Transport 1
Select a Protocol in the left panel of the workspace.
2
The properties of the Protocol are listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
52
EMAFTM082/01
Using SPAZIO Administrator
The first item in the list is the Classes folder, explained in the next section. A single property of the selected Transport Agent is listed: Name.
2.3.8.3 List the Transport Classes associated with a Transport Protocol 1
Click a Transport Agent in the left panel of the workspace. Click the Classes folder under this agent.
2
The Transport Classes associated with this Transport Agent (i.e. the Transport Agent Classes) are displayed in the left panel:
3
The Transport Agent Classes are also listed in the right panel.
2.3.8.4 View the properties of a Transport Class associated with a Transport Protocol 1
Select a Transport Protocol Class in the left panel of the workspace.
2
The properties of the class are listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
53
Using SPAZIO Administrator
A single property, the Name of the class is listed.
2.3.9
Tasks (Local Node only) The sections below describe how you can use SPAZIO Administrator to list and view Tasks running on the local Node.
2.3.9.1 List Tasks 1
Click the Tasks folder in the left panel of the workspace.
2
Tasks currently running are listed in the left panel:
3
The current tasks are also listed in the right panel:
2.3.9.2 View the properties of a Task 1
Select a task in the left panel of the workspace.
2
The properties of the task are listed in the right panel:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
54
EMAFTM082/01
Using SPAZIO Administrator
The following table explains the above properties:
2.4
Property
Description / Values
ID
Task ID.
Name
Name of the transaction.
Active
Whether or not the task is active. Value
Description
True
The task is active.
False
The task is not active.
Direction
Task Direction. Input\Output
Proc ID
Process ID
Setting SPAZIO Administrator options 1
Choose View – Options to open the Options dialog box:
The General tab allows you to enable/disable the use of login dialog boxes when connecting to Local Queue Managers. If this option is not checked, you will not see the following box when you try to connect to a Local Queue Manager (unless the Queue Manager is passwordprotected):
2
The Startup tab allows you to specify the start up options on the Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
55
Using SPAZIO Administrator
3
2.5
The Filters tab allows you to specify a filter, with which to list Queue Managers:
SPAZIO Administrator Help 1
Open the Help menu on the menu bar:
2
Click Contents to browse the contents of the online help or Search For Help On… to search for a specific term in the online help.
3
Click About Spazio Administrator to see the name and version of the product you are using.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
56
EMAFTM082/01
Chapter 3
3.1
Security Management
Introduction SPAZIO Administrator provides comprehensive security functionality through highly configurable access rights to a range of SPAZIO objects at various levels:
3.2
Login - access to the SPAZIO Administrator 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.
Logging in to SPAZIO Administrator Basic authentication is required in order to access SPAZIO Administrator, whether you wish to perform security management or any other operations (for example, those described in Chapter 2 of this manual).
3.2.1
Access control for SPAZIO Administrator When you start SPAZIO Administrator, you are requested for a User ID and Password. For information about creating, deleting, and managing user accounts, see the SPAZIO MFT/S for Distributed Platforms: Installation and Configuration manual. In order to access SPAZIO Administrator you must be part of the SPAZIO Administrators group.
3.2.2
Login procedure 1
Start SPAZIO Administrator.
2
Enter the required user name and password:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
57
Security Management
3
Click on OK.
NOTE: if you have checked the Always show login dialog box for the connections option (see section 2.4: Setting SPAZIO Administrator Options), your SPAZIO Administrator session will always begin with the Access Denied dialog box.
3.3
Node-level security SPAZIO Administrator allows you to set and modify access rights for the Node object. Section 3.3.1: Node permissions describes the various types of access that can be specified for a Node. Sections 3.3.2 to 3.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.
3.3.1
Node permissions As you will see later, SPAZIO Administrator 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).
3.3.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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
58
EMAFTM082/01
Security Management
Option
Code
Description
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.
3.3.1.2 Types of Node access Four preset types of access are available for Nodes:
3.3.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 3.3.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 3.3.1.1 and 3.3.1.2 above).
4
Select a group from the list in the Name column.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
59
Security Management
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 3.3.1.2 above).
6
If you choose Special Access the following box appears:
Choose either of the following: Full Control (all access rights are granted) Other (only those rights that you check are granted)
3.3.3
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.
Adding groups and setting their 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: System Administrator's Guide
60
EMAFTM082/01
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 3.3.1.2 above).
10 If you choose Special Access the following box appears:
Choose either of the following:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
61
Security Management
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. 13 Click OK to enforce the changes, or Cancel to cancel the operation. 14 If you clicked OK, the group is now added with a specific set of access rights.
3.3.4
Adding users and setting their 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:
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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
62
EMAFTM082/01
Security Management
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 3.3.1.2 above).
10 If you choose Special Access the following box appears:
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.
3.3.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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
63
Security Management
3.4
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.
Queue Manager-level security At Queue Manager level, SPAZIO Administrator lets you manage access to three security objects:
3.4.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 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:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
64
EMAFTM082/01
Security Management
4
3.4.2
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 3.4.2 for details.
View or set default permissions for the Queues belonging to the Queue Manager (Default Queue Permissions) - see section 3.4.3 for details.
View or set default permissions for the DQLs belonging to the Queue Manager (Default DQL Permissions) - see section 3.4.4 for details.
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 3.3.2 to 3.3.5).
3.4.2.1 Table of access rights for Queue Managers The following table lists the access rights that can be specified for Queue Managers: 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
65
Security Management
3.4.2.2
Option
Code
Description
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:
3.4.3
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.
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 3.4.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 3.3.2 to 3.3.5).
3.4.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).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
66
EMAFTM082/01
Security Management
Option
Code
Description
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.
3.4.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:
3.4.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 3.4.2.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 3.3.2 to 3.3.5).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
67
Security Management
3.4.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.
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.
3.4.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:
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 3.4.3.1, or to specify Full Control, for a specific user or group.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
68
EMAFTM082/01
Security Management
3.5
Queue and DQL-level security SPAZIO Administrator allows you to modify access rights for individual Queues and DQLs under a Queue Manager. Section 3.5.1: Queue permissions describes the various types of access that can be specified for a Queue. Section 3.5.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 3.4.3 and 3.4.4).
3.5.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 3.3.2 to 3.3.5).
3.5.1.1 Table of access rights for Queues The following table lists the access rights that can be specified for Queues: 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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
69
Security Management
Option
Code
Description
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.
3.5.1.2 Types of Queue access Five preset types of access may be specified for a Queue:
3.5.2
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 3.5.1.1, or to specify Full Control, for a specific user or group.
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 3.3.2 to 3.3.5).
3.5.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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
70
EMAFTM082/01
Security Management
Option
Code
Description
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.
3.5.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 3.5.2.1, or to specify Full Control, for a specific user or group.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
71
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
72
EMAFTM082/01
Chapter 4
4.1
Transport Manager
Introduction SPAZIO Transport Manager allows you to view session details of File/Message transport session that have taken place on a Local or remote Queue Manager and their respective Queues. To run Transport Manager make sure that SPAZIO is installed and running. Click Start – Programs – Primeur- Spazio Server - Spazio Event Manager, or click the Transport Manager icon on the desktop: If you try to open Transport Manager and SPAZIO is either not installed or not running, the Spazio Server not available error message appears.
4.2
A note for users who are new to Windows applications There are several ways to access most of the functions provided by Transport Manager, including:
Point-and-click methods (for example, pressing a button on the toolbar)
Menus opened from the menu bar
Menus opened by clicking an object (for example, a Queue Manager) with right mouse button.
Alternative methods are pointed out where appropriate in this chapter.
4.3
View or modify Transport Manager runtime options You can customize your Transport Manager session through a series of usermodifiable options. To access these options, choose View – Options. The dialog box that appears contains two tabs, General, and Startup.
4.3.1
General options The first tab in the Options dialog box contains the General options for the current node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
73
Transport Manager
The following table describes the properties listed:
4.3.2
Menu Item
Description
Node connection timeout
Node connection timeout. Default 600 seconds.
Auto Refresh interval
Set the Auto Refresh interval
Startup options The second tab in the Options dialog box contains the Startup options for the current node.
The following table describes each property: Item
Description
Connect to First Node Do not Connect
Connect to node before startup Do not Connect to node on startup
Connect to Node
Connect to a specified Node on startup
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
74
EMAFTM082/01
TTransport Manager
4.3.3
Applying changes to the options After you have modified any fields in the three 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.
4.4
Connecting to a Queue Manager You must connect to a Queue Manager before you can view Session details. When connecting a list of the Queue Managers to which you can connect are displayed in a dialog box:
4.4.1
Connect to a Queue Manager To connect to a Queue Manager: 1
Click the button, or choose Action – Connect to Node . The following menu appears.
2
Select the Queue Manager.
3
Click connect
4
If security is enabled for the selected Queue Manager the following dialog box appears:
5
Enter the correct User ID and Password, and click OK to connect.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
75
Transport Manager
4.5
View Transport Route Details (Master) SPAZIO Transport Manager lets you view session properties associated Queue Manager transport route. It also allows you to view session details associated with a Queue on a selected queue manager.
4.5.1
View Session Summary from a Queue Manager To view session properties associated a Queue Manager 1
Select the Transport Manager folder.
2
This displays a list of possible Queue Managers to view:
3
Click on the Queue Manager you wish to view.
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.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
76
EMAFTM082/01
TTransport Manager
The right column display 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\Files transfers
Executing
Number of executing Message\Files transfers
Failed
Number of failed Message\Files transfers
Completed
Number of completed Message\Files transfers
Hold
Number of holding Message\Files transfers
Terminating
Number of terminating Message\Files 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: System Administrator's Guide EMAFTM082/01
77
Transport Manager
The following table describes the Queue properties.
4.5.2
Property
Description
Remote Queue
Remote Queue name
Address type
Remote Address type
Queue Status
Remote Queue status
Pending
Number of pending Message\Files transfers
Executing
Number of executing Message\Files transfers
Failed
Number of failed Message\Files transfers
Completed
Number of completed Message\Files transfers
Hold
Number of holding Message\Files transfers
Terminating
Number of Terminating Message\Files 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: System Administrator's Guide
78
EMAFTM082/01
TTransport Manager
The following table describes the Session properties.
Property
Description
Transport Name
Session Transport Name
Transport Type
Session Transport Type
User Class
Use Class
Message/File Id
Message\File ID
Status
Queue Status. Can be enabled or disabled
4.5.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 Transport Manager allows you to view the details of each of these message/file transfer session. 1
Click on the file to display the Session Details.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
79
Transport Manager
2
The right panel displays Session Details for the selected File\Message transfer session.
The following table describes the session properties. Property
Description
Status
Session Status
Transport Type
Session Transport type
Priority
Session priority
Modality
Session Modality
Message/File Id
Message/file ID
Internal Number
Internal number
User Class
User Class
Correlation ID
Correlation ID
Original ID
Original ID
Internal Session
Internal session number
Retry Number
Number of Session retries
Max Retry
Maximum number of allowed retries
Transport name
Session transport name
Start date
Session Start date
Interrupt Date
Session Interrupt Date
Deliv From
Delivered from
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
80
EMAFTM082/01
TTransport Manager
4.6
Property
Description
Deliv to
Delivered to
Original Size
Original Message/File size
Real size
Actual Message/File size
Total Blk/Msg
Total Blk/Msg size
Original Byte Tr
Original Byte to be Transported
Real Byte Tr
Actual Byte Transported
Last Blk/Msg
Last Blk/Msg size
Last Rec Tr
Last record Trace
Ext Ftr CC
Ext Ftr Completion code
Ext Ftr RC
Ext Ftr Reason code
CC
Completion code
RC
Reason Code
Error Side
Error side
Extension code
Session extension code
View Transport Session Summary (Slave) SPAZIO Transport Manager allows you to view the session details associated with a Slave Transport. This is usually associated with a Remote Queue Manager.
4.7
1
To view the session details follow Steps 1 to 4 from section 4.5.1 - View Session Summary from a Queue Manager.
2
At this point select the Slave option. A remote Queue Manager is then displayed.
3
To display the session details follow the Steps 5 to 9 from section 4.5.1 View Session Summary from a Queue Manager.
View Transport Session Summary (Pull) SPAZIO Transport Manager allows you to view the session details associated with a Slave Transport. This is usually associated with a Remote Queue Manager. 1
To view the session details follow Steps 1 to 4 from section 4.5.1 - View Session Summary from a Queue Manager.
2
At this point select the Pull option. A remote Queue Manager is then displayed.
3
To display the session details follow the Steps 5 to 9 from section 4.5.1 View Session Summary from a Queue Manager.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
81
Transport Manager
4.8
File Session Options By selecting one of the File/Message transfer sessions SPAZIO Transport Manager enables the following options: Info, Stop, Resume, Delete, New Transport and Force Delete for each file transfer Session. Property
Description
Info
Retrieve details on the selected transport
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 options can be accessed via the toolbar or by right clicking on the selected transport session.
4.9
Queue Session Options By selecting one of the Remote Queue SPAZIO Transport Manager enables the following options: 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 options can be accessed via the toolbar or by right clicking on the selected remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
82
EMAFTM082/01
Chapter 5
5.1
Log Viewer
Introduction SPAZIO Log Viewer allows you to view details of any active or inactive SPAZIO session. To run Log Viewer make sure that SPAZIO is installed and running and Click Start – Programs – Primeur- Spazio Server - Spazio Log Manager, or click the Log Viewer icon on the desktop. If you try to open Log Viewer and SPAZIO is either not installed or not running, the Spazio Server not available error message appears.
5.2
A note for users who are new to Windows applications There are several ways to access most of the functions provided by Log Manager, including:
Point-and-click methods (for example, pressing a button on the toolbar)
Menus opened from the menu bar
Menus opened by clicking an object (for example, a Queue Manager) with right mouse button
Alternative methods are pointed out where appropriate in this chapter.
5.3
View or modify Log Manager runtime options You can customize your Log Manager session through a series of usermodifiable options. To access these options, choose View – Options. The dialog box that appears contains three tabs, General, Startup and Color.
5.3.1
General options The first tab in the Options dialog box contains the General options for the current node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
83
Log Viewer
The following table describes the properties listed:
5.3.2
Menu Item
Description
Node connection timeout
Node connection timeout. Default 600 seconds.
Startup options The second tab in the Options dialog box contains the Startup options for the current node.
The following table describes each property: Item
Description
Connect to First Node Do not Connect
Connect to node before startup Do not Connect to node on startup
Connect to Node
Connect to a specified Node on startup
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
84
EMAFTM082/01
Log Viewer
5.3.3
Color The third tab in the Options dialog box contains the Color options for the current node.
This tab contains the following options:
5.3.4
Item
Description
Failed Session
Change the font color of a failed Session
Failed Operation
Change the font color of a failed operation
Applying changes to the options After you have modified any fields in the three 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.
5.4
Connecting to a Queue Manager You must connect to a Queue Manager before you can view Session Logs. When connecting a list of the Queue Managers to which you can connect are displayed in a dialog box.
5.4.1
Connect to a Queue Manager To connect to a Queue Manager: 1
Click the button, or choose Action – Connect to Node . The following menu appears.
2
Select the Queue Manager.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
85
Log Viewer
3
Click on Connect.
4
If security is enabled for the selected Queue Manager the following dialog box appears:
5
Enter the correct User ID and Password, and click OK to connect.
NOTE: you can only connect to one Queue Manager at a time. If you are connected to one Queue Manager, and try to connect to a second (without disconnecting from the first), the following dialog box appears:
Click ‘Yes’ to disconnect from the current Queue Manager, and ‘No’ to connect to the new Queue Manager.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
86
EMAFTM082/01
Log Viewer
5.5
Extended Log View This function lets you view session properties associated with a particular session. To view session properties: 1
Select the Log Viewer folder.
2
This displays a list of Sessions in the panel
3
Click on the Log you wish to view. An extended view of the Session appears in the right panel.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
87
Log Viewer
5.5.1
View Details of a Session To view the details of a particular session, complete the step described in section 5.5 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
Reckless
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
SetId
Character set. Platform-dependent value: Value
ASCII EBCDIC UNICODE Encoding
Integer Encoding
CurVersion
Current Spazio version
ExtRecLen
Extended Record Length
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
88
EMAFTM082/01
Log Viewer
2
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
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
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
89
Log Viewer
5.5.2
Property
Description
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 Viewer allows log sessions to be filtered according to numerous criteria. To apply a session filter: 1
Click on the Log Viewer Folder
2
Select from the Filter option from the View menu. Alternatively select the Filter button from the toolbar. The following window is displayed
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)
Completion Code
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
90
EMAFTM082/01
Log Viewer
Property
Description OK
Filter using completion code OK
Not OK
Filter using Completion code Not OK
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
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: System Administrator's Guide EMAFTM082/01
91
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
92
EMAFTM082/01
Chapter 6
6.1
SPAZIO Administrator Terminal
Introduction SPAZIO Administrator Terminal is an administration tool for use with SPAZIO in non-Windows environments.
6.1.1
Functionality SPAZIO Administrator Terminal provides similar functionality to SPAZIO Administrator described in Chapters 1 and 2. In addition, it allows you to view and intervene in active transport operations as well as performing a series of operations on files.
6.1.1.1 System Administration SPAZIO Administrator Terminal allows you to perform certain administration tasks for both Local and Remote SPAZIO nodes as follows:
Local Node
View the name and contents of the node.
List Queue Managers, Queues, Queues, DQLs, Communication Lines, Line Conversations Transport Classes, Transport Agents, and Tasks.
View the properties of Queue Managers, Queues, DQLs, Communication Lines, Line Conversations, the Transport Monitor, Transport Classes, Transport Agents, and Tasks.
Activate/deactivate Queue Managers, Communication Lines and the Transport Monitor.
Connect to/disconnect from Queue Managers.
Create/delete Queues, DQLs, and User Classes.
Set trace levels for Queue Managers, Communication Lines and the Transport Monitor. NOTE: set Trace Level operation on a SPAZIO component requires a deactivation/re-activation cycle.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
93
SPAZIO Administrator Terminal
Remote Nodes
View the name and contents of the node.
List Queue Managers, Queues, Queues, DQLs and Line Addresses.
View the properties of Queue Managers, Queues, DQLs, and Line Addresses.
Connect to/disconnect from Queue Managers.
Create/delete Queues, DQLs, and User Classes.
6.1.1.2 Transport Management SPAZIO Administrator Terminal also allows you to manage transports (see section 6.6.2.2: Transport Management). The functions available from this menu allow you to
List all current transport operations
Apply filters to the transport list
For each transport listed
Get details about that transport operation
Stop the transport
Restart the transport
6.1.1.3 File Management SPAZIO Administrator Terminal provides access to a number of file operations:
6.2
Dispatch files
Acquire files
List files and their attributes
Delete files
Installation SPAZIO Administrator is installed as part of the installation of SPAZIO. See the SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide Manual.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
94
EMAFTM082/01
SPAZIO Administrator Terminal
6.3
The SPAZIO Administrator Terminal interface The SPAZIO Administrator Terminal interface consists of a series of screens that allow you to make choices from menus, and in some cases to enter text. Screens are divided into three areas:
The upper panel contains menus from which you can choose various items.
The central panel displays information and also accepts user input.
The bottom of the screen contains an area for displaying status and error messages.
The following table lists the various navigational and input keystrokes: Action
Keystroke
Move down /up a menu
Down arrow / Up arrow
Highlight an item to the right
Home - Right arrow
Highlight an item to the left
End - Left arrow
Confirm selection
Enter
Enter text
Standard keys
Delete text to the left
Backspace
Delete text to the right
Delete
Confirm input
Enter
Return to the previous screen
Esc
Exit the opening screen
Esc
Refresh current information
function key
A self-explicating mnemonic has been added to Reason Code display (“RC”). “WAIT PLEASE” string is now always displayed while program is waiting for answer.
6.4
Opening SPAZIO Administrator Terminal 1
Make sure that SPAZIO is installed and running.
2
From the command line:
3
change directory to SPAZIO\bin
type spadmint
The SPAZIO Administrator Terminal opening screen appears.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
95
SPAZIO Administrator Terminal
6.5
The Main Screen When you open SPAZIO Administrator Terminal the following screen appears:
You can choose one of four items from the menu at the top of the screen: Option
Description
SELECT LOCAL NODE
Lets you perform administration tasks on the Local Node
SELECT REMOTE NODE
Lets you perform administration tasks on Remote Nodes
VERSION INFORMATION
Displays version information about spadmint components
EXIT PROGRAM
Lets you shut SPAZIO Administrator Terminal
Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
96
EMAFTM082/01
SPAZIO Administrator Terminal
6.6
Local Node Management When you choose SELECT LOCAL NODE from the Main screen, the Local Node Management menu appears:
The following table describes the five options in this menu. Option
Description
CURRENT NODE MANAGEMENT
Lets you:
List local/remote nodes and their properties.
List local Queue Managers and their properties.
Activate/deactivate Queue Managers.
View information on events.
Set traces for Queue Managers.
Activate/deactivate the Transport Monitor.
View information on transports.
List transport classes and their properties.
Set the trace level for the Transport Monitor.
List communication lines and their properties.
List line conversations.
Activate/deactivate communication lines.
Set trace levels for communication lines.
List current transactions
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
97
SPAZIO Administrator Terminal
Option
Description
TRANSPORT MONITOR MANAGEMENT
Lets you:
APPLICATION LOG MANAGEMENT
List transports and their status.
Stop/resume transports.
Lets you:
CONNECTION TO QUEUE MANAGER
EXIT
Display the log files.
Lets you:
Connect to a Local Queue Manager
List/create/delete queues
List/create/delete DQLs
List/create/delete user classes
List/dispatch/acquire files
Return to the previous screen
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.6.1
Current Node Management When you select this option from the Local Node Management menu, the Current Node Management menu appears. You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value, and press ENTER (default Connection Timeout = 5 min.). Next you are prompted for a user ID and password. Enter the relevant details and press ENTER.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
98
EMAFTM082/01
SPAZIO Administrator Terminal
This menu contains six options: Option
Description
NODE INFORMATION
View information on local and direct nodes.
QUEUE MANAGERS
List/activate/deactivate Queue Managers.
List events and their properties.
Set the trace level for Queue Managers.
View information on the Transport Monitor and the properties of transport classes.
Activate/deactivate the Transport Monitor.
Set the trace level for the Transport Monitor.
List and view the properties of communication lines.
Activate/deactivate communication lines.
List line conversations.
Set trace levels for communication lines.
TRANSPORT MONITOR
COMMUNICATION LINES
TRANSACTION LIST
List current transactions.
SECURITY MANAGEMENT
Show the current permissions.
Change current permissions
Manage Group and User permissions
EXIT
Return to the Local Node Management menu (see section 6.6).
Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
99
SPAZIO Administrator Terminal
6.6.1.1 Node Information When you choose this option from the Current Node Management menu, the Node Information menu appears:
This menu contains five items: Option
Description
LOCAL NODE
View information on the local node.
DIRECT NODES
View information on direct nodes.
EXIT
Return to the Current Node Management menu (see section 6.6.1).
Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
100
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.1.1.1 Local Node 1
Choose LOCAL NODE from the Node Information menu to display information on the local node:
2
Scroll down this screen to display the following details on the local node:
Local Node Information
Field
Description / Values
Local Node Name
Name of local (current) node.
Local Sys Name
Same as above, but truncated and converted as necessary to have a maximum of 8 UPPER CASE characters.
SpazioProcH
SPAZIO process handle.
SpChronProcH
SPAZIO CHRON process handle.
TraspMonitorH
Transport Monitor handle.
Queue Managers
Field
Description / Values
ExistLocQM
Number of existing local Queue Managers.
ActiveLocQM
Number of active local Queue Managers.
QmName
Local Queue Manager name.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
101
SPAZIO Administrator Terminal
Communication Lines
Field
Description / Values
NumCommLines
Number of communication lines defined on the local node.
ActCommLines
Number of active communication lines.
NumTrans
Total number of transmissions
ActTrans
Number of active transmissions
ActInTrans
Number of active incoming transmissions
ActOutTrans
Number of active outgoing transmissions
NumConvCommLines
Maximum number of conversations on Communication Lines
ActConvCommLines
Number of active conversations on Communication Lines
Line N.x
There is a heading Line N.x for each communication line defined, where x is the integer identifying the line (for example, in the SPLINE.INI configuration file).
Name
Name of the line.
Type
Physical connection type of SPAZIO driver:
Status
Trace
Value
Description
TCP
TCP/IP
ISCL
ISCL (with various protocols)
Activity status of the communication line: Value
Description
ACTIVE
Active
NOT ACTIVE
Not active
Trace level specified for the line Value
Description
0
No trace is set
1
Minimal trace
2
Normal trace
3
Most detailed trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
102
EMAFTM082/01
SPAZIO Administrator Terminal
Maximum Values
Field
Description / Values
MaxRSA
Maximum number of remote PR4 sessions.
MaxDirNodes
Maximum number of direct nodes
MaxQMs
Maximum number of Queue Managers on the local node
MaxQmSess
Maximum number of sessions on the local QM
MaxTrans
Maximum total number of active transactions
MaxActInTrans
Maximum number of transactions active in Input
MaxActOutTrans
Maximum number of transactions active in Output
MaxClientIscSess
Maximum number of ISC sessions allowed
MaxCommLines
Maximum number of non-ISC lines
MaxConvCommLines
Maximum number of Input and Output conversations on each individual non-ISC line
MaxSMonTrPermit
Maximum number of concurrent transports managed by the Transport Monitor
MaxSMonMTrasp
Maximum number of concurrent message transport agents managed by the Transport Monitor
MaxSMonFTrasp
Maximum number of concurrent file transport agents managed by the Transport Monitor
MaxSMonRQueues
Maximum number of Remote Queues on all local Queue Managers managed by the Transport Monitor
MaxSMonTrFile
Maximum number of files to be transported from all local Queue Managers managed by the Transport Monitor
MaxSMonInFile
Maximum number of files transported to local Queue Managers (by PR4 transports).
QmEventLevel
Allowed level of Event Manager for local Queue Managers: Value
Description
0
No Queue Manager event management
1
Basic Queue Manager event management
2
Extended level 1 Queue Manager event management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
103
SPAZIO Administrator Terminal
Field
Description / Values
MaxQmEventParall
Maximum number of parallel events under a Queue Manager
MaxExistQue
Maximum number of queues under the Queue Manager
MaxOpenQue
Maximum number of queues open in a session
MaxOpenFil
Maximum number of files open in a session
QCatMax
Maximum size of the disk file for the Queues Catalog
UsClCatMax
Maximum size of the disk file for the User Classes Catalog
DQLCatMax
Maximum size of the disk file for the DQLs Catalogue
MaxQFileDepth
Maximum number of files in a queue
MaxQMsgDepth
Maximum number of messages in a queue
ClassMaxPSize
Maximum size of a Persistent Repository (on disk) for a Storage Class
ClassMaxNPSize
Maximum size of a Non-Persistent Repository (on disk) for a Storage Class
MaxDE
Maximum number of dynamic events
MaxQueDE
Maximum number of queues with dynamic events.
MaxSEinQue
Maximum number of static events that can be associated with a queue
MaxQueSE
Maximum number of queues with static events
MaxDefSE
Maximum number of default static events
MaxEvDefinitions
Maximum number of event definitions
DynRSA
Dynamic Remote Session Agent
DynSA
Dynamic Session Agent
SpSerialId
Spazio Serial ID.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
104
EMAFTM082/01
SPAZIO Administrator Terminal
Node Options
Field
Description / Values
Options
Time setting for the node:
Encoding
CharSetId
Value
Description
LOCAL TIME
Local time
GLOBAL TIME
Global time
Encoding type. Platform-dependent value: Value
Description
NORMAL
Normal.
REVERSE
Reverse.
Character set. Platform-dependent value: Value
Description
ASCII
ASCII
EBCDIC
EBCDIC
UNICODE
UNICODE
CodePage
Code Page. Default = 0.
EndOfRec
End-of-record marker:
EndOfFile
SpRstDFileMax
Value
Description
NONE
No marker
LF
Line feed
CRLF
Carriage return and Line feed
Presence of EOF marker: Value
Description
NONE
No end-of-file marker
PRESENT
End-of-file marker present
Maximum size on disk of the SPAZIO File Transport Restart file. Default: 5000000.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
105
SPAZIO Administrator Terminal
6.6.1.1.2 Direct Nodes 1
Choose DIRECT NODES from the Node Information menu to list remote direct nodes:
2
Select a node and press ENTER to display information on that node:
3
Scroll down this screen to display the following details on the direct node:
Direct Node Information Field
Description / Values
DirNodeName
Name of the direct node
System Name
Name of the direct node
NodeType
Type of the direct node. Value
Description
0
SPAZIO
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
106
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
MaxMTrasp
Maximum number of message transport agents that can be defined on this node.
MaxFTrasp
Maximum number of file transport agents that can be defined on this node.
Queue Manager Specifications Field
Description
NumQM
Number of Queue Managers defined on the direct node
Queue Manager N.x
There is one Queue Manager N.x section for each Queue Manager defined, where x is the integer identifying the Queue Manager (for example, in the SPRNODE.INI configuration file).
QMName
Name of the Queue Manager.
TrClass
Name of the Transport Class associated with the Queue Manager.
Communication Lines
Field
Description / Values
NumCommLines
Number of communication lines defined on the local node.
Line N.x
There is a heading Line N.x for each communication line defined, where x is the integer identifying the line (for example, in the SPLINE.INI configuration file).
Name
Name of the line
CxStatus
Line status: Value
Description
ACTIVE
Active
NOT ACTIVE
Not active
TimeOut
Timeout for the line.
Address
Address (IP or other type) of the line, that is, the address of the direct node.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
107
SPAZIO Administrator Terminal
6.6.1.2 Queue Managers 1
Choose QUEUE MANAGERS from the Current Node Management menu to list the local Queue Manager(s):
2
Each Queue Manager is listed together with its current status (active in the above example).
3
Select a Queue Manager and press ENTER to display the Queue Manager Operations menu:
This menu contains five options: Option
Description
DEACTIVATE | ACTIVATE QUEUE MANAGER
Deactivate/activate the selected Queue Manager.
QUEUE MANAGER INFO
View the properties of the selected Queue Manager.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
108
EMAFTM082/01
SPAZIO Administrator Terminal
4
Option
Description
QUEUE MANAGER EVENTS
List events associated with the selected Queue Manager, and view their properties.
SET TRACE LEVEL
Set the trace level for the selected Queue Manager.
EXIT
Return to the Queue Manager Operations menu
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.6.1.2.1 Activate / Deactivate Queue Manager Choose this option to deactivate an active Queue Manager, or to activate a deactivated Queue Manager.
6.6.1.2.2 Queue Manager Info 1
Choose QUEUE MANAGER INFO to display information about the local Queue Manager:
2
Scroll down this screen to display the following details on the Queue Manager:
Queue Manager Information
Field
Description / Values
QmProcHandle
Handle for the Queue Manager process.
QM StartUp
Start-up mode for the Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
109
SPAZIO Administrator Terminal
Field
Status
Description / Values Value
Description
MANUAL
Manual start-up
INIT
Automatic start-up
Current status of the Queue Manager Value
Description
ACTIVE
Queue Manager is active
NOT ACT
Queue Manager is not active
QmOptions
Internal value
MaxQMSess
Maximum number of sessions permitted for the Queue Manager.
DynSA
Dynamic Session Agents
Trace
Trace level for the Queue Manager
OneIndex
FastIndex
VirtCatalog
Value
Description
0
No trace
1
Minimal trace
2
Normal trace
3
Most detailed trace
Option for using a single index on storage classes: Value
Description
1
Option is switched on.
0
Option is switched off.
Option to use the SPAM FAST_INDEX for storage classes. Faster, but involves more work in the case of a system failure: Value
Description
1
Option is switched on.
0
Option is switched off.
Option to use the SPAM VIRT file for Queue Manager catalogues. Faster, but involves more work in the case of a system failure: Value
Description
1
Option is switched on.
0
Option is switched off.
MaxExistQueue
Maximum number of Queues under the Queue Manager.
MaxOpenQue
Maximum number of Queues open in a session.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
110
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
MaxOpenFil
Maximum number of files open in a session.
MaxUsrClass
Maximum number of user classes in a session.
QCatMax
Maximum size of the Queue Catalogue file on disk.
UsClCatMax
Maximum size of the User Class file on disk.
DQLCatMax
Maximum size of the DQL Catalogue file on disk.
MaxQFileDepth
Maximum number of files in a Queue belonging to this Queue Manager.
MaxQMsgDepth
Maximum number of messages in a Queue belonging to this Queue Manager.
QmDir
Name of the directory where Queue Manager files are stored.
QmClean
Directions for the Queue Manager Cleaner process. Value
Description
0
QmCleanInterv QmEventMngLev
No clean Clean when the Queue Manager starts 1 up. Clean when the Queue Manager starts 2 up, and then at regular intervals. Time, in hours, between successive cycles of the Queue Manager Cleaner process. Level of the Event Manager: Value
Description
1
Basic Extended
2
Storage Classes Information
Field
Description / Values
TotalClass
Total number of storage classes defined for the Queue Manager
Class ID
Class ID for the Storage Class. There is one section for each class defined.
ClassName
Name of the storage class. Max. 4 characters.
ClassDesc
Description of the storage class.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
111
SPAZIO Administrator Terminal
Field
Description / Values
ClassPath
Path where the class data and class directories are appended.
RepPMax
Maximum size on disk of the class repository file.
RepNPMax
Maximum size of the class repository file in memory.
MsgBodyPMax
Maximum size of the class message body file on disk.
MsgBodyNPMax
Maximum size of the class message body file in memory.
FileInfoPMax
Maximum size on disk of the class File Info file.
Events Information
Field
Description / Values
EvDefinNum
Number of events defined under the Queue Manager.
QueueSEvNum
Number of queues with static events.
StatEvNum
Number of static events.
MaxDE
Maximum number of dynamic events.
MaxQueDE
Maximum number of Queues with dynamic events.
6.6.1.2.3 Queue Manager Events 1
Choose QUEUE MANAGER EVENTS to display the Queue Manager Events menu:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
112
EMAFTM082/01
SPAZIO Administrator Terminal
This menu contains four options:
2
Option
Description
NEW EVENT DEFINITIONS
Create a new event definition
LIST EVENT DEFINITIONS
List current event definitions
LIST EVENT INSTANCE
List current event instances
EXIT
Return to the Queue Manager Operations menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
New Event Definitions 1
Select NEW EVENT DEFINITIONS, the following information is required to define and event definition Field
Description / Values
GroupName
Name of the event group. Maximum 8 characters.
EventName
Name of the event. Maximum 8 characters.
EventDescription
Description of the new Event
Event Body Type
Event Body Type.
Command Type
Value
Description
MINI
Distributed platforms body type
MVS
Mainframe body type
Command type used for the Event Value
Description
COMM
COMM command
SPROC
SPROC command
SHELL
Shell command
Command
User class command
Command parameters
Parameters taken by the command
Event Level
Event Level
Persistence
Value
Description
BASIC
Basic Event definition
EXTENDED
Extented Event definition
Whether the event is persistent: TRUE or FALSE
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
113
SPAZIO Administrator Terminal
Field
Description / Values Value
Description
PERSISTENT
New Event definition is persistent
VOLATILE
New Event definition is volatile
Start Valid Date
Start valid date
End Valid Date
Start valid date
Number of Conditions
Number of conditions Value
Description
ZERO ONE Number of Queues
Number of queues associated with the User class
Queue Name
Queue associated with the User Class
Address Type
Queue Address Type Value
Description
0
SPAZIO
List Event Definition 1
Select LIST EVENT DEFINITION from the Queue Manager Events menu. The following screen appears:
The following information is required to list each Event Definition:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
114
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
GroupName
Name of the event group. Maximum 8 characters.
EventName
Name of the event. Maximum 8 characters.
List Events Instances 1
Select LIST EVENT INSTANCES from the Queue Manager Events menu.
2
The following screen appears:
The following information is required to list each Event Instance: Field
Description / Values
TYPE OF EVENT BODY
Event type. One of the following:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
115
SPAZIO Administrator Terminal
Field
Description / Values Value
Description
MINI
Distributed platforms body type
MVS
Mainframe body type
GroupName
Name of the event group. Maximum 8 characters.
EventName
Name of the event. Maximum 8 characters.
6.6.1.2.4 Set Trace Level 1
Choose SET TRACE LEVEL from the Queue Manager Operations menu to set the trace level for the current Queue Manager:
2
Choose one of the following options and press ENTER: Option
Description / Values
NO TRACE
No trace is set for the Queue Manager.
TRACE LEVEL 1
Minimal trace
TRACE LEVEL 2
Normal trace
TRACE LEVEL 3
Most detailed trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
116
EMAFTM082/01
SPAZIO Administrator Terminal
The message TRACE LEVEL WAS SET appears at the bottom of the screen.
6.6.1.3 Transport Monitor 1
Choose TRANSPORT MONITOR from the Current Node Management menu to display the Transport Monitor menu:
This menu contains the following options: Option
Description
TRANSPORT INFORMATION
View information on file/message transports.
TRANSPORT CLASSES
View properties of transport classes.
ACTIVATE TRANSPORT MONITOR
Activate the Transport Monitor.
DEACTIVATE TRANSPORT MONITOR
Deactivate the Transport Monitor.
SET TRACE LEVEL
Set the trace level for the Transport Monitor.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
117
SPAZIO Administrator Terminal
2
Option
Description
EXIT
Return to the Current Node Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.6.1.3.1 Transport Information 1
Select TRANSPORT INFORMATION from the Transport Monitor menu and press ENTER to display the following screen:
The following table explains the fields in the Transport Monitor Information screen:
Transport Monitor Information
Field
Description / Values
TraspMonitorH
Transport Monitor handle
StartUp
Start up option.
Trace
Value
Description
MANUAL
Manual
INIT
Automatic
Trace level for the Transport Monitor Value
Description
0
No trace is set for the Transport Monitor.
1
Minimal trace
2
Normal trace
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
118
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values Most detailed trace
3 TrMonOptions
Options for the Transport Monitor
AsyncInfo
Asynchronous information support by the Transport Monitor: Value
Description
0
Off
1
On
NumFTrAgent
Number of File Transport Agents.
NumMTrAgent
Number of Message Transport Agents.
MaxMTrFailure
Maximum message transport failures.
6.6.1.3.2 Transport Classes 1
Select TRANSPORT CLASSES from the Transport Monitor menu and press ENTER to display the following screen:
2
Scroll down this screen to display the following details on the transport classes defined for this node: Field
Description / Values
TotQClasses
Total number of Transport Classes.
Transport Class N.x
There is a Transport Class N.x heading for each Transport Class defined.
QClassName
Name of the Transport Class.
StartEnabled
Transports associated with the class are enabled to start
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
119
SPAZIO Administrator Terminal
Field
Description / Values Value
Description
0
Start not enabled
1
Start enabled
FTraspAgent
Name of the File Transport Agent.
FParallTr
File Transport parallelism on a single queue. Number in the range1-4. Default: 1. Note: for FIFO policy for files, FParallTr = 1
MTraspAgent
Name of the Message Transport Agent.
MParallTr
Message Transport parallelism on a single queue. Number in the range1-4. Default: 1. Note: for FIFO policy for messages, MParallTr = 1
Priority
Selection priority of the queue. Number in the range1-10.
NumRetr
Number of retries permitted.
RetrInterval
Interval specified between retries.
Policy
Queue policy: Value
Description
IMMEDIATE
Immediate delivery
INTERVAL
Delivery within specified interval
MaxDelivDelay
Maximum delay before file or message expiry in seconds.
SyncLevel
Number of blocks (in the case of a file) or number of messages before a Sync (ACK1) is requested in the transport. Default: 10
TrAgTimeout
Timeout for Transport Agents.
SuggestFTrBlock
Suggested length of file transport block.
MTrParam
Parameters of the Message Transport Agents.
FTrParam
Parameters of the File Transport Agents.
6.6.1.3.3 Activate Transport Monitor 1
Select ACTIVATE TRANSPORT MONITOR from the Transport Monitor menu and press ENTER to display the following screen:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
120
EMAFTM082/01
SPAZIO Administrator Terminal
2
The message TRANSPORT MONITOR WAS ACTIVATED appears at the bottom of the screen.
6.6.1.3.4 Deactivate Transport Monitor 1
Select DEACTIVATE TRANSPORT MONITOR from the Transport Monitor menu and press ENTER to display the following screen:
2
The message TRANSPORT MONITOR WAS DEACTIVATED appears at the bottom of the screen.
6.6.1.3.5 Set Trace Level 1
Choose SET TRACE LEVEL from the Transport Monitor menu to set the trace level for the Transport Monitor:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
121
SPAZIO Administrator Terminal
3
4
Choose one of the following options and press ENTER to set the trace level: Option
Description / Values
NO TRACE
No trace set for the Transport Monitor.
TRACE LEVEL 1
Minimal trace
TRACE LEVEL 2
Normal trace
TRACE LEVEL 3
Most detailed trace
The message TRACE LEVEL WAS SET appears at the bottom of the screen.
6.6.1.4 Communication Lines 1
Choose COMMUNICATION LINES from the Current Node Management menu to display the Communication Lines menu:
The following menu is displayed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
122
EMAFTM082/01
SPAZIO Administrator Terminal
This menu contains the following options:
2
Option
Description
LINE INFORMATION
View the properties of a communication line.
ACTIVATE LINE
Activate a communication line.
DEACTIVATE LINE
Deactivate a communication line.
LINE CONVERSATIONS
List active conversations on a communication line.
LINE LINKS
Links towards remote systems using ISC protocol
SET TRACE LEVEL
Set the trace level for a communication line.
EXIT
Return to the Current Node Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.6.1.4.1 Line Information 1
Choose LINE INFORMATION from the Communication Lines menu to list lines defined on this node. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
123
SPAZIO Administrator Terminal
2
Select a line and press ENTER to display information on that line:
3
Scroll down this screen to display the following details on the communication line chosen: Field
Description / Values
Name
Name of the communication line.
Status
Current status of the communication line.
Type
LineDirection
Value
Description
ACTIVE
The line is active
NOT ACT
The line is not active
Type of communication driver used by the line. Value
Description
TCP
TCP/IP
ISCL
ISCL (various protocols)
Direction of communication:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
124
EMAFTM082/01
SPAZIO Administrator Terminal
Field
State
StartUp
Trace
Description / Values Value
Description
I
Input only.
O
Output only.
A
Input and output.
Current state of the line Value
Description
NOT ACT
Not active
WAIT
Waiting
LWAIT
Waiting
AVAIL
Available
BUSY
Busy
CLOSING
Closing
Start-up options: Value
Description
MANUAL
Manual
INIT
Automatic
Trace level for the line. Value
Description
0
No trace is set for the line.
1
Minimal trace
2
Normal trace
3
Most detailed trace
Cost
Cost of line usage (to decide which line to use).
TimeOut
Timeout for the line inbound to this node.
DriverHandle
Communication driver handle.
Param
Initialization parameters for the SPAZIO driver.
LocalAddress
Line address for inbound communication lines to the local node.
MaxConv
Maximum number of simultaneously active conversations.
MaxInConv
Maximum number of simultaneously active input conversations.
MaxOutConv
Maximum number of simultaneously active output conversations.
ActConv
Number of active conversations on the line.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
125
SPAZIO Administrator Terminal
Field
Description / Values
ActInConv
Number of active incoming conversations on the line.
ActOutConv
Number of active outgoing conversations on the line.
6.6.1.4.2 Activate Line 1
Choose ACTIVATE LINE from the Communication Lines menu. The following screen appears:
2
Select a line and press ENTER to activate the line. The message LINE WAS ACTIVATED appears at the bottom of the screen.
6.6.1.4.3 Deactivate Line 1
Choose DEACTIVATE LINE from the Communication Lines menu. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
126
EMAFTM082/01
SPAZIO Administrator Terminal
2
Select a line and press ENTER to deactivate the line. The message LINE WAS DEACTIVATED appears at the bottom of the screen.
6.6.1.4.4 Line Conversations 1
Choose LINE CONVERSATIONS from the Communication Lines menu. The following screen appears:
2
Select a line and press ENTER to list active conversations on that line. The message NO CONVERSATIONS appears at the bottom of the screen if there are no active conversations. If there are any active conversations the following fields are displayed: Field
Description / Values
CommLineName
Name of the communication line
ProcHClient
Client process handle
ProcHConv
Conversation process handle
ConvDirection
Direction of the conversation Value
Description
I
Input
O
Output
RemNode
The name of the Remote Node at the other end of the conversation
Status values
Reserved field
Cdata
Reserved field
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
127
SPAZIO Administrator Terminal
6.6.1.4.5 Line Links 1
Choose LINE LINKS from the Communication Lines menu:
The following fields are displayed for each communication line listed. Field
Description / Values
LinkId
Link Identifier
Remote node
Remote node name
Status
Current status of the node. Values can be: Inactive Invoke Reply Active Break Closing Unknown
Conversion Counter
Conversion Counter
Timeout
Node timeout
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
128
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.1.4.6 Set Trace Level 1
Choose SET TRACE LEVEL from the Communication Lines menu to set the trace level for the Communication Line:
2
Choose one of the following options and press ENTER to set the trace level:
4
Option
Description / Values
NO TRACE
No trace set for the communication line.
TRACE LEVEL 1
Normal trace
TRACE LEVEL 2
Minimal trace
TRACE LEVEL 3
Most detailed trace
The message TRACE LEVEL WAS SET appears at the bottom of the screen.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
129
SPAZIO Administrator Terminal
6.6.1.5 Transaction List 1
Choose TRANSACTION LIST from the Current Node Management menu to list current transactions:
2
The current transactions are listed. The message NO TRANSACTIONS appears at the bottom of the screen if there are no current transactions. The following fields are displayed for each transaction listed Field
Description / Values
Id
Internal ID for the transaction
Name
Name of the transaction (for example SPTXSPMN)
Active
Whether the transaction is active
Direct.
ProcHandle
Value
Description
0
Not active
1
Active
Direction of transaction Value
Description
I
Input
0
Output
Process handle (hexadecimal)
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
130
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.1.6
Security Management Choose TRANSACTION LIST from the Current Node Management menu to manage current security settings. The following menu options are displayed: Option
Description / Values
SHOW PERMISSIONS
Displays the current permissions
CHANGE PERMISSIONS
Change the current permissions
GROUP\USERS MANAGEMENT Manage current User and Group permissions EXIT
Exit to the previous menu
6.6.1.6.1 Show Permissions 1
To display the current permissions select Show Permissions from the menu
A full list of permission properties is contained in section 3.3.1.1 - Table of access rights for Nodes.
6.6.1.6.2 Change Permissions 1
To change the current permissions select Change Permissions from the menu.
2
Select The User to be changed.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
131
SPAZIO Administrator Terminal
3
Select YES to confirm the permission change and press ENTER.
6.6.1.6.3 Group\User Management 1
To manage current Users and groups select Groups/Users Management from the menu
2
Select the group or user you wish to change.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
132
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.2
Transport Monitor Management 1
When you select this option from the Local Node Management menu (see section 6.6), the following screen appears:
Default Connection Timeout = 5 min. 2
You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value.
3
Press ENTER to display the Transport Monitor Management menu:
This menu contains three options: Option
Description
SUMMARY INFORMATION
View information on transports.
TRANSPORT MANAGEMENT
Stop/resume/view information on transports.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
133
SPAZIO Administrator Terminal
4
Option
Description
EXIT
Return to the Local Node Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.6.2.1 Summary Information This function provides summary information about transport activity towards and from the current node. 1
When you choose this option from the Transport Monitor Management menu, you are prompted to select a local Queue Manager:
2
Select a local Queue Manager and press ENTER to display the next screen:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
134
EMAFTM082/01
SPAZIO Administrator Terminal
3
Select ALL to view summary information on all remote Queue Managers, or select one of the remote Queue Managers listed to view summary information on that Queue Manager alone.
4
Press ENTER to display the next screen:
5
Select a direction. The options are as follows:
6
Option
Description
ALL
All transports.
MASTER
Master transports only (outgoing)
SLAVE
Slave transports only (incoming)
PULL
Pull transports only (incoming)
Press ENTER to confirm your choice and proceed to the next screen:
This screen lists information on transports, based on the Queue Manager and Direction choices made in the previous two screens.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
135
SPAZIO Administrator Terminal
The following table explains the fields that are listed in the above screen:
7
Field
Description / Values
LocalQm
Name of the local Queue Manager (i.e. on the node to which you are currently logged).
RemoteQm
Name of the Remote Queue Manager(s) in question. This value may be a remote Queue Manager name, or ALL QM.
Type
Type of transport. Value
Description
Master
Master transport.
Slave
Slave transport.
Pull
Pull transport.
Pend
Number of transports with pending status.
Exec
Number of transports with executing status.
Fail
Number of transports with failed status.
Comp
Number of transports with completed status.
Hold
Number of transports with hold status.
Term
Number of transports with terminating status.
Press ESC or ENTER to return to the Transport Monitor Management menu.
6.6.2.2 Transport Management The Transport Management option lets you access increasingly detailed data about transport activities, and allows transport management operations. 1
When you choose this option from the Transport Monitor Management menu, you are prompted to select a local Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
136
EMAFTM082/01
SPAZIO Administrator Terminal
2
Select a local Queue Manager and press ENTER to display the next screen:
3
Select a direction. The options are as follows:
4
Option
Description
MASTER
Master (outgoing) direction.
SLAVE
Slave (incoming) direction.
PULL
Pull (incoming) direction.
Press ENTER to confirm your choice. You are now prompted to specify a status:
The options are as follows: Option
Description
ALL
Any status.
FILTER
Filter on given status.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
137
SPAZIO Administrator Terminal
5
If you select FILTER, you are now prompted to specify which filters you require:
The following are the filters you can choose to apply:
6
Filter
Description
Executing
Transports that are currently executing.
Pending
Transports that are currently pending.
Failed
Transports that have failed.
Completed
Transports that have completed.
Hold
Transports that are on hold.
Terminating
Transports that are currently terminating.
Press ENTER to continue. Transports are now listed according to the criteria specified in the previous three screens:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
138
EMAFTM082/01
SPAZIO Administrator Terminal
The following table explains the fields that are listed in the above screen: Field
Description / Values
LocQm
Name of the local Queue Manager (at one end of the transport).
RemQm
Name of the Remote Queue Manager(s) at the other end of the transport. This value may be a remote Queue Manager name, or ALL.
AT
Address Type.
Status
ENABLED or DISABLED
Type
Type of transport. Value
Description
Master
Master transport
Slave
Slave transport
Pull
Pull transport
Pend
Number of transports with pending status.
Exec
Number of transports with executing status.
Fail
Number of transports with failed status.
Comp
Number of transports with completed status.
Hold
Number of transports with hold status.
Term
Number of transports with terminating status.
Next, select a line in the above screen and press ENTER. The following screen appears:
7
Choose one of the seven actions and press ENTER:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
139
SPAZIO Administrator Terminal
Action
Description
INFO
Get information on transmission(s) to/from the selected remote Queue Manager.
ENABLE
Enable transmission(s) from the local to the selected remote Queue Manager.
DISABLE
Disable transmission(s) from the local to the selected remote Queue Manager.
STOP-ALL
Interrupt all the transmission(s) from the local to the selected remote Queue Manager.
RESUME-ALL
Resume all the transmission(s) from the local to the selected remote Queue Manager.
DEL-ALL
Delete all the transmission(s) from the local to the selected remote Queue Manager.
DELF-ALL
Force the deletion of all the transmission(s) from the local to the selected remote Queue Manager.
8
If you choose STOP-ALL the selected transport operation is stopped:
9
If you choose RESUME-ALL the selected transport operation is resumed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
140
EMAFTM082/01
SPAZIO Administrator Terminal
10 If you choose INFO, the following screen appears:
The following table explains the fields that are listed in the above screen: Field
Description / Values
LocalQm
Name of the local Queue Manager (at one end of the transport).
RemoteQm
Name of the Remote Queue Manager(s) at the other end of the transport. This value may be a remote Queue Manager name, or ALL.
AT
Address type
Remote Queue
There is one line in this screen for each remote queue involved in a transmission
QStatus
Status of the queue Value
Description
Enabled
Enabled
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
141
SPAZIO Administrator Terminal
Field
Description / Values Disabled
Type
Disabled
Type of transport. Value
Description
Master
Master transport.
Slave
Slave transport.
Pull
Pull transport.
Pend
Number of transports with pending status.
Exec
Number of transports with executing status.
Fail
Number of transports with failed status.
Comp
Number of transports with completed status.
Hold
Number of transports with hold status.
Term
Number of transports with terminating status.
11 Next, select a line in the above screen and press ENTER. The following screen appears:
12 Choose one of the three actions and press ENTER: Action
Description
INFO
Get information on the transmission(s) from the selected remote queue.
ENABLE
Enable transmission(s) from the selected remote queue.
DISABLE
Disable transmission(s) from the selected remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
142
EMAFTM082/01
SPAZIO Administrator Terminal
Action
Description
STOP-ALL
Interrupt all the transmission(s) from the remote queue.
RESUME-ALL
Resume all the transmission(s) from the remote queue.
DEL-ALL
Delete all the transmission(s) from the remote queue.
DELF_ALL
Force the deletion of all the transmission(s) from the remote queue.
NEW-TR-ALL
Create a new transport for all the transmission(s) failed from the the selected remote queue.
NOTE: in Step 8 these options were available for a selected Queue Manager. In this step they are available for Queues. 13 If you choose STOP-ALL the selected transport operation is stopped:
14 If you choose RESUME the selected transport operation is resumed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
143
SPAZIO Administrator Terminal
15 If you choose INFO, the following screen appears:
16 If no transports are found, the message NO ITEMS FOUND appears (as above. Otherwise, the following fields are listed for each transport to/from the queue in question: MASTER Field
Description / Values
LocQMgr
Local Queue Manager name
RemQMgr
Remote Queue Manager name
AT
Address Type
LocQueue
Name of the queue under LocQMgr that points to RemQueue.
RemQueue
The queue under RemQMgr to which the LocQueue points.
QAT
The address type of the RemQueue
TranspType
A string which is a combination of one option from each of the following three groups: MASTER SEND FILE or MESSAGE For example, MASTER SEND FILE
Priority
Priority of the queue (value from 0 to 255)
MsgFileId
MsgFileID of the file or message in transmission
Internal N.
Internal number of the file or message
User Class
User Class of the file or message
Internal Session
Internal session number
Ext Token
External token
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
144
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
Status
Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED HOLD EXEC TERMINATING TERMINATING
CorrelId
Correlation ID of the file or message in transmission
TranspName
Name of the transport
StartDate
Start date/time in the format yyyymmdd – hhmmss
Interr.Date
Date/time of interruption in the format yyyymmdd – hhmmss
CompCode
Completion code returned by the transmission
ReasonCode
Reason code returned by the transmission
ErrorSide
Side on which the error occurred
17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions: Action
Description
INFO
Get information on selected transmission.
STOP
Interrupt the transmission.
RESUME
Resume the transmission.
DELETE
Delete the transmission.
NEW-TRASP
Request the Transport Monitor to schedule a new transport for the transmission
FORCE-DELETE
Force deletion of the transmission
19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
145
SPAZIO Administrator Terminal
SLAVE Field
Description / Values
LocQMgr
Local Queue Manager name
RemQMgr
Remote Queue Manager name
AT
Address Type
LocQueue
Name of the queue under LocQMgr that receive from RemQueue.
RemQueue
The queue under RemQMgr that points to the LocQueue
QAT
The address type of the RemQueue
TranspType
The string SLAVE RECEIVE FILE
Priority
Priority of the queue (value from 0 to 255)
MsgFileId
MsgFileID of the file in transmission
Internal N.
Internal number of the file
User Class
User Class of the file
Internal Session
Internal session number
Ext Token
External token
Status
Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED
CorrelId
Correlation ID of the file in transmission
TranspName
Name of the transport
StartDate
Start date/time in the format yyyymmdd – hhmmss
Interr.Date
Date/time of interruption in the format yyyymmdd – hhmmss
CompCode
Completion code returned by the transmission
ReasonCode
Reason code returned by the transmission
ErrorSide
Side on which the error occurred
17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
146
EMAFTM082/01
SPAZIO Administrator Terminal
Action
Description
INFO
Get information on selected transmission.
DELETE
Delete the transmission.
FORCE DELETE
Force deletion of the transmission
19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu. PULL Field
Description / Values
LocQMgr
Local Queue Manager name
RemQMgr
Local Queue Manager name
AT
Address Type
LocQueue
Name of the queue under LocQMgr where the file is received
RemQueue
Name of the queue under LocQMgr where the file is received
QAT
The address type of the LocQueue
TranspType
The string PULL RECEIVE FILE
Priority
Priority of the queue (value from 0 to 255)
MsgFileId
MsgFileID of the file in transmission
Internal N.
Internal number of the file
User Class
User Class of the file
Internal Session
Internal session number
Ext Token
External token
Status
Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED
CorrelId
Correlation ID of the file in transmission
TranspName
Name of the transport
StartDate
Start date/time in the format yyyymmdd – hhmmss
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
147
SPAZIO Administrator Terminal
Field
Description / Values
Interr.Date
Date/time of interruption in the format yyyymmdd – hhmmss
CompCode
Completion code returned by the transmission
ReasonCode
Reason code returned by the transmission
ErrorSide
Side on which the error occurred
17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions: Action
Description
INFO
Get information on selected transmission.
DELETE
Delete the transmission.
FORCE DELETE
Force deletion of the transmission
19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
148
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.3
Application Log Management 1
Select this option from the Local Node Management menu (see section 6.6):
2
You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value.
3
Press ENTER to display the Application Log Management menu.
6.6.3.1 Summarized List 1
Select this option from the Application Log Management menu
2
The summarized list is displayed according to the criteria specified in the following screen:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
149
SPAZIO Administrator Terminal
The following table explains the fields that are listed in the above screen:
3
4
Field
Description / Values
Filter Options
Filtering Options Value
Description
Date\time
Filter using a specific date or time
Log position
Filter using a specific position in the Log
The following fields are specific to Date\Time filtering: Field
Description / Values
Start Date
Date from which to start the filtering Value
Description
Current Date
Start filtering from today
Other date
Choose another date
Start Time
Time from which to start the filtering
End Date
Date from which to end the filtering
End Time
Time from which to end the filtering
The following fields are specific to Log Position filtering: Field
Description / Values
Start Log File
Date from which to start the filtering
Start Log Position
Position from which to start the filtering
End Log File
Date from which to end the filtering
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
150
EMAFTM082/01
SPAZIO Administrator Terminal
5
Field
Description / Values
End Log Position
Position from which to end the filtering
The following fields are common to both filtering techniques. Field
Description / Values
Completion Type
Filter using a specific completion type Value
Description
ALL
Filter using all completion codes
OK
Filter using only OK
FAIL
Filter using only FAIL
Session ID
Filter using a specific session ID
Max Items Returned
Filter by specifying a specific maximum number of items returned.
Elaboration Type
Filter using a specific elaboration type
Elaboration Code
Filter using a specific elaboration code
External Token
Filter using an external token
A summarized list is displayed according to the criteria specified.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
151
SPAZIO Administrator Terminal
6.6.3.2 Extended List 1
Select the Extented List option from the Application Log Management menu
2
The extended list is displayed according to the criteria specified in the following screen:
3
The above fields are explained in the previous section (6.6.3.1 Summarized List).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
152
EMAFTM082/01
SPAZIO Administrator Terminal
A summarized list is displayed according to the criteria specified.
6.6.3.3
User Log 1
Select the User Log (Extended) option from the Application Log Management menu.
The following table explains the fields that are listed in the below screen: Field
Description / Values
File Name Prefix
File name prefix
Filter option
Specific filtering option Value
DATE/TIME LOG POSITION Start Date
Start date
Start time
Start time
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
153
SPAZIO Administrator Terminal
6.6.3.4
Field
Description / Values
End Time
End time
End Date
End date
Session Id
Session ID
Max Items Returned
Maximum number of items that can be returned
Log Level (Elaboration Type)
Elaboration type
Elaboration Code
Elaboration code
Disconnect 1
Select the Disconnect option from the Application Log Management menu to return to the previous menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
154
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.4 Connection to Queue Manager Selecting this option from the Local Node Management menu (see section 6.6) allows you to
Connect to a local Queue Manager and perform a series of operations on the SPAZIO objects that it manages (Queues, DQLs, User Classes and Files)
Restart a previously attempted file dispatch or file acquire operation.
1
When you select this option you are prompted to select a local Queue Manager (there is probably only one):
2
Select the Queue Manager and press ENTER to display the following screen:
Select NORMAL to proceed to the SPAZIO Object Management menu from where you can perform operations on the various objects (see section 6.6.4.1).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
155
SPAZIO Administrator Terminal
Select RESTART to restart a previously attempted file dispatch or file acquire operation (see section 6.6.4.2).
6.6.4.1
Connect to Queue Manager for SPAZIO object management 1
If you selected NORMAL in section 6.6.4, the following screen appears:
The following table explains the above items: 2
3
Connection Timeout (Default 6 min.) is now requested. Field
Description / Values
User Identifier
User ID for connecting to the current Queue Manager. If none is required, leave blank.
User Password
Password for connecting to the current Queue Manager. If none is required, leave blank.
RESTART Info
Specifies information for a restart operation. For a normal connection, select IGNORE.
Log Option
Specifies whether a log file is to be written for the operations that follow. Value
Description
NONE
No log file.
FILE
Log is to be written to a file.
Trace Level
Specifies the trace level.
Log File Name
Name of the log file.
Timeout
Connection timeout
For a normal connection (i.e. not a restart), the only fields you may have to specify are User Identifier and User Password.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
156
EMAFTM082/01
SPAZIO Administrator Terminal
4
Press ENTER to display the Object Management menu:
This menu contains five options:
5
Option
Description
QUEUE MANAGEMENT
List/create/delete queues.
DQL MANAGEMENT
List/create/delete DQLs.
USER CLASS MANAGEMENT
List/create/delete user classes.
FILE MANAGEMENT
List/dispatch/acquire files.
MESSAGE MANAGEMENT
Manage messages
SECURITY MANAGEMENT
Security management
DISCONNECT QM
Disconnect from the current Queue Manager and return to the Local Node Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
157
SPAZIO Administrator Terminal
6.6.4.1.1 Queue Management 1
Select QUEUE MANAGEMENT from the Object Management menu. The following screen appears:
This menu contains four options:
2
Option
Description
CREATE QUEUE
Create a queue.
DELETE QUEUE
Delete a queue.
LIST QUEUES
List queues belonging to the current Queue Manager and their properties.
UPDATE QUEUE
Update a queue
SECURITY
Security options
EXIT MENU
Return to the Object Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
158
EMAFTM082/01
SPAZIO Administrator Terminal
Create Queue 1
Choose CREATE QUEUE from the Queue Management menu to create a new queue. The following screen appears:
2
Fill in the required fields and make relevant selections to specify the attributes of the local or remote queue that you want to create. The following table explains the fields of the Create Queue screen: Field
Description / Values
Queue Name
Mandatory. Name of the Queue. Maximum 8 characters.
Description
Optional. Description of the queue.
Queue Address Type
Mandatory. Address type of the queue to create
Queue Type
Value
Description
SPAZIO
SPAZIO queue type
LOCAUTO
Local automatic queue type
Mandatory. Value
Description
LOCAL
Local queue
REMOTE
Remote queue
Remote Queue Manager
For remote queues only. Mandatory. The Queue Manager that owns the queue in the next field (Remote Queue).
Remote Queue
For remote queues only. Mandatory. The actual queue belonging to a Remote Queue Manager, pointed to by the remote queue being created for remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
159
SPAZIO Administrator Terminal
Field
Description / Values
Remote Queue Address Type
For remote queues only. Remote Queue Address Type. Value
Description
SPAZIO
SPAZIO queue type
LOCAUTO
Local automatic queue type
Remote Queue Type
For remote queues only. Remote Queue Type
Remote Queue Write Password
For remote queues only. Remote Queue Write password
Remote User ID
For remote queues only. User Id for the remote queue
Remote Password
For remote queues only. Password for connecting to the remote Queue Manager
Delivery Mode
For remote queues only. Optional. Specifies the mode of delivery to Remote Queues. Value
Description
CLASS
Delivery is according to the policies specified in a Transport Class.
IMMEDIATE
Delivery is immediate.
HOLD
Delivery is put on hold.
INTERVAL
Delivery is within a specified interval.
Max Delivery Time
(If Delivery Mode = IMMEDIATE). Optional. Maximum time allowed for delivery.
Delivery Start Time
(If Delivery Mode = INTERVAL). Optional. Start of delivery interval.
Delivery End Time
(If Delivery Mode = INTERVAL). Optional. End of delivery interval.
Transport Class
Required only if Delivery Mode=CLASS. Specifies the name of the Transport Class.
Storage Class
Optional. Storage class associated with the queue.
Default User Class
Default User Class
Read Password
Optional. Read password for the queue.
Write Password
Optional. Write password for the queue.
Set Password
Optional. Set password for the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
160
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
Max Message Depth
Optional. Maximum number of messages that can be stored in the queue. Default: 5000.
Max. Message Length
Optional. Default = 30000 Bytes. Maximum length of messages that can be stored in the queue.
Max. File Depth
Optional. Maximum number of files that can be stored in the queue. Default: 5000.
Queue Mode
Whether the queue can be opened in shared mode:
Default Input Open Option
Queue Persistence
3
Value
Description
SHAREABLE
The queue can be opened in shared mode
NOT SHAREABLE
The queue can not be opened in shared mode
How the queue is to be opened by default Value
Description
INPUT SHARED
For shared input
INPUT EXCLUSIVE
For exclusive input
Persistence of the queue Value
Description
PERSISTENT
The queue is persistent
NOT PERSISTENT
The queue is not persistent
If you choose Insert Advanced Parameters (Insert Advanced Parameters = YES), fill in the required fields. The following table explains the advanced parameters: Field
Description
Base Queue Name
Name of the queue to which messages are sent. Max. 8 characters.
Initiation Queue Name Name of the queue for temporary holding the queued messages. Max. 8 characters.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
161
SPAZIO Administrator Terminal
Field
Description
Transmit Queue Name Name of the local queue on which prepared messages destined for a remote queue are temporarily stored Max. 8 characters. Default Priority
Default priority of messages/files on the queue. Range: [0 (min.) ... 9 (max.)]
Success Event Name
Name of the event that will be triggered if a file/message has been transmitted.
Success Event Group Name If a file/message has been transmitted, it is the name of the group that the event belongs to. Name of the event that will be triggered if a file/message has not been transmitted.
Fail Event Name
Fail Event Group Name If a file/message has not been transmitted, it is the name of the group that the event belongs to. Group Name for Submit Events Name of the group assigned by the application to the event associated with the automatic submit defined by this queue. Harden Get Backout
Whether hardening should be used to ensure that the count of the number of times that a message/file has been backed out is accurate. Value
Description
BACKOUT_NOT_HARDENED Default. The count is not hardened BACKOUT_HARDENED The count is hardened Inhibit Get
Specifies whether get operations are allowed Value
Description
GET_ALLOWED Default. Get operations are allowed GET_INHIBITED Get operations are inhibited
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
162
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description
Inhibit Put
Specifies whether messages/files can be put on the queue Value
Description
PUT_ALLOWED Default. Put operations are allowed PUT_INHIBITED Put operations are inhibited Trigger Control
Trigger Type
Specifies whether trigger messages/files are written to the initiation queue Value
Description
OFF
Default. Trigger messages/files not required
ON
Messages/files required
Specifies the condition that initiates a trigger events. When the condition is true, a trigger message/file is sent to the initiation queue. Value
Description
NONE
Default. No trigger message/file
EVERY
Trigger message/file for every message/file
FIRST
Trigger message/file when queue depth goes from 0 to 1.
DEPTH
Trigger message/file when depth threshold exceeded
Trigger Depth
Number of messages/files that will initiate a trigger message/file to the initiation queue. Max. value: 999 999 999.
Trigger Priority
Threshold message/file priority that a message must have before it can cause, or be counted for, a trigger event. Range: [0 (min.) ... 9 (max.)]
Trigger Data
User data that the queue manager includes in the trigger message/file
Usage
Specifies whether the queue is for normal usage or for transmitting messages/file to a remote queue. Value
Description
Normal
Default. Normal usage
Transmission
Transmission queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
163
SPAZIO Administrator Terminal
Field
Description
User Flag
Field used for to classify queues into user defines categories. SPAZIO does not validate the entered value.
Message Delivery Sequence Only for z/OS. Mode in which messages/files are delivered.
Submit Flag
Value
Description
PRIORITY
Default. Messages/files are returned in priority order
FIFO
Messages/files are returned in FIFO order (first in, first out)
For z/OS. Automatic submit attribute. This field identifies the way in which a batch job or an on line procedure event starts when a file is written into the queue. Value
Description
Blank
Default. No submit attribute
1
The event starts every time a message/file is written into the queue
2
The event starts when all messages/file belonging to a previously defined table are written into the queue
3
The event starts when a specific file/message is written into the queue
For Distributed Platforms. It forces the queue default user class for the files and the messages.
Definition Type
Value
Description
16
It forces for messages
32
It forces for files
Queue definition type Value
Description
PREDEFINED
Default. Predefined queue
PERM_DYN
Dynamically defined permanent queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
164
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description TEMP_DYN
Dynamically defined temporary queue
4
Once you have specified the relevant fields, press ENTER to confirm your input.
5
The message QUEUE CREATION OK appears at the bottom of the screen if the queue is created successfully.
Delete Queue 1
Choose DELETE QUEUE from the Queue Management menu to delete an existing queue. The following screen appears listing queues belonging to the current Queue Manager:
2
Select a queue from the list and press ENTER.
3
If the queue is password-protected you are next asked to enter the correct password.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
165
SPAZIO Administrator Terminal
4
Finally, you are asked to either confirm or cancel the deletion operation:
5
If you choose CANCEL OPERATION you are returned to the Queue Management menu (see section 6.6.4.1.1). If you choose CONFIRM QUEUE DELETION, the queue should be deleted and the message QUEUE DELETION OK appears at the bottom of the screen.
Update Queue 1
Choose UPDATE QUEUE from the Queue Management menu to update an existing queue. The following screen appears listing queues belonging to the current Queue Manager:
2
Select a queue you wish to update from the list and press ENTER. The following screen is displayed:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
166
EMAFTM082/01
SPAZIO Administrator Terminal
3
Select UPDATE QUEUE and press ENTER.
4
A list of queue properties is displayed (ro and rw). Select the property you wish to modify and press ENTER.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
167
SPAZIO Administrator Terminal
5
Enter the new value and press ENTER.
6
CONFIRM or CANCEL the operation. A QUEUE UPDATE OK message is displayed if the update has completed successfully.
List Queues 1
Choose LIST QUEUES from the Queue Management menu to list queues belonging to the current Queue Manager:
For each row the following attributes are displayed:
Queue type (SPAZIO in the sample window above)
VF = Number of currently visible files stored in the queue (“not visible” files are those that have expired and those in standby for clean up or the files that are being received but the transfer is not yet completed)
TF = Number of files currently stored in the queue
TM = Number of messages currently stored in the queue
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
168
EMAFTM082/01
SPAZIO Administrator Terminal
2
PM = Number of persistent messages currently stored in the queue
NM = Number of non-persistent messages currently stored in the queue
Queue description (for local queue) or pointed remote Queue and Queue Manager (for remote queue).
Select a queue from the list and press ENTER to display information on that queue:
The following table contains the attributes which may be listed for local or remote queues: Field
Description / Values
Name
Name of the queue.
Type
Type of the queue. Value
Description
LOCAL
The queue is a local queue.
REMOTE
The queue is a remote queue.
Description
Description of the queue.
Remote Queue Manager Name
For remote queues. The name of the Queue Manager on the remote node that owns the queue named in the next field.
Remote Queue Name
For remote queues. It is the name of the queue on the remote node to which the “remote queue” defined on the local node points.
Current Visible File Depth
Number of currently visible files stored in the queue.
Current File Depth
Number of files currently stored in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
169
SPAZIO Administrator Terminal
Field
Description / Values
Current Persistent Depth
Number of persistent messages currently stored in the queue.
Current NonPersistent Depth
Number of non-persistent messages currently stored in the queue.
Queue Identifier
Queue identifier
Base Queue Name
Base queue name for alias queues.
Creation Date
Date when the queue was created.
Creation Time
Time when the queue was created.
Delivery End Time
End of the delivery period.
Delivery Start Time
Start of the delivery period
Fail Event Group Name
Name of the Event Group to which the event in the next field belongs.
Fail Event Name
Name of the event to be executed if transmission fails.
File Default User Class
Default user class to be associated with files.
File Transporter
The File Transport Agent to be used for transmission of files to Remote Queues.
Initiation Queue Name
Name of the initiation queue.
Message Default User Class
Default user class to be associated with messages.
Message Transporter
Message Transport Agent to be used for transmission of messages to Remote Queues.
Remote User ID
User ID for connecting to the remote queue.
Storage Class
Storage class for the queue.
Success Event Group Name
Name of the Event Group to which the event in the next field belongs.
Success Event Name
Name of the event to be executed when transmission is successful.
Transport Class
Transport Class associated with the queue (remote queues only).
Trigger Data
Trigger data
Update Date
Date when the queue was last updated.
Update Time
Time when the queue was last updated.
Transmit Queue Name
Name of the transmit queue
Maximum File Length
Maximum length for files stored in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
170
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
Address Type
Address type of the queue. Value
Description
0
SPAZIO. Default.
Current Message Depth
Number of messages currently stored in the queue.
Default Input Open Option
How the queue is opened by default:
Default Persistence
Value
Description
INPUT SHARED
For shared input
INPUT EXCLUSIVE
For exclusive input
Default persistence for the queue: Value
Description
PERSISTENT
The queue is persistent
NOT PERSISTENT
The queue is not persistent
Default Priority
Default priority for the queue.
Definition Type
Internal value
Delivery Mode
For remote queues only. Optional. Specifies the mode of delivery to Remote Queues. Value
Description
CLASS
Delivery is according to the policies specified in a Transport Class.
IMMEDIATE
Delivery is immediate.
HOLD
Delivery is put on hold.
INTERVAL
Delivery is within a specified interval.
NONE
No delivery mode is specified.
File Open Input Count
Number of files currently opened for input.
File Open Output Count
Number of files currently opened for output
File Transport Parallelism
File Transport parallelism
File Transport Timeout
Timeout for File Transport operations.
Harden Get Backout
Internal value
Index Type
Internal value
Info Area Length
Length of the Information Area
Inhibit Get
Whether GET operations are prohibited.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
171
SPAZIO Administrator Terminal
Field
Description / Values
Inhibit Put
Whether PUT operations are prohibited.
Max Delivery Interval
Maximum length of delivery interval
Max File Depth
Maximum number of files that can be stored in the queue.
Max File Length
Maximum length of file
Max Message Length
Maximum length of messages stored in the queue.
Max Queue Depth
Maximum number of objects (files and messages) that can be stored in the queue.
Max Restart Retry
Maximum number of transmission restarts that can be attempted.
Message Delivery Sequence
Internal value
Message Transport Parallelism
Message transport parallelism.
Message Transfer Timeout
Timeout for message transfer operations.
Open Count
Number of times the queue has been opened.
Open Input Count
Number of times the queue has been opened for input
Open Output Count
Number of times the queue has been opened for output
Queue Identifier
Queue Identifier
Remote Queue Address Type
Address type of the Remote Queue (that is, the queue belonging to a Remote Queue Manager, pointed to by a “remote queue” on the current node). Value
Description
0
SPAZIO. Default.
Remote Queue Type
Type of the Remote Queue.
Restart Interval
Interval specified between restarts.
Retention Interval
Maximum length of time a file or message can be retained in the queue.
Shareability
Whether or not the queue is shareable. Value
Description
SHAREABLE
The queue can be opened in shared mode
NOT SHAREABLE
The queue can not be opened in shared mode
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
172
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values
Submit Flag
Reserved field
Sync Level
Synchronization level (for remote queues only). The number of transmission blocks sent after which the receiver must return an acknowledgement to the sender.
Transport Priority
Priority in selecting the queue (only for remote queues).
Transmission Options
Reserved field
Trigger Control
Reserved field
Trigger Depth
Reserved field
Trigger Priority
Reserved field
Trigger Type
Reserved field
Usage
Reserved field
User Flag
Reserved field.
6.6.4.1.2 DQL Management 1
Select DQL MANAGEMENT from the Object Management menu. The following screen appears:
This menu contains four options: Option
Description
CREATE DQL
Create a DQL.
DELETE DQL
Delete a DQL.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
173
SPAZIO Administrator Terminal
2
Option
Description
LIST DQLS
List DQLs belonging to the current Queue Manager and their properties.
SECURITY
Security options
EXIT MENU
Return to the Object Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
Create DQL 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 class that is the first defined in SPQM.INI. 1
Choose CREATE DQL from the DQL Management menu to create a new DQL. The following screen appears:
The following table explains the above fields: Field
Description / Values
DQL Name
Mandatory. Name of the DQL.
Description
Optional. Description of the DQL.
Sender
Optional. Sender specified for the DQL.
Read Password
Optional. Read password for the DQL.
Write Password
Optional. Write password for the DQL.
Set Password
Optional. Set password for the DQL.
DQL Definition
Mandatory. How the DQL will be defined.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
174
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Definition File
Description / Values Value
Description
DEFINITION FILE
The DQL is created from an existing DQL definition text file.
MENU DRIVEN
The DQL will be created interactively through the following screens.
Only if DQL Definition = DEFINITION FILE. Mandatory. Name of the DQL definition file.
2
If you chose DEFINITION FILE in the DQL Definition field, and specified the file in the Definition File field, press ENTER to create the new DQL.
3
If you chose MENU DRIVEN in the DQL Definition field, the following screen appears, allowing you to add DQL items interactively to the new DQL:
The following table explains the fields in the above screen: Field
Description / Values
Item Level
Nesting level of the item.
Item Type
The type of the SPAZIO object that is currently being added to the DQL. Value
Description
GENERIC QUEUE
A queue of unspecified type.
LOCAL QUEUE
A local queue.
REMOTE QUEUE
A remote queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
175
SPAZIO Administrator Terminal
Field
Description / Values DQL
Another DQL.
QUEUE MAN
A Queue Manager
Queue/QMan Name
The name of the queue or Queue Manager being added to the DQL.
Address Type
Queue Address Type Value
Description
0
SPAZIO. Default.
Password
Password associated with the item being added.
DQL Definition
Choose whether to add another item to the DQL. Value
Description
NEXT ITEM
Add another item to the DQL.
END OF DEFINITION
DQL is complete.
4
If you choose NEXT ITEM in the DQL Definition field, this screen is repeated for another item.
5
If you choose END OF DEFINITION in the DQL Definition field and press ENTER, the new DQL is created.
6
The message DQL CREATION OK appears at the bottom of the screen if the DQL is created successfully.
Delete DQL 1
Choose DELETE DQL from the DQL Management menu to delete an existing DQL. The following screen appears listing DQLs belonging to the current Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
176
EMAFTM082/01
SPAZIO Administrator Terminal
2
Select a DQL from the list and press ENTER.
3
If the DQL is password-protected you are next asked to enter the correct password.
4
Finally, you are asked to either confirm or cancel the deletion operation:
5
If you choose CANCEL OPERATION the deletion is aborted and you are returned to the DQL Management menu (see section 6.6.4.1.2). If you choose CONFIRM DQL DELETION, the DQL is deleted and the message DQL DELETION OK appears at the bottom of the screen.
List DQLs 1
Choose LIST DQLS from the DQL Management menu to list DQLs belonging to the current Queue Manager:
2
Select a DQL and press ENTER to view information on that DQL (if the DQL is password-protected you are prompted for the correct password).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
177
SPAZIO Administrator Terminal
3
The following screen appears, providing information on the selected DQL:
The following table explains the fields in the above screen: Field
Description / Values
DQL NAME
Name of the DQL item.
TYPE
Type of the DQL item Value
Description
Q
DQL
M
Queue Manager
L
Local Queue
R
Remote Queue
G
Generic Queue
ADDR
Address type of the DQL item
LEVEL
Nesting level of the DQL item
6.6.4.1.3 User Class Management 1
Select USER CLASS MANAGEMENT from the Object Management menu. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
178
EMAFTM082/01
SPAZIO Administrator Terminal
This menu contains four options:
2
Option
Description
CREATE CLASS
Create a user class.
DELETE CLASS
Delete a user class.
LIST CLASSES
List user classes belonging to the current Queue Manager and their properties.
UPDATE CLASSES
Update a user class.
EXIT MENU
Return to the Object Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
Create Class 1
Choose CREATE CLASS from the User Class Management menu to create a new user class. The following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
179
SPAZIO Administrator Terminal
The following table explains the fields in the Create Class screen: Option
Description
User Class Name
Mandatory. Name of the user class (maximum 4 alphanumeric characters)
User Class Name
Mandatory. Name of the user class
User Class Description
Optional. Description of the user class
Expiry Hours after Put
Expiry after put operation
Expiry Hours after Read
Expiry after read operation
Expiry Seconds after Put
Optional. Default = unlimited. Number of seconds a file remains in a queue after being put there before it expires.
Expiry Seconds After Read
Optional. Default = unlimited. Number of seconds a file remains in a queue after being read before it expires.
Deletion Mode
Deletion mode for the class. Default = blank.
User class Type
Type of the class. Default = blank. User class deletion mode
User Class deletion Mode Queue Set Name
Name of the Queue Set. Default = blank.
Object Set Name
Name of the object set. Default = blank.
2
Fill in the relevant fields and press ENTER to create the new user class.
3
The message USER CLASS CREATION OK appears at the bottom of the screen if the user class is created successfully.
Delete Class 1
Choose DELETE CLASS from the User Class Management menu to delete an existing user class. The following screen appears listing user classes belonging to the current Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
180
EMAFTM082/01
SPAZIO Administrator Terminal
2
Select a user class from the list and press ENTER. You are asked to either confirm or cancel the deletion operation:
3
If you choose CANCEL OPERATION the deletion is aborted and you are returned to the User Class Management menu (see section 6.6.4.1.3). If you choose CONFIRM CLASS DELETION, the user class should be deleted and the message CLASS DELETION OK appears at the bottom of the screen.
List Classes 1
Choose LIST CLASSES from the User Class Management menu to list user classes belonging to the current Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
181
SPAZIO Administrator Terminal
See section 6.6.4.1.3 for an explanation of the fields enclosed in square brackets that follow the name of each user class in the above screen.
Update Class 1
Choose UPDATE CLASS from the User Class Management menu to list user classes belonging to the current Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
182
EMAFTM082/01
SPAZIO Administrator Terminal
2
A list of the all the current user classes is displayed. Select the user class you wish to update and press ENTER
3
From the next select UPDATE CLASS A list of fileids enclosed in square brackets is displayed.
4
Select the field to be updated and press ENTER.
5
Insert the new value and press ENTER.
6
Confirm the action by selecting CONFIRM CLASS UPDATE or cancel the operation by selecting CANCEL OPERATION
If you choose CONFIRM CLASS UPDATE, the user class should be updated and the message CLASS UPDATE OK appears at the bottom of the screen.
6.6.4.1.4 File Management 1
Select FILE MANAGEMENT from the Object Management menu. The following screen appears:
This menu contains five options:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
183
SPAZIO Administrator Terminal
2
Option
Description
DISPATCH FILE
Dispatch a file.
ACQUIRE FILE
Acquire a file.
LIST FILES
List the files in a queue and their properties.
DELETE FILES
Delete a file from a queue.
EXIT MENU
Return to the Local Node Management menu.
Select the relevant option and press ENTER. The following sections describe the above options in detail.
Dispatch File 1
When you select this option the following screen appears:
2
Select the queue to which you want to dispatch the file and press ENTER.
3
You are then asked to specify the directory containing the file to be dispatched:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
184
EMAFTM082/01
SPAZIO Administrator Terminal
4
Enter a directory path and press ENTER. The files contained in the specified directory are listed:
5
Select a file and press ENTER. The following screen appears:
The following table explains the fields in the above screen: Field
Description / Values
Correlation ID
Correlation ID of the file.
MsgFile ID Filter
Filter on the MsgFileID attribute Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
185
SPAZIO Administrator Terminal
Field
Description / Values
User Class
User class for the file.
Description
Optional. Description for the file.
Expiry After Put
Optional. Default = unlimited. Time that the file will remain in the queue after being put there before it expires.
Expiry After Read
Optional. Default = unlimited. Time that the file will remain in the queue after being read before it expires.
File Type
Whether the file is a binary or data file.
EOR Format
Destination File
Value
Description
BINARY
Binary file (default)
DATA
Data file.
Only specified if File Type = DATA. End-ofrecord marker. Value
Description
DEFAULT
Default for the platform in question.
CRLF
CRLF
LF
LF
Type of the destination file. Value
Description
INTERNAL
Internal file (the file is being transmitted to a SPAZIO queue)
EXTERNAL
External file (the file is being transferred to a destination other than a destination queue)
Destination Name
Only specified if Destination File = EXTERNAL. Destination file name.
Reload Option
File reload option
File Move Type
Type of file movement performed.
Record Type
Value
Description
COPY
The file is copied
LINK
The file is linked
Record type of the file. Value
Description
STREAM
Stream type (default).
FIX LEN
Fixed-length record.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
186
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description / Values VAR LEN
Variable length record.
Record Length
Only specified if Record Type is FIX LEN or VAR LEN. With fixed-length records, it specifies the record length. With variablelength records, it specifies the maximum record length. Default = 32000.
Compression
Type of compression applied to the file. Value
Description
NONE
No compression
BLOCK
Block compression
Priority
Value in the range 0 – 255. Default = 5. Priority of the file in the queue, where 255 represents the highest priority.
Dispatch Option
The manner in which the file is to be dispatched. Value
Description
FILE PUT
The file is dispatched as a whole.
REC BY REC
The file is dispatched one record at a time.
6
Provide the relevant information and press ENTER.
7
The message FILE DISPATCH OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.
Acquire File 1
When you select this option the following screen appears:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
187
SPAZIO Administrator Terminal
2
Select the queue from which you wish to acquire a file and press ENTER.
3
You are now given the option to filter the set of files that will be listed for the selected queue:
4
Specify the fields you wish to use to filter the list of files. The following table explains the above fields:
5
Field
Description
Correlation ID
Correlation ID.
MsgFile ID Filter
Filter on the MsgFileID attribute Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
User Class Filter
Filter on the User Class Name attribute
Sender Filter
Sender name.
Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
188
EMAFTM082/01
SPAZIO Administrator Terminal
6
Select the file that you want to acquire or whose details you wish to view. Press ENTER. The following screen appears:
The following two subsections describe the Acquire File and File Information operations.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
189
SPAZIO Administrator Terminal
Acquire File 1
Select ACQUIRE FILE to acquire the file. Press ENTER. You are then prompted to provide some file acquisition parameters:
The following table explains the above fields: Field
Description
Result File Name
Optional. The name to be given to the file after acquisition.
CodePage Acquire Option Value
Description
FILE ET BY REC Acquisition
Acquisition mode. Value
Description
BROWSE
The file is to be left in the queue after acquisition.
INPUT
The file is to be removed from the queue after acquisition.
2
Once you have specified the relevant parameters, press ENTER to continue.
3
The message FILE ACQUIRE OK appears at the bottom of the screen if the operation is carried out successfully.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
190
EMAFTM082/01
SPAZIO Administrator Terminal
File Information 1
Select FILE INFORMATION to view information about the selected file. Press ENTER. The following screen appears:
The following table describes the fields in the above screen: Field
Description
Internal Number
Internal number of the file.
MessageFile ID
File ID of the file.
User Class
User class associated with the file.
Correlation ID (Bin)
Correlation ID (Binary)
Accounting Token
Reserved field
Original Internal Number
Internal number of the file when it was first dispatched.
Original MessageFile ID
File ID of the file when it was first dispatched.
Queue ID*
Reserved field
Application ID Data
Reserved field
Application Original Data
Reserved field
Arrival Date*
Date the file arrived in the queue.
Arrival Time*
Time that the file arrived in the queue.
Correlation ID (Asc)
Correlation ID (ASCII)
Description
Description of the file.
Expiry Date
Date on which the file will expire in the queue.
Expiry Time
Time at which the file will expire in the queue.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
191
SPAZIO Administrator Terminal
Field
Description
External File Name*
External file name specified for the file.
First Read Date
Date on which the file was first read from the queue.
First Read Time
Time at which the file was first read from the queue.
Format
File format: DATA or BINARY
Internal File Name*
SPAZIO internal file name.
Last Read Date
Date on which the file was last read from the queue.
Last Read Time
Time at which the file was last read from the queue.
Original Queue Name
The name of the queue to which the file was first dispatched.
Original Queue Manager Name
The name of the Queue Manager that owned the above queue.
Original User Class
User class originally associated with the file.
Original Put Date
Date that the file was put in the queue to which it was first dispatched
Original Put Time
Time that the file was put in the queue to which it was first dispatched
Put Application Name
Name of the application that put the file in the queue.
Put Date
Date that the file was put in the current queue.
Put Time
Time that the file was put in the current queue.
Queue Name
Name of the queue where the file is currently stored.
Reply-To Queue
If there is an ACK message is to be sent when the file arrives or is read, the name of the queue to which the ACK is to be sent.
Reply-To Queue Manager
If there is an ACK message is to be sent when the file arrives or is read, the name of the Queue Manager to which the ACK is to be sent.
Sender
Sender name associated with the file.
User ID
User ID
Actual File Length*
Current length of the file in bytes.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
192
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description
Last Byte*
Number of the last byte received.
Object Size
Total length of the data object
Original File Length
Length in bytes of the file when it was first dispatched
Ack Level
ACK level specified for the file.
Backout Count
Internal value
CodePage
Code Page
Coded Char Set ID*
Char Set ID
Context*
Internal value
Counter*
Internal value
DQL Item Number
Internal value
Elaboration Pack*
Internal value
Encoding
Type of encoding
Error Code
Error code returned by Acquisition
Expiry After Get
Time that the file will remain in the queue after being read before it expires. –1 indicates there is no expiry specified.
Expiry After Put
Time that the file will remain in the queue after being put there before it expires. –1 indicates there is no expiry specified.
Feedback
Internal value
File Open Share Count*
Number of files open in shared mode
File Type
Type of the file
Internal Session ID
Internal Session ID
LUW ID*
LUW ID
Max. Block Length
Maximum block length of the file
Max. Record Length
Maximum record length of the file
Max TRX Interval*
Maximum length of transmission interval
Move Type
Move type Value
Description
COPY
File is copied
LINK
File is linked
Message Modality
Internal value
Message Mode*
Internal value
Message Status*
Internal value
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
193
SPAZIO Administrator Terminal
Field
Description
Message Type
Message Type (persistent, non-persistent)
Object Type
Object type
Original ACK Level
ACK level when the file was originally dispatched
Original Coded Char Set ID
Char Set ID originally associated with the file
Original CodePage*
Code Page originally associated with the file
Original Encoding*
Encoding originally specified for the file.
Original Message Modality*
Message modality originally specified for the file.
Original Queue Address Type
Address type of the queue from which the file was sent:
Pack Sequence Number*
Internal value
Persistence
Values: PERSISTENT or NOT PERSISTENT
Priority
Priority of the file. Value in the range 0 – 255, where 255 represents the highest priority.
Put Application Type*
Type of the application that put the file in the queue
Queue Type
Type of the queue where the file is currently stored.
Read Counter*
Internal value
Reply-To Queue Address Type
Address type of the Reply-To Queue.
Report
Internal value
Status*
Internal value
Status Flag
Internal value. It can be: Value
Description
0
Not visible
1
Delete
2
Hold for GET
4
Visible
System-User Area Length
Internal value
Total Blocks
Total blocks transferred
Total Files in Pack*
Total files in the pack
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
194
EMAFTM082/01
SPAZIO Administrator Terminal
Field
Description
Total Records
Total records transferred
Transfer Session
Internal value
Hold Status*
Internal value
Macro Selector
Internal value
Basic Component
Internal value
* If you view the attributes of a file contained in a remote queue on mainframe, the attributes marked with a (*) are listed as (able) because they are not meaningful on mainframe platforms. 3
Press ENTER to return to the File Management menu.
List Files 1
Choose LIST FILES from the File Management menu to list files in a queue belonging to the current Queue Manager:
2
Select a queue and press ENTER. You are now given the option to filter the set of files that will be listed for the selected queue:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
195
SPAZIO Administrator Terminal
3
Specify the fields you wish to use to filter the list of files. The following table explains the above fields:
3
Field
Description
Correlation ID
Correlation identifier
MsgFile ID Filter
Filter on the MsgFileID attribute Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
User Class Filter
Filter on the User Class Name attribute associated with the file.
Sender Filter
Sender name associated with the file.
Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
196
EMAFTM082/01
SPAZIO Administrator Terminal
4
If you select a file and press ENTER, a menu with the following items is displayed: Item
Description
FILE INFORMATION
It allows you to display all the details of the selected file. The fields are fully described in the previous section: File Information.
RE-SUBMIT FILE
Only for files belonging to remote queues. It allows you to resubmit the file. The user must issue the queue write password, if necessary.
UPDATE FILE
It allows you to display all the details and change some of the following parameters of the selected file:
Description
Reply-To Queue
Reply-To Queue Manager
Reply-to Queue Address Type
Status Flag (from value 2 to value 4 for the unlocking of the selected file)
The fields are fully described in the previous section File Information. 5
Press ENTER or ESC to return to the list of files in the preceding screen. From there either chooses another file, or press ENTER or ESC to return to the File Management menu.
Delete Files 1
Choose DELETE FILES from the File Management menu to delete files from a queue belonging to the current Queue Manager:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
197
SPAZIO Administrator Terminal
2
Select a queue and press ENTER.
3
You are now given the option to filter the set of files that will be listed for the selected queue:
4
These fields are described below
5
Field
Description
Sender
Sender name associated with the message
Queue Read password
Read password for the Queue
MsgFile ID Filter
Filter on the MsgFileID attribute Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
User Class Filter
Filter on the User Class Name attribute
Correl ID Filter
Filter on the Correl ID Filter attribute
Sender Filter
Filter on the Sender ID Filter attribute
Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
198
EMAFTM082/01
SPAZIO Administrator Terminal
6
Select the file you wish to delete. Press ENTER. The following screen appears:
6
Select CONFIRM FILE DELETION delete the file. To cancel the deletion select CANCEL OPERATION.
7
Press ENTER or ESC to return to the list of files in the preceding screen. From there either chooses another file, or press ENTER or ESC to return to the File Management menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
199
SPAZIO Administrator Terminal
6.6.4.1.5 Message Management Choose MESSAGE MANAGEMENT from the Object Management menu. The following screen appears:
Put Message 1
To put carry out a Put Message Operation choose PUT MESSAGE from the Message Management menu. The following screen appears:
2
You are asked to select the Queue Address Type you wish to put the message to.
3
Select the Queue you wish to put the message to and press ENTER.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
200
EMAFTM082/01
SPAZIO Administrator Terminal
4
Enter the message criteria.
The fields are explained below. Field
Description
Sender
Sender name associated with the message.
Queue Write password
Write password for the message
Message Source
Message source
Message Persistence
Whether the Message is persistent: TRUE or FALSE
MsgFile ID Value
Message File ID
Message Format
Message format
User Class
User Class of the message
Correlation ID
Correlation ID of the message
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
201
SPAZIO Administrator Terminal
Field
Description
Message Description
Message Description
Expiry secs After Put
Specifies (in seconds)an interval after which messages inserted in the queue will expire.
Expiry Secs After Read
Specifies an interval after which messages read from the queue will expire.
Message Modality
Internal value
Message Type
Message Type (persistent, non-persistent)
Priority
Priority of the queue
ACK Option
Ack type.
5
Provide the relevant information and press ENTER.
6
The message MESSAGE PUT OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.
Get Message 1
To put carry out a Get Message Operation choose GET MESSAGE from the Message Management menu. The following screen appears:
2
You are asked to select the Queue Address Type you wish to get the message from.
3
Select the queue from which you wish to get a message and press ENTER.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
202
EMAFTM082/01
SPAZIO Administrator Terminal
4
You are now given the option to filter the set of files that will be listed for the selected queue:
The fields are explained below. Field
Description
Sender
Sender name associated with the message
Queue Read password
Read password for the Queue
MsgFile ID Filter
Filter on the MsgFileID attribute
User Class Filter
Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
Filter on the User Class Name attribute
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
203
SPAZIO Administrator Terminal
Field
Description
Correl ID Filter
Filter on the Correl ID Filter attribute
Sender Filter
Filter on the Sender ID Filter attribute
4
Provide the relevant information and press ENTER.
5
The message MESSAGE PUT OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.
List Messages 1
Choose LIST MESSAGES from the Queue Management menu to list messages on a Queue:
2
Select a queue and press ENTER. You are now given the option to filter the set of messages that will be listed for the selected queue:
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
204
EMAFTM082/01
SPAZIO Administrator Terminal
3
Specify the fields you wish to use to filter the list of files.
The following table explains the above fields: Field
Description
Sender
Sender name associated with the message
Queue Read password
Read password for the Queue.
MsgFile ID Filter
Filter on the MsgFileID attribute Value
Description
NONE
No MsgFileID filter
ASCII
Include files whose MsgFileID is in ASCII format
BINARY
Include files whose MsgFileID is in Binary format
User Class Filter
Filter on the User Class Name attribute
Correl ID Filter
Filter on the Correl ID Filter attribute
Sender Filter
Filter on the Sender ID Filter attribute
3
Press ENTER to list the message in the selected queue (filtered according to any criteria specified in the previous step):
4
Select the message whose details you wish to view. Press ENTER. The following screen appears:
5
Press ENTER or ESC to return to the list of messages in the preceding screen. From there either chooses another message, or press ENTER or ESC to return to the Message Management menu.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
205
SPAZIO Administrator Terminal
6.6.4.1.6 Security Management 1
Choose SECURITY MANAGEMENT from the Queue Management menu to Manage Security on a Queue Manager:
2
You are now given the option to manage security on a Queue Manager or Queue Definition.
3
Select either QUEUE MANAGER or QUEUE DEF and press ENTER
4
The following menu is displayed (Security Management is explained in section 6.6.1.6).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
206
EMAFTM082/01
SPAZIO Administrator Terminal
6.6.4.1.7 Disconnect QM Choose DISCONNECT QM from the Object Management menu to return to the Local Node Management menu.
6.6.4.2 Connect to Queue Manager to perform a Restart operation 1
Select the CONNECTION TO QUEUE MANAGER option from the Local Node Management menu (see section 6.6), to restart a previously attempted file dispatch or file acquire operation.
2
When you select this option you are prompted to select a local Queue Manager (there is probably only one):
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
207
SPAZIO Administrator Terminal
3
Select the Queue Manager and press ENTER to display the following screen:
4
You are now prompted to select the type of restart operation (which must be either DISPATCH or ACQUISITION), and to enter the name of the restart file:
5
Press ENTER to begin the restart operation. Press ESC to return to the Local Node Management menu (see section 6.6).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
208
EMAFTM082/01
SPAZIO Administrator Terminal
6.7
Remote Node Management 1
When you choose SELECT REMOTE NODE from the Main screen, the Select Node screen appears:
2
Choose a node from the list and press ENTER. The Remote Node Management menu appears:
The following table describes the options in this menu. Option
Description
CURRENT NODE MANAGEMENT
Not implemented for remote node management
TRANSPORT MONITOR MANAGEMENT
Lets you:
List transports and their status.
Stop/resume transports.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
209
SPAZIO Administrator Terminal
Option
Description
APPLICATION LOG MANAGEMENT
Not currently implemented
CONNECTION TO QUEUE MANAGER
Lets you:
Connect to a Local Queue Manager
List/create/delete queues
List/create/delete DQLs
List/create/delete user classes
List/dispatch/acquire files
Return to the Main menu.
EXIT
Select the relevant option and press ENTER. The following sections describe the above options in detail.
6.7.1
Current Node Management These functions (described in section 6.6.1) are not supported for remote nodes.
6.7.2 Transport Monitor Management Follow the instructions in section 6.6.2.
6.7.3
Application Log Management These functions will be implemented in a future release.
6.7.4
Connection to Queue Manager Follow the instructions in section 6.6.4.
6.7.5
Exit Select this option from the Remote Node Management menu (see section 6.7) to return to the Main menu (see section 6.5).
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
210
EMAFTM082/01
SPAZIO Administrator Terminal
6.8
Closing SPAZIO Administrator Terminal Return to the Main screen (pressing ESC as many times as necessary), and either:
Press ESC again, or
Select EXIT PROGRAM and press ENTER.
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01
211
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide
212
EMAFTM082/01