SPAZIO MFTS DistPlatf v2.5 SysAdminGuide

March 7, 2017 | Author: cantanna | Category: N/A
Share Embed Donate


Short Description

Download SPAZIO MFTS DistPlatf v2.5 SysAdminGuide...

Description

SPAZIO MFT/S for Distributed Platforms System Administrator's Guide Version 2 Release 5

EMAFTM082/01 - September 2010

SPAZIO MFT/S for Distributed Platforms System Administrator’s Guide

Date of issue

Reference number

Brief description

September 2010

EMAFTM082/01

First edition - ver. 2.5

Copyright © 2010 Primeur Ltd. All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Primeur Ltd. Primeur Ltd may revise this publication from time to time without notice. A new release of this manual contains changes made to the product since the previous version. The software product that this manual documents is the exclusive property of Primeur Ltd. The use of this software is governed by the license agreement that accompanies the product. The following conditions must be observed in all cases: „

The product may be used only on the number of computers for which the client is licensed.

„

The client may make only one copy of the product, and this only for backup purposes.

„

The client may not reverse engineer, decompile, or disassemble the product.

„

The client may not loan, rent or lease neither the product, nor any of the documentation or user manuals related to the product, whether this is for free or for a fee.

Primeur Ltd warrants that the product will perform substantially in accordance with the accompanying product manual(s). Primeur Ltd disclaims all other warranties either expressed or implied. Primeur Ltd and its suppliers shall not be liable for any damages whatsoever (including damages for loss of business profits, business interruption, loss of business information or other pecuniary loss) arising out of the use of, or inability to use, the product. SPAZIO, SPAZIO MFT/S, SPAZIO Orchestration Suite, SPAZIO FTFI, SPAZIO Messaging & Queuing, SPAZIO M&Q, SPAZIO File Transport, SPAZIO Data Extract, SPAZIO Legacy Interface, SPAZIO Data Secure, SPAZIO DSSP, SPAZIO DSMQ, SPAZIO Data Compress, SPAZIO JMS and THEMA are trademarks of Primeur Ltd. Other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such.

Company Headquarters Corso Paganini 3 16125 Genova Italy Tel: Fax:

+39 010 27811 +39 010 8684913

Web: Mail:

www.primeur.com [email protected]

Local Agent

Contents

Contents About this Manual Purpose Reader Area Covered Recommended Use Related Publications Limitations Conventions Chapter 1 SPAZIO Administrator: Getting Started 1.3 Opening SPAZIO Administrator 1.4 The SPAZIO Administrator Interface 1.4.1 Title Bar 1.4.2 Menu Bar and Drop-down Menus 1.4.3 Toolbar 1.4.4 Workspace 1.4.5 Status Bar 1.5 Closing SPAZIO Administrator

i iv iv iv iv v v vi vii 1 1 3 3 3 6 6 8 8

Chapter 2 Using SPAZIO Administrator 2.1 Introduction 2.1.1 Local node administration 2.1.2 Remote node administration 2.2 Notes on Using SPAZIO Administrator 2.2.1 A note for users who are new to Windows 2.3 System administration operations 2.3.1 Queue Managers 2.3.2 Queues 2.3.3 DQLs 2.3.4 User Classes 2.3.5 Communication Lines 2.3.6 Transport Definitions (Local Node only) 2.3.7 Classes By Name (Local Node only) 2.3.8 Classes by Protocol (Local Node only) 2.3.9 Tasks (Local Node only) 2.4 Setting SPAZIO Administrator options 2.5 SPAZIO Administrator Help

9 9 9 9 10 10 10 10 18 33 42 45 49 50 52 54 55 56

Chapter 3 Security Management 3.1 Introduction 3.2 Logging in to SPAZIO Administrator 3.2.1 Access control for SPAZIO Administrator 3.2.2 Login procedure 3.3 Node-level security 3.3.1 Node permissions 3.3.2 Changing access rights for groups 3.3.3 Adding groups and setting their access rights 3.3.4 Adding users and setting their access rights 3.3.5 Removing groups 3.4 Queue Manager-level security 3.4.1 Accessing Queue Manager security management

57 57 57 57 57 58 58 59 60 62 63 64 64

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

i

Contents

3.4.2 Queue Manager permissions 3.4.3 Default Queue permissions 3.4.4 Default DQL permissions 3.5 Queue and DQL-level security 3.5.1 Queue permissions 3.5.2 DQL permissions

65 66 67 69 69 70

Chapter 4 Transport Manager 4.1 Introduction 4.2 A note for users who are new to Windows applications 4.3 View or modify Transport Manager runtime options 4.3.1 General options 4.3.2 Startup options 4.3.3 Applying changes to the options 4.4 Connecting to a Queue Manager 4.4.1 Connect to a Queue Manager 4.5 View Transport Route Details (Master) 4.5.1 View Session Summary from a Queue Manager 4.5.2 View Queue Session Details 4.5.3 View file Session Details 4.6 View Transport Session Summary (Slave) 4.7 View Transport Session Summary (Pull) 4.8 File Session Options 4.9 Queue Session Options

73 73 73 73 73 74 75 75 75 76 76 78 79 81 81 82 82

Chapter 5 Log Viewer 5.1 Introduction 5.2 A note for users who are new to Windows applications 5.3 View or modify Log Manager runtime options 5.3.1 General options 5.3.2 Startup options 5.3.3 Color 5.3.4 Applying changes to the options 5.4 Connecting to a Queue Manager 5.4.1 Connect to a Queue Manager 5.5 Extended Log View 5.5.1 View Details of a Session 5.5.2 Apply a filter to Session List

83 83 83 83 83 84 85 85 85 85 87 88 90

Chapter 6 SPAZIO Administrator Terminal 6.1 Introduction 6.1.1 Functionality 6.2 Installation 6.3 The SPAZIO Administrator Terminal interface 6.4 Opening SPAZIO Administrator Terminal 6.5 The Main Screen 6.6 Local Node Management 6.6.1 Current Node Management 6.6.2 Transport Monitor Management 6.6.3 Application Log Management 6.6.4 Connection to Queue Manager 6.7 Remote Node Management 6.7.1 Current Node Management 6.7.2 Transport Monitor Management 6.7.3 Application Log Management 6.7.4 Connection to Queue Manager 6.7.5 Exit 6.8 Closing SPAZIO Administrator Terminal

93 93 93 94 95 95 96 97 98 133 149 155 209 210 210 210 210 210 211

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

ii

EMAFTM082/01

Contents

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

iii

About this Manual

Purpose This manual is a guide to SPAZIO Managed File Transfer/Secure (SPAZIO MFT/S) system administration for distributed platforms. It primarily provides the reader with a description of the SPAZIO Administrator graphical interface for use in Windows environments, and its menu-driven counterpart, SPAZIO Administrator Terminal, for use in non-Windows environments. The manual provides a step-by-step description of system administration tasks, for example: „

Creating Queues, DQLs and User Classes

„

Viewing information on existing SPAZIO objects

„

User intervention such as activating/deactivating Queue Managers, Communication Lines and the Transport Monitor, as well as setting trace levels for these objects

„

Listing, setting and modifying security settings.

Reader This manual is provided for the SPAZIO system administrator. It is assumed that the reader has reasonable knowledge of SPAZIO and of the relevant Windows or UNIX operating systems. Programming knowledge is not required, but any familiarity with SPAZIO objects from the point of view of using, installing or configuring SPAZIO would be an advantage.

Area Covered The manual is organized as follows: „

Chapter 1: SPAZIO Administrator: Getting Started describes the graphical interface for Windows-based SPAZIO administration.

„

Chapter 2: Using SPAZIO Administrator describes the range of operations that can be performed using SPAZIO Administrator.

„

Chapter 3: Security Management describes how security is implemented through SPAZIO Administrator.

„

Chapter 4: Transport Manager describes how to view session details of File/Message transport session.

„

Chapter 5: Log Viewer describes how to to view details of any active or inactive SPAZIO session.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

iv

About this Manual

„

Chapter 6: SPAZIO Administrator Terminal describes the menu-driven interface available for non-Windows environments.

Recommended Use This manual should be read by any SPAZIO user who has to perform system administration tasks. The reader will find the SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide particularly helpful for understanding the configuration of a SPAZIO environment.

Related Publications A comprehensive suite of manuals is provided to support the implementation and usage of SPAZIO MFT/S. These manuals are divided into three categories: „

z/OS - manuals related to the z/OS Mainframe platform

„

Distributed platforms - manuals related to the non-Mainframe platforms including SPAZIO workstation

„

General - manuals related both the Mainframe and non-Mainframe platforms.

The key manuals for z/OS are: „

SPAZIO MFT/S for z/OS: Customization and Configuration Guide

„

SPAZIO MFT/S for z/OS: System Administrator’s Guide

„

SPAZIO MFT/S for z/OS: File Transport User's Guide

„

SPAZIO MFT/S for z/OS: Messages and Codes

„

SPAZIO MFT/S for z/OS: Extended Event Manager Administrator's Guide

„

SPAZIO MFT/S for z/OS: Application Log Administrator's Guide

The key manuals for Distributed Platforms are: „

SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide

„

SPAZIO MFT/S for Distributed Platforms: System Administrator’s Guide

„

SPAZIO MFT/S for Distributed Platforms: File Transport User's Guide

„

SPAZIO MFT/S for Distributed Platforms: SPXP Transports

„

SPAZIO MFT/S for Distributed Platforms: Extended Event Manager Administrator's Guide

„

SPAZIO MFT/S for Distributed Platforms: Messages and Codes

„

SPAZIO MFT/S for Distributed Platforms: Static Agenda User's Guide

„

SPAZIO MFT/S for Distributed Platforms: Management Console Guide

„

SPAZIO MFT/S for Distributed Platforms: Release Notes

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

v

About this Manual

The key general manuals are: „

Data Secure for SPAZIO (DSSP): Installation, Configuration and User Guide

„

Data Secure for SPAZIO MFT/S Open Protocols (DSSP Open): Installation, Configuration and User Guide

„

AAA Security for SPAZIO MFT/S (A3SP): Installation, Configuration and User Guide

Limitations SPAZIO only supports the use of the STANDARD ASCII table in the following: „

pathnames

„

Description fields

The STANDARD ASCII table includes the following characters: „

0123456789

„

abcdefghijklmnopqrstuvwxyz

„

ABCDEFGHIJKLMNOPQRSTUVWXYZ

„

!"#$%&'()*+,-./:;?@[\]^_`{|}~

The names of the queues, remote queues and distribution queue lists (DQL) can only include the following characters: „

0123456789

„

abcdefghijklmnopqrstuvwxyz

„

ABCDEFGHIJKLMNOPQRSTUVWXYZ

„

./-%

The names of the user classes can only include the following characters: „

0123456789

„

abcdefghijklmnopqrstuvwxyz

„

ABCDEFGHIJKLMNOPQRSTUVWXYZ

Use of accented characters, special punctuation and so on is not supported.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

vi

EMAFTM082/01

About this Manual

Conventions Sometimes "Distributed Platforms" is abbreviated DP. The following are common styles that may appear in the manuals. Typographical styles change the appearance of certain areas of text. The instances where different styles are used and what these styles mean is explained below:

Italics Cross-references to other manuals appear in italic font. For example: SPAZIO MFT/S: Developer’s Guide.

Courier font This style illustrates system code or text. It may be input that needs to be entered by the programmer exactly as illustrated or output from the system. For example: correlation id Text in Courier font surrounded by a box with shading represents a listing. For example:

* PRINTOUT QUEUED *

Text in Courier font surrounded by a box, without shading represents a screen. For example:

PRIMEUR ----------------------FUNCTION ===> _

T M 1 0

0 1 2 3 4 5 6 7 8 9

PARAMETERS QUEUES CLASSES FILE UTILITIES MESSAGE UTILITIES TRANSFER LISTS TRANSMISSION MONITORING SYSTEM LOG INQUIRY ACTIVITIES CONTROL

-------------------- SPAZB ----Userid : PRIAMPO Date : 98/02/21 Time : 14:40 Defines User and System parameters Defines User Queues Defines Classes File Utility functions Message Utility functions Transfers Files to/from Q_Manager Defines Distribution Lists Monitors Transmission Status Displays System Log data Activities control

M T X

PRODUCT MAINTENANCE TUTORIAL EXIT

Inquiries/lists installed PTFs Displays TM10 manual Quits TM10 transaction

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

vii

About this Manual

Text that appears in this format is important information and should be read in all cases.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

viii

EMAFTM082/01

About this Manual

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

ix

Chapter 1 Started

SPAZIO Administrator: Getting

SPAZIO Administrator is a graphical utility for the administration of a SPAZIO network. The program provides the SPAZIO system administrator with a user-friendly hierarchical view of the objects that make up the network. This chapter describes the SPAZIO Administrator user interface, while the following chapter provides detailed instructions for performing each of the available operations. NOTE A menu-driven interface, SPAZIO Administrator Terminal, provides similar functionality for non-windows users. Chapter 6: SPAZIO Administrator Terminal describes the program in detail.

1.3

Opening SPAZIO Administrator 1

Make sure that SPAZIO is installed and running.

2

Click Start – Programs – Primeur – Spazio Server - Spazio Administrator, or click the SPAZIO Administrator icon on the desktop.

3

The following screen appears:

4

The initial login box appears next:

If required, enter the correct user ID and password:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

1

SPAZIO Administrator: Getting Started

5

Click OK. SPAZIO Administrator now opens.

NOTE If you try to open SPAZIO Administrator, and SPAZIO is either not installed or not running, the following error message appears:

Click “OK”. If required enter the correct user ID / password combination in the initial login box. SPAZIO Administrator opens, displaying the following icon in the lefthand panel:

To retry starting SPAZIO Administrator (for example, after first starting SPAZIO) right-click this item and click “Retry” in the menu that appears. If SPAZIO is running, SPAZIO Administrator starts up and the initial login box appears again.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

2

EMAFTM082/01

SPAZIO Administrator: Getting Started

1.4

The SPAZIO Administrator Interface When you open SPAZIO Administrator, the following screen appears (the Main screen):

This screen is made up of the following areas:

1.4.1 Title Bar This displays the name of the program, and contains three buttons on the right which you can use to

1.4.2

„

Minimize the window

„

Maximize / restore the window

„

Close the window (and the program)

Menu Bar and Drop-down Menus This lets you access the three SPAZIO Administrator menus: Action, View and Help.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

3

SPAZIO Administrator: Getting Started

1.4.2.1 Action menu The Action menu contains the following items:

Menu Item

Description

Expand

Expand an item to display its contents

Collapse

Collapse an item to hide its contents

Activate

Activate an object

Deactivate

Deactivate an object

Connect

Connect to a local or remote Queue Manager

Disconnect

Disconnect from a local or remote Queue Manager

Create

Create a new object

Modify

Modify an existing object

Remove

Delete an existing object

Set trace level

Set the trace level for an object. When the cursor is placed over this item, a sub-menu appears containing the following options: Option

Description

No Trace

No trace is set for the object.

Trace level 1

Minimal trace

Trace level 2

Normal trace

Trace level 3

Most detailed trace

Connect to Node

Connect to a Local or Remote Node

Stop Spazio

End SPAZIO

Exit

Exit from SPAZIO Administrator

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

4

EMAFTM082/01

SPAZIO Administrator: Getting Started

1.4.2.2 View menu The View menu contains the following items:

Menu Item

Description

Toolbar

Display / hide the toolbar

Status Bar

Display / hide the status bar

Description

Display / hide object descriptions

Security

Access security settings

Default Queue Security

Access default queue security settings

Default DQL Security

Access default DQL security settings

Options

Access user-defined program settings

1.4.2.3 Help Menu The Help menu contains the following items:

Menu Item

Description

Contents

Display on-line help contents

Search For Help On

Search the on-line help index

About Spazio Administrator

Display information on the program

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

5

SPAZIO Administrator: Getting Started

1.4.3

Toolbar

This bar contains a number of buttons that provide point-and-click access to most SPAZIO Administrator operations. The following table describes the function of each button and the equivalent menu command: Button

1.4.4

Function

Menu Command

Connect to a Local or Remote node

Action - Expand

Expand an item to display its contents

Action - Expand

Collapse an item to hide its contents

Action - Collapse

Activate an object

Action - Activate

Deactivate an object

Action - Deactivate

Connect to a Queue Manager

Action - Connect

Disconnect from a Queue Manager

Action Disconnect

Create a new object

Action - Create

Delete an existing object

Action - Remove

Show DQL information

none

Display DQL structure (items)

none

Apply a node filter

none

Workspace This is the main part of the GUI, and is divided into two panels: „

The SPAZIO Objects panel

„

The Properties or Contents panel

The left panel contains the names of SPAZIO objects. The right panel contains the properties and/or the contents of the object selected in the left panel. The range of objects that can be displayed in the left panel differs for local and remote nodes, as the following screen images show:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

6

EMAFTM082/01

SPAZIO Administrator: Getting Started

Local Node Objects

Remote Node Objects

1.4.4.1 Expanding / collapsing SPAZIO objects and folders When SPAZIO Administrator starts, the objects in the left panel are all collapsed. That is, the only icons visible are those representing the nodes in the network. To see the contents of a node, or any object in the left panel of the screen you must expand it by performing one of the following actions: „

Click the object

„

If there is a “+” symbol to the left of the object, click this

„

Right-click the object and choose Expand from the pop-up menu

„

If the object is selected but collapsed, choose Action – Expand

To collapse an expanded object or folder „

Click the “–“ symbol to the left of the object

„

Right-click the object and choose Collapse from the pop-up menu

„

Select the object and choose Action – Collapse

1.4.4.2 Performing operations on SPAZIO objects SPAZIO Administrator allows you to perform a wide range of operations on SPAZIO objects. These operations are listed in Chapter 2: Using SPAZIO Administrator. In general, to perform an operation on an object: „

Select the object or folder in the left panel of the screen

„

Perform the operation by ‰

Clicking the relevant button on the toolbar

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

7

SPAZIO Administrator: Getting Started

‰

Choosing a menu command from the menu bar

‰

Right-clicking the object and selecting a command from the pop-up menu.

NOTE: some operations can be activated using all three of the above methods while others may be available through only one or two actions.

1.4.5

Status Bar

This bar contains various items of information

1.5

„

The name of the currently selected object, or a status message such as Connecting …

„

The current date

„

The current time

Closing SPAZIO Administrator To close SPAZIO Administrator, click the close button choose Action – Exit.

on the title bar, or

If one or more Queue Managers are connected, they are automatically disconnected by the close operation.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

8

EMAFTM082/01

Chapter 2

2.1

Using SPAZIO Administrator

Introduction SPAZIO Administrator allows you to perform certain administration tasks for both Local and Remote SPAZIO nodes as follows:

2.1.1

2.1.2

Local node administration „

View the name and contents of the node.

„

List Queue Managers, Queues, DQLs, Communication Lines, Line Conversations Transport Classes, Transport Agents, and Tasks.

„

View the properties of Queue Managers, Queues, DQLs, Communication Lines, Line Conversations, the Transport Monitor, Transport Classes, Transport Agents, and Tasks.

„

Activate/deactivate Queue Managers, Communication Lines and the Transport Monitor.

„

Connect to/disconnect from Queue Managers.

„

Create/delete Queues, DQLs, and User Classes.

„

View and set security permissions for Queue Managers, and default security permissions for Queues and DQLs belonging to a specific Queue Manager.

„

Set trace levels for Queue Managers, Communication Lines and the Transport Monitor.

Remote node administration „

View the name and contents of the node.

„

List Queue Managers, Queues, DQLs and Line Addresses.

„

View the properties of Queue Managers, Queues, DQLs, and Line Addresses.

„

Connect to/disconnect from Queue Managers.

„

Create/delete Queues, DQLs, and User Classes.

„

View and set security permissions for Queue Managers, and default security permissions for Queues and DQLs belonging to a specific Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

9

Using SPAZIO Administrator

2.2 2.2.1

Notes on Using SPAZIO Administrator A note for users who are new to Windows As described in Chapter 1: SPAZIO Administrator – Getting Started, many commands can be activated through a variety of mechanisms, including drop-down menus, pop-up or right-click menus, buttons and icons. Throughout this chapter, in most cases only the simplest methods of performing an operation are documented (e.g. clicking a particular button on the toolbar). See Chapter 1: SPAZIO Administrator – Getting Started for an overview of available menus and buttons.

2.3

System administration operations Sections 2.3.1 to 2.3.9 describe the range of operations that SPAZIO Administrator allows you to perform on the various SPAZIO objects (Queue Managers, Queues, DQLs, User Classes, Communication Lines, the Transport Monitor, Transport Classes, Transport Agents, and Tasks) on both Local and Remote Nodes. NOTE: SPAZIO Administrator does not permit the same range of operations for Remote Node objects as it does for Local Node objects. The differences in functionality are clearly indicated throughout the rest of this chapter.

2.3.1

Queue Managers The sections below describe the operations that you can perform on local Queue Managers using SPAZIO Administrator. NOTE: Queue Managers are created (or, more precisely, defined) through the SPAZIO configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

10

EMAFTM082/01

Using SPAZIO Administrator

2.3.1.1 List Queue Managers

2.3.1.2

1

If the contents of the Node are not already expanded, click the Node icon in the left panel of the workspace (the Local Node is the first node listed).

2

Next, expand the Queue Managers folder:

3

The Queue Managers are listed.

View the properties of a Queue Manager 1

Click a Queue Manager.

2

A series of properties is displayed in the right panel of the workspace:

The following table describes these properties: Property

Description / Values

Name

Name of the Queue Manager

Active

Whether the Queue Manager is active or not: Value

Description

True

The Queue Manager is active.

False

The Queue Manager is not active.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

11

Using SPAZIO Administrator

Property

Description / Values

Options

Options for the Queue Manager.

Startup mode

Start-up mode for the Queue Manager: Value

Description

1

Manual

2

Automatic

Max number of concurrent sessions

The maximum number of simultaneously active Queue Manager sessions.

Prestarted Session Agents

Pre-started session agents.

Trace Level

Trace level for the Queue Manager. Values: Value

