spazio mfts distplatf v2.5 sysadminguide
DESCRIPTION
SPAZIO MFTS DistPlatf v2.5 SysAdminGuideTRANSCRIPT
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: +39 010 27811 Fax: +39 010 8684913 Web: www.primeur.com Mail: [email protected]
Local Agent
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 i
Contents
Contents i
About this Manual iv Purpose iv Reader iv Area Covered iv Recommended Use v Related Publications v Limitations vi Conventions vii
Chapter 1 SPAZIO Administrator: Getting Started 1 1.3 Opening SPAZIO Administrator 1 1.4 The SPAZIO Administrator Interface 3
1.4.1 Title Bar 3 1.4.2 Menu Bar and Drop-down Menus 3 1.4.3 Toolbar 6 1.4.4 Workspace 6 1.4.5 Status Bar 8
1.5 Closing SPAZIO Administrator 8
Chapter 2 Using SPAZIO Administrator 9 2.1 Introduction 9
2.1.1 Local node administration 9 2.1.2 Remote node administration 9
2.2 Notes on Using SPAZIO Administrator 10 2.2.1 A note for users who are new to Windows 10
2.3 System administration operations 10 2.3.1 Queue Managers 10 2.3.2 Queues 18 2.3.3 DQLs 33 2.3.4 User Classes 42 2.3.5 Communication Lines 45 2.3.6 Transport Definitions (Local Node only) 49 2.3.7 Classes By Name (Local Node only) 50 2.3.8 Classes by Protocol (Local Node only) 52 2.3.9 Tasks (Local Node only) 54
2.4 Setting SPAZIO Administrator options 55 2.5 SPAZIO Administrator Help 56
Chapter 3 Security Management 57 3.1 Introduction 57 3.2 Logging in to SPAZIO Administrator 57
3.2.1 Access control for SPAZIO Administrator 57 3.2.2 Login procedure 57
3.3 Node-level security 58 3.3.1 Node permissions 58 3.3.2 Changing access rights for groups 59 3.3.3 Adding groups and setting their access rights 60 3.3.4 Adding users and setting their access rights 62 3.3.5 Removing groups 63
3.4 Queue Manager-level security 64 3.4.1 Accessing Queue Manager security management 64
Contents
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide ii EMAFTM082/01
3.4.2 Queue Manager permissions 65 3.4.3 Default Queue permissions 66 3.4.4 Default DQL permissions 67
3.5 Queue and DQL-level security 69 3.5.1 Queue permissions 69 3.5.2 DQL permissions 70
Chapter 4 Transport Manager 73 4.1 Introduction 73 4.2 A note for users who are new to Windows applications 73 4.3 View or modify Transport Manager runtime options 73
4.3.1 General options 73 4.3.2 Startup options 74 4.3.3 Applying changes to the options 75
4.4 Connecting to a Queue Manager 75 4.4.1 Connect to a Queue Manager 75
4.5 View Transport Route Details (Master) 76 4.5.1 View Session Summary from a Queue Manager 76 4.5.2 View Queue Session Details 78 4.5.3 View file Session Details 79
4.6 View Transport Session Summary (Slave) 81 4.7 View Transport Session Summary (Pull) 81 4.8 File Session Options 82 4.9 Queue Session Options 82
Chapter 5 Log Viewer 83 5.1 Introduction 83 5.2 A note for users who are new to Windows applications 83 5.3 View or modify Log Manager runtime options 83
5.3.1 General options 83 5.3.2 Startup options 84 5.3.3 Color 85 5.3.4 Applying changes to the options 85
5.4 Connecting to a Queue Manager 85 5.4.1 Connect to a Queue Manager 85
5.5 Extended Log View 87 5.5.1 View Details of a Session 88 5.5.2 Apply a filter to Session List 90
Chapter 6 SPAZIO Administrator Terminal 93 6.1 Introduction 93
6.1.1 Functionality 93 6.2 Installation 94 6.3 The SPAZIO Administrator Terminal interface 95 6.4 Opening SPAZIO Administrator Terminal 95 6.5 The Main Screen 96 6.6 Local Node Management 97
6.6.1 Current Node Management 98 6.6.2 Transport Monitor Management 133 6.6.3 Application Log Management 149 6.6.4 Connection to Queue Manager 155
6.7 Remote Node Management 209 6.7.1 Current Node Management 210 6.7.2 Transport Monitor Management 210 6.7.3 Application Log Management 210 6.7.4 Connection to Queue Manager 210 6.7.5 Exit 210
6.8 Closing SPAZIO Administrator Terminal 211
Contents
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 iii
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 iv
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.
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 v
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
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide vi EMAFTM082/01
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.
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 vii
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 ----------------------- T M 1 0 -------------------- SPAZB ----- FUNCTION ===> _ Userid : PRIAMPO Date : 98/02/21 Time : 14:40 0 PARAMETERS Defines User and System parameters 1 QUEUES Defines User Queues 2 CLASSES Defines Classes 3 FILE UTILITIES File Utility functions 4 MESSAGE UTILITIES Message Utility functions 5 TRANSFER Transfers Files to/from Q_Manager 6 LISTS Defines Distribution Lists 7 TRANSMISSION MONITORING Monitors Transmission Status 8 SYSTEM LOG INQUIRY Displays System Log data 9 ACTIVITIES CONTROL Activities control M PRODUCT MAINTENANCE Inquiries/lists installed PTFs T TUTORIAL Displays TM10 manual X EXIT Quits TM10 transaction
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide viii EMAFTM082/01
Text that appears in this format is important information and should be read in all cases.
About this Manual
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 ix
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 1
Chapter 1 SPAZIO Administrator: Getting Started
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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 2 EMAFTM082/01
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 left-hand 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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 3
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
Minimize the window
Maximize / restore the window
Close the window (and the program)
1.4.2 Menu Bar and Drop-down Menus
This lets you access the three SPAZIO Administrator menus: Action, View and Help.
SPAZIO Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 4 EMAFTM082/01
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 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
Set trace level
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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 5
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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 6 EMAFTM082/01
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 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
1.4.4 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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 7
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 Administrator: Getting Started
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 8 EMAFTM082/01
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
The name of the currently selected object, or a status message such as Connecting …
The current date
The current time
1.5 Closing SPAZIO Administrator
To close SPAZIO Administrator, click the close button on the title bar, or choose Action – Exit.
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 EMAFTM082/01 9
Chapter 2 Using SPAZIO Administrator
2.1 Introduction
SPAZIO Administrator allows you to perform certain administration tasks for both Local and Remote SPAZIO nodes as follows:
2.1.1 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.
2.1.2 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 10 EMAFTM082/01
2.2 Notes on Using SPAZIO Administrator
2.2.1 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 11
2.3.1.1 List Queue Managers
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.
2.3.1.2 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 12 EMAFTM082/01
Property Description / Values Options Options for the Queue Manager.
Start-up mode for the Queue Manager:
Value Description 1 Manual
Startup mode
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 for the Queue Manager.
Values:
Value Description 0 No trace 1 Minimal trace 2 Normal trace
Trace Level
3 Most detailed trace
Option for using a single index on storage classes:
Value Description True Option is switched on.
Single Index
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:
Value Description True Option is switched on.
Optimize indices for speed
False Option is switched off. Catalogues in virtual memory only
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 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 13
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.
Directions for the Queue Manager Cleaner process.
Values:
Value Description
0 No clean
1 Clean when the Queue Manager starts up.
Cleaning policy
2 Clean when the Queue Manager starts up, and then at regular intervals.
Cleaning interval (in hours)
Time, in hours, between successive cycles of the Queue Manager Cleaner process.
Level of the Event Manager:
Value Description 1 Basic
Event Manager level
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 14 EMAFTM082/01
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 on the toolbar.
2.3.1.4 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 on the toolbar.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 15
2.3.1.5 Connect to a Queue Manager
1 Select the Queue Manager.
2 Click the Connect button on the toolbar.
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):
2.3.1.6 Disconnect from a Queue Manager
1 Select the Queue Manager.
2 Click the Disconnect button on the toolbar.
2.3.1.7 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 16 EMAFTM082/01
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 17
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 18 EMAFTM082/01
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.2 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, and remote queues by the
icon.
3 The queues are also listed in the right panel:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 19
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.
Whether GET operations are blocked for the queue.
Values:
Value Description True GET operations are blocked.
Inhibit Get
False GET operations are not blocked. Inhibit Put Whether PUT operations are blocked for the
queue: Value Description True PUT operations are blocked.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 20 EMAFTM082/01
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 21
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:
Value Description True GET operations are blocked.
False GET operations are not blocked. Inhibit Put Whether PUT operations are blocked for the
queue: Value Description True PUT operations are blocked.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 22 EMAFTM082/01
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 23
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 24 EMAFTM082/01
2.3.2.4 Create a Local Queue
1 Select the Queues folder.
2 Click the button on the toolbar. The following screen 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 Make sure that Local is selected as the Queue Type.
6 Select Queue Mode, Default Input Open Option and File Default User Class.
The following table explains the fields:
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 25
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.
Mode in which messages are delivered
Value Description FIFO Delivered using First In First
Out mechanism. MVS only
Message Delivery Sequence
Priority Based
Delivered using a priority based mechanism
Whether GET operations are blocked for the queue:
Value Description True GET operations are blocked.
Inhibit Get Operation
False GET operations are not blocked.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 26 EMAFTM082/01
Field Description / Values
Whether PUT operations are blocked for the queue:
Value Description True PUT operations are blocked.
Inhibit Put Operation
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 27
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 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.
6 Click the Advanced tab:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 28 EMAFTM082/01
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.
Mode in which messages are delivered
Value Description FIFO Delivered using First In First
Out mechanism. MVS only.
Message Delivery Sequence
Priority Based
Priority Based
Whether GET operations are blocked for the queue:
Value Description True GET operations are blocked.
Inhibit Get Operation
False GET operations are not blocked.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 29
Field Description / Values
Whether PUT operations are blocked for the queue:
Value Description True PUT operations are blocked.
Inhibit Put Operation
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).
Force Default Class For Files
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
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 30 EMAFTM082/01
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. Interval 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.
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
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 31
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
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 32 EMAFTM082/01
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 button on the toolbar.
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.
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)
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 33
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 = 1 ClassName_1 = CLASS1 ClassDesc_1 = FIRST_CLASS ClassPath_1 = RepPMax_1 = 40000000 RepNPMax_1 = 1000000 MsgBodyPMax_1 = 20000000 MsgBodyNPMax_1 = 800000 FileInfoPMax_1 = 10000000 . .
2.3.3 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 34 EMAFTM082/01
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 If the button on the toolbar is already selected, the properties of the DQL are listed in the right panel:
The properties listed are the name of the DQL, possibly a brief description and the date a time at which the DQL was created.
2.3.3.3 View the items contained in a DQL
1 Click a DQL.
2 If the button on the toolbar is already selected, the items contained in the DQL are displayed in the right panel:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 35
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 Queue Manager: HEATHROW
Local Queue: FROMLIN Local Queue: FROMLINLocal Queue: FROMHRW
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 36 EMAFTM082/01
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 button on the toolbar.
3 The New DQL dialog box appears:
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 37
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 38 EMAFTM082/01
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 39
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 40 EMAFTM082/01
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 41
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 button on the toolbar.
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.
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 42 EMAFTM082/01
2.3.3.7 Modify a DQL
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.
2.3.4 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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 43
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 44 EMAFTM082/01
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: Minutes
Hours
Days Expiry after read 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:
Minutes
Hours
Days Type User Class type Value Description Permanent Permanent User
class Dynamic Allocation 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.
3 Fill in the relevant fields and click OK to create the User Class, or Cancel to cancel the operation.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 45
2.3.4.4 Delete a User Class
1 Select a User Class in the left panel of the workspace.
2 Click the button on the toolbar.
2.3.5 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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 46 EMAFTM082/01
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: Value Description TCP TCP/IP ISCL ISCL (various protocols) Active Whether or not the line is currently active:
Value Description True The line is active.
False The line is not active. Direction 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 47
Property Description / Values Value Description 1 Manual
2 Automatic Trace Level Trace level for the Communication Line:
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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 48 EMAFTM082/01
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 49
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 <INPUT>.
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)
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.
2.3.6 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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 50 EMAFTM082/01
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
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.
2.3.7 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.
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 51
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 52 EMAFTM082/01
Property Description / Values Value Description 0 Immediate delivery.
1 Delivery after interval. Protocol Name File Transport Protocol t used by the class.
2.3.8 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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 53
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 54 EMAFTM082/01
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:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 55
The following table explains the above properties:
Property Description / Values ID Task ID. Name Name of the transaction.
Whether or not the task is active.
Value Description True The task is active.
Active
False The task is not active. Direction Task Direction. Input\Output Proc ID Process ID
2.4 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 password-protected):
2 The Startup tab allows you to specify the start up options on the Queue Manager:
Using SPAZIO Administrator
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 56 EMAFTM082/01
3 The Filters tab allows you to specify a filter, with which to list Queue Managers:
2.5 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 EMAFTM082/01 57
Chapter 3 Security Management
3.1 Introduction
SPAZIO Administrator provides comprehensive security functionality through highly configurable access rights to a range of SPAZIO objects at various levels:
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.
3.2 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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 58 EMAFTM082/01
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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 59
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:
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.
3.3.2 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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 60 EMAFTM082/01
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)
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.
3.3.3 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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 61
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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 62 EMAFTM082/01
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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 63
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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 64 EMAFTM082/01
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.
3.4 Queue Manager-level security
At Queue Manager level, SPAZIO Administrator lets you manage access to three security objects:
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.
3.4.1 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:
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 65
4 You can now choose one of the following sets of Queue Manager security
operations by clicking the relevant Permissions button:
View or set permissions for the Queue Manager (Permissions) - see section 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.
3.4.2 Queue Manager permissions
The following sections list the various access rights and access types (groups of access rights) that can be associated with Queue Managers.
Setting for Queue Managers is performed in the same way as it is for Nodes (see sections 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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 66 EMAFTM082/01
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.
3.4.2.2 Types of Queue Manager access
Four preset types of access are available for Queue Managers:
No Access - all access rights to the Queue Manager are disabled for a specific user or group.
Full Control - all access rights to the Queue Manager are granted for a specific user or group.
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.
3.4.3 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).
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 67
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:
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.
3.4.4 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).
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 68 EMAFTM082/01
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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 69
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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 70 EMAFTM082/01
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:
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.
3.5.2 DQL permissions
The following sections list the various access rights and access types (groups of access rights) that can be associated with DQLs.
Setting permissions for DQLs is performed in the same way as it is for Nodes (see sections 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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 71
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.
Security Management
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 72 EMAFTM082/01
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 73
Chapter 4 Transport Manager
4.1 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 user-modifiable 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.
Transport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 74 EMAFTM082/01
The following table describes the properties listed:
Menu Item Description Node connection timeout
Node connection timeout. Default 600 seconds.
Auto Refresh interval
Set the Auto Refresh interval
4.3.2 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 Connect to node before startup Do not Connect Do not Connect to node on startup
Connect to Node Connect to a specified Node on startup
TTransport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 75
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.
Transport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 76 EMAFTM082/01
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.
TTransport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 77
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 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
5 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
Transport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 78 EMAFTM082/01
The following table describes the Queue properties.
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
4.5.2 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.
TTransport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 79
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 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
4.5.3 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.
Transport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 80 EMAFTM082/01
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
TTransport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 81
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
4.6 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.
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.
4.7 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.
Transport Manager
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 82 EMAFTM082/01
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 EMAFTM082/01 83
Chapter 5 Log Viewer
5.1 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 user-modifiable 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.
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 84 EMAFTM082/01
The following table describes the properties listed:
Menu Item Description Node connection timeout
Node connection timeout. Default 600 seconds.
5.3.2 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 Connect to node before startup Do not Connect Do not Connect to node on startup
Connect to Node Connect to a specified Node on startup
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 85
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:
Item Description Failed Session Change the font color of a failed Session Failed Operation Change the font color of a failed operation
5.3.4 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.
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 86 EMAFTM082/01
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.
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 87
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.
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 88 EMAFTM082/01
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
Character set. Platform-dependent value:
Value ASCII EBCDIC
SetId
UNICODE Encoding Integer Encoding CurVersion Current Spazio version ExtRecLen Extended Record Length
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 89
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
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 90 EMAFTM082/01
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
5.5.2 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 Value Description Start Date Session Start Date End Date Session End Date Start Time Session Start Time
Period
End Time Session End Time Completion Code
Value Description
All Filter using all completion codes (default)
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 91
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
Log Viewer
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 92 EMAFTM082/01
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 93
Chapter 6 SPAZIO Administrator Terminal
6.1 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 94 EMAFTM082/01
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:
Dispatch files
Acquire files
List files and their attributes
Delete files
6.2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 95
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 <F5> 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:
change directory to SPAZIO\bin
type spadmint
3 The SPAZIO Administrator Terminal opening screen appears.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 96 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 97
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 98 EMAFTM082/01
Option Description TRANSPORT MONITOR MANAGEMENT
Lets you:
List transports and their status.
Stop/resume transports. APPLICATION LOG MANAGEMENT
Lets you:
Display the log files. 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 EXIT 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 99
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. TRANSPORT MONITOR 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. COMMUNICATION LINES List and view the properties of
communication lines.
Activate/deactivate communication lines.
List line conversations.
Set trace levels for 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 100 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 101
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 102 EMAFTM082/01
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: Value Description TCP TCP/IP ISCL ISCL (with various protocols)
Activity status of the communication line:
Value Description ACTIVE Active
Status
NOT ACTIVE Not active
Trace level specified for the line
Value Description 0 No trace is set 1 Minimal trace 2 Normal trace
Trace
3 Most detailed trace
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 103
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 104 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 105
Node Options
Field Description / Values
Time setting for the node:
Value Description LOCAL TIME Local time
Options
GLOBAL TIME Global time
Encoding type. Platform-dependent value:
Value Description NORMAL Normal.
Encoding
REVERSE Reverse.
Character set. Platform-dependent value:
Value Description ASCII ASCII EBCDIC EBCDIC
CharSetId
UNICODE UNICODE CodePage Code Page. Default = 0.
End-of-record marker:
Value Description NONE No marker LF Line feed
EndOfRec
CRLF Carriage return and Line feed
Presence of EOF marker:
Value Description NONE No end-of-file marker
EndOfFile
PRESENT End-of-file marker present SpRstDFileMax Maximum size on disk of the SPAZIO File
Transport Restart file. Default: 5000000.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 106 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 107
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
Line status:
Value Description ACTIVE Active
CxStatus
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 108 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 109
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
4 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 110 EMAFTM082/01
Field 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
Status
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 level for the Queue Manager
Value Description 0 No trace 1 Minimal trace 2 Normal trace
Trace
3 Most detailed trace
Option for using a single index on storage classes:
Value Description 1 Option is switched on.
OneIndex
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.
FastIndex
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.
VirtCatalog
0 Option is switched off. MaxExistQueue Maximum number of Queues under the Queue
Manager. MaxOpenQue Maximum number of Queues open in a session.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 111
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 No clean 1 Clean when the Queue Manager starts
up. 2 Clean when the Queue Manager starts
up, and then at regular intervals. QmCleanInterv Time, in hours, between successive cycles of the
Queue Manager Cleaner process.
Level of the Event Manager:
Value Description
1 Basic
QmEventMngLev
2 Extended
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 112 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 113
This menu contains four options:
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.
2 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.
Value Description MINI Distributed platforms body
type
Event Body Type
MVS Mainframe body type
Command type used for the Event
Value Description COMM COMM command SPROC SPROC command
Command Type
SHELL Shell command Command User class command Command parameters Parameters taken by the command
Event Level
Value Description BASIC Basic Event definition
Event Level
EXTENDED Extented Event definition Persistence Whether the event is persistent: TRUE or
FALSE
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 114 EMAFTM082/01
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
Value Description ZERO
Number of Conditions
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 115
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 116 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 117
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 118 EMAFTM082/01
Option Description EXIT Return to the Current Node Management
menu.
2 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
Start up option.
Value Description MANUAL Manual
StartUp
INIT Automatic
Trace level for the Transport Monitor
Value Description 0 No trace is set for the Transport
Monitor. 1 Minimal trace
Trace
2 Normal trace
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 119
Field Description / Values 3 Most detailed trace
TrMonOptions Options for the Transport Monitor
Asynchronous information support by the Transport Monitor:
Value Description 0 Off
AsyncInfo
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 120 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 121
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 122 EMAFTM082/01
3 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
4 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 123
This menu contains the following options:
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.
2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 124 EMAFTM082/01
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.
Current status of the communication line.
Value Description ACTIVE The line is active
Status
NOT ACT The line is not active Type Type of communication driver used by the line. Value Description TCP TCP/IP ISCL ISCL (various protocols) LineDirection Direction of communication:
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 125
Field Description / Values Value Description I Input only. O Output only. A Input and output.
State 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
StartUp
INIT Automatic
Trace level for the line.
Value Description 0 No trace is set for the line. 1 Minimal trace 2 Normal trace
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 126 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 127
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
Direction of the conversation
Value Description I Input
ConvDirection
O Output RemNode The name of the Remote Node at the other end of
the conversation Status values Reserved field Cdata Reserved field
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 128 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 129
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:
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
4 The message TRACE LEVEL WAS SET appears at the bottom of the screen.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 130 EMAFTM082/01
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)
Whether the transaction is active
Value Description 0 Not active
Active
1 Active
Direction of transaction
Value Description I Input
Direct.
0 Output ProcHandle Process handle (hexadecimal)
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 131
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 132 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 133
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 134 EMAFTM082/01
Option Description EXIT Return to the Local Node Management
menu.
4 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 135
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:
Option Description ALL All transports. MASTER Master transports only (outgoing) SLAVE Slave transports only (incoming) PULL Pull transports only (incoming)
6 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 136 EMAFTM082/01
The following table explains the fields that are listed in the above screen:
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.
7 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 137
2 Select a local Queue Manager and press ENTER to display the next screen:
3 Select a direction. The options are as follows:
Option Description MASTER Master (outgoing) direction. SLAVE Slave (incoming) direction. PULL Pull (incoming) direction.
4 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 138 EMAFTM082/01
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:
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.
6 Press ENTER to continue. Transports are now listed according to the criteria specified in the previous three screens:
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 139
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 140 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 141
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
Status of the queue
Value Description
QStatus
Enabled Enabled
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 142 EMAFTM082/01
Field Description / Values Disabled 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.
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 143
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 144 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 145
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 146 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 147
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 148 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 149
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 150 EMAFTM082/01
The following table explains the fields that are listed in the above screen:
Field Description / Values
Filtering Options
Value Description Date\time Filter using a specific date or time
Filter Options
Log position
Filter using a specific position in the Log
3 The following fields are specific to Date\Time filtering:
Field Description / Values
Date from which to start the filtering
Value Description Current Date Start filtering from today
Start Date
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
4 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 151
Field Description / Values End Log Position
Position from which to end the filtering
5 The following fields are common to both filtering techniques.
Field Description / Values
Filter using a specific completion type
Value Description ALL Filter using all completion codes OK Filter using only OK
Completion Type
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 152 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 153
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
Specific filtering option
Value DATE/TIME
Filter option
LOG POSITION Start Date Start date Start time Start time
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 154 EMAFTM082/01
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
6.6.3.4 Disconnect
1 Select the Disconnect option from the Application Log Management menu to return to the previous menu.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 155
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 156 EMAFTM082/01
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 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.
Specifies whether a log file is to be written for the operations that follow.
Value Description NONE No log file.
Log Option
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
3 For a normal connection (i.e. not a restart), the only fields you may have to specify are User Identifier and User Password.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 157
4 Press ENTER to display the Object Management menu:
This menu contains five options:
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.
5 Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 158 EMAFTM082/01
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:
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.
2 Select the relevant option and press ENTER. The following sections describe the above options in detail.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 159
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 Value Description SPAZIO SPAZIO queue type LOCAUTO Local automatic queue type 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 160 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 161
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:
Value Description SHAREABLE The queue can be opened
in shared mode NOT SHAREABLE The queue can not be
opened in shared mode Default Input Open Option
How the queue is to be opened by default
Value Description INPUT SHARED For shared input INPUT EXCLUSIVE For exclusive input Queue Persistence Persistence of the queue Value Description PERSISTENT The queue is
persistent NOT PERSISTENT The queue is not
persistent
3 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 162 EMAFTM082/01
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.
Fail Event Name Name of the event that will be triggered if a file/message has not been transmitted.
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 163
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 Specifies whether trigger messages/files are
written to the initiation queue Value Description OFF Default. Trigger messages/files not
required ON Messages/files required Trigger Type 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 164 EMAFTM082/01
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. Value Description PRIORITY Default. Messages/files are
returned in priority order FIFO Messages/files are
returned in FIFO order (first in, first out)
Submit Flag 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.
Value Description 16 It forces for messages 32 It forces for files Definition Type Queue definition type Value Description PREDEFINED Default. Predefined queue PERM_DYN Dynamically defined
permanent queue
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 165
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 166 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 167
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 168 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 169
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).
2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 170 EMAFTM082/01
Field Description / Values Current Persistent Depth
Number of persistent messages currently stored in the queue.
Current Non-Persistent 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 171
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.
How the queue is opened by default:
Value Description INPUT SHARED For shared input
Default Input Open Option
INPUT EXCLUSIVE For exclusive input
Default persistence for the queue:
Value Description PERSISTENT The queue is persistent
Default Persistence
NOT PERSISTENT The queue is not persistent Default Priority Default priority for the queue. Definition Type Internal value
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.
Delivery Mode
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 172 EMAFTM082/01
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.
Whether or not the queue is shareable.
Value Description SHAREABLE The queue can be
opened in shared mode
Shareability
NOT SHAREABLE The queue can not be opened in shared mode
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 173
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 174 EMAFTM082/01
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.
2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 175
Field 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.
Definition File 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 176 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 177
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 178 EMAFTM082/01
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 of the DQL item
Value Description Q DQL M Queue Manager L Local Queue R Remote Queue
TYPE
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 179
This menu contains four options:
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.
2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 180 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 181
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 182 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 183
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 184 EMAFTM082/01
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.
2 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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 185
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.
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter
MsgFile ID Filter
ASCII Include files whose MsgFileID is in ASCII format
BINARY Include files whose MsgFileID is in Binary format
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 186 EMAFTM082/01
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.
Whether the file is a binary or data file.
Value Description BINARY Binary file (default)
File Type
DATA Data file.
Only specified if File Type = DATA. End-of-record marker.
Value Description DEFAULT Default for the platform in
question. CRLF CRLF
EOR Format
LF LF
Type of the destination file.
Value Description INTERNAL Internal file (the file is being
transmitted to a SPAZIO queue)
Destination File
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
Type of file movement performed.
Value Description COPY The file is copied
File Move Type
LINK The file is linked
Record type of the file.
Value Description STREAM Stream type (default).
Record Type
FIX LEN Fixed-length record.
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 187
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 variable-length records, it specifies the maximum record length. Default = 32000.
Type of compression applied to the file.
Value Description NONE No compression
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.
The manner in which the file is to be dispatched.
Value Description FILE PUT The file is dispatched as a
whole.
Dispatch Option
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 188 EMAFTM082/01
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:
Field Description Correlation ID Correlation ID.
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter
MsgFile ID 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.
5 Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 189
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 190 EMAFTM082/01
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
Value Description FILE ET
Acquire Option
BY REC
Acquisition mode.
Value Description BROWSE The file is to be left in the queue after
acquisition.
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 191
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 192 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 193
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
Value Description COPY File is copied
Move Type
LINK File is linked Message Modality Internal value Message Mode* Internal value Message Status* Internal value
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 194 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 195
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 <NOT AVAIL>(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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 196 EMAFTM082/01
3 Specify the fields you wish to use to filter the list of files.
The following table explains the above fields:
Field Description Correlation ID Correlation identifier
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter ASCII Include files whose MsgFileID is in
ASCII format
MsgFile ID Filter
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.
3 Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 197
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 198 EMAFTM082/01
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
Field Description Sender Sender name associated with the message Queue Read password
Read password for the Queue
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter ASCII Include files whose MsgFileID is
in ASCII format
MsgFile ID Filter
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
5 Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 199
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 200 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 201
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 202 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 203
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
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter ASCII Include files whose MsgFileID is
in ASCII format
MsgFile ID Filter
BINARY Include files whose MsgFileID is in Binary format
User Class Filter Filter on the User Class Name attribute
SPAZIO Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 204 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 205
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.
Filter on the MsgFileID attribute
Value Description NONE No MsgFileID filter ASCII Include files whose MsgFileID
is in ASCII format
MsgFile ID Filter
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 206 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 207
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 208 EMAFTM082/01
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 209
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 210 EMAFTM082/01
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 EXIT Return to the Main menu.
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01 211
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 Administrator Terminal
SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide 212 EMAFTM082/01