Description

0

No trace

1

Minimal trace

2

Normal trace

3

Most detailed trace

Option for using a single index on storage classes:

Single Index

Value

Description

True

Option is switched on.

False

Option is switched off.

Option to use the SPAM FAST_INDEX for storage classes. Faster, but involves more work in the case of a system failure:

Optimize indices for speed

Value

Description

True

Option is switched on.

False

Option is switched off.

Option to use the SPAM VIRT file for Queue Manager catalogues. Faster, but involves more work in the case of a system failure:

Catalogues in virtual memory only

Value

Description

True

Option is switched on.

False

Option is switched off.

Max number of Queues

Maximum number of Queues under the Queue Manager.

Max number of open Queues per session

Maximum number of Queues open in a session.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

12

EMAFTM082/01

Using SPAZIO Administrator

Property

Description / Values

Max number of open files per session

Maximum number of files open in a session.

Max number of user classes

Maximum number of user classes in a session.

Max dimension of Queue catalogue on disk

Maximum size of the Queue Catalogue file on disk.

Max dimension of DQL catalogue on disk

Maximum size of the DQL Catalogue file on disk.

Max number of files in a Queue

Maximum number of files in a Queue belonging to this Queue Manager.

Max number of messages in a Queue

Maximum number of files in a Queue belonging to this Queue Manager.

Directory for the Queue Manager files

Name of the directory where Queue Manager files are stored.

Cleaning policy

Directions for the Queue Manager Cleaner process. Values: Value

Description

0

Cleaning interval (in hours) Event Manager level

No clean Clean when the Queue Manager 1 starts up. Clean when the Queue Manager 2 starts up, and then at regular intervals. Time, in hours, between successive cycles of the Queue Manager Cleaner process. Level of the Event Manager: Value

Description

1

Basic

2

Extended

Number of storage classes

Total number of storage classes defined on the Queue Manager.

Number of events definitions

Number of event definitions for the Queue Manager.

Number of default events

Number of default events defined for the Queue Manager.

Number of Queues with events

Number of Queues belonging to the Queue Manager that have events defined for them.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

13

Using SPAZIO Administrator

Property

Description / Values

Number of event instances

The total number of instances of events.

Max number of dynamic events

Maximum number of dynamic events for the Queue Manager.

Max number of Queues with dynamic events

Maximum number of queues with dynamic events.

Remote Nodes The only property displayed for a Queue Manager on a Remote Node is the Name. NOTE: for SPAZIO Administrator, these properties are read-only. Their values are assigned and modified through the configuration process (see SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for details).

2.3.1.3 Activate an inactive Queue Manager (Local Node only) You can activate a Queue Manager if it is „

Not connected (see section 2.3.1.5), and

„

Not active (the Active property of the Queue Manager is False – see section 2.3.1.2)

To activate a selected Queue Manager, click the Activate button toolbar.

2.3.1.4

on the

Deactivate an active Queue Manager (Local Node only) You can deactivate a Queue Manager if it is „

Not connected (see section 2.3.1.5), and

„

Active (the Active property of the Queue Manager is True – see section 2.3.1.2)

To deactivate a selected Queue Manager, click the Deactivate button the toolbar.

on

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

14

EMAFTM082/01

Using SPAZIO Administrator

2.3.1.5 Connect to a Queue Manager 1

Select the Queue Manager.

2

Click the Connect button

3

The Connect to Queue Manager box appears:

4

If a User ID and password is required, enter them in the dialog box:

5

The Queue Manager is connected, and the Queue Manager contents are displayed in both panels (the Queue Manager properties are also listed in the right panel):

on the toolbar.

2.3.1.6 Disconnect from a Queue Manager

2.3.1.7

1

Select the Queue Manager.

2

Click the Disconnect button

on the toolbar.

Set the Trace Level for a Queue Manager (Local Node only) 1

Select the Queue Manager.

2

Choose Action – Set Trace Level.

3

The following sub-menu appears:

4

Set the trace level by clicking one of the options.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

15

Using SPAZIO Administrator

The following table explains the trace levels: Trace Level

Description

No trace

No trace will be performed.

Trace level 1

Minimal trace

Trace level 2

Normal trace

Trace level 3

Most detailed trace

2.3.1.8 View the Security properties of a Queue Manager 1

Right-click a Queue Manager to display the following pop-up menu:

2

Click Security.

3

The following box appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

16

EMAFTM082/01

Using SPAZIO Administrator

2.3.1.8.1 Queue Manager Security 1

To view or set permission information on the Queue Manager, click the Permissions button in the Permissions area:

2

If you do not have the correct permissions for this operation, the following message appears:

3

Refer to Chapter 3: Security Management for details on how to set and modify the permissions.

2.3.1.8.2 Queue Manager default Queue security 1

To view or set permission information on the default permissions for Queues under the current Queue Manager, click the Permissions button in the Default Queue Permissions area:

2

If you do not have the correct permissions for this operation, the following message appears:

3

Refer to Chapter 3: Security Management for details on how to set and modify the permissions.

2.3.1.8.3 Queue Manager default DQL security 1

To view or set permission information on the default permissions for DQLs under the current Queue Manager, click the Permissions button in the Default DQL Permissions area:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

17

Using SPAZIO Administrator

2.3.2

2

If you do not have the correct permissions for this operation, the following message appears:

3

Refer to Chapter 3: Security Management for details on how to set and modify the permissions.

Queues The sections below describe the operations that you can perform on queues belonging to a Queue Manager on a local or remote node using SPAZIO Administrator.

2.3.2.1 List Queues 1

Click the Queues folder in the left panel of the screen.

2

The queues belonging to the current Queue Manager are displayed:

Local queues are indicated by the icon. 3

icon, and remote queues by the

The queues are also listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

18

EMAFTM082/01

Using SPAZIO Administrator

2.3.2.2 View the properties of a Local Queue 1

Click a local queue to display its properties in the right panel:

The local queue properties are described in the following table: Property

Description / Values

Name

Name of the Queue.

Type

Queue Type

Description

A user-defined description of the queue.

Storage Class

The storage class associated with the queue.

Address Type

The address type of the queue. Value

Description

0

SPAZIO. Default.

Current Message Depth

The number of messages currently in the queue.

Creation

Date and time that the queue was created.

Update

Date and time that the queue was last updated.

Inhibit Get

Whether GET operations are blocked for the queue. Values:

Inhibit Put

Value

Description

True

GET operations are blocked.

False

GET operations are not blocked.

Whether PUT operations are blocked for the queue: Value

Description

True

PUT operations are blocked.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

19

Using SPAZIO Administrator

Property

Description / Values False

PUT operations are not blocked.

Shareability

Whether the queue is shareable: TRUE or FALSE

Default Input Open Option

Whether the queue is opened for input by default

Persistence

Whether the queue is persistent: TRUE or FALSE

Priority

Selection priority of the queue. Number in the range1-10. Default = 5

Open Input Count

The number of times that the queue has been opened for input

Open Output Count

The number of times that the queue has been opened for output

File Default User Class

The default user class for files in the queue.

Max File Depth

The maximum number of files that the queue can contain.

Max File Length

The maximum size of files that may be contained in the queue.

Message Default User Class

The default user class for messages in the queue.

Max Message Depth

Maximum number of messages that may be contained in the queue

Max Message Length

The maximum length of messages that may be contained in the queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

20

EMAFTM082/01

Using SPAZIO Administrator

2.3.2.3 View the properties of a Remote Queue 1

Click a remote queue in the left panel

2

Its properties are listed in the right panel. The remote queue properties are described in the following table:

Property

Description / Values

Name

Name of the Queue.

Type

Queue Type

Description

A user-defined description of the queue.

Storage Class

The storage class associated with the queue.

Address Type

The address type of the queue. Value

Description

0

SPAZIO. Default.

Current Message Depth

The number of messages currently in the queue.

Creation

Date and time that the queue was created.

Update

Date and time that the queue was last updated.

Inhibit Get

Whether GET operations are blocked for the queue:

Inhibit Put

Value

Description

True

GET operations are blocked.

False

GET operations are not blocked.

Whether PUT operations are blocked for the queue: Value

Description

True

PUT operations are blocked.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

21

Using SPAZIO Administrator

Property

Description / Values False

PUT operations are not blocked.

Shareability

Whether the queue is shareable: TRUE or FALSE

Default Input Open Option

Whether the queue is opened for input by default

Persistence

Whether the queue is persistent: TRUE or FALSE

Priority

Selection priority of the queue. Number in the range1-10. Default = 5

Open Input Count

The number of times that the queue has been opened for input

Open Output Count

The number of times that the queue has been opened for output

File Default User Class

The default user class for files in the queue.

Max File Depth

The maximum number of files that the queue can contain.

Max File Length

The maximum size of files that may be contained in the queue.

Message Default User Class

The default user class for messages in the queue.

Max Message Length

The maximum length of messages that may be contained in the queue.

Max Message Depth

Maximum number of messages that may be contained in the queue

Remote Queue Manager

Name of the remote Queue Manager that owns the queue to which this “remote queue” points.

Remote Queue

Name of the queue belonging to a remote Queue Manager to which this “remote queue” points.

Remote Queue Address type

The Address Type of the remote queue

Remote Queue Type

The type of the remote queue.

Remote User Id

User ID associated with the remote Queue Manager.

Transport Class

The transport class associated with the remote queue.

File Transport Type

File Transport type associated with the remote queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

22

EMAFTM082/01

Using SPAZIO Administrator

Property

Description / Values

Message Transport Type

Message Transport type associated with the remote queue.

Delivery Mode

The delivery mode for the queue (immediate or within an interval or class)

Start of Delivery

Start of delivery period

End of Delivery

End of delivery period

File Transport Timeout

Timeout for file transport.

Message Transport Timeout

Timeout for message transport.

File Transport parallelism

Maximum number of current active transports.

Message Transport parallelism

Maximum number of current active transports.

Transport Priority

Priority in selecting the queue (only for remote queues).

Max Delivery interval

Maximum length of the delivery interval

Max Restart Retry

Maximum number of restarts that can be attempted.

Restart Interval

The interval specified between restart attempts.

Synchronization Level

Number of blocks (in the case of a file) or number of messages before a Sync (ACK1) is requested in the transport. Default: 10

Successful Event Group

Name of the Event Group to which the following parameter belongs.

Successful Event Name

Name of the Event to be executed in case of success in reaching the remote Queue Manager.

Failure Event Group

Name of the Event Group to which the following parameter belongs.

Failure Event Name

Name of the Event to be executed in case of failure in reaching the remote Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

23

Using SPAZIO Administrator

2.3.2.4 Create a Local Queue 1

Select the Queues folder.

2

Click the

3

Enter a name for the queue in the Queue Name field.

4

Optionally, enter a description of the queue in the Description field.

5

Make sure that Local is selected as the Queue Type.

6

Select Queue Mode, Default Input Open Option and File Default User Class.

button on the toolbar. The following screen appears:

The following table explains the fields: Field

Description / Values

Queue Name

Name of the current Queue

Queue Description

Queue Description

Queue Type

Queue Type

Queue Mode

It specifies if the queue can be opened for input several times concurrently.

Default Input Open Option

It identifies the default way in which a queue should be opened for input

File Default User Class

It identifies the default user class when putting files and getting files from queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

24

EMAFTM082/01

Using SPAZIO Administrator

7

Click the Advanced tab:

The following table explains the fields in the Advanced tab: Field

Description / Values

Storage Class

Storage class to be associated with the new queue. For further details, see section 2.3.2.8.

Max File Depth

Maximum number of files that can be contained in the queue.

Max Message Depth

Maximum number of messages that can be contained in the queue.

Max Message Length

Maximum length of messages that may be inserted in the queue.

Default Priority

Default priority of the Message\File put to the queue

Default persistence of messages

Persistence assigned to messages written to this queue that had no persistence specified when they were written.

Message Delivery Sequence

Mode in which messages are delivered

Inhibit Get Operation

Value

Description

FIFO

Delivered using First In First Out mechanism. MVS only

Priority Based

Delivered using a priority based mechanism

Whether GET operations are blocked for the queue: Value

Description

True

GET operations are blocked.

False

GET operations are not blocked.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

25

Using SPAZIO Administrator

Field

Description / Values

Inhibit Put Operation

Whether PUT operations are blocked for the queue: Value

Description

True

PUT operations are blocked.

False

PUT operations are not blocked.

Read Password

Read password associated with the queue (allows files and messages to be read from the queue).

Write Password

Write password associated with the queue (allows files and messages to be inserted in the queue).

Set Password

Set password associated with the queue (allows the queue to be modified or deleted).

8

Fill in the relevant fields.

9

Click OK to create the queue, or Cancel to abort the operation.

2.3.2.5 Create a Remote Queue 1

Select the Queues folder.

2

Click the button on the toolbar. Select Remote as the Queue Type in the box that appears:

3

Enter a name for the queue in the Queue Name field.

4

Optionally enter a description of the queue in the Description field.

5

Indicate Remote Queue Manager and Remote Queue and select Queue Mode, Default Input Open Option and File Default User Class.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

26

EMAFTM082/01

Using SPAZIO Administrator

The following table explains the fields: Field

Description / Values

Remote Queue Manager: Name

It identifies the name of the remote Queue Manager to which the remote queue belongs.

User Id

User identifier with which the transport identifies itself to the remote Queue Manager.

Password

Password with which the transport identifies itself to the remote Queue Manager.

Remote Queue: Name

It identifies the name of the remote queue corresponding to the queue to be created.

Password

Write password for remote queues in the remote Queue Manager.

Type

Queue Type Value

Description

LOCAL MODEL ALIAS REMOTE UNKNOWN Address Type

Address Type Value

Description

Spazio Spazio System Local Automatic Remote Automatic

6

Queue Mode

It specifies if the queue can be opened for input several times concurrently.

Default Input Open Option

It identifies the default way in which a queue should be opened for input

File Default User Class

It identifies the default user class when putting files and getting files from queue.

Click the Advanced tab:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

27

Using SPAZIO Administrator

The following table explains the fields in the Advanced tab: Field

Description / Values

Storage Class

Storage class to be associated with the new queue. For further details, see section 2.3.2.8.

Max File Depth

Maximum number of files that can be contained in the queue.

Max Message Depth

Maximum number of messages that can be contained in the queue.

Max Message Length

Maximum length of messages that may be inserted in the queue.

Default Priority

Default priority of the Message\File put to the queue

Default persistence of messages

Persistence assigned to messages written to this queue that had no persistence specified when they were written.

Message Delivery Sequence

Mode in which messages are delivered

Inhibit Get Operation

Value

Description

FIFO

Delivered using First In First Out mechanism. MVS only.

Priority Based

Priority Based

Whether GET operations are blocked for the queue: Value

Description

True

GET operations are blocked.

False

GET operations are not blocked.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

28

EMAFTM082/01

Using SPAZIO Administrator

Field

Description / Values

Inhibit Put Operation

Whether PUT operations are blocked for the queue: Value

Description

True

PUT operations are blocked.

Force Default Class For Files

PUT operations are not blocked. Read password associated with the queue (allows files and messages to be read from the queue). Write password associated with the queue (allows files and messages to be inserted in the queue). Set password associated with the queue (allows the queue to be modified or deleted). Force all files put to the queue to use the default user class

Force Default Class For Messages

Force all messages put to the queue to use the default user class

False

Read Password

Write Password

Set Password

7

Fill in the relevant fields.

8

Click the Delivery Mode tab:

The following table explains the fields in the Delivery Mode tab: It identifies how messages/files are written to the remote Queue Manager, once they have been written on the local Queue Manager. Allowed values:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

29

Using SPAZIO Administrator

Field

Description

Delivery Mode Hold

Optional. Alternate to Immediate, Interval, Use Transport Class parameters. Deferred delivery. Files/messages remain in the local Queue Manager. They are transmitted to the remote Queue Manager only on request. This mode is valid only for MVS nodes.

Immediate

Optional. Alternate to Hold, Interval, Use Transport Class parameters. Immediate delivery. All messages/files written on the local Queue Manager are immediately delivered to the remote Queue Manager. If selected, the Max Delivery Time field appears that identifies the maximum time interval, in seconds, between the writing of a message/file in the local Queue Manager and its send to the remote Queue Manager (max. 86400, a day) This mode is valid only for MVS nodes. Optional. Alternate to Hold, Immediate, Use Transport Class parameters. It identifies the time of the day at which the delivery of a message/file starts and ends. If selected, two fields appear and the user must indicate the values in the format HHMMSS.

Interval

This mode is valid only for MVS nodes. Use Transport Class

Optional. Alternate to Hold, Immediate, Interval parameters. The user can specify a transport class, different from the default transport class, to be used for files contained in this queue. Value

Description

Use Default Transport Class

Use the current default user class

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

30

EMAFTM082/01

Using SPAZIO Administrator

Field

Description Use Destination QM Default Transport Class

Default Transport Class of their destination queue manager

Use Transport Class

Specify a Transport Class to be used

Transport Success Event Event Name

Event used after a successful transport

Group Name

Group used after a successful transport

Transport Failure Event Event Name

Event used after a failed transport

Group Name

Group used after a failed transport

Custom Delivery mode Guaranteed Delivery Order

Guaranteed Delivery Order

Restart Interval

Interval specified between restart attempts

Restart Max Number

Optional. Maximum number of restarts that can be attempted. If Delivery Mode is set to Use Transport Class, this value is ignored, since it will be taken directly from the Transport Class specified for the queue. If Delivery Mode is other than Class (Hold, Immediate, Interval), this value can be specified. The range of values is [0 – 10000]. The value 0 sets the value to the default (for SPAZIO the default is 6).

Sync Level

Number of blocks (in the case of a file) or number of messages before a Sync (ACK1) is requested in the transport. Default: 10

Files Transport Name

File Transport Name

Transport Timeout

File Transport Timeout

Transport Prestarted

File Transport Prestarted

Messages Transport Name

Messages Transport Name

Transport Timeout

Messages Transport Name

Transport Prestarted

Messages Transport Name

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

31

Using SPAZIO Administrator

9

Select the relevant option.

10 Click OK to create the queue, or Cancel to abort the operation. NOTE: if the user specifies an incorrect password when defining a remote queue, subsequent transmissions to this queue will fail (status "Failed"). Normally transmissions in "Failed" status require manual intervention by the user (New Transport) in order to restart them. In this case, however, it is enough to specify the correct password in the definition of the remote queue and the transmissions will restart and complete automatically.

2.3.2.6 Delete a Queue 1

Select a local or remote queue.

2

Click the

3

The Remove Queue dialog box appears:

4

If no Set password was assigned to the queue, leave the Password field blank. If a Set password is required, enter the correct password.

5

The queue is now deleted.

button on the toolbar.

2.3.2.7 View and Set the Security properties of a Queue To view or change the security properties of a queue, select the queue and choose View – Security or right-click the queue and choose Security. Refer to Chapter 3: Security Management for details on how to set and modify the permissions.

2.3.2.8 Storage Class A Storage Class is applied to a Queue Manager and specifies the attributes (in particular the data catalogue path and the maximum number of files that can be stored in a queue) that characterize the queues belonging to the Queue Manager to which such class is applied. A Storage Class must be defined in the SPQM.INI configuration file and is made up of the following attributes: „

Identifier (ClassId)

„

Name (ClassName)

„

Description (ClassDesc)

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

32

EMAFTM082/01

Using SPAZIO Administrator

„

Path where directories CLASS and DATA of the Storage Class in QM, are appended (ClassPath)

„

Maximum size of disk file of persistent object entry repository - entries for persistent messages and files in queues (RepPMax)

„

Maximum size of memory file of volatile object entry repository - entries for non-persistent messages in queues (RepNPMax)

„

Maximum size of disk file of persistent message body repository - entries for persistent messages in queues (MsgBodyPMax)

„

Maximum size of memory file of volatile message body repository - entries for non-persistent messages in queues (MsgBodyNPMax)

„

Maximum size of disk file of file information entry repository - entries for files in queues (FileInfoPMax)

Example (SPQM.INI) . . ClassId_1 ClassName_1 ClassDesc_1 ClassPath_1 RepPMax_1 RepNPMax_1 MsgBodyPMax_1 MsgBodyNPMax_1 FileInfoPMax_1 . .

2.3.3

= = = = = = = = =

1 CLASS1 FIRST_CLASS 40000000 1000000 20000000 800000 10000000

DQLs The sections below describe the operations that you can perform on DQLs (Destination Queue Lists) belonging to a Queue Manager on a Local or Remote Node using SPAZIO Administrator. A DQL is a SPAZIO object that groups together a set of queues to which you want to send files or messages. In SPAZIO you can add an item to a DQL by naming a destination queue and its Queue Manager. NOTE: all queues of a DQL must also belong to the same storage class. If a DQL item is a Queue Manager queue type (M queue type), all the other DQL queues must belong to the default storage class that is the first defined in SPQM.INI.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

33

Using SPAZIO Administrator

2.3.3.1 List DQLs 1

Click the DQLs folder in the left panel of the screen.

2

The DQLs belonging to the current Queue Manager are displayed:

3

The DQLs are also listed in the right panel:

2.3.3.2 View the general properties of a DQL 1

Click a DQL.

2

button on the toolbar is already selected, the properties of the If the DQL are listed in the right panel:

The properties listed are the name of the DQL, possibly a brief description and the date a time at which the DQL was created.

2.3.3.3 View the items contained in a DQL 1

Click a DQL.

2

button on the toolbar is already selected, the items contained in If the the DQL are displayed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

34

EMAFTM082/01

Using SPAZIO Administrator

The various objects are displayed hierarchically, using the familiar icon representations of queues and Queue Managers.

2.3.3.4 Create a DQL The easiest way to explain DQL creation is through a simple example. The following sections describe the creation of a DQL called dql2.

Requirements for the example DQL The following are the requirements for the example DQL dql2: „

It must include two queues under Queue Manager BORODIN called FRMQMGR1 and FRMMVSND

„

It must include one queue under Queue Manager MVSNODE called FRMQMGR1

„

Read, Write and Set passwords must be specified for the DQL.

NOTE: in this example, two queues share the same name (FRMQMGR1). This is possible since both queues belong to different Queue Managers.

Structure of the example DQL The following diagram represents the DQL to be created:

DQL: SALESDQL

Queue Manager: JFK

Local Queue: FROMLIN

Queue Manager: HEATHROW

Local Queue: FROMHRW

Local Queue: FROMLIN

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

35

Using SPAZIO Administrator

Create the new DQL object The first step is to create a new (empty) DQL, providing a name, description (optional) and various passwords (optional). In this case the DQL will be called dql2. Read, Write and Set passwords will be specified. The following steps describe how to create this DQL: 1

Select the DQLs folder under the relevant Queue Manager.

2

Click the

3

The New DQL dialog box appears:

button on the toolbar.

The following table explains the fields and buttons in the New DQL dialog box: Field

Description / Values

Name

Name of the DQL.

Description

Brief description of the DQL.

Password

DQL password

Read

Read password associated with the DQL.

Write

Write password associated with the DQL (allows files and messages to be inserted in the DQL).

Set

Set password associated with the DQL (allows the DQL to be modified or deleted).

Insert Sibling

Insert an item in the DQL that is at the same hierarchical level as the currently selected item.

Insert Child

Insert an item in the DQL that is at the next hierarchical level below the currently selected item.

Show Details

Open a further panel listing details of each DQL item.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

36

EMAFTM082/01

Using SPAZIO Administrator

Field

Description / Values

Hide Details

Close the above panel.

OK

Accept the current input and proceed to the next operation.

Cancel

Cancel the current input.

4

Fill in the relevant fields in the New DQL dialog box:

5

Click OK to continue, or Cancel to abort the operation.

Add items to the DQL The rest of this section describes how to add items to the DQL. To follow the example described previously, the steps involved are: „

Add a Queue Manager BORODIN as a child of the DQL dql2.

„

Add a Local Queue FRMQMGR1 as child of Queue Manager BORODIN.

„

Add a Local Queue FRMMVSND as a sibling of Local Queue FRMQMGR1. (Note: FRMMVSND could equally be inserted as another child of BORODIN.)

„

Add a second Queue Manager MVSNODE as a child of the DQL dql2. (Note: MVSNODE could equally be inserted as a sibling of BORODIN.)

„

Add a Local Queue also called FRMQMGR1 as child of Queue Manager FRMMVSND.

The following steps describe these procedures: 1

To enter the first item in the DQL, click Insert Child.

2

The DQL Item dialog box appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

37

Using SPAZIO Administrator

3

Type BORODIN (the name of the first Queue Manager containing destination queues for the DQL) in the Name field.

4

Leave the Address Type as the default 0, indicating SPAZIO.

5

Select the object type (in this case Queue Manager) from the list in the Type field.

6

Queue Manager BORODIN is now added to the DQL:

7

Next, select Queue Manager BORODIN, and click the Insert Child button.

8

The DQL Item box appears again:

9

Type FRMQMGR1 (the name of the first destination queue under Queue Manager BORODIN) in the Name field.

10 Leave the Address Type as the default 0, indicating SPAZIO. 11 Select the object type (in this case Local Queue) from the list in the Type field. 12 Click OK. 13 The queue FRMQMGR1 is now added to the DQL:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

38

EMAFTM082/01

Using SPAZIO Administrator

The next queue to be added, FRMMVSND, is also under Queue Manager BORODIN, and so can be considered a sibling of FRMQMGR1: 14 Select FRMQMGR1. 15 Click the Insert Sibling button to open the DQL Item dialog box:

16 Type FRMMVSND (the name of the second destination queue under Queue Manager BORODIN) in the Name field. 17 Leave the Address Type as the default SPAZIO. 18 Select the object type (in this case Generic Queue) from the list in the Type field. 19 Click OK. 20 The queue FRMMVSND is now added to the DQL:

21 To complete the DQL, select dql2:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

39

Using SPAZIO Administrator

22 Click the Insert Child button to open the DQL Item dialog box:

23 Type MVSNODE (the name of the next Queue Manager containing a destination queue for the DQL) in the Name field. 24 Leave the Address Type as the default SPAZIO. 25 Select the object type (in this case Queue Manager) from the list in the Type field. 26 Click OK. 27 Queue Manager MVSNODE is now added to the DQL:

28 Next, select Queue Manager MVSNODE, and click the Insert Child button. 29 The DQL Item box appears again:

30 Type FRMQMGR1 (the name of the destination queue under Queue Manager BORODIN) in the Name field. 31 Leave the Address Type as the default 0, indicating SPAZIO. 32 Select the object type (in this case Local Queue) from the list in the Type field. 33 Click OK. 34 The queue FRMQMGR1 is now added to dql2 and the DQL is complete. 35 Click the Show Details button to open an additional panel listing details for each item in the DQL:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

40

EMAFTM082/01

Using SPAZIO Administrator

Click Hide Details to close the lower panel.

2.3.3.5 Delete a DQL 1

Select the DQL that you want to delete in the left panel of the workspace.

2

Click the

3

The Remove DQL dialog box appears:

4

If the DQL is protected by a Set password, type it in the Password field (otherwise, leave the field blank).

5

Click OK to proceed with deletion, or Cancel to cancel the operation.

button on the toolbar.

2.3.3.6 View and Set the Security properties of a DQL 1

Right click the relevant DQL in the left panel of the workspace

2

Choose Security from the pop-up menu:

3

Refer to Chapter 3: Security Management for details on how to set and modify the permissions.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

41

Using SPAZIO Administrator

2.3.3.7 Modify a DQL

2.3.4

1

Right click the relevant DQL in the left panel of the workspace

2

Choose Modify from the pop-up menu:

3

Refer to section 2.3.3.4 Creating a DQL for details on how to modify the properties.

User Classes The sections below describe the operations that you can perform on User Classes belonging to a Queue Manager on a Local or Remote Node using SPAZIO Administrator.

2.3.4.1 List User Classes 1

Click the User Classes folder in the left panel of the screen.

2

The queues under the current Queue Manager are displayed:

3

The User Classes are also listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

42

EMAFTM082/01

Using SPAZIO Administrator

2.3.4.2 View the properties of a User Class 1

Click a User Class in the left panel.

2

The properties of the User Class are listed in the right panel:

The User Class properties are described in the following table: Property

Description / Values

Name

Name of the User Class.

Description

Brief description of the User class.

Queue Set Name

Queue Set name

Object Set Name

Object Set name

Expiry after put

Specifies an interval after which objects inserted in the queue will expire.

Expiry after read

Specifies an interval after which objects read from the queue will expire.

2.3.4.3 Create a User Class 1

Select the User Classes folder.

2

Click the

button on the toolbar. The following screen appears:

The following table explains the fields in the New User Class dialog box:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

43

Using SPAZIO Administrator

Field

Description / Values

User Class Name

Name of the new User Class (maximum 4 alphanumeric characters)

Description

Brief description of the User Class.

Queue Set Name

Queue set name

Object Set Name

Object set name

Expiry after put

Specifies an interval after which objects inserted in the queue will expire. The selection box lets you choose a time unit for the specified interval. The choices are:

Expiry after read

„

Minutes

„

Hours

„

Days

Specifies an interval after which objects read from the queue will expire. The selection box lets you choose a time unit for the specified interval. The choices are:

Type

„

Minutes

„

Hours

„

Days

User Class type Value

Description

Permanent

Permanent User class

Dynamic Allocation

3

Prioritary Deletion Mode

Prioritary Deletion enforced

Forced External File

When a record is inserted on a Local queue it forces the file to be external. MVS only

Force Internal Format

When a record is inserted on a Local queue it forces the file to be written in an internal format. DP only.

Fill in the relevant fields and click OK to create the User Class, or Cancel to cancel the operation.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

44

EMAFTM082/01

Using SPAZIO Administrator

2.3.4.4 Delete a User Class

2.3.5

1

Select a User Class in the left panel of the workspace.

2

Click the

button on the toolbar.

Communication Lines The sections below describe the operations that you can perform on Communication Lines belonging to a local Queue Manager using SPAZIO Administrator. Limited functionality is also available for Remote Nodes. NOTE: communication lines are created (or, more precisely, defined) through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.

2.3.5.1 List Communication Lines 1

Click the Lines folder (on Remote Nodes, this folder is labeled Line Addresses) in the left panel of the screen.

2

The communication lines defined on the current node are displayed in the left panel:

3

The communication lines are also listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

45

Using SPAZIO Administrator

2.3.5.2 View the properties of a Communication Line 1

Click a communication line in the left panel of the workspace.

2

The properties of the selected line are displayed in the right panel:

The first item in the list is the Conversations folder. This is explained in section 2.3.5.5. The following table explains the communication line properties: Property

Description / Values

Name

Symbolic name of the Communication Line.

Type

Physical connection type of SPAZIO driver:

Active

Direction

Value

Description

TCP

TCP/IP

ISCL

ISCL (various protocols)

Whether or not the line is currently active: Value

Description

True

The line is active.

False

The line is not active.

Direction of communication: Value

Description

I

Input only

O

Output only

A

Input and output

Status

Status of the communication line

Startup Mode

Start-up options.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

46

EMAFTM082/01

Using SPAZIO Administrator

Property

Description / Values Value

Description

1

Manual

2

Automatic

Trace level for the Communication Line:

Trace Level

Value

Description

0

No trace

1

Minimal trace

2

Normal trace

3

Most detailed trace

Timeout

Timeout in seconds (for inbound connection).

Driver Handle

Communication driver handle

Max Conversations

Maximum number of conversations on the line.

Max Input Conversations

Maximum number of outgoing conversations on the line.

Max Output Conversations

Maximum number of incoming conversations on the line.

Num Active Conversations

Number of active conversations on the line.

Num Active Input Conversations

Number of active incoming conversations on the line.

Num Active Output Conversations

Number of active outgoing conversations on the line.

Param

Port values

Local Address

Local IP Address

Remote Nodes The following are the only properties listed for Line Address objects on Remote Nodes: Property

Description / Values

Name

Symbolic name of the communication line.

Address

Destination address (IP or other) of the Communication Line.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

47

Using SPAZIO Administrator

2.3.5.3 Activate an inactive Communication Line (Local Node only) 1

Select the communication line in the left panel of the workspace.

2

If the Active property of the line is False (see section 2.2.5.2), click the button on the toolbar.

2.3.5.4 Deactivate an active Communication Line (Local Node only) 1

Select the communication line in the left panel of the workspace.

2

If the Active property of the line is True (see section 2.2.5.2), click the button on the toolbar.

2.3.5.5 List the conversations on a Communication Line (Local Node only) 1

Select the communication line in the left panel of the workspace.

2

Click the Conversations folder under the line.

3

Conversations on that line are listed in the left panel:

4

The conversations are also listed in the right panel:

2.3.5.6 View the properties of a Communication Line conversation (Local Node only) 1

Select the communication line conversation in the left panel of the workspace.

2

The properties of the conversation are listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

48

EMAFTM082/01

Using SPAZIO Administrator

The following table explains the above properties: Property

Description / Values

ID

Identifier for the conversation.

Remote Node Name

Name of the remote node on the receiving end of the conversation. If the Direction property of the conversation is I (Input), then this property has the value .

Direction

The direction of the conversation: Value

Description

I

Input (incoming).

O

Output (outgoing).

Active

True or False value indicating whether the conversation is active or not.

Status

Status of the conversation

Client Handle

Client process handle

Conversation Handle

Conversation process handle

2.3.5.7 Set the Trace Level for a Communication Line (Local Node only)

2.3.6

1

Select the communication line in the left panel of the workspace.

2

Choose Action – Set Trace Level.

3

The following sub-menu appears:

4

Set the trace level by clicking one of the options.

Transport Definitions (Local Node only) The sections below describe the operations that you can perform on the Transport Definitions on the Local Node using SPAZIO Administrator.

2.3.6.1 View the properties of the Transport Definitions 1

Click the Transport Definitions folder in the left panel of the workspace.

2

The contents and properties of the Transport Definition are listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

49

Using SPAZIO Administrator

The first two items in the list are the Classes by Name folder (see section 2.3.7 Transport Classes) and the Classes By Protocol folder (see section 2.3.8 Transport Agents).

2.3.6.2 Activate the Transport Definitions 1

Select the Transport Definition folder in the left panel of the workspace.

2

If the Active property of the Transport Definitions is False, click the button on the toolbar.

2.3.6.3 Deactivate the Transport Definitions 1

Select the Transport Definitions folder in the left panel of the workspace.

2

If the Active property of the Transport Definitions is True, click the button on the toolbar.

2.3.6.4 Set the Trace Level for the Transport Definitions

2.3.7

1

Select the Transport Definitions folder in the left panel of the workspace.

2

Choose Action – Set Trace Level.

3

The following sub-menu appears:

4

Set the trace level by clicking one of the options.

Classes By Name (Local Node only) The sections below describe how you can use SPAZIO Administrator to perform operations on Transport Classes defined on the local Node.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

50

EMAFTM082/01

Using SPAZIO Administrator

NOTE: Transport Classes are defined through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.

2.3.7.1 List Transport Classes 1

Click the Classes by Name folder in the left panel of the workspace.

2

The Transport Classes defined on the current node are displayed in the left panel:

3

The Transport Classes are also listed in the right panel

2.3.7.2 View the properties of a Transport Class 1

Select a Transport Class in the left panel of the workspace.

2

The properties of the class are listed in the right panel:

The following table explains the above properties: Property

Description / Values

Name

Name of the Transport Class.

Priority

Selection priority of the queue. Number in the range1-10. Default = 5

Delivery Mode

Queue Delivery Mode. Values:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

51

Using SPAZIO Administrator

Property

Protocol Name

2.3.8

Description / Values Value

Description

0

Immediate delivery.

1

Delivery after interval.

File Transport Protocol t used by the class.

Classes by Protocol (Local Node only) The sections below describe how you can use SPAZIO Administrator to perform operations on Transport Protocols defined on the local Node. NOTE: Transport Agents are configured through the SPAZIO Configuration process. See SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide for further details.

2.3.8.1 List Transport Agents 1

Click the Classes by Protocol folder in the left panel of the workspace.

2

The Transport Protocols defined on the current node are displayed in the left panel:

3

The Transport Protocols are also listed in the right panel.

2.3.8.2 View the properties of a Transport 1

Select a Protocol in the left panel of the workspace.

2

The properties of the Protocol are listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

52

EMAFTM082/01

Using SPAZIO Administrator

The first item in the list is the Classes folder, explained in the next section. A single property of the selected Transport Agent is listed: Name.

2.3.8.3 List the Transport Classes associated with a Transport Protocol 1

Click a Transport Agent in the left panel of the workspace. Click the Classes folder under this agent.

2

The Transport Classes associated with this Transport Agent (i.e. the Transport Agent Classes) are displayed in the left panel:

3

The Transport Agent Classes are also listed in the right panel.

2.3.8.4 View the properties of a Transport Class associated with a Transport Protocol 1

Select a Transport Protocol Class in the left panel of the workspace.

2

The properties of the class are listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

53

Using SPAZIO Administrator

A single property, the Name of the class is listed.

2.3.9

Tasks (Local Node only) The sections below describe how you can use SPAZIO Administrator to list and view Tasks running on the local Node.

2.3.9.1 List Tasks 1

Click the Tasks folder in the left panel of the workspace.

2

Tasks currently running are listed in the left panel:

3

The current tasks are also listed in the right panel:

2.3.9.2 View the properties of a Task 1

Select a task in the left panel of the workspace.

2

The properties of the task are listed in the right panel:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

54

EMAFTM082/01

Using SPAZIO Administrator

The following table explains the above properties:

2.4

Property

Description / Values

ID

Task ID.

Name

Name of the transaction.

Active

Whether or not the task is active. Value

Description

True

The task is active.

False

The task is not active.

Direction

Task Direction. Input\Output

Proc ID

Process ID

Setting SPAZIO Administrator options 1

Choose View – Options to open the Options dialog box:

The General tab allows you to enable/disable the use of login dialog boxes when connecting to Local Queue Managers. If this option is not checked, you will not see the following box when you try to connect to a Local Queue Manager (unless the Queue Manager is passwordprotected):

2

The Startup tab allows you to specify the start up options on the Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

55

Using SPAZIO Administrator

3

2.5

The Filters tab allows you to specify a filter, with which to list Queue Managers:

SPAZIO Administrator Help 1

Open the Help menu on the menu bar:

2

Click Contents to browse the contents of the online help or Search For Help On… to search for a specific term in the online help.

3

Click About Spazio Administrator to see the name and version of the product you are using.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

56

EMAFTM082/01

Chapter 3

3.1

Security Management

Introduction SPAZIO Administrator provides comprehensive security functionality through highly configurable access rights to a range of SPAZIO objects at various levels:

3.2

„

Login - access to the SPAZIO Administrator program itself is limited to those users with appropriate access rights.

„

Nodes - at the top level, access rights for SPAZIO users can be configured for each node in the network.

„

Queue Managers - access rights for SPAZIO users can be defined for individual Queue Managers. At this level, you can also specify default Queue and DQL permissions, which will be inherited by all Queues and DQLs created under a specific Queue Manager.

„

Queues and DQLs - access rights for existing Queues and DQLs can be modified.

Logging in to SPAZIO Administrator Basic authentication is required in order to access SPAZIO Administrator, whether you wish to perform security management or any other operations (for example, those described in Chapter 2 of this manual).

3.2.1

Access control for SPAZIO Administrator When you start SPAZIO Administrator, you are requested for a User ID and Password. For information about creating, deleting, and managing user accounts, see the SPAZIO MFT/S for Distributed Platforms: Installation and Configuration manual. In order to access SPAZIO Administrator you must be part of the SPAZIO Administrators group.

3.2.2

Login procedure 1

Start SPAZIO Administrator.

2

Enter the required user name and password:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

57

Security Management

3

Click on OK.

NOTE: if you have checked the Always show login dialog box for the connections option (see section 2.4: Setting SPAZIO Administrator Options), your SPAZIO Administrator session will always begin with the Access Denied dialog box.

3.3

Node-level security SPAZIO Administrator allows you to set and modify access rights for the Node object. Section 3.3.1: Node permissions describes the various types of access that can be specified for a Node. Sections 3.3.2 to 3.3.5 explain how to associate specific permissions with user groups, how to modify these rights and how to add/remove users or groups from the access list for a specific Node.

3.3.1

Node permissions As you will see later, SPAZIO Administrator lets you manipulate security permissions at the level of individual access rights (through the Special Access option), or by specifying pre-defined sets of rights (No Access, Operator and Full Control options).

3.3.1.1 Table of access rights for Nodes The following table lists the access rights that can be specified for Nodes: Option

Code

Description

Set Node Properties

Sp

The user or group members can set the properties of the Node.

Get Node Properties

Gp

The user or group members can read the properties of the Node.

Get Node Objects

So

The user or group members can list the objects on the Node (Queue Managers, Queues etc.).

Set Node Objects

Go

The user or group members can set the properties of objects on the Node (Queue Managers, Queues etc.).

Delete Node Objects

Do

The user or group members can delete objects on the Node.

Connect

C

The user or group members can connect to the node.

Get Node Permissions

Ge

The user or group members can read permissions associated with the Node.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

58

EMAFTM082/01

Security Management

Option

Code

Description

Change Node Permissions

Ce

The user or group members can change permissions associated with the Node.

Take Node Ownership

T

The user or group members can take ownership of the node.

3.3.1.2 Types of Node access Four preset types of access are available for Nodes:

3.3.2

„

No Access - all access rights to the Node are disabled for a specific user or group.

„

Full Control - all access rights to the Node are granted for a specific user or group.

„

Operator - all access rights except Get Node Permissions, Set Node Permissions and Take Node Ownership are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.3.1.1, or to specify Full Control, for a specific user or group.

Changing access rights for groups 1

Right-click a node in the left panel of the screen and choose Security… from the pop-up menu (or select a node in the left panel of the screen and choose View - Security ... from the menu bar).

2

The Security screen appears:

3

The Name column contains a list of groups for which access rights to the Node have been defined. The Rights column specifies the access rights granted for each group, either as an access type (for example, No Access) or as a string of concatenated access codes (for example, SpGpSoGoDoC). These access rights, codes and types are explained in sections 3.3.1.1 and 3.3.1.2 above).

4

Select a group from the list in the Name column.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

59

Security Management

5

Click the down-arrow in the Type of Access box and select the type of access you want to grant to the group from the drop down menu (the available options are explained in section 3.3.1.2 above).

6

If you choose Special Access the following box appears:

Choose either of the following: Full Control (all access rights are granted) Other (only those rights that you check are granted)

3.3.3

7

Click OK to proceed, or Cancel to cancel the operation. You now return to the initial Security screen.

8

Click Apply to enforce the changes, or Cancel to cancel the operation.

Adding groups and setting their access rights 1

Right-click a node in the left panel of the screen and choose Security… from the pop-up menu (or select a node in the left panel of the screen and choose View - Security ... from the menu bar).

2

The Security screen appears:

3

Click Add ...

4

The Add Users and Groups box appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

60

EMAFTM082/01

Security Management

5

Select a group from the Names area.

6

To see a list of users belonging to the group, you can click the Show Users button. The list appears in the Names area:

7

With relevant group selected, click Add.

8

The group now appears in the Add Names area.

9

Click the down-arrow in the Type of Access box and select the type of access you want to grant to the group from the drop down menu (the available options are explained in section 3.3.1.2 above).

10 If you choose Special Access the following box appears:

Choose either of the following:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

61

Security Management

‰

Full Control (all access rights are granted)

‰

Other (only those rights that you check are granted)

Click OK to proceed, or Cancel to cancel the operation. You now return to the initial Add Users and Groups screen. 13 Click OK to enforce the changes, or Cancel to cancel the operation. 14 If you clicked OK, the group is now added with a specific set of access rights.

3.3.4

Adding users and setting their access rights 1

Right-click a node in the left panel of the screen and choose Security… from the pop-up menu (or select a node in the left panel of the screen and choose View - Security ... from the menu bar).

2

The Security screen appears:

3

Click Add.

4

The Add Users and Groups box appears:

5

Select a group from the Names area and click Show Users.

6

The users belonging to the selected group are listed in the Names area:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

62

EMAFTM082/01

Security Management

7

Select a user and click Add.

8

The user now appears in the Add Names area.

9

Click the down-arrow in the Type of Access box and select the type of access you want to grant to the user from the drop down menu (the available options are explained in section 3.3.1.2 above).

10 If you choose Special Access the following box appears:

Choose either of the following: ‰

Full Control (all access rights are granted)

‰

Other (only those rights that you check are granted)

Click OK to proceed, or Cancel to cancel the operation. You now return to the initial Add Users and Groups screen. 11 Click OK to enforce the changes, or Cancel to cancel the operation. 12 If you clicked OK, the user is now added with a specified set of access rights.

3.3.5

Removing groups 1

Right-click a node in the left panel of the screen and choose Security… from the pop-up menu (or select a node in the left panel of the screen and choose View - Security ... from the menu bar).

2

The Security screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

63

Security Management

3.4

3

The Name column contains a list of groups for which access rights to the Node have been defined.

4

Select a group from the list in the Name column.

5

Click the Remove button to remove the group from the list of groups with access rights to the Node.

Queue Manager-level security At Queue Manager level, SPAZIO Administrator lets you manage access to three security objects:

3.4.1

„

Queue Managers - you can set and change access rights for a given Queue Manager

„

Queues (default) - by setting default permissions for queues, you are specifying a series of security features that will be applied to all queues created under the current Queue Manager.

„

DQLs (default) - by setting default permissions for DQLs, you are specifying a series of security features that will be applied to all DQLs created under the current Queue Manager.

Accessing Queue Manager security management To perform Queue Manager security management: 1

Connect to a Queue Manager in the left panel of the screen.

2

Right-click the Queue Manager and choose Security… from the pop-up menu (or select the Queue Manager and choose View - Security ... from the menu bar).

3

The Security Properties screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

64

EMAFTM082/01

Security Management

4

3.4.2

You can now choose one of the following sets of Queue Manager security operations by clicking the relevant Permissions button: ‰

View or set permissions for the Queue Manager (Permissions) - see section 3.4.2 for details.

‰

View or set default permissions for the Queues belonging to the Queue Manager (Default Queue Permissions) - see section 3.4.3 for details.

‰

View or set default permissions for the DQLs belonging to the Queue Manager (Default DQL Permissions) - see section 3.4.4 for details.

Queue Manager permissions The following sections list the various access rights and access types (groups of access rights) that can be associated with Queue Managers. Setting for Queue Managers is performed in the same way as it is for Nodes (see sections 3.3.2 to 3.3.5).

3.4.2.1 Table of access rights for Queue Managers The following table lists the access rights that can be specified for Queue Managers: Option

Code

Description

Set Queue Manager Properties

Sp

The user or group members can set the properties of the Queue Manager.

Get Queue Manager Properties

Gp

The user or group members can read the properties of the Queue Manager.

Create Queue

Cq

The user or group members can create Queues under the Queue Manager.

Create DQL

Cd

The user or group members can create DQLs under the Queue Manager.

Create User Class

Cu

The user or group members can create User Classes under the Queue Manager.

Connect

C

The user or group members can connect to the Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

65

Security Management

3.4.2.2

Option

Code

Description

Get Queue Manager Permissions

Ge

The user or group members can read permissions associated with the Queue Manager.

Change Queue Manager Permissions

Ce

The user or group members can change permissions associated with the Queue Manager.

Take Queue Manager Ownership

T

The user or group members take ownership of the Queue Manager.

Types of Queue Manager access Four preset types of access are available for Queue Managers:

3.4.3

„

No Access - all access rights to the Queue Manager are disabled for a specific user or group.

„

Full Control - all access rights to the Queue Manager are granted for a specific user or group.

„

Read - Connect and Get Queue Manager Properties rights are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.4.2.1, or to specify Full Control, for a specific user or group.

Default Queue permissions The following sections list the various access rights and access types (groups of access rights) that can be set as defaults for Queues belonging to a given Queue Manager. Setting default permissions for Queues is performed in the same way as it is for Nodes (see sections 3.3.2 to 3.3.5).

3.4.3.1 Table of access rights for Queues The following table lists the access rights that can be specified as defaults for Queues: Option

Code

Description

Delete Data Object

Do

The user or group members can delete files or messages from Queues.

Peek Data Object

Po

The user or group members can read files or messages in Queues (without removing them).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

66

EMAFTM082/01

Security Management

Option

Code

Description

Write Data Object

Wo

The user or group members can put files or messages in Queues.

Set Queue Properties

Sp

The user or group members can set the properties of Queues.

Get Queue Properties

Gp

The user or group members can read the properties of Queues.

Delete Queue

D

The user or group members can delete Queues.

Get Queue Permissions

Ge

The user or group members can read the permissions associated with Queues.

Change Queue Permissions

Ce

The user or group members can change permissions associated with Queues.

Take Queue Ownership

T

The user or group members can take ownership of Queues.

3.4.3.2 Types of default Queue access Five preset types of access may be specified as the default type of access for Queues belonging to a particular Queue Manager:

3.4.4

„

No Access - all access rights to the Queue are disabled for a specific user or group.

„

Full Control - all access rights to the Queue are granted for a specific user or group.

„

Insert - Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Receive - Delete Data Object, Peek Data Object, Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.4.2.1, or to specify Full Control, for a specific user or group.

Default DQL permissions The following sections list the various access rights and access types (groups of access rights) that can be set as defaults for DQLs belonging to a given Queue Manager. Setting default permissions for DQLs is performed in the same way as it is for Nodes (see sections 3.3.2 to 3.3.5).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

67

Security Management

3.4.4.1 Table of access rights for DQLs The following table lists the access rights that can be specified as defaults for DQLs: Option

Code

Description

Write Data Object

Wo

The user or group members can write messages or files to DQLs.

Set DQL Properties

Sp

The user or group members can set the properties of DQLs.

Get DQL Properties

Gp

The user or group members can read the properties of DQLs.

Delete DQL

D

The user or group members can delete DQLs.

Get DQL Permissions

Ge

The user or group members can read the permissions associated with DQLs.

Change DQL Permissions

Ce

The user or group members can change permissions associated with DQLs.

Take DQL Ownership

T

The user or group members can take ownership of DQLs.

3.4.4.2 Types of default DQL access Four preset types of access may be specified as the default type of access for DQL belonging to a particular Queue Manager: „

No Access - all access rights to the DQL are disabled for a specific user or group.

„

Full Control - all access rights to the DQL are granted for a specific user or group.

„

Insert - Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.4.3.1, or to specify Full Control, for a specific user or group.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

68

EMAFTM082/01

Security Management

3.5

Queue and DQL-level security SPAZIO Administrator allows you to modify access rights for individual Queues and DQLs under a Queue Manager. Section 3.5.1: Queue permissions describes the various types of access that can be specified for a Queue. Section 3.5.2: DQL permissions describes the various types of access that can be specified for a DQL. NOTE: security options can not be specified for Queues or DQLs at creation time. Instead, each Queue or DQL created assumes the default permissions associated with its Queue Manager (see sections 3.4.3 and 3.4.4).

3.5.1

Queue permissions The following sections list the various access rights and access types (groups of access rights) that can be associated with Queues. Setting permissions for Queues is performed in the same way as it is for Nodes (see sections 3.3.2 to 3.3.5).

3.5.1.1 Table of access rights for Queues The following table lists the access rights that can be specified for Queues: Option

Code

Description

Delete Data Object

Do

The user or group members can delete files or messages from the Queue.

Peek Data Object

Po

The user or group members can read files or messages in the Queue (without removing them).

Write Data Object

Wo

The user or group members can put files or messages in the Queue.

Set Queue Properties

Sp

The user or group members can set the properties of the Queue.

Get Queue Properties

Gp

The user or group members can read the properties of the Queue.

Delete Queue

D

The user or group members can delete the Queue.

Get Queue Permissions

Ge

The user or group members can read the permissions associated with the Queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

69

Security Management

Option

Code

Description

Change Queue Permissions

Ce

The user or group members can change permissions associated with the queue.

Take Queue Ownership

T

The user or group members can take ownership of the Queue.

3.5.1.2 Types of Queue access Five preset types of access may be specified for a Queue:

3.5.2

„

No Access - all access rights to the Queue are disabled for a specific user or group.

„

Full Control - all access rights to the Queue are granted for a specific user or group.

„

Insert - Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Receive - Delete Data Object, Peek Data Object, Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.5.1.1, or to specify Full Control, for a specific user or group.

DQL permissions The following sections list the various access rights and access types (groups of access rights) that can be associated with DQLs. Setting permissions for DQLs is performed in the same way as it is for Nodes (see sections 3.3.2 to 3.3.5).

3.5.2.1 Table of access rights for DQLs The following table lists the access rights that can be specified for DQLs: Option

Code

Description

Write Data Object

Wo

The user or group members can write messages or files to the DQL.

Set DQL Properties

Sp

The user or group members can set the properties of the DQL.

Get DQL Properties

Gp

The user or group members can read the properties of the DQL.

Delete DQL

D

The user or group members can delete the DQL.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

70

EMAFTM082/01

Security Management

Option

Code

Description

Get DQL Permissions

Ge

The user or group members can read the permissions associated with the DQL.

Change DQL Permissions

Ce

The user or group members can change permissions associated with the DQL.

Take DQL Ownership

T

The user or group members can take ownership of the DQL.

3.5.2.2 Types of DQL access Four preset types of access may be specified for DQLs: „

No Access - all access rights to the DQL are disabled for a specific user or group.

„

Full Control - all access rights to the DQL are granted for a specific user or group.

„

Insert - Write Data Object and Get Queue Properties rights are granted for a specific user or group.

„

Special Access - allows you to grant one or more of the access rights specified in section 3.5.2.1, or to specify Full Control, for a specific user or group.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

71

Security Management

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

72

EMAFTM082/01

Chapter 4

4.1

Transport Manager

Introduction SPAZIO Transport Manager allows you to view session details of File/Message transport session that have taken place on a Local or remote Queue Manager and their respective Queues. To run Transport Manager make sure that SPAZIO is installed and running. Click Start – Programs – Primeur- Spazio Server - Spazio Event Manager, or click the Transport Manager icon on the desktop: If you try to open Transport Manager and SPAZIO is either not installed or not running, the Spazio Server not available error message appears.

4.2

A note for users who are new to Windows applications There are several ways to access most of the functions provided by Transport Manager, including: „

Point-and-click methods (for example, pressing a button on the toolbar)

„

Menus opened from the menu bar

„

Menus opened by clicking an object (for example, a Queue Manager) with right mouse button.

Alternative methods are pointed out where appropriate in this chapter.

4.3

View or modify Transport Manager runtime options You can customize your Transport Manager session through a series of usermodifiable options. To access these options, choose View – Options. The dialog box that appears contains two tabs, General, and Startup.

4.3.1

General options The first tab in the Options dialog box contains the General options for the current node.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

73

Transport Manager

The following table describes the properties listed:

4.3.2

Menu Item

Description

Node connection timeout

Node connection timeout. Default 600 seconds.

Auto Refresh interval

Set the Auto Refresh interval

Startup options The second tab in the Options dialog box contains the Startup options for the current node.

The following table describes each property: Item

Description

Connect to First Node Do not Connect

Connect to node before startup Do not Connect to node on startup

Connect to Node

Connect to a specified Node on startup

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

74

EMAFTM082/01

TTransport Manager

4.3.3

Applying changes to the options After you have modified any fields in the three tabs of the Options dialog box, click Apply and then OK to enforce the changes. If you wish to exit the operation without applying the changes, click Cancel.

4.4

Connecting to a Queue Manager You must connect to a Queue Manager before you can view Session details. When connecting a list of the Queue Managers to which you can connect are displayed in a dialog box:

4.4.1

Connect to a Queue Manager To connect to a Queue Manager: 1

Click the button, or choose Action – Connect to Node . The following menu appears.

2

Select the Queue Manager.

3

Click connect

4

If security is enabled for the selected Queue Manager the following dialog box appears:

5

Enter the correct User ID and Password, and click OK to connect.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

75

Transport Manager

4.5

View Transport Route Details (Master) SPAZIO Transport Manager lets you view session properties associated Queue Manager transport route. It also allows you to view session details associated with a Queue on a selected queue manager.

4.5.1

View Session Summary from a Queue Manager To view session properties associated a Queue Manager 1

Select the Transport Manager folder.

2

This displays a list of possible Queue Managers to view:

3

Click on the Queue Manager you wish to view.

4

Click on the Master icon The Left column now displays a list of possible Queue Manager Routes to display for the selected Queue manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

76

EMAFTM082/01

TTransport Manager

The right column display a session summary for each Queue Manager

The following table describes the properties listed: Property

Description

Remote QM

Remote Queue Manager name

Address type

Queue Manager Address Type

Status

Queue Manager Status. Can be enabled or disabled

5

Pending

Number of pending Message\Files transfers

Executing

Number of executing Message\Files transfers

Failed

Number of failed Message\Files transfers

Completed

Number of completed Message\Files transfers

Hold

Number of holding Message\Files transfers

Terminating

Number of terminating Message\Files transfers

To view a specific session summary, select a Queue manager. A list of Remote Queues is displayed in the Left panel.

The right panel displays the session summary for the selected queue

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

77

Transport Manager

The following table describes the Queue properties.

4.5.2

Property

Description

Remote Queue

Remote Queue name

Address type

Remote Address type

Queue Status

Remote Queue status

Pending

Number of pending Message\Files transfers

Executing

Number of executing Message\Files transfers

Failed

Number of failed Message\Files transfers

Completed

Number of completed Message\Files transfers

Hold

Number of holding Message\Files transfers

Terminating

Number of Terminating Message\Files transfers

View Queue Session Details 1

Click on any of the Remote Queues listed in the Left panel

2

The right panel now displays the session details between the two Queue Managers and their respective Queues.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

78

EMAFTM082/01

TTransport Manager

The following table describes the Session properties.

Property

Description

Transport Name

Session Transport Name

Transport Type

Session Transport Type

User Class

Use Class

Message/File Id

Message\File ID

Status

Queue Status. Can be enabled or disabled

4.5.3

Correlation Id

Correlation ID

Start Date/Time

Start Date/Time of message/file transfer

Interrupt Date/Time

Interrupt Date/Time of message/file transfer

CC

Completion code

RC

Reason code

Priority

Priority

Error Side

Error side

Internal Session

Internal session ID

View file Session Details Each queue displayed contains a list of files which have been used in a transfer session. SPAZIO Transport Manager allows you to view the details of each of these message/file transfer session. 1

Click on the file to display the Session Details.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

79

Transport Manager

2

The right panel displays Session Details for the selected File\Message transfer session.

The following table describes the session properties. Property

Description

Status

Session Status

Transport Type

Session Transport type

Priority

Session priority

Modality

Session Modality

Message/File Id

Message/file ID

Internal Number

Internal number

User Class

User Class

Correlation ID

Correlation ID

Original ID

Original ID

Internal Session

Internal session number

Retry Number

Number of Session retries

Max Retry

Maximum number of allowed retries

Transport name

Session transport name

Start date

Session Start date

Interrupt Date

Session Interrupt Date

Deliv From

Delivered from

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

80

EMAFTM082/01

TTransport Manager

4.6

Property

Description

Deliv to

Delivered to

Original Size

Original Message/File size

Real size

Actual Message/File size

Total Blk/Msg

Total Blk/Msg size

Original Byte Tr

Original Byte to be Transported

Real Byte Tr

Actual Byte Transported

Last Blk/Msg

Last Blk/Msg size

Last Rec Tr

Last record Trace

Ext Ftr CC

Ext Ftr Completion code

Ext Ftr RC

Ext Ftr Reason code

CC

Completion code

RC

Reason Code

Error Side

Error side

Extension code

Session extension code

View Transport Session Summary (Slave) SPAZIO Transport Manager allows you to view the session details associated with a Slave Transport. This is usually associated with a Remote Queue Manager.

4.7

1

To view the session details follow Steps 1 to 4 from section 4.5.1 - View Session Summary from a Queue Manager.

2

At this point select the Slave option. A remote Queue Manager is then displayed.

3

To display the session details follow the Steps 5 to 9 from section 4.5.1 View Session Summary from a Queue Manager.

View Transport Session Summary (Pull) SPAZIO Transport Manager allows you to view the session details associated with a Slave Transport. This is usually associated with a Remote Queue Manager. 1

To view the session details follow Steps 1 to 4 from section 4.5.1 - View Session Summary from a Queue Manager.

2

At this point select the Pull option. A remote Queue Manager is then displayed.

3

To display the session details follow the Steps 5 to 9 from section 4.5.1 View Session Summary from a Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

81

Transport Manager

4.8

File Session Options By selecting one of the File/Message transfer sessions SPAZIO Transport Manager enables the following options: Info, Stop, Resume, Delete, New Transport and Force Delete for each file transfer Session. Property

Description

Info

Retrieve details on the selected transport

Stop

Stop the selected transport

Resume

Restart the selected transport

Delete

Delete the selected transport

New Transport

Create a new transport (not enabled)

Force Delete

Force the deletion of the selected transport.

These options can be accessed via the toolbar or by right clicking on the selected transport session.

4.9

Queue Session Options By selecting one of the Remote Queue SPAZIO Transport Manager enables the following options: Enable, Disable, Stop, Resume, New Transport, Delete and Force Delete for each file transfer session in the queue. Property

Description

Enable

Enable the transports in the queue

Disable

Disable the transports in the queue

Stop

Stop all the transports in the selected queue

Resume

Resume all the transports in the selected queue

New Transport

Create a new transport for all the transports failed in the selected queue

Delete

Delete all the transports in the selected queue

Force Delete

Force the deletion of the transports in the selected queue

These options can be accessed via the toolbar or by right clicking on the selected remote queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

82

EMAFTM082/01

Chapter 5

5.1

Log Viewer

Introduction SPAZIO Log Viewer allows you to view details of any active or inactive SPAZIO session. To run Log Viewer make sure that SPAZIO is installed and running and Click Start – Programs – Primeur- Spazio Server - Spazio Log Manager, or click the Log Viewer icon on the desktop. If you try to open Log Viewer and SPAZIO is either not installed or not running, the Spazio Server not available error message appears.

5.2

A note for users who are new to Windows applications There are several ways to access most of the functions provided by Log Manager, including: „

Point-and-click methods (for example, pressing a button on the toolbar)

„

Menus opened from the menu bar

„

Menus opened by clicking an object (for example, a Queue Manager) with right mouse button

Alternative methods are pointed out where appropriate in this chapter.

5.3

View or modify Log Manager runtime options You can customize your Log Manager session through a series of usermodifiable options. To access these options, choose View – Options. The dialog box that appears contains three tabs, General, Startup and Color.

5.3.1

General options The first tab in the Options dialog box contains the General options for the current node.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

83

Log Viewer

The following table describes the properties listed:

5.3.2

Menu Item

Description

Node connection timeout

Node connection timeout. Default 600 seconds.

Startup options The second tab in the Options dialog box contains the Startup options for the current node.

The following table describes each property: Item

Description

Connect to First Node Do not Connect

Connect to node before startup Do not Connect to node on startup

Connect to Node

Connect to a specified Node on startup

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

84

EMAFTM082/01

Log Viewer

5.3.3

Color The third tab in the Options dialog box contains the Color options for the current node.

This tab contains the following options:

5.3.4

Item

Description

Failed Session

Change the font color of a failed Session

Failed Operation

Change the font color of a failed operation

Applying changes to the options After you have modified any fields in the three tabs of the Options dialog box, click Apply and then OK to enforce the changes. If you wish to exit the operation without applying the changes, click Cancel.

5.4

Connecting to a Queue Manager You must connect to a Queue Manager before you can view Session Logs. When connecting a list of the Queue Managers to which you can connect are displayed in a dialog box.

5.4.1

Connect to a Queue Manager To connect to a Queue Manager: 1

Click the button, or choose Action – Connect to Node . The following menu appears.

2

Select the Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

85

Log Viewer

3

Click on Connect.

4

If security is enabled for the selected Queue Manager the following dialog box appears:

5

Enter the correct User ID and Password, and click OK to connect.

NOTE: you can only connect to one Queue Manager at a time. If you are connected to one Queue Manager, and try to connect to a second (without disconnecting from the first), the following dialog box appears:

Click ‘Yes’ to disconnect from the current Queue Manager, and ‘No’ to connect to the new Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

86

EMAFTM082/01

Log Viewer

5.5

Extended Log View This function lets you view session properties associated with a particular session. To view session properties: 1

Select the Log Viewer folder.

2

This displays a list of Sessions in the panel

3

Click on the Log you wish to view. An extended view of the Session appears in the right panel.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

87

Log Viewer

5.5.1

View Details of a Session To view the details of a particular session, complete the step described in section 5.5 Extended Log View. 1

Select from the session you wish to view from the right panel; below

The following table describes the properties listed: Property

Description

Session Id

Session ID

Level

Session Class

Reckless

Record Class

Family

Product family

ElabCode

Elaboration Code

RecCode

Record Code

Date

Connection Date

Time

Connection Time

TimeZone

Time

CC

Completion code

RC

Return code

SetId

Character set. Platform-dependent value: Value

ASCII EBCDIC UNICODE Encoding

Integer Encoding

CurVersion

Current Spazio version

ExtRecLen

Extended Record Length

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

88

EMAFTM082/01

Log Viewer

2

To view the details of the session go to the View menu and select Details. Alternatively view the session by clicking on the Details icon provided on the Log Manager toolbar The following window is displayed, to display more session properties click Next:

This table contains the following fields Property

Description

CodedcharSetId

Code character set ID

Encoding

Integer Encoding

DataRecLength

Data record length

Date

Current Date

Family

Product Family

Level

Session Level

Class

Session Class

SessionId

Session ID

Elaboration Code

Session elaboration code

Record Type

Record type

Version

Application version

CC

Completion Code

RC

Reason Code

Obj Handle

Object handle

File Handle

File handle

Options

Session Options

Q_Manager

Current Queue Manger

SessionId

Session ID

Group Name

Group Name

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

89

Log Viewer

5.5.2

Property

Description

User Id

User ID

Original Q_Manager

Original Session Queue Manger

Processing Code

Processing code

Transid

Transport ID

Node Name\IP Address

Node IP address

Apply a filter to Session List The Log Viewer allows log sessions to be filtered according to numerous criteria. To apply a session filter: 1

Click on the Log Viewer Folder

2

Select from the Filter option from the View menu. Alternatively select the Filter button from the toolbar. The following window is displayed

The first tab in the Options dialog box contains the following options for filtering Sessions.

Property

Description

Period

Value

Description

Start Date

Session Start Date

End Date

Session End Date

Start Time

Session Start Time

End Time

Session End Time

Value

Description

All

Filter using all completion codes (default)

Completion Code

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

90

EMAFTM082/01

Log Viewer

Property

Description OK

Filter using completion code OK

Not OK

Filter using Completion code Not OK

SessionId

Filter using session ID

Max Items

Filter using the Max number of items in a Session

Elaboration Code

Filter using a Session elaboration Code

External Token

Filter using a specified External Token

The second tab in the Filter dialog box contains the Elaboration Type options for filtering:

This allows you to filter using the following Elaboration Types. „

All System Applications (no expiry)

„

All System Applications (with expiry)

„

All File System applications

„

Routers System Applications

„

Acquirers System Applications

„

SP10 without MLIST

„

All Administration Applications

„

All Message Transfer System Applications

„

External File Transfer

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

91

Log Viewer

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

92

EMAFTM082/01

Chapter 6

6.1

SPAZIO Administrator Terminal

Introduction SPAZIO Administrator Terminal is an administration tool for use with SPAZIO in non-Windows environments.

6.1.1

Functionality SPAZIO Administrator Terminal provides similar functionality to SPAZIO Administrator described in Chapters 1 and 2. In addition, it allows you to view and intervene in active transport operations as well as performing a series of operations on files.

6.1.1.1 System Administration SPAZIO Administrator Terminal allows you to perform certain administration tasks for both Local and Remote SPAZIO nodes as follows:

Local Node „

View the name and contents of the node.

„

List Queue Managers, Queues, Queues, DQLs, Communication Lines, Line Conversations Transport Classes, Transport Agents, and Tasks.

„

View the properties of Queue Managers, Queues, DQLs, Communication Lines, Line Conversations, the Transport Monitor, Transport Classes, Transport Agents, and Tasks.

„

Activate/deactivate Queue Managers, Communication Lines and the Transport Monitor.

„

Connect to/disconnect from Queue Managers.

„

Create/delete Queues, DQLs, and User Classes.

„

Set trace levels for Queue Managers, Communication Lines and the Transport Monitor. NOTE: set Trace Level operation on a SPAZIO component requires a deactivation/re-activation cycle.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

93

SPAZIO Administrator Terminal

Remote Nodes „

View the name and contents of the node.

„

List Queue Managers, Queues, Queues, DQLs and Line Addresses.

„

View the properties of Queue Managers, Queues, DQLs, and Line Addresses.

„

Connect to/disconnect from Queue Managers.

„

Create/delete Queues, DQLs, and User Classes.

6.1.1.2 Transport Management SPAZIO Administrator Terminal also allows you to manage transports (see section 6.6.2.2: Transport Management). The functions available from this menu allow you to „

List all current transport operations

„

Apply filters to the transport list

„

For each transport listed ‰

Get details about that transport operation

‰

Stop the transport

‰

Restart the transport

6.1.1.3 File Management SPAZIO Administrator Terminal provides access to a number of file operations:

6.2

„

Dispatch files

„

Acquire files

„

List files and their attributes

„

Delete files

Installation SPAZIO Administrator is installed as part of the installation of SPAZIO. See the SPAZIO MFT/S for Distributed Platforms: Installation and Configuration Guide Manual.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

94

EMAFTM082/01

SPAZIO Administrator Terminal

6.3

The SPAZIO Administrator Terminal interface The SPAZIO Administrator Terminal interface consists of a series of screens that allow you to make choices from menus, and in some cases to enter text. Screens are divided into three areas: „

The upper panel contains menus from which you can choose various items.

„

The central panel displays information and also accepts user input.

„

The bottom of the screen contains an area for displaying status and error messages.

The following table lists the various navigational and input keystrokes: Action

Keystroke

Move down /up a menu

Down arrow / Up arrow

Highlight an item to the right

Home - Right arrow

Highlight an item to the left

End - Left arrow

Confirm selection

Enter

Enter text

Standard keys

Delete text to the left

Backspace

Delete text to the right

Delete

Confirm input

Enter

Return to the previous screen

Esc

Exit the opening screen

Esc

Refresh current information

function key

A self-explicating mnemonic has been added to Reason Code display (“RC”). “WAIT PLEASE” string is now always displayed while program is waiting for answer.

6.4

Opening SPAZIO Administrator Terminal 1

Make sure that SPAZIO is installed and running.

2

From the command line:

3

„

change directory to SPAZIO\bin

„

type spadmint

The SPAZIO Administrator Terminal opening screen appears.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

95

SPAZIO Administrator Terminal

6.5

The Main Screen When you open SPAZIO Administrator Terminal the following screen appears:

You can choose one of four items from the menu at the top of the screen: Option

Description

SELECT LOCAL NODE

Lets you perform administration tasks on the Local Node

SELECT REMOTE NODE

Lets you perform administration tasks on Remote Nodes

VERSION INFORMATION

Displays version information about spadmint components

EXIT PROGRAM

Lets you shut SPAZIO Administrator Terminal

Select the relevant option and press ENTER. The following sections describe the above options in detail.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

96

EMAFTM082/01

SPAZIO Administrator Terminal

6.6

Local Node Management When you choose SELECT LOCAL NODE from the Main screen, the Local Node Management menu appears:

The following table describes the five options in this menu. Option

Description

CURRENT NODE MANAGEMENT

Lets you: „

List local/remote nodes and their properties.

„

List local Queue Managers and their properties.

„

Activate/deactivate Queue Managers.

„

View information on events.

„

Set traces for Queue Managers.

„

Activate/deactivate the Transport Monitor.

„

View information on transports.

„

List transport classes and their properties.

„

Set the trace level for the Transport Monitor.

„

List communication lines and their properties.

„

List line conversations.

„

Activate/deactivate communication lines.

„

Set trace levels for communication lines.

„

List current transactions

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

97

SPAZIO Administrator Terminal

Option

Description

TRANSPORT MONITOR MANAGEMENT

Lets you:

APPLICATION LOG MANAGEMENT

„

List transports and their status.

„

Stop/resume transports.

Lets you: „

CONNECTION TO QUEUE MANAGER

EXIT

Display the log files.

Lets you: „

Connect to a Local Queue Manager

„

List/create/delete queues

„

List/create/delete DQLs

„

List/create/delete user classes

„

List/dispatch/acquire files

Return to the previous screen

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.6.1

Current Node Management When you select this option from the Local Node Management menu, the Current Node Management menu appears. You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value, and press ENTER (default Connection Timeout = 5 min.). Next you are prompted for a user ID and password. Enter the relevant details and press ENTER.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

98

EMAFTM082/01

SPAZIO Administrator Terminal

This menu contains six options: Option

Description

NODE INFORMATION

View information on local and direct nodes.

QUEUE MANAGERS

„

List/activate/deactivate Queue Managers.

„

List events and their properties.

„

Set the trace level for Queue Managers.

„

View information on the Transport Monitor and the properties of transport classes.

„

Activate/deactivate the Transport Monitor.

„

Set the trace level for the Transport Monitor.

„

List and view the properties of communication lines.

„

Activate/deactivate communication lines.

„

List line conversations.

„

Set trace levels for communication lines.

TRANSPORT MONITOR

COMMUNICATION LINES

TRANSACTION LIST

List current transactions.

SECURITY MANAGEMENT

„

Show the current permissions.

„

Change current permissions

„

Manage Group and User permissions

EXIT

Return to the Local Node Management menu (see section 6.6).

Select the relevant option and press ENTER. The following sections describe the above options in detail.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

99

SPAZIO Administrator Terminal

6.6.1.1 Node Information When you choose this option from the Current Node Management menu, the Node Information menu appears:

This menu contains five items: Option

Description

LOCAL NODE

View information on the local node.

DIRECT NODES

View information on direct nodes.

EXIT

Return to the Current Node Management menu (see section 6.6.1).

Select the relevant option and press ENTER. The following sections describe the above options in detail.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

100

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.1.1.1 Local Node 1

Choose LOCAL NODE from the Node Information menu to display information on the local node:

2

Scroll down this screen to display the following details on the local node:

Local Node Information

Field

Description / Values

Local Node Name

Name of local (current) node.

Local Sys Name

Same as above, but truncated and converted as necessary to have a maximum of 8 UPPER CASE characters.

SpazioProcH

SPAZIO process handle.

SpChronProcH

SPAZIO CHRON process handle.

TraspMonitorH

Transport Monitor handle.

Queue Managers

Field

Description / Values

ExistLocQM

Number of existing local Queue Managers.

ActiveLocQM

Number of active local Queue Managers.

QmName

Local Queue Manager name.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

101

SPAZIO Administrator Terminal

Communication Lines

Field

Description / Values

NumCommLines

Number of communication lines defined on the local node.

ActCommLines

Number of active communication lines.

NumTrans

Total number of transmissions

ActTrans

Number of active transmissions

ActInTrans

Number of active incoming transmissions

ActOutTrans

Number of active outgoing transmissions

NumConvCommLines

Maximum number of conversations on Communication Lines

ActConvCommLines

Number of active conversations on Communication Lines

Line N.x

There is a heading Line N.x for each communication line defined, where x is the integer identifying the line (for example, in the SPLINE.INI configuration file).

Name

Name of the line.

Type

Physical connection type of SPAZIO driver:

Status

Trace

Value

Description

TCP

TCP/IP

ISCL

ISCL (with various protocols)

Activity status of the communication line: Value

Description

ACTIVE

Active

NOT ACTIVE

Not active

Trace level specified for the line Value

Description

0

No trace is set

1

Minimal trace

2

Normal trace

3

Most detailed trace

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

102

EMAFTM082/01

SPAZIO Administrator Terminal

Maximum Values

Field

Description / Values

MaxRSA

Maximum number of remote PR4 sessions.

MaxDirNodes

Maximum number of direct nodes

MaxQMs

Maximum number of Queue Managers on the local node

MaxQmSess

Maximum number of sessions on the local QM

MaxTrans

Maximum total number of active transactions

MaxActInTrans

Maximum number of transactions active in Input

MaxActOutTrans

Maximum number of transactions active in Output

MaxClientIscSess

Maximum number of ISC sessions allowed

MaxCommLines

Maximum number of non-ISC lines

MaxConvCommLines

Maximum number of Input and Output conversations on each individual non-ISC line

MaxSMonTrPermit

Maximum number of concurrent transports managed by the Transport Monitor

MaxSMonMTrasp

Maximum number of concurrent message transport agents managed by the Transport Monitor

MaxSMonFTrasp

Maximum number of concurrent file transport agents managed by the Transport Monitor

MaxSMonRQueues

Maximum number of Remote Queues on all local Queue Managers managed by the Transport Monitor

MaxSMonTrFile

Maximum number of files to be transported from all local Queue Managers managed by the Transport Monitor

MaxSMonInFile

Maximum number of files transported to local Queue Managers (by PR4 transports).

QmEventLevel

Allowed level of Event Manager for local Queue Managers: Value

Description

0

No Queue Manager event management

1

Basic Queue Manager event management

2

Extended level 1 Queue Manager event management

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

103

SPAZIO Administrator Terminal

Field

Description / Values

MaxQmEventParall

Maximum number of parallel events under a Queue Manager

MaxExistQue

Maximum number of queues under the Queue Manager

MaxOpenQue

Maximum number of queues open in a session

MaxOpenFil

Maximum number of files open in a session

QCatMax

Maximum size of the disk file for the Queues Catalog

UsClCatMax

Maximum size of the disk file for the User Classes Catalog

DQLCatMax

Maximum size of the disk file for the DQLs Catalogue

MaxQFileDepth

Maximum number of files in a queue

MaxQMsgDepth

Maximum number of messages in a queue

ClassMaxPSize

Maximum size of a Persistent Repository (on disk) for a Storage Class

ClassMaxNPSize

Maximum size of a Non-Persistent Repository (on disk) for a Storage Class

MaxDE

Maximum number of dynamic events

MaxQueDE

Maximum number of queues with dynamic events.

MaxSEinQue

Maximum number of static events that can be associated with a queue

MaxQueSE

Maximum number of queues with static events

MaxDefSE

Maximum number of default static events

MaxEvDefinitions

Maximum number of event definitions

DynRSA

Dynamic Remote Session Agent

DynSA

Dynamic Session Agent

SpSerialId

Spazio Serial ID.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

104

EMAFTM082/01

SPAZIO Administrator Terminal

Node Options

Field

Description / Values

Options

Time setting for the node:

Encoding

CharSetId

Value

Description

LOCAL TIME

Local time

GLOBAL TIME

Global time

Encoding type. Platform-dependent value: Value

Description

NORMAL

Normal.

REVERSE

Reverse.

Character set. Platform-dependent value: Value

Description

ASCII

ASCII

EBCDIC

EBCDIC

UNICODE

UNICODE

CodePage

Code Page. Default = 0.

EndOfRec

End-of-record marker:

EndOfFile

SpRstDFileMax

Value

Description

NONE

No marker

LF

Line feed

CRLF

Carriage return and Line feed

Presence of EOF marker: Value

Description

NONE

No end-of-file marker

PRESENT

End-of-file marker present

Maximum size on disk of the SPAZIO File Transport Restart file. Default: 5000000.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

105

SPAZIO Administrator Terminal

6.6.1.1.2 Direct Nodes 1

Choose DIRECT NODES from the Node Information menu to list remote direct nodes:

2

Select a node and press ENTER to display information on that node:

3

Scroll down this screen to display the following details on the direct node:

Direct Node Information Field

Description / Values

DirNodeName

Name of the direct node

System Name

Name of the direct node

NodeType

Type of the direct node. Value

Description

0

SPAZIO

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

106

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

MaxMTrasp

Maximum number of message transport agents that can be defined on this node.

MaxFTrasp

Maximum number of file transport agents that can be defined on this node.

Queue Manager Specifications Field

Description

NumQM

Number of Queue Managers defined on the direct node

Queue Manager N.x

There is one Queue Manager N.x section for each Queue Manager defined, where x is the integer identifying the Queue Manager (for example, in the SPRNODE.INI configuration file).

QMName

Name of the Queue Manager.

TrClass

Name of the Transport Class associated with the Queue Manager.

Communication Lines

Field

Description / Values

NumCommLines

Number of communication lines defined on the local node.

Line N.x

There is a heading Line N.x for each communication line defined, where x is the integer identifying the line (for example, in the SPLINE.INI configuration file).

Name

Name of the line

CxStatus

Line status: Value

Description

ACTIVE

Active

NOT ACTIVE

Not active

TimeOut

Timeout for the line.

Address

Address (IP or other type) of the line, that is, the address of the direct node.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

107

SPAZIO Administrator Terminal

6.6.1.2 Queue Managers 1

Choose QUEUE MANAGERS from the Current Node Management menu to list the local Queue Manager(s):

2

Each Queue Manager is listed together with its current status (active in the above example).

3

Select a Queue Manager and press ENTER to display the Queue Manager Operations menu:

This menu contains five options: Option

Description

DEACTIVATE | ACTIVATE QUEUE MANAGER

Deactivate/activate the selected Queue Manager.

QUEUE MANAGER INFO

View the properties of the selected Queue Manager.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

108

EMAFTM082/01

SPAZIO Administrator Terminal

4

Option

Description

QUEUE MANAGER EVENTS

List events associated with the selected Queue Manager, and view their properties.

SET TRACE LEVEL

Set the trace level for the selected Queue Manager.

EXIT

Return to the Queue Manager Operations menu

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.6.1.2.1 Activate / Deactivate Queue Manager Choose this option to deactivate an active Queue Manager, or to activate a deactivated Queue Manager.

6.6.1.2.2 Queue Manager Info 1

Choose QUEUE MANAGER INFO to display information about the local Queue Manager:

2

Scroll down this screen to display the following details on the Queue Manager:

Queue Manager Information

Field

Description / Values

QmProcHandle

Handle for the Queue Manager process.

QM StartUp

Start-up mode for the Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

109

SPAZIO Administrator Terminal

Field

Status

Description / Values Value

Description

MANUAL

Manual start-up

INIT

Automatic start-up

Current status of the Queue Manager Value

Description

ACTIVE

Queue Manager is active

NOT ACT

Queue Manager is not active

QmOptions

Internal value

MaxQMSess

Maximum number of sessions permitted for the Queue Manager.

DynSA

Dynamic Session Agents

Trace

Trace level for the Queue Manager

OneIndex

FastIndex

VirtCatalog

Value

Description

0

No trace

1

Minimal trace

2

Normal trace

3

Most detailed trace

Option for using a single index on storage classes: Value

Description

1

Option is switched on.

0

Option is switched off.

Option to use the SPAM FAST_INDEX for storage classes. Faster, but involves more work in the case of a system failure: Value

Description

1

Option is switched on.

0

Option is switched off.

Option to use the SPAM VIRT file for Queue Manager catalogues. Faster, but involves more work in the case of a system failure: Value

Description

1

Option is switched on.

0

Option is switched off.

MaxExistQueue

Maximum number of Queues under the Queue Manager.

MaxOpenQue

Maximum number of Queues open in a session.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

110

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

MaxOpenFil

Maximum number of files open in a session.

MaxUsrClass

Maximum number of user classes in a session.

QCatMax

Maximum size of the Queue Catalogue file on disk.

UsClCatMax

Maximum size of the User Class file on disk.

DQLCatMax

Maximum size of the DQL Catalogue file on disk.

MaxQFileDepth

Maximum number of files in a Queue belonging to this Queue Manager.

MaxQMsgDepth

Maximum number of messages in a Queue belonging to this Queue Manager.

QmDir

Name of the directory where Queue Manager files are stored.

QmClean

Directions for the Queue Manager Cleaner process. Value

Description

0

QmCleanInterv QmEventMngLev

No clean Clean when the Queue Manager starts 1 up. Clean when the Queue Manager starts 2 up, and then at regular intervals. Time, in hours, between successive cycles of the Queue Manager Cleaner process. Level of the Event Manager: Value

Description

1

Basic Extended

2

Storage Classes Information

Field

Description / Values

TotalClass

Total number of storage classes defined for the Queue Manager

Class ID

Class ID for the Storage Class. There is one section for each class defined.

ClassName

Name of the storage class. Max. 4 characters.

ClassDesc

Description of the storage class.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

111

SPAZIO Administrator Terminal

Field

Description / Values

ClassPath

Path where the class data and class directories are appended.

RepPMax

Maximum size on disk of the class repository file.

RepNPMax

Maximum size of the class repository file in memory.

MsgBodyPMax

Maximum size of the class message body file on disk.

MsgBodyNPMax

Maximum size of the class message body file in memory.

FileInfoPMax

Maximum size on disk of the class File Info file.

Events Information

Field

Description / Values

EvDefinNum

Number of events defined under the Queue Manager.

QueueSEvNum

Number of queues with static events.

StatEvNum

Number of static events.

MaxDE

Maximum number of dynamic events.

MaxQueDE

Maximum number of Queues with dynamic events.

6.6.1.2.3 Queue Manager Events 1

Choose QUEUE MANAGER EVENTS to display the Queue Manager Events menu:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

112

EMAFTM082/01

SPAZIO Administrator Terminal

This menu contains four options:

2

Option

Description

NEW EVENT DEFINITIONS

Create a new event definition

LIST EVENT DEFINITIONS

List current event definitions

LIST EVENT INSTANCE

List current event instances

EXIT

Return to the Queue Manager Operations menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

New Event Definitions 1

Select NEW EVENT DEFINITIONS, the following information is required to define and event definition Field

Description / Values

GroupName

Name of the event group. Maximum 8 characters.

EventName

Name of the event. Maximum 8 characters.

EventDescription

Description of the new Event

Event Body Type

Event Body Type.

Command Type

Value

Description

MINI

Distributed platforms body type

MVS

Mainframe body type

Command type used for the Event Value

Description

COMM

COMM command

SPROC

SPROC command

SHELL

Shell command

Command

User class command

Command parameters

Parameters taken by the command

Event Level

Event Level

Persistence

Value

Description

BASIC

Basic Event definition

EXTENDED

Extented Event definition

Whether the event is persistent: TRUE or FALSE

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

113

SPAZIO Administrator Terminal

Field

Description / Values Value

Description

PERSISTENT

New Event definition is persistent

VOLATILE

New Event definition is volatile

Start Valid Date

Start valid date

End Valid Date

Start valid date

Number of Conditions

Number of conditions Value

Description

ZERO ONE Number of Queues

Number of queues associated with the User class

Queue Name

Queue associated with the User Class

Address Type

Queue Address Type Value

Description

0

SPAZIO

List Event Definition 1

Select LIST EVENT DEFINITION from the Queue Manager Events menu. The following screen appears:

The following information is required to list each Event Definition:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

114

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

GroupName

Name of the event group. Maximum 8 characters.

EventName

Name of the event. Maximum 8 characters.

List Events Instances 1

Select LIST EVENT INSTANCES from the Queue Manager Events menu.

2

The following screen appears:

The following information is required to list each Event Instance: Field

Description / Values

TYPE OF EVENT BODY

Event type. One of the following:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

115

SPAZIO Administrator Terminal

Field

Description / Values Value

Description

MINI

Distributed platforms body type

MVS

Mainframe body type

GroupName

Name of the event group. Maximum 8 characters.

EventName

Name of the event. Maximum 8 characters.

6.6.1.2.4 Set Trace Level 1

Choose SET TRACE LEVEL from the Queue Manager Operations menu to set the trace level for the current Queue Manager:

2

Choose one of the following options and press ENTER: Option

Description / Values

NO TRACE

No trace is set for the Queue Manager.

TRACE LEVEL 1

Minimal trace

TRACE LEVEL 2

Normal trace

TRACE LEVEL 3

Most detailed trace

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

116

EMAFTM082/01

SPAZIO Administrator Terminal

The message TRACE LEVEL WAS SET appears at the bottom of the screen.

6.6.1.3 Transport Monitor 1

Choose TRANSPORT MONITOR from the Current Node Management menu to display the Transport Monitor menu:

This menu contains the following options: Option

Description

TRANSPORT INFORMATION

View information on file/message transports.

TRANSPORT CLASSES

View properties of transport classes.

ACTIVATE TRANSPORT MONITOR

Activate the Transport Monitor.

DEACTIVATE TRANSPORT MONITOR

Deactivate the Transport Monitor.

SET TRACE LEVEL

Set the trace level for the Transport Monitor.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

117

SPAZIO Administrator Terminal

2

Option

Description

EXIT

Return to the Current Node Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.6.1.3.1 Transport Information 1

Select TRANSPORT INFORMATION from the Transport Monitor menu and press ENTER to display the following screen:

The following table explains the fields in the Transport Monitor Information screen:

Transport Monitor Information

Field

Description / Values

TraspMonitorH

Transport Monitor handle

StartUp

Start up option.

Trace

Value

Description

MANUAL

Manual

INIT

Automatic

Trace level for the Transport Monitor Value

Description

0

No trace is set for the Transport Monitor.

1

Minimal trace

2

Normal trace

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

118

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values Most detailed trace

3 TrMonOptions

Options for the Transport Monitor

AsyncInfo

Asynchronous information support by the Transport Monitor: Value

Description

0

Off

1

On

NumFTrAgent

Number of File Transport Agents.

NumMTrAgent

Number of Message Transport Agents.

MaxMTrFailure

Maximum message transport failures.

6.6.1.3.2 Transport Classes 1

Select TRANSPORT CLASSES from the Transport Monitor menu and press ENTER to display the following screen:

2

Scroll down this screen to display the following details on the transport classes defined for this node: Field

Description / Values

TotQClasses

Total number of Transport Classes.

Transport Class N.x

There is a Transport Class N.x heading for each Transport Class defined.

QClassName

Name of the Transport Class.

StartEnabled

Transports associated with the class are enabled to start

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

119

SPAZIO Administrator Terminal

Field

Description / Values Value

Description

0

Start not enabled

1

Start enabled

FTraspAgent

Name of the File Transport Agent.

FParallTr

File Transport parallelism on a single queue. Number in the range1-4. Default: 1. Note: for FIFO policy for files, FParallTr = 1

MTraspAgent

Name of the Message Transport Agent.

MParallTr

Message Transport parallelism on a single queue. Number in the range1-4. Default: 1. Note: for FIFO policy for messages, MParallTr = 1

Priority

Selection priority of the queue. Number in the range1-10.

NumRetr

Number of retries permitted.

RetrInterval

Interval specified between retries.

Policy

Queue policy: Value

Description

IMMEDIATE

Immediate delivery

INTERVAL

Delivery within specified interval

MaxDelivDelay

Maximum delay before file or message expiry in seconds.

SyncLevel

Number of blocks (in the case of a file) or number of messages before a Sync (ACK1) is requested in the transport. Default: 10

TrAgTimeout

Timeout for Transport Agents.

SuggestFTrBlock

Suggested length of file transport block.

MTrParam

Parameters of the Message Transport Agents.

FTrParam

Parameters of the File Transport Agents.

6.6.1.3.3 Activate Transport Monitor 1

Select ACTIVATE TRANSPORT MONITOR from the Transport Monitor menu and press ENTER to display the following screen:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

120

EMAFTM082/01

SPAZIO Administrator Terminal

2

The message TRANSPORT MONITOR WAS ACTIVATED appears at the bottom of the screen.

6.6.1.3.4 Deactivate Transport Monitor 1

Select DEACTIVATE TRANSPORT MONITOR from the Transport Monitor menu and press ENTER to display the following screen:

2

The message TRANSPORT MONITOR WAS DEACTIVATED appears at the bottom of the screen.

6.6.1.3.5 Set Trace Level 1

Choose SET TRACE LEVEL from the Transport Monitor menu to set the trace level for the Transport Monitor:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

121

SPAZIO Administrator Terminal

3

4

Choose one of the following options and press ENTER to set the trace level: Option

Description / Values

NO TRACE

No trace set for the Transport Monitor.

TRACE LEVEL 1

Minimal trace

TRACE LEVEL 2

Normal trace

TRACE LEVEL 3

Most detailed trace

The message TRACE LEVEL WAS SET appears at the bottom of the screen.

6.6.1.4 Communication Lines 1

Choose COMMUNICATION LINES from the Current Node Management menu to display the Communication Lines menu:

The following menu is displayed:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

122

EMAFTM082/01

SPAZIO Administrator Terminal

This menu contains the following options:

2

Option

Description

LINE INFORMATION

View the properties of a communication line.

ACTIVATE LINE

Activate a communication line.

DEACTIVATE LINE

Deactivate a communication line.

LINE CONVERSATIONS

List active conversations on a communication line.

LINE LINKS

Links towards remote systems using ISC protocol

SET TRACE LEVEL

Set the trace level for a communication line.

EXIT

Return to the Current Node Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.6.1.4.1 Line Information 1

Choose LINE INFORMATION from the Communication Lines menu to list lines defined on this node. The following screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

123

SPAZIO Administrator Terminal

2

Select a line and press ENTER to display information on that line:

3

Scroll down this screen to display the following details on the communication line chosen: Field

Description / Values

Name

Name of the communication line.

Status

Current status of the communication line.

Type

LineDirection

Value

Description

ACTIVE

The line is active

NOT ACT

The line is not active

Type of communication driver used by the line. Value

Description

TCP

TCP/IP

ISCL

ISCL (various protocols)

Direction of communication:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

124

EMAFTM082/01

SPAZIO Administrator Terminal

Field

State

StartUp

Trace

Description / Values Value

Description

I

Input only.

O

Output only.

A

Input and output.

Current state of the line Value

Description

NOT ACT

Not active

WAIT

Waiting

LWAIT

Waiting

AVAIL

Available

BUSY

Busy

CLOSING

Closing

Start-up options: Value

Description

MANUAL

Manual

INIT

Automatic

Trace level for the line. Value

Description

0

No trace is set for the line.

1

Minimal trace

2

Normal trace

3

Most detailed trace

Cost

Cost of line usage (to decide which line to use).

TimeOut

Timeout for the line inbound to this node.

DriverHandle

Communication driver handle.

Param

Initialization parameters for the SPAZIO driver.

LocalAddress

Line address for inbound communication lines to the local node.

MaxConv

Maximum number of simultaneously active conversations.

MaxInConv

Maximum number of simultaneously active input conversations.

MaxOutConv

Maximum number of simultaneously active output conversations.

ActConv

Number of active conversations on the line.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

125

SPAZIO Administrator Terminal

Field

Description / Values

ActInConv

Number of active incoming conversations on the line.

ActOutConv

Number of active outgoing conversations on the line.

6.6.1.4.2 Activate Line 1

Choose ACTIVATE LINE from the Communication Lines menu. The following screen appears:

2

Select a line and press ENTER to activate the line. The message LINE WAS ACTIVATED appears at the bottom of the screen.

6.6.1.4.3 Deactivate Line 1

Choose DEACTIVATE LINE from the Communication Lines menu. The following screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

126

EMAFTM082/01

SPAZIO Administrator Terminal

2

Select a line and press ENTER to deactivate the line. The message LINE WAS DEACTIVATED appears at the bottom of the screen.

6.6.1.4.4 Line Conversations 1

Choose LINE CONVERSATIONS from the Communication Lines menu. The following screen appears:

2

Select a line and press ENTER to list active conversations on that line. The message NO CONVERSATIONS appears at the bottom of the screen if there are no active conversations. If there are any active conversations the following fields are displayed: Field

Description / Values

CommLineName

Name of the communication line

ProcHClient

Client process handle

ProcHConv

Conversation process handle

ConvDirection

Direction of the conversation Value

Description

I

Input

O

Output

RemNode

The name of the Remote Node at the other end of the conversation

Status values

Reserved field

Cdata

Reserved field

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

127

SPAZIO Administrator Terminal

6.6.1.4.5 Line Links 1

Choose LINE LINKS from the Communication Lines menu:

The following fields are displayed for each communication line listed. Field

Description / Values

LinkId

Link Identifier

Remote node

Remote node name

Status

Current status of the node. Values can be: Inactive Invoke Reply Active Break Closing Unknown

Conversion Counter

Conversion Counter

Timeout

Node timeout

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

128

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.1.4.6 Set Trace Level 1

Choose SET TRACE LEVEL from the Communication Lines menu to set the trace level for the Communication Line:

2

Choose one of the following options and press ENTER to set the trace level:

4

Option

Description / Values

NO TRACE

No trace set for the communication line.

TRACE LEVEL 1

Normal trace

TRACE LEVEL 2

Minimal trace

TRACE LEVEL 3

Most detailed trace

The message TRACE LEVEL WAS SET appears at the bottom of the screen.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

129

SPAZIO Administrator Terminal

6.6.1.5 Transaction List 1

Choose TRANSACTION LIST from the Current Node Management menu to list current transactions:

2

The current transactions are listed. The message NO TRANSACTIONS appears at the bottom of the screen if there are no current transactions. The following fields are displayed for each transaction listed Field

Description / Values

Id

Internal ID for the transaction

Name

Name of the transaction (for example SPTXSPMN)

Active

Whether the transaction is active

Direct.

ProcHandle

Value

Description

0

Not active

1

Active

Direction of transaction Value

Description

I

Input

0

Output

Process handle (hexadecimal)

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

130

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.1.6

Security Management Choose TRANSACTION LIST from the Current Node Management menu to manage current security settings. The following menu options are displayed: Option

Description / Values

SHOW PERMISSIONS

Displays the current permissions

CHANGE PERMISSIONS

Change the current permissions

GROUP\USERS MANAGEMENT Manage current User and Group permissions EXIT

Exit to the previous menu

6.6.1.6.1 Show Permissions 1

To display the current permissions select Show Permissions from the menu

A full list of permission properties is contained in section 3.3.1.1 - Table of access rights for Nodes.

6.6.1.6.2 Change Permissions 1

To change the current permissions select Change Permissions from the menu.

2

Select The User to be changed.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

131

SPAZIO Administrator Terminal

3

Select YES to confirm the permission change and press ENTER.

6.6.1.6.3 Group\User Management 1

To manage current Users and groups select Groups/Users Management from the menu

2

Select the group or user you wish to change.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

132

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.2

Transport Monitor Management 1

When you select this option from the Local Node Management menu (see section 6.6), the following screen appears:

Default Connection Timeout = 5 min. 2

You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value.

3

Press ENTER to display the Transport Monitor Management menu:

This menu contains three options: Option

Description

SUMMARY INFORMATION

View information on transports.

TRANSPORT MANAGEMENT

Stop/resume/view information on transports.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

133

SPAZIO Administrator Terminal

4

Option

Description

EXIT

Return to the Local Node Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.6.2.1 Summary Information This function provides summary information about transport activity towards and from the current node. 1

When you choose this option from the Transport Monitor Management menu, you are prompted to select a local Queue Manager:

2

Select a local Queue Manager and press ENTER to display the next screen:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

134

EMAFTM082/01

SPAZIO Administrator Terminal

3

Select ALL to view summary information on all remote Queue Managers, or select one of the remote Queue Managers listed to view summary information on that Queue Manager alone.

4

Press ENTER to display the next screen:

5

Select a direction. The options are as follows:

6

Option

Description

ALL

All transports.

MASTER

Master transports only (outgoing)

SLAVE

Slave transports only (incoming)

PULL

Pull transports only (incoming)

Press ENTER to confirm your choice and proceed to the next screen:

This screen lists information on transports, based on the Queue Manager and Direction choices made in the previous two screens.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

135

SPAZIO Administrator Terminal

The following table explains the fields that are listed in the above screen:

7

Field

Description / Values

LocalQm

Name of the local Queue Manager (i.e. on the node to which you are currently logged).

RemoteQm

Name of the Remote Queue Manager(s) in question. This value may be a remote Queue Manager name, or ALL QM.

Type

Type of transport. Value

Description

Master

Master transport.

Slave

Slave transport.

Pull

Pull transport.

Pend

Number of transports with pending status.

Exec

Number of transports with executing status.

Fail

Number of transports with failed status.

Comp

Number of transports with completed status.

Hold

Number of transports with hold status.

Term

Number of transports with terminating status.

Press ESC or ENTER to return to the Transport Monitor Management menu.

6.6.2.2 Transport Management The Transport Management option lets you access increasingly detailed data about transport activities, and allows transport management operations. 1

When you choose this option from the Transport Monitor Management menu, you are prompted to select a local Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

136

EMAFTM082/01

SPAZIO Administrator Terminal

2

Select a local Queue Manager and press ENTER to display the next screen:

3

Select a direction. The options are as follows:

4

Option

Description

MASTER

Master (outgoing) direction.

SLAVE

Slave (incoming) direction.

PULL

Pull (incoming) direction.

Press ENTER to confirm your choice. You are now prompted to specify a status:

The options are as follows: Option

Description

ALL

Any status.

FILTER

Filter on given status.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

137

SPAZIO Administrator Terminal

5

If you select FILTER, you are now prompted to specify which filters you require:

The following are the filters you can choose to apply:

6

Filter

Description

Executing

Transports that are currently executing.

Pending

Transports that are currently pending.

Failed

Transports that have failed.

Completed

Transports that have completed.

Hold

Transports that are on hold.

Terminating

Transports that are currently terminating.

Press ENTER to continue. Transports are now listed according to the criteria specified in the previous three screens:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

138

EMAFTM082/01

SPAZIO Administrator Terminal

The following table explains the fields that are listed in the above screen: Field

Description / Values

LocQm

Name of the local Queue Manager (at one end of the transport).

RemQm

Name of the Remote Queue Manager(s) at the other end of the transport. This value may be a remote Queue Manager name, or ALL.

AT

Address Type.

Status

ENABLED or DISABLED

Type

Type of transport. Value

Description

Master

Master transport

Slave

Slave transport

Pull

Pull transport

Pend

Number of transports with pending status.

Exec

Number of transports with executing status.

Fail

Number of transports with failed status.

Comp

Number of transports with completed status.

Hold

Number of transports with hold status.

Term

Number of transports with terminating status.

Next, select a line in the above screen and press ENTER. The following screen appears:

7

Choose one of the seven actions and press ENTER:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

139

SPAZIO Administrator Terminal

Action

Description

INFO

Get information on transmission(s) to/from the selected remote Queue Manager.

ENABLE

Enable transmission(s) from the local to the selected remote Queue Manager.

DISABLE

Disable transmission(s) from the local to the selected remote Queue Manager.

STOP-ALL

Interrupt all the transmission(s) from the local to the selected remote Queue Manager.

RESUME-ALL

Resume all the transmission(s) from the local to the selected remote Queue Manager.

DEL-ALL

Delete all the transmission(s) from the local to the selected remote Queue Manager.

DELF-ALL

Force the deletion of all the transmission(s) from the local to the selected remote Queue Manager.

8

If you choose STOP-ALL the selected transport operation is stopped:

9

If you choose RESUME-ALL the selected transport operation is resumed:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

140

EMAFTM082/01

SPAZIO Administrator Terminal

10 If you choose INFO, the following screen appears:

The following table explains the fields that are listed in the above screen: Field

Description / Values

LocalQm

Name of the local Queue Manager (at one end of the transport).

RemoteQm

Name of the Remote Queue Manager(s) at the other end of the transport. This value may be a remote Queue Manager name, or ALL.

AT

Address type

Remote Queue

There is one line in this screen for each remote queue involved in a transmission

QStatus

Status of the queue Value

Description

Enabled

Enabled

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

141

SPAZIO Administrator Terminal

Field

Description / Values Disabled

Type

Disabled

Type of transport. Value

Description

Master

Master transport.

Slave

Slave transport.

Pull

Pull transport.

Pend

Number of transports with pending status.

Exec

Number of transports with executing status.

Fail

Number of transports with failed status.

Comp

Number of transports with completed status.

Hold

Number of transports with hold status.

Term

Number of transports with terminating status.

11 Next, select a line in the above screen and press ENTER. The following screen appears:

12 Choose one of the three actions and press ENTER: Action

Description

INFO

Get information on the transmission(s) from the selected remote queue.

ENABLE

Enable transmission(s) from the selected remote queue.

DISABLE

Disable transmission(s) from the selected remote queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

142

EMAFTM082/01

SPAZIO Administrator Terminal

Action

Description

STOP-ALL

Interrupt all the transmission(s) from the remote queue.

RESUME-ALL

Resume all the transmission(s) from the remote queue.

DEL-ALL

Delete all the transmission(s) from the remote queue.

DELF_ALL

Force the deletion of all the transmission(s) from the remote queue.

NEW-TR-ALL

Create a new transport for all the transmission(s) failed from the the selected remote queue.

NOTE: in Step 8 these options were available for a selected Queue Manager. In this step they are available for Queues. 13 If you choose STOP-ALL the selected transport operation is stopped:

14 If you choose RESUME the selected transport operation is resumed:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

143

SPAZIO Administrator Terminal

15 If you choose INFO, the following screen appears:

16 If no transports are found, the message NO ITEMS FOUND appears (as above. Otherwise, the following fields are listed for each transport to/from the queue in question: MASTER Field

Description / Values

LocQMgr

Local Queue Manager name

RemQMgr

Remote Queue Manager name

AT

Address Type

LocQueue

Name of the queue under LocQMgr that points to RemQueue.

RemQueue

The queue under RemQMgr to which the LocQueue points.

QAT

The address type of the RemQueue

TranspType

A string which is a combination of one option from each of the following three groups: MASTER SEND FILE or MESSAGE For example, MASTER SEND FILE

Priority

Priority of the queue (value from 0 to 255)

MsgFileId

MsgFileID of the file or message in transmission

Internal N.

Internal number of the file or message

User Class

User Class of the file or message

Internal Session

Internal session number

Ext Token

External token

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

144

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

Status

Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED HOLD EXEC TERMINATING TERMINATING

CorrelId

Correlation ID of the file or message in transmission

TranspName

Name of the transport

StartDate

Start date/time in the format yyyymmdd – hhmmss

Interr.Date

Date/time of interruption in the format yyyymmdd – hhmmss

CompCode

Completion code returned by the transmission

ReasonCode

Reason code returned by the transmission

ErrorSide

Side on which the error occurred

17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions: Action

Description

INFO

Get information on selected transmission.

STOP

Interrupt the transmission.

RESUME

Resume the transmission.

DELETE

Delete the transmission.

NEW-TRASP

Request the Transport Monitor to schedule a new transport for the transmission

FORCE-DELETE

Force deletion of the transmission

19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

145

SPAZIO Administrator Terminal

SLAVE Field

Description / Values

LocQMgr

Local Queue Manager name

RemQMgr

Remote Queue Manager name

AT

Address Type

LocQueue

Name of the queue under LocQMgr that receive from RemQueue.

RemQueue

The queue under RemQMgr that points to the LocQueue

QAT

The address type of the RemQueue

TranspType

The string SLAVE RECEIVE FILE

Priority

Priority of the queue (value from 0 to 255)

MsgFileId

MsgFileID of the file in transmission

Internal N.

Internal number of the file

User Class

User Class of the file

Internal Session

Internal session number

Ext Token

External token

Status

Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED

CorrelId

Correlation ID of the file in transmission

TranspName

Name of the transport

StartDate

Start date/time in the format yyyymmdd – hhmmss

Interr.Date

Date/time of interruption in the format yyyymmdd – hhmmss

CompCode

Completion code returned by the transmission

ReasonCode

Reason code returned by the transmission

ErrorSide

Side on which the error occurred

17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

146

EMAFTM082/01

SPAZIO Administrator Terminal

Action

Description

INFO

Get information on selected transmission.

DELETE

Delete the transmission.

FORCE DELETE

Force deletion of the transmission

19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu. PULL Field

Description / Values

LocQMgr

Local Queue Manager name

RemQMgr

Local Queue Manager name

AT

Address Type

LocQueue

Name of the queue under LocQMgr where the file is received

RemQueue

Name of the queue under LocQMgr where the file is received

QAT

The address type of the LocQueue

TranspType

The string PULL RECEIVE FILE

Priority

Priority of the queue (value from 0 to 255)

MsgFileId

MsgFileID of the file in transmission

Internal N.

Internal number of the file

User Class

User Class of the file

Internal Session

Internal session number

Ext Token

External token

Status

Status of the transport: Possible values are: EXECUTING PENDING FAILED COMPLETED

CorrelId

Correlation ID of the file in transmission

TranspName

Name of the transport

StartDate

Start date/time in the format yyyymmdd – hhmmss

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

147

SPAZIO Administrator Terminal

Field

Description / Values

Interr.Date

Date/time of interruption in the format yyyymmdd – hhmmss

CompCode

Completion code returned by the transmission

ReasonCode

Reason code returned by the transmission

ErrorSide

Side on which the error occurred

17 You can now select any line in the above list to choose the item to which that line belongs. 18 When you press ENTER, you are presented with a list of actions: Action

Description

INFO

Get information on selected transmission.

DELETE

Delete the transmission.

FORCE DELETE

Force deletion of the transmission

19 Select an action and press ENTER to perform the operation. 20 Press ESC or ENTER to return to the Transport Monitor Management menu.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

148

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.3

Application Log Management 1

Select this option from the Local Node Management menu (see section 6.6):

2

You are requested to specify a timeout for this session. Type the value in seconds, or leave blank to accept the default value.

3

Press ENTER to display the Application Log Management menu.

6.6.3.1 Summarized List 1

Select this option from the Application Log Management menu

2

The summarized list is displayed according to the criteria specified in the following screen:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

149

SPAZIO Administrator Terminal

The following table explains the fields that are listed in the above screen:

3

4

Field

Description / Values

Filter Options

Filtering Options Value

Description

Date\time

Filter using a specific date or time

Log position

Filter using a specific position in the Log

The following fields are specific to Date\Time filtering: Field

Description / Values

Start Date

Date from which to start the filtering Value

Description

Current Date

Start filtering from today

Other date

Choose another date

Start Time

Time from which to start the filtering

End Date

Date from which to end the filtering

End Time

Time from which to end the filtering

The following fields are specific to Log Position filtering: Field

Description / Values

Start Log File

Date from which to start the filtering

Start Log Position

Position from which to start the filtering

End Log File

Date from which to end the filtering

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

150

EMAFTM082/01

SPAZIO Administrator Terminal

5

Field

Description / Values

End Log Position

Position from which to end the filtering

The following fields are common to both filtering techniques. Field

Description / Values

Completion Type

Filter using a specific completion type Value

Description

ALL

Filter using all completion codes

OK

Filter using only OK

FAIL

Filter using only FAIL

Session ID

Filter using a specific session ID

Max Items Returned

Filter by specifying a specific maximum number of items returned.

Elaboration Type

Filter using a specific elaboration type

Elaboration Code

Filter using a specific elaboration code

External Token

Filter using an external token

A summarized list is displayed according to the criteria specified.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

151

SPAZIO Administrator Terminal

6.6.3.2 Extended List 1

Select the Extented List option from the Application Log Management menu

2

The extended list is displayed according to the criteria specified in the following screen:

3

The above fields are explained in the previous section (6.6.3.1 Summarized List).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

152

EMAFTM082/01

SPAZIO Administrator Terminal

A summarized list is displayed according to the criteria specified.

6.6.3.3

User Log 1

Select the User Log (Extended) option from the Application Log Management menu.

The following table explains the fields that are listed in the below screen: Field

Description / Values

File Name Prefix

File name prefix

Filter option

Specific filtering option Value

DATE/TIME LOG POSITION Start Date

Start date

Start time

Start time

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

153

SPAZIO Administrator Terminal

6.6.3.4

Field

Description / Values

End Time

End time

End Date

End date

Session Id

Session ID

Max Items Returned

Maximum number of items that can be returned

Log Level (Elaboration Type)

Elaboration type

Elaboration Code

Elaboration code

Disconnect 1

Select the Disconnect option from the Application Log Management menu to return to the previous menu.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

154

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.4 Connection to Queue Manager Selecting this option from the Local Node Management menu (see section 6.6) allows you to „

Connect to a local Queue Manager and perform a series of operations on the SPAZIO objects that it manages (Queues, DQLs, User Classes and Files)

„

Restart a previously attempted file dispatch or file acquire operation.

1

When you select this option you are prompted to select a local Queue Manager (there is probably only one):

2

Select the Queue Manager and press ENTER to display the following screen:

Select NORMAL to proceed to the SPAZIO Object Management menu from where you can perform operations on the various objects (see section 6.6.4.1).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

155

SPAZIO Administrator Terminal

Select RESTART to restart a previously attempted file dispatch or file acquire operation (see section 6.6.4.2).

6.6.4.1

Connect to Queue Manager for SPAZIO object management 1

If you selected NORMAL in section 6.6.4, the following screen appears:

The following table explains the above items: 2

3

Connection Timeout (Default 6 min.) is now requested. Field

Description / Values

User Identifier

User ID for connecting to the current Queue Manager. If none is required, leave blank.

User Password

Password for connecting to the current Queue Manager. If none is required, leave blank.

RESTART Info

Specifies information for a restart operation. For a normal connection, select IGNORE.

Log Option

Specifies whether a log file is to be written for the operations that follow. Value

Description

NONE

No log file.

FILE

Log is to be written to a file.

Trace Level

Specifies the trace level.

Log File Name

Name of the log file.

Timeout

Connection timeout

For a normal connection (i.e. not a restart), the only fields you may have to specify are User Identifier and User Password.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

156

EMAFTM082/01

SPAZIO Administrator Terminal

4

Press ENTER to display the Object Management menu:

This menu contains five options:

5

Option

Description

QUEUE MANAGEMENT

List/create/delete queues.

DQL MANAGEMENT

List/create/delete DQLs.

USER CLASS MANAGEMENT

List/create/delete user classes.

FILE MANAGEMENT

List/dispatch/acquire files.

MESSAGE MANAGEMENT

Manage messages

SECURITY MANAGEMENT

Security management

DISCONNECT QM

Disconnect from the current Queue Manager and return to the Local Node Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

157

SPAZIO Administrator Terminal

6.6.4.1.1 Queue Management 1

Select QUEUE MANAGEMENT from the Object Management menu. The following screen appears:

This menu contains four options:

2

Option

Description

CREATE QUEUE

Create a queue.

DELETE QUEUE

Delete a queue.

LIST QUEUES

List queues belonging to the current Queue Manager and their properties.

UPDATE QUEUE

Update a queue

SECURITY

Security options

EXIT MENU

Return to the Object Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

158

EMAFTM082/01

SPAZIO Administrator Terminal

Create Queue 1

Choose CREATE QUEUE from the Queue Management menu to create a new queue. The following screen appears:

2

Fill in the required fields and make relevant selections to specify the attributes of the local or remote queue that you want to create. The following table explains the fields of the Create Queue screen: Field

Description / Values

Queue Name

Mandatory. Name of the Queue. Maximum 8 characters.

Description

Optional. Description of the queue.

Queue Address Type

Mandatory. Address type of the queue to create

Queue Type

Value

Description

SPAZIO

SPAZIO queue type

LOCAUTO

Local automatic queue type

Mandatory. Value

Description

LOCAL

Local queue

REMOTE

Remote queue

Remote Queue Manager

For remote queues only. Mandatory. The Queue Manager that owns the queue in the next field (Remote Queue).

Remote Queue

For remote queues only. Mandatory. The actual queue belonging to a Remote Queue Manager, pointed to by the remote queue being created for remote queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

159

SPAZIO Administrator Terminal

Field

Description / Values

Remote Queue Address Type

For remote queues only. Remote Queue Address Type. Value

Description

SPAZIO

SPAZIO queue type

LOCAUTO

Local automatic queue type

Remote Queue Type

For remote queues only. Remote Queue Type

Remote Queue Write Password

For remote queues only. Remote Queue Write password

Remote User ID

For remote queues only. User Id for the remote queue

Remote Password

For remote queues only. Password for connecting to the remote Queue Manager

Delivery Mode

For remote queues only. Optional. Specifies the mode of delivery to Remote Queues. Value

Description

CLASS

Delivery is according to the policies specified in a Transport Class.

IMMEDIATE

Delivery is immediate.

HOLD

Delivery is put on hold.

INTERVAL

Delivery is within a specified interval.

Max Delivery Time

(If Delivery Mode = IMMEDIATE). Optional. Maximum time allowed for delivery.

Delivery Start Time

(If Delivery Mode = INTERVAL). Optional. Start of delivery interval.

Delivery End Time

(If Delivery Mode = INTERVAL). Optional. End of delivery interval.

Transport Class

Required only if Delivery Mode=CLASS. Specifies the name of the Transport Class.

Storage Class

Optional. Storage class associated with the queue.

Default User Class

Default User Class

Read Password

Optional. Read password for the queue.

Write Password

Optional. Write password for the queue.

Set Password

Optional. Set password for the queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

160

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

Max Message Depth

Optional. Maximum number of messages that can be stored in the queue. Default: 5000.

Max. Message Length

Optional. Default = 30000 Bytes. Maximum length of messages that can be stored in the queue.

Max. File Depth

Optional. Maximum number of files that can be stored in the queue. Default: 5000.

Queue Mode

Whether the queue can be opened in shared mode:

Default Input Open Option

Queue Persistence

3

Value

Description

SHAREABLE

The queue can be opened in shared mode

NOT SHAREABLE

The queue can not be opened in shared mode

How the queue is to be opened by default Value

Description

INPUT SHARED

For shared input

INPUT EXCLUSIVE

For exclusive input

Persistence of the queue Value

Description

PERSISTENT

The queue is persistent

NOT PERSISTENT

The queue is not persistent

If you choose Insert Advanced Parameters (Insert Advanced Parameters = YES), fill in the required fields. The following table explains the advanced parameters: Field

Description

Base Queue Name

Name of the queue to which messages are sent. Max. 8 characters.

Initiation Queue Name Name of the queue for temporary holding the queued messages. Max. 8 characters.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

161

SPAZIO Administrator Terminal

Field

Description

Transmit Queue Name Name of the local queue on which prepared messages destined for a remote queue are temporarily stored Max. 8 characters. Default Priority

Default priority of messages/files on the queue. Range: [0 (min.) ... 9 (max.)]

Success Event Name

Name of the event that will be triggered if a file/message has been transmitted.

Success Event Group Name If a file/message has been transmitted, it is the name of the group that the event belongs to. Name of the event that will be triggered if a file/message has not been transmitted.

Fail Event Name

Fail Event Group Name If a file/message has not been transmitted, it is the name of the group that the event belongs to. Group Name for Submit Events Name of the group assigned by the application to the event associated with the automatic submit defined by this queue. Harden Get Backout

Whether hardening should be used to ensure that the count of the number of times that a message/file has been backed out is accurate. Value

Description

BACKOUT_NOT_HARDENED Default. The count is not hardened BACKOUT_HARDENED The count is hardened Inhibit Get

Specifies whether get operations are allowed Value

Description

GET_ALLOWED Default. Get operations are allowed GET_INHIBITED Get operations are inhibited

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

162

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description

Inhibit Put

Specifies whether messages/files can be put on the queue Value

Description

PUT_ALLOWED Default. Put operations are allowed PUT_INHIBITED Put operations are inhibited Trigger Control

Trigger Type

Specifies whether trigger messages/files are written to the initiation queue Value

Description

OFF

Default. Trigger messages/files not required

ON

Messages/files required

Specifies the condition that initiates a trigger events. When the condition is true, a trigger message/file is sent to the initiation queue. Value

Description

NONE

Default. No trigger message/file

EVERY

Trigger message/file for every message/file

FIRST

Trigger message/file when queue depth goes from 0 to 1.

DEPTH

Trigger message/file when depth threshold exceeded

Trigger Depth

Number of messages/files that will initiate a trigger message/file to the initiation queue. Max. value: 999 999 999.

Trigger Priority

Threshold message/file priority that a message must have before it can cause, or be counted for, a trigger event. Range: [0 (min.) ... 9 (max.)]

Trigger Data

User data that the queue manager includes in the trigger message/file

Usage

Specifies whether the queue is for normal usage or for transmitting messages/file to a remote queue. Value

Description

Normal

Default. Normal usage

Transmission

Transmission queue

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

163

SPAZIO Administrator Terminal

Field

Description

User Flag

Field used for to classify queues into user defines categories. SPAZIO does not validate the entered value.

Message Delivery Sequence Only for z/OS. Mode in which messages/files are delivered.

Submit Flag

Value

Description

PRIORITY

Default. Messages/files are returned in priority order

FIFO

Messages/files are returned in FIFO order (first in, first out)

For z/OS. Automatic submit attribute. This field identifies the way in which a batch job or an on line procedure event starts when a file is written into the queue. Value

Description

Blank

Default. No submit attribute

1

The event starts every time a message/file is written into the queue

2

The event starts when all messages/file belonging to a previously defined table are written into the queue

3

The event starts when a specific file/message is written into the queue

For Distributed Platforms. It forces the queue default user class for the files and the messages.

Definition Type

Value

Description

16

It forces for messages

32

It forces for files

Queue definition type Value

Description

PREDEFINED

Default. Predefined queue

PERM_DYN

Dynamically defined permanent queue

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

164

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description TEMP_DYN

Dynamically defined temporary queue

4

Once you have specified the relevant fields, press ENTER to confirm your input.

5

The message QUEUE CREATION OK appears at the bottom of the screen if the queue is created successfully.

Delete Queue 1

Choose DELETE QUEUE from the Queue Management menu to delete an existing queue. The following screen appears listing queues belonging to the current Queue Manager:

2

Select a queue from the list and press ENTER.

3

If the queue is password-protected you are next asked to enter the correct password.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

165

SPAZIO Administrator Terminal

4

Finally, you are asked to either confirm or cancel the deletion operation:

5

If you choose CANCEL OPERATION you are returned to the Queue Management menu (see section 6.6.4.1.1). If you choose CONFIRM QUEUE DELETION, the queue should be deleted and the message QUEUE DELETION OK appears at the bottom of the screen.

Update Queue 1

Choose UPDATE QUEUE from the Queue Management menu to update an existing queue. The following screen appears listing queues belonging to the current Queue Manager:

2

Select a queue you wish to update from the list and press ENTER. The following screen is displayed:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

166

EMAFTM082/01

SPAZIO Administrator Terminal

3

Select UPDATE QUEUE and press ENTER.

4

A list of queue properties is displayed (ro and rw). Select the property you wish to modify and press ENTER.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

167

SPAZIO Administrator Terminal

5

Enter the new value and press ENTER.

6

CONFIRM or CANCEL the operation. A QUEUE UPDATE OK message is displayed if the update has completed successfully.

List Queues 1

Choose LIST QUEUES from the Queue Management menu to list queues belonging to the current Queue Manager:

For each row the following attributes are displayed: ‰

Queue type (SPAZIO in the sample window above)

‰

VF = Number of currently visible files stored in the queue (“not visible” files are those that have expired and those in standby for clean up or the files that are being received but the transfer is not yet completed)

‰

TF = Number of files currently stored in the queue

‰

TM = Number of messages currently stored in the queue

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

168

EMAFTM082/01

SPAZIO Administrator Terminal

2

‰

PM = Number of persistent messages currently stored in the queue

‰

NM = Number of non-persistent messages currently stored in the queue

‰

Queue description (for local queue) or pointed remote Queue and Queue Manager (for remote queue).

Select a queue from the list and press ENTER to display information on that queue:

The following table contains the attributes which may be listed for local or remote queues: Field

Description / Values

Name

Name of the queue.

Type

Type of the queue. Value

Description

LOCAL

The queue is a local queue.

REMOTE

The queue is a remote queue.

Description

Description of the queue.

Remote Queue Manager Name

For remote queues. The name of the Queue Manager on the remote node that owns the queue named in the next field.

Remote Queue Name

For remote queues. It is the name of the queue on the remote node to which the “remote queue” defined on the local node points.

Current Visible File Depth

Number of currently visible files stored in the queue.

Current File Depth

Number of files currently stored in the queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

169

SPAZIO Administrator Terminal

Field

Description / Values

Current Persistent Depth

Number of persistent messages currently stored in the queue.

Current NonPersistent Depth

Number of non-persistent messages currently stored in the queue.

Queue Identifier

Queue identifier

Base Queue Name

Base queue name for alias queues.

Creation Date

Date when the queue was created.

Creation Time

Time when the queue was created.

Delivery End Time

End of the delivery period.

Delivery Start Time

Start of the delivery period

Fail Event Group Name

Name of the Event Group to which the event in the next field belongs.

Fail Event Name

Name of the event to be executed if transmission fails.

File Default User Class

Default user class to be associated with files.

File Transporter

The File Transport Agent to be used for transmission of files to Remote Queues.

Initiation Queue Name

Name of the initiation queue.

Message Default User Class

Default user class to be associated with messages.

Message Transporter

Message Transport Agent to be used for transmission of messages to Remote Queues.

Remote User ID

User ID for connecting to the remote queue.

Storage Class

Storage class for the queue.

Success Event Group Name

Name of the Event Group to which the event in the next field belongs.

Success Event Name

Name of the event to be executed when transmission is successful.

Transport Class

Transport Class associated with the queue (remote queues only).

Trigger Data

Trigger data

Update Date

Date when the queue was last updated.

Update Time

Time when the queue was last updated.

Transmit Queue Name

Name of the transmit queue

Maximum File Length

Maximum length for files stored in the queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

170

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

Address Type

Address type of the queue. Value

Description

0

SPAZIO. Default.

Current Message Depth

Number of messages currently stored in the queue.

Default Input Open Option

How the queue is opened by default:

Default Persistence

Value

Description

INPUT SHARED

For shared input

INPUT EXCLUSIVE

For exclusive input

Default persistence for the queue: Value

Description

PERSISTENT

The queue is persistent

NOT PERSISTENT

The queue is not persistent

Default Priority

Default priority for the queue.

Definition Type

Internal value

Delivery Mode

For remote queues only. Optional. Specifies the mode of delivery to Remote Queues. Value

Description

CLASS

Delivery is according to the policies specified in a Transport Class.

IMMEDIATE

Delivery is immediate.

HOLD

Delivery is put on hold.

INTERVAL

Delivery is within a specified interval.

NONE

No delivery mode is specified.

File Open Input Count

Number of files currently opened for input.

File Open Output Count

Number of files currently opened for output

File Transport Parallelism

File Transport parallelism

File Transport Timeout

Timeout for File Transport operations.

Harden Get Backout

Internal value

Index Type

Internal value

Info Area Length

Length of the Information Area

Inhibit Get

Whether GET operations are prohibited.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

171

SPAZIO Administrator Terminal

Field

Description / Values

Inhibit Put

Whether PUT operations are prohibited.

Max Delivery Interval

Maximum length of delivery interval

Max File Depth

Maximum number of files that can be stored in the queue.

Max File Length

Maximum length of file

Max Message Length

Maximum length of messages stored in the queue.

Max Queue Depth

Maximum number of objects (files and messages) that can be stored in the queue.

Max Restart Retry

Maximum number of transmission restarts that can be attempted.

Message Delivery Sequence

Internal value

Message Transport Parallelism

Message transport parallelism.

Message Transfer Timeout

Timeout for message transfer operations.

Open Count

Number of times the queue has been opened.

Open Input Count

Number of times the queue has been opened for input

Open Output Count

Number of times the queue has been opened for output

Queue Identifier

Queue Identifier

Remote Queue Address Type

Address type of the Remote Queue (that is, the queue belonging to a Remote Queue Manager, pointed to by a “remote queue” on the current node). Value

Description

0

SPAZIO. Default.

Remote Queue Type

Type of the Remote Queue.

Restart Interval

Interval specified between restarts.

Retention Interval

Maximum length of time a file or message can be retained in the queue.

Shareability

Whether or not the queue is shareable. Value

Description

SHAREABLE

The queue can be opened in shared mode

NOT SHAREABLE

The queue can not be opened in shared mode

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

172

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values

Submit Flag

Reserved field

Sync Level

Synchronization level (for remote queues only). The number of transmission blocks sent after which the receiver must return an acknowledgement to the sender.

Transport Priority

Priority in selecting the queue (only for remote queues).

Transmission Options

Reserved field

Trigger Control

Reserved field

Trigger Depth

Reserved field

Trigger Priority

Reserved field

Trigger Type

Reserved field

Usage

Reserved field

User Flag

Reserved field.

6.6.4.1.2 DQL Management 1

Select DQL MANAGEMENT from the Object Management menu. The following screen appears:

This menu contains four options: Option

Description

CREATE DQL

Create a DQL.

DELETE DQL

Delete a DQL.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

173

SPAZIO Administrator Terminal

2

Option

Description

LIST DQLS

List DQLs belonging to the current Queue Manager and their properties.

SECURITY

Security options

EXIT MENU

Return to the Object Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

Create DQL NOTE: all queues of a DQL must also belong to the same storage class. If a DQL item is a Queue Manager queue type (M queue type), all the other DQL queues must belong to the default storage class that is the first defined in SPQM.INI. 1

Choose CREATE DQL from the DQL Management menu to create a new DQL. The following screen appears:

The following table explains the above fields: Field

Description / Values

DQL Name

Mandatory. Name of the DQL.

Description

Optional. Description of the DQL.

Sender

Optional. Sender specified for the DQL.

Read Password

Optional. Read password for the DQL.

Write Password

Optional. Write password for the DQL.

Set Password

Optional. Set password for the DQL.

DQL Definition

Mandatory. How the DQL will be defined.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

174

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Definition File

Description / Values Value

Description

DEFINITION FILE

The DQL is created from an existing DQL definition text file.

MENU DRIVEN

The DQL will be created interactively through the following screens.

Only if DQL Definition = DEFINITION FILE. Mandatory. Name of the DQL definition file.

2

If you chose DEFINITION FILE in the DQL Definition field, and specified the file in the Definition File field, press ENTER to create the new DQL.

3

If you chose MENU DRIVEN in the DQL Definition field, the following screen appears, allowing you to add DQL items interactively to the new DQL:

The following table explains the fields in the above screen: Field

Description / Values

Item Level

Nesting level of the item.

Item Type

The type of the SPAZIO object that is currently being added to the DQL. Value

Description

GENERIC QUEUE

A queue of unspecified type.

LOCAL QUEUE

A local queue.

REMOTE QUEUE

A remote queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

175

SPAZIO Administrator Terminal

Field

Description / Values DQL

Another DQL.

QUEUE MAN

A Queue Manager

Queue/QMan Name

The name of the queue or Queue Manager being added to the DQL.

Address Type

Queue Address Type Value

Description

0

SPAZIO. Default.

Password

Password associated with the item being added.

DQL Definition

Choose whether to add another item to the DQL. Value

Description

NEXT ITEM

Add another item to the DQL.

END OF DEFINITION

DQL is complete.

4

If you choose NEXT ITEM in the DQL Definition field, this screen is repeated for another item.

5

If you choose END OF DEFINITION in the DQL Definition field and press ENTER, the new DQL is created.

6

The message DQL CREATION OK appears at the bottom of the screen if the DQL is created successfully.

Delete DQL 1

Choose DELETE DQL from the DQL Management menu to delete an existing DQL. The following screen appears listing DQLs belonging to the current Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

176

EMAFTM082/01

SPAZIO Administrator Terminal

2

Select a DQL from the list and press ENTER.

3

If the DQL is password-protected you are next asked to enter the correct password.

4

Finally, you are asked to either confirm or cancel the deletion operation:

5

If you choose CANCEL OPERATION the deletion is aborted and you are returned to the DQL Management menu (see section 6.6.4.1.2). If you choose CONFIRM DQL DELETION, the DQL is deleted and the message DQL DELETION OK appears at the bottom of the screen.

List DQLs 1

Choose LIST DQLS from the DQL Management menu to list DQLs belonging to the current Queue Manager:

2

Select a DQL and press ENTER to view information on that DQL (if the DQL is password-protected you are prompted for the correct password).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

177

SPAZIO Administrator Terminal

3

The following screen appears, providing information on the selected DQL:

The following table explains the fields in the above screen: Field

Description / Values

DQL NAME

Name of the DQL item.

TYPE

Type of the DQL item Value

Description

Q

DQL

M

Queue Manager

L

Local Queue

R

Remote Queue

G

Generic Queue

ADDR

Address type of the DQL item

LEVEL

Nesting level of the DQL item

6.6.4.1.3 User Class Management 1

Select USER CLASS MANAGEMENT from the Object Management menu. The following screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

178

EMAFTM082/01

SPAZIO Administrator Terminal

This menu contains four options:

2

Option

Description

CREATE CLASS

Create a user class.

DELETE CLASS

Delete a user class.

LIST CLASSES

List user classes belonging to the current Queue Manager and their properties.

UPDATE CLASSES

Update a user class.

EXIT MENU

Return to the Object Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

Create Class 1

Choose CREATE CLASS from the User Class Management menu to create a new user class. The following screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

179

SPAZIO Administrator Terminal

The following table explains the fields in the Create Class screen: Option

Description

User Class Name

Mandatory. Name of the user class (maximum 4 alphanumeric characters)

User Class Name

Mandatory. Name of the user class

User Class Description

Optional. Description of the user class

Expiry Hours after Put

Expiry after put operation

Expiry Hours after Read

Expiry after read operation

Expiry Seconds after Put

Optional. Default = unlimited. Number of seconds a file remains in a queue after being put there before it expires.

Expiry Seconds After Read

Optional. Default = unlimited. Number of seconds a file remains in a queue after being read before it expires.

Deletion Mode

Deletion mode for the class. Default = blank.

User class Type

Type of the class. Default = blank. User class deletion mode

User Class deletion Mode Queue Set Name

Name of the Queue Set. Default = blank.

Object Set Name

Name of the object set. Default = blank.

2

Fill in the relevant fields and press ENTER to create the new user class.

3

The message USER CLASS CREATION OK appears at the bottom of the screen if the user class is created successfully.

Delete Class 1

Choose DELETE CLASS from the User Class Management menu to delete an existing user class. The following screen appears listing user classes belonging to the current Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

180

EMAFTM082/01

SPAZIO Administrator Terminal

2

Select a user class from the list and press ENTER. You are asked to either confirm or cancel the deletion operation:

3

If you choose CANCEL OPERATION the deletion is aborted and you are returned to the User Class Management menu (see section 6.6.4.1.3). If you choose CONFIRM CLASS DELETION, the user class should be deleted and the message CLASS DELETION OK appears at the bottom of the screen.

List Classes 1

Choose LIST CLASSES from the User Class Management menu to list user classes belonging to the current Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

181

SPAZIO Administrator Terminal

See section 6.6.4.1.3 for an explanation of the fields enclosed in square brackets that follow the name of each user class in the above screen.

Update Class 1

Choose UPDATE CLASS from the User Class Management menu to list user classes belonging to the current Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

182

EMAFTM082/01

SPAZIO Administrator Terminal

2

A list of the all the current user classes is displayed. Select the user class you wish to update and press ENTER

3

From the next select UPDATE CLASS A list of fileids enclosed in square brackets is displayed.

4

Select the field to be updated and press ENTER.

5

Insert the new value and press ENTER.

6

Confirm the action by selecting CONFIRM CLASS UPDATE or cancel the operation by selecting CANCEL OPERATION

If you choose CONFIRM CLASS UPDATE, the user class should be updated and the message CLASS UPDATE OK appears at the bottom of the screen.

6.6.4.1.4 File Management 1

Select FILE MANAGEMENT from the Object Management menu. The following screen appears:

This menu contains five options:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

183

SPAZIO Administrator Terminal

2

Option

Description

DISPATCH FILE

Dispatch a file.

ACQUIRE FILE

Acquire a file.

LIST FILES

List the files in a queue and their properties.

DELETE FILES

Delete a file from a queue.

EXIT MENU

Return to the Local Node Management menu.

Select the relevant option and press ENTER. The following sections describe the above options in detail.

Dispatch File 1

When you select this option the following screen appears:

2

Select the queue to which you want to dispatch the file and press ENTER.

3

You are then asked to specify the directory containing the file to be dispatched:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

184

EMAFTM082/01

SPAZIO Administrator Terminal

4

Enter a directory path and press ENTER. The files contained in the specified directory are listed:

5

Select a file and press ENTER. The following screen appears:

The following table explains the fields in the above screen: Field

Description / Values

Correlation ID

Correlation ID of the file.

MsgFile ID Filter

Filter on the MsgFileID attribute Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

185

SPAZIO Administrator Terminal

Field

Description / Values

User Class

User class for the file.

Description

Optional. Description for the file.

Expiry After Put

Optional. Default = unlimited. Time that the file will remain in the queue after being put there before it expires.

Expiry After Read

Optional. Default = unlimited. Time that the file will remain in the queue after being read before it expires.

File Type

Whether the file is a binary or data file.

EOR Format

Destination File

Value

Description

BINARY

Binary file (default)

DATA

Data file.

Only specified if File Type = DATA. End-ofrecord marker. Value

Description

DEFAULT

Default for the platform in question.

CRLF

CRLF

LF

LF

Type of the destination file. Value

Description

INTERNAL

Internal file (the file is being transmitted to a SPAZIO queue)

EXTERNAL

External file (the file is being transferred to a destination other than a destination queue)

Destination Name

Only specified if Destination File = EXTERNAL. Destination file name.

Reload Option

File reload option

File Move Type

Type of file movement performed.

Record Type

Value

Description

COPY

The file is copied

LINK

The file is linked

Record type of the file. Value

Description

STREAM

Stream type (default).

FIX LEN

Fixed-length record.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

186

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description / Values VAR LEN

Variable length record.

Record Length

Only specified if Record Type is FIX LEN or VAR LEN. With fixed-length records, it specifies the record length. With variablelength records, it specifies the maximum record length. Default = 32000.

Compression

Type of compression applied to the file. Value

Description

NONE

No compression

BLOCK

Block compression

Priority

Value in the range 0 – 255. Default = 5. Priority of the file in the queue, where 255 represents the highest priority.

Dispatch Option

The manner in which the file is to be dispatched. Value

Description

FILE PUT

The file is dispatched as a whole.

REC BY REC

The file is dispatched one record at a time.

6

Provide the relevant information and press ENTER.

7

The message FILE DISPATCH OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.

Acquire File 1

When you select this option the following screen appears:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

187

SPAZIO Administrator Terminal

2

Select the queue from which you wish to acquire a file and press ENTER.

3

You are now given the option to filter the set of files that will be listed for the selected queue:

4

Specify the fields you wish to use to filter the list of files. The following table explains the above fields:

5

Field

Description

Correlation ID

Correlation ID.

MsgFile ID Filter

Filter on the MsgFileID attribute Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

User Class Filter

Filter on the User Class Name attribute

Sender Filter

Sender name.

Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

188

EMAFTM082/01

SPAZIO Administrator Terminal

6

Select the file that you want to acquire or whose details you wish to view. Press ENTER. The following screen appears:

The following two subsections describe the Acquire File and File Information operations.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

189

SPAZIO Administrator Terminal

Acquire File 1

Select ACQUIRE FILE to acquire the file. Press ENTER. You are then prompted to provide some file acquisition parameters:

The following table explains the above fields: Field

Description

Result File Name

Optional. The name to be given to the file after acquisition.

CodePage Acquire Option Value

Description

FILE ET BY REC Acquisition

Acquisition mode. Value

Description

BROWSE

The file is to be left in the queue after acquisition.

INPUT

The file is to be removed from the queue after acquisition.

2

Once you have specified the relevant parameters, press ENTER to continue.

3

The message FILE ACQUIRE OK appears at the bottom of the screen if the operation is carried out successfully.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

190

EMAFTM082/01

SPAZIO Administrator Terminal

File Information 1

Select FILE INFORMATION to view information about the selected file. Press ENTER. The following screen appears:

The following table describes the fields in the above screen: Field

Description

Internal Number

Internal number of the file.

MessageFile ID

File ID of the file.

User Class

User class associated with the file.

Correlation ID (Bin)

Correlation ID (Binary)

Accounting Token

Reserved field

Original Internal Number

Internal number of the file when it was first dispatched.

Original MessageFile ID

File ID of the file when it was first dispatched.

Queue ID*

Reserved field

Application ID Data

Reserved field

Application Original Data

Reserved field

Arrival Date*

Date the file arrived in the queue.

Arrival Time*

Time that the file arrived in the queue.

Correlation ID (Asc)

Correlation ID (ASCII)

Description

Description of the file.

Expiry Date

Date on which the file will expire in the queue.

Expiry Time

Time at which the file will expire in the queue.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

191

SPAZIO Administrator Terminal

Field

Description

External File Name*

External file name specified for the file.

First Read Date

Date on which the file was first read from the queue.

First Read Time

Time at which the file was first read from the queue.

Format

File format: DATA or BINARY

Internal File Name*

SPAZIO internal file name.

Last Read Date

Date on which the file was last read from the queue.

Last Read Time

Time at which the file was last read from the queue.

Original Queue Name

The name of the queue to which the file was first dispatched.

Original Queue Manager Name

The name of the Queue Manager that owned the above queue.

Original User Class

User class originally associated with the file.

Original Put Date

Date that the file was put in the queue to which it was first dispatched

Original Put Time

Time that the file was put in the queue to which it was first dispatched

Put Application Name

Name of the application that put the file in the queue.

Put Date

Date that the file was put in the current queue.

Put Time

Time that the file was put in the current queue.

Queue Name

Name of the queue where the file is currently stored.

Reply-To Queue

If there is an ACK message is to be sent when the file arrives or is read, the name of the queue to which the ACK is to be sent.

Reply-To Queue Manager

If there is an ACK message is to be sent when the file arrives or is read, the name of the Queue Manager to which the ACK is to be sent.

Sender

Sender name associated with the file.

User ID

User ID

Actual File Length*

Current length of the file in bytes.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

192

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description

Last Byte*

Number of the last byte received.

Object Size

Total length of the data object

Original File Length

Length in bytes of the file when it was first dispatched

Ack Level

ACK level specified for the file.

Backout Count

Internal value

CodePage

Code Page

Coded Char Set ID*

Char Set ID

Context*

Internal value

Counter*

Internal value

DQL Item Number

Internal value

Elaboration Pack*

Internal value

Encoding

Type of encoding

Error Code

Error code returned by Acquisition

Expiry After Get

Time that the file will remain in the queue after being read before it expires. –1 indicates there is no expiry specified.

Expiry After Put

Time that the file will remain in the queue after being put there before it expires. –1 indicates there is no expiry specified.

Feedback

Internal value

File Open Share Count*

Number of files open in shared mode

File Type

Type of the file

Internal Session ID

Internal Session ID

LUW ID*

LUW ID

Max. Block Length

Maximum block length of the file

Max. Record Length

Maximum record length of the file

Max TRX Interval*

Maximum length of transmission interval

Move Type

Move type Value

Description

COPY

File is copied

LINK

File is linked

Message Modality

Internal value

Message Mode*

Internal value

Message Status*

Internal value

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

193

SPAZIO Administrator Terminal

Field

Description

Message Type

Message Type (persistent, non-persistent)

Object Type

Object type

Original ACK Level

ACK level when the file was originally dispatched

Original Coded Char Set ID

Char Set ID originally associated with the file

Original CodePage*

Code Page originally associated with the file

Original Encoding*

Encoding originally specified for the file.

Original Message Modality*

Message modality originally specified for the file.

Original Queue Address Type

Address type of the queue from which the file was sent:

Pack Sequence Number*

Internal value

Persistence

Values: PERSISTENT or NOT PERSISTENT

Priority

Priority of the file. Value in the range 0 – 255, where 255 represents the highest priority.

Put Application Type*

Type of the application that put the file in the queue

Queue Type

Type of the queue where the file is currently stored.

Read Counter*

Internal value

Reply-To Queue Address Type

Address type of the Reply-To Queue.

Report

Internal value

Status*

Internal value

Status Flag

Internal value. It can be: Value

Description

0

Not visible

1

Delete

2

Hold for GET

4

Visible

System-User Area Length

Internal value

Total Blocks

Total blocks transferred

Total Files in Pack*

Total files in the pack

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

194

EMAFTM082/01

SPAZIO Administrator Terminal

Field

Description

Total Records

Total records transferred

Transfer Session

Internal value

Hold Status*

Internal value

Macro Selector

Internal value

Basic Component

Internal value

* If you view the attributes of a file contained in a remote queue on mainframe, the attributes marked with a (*) are listed as (able) because they are not meaningful on mainframe platforms. 3

Press ENTER to return to the File Management menu.

List Files 1

Choose LIST FILES from the File Management menu to list files in a queue belonging to the current Queue Manager:

2

Select a queue and press ENTER. You are now given the option to filter the set of files that will be listed for the selected queue:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

195

SPAZIO Administrator Terminal

3

Specify the fields you wish to use to filter the list of files. The following table explains the above fields:

3

Field

Description

Correlation ID

Correlation identifier

MsgFile ID Filter

Filter on the MsgFileID attribute Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

User Class Filter

Filter on the User Class Name attribute associated with the file.

Sender Filter

Sender name associated with the file.

Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

196

EMAFTM082/01

SPAZIO Administrator Terminal

4

If you select a file and press ENTER, a menu with the following items is displayed: Item

Description

FILE INFORMATION

It allows you to display all the details of the selected file. The fields are fully described in the previous section: File Information.

RE-SUBMIT FILE

Only for files belonging to remote queues. It allows you to resubmit the file. The user must issue the queue write password, if necessary.

UPDATE FILE

It allows you to display all the details and change some of the following parameters of the selected file: „

Description

„

Reply-To Queue

„

Reply-To Queue Manager

„

Reply-to Queue Address Type

„

Status Flag (from value 2 to value 4 for the unlocking of the selected file)

The fields are fully described in the previous section File Information. 5

Press ENTER or ESC to return to the list of files in the preceding screen. From there either chooses another file, or press ENTER or ESC to return to the File Management menu.

Delete Files 1

Choose DELETE FILES from the File Management menu to delete files from a queue belonging to the current Queue Manager:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

197

SPAZIO Administrator Terminal

2

Select a queue and press ENTER.

3

You are now given the option to filter the set of files that will be listed for the selected queue:

4

These fields are described below

5

Field

Description

Sender

Sender name associated with the message

Queue Read password

Read password for the Queue

MsgFile ID Filter

Filter on the MsgFileID attribute Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

User Class Filter

Filter on the User Class Name attribute

Correl ID Filter

Filter on the Correl ID Filter attribute

Sender Filter

Filter on the Sender ID Filter attribute

Press ENTER to list the files in the selected queue (filtered according to any criteria specified in the previous step):

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

198

EMAFTM082/01

SPAZIO Administrator Terminal

6

Select the file you wish to delete. Press ENTER. The following screen appears:

6

Select CONFIRM FILE DELETION delete the file. To cancel the deletion select CANCEL OPERATION.

7

Press ENTER or ESC to return to the list of files in the preceding screen. From there either chooses another file, or press ENTER or ESC to return to the File Management menu.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

199

SPAZIO Administrator Terminal

6.6.4.1.5 Message Management Choose MESSAGE MANAGEMENT from the Object Management menu. The following screen appears:

Put Message 1

To put carry out a Put Message Operation choose PUT MESSAGE from the Message Management menu. The following screen appears:

2

You are asked to select the Queue Address Type you wish to put the message to.

3

Select the Queue you wish to put the message to and press ENTER.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

200

EMAFTM082/01

SPAZIO Administrator Terminal

4

Enter the message criteria.

The fields are explained below. Field

Description

Sender

Sender name associated with the message.

Queue Write password

Write password for the message

Message Source

Message source

Message Persistence

Whether the Message is persistent: TRUE or FALSE

MsgFile ID Value

Message File ID

Message Format

Message format

User Class

User Class of the message

Correlation ID

Correlation ID of the message

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

201

SPAZIO Administrator Terminal

Field

Description

Message Description

Message Description

Expiry secs After Put

Specifies (in seconds)an interval after which messages inserted in the queue will expire.

Expiry Secs After Read

Specifies an interval after which messages read from the queue will expire.

Message Modality

Internal value

Message Type

Message Type (persistent, non-persistent)

Priority

Priority of the queue

ACK Option

Ack type.

5

Provide the relevant information and press ENTER.

6

The message MESSAGE PUT OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.

Get Message 1

To put carry out a Get Message Operation choose GET MESSAGE from the Message Management menu. The following screen appears:

2

You are asked to select the Queue Address Type you wish to get the message from.

3

Select the queue from which you wish to get a message and press ENTER.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

202

EMAFTM082/01

SPAZIO Administrator Terminal

4

You are now given the option to filter the set of files that will be listed for the selected queue:

The fields are explained below. Field

Description

Sender

Sender name associated with the message

Queue Read password

Read password for the Queue

MsgFile ID Filter

Filter on the MsgFileID attribute

User Class Filter

Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

Filter on the User Class Name attribute

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

203

SPAZIO Administrator Terminal

Field

Description

Correl ID Filter

Filter on the Correl ID Filter attribute

Sender Filter

Filter on the Sender ID Filter attribute

4

Provide the relevant information and press ENTER.

5

The message MESSAGE PUT OK (internal number) appears at the bottom of the screen if the operation is carried out successfully.

List Messages 1

Choose LIST MESSAGES from the Queue Management menu to list messages on a Queue:

2

Select a queue and press ENTER. You are now given the option to filter the set of messages that will be listed for the selected queue:

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

204

EMAFTM082/01

SPAZIO Administrator Terminal

3

Specify the fields you wish to use to filter the list of files.

The following table explains the above fields: Field

Description

Sender

Sender name associated with the message

Queue Read password

Read password for the Queue.

MsgFile ID Filter

Filter on the MsgFileID attribute Value

Description

NONE

No MsgFileID filter

ASCII

Include files whose MsgFileID is in ASCII format

BINARY

Include files whose MsgFileID is in Binary format

User Class Filter

Filter on the User Class Name attribute

Correl ID Filter

Filter on the Correl ID Filter attribute

Sender Filter

Filter on the Sender ID Filter attribute

3

Press ENTER to list the message in the selected queue (filtered according to any criteria specified in the previous step):

4

Select the message whose details you wish to view. Press ENTER. The following screen appears:

5

Press ENTER or ESC to return to the list of messages in the preceding screen. From there either chooses another message, or press ENTER or ESC to return to the Message Management menu.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

205

SPAZIO Administrator Terminal

6.6.4.1.6 Security Management 1

Choose SECURITY MANAGEMENT from the Queue Management menu to Manage Security on a Queue Manager:

2

You are now given the option to manage security on a Queue Manager or Queue Definition.

3

Select either QUEUE MANAGER or QUEUE DEF and press ENTER

4

The following menu is displayed (Security Management is explained in section 6.6.1.6).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

206

EMAFTM082/01

SPAZIO Administrator Terminal

6.6.4.1.7 Disconnect QM Choose DISCONNECT QM from the Object Management menu to return to the Local Node Management menu.

6.6.4.2 Connect to Queue Manager to perform a Restart operation 1

Select the CONNECTION TO QUEUE MANAGER option from the Local Node Management menu (see section 6.6), to restart a previously attempted file dispatch or file acquire operation.

2

When you select this option you are prompted to select a local Queue Manager (there is probably only one):

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

207

SPAZIO Administrator Terminal

3

Select the Queue Manager and press ENTER to display the following screen:

4

You are now prompted to select the type of restart operation (which must be either DISPATCH or ACQUISITION), and to enter the name of the restart file:

5

Press ENTER to begin the restart operation. Press ESC to return to the Local Node Management menu (see section 6.6).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

208

EMAFTM082/01

SPAZIO Administrator Terminal

6.7

Remote Node Management 1

When you choose SELECT REMOTE NODE from the Main screen, the Select Node screen appears:

2

Choose a node from the list and press ENTER. The Remote Node Management menu appears:

The following table describes the options in this menu. Option

Description

CURRENT NODE MANAGEMENT

Not implemented for remote node management

TRANSPORT MONITOR MANAGEMENT

Lets you: „

List transports and their status.

„

Stop/resume transports.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

209

SPAZIO Administrator Terminal

Option

Description

APPLICATION LOG MANAGEMENT

Not currently implemented

CONNECTION TO QUEUE MANAGER

Lets you: „

Connect to a Local Queue Manager

„

List/create/delete queues

„

List/create/delete DQLs

„

List/create/delete user classes

„

List/dispatch/acquire files

Return to the Main menu.

EXIT

Select the relevant option and press ENTER. The following sections describe the above options in detail.

6.7.1

Current Node Management These functions (described in section 6.6.1) are not supported for remote nodes.

6.7.2 Transport Monitor Management Follow the instructions in section 6.6.2.

6.7.3

Application Log Management These functions will be implemented in a future release.

6.7.4

Connection to Queue Manager Follow the instructions in section 6.6.4.

6.7.5

Exit Select this option from the Remote Node Management menu (see section 6.7) to return to the Main menu (see section 6.5).

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

210

EMAFTM082/01

SPAZIO Administrator Terminal

6.8

Closing SPAZIO Administrator Terminal Return to the Main screen (pressing ESC as many times as necessary), and either: „

Press ESC again, or

„

Select EXIT PROGRAM and press ENTER.

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide EMAFTM082/01

211

SPAZIO Administrator Terminal

SPAZIO MFT/S for Distributed Platforms ver. 2.5: System Administrator's Guide

212

EMAFTM082/01

View more...

Comments

Copyright ©2017 KUPDF Inc.
SUPPORT KUPDF