0% found this document useful (0 votes)
16 views812 pages

DQM 1 MST

Uploaded by

cyougokichi
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
16 views812 pages

DQM 1 MST

Uploaded by

cyougokichi
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 812

IBM Z NetView

6.4

Messages and Codes


Volume 1 (AAU-DSI)

IBM

GC27-2856-10
Note
Before using this information and the product it supports, read the information in “Notices” on page
795.

This edition applies to version 6, release 4 of IBM Z NetView (product number 5697-NV6 ) and to all subsequent
versions, releases, and modifications until otherwise indicated in new editions.
This edition replaces GC27-2856-09.
© Copyright International Business Machines Corporation 1997, 2022.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
Contents

About this publication............................................................................................v


Intended audience....................................................................................................................................... v
Publications.................................................................................................................................................. v
IBM Z NetView library............................................................................................................................. v
Related publications ............................................................................................................................. vi
Terminology in this Library....................................................................................................................vii
Using IBM Z NetView online help......................................................................................................... vii
Accessing publications online.............................................................................................................. vii
Ordering publications ..........................................................................................................................viii
Accessibility .............................................................................................................................................. viii
Support information.................................................................................................................................. viii
Conventions used in this publication........................................................................................................ viii
Typeface conventions ..........................................................................................................................viii
Operating system-dependent variables and paths...............................................................................ix
Syntax diagrams.....................................................................................................................................ix

Chapter 1. AAU Prefix Messages............................................................................ 1

Chapter 2. AQN Prefix Messages.......................................................................... 79

Chapter 3. BNH Prefix Messages........................................................................ 117

Chapter 4. BNJ Prefix Messages......................................................................... 353

Chapter 5. CNM Prefix Messages........................................................................ 473

Chapter 6. CNMPP Prefix Messages.................................................................... 599

Chapter 7. DSI Prefix Messages..........................................................................605

Appendix A. Codes............................................................................................ 777


NetView Abend Codes............................................................................................................................. 777
Alias Sense Codes....................................................................................................................................789
Global Sense Codes........................................................................................................................... 790
Specific-Request Sense Codes.......................................................................................................... 790
LUC Conversation Request Service Return Codes and Sense Codes.....................................................790
Generic Alert Code Points....................................................................................................................... 791
Code Point Format..............................................................................................................................792
Resource Types (X'05')...................................................................................................................... 792
Recommended Actions (X'81').......................................................................................................... 792
Detail Data (X'82').............................................................................................................................. 792
Detail Data (X'85').............................................................................................................................. 793
Actual Actions (X'86').........................................................................................................................793
Generic Alert Data/Resolution Data (X'92')...................................................................................... 793
Probable Causes (X'93').....................................................................................................................793
User Causes (X'94')............................................................................................................................793
Install Causes (X'95')......................................................................................................................... 794
Failure Causes (X'96')........................................................................................................................ 794

Notices..............................................................................................................795

iii
Programming Interfaces..........................................................................................................................796
Trademarks.............................................................................................................................................. 796
Privacy policy considerations.................................................................................................................. 796

iv
About this publication
The IBM Z® NetView® product provides advanced capabilities that you can use to maintain the highest
degree of availability of your complex, multi-platform, multi-vendor networks and systems from a single
point of control. This publication, IBM Z NetView Messages and Codes Volume 1 (AAU-DSI), lists the
messages produced by the NetView program. Many of the messages described in this publication can
be used in NetView automation. See the IBM Z NetView Automation Guide for more information about
NetView automation. Messages that are new or changed for this release are listed in the IBM Z NetView
Installation: Migration Guide. You can display the descriptions for SNA or VTAM® sense codes that you
encounter in a NetView message by using the SENSE command list. For more information, see the
Systems Network Architecture Formats manual or the appropriate VTAM manual.

Intended audience
This publication is for system programmers and operators who need explanations of and responses to the
messages produced by the NetView program.

Publications
This section lists publications in the IBM Z NetView library and related documents. It also describes how
to access NetView publications online and how to order NetView publications.

IBM Z NetView library


The following documents are available in the IBM Z NetView library:
• Administration Reference, SC27-2869, describes the NetView program definition statements required
for system administration.
• Application Programmer's Guide, SC27-2870, describes the NetView program-to-program interface
(PPI) and how to use the NetView application programming interfaces (APIs).
• Automation Guide, SC27-2846, describes how to use automated operations to improve system and
network efficiency and operator productivity.
• Command Reference Volume 1 (A-N), SC27-2847, and Command Reference Volume 2 (O-Z), SC27-2848,
describe the NetView commands, which can be used for network and system operation and in
command lists and command procedures.
• Installation: Configuring Additional Components, GC27-2851, describes how to configure NetView
functions beyond the base functions.
• Installation: Configuring the NetView Enterprise Management Agent, GC27-2853, describes how to
install and configure the IBM Z NetView Enterprise Management Agent.
• Installation: Getting Started, GI11-9443, describes how to install and configure the base NetView
program.
• Installation: Migration Guide, GC27-2854, describes the new functions that are provided by the current
release of the NetView product and the migration of the base functions from a previous release.
• IP Management, SC27-2855, describes how to use the NetView product to manage IP networks.
• Messages and Codes Volume 1 (AAU-DSI), GC27-2856, and Messages and Codes Volume 2 (DUI-IHS),
GC27-2857, describe the messages for the NetView product, the NetView abend codes, the sense
codes that are included in NetView messages, and generic alert code points.
• Programming: Pipes, SC27-2859, describes how to use the NetView pipelines to customize a NetView
installation.

© Copyright IBM Corp. 1997, 2022 v


• Programming: REXX and the NetView Command List Language, SC27-2861, describes how to write
command lists for the NetView product using the Restructured Extended Executor language (REXX) or
the NetView command list language.
• Security Reference, SC27-2863, describes how to implement authorization checking for the NetView
environment.
• Troubleshooting Guide, GC27-2865, provides information about documenting, diagnosing, and solving
problems that occur in the NetView product.
• Tuning Guide, SC27-2874, provides tuning information to help achieve certain performance goals for the
NetView product and the network environment.
• User's Guide: Automated Operations Network, SC27-2866, describes how to use the NetView
Automated Operations Network (AON) component, which provides event-driven network automation,
to improve system and network efficiency. It also describes how to tailor and extend the automated
operations capabilities of the AON component.
• User's Guide: NetView, SC27-2867, describes how to use the NetView product to manage complex,
multivendor networks and systems from a single point.
• User's Guide: NetView Enterprise Management Agent, SC27-2876, describes how to use the NetView
Enterprise Management Agent.
• Licensed Program Specifications, GC31-8848, provides the license information for the NetView product.
• Program Directory for IBM Z NetView US English, GI11-9444, contains information about the material
and procedures that are associated with installing the NetView product.
• Program Directory for IBM Z NetView Japanese, GI11-9445, contains information about the material and
procedures that are associated with installing the NetView product.
• Program Directory for IBM Z NetView Enterprise Management Agent, GI11-9446, contains information
about the material and procedures that are associated with installing the IBM Z NetView Enterprise
Management Agent.
The following books are archived:
• Customization Guide, SC27-2849, describes how to customize the NetView product and points to
sources of related information.
• Data Model Reference, SC27-2850, provides information about the Graphic Monitor Facility host
subsystem (GMFHS) and MultiSystem Manager data models.
• Installation: Configuring Graphical Components, GC27-2852, describes how to install and configure the
NetView graphics components.
• Programming: Assembler, SC27-2858, describes how to write exit routines, command processors, and
subtasks for the NetView product using assembler language.
• Programming: PL/I and C, SC27-2860, describes how to write command processors and installation exit
routines for the NetView product using PL/I or C.
• Resource Object Data Manager and GMFHS Programmer's Guide, SC27-2862, describes the NetView
Resource Object Data Manager (RODM), including how to define your non-SNA network to RODM and
use RODM for network automation and for application programming.
• User's Guide: NetView Management Console, SC27-2868, provides information about the NetView
management console interface of the NetView product.

Related publications
You can find additional product information on the IBM Z NetView web site at https://www.ibm.com/
products/z-netview.
For information about the NetView Bridge function, see Tivoli NetView for OS/390 Bridge Implementation,
SC31-8238-03 (available only in the V1R4 library).

vi IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Terminology in this Library
The following terms are used in this library:
CNMCMD
For the CNMCMD member and the members that are included in it using the %INCLUDE statement
CNMSTYLE
For the CNMSTYLE member and the members that are included in it using the %INCLUDE statement
DSIOPF
For the DSIOPF member and the members that are included in it using the %INCLUDE statement
IBM® Tivoli® Netcool®/OMNIbus
For either of these products:
• IBM Tivoli Netcool/OMNIbus
• IBM Tivoli OMNIbus and Network Manager
MVS™
For z/OS® operating systems
MVS element
For the base control program (BCP) element of the z/OS operating system
NetView
For the following products:
• IBM Z NetView version 6 release 4
• IBM Z NetView version 6 release 3
• IBM Tivoli NetView for z/OS version 6 release 2 modification 1
• NetView releases that are no longer supported
PARMLIB
For SYS1.PARMLIB and other data sets in the concatenation sequence
VTAM
For Communications Server - SNA Services
Unless otherwise indicated, topics to programs indicate the latest version and release of the programs. If
only a version is indicated, the topic is to all releases within that version.
When a topic is made about using a personal computer or workstation, any programmable workstation
can be used.

Using IBM Z NetView online help


The following types of IBM Z NetView mainframe online help are available, depending on your installation
and configuration:
• General help and component information
• Command help
• Message help
• Sense code information
• Recommended actions

Accessing publications online


IBM posts publications for this and all other products, as they become available and whenever they
are updated, to the IBM Documentation at https://www.ibm.com/docs/en. You can find IBM Z NetView
documentation on IBM Z NetView Documentation.
Note: If you print PDF documents on other than letter-sized paper, set the option in the Print window that
enables Adobe Reader to print letter-sized pages on your local paper.

About this publication vii


Ordering publications
You can order many IBM publications online at http://www.ibm.com/e-business/linkweb/publications/
servlet/pbi.wss
You can also order by telephone by calling one of these numbers:
• In the United States: 800-426-4968
• In Canada: 800-879-2755
In other countries, contact your software account representative to order IBM publications. To locate the
telephone number of your local representative, perform the following steps:
1. Go to http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss.
2. Select your country from the list and click the grey arrow button beside the list.
3. Click About this site to see an information page that includes the telephone number of your local
representative.

Accessibility
Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to
use software products successfully. Standard shortcut and accelerator keys are used by the product and
are documented by the operating system. Refer to the documentation provided by your operating system
for more information.
For additional information, see the Accessibility appendix in the User's Guide: NetView.

Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following
ways for you to obtain the support you need:
Online
Please follow the instructions located in the support guide entry: https://www.ibm.com/support/
home/pages/support-guide/?product=4429363.
Troubleshooting information
For more information about resolving problems with the IBM Z NetView product, see the IBM Z
NetView Troubleshooting Guide. You can also discuss technical issues about the IBM Z NetView
product through the NetView user group located at https://groups.io/g/NetView. This user group is for
IBM Z NetView customers only, and registration is required. This forum is also monitored by interested
parties within IBM who answer questions and provide guidance about the NetView product. When a
problem with the code is found, you are asked to open an official case to obtain resolution.

Conventions used in this publication


This section describes the conventions that are used in this publication.

Typeface conventions
This publication uses the following typeface conventions:
Bold
• Lowercase commands and mixed case commands that are otherwise difficult to distinguish from
surrounding text
• Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons,
list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs,
property sheets), labels (such as Tip:, and Operating system considerations:)
• Keywords and parameters in text

viii IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Italic
• Citations (examples: titles of publications, diskettes, and CDs
• Words defined in text (example: a nonswitched line is called a point-to-point line)
• Emphasis of words and letters (words as words example: "Use the word that to introduce a
restrictive clause."; letters as letters example: "The LUN address must start with the letter L.")
• New terms in text (except in a definition list): a view is a frame in a workspace that contains data.
• Variables and values you must provide: ... where myname represents...
Monospace
• Examples and code examples
• File names, programming keywords, and other elements that are difficult to distinguish from
surrounding text
• Message text and prompts addressed to the user
• Text that the user must type
• Values for arguments or command options

Operating system-dependent variables and paths


For workstation components, this publication uses the UNIX convention for specifying environment
variables and for directory notation.
When using the Windows command line, replace $variable with %variable% for environment variables
and replace each forward slash (/) with a backslash (\) in directory paths. The names of environment
variables are not always the same in the Windows and UNIX environments. For example, %TEMP% in
Windows environments is equivalent to $TMPDIR in UNIX environments.
Note: If you are using the bash shell on a Windows system, you can use the UNIX conventions.

Syntax diagrams
The following syntax elements are shown in syntax diagrams. Read syntax diagrams from left-to-right,
top-to-bottom, following the horizontal line (the main path).
• “Symbols” on page ix
• “Parameters” on page x
• “Punctuation and parentheses” on page x
• “Abbreviations” on page x
For examples of syntax, see “Syntax examples” on page x.

Symbols
The following symbols are used in syntax diagrams:

Marks the beginning of the command syntax.

Marks the end of the command syntax.

Indicates that the command syntax is continued on the next line.

Indicates that a statement is continued from the previous line.


|
Marks the beginning and end of a fragment or part of the command syntax.

About this publication ix


Parameters
The following types of parameters are used in syntax diagrams:
Required
Required parameters are shown on the main path.
Optional
Optional parameters are shown below the main path.
Default
Default parameters are shown above the main path. In parameter descriptions, default parameters
are underlined.
Syntax diagrams do not rely on highlighting, brackets, or braces. In syntax diagrams, the position of
the elements relative to the main syntax line indicates whether an element is required, optional, or the
default value.
When you issue a command, spaces are required between the parameters unless a different separator,
such as a comma, is specified in the syntax.
Parameters are classified as keywords or variables. Keywords are shown in uppercase letters. Variables,
which represent names or values that you supply, are shown in lowercase letters and are either italicized
or, in NetView help, displayed in a differentiating color.
In the following example, the USER command is a keyword, the user_id parameter is a required variable,
and the password parameter is an optional variable.
USER user_id
password

Punctuation and parentheses


You must include all punctuation that is shown in the syntax diagram, such as colons, semicolons,
commas, minus signs, and both single and double quotation marks.
When an operand can have more than one value, the values are typically enclosed in parentheses and
separated by commas. For a single value, the parentheses typically can be omitted. For more information,
see “Multiple operands or values” on page xi.
If a command requires positional commas to separate keywords and variables, the commas are shown
before the keywords or variables.
When examples of commands are shown, commas are also used to indicate the absence of a positional
operand. For example, the second comma indicates that an optional operand is not being used:

COMMAND_NAME opt_variable_1,,opt_variable_3

You do not need to specify the trailing positional commas. Trailing positional and non-positional commas
either are ignored or cause a command to be rejected. Restrictions for each command state whether
trailing commas cause the command to be rejected.

Abbreviations
Command and keyword abbreviations are listed in synonym tables after each command description.

Syntax examples
The following examples show the different uses of syntax elements:
• “Required syntax elements” on page xi
• “Optional syntax elements” on page xi
• “Default keywords and values” on page xi

x IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• “Multiple operands or values” on page xi
• “Syntax that is longer than one line” on page xii
• “Syntax fragments” on page xii

Required syntax elements


Required keywords and variables are shown on the main syntax line. You must code required keywords
and variables.
REQUIRED_KEYWORD required_variable

A required choice (two or more items) is shown in a vertical stack on the main path. The items are shown
in alphanumeric order.
REQUIRED_OPERAND_OR_VALUE_1

REQUIRED_OPERAND_OR_VALUE_2

Optional syntax elements


Optional keywords and variables are shown below the main syntax line. You can choose not to code
optional keywords and variables.

OPTIONAL_OPERAND

A required choice (two or more items) is shown in a vertical stack below the main path. The items are
shown in alphanumeric order.

OPTIONAL_OPERAND_OR_VALUE_1

OPTIONAL_OPERAND_OR_VALUE_2

Default keywords and values


Default keywords and values are shown above the main syntax line in one of the following ways:
• A default keyword is shown only above the main syntax line. You can specify this keyword or allow it
to default. The following syntax example shows the default keyword KEYWORD1 above the main syntax
line and the rest of the optional keywords below the main syntax line.
• If an operand has a default value, the operand is shown both above and below the main syntax line. A
value below the main syntax line indicates that if you specify the operand, you must also specify either
the default value or another value shown. If you do not specify the operand, the default value above the
main syntax line is used. The following syntax example shows the default values for operand OPTION=*
above and below the main syntax line.

KEYWORD1 OPTION=*
COMMAND_NAME
KEYWORD1 OPTION= *
KEYWORD2 VALUE1

KEYWORD3 VALUE2

Multiple operands or values


An arrow returning to the left above a group of operands or values indicates that more than one can be
selected or that a single one can be repeated.

About this publication xi


KEYWORD= (
,

REPEATABLE_OPERAND_OR_VALUE_1

REPEATABLE_OPERAND_OR_VALUE_2

REPEATABLE_OPERAND_OR_VALUE_3

value_n )

Syntax that is longer than one line


If a diagram is longer than one line, each line that is to be continued ends with a single arrowhead and the
following line begins with a single arrowhead.
OPERAND1 OPERAND2 OPERAND3 OPERAND4 OPERAND5 OPERAND6

OPERAND7 OPERAND8

Syntax fragments
Some syntax diagrams contain syntax fragments, which are used for lengthy, complex, or repeated
sections of syntax. Syntax fragments follow the main diagram. Each syntax fragment name is mixed case
and is shown in the main diagram and in the heading of the fragment. The following syntax example
shows a syntax diagram with two fragments that are identified as Fragment1 and Fragment2.

COMMAND_NAME Fragment1

Fragment2

Fragment1
KEYWORD_A= valueA KEYWORD_B KEYWORD_C

Fragment2
KEYWORD_D KEYWORD_E= valueE KEYWORD_F

xii IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Chapter 1. AAU Prefix Messages

This chapter lists the AAU prefix messages.


Note: All return codes displayed in AAU messages are in decimal format.
AAU000I MESSAGE NUMBER nnn NOT IN Operator response
MESSAGE CSECT module
Enter a valid selection number or enter a valid NetView
command. See the NetView online help.
Explanation
AAU010I INVALID FUNCTION SELECTED
During a data services command processor (DSCP)
request for a message from the specified message
table, the message in field nnn is either zero or a value Explanation
not found in the message control section (CSECT). You responded incorrectly to a request for a command
Message Variables entry on the session monitor panel. You entered a
function command that was not valid when you were
nnn prompted to enter either a selection number or a
The message number selection number followed by a function command.
module
The message table AAUAMDMA, AAUNMDMA, or System action
AAUZMDMA
The NetView program ignores the request and
processing continues.
System action
The data services command processor continues Operator response
processing.
Enter a valid request or enter a valid NetView
command. See the NetView online help.
Operator response
AAU015I PORT ADDRESS: X'address'
Notify the system programmer.
NCPNAME: name NCP RESOURCE
NAME: station
System programmer response
Determine whether the message number is in the Explanation
named control section and then contact IBM Software
You entered the LINEMAP command. This message
Support.
provides the port address for the specified station.
AAU009I INVALID RESPONSE/SELECTION Message Variables
NUMBER
address
The hexadecimal network control program (NCP)
Explanation line port address of the named station attached to
You responded incorrectly to a request for a command the named network control program. For stations
entry on the session monitor panel. You incorrectly where a port address is not applicable, N/A is
spaced the command options or, when prompted for a displayed.
selection number, did not enter a number or entered a name
number that was not on the panel that is displayed. The name of the network control program
specified in the LINEMAP command.
System action station
The NetView program ignores the request and The name of the station specified in the LINEMAP
processing continues. command.

© Copyright IBM Corp. 1997, 2022 1


System action System action
Processing continues. The request for connectivity test stops and processing
continues.
AAU016I EXPLICIT ROUTE DATA (ER) NOT
AVAILABLE AAU019I CONNECTIVITY EXISTS BETWEEN
name1 name2
Explanation
Explanation
You selected explicit route (ER) from the session
configuration panel. Your network is either not You selected the connectivity test (CT) request from
authorized to view the explicit route data for the the session list panel. The connectivity test between
network being displayed, or VTAM does not supply the the specified session partners (real network names are
route data. used for cross-network sessions) was successful.
Message Variables
System action
name1
The NetView program ignores the request and The primary session partner
processing continues. name2
The secondary session partner
Operator response
Enter an appropriate selection or a valid NetView System action
command. Processing continues.
AAU017I CONNECTIVITY TEST TIMEOUT AAU020I module locid operatorid VSAM
I/O REQUEST FAILED TO START:
Explanation DSIZVSMS R/C - MAJOR = majcode
MINOR = mincode, VSAM DATASET
You selected the connectivity test (CT) request from
= ddname, KEY 'keyval'
the session list panel and timed out before the request
was processed.
Explanation
System action DSIZVSMS detected an error in the I/O request and
gave nonzero return codes majcode and mincode.
The request for connectivity test stops and processing
If the return codes are both 9999, the DSIZVSMS
continues.
macro is not issued because the parameters passed
by module module were not valid.
Operator response
Message Variables
Notify the system programmer.
module
The control section (CSECT) name where an error
System programmer response condition was detected.
Contact IBM Software Support. locid
The location within the named CSECT where an
AAU018I NO CONNECTIVITY TEST - NO error condition was detected.
ROUTE DATA
operatorid
The NetView terminal operator identifier. If no
Explanation operator is defined, this value is blank.
You selected the connectivity test (CT) request from majcode
the session list panel. The access method did not The DSIZVSMS REG15 code. The code is in
provide local route data. This message is displayed decimal.
if any access method in the route does not support mincode
the connectivity test. A connectivity test cannot be run The DSIZVSMS FDBK code. The code is in decimal.
without route data.

2 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


ddname System programmer response
The name of the VSAM data set that encountered
the error. If the ddname cannot be determined, Ensure that VSAM data sets AAUVSPL and AAUVSSL
this value is UNKNOWN. used the correct VSAM definitions. If so, contact IBM
Software Support.
keyval
The key used for the VSAM request. AAU022I module locid operatorid VSAM I/O
COMPLETION FAILURE: VSAM R/C
- MAJOR = majcode MINOR =
System action
mincode, DDNAME = ddname, KEY
The NetView program stops processing for this VSAM 'keyval'
database record. If this message is a result of an
operator request, message AAU050I is sent to the Explanation
NetView terminal operator who issued the request.
The module requested a keyval using the VSAM macro
to initiate a VSAM I/O request. The request did not
Operator response
complete successfully.
Enter the command again that failed. If the same
Message Variables
condition occurs, notify the system programmer.
module
System programmer response The control section (CSECT) name where an error
condition was detected.
Refer to IBM Z NetView Programming: Assembler for locid
information about the specific error. The location within the CSECT where an error
AAU021I module locid operatorid LOGICAL condition was detected.
RECORD BLOCKING ERROR operatorid
DETECTED The NetView terminal operator identifier. If no
operator is defined, this value is blank.
Explanation majcode
The VSAM REG15 code. The code is in decimal.
The service routine cannot insert the logical temporary
record into the physical temporary record. Either there mincode
was not enough space in the physical record or you The VSAM FDBK code. The code is in decimal.
specified an incorrect physical or logical record size. ddname
Message Variables The name of the VSAM data set that encountered
the error. If the DDNAME cannot be determined,
module this value is UNKNOWN.
The control section (CSECT) name where an error
keyval
condition was detected.
The key used for the VSAM request.
locid
The location within the named CSECT where an
error condition was detected.
System action
operatorid Processing stops for this VSAM database record.
The NetView terminal operator identifier. If no
operator is defined, this value is blank. Operator response
Notify the system programmer.
System action
If this message is a result of an operator request, System programmer response
message AAU050I is sent to the NetView terminal
operator who issued the request. Processing stops for Refer to the appropriate VSAM manual to determine
the logical temporary record. the type of error indicated by the major and minor
(REG15 and FDBK) codes that are returned. The
following descriptions are some of the common minor
Operator response codes associated with a major code of 8:
Notify the system programmer. 4
The end of the data set was encountered.

Chapter 1. AAU Prefix Messages 3


8 module
You attempted to store a record with a duplicate The control section (CSECT) name where an error
key, or there is a duplicate record for an alternate condition was detected.
index with the unique key option. locid
16 The location within the CSECT where an error
The record is not found in the database. When condition was detected.
such an indication is associated with the session operatorid
monitor, it is usually part of regular operation and The NetView terminal operator identifier. If no
can be ignored. operator is defined, this value is blank.
24
A record resides on a volume that cannot be System action
mounted.
28 Data services command processor (DSCP) processing
The data set is full and cannot be extended. stops.
You can run the DBAUTO command to perform
database maintenance. You can also use the Operator response
DBINIT command (called by the CNMSTYLE
Determine whether you received message BNH16I,
member when the NetView program starts) to set
which means the task has reached its storage limit.
global variables and to perform periodic database
If so, notify your system programmer.
maintenance.
40
There is insufficient virtual storage in the address System programmer response
space to complete the request. Refer to the IBM Z NetView Troubleshooting Guide for
44 possible causes of the storage shortage. If necessary,
The work area is not large enough for the data refer to the IBM Z NetView Tuning Guide for more
record or for the buffer. storage calculation information.
64 AAU024I module locid TRACE BUFFER
There is insufficient storage available to add SEQUENCE ERROR: nnn DATA
another string dynamically. For a DFSMS BUFFER(S) LOST
Transactional VSAM Services (DFSMStvs) or VSAM
Record Level Sharing (RLS) application control
Explanation
block (ACB), the limit of 1024 outstanding
requests for this ACB has been exceeded. The path information unit (PIU) buffer header
96 sequence number does not match the expected path
An attempt was made to change the prime key or information unit buffer sequence number. The number
key of reference while making an update. of data buffers specified by nnn are skipped.
108 Message Variables
The RECLEN is incorrect. module
112 The control section (CSECT) name where an error
The specified KEYLEN is too large or equal to zero. condition was detected
190 locid
There is a partial EOV error. The location within the CSECT where an error
192 condition was detected
The relative record number is not valid. nnn
The number of data buffers
AAU023I module locid operatorid DSIGET
FAILURE DETECTED
System action
Explanation Processing continues.
The NetView storage allocation routine indicated that
storage is unavailable for a storage request. Operator response
Message Variables Reduce the number of sessions being traced. If this
message persists, notify the system programmer.

4 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response retcode
The internal NetView return code has one of the
Adjust the access method buffer size and the following values:
number of buffers. Refer to the IBM Z NetView
Installation: Configuring Additional Components for 00
more information. Successful completion.
04
AAU025I module locid operatorid
The NetView domain is not on the LUC control
PARAMETER ERROR DETECTED
queue.
08
Explanation The conversation is already allocated or
You specified a LIST type that was not valid. The allocation is pending.
NetView program detected the error while processing 12
your LIST command. The conversation was not allocated,
Message Variables deallocation completion is pending, or a
deallocation request is pending.
module
16
The control section (CSECT) name where an error
Request type not valid.
condition was detected.
20
locid
PARML is less than or equal to zero.
The location within the CSECT where an error
condition was detected. 24
A nonzero immediate return code was received
operatorid
from the command facility component.
The NetView terminal operator identifier. If no
operator is defined, this value is blank. 28
LUC service cannot get the required storage.
System action 32
The NetView domain is not valid.
Processing of the request stops.
System action
Operator response
Processing continues.
Refer to the online help to determine valid parameters
and enter the LIST command again.
Operator response
AAU027I module locid operatorid CROSS
DOMAIN IMMEDIATE FAILURE. Use the panel NLDM.LIST.DOM to check the status of
RETURN CODE = retcode the conversation as listed in the online help. If the
message persists, notify the system programmer.

Explanation
System programmer response
You receive this message when you issue a cross-
domain request. During initialization, this message Verify that cross-domain names are defined properly
indicates that the NetView program you are trying to in the NetView member DSILUCTD.
reach might not be active. AAU028I PRIMARY GATEWAY TRACE DATA
Message Variables NOT AVAILABLE FROM THIS
DOMAIN
module
The control section (CSECT) name where an error
condition was detected.
Explanation
locid You requested primary gateway trace data that is not
The location within the CSECT where an error available.
condition was detected.
operatorid System action
The NetView terminal operator identifier. If no Processing of request stops.
operator is defined, this value is blank.

Chapter 1. AAU Prefix Messages 5


Operator response displayed when it is prohibited by the NetView security
parameter in the identified network.
Set the domain to the remote network SSCP and
request gateway trace data. However, if gateway Message Variables
trace has timed out in the remote network during netid
initialization, gateway trace data is not available in the The network where the failure occurred
remote network.
resource
AAU029I SECONDARY GATEWAY TRACE The name of the network control program (NCP)
DATA NOT AVAILABLE FROM THIS where the failure occurred
DOMAIN reason
The VTAM return code indicating the reason for the
Explanation routing failure
You requested secondary gateway trace data that is
not available. System action
Processing of the request stops.
System action
Processing of request stops. Operator response
Notify the system programmer.
Operator response
Set the domain to the remote network SSCP, if System programmer response
possible, and request gateway trace data. However, if For the meaning of the reason code, see byte 4 of the
gateway trace has timed out in the remote network NC-ER-TEST-REPLY in the appropriate VTAM manual,
during initialization, gateway trace data is not available or in the appropriate Systems Network Architecture
in the remote network. manual.
AAU030I VIRTUAL ROUTE DATA NOT AAU032I SESSION INACTIVE - NO
AVAILABLE FOR INACTIVE CONNECTIVITY TEST
SESSION

Explanation
Explanation
You selected the connectivity test (CT) request from
This message is issued in response to a user selecting the session list panel. The session is either inactive or
virtual route (VR) from a configuration panel for a it passes through a node that is running the session
session that is inactive. Active virtual route data monitor on a VTAM without warm start capability. No
cannot be displayed for an inactive session. connectivity testing is done.

System action System action


The request for virtual route status data ends and Processing of the request stops.
processing continues.

Operator response
Operator response
When the session becomes active, enter the command
Enter an appropriate selection or a valid NetView again.
command.
AAU033I module locid INSUFFICIENT
AAU031I ROUTE FAILURE IN NETWORK STORAGE EXISTS FOR TIMER
netid, NODEID resource, REASON REQUEST
reason

Explanation
Explanation
There was a DSIGET failure when the timer service
You selected the connectivity test (CT) request from routine was called.
the session list panel. The connectivity test failed
at the indicated network element. NODEID is not Message Variables

6 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module Explanation
The control section (CSECT) name where an error
condition was detected Because this VTAM level does not support the warm
start capability, the ENABLE command is not valid.
locid
The location within the CSECT where an error
condition was detected System action
The NetView program ignores the command.
System action
AAU036I module locid operatorid INVALID
The timer request is ignored. RECORD TYPE ENCOUNTERED

Operator response Explanation


Determine whether the task you are running is under The data services command processor (DSCP)
storage constraint. If the storage is constrained, notify encountered a record that was not valid. The
the system programmer. command processor cannot retrieve the data you
requested.
System programmer response Message Variables
Refer to the IBM Z NetView Troubleshooting Guide for module
possible causes of the storage shortage. If necessary, The control section (CSECT) name where an error
refer to the IBM Z NetView Tuning Guide for more condition was detected.
storage calculation information. locid
AAU034I NETWORK NAME SUPPLIED BY The location within the CSECT where an error
VTAM netid1 DOES NOT MATCH condition was detected.
USER SUPPLIED NETWORK NAME operatorid
netid2 netid1 IS USED The NetView terminal operator identifier. If no
operator is defined, this value is blank.
Explanation
The value of the VTAM NETID start option is different
System action
from the value specified by the NETID INITMOD Processing of this request stops.
statement in AAUPRMLP.
Message Variables Operator response
netid1 Notify the system programmer.
The network ID specified in the VTAM NETID start
option
System programmer response
netid2
The network ID specified by the NETID INITMOD Contact IBM Software Support.
statement in AAUPRMLP AAU037I module locid INVALID SAW
RECORD: BUFFER SEQUENCE
System action NUMBER= X'bufseqno' OFFSET=
X'offset'
Processing continues.

Explanation
System programmer response
The session awareness (SAW) data buffer contains a
Either remove the NetView NETID INITMOD statement record that is not valid.
from AAUPRMLP or change the value to equal
that supplied by the VTAM start option. For more Message Variables
information about the INITMOD statement, refer to the module
IBM Z NetView Administration Reference. The control section (CSECT) name where an error
AAU035I ENABLE COMMAND NOT condition was detected
SUPPORTED BY CURRENTLY
INSTALLED ACCESS METHOD

Chapter 1. AAU Prefix Messages 7


locid Explanation
The location within the CSECT where an error
condition was detected You made a request to activate session awareness, but
session awareness is already activated.
bufseqno
The hexadecimal sequence number of the SAW
buffer containing the SAW record that is not valid System action
offset The NetView program ignores the request.
The hexadecimal offset within the SAW buffer to
AAU040I REQUIRED PARAMETER(S)
the SAW record that is not valid
MISSING FOR EXPLICIT
COMMAND
System action
No processing of the session awareness buffer is Explanation
attempted.
One or more required parameters is missing.

Operator response
System action
Notify the system programmer.
The NetView program ignores the request.

System programmer response


Operator response
Contact IBM Software Support.
See the NetView online help to determine the correct
AAU038I module locid INVALID SAW parameters and enter the explicit command again.
BUFFER RECEIVED
AAU041I INVALID RESOURCE NAME
SPECIFIED
Explanation
The session awareness (SAW) processor received a Explanation
buffer that does not contain session awareness data.
You entered an incorrect resource name in a
Message Variables command.
module
The control section (CSECT) name where an error System action
condition was detected
The NetView program ignores the request.
locid
The location within the CSECT where an error
condition was detected
Operator response
Determine the correct resource name and enter the
System action command again.

No processing of the received buffer is attempted. AAU042I TOO MANY PARAMETERS


SPECIFIED
Operator response
Explanation
Notify the system programmer.
You entered one or more extraneous parameters.
System programmer response
System action
Contact IBM Software Support.
The NetView program ignores the request.
AAU039I SESSION AWARENESS ALREADY
ACTIVE. ENABLE COMMAND IS
IGNORED
Operator response
See the NetView online help to determine the correct
parameters and enter the explicit command again.
AAU043I INVALID LIST TYPE SPECIFIED

8 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
The LIST command function you requested was not See the NetView online help for more information
valid. Only LU, PLU, SLU, PU, SSCP, ER, VR, ALL, about the COUNT parameter and enter the KEEP
HISTORY, CP, and DOMAIN are valid. command again.
AAU047I SPECIFIED KEEP COUNT OUT OF
System action RANGE
The NetView program ignores the request.
Explanation
Operator response The count of items to be retained in the KEEP
See the NetView online help to determine the correct command was out of range. The range is 1-999.
parameters and enter the LIST command again.
System action
AAU044I INVALID 'KEEP' FUNCTION
SELECTED The NetView program ignores the request.

Explanation Operator response


The KEEP command function you requested was not See the NetView online help to determine the correct
valid. You entered an incorrect parameter. parameters and enter the KEEP command again.
AAU048I INVALID 'TRACE' FUNCTION
System action SPECIFIED
The NetView program ignores the request.
Explanation
Operator response The TRACE command function you requested was not
See the NetView online help to determine the correct valid. Only START, STOP, or DISP are valid.
parameters and enter the KEEP command again.
System action
AAU045I INVALID 'DISKEEP' FUNCTION
SELECTED The NetView program ignores the request.

Explanation Operator response


The DISKEEP command function you requested was See the NetView online help to determine the correct
not valid. You entered an incorrect parameter. parameters and enter the TRACE command again.
AAU049I INVALID DOMAIN NAME
System action SPECIFIED
The NetView program ignores the request.
Explanation
Operator response You specified an incorrect domain name as a
See the NetView online help to determine the correct parameter on the TRACE command.
parameters and enter the DISKEEP command again.
System action
AAU046I NON-NUMERIC KEEP COUNT
SPECIFIED The NetView program ignores the request.

Explanation Operator response


You specified a KEEP count value that was non- Enter the command again with a valid domain name.
numeric. For a list of possible valid domain names, use the LIST
DOMAIN command. See the NetView online help to
System action determine the correct command syntax.

The NetView program ignores the request.

Chapter 1. AAU Prefix Messages 9


AAU050I DATA SERVICES FAILURE IN AAU052I DATA SERVICES FAILURE IN
PROCESSING LAST COMMAND DOMAIN domainid IN NETWORK
netid
Explanation
Explanation
While processing your request, an error occurred
under the data services task. The authorized message Data services failed while running a NetView command
receiver might get an additional message indicating in the domain and network you specified. The
the specific error that was encountered, unless authorized message receiver in the domain specified
message suppression is in effect. The VSAM database gets an additional error message.
might be full, causing some VSAM I/O messages to be
Message Variables
suppressed.
domainid
System action The domain where data services failed
netid
The request or command you entered is not The network where data services failed
processed.

System action
Operator response
The command you entered is ignored.
Enter the request again or enter a new command. The
NLDM SMDR QUERY command shows the status of
VSAM session recording. If the status is inactive, check Operator response
the log for message AAU272I. If the problem recurs, Enter the request again or enter a new command. If
notify the system programmer. the problem recurs, notify the system programmer.

System programmer response System programmer response


See the related messages sent to the authorized See the related messages sent to the authorized
message receiver. message receiver.
AAU051I module locid ER-TESTED RU HAS AAU053I COMMAND BEING PROCESSED
BEEN TRUNCATED BY NETVIEW

Explanation
Explanation
The NetView program is processing the command that
System capabilities have been exceeded. The explicit was entered.
route-tested request/response unit (ER-TESTED RU)
contains data for each node in an explicit route.
Because of many nodes in an explicit route, the System action
NetView program has received an ER-TESTED RU that Processing continues.
exceeds the allowable length.
AAU054I TIME EXPIRED IN NETWORK netid
Message Variables
module Explanation
The control section (CSECT) name where an error
condition was detected You requested data that had to be retrieved from
your network or from another network. Because of
locid
high activity on the network, or because the data
The location within the CSECT where an error
you requested was not available, the amount of time
condition was detected
allowed for the command expired before you were
able to receive the data.
System action
Message Variables
The ER-TESTED RU is not processed. The NetView
netid
program continues to function, but route data for any
The name of the network from which the data is
sessions using this route is not available.
being retrieved

10 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
Processing of the command stops. The NetView program ignores the request.

Operator response Operator response


Retry the request later. Return to the NLDM session panel and enter your
selection again. If the domain name or adjacent
AAU055I SENSE CODE X'hhhh' NOT
network name are the only fields not available, notify
RECOGNIZED BY LINEMAP
the system programmer.
COMMAND

System programmer response


Explanation
Contact IBM Software Support.
You issued the LINEMAP command and the returned
sense code was not recognized. AAU058I module locid SAW INVALID
FOR SESSION STATE: BUFFER
Message Variables
SEQUENCE= X'bufseqno' OFFSET=
hhhh X'offset' PCID= X'pcid'
The hexadecimal sense code
Explanation
System action
The session awareness processor encountered a
The NetView program ignores the command and record that was not valid for its current session state.
processing continues.
Message Variables

System programmer response module


The control section (CSECT) name where an error
Use the sense code to find out why the network condition was detected
control program (NCP) cannot complete the NetView locid
LINEMAP request. For sense code information, refer to The location within the CSECT where an error
Systems Network Architecture Formats. condition was detected
AAU056I CONNECTIVITY TEST CANNOT BE bufseqno
RUN FOR LOCALLY ATTACHED The hexadecimal sequence number of the SAW
RESOURCE buffer containing the SAW record that is not valid
offset
Explanation The hexadecimal offset within the SAW buffer to
the SAW record that is not valid
You selected the connectivity test (CT) request from
the session list panel for a session involving a locally pcid
attached resource. The locally attached resources are The procedure correlation identifier found in the
not supported for connectivity test requests. SAW record that is not valid

System action System action


The request is ignored. No processing of the session awareness (SAW) buffer
is attempted.
AAU057I ADJACENT NET DATA NOT
AVAILABLE AT THIS TIME
Operator response
Explanation Notify the system programmer.

When building a configuration panel for a cross-


network session, the data services command System programmer response
processor (DSCP) cannot resolve either the adjacent Contact IBM Software Support.
network name or the domain name for one side of the
panel. AAU059I ERROR WHILE PROCESSING PIU
TRACE BUFFER - SOME DATA MAY
BE LOST

Chapter 1. AAU Prefix Messages 11


Explanation Explanation
The trace buffer processor detected an error condition. The amount of storage required to retain the number
This indicates that the buffer contains a path of items you specified by the KEEP command is not
information unit (PIU) that is not valid or a complete available.
PIU that is too large for the specified buffer size. The
PIU buffer header (48 bytes) and the first 64 bytes of System action
the PIU data are logged in the NetView log following
this message. To prevent filling the NetView log, the The NetView program ignores the request.
AAU059I message is sent only approximately once an
hour if the complete PIU truncation problem occurs Operator response
repeatedly.
Enter the command again. If this message recurs,
decrease the KEEP count and enter the command
System action
again. If unsuccessful, notify the system programmer.
Detection of an invalid PIU results in an end to further
processing of this trace buffer. A complete PIU that System programmer response
exceeds the buffer size is truncated and retained.
If storage is constrained, refer to the IBM Z NetView
Troubleshooting Guide. If necessary, refer to the
Operator response
IBM Z NetView Tuning Guide for storage calculation
Notify the system programmer. information.
AAU062I KEEP PROCESSING HAS
System programmer response COMPLETED SUCCESSFULLY
If tracing the complete PIU (CPIU), increase the NLDM
PIU buffer size (NLDM.PIUTSIZE in the CNMSTYLE Explanation
member) to accept complete PIUs in their entirety (the
The NetView program successfully processed the
maximum allowable PIU size is 32K). You can find the
KEEP command.
PIU size by locating the 64 BYES of PIU Data
string after the AAU059I message. The PIU size is at
offset X'20' of the PIU data. If you are not tracing System action
complete PIUs, contact IBM Software Support and
Processing continues.
provide the PIU BUFFER HEADER DATA and the PIU
DATA. AAU063I SPECIFIED SESSION(S) NOT
FOUND: FORCE COMMAND
AAU060I SPECIFIED SESSION(S) NOT
CANCELLED
FOUND — KEEP COMMAND
CANCELLED
Explanation
Explanation You specified one or more session names in the FORCE
command that cannot be found.
No sessions were found for the given resource names.

System action
System action
The NetView program ignores the request.
The NetView program ignores the request.

Operator response
Operator response
Determine the correct session names and enter the
Determine the correct resource names and enter the
command again.
command again.
AAU064I INSUFFICIENT STORAGE
AAU061I INSUFFICIENT STORAGE TO
AVAILABLE TO FORCE SPECIFIED
EXPAND KEEP COUNT(S) TO
SESSION(S)
SPECIFIED VALUE

12 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation AAU067I SESSION AWARENESS CANNOT
BE DISABLED WHILE TRACE OR
The amount of virtual storage required to force the ACCOUNTING ACTIVE
sessions you specified is not available. If you used a
single name in the FORCE command, some sessions
might have been forced, but not all. Explanation
You entered a DISABLE command while the trace or
System action accounting function was active.
Processing continues.
System action
Operator response The NetView program ignores the request.
Use the SESS command to verify that actual
session forcing was completed. If incomplete, enter Operator response
the command again with specific session pairs. If If trace is active and accounting is not active, enter a
unsuccessful, notify the system programmer. TRACE STOP ALL command to stop the active trace.
Then enter the DISABLE command again. If accounting
System programmer response is active (regardless of trace), the DISABLE command
cannot be processed.
If storage is constrained, refer to the IBM Z NetView
Troubleshooting Guide. If necessary, refer to the AAU068I TRACE COMMAND CANNOT
IBM Z NetView Tuning Guide for storage calculation BE PROCESSED — SESSION
information. AWARENESS IS INACTIVE
AAU065I SPECIFIED SESSION(S) HAVE
BEEN FORCED TO DATA BASE Explanation
You entered a TRACE command while session
Explanation awareness was not active.
The NetView program sent the FORCE request to
the data services task (AAUTSKLP) for processing. System action
AAUTSKLP processes the FORCE request as soon as The NetView program ignores the request.
possible. If the FORCE request cannot be processed
(for example, the VSAM data set is full), then an error
indicating the problem is, or has been, sent to the Operator response
authorized receiver. If the AAU272I message is sent to To activate session awareness, enter the ENABLE
the authorized receiver and the AAU273I message was command. Then enter the TRACE command again.
not sent, then VSAM message suppression is active.
In this case, no further VSAM error messages are sent AAU069I SESSION AWARENESS IS NOT
to the authorized receiver until the error condition is ENABLED: A DISABLE COMMAND
corrected and the AAU273I message is sent. WAS ENTERED EARLIER

System action Explanation


Processing continues. This message is issued to the command facility
terminal operator. An ENABLE command was entered
AAU066I SESSION AWARENESS DATA HAS but cannot be processed because session awareness
BEEN DISABLED was stopped by a DISABLE command.

Explanation System action


The NetView program successfully processed the The NetView program ignores the request.
DISABLE command.

Operator response
System action
Enter STOPCNM NLDM. Then enter STARTCNM NLDM
Processing continues. and enter the ENABLE command again.

Chapter 1. AAU Prefix Messages 13


AAU070I TRACE IS NOT ACTIVE FOR Operator response
SPECIFIED RESOURCE
Enter the SESS command, then repeat the command
for the inactive session.
Explanation
AAU073I RESOURCE NOT AVAILABLE OR
You issued a PT or ST option for a session, but trace is UNKNOWN: SENSE CODE =
not active for either resource. X'hhhh'

System action Explanation


The NetView program ignores the request. The resource name you specified on a LINEMAP or
AAU071I PROCEDURE NOT SUPPORTED: TRACE command was not recognized.
SENSE CODE = X'hhhh' Message Variables
hhhh
Explanation The hexadecimal sense code returned to the
An error condition was detected while processing a NetView program from VTAM
LINEMAP command or an ST request.
Message Variables System action
hhhh The NetView program ignores the request.
The hexadecimal sense code returned to the
NetView program from VTAM Operator response
Enter the command again with a valid resource name.
System action
For information about sense codes, enter the HELP
The NetView program ignores the request. The SENSE command or refer to Systems Network
authorized message receiver gets message AAU082I Architecture Formats.
if ST was entered.
AAU074I REQUESTED TRACE FUNCTION IS
ALREADY IN EFFECT
Operator response
Notify the system programmer. Explanation
The TRACE START or TRACE STOP is already in effect
System programmer response for the resource you requested.
The problem might be because of the network control
program (NCP) level. System action
For information about sense codes, enter the HELP The NetView program ignores the request.
SENSE command or refer to Systems Network
Architecture Formats.
Operator response
AAU072I SPECIFIED SESSION IS NO
LONGER ACTIVE Use the TRACE DISP command to display active
traces. Use the HELP command for an explanation of
the correct command syntax.
Explanation
AAU075I REQUESTED TRACE FUNCTION
Between the time the most recent panel was displayed HAS BEEN PROCESSED
and the time of the new request, the specified session
became inactive.
Explanation
System action The NetView program successfully processed the
TRACE command.
The NetView program ignores the request.
System action
Processing continues.

14 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


AAU076I COMMAND PROCESSED FOR the same TRACE command while operating in the
resource IN DOMAIN domain1, secondary domain. The NetView program must be
NOT IN domain2 active in both domains.
AAU078I ENABLE PROCESS HAS BEEN
Explanation STARTED
You entered a TRACE command for a specific resource
which is defined as an LU in this network, but is Explanation
not defined in the domain from which the TRACE
The NetView program has started collecting session
command was issued.
awareness data.
Message Variables
resource System action
The resource name specified on the TRACE
Processing continues.
command being processed
domain1 AAU079I RESOURCE resource CURRENTLY
The domain in which the TRACE command was UNDEFINED—TRACE REQUEST
processed QUEUED
domain2
The domain in which the specified resource is Explanation
defined as an LU The NetView program queued the TRACE command.
As soon as the resource is activated, trace data is
System action collected for it.
Processing continues. Local domain trace has been Message Variables
started or stopped for the specified resource. resource
The name of the resource for which the trace was
Operator response requested
Verify that the resource is in the desired TRACE state
in the domain in which it is defined as an LU. Use the System action
DOMAIN keyword on the TRACE command to route the Processing continues.
command to the proper domain. You might also use
the SDOMAIN command to set the current domain to AAU080I module locid UNMATCHED
the domain in which the specified resource exists in SESSION END NOTIFICATION
order to use the TRACE command for that resource. RECEIVED
The NetView program must be active in both domains.
AAU077I SECONDARY TRACE NOT Explanation
STARTED. RESOURCE IS IN CROSS The access method issued a session end notification
DOMAIN SESSION for a session that was not started.
Message Variables
Explanation
module
The secondary trace was not started because its The control section (CSECT) name where an error
beginning resides in one domain and its end resides condition was detected
in a different domain.
locid
The location within the CSECT where an error
System action condition was detected
Processing continues. Local domain trace has been
started. System action
No processing of the session end notification is
Operator response attempted.
Enter the NetView SDOMAIN command for the domain AAU081I module locid NO FREE SLOTS
in which the secondary resource resides. Enter AVAILABLE IN table

Chapter 1. AAU Prefix Messages 15


Explanation System programmer response
An attempt to make an entry in the table or queue For information about sense codes, enter the HELP
tablename was unsuccessful because no free slots SENSE command or refer to Systems Network
were available. Architecture Formats.
Message Variables AAU083I module locid operatorid LOAD
module MODULE module NOT FOUND
The control section (CSECT) name where an error
condition was detected Explanation
locid The NetView program cannot find the specified
The location within the CSECT where an error module.
condition was detected
Message Variables
table
The name of the table or queue module
The control section (CSECT) name where an error
condition was detected.
System action
locid
Processing continues. The location within the CSECT where an error
condition was detected.
Operator response operatorid
Notify the system programmer. The NetView terminal operator identifier. If no
operator is defined, this value is blank.
module
System programmer response
The load module that cannot be found.
Provide more free slots by increasing either the
MAXEND parameter value in the NetView parameter System action
library member or in file AAUPRMLP.
The NetView program stops processing the request.
AAU082I module locid NETWORK REQUEST
FAILURE DETECTED: SENSE=
X'hhhh' Operator response
Notify the system programmer.
Explanation
A network request was issued and the NetView System programmer response
program received sense data that is not valid. Verify that the load module is in the NetView library.
Message Variables
AAU084I module locid LU TASK REQUEST
module FAILURE DETECTED: TYPE=type,
The control section (CSECT) name where an error FLAG=flag, LUIRBRC=retcode
condition was detected
locid Explanation
The location within the CSECT where an error
The logical unit (LU) task request failed for the LU-LU
condition was detected
session between the NetView program and VTAM.
hhhh
The hexadecimal sense code returned to the Message Variables
NetView program module
The control section (CSECT) name where an error
System action condition was detected.

Processing of the request stops. locid


The location within the CSECT where an error
condition was detected.
Operator response
Notify the system programmer.

16 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


type 40
The request type. This variable has one of the ACB not open
following values:
01 System action
LU task start request
Session trace or session awareness data collection is
02 not activated.
LU task receive request
03 Operator response
LU task stop request
Notify the system programmer.
flag
The reason request generated. This request has
one of the following values: System programmer response
00 See the NetView return code to determine the cause of
Successful the logical unit task failure.
08 AAU085I module locid LU SESSION WITH
Purge generated request AM LOST: PIU TRACING AND/OR
10 SAW HAS BEEN TERMINATED
Receive failure generated request
20 Explanation
TPEND generated request
The logical unit (LU-LU) session between the NetView
40 program and the access method (AM) ended. Path
LOSTERM generated request information unit (PIU) tracing or session awareness
80 data collection is no longer active.
NSEXIT generated request Message Variables
retcode module
The NetView return code. This return code has one The control section (CSECT) name where an error
of the following values: condition was detected
04 locid
LU request not valid The location within the CSECT where an error
08 condition was detected
Insufficient storage
12 System action
API request failed
Session trace is not started.
16
GENCB failed
Operator response
20
For TYPE = 01, the session is already active Start all traces for resources. If failure recurs, notify
with the named LU. the system programmer.
For TYPE = 02 or 03, the LU session was ended
or is inactive. System programmer response
24 Determine the cause of the LU-LU session end using
Incorrect buffer length on receive request other console messages from VTAM or the NetView
program.
28
Task not valid AAU086I module locid INSUFFICIENT
32 STORAGE TO BUILD LU INTERFACE
Session does not exist BUFFER
36
Session parameters not valid

Chapter 1. AAU Prefix Messages 17


Explanation module
The control section (CSECT) name where an error
The amount of NetView storage space required to condition was detected.
receive the path information unit (PIU) or the session
awareness (SAW) buffer is not available. locid
The location within the CSECT where an error
Message Variables condition was detected.
module queue
The control section (CSECT) name where an error The queue being processed. This insert has one of
condition was detected the following values:
locid BPQ
The location within the CSECT where an error Buffer pend queue
condition was detected DRQ
Data recording queue
System action DRQF
Session trace is not started. Data recording queue (FORCE)
OPQ
Operator response Operator pend queue
SESSTATS
Determine whether you received message BNH16I,
Session statistics queue
which means the task has reached its storage limit.
If so, notify your system programmer. TPQ
Timer pend queue
System programmer response
System action
Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary, The data services command processor (DSCP) stops.
refer to the IBM Z NetView Tuning Guide for storage
calculation information. Operator response
AAU087I SESSION AWARENESS DISABLED Notify the system programmer.
BY OPERATOR operatorid
System programmer response
Explanation
See related messages for message queuing service
You entered a DISABLE command. Session awareness (MQS) error.
is disabled.
AAU089I module locid MODULE POINTER
Message Variables CONTAINS BINARY ZEROS
operatorid
The NetView terminal operator identifier. If no Explanation
operator is defined, this value is blank.
The module pointer for an entry being processed in
the buffer-pending queue contains binary zeros. The
System action binary zeros represent an address that is not valid.
Processing continues. Message Variables
AAU088I module locid MQS FAILURE module
DETECTED WHILE PROCESSING The control section (CSECT) name where an error
queue condition was detected
locid
Explanation The location within the CSECT where an error
condition was detected
While attempting to send data, the NetView message
queueing service (MQS) indicated that the message
failed. System action
Message Variables The data services command processor (DSCP) stops.

18 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System action
Notify the system programmer. The session trace is not started.

System programmer response Operator response


Contact IBM Software Support. Notify the system programmer.
AAU090I module locid MAXRU SIZE/BUFFER
SIZE INCONSISTENT System programmer response
Determine the storage requirements for VTAM and
Explanation the size of the path information unit buffer (refer to
either the BUFSIZE parameter value in the NetView
A request for allocation of a path information unit (PIU) parameter library member or file AAUPRMLP). Refer
trace buffer failed. The buffer size you requested is to IBM Z NetView Tuning Guide for storage calculation
inconsistent with the access method buffer size. information.
Message Variables
AAU092I module locid UNABLE TO
module ALLOCATE TRACE BUFFER
The control section (CSECT) name where an error
condition was detected Explanation
locid
The location within the CSECT where an error A trace buffer was temporarily unavailable and the
condition was detected maximum number of 'free buffer' requests was
entered.

System action Message Variables

The session trace is not started. module


The control section (CSECT) name where an error
condition was detected
Operator response
locid
Notify the system programmer. The location within the CSECT where an error
condition was detected
System programmer response
System action
This is an installation error. Refer to the IBM Z NetView
Installation: Configuring Additional Components for Processing stops.
more information.
AAU091I module locid INSUFFICIENT Operator response
STORAGE IN ACCESS METHOD Notify the system programmer.
FOR PIU TRACE BUFFER

System programmer response


Explanation
Increase VTAM's virtual storage size. If problem still
The amount of storage required in the access method occurs, contact IBM Software Support.
for the path information unit (PIU) buffer was not
available during NetView initialization. AAU093I module locid ERROR DURING
INITIALIZATION. TRACING
Message Variables
INACTIVE
module
The control section (CSECT) name where an error Explanation
condition was detected
locid A severe error condition during NetView initialization
The location within the CSECT where an error caused tracing to stop.
condition was detected Message Variables

Chapter 1. AAU Prefix Messages 19


module Explanation
The control section (CSECT) name where an error
condition was detected You specified an incorrect parameter keyword in the
data services command processor (DSCP) initialization
locid statement. If keyword is blank, then the keyword that
The location within the CSECT where an error is specified on the initialization statement is longer
condition was detected than eight characters.
Message Variables
System action
module
Processing stops. A diagnostic message is sent to the
The control section (CSECT) name where an error
authorized message receiver that provides information condition was detected
about the specific error condition.
locid
The location within the CSECT where an error
Operator response condition was detected
Notify the system programmer. keyword
The keyword that is specified in the INITMOD
System programmer response statement

Use the accompanying diagnostic message to


determine the appropriate action.
System action
The NetView program ignores the statement that is not
AAU094I module locid ERROR DURING
valid and uses the default.
INITIALIZATION. SESSION DATA
INACTIVE
Operator response
Explanation Notify the system programmer.
A request to activate session awareness was entered
during NetView initialization. The request failed. (This System programmer response
message follows message AAU082I.)
Correct the parameter keyword that is not valid and try
Message Variables again. For coding requirements for INITMOD, refer to
the IBM Z NetView Administration Reference.
module
The control section (CSECT) name where an error AAU096I module locid PARAMETER
condition was detected VALUE MISSING/INVALID:
locid KEYWORD=keyword
The location within the CSECT where an error
condition was detected Explanation
A parameter value was either missing or not valid
System action in the data services command processor (DSCP)
Processing stops. initialization statement. If the keyword is blank in the
message, the keyword was also missing.
Operator response Message Variables

Notify the system programmer. module


The control section (CSECT) name where an error
condition was detected
System programmer response
locid
For information about sense codes, enter the HELP The location within the CSECT where an error
SENSE command, or refer to Systems Network condition was detected
Architecture Formats.
keyword
AAU095I module locid INVALID The keyword in the INITMOD statement that has a
INITIALIZATION PARAMETER value that is not valid
KEYWORD: keyword

20 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Message Variables

The NetView program ignores the statement that is not module


valid and uses the default. The control section (CSECT) name where an error
condition was detected
Operator response locid
The location within the CSECT where an error
Notify the system programmer. condition was detected

System programmer response System action


Correct the parameter keyword that is not valid and try DSCP global table initialization stops.
again. For coding requirements for INITMOD, refer to
the IBM Z NetView Administration Reference.
Operator response
AAU097I module locid PARAMETER VALUE
Determine whether you received message BNH16I,
OUT OF RANGE: keyword
which means the task has reached its storage limit.
If so, notify your system programmer.
Explanation
The parameter value for keyword is not within the System programmer response
acceptable range in the data services command
Refer to the IBM Z NetView Troubleshooting Guide for
processor (DSCP) initialization statement.
possible causes of the storage shortage. If necessary,
Message Variables refer to the IBM Z NetView Tuning Guide for more
storage calculation information.
module
The control section (CSECT) name where an error AAU099I module locid INITIALIZATION MQS
condition was detected FAILED: NLDM IS NOT ACTIVE
locid
The location within the CSECT where an error Explanation
condition was detected
The initialization MQS message was not placed on the
keyword message queue successfully.
The keyword in the INITMOD statement that has a
value that is too large or too small Message Variables
module
System action The control section (CSECT) name where an error
condition was detected
The statement that is not valid is ignored and the
default is used. locid
The location within the CSECT where an error
condition was detected
Operator response
Notify the system programmer. System action
Data services command processor (DSCP) global table
System programmer response initialization stops.
Correct the parameter keyword that is not valid and try
again. For coding requirements for INITMOD, refer to Operator response
the IBM Z NetView Administration Reference.
Notify the system programmer.
AAU098I module locid STORAGE NOT
AVAILABLE FOR INITIALIZATION
System programmer response
Explanation Message AAU832I or AAU833I precedes this
message. Determine the cause of the error based on
The amount of storage required to build the NetView which message you received.
data services command processor (DSCP) global table
is not available. AAU100I module locid UNABLE TO
DEALLOCATE TRACE BUFFER

Chapter 1. AAU Prefix Messages 21


Explanation System programmer response
No path information unit (PIU) trace buffers were Refer to the IBM Z NetView Troubleshooting Guide for
being sent to the NetView program. Consequently, the possible causes of the storage shortage. If necessary,
NetView program requested VTAM to free the storage refer to the IBM Z NetView Tuning Guide for storage
it allocated for these buffers. VTAM was unable to calculation information.
deallocate this storage.
AAU105I module locid NOT ALLOWED TO
Message Variables MIX PARAMETERS ON AUTHORIZ
DST INITIALIZATION STATEMENT
module
parameter
The control section (CSECT) name where an error
condition was detected
locid Explanation
The location within the CSECT where an error Up to 255 AUTHORIZ=XXXXXXXX statements can
condition was detected be entered, but mixing statements is not allowed.
For example, you cannot enter a specific name
System action after entering AUTHORIZ=ANY, and you cannot enter
AUTHORIZ=ANY after entering a specific name.
Processing continues.
Message Variables
Operator response module
The control section (CSECT) name where an error
Notify the system programmer. condition was detected
locid
System programmer response The location within the CSECT where an error
Contact IBM Software Support. condition was detected
parameter
AAU101I module locid operatorid AAUSPOOL
The parameter that is not valid
FAILED TO OBTAIN STORAGE

System action
Explanation
This statement parameter is bypassed and data
The NetView storage pool manager is unable to obtain
services command processor (DSCP) initialization
the storage required.
continues.
Message Variables
module Operator response
The control section (CSECT) name where an error Notify the system programmer.
condition was detected.
locid
System programmer response
The location within the CSECT where an error
condition was detected. Correct the AUTHORIZ=XXXXXXXX statements so that
operatorid no mixing takes place. For coding requirements for
The NetView terminal operator identifier. If no AUTHORIZ, refer to the IBM Z NetView Administration
operator is defined, this value is blank. Reference.
AAU106I module locid OVER
System action 255 AUTHORIZ=XXXXXXXX
PARAMETER STATEMENTS HAVE
The NetView program stops processing the request. BEEN ENTERED. parameter =
256TH ENTRY
Operator response
Determine whether you received message BNH16I, Explanation
which means the task has reached its storage limit. You entered more than the maximum of 255
If so, notify your system programmer. AUTHORIZ=XXXXXXXX statements.
Message Variables

22 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module System programmer response
The control section (CSECT) name where an error
condition was detected Remove any duplicate AUTHORIZ statements. For
coding requirements for AUTHORIZ, refer to the IBM
locid Z NetView Administration Reference.
The location within the CSECT where an error
condition was detected AAU108I module locid DOMAIN
parameter INFORMATION TABLE NOT FOUND
The parameter value of the AUTHORIZ statement
Explanation
System action During initialization or sometime after the domain
This statement is bypassed and data services information table was initialized, an error occurred
command processor (DSCP) initialization continues. while processing a domain INIT RU.
Message Variables
Operator response module
Notify the system programmer. The control section (CSECT) name where an error
condition was detected

System programmer response locid


The location within the CSECT where an error
Reduce the number of AUTHORIZ statements to 255. condition was detected
For coding requirements for AUTHORIZ, refer to the
IBM Z NetView Administration Reference.
System action
AAU107I module locid DUPLICATE
The NetView program continues to function, but no
AUTHORIZ=XXXXXXXX ARE NOT
cross-domain NetView-NetView communications can
ALLOWED. parameter = SECOND
be established.
OCCURRENCE OF THIS ENTRY

Operator response
Explanation
Notify the system programmer only if data services
You entered duplicate AUTHORIZ=XXXXXXXX
task (DST) initialization has finished. If the NetView
statements.
program is just being initialized, the table might not
Message Variables have been created and this error is not to be regarded
as a problem. When initialization has completed,
module
the request/response units from the other NetView
The control section (CSECT) name where an error
programs are reprocessed.
condition was detected
locid
System programmer response
The location within the CSECT where an error
condition was detected If NetView data/device services task initialization has
parameter finished, restart the NetView program. This message
The parameter value of the second occurrence of is preceded by message AAU023I indicating there is a
the AUTHORIZ statement storage shortage.
AAU109I module locid INVALID buftype
System action PARAMETERS HAVE BEEN
ENTERED
This statement is bypassed and data services
command processor (DSCP) initialization continues.
Explanation
Operator response A combination of buffer type parameters that are not
valid has been detected. The parameters cannot be
Notify the system programmer. processed.
Message Variables

Chapter 1. AAU Prefix Messages 23


module Operator response
The control section (CSECT) name where an error
condition was detected Notify the system programmer.
locid
The location within the CSECT where an error System programmer response
condition was detected Refer to the IBM Z NetView Administration Reference
buftype and update the CDRMDEF statements table (NetView
The buffer type parameter library member or file DSIAMLTD) to hold
all NetView programs known to this NetView program.
System action Restart the NetView program.

This parameter statement is bypassed and data AAU111I COULD NOT ROUTE REQUEST
services command processor (DSCP) initialization BEYOND DOMAIN domainid IN
continues with default parameters. NETWORK netid.

Operator response Explanation


Notify the system programmer. The NetView program cannot get routing information
to satisfy the request. Inactive session data can be
in route to the VSAM database or it can be wrapped
System programmer response out. The authorized message receiver might have more
Use the AAUPRMLP member shipped with the NetView information.
product. Message Variables
AAU110I module locid INPUT RU CANNOT domainid
FIND A MATCH IN THE The name of the domain in which the request
DOMAIN INFORMATION TABLE. failed
RU DOMAIN NAME = domainid
netid
The name of the network in which the request
Explanation failed
The NetView program received a domain INIT RU
(information about the foreign domain from a foreign System action
domain request/response unit). This NetView program
The NetView program ignores the request.
used the values from cross-domain resource manager
(CDRM) definition statements to initialize the domain
information table. CDRMDEFs must be updated to Operator response
contain all NetView programs known to this NetView Check the authorized message receiver or system
program. console for additional messages. If no messages are
Message Variables there, enter the command again. If message recurs,
check the route beyond the given domain.
module
The control section (CSECT) name where an error AAU112I ROUTE DATA NOT AVAILABLE FOR
condition was detected NETWORK netid
locid
The location within the CSECT where an error Explanation
condition was detected
If you entered connectivity test (), route data is not
domainid available in a network other than the one in which the
The name of the domain from which the request/ connectivity test was requested. If you entered LIST
response unit (RU) was sent ER or LIST VR, explicit route data was not found for the
network specified by the operator.
System action Message Variables
This domain INIT RU cannot be processed. The netid
NetView program continues to function, but cross- The network name
domain data cannot be stored.

24 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
The NetView program ignores the request. The session monitor continues processing with no
CNMI reply.
Operator response
Operator response
Notify the system programmer of the network in which
the route data is not available. If you entered a LIST ER For CNMI timeouts caused by operator commands, the
or LIST VR command, verify that a valid network name command can be entered again. In any case, notify the
for your installation was specified. system programmer.

System programmer response System programmer response


Determine the reason for the route failure. Verify in DSICTMOD that the timeout value (the
amount of time required to send and receive a
AAU113I INVALID NETWORK NAME response from the target source) specified for the
SPECIFIED requested function is reasonable, based on your
systems utilization. If so, contact IBM Software
Explanation Support.
You entered the LIST command with a network name AAU115I SESSION AWARENESS ALREADY
that is not valid. DISABLED. DISABLE COMMAND IS
IGNORED.
System action
Explanation
The NetView program ignores the request.
You entered a DISABLE command after session
Operator response awareness had been stopped by a DISABLE command.
DISABLE can be entered only once. Use STOP and
Determine the correct network name and enter the START commands to recycle the NetView program,
command again. then use the DISABLE or ENABLE commands.
AAU114I module locid CNMI REQUEST
TIMED OUT. REQUEST TYPE=type, System action
TARGET=target
The NetView program ignores the request.

Explanation AAU128I DOMAIN domain DID NOT


RECEIVE APPN ROUTE DATA VIA
The CNMI request indicated by target has timed out, SESSION AWARENESS
and no reply was returned. This message is sent to the
authorized operator.
Explanation
Message Variables
The APPN route data you requested is unavailable to
module the requested NetView domain. A possible cause of
The control section (CSECT) name that issued the this condition is that the NetView session monitor at
CNMI request that domain was started after this session started.
locid When session monitor starts, it requests already
The location within the CSECT where the CNMI active session awareness (SAW) information from its
request was issued VTAM, and the APPN route information might no longer
be known by VTAM at that time. Also, APPN route data
type is generally unavailable for certain session types, for
The type of request that timed out: ER example CP-CP.
TEST, LINEMAP CMD, QUERY PSID, GW TRACE,
BOUNDARY NCP TRACE, RTM INIT, RTM COLLECT, Message Variables
CONN TEST, VR STATUS, TRACE CMD domain
target Domain where the problem occurred.
The target or destination of the request (for
example, a NETWORK CONTROL PROGRAM or a
RESPONSE TIME MONITOR-CAPABLE DEVICE)

Chapter 1. AAU Prefix Messages 25


System action Explanation
The NetView program stops processing your request You requested that SAW or PIU data buffers be
for APPN session route data. traced. The MVS generalized trace facility (GTF) is
either not active or was not activated with the USR
Operator response or USRP option specified. If the GTF is active and the
USRP option was specified, then none of the event
You might be able to get the information you require identifiers specified match the event identifier for the
from the session configuration panel (NLDM.CON), SAW (X'5F4') or PIU (X'5F5') events. If you display
or you might be able to issue NLDM SDOMAIN to the status of the traces using the NLDM TRACE DISP
other NetView systems in the session path to get command, the status of the specified trace is pending
the required session configuration or APPN route (PND). If you start the GTF with the USR option, tracing
information. If you have logged past sessions between begins. If you start the GTF with the USRP option and
the same partners, the APPN route information for specify the event identifier for the SAW, the PIU, or
those inactive sessions can also be helpful. both the SAW and the PIU, tracing begins.
AAU129I module locid RTM DISABLED FOR
puname BECAUSE OF BOUNDS System action
MISMATCH The request is processed. No tracing is done until
the GTF is started with the appropriate option as
Explanation described.
The 3174 or 3274 response time monitor boundaries
did not match the response time monitor boundaries Operator response
at the host. Start GTF with the USR or USRP option. If the USRP
Message Variables option is used, specify the event identifier for the SAW
(X'5F4'), the PIU (X'5F5'), or both the SAW and the
module PIU.
The name of the control section where an error
was detected AAU131I type DEBUG TRACING ERROR -
locid GTF INACTIVE
The location in the control section where an error
was detected Explanation
puname The generalized trace facility (GTF) was stopped
The name of the PU replying with response time while the specified debug tracing was active. The
monitor boundaries that are not valid debug tracing will continue when GTF becomes active.
This message is issued only once per debug trace
System action invocation.

The NetView program turns off the RTM capabilities for Message Variables
the PU. type
The type of debug tracing.
Operator response
AAU132I module locid SEVERE GTF ERROR
Notify the system programmer. ENCOUNTERED, RC = retcode

System programmer response Explanation


Reset the response time monitor boundaries in the The NetView program received an unexpected error
NetView program, in the 3174, or in the 3274. code from the generalized trace facility (GTF) while
tracing or attempting to start tracing. This message is
AAU130I REQUESTED TRACE FUNCTION IS issued only once per debug trace invocation.
PENDING GTF START WITH USR
OR USRP OPTION Message Variables
module
The control section (CSECT) where the error
condition was detected. If module is AAUDPRSA,
some SAW trace data buffers might be lost. If

26 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module is AAUDPIUA, some PIU trace data buffers locid
might be lost. If module is AAUDXTRA, a TRACE The location within the CSECT where an error
START request was being processed when the condition was detected
error occurred.
locid System action
The location within the CSECT where the error
condition was detected. Processing continues.

retcode
The error code returned from the GTRACE system Operator response
macro. Notify the system programmer.

System action System programmer response


Tracing continues, but no data is recorded until the Verify that the value that is specified on the
GTF error condition is corrected. NLDM.LUCOUNT=nnnn statement in the CNMSTYLE
member is the intended value based on an estimate of
Operator response the total number of LUs being monitored. If necessary,
copy the NLDM.LUCOUNT statement to the CNMSTUSR
Notify the system programmer. or CxxSTGEN member and modify it.
AAU140I APPN SESSION ROUTE DATA IS
System programmer response NOT AVAILABLE
Note the message text and the values of the message
variables, and contact IBM Software Support. Explanation
AAU136I SESSION STAT FUNCTIONS IS The APPN session route data you requested does not
NOW ACTIVE exist.

Explanation System action


This message is displayed when session statistics The NetView program stops processing your request
initialization is complete. for APPN session route data.

Operator response Operator response


Enter the session monitor RECORD SESSTATS Enter another selection or a NetView command.
command.
AAU144I locid FLOW CONTROL DATA IS NOT
AAU137I modname locid LUCOUNT AVAILABLE
IN SESSION MONITOR
INITIALIZATION MEMBER MAY
BE TOO LOW FOR BEST Explanation
PERFORMANCE. The flow control data you requested does not exist.
There are two possible reasons for this:
Explanation • The session does not traverse a T2.1 connection
The number of active LUs being monitored by • VTAM or NCP has not supplied the flow control data
the session monitor has exceeded twice the value to the NetView program
specified on the NLDM.LUCOUNT=nnnn statement
in the CNMSTYLE member. The LUCOUNT value is Message Variables
used to calculate optimal table sizes for session locid
monitor retention and retrieval of session data. System The code location where this condition was
performance might be degraded. detected
Message Variables
modname
System action
The control section (CSECT) name where an error The NetView program stops processing your request
condition was detected for flow control data.

Chapter 1. AAU Prefix Messages 27


Operator response Operator response
Enter another selection or a NetView command. Use the TRACE DISP command to display resource
trace status. Notify the system programmer if PIU data
AAU145I FLOW CONTROL DATA IS
is not received or if you think the trace request to the
NOT AVAILABLE FOR INACTIVE
NCP should have been successful.
SESSIONS

System programmer response


Explanation
See any related messages sent to the authorized
You have requested flow control data for a session that message receiver for help in correcting the problem.
is inactive. The NetView program cannot display active
flow control data for an inactive session. AAU200I module locid UNABLE TO ACCESS
THE DSIPARM DATA SET
This message is also displayed for active sessions
after an SSCP Takeover or Giveback has been issued.
Because of the limited route data for sessions taken Explanation
over, the previous owner might be solicited for flow
You receive this message at initialization when the
control data. In some cases, the previous owner is
NetView program is unable to access the NetView
no longer aware of the session and believes that it
parameter library or initialization files.
is inactive. If so, this message is displayed for active
sessions. Message Variables
module
System action The control section (CSECT) name where an error
condition was detected
The NetView program stops processing your request
for flow control data. locid
The location within the CSECT where an error
condition was detected
Operator response
Enter another selection or a NetView command. System action
AAU148I FORMATTED RU NOT AVAILABLE Processing continues, but the performance class
definitions are ignored. The NetView program uses
Explanation default values to initialize the response time monitor
(RTM) feature.
Formatting is not available for the response unit (RU)
you selected.
Operator response
Operator response Notify the system programmer.

Select the correct RU, or select the RU without "F" to


view it in dump format. System programmer response
AAU160I DATA SERVICES FAILURE, TRACE Ensure that the data set is accessible to the system.
COMMAND PROCESSED AAU201I module locid UNABLE TO FIND
MEMBER member OF THE
Explanation DSIPARM DATA SET

An error occurred under the data services task while


the NetView program was processing the NLDM TRACE Explanation
command. The error occurred while the NetView You receive this message at initialization when the
program was trying to send the trace request to NetView program cannot find the member specified
NCP. The authorized message receiver might get an on the PERFMEM or KEEPMEM definition statement or
additional message indicating the specific error that when a RELOAD command is entered.
occurred.
Message Variables
System action module
The control section (CSECT) name where an error
The request might be partially processed. condition was detected

28 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


locid the PCLASS or KCLASS statement that is not valid.
The location within the CSECT where an error If this message is issued as the result of a RELOAD
condition was detected command, message AAU234I is issued and the keep
member class or performance class table is not reloaded (the
The data set member that the NetView program currently active table is not replaced).
cannot find
Operator response
System action Notify the system programmer.
Processing continues, but the definition statements
are ignored. The NetView program uses the default System programmer response
values to initialize the response time monitor (RTM).
Ensure each PCLASS and KCLASS statement has a
label. Refer to the IBM Z NetView Administration
Operator response Reference.
If you entered the RELOAD command, verify that AAU203I module locid DUPLICATE keyword
you used the correct member name and enter the DEFINITION ENCOUNTERED: label
command again. If this does not correct the problem,
or if you did not enter a RELOAD command, notify the
system programmer. Explanation
The label or identifier on this type of statement must
System programmer response be unique.

Verify that the name on the PERFMEM or KEEPMEM Message Variables


statement matches the name of the member in the module
NetView library that contains the definition statement. The control section (CSECT) name where an error
Refer to the IBM Z NetView Administration Reference condition was detected.
for more information about definition statements. If
locid
the two names match, a system error occurred.
The location within the CSECT where an error
AAU202I module locid REQUIRED LABEL condition was detected.
NOT FOUND ON keyword keyword
STATEMENT The related keyword.
label
Explanation The label that was duplicated.
A 1– to 8–character label (name) is required
(beginning in column 1) on every PCLASS and KCLASS System action
definition statement.
If this message is issued during session monitor
Message Variables initialization, the NetView program loads the keep
module class or performance class table but ignores the
The control section (CSECT) name where an error PCLASS or KCLASS statement with a duplicate label.
condition was detected. If this message is issued as the result of a RELOAD
command, message AAU234I is issued and the keep
locid class or performance class table is not reloaded (the
The location within the CSECT where an error currently active table is not replaced). Otherwise the
condition was detected. duplicate definition is ignored.
keyword
The keyword in the initialization statement that is Operator response
missing a label. The value of the keyword is either
KCLASS or PCLASS. Notify the system programmer.

System action System programmer response


If this message is issued during NetView initialization Ensure that each statement has a unique label. Refer
for session monitor, the NetView program loads the to the IBM Z NetView Administration Reference for
keep class or performance class table but ignores more information.

Chapter 1. AAU Prefix Messages 29


AAU204I module locid keyword member HAS Explanation
NOT BEEN DEFINED
A label (name) on a PCLASS, KCLASS or MAPSESS
statement is longer than 8 characters.
Explanation
Message Variables
When this message is issued in response to a
TCPCONN or PKTS command, no TCP/IP stacks module
have been defined. Refer to the online help for The control section (CSECT) name where an error
more information about TCPCONN DEFINE or PKTS condition was detected
DEFINE. Otherwise, a MAPSESS statement referred to locid
a performance or keep class that is not defined; that is, The location within the CSECT where an error
no PCLASS or KCLASS statement was encountered. condition was detected
Message Variables label
The first 8 characters of the label given to the
module PCLASS, KCLASS, or MAPSESS statement
The control section (CSECT) name where an error
condition was detected.
System action
locid
The location within the CSECT where an error The PCLASS, KCLASS or MAPSESS statement is
condition was detected. accepted but the NetView program truncates the label
keyword to the first 8 characters.
The related keyword.
member Operator response
The name of the item that was not defined. Notify the system programmer.

System action System programmer response


If this message is issued during session monitor Shorten the label on the PCLASS, KCLASS or MAPSESS
initialization, the NetView program loads the keep statement. Refer to the IBM Z NetView Administration
class or performance class table and assigns Reference.
default values for the undefined PCLASS or KCLASS
statement. If this message is issued as the result AAU206I module locid PARAMETER VALUE
of a RELOAD command, message AAU234I is issued MISSING/INVALID: LABEL=label
and the keep class or performance class table is not VERB=verb KEYWORD=keyword
reloaded (the currently active table is not replaced).
Otherwise the command or definition is ignored. Explanation
An error was found while processing a PCLASS,
Operator response KCLASS, or MAPSESS statement.
Notify the system programmer. Message Variables
module
System programmer response The control section (CSECT) name where an error
For session monitor, ensure the performance or keep condition was detected
class referred to is defined with a PCLASS or KCLASS locid
statement. Confirm that this statement precedes The location within the CSECT where an error
any MAPSESS statements that refer to the given condition was detected
performance or keep class. Refer to the IBM Z NetView
label
Administration Reference. Otherwise issue one or more
The label specified in the initialization statement
TCPCONN or PKTS DEFINE commands to define the
needed stacks. verb
The verb that identifies the initialization statement
AAU205I module locid THE LABEL 'label' as PCLASS, KCLASS, or MAPSESS
HAS BEEN TRUNCATED TO 8
CHARACTERS keyword
The keyword in the initialization statement

30 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
If this message is issued during NetView initialization Notify the system programmer.
for the session monitor, the NetView program loads
the table of keep classes or performance classes and System programmer response
assigns a default value to the incorrect parameter
if possible. If this message is issued as the result Correct the error on the specified statement. Refer to
of a RELOAD command, message AAU234I is issued the IBM Z NetView Administration Reference.
and the keep class or performance class table is not
AAU208I INVALID DATE/TIME PARAMETER
reloaded (the currently active table is not replaced).
SPECIFIED

Operator response
Explanation
Notify the system programmer.
An RTREND, RTSUM or PURGEDB command contains a
parameter with a date or time that is not valid.
System programmer response
Correct the keyword value on the specified statement. System action
Also verify that if the keyword is AVAIL for the verb
The NetView program ignores the command.
KCLASS, the value of SESSTATS on an INITMOD
statement is set to YES or NO. Refer to the IBM Z
NetView Administration Reference for further details. Operator response
AAU207I module locid INITIALIZATION Enter the command again with valid date and time
STATEMENT IN ERROR: parameters. To determine the valid parameters, see
LABEL=label VERB=verb the RTREND, RTSUM, or PURGEDB command in the
NetView online help.
Explanation AAU209I TOO FEW DATE/TIME
PARAMETERS SPECIFIED
An error was found while processing a MAPSESS,
PCLASS, or KCLASS statement.
Explanation
Message Variables
The RTREND or RTSUM command you entered
module
requires more date and time parameters than you
The control section (CSECT) name where an error
specified.
condition was detected
locid
The location within the CSECT where an error
System action
condition was detected The NetView program ignores the command.
label
The label specified on the initialization statement Operator response
verb Enter the command again with valid date and time
The verb that identifies the initialization statement parameters. To determine the valid parameters, see
as KCLASS, PCLASS, or MAPSESS the RTREND or RTSUM command in the NetView
online help.
System action
AAU210I TOO MANY DATE/TIME
If this message is issued during NetView initialization PARAMETERS SPECIFIED
for session monitor, the NetView program loads the
keep class or performance class table and assigns Explanation
default values for the incorrect statement if possible.
If this message is issued as the result of a RELOAD You specified too many date and time parameters in
command, message AAU234I is issued and the keep an RTREND or RTSUM command.
class or performance class table is not reloaded (the
currently active table is not replaced). System action
The NetView program ignores the command.

Chapter 1. AAU Prefix Messages 31


Operator response To determine the valid parameters, see the RECORD
command in the NetView online help.
Enter the command again with valid date and time
parameters. To determine the valid parameters, see AAU215I INVALID COLLECT FUNCTION
the RTREND or RTSUM command in the NetView SPECIFIED
online help.
AAU211I INVALID PARAMETER SPECIFIED Explanation
You specified an incorrect collection data type on a
Explanation COLLECT command. The first parameter must be RTM.

A command contains a parameter that is not valid.


System action
System action The NetView program ignores the command.

The NetView program ignores the command.


Operator response
Operator response Enter the COLLECT command again with a valid data
type. To determine the valid parameters, see the
Enter the command again with valid parameters. To COLLECT command in the NetView online help.
determine the valid parameters, see the syntax for the
specific command in the NetView online help. AAU216I NOT ENOUGH PARAMETERS
SPECIFIED
AAU212I INVALID TIME RANGE SPECIFIED

Explanation
Explanation
The command you entered requires more parameters
You entered an RTREND command with either an than you specified.
incorrect or one time only parameter specified. If you
want a time range, it must include both a beginning
and ending time or date and time. System action
The NetView program ignores the command.
System action
The NetView program ignores the command. Operator response
Enter the command again with the required number
Operator response of parameters. To determine the valid parameters, see
the specific command syntax in the NetView online
Enter the command again with valid parameters. To help.
determine the valid parameters, see the RTREND
command in the NetView online help. AAU217I NOT AUTHORIZED TO ISSUE
COMMAND command
AAU214I INVALID RECORD FUNCTION
SPECIFIED
Explanation
Explanation You selected an option that causes the command to
be issued, but you are not authorized to enter that
You specified a data type that was not valid on a command.
RECORD command. The first parameter of RECORD
command must be SESSTATS or STRGDATA. Message Variables
command
System action The name of the command that was issued
The NetView program ignores the command.
System action
Operator response The NetView program ignores the command and
processing continues.
Enter the RECORD command again with a valid data
type. If the NetView program enters the command by
a command list, stop and correct the command list.

32 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response module
The control section (CSECT) name where an error
Notify the system programmer. condition was detected
locid
System programmer response The location within the CSECT where an error
Evaluate the requirements of the operator and add condition was detected
appropriate security access if required. label
The label specified in the PCLASS statement
AAU218I INVALID TIME RANGE: BEGIN
TIME IS AFTER END TIME verb
The verb that indicates that the error is within the
PCLASS definition statement
Explanation
You specified a time range that is not valid. The System action
beginning time was after the ending time.
The NetView program ignores the bounds values and
uses the default values.
System action
The NetView program ignores the command. Operator response
Notify the system programmer.
Operator response
Enter the command again with a valid time range. System programmer response
To determine the valid parameters, see the NetView
online help. Correct the number of bounds values on the specified
statement. Refer to the IBM Z NetView Administration
AAU219I INVALID DATE/TIME PARAMETER: Reference.
DATE ENTERED WITHOUT A TIME
AAU221I MISSING PARAMETER AFTER
KEYWORD
Explanation
An RTREND or RTSUM command requires Explanation
corresponding time and date parameters.
You entered a LIST ER command without specifying a
parameter to follow the keyword NET.
System action
The NetView program ignores the command. System action
The NetView program ignores the command.
Operator response
Enter the command again with a valid time range (a Operator response
time corresponding to each date). To determine the
valid parameters, the RTREND or RTSUM command in Enter the command again. To determine the valid
the NetView online help. parameters, see the LIST command in the NetView
online help.
AAU220I module locid INCORRECT NUMBER
OF VALUES SPECIFIED FOR THE AAU222I DUPLICATE KEYWORD SPECIFIED
BOUNDS KEYWORD: LABEL=label
VERB=verb Explanation
You specified keyword NET twice when you entered a
Explanation LIST ER command.
You incorrectly specified the bounds keyword on a
PCLASS statement with a number of values that was System action
not valid. Valid values are 1-4.
The NetView program ignores the command.
Message Variables

Chapter 1. AAU Prefix Messages 33


Operator response verb
The verb in the MAPSESS, PCLASS, or KCLASS
Enter the command again. To determine the valid initialization statement that is not valid
parameters, see the LIST command in the NetView
online help.
System action
AAU223I OPTIONAL KEYWORD 'TO' OR
'FROM' SPECIFIED INCORRECTLY The NetView program ignores the incorrect statement.

Explanation Operator response


You specified the position of the keywords 'TO' and Notify the system programmer.
'FROM' incorrectly in the LIST ER command. 'FROM'
comes before the first resource name, and 'TO' comes System programmer response
before the second resource name.
Ensure the statements in the NetView parameter
library (DSIPARM) member or file were entered
System action correctly. Refer to the IBM Z NetView Administration
The NetView program ignores the command. Reference.
AAU227I module locid VALUES FOR
Operator response KEYWORDS, LOG AND SESSTATS,
ARE IN CONFLICT
Enter the command again. To determine the valid
parameters, see the LIST command in the NetView
online help. Explanation
AAU225I MAXIMUM RESPONSE TIME FOR The NetView program is unable to activate accounting
GRAPH IS GREATER THAN 1800 and session statistics function because of the conflict
SECONDS in keyword settings.
Message Variables
Explanation module
You entered an RTREND command with a response The control section (CSECT) name where an error
time too large for the graph. The Response Time Trend condition was detected
panel (NLDM.RTREND) can display response times of locid
30 minutes (1800 seconds) or less. The location within the CSECT where an error
condition was detected
System action
System action
The NetView program ignores the command.
The NetView program does not activate the accounting
Operator response and session statistics function.

Enter the command again with a valid maximum


Operator response
response time for the graph (not greater than 1800
seconds). To determine the valid parameters, see the Notify the system programmer.
RTREND command in the NetView online help.
AAU226I INVALID INITIALIZATION System programmer response
STATEMENT VERB: verb Correct the setting values of the LOG and SESSTATS
keywords in the NetView initialization parameters in
Explanation member or file AAUPRMLP. Refer to the IBM Z NetView
Administration Reference.
The NetView program found a statement verb other
than MAPSESS, PCLASS, or KCLASS in the DSIPARM AAU228I module locid SESSION STAT
data set member or file that contains the initialization FUNCTION IS NOT ACTIVE
statements.
Message Variables

34 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
The accounting and session statistics function is not See the associated messages issued by AAUDBLRA for
active and a RECORD SESSTATS command is sent to the cause of the failure.
the NetView program.
AAU230I module locid n RECORD/RECORDS
Message Variables SCHEDULED FOR LOGGING
module
The control section (CSECT) name where an error Explanation
condition was detected
The accounting and session statistics function
locid scheduled a number of records to be written to the
The location within the CSECT where an error external log.
condition was detected
Message Variables

System action module


The control section (CSECT) name where an error
The NetView program ignores the command. condition was detected
locid
Operator response The location within the CSECT where an error
Notify the system programmer. condition was detected
n
The number of records
System programmer response
If activation of the accounting and session statistics System action
function had been specified at initialization time, this
message indicates that the activation failed. See the Records are written to the external log.
related message at system startup.
AAU231I module locid NO RECORD
The RECORD command was either called by a SCHEDULED FOR LOGGING
command list or was issued by a NetView operator.
Verify that the value of SESSTATS on an INITMOD Explanation
statement is not set to NO.
You entered a RECORD command but the accounting
AAU229I module locid FAILURE IN and session statistics function did not find any session
RECORDING SESS STAT DATA match for the session partners you gave.
Message Variables
Explanation
module
The accounting and session statistics function failed to The control section (CSECT) name where an error
record data to the external log. condition was detected
Message Variables locid
The location within the CSECT where an error
module condition was detected
The control section (CSECT) name where an error
condition was detected
System action
locid
The location within the CSECT where an error The NetView program ignores the command.
condition was detected
Operator response
System action If a NetView operator entered the command, correct
The NetView program keeps the data until the next the session partner names that are not valid.
recording process starts. If a NetView command list initiated the command,
notify the system programmer.
Operator response
Notify the system programmer.

Chapter 1. AAU Prefix Messages 35


System programmer response Operator response
Correct the command list and restart it. Correct the errors and enter the command again.
AAU232I INVALID MEMBERNAME AAU240I module locid RESPONSE TIME
SPECIFIED INITIALIZATION FOR resource
FAILED: RC=retcode
Explanation
Explanation
You entered a RELOAD command with a member name
that is not valid. The NetView program was unable to send a response
time initialization request.
System action Message Variables
The NetView program ignores the request. module
The control section (CSECT) name where an error
Operator response condition was detected
locid
Enter the command again specifying a valid member
The location within the CSECT where an error
name.
condition was detected
AAU233I table HAS BEEN RELOADED resource
The name of the PU for which RTM initialization
Explanation has failed
retcode
The NetView program completed the reload of the
The return code:
PERFMEM or KEEPMEM definition statement, or other
table as indicated by the table variable. 4
The maximum number of requests is
Message Variables
outstanding
table 8
The name of the table to be reloaded. The control table not found or the MQS failure
AAU234I table HAS NOT BEEN RELOADED, detected
nnn ERRORS FOUND
System action
Explanation The NetView program assumes that the device does
Because errors were found, the NetView program not support RTM.
did not reload the PERFMEM or KEEPMEM definition
statements, or other table as indicated by the Operator response
table variable. If the table variable is PERFMEM or
KEEPMEM, the definition statement does not exist Notify the system programmer.
or encountered I/O errors. The authorized message
receiver in the domain where the RELOAD command System programmer response
processes receives a more descriptive message.
Verify that the tasks AAUTCNMI and AAUTSKLP are
Message Variables active. If they are, contact IBM Software Support.
table AAU241I RTM DATA IS NOT AVAILABLE:
The name of the table to be reloaded. DEVICE IS BUSY
nnn
The number of errors or I/O if the statement does Explanation
not exist.
You requested a response time data display that
involved retrieving data from a device with the RTM
System action feature. The device sent back a busy response.
The NetView program ignores the request.

36 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The NetView program ignores the request. The NetView program processed a COLLECT RTM
command and the requested data collection is in
Operator response progress.

Enter the command again. If the device is still busy,


System action
notify the system programmer.
Processing continues.
System programmer response AAU244I RESOURCE name IS NOT ACTIVE
Ensure that the device is RTM-capable. If it is, notify
the appropriate hardware support personnel. Explanation
AAU242I module locid FAILURE TO SEND A COLLECT command requested data from a resource
RESPONSE TIME SOLICITATION that was not active.
REQUEST FOR resource:
Message Variables
RC=retcode
name
Explanation The name of the resource

The NetView program cannot send the network


System action
request to collect RTM data for the indicated resource.
The NetView program ignores the request.
Message Variables
module Operator response
The control section (CSECT) name where an error
condition was detected Ensure that the resource name on the COLLECT
locid command is correct and that the resource is active.
The location within the CSECT where an error AAU245I RTM DATA COLLECTION STARTED,
condition was detected LOG OPTION IGNORED
resource
The PU resource name Explanation
retcode
The NetView program processed a COLLECT RTM
The return code:
command and the requested data collection is
4 in progress. However, the LOG option is ignored
The maximum number of requests is because LOG=YES was not coded in the initialization
outstanding statements.
8
The control table is not located or MQS failure System action
detected
Processing continues.

System action
Operator response
The response time data is not solicited for the
resource. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. If you require logging, include an NLDM.LOG=YES
statement in the CNMSTUSR member.

System programmer response AAU246I module locid RESPONSE TIME


DATA IS NOT AVAILABLE FOR
Verify that the AAUTSKLP and AAUTCNMI tasks are RESOURCE resource
active. If they are, contact IBM Software Support.
AAU243I RTM DATA COLLECTION STARTED

Chapter 1. AAU Prefix Messages 37


Explanation System programmer response
A COLLECT RTM command was entered. The NetView Determine the reason for the failure from message
program was unable to send the network request over AAU249I or AAU250I. If neither message is displayed,
the CNM interface task to collect the RTM data, or COLLECT was not processed because RTM to the
a device with the RTM feature has sent back a busy device is not allowed or the LU is not RTM-capable.
response when it received the request for data.
AAU248I RESPONSE TIME DATA IS NOT
Message Variables AVAILABLE FROM RESOURCE
resource
module
The control section (CSECT) name where an error
condition was detected Explanation
locid You requested response time data for resource but it
The location within the CSECT where an error was unable to process the request, or resource is not a
condition was detected valid resource. If resource is *, no RTM-capable devices
resource are attached.
The resource name Message Variables
resource
System action The resource name
The NetView program does not collect response time
data for the resource. System action
The NetView program ignores the request.
Operator response
If message AAU242I was also received, the NetView Operator response
program was unable to send the request. If not, a busy
response was received. Enter the command again. If Notify the system programmer.
the device is still busy, notify the system programmer.
System programmer response
System programmer response Determine whether the resource is RTM-capable. If it
If message AAU242I was also received, see that is, then specify to use RTM in the definition statement.
message for more information. If it was not, see if If you entered COLLECT RTM * to receive this message,
the error was caused by many requests being sent to it is possible that none of your resources are RTM-
the device simultaneously. If that is not the problem, capable.
notify the appropriate hardware support personnel.
AAU249I module locid MQS FAILURE IN RTM
AAU247I FAILURE TO PROCESS RESPONSE DATA COLLECTION PROCESS
TIME DATA COLLECTION
REQUEST. Explanation
An error occurred while attempting to send a message
Explanation between tasks. This error is caused by the task not
The NetView program was unable to process a being active.
COLLECT command. Message Variables
module
System action The control section (CSECT) name where an error
The NetView program does not collect response time condition was detected
data for the resource. locid
The location within the CSECT where an error
Operator response condition was detected

Notify the system programmer.


System action
The NetView program does not collect response time
data for the resource.

38 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response module
The control section (CSECT) name where an error
Ensure all the required tasks are active. If they are not, condition was detected
notify the system programmer.
locid
The location within the CSECT where an error
System programmer response condition was detected
Determine the reason for the task or initialization hhhh
failure from the error message. Verify that the tasks The hexadecimal sense code
AAUTCNMI and AAUTSKLP are active. target
AAU250I module locid INSUFFICIENT The name of the target
STORAGE EXISTS FOR RESPONSE
TIME REQUEST System action
If the sense code received was from a PU initialization
Explanation request, the PU is marked RTM NONCAPABLE. If it was
There is not enough storage to process the RTM received from a data collection request, the NetView
request. program ignores the request.

Message Variables
Operator response
module
The control section (CSECT) name where an error Notify the system programmer.
condition was detected
locid System programmer response
The location within the CSECT where an error Check the sense code returned. For sense code
condition was detected X'0835', ensure that SSCP-LU and LU-LU session
awareness data is being kept for LUs attached to the
System action control unit. Refer to the KCLASS statement in the IBM
Z NetView Administration Reference. For information
Processing might continue or stop depending on where about sense codes, enter the HELP SENSE command,
the failure is detected. or refer to Systems Network Architecture Formats.
AAU252I module locid RESOURCE resource
Operator response
DOES NOT SUPPORT RTM
Determine whether you received message BNH16I,
which means the task has reached its storage limit. Explanation
If so, notify your system programmer.
You entered a COLLECT RTM command which specifies
a resource that does not have the RTM feature.
System programmer response
Message Variables
Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary, module
refer to the IBM Z NetView Tuning Guide for storage The control section (CSECT) name where an error
calculation information. condition was detected
AAU251I module locid UNEXPECTED SENSE locid
CODE X'hhhh' ENCOUNTERED, The location within the CSECT where an error
TARGET=target condition was detected
resource
Explanation The resource name

The NetView program found an unknown sense code


from either an RTM initialization request or an RTM
System action
data collection request. The NetView program does not collect response time
Message Variables data for the resource.

Chapter 1. AAU Prefix Messages 39


Operator response locid
The location within the CSECT where an error
Verify that the resource name specified on the condition was detected.
COLLECT command is correct.
resource
AAU253I module locid UNABLE TO RECORD The name of the resource sending RTM data that is
DATA ON EXTERNAL LOG, not valid.
RC=retcode retcode
The return code. This return code has one of the
Explanation following values:
The NetView macro DSIWLS (Write Log Service) failed. 04
RU length error
Message Variables
08
module Insufficient data
The control section (CSECT) name where an error
12
condition was detected.
Incompatible data
locid
The location within the CSECT where an error
condition was detected.
System action
retcode The NetView program ignores the RU.
The system return code. This return code has one
of the following values: Operator response
24 Notify the system programmer.
A NetView CMDDEF statement is missing or in
error.
System programmer response
28
DSIMQS failure was detected. Notify hardware support.
AAU255I module VTAM REQUEST FAILURE:
System action EXTERNAL LOG RECORD
Data cannot be recorded on the external log. REFLECTS ONLY SESSION
MONITOR SAW FILTER COUNTS,
[RETURN CODE| SENSE CODE]=
Operator response X'retcode'
Notify the system programmer.
Explanation
System programmer response The SMF log does not reflect any SAW data from VTAM.
For RC=24, check the CMDDEF statements, specifically Message Variables
the definition for DSIELDAT. For RC=28, verify that
the DSIELTSK, AAUTCNMI, and AAUTSKLP tasks are module
active. The module name and location
retcode
AAU254I module locid INVALID RTM REPLY The hexadecimal value of the return code or sense
RU RECEIVED FROM RESOURCE code
resource, RC = retcode

System action
Explanation
The NetView program logs the record to the SMF log.
The NetView program received a reply RU that is not
valid from a device when it expected RTM data.
Operator response
Message Variables
Notify the system programmer.
module
The control section (CSECT) name where an error
condition was detected.

40 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response System action
Refer to the appropriate VTAM manual to determine The NetView program does not collect response time
the meaning of the return code or sense code. data for any of the terminal LUs attached to this
controller.
AAU256I module locid MQS FAILURE WHILE
PROCESSING TIMER REQUEST
Operator response
Explanation Check the state of the terminal LUs attached to the
controller.
The attempt to send a message to the timer task,
AAUATIMA, failed. AAU258I module locid RTM DATA IS
NOT AVAILABLE FOR resource1
Message Variables
BECAUSE RESOURCE resource2
module DOES NOT SUPPORT RTM
The control section (CSECT) name where an error
condition was detected Explanation
locid
The location within the CSECT where an error An RTM data collection for an LU was not possible. The
condition was detected PU to which it was attached does not support RTM.
Message Variables
System action module
The process continues without timer service. The control section (CSECT) name where an error
condition was detected

Operator response locid


The location within the CSECT where an error
Notify the system programmer. condition was detected
resource1
System programmer response The name of the LU
Determine whether the timer task, AAUATIMA, is resource2
active. If it is, contact IBM Software Support. Also, see The name of the PU that is not RTM-capable
the command facility LIST task name command in the
NetView online help. System action
AAU257I module locid RESOURCE resource The NetView program does not collect response time
IS NO LONGER RTM CAPABLE data for the LU.
DUE TO A SUBSEQUENT LU INIT
FAILURE
Operator response
Explanation Verify the spelling of the LU name.

A controller was RTM-capable and now is being AAU260I ROUTE DATA IS NOT AVAILABLE
classified as RTM NONCAPABLE because a terminal LU FOR COMMAND SPECIFIED
attached to this device cannot be initialized.
Message Variables Explanation
module The route data is unavailable.
The control section (CSECT) name where an error
condition was detected System action
locid The NetView program stops processing the request.
The location within the CSECT where an error
condition was detected AAU261I NO DATA EXISTS FOR COMMAND
SPECIFIED
resource
The name of the controller

Chapter 1. AAU Prefix Messages 41


Explanation Explanation
There is no data on the VSAM database or in storage You requested VR data where no such data exists.
for the NetView command you specified. (Either the session does not traverse a virtual route,
your network is not authorized to view the virtual route
System action data for the network being displayed, or VTAM has not
supplied the route data.)
The NetView program ignores the command.
System action
Operator response
The NetView program rejects the request and
Verify the resource name and enter the command processing continues.
again. If the problem recurs, notify the system
programmer.
Operator response
System programmer response Enter a valid selection or NLDM command.

Perform network problem determination to determine AAU266I module locid UNABLE TO


why no data exists. PUSH LOGOFF EXIT ROUTINE:
RC=retcode
AAU262I INCOMPATIBLE VALUE:
LABEL=label VERB=verb
Explanation
KEYWORD=keyword
NLDM was unable to establish (push) the AAUTSKLP
Explanation logoff routine because of a DSIPUSH failure. This
failure is identified by return code (RC=) in this
You specified incompatible or conflicting keyword message.
values for the initialization statement identified by this
Message Variables
message.
module
Message Variables
The control section (CSECT) name where an error
label condition was detected
The label of the incorrect statement locid
verb The location within the CSECT where an error
The initialization verb of the incorrect statement condition was detected
keyword retcode
The keyword that had the incompatible value The return code that resulted from the DSIPUSH of
the AAUTSKLP logoff routine
System action
System action
The NetView program ignores the initialization
statement. Initialization continues. No logoff routine is
established.
Operator response
Operator response
Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response
Resolve the conflicting values for the identified
keyword. For example, verify that YES and NO are not If RC=4, not enough storage was available to perform
both specified for the same KCLASS statement. Refer the DSIPUSH; increase the region size. If RC=28, add a
to the IBM Z NetView Administration Reference. CMDDEF statement for AAUSLGEX. Otherwise, contact
IBM Software Support.
AAU265I VIRTUAL ROUTE DATA (VR) NOT
AVAILABLE AAU267I locid PURGE COMPLETED FOR
datatype DATA. nn datatype name1
name2 PURGED

42 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
This message is sent to the authorized message See the NetView online help for the valid session
receiver. Session or route data for the session monitor monitor commands.
has been purged.
AAU269I DATABASE PURGE STARTED
Message Variables
locid Explanation
The location within the CSECT (control section)
The session monitor database purge has been started
where an error condition was detected
as a result of the purge command. This message is
datatype displayed on the session monitor panel or the common
SESSION or ROUTE data, depending on the type of facility panel.
session monitor data being purged
nn System action
The number of sessions purged (if a SESSION
purge) or the number of routes purged (if a ROUTE The NetView component where the command was
purge) issued resumes processing and awaits further input.
datatype AAU270I SYNTAX ERROR INVOLVING
SESSIONS or ROUTES data, depending on the type BEFORE PHRASE OR PEXLST
of session monitor data being purged PARAMETER
name1
The resource name of first resource specified in Explanation
purge command (if SESSION purge), or * (if ROUTE
purge) The syntax for the NLDM PURGE command is
incorrect:
name2
The resource name of second resource specified in • The BEFORE phrase is not specified or is in the
purge command (if SESSION purge), or * (if ROUTE wrong position.
purge) • The optional PEXLST parameter is incorrect or is in
the wrong position.
System action
The session monitor database purge has completed. System action
AAU268I command ext COMMAND NO The NLDM PURGE command is not processed.
LONGER SUPPORTED
Operator response
Explanation Refer to the NetView online help for the NLDM PURGE
This message is issued to the session monitor terminal command.
operator. The specified session monitor command AAU271I INVALID PURGE TYPE (MUST BE
is not supported in the NetView program Version 1 SESSION, ROUTE OR ALL)
Release 2 or greater.
Message Variables Explanation
command This message is issued to the session monitor terminal
The command name operator. The only valid purge types are SESSION,
ext ROUTE, or ALL.
The extension to the command name, if applicable
System action
System action The system waits for the next session monitor request.
The system waits for the next session monitor request. The PURGE command is not processed.

Operator response
See the NetView online help for the valid session
monitor PURGE command.

Chapter 1. AAU Prefix Messages 43


AAU272I origin locid operatorid VSAM AAU273I origin locid operatorid NORMAL
SESSION RECORDING NOW VSAM SESSION RECORDING HAS
BEING SUPPRESSED, VSAM R/C - RESUMED, number SESSIONS
MAJOR = major MINOR = minor WERE SUPPRESSED.

Explanation Explanation
Session monitor VSAM recording was suspended Session or connection recording to VSAM has
because of an error condition, or TCPCONN VSAM resumed because either the VSAM error condition was
recording was suspended because of a TCPCONN alleviated or the TCPCONN RESDASD command was
SUSDASD command. issued.
Message Variables Message Variables
origin origin
The control section (CSECT) name where an error The control section (CSECT) name where an error
condition was detected, or TCPCONN if TCPCONN condition was detected, or TCPCONN if TCPCONN
SUSDASD was issued. SUSDASD was issued.
locid locid
The location within the CSECT where an error The location within the CSECT where an error
condition was detected. If locid is 99, then no condition was detected. If origin is TCPCONN, this
active database exists. If origin is TCPCONN, this value is blank.
value is blank. operatorid
operatorid The NetView terminal operator identifier. If no
The NetView terminal operator identifier. If no operator is defined, this value is blank. If origin is
operator is defined, this value is blank. If origin is TCPCONN, this value is blank.
TCPCONN, this value is blank. number
major The number of sessions or connections which were
The VSAM major error code. If major is 99, then no not recorded while VSAM database recording was
active database exists. If origin is TCPCONN, this suspended.
value is 0.
minor System action
The VSAM minor error code. If minor is 99, then no
active database exists. If origin is TCPCONN, this VSAM session or connection recording continues
value is 0. normally.
AAU274I VSAM SESSION RECORDING IS
System action status

Session monitor or TCPCONN database recording


stops. Explanation
The status of the VSAM session recording is indicated
Operator response by this message.

For session monitor, notify the system programmer. Message Variables


For TCPCONN, issue TCPCONN RESDASD when status
recording to DASD is to resume. The status of VSAM session recording. The insert
has one of the following values:
System programmer response • ACTIVE - Indicates that data recording is
For session monitor, determine the reason for the currently active in response to the SMDR QUERY
suppression and take appropriate action. Verify that command.
the VSAM database is active. If the database is active, • ALREADY ACTIVE - Indicates that data recording
determine whether the VSAM database is full. You is already active in response to the SMDR START
might want to reorganize or scratch and reallocate the command.
data set. After fixing the problem, enter the SMDR
• ALREADY INACTIVE - Indicates that data
START command to restart the data recording, or
recording is already inactive in response to the
recycle the session monitor task.
SMDR STOP command.

44 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• INACTIVE - Indicates that data recording is System action
currently inactive in response to the SMDR
QUERY command. The default for AVAIL is used. The default corresponds
to the value of SESSTATS on an INITMOD statement.
• NOW STOPPED - Indicates that data recording
has been stopped in response to the SMDR STOP If
command. SESSTATS= Then AVAIL This means that
• STARTED - Indicates that data recording has AVAIL Defaults to Only availability data is
been started in response to the SMDR START YES logged
command.
YES Is ignored Both availability and
• UNAVAILABLE: NO DATABASE - Indicates that no
accounting data are
active database exists.
logged
NO Is ignored Neither availability nor
System action
accounting data is logged
Session monitor continues to perform as indicated by
the status insert.
Operator response
AAU275I PURGE REQUEST DENIED - PURGE
ALREADY IN PROGRESS Notify the system programmer.

Explanation System programmer response


You requested a session monitor purge when a purge Change the SESSTATS value to AVAIL if only availability
is already in progress. data is desired.
AAU284I module locid THE DGROUP
System action KEYWORD keyword FOR KCLASS
STATEMENT name MUST BE
The NetView program does not process the new purge EITHER 'RENAME' OR NULL
request, but continues processing the original purge
request.
Explanation
Operator response You specified a value other than RENAME or null and
it is incorrect. The second optional keyword for the
Do not attempt another session monitor purge request DGROUP parameter in a KCLASS statement must be
until message AAU267I is received by the authorized either RENAME or null.
receiver.
Message Variables
AAU276I module locid KEYWORD
AVAIL VALID ONLY WHEN module
SESSTATS=AVAIL. VALUE OF The control section (CSECT) name where an error
AVAIL ON KCLASS STATEMENT condition was detected
IGNORED. locid
The location within the CSECT where an error
Explanation condition was detected
keyword
The keyword AVAIL was used on a KCLASS statement, The incorrect keyword
but SESSTATS was not set to the value of AVAIL.
name
Message Variables The KCLASS statement label
module
The control section (CSECT) name where an error System action
condition was detected
Session monitor initialization continues processing the
locid KCLASS statement. The default of null is used for the
The location within the CSECT where an error second DGROUP keyword.
condition was detected

Chapter 1. AAU Prefix Messages 45


Operator response Message Variables

Notify the system programmer. module


The control section (CSECT) name where an error
condition was detected
System programmer response
locid
Modify the second value of the DGROUP parameter to The location within the CSECT where an error
be either RENAME or null. condition was detected
AAU285I module locid THE DGROUP keyword1
KEYWORD keyword FOR KCLASS The optional keyword
STATEMENT name MUST BE name
EITHER 'PRI', 'SEC', OR NULL The KCLASS statement label
keyword2
Explanation The required keyword
You specified a value other than PRI, SEC, or null. The
third optional keyword for the DGROUP parameter in a System action
KCLASS statement must be either PRI, SEC, or null.
Session monitor initialization continues processing the
Message Variables KCLASS statement. The default keyword values are
module used as if keyword1 was not specified.
The control section (CSECT) name where an error
condition was detected Operator response
locid Notify the system programmer.
The location within the CSECT where an error
condition was detected
System programmer response
keyword
The incorrect keyword Either add keyword keyword2 to the DGROUP
parameter, or remove keyword keyword1 from the
name
DGROUP parameter.
The KCLASS statement label
AAU287I module locid THE DGROUP
System action PARAMETER FOR KCLASS
STATEMENT name REQUIRES THE
Session monitor initialization continues processing the GROUP NAME
KCLASS statement. The default of PRI is used for the
third DGROUP keyword.
Explanation
Operator response You specified the DGROUP parameter in KCLASS
statement name, but did not specify the required
Notify the system programmer. group name.
Message Variables
System programmer response
module
Modify the third keyword of the DGROUP parameter to The control section (CSECT) name where an error
be either PRI, SEC, or null. condition was detected
AAU286I module locid THE DGROUP locid
KEYWORD keyword1 FOR KCLASS The location within the CSECT where an error
STATEMENT name REQUIRES THE condition was detected
keyword2 KEYWORD name
The KCLASS statement label
Explanation
You specified the first optional DGROUP keyword in a System action
KCLASS statement, but did not specify the required Session monitor initialization continues processing the
DGROUP keyword keyword2. KCLASS statement. The default keyword values are

46 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


used as if the DGROUP parameter had not been Explanation
specified.
You supplied too many values on the DGROUP
keyword when you also specified deferred DGROUP
Operator response name *PRI or *SEC.
Notify the system programmer. Message Variables
module
System programmer response The control section (CSECT) name where an error
Either add the group name to the DGROUP parameter, condition was detected
or remove the DGROUP parameter from the KCLASS locid
statement. The location within the CSECT where an error
condition was detected
AAU288I GLOBAL DASD SESSION KEEP
COUNT=newcount, WAS oldcount value
The extra value that was specified on the DGROUP
keyword
Explanation
name
The global DASD session keep count has been The deferred DGROUP name, either *PRI or *SEC
changed by operator request. The new session keep
count and the old session keep count are displayed in label
the message. The label specified in the KCLASS statement

Message Variables
System action
newcount
If this message is issued during NetView initialization
The new (changed) DASD session keep count
for the session monitor, the NetView program loads
oldcount the table of keep classes and ignores the extra value.
The old (previous) DASD session keep count If this message is issued as the result of a RELOAD
command, message AAU234I is issued and the keep
System action class or performance class table is not reloaded (the
currently active table is not replaced).
This is an informational message in response to an
operator request. When issued, this message indicates
the operator request was processed successfully. Operator response
AAU289I GLOBAL DASD SESSION KEEP Notify the system programmer.
COUNT=curcount
System programmer response
Explanation Correct the keyword value on the specified statement.
The current global DASD session keep count is Refer to the IBM Z NetView Administration Reference
displayed by operator request. for additional details.

Message Variables AAU300I module locid INSUFFICIENT


STORAGE EXISTS FOR VSAM
curcount BLOCK BUFFER
The current DASD session keep count
Explanation
System action
There is not enough storage to create the VSAM block
This is an informational message in response to an buffer for a database request.
operator request. When issued, this message indicates
the operator request was processed successfully. Message Variables

AAU290I module locid NO OTHER DGROUP module


PARAMETER VALUES (value) FOR The control section (CSECT) name where an error
DEFERRED DGROUP NAME name condition was detected
FOR KCLASS STATEMENT label locid
ARE ALLOWED The location within the CSECT where an error
condition was detected

Chapter 1. AAU Prefix Messages 47


System action Message Variables

The database request is ignored. module


The control section (CSECT) name where an error
condition was detected
Operator response
locid
Determine whether you received message BNH160I, The location within the CSECT where an error
which means the task has reached its storage limit. If condition was detected
so, notify your system programmer.
System action
System programmer response
The new table entry is not added.
Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary,
refer to the IBM Z NetView Tuning Guide for more
Operator response
storage calculation information. Notify the system programmer.
AAU301I module locid INSUFFICIENT
STORAGE EXISTS FOR LOGICAL System programmer response
RECORD BUFFER BLOCK
Contact IBM Software Support.

Explanation AAU303I module locid INTERNAL PROGRAM


ERROR: logicnn HAS OCCURRED
There is not enough storage to create the logical
record buffer block for a database request.
Explanation
Message Variables
There is an internal program error that represents a
module should-not-occur condition.
The control section (CSECT) name where an error
Message Variables
condition was detected
locid module
The location within the CSECT where an error The control section (CSECT) name where an error
condition was detected condition was detected.
locid
System action The location within the CSECT where an error
condition was detected.
The database request is ignored.
logicnn
The internal program error number. If nn=16
Operator response and this message was preceded by DSI124I and
DSI125I, the session monitor encountered an out-
Determine whether you received message BNH16I,
of-storage condition and tried to delete control
which means the task has reached its storage limit.
blocks that cannot be built because of the out-of-
If so, notify your system programmer.
storage condition.

System programmer response


System action
Refer to the IBM Z NetView Troubleshooting Guide for
The operation fails.
possible causes of the storage shortage. If necessary,
refer to the IBM Z NetView Tuning Guide for more
storage calculation information. Operator response
AAU302I module locid DUPLICATE Notify the system programmer.
DATABASE TABLE ENTRY
System programmer response
Explanation If nn=16 for the logicnn insert, re-evaluate the storage
There is a duplicate table error at database estimates or increase the region size specified in
initialization. The table entry is ignored. the startup procedure for the NetView program. All
other logic errors are defined internally and represent

48 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


various should-not-occur conditions. If you receive any Operator response
other logic errors, contact IBM Software Support.
Notify the system programmer.
AAU304I module locid UNSOLICITED DATA
REJECTED, RC=retcode
System programmer response
Explanation If necessary, check the installation exit routine that
performed message substitution.
An unsolicited data RU was received but was rejected
because of truncation of the RU message because of AAU306I ctrname IS OVER percent OF
insufficient buffer space. MAXIMUM VALUE. PRIMARY:
name1 SECONDARY: name2
Message Variables
module Explanation
The control section (CSECT) name where an error
condition was detected The named counter has exceeded the indicated
percentage of the maximum value it can hold for a
locid session between the named resources.
The location within the CSECT where an error
condition was detected Message Variables
retcode ctrname
The actual return code from the DSRB control The counter name for the external log record of the
block session monitor.
percent
System action A percentage
Processing continues. The NetView program ignores name1
the RU message. The primary resource name
name2
Operator response The secondary resource name

Notify the system programmer.


System action
System programmer response Processing continues.

Contact IBM Software Support.


Operator response
AAU305I module locid UNSOLICITED DATA
Consider issuing a RECORD SESSTATS command for
REJECTED, SUBSTITUTED TYPE
the given session partner names. Otherwise, it is
NOT RECOGNIZED
possible that the counter wraps and no longer be valid.

Explanation AAU801I module locid operatorid NAMED


STORAGE AREA storearea NOT
An unsolicited data RU was received but was rejected FOUND
because the type of substituted message was not
known.
Explanation
Message Variables
You requested storearea but it cannot be found by a
module NetView routine.
The control section (CSECT) name where an error
Message Variables
condition was detected
locid module
The location within the CSECT where an error The control section (CSECT) name where an error
condition was detected condition was detected.
locid
System action The location within the CSECT where an error
condition was detected.
Processing continues. The NetView program ignores
the RU message.

Chapter 1. AAU Prefix Messages 49


operatorid System programmer response
The NetView terminal operator identifier. If no
operator is defined, this value is blank. Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary,
storearea refer to the IBM Z NetView Tuning Guide for more
The named storage area. storage calculation information.
AAU803I module locid name1 name2 CNM
System action
DATA TRANSFER TASK NOT
An abend might be entered and processing stops. AVAILABLE FOR requestype

Operator response Explanation


Notify the system programmer. The NetView program cannot process your allocate,
send, or deallocate request. The CNM data transfer
System programmer response task in domain name1 is not active.
Message Variables
Ensure that the storage area is specified correctly. If it
is, contact IBM Software Support. module
The control section (CSECT) name where an error
AAU802I module locid name1 name2
condition was detected
INSUFFICIENT STORAGE EXISTS
TO INITIATE requestype REQUEST locid
The location within the CSECT where an error
condition was detected
Explanation
name1
The storage required is not available to process an The CNM data transfer task in the domain in which
allocate request, a send request, or a deallocate the request is entered
request.
name2
Message Variables The CNM data transfer task in the domain to which
the request is directed
module
The control section (CSECT) name where an error requestype
condition was detected The request type that can be either ALLOCATE,
SEND, or DEALLOC
locid
The location within the CSECT where an error
condition was detected System action
name1 The NetView program stops processing the request.
The CNM data transfer task in the domain in which
the request is entered
Operator response
name2
The name of the CNM data transfer task in the Start the CNM data transfer task. If the task cannot be
domain to which the request is directed started, notify the system programmer.
requestype
The request type that can be either ALLOCATE, System programmer response
SEND, or DEALLOC Refer to IBM Z NetView Installation: Configuring
Additional Components for the definition of the
System action NetView CNM data transfer task and the coding
requirements for DSILUCTD.
The NetView program stops processing the request.
AAU804I module locid name1
Operator response name2 COMMAND PROCESSOR
AAUDCPEX SPECIFIED TO BE
Determine whether you received message BNH16I, SCHEDULED ON COMPLETION OF
which means the task has reached its storage limit. requestype DOES NOT EXIST
If so, notify your system programmer.

50 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation name1
The CNM data transfer task in the domain in which
No CMDDEF statement for AAUDCPEX exists in the the request is entered
NetView parameter library member or file CNMCMD.
name2
Message Variables The name of the CNM data transfer task in the
module domain to which the request is directed
The control section (CSECT) name where an error
condition was detected System action
locid The conversation is deallocated.
The location within the CSECT where an error
condition was detected AAU806I module locid name1 name2 SEND
QUEUE HAS BEEN FLUSHED FOR
name1
CONVERSATION
The CNM data transfer task in the domain in which
the request is entered
name2
Explanation
The CNM data transfer task in the domain to which Any requests to send data to the NetView program
the request is directed in the domain associated with name2 were flushed
requestype and the corresponding application completion routines
The request type that can be either ALLOCATE, were driven. Message AAU817I follows this message.
SEND, or DEALLOC Message Variables
module
System action The control section (CSECT) name where an error
The NetView program stops processing the request. condition was detected
locid
Operator response The location within the CSECT where an error
condition was detected
Notify the system programmer.
name1
The CNM data transfer task in the domain in which
System programmer response the request is entered
Add a CMDDEF statement to DSIPARM member name2
CNMCMD for AAUDCPEX. Refer to the coding The name of the CNM data transfer task in the
requirements for CMDDEF statements in the IBM Z domain to which the request is directed
NetView Administration Reference.
AAU805I module locid name1 name2 System action
CONVERSATION IS BEING The NetView program ignores the request and
DEALLOCATED processing continues.

Explanation System programmer response


The conversation with the NetView program in the See the description for message AAU817I.
domain associated with name2 is being deallocated.
This message can follow message AAU808I. AAU807I module locid name1 name2
STORAGE FOR SEND QUEUE
Message Variables ELEMENT NOT AVAILABLE
module
The control section (CSECT) name where an error Explanation
condition was detected
Completion of a previous request to send data on
locid
the conversation with the NetView program in the
The location within the CSECT where an error
domain associated with name2 is pending. Storage is
condition was detected
not available to add the current request to the send
pend queue to be run later.
Message Variables

Chapter 1. AAU Prefix Messages 51


module requestype
The control section (CSECT) name where an error The request type that can be either ALLOCATE,
condition was detected SEND, or DEALLOC
locid retcode
The location within the CSECT where an error The internal NetView return code. Contact IBM
condition was detected Software Support if assistance is required.
name1 sensecode
The CNM data transfer task in the domain in which The sense code value
the request is entered
name2 System action
The name of the CNM data transfer task in the
domain to which the request is directed The NetView program stops processing the request.

System action Operator response


The NetView program ignores the request and Notify the system programmer.
processing continues.
System programmer response
Operator response For REQ=ALLOCATE, use NetView message AAU817I
Determine whether you received message BNH16I, to determine the appropriate action; otherwise no
which means the task has reached its storage limit. action is required.
If so, notify your system programmer. If the REQ field was ALLOCATE or SEND, then it
might take up to 10 minutes for the cross-domain
System programmer response sessions to reinitialize. If the ALLOCATE to reinitialize
the sessions fails, then a VTAM message, IST663I
Refer to the IBM Z NetView Troubleshooting Guide for followed by IST664I, is received. If these VTAM
possible causes of the storage shortage. If necessary, messages are received, it might take an additional 10
refer to the IBM Z NetView Tuning Guide for more minutes from that time for the cross-domain sessions
storage calculation information. to reinitialize.
AAU808I module locid name1 name2 For information about sense codes, enter the HELP
CDT REQUEST SERVICE FAILURE SENSE command, or see Systems Network Architecture
REQ=requestype RC= X'retcode' Formats.
SENSE= X'sensecode'
AAU809I module locid operatorid INVALID
REQUEST TYPE: XTMCODE = nnnn,
Explanation APPLID = applid
The request issued by the CNM data transfer task
failed. If requestype is sent, the conversation is Explanation
deallocated and the send pend queue is flushed.
The cross-task message code entered by the specific
Message Variables application applid is not valid.
module Message Variables
The control section (CSECT) name where an error
condition was detected module
The control section (CSECT) name where an error
locid condition was detected.
The location within the CSECT where an error
condition was detected locid
The location within the CSECT where an error
name1 condition was detected.
The CNM data transfer task in the domain in which
the request is entered operatorid
The NetView terminal operator identifier. If no
name2 operator is defined, this value is blank.
The name of the CNM data transfer task in the
domain to which the request is directed

52 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


nnnn refer to the IBM Z NetView Tuning Guide for more
The cross-task message code internal to the storage calculation information.
NetView program.
AAU812I module locid INSUFFICIENT
applid STORAGE EXISTS TO ADD TPN
The ID of the application that entered XTMCODE. DEFINITION

System action Explanation


Processing continues. There is not enough storage to add definition of the
transaction processor name.
Operator response Message Variables
Notify the system programmer. module
The control section (CSECT) name where an error
System programmer response condition was detected
Contact IBM Software Support. locid
The location within the CSECT where an error
AAU811I module locid name1 name2 condition was detected
INSUFFICIENT STORAGE EXISTS
FOR A RECEIVE BUFFER
System action
Explanation The NetView program ignores the request.

The data to be received exceeds the size of the


Operator response
default receive buffer and the request for storage for a
secondary receive buffer failed. The size of the default Determine whether you received message BNH16I,
buffer is 1024 bytes. which means the task has reached its storage limit.
If so, notify your system programmer.
Message Variables
module
System programmer response
The control section (CSECT) name where an error
condition was detected Refer to the IBM Z NetView Troubleshooting Guide for
locid possible causes of the storage shortage. If necessary,
The location within the CSECT where an error refer to the IBM Z NetView Tuning Guide for more
condition was detected storage calculation information.
name1 AAU813I module locid REQUESTING TASK
The CNM data transfer task in the domain in which NOT DST
the request is entered
name2 Explanation
The name of the CNM data transfer task in the
The transaction processor name being defined is not a
domain to which the request is directed
data services task.

System action Message Variables

The NetView program ignores the request. module


The control section (CSECT) name where an error
condition was detected
Operator response
locid
Determine whether you received message BNH16I, The location within the CSECT where an error
which means the task has reached its storage limit. condition was detected
If so, notify your system programmer.
System action
System programmer response
The NetView program ignores the request.
Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary,

Chapter 1. AAU Prefix Messages 53


Operator response name1
The CNM data transfer task in the domain in which
Notify the system programmer. the request is entered
name2
System programmer response The name of the CNM data transfer task in the
Ensure that the definition for AAUDCPEX in the domain to which the request is directed
DSIPARM member CNMCMD is defined as TYPE=RD. requestype
If this is true, contact IBM Software Support. The request type that can be either ALLOCATE,
SEND, or DEALLOC
AAU814I module locid TPN NOT UNIQUE
FOR THIS DOMAIN
System action
Explanation The NetView program ignores the request.
During initialization of the application DST, module
tried to define the transaction processor name Operator response
AAUTSKLP and the command verb name AAUDCPEX Notify the system programmer.
to the CNM data transfer task. The definition already
existed. The application DST was active previously and
is being restarted. System programmer response
Message Variables Contact IBM Software Support.

module AAU816I module locid MQS FAILED FOR


The control section (CSECT) name where an error CROSS DOMAIN INITIALIZATION
condition was detected
locid Explanation
The location within the CSECT where an error
A DSIMQS macro failed during session monitor
condition was detected
initialization.

System action Message Variables


module
The NetView program ignores the request.
The control section (CSECT) name where an error
condition was detected
Operator response
locid
If you were restarting an AAUTSKLP task, this message The location within the CSECT where an error
is for information only. If this message occurs during condition was detected
NetView initial startup, notify the system programmer.
System action
System programmer response
Processing continues. The NetView application cannot
If this message occurs during the NetView program have a conversation with its counterpart in another
initial startup, contact IBM Software Support. domain.
AAU815I module name1 name2 NCCF
PASSED BACK AN UNKNOWN Operator response
RETURN CODE FOR requestype Notify the system programmer.
REQUEST

System programmer response


Explanation
Message AAU832I or AAU833I precede this message.
The return code from a CNM data transfer task Keep this information and follow the appropriate
interface macro is not recognized. action based on the message you have received.
Message Variables Contact IBM Software Support.

module AAU817I module locid name1 name2 RPL


The control section (CSECT) name where an error RTNCD/FDBK= X'hhhhhhhh', RPL
condition was detected SENSE CODE= X'hhhhhhhh'

54 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation taskid
The task identifier.
This message follows message AAU808I.
retcode
Message Variables The return code from DSIGET or DSIMQS.
module
The control section (CSECT) name where an error System action
condition was detected
If it is a DSIGET failure, the request entry on the time
locid pend queue is requeued and reprocessed. If it is a
The location within the CSECT where an error DSIMQS failure, the request entry on the time pend
condition was detected queue is deleted.
name1
The name of the CNM data transfer task in the Operator response
domain in which the request is entered
Notify the system programmer.
name2
The CNM data transfer task in the domain to which
the request is directed System programmer response
hhhhhhhh If the failure is because of insufficient storage (DSIGET
The codes for problem determination failure or DSIMQS failure with a return code of 12),
increase the region size for the NetView program and
System action restart. If the failure is because the task ID cannot
be found (DSIMQS failure with a return code of 8),
The NetView program stops processing the request. determine the status of the task. If the task is active,
contact IBM Software Support. If the task is inactive,
Operator response restart the task.

Notify the system programmer. AAU832I module locid operatorid DSIGET


PASSED BACK A RETURN CODE OF
retcode
System programmer response
Use the RCFB and SENSE command lists to determine Explanation
the meaning of the return, feedback, and sense
codes. See the device-specific documentation for the The NetView storage allocation routine indicated
meaning of the user sense data. storage is unavailable for a work area.

AAU830I module locid type FAILURE: OPID Message Variables


operatorid TASKID taskid RC module
retcode The control section (CSECT) name where an error
condition was detected.
Explanation locid
There is a DSIGET or DSIMQS failure. The location within the CSECT where an error
condition was detected.
Message Variables
operatorid
module The NetView terminal operator identifier. If no
The control section (CSECT) name where an error operator is defined, this value is blank.
condition was detected. retcode
locid The return code from DSIGET.
The location within the CSECT where an error
condition was detected. System action
type
Data services command processor (DSCP) processing
The type of failure that can be either DSIGET or
stops.
DSIMQS.
operatorid
The NetView terminal operator identifier. If no
operator is defined, this value is blank.

Chapter 1. AAU Prefix Messages 55


Operator response (ADXRESMP) CONTAINS ZEROS.
ADXRESMS CONTAINS module2
Determine whether you received message BNH16I,
which means the task has reached its storage limit.
If so, notify your system programmer. Explanation
A functional service routine was unable to return
System programmer response control to the data-capturing routine that called it. The
data-capturing routine address is in ADXRESMP.
Refer to the IBM Z NetView Troubleshooting Guide
for possible causes of the storage shortage. If Message Variables
necessary, refer to the DSIGET macro in IBM Z NetView module1
Programming: Assembler for information about the The control section (CSECT) name where an error
specific error. condition was detected.
AAU833I module locid operatorid DSIMQS/ locid
DSILUS PASSED BACK A RETURN The location within the CSECT where an error
CODE OF retcode, DESTINATION: condition was detected.
taskid operatorid
The NetView terminal operator identifier. If no
Explanation operator is defined, this value is blank.
While attempting to send data to taskid, the NetView module2
message queuing routine indicated that the message The module that last updated field ADXRESMP.
was not sent successfully.
Message Variables System action
module Processing stops.
The control section (CSECT) name where an error
condition was detected. Operator response
locid Notify the system programmer.
The location within the CSECT where an error
condition was detected.
System programmer response
operatorid
The NetView terminal operator identifier. If no Determine which panel the operator last used and
operator is defined, this value is blank. which command the operator last entered. Contact
retcode IBM Software Support.
The return code from DSIMQS or DSILUS. AAU835I module locid operatorid INVALID
taskid KEY SIZE
The task name.
Explanation
System action The NetView program detected a key length less than
Data services command processor (DSCP) processing or greater than the valid key length.
stops. Message Variables
module
Operator response The control section (CSECT) name where an error
Notify the system programmer. condition was detected.
locid
System programmer response The location within the CSECT where an error
condition was detected.
If the return code is 8 and the task ID is supplied by
the NetView program, use the START TASK command operatorid
to start the task and retry your request. If this fails, The NetView terminal operator identifier. If no
contact IBM Software Support. operator is defined, this value is blank.

AAU834I module1 locid operatorid THE


LOGIC RESUME POINTER

56 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
Data services command processor (DSCP) processing Data services command processor (DSCP) processing
stops. stops.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Determine which panel the operator last used and Determine which panel the operator last used and
which command the operator last entered. Contact which command the operator last entered. Contact
IBM Software Support. IBM Software Support.
AAU842I operatorid AAUALTPA LOGICAL AAU844I operatorid AAUALTPA PHYSICAL
RECORD SIZE IS TOO LARGE RECORD SIZE IS TOO LARGE

Explanation Explanation
AAUALTPA service routine input parameters are set up AAUALTPA service routine input parameters were set
incorrectly. up incorrectly.
Message Variables Message Variables
operatorid operatorid
The NetView terminal operator identifier. If no The NetView terminal operator identifier. If no
operator is defined, this value is blank. operator is defined, this value is blank.

System action System action


Data services command processor (DSCP) processing Data services command processor (DSCP) processing
stops. stops.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Determine which panel the operator last used and Determine which panel the operator last used and
which command the operator last entered. Contact which command the operator last entered. Contact
IBM Software Support. IBM Software Support.
AAU843I operatorid AAUALTPA PHYSICAL AAU854I module1 locid operatorid THE I/O
RECORD SIZE IS TOO SMALL RESUME POINTER (ADXIORSP)
CONTAINS ZEROS. ADXIORSS
Explanation CONTAINS 'module2'

AAUALTPA service routine input parameters were set


Explanation
up incorrectly.
The module module1 requested the solicited data
Message Variables
and is now receiving it. The ADXIORSP should be set
operatorid during the request to indicate what module processes
The NetView terminal operator identifier. If no the solicited data. The ADXIORSP field identifies the
operator is defined, this value is blank. last module module2 that initialized ADXIORSP.
Message Variables
module1
The module making the request.

Chapter 1. AAU Prefix Messages 57


locid System programmer response
The location within the control section (CSECT)
where an error condition was detected. Determine which panel the operator last used and
which command the operator last entered. Contact
operatorid IBM Software Support.
The NetView terminal operator identifier. If no
operator is defined, this value is blank. AAU856I module locid UNRECOGNIZABLE
module2 REQUEST CODE: DSRBFNCD =
The module that last initialized ADXIORSP. fcode

System action Explanation


Processing stops. The NetView DST was driven with a DSRB function
indicator code that is not valid for the NetView
program. DSRBFNCD is internal to the NetView
Operator response program.
Notify the system programmer. Message Variables
module
System programmer response The control section (CSECT) name where an error
Determine which panel the operator last used and condition was detected
which command the operator last entered. Contact locid
IBM Software Support. The location within the CSECT where an error
condition was detected
AAU855I module1 locid operatorid DATA
RECEIVED FROM THE VSAM fcode
DATABASE WITH NO ACTIVE The DSRBFNCD function code
RESUME POINTER. ADXIORSS
CONTAINS 'module2' System action
Processing stops.
Explanation
The module module1 entered a VSAM GET for data Operator response
and the NetView program is now receiving it. The
ADXIORSP field should be set during the request Notify the system programmer.
to indicate what module processes the record. The
ADXIORSS field identifies the last module module2 System programmer response
that initialized ADXIORSP.
Refer to IBM Z NetView Programming: Assembler
Message Variables for control block DSRB and look up DSRBFNCD for
module1 function code interpretation.
The module making the request. AAU859I module locid operatorid DSIGET
locid FAILURE: RETURN CODE = retcode,
The location within the control section (CSECT) STORAGE SIZE = mmmm
where an error condition was detected.
operatorid Explanation
The NetView terminal operator identifier. If no
The module requested mmmm bytes of storage using
operator is defined, this value is blank.
the DSIGET macro instruction.
module2
The module that last initialized ADXIORSP. Message Variables
module
System action The control section (CSECT) name where an error
condition was detected.
Processing stops.
locid
The location within the CSECT where an error
Operator response condition was detected.
Notify the system programmer.

58 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


operatorid System programmer response
The NetView terminal operator identifier. If no
operator is defined, this value is blank. Refer to the DSIZCSMS macro documentation in IBM
Z NetView Programming: Assembler for information
retcode about the specific error.
The return code from DSIGET in register 15.
mmmm AAU861I module1 locid operatorid
The requested number of bytes of storage. SOLICITED DATA RESPONSE CODE
INVALID: DSRBRCMI = nnnn,
ADXSNAME = module2
System action
Processing stops. Explanation
The data services task (DST) is sending solicited data
Operator response to the data services command processor (DSCP). The
Notify the system programmer. DST stores a code in the DSRB field to indicate if
the solicited data is being received or if a negative
response is being sent. The value nnnn in the
System programmer response DSRBRCMI indicates neither condition occurred.
See the DSIGET macro documentation in IBM Z Message Variables
NetView Programming: Assembler for information
about the specific error. module1
The control section (CSECT) name where an error
AAU860I module locid operatorid DSIZCSMS condition was detected.
MACRO FAILURE: MAJOR CODE =
locid
majcode, MINOR CODE = mincode
The location within the CSECT where an error
condition was detected.
Explanation operatorid
The module entered the DSIZCSMS macro and the The NetView terminal operator identifier. If no
return codes majcode and mincode indicate an error. operator is defined, this value is blank.
Message Variables nnnn
The minor return code value.
module
module2
The control section (CSECT) name where an error
The module that called the solicitation module.
condition was detected.
locid
The location within the CSECT where an error
System action
condition was detected. Processing stops.
operatorid
The NetView terminal operator identifier. If no Operator response
operator is defined, this value is blank.
Notify the system programmer.
majcode
The code for problem determination in register 15.
System programmer response
mincode
The code for problem determination in register 0. Refer to the DSIZCSMS documentation in IBM Z
NetView Programming: Assembler for information
System action about the specific error and an explanation of
DSRBRCMI.
Processing stops.
AAU862I module locid operatorid
FUNCTIONAL ERASE MODULE
Operator response FAILURE
Notify the system programmer.
Explanation
The functional erase service routine AAUAFERA
detected a VSAM error while attempting to erase

Chapter 1. AAU Prefix Messages 59


VSAM records. When the routine calls the module, it Operator response
passes a return code of 16.
Record the module name modname and notify the
Message Variables system programmer.
module
The control section (CSECT) name where an error System programmer response
condition was detected.
Verify that the module is in the NetView library. If it is,
locid contact IBM Software Support.
The location within the CSECT where an error
condition was detected. AAU870I module locid NOT ALLOWED TO
MIX PARAMETERS ON AUTHDOM
operatorid
INITIALIZATION STATEMENT
The NetView terminal operator identifier. If no
parameter
operator is defined, this value is blank.

System action Explanation


Mixing statements is not allowed. For example,
Processing continues.
a specific name cannot be entered after entering
AUTHDOM=ANY and AUTHDOM=ANY cannot be
Operator response entered after entering a specific name.
Notify the system programmer. Message Variables
module
System programmer response The control section (CSECT) name where an error
Check to see if the VSAM data set is active. If the data condition was detected
set is not active, activate it. If the data set is active, locid
contact IBM Software Support. The location within the CSECT where an error
condition was detected
AAU869I module locid operatorid LOAD
MODULE modname DOES NOT parameter
EXIST The parameter that is not valid

Explanation System action


The NetView program cannot find the module The NetView program bypasses the parameter
modname. statement that is not valid. Presentation services
command processor (PSCP) initialization continues.
Message Variables
module Operator response
The control section (CSECT) name where an error
condition was detected. Notify the system programmer.
locid
The location within the CSECT where an error System programmer response
condition was detected. Correct the AUTHDOM=parameter statements so
operatorid that no mixing takes place. Refer to the coding
The NetView terminal operator identifier. If no requirements for AAUPRMLP in the IBM Z NetView
operator is defined, this value is blank. Administration Reference.
modname AAU871I module locid DUPLICATE
The module that was not found. AUTHDOM=XXXXXXXX ARE NOT
ALLOWED. parameter = SECOND
System action OCCURRENCE OF THIS ENTRY

Processing stops.
Explanation
Duplicate AUTHDOM statements are not allowed.
Message Variables

60 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module Explanation
The control section (CSECT) name where an error
condition was detected The number of outstanding NetView network requests
exceeds the solicitation table size.
locid
The location within the CSECT where an error
condition was detected System action
parameter Excess NetView network requests are not processed.
The parameter value of the second occurrence of
the AUTHDOM statement Operator response
Notify the system programmer.
System action
The NetView program skips the parameter statement System programmer response
that is not valid. Presentation Services Command
Processor (PSCP) initialization continues. Contact IBM Software Support.
AAU892I module locid DSIAMLUT TASK
Operator response RECEIVED DATA WITHOUT
ROUTING INFORMATION
Notify the system programmer.

System programmer response Explanation


The NetView program's DSIAMLUT task was unable to
Remove any duplicate AUTHDOM parameter
process data received from the LU-LU session between
statements. Refer to the coding requirements for
the NetView program and VTAM. The LU name was not
AAUPRMLP in the IBM Z NetView Administration
found in the CPEX routing table.
Reference.
Message Variables
AAU890I module locid CPEX CONTROL
STORAGE NOT DEFINED module
The control section (CSECT) name where an error
Explanation condition was detected
locid
The address of the CPEX control table was not found. The location within the CSECT where an error
Message Variables condition was detected
module
The control section (CSECT) name where an error System action
condition was detected Processing stops.
locid
The location within the CSECT where an error Operator response
condition was detected
Notify the system programmer.
System action
System programmer response
Processing stops.
Contact IBM Software Support.
Operator response AAU893I module locid ERROR DETECTED
WHEN ISSUING AAUMBNS
Notify the system programmer.

System programmer response Explanation


A build named storage macro failed to get storage for
Contact IBM Software Support.
the CPEX control area.
AAU891I THE NUMBER OF OUTSTANDING
Message Variables
NETVIEW NETWORK REQUESTS
EXCEEDS THE SOLICITATION
TABLE SIZE

Chapter 1. AAU Prefix Messages 61


module AAU896I module locid PARAMETER
The control section (CSECT) name where an error VALUE MISSING: FILE NAME=
condition was detected 'member',KEYWORD= 'keyword'
locid
The location within the CSECT where an error Explanation
condition was detected
A parameter value in the specified data set member
is missing in the data services command processor
System action (DSCP) initialization statement. If no keyword is
The CPEX data services command processor (DSCP) specified in the message, the keyword was missing
control table initialization stops. also.
Message Variables
Operator response module
Notify the system programmer. The control section (CSECT) name where an error
condition was detected
System programmer response locid
The location within the CSECT where an error
Contact IBM Software Support. condition was detected
AAU895I module locid INVALID member
INITIALIZATION PARAMETER The name of the member in the data set that is
KEYWORD: 'keyword' missing the parameter value
keyword
Explanation The keyword of the statement within the member
that has the missing parameter value
A parameter keyword is missing or not valid for the
data services command processor (DSCP) initialization
statement. System action
Message Variables The initialization of the task requiring the specified
parameter stops.
module
The control section (CSECT) name where an error
condition was detected. Operator response
locid Notify the system programmer.
The location within the CSECT where an error
condition was detected. System programmer response
keyword
Correct the incorrect or missing parameter value and
The keyword that is not valid. If this value is blank,
retry. Refer to the coding requirements for AAUPRMLP
the keyword is longer than 8 characters.
in the IBM Z NetView Administration Reference.

System action AAU897I module locid PARAMETER VALUE


OUT OF RANGE: FILE NAME=
The CPEX data services command processor (DSCP) 'member', KEYWORD= 'keyword'
control table initialization stops.
Explanation
Operator response
A parameter value in the specified data set member
Notify the system programmer. was not within the acceptable range in the data
services command processor (DSCP) initialization
System programmer response statement.

Correct the parameter keyword that is not valid and Message Variables
retry. Refer to the coding requirements for AAUPRMLP module
in the IBM Z NetView Administration Reference. The control section (CSECT) name where an error
condition was detected

62 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


locid module1
The location within the CSECT where an error The module that the NetView program cannot load.
condition was detected operatorid
member The NetView terminal operator identifier. If no
The name of the member in the data set that operator is defined, this value is blank.
contains the incorrect parameter value module2
keyword The module initiating the call to load a module.
The keyword of the statement within the member retcode
or file having the out-of-range parameter value The code used for problem determination.

System action System action


The initialization of the task requiring the specified Processing of the command stops.
parameter stops.

Operator response
Operator response
Notify the system programmer.
Notify the system programmer.

System programmer response


System programmer response
Verify that the module is in the library. See the
Correct the unacceptable parameter value and retry DSILOD register 15 documentation in IBM Z NetView
initialization of the task. Programming: Assembler for specific information on
AAU901I COMMAND NOT PROCESSED: the error.
FAILED TO LOAD MODULE module AAU904I UNRECOGNIZED COMMAND
ENTERED
Explanation
The NetView program failed to load the module to Explanation
process your command. You entered a command that is not recognized by
Message Variables the NetView program or is not valid from the session
monitor.
module
The name of the module that was not loaded
System action
System action Processing of the command stops.
Processing for the command stops.
Operator response
Operator response Ensure the command entered is a valid NetView
command. See the NetView online help.
Notify the system programmer.

System programmer response


System programmer response
If the command entered is a valid NetView command,
If the module is in the NetView library, contact IBM contact IBM Software Support.
Software Support.
AAU905I INVALID SYNTAX OR
AAU902I LOAD FAILURE ON MODULE INSUFFICIENT OPERANDS
module1: OPID operatorid, FROM SPECIFIED
module2, DSILOD R/C = retcode

Explanation
Explanation
The command requires a minimum number of
The NetView program failed to load the specified operands to run correctly. You specified too few or
module. specified them incorrectly.
Message Variables

Chapter 1. AAU Prefix Messages 63


System action Explanation
Processing of the command stops. You issued the TRACE command with the NET
keyword. The VTAM level does not support the TRACE
Operator response command with the NET keyword.

See the NetView online help to determine the correct


System action
operands and syntax. Then enter the command again.
The request is ignored.
AAU906I CMD FACILITY ROUTE CMD
DETECTED BY SESSION MONITOR
— COMMAND REJECTED Operator response
Notify the system programmer.
Explanation
Session monitor detected a command facility ROUTE System programmer response
command that is attempting to process a session Determine whether the NET keyword is required to
monitor command in a remote domain. This is not a identify the resource. If it is not required, enter the
valid procedure under the NetView program. TRACE command again without the NET keyword and
keyword parameter. If the NET is required, the TRACE
System action command cannot be used to control the resource with
the installed VTAM.
Processing of the command stops.
AAU909I TOO MANY PARAMETERS
System programmer response SPECIFIED FOR SDOMAIN
COMMAND
Issue a session monitor SDOMAIN command to the
remote domain. Then enter the session monitor
Explanation
command.
You entered an incorrect SDOMAIN command.
AAU907I INSUFFICIENT STORAGE TO
ALLOCATE ACT
System action
Explanation Processing of the command stops.
The NetView terminal operator cannot access the
session monitor unless sufficient storage can be Operator response
obtained for the presentation services command See the NetView online help to determine the correct
processor application control table (ACT). parameters and syntax. Then enter the command
again.
System action
AAU910I NO DOMAIN NAME SPECIFIED
Processing of the command stops. FOR SDOMAIN COMMAND

Operator response Explanation


Determine whether you received message BNH16I, You entered an SDOMAIN command without the
which means the task has reached its storage limit. required domain identifier.
If so, notify your system programmer.
System action
System programmer response
The NetView program ignores the request.
Refer to the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. Operator response
AAU908I NET KEYWORD IS NOT Enter the command again with the proper domain
SUPPORTED BY INSTALLED VTAM identifier. See SDOMAIN command in the NetView
RELEASE LEVEL online help.

64 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


AAU911I CURRENT DOMAIN NOW System action
domainid1, WAS domainid2
The NetView program rejects the current command
and processing continues.
Explanation
You entered an SDOMAIN command. This message Operator response
indicates the result.
Enter the current command again when data services
Message Variables (DSM) for the previous command have completed.
domainid1 AAU917I INVALID INVOCATION OF
The newly set domain AAUPCPEX
domainid2
The old domain Explanation
The NetView program cannot find the application
System action program initialization data. The NetView load module
Processing continues. AAUPCPEX was not called properly.

AAU912I RELEASE LEVELS NOT


COMPATIBLE BETWEEN DOMAINS System action
domainid1 AND domainid2 Session monitor processing stops.

Explanation Operator response


The session monitor release level in domainid1 is not Activate session monitor by entering NLDM. If this
the same as in domainid2. Cross-domain functions message recurs, notify the system programmer.
cannot be processed at the remote domain.
Message Variables System programmer response
domainid1 Verify that the CMDDEF statements are correct and
The name of the current domain ensure that no other commands are set up to activate
domainid2 the NetView load module AAUPCPEX. Refer to the
The name of the remote domain coding requirements for CNMCMD in the IBM Z
NetView Administration Reference.
System action AAU918I MAXIMUM APPLICATION COUNT
REACHED
The NetView program ignores the request.

Explanation
Operator response
The number of active commands to be run exceeds the
Notify the system programmer.
limit of the application control table.

System programmer response System action


Determine the session monitor release level at both
Processing stops.
domains and take the appropriate action.
AAU913I SESSION MONITOR WAITING FOR Operator response
DATA, ENTER 'NLDM END' TO
CANCEL REQUEST. Notify the system programmer.

Explanation System programmer response


The NetView program has not completed data retrieval Contact IBM Software Support.
activity for a previous command.
AAU919I INSUFFICIENT STORAGE TO
ALLOCATE ATX

Chapter 1. AAU Prefix Messages 65


Explanation AAU922I INITIALIZATION FAILED
You cannot access the session monitor unless
sufficient storage can be obtained for the Application Explanation
Table Extension (ATX). Storage is not available to complete initialization of the
NetView program.
System action
NetView processing stops. System action
Processing stops.
Operator response
Determine whether you received message BNH16I, Operator response
which means the task has reached its storage limit. Determine whether you received message BNH16I,
If so, notify your system programmer. which means the task has reached its storage limit.
If so, notify your system programmer.
System programmer response
Refer to the IBM Z NetView Troubleshooting Guide for System programmer response
possible causes of the storage shortage. If necessary, Refer to the IBM Z NetView Troubleshooting Guide for
refer to the IBM Z NetView Tuning Guide for more possible causes of the storage shortage. If necessary,
storage calculation information. refer to the IBM Z NetView Tuning Guide for more
AAU920I INVALID RESPONSE/SELECTION storage calculation information.
NUMBER AAU923I DATA SERVICES TASK IS NOT
ACTIVE: TASKID taskid
Explanation
You responded incorrectly to a request to enter a Explanation
command. You entered the command option with The specified task was not activated or failed to
incorrect spacing, entered an alphabetic character initialize.
when prompted for a selection number, or entered a
number not displayed on the panel. Message Variables
taskid
System action The name of the inactive task
The NetView program ignores the request.
System action
Operator response Processing of this command stops.
Enter a valid response (function, selection number, or
command). Operator response
AAU921I component ENDED Determine all inactive session monitor tasks using
the command facility LIST command. Then start all
inactive session monitor tasks using STARTCNM NLDM.
Explanation
AAU925I NO DATA EXISTS FOR COMMAND
The application has completed as a result of the END SPECIFIED pqual
command.
Message Variables Explanation
component There is no data on the VSAM database or in storage
The NetView component name, which is session for the NetView command specified. The resource
monitor in this case name might not be valid or there might not be any
data for that resource. This might be the result of KEEP
System action CLASS processing.
The NetView panel is displayed. Message Variables

66 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


pqual Operator response
The SESSC command might add the following
qualifiers: • Ensure that the domain identifier you specified in the
SDOMAIN command is correct.
(SESS)
No NLDM.SESS screen was available for the • Verify that the session monitor is active in the
resource or resource pair. specified domain.

(SEL#) • Verify that a conversation exists between the two


For a given selection on the NLDM.SESS domains by viewing the LIST.DOM and LIST.SSCP
screen, no NLDM.CON screen was available. panels.

(PCID) • If the conversation is not active with the requested


No selection on the NLDM.SESS screen domain, allow time for the two domains to establish
matched the given PCID. contact and retry the SDOMAIN command.

(ER) • If the SDOMAIN command continues to fail, and


No NLDM.ER screen was available. This might you have verified that it is not because of the
be typical and appears only in the log. previously listed causes of failure, notify the system
programmer.
(AR)
No NLDM.AR screen was available. This might
be typical and appears only in the log. System programmer response
Check for error messages and process accordingly.
System action AAU927I modid locid INVALID PURGE
The NetView program ignores the command. EXCEPTION LIST xx

Operator response Explanation


Verify the resource name or other parameters and This message is sent to the authorized message
enter the command again. If the problem persists, receiver. A missing or incorrect PURGE exception list
notify the system programmer. was specified on the NLDM PURGE command.
Message Variables
System programmer response modid
Determine why no data exists. Ensure that session The session monitor module where the error
awareness is enabled and that the required NetView condition occurred.
tasks are active. locid
AAU926I SDOMAIN FAILED FOR domid The location within the module where the error
- CURRENT DOMAIN IS condition occurred. Possible values include:
UNCHANGED 01
Common global variable
Explanation CNMSTYLE.NLDM.PEXLSTxx.0 (number of
entries for this list) cannot be accessed.
The session monitor in your domain cannot
02
communicate with the session monitor you specified
Common global variable
in the SDOMAIN command.
CNMSTYLE.NLDM.PEXLSTxx.0 (number of
Message Variables entries for this list) does not have a numeric
value.
domid
The NetView domain 03
Common global variable
CNMSTYLE.NLDM.PEXLSTxx.n (one of the
System action entries for this list) cannot be accessed.
The NetView program ignores the command and 04
processing continues. An entry is not valid (for example, the first
token exceeds nine characters or is not found
at position 1).

Chapter 1. AAU Prefix Messages 67


05 Operator response
Duplicate or excessive session type entries (for
example, SSCP-SSCP) are defined. Press the Enter key.
06 AAU931I SCREEN HAS BEEN LOGGED BUT
A session type entry (for example SSCP-SSCP) NOT PRINTED
contains an extraneous value.
07 Explanation
An entry is not valid (for example, there are not
You entered the COPY command, but no hardcopy
two resource specifications, or one entry has
device is available for printing.
an incorrect length).
xx
The last two characters of the PEXLSTxx parameter
System action
that was specified on the NLDM PURGE command. Output from the COPY command is sent to the network
The xx corresponds to the exception list statement log.
that is defined in the CNMSTYLE member
(NLDM.PEXLSTxx).
Operator response
System action Provide a hardcopy device for printing and enter the
COPY command again, or print the network log.
If you specified the SESSION keyword on the NLDM
PURGE command, the command was not processed. AAU933I SCREEN HAS BEEN PRINTED
If you specified the ALL keyword, routes might have
been purged from the session monitor database, but Explanation
sessions were not.
The COPY command processed successfully.

Operator response
System action
Ensure that you specified the correct PURGE exception
list. Processing continues.
AAU934I COPY COMMAND FAILURE
System programmer response DETECTED - SCREEN NOT
PRINTED
Verify that the specified PURGE exception list is
correct. Check the corresponding definitions in the
CNMSTYLE member (NLDM.PEXLSTxx). Explanation
AAU930I applid APPLICATION action: The COPY command failed.
PRESS ENTER TO CONTINUE
System action
Explanation Processing stops.
The application has either started or resumed as
indicated by the action. Operator response
Message Variables Enter the COPY command again. If the command fails
again, notify the system programmer.
applid
The application name
action System programmer response
The action, either STARTED or RESUMED See the IBM Z NetView Troubleshooting Guide.
AAU935I NOT AUTHORIZED TO CONNECT
System action TO REQUESTED DOMAIN
Processing continues when the operator presses the
Enter key. Explanation
The command you entered specified a domain to
which you are not authorized to connect.

68 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
Processing continues. You entered a command in line mode but you are not
authorized to enter that command.
Operator response
System action
Notify the system programmer.
The NetView program ignores the command and
System programmer response processing continues.

To be authorized to connect to the domain, the AAU939I I/O errortype ERROR, RETURN
domain name of the operator must be included on an CODE retcode, - TO RESUME
NLDM.AUTHDOM definition statement for that domain ENTER applid
in CNMSTYLE or one of its included members. For the
NLDM.AUTHDOM definition coding requirements, refer Explanation
to the CNMSTYLE Initialization Statements in the IBM
Z NetView Administration Reference. The NetView program detected an error while trying to
send data to or receive data from the terminal.
AAU936I INVALID INVOCATION OF
Message Variables
COMMAND
errortype
Explanation The error type that can be either SEND or RECEIVE
retcode
You entered a NetView command while in a mode that The DSIPSS macro return code
is not valid for that command.
applid
The application name
System action
The NetView program ignores the command and System action
processing continues.
The NetView program returns you to the NetView
panel.
Operator response
Ensure that you entered the NetView command in Operator response
the correct mode: line, panel, or multiple (panel or
line). See the NetView online help. Enter the command Enter application name applid to return to the
again. application. If the I/O errors continue, notify the
system programmer.
AAU937I COMMAND ENTERED IS NOT AN
EXPLICIT COMMAND
System programmer response
Explanation To determine the cause of the error, refer to the return
codes for the DSIPSS macro in the IBM Z NetView
You entered a command in line mode that is not a valid Programming: Assembler.
line mode command.
For I/O SEND errors, reference DSIPSS with
Type=ASYPANEL. For I/O RECEIVE errors, reference
System action DSIPSS with Type=PSSWAIT.
The NetView program ignores the command and AAU940I THE CROSS DOMAIN DST
processing continues. REQUEST FAILED

Operator response Explanation


Enter a valid NetView command or switch to panel An attempt was made to send to another domain for
mode and enter the command again. data but the conversation with that domain is not
AAU938I NOT AUTHORIZED TO ISSUE active.
SPECIFIED COMMAND

Chapter 1. AAU Prefix Messages 69


System action System action
The NetView program ignores the request. Processing stops.

Operator response Operator response


Use the LIST DOMAIN command to verify the correct Determine whether you received message BNH16I,
spelling of the domain name and whether the domain which means the task has reached its storage limit.
is active. See the LIST command in the NetView If so, notify your system programmer.
online help. If all seems correct, notify the system
programmer. System programmer response
Refer to the IBM Z NetView Troubleshooting Guide for
System programmer response
possible causes of the storage shortage. If necessary,
Check the authorized message receiver messages refer to the IBM Z NetView Tuning Guide for storage
for problems in establishing conversations, such as calculation information.
indicated by message AAU808I.
AAU949I SET TIMER REQUEST FAILED
AAU945I TOO MANY PARAMETERS FOR IMPLICIT CROSS-DOMAIN
SPECIFIED REQUEST

Explanation Explanation
You entered more than the allowed number of For an implicit cross-domain request, the set timer
parameters for a command. request failed.

System action System action


Processing stops. Processing stops.

Operator response Operator response


See the NetView online help to determine the correct Enter the command again later. If the problem
operands. Then enter the command again. persists, notify the system programmer.
AAU947I TIME EXPIRED BEFORE DATA WAS
RECEIVED System programmer response
Verify that the DSIPPT task is active. If it is active,
Explanation contact IBM Software Support.
An attempt was made to retrieve data from another AAU950I HEX MODE IS SET TO 'ON'
domain. The data was not received within the time
allowed. Explanation
You requested that the hexadecimal mode be changed
System action
to ON but the current panel is not one that uses
Processing stops. hexadecimal display mode.

Operator response System action


Enter the command again. If the message persists, Processing of the SET HEX command is completed.
investigate network degradation.
AAU951I HEX MODE IS SET TO 'OFF'
AAU948I STORAGE NOT AVAILABLE
FOR IMPLICIT CROSS-DOMAIN Explanation
REQUEST
You requested that the hexadecimal mode be changed
to OFF but the current panel is not one that uses
Explanation
hexadecimal display mode.
Storage was not available for the data areas needed.

70 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action AAU955I TOO MANY DATE/TIME
PARAMETERS SPECIFIED
Processing of the SET HEX command is completed.
AAU952I PARAMETER MORE THAN 8 Explanation
CHARACTERS LONG
You entered a SET RANGE command that does not
allow as many date and time parameters as you
Explanation specified.
You entered a parameter on the command input line
that is more than eight characters long. System action
The NetView program ignores the command.
System action
The NetView program ignores the request. Operator response
Enter the command again with valid date and
Operator response time parameters. See the SET RANGE command in
See the NetView online help to determine the correct the NetView online help to determine the correct
parameters. Then enter the command again. parameters.

AAU953I INVALID DATE/TIME PARAMETER AAU956I NO TIME RANGE SPECIFIED


SPECIFIED
Explanation
Explanation You entered a SET RANGE command without a
You entered a SET RANGE command that contains a required time range specified.
parameter with a date or time that is not valid.
System action
System action The NetView program ignores the command.
The NetView program ignores the command.
Operator response
Operator response Enter the command again with a valid time range. See
Enter the command again with valid date and the SET RANGE command in the NetView online help
time parameters. See the SET RANGE command in to determine the correct parameters.
the NetView online help to determine the correct AAU957I SET RANGE COMPLETE
parameters.
AAU954I NOT ENOUGH DATE/TIME Explanation
PARAMETERS SPECIFIED
The NetView program processed a SET RANGE
command successfully.
Explanation
You entered a SET RANGE command that requires System action
more date and time parameters than you specified.
The system is ready to process additional commands.
System action AAU958I INVALID TIME RANGE: BEGIN
TIME IS AFTER END TIME
The NetView program ignores the command.

Explanation
Operator response
You specified a SET RANGE command in which the
Enter the command again with valid date and beginning time is greater than the ending time.
time parameters. See the SET RANGE command in
the NetView online help to determine the correct
parameters. System action
The NetView program ignores the command.

Chapter 1. AAU Prefix Messages 71


Operator response System action
Enter the command again with a valid time range Processing continues. The dataset variable is not read
(begin time less than end time). See the SET RANGE because it cannot be accessed.
command in the NetView online help to determine the
correct parameters. Operator response
AAU959I INVALID DATE/TIME PARAMETER: Notify the system programmer.
DATE ENTERED WITHOUT A TIME

System programmer response


Explanation
Determine the disposition of the concatenated dataset
You entered a SET RANGE command that requires a data sets and correct problems.
time parameter corresponding to each date specified.
AAU962I UNABLE TO FIND MEMBER
member OF THE ddname DATA SET
System action
The NetView program ignores the command. Explanation
Data set ddname cannot be found. This message
Operator response
is displayed when the main menu of the session
Enter the command again with a valid time range, a monitor is requested but cannot be loaded. If the
time corresponding to each date. See the SET RANGE current session monitor panel is being displayed, this
command in the NetView online help to determine the message appears there; otherwise, it is displayed on
correct parameters. the command facility console.
AAU960I RANGE SET FROM time1 TO time2 Message Variables
member
Explanation The name of the member within the specified data
set
This is the response to a QUERY RANGE command,
showing the beginning and the ending date and time. ddname
The name of the DD statement in the JCL of the
Message Variables procedure that started the NetView program
time1
The beginning time. The time format is controlled System action
by the setting of the time operands of the
DEFAULTS and OVERRIDE commands. If there is an active panel for the session monitor,
the message appears on that panel and the session
time2 monitor retains control. Otherwise, the message is
The ending time. The time format is controlled by displayed on the command facility console and the
the setting of the time operands of the DEFAULTS command facility retains control.
and OVERRIDE commands.

Operator response
System action
Notify the system programmer.
The system is ready to process addition commands.
AAU961I UNABLE TO ACCESS dataset DATA System programmer response
SET
Add the session monitor main menu panel to the
specified data set and restart the NetView program.
Explanation
AAU963I UNABLE TO SEND COMMAND
An attempt to obtain access to dataset failed in
module AAUZTRMA.
Explanation
Message Variables
You did not enter a session monitor command from a
dataset session monitor panel and the DSIMQS returned a bad
The name of the data set that cannot be accessed return code.

72 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
The command is ignored. Ensure the parameter following the QUERY command
is valid.
Operator response AAU966I INVALID 'SET' PARAMETER
Enter the command again from a session monitor ENTERED: parameter
panel. If the error continues to occur, notify the system
programmer. Explanation
You entered a SET parameter that is not valid.
System programmer response
Message Variables
Contact IBM Software Support.
parameter
AAU964I CANNOT ISSUE PANEL The incorrect parameter following the SET
GENERATING COMMANDS UNDER command
A PPT OR AN AUTOMATED OST
System action
Explanation
The command is ignored.
A session monitor (NLDM) command which causes
a session monitor panel to be displayed cannot be
Operator response
entered under a PPT or an automated operator station
task (OST). Ensure the parameter following the SET command is
valid.
System action AAU967I SCREEN PRINTED BUT NOT
The command is ignored. LOGGED

Operator response Explanation


Avoid entering session monitor panel mode commands You attempted to use the session monitor COPY
under PPT (for example, the AT command with the command. The NetView hardcopy task is active, but
PPT parameter) or automated OST. See the NetView the DSILOG subtask is not active.
online help for a list of session monitor panel mode
commands. System action
Processing continues.
System programmer response
Verify that no command lists are issuing session Operator response
monitor panel mode commands under the PPT or
If you require a softcopy of the screen, use the
automated OST.
NetView START TASK command for DSILOG and enter
AAU965I INVALID 'QUERY' PARAMETER the COPY command again to write a copy of the screen
ENTERED: parameter to a file.
AAU968I SCREEN NEITHER LOGGED OR
Explanation PRINTED. NO HARDCOPY OR LOG
You entered a QUERY parameter that is not valid. TASK ACTIVE

Message Variables
Explanation
parameter
You attempted to use the session monitor COPY
The incorrect parameter following the QUERY
command but the NetView DSILOG subtask and the
command
hardcopy task are not active.

System action
System action
The command is ignored.
Processing continues.

Chapter 1. AAU Prefix Messages 73


Operator response Operator response
To get a hardcopy of the screen, notify the system Notify the system programmer
programmer to set up the hardcopy task to start at
logon. For a softcopy of the screen, use the NetView System programmer response
START TASK command to start DSILOG then enter the
COPY command again. Determine the source of the error by examining
the RPL feedback word. Refer to the appropriate
VTAM manual for information about interpreting the
System programmer response
feedback word.
Verify the setup of the DSILOG task and the hardcopy
task. AAU974I UNKNOWN CP NAME cpname

AAU969I UNSOLICITED DATA SERVICES Explanation


MESSAGE RECEIVED —
DISCARDED A session monitor process attempted to use a CP or
SSCP name that is unknown to the session monitor.
Explanation Message Variables
A message was received by session monitor data cpname
services for which no request was outstanding. This The name of the unknown CP or SSCP.
message is the result of a terminal operator entering a
session monitor request, logging off immediately after System action
the request, then logging on again.
The related session monitor process ends.
System action
Operator response
Processing continues. The unsolicited message is
discarded. Retry with the correct cpname. If the name is
correct but the failure persists, contact your system
AAU970I module locid DSIPSS programmer.
PERMANENT I/O ERROR, RPL
FDBWD=fdbkword
System programmer response
Explanation Review your definitions relating to session monitor to
session monitor communications, especially CDRMDEF
A permanent I/O error has occurred during the statements in member DSIAMLTD on each related
invocation of the DSIPSS. The VTAM RPL feedback NetView system.
word describes the error condition in detail.
AAU975I domainid
Message Variables
module Explanation
The control section (CSECT) name where an error
condition was detected This message is the domainid of the NLDM that you
requested information from using a SESMGET request.
locid
The location within the CSECT where an error Message Variables
condition was detected
domainid
fdbkword The domain ID of the NLDM
The VTAM RPL feedback word describing the error
condition
System action
System action The AAU975I message is returned as a successful
response to the SESMGET command.
Processing continues. The OST might abend as a result
of the error. A memory dumpis not generated if the AAU976I priname pritype pridom pritakg
abend occurs. secname sectype secdom sectakg
starttim endtim pcid sensecd

74 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


reasoncd xrftype dlurs applrecv starttim
epchg The date and time the session was started in the
format yyyymmddhhmmss (year, month, day, hour,
Explanation minute, second) is in columns 67–80.
endtim
This message is the response to a SESMGET The date and time the session ended in the
command. The information in this message is column- format yyyymmddhhmmss (year, month, day, hour,
dependent. minute, second), or other possibilities such as
Message Variables ACTIVE, CONTACTED, FORCED, BINDF, or INITF is
in columns 81–94.
priname
The network-qualified name of primary endpoint is pcid
in columns 9–25. The fully qualified procedure correlation identifier
(PCID) of the session is in columns 95–128.
pritype
The primary endpoint type is in columns 26–29. sensecd
The sense code associated with session
pridom termination is in columns 129–136. For more
The NetView domain associated with the primary information, enter HELP NLDM 'SENSE' or NLDM
endpoint, or other possibilities, including X-NET, SENSE code.
NNNA, C-C, N/A or blanks is in columns 30–34. For
more information, enter HELP NLDM 'DOM'. reasoncd
The reason code associated with session terminal
pritakg in columns 137–138. For more information, enter
Primary takeover/giveback information is in HELP NLDM 'REASON CODE'.
columns 35–37:
xrftype
• TOV indicates that the resource has been taken The extended recovery facility session type in
over. columns 139–146. For more information, enter
• GTK indicates that the resource was previously HELP NLDM 'XRF'.
given back and has now been taken over. dlurs
• GBK indicates the resource has been given back. A D in this column indicates that this session
traverses a DLUS-DLUR pipe which resides in
• TGV indicates the resource was previously taken
column 147. For more information, enter HELP
over and has now been given back.
NLDM 'DLUS-DLUR PIPE'.
secname applrecv
The network-qualified name of secondary endpoint The application LU recovery in column 148:
is in columns 38–54.
• P indicates that application LU recovery is
sectype
pending.
The secondary endpoint type is in columns 55–58.
• I indicates that application LU recovery is in
secdom
progress.
The NetView domain associated with the
secondary endpoint, or other possibilities, • C indicates that application LU recovery is
including X-NET, NNNA, C-C, N/A or blanks is in complete.
columns 59–63. For more information, enter HELP epchg
NLDM 'DOM'. The endpoint change indication in columns 149–
sectakg 151:
Secondary takeover/giveback information is in
• PRI indicates that the (control point) CP at the
columns 64–66.
primary endpoint has changed since the session
• TOV indicates that the resource has been taken started.
over. • SEC indicates that the CP at the secondary
• GTK indicates that the resource was previously endpoint has changed since the session started.
given back and has now been taken over. • P/S indicates that the CPs at both the primary
• GBK indicates the resource has been given back. and secondary endpoints have changed since the
• TGV indicates the resource was previously taken session started.
over and has now been given back. Note: Several fields in this message might be blank if
not applicable to the associated session.

Chapter 1. AAU Prefix Messages 75


AAU977I senstext and SADJ CP. These fields are delimited by commas
and are included only if they are not blank.
Explanation The ER (explicit route) section is included if the
ER prompt from NLDM.CON brings up an NLDM.ER
This message is a multiline message which results
screen. If so, the next line is 'ER CONFIGURATION:'
from a SENSE command that creates message output.
which is followed by a variable number of lines
The lines in this message are identical to the data lines
formatted as follows, each corresponding to one
on the corresponding NLDM.SENS panel, except for
box on the NLDM.ER screen, from top to bottom.
the AAU977I message-id, which is inserted at the start
of the first data line. NAME:netname SA:subarea SSCP:sscpname
TG:tgnum
Message Variables
sensetext These fields always begin in the same column. The
The text of the first data line of the corresponding last line does not have a tgnum or label following
NLDM.SENS panel, which is then followed by sscpname.
subsequent lines The AR (APPN route) section is included if
the AR prompt from NLDM.CON brings up an
System action NLDM.AR screen. If so, the next line is 'APPN
CONFIGURATION': which is followed by a variable
The AAU977I message is returned as a successful number of lines formatted as follows, each
response to a SENSE command. corresponding to one box on the NLDM.AR screen,
AAU978I SESSION CONFIGURATION: from top to bottom.

cptype cpname tgnum descriptors


Explanation
These fields always begin in the same column. The
This is a multiline message, which is a successful last line does not have a tgnum or descriptors
response to an SESSC command. The message is following cpname.
designed to be parsed by a program. The message is
created by doing full-screen automation of most NLDM Example message:
configuration information. The message consists of AAU978I SESSION CONFIGURATION:
a base section, followed by conditional ER, and AR PRIMARY: NAME RESOURCA
sections. SA 0001
EL 00002222
The base section consists of the message-ID line, DOMAIN NTVAA SUBAREA
PU ISTPUPD4(0000),
followed by these three lines: LINK LINKPD4,
PU PUPRID4 (7777),
1. Primary name, primary subarea, primary element ILU RESOURCA(2222)
address, and primary domain are followed by the SECONDARY: NAME RESOURCB
SA 0001
primary resource hierarchy, as defined by the left EL 00003333
side of the NLDM.CON screen. The first four of the DOMAIN NTVAA SUBAREA
PU ISTPUSD4(0000),
previous fields named are always present and are LINK LINKSD4,
always put into columns as shown in the following PU PUSECD4 (1111),
example. The resources, if present in the hierarchy, ILU RESOURCB(3333)
PCID NETA.CPNAME01.F1F2F3F4F5F6F7F8,
begin in column 63 and are delimited by commas. APPN TP 01,
APPNCOS COSAPPN1,
2. Secondary name, secondary subarea element SUBACOS COSSUBA1,
address, and secondary domain are followed by LOGMODE LOGMODE1,
PADJ CP N/A,
the secondary resource hierarchy, as defined by the SADJ CPN/A
right side of the NLDM.CON screen. The first four ER CONFIGURATION:
of the previous fields named are always present NAME: N/A SA: 0000007E SSCP: N/A
TG: TG001
and are always put into columns as shown in the NAME: N/A SA: 000000FE SSCP: N/A
following example. The resources, if present in the TG: TG001
NAME: NTAAVTAM SA: 000000AA
hierarchy, begin in column 63 and are delimited by SSCP: NTAAMVS
commas. APPN CONFIGURATION:
CP(ICN) APPNCN1 TG001
3. PCID followed by these fields gathered from the HPR-1234567890123450
NLDM.CON screen: APPN TP, SUBA TP, ER, VR, RER, CP APPNCP2 TG002 PRI-SA: 0004
SEC-SA: 0003
INOP, APPNCOS, SUBACOS, LOGMODE, PADJ CP HPR-1234567890123450

76 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CP(CN)
CP
APPNCN3
APPNCP4
VR-TG
System action
The AAU978I message is a successful response to a
Note: The PRIMARY, SECONDARY, and PCID lines are SESSC command.
not split as shown, but are continuous with one space
after each comma. The data shown is for illustration
only. Most of the labels come from NLDM, and help for
the terms is available through the HELP NLDM 'term'
command. See HELP in the online help facility.

Chapter 1. AAU Prefix Messages 77


78 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)
Chapter 2. AQN Prefix Messages

This section lists the AQN prefix messages.


AQN001I NO SOCKET PATH NAMES FOUND System programmer response
FOR DATA SOURCE subtower_name
DOMAIN domain Verify that replication data collection is enabled for the
specified subtower. If it is not enabled, comment out
the subtower name in the user-defined CNMSTGEN
Explanation or CNMSTUSR member, and then recycle the NetView
This message can be issued for replication data program.
collection or as a response to the ACTVREPL Verify that the socket path names are configured
command. for the specified replication subtower. If you update
If the message is issued for replication data collection, the socket path names, issue the RESTYLE ACTACT
no configured or dynamic socket path names were command.
found for the specified replication subtower for the AQN002I DATA COLLECTION FAILED FOR
specified domain. The domain is the local NetView DATA SOURCE subtower_name,
domain. SOCKET PATH NAME path
If the message is received as a response to an
ACTVREPL command, no configured socket path Explanation
names were found for the specified replication
subtower for the specified domain. The domain is a The NetView program attempted to connect to the
remote NetView domain. specified socket path name for the specified subtower,
and the connection failed.
A configured socket path name is one defined to the
NetView program in a user-defined CNMSTGEN or Message Variables
CNMSTUSR member. A dynamic socket path name subtower_name
is one that the NetView program determines only For the ACTIVEACTIVE REPLICATION subtower:
through message automation when a replication
server starts. A dynamic socket path name is not also • DB2
configured. • IMS
Message Variables • VSAM
subtower_name path
For the ACTIVEACTIVE REPLICATION subtower: The configured or dynamic socket path name
• DB2® A configured socket path name is defined to the
NetView product in a user-defined CNMSTGEN or
• IMS
CNMSTUSR member. A dynamic socket path name
• VSAM is determined by the NetView product through
domain message automation when a replication server
The NetView domain. starts. A dynamic socket path name is not also
configured.

System action
System action
If the message is issued for replication data collection,
then data collection is stopped for the specified If all socket path names fail for a subtower, data
subtower. collection for that subtower is stopped. If a RESTYLE
ACTACT is issued or a message from a replication
If the message is issued as a response to the server is received with an active socket path name,
ACTVREPL command, the command fails for the data collection is restarted.
specified subtower.

© Copyright IBM Corp. 1997, 2022 79


Operator response AQN006I DUPLICATE subtower_name,
SOCKET PATH NAME path
If the replication server is not started, this message IGNORED
can be ignored.
After the replication server is started, verify that data Explanation
collection started for the specified socket path name
by using the ACTVCTL LISTINFO command. A duplicate socket path name for the specified
subtower was specified and is ignored.
System programmer response For data collection, the duplicate paths are ignored in
order to prevent duplicate data collection.
Verify that the socket path name is configured
correctly for the specified replication subtower, and For the ACTVREPL command, no production system
issue a RESTYLE ACTACT command. The updated path configuration information is forwarded to the
socket path name is read at the next data collection controller system for the particular data source (DB2,
interval. IMS, or VSAM) and function (capture or apply).

AQN003I LOCAL DOMAIN domain_name Message Variables


NOW ENTERPRISE MASTER FOR subtower_name
ACTIVEACTIVE For the ACTIVEACTIVE REPLICATION subtower:
• DB2
Explanation
• IMS
This message is issued when the NetView program
• VSAM
becomes an enterprise master and its enterprise
master configuration that is specified on the ENT.TYPE path
statement includes ACTIVEACTIVE. The configured socket path name
Message Variables A configured socket path name is defined to the
NetView program in a user-defined CNMSTGEN or
domain_name
CNMSTUSR member.
Name of the local NetView domain
AQN004E ENT.ACTIVEACTIVE.ROLE System action
STATEMENT REQUIRED IF
ACTIVEACTIVE SPECIFIED ON For data collection, one connection will be attempted
ENT.TYPE for the specified socket path name.
For ACTVREPL, the command will fail for the NetView
Explanation domain for the specified data source (DB2, IMS, or
VSAM) and function (capture or apply).
This message is issued when a required
ENT.ACTIVEACTIVE.ROLE statement is not coded in
the CNMSTYLE member. If you specify ACTIVEACTIVE Operator response
as the type of enterprise master NetView program on Notify the system programmer of the duplicate socket
the ENT.TYPE statement, then you must also specify path name.
the ENT.ACTIVEACTIVE.ROLE statement.
When the AQN004I message is issued, processing of System programmer response
ENT.SYSTEMS statements ends. The NetView program
does not become an enterprise master. Change the duplicate socket path name in the
CNMSTGEN or CNMSTUSR sample.
Operator response:
Notify the system programmer. AQN007I DISPLAY ACTIVE/ACTIVE DATA
COLLECTION INFORMATION
System programmer response
Explanation
Review and update the ENT.TYPE and
ENT.ACTIVEACTIVE.ROLE statements in the This message is received when the ACTVCTL LISTINFO
CNMSTYLE member. command is issued. The information provided is based
on the value specified for the LISTINFO keyword.
There can be multiple entries for the replication

80 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


subtowers because there can be multiple replication AQN008I REPLICATION SERVER SITUATION
servers for each data source (DB2, IMS, VSAM) on OR POLICY NAME IS name
each z/OS image.
The AQN007I message lists the following information: Explanation
Tower name This is the first line of a multiline message for
Specifies the Active/Active tower or subtower displaying information related to replication server
descriptive name situations. This message is issued as a notification for
Status automation by the GDPS® solution. The data lines for
Indicates whether data collection is active this message provide keyword and value pairs that
or inactive. If multiple replication servers are provide detailed attribute information related to the
configured for each data source, and a connection situation.
to at least one data source is successful, the status Message Variables
is Active. The sampling interval is the same for all
replication servers for each data source. name
The message variable is an abbreviated version of
Path
the situation or policy name:
Specifies the socket path name on which data
collection occurs. APPSERVERSTATUS
Indicates that the
Task information
NAS_AA_RS_AppServerStatus situation fired
Specifies the virtual OST (VOST) and the
associated attach name of the VOST on which data CAPSERVERSTATUS
collection runs. Data collection control (sampling Indicates that the
interval) is done at the configured autotask, but the NAS_AA_RS_CapServerStatus situation fired
actual data collection is done on a VOST. DB2WORKLOADSTATE
Average time Indicates that the
Specifies the average amount of time incurred for NAS_AA_RS_DB2WorkloadState situation fired
data collection across intervals. This value resets if IMSWORKLOADSTATE
data collection is stopped and restarted. Indicates that the
Maximum time NAS_AA_RS_IMSWorkloadState situation fired
Specifies the maximum amount of time for a single LATENCYEXCEEDED
data collection across one sampling interval. This Indicates that the
value resets if data collection is stopped and NAS_AA_RS_LatencyExceeded situation fired
restarted. If this value is larger than your sampling
LATENCYRESET
interval, consider increasing the sampling interval.
Indicates that the
Number of iterations NAS_AA_RS_LatencyExceeded situation
Specifies the number of times data collection was resolved as defined in the
occurred since it was started. This value resets if NAP_AA_RS_LatencyReset policy
data collection is stopped and restarted.
VSAMWORKLOADSTATE
Indicates that the
Operator response NAS_AA_RS_VSAMWorkloadState situation
Contact your system programmer if a data collection fired
is inactive for a specified socket path name, and if it For more information about the situations and the
should be active. attributes related to the situations, refer to the IBM
Z NetView Enterprise Management Agent online
System programmer response help or the IBM Z NetView User's Guide: NetView
Enterprise Management Agent.
Use the information in this message to set an optimal
data collection interval. You can also use this message AQN009I DATA COLLECTION FOR
for diagnostic purposes. subtower_name RESTARTED

Usage Note: If there are multiple socket path names


for a replication data source, and data collection
Explanation
failed for a particular socket path name, Task Data collection for the specified subtower was stopped
Information fields display N/A, and the statistics and restarted. This action occurs when data collection
display zero (0). is already started for a replication server for the

Chapter 2. AQN Prefix Messages 81


specified subtower, and another replication server for Operator response
the specified subtower is started. The data collection
stop and start allows data from the new server to Use the ACTVCTL LISTINFO command to display
be immediately available without waiting for the next information about Active/Active data collection.
sampling interval. AQN012I cmd COMMAND NOT PROCESSED.
Message Variables CURRENT VALUE interval
FOR subtower_name MATCHES
subtower_name CHANGE VALUE.
For the ACTIVEACTIVE REPLICATION subtower:
• DB2 Explanation
• IMS An ACTVCTL RESET command was issued with the
• VSAM same interval value that is currently being used
for data collection for the specified subtower. The
AQN010I DATA COLLECTION FOR
command ends with no changes.
subtower_name ALREADY
STARTED Message Variables
cmd
Explanation The command that was issued
Data collection for the specified subtower was already interval
started. The command is not processed. The data collection sampling interval for the
specified subtower
Message Variables
subtower_name
subtower_name For the ACTIVEACTIVE subtower:
For the ACTIVEACTIVE subtower:
• DB2
• DB2
• IMS
• IMS
• LIFELINE
• LIFELINE
• VSAM
• VSAM
Operator response
Operator response
Specify a different interval value.
Use the ACTVCTL LISTINFO command to display
information about Active/Active data collection. AQN013I DATA COLLECTION INTERVAL FOR
subtower_name SET TO interval
AQN011I DATA COLLECTION FOR
subtower_name ALREADY
STOPPED Explanation
The data collection sampling interval was changed
Explanation for the specified subtower using the ACTVCTL RESET
command.
Data collection for the specified subtower was already
stopped. The command is not processed. Message Variables

Message Variables subtower_name


For the ACTIVEACTIVE subtower:
subtower_name
For the ACTIVEACTIVE tower: • DB2
• IMS
• DB2
• LIFELINE
• IMS
• VSAM
• LIFELINE
• VSAM interval
The data collection sampling interval for the
specified subtower

82 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action – The ENT.ACTIVEACTIVE.ROLE statement specifies
a value that is not valid.
When data collection is active for the specified
subtower and the sampling interval is changed, data – The ENT.TYPE statement specifies
collection is stopped and then immediately restarted. ACTIVEACTIVE, but no ENT.ACTIVEACTIVE.ROLE
When data collection is inactive for the specified statement is present.
subtower and the sampling interval is changed, the • The NetView program is not in the master role in its
new interval is used when data collection is started. XCF group.
AQN014E ACTIVEACTIVE.LIFELINE • Another NetView program is the Active/Active
SUBTOWER REQUIRES A VALUE enterprise master NetView program.
OF ACTIVEACTIVE ON THE
ENT.TYPE STATEMENT System action
Enterprise master processing is ended.
Explanation
This message is issued during enterprise master Operator response
processing on an Active/Active controller system.
This error occurs when an ACTIVEACTIVE.LIFELINE Contact your system programmer.
subtower is enabled and an ENT.TYPE statement
is not found in CNMSTYLE processing or the value System programmer response
for the ENT.TYPE statement does not include
ACTIVEACTIVE. Review the NetView log for additional error messages
that might identify the cause of the problem.

System action AQN016A Reply Yes if Tivoli Enterprise


Monitoring Server is inactive on
Enterprise master processing is ended. system system. Otherwise, reply
No.
Operator response
Contact your system programmer. Explanation
This message is issued when the value for the
System programmer response ACTACT.BKTEMS.Enable statement in the CNMSTYLE
member is Yes. For more information about when
For Active/Active controller systems, you must code an this message is issued, see the description for the
ENT.TYPE statement that includes ACTIVEACTIVE. ACTACT.BKTEMS.Enable statement in the CNMSTLIF
AQN015E ACTIVEACTIVE ENTERPRISE include member.
MASTER PROCESSING FAILED Message Variables
system
Explanation The z/OS image name of the primary controller
This message is issued during enterprise master system on which the hub Tivoli Enterprise
processing on an Active/Active controller system. This Monitoring Server (monitoring server) resides.
error occurs for the following configuration errors: The system is defined to the NetView program
on the ACTACT.PriCont.System statement in the
• Errors in CNMSTYLE configuation, such as the CNMSTYLE member.
following:
– The ENT.TYPE statement specifies System action
ACTIVEACTIVE, but the ACTIVEACTIVE.LIFELINE
tower is not enabled. If the reply is Yes, the monitoring server is started
using the startup procedure that is specified on the
– The ACTIVEACTIVE.LIFELINE tower is enabled, ACTACT.BKTEMS.procStr statement in the CNMSTYLE
but no ENT.TYPE statement is present. member.
– No valid types are specified by the ENT.TYPE
statement.
Operator response
– The ENT.TYPE statement is present, but no
ENT.SYSTEMS statements are present. Respond as follows:

Chapter 2. AQN Prefix Messages 83


1. If any of the following conditions are true, reply components on controller systems" in the IBM Z
Yes: NetView for Continuous Availability Configuring and
Using the GDPS Continuous Availability Solution for
• The monitoring server on the specified system is
more information.
not active or will be stopped in the immediate
future. AQN018I Tivoli Enterprise Monitoring Server
• The specified system is not available. procstr is already active. Results
may be unpredictable.
• The Tivoli Enterprise Portal Server (portal server)
lost contact with the monitoring server on the
specified system. Explanation
When you reply YES, the monitoring server The Tivoli Enterprise Monitoring Server (monitoring
is started using the startup procedure that server) is already active on the backup controller. If
is specified on the ACTACT.BKTEMS.procStr the monitoring server is active on both the primary
CNMSTYLE statement. If the portal server is still and backup controller z/OS images, you can have
communicating with the monitoring server on unpredictable results in your NetView Active/Active
the specified system, it does not connect to this Sites workspaces on the Tivoli Enterprise Portal.
monitoring server, and there is no data from this Message Variables
Active/Active enterprise master NetView program
in the portal server. procstr
The startup procedure that is specified on
2. If the monitoring server on the specified system
the ACTACT.BKTEMS.procStr statement in the
is still active and communicating with the portal
CNMSTYLE member.
server, reply No.
3. Contact your system programmer.
System programmer response
System programmer response Make sure that the monitoring server is only started on
one controller system at a time. Except for an outage,
Determine the cause of the outage. the hub monitoring server must run on the primary
AQN017I domain ON system IS ALREADY controller.
AN ACTIVEACTIVE ENTERPRISE AQN019E CONNECTION FAILURE TO
MASTER NETVIEW server ON SOCKET
PATH path. REPORTING
Explanation MODULE=module_name. RC:
return_code REASON: reason
The NetView program on which an ACTVCTL
TAKEOVER command was issued is already an Active/
Active enterprise master NetView program. Explanation
Message Variables This message is a result of a failure to establish or
maintain a data collection connection on an Active/
domain Active server.
The NetView domain
Message Variables
system
The z/OS image name of the system on which this server
NetView program resides The type of server (DB2, IMS, LIFELINE, or VSAM)
path
System action The UNIX path that was used

The ACTVCTL TAKEOVER command fails. module_name


The control section (CSECT) name where an error
condition was detected
Operator response
return_code
Do not issue the ACTVCTL TAKEOVER command The return code
unless directed to do so by your system programmer. reason
Issuing the ACTVCTL TAKEOVER command can cause Description of the return code:
unintended results from the Active/Active solution
standpoint. Refer to the section "Switching solution • Attach command failure

84 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• Command authorization failure 102-111
• Connection already started The number of Multi-site Workload Lifeline Agents
that are connected to the Multi-site Workload
• Connection already stopped Lifeline Advisor. This attribute is not applicable for
• Could not connect socket secondary Multi-site Workload Lifeline Advisors.
• Initialization subroutine failure
• Invalid action parameter value System action
• Invalid socket path name The ACTVLIFE ADVISORS command processing is
• Invalid tower/subtower configuration complete.

• Invalid type parameter value AQN021I DISPLAY OF LIFELINE AGENTS


• LRCE storage not found
• No text available Explanation
• Should not occur condition encountered This multiline message is issued in response to
the ACTVLIFE AGENTS command. It consists of one
• Unable to obtain storage
header line, three label lines, and one or more data
• Unable to push LRCE storage lines, with each data line providing information about a
• Unable to obtain UNIX socket Lifeline Agent.
• UNIX socket closed Each data line includes the following information:
• Unspecified command syntax error Columns
Description
AQN020I DISPLAY OF LIFELINE ADVISORS
1-45
The IP address of the Multi-site Workload Lifeline
Explanation Agent.
This multiline message is issued in response to the 49-56
ACTVLIFE ADVISORS command. It consists of one The image name where the Multi-site Workload
header line, three label lines, and one or more data Lifeline Agent resides.
lines, with each data line providing information about a
60-67
Lifeline Advisor.
The name of the site as it is known to the Multi-site
Each data line includes the following information: Workload Lifeline Agent.
Columns • If the site_name parameter is configured for the
Description Multi-site Workload Lifeline Agent, the site name
1-8 is the name specified for the parameter.
The name of the z/OS operating system where the – The site_name parameter is required for a
Multi-site Workload Lifeline Advisor resides. Linux® on z Systems® Management Agent and
12-26 is optional for a z/OS Agent.
The IPv4 address of the Multi-site Workload • If the site_name parameter is not configured for
Lifeline Advisor. the z/OS Agent, the site name is the name of
30-74 the sysplex as it is known to the z/OS operating
The IPv6 address of the Multi-site Workload system.
Lifeline Advisor.
71-80
78-86 The number of server applications that are being
The role of the Multi-site Workload Lifeline Advisor. monitored by this Multi-site Workload Lifeline
The following values are valid: Agent.
• PRIMARY 84-91
• SECONDARY The state of the Multi-site Workload Lifeline Agent.
The following values are valid:
90-94
The number of active load balancers that are • ACTIVE
registered with the Multi-site Workload Lifeline • INACTIVE
Advisor. This attribute is not applicable for
secondary Multi-site Workload Lifeline Advisors.

Chapter 2. AQN Prefix Messages 85


95-134 Explanation
The type of the Multi-site Workload Lifeline Agent.
The following values are valid: This multiline message is issued in response to the
ACTVLIFE LBS command. It consists of one header
• z/OS line, three label lines, and one or more data lines,
• Linux on z Systems Management Guest with each data line providing information about a load
balancer.
138-146
Each data line includes the following information:
The name of the site (i.e. the sysplex name), as it
is known to the z/OS operating system, where the Columns
Multi-site Workload Lifeline Agent resides. Description

For a Linux on z Systems Management Guest 1-45


agent, the value is N/A. The IP address of the load balancer.
49-60
The role of the load balancer. The following values
System action
are valid:
The ACTVLIFE AGENTS command processing is 1st TIER
complete. This load balancer is responsible for routing
AQN022I DISPLAY OF LOAD BALANCER workloads between sites.
GROUPS FOR LOAD BALANCER AT 2nd TIER
IP ADDRESS ipaddress This load balancer is responsible for routing
workloads within a site.
Explanation UNKNOWN
This load balancer is unclassified.
This multiline message is issued in response to the
ACTVLIFE LBGROUPS command. It consists of one INTERMED
header line, three label lines, and one or more data This load balancer is an intermediary node that
lines, with each data line providing information about a is responsible for routing workloads within a
load balancer group. site.
Each data line includes the following information: Note: The 1st TIER and 2nd TIER values do not
pertain to the TIER1 and TIER2 keywords that
Columns
are provided by the z/OS Communications Server
Description
VIPADYNAMIC statement.
1-45
The IP address for a server application that is 64-71
registered for the group. The status of the load balancer. The following
values are valid:
49-53
The port number for a server application that is • ACTIVE
registered for the group. • INACTIVE
57-311 75-93
The name of the group that is registered to the The type of load balancer. The following values are
load balancer. For internal load balancers, this valid:
attribute does not apply.
EXTERNAL
Message Variables The IP address for this load balancer is for an
ipaddress external appliance.
The IPv4 or IPv6 address of the load balancer. INTERNAL
The IP address for this load balancer:
System action • For a second tier load balancer, this is the IP
The ACTVLIFE LBGROUPS command processing is address for a sysplex distributor within a site.
complete. • For an intermediary node, this is the IP
address that is defined on an internal system
AQN023I DISPLAY OF LOAD BALANCERS within a site.

86 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


97-102 AQN025I DISPLAY OF z/OS WORKLOAD
The number of groups that are registered by SERVERS FOR WORKLOAD NAME
the load balancer. For internal load balancers workload_name
(sysplex distributors), or load balancers that are
intermediary nodes, this attribute does not apply.
Explanation
System action This multiline message is issued in response to the
ACTVLIFE SERVERS command. It consists of one
The ACTVLIFE LBS command processing is complete. header line, three label lines, and one or more data
lines, with each data line providing information about a
AQN024I DISPLAY OF LOAD BALANCER
workload server.
WORKLOADS FOR LOAD
BALANCER AT IP ADDRESS Each data line includes the following information:
ipaddress
Columns
Description
Explanation 1-8
This multiline message is issued in response to the The MVS job name of the server application.
ACTVLIFE LBWRKLDS command. It consists of one 12-56
header line, three label lines, and one or more data The IPv4 or IPv6 address of a server application
lines, with each data line providing information about a that is defined for the workload.
load balancer workload.
60-64
Each data line includes the following information: The number of the port on which the server
application listens.
Columns
Description 68-75
The z/OS image name where the server application
1-64
resides.
The name of the workload.
79-86
68-70
The name of the site as it is known to the Multi-site
An indication of whether the server applications Workload Lifeline Agent.
on the active site are available and if these server
• If the site_name parameter is configured for the
applications are able to handle additional requests
Multi-site Workload Lifeline Agent, the site name
for this workload.
is the name specified for the parameter.
The following values are valid:
– The site_name parameter is required for a
• Yes: The server applications for this workload Linux on z Systems Management Agent and is
are available and able to handle new workload optional for a z/OS Agent.
requests. • If the site_name parameter is not configured for
• No: The server applications for this workload are the z/OS Agent, the site name is the name of
either not available or not able to handle new the sysplex as it is known to the z/OS operating
workload requests. system.
83-127 90-97
The IP address for a server application that is The state of the server application. The following
registered for the group. values are valid:
131-135 • ACTIVE
The port number for a server application that is
• INACTIVE
registered for the group.
101-102
Message Variables
The net weight for this server application relative
ipaddress to other server instances that are defined for this
The IPv4 or IPv6 address of the load balancer. workload on the same site. This value is calculated
by applying the Communications Server health as a
System action percentage of the WLM weight for this server. It is
then normalized against the other server instances
The ACTVLIFE LBWRKLDS command processing is (active on this same site) that are defined for this
complete. workload. If the value for this field is blank, look in

Chapter 2. AQN Prefix Messages 87


the NetView log for the AQN029I message to see if 161-162
the value is out of range. The zIIP factor in the WLM weight. This is the
110-111 amount of displaceable zIIP capacity based on the
The Workload Manager (WLM) weight value for importance of the server application as compared
the server application. This value is a measure of to other server instances (active on this same site)
how well the server application is implementing that are defined for this workload and modified
the WLM policies of the server application. It by the proportion of zIIP capacity that is used by
represents the amount of displaceable processor this server, as compared to general CPU and zAAP
capacity based on the importance of the server processors. If the value for this field is blank, look
application as compared to other server instances in the NetView log for the AQN029I message to
(active on this same site) that are defined for this see if the value is out of range.
workload. The WLM weight is a composite weight 170-173
and includes the sum of the CP, zAAP, and zIIP The health of the server application as determined
weights. If the value for this field is blank, look in by z/OS Communications Server. The value is
the NetView log for the AQN029I message to see if calculated based on how well the server keeps
the value is out of range. up with new connection requests on the backlog
119-122 of the server, how well the server establishes
The rate of abnormal transaction completions per new connections, and whether the server drops
1000 transactions for this server application. This connections. This value is treated as a percentage
value is optionally supplied by server applications and is used to adjust the net weight. If the value
to the Workload Manager, which uses it to adjust for this field is blank, look in the NetView log for
the reported WLM weight. If the value for this field the AQN029I message to see if the value is out of
is blank, look in the NetView log for the AQN029I range.
message to see if the value is out of range. 187-194
134-137 The name of the site (i.e. the sysplex name), as it
The health indicator of the server application. is known to the z/OS operating system, where the
This indicator is available only for servers that z/OS server application resides.
provide this information to Workload Manager. For Message Variables
servers that are healthy or are not reporting this
information, a value of 100 is returned. This value workload_name
is treated as a percentage and is used to adjust The name of the workload as specified for the
the reported WLM weight. If the value for this field WORKLOAD keyword. A value of * indicates that
is blank, look in the NetView log for the AQN029I the WORKLOAD keyword is not specified or that
message to see if the value is out of range. WORKLOAD=* is specified.

143-144
The CPU factor in the WLM weight. This is the System action
amount of displaceable general CPU capacity The ACTVLIFE SERVERS command processing is
based on the importance of the server application complete.
as compared to other server instances (active on
the same site) that are defined for this workload AQN026I DISPLAY OF WORKLOAD SITES
and modified by the proportion of general CPU FOR WORKLOAD workload_name
capacity that is used by this server, as compared to
zAAP and zIIP processors. If the value for this field Explanation
is blank, look in the NetView log for the AQN029I
message to see if the value is out of range. This multiline message is issued in response to the
ACTVLIFE SITES command. It consists of one header
152-153
line, three label lines, and one or more data lines, with
The zAAP factor in the WLM weight. This is
each data line providing information about a workload
the amount of displaceable zAAP capacity based
site.
on the importance of the server application as
compared to other server instances (active on this Each data line includes the following information:
same site) that are defined for this workload and Columns
modified by the proportion of zAAP capacity that Description
is used by this server, as compared to general CPU
and zIIP processors. If the value for this field is 1-8
blank, look in the NetView log for the AQN029I The name of the site where the workload can be
message to see if the value is out of range. distributed.

88 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


12-23 AQN027I DISPLAY OF role WORKLOADS FOR
The routing state of the workload on this site. The WORKLOAD NAME workload_name
following values are valid:
ACTIVE Explanation
If the workload is active on this site, this is the
active site. This multiline message is issued in response to the
ACTVLIFE WRKLOADS command. It consists of one
QUIESCED header line, three label lines, and one or more data
If the workload is quiesced on this site, this is lines, with each data line providing information about a
the standby site. workload.
Note: If the workload is quiesced on both sites, Each data line includes the following information:
the workload on the active site might not be
activated yet. Columns
Description
DEACTIVATED
1-64
For an Active/Standby workload, this is the
The name of the workload.
standby site for the workload. Any connections
for the Active/Standby workload on this site 68-81
are reset. For an Active/Query workload, this The overall status of the workload. This value
is the site where the workload is currently is calculated from the workload status that
quiesced. Any connections for the Active/ is reported by the Multi-site Workload Lifeline
Query workload on this site are reset. product and the workload status that is reported
by the replication server that is associated with the
27-28
workload. The following values are valid:
The routing weight of the workload on this site. For
an Active/Standby workload, the workload routing • SATISFACTORY: Both statuses are satisfactory.
weight is 0 for the standby site or 1 for the active • UNSATISFACTORY: At least one of the statuses is
site. For an Active/Query workload, the workload unsatisfactory.
routing weight is in the range 0 - 64, which
corresponds to the current routing distribution to 85-96
this site The monitoring component that detected a failure
when the Workload Status attribute value is
38-40
UNSATISFACTORY. The following values are valid:
An indication of whether the site is preferred when
the Role attribute value is ACTIVE/QUERY and the • BOTH
workload routing type, as defined to the Multi-site • REPLICATION
Lifeline Workload product, is DYNAMIC. Otherwise
this value does not apply and is set to N/A. The • ROUTING
following values are valid: The value of NONE is specified when the Workload
• Yes Status attribute value is SATISFACTORY.

• No 100-113
The role of the workload. The following values are
• N/A valid:
50-63 • ACTIVE/QUERY
The role of the workload. The following values are
valid: • ACTIVE/STANDBY

• ACTIVE/STANDBY 117-122
The number of servers that make up the workload.
• ACTIVE/QUERY
130-145
Message Variables The failure state of the workload as reported
workload_name by the Multi-site Workload Lifeline product
The workload name for which the site information when the Workload Status attribute value is
is displayed. UNSATISFACTORY and the Detected Failure
attribute value is either BOTH or ROUTING. The
following values are valid:
System action
• QUIESCED: The Multi-site Workload Lifeline
The ACTVLIFE SITES command processing is product is reporting an unsatisfactory workload
complete.

Chapter 2. AQN Prefix Messages 89


status because either the Active/Standby systems that make up the site, and the average
workload or the Active/Query workload is replication latency of the associated Active/
quiesced on both sites. Standby workload.
• SITE FAILURE: The Multi-site Workload Lifeline 168-183
product is reporting an unsatisfactory workload The latency state of the workload when the Role
status because the site where the workload is attribute value is ACTIVE/QUERY. Otherwise this
active failed. value does not apply and is set to N/A. The
– For Active/Standby workloads, the Active site following values are valid:
failed. • ACUTE
– For Active/Query workloads, the site or sites • CONSTRAINED
where the workload is active failed.
• CRITICAL
• SITE NOT OPTIMAL: The Multi-site Workload
• NORMAL
Lifeline product is reporting an unsatisfactory
workload status because an Active/Query • UNKNOWN
workload with a workload routing type of STATIC 187-191
is being routed to a site that is not optimal. The number of Active/Query workloads that are
– One of the sites had a workload or site failure associated with this Active/Standby workload
but connections for the workload are still when the Role attribute value is ACTIVE/STANDBY.
being routed to that site. Otherwise this value does not apply and is set
to N/A. The number of Active/Query workloads
– The maximum replication latency threshold
that can be associated with an Active/Standby
was exceeded for the workload but
workload is 0, 1, or 2.
connections for the workload are still being
routed to the Standby site. 202-265
The name of the Active/Standby workload that
• WORKLOAD FAILURE: The Multi-site Workload
is associated with this Active/Query workload
Lifeline product is reporting an unsatisfactory
when the Role attribute value is ACTIVE/QUERY.
workload status because no server applications
Otherwise this value does not apply and is set to
are available for the workload.
N/A.
– For Active/Standby workloads, no servers are
Message Variables
available on the site where the workload
connections are being routed. role
– For Active/Query workloads, no servers are The role of the workload. The following values are
available on the site or sites where the valid:
workload connections are being routed. • ALL: Indicates that the ROLE keyword is not
A value of N/A is displayed when either of the specified or that ROLE=* is specified.
following conditions is true: • Active/Standby: Indicates that ROLE=STANDBY
is specified.
• The Workload Status attribute value is
SATISFACTORY. • Active/Query: Indicates that ROLE=QUERY is
specified.
• The Workload Status attribute value is
UNSATISFACTORY and the Detected Failure workload_name
attribute value is REPLICATION. The name of the workload as specified for the
WORKLOAD keyword. A value of * indicates that
149-164
the WORKLOAD keyword is not specified or that
The routing type of the workload when the Role
WORKLOAD=* is specified.
attribute value is ACTIVE/QUERY. Otherwise this
value does not apply and is set to N/A. The
following values are valid: System action
• STATIC: Indicates that query transactions are The ACTVLIFE WRKLOADS command processing is
routed to each of the sites based on the complete.
configured percentages.
AQN028I SOCKET PATH NAME path NOT
• DYNAMIC: Indicates that query transactions CONFIGURED FOR subtower_name
are routed based on the health of the server
applications, the available capacity of the

90 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation source attribute missing or processing of an alert
ended before the data source was known.
A message was received from IMS or VSAM replication
indicating that an interface for data collection was
started, but the socket path name in the message is System programmer response
not configured to the NetView program. The socket If the message is issued as a result of issuing
path name must be configured to the NetView program an ACTVLIFE or ACTVREPL command, contact IBM
for data collection to start. Software Support with the information in the message.
Message Variables If the message is issued with Subfield_30 for the field
path name, contact IBM Software Support for the specified
The socket path name. replication product.
subtower_name AQN030I DISPLAY OF REPLICATION
For the ACTIVEACTIVE tower, IMS/VSAM SERVER WORKLOADS
workload_name FOR DATA
System programmer response SOURCE type

Configure the specified socket path name to the


Explanation
NetView program and then issue the RESTYLE ACTACT
command. This multiline message is issued in response to the
following commands:
AQN029I UNEXPECTED VALUE value
RECEIVED FOR fieldname FOR • ACTVREPL SERVER=* | server_job_name
DATA SOURCE subtower_name VIEW=COMMON
Replication server workload information for the
Explanation specified server or servers is displayed.
This message is written to the NetView log for the • ACTVREPL WORKLOAD=* | workload_name
following conditions: VIEW=COMMON

• As a response to an ACTVLIFE or ACTVREPL Replication server workload information for the


command when the data value for the specified field specified workload or workloads is displayed.
is out of range. It consists of one header line, three label lines, and
A message is issued for each field in the message one or more data lines, with each data line providing
output for which the data value is invalid. information about a replication server workload.
• As a response to invalid information in a subvector Each data line includes the following information:
31, subfield 30, that is generated from an Event Columns
Integration Facility (EIF) event that is sent from a Description
replication product
1-64
Message Variables The name of the workload.
value 68-75
The data value that is out of range. The type of workload. The following values are
fieldname valid:
The field name for which the data value is out of • DB2
range.
• IMS
subtower_name
• VSAM
For the ACTIVEACTIVE tower:
79-88
• DB2
The average latency is the average elapsed time
• IMS in milliseconds between the time that transactions
• LIFELINE were committed to the source table or database
and the time that transactions were committed to
• VSAM
the target table or database. This average includes
If a value of unknown is specified, the NetView only the transactions that were processed during
program encountered an EIF event that had a data the last sampling interval.

Chapter 2. AQN Prefix Messages 91


92-108 sent to the target server. This average includes
The date and time that the NetView program only the transactions that were processed during
received the data from the capture server for this the last sampling interval.
workload.
When the value of Workload Type is DB2, average
112-131 capture latency is the average elapsed time in
The state of the workload as determined by the milliseconds between the time that transactions
capture server. were committed to the source table and the time
When the value of Workload Type is DB2, the that the Q Capture program puts the last message
following values are valid: for the transactions on the send queue.

• INACTIVE When the value of Workload Type is IMS, average


capture latency is the average elapsed time in
• REPLICATE CONTINUOUS milliseconds between the time that a transaction
When the value of Workload Type is IMS or VSAM, was committed to the source database and the
the following values are valid: time that the transaction was sent to the target
server.
• DESCRIBE
291-300
• ENDING CONTROLLED
The average network latency is the average
• ENDING IMMEDIATELY elapsed time in milliseconds between the time that
• ERROR transactions were sent to the target server and
the time that the target server received them. This
• INACTIVE
average includes only the transactions that were
• REPLICATE CONTINUOUS processed during the last sampling interval.
• STARTING When the value of Workload Type is DB2, average
135-142 network latency is the average elapsed time in
The job name of the capture server. milliseconds between the time that the Q Capture
program put messages on the send queue and the
149-152
time that the Q Apply program got them from the
The address space ID of the capture server. This is
receive queue.
a four-digit hexadecimal number.
163-170 When the value of Workload Type is IMS, average
The status of the NetView data collection network latency is the average elapsed time in
connection to the capture server. The following milliseconds between the time that a transaction
values are valid: was sent to the target server and the time that the
transaction was received by the target server.
• ACTIVE
309-325
• INACTIVE The date and time that the NetView program
179-185 received the data from the apply server for this
The z/OS image name of the capture server. workload.
192-199 329-348
The name of the capture site (sysplex). The state of the workload as determined by the
apply server.
204-223
The cumulative total number of bytes that were When the value of Workload Type is DB2, the
sent to the target server. following values are valid:
227-246 • INACTIVE
The cumulative total number of transactions that
• REPLICATE CONTINUOUS
were sent to the target server.
250-269 When the value of Workload Type is IMS or VSAM,
The cumulative total number of rows that were the following values are valid:
sent to the target server. • DESCRIBE
273-282 • ENDING CONTROLLED
The average capture latency is the average elapsed
• ENDING IMMEDIATELY
time in milliseconds between the time that
transactions were committed to the source table • ERROR
or database and the time that transactions were • INACTIVE

92 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• REPLICATE CONTINUOUS 533-537
• STARTING The number of consistency groups that make up
the workload as defined by the replication product.
352-359
554-617
The job name of the apply server.
The name of the consistency group. A consistency
366-369 group is a single capture and apply server pair for a
The address space ID of the apply server. This is a workload.
four-digit hexadecimal number.
621-628
380-387 The name of the source site. The source site is
The status of the NetView connection to the apply where the database or file system logs that are
server. The following values are valid: used by replication are written.
• ACTIVE When a proxy database or file system configuration
• INACTIVE reads the source site logs from mirrored disks,
and the data is then replicated using software
396-403 replication, the source site and capture site are
The z/OS image name of the apply server. different.
409-416
When the source site and capture site are the
The name of the apply site (sysplex).
same, the value of this attribute is N/A.
421-440
The cumulative total number of bytes that were 633-652
received by the target server. The average elapsed milliseconds between the
444-463 time that the first change for the replicated
The cumulative total number of transactions that transaction was issued at the target database and
were received by the target server. the time that the transaction was committed at the
target database.
467-486
The cumulative total number of rows that were Message Variables
received by the target server.
workload_name
490-506 The name or asterisk (*) as specified on the
A time stamp that represents the point in time at ACTVREPL WORKLOAD command. An asterisk
which all transactions have been applied to the indicates that the WORKLOAD keyword was not
target without gaps that might result from parallel specified or that WORKLOAD=* was specified.
apply.
type
510-529 The data source for which replication server
The average apply latency is the average elapsed workload information is displayed. The following
time in milliseconds between the time that values are valid:
transactions were received by the target server
and the time that transactions were committed to • * (indicates that the TYPE keyword was not
the target data source. This average includes only specified or that TYPE=* was specified)
the transactions that were processed during the • DB2
last sampling interval. • IMS
When the value of Workload Type is DB2, average • VSAM
apply latency is the average elapsed time in
• One or more replication types as specified on the
milliseconds between the time that the Q Apply
ACTVREPL command
program read transactions from the receive queue
and the time that they were committed to the
target. System action
When the value of Workload Type is IMS, average The ACTVREPL SERVER and ACTVREPL WORKLOAD
apply latency is the average elapsed time in command processing is complete.
milliseconds between the time that a transaction
AQN031I DISPLAY OF type CAPTURE
was received by the target server and the time that
WORKLOAD DETAILS FOR
the processing of the transaction was completed
WORKLOAD workload_name
by the database management system (DBMS).

Chapter 2. AQN Prefix Messages 93


Explanation 103-122
The cumulative total number of commit messages
This multiline message is issued in response to the that were received by the source server. The
following commands: number of commits reflects the number of
• ACTVREPL SERVER=* | server_job_name TYPE=type transactions.
VIEW=DETAILS 126-145
Detailed workload information for all workloads on The cumulative total number of insert messages
the specified capture server or servers is displayed. that were sent to the target server.

• ACTVREPL WORKLOAD=* | workload_name TYPE=* | 149-168


type VIEW=DETAILS The cumulative total number of update messages
that were sent to the target server.
Detailed workload information for the specified
172-191
workload or workloads on all IMS or VSAM (or both)
The cumulative total number of delete messages
capture server or servers is displayed.
that were sent to the target server.
It consists of one header line, three label lines, and 195-214
one or more data lines. Each data line provides The cumulative number of rollbacks that were
detailed IMS or VSAM workload information for the processed.
workloads that are running on the specified IMS or
VSAM replication capture server or servers. 218-221
The percentage of the source (capture) cache
Each data line includes the following information: that is in use (queue depth), computed as
Columns (Current® Cache Size/Maximum Cache Size)*100
Description and rounded down to the nearest whole integer. If
the value for this field is blank, look in the NetView
1-20 log for the AQN029I message to see if the value is
The state of the workload as determined by the out of range.
capture server. The following values are valid:
233-252
• DESCRIBE The maximum size of the source (capture) cache in
• ENDING CONTROLLED bytes.
• ENDING IMMEDIATELY 256-272
The current size of the source (capture) cache in
• ERROR
bytes.
• INACTIVE
279-286
• REPLICATE CONTINUOUS The job name of the capture server
• STARTING 290-353
24-31 The name of the workload.
For a Capture Workload State attribute value of Message Variables
ERROR, the error identification is shown as a
hexadecimal code. Otherwise, the value does not type
apply and is set to N/A. For more information The type of the workload. The following values are
about error codes, see the IMS or VSAM replication valid:
documentation. • IMS
37-53 • VSAM
A time stamp that represents when the value
• * (IMS and VSAM)
of the Capture Workload State attribute was last
changed. workload_name
57-76 The name of the workload for which data is
The cumulative total number of bytes that were displayed. If an asterisk (*) is specified for the
received by the source server. workload name, the display is for all IMS or VSAM
(or both) workloads on the specified capture server
80-99 or servers.
The cumulative total number of rows that were
received by the source server.

94 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action 57-76
The cumulative total number of bytes that were
The ACTVREPL SERVER and ACTVREPL WORKLOAD applied.
command processing is complete.
80-99
AQN032I DISPLAY OF type APPLY The cumulative total number of rows that were
WORKLOAD DETAILS FOR applied.
WORKLOAD workload_name 103-122
The cumulative total number of commit messages
Explanation that were applied. The number of commits reflects
the number of transactions.
This multiline message is issued in response to the
following commands: 126-145
The cumulative total number of insert messages
• ACTVREPL SERVER=* | server_job_name TYPE=type that were applied.
VIEW=DETAILS
149-168
Detailed workload information for all workloads on The cumulative total number of update messages
the specified apply server or servers is displayed. that were applied.
• ACTVREPL WORKLOAD=* | workload_name TYPE=* | 172-191
type VIEW=DETAILS The cumulative total number of delete messages
Detailed workload information for the specified that were applied.
workload or workloads on all IMS or VSAM (or both) 195-214
apply server or servers is displayed. The cumulative total number of rollbacks that were
processed.
It consists of one header line, three label lines, and
one or more data lines. Each data line provides 218-221
detailed IMS or VSAM workload information for the The percentage of the target (apply) cache in use
workloads that are running on the specified IMS or (queue depth), computed as (Current Cache Size/
VSAM replication apply server or servers. Maximum Cache Size)*100 and rounded down to
the nearest whole integer. If the value for this field
Each data line includes the following information: is blank, look in the NetView log for the AQN029I
Columns message to see if the value is out of range.
Description 233-252
1-20 The maximum size of the target (apply) cache in
The state of the workload as determined by the bytes.
apply server. The following values are valid: 256-275
• DESCRIBE The current number of bytes that are in use in the
target (apply) cache.
• ENDING CONTROLLED
279-286
• ENDING IMMEDIATELY The job name of the apply server.
• ERROR 290-353
• INACTIVE The name of the workload.
• REPLICATE CONTINUOUS 357-364
• STARTING Apply exits perform special target apply processing
24-31 for subscriptions during replication.
For an Apply Workload State attribute value of IBM-supplied apply exits are named with the
ERROR, the error identification is shown as a product prefix of the related component.
hexadecimal code. Otherwise, the value does not
apply and is set to N/A. For example, the apply exit provided by the z/OS
Integrated Cryptographic Service Facility (ICSF) is
For more information about error codes, see the named CSFMIAAX because the prefix for the ICSF
IMS or VSAM replication documentation. component is CSF.
37-53 For workload type VSAM, the exit name is
A time stamp that represents when the value displayed if one is being used. Otherwise, the value
of the Apply Workload State attribute was last is blank.
changed.

Chapter 2. AQN Prefix Messages 95


For workload type IMS, the value is N/A. 1-20
The state of the workload as determined by the
For workload type *:
capture server. The following values are valid:
• If the workload type is IMS, then the value is
• INACTIVE
N/A.
• REPLICATE CONTINUOUS
• If the workload type is VSAM, the exit name is
displayed if one is being used. Otherwise, the 24-33
value is blank. The number of rows (individual insert, update, or
delete operations) that the Q Capture program put
Message Variables
on this send queue.
type 37-46
The type of the workload. The following values are The number of transactions that the Q Capture
valid: program put on this send queue.
• IMS 52-61
• VSAM The number of messages that were put on the
send queue during the collection interval.
• * (IMS and VSAM)
68-77
workload_name The number of bytes that were put on the send
The name of the workload for which data is queue during the collection interval, including data
displayed. If an asterisk (*) is specified for the from the source table and the message header.
workload name, the display is for all IMS or VSAM
(or both) workloads on the specified apply server 81-104
or servers. The most recent logical log sequence number in
the recovery log that the Q Capture program read
for this send queue.
System action
For DB2 for z/OS Version 10 or earlier, this value
The ACTVREPL SERVER and ACTVREPL WORKLOAD is set to the current log sequence number and, for
command processing is complete. DB2 for z/OS Version 11, it is set to N/A.
AQN033I DISPLAY OF Q REPLICATION DATA 108-131
FOR SEND QUEUE send_queue The logical log sequence number from which the
WORKLOAD workload_name Q Capture program starts putting messages on
this send queue during a warm restart. This value
Explanation represents the earliest log sequence number that
the Q Capture program found that did not have a
This multiline message is issued in response to the commit or abort record.
following commands:
For DB2 for z/OS Version 10 or earlier, this value
• ACTVREPL SENDQ=* | send_queue is set to the restart log sequence number and, for
Send queue information for the specified SENDQ DB2 for z/OS Version 11, it is set to N/A.
name or names and the associated workload or 135-144
workloads is displayed. The number of times that the Q Capture program
• ACTVREPL WORKLOAD=* | workload_name TYPE=* | retried putting messages (MQPUT) on this send
DB2 VIEW=DETAILS queue.
Information for the send queue or queues for the 149-158
specified workload or workloads is displayed. The number of changed rows that were not put
on this send queue because the changes were to
It consists of one header line, three label lines, and columns that are not part of a Q subscription or
one or more data lines, with each data line providing publication. The ALL_CHANGED_ROWS parameter
information about the Q replication send queue or in the IBMDB2_SUBS table was set to the default
queues for one or more workloads. value of No.
Each data line includes the following information: 164-173
Columns The number of delete row operations that were not
Description put on this send queue because the Q subscription
or publication was created with the option to
suppress replication of delete operations.

96 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


178-187 AQN034I DISPLAY OF Q REPLICATION
The number of rows that the Q Capture program DATA FOR RECEIVE QUEUE
did not transmit to this send queue because they receive_queue WORKLOAD
did not meet the search condition that is defined in workload_name
the Q subscription or publication.
191-238 Explanation
The name of the send queue.
This multiline message is issued in response to the
242-305 following commands:
The name of the workload.
• ACTVREPL RCVQ=* | receive_queue
309-372
The name of the consistency group. A consistency Receive queue information for the specified receive
group, which is also known as a queue map, is queue or queues and the associated workload or
a single send queue and receive queue pair. A workloads is displayed.
workload is made up of one or more consistency • ACTVREPL WORKLOAD=* | workload_name TYPE=* |
groups. DB2 VIEW=DETAILS
376-423
Information for the receive queue or queues for the
The name of the WebSphere® MQ queue manager
specified workload or workloads is displayed.
that the Q Capture program works with.
427-490 It consists of one header line, three label lines, and
The most recent logical log sequence number in one or more data lines, with each data line providing
the recovery log that the Q Capture program read information about the Q replication receive queue or
for this send queue. queues for one or more workloads.

For DB2 for z/OS Version 11, this value is set to Each data line includes the following information:
the current log sequence number, and, for DB2 for Columns
z/OS Version 10 or earlier, it is set to N/A. Description
494-557 1-20
The logical log sequence number from which the The state of the workload as determined by the
Q Capture program starts putting messages on apply server. The following value is valid:
this send queue during a warm restart. This value
• INACTIVE
represents the earliest log sequence number that
the Q Capture program found that did not have a • REPLICATE CONTINUOUS
commit or abort record. 24-33
For DB2 for z/OS Version 11, this value is set to the The number of insert, update, and delete
restart log sequence number, and, for DB2 for z/OS operations from this receive queue that the Q
Version 10 or earlier, it is set to N/A. Apply program applied to the target.

561-580 37-46
The number of milliseconds that the Q Capture The number of transactions from this receive
program spent putting messages on this send queue that the Q Apply program committed to the
queue during the collection interval. target.
52-61
Message Variables
The number of transactions that conflicted with
send_queue another transaction, because of either a row
The name of the send queue on the capture server conflict or a referential integrity conflict. In these
for which data is displayed. If workload_name=*, cases, the Q Apply program suspends parallel
all send queues are displayed. processing and applies the row changes within the
workload_name transaction in the order that they were committed
The name of the workload for which data is at the source.
displayed. If workload_name=*, all send queues 67-70
are displayed. The fullness of the queue as a percentage. If the
value for this field is blank, look in the NetView log
for the AQN029I message to see if the value is out
System action
of range.
The ACTVREPL SENDQ and ACTVREPL WORKLOAD
command processing is complete.

Chapter 2. AQN Prefix Messages 97


82-91 292-301
The number of seconds that the Q Apply program The total number of unique index constraints
was unable to build transactions from this receive that were detected, forcing transactions to be
queue because its agents were using all the serialized.
available memory to apply transactions. 307-316
95-104 The number of transactions that are delayed
The number of transactions that exceeded the because of job name dependencies.
memory limit for the receive queue that was set 322-331
in the IBMDB2_RECVQUEUES table. The number of times that the Q Apply program
110-119 had to reapply row changes because of referential
The number of times that the Q Apply program integrity (RI) conflicts when the transactions that
reapplied row changes because of lock timeouts they were part of were executed in parallel.
and deadlocks. 335-344
123-132 The number of times that the Q Apply program
The number of Q Apply agents. tried to reapply rows that were not applied in
136-145 parallel because of unique index constraints.
The number of milliseconds that Q Apply agents 348-357
for this receive queue were idle while waiting for The number of rows that the Q Apply program sent
work. to temporary spill queues while targets were being
149-158 loaded or while Q subscriptions were placed into a
The amount of memory in bytes that the Q Apply spill state by the spillsub parameter of the MODIFY
browser thread used for reading transactions from or asnqacmd command.
this queue. 361-370
162-171 The number of spilled rows that were applied to
The number of messages on the queue. the target.

175-191 376-395
The time stamp at the Q Apply server when the A time stamp that represents the source commit
receive queue was started. time of the oldest currently in-flight transaction.
An in-flight transaction was not fully applied and
195-204 committed at the target.
The number of bytes that were read from this
receive queue. 399-422
The commit log sequence number (LSN) from the
208-217 source recovery log that corresponds to the oldest
The number of transactions that were read from transaction that was applied.
this receive queue.
For DB2 for z/OS Version 10 or earlier, this value is
223-232
set to the oldest commit LSN, and, for DB2 for z/OS
The number of rows that were read from this
Version 11, it is set to N/A.
receive queue.
236-245 426-449
The number of rows that were applied but might An internal log marker that corresponds to the
not yet be committed to the target. oldest transaction that was applied.

249-258 For DB2 for z/OS Version 10 or earlier, this value


The number of rows that were unable to be applied is set to the oldest commit sequence number, and,
and were entered in the IBMDB2_EXCEPTIONS for DB2 for z/OS Version 11, it is set to N/A.
table. 453-462
262-271 The number of row changes that caused an
The total number of replication key constraints SQL error that is defined as acceptable in the
that were detected, forcing transactions to be OKSQLSTATES field of the IBMQREP_TARGETS
serialized. table. The Q Apply program ignores these errors.
277-286 466-475
The total number of referential integrity (RI) The heartbeat latency is the average elapsed
conflicts that were detected, forcing transactions milliseconds between the time that heartbeat
to be serialized. messages were sent by the Q Capture program and

98 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


the time that they were received by the Q Apply For DB2 for z/OS Version 11, this value is set to the
program. oldest commit sequence number, and, for DB2 for
479-526 z/OS Version 10 or earlier, it is set to N/A.
The name of the receive queue. Message Variables
530-593 receive_queue
The name of the workload. The name of the receive queue on the apply server
597-660 for which data is displayed. If workload_name=*,
The name of the consistency group. A consistency all receive queues are displayed.
group, which is also known as a queue map, is workload_name
a single send queue and receive queue pair. A The name of the workload for which data is
workload is made up of one or more consistency displayed. If workload_name=*, all receive queues
groups. are displayed.
664-673
The number of transactions that are currently System action
being processed by the apply server, but have not
yet been applied. The ACTVREPL RCVQ and ACTVREPL WORKLOAD
679-698 commands are complete.
A time stamp that represents the highest source AQN035I DISPLAY OF Q
transaction commit time of the transactions that REPLICATION CAPTURE SERVER
have been read for all consistency groups for this server_job_name DATA ON SITE
workload. server_site
702-721
A time stamp that represents the highest Explanation
common source transaction commit time across
all transactions that have been read for all This multiline message is issued in response to the
consistency groups for this workload. following command:
725-744 • ACTVREPL SERVER=server_job_name TYPE=DB2
A time stamp that represents the next stop point VIEW=DETAILS
for this consistency group. Only transactions with a
Capture server information for the specified server is
source transaction commit time up to the value of
displayed.
this time stamp are applied. Transactions are not
applied if the source transaction commit time is It consists of one header line, three label lines, and
later than the value of this time stamp. one or more data lines, with each data line providing
748-779 information about a Q Replication capture server.
The synchronization state of the consistency Each data line includes the following information:
group. The following values are valid:
Columns
• ACTIVE Description
• INACTIVE 1-8
The status of the NetView connection to the
783-830
capture server. The following values are valid:
The name of the WebSphere MQ queue manager
that the Q Apply program uses. • ACTIVE
834-897 • INACTIVE
The commit log sequence number (LSN) from the
12-19
source recovery log that corresponds to the oldest
The DB2 subsystem or the DB2 group attach name.
transaction that was applied.
23-32
For DB2 for z/OS Version 11, this value is set to the The number of rows (individual insert, update, or
oldest commit LSN, and, for DB2 for z/OS Version delete operations) that the Q Capture program
10 or earlier, it is set to N/A. read from the log.
901-964 36-45
An internal log marker that corresponds to the The number of transactions that the Q Capture
oldest transaction that was applied. program processed.

Chapter 2. AQN Prefix Messages 99


51-74 changes to capture or because the Q Capture
The most recent logical log sequence number in program is operating at its memory limit.
the recovery log that the Q Capture program read. 267-330
For DB2 for z/OS Version 10 or earlier, this value The most recent logical log sequence number in
is set to the current log sequence number, and, for the recovery log that the Q Capture program read.
DB2 for z/OS Version 11, it is set to N/A. For DB2 for z/OS Version 11, this value is set to
78-101 the current log sequence number, and, for DB2 for
The logical log sequence number in the recovery z/OS Version 10 or earlier, it is set to N/A.
log at which the Q Capture program starts during 334-397
a warm restart. This value represents the earliest The logical log sequence number in the recovery
log sequence number that the Q Capture program log at which the Q Capture program starts during
found that did not have a commit or abort record. a warm restart. This value represents the earliest
For DB2 for z/OS Version 10 or earlier, this value log sequence number that the Q Capture program
is set to the restart log sequence number, and, for found that did not have a commit or abort record.
DB2 for z/OS Version 11, it is set to N/A. For DB2 for z/OS Version 11, this value is set to the
105-121 restart log sequence number, and, for DB2 for z/OS
The time stamp at the Q Capture server of the Version 10 or earlier, it is set to N/A.
latest database commit that was seen by the Q 401-420
Capture log reader. The number of times that the Q Capture program
125-134 issued warning messages after encountering
The number of transactions (containing changed transactions that are larger than the threshold that
rows) that were not put on queues because is set by the Q Capture warntxsz parameter.
the changes were to columns that are not 424-443
part of a Q subscription or publication, for The number of times that the Q Capture program
example, the ALL_CHANGED_ROWS parameter in waited for the DB2 for z/OS instrumentation
the IBMDB2_SUBS table was set to NO. facility interface (IFI) to return log records than
140-149 the threshold set by the Q Capture warnlogapi
The number of transactions that the Q Capture parameter.
program spilled to a file after exceeding the 447-456
MEMORY_LIMIT threshold. The number of consecutive calls to the DB2
155-164 for z/OS instrumentation facility interface (IFI)
The memory that the Q Capture program used to that return reason code 0x00E60813 without any
construct transactions from the log. increase in the end-of-scope log position. A non-
169-178 zero value can indicate an issue with replication of
The largest transaction, in bytes, that the Q DB2 logs when running in DB2 proxy remote log
Capture program processed. read mode.

188-204 470-479
The time stamp at the Q Capture control server The number of times that the Q Capture program
when the Q Capture program reached the end of tried to read the log, and the DB2 for z/OS
the log. instrumentation facility interface (IFI) failed with
a bad return code.
208-224
The number of milliseconds that the Q Capture 484-503
program spent using the DB2 log read application The number of milliseconds that the Q Capture
programming interface (API) to retrieve log records program spent committing messages on all send
queues monitoring during the collection interval.
228-237
The number of log read API calls that the Q Message Variables
Capture program made. server_job_name
241-250 The specified capture server job name.
The number of times that the Q Capture program server_site
reached the end of the log. The site (sysplex) on which the server is running.
254-263
The number of seconds that the Q Capture
log reader thread slept because there were no

100 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The ACTVREPL SERVER command processing is This message can be issued in response to the
complete. ACTVCTL TAKEOVER command or the ACTVREPL
command.
AQN036I DISPLAY OF Q REPLICATION
APPLY SERVER server_job_name For the ACTVCTL TAKEOVER command, the NetView
DATA ON SITE server_site program on which the command is issued is not
participating in an XCF group.
Explanation For the ACTVREPL command, the target domain on the
production system is not participating in an XCF group
This multiline message is issued in response to the
or it is not part of the purview for this Active/Active
following command:
enterprise master.
• ACTVREPL SERVER=server_job_name TYPE=DB2
Participating in an XCF group is a prerequisite for the
VIEW=DETAILS
GDPS Continuous Availability solution.
Apply server information for the specified server is
Message Variables
displayed.
domain
It consists of one header line, three label lines, and
The NetView domain
one or more data lines, with each data line providing
information about a Q Replication apply server.
Operator response
Each data line includes the following information:
Notify the system programmer.
Columns
Description
1-8
System programmer response
The status of the NetView connection to the apply Verify that the XCF.RANK statement in the CNMSTYLE
server. The following values are valid: member is not set to -1 for the specified NetView
• ACTIVE domain. If it is -1, set an appropriate XCF rank so
that the specified NetView domain can participate in
• INACTIVE an XCF group.
12-19 If the command that is issued is ACTVREPL, verify that
The DB2 subsystem or the DB2 group attach name. the specified domain is in a sysplex targeted by an
23-39 ENT.SYSTEMS.name CNMSTYLE member statement.
A time stamp that represents when the Q Apply
AQN038I DOMAIN NOT FOUND FOR
task was started.
server_type SITE sysplex SYSTEM
43-52 system
The total count of active subscriptions across all
active queues.
Explanation
Message Variables
This message is issued as a response to the ACTVREPL
server_job_name command when the CAPSITE or APPSITE and CAPSYS
The specified apply server job name. or APPSYS keywords are specified.
server_site The Active/Active enterprise master NetView does not
The site (sysplex) on which the server is running. have the specified NetView domain for the specified
site and system in its XCF group.
System action Message Variables
The ACTVREPL SERVER command processing is server_type
complete. The requested server type, capture or apply, for
AQN037I DOMAIN domain IS NOT the site and system.
PARTICIPATING IN AN XCF sysplex
GROUP The sysplex name.
system
The z/OS image name.

Chapter 2. AQN Prefix Messages 101


Operator response • Number of replication capture and apply socket path
names defined on the production system.
Verify that the correct site and system names were
entered on the command. • Replication capture and apply socket path names
defined on the production system.

System programmer response These variables are derived from information sent
from the production system for the following
Verify that the ENT.SYSTEMS.name CNMSTYLE situations:
statements are configured properly.
• Activation of a replication autotask.
AQN039I TOWER
• Establishment of an enterprise master NetView
ACTIVEACTIVE.REPLICATION.subt
program.
wr NOT ENABLED FOR DOMAIN
domain • Issuance of the RESTYLE ACTACT command.
Note:
Explanation 1. The AQN001I message is issued if no paths are
An ACTVREPL command was issued, and the specified found for the specified domain.
replication subtower is not enabled for the specified 2. The AQN041I message is issued if the socket path
domain. The subtower corresponds to the TYPE definition is not sequential.
keyword on the ACTVREPL command.
3. The AQN006I message is issued if the socket path
Message Variables definition is a duplicate.
subtwr 4. See automation sample member AQNSACTA
The replication subtower for the ACTIVEACTIVE for more information about messages used to
tower: send replication information from the production
systems to the controller system.
• DB2
Message Variables
• IMS
• VSAM variable
The common global variable name
domain
domain
The NetView domain
The NetView domain

Operator response System action


Verify that the appropriate values are specified on the
The command fails.
command, and reissue it.

Operator response
System programmer response
Verify the following:
Verify that the replication subtower is enabled for the
specified domain. If it is not enabled, uncomment • That the correct destination information was
the subtower name in the user-defined CNMSTGEN specified on the ACTVREPL command.
or CNMSTUSR member, and then recycle the NetView • That the specified domain is in the LIST
program. STATUS=XCFGRPS command output.
AQN040I COMMON GLOBAL VARIABLE • That there are no messages in the NetView log for
variable IS NOT DEFINED FOR the specified domain that indicate that there are
DOMAIN domain problems with the socket path definition statements.

Explanation System programmer response


The ACTVREPL command could not find the specified Verify the configuration on the production system with
common global variable for the specified NetView the specified domain:
domain. The variables represent:
• Enable the replication subtower, if necessary, and
• Status of the replication subtower on the production recycle NetView.
system.

102 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• Configure or change socket path names for the controller system, the cumulative total of each server
replication subtower, if necessary, and issue the type for the data source is over 50.
RESTYLE ACTACT command.
Message Variables
Verify that automation for ACTVREPL (sample
subtower_name
automation member AQNSACTA) is enabled on both
For the ACTIVEACTIVE tower:
production systems and controller systems.
• DB2
AQN041I SOCKET PATH DEFINITION
statement IS NOT SEQUENTIAL • IMS
• VSAM
Explanation server_type
The path number for an ACTACT socket path definition The server type, capture or apply, on the socket
statement is not sequential. Socket path name path definition.
information is not forwarded to the enterprise master
NetView program. The CNMSTYLE member statements System programmer response
are:
Verify that the socket path definitions are correct on
• ACTACT.DB2PATH.CAPx the production systems. Make any necessary changes,
• ACTACT.DB2PATH.APPx and issue the RESTYLE ACTACT command.
• ACTACT.IMSPATH.CAPx If more path definitions are required for your
environment, contact IBM Software Support.
• ACTACT.IMSPATH.APPx
• ACTACT.VSAMPATH.CAPx AQN043I AQN043I NO subtower_name
server_type SOCKET PATH
• ACTACT.VSAMPATH.APPx
INFORMATION FORWARDED TO
The value for x must start with 1 and increase CONTROLLER, REASON 'reason'
sequentially up to a maximum of 50 for each of these
statements. If a non-sequential definition is found, Explanation
no socket path name information for the particular
data source and server type is forwarded to the The specified socket path definition is not configured
controller system. The ACTVREPL command fails if correctly for one of the following reasons:
the destination is for this particular set of socket path DUPLICATE PATH NAME
definitions. The same socket path name was specified
Message Variables more than once on different CNMSTYLE member
statements.
statement
The CNMSTYLE statement that is not sequential INVALID PATH NAME
The socket path name did not start with a leading
forward slash (/).
System programmer response
If an incorrect definition is found, no socket path
Correct the CNMSTYLE member statements and issue information for the specified subtower and replication
the RESTYLE ACTACT command. server type is forwarded to the controller system. The
AQN042I MAXIMUM NUMBER OF ACTVREPL command fails if the destination is for this
subtower_name server_type particular set of socket path definitions.
SOCKET PATH DEFINITIONS The CNMSTYLE member statements are:
EXCEEDED
• ACTACT.DB2PATH.CAPx

Explanation • ACTACT.DB2PATH.APPx
• ACTACT.IMSPATH.CAPx
More than 50 socket path definitions were defined
for Q replication capture servers, Q replication apply • ACTACT.IMSPATH.APPx
servers, IMS replication capture servers, or IMS Message Variables
replication apply servers.
subtower_name
This message can be issued on the production system For the ACTIVEACTIVE tower:
or on the controller system. If it is issued on the
• DB2

Chapter 2. AQN Prefix Messages 103


• IMS missing, the following order is used to determine
• VSAM the attribute name that is specified in the AQN044I
message:
server_type
APPLY or CAPTURE • The first major attribute that is found to be
missing. A major attribute is required by the
reason Lifeline Advisor for routing.
One of the following reasons, including the socket
path name in error: • The first minor attribute that is found to be
missing. A minor attribute is not required by the
• DUPLICATE PATH NAME Lifeline Advisor for routing.
• INVALID PATH NAME 2. EIF event information is sent to the Lifeline Advisor
for Active/Query workloads.
System action 3. EIF event information is sent to the GDPS
Continuous Availability component for both Active/
No production system path configuration information
Standby and Active/Query workloads.
is forwarded to the controller system for the specified
data source (DB2, IMS, or VSAM) and function (APPLY For more information, see the help for the AQN047I
or CAPTURE). message.
Message Variables
System programmer response
attribute_name
Verify that the socket path definitions are correct on The attribute name specified in the EIF event.
the production systems. Make any necessary changes,
and issue the RESTYLE ACTACT command. The following example represents an attribute-
value pair in an EIF event:
AQN044I ATTRIBUTE attribute_name IS
MISSING FOR data_source workload_name=TELNET23Q;
REPLICATION EVENT class_name
data_source
The value specified in the data_source attribute in
Explanation the EIF event:
This message is written to the NetView log when • DB2
a required attribute in an Event Integration Facility
• IMS
(EIF) event that is sent by a replication product is
not present in the alert. The alert is generated by • VSAM
the NetView Event/Automation Facility (E/AS) Event • unknown_data_source
Receiver.
The unknown_data_source value is specified
If the missing attribute is one that impacts the routing by the NetView program when the data_source
of workloads by the GDPS Continuous Availability attribute is missing or processing of the alert
solution, the AQN047I message is also issued ends before the data source is known.
indicating that no information is forwarded. This
means that event information is not sent to the class_name
Lifeline Advisor component of the Multi-site Workload The EIF event class name.
Lifeline product or to the GDPS Continuous Availability
component. System action
The attribute might be missing for one of the following If the AQN047I message is issued with the AQN044I
reasons: message, processing stops. If the AQN044I message
• The specified replication product did not send the is issued by itself, the EIF event information is
attribute in the EIF event. forwarded to the Lifeline Advisor and the GDPS
Continuous Availability component.
• The NetView E/AS Event Receiver Class Definition
Statement (CDS) member for the GDPS Continuous
Availability solution was modified. Operator response
Notes: Look for the AQN047I message in the NetView log.
Contact your system programmer with all messages
1. The AQN044I message is issued one time for the and the NPDA alert information for this event.
specified event. If more than one attribute value is

104 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response 2. EIF event information is sent to the Lifeline Advisor
for Active/Query workloads.
Verify that the E/AS Event Receiver CDS member (or
an included member) was not modified to prevent 3. EIF event information is sent to GDPS Continuous
this attribute from being generated in the NPDA Availability component for both Active/Standby and
alert. If it was modified, correct the statements. Active/Query workloads.
Otherwise, contact IBM Software Support for the For more information, see the help for the AQN047I
specified replication product. message.
AQN045I INVALID VALUE RECEIVED Message Variables
FOR data_source REPLICATION
data_source
EVENT class_name, ATTRIBUTE
The value that is specified in the data_source
attribute_name
attribute in the EIF event:

Explanation • DB2
• IMS
This message is written to the NetView log when the
value for a required attribute in an Event Integration • VSAM
Facility (EIF) event that is sent by a replication product • unknown_data_source
is invalid in the alert. The alert is generated by
the NetView Event/Automation Facility (E/AS) Event The unknown_data_source value is specified
Receiver. by the NetView program when the data_source
attribute is missing or processing of the alert
If the attribute is one that impacts the routing ends before the data source is known.
of workloads by the GDPS Continuous Availability
solution, the AQN047I message is also issued class_name
indicating that no information is forwarded. This The EIF event class name.
means that event information is not sent to the attribute_name
Lifeline Advisor component of the Multi-site Workload The attribute name specified in the EIF event.
Lifeline product or to the GDPS Continuous Availability
The following example represents an attribute-
component.
value pair in an EIF event:
The attribute might be invalid for one of the following
workload_name=TELNET23Q;
reasons:
• The specified replication product did not send the
correct attribute value in the EIF event. System action
• The NetView E/AS Event Receiver Class Definition If the AQN047I message is issued with the AQN045I
Statement (CDS) member for the GDPS Continuous message, processing stops. If the AQN045I message
Availability solution was modified. is issued by itself, the EIF event information is
• The length of the attribute value might be incorrect. forwarded to the Lifeline Advisor and the GDPS
Continuous Availability component.
• The attribute value was an unexpected value.
• The attribute value did not end with a semicolon (;).
Operator response
• The attribute value was not present.
Look for the AQN047I message in the NetView log.
Notes: Contact your system programmer with all messages
1. The AQN045I message is issued one time for the and the NPDA alert information for this event.
specified event. If more than one attribute value
is invalid, the following order is used to determine System programmer response
the attribute name that is specified in the AQN045I
message: Verify that the E/AS Event Receiver CDS member (or
an included member) was not modified to prevent this
• The first major attribute that is found to be attribute value from being generated correctly in the
invalid. A major attribute is required by the NPDA alert.
Lifeline Advisor for routing.
If the CDS member was modified, correct the
• The first minor attribute that is found to be statements. Otherwise contact IBM Software Support
invalid. A minor attribute is not required by the for the specified replication product.
Lifeline Advisor for routing.

Chapter 2. AQN Prefix Messages 105


AQN046I REPLICATION EVENT class_name System programmer response
IS NOT RECOGNIZED
Verify that the E/AS Event Receiver CDS member (or
an included member) was not modified to change the
Explanation event name that is generated in the NPDA alert.
This message is written to the NetView log when If the CDS member was modified, correct the
the class name in an alert is not recognized in an statements. Otherwise contact IBM Software Support
Event Integration Facility (EIF) event that is sent for the specified replication product.
by a replication product. The alert is generated by
the NetView Event/Automation Facility (E/AS) Event AQN047I data_source REPLICATION EVENT
Receiver. class_name NOT FORWARDED.
RETURN CODE: return_code
The event class name might not be recognized for one
of the following reasons:
Explanation
• The replication product did not send the correct
class name in the EIF event. This message is issued when the NetView program
does not forward information about an Event
• The NetView E/AS Event Receiver Class Definition Integration Facility (EIF) event to the Lifeline Advisor
Statement (CDS) member was modified. component of the Multi-site Workload Lifeline product
An AQN047I message is also issued because no or the GDPS Continuous Availability component.
information for this event is forwarded to the Lifeline See the return code to determine the reason why
Advisor component of the Multi-site Workload Lifeline information was not forwarded.
product or to the GDPS Continuous Availability
component. Message Variables
The replication EIF event class names for the GDPS data_source
Continuous Availability solution are as follows: The value that is specified in the data_source
attribute in the EIF event:
• AA_replication_reset_average_latency_me
t • DB2
• AA_replication_constrained_average_late • IMS
ncy_exceeded • VSAM
• AA_replication_critical_average_latency • unknown_data_source
_exceeded
The unknown_data_source value is specified
• AA_replication_max_average_latency_exce by the NetView program when the data_source
eded attribute is missing or processing of the alert
• AA_replication_discrete_latency_exceede ends before the data source is known.
d AA_replication_heartbeat
class_name
• AA_replication_workload_down The EIF event class name.
AA_replication_workload_up
return_code
For more information, see the help for the AQN047I The return code has one of the following values:
message.
8
Message Variables An attribute value for a major attribute is
invalid.
class_name
The EIF event class name. 12
A major attribute is missing. The major
attributes are as follows:
System action
• sysplex_name
Processing stops.
• workload_name

Operator response • consistency_group_name


• consistency_group_total
Contact your system programmer with the information
in the NPDA alert that matches this event class name. • latency_state with one of the following
values:

106 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


– Normal source. If all current maintenance is applied, contact
– Constrained IBM Software Support.

– Critical AQN049I DISPLAY OF REPLICATION


WORKLOADS
– Acute
16
Explanation
EIF event class name is not supported by the
GDPS Continuous Availability solution. This multiline message is issued in response to the
20 following command:
Information is not forwarded to the Lifeline • ACTVREPL WORKLOAD=* | workload_name
Advisor because it is not active in primary role. VIEW=SUMMARY
Because the information is not forwarded to
the Lifeline Advisor, it is also not forwarded to Summary information for the specified replication
the GDPS Continuous Availability component. workload or workloads is displayed.

AQN048I data_source REPLICATION EVENT It consists of one header line, three label lines, and
VERSION replication_version DOES one or more data lines, with each data line providing
NOT MATCH NETVIEW EVENT information about a replication workload.
VERSION netview_version Each data line includes the following information:
Columns
Explanation Description
This message is issued when a replication Event 1-64
Integration Facility (EIF) event is sent with a version The name of the workload. A workload is made up
attribute value that does not match the version that of one or more consistency groups.
the NetView program supports. There is a function 68-75
mismatch, and results are unpredictable. The name of the capture site.
This message is issued only once for each data source 80-87
for the current instance of the NetView program. If The name of the apply site.
other problems are found with the EIF event that is 92-96
sent by the replication product, this message is not The number of consistency groups that make up
issued. the workload as defined by the replication product.
Message Variables 113-117
data_source The number of consistency groups for a workload
The value specified in the data source attribute in for which the NetView program has data, which is
the EIF event: to be used for aggregation.
134-143
• DB2
The highest average latency of all of the
• IMS consistency groups for this workload.
• VSAM Average latency is the average elapsed time in
replication_version milliseconds between the time that transactions
The value for the version attribute sent in the EIF were committed to the source table or database
event for the specified data source and the time that transactions were committed to
the target table or database. This average includes
netview_version
only the transactions that were processed during
The value that the NetView program currently
the last polling interval.
supports
147-156
Operator response The number of transactions that are currently
being processed by the apply server but have not
Contact your system programmer. yet been applied.
162-181
System programmer response A time stamp that represents the highest source
transaction commit time of the transactions that
Apply maintenance for the NetView program or the
replication product that is identified by the data

Chapter 2. AQN Prefix Messages 107


have been read for all consistency groups for this any older than 2 seconds in relation to the source
workload. database for this workload.
185-204 401-416
A time stamp that represents the highest An indication of the amount of replication
common source transaction commit time across information that has been received for a workload,
all transactions that have been read for all as determined by the NetView program that is
consistency groups for this workload. running on the controller system. The following
208-239 values are valid:
The state of the replication workload as • SATISFACTORY: All capture and apply data has
determined by the state of all of the capture been received for the workload and is being used
and apply servers for the workload. If the state for aggregation.
of any of the capture and apply servers for
• UNSATISFACTORY: Incomplete capture or apply
the workload is INACTIVE, then the value of
data has been received for the workload.
Replication Workload State is INACTIVE.
Data has been aggregated using the available
The following values are valid: replication data, but the missing data might lead
to inaccurate results.
• INACTIVE
• REPLICATE CONTINUOUS 420-435
An explanation for the aggregation status value,
243-262 as determined by the NetView program that is
The aggregate of the cumulative total number of running on the controller systems. The following
bytes that were sent to the target server for all of values are valid:
the consistency groups for this workload.
• COMPLETE DATA: All capture and apply data has
266-285 been received for the workload.
The aggregate of the cumulative total number of
transactions that were sent to the target server for • PARTIAL DATA: Not all of the capture and apply
all of the consistency groups for this workload. data is received for the workload.

289-308 • STALE DATA: All of the capture and apply data for
The aggregate of the cumulative total number of the workload is not received within a calculated
rows that were sent to the target server for all of window, which is based on the sampling interval
the consistency groups for this workload. as defined on the production system. The
window value is the sampling interval plus the
312-331 value of the ACTACT.MASTER.DELAY CNMSTYLE
The aggregate of the cumulative total number of statement, which defaults to 3 seconds. For
bytes that were received by the target server for all information about the ACTACT.MASTER.DELAY
of the consistency groups for this workload. statement, see the IBM Z NetView Administration
335-354 Reference.
The aggregate of the cumulative total number
439-446
of transactions that were received by the target
The name of the source site. The source site is
server for all of the consistency groups for this
where the database or file system logs that are
workload.
used by replication are written.
358-377
The aggregate of the cumulative total number of When a proxy database or file system configuration
rows that were received by the target server for all reads the source site logs from mirrored disks,
of the consistency groups for this workload. and the data is then replicated using software
replication, the source site and capture site are
381-397 different.
A time stamp that represents the point in time
at which all transactions have been applied to When the source site and capture site are the
the target without gaps that might result from same, the value of this attribute is N/A.
parallel apply, across all consistency groups in 451-470
the workload. The time stamp comes from the The highest average transaction response time of
source DBMS log and is expressed in GMT. This all of the consistency groups for this workload.
time stamp provides the age of the oldest data
for the workload. For example, if the current GMT The average elapsed milliseconds between the
time is 5:00:01.10 and point-in-time consistency is time that the first change for the replicated
5:00:01.08, then no data on the target database is transaction was issued at the target database and

108 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


the time that the transaction was committed at the 78-101
target database. The logical log sequence number in the recovery
log at which the Q Capture program starts during
474-493
a warm restart. This value represents the earliest
The highest average transaction dependency delay
log sequence number that the Q Capture program
time of all of the consistency groups for this
found that did not have a commit or abort record.
workload.
For DB2 for z/OS Version 10 or earlier, this value
The average time, in milliseconds, that
is set to the restart log sequence number, and, for
transactions waited to be applied because of
DB2 for z/OS Version 11, it is set to N/A.
dependencies with other transactions.
105-121
System action The time stamp at the Q Capture server of the
latest database commit that was seen by the Q
The ACTVREPL SERVER and ACTVREPL WORKLOAD Capture log reader.
command processing is complete. 125-134
AQN050I DISPLAY OF Q REPLICATION The number of transactions (containing changed
CAPTURE SERVERS DATA rows) that were not put on queues because
the changes were to columns that are not
part of a Q subscription or publication, for
Explanation example, the ALL_CHANGED_ROWS parameter in
This multiline message is issued in response to the the IBMDB2_SUBS table was set to NO.
following command: 140-149
• ACTVREPL SERVER=* TYPE=DB2 VIEW=DETAILS The number of transactions that the Q Capture
program spilled to a file after exceeding the
Capture server information for one or more Q MEMORY_LIMIT threshold.
Replication servers is displayed.
155-164
It consists of one header line, three label lines, and The memory that the Q Capture program used to
one or more data lines, with each data line providing construct transactions from the log.
information about a Q Replication capture server. 169-178
Each data line includes the following information: The largest transaction, in bytes, that the Q
Capture program processed.
Columns
Description 188-204
The time stamp at the Q Capture control server
1-8
when the Q Capture program reached the end of
The status of the NetView connection to the
the log.
capture server. The following values are valid:
208-224
• ACTIVE The number of milliseconds that the Q Capture
• INACTIVE program spent using the DB2 log read application
programming interface (API) to retrieve log records
12-19
The DB2 subsystem or the DB2 group attach name. 228-237
The number of log read API calls that the Q
23-32
Capture program made.
The number of rows (individual insert, update, or
delete operations) that the Q Capture program 241-250
read from the log. The number of times that the Q Capture program
reached the end of the log.
36-45
The number of transactions that the Q Capture 254-263
program processed. The number of seconds that the Q Capture
log reader thread slept because there were no
51-74
changes to capture or because the Q Capture
The most recent logical log sequence number in
program is operating at its memory limit.
the recovery log that the Q Capture program read.
267-274
For DB2 for z/OS Version 10 or earlier, this value The job name of the capture server.
is set to the current log sequence number, and, for
DB2 for z/OS Version 11, it is set to N/A. 281-288
The name of the capture site.

Chapter 2. AQN Prefix Messages 109


293-356 Explanation
The most recent logical log sequence number in
the recovery log that the Q Capture program read. This multiline message is issued in response to the
following command:
For DB2 for z/OS Version 11, this value is set to
the current log sequence number, and, for DB2 for • ACTVREPL SERVER=* TYPE=DB2 VIEW=DETAILS
z/OS Version 10 or earlier, it is set to N/A. Apply server information for one or more Q
360-423 Replication servers is displayed.
The logical log sequence number in the recovery It consists of one header line, three label lines, and
log at which the Q Capture program starts during one or more data lines, with each data line providing
a warm restart. This value represents the earliest information about a Q Replication apply server.
log sequence number that the Q Capture program
found that did not have a commit or abort record. Each data line includes the following information:

For DB2 for z/OS Version 11, this value is set to the Columns
restart log sequence number, and, for DB2 for z/OS Description
Version 10 or earlier, it is set to N/A. 1-8
The status of the NetView connection to the apply
427-446
server. The following values are valid:
The number of times that the Q Capture program
issued warning messages after encountering • ACTIVE
transactions that are larger than the threshold that • INACTIVE
is set by the Q Capture warntxsz parameter.
12-19
450-469
The DB2 subsystem or the DB2 group attach name.
The number of times that the Q Capture program
waited for the DB2 for z/OS instrumentation 23-39
facility interface (IFI) to return log records than A time stamp that represents when the Q Apply
the threshold set by the Q Capture warnlogapi task was started.
parameter. 43-52
473-482 The total count of active subscriptions across all
The number of consecutive calls to the DB2 active queues.
for z/OS instrumentation facility interface (IFI) 59-66
that return reason code 0x00E60813 without any The job name of the apply server.
increase in the end-of-scope log position. A non-
73-80
zero value can indicate an issue with replication of
The name of the apply site.
DB2 logs when running in DB2 proxy remote log
read mode.
496-505
System action
The number of times that the Q Capture program The ACTVREPL SERVER command processing is
tried to read the log, and the DB2 for z/OS complete.
instrumentation facility interface (IFI) failed with
a bad return code. AQN052I ENT.SYN.prisec.site.domain FOR
DOMAIN domain_id SPECIFIES
510-529 SNA
The number of milliseconds that the Q Capture
program spent committing messages on all send
queues monitoring during the collection interval. Explanation
This message is issued during ACTVCTL CONNECT
System action processing when the RMTSYN value that is specified
on an ENT.SYN statement specifies to use SNA
The ACTVREPL SERVER command processing is RMTCMD communications.
complete.
Message Variables
AQN051I DISPLAY OF Q REPLICATION
APPLY SERVERS DATA prisec
Specifies the primary or secondary ENT.SYN
statement:

110 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


ENT.SYN.PRI.site.domain – The NetView program is not an enterprise
Primary IP addresses for the NetView master NetView program.
domain. .site.domain identifies the domain and – No production systems had communicated
the site in which it resides. information to the controller system when the
ENT.SYN.SEC.site.domain command was issued, which can be caused by
Secondary IP addresses for the NetView the following circumstances:
domain. .site.domain identifies the domain and
- The NetView program or one or more of the
the site in which it resides.
replication products are not initialized on
domain_id any production system.
Specifies the remote NetView domain. - Communication between the NetView
program on the controller system and all
System action production systems has failed.
Processing continues, but the ENT.SYN statement is • No replication information is available from
ignored and a RMTALIAS statement is not generated. production system NetView domains
This might cause connectivity problems to systems The NetView program that is running on
that are specified on ENT.SYSTEMS statements that the controller system does not have any
use the RMTALIAS statement. replication configuration information from any
production system NetView program. The
Operator response replication configuration information is required
to collect information for the ACTVREPL
Contact the system programmer responsible for command. This situation can occur when
adding ENT.SYN CNMSTYLE statements. the NetView program that is running on the
controller system previously had information
System programmer response from production system NetView domains, but
all of the production system NetView programs
Update the ENT.SYN statement to use an IP address. are currently inactive.
The ACTVCTL CONNECT command supports only IP
addressing. • No replication subtowers are enabled

AQN053I command FAILED. Reason: reason. The NetView program on the controller system
Reason Code: reason_code has information about production systems, but
no replication subtowers are enabled on the
production systems.
Explanation
• No socket path definitions are defined
This message is issued when a NetView command
for the GDPS Continuous Availability solution fails. The NetView program on the controller system
The reason and reason code provide more information has information about production systems and
about why the command failed. replication subtowers are enabled, but no socket
paths definitions are defined.
Message Variables
reason_code
command
The following reason codes are valid:
The command that failed, namely, the ACTVREPL
command, which is issued from a GDPS 16
Continuous Availability solution controller system. Replication server information is not available.
The ACTVREPL command uses stored socket path 12
name information to identify the GDPS Continuous No replication information is available from
Availability solution production systems from production system NetView domains.
which to retrieve replication information.
10
reason No replication subtowers are enabled.
The possible reasons for the command failure are
as follows: 8
No socket path definitions are defined.
• Replication server information is not available
System action:
No replication information for any production Processing stops.
system is available (or was previously available)
to the NetView program on the controller system,
which can occur for the following reasons:

Chapter 2. AQN Prefix Messages 111


Operator response Operator response:
If the reason is either that replication server Notify the system programmer.
information is not available or that no replication System programmer response:
information is available from production system Add the required ENT.ALT.CONTROLLER CNMSTYLE
NetView domains, verify the following items: statement.
• The NetView program on which the command is AQN055D tower_name tower not enabled.
issued is the enterprise master NetView program. Required software not installed.
• The NetView programs in the production system
domains are active and successfully communicating Explanation
with the enterprise master NetView program.
The specified tower is not enabled because additional
• The production system NetView log contains no software must be installed to provide the function that
errors that are related to replication configuration. is represented by the tower.
Note: Message Variables
1. On the controller system, issue the LIST tower_name
STATUS=XCFGRPS command to determine whether The tower name that is specified on the
the NetView program is the enterprise master CNMSTYLE TOWER statement or the MODIFY
NetView program. TOWER statement:
2. On the production systems, issue the RMTCMD • ACTIVEACTIVE
QUERY LCLAUTOS command. In the command
• AMI
output, look in the RMTCMD AUTOTASK column
for an entry with the name of the autotask • AON
that is defined by the function.autotask.ACTDATA • DISCOVERY
statement; AUTOADAT is the default name for this
• DVIPA
autotask.
• GRAPHICS
Otherwise, contact the system programmer.
• IPMGT
System programmer response • NLDM
Verify the replication configuration on the production • NPDA
systems: • TCPIPCOLLECT
• Appropriate towers and subtowers are enabled. • TEMA
• Socket paths are defined for enabled replication
subtowers. System action
Verify the network connectivity between the enterprise NetView initialization continues, but the tower is not
master NetView program and the NetView programs enabled. Any conditional includes or REXX TOWER
on the production systems. functions that check for the specified tower fail.
Review the ENT.SYSTEMS.name statements in the For the ACTIVEACTIVE tower, no GDPS Continuous
CNMSTYLE member to ensure that the enterprise Availability solution functions are enabled on this
master NetView program is contacting all the NetView program. This includes IBM Z NetView, IBM
necessary production systems. Z System Automation, and GDPS component functions
AQN054I REQUIRED that are dependent on the NetView ACTIVEACTIVE
ENT.ALT.CONTROLLERS tower.
STATEMENT MISSING Towers of the IBM Z NetView product, when specified
Explanation: in the following products, cause this message to be
During processing of ENT.SYN statements as a result issued:
of ACTVCTL CONNECT or RESTYLE ENT commands, • IBM Automation Control for z/OS
no ENT.ALT.CONTROLLER statement was found for an
• IBM Tivoli System Automation for GDPS/PPRC
ACTIVEACTIVE enterprise master.
HyperSwap® Manager with NetView
System action:
Operator response:
ENT.SYN statement processing ends. No RMTALIAS
Notify the system programmer.
statements are generated from ENT.SYN statements.

112 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response the sysplex as it is known to the z/OS operating
Install required software or remove the TOWER or system.
MODIFY.TOWER statement from your CNMSTYLE user 105-112
member. The state of the server application. The following
Z NetView must be installed for functional support for values are valid:
all of the listed towers. • ACTIVE
Z NetView for Continuous Availability is also required • INACTIVE
when specifying the ACTIVEACTIVE tower in order
to have GDPS Continuous Availability solution 116-117
functionally. The net weight for this server application relative
to other server instances that are defined for
AQN056I DISPLAY OF Linux on z Systems this workload on the same site. This value is
WORKLOAD SERVERS FOR determined by assigning a 1 for active server
WORKLOAD NAME workload_name instances and a 0 for inactive server instances.
Message Variables
Explanation
workload_name
This multiline message is issued in response to the The name of the workload as specified for the
ACTVLIFE SERVERS command. It consists of one WORKLOAD keyword. A value of * indicates that
header line, three label lines, and one or more data the WORKLOAD keyword is not specified or that
lines, with each data line providing information about a WORKLOAD=* is specified.
workload server.
Each data line includes the following information: System action
Columns The ACTVLIFE SERVERS command processing is
Description complete.
1-45 AQN057I DISPLAY OF SNA WORKLOAD
The IPv4 or IPv6 address of a server application SERVERS FOR WORKLOAD NAME
that is defined for the workload. workload_name
49-53
The number of the port on which the server
Explanation
application listens.
57-64 This multiline message is issued in response to the
The name of the Linux on z Systems guest where ACTVLIFE SERVERS command. It consists of one
the workload server application resides. header line, three label lines, and one or more data
lines, with each data line providing information about a
70-77 workload server.
The name of the Linux on z Systems guest where
the Lifeline Management Agent, monitoring the Each data line includes the following information:
server application, resides. Columns
83-90 Description
The z/VM® system ID where the Server Guest and 1-8
Agent Guest are active. The MVS job name of the server application.
94-101 12-19
The name of the site as it is known to the Multi-site The name of the SNA application.
Workload Lifeline Agent.
27-34
• If the site_name parameter is configured for the The name of the network where the application
Multi-site Workload Lifeline Agent, the site name resides.
is the name specified for the parameter. 38-45
– The site_name parameter is required for a The image name where the server application
Linux on z Systems Management Agent and is resides.
optional for a z/OS Agent. 49-56
• If the site_name parameter is not configured for The name of the site as it is known to the Multi-site
the z/OS Agent, the site name is the name of Workload Lifeline Agent.

Chapter 2. AQN Prefix Messages 113


• If the site_name parameter is configured for the and ACTVREPL command output. If the statement
Multi-site Workload Lifeline Agent, the site name is omitted, a default value of AQNPLEX is used.
is the name specified for the parameter. The message is only issued the first time NetView
processes data from the replication server to avoid
– The site_name parameter is required for a
redundant messages in the NetView log.
Linux on z Systems Management Agent and is
optional for a z/OS Agent. Message Variable:
• If the site_name parameter is not configured for sysplex
the z/OS Agent, the site name is the name of The sysplex name where the capture server is
the sysplex as it is known to the z/OS operating running.
system.
60-67 System action
The state of the server application. The following
The Source Site Name field will be set to its default
values are valid:
value of AQNPLEX on data that is sent to the Tivoli
• ACTIVE Enterprise Portal or is returned on the ACTVREPL
• INACTIVE command.

71-72
The net weight for this SNA application relative to Operator response
other SNA application instances that are defined Notify the system programmer.
for this workload on the same site. This value
is determined by using the WLM weight for this
system. It is then normalized against the other
System programmer response
SNA application instances (active on this same Supply the missing definition statement on the
site) that are defined for this workload. controller NetView and issue the RESTYLE ACTACT
80-87 command.
The name of the site (i.e. the sysplex name), as it AQN059I DISPLAY OF MQ WORKLOAD
is known to the z/OS operating system, where the CLUSTERS FOR WORKLOAD NAME
SNA application server resides. workload_name
Message Variables
workload_name Explanation
The name of the workload as specified for the This multiline message is issued in response to the
WORKLOAD keyword. A value of * indicates that ACTVLIFE SERVERS command. It consists of one
the WORKLOAD keyword is not specified or that header line, three label lines, and one or more data
WORKLOAD=* is specified. lines, with each data line providing information about a
workload server.
System action Each data line includes the following information:
The ACTVLIFE SERVERS command processing is Columns
complete. Description
AQN058I SOURCE SYSPLEX STATEMENT 1-48
MISSING FOR PROXY DATABASE The name of the WebSphere MQ cluster name for
OR FILE SYSTEM FOR SYSPLEX the workload.
sysplex. DEFAULT VALUE OF 52-55
AQNPLEX WILL BE USED. The name of the WebSphere MQ queue manager
that hosts the specified cluster.
Explanation 67-74
The NetView program cannot find an ACTACT.SPLEX The MVS job name of the MQ queue manager.
definition statement for the specified sysplex. For 78-122
usability purposes, the definition provides NetView The IPv4 or IPv6 address of the MQ queue
the source database or file system sysplex name manager listener that is defined for the workload.
when running in a database or file system proxy 126-130
configuration. This sysplex name is displayed in the The number of the port on which the MQ queue
Source Site Name field in the Tivoli Enterprise Portal manager listens.

114 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


134-141 are defined for this workload on the same site. This
The name of the z/OS image where the MQ queue value is determined by using the WLM weight for
manager resides. this system. It is then normalized against the other
145-152 MQ cluster queue managers (active on the same
The name of the site as it is known to the Multi-site site) that are defined for this workload.
Workload Lifeline Agent. 181-182
The Workload Manager (WLM) weight value for
• If the site_name parameter is configured for the
the MQ queue manager. This value is a measure
Multi-site Workload Lifeline Agent, the site name
of how well the MQ queue manager is meeting
is the name specified for the parameter.
the configured WLM goals. It represents the
– The site_name parameter is required for a amount of displaceable processor capacity based
Linux on z Systems Management Agent and is on the importance of this MQ queue manager as
optional for a z/OS Agent. compared to other MQ queue manager instances
• If the site_name parameter is not configured for (active on this same site) that are defined for this
the z/OS Agent, the site name is the name of workload. The WLM weight is a composite weight
the sysplex as it is known to the z/OS operating and comprises the sum of the CP, zAAP, and zIIP
system. weights.
190-197
156-158
The name of the site (i.e. the sysplex name), as it
The availability of the MQ queue manager for the is known to the z/OS operating system, where the
specified MQ cluster name. The following values MQ queue manager resides.
are valid:
Message Variables
• Yes: The queue manager is available for the
workload_name
workload when the queues configured to the
The name of the workload as specified for the
Multi-Site Workload Lifeline Advisor are also
WORKLOAD keyword. A value of * indicates that
defined to the MQ Queue manager and can have
the WORKLOAD keyword is not specified or that
messages queued to them.
WORKLOAD=* is specified.
• No: The queue manager is not available for
the workload when one or more of the queues
configured to the Multi-Site Workload Lifeline
System action
Advisor are not defined to the MQ Queue The ACTVLIFE SERVERS command processing is
manager or cannot have messages queued to complete.
them.
172-173
The net weight for this MQ cluster queue manager
relative to other MQ cluster queue managers that

Chapter 2. AQN Prefix Messages 115


116 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)
Chapter 3. BNH Prefix Messages

This chapter lists the BNH prefix messages.


The following messages are sent to the NetView terminal operator or the authorized message receiver. If
an authorized message receiver is not defined in the system, or is not logged on, the messages destined
for the authorized message receiver are sent to the system console operator.
BNH000I COMMAND FACILITY MESSAGE BNH002I NAME TYPE STATE
msgid ISSUED BUT DOES NOT
EXIST IN MESSAGE TABLE Explanation
DSIMDMH - CALL IGNORED
This message is the second-column header line for the
FOCALPT DISPSOC command. The columns contain:
Explanation
ENTRY POINT NAME
The specified message number does not exist in the The entry point name
message table.
SPHERE OF CONTROL TYPE
Message Variables Indicates whether the sphere of control is implicit
msgid or explicit
The message number ENTRY POINT STATE
Indicates whether the entry point is unknown,
System action active, inactive, delete pending, add pending,
delete add pending, or inactive retry
The NetView program ignores the message call and
continues processing.
System action
Operator response FOCALPT DISPSOC data follows these messages.

Notify the system programmer. BNH003I ep_name IMPLICIT UNKNOWN

System programmer response Explanation


Contact IBM Software Support. The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing
BNH001I ENTRY POINT SPHERE OF entry point data. They are displayed after the header
CONTROL ENTRY POINT messages, BNH001I and BNH002I, are issued.
Message Variables
Explanation
ep_name
This message is a column header for the FOCALPT Entry point name
DISPSOC command. The columns contain:
ENTRY POINT NAME System action
The entry point name
This message contains entry point data.
SPHERE OF CONTROL TYPE
Indicates whether the sphere of control is implicit BNH004I ep_name IMPLICIT ACTIVE
or explicit
ENTRY POINT STATE Explanation
Indicates whether the entry point is unknown,
active, inactive, delete pending, add pending, The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing
delete add pending, or inactive retry
entry point data. They are displayed after the header
messages, BNH001I and BNH002I, are issued.
System action
Message Variables
Message BNH002I follows this message.

© Copyright IBM Corp. 1997, 2022 117


ep_name Explanation
Entry point name
The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing
System action entry point data. They are displayed after the header
This message contains entry point data. messages, BNH001I and BNH002I, are issued.

BNH005I ep_name IMPLICIT DELETE Message Variables


PENDING ep_name
Entry point name
Explanation
The operator issued a FOCALPT DISPSOC command. System action
This message is one of a series of messages containing This message contains entry point data.
entry point data. They are displayed after the header
messages, BNH001I and BNH002I, are issued. BNH009I ep_name EXPLICIT DELETE
PENDING
Message Variables
ep_name Explanation
Entry point name
The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing
System action entry point data. They are displayed after the header
This message contains entry point data. messages, BNH001I and BNH002I, are issued.

BNH006I ep_name IMPLICIT INACTIVE Message Variables


ep_name
Explanation Entry point name

The operator issued a FOCALPT DISPSOC command.


This message is one of a series of messages containing System action
entry point data. They are displayed after the header This message contains entry point data.
messages, BNH001I and BNH002I, are issued.
BNH010I ep_name EXPLICIT DELETE ADD
Message Variables PENDING
ep_name
Entry point name Explanation
The operator issued a FOCALPT DISPSOC command.
System action This message is one of a series of messages containing
This message contains entry point data. entry point data. They are displayed after the header
messages, BNH001I and BNH002I, are issued.
BNH007I ep_name EXPLICIT ADD PENDING
Message Variables

Explanation ep_name
Entry point name
The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing
entry point data. They are displayed after the header System action
messages, BNH001I and BNH002I, are issued. This message contains entry point data.
Message Variables BNH011I ep_name EXPLICIT INACTIVE
ep_name
Entry point name Explanation
The operator issued a FOCALPT DISPSOC command.
System action This message is one of a series of messages containing
This message contains entry point data. entry point data. They are displayed after the header
messages, BNH001I and BNH002I, are issued.
BNH008I ep_name EXPLICIT ACTIVE

118 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables BNH015E THERE ARE NO ENTRY POINTS IN
THE SPHERE OF CONTROL FOR
ep_name
CATEGORY fpcat WHICH QUALIFY
Entry point name
FOR ANY OF THE TARGETS
SPECIFIED IN THE TARGET LIST
System action
This message contains entry point data. Explanation
BNH012I ep_name EXPLICIT INACTIVE A FOCALPT DELETE command was specified with the
RETRY TARGLIST parameter. However, there were no entry
points in the specified category that matched any of
Explanation the targets specified in the target list.
Message Variables
The operator issued a FOCALPT DISPSOC command.
This message is one of a series of messages containing fpcat
entry point data. They are displayed after the header Focal point category name
messages, BNH001I and BNH002I, are issued.
Message Variables System action
ep_name The command is ignored.
Entry point name
Operator response
System action
Enter the command again with a valid entry point
This message contains entry point data. name.
BNH013I END OF SPHERE OF CONTROL BNH016E NO ENTRY POINTS QUALIFY FOR
INFORMATION TARGET: target_parameter, STATE:
state
Explanation
Explanation
The FOCALPT DISPSOC command has completed.
The operator issued a FOCALPT DISPSOC command,
BNH014E NO ENTRY POINT NAME FOR but there were no entry points in the sphere of control
CATEGORY fpcat QUALIFIES FOR that matched the target and state parameters.
TARGET: target
Message Variables
Explanation target_parameter
Target parameter input
FOCALPT DELETE command was issued. However,
there are no entry points in the sphere of control state
for the specified category whose name matched the State parameter input
specified target.
Message Variables System action
fpcat The command completed successfully.
Focal point category name BNH017I FOCALPT delete SUCCESSFUL.
target num1 ENTRY POINTS REMOVED
Specified target name for user. FROM THE SPHERE OF CONTROL
AND num2 ENTRY POINTS SET TO
System action A DELETE STATE FOR CATEGORY
fpcat
The command is ignored.
Explanation
Operator response
The operator issued a FOCALPT DELETE command
Enter the FOCALPT DELETE command again with a that completed successfully. This message tells how
valid wildcard string for the TARGET parameter. many entry points were affected by the command and

Chapter 3. BNH Prefix Messages 119


the name of the sphere of control category of the entry BNH020I DSI6SCF PROCESSED
points. SUCCESSFULLY. number ENTRY
POINTS WERE ADDED TO THE
Message Variables
SPHERE OF CONTROL
num1
Number of entry points removed from the sphere
Explanation
of control
num2 During initialization, the SOC_MGR cannot find any
Number of entry points set to a delete state recovery data. Therefore, the sphere of control
environment was updated from the DSI6SCF file.
fpcat
Focal point category name Message Variables
number
System action The number of entry points added to the sphere of
control
The command completed successfully.
BNH018E SPHERE OF CONTROL IS UNABLE System action
TO ALLOCATE STORAGE FOR
ENTRY POINT ep_name FOR The sphere of control environment is updated
CATEGORY fpcat. THE ENTRY BNH021I ep_name HAS BEEN REMOVED
POINT IS LOST FROM THE SPHERE FROM THE SPHERE OF CONTROL
OF CONTROL FOR CATEGORY fpcat

Explanation Explanation
SOC_MGR cannot allocate storage for an entry point. An event caused an entry point to be removed from
There is possible loss of sphere of control information. the sphere of control; there is no longer a focal point-
Message Variables entry point relationship with the entry point.
ep_name Message Variables
Name of the entry point ep_name
fpcat Name of the entry point
Focal point category name fpcat
Focal point category name
System action
An entry point is lost from the sphere of control. System action
The focal point-entry point relationship is lost.
System programmer response
Allocate more storage for the DSI6DST task. If Operator response
necessary, see the IBM Z NetView Troubleshooting Depending on the circumstances, the operator might
Guide for possible causes of the storage shortage. want to issue a FOCALPT CHANGE command to obtain
BNH019I SPHERE OF CONTROL the entry point into the sphere of control again.
ENVIRONMENT UPDATED FROM BNH022I ep_name HAS BEEN SET INACTIVE
RECOVERY DATA FOR CATEGORY fpcat

Explanation Explanation
During initialization, the SOC_MGR restored the sphere An event caused an entry point to be set to the inactive
of control environment from recovery data in the VSAM state; there is no longer a focal point-entry point
Save/Restore database. relationship with the entry point.
Message Variables
System action
ep_name
The sphere of control environment is restored. Name of the entry point

120 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


fpcat Operator response
Focal point category name
If you do not want SOC_MGR to continue trying
to obtain the entry point, the operator can issue
System action a FOCALPT DELETE command. This removes the
The focal point-entry point relationship is lost. entry point from the sphere of control and cancels
subsequent attempts to obtain the entry point.
Operator response BNH025I SAVE/RESTORE DATA CONTAINED
A DUPLICATE ENTRY POINT,
Depending on the circumstances, the operator might ep_name, FOR CATEGORY fpcat.
want to issue a FOCALPT CHANGE command to set the THE ENTRY POINT IS REMOVED
entry point back to the ACTIVE state. FROM SAVE/RESTORE DATA
BNH023I DSI6SCF NOT FOUND. SPHERE OF
CONTROL IS NOT UPDATED Explanation
During initialization, SOC_MGR encountered duplicate
Explanation entry points in the VSAM Save/Restore database.
During initialization, the SOC_MGR cannot find any Message Variables
recovery data and was unable to find the DSI6SCF file
or the DSI6SCF file was empty. The sphere of control ep_name
environment is not updated. Name of the entry point
fpcat
System action Focal point category name

The sphere of control environment is not updated.


System action
BNH024I SPHERE OF CONTROL CONTINUES
SOC_MGR deletes the duplicate entry point from the
TO RETRY ESTABLISHING THE
VSAM Save/Restore database.
RELATIONSHIP WITH ep_name
FOR CATEGORY fpcat EVERY num1 BNH026E I/O ERROR OCCURRED FOR
SECONDS RECORD num1 IN DSI6SCF.
REASON CODE = num2
Explanation
A NetView operator issued a FOCALPT CHANGE or
Explanation
FOCALPT REFRESH command or, during initialization, While SOC_MGR was reading the DSI6SCF file an I/O
SOC_MGR attempted to obtain an entry point specified error occurred.
in the DSI6SCF file and the command or SOC_MGR
attempt failed. Message Variables

Message Variables num1


The number of the record where the error
ep_name occurred.
Name of the entry point
num2
fpcat I/O error reason code:
Focal point category name
8
num1 I/O error.
Time interval in seconds
12
FIND: Data set specified has not been opened.
System action 12
SOC_MGR continues trying to obtain the entry point READ: READING PROHIBITED - Find flag not
at the specified interval. This interval can be adjusted on.
using the DEFAULTS command. 16
No I/O area address supplied.
20
DSB control block ID not valid.

Chapter 3. BNH Prefix Messages 121


24 28
Request code is not FIND or READ. The entry point name and the backup focal
28 point name are the same.
Syntax error in INCLUDE card. 28
36 The primary focal point name and the backup
Member name on INCLUDE card not valid. focal point name are the same.

40 32
Embed member not valid (can cause deadlock; The entry point name and the backup focal
member embeds itself). point name are the same.

44
System error (unrecoverable internal error). System action
48 SOC_MGR continues to read the DSI6SCF file.
Incorrect use of embed with TTR function.
Operator response
System action
Correct the record and enter the FOCALPT REFRESH
SOC_MGR continues to read the DSI6SCF file. command again.
BNH028E UNABLE TO OBTAIN ep_name
System programmer response INTO THE SPHERE OF CONTROL
Contact IBM Software Support. FOR CATEGORY fpcat. THERE IS
NO REGISTERED FOCAL POINT
BNH027E RECORD num1 IN DSI6SCF
IS INCORRECTLY FORMATTED. Explanation
REASON CODE = num2
SOC_MGR was unable to obtain an entry point
specified in the DSI6SCF file because the category is
Explanation
not a registered focal point.
While SOC_MGR was reading the DSI6SCF file, it
Message Variables
encountered an incorrectly formatted record.
ep_name
Message Variables
Name of the entry point
num1 fpcat
The number of the record where the error Focal point category name
occurred.
num2 System action
Reason code:
The SOC_MGR ignores the entry.
4
The record contains extraneous data.
8 Operator response
The record contains an incorrect backup focal Register the category as a focal point.
point name.
BNH029I FOCAL POINT CATEGORY: fpcat
12
The record contains an incorrect primary focal
point name. Explanation
16 Displays the name of the registered focal point whose
The record contains an incorrect category information is displayed.
name.
Message Variables
20
The record contains an incorrect entry point fpcat
name. Focal point category name
24
The entry point name and the primary focal System action
point name are the same. Sphere of control data follows.

122 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH030E NO REGISTERED FOCAL POINT Explanation
APPLICATION NAME QUALIFIES
FOR NAME: fpcat This message follows message BNH031I. It
indicates that the immediately following lines contain
information about task global variables.
Explanation
Message Variables
An operator issued a FOCALPT command. However,
there were no category names that matched the task
specified category name. The task for which the QRYGLOBL command was
issued
Message Variables
BNH034I EXPECTED NUMBER OF
fpcat VARIABLES: exp
Focal point category name
Explanation
System action This message contains the expected number of
The command is ignored. common or task global variables as defined in the
NetView Constants module. The expected number of
variables is an indication to the NetView program of
Operator response the expected size of the global variable dictionaries.
Enter the command again with a valid category name. With these values, the NetView program can improve
the performance of global variable retrievals.This
BNH031I NETVIEW GLOBAL VARIABLE message is part of the BNH031I multiline write-to-
INFORMATION operator (MLWTO) and refers to common or task global
variables, depending upon whether it follows BNH032I
Explanation or BNH033I.Message Variables

This message is the title line message of the multiline exp


write-to-operator (MLWTO) that is generated by the The expected number of common or task global
QRYGLOBL command. This MLWTO might contain the variables as defined in the NetView Constants
following additional messages in subsequent lines: module (DSICTMOD)

• BNH032I COMMON GLOBAL VARIABLES BNH035I NUMBER OF VARIABLES FOUND:


found
• BNH036I GLOBAL VARIABLE NAME: GLOBAL
VARIABLE VALUE:
Explanation
• BNH033I TASK GLOBAL VARIABLES FOR task
• BNH034I EXPECTED NUMBER OF VARIABLES: exp The number of common or task global variables. When
the VARS keyword is specified, this is the number of
• BNH035I NUMBER OF VARIABLES FOUND: found variables that match the search word. When VARS is
• BNH037I NETVIEW GLOBAL VARIABLE omitted, this is the number of variables that exist in
INFORMATION COMPLETE the dictionary.
• BNH039I globalvarname globalvarvalue This message is part of the BNH031I multiline write-
Note: Additional blank lines and dividing lines might to-operator (MLWTO) and refers to common or task
be included in the MLWTO for readability. global variables, depending upon whether it follows
BNH032I or BNH033I.
BNH032I COMMON GLOBAL VARIABLES
Message Variables

Explanation found
The number of common or task global variables
This message follows message BNH031I. It
indicates that the immediately following lines contain BNH036I GLOBAL VARIABLE NAME: GLOBAL
information about common global variables. VARIABLE VALUE:

BNH033I TASK GLOBAL VARIABLES FOR


Explanation
task
This message is part of the BNH031I multiline write-
to-operator and contains the header for the list of

Chapter 3. BNH Prefix Messages 123


global variable names and values which follow in the Explanation
BNH039I messages.
This message is part of the BNH031I multiline write-
BNH037I NETVIEW GLOBAL VARIABLE to-operator and contains a variable name and the
INFORMATION COMPLETE variable value. The variable contained in this message
is a common or task global variable, depending upon
Explanation whether it follows BNH032I or BNH033I, Lines with
displayed values that exceed 255 characters are
This message indicates that the QRYGLOBL command displayed in turquoise - all others are displayed in
has completed successfully. If the QRYGLOBL output green.
was directed to the operator, this is the last line in the
BNH031I multiline write-to-operator. If the QRYGLOBL Message Variables
output was directed to an output file, this message is globalvarname
sent to the operator to indicate successful completion The global variable name. If the LONGVAR
of the command. attribute was specified, the entire name is shown.
BNH038E NETVIEW GLOBAL VARIABLE Otherwise, names longer than 31 characters
INFORMATION OUTPUT HALTED are truncated, as indicated by the final 2 >>
DUE TO SEVERE ERROR characters.
globalvarvalue
The value associated with the global variable
Explanation
name. This value begins in column 45, unless the
This message indicates that there was a severe error LONGVAR attribute was specified. If the LONGVAR
while trying to write the QRYGLOBL output to the attribute was specified, the globalvarvalue value
specified file. begins after globalvarname and one blank space.
The globalvarvalue value is truncated after 255
characters, unless the LONGVAR attribute was
System action
specified.
The output is not written to the output file and the
QRYGLOBL command ends. BNH040I envtype PREINITIALIZED
ENVIRONMENT STATISTICS

Operator response
Explanation
Notify the system programmer.
This is the title line of a multiline write-to-operator
(MLWTO) message that is generated by the HLLENV
System programmer response command. The MLWTO message lists preinitialized
Determine the reason why the QRYGLOBL command environment statistics for envtype.
failed. It can fail for any of the following reasons: Message Variables
• The first line of an output file specified with the envtype
REPLACE option might not have the correct key The preinitialized environment type specified with
that indicates the output file is for QRYGLOBL. The the TYPE keyword of the HLLENV command.
QRYGLOBL output key is &* (ampersand asterisk). If IBMHLPLI is the only possible value for envtype.
the REPLACE option is specified, ensure that &* is all
that exists on the first line of the output file.
System action
• DSILIST might not be correctly specified in your
NetView program. Ensure that the DSILIST DD The statistics for envtype are displayed in the
is correctly specified in your NetView startup BNH040I MLWTO message.
procedure.
• An I/O error might have occurred while attempting Operator response
to write to DASD. Ensure that there are no problems Record the statistics for your system programmer.
with the output device.
BNH039I globalvarname globalvarvalue System programmer response
Analyze the statistics provided in the MLWTO message
and your system requirements. Use this information
to optimize performance for the envtype preinitialized

124 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


environment using the HLLENV command and Explanation
HLLOPTS HLL runtime options.
This is the third line of a multiline write-to-operator
For information about using the HLLENV command, (MLWTO) message that is generated by the HLLENV
see the online help. For information about HLLOPTS, command. The MLWTO message lists preinitialized
see IBM Z NetView Programming: PL/I and C. For environment statistics for the environment type
more information about tuning your preinitialized specified on the HLLENV command.
environments, see the IBM Z NetView Tuning Guide.
Message Variables
BNH041I STATISTICS RESET AT: mm/dd/yy
hh:mm:ss pisa
The initial storage allocated (ISA) value for the
preinitialized environments. This value can be set
Explanation using the PISA keyword on the HLLENV command
This is the second line of a multiline write-to-operator and is used when allocating preinitialized
(MLWTO) message that is generated by the HLLENV environments.
command. The MLWTO message lists preinitialized pheap
environment statistics for the environment type The HEAP value for the preinitialized
specified on the HLLENV command. environments. This value is set using the PHEAP
keyword on the HLLENV command and is used
Message Variables
when allocating preinitialized environments.
mm/dd/yy def_val
The date when the statistics were reset. The Has a value of either NOTPREINIT or PREINIT.
date format depends on the TRANSMSG member,
when in effect, and on the date operands of the NOTPREINIT indicates that the NetView program
DEFAULTS and OVERRIDE commands. does not run PL/I programs linked with DSIEXPLP
in a preinitialized environment unless bit 3 in
hh:mm:ss
HLLOPTS is set to 1.
The time when the statistics were reset. The
time format depends on the TRANSMSG member, PREINIT indicates that the NetView program does
when in effect, and on the time operands of the run PL/I programs linked with DSIEXPLP in a
DEFAULTS and OVERRIDE commands. preinitialized environment unless bit 2 in HLLOPTS
is set to 1.
System action
System action
The statistics for the preinitialized environment type
are displayed in the BNH040I MLWTO message. The statistics for the preinitialized environment type
are displayed in the BNH040I MLWTO message.
Operator response
Operator response
Record the statistics for your system programmer.
Record the statistics for your system programmer.
System programmer response
System programmer response
Analyze the statistics provided in the MLWTO message
and your system requirements. Use this information Analyze the statistics provided in the MLWTO message
to optimize performance for the preinitialized and your system requirements. Use this information
environment type using the HLLENV command and to optimize performance for the preinitialized
HLLOPTS HLL runtime options. environment type using the HLLENV command and
HLLOPTS HLL runtime options.
For information about using the HLLENV command,
see the online help. For information about HLLOPTS, For information about using the HLLENV command,
see IBM Z NetView Programming: PL/I and C. For more see the online help. For information about HLLOPTS,
information about tuning preinitialized environments, see IBM Z NetView Programming: PL/I and C. For
see the IBM Z NetView Tuning Guide. more information about tuning your preinitialized
environments, see the IBM Z NetView Tuning Guide.
BNH042I PISA: pisa PHEAP: pheap
DEFAULT: def_val BNH043I NUMBER REQUESTED. REGENVS:
reg_env CRITENVS: crit_env

Chapter 3. BNH Prefix Messages 125


Explanation reg_alloc
The number of preinitialized environments
This is the 4th line of a multiline write-to-operator currently allocated with the REGENVS keyword
(MLWTO) message that is generated by the HLLENV of the HLLENV command. These preinitialized
command. The MLWTO message lists preinitialized environments are allocated immediately and can
environment statistics for the environment type be used by PL/I programs that you define to run in
specified on the HLLENV command. a preinitialized environment.
Message Variables crit_alloc
reg_env The number of preinitialized environments
The number of preinitialized environments currently allocated exclusively for PL/I programs
allocated with the REGENVS keyword on with bit 4 set in HLLOPTS. The maximum number
the HLLENV command. These preinitialized of environments that can be allocated for PL/I
environments are allocated immediately and can programs with bit 4 set in HLLOPTS is specified
be used by PL/I programs that you define to run in using the CRITENVS keyword of the HLLENV
a preinitialized environment. command.

crit_env
The maximum number of preinitialized System action
environments that can be allocated exclusively for The statistics for the preinitialized environment type
PL/I programs with bit 4 set in HLLOPTS. These are displayed in the BNH040I MLWTO message.
environments are defined with the CRITENVS
keyword on the HLLENV command.
Operator response
System action Record the statistics for your system programmer.

The statistics for the preinitialized environment type


are displayed in the BNH040I MLWTO message. System programmer response
Analyze the statistics provided in the MLWTO message
Operator response and your system requirements. Use this information
to optimize performance for the preinitialized
Record the statistics for your system programmer. environment type using the HLLENV command and
HLLOPTS HLL runtime options.
System programmer response For information about using the HLLENV command,
Analyze the statistics provided in the MLWTO message see the online help. For information about HLLOPTS,
and your system requirements. Use this information see IBM Z NetView Programming: PL/I and C. For more
to optimize performance for the preinitialized information about tuning preinitialized environments,
environment type using the HLLENV command and see the IBM Z NetView Tuning Guide.
HLLOPTS HLL runtime options. BNH045I IN USE. REGENVS: reg_inuse
For information about using the HLLENV command, CRITENVS: crit_inuse
see the online help. For information about HLLOPTS,
see IBM Z NetView Programming: PL/I and C. For more Explanation
information about tuning preinitialized environments,
see the IBM Z NetView Tuning Guide. This is the sixth line of a multiline write-to-operator
(MLWTO) message that is generated as a result
BNH044I PREINITIALIZED. REGENVS: of the HLLENV command. The MLWTO message
reg_alloc CRITENVS: crit_alloc lists preinitialized environment statistics for the
environment type specified on the HLLENV command.
Explanation Message Variables
This is the fifth line of a multiline write-to-operator reg_inuse
(MLWTO) message that is generated as a result The number of preinitialized environments in use
of the HLLENV command. The MLWTO message from the pool of environments allocated with the
lists preinitialized environment statistics for the REGENVS keyword of the HLLENV command
environment type specified on the HLLENV command.
crit_inuse
Message Variables The number of preinitialized environments in
use from the pool of environments allocated

126 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


exclusively for PL/I programs with bit 4 set in System programmer response
HLLOPTS
Analyze the statistics provided in the MLWTO message
and your system requirements. Use this information
System action to optimize performance for the preinitialized
The statistics for the preinitialized environment type environment type using the HLLENV command and
are displayed in the BNH040I MLWTO message. HLLOPTS HLL runtime options.
For information about using the HLLENV command,
Operator response see the online help. For information about HLLOPTS,
see IBM Z NetView Programming: PL/I and C. For more
Record the statistics for your system programmer. information about tuning preinitialized environments,
see the IBM Z NetView Tuning Guide.
System programmer response BNH047I TIMES USED. REGENVS: reg_used
Analyze the statistics provided in the MLWTO message CRITENVS: crit_used
and your system requirements. Use this information
to optimize performance for the preinitialized Explanation
environment type using the HLLENV command and
HLLOPTS HLL runtime options. This is the eighth line of a multiline write-to-operator
(MLWTO) message that is generated as a result
For information about using the HLLENV command, of the HLLENV command. The MLWTO message
see the online help. For information about HLLOPTS, lists preinitialized environment statistics for the
see IBM Z NetView Programming: PL/I and C. For more environment type specified on the HLLENV command.
information about tuning preinitialized environments,
see the IBM Z NetView Tuning Guide. Message Variables

BNH046I MOST NEEDED. REGENVS: reg_used


reg_most CRITENVS: crit_most The total number of times that PL/I programs
defined to run in a preinitialized environment
actually use an environment from the pool
Explanation allocated with the REGENVS keyword of the
This is the seventh line of a multiline write-to-operator HLLENV command.
(MLWTO) message that is generated as a result crit_used
of the HLLENV command. The MLWTO message The total number of times that PL/I programs
lists preinitialized environment statistics for the defined to run in a preinitialized environment
environment type specified on the HLLENV command. actually use an environment from the pool
Message Variables allocated exclusively for programs with bit 4 set
in HLLOPTS.
reg_most
The maximum number of preinitialized
environments in use at any one time from the
System action
pool of environments allocated with the REGENVS The statistics for the preinitialized environment type
keyword of the HLLENV command are displayed in the BNH040I MLWTO message.
crit_most
The maximum number of preinitialized Operator response
environments in use at any one time from the
pool of environments allocated exclusively for PL/I Record the statistics for your system programmer.
programs with bit 4 set in HLLOPTS
System programmer response
System action Analyze the statistics provided in the MLWTO message
The statistics for the preinitialized environment type and your system requirements. Use this information
are displayed in the BNH040I MLWTO message. to optimize performance for the preinitialized
environment type using the HLLENV command and
HLLOPTS HLL runtime options. For information about
Operator response using the HLLENV command, see the online help.
Record the statistics for your system programmer. For more information about tuning preinitialized
environments, see the IBM Z NetView Tuning Guide.

Chapter 3. BNH Prefix Messages 127


BNH048I TIMES UNAVAILABLE. REGENVS: for the environment type specified on the HLLENV
reg_unavl CRITENVS: crit_unavl command.
Message Variables
Explanation
x.xx
This is the ninth line of a multiline write-to-operator The average number of preinitialized environments
(MLWTO) message that is generated as a result needed by a PL/I program from the pool of
of the HLLENV command. The MLWTO message environments set up with the REGENVS keyword of
lists preinitialized environment statistics for the the HLLENV command. The average is calculated:
environment type specified on the HLLENV command.
• Each time a PL/I program with bit 4 set to 0
Message Variables in HLLOPTS and actually runs in a preinitialized
environment tries to run in an environment
reg_unavl
allocated with REGENVS keyword of the HLLENV
The number of times all preinitialized
command, whether it finds a preinitialized
environments allocated with the REGENVS
environment.
keyword are unavailable to a PL/I program defined
to run in a preinitialized environment. These • Each time a PL/I program with bit 4 set to 1
programs have bit 4 set to (zero) in HLLOPTS. in HLLOPTS runs in a preinitialized environment
allocated with the REGENVS keyword of the
crit_unavl
HLLENV command.
The number of times all preinitialized
environments are unavailable to a PL/I program y.yy
with bit 4 set to 1 in HLLOPTS. The average number of preinitialized environments
needed by a PL/I program with bit 4 set to 1 in
For information about HLLOPTS, see IBM Z NetView
HLLOPTS. The average is calculated:
Programming: PL/I and C.
• Each time a PL/I program tries to run in a
System action preinitialized environment allocated exclusively
for programs with bit 4 set in HLLOPTS, whether
The statistics for the preinitialized environment type it finds a preinitialized environment.
are displayed in the BNH040I MLWTO message.
System action
Operator response
The statistics for the preinitialized environment type
Record the statistics for your system programmer. are displayed in the BNH040I MLWTO message.

System programmer response Operator response


Analyze the statistics provided in the MLWTO message Record the statistics for your system programmer.
and your system requirements. Use this information
to optimize performance for the preinitialized
System programmer response
environment type using the HLLENV command and
HLLOPTS HLL runtime options. Analyze the statistics provided in the MLWTO message
and your system requirements. Use this information
For information about using the HLLENV command,
to optimize performance for the preinitialized
see the online help. For information about HLLOPTS,
environment type using the HLLENV command and
see IBM Z NetView Programming: PL/I and C. For more
HLLOPTS HLL runtime options.
information about tuning preinitialized environments,
see the IBM Z NetView Tuning Guide. For information about using the HLLENV command,
see the online help. For information about HLLOPTS,
BNH049I AVERAGE NEEDED. REGENVS: x.xx
see IBM Z NetView Programming: PL/I and C. For more
CRITENVS: y.yy
information about tuning preinitialized environments,
see the IBM Z NetView Tuning Guide.
Explanation
BNH050I envtype PREINITIALIZED
This is the tenth and last line of a multiline write- ENVIRONMENT ALLOCATION
to-operator (MLWTO) message that is generated as
a result of the HLLENV command. The MLWTO
message lists preinitialized environment statistics

128 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
This is the first line of a multiline write-to-operator Record the information for your system programmer.
(MLWTO) message that is generated as a result of
the HLLENV command. The MLWTO message lists System programmer response
preinitialized environment allocation information. You
also receive one or more BNH051I messages or one Analyze the information provided in the MLWTO
BNH056I message in the MLWTO. message to determine what NetView subtasks are
using preinitialized environments. For information
Message Variables
about using the HLLENV command, see the NetView
envtype online help.
The preinitialized environment type specified with
BNH052I envtype ENVIRONMENT KEYWORD
the TYPE keyword of the HLLENV command.
keyword HAS BEEN CHANGED
IBMHLPLI is the only possible value for envtype.
FROM oldval TO newval

System action
Explanation
The allocation information for the preinitialized
This message is displayed to verify a change made by
environment type is displayed in the BNH050I MLWTO
the HLLENV command.
message.
Message Variables
Operator response envtype
Record the information for your system programmer. The preinitialized environment type specified with
the TYPE keyword of the HLLENV command.
IBMHLPLI is the only possible value for envtype.
System programmer response
keyword
Analyze the information provided in the MLWTO The keyword changed with the HLLENV command
message to determine what NetView subtasks are for a specified type. keyword can have a value of
using preinitialized environments. For information REGENVS, CRITENVS, PISA, PHEAP, and DEFAULT.
about using the HLLENV command, see the online oldval
help. The value for keyword before issuing the HLLENV
BNH051I TASK: taskname ENVIRONMENTS command with the CHANGE keyword.
IN USE: number newval
The value for keyword after issuing the HLLENV
Explanation command with the CHANGE keyword.

One or more of these might follow BNH050I in a


System action
multiline write-to-operator (MLWTO). It is generated
by the HLLENV command. The MLWTO message lists If the value of REGENVS or CRITENVS is changed,
preinitialized environment allocation information. preinitialized environments not in use are allocated or
freed as requested. If PISA or PHEAP are changed,
Message Variables
preinitialized environments not in use are freed
taskname immediately and reallocated with the new PISA or
The NetView subtask where the HLL command PHEAP value.
processor is executing in a preinitialized
Any preinitialized environments in use when
environment. OPER1 and AUTO1 are examples of
REGENVS, CRITENVS, PISA, or PHEAP are changed,
subtasks.
are not affected until the program running in the
number environment completes processing.
The number of environments in use.
The value for DEFAULT changes if no preinitialized
environments are allocated.
System action
BNH053I envtype ENVIRONMENT
The allocation information for the preinitialized STATISTICS RESET
environment type is displayed in the BNH050I MLWTO
message.

Chapter 3. BNH Prefix Messages 129


Explanation System action
Indicates that preinitialized environment statistics The change request is ignored.
have been reset for the specified environment type.
Message Variables Operator response
envtype Notify the system programmer of the envtype and
The preinitialized environment type specified with keyword that caused the message.
the TYPE keyword of the HLLENV command.
IBMHLPLI is the only possible value for envtype. System programmer response
Issue the HLLENV command with REGENVS=0 and
System action
CRITENVS=0. This frees all preinitialized environments
The following preinitialization statistics are reset: when all programs running in those environments
complete processing. You can then issue the HLLENV
• The date and time that the statistics were last reset.
command again and change the values for DEFAULT.
• The maximum number of environments that were in
use at any time. BNH056I NO ENVIRONMENTS CURRENTLY
ALLOCATED
• The number of times PL/I programs used a
preinitialized environment.
Explanation
• The number of times a PL/I program tried to get a
preinitialized environment but none were available. This is the second and last message of a multiline
• The average number of environments needed. write-to-operator (MLWTO) message and follows the
BNH050I message. The MLWTO is generated by the
BNH054I PLEASE WAIT. PROCESSING YOUR HLLENV command.
REQUEST...
This message indicates that you attempted to list the
preinitialized environment allocation information but
Explanation no environments were in use.
Your request is being processed and is not yet
complete. System action
No preinitialized environment allocation information is
Operator response displayed.
Wait for your request to be completed. BNH057E cmd COMMAND IS NOT A VALID
BNH055E envtype ENVIRONMENT REQUEST OPERATOR COMMAND
IGNORED. CHANGING THE
keyword KEYWORD VALUE IS NOT Explanation
ALLOWED WHILE ENVIRONMENTS
You tried to issue a command that is not valid or that
ARE ALLOCATED
you are not authorized to use.

Explanation Message Variables

You attempted to change a preinitialized environment cmd


value for the specified type while environments of that The command you tried to issue
type were allocated.
Message Variables
System action
The command is not processed.
envtype
The preinitialized environment type specified with BNH058I THE SPECIFIED WRAP COUNT
the TYPE keyword of the HLLENV command. OF WrapCnt EXCEEDS THE
IBMHLPLI is the only possible value for envtype. MAXIMUM ALLOWABLE VALUE
keyword OF MaxWrapCnt. MaxWrapCnt IS
The keyword changed with the HLLENV command USED INSTEAD.
for a specified type. keyword can have a value of
DEFAULT.

130 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
You previously issued an NPDA SDOMAIN command Processing continues.
from a previous release of the NetView program
BNH060I RMTCMD QUERY INFORMATION
and established a session with IBM Z NetView. You
later entered an SWRAP EV|ST WrapCnt N resname
command to change an Event or Statistic wrap count Explanation
at the target NetView system. The WrapCnt value
This is the first line of a multiline response to
you specified is greater than the MaxWrapCnt value
the RMTCMD QUERY command. Additional lines of
allowed by the target NetView system. The maximum
the multiline response contain the RMTCMD QUERY
allowable value was used instead. For the EV (Event)
information requested.
or ST (Stat) data types, the maximum wrap count value
that is valid for a NetView system is 450, and the BNH061I separator
maximum valid value for a prior release of a NetView
program is 999.
Explanation
Message Variables
This is a separator line used for readability of multiple
WrapCnt multiline messages.
The specified wrap count
Message Variables
MaxWrapCnt
The maximum allowable wrap count separator
A separator character string used for readability of
multiple multiline messages
System action
BNH062I taskid ON netid.domainid IS NOT A
Processing continues. DISTRIBUTED AUTOTASK

Operator response Explanation


The wrap count is set to MaxWrapCnt. To change This message is generated as a result of the RMTCMD
the wrap count, reenter the command with a smaller QUERY command. The taskid specification on the
value. RMTCMD QUERY command was not a distributed
BNH059I YOUR HOST NETVIEW IS DOWN- autotask. Because it is not a distributed autotask,
LEVEL WITH RESPECT TO THE there is no additional information to display.
REMOTE NETVIEW WITH WHICH Message Variables
YOU ARE IN SESSION, AND
CANNOT DISPLAY THE CORRECT taskid
ALERT WRAP COUNT. THE The task specification on the RMTCMD QUERY
CORRECT ALERT WRAP COUNT IS command
WrapCnt. netid
The network identifier of the NetView program for
Explanation taskid
domainid
You previously issued an NPDA SDOMAIN command,
The domain identifier of the NetView program for
and established a session with IBM Z NetView. Your
taskid
host NetView program is a prior release. You later
entered an NPDA DWRAP AL command. The alert wrap
count of the target NetView program is greater than System action
999, and your prior-release NetView program displays
The RMTCMD QUERY command is complete.
only the last (rightmost) three digits of the wrap count
sent from the target NetView program. The actual alert
wrap count is WrapCnt. Operator response
Message Variables To query all active distributed autotasks on your
NetView program, issue the RMTCMD QUERY
WrapCnt LCLAUTOS command with a taskid specification of
The wrap count ALL.

Chapter 3. BNH Prefix Messages 131


BNH063I NO RMTCMD QUERY TRANSPORT
INFORMATION EXISTS FOR Indicates the communication mode used to start
REQUEST the remote operator listed on this line.

Explanation System action


A RMTCMD QUERY request was issued for which there The remainder of the multiline message contains
is no corresponding query information available. the information generated by the RMTCMD QUERY
LCLAUTOS command.
BNH064I DISTRIBUTED ORIGIN ORIGIN
ORIGIN BNH066I taskid o_netview o_opid version
N/A transport
Explanation
Explanation
This is the first header line of a multiline message
used in the output of the RMTCMD QUERY LCLAUTOS This is a data line of a multiline message used in the
command. The columns contain: output of the RMTCMD QUERY LCLAUTOS command
with the expedite option set to N/A.
DISTRIBUTED AUTOTASK
The name of the distributed autotask. Message Variables
ORIGIN NETVIEW taskid
The NetView program that issued the RMTCMD The distributed autotask being displayed.
command to start the autotask.
o_netview
ORIGIN OPERATOR The NetView program that issued the RMTCMD
The operator that issued the RMTCMD command to command that caused taskid to be started.
start the autotask.
o_opid
ORIGIN VERSION The operator who issued the RMTCMD command
The version and release of the NetView program that caused taskid to be started. The o_opid task
that issued the RMTCMD command to start the resides on the o_netview NetView program.
autotask.
version
The version and release of the NetView program
System action (VxRy or VxRyMz).
Message BNH065I follows this message. transport
Indicates the communication mode used to start
BNH065I AUTOTASK NETVIEW OPERATOR the remote operator being listed on this line.
VERSION TRANSPORT
BNH067I scope MASTER IN
GROUP group_name SET
Explanation TO new_master. PREVIOUS
This is the second header line of a multiline message MASTER=previous_master,
used in the output of the RMTCMD QUERY LCLAUTOS REASON=reason_code
command. The columns contain:
DISTRIBUTED AUTOTASK Explanation
The name of the distributed autotask.
This message is issued for the following reasons:
ORIGIN NETVIEW
The NetView program that issued the RMTCMD • When the master NetView program changes in a
command to start the autotask. sysplex or enterprise. This message identifies the
new and previous master NetView programs and
ORIGIN OPERATOR includes a reason code indicating why the new
The operator that issued the RMTCMD command to master program was established.
start the autotask.
• When the sysplex master NetView program becomes
ORIGIN VERSION active.
The version and release of the NetView program
that issued the RMTCMD command to start the Message Variables
autotask. scope
ENTERPRISE or SYSPLEX

132 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


group_name or the RMTCMD QUERY RMTDOMS command. This
Group name of the local NetView program message is repeated in the message for each remote
new_master NetView program where an operator has started a
The master NetView domain name distributed autotask.
previous_master This message does not imply that the requesting
This is either the previous master NetView domain operator currently has an active distributed autotask
name, or N/A if this message is issued when the at netid.luname. It indicates there was an active
first master comes up at initialization or if the distributed autotask at netid.luname at one point and
message scope is ENTERPRISE. that no sense codes have been received indicating
communication failure with netid.luname.
reason_code
The reason code that is returned. The following Message Variables
codes can be received:
netid.domainid
0 The network identifier of the NetView program
The NetView program is established as where the operator has started a distributed
the master NetView program because the autotask
XCF.RANK statement in the CNMSTYLE version
member is set to 250. The version and release of the NetView program
This reason code is also used for enterprise (VxRy or VxRyMz).
master NetView program changes. transport
1 Indicates the communication mode used to start
The master-capable NetView program is taking the remote operator being listed on this line.
over because the master failed. BNH070I taskid
2
The PLEXCTL command caused the master- Explanation
capable NetView program to take over.
3 This is a data line of a multiline message used in the
The master-capable NetView program is taking output of the RMTCMD QUERY RMTAUTOS command.
over because the master did not initialize. When more than one BNH070I message is in
the multiline message, the first BNH070I message
Operator response indicates the operator used when OPERID=* is used
for sending RMTCMD commands.
Check the reason code for the appropriate action.
Message Variables
BNH068I REMOTE NETVIEW VERSION
taskid
TRANSPORT
The distributed autotask that is displayed as
a result of the RMTCMD QUERY RMTAUTOS
Explanation command
This is a header line of a multiline message that BNH071I AUTOTASK autotask CANNOT BE
is used in the output of the RMTCMD QUERY DELETED FROM THE GROUP
RMTLUS command or the RMTCMD QUERY RMTDOMS OF VALID NETVIEW OPERATORS
command. BECAUSE IT IS CURRENTLY
ASSOCIATED WITH AN MVS
System action CONSOLE

The remainder of the multiline message contains the


results of the RMTCMD QUERY RMTLUS command or Explanation
the RMTCMD QUERY RMTDOMS command. This message is displayed after a REFRESH OPERS
BNH069I netid.domainid version transport command is processed. The autotask autotask deleted
in DSIOPF is associated with an MVS console and
cannot be deleted from the group of valid NetView
Explanation operators at this time.
This is a data line of a multiline message that is used in Message Variables
the output of the RMTCMD QUERY RMTLUS command

Chapter 3. BNH Prefix Messages 133


autotask message, the NetView program might need to be
The name of the NetView autotask recycled before the REFRESH OPERS command can
work.
System action BNH074I command keyword NOT VALID IN A
The autotask is still defined as a valid NetView PIPE
operator.
Explanation
System programmer response The NetView program issues this message when
If the autotask is to be deleted, issue the AUTOTASK command keyword is issued in a pipeline. The keyword
command to drop the console association from cannot be used in a pipeline even if the PIPE command
this autotask and then issue the REFRESH OPERS is issued from a NetView command list.
command. Message Variables
BNH072I RMTCMD QUERY INFORMATION command
FROM netid.domainid The name of the command issued
keyword
Explanation The keyword that is not valid in a pipeline
This is the first line of a multiline response from
a RMTCMD QUERY command. Additional lines of System action
the multiline response contain the RMTCMD QUERY The NetView program stops processing the command.
information requested.
Message Variables Operator response
netid Notify the system programmer of the PIPE command
The network identifier of the NetView program that that tried to issue command keyword. If the PIPE
responded with the RMTCMD QUERY information. command was issued from a NetView command list,
domainid provide the name of the command list.
The domain identifier of the NetView program that
responded with the RMTCMD QUERY information. System programmer response
BNH073W THE REFRESH COMMAND CANNOT Remove the keyword from the PIPE command
BE PROCESSED BECAUSE THERE or NetView command list. See IBM Z NetView
ARE NO VALID OPERATOR Programming: Pipes for more information about using
DEFINITIONS IN DSIOPF keyword in a pipeline.
BNH075I MVS COMMAND WAS NOT
Explanation
PROCESSED. COMMAND TEXT
This message is displayed after a REFRESH OPERS MUST BE LESS THAN max_len
command is issued. Either DSIOPF contains no valid CHARACTERS
operator definitions or there was an error processing
DSIOPF or one of its INCLUDE members. The group of Explanation
valid NetView operators remains unchanged.
The MVS command text exceeded the allowable limit.
System action Message Variables
The operators that are defined to the NetView max_len
program are not changed. If this error occurred during The maximum command length allowed
initialization, some operators might not be able to
logon until DSIOPF has been corrected. System action
The command is not sent to MVS for processing.
System programmer response
Update DSIOPF to include at least one valid operator
definition and reissue the REFRESH command. If
message DSI297E or DSI086I was issued with this

134 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response netid.luname
The network identifier of the NetView program
Enter the command again with fewer characters than with which the command was unable to
the maximum allowed. communicate
BNH076I NETVIEW MVS COMMAND
MANAGEMENT RECEIVER ID= System action
receiver_id IS ALREADY ACTIVE
The command being processed ended because of the
communication failure.
Explanation
NetView MVS Command Management Receiver Operator response
DSIMCAT is already active. If more than one NetView
program is active on z/OS, DSIMCAT can be started Ensure the parameters to command were specified
only on 1 NetView program. correctly. Contact the system programmer.

Message Variables
System programmer response
receiver_id
The NetView MVS Command Management Determine the cause of the communications problem
Receiver ID, DSIMCAT and correct the error. Messages in the network log
can help to determine more specifically what the error
might be.
System action
BNH079I REMOTE command FOR
The NetView Optional Task, DSIMCAT, ends. netid.luname TERMINATED.
BNH077I ep_name EXPLICIT UNKNOWN MESSAGE msgid FOLLOWS WITH
ADDITIONAL INFORMATION

Explanation
Explanation
The operator issued a FOCALPT DISPSOC command.
This message is displayed after the header messages A remote command request ended and caused this
are issued. This message is a data item for the message to be issued. To determine why the request
FOCALPT DISPSOC command. ended, see msgid which is issued after message
BNH079.
Message Variables
Message Variables
ep_name
The name of the entry point command
The remote request for which the message is being
issued.
System action
netid.luname
Sphere-of-control data is included in this message. The network identifier of the NetView program for
which the message is being issued.
BNH078I REMOTE command FOR
netid.luname TERMINATED msgid
BECAUSE OF A COMMUNICATION This message is issued after message BNH079
FAILURE and contains additional information about why the
remote command request ended.
Explanation
System action
The remote command request ended because it was
not able to communicate with the remote NetView The command being processed ends because of the
program. condition being reported in msgid.

Message Variables
Operator response
command
The remote request that failed Ensure the parameters to command were specified
correctly. See msgid for additional information and
contact the system programmer if the error cannot be
corrected.

Chapter 3. BNH Prefix Messages 135


System programmer response program responds, this message goes away. If
you END or RETURN from the application before
Determine the cause of the condition being reported in the remote NetView response to the request, the
this message and correct the problem. application is considered complete and any response
BNH080I target FROM netid.luname USING is ignored. If the application takes too long to respond,
OPERID autoid contact the system programmer. You can also exit the
application and issue the command again to determine
if communication is still possible.
Explanation
A remote browse request is identified with this System programmer response
message. It indicates which remote NetView program
and distributed autotask was used to satisfy the Determine the cause of the delayed response and
remote browse request. correct any problem that might exist. When you are
browsing a large member, significant data transfer can
Message Variables cause a slow response time. The RMTMAXL setting for
target the DEFAULTS and OVERRIDE commands can be used
The remote browse target. When you are browsing to limit the amount of data which is transferred for a
a remote member, this field contains the remote remote member browse request.
member name - it might be a member name BNH082I synname IS A COMMAND
for which the requested name is a command SYNONYM FOR cmdname
synonym. When you are browsing a remote
network log, this field is set to NETLOG.
Explanation
netid.luname
The network identifier of the NetView program The user requested to browse a member name that
where the target resides. is a command synonym of a member with a different
name, as defined in CNMCMD.
autoid
The distributed autotask that was used to satisfy Note: For a remote member browse request, any
the remote browse request. command synonym information is displayed in
message BNH080I.
BNH081I command WAITING FOR DATA
FROM netid.luname Message Variables
synname
Explanation The member name requested that is a command
synonym
A remote command request was issued and the
application is waiting for a response from the remote cmdname
NetView program. The name of the member for which the requested
name is a synonym
Message Variables
BNH083I REMOTE DISTRIBUTED REMOTE
command
The request that is waiting for the remote NetView
program to reply Explanation
netid.luname This is the first header line of a multiline message
The network identifier of the remote NetView used in the output of the RMTSESS command. This
program, that is processing the remote command message is followed by message BNH084I. The
request columns contain:
REMOTE NETVIEW
System action The name of the remote NetView program where
the autotask was started
The command being processed is pending until the
remote NetView program responds with the data. DISTRIBUTED AUTOTASK
The name of the distributed autotask
Operator response REMOTE VERSION
The version and release of the remote NetView
While the request being processed is pending, you program
might ROLL to another application or issue other
NetView commands. When the remote NetView

136 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action verbname
The command verb being defined
The data lines of this multiline message contain the
information generated by the RMTSESS command.
System action
BNH084I NETVIEW AUTOTASK VERSION
Processing continues.

Explanation BNH087I NETVIEW COMMAND


CHARACTERISTICS TABLE NOT
This is the second header line of a multiline message FOUND
used in the output of the RMTSESS command. This
message follows message BNH083I. The columns
contain: Explanation
REMOTE NETVIEW This message is issued in response to a CCDEF
The name of the remote NetView program where QUERY, stating that no command has been
the autotask was started successfully defined, and that no NetView Command
Characteristics (CCDEF) table exists. The CCDEF
DISTRIBUTED AUTOTASK
table defines when to stop waiting for responses
The name of the distributed autotask
to asynchronous commands. Host commands from
REMOTE VERSION NMC and several NetView command lists use this
The version and release of the remote NetView information to ensure that you see your responses
program without excessive waits.
This message might also be issued when a PIPE
System action command with the CORRCMD stage is running. The
The data lines of this multiline message contain the CORRCMD stage accesses the CCDEF table to build
information generated by the RMTSESS command. timer and termination conditions in the pipeline until
the CCDEF table is loaded, using the CCDEF command,
BNH085I netview autotask version the CORRCMD stage uses a long default timer value to
allow messages time to return to the pipeline.
Explanation
This is a data line of a multiline message used in the
System action
output of the RMTSESS command. Processing continues.
Message Variables
netview
Operator response
The remote NetView program where you have Issue CCDEF, specifying an appropriate member, if
started the distributed autotask. wanted.
autotask BNH088I RODM QUERY FAILED, RETURN
The distributed autotask with which you have CODE = retcode, REASON CODE =
an active association. The autotask distributed reascode
autotask resides on the netview NetView program.
version Explanation
The version and release of the remote NetView
program netview. A RODM query failed.
BNH086I DEFINING verbname. Message Variables
retcode
Explanation The return code from the RODM query
Subsequent messages pertaining to the command reascode
characteristics definition of the verbname specified. The reason code from the RODM query
When issued in response to a query, the actual
stages that determine the characteristics to follow. System action
Otherwise, any messages that follow report an error
encountered during definition of verbname. No RODM query information is available.

Message Variables

Chapter 3. BNH Prefix Messages 137


Operator response System action
Notify the system programmer. The VSAMPOOL command continues.
BNH092I ALERT WAS FORWARDED FROM
System programmer response NODE netid.nau VIA® SNA-MDS.
Determine the cause of the RODM query failure from
the return code and reason code provided. Correct the Explanation
problem and enter the command again.
The alert you selected was forwarded from the
BNH089E ACCESS OF LOCAL VARIABLES indicated entry point node using the SNA-MDS LU 6.2
NOT ALLOWED BY name alert forwarding protocol. The sending product in the
entry point node might be a NetView program or non-
Explanation NetView product, such as an AS/400.
Message Variables
A command list cannot access the local variables
defined by another command list. The command netid.nau
list, name, has tried to issue a command which The name of the entry point node that forwarded
is attempting to access local variables of another the alert.
command list. If the command list, name, is started
When the NetView program cannot determine the
from a command list, name might be trying to use the
NetID name of the entry point name, an * (asterisk)
variables defined by the starting command list.
is displayed, for example *.nau.
Message Variables
When the NetView program can determine the
name node name, but cannot determine if the node
The command list that is trying to access the name is the node name of the entry point (the
variables node name might be that of an intermediate focal
point node), the node name is preceded by an *
System action (asterisk), for example *netid.nau is displayed.

Processing ends.
System action
Operator response Processing continues.

Change the command, and issue the command list BNH093I *** protocol1 FOCAL POINT
again. If the command issued was a PIPE command DISALLOWED DUE TO "ALERTFWD
with a STEM or VAR stage, change the PIPE command protocol2" IN member
to use the SAFE stage that allows access to command
list messages. Explanation
BNH090I BUFFER TYPE = INDEX This message is one line of the multiline write-to-
operator (MLWTO) message output from the FOCALPT
Explanation QUERY command for the ALERT category. The
ALERTFWD statement in member member defines
This is a secondary label line for the VSAMPOOL the alert forwarding protocol for your node, either
command. It identifies that the following statistics see explicitly or by default. The defined alert forwarding
the INDEX LSR buffer pools. protocol for your node is protocol2. The message
line preceding this message line in the FOCALPT
System action QUERY output is a title line for alert forwarding by
the protocol1 protocol. This message is sent because
The VSAMPOOL command continues. your node is not permitted to forward alerts by the
protocol1 protocol.
BNH091I BUFFER TYPE = DATA
Note: If your node alert forwarding protocol is NV-
Explanation UNIQ, your node is permitted to be a local alert
focal point using the SNA-MDS protocol. However, your
This is a secondary label line for the VSAMPOOL node is not permitted to have a remote focal point
command. It identifies that the following statistics see where alerts are forwarded using SNA-MDS.
the DATA LSR buffer pools.
Message Variables

138 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


protocol1 sending_appl
The alert forwarding protocol that is not permitted The MS application that sent the MDS error
protocol2 message. If you receive this information in
The alert forwarding protocol defined for your node character format, see the REGISTER command in
in the ALERTFWD statement the NetView online help to see the corresponding
hexadecimal format. If the value of this field
member is UNKNOWN, the NetView program cannot
The member that contains the ALERTFWD determine the name of the MS application.
statement
netid.nau
The node where sending_appl resides. If the
System action value of this field is UNKNOWN, the NetView
Processing continues. program cannot determine the node name where
the sending program resides. If the value of the
BNH094I MDS ERROR MESSAGE RECEIVED netid is *, the NetView program can determine the
BY APPLICATION loc_appl FROM nau name, but not the netid name.
APPLICATION sending_appl IN
sensecod
NODE netid.nau. SNA SENSE CODE
The sense code present in the MDS error message.
IS X'sensecod'.

System action
Explanation
Processing continues.
The local MS (Management Services) application
loc_appl received an MDS error message from an MS
application sending_appl in node netid.nau. The SNA Operator response
sense code present in the MDS error message is
Notify the system programmer.
displayed.
If loc_appl is ALERT, the problem might be that the System programmer response
NetView program forwarded an unarchitected alert to
a non-NetView program alert focal point. Non-NetView Check the sense code in Systems network Architecture
program alert focal points, such as AS/400, cannot network Product Formats or issue the SENSE command
process all the types of unarchitected alerts that and take corrective action. If necessary, contact IBM
the NetView program forwards. You might consider Software Support.
restructuring your focal points so that your NetView
BNH095I APPLICATION ERROR MESSAGE
node has a NetView alert focal point.
RECEIVED BY APPLICATION
If loc_appl is HMON_OST, either an NPDA SDOMAIN loc_appl FROM APPLICATION
command failed because of an LU 6.2 transport sending_appl IN NODE netid.nau.
failure when the hardware monitor attempted to SNA SENSE CODE IS X'sensecod'.
establish a cross-domain session. Or, the SDOMAIN
command completed successfully but a subsequent Explanation
hardware monitor command failed because of an LU
6.2 transport failure. If the sensecod is X'08A80003' Local MS Application loc_appl received an application
or X'08A8000A' the target domain specified on the error message from MS Application sending_appl in
SDOMAIN command might be a NetView Version 2 or node netid.nau. The SNA sense code present in the
earlier release. application error message is displayed.
If loc_appl is HMON_DST, the hardware monitor If loc_appl is ALERT, the problem might be that the
attempted to send response data to an operator in NetView program forwarded an unarchitected alert to
another node but the send failed because of an LU 6.2 a non-NetView program alert focal point. Non-NetView
transport failure. alert focal points, such as AS/400, cannot process
all types of unarchitected alerts that the NetView
Message Variables program forwards. You might consider restructuring
loc_appl your focal points so that your NetView node has a
The local MS application that received the MDS NetView alert focal point.
error message. If you receive this information in Message Variables
character format, see the REGISTER command in
the NetView online help to see the corresponding
hexadecimal format.

Chapter 3. BNH Prefix Messages 139


loc_appl For example, if your CNMSTYLE member specifies a
The local MS application that received the value for NPDA.ALERTFWD that begins with SNA-MDS,
application error message. If you receive this your node is defined to forward alerts using the SNA-
information in character format, see the REGISTER MDS LU 6.2 alert forwarding protocol. However, if you
command in the NetView online help to see the also include a DEFFOCPT statement for category alert
corresponding hexadecimal format. in member DSICRTTD that defines an NV-UNIQ alert
sending_appl focal point, the DEFFOCPT statement is ignored and
The MS application that sent the application this message is issued.
error message. If you receive this information in Message Variables
character format, see the REGISTER command in
the NetView online help to see the corresponding member1
hexadecimal format. If the value of this field The member that contains the DEFFOCPT
is UNKNOWN, the NetView program cannot statement for category ALERT
determine the name of the sending MS application. protocol1
netid.nau The alert forwarding protocol that has been
The node where sending_appl resides. If the value overridden by the ALERTFWD statement
of this field is UNKNOWN, the NetView program protocol2
cannot determine the node where the sending The alert forwarding protocol defined by the
program resides. If the value of the netid is *, the ALERTFWD statement
NetView program can determine the nau name, member2
but not the netid name. The member that contains the ALERTFWD
sensecod statement
The sense code present in the application error
message. System action
Processing continues.
System action
Processing continues. Operator response
Notify the system programmer.
Operator response
Notify the system programmer. System programmer response
Determine whether your alert forwarding protocol is
System programmer response
defined. If so, delete the DEFFOCPT statement in
Check the sense code in Systems network Architecture member1. If not, change the protocol2 setting on the
network Product Formats or else issue the SENSE ALERTFWD statement in member2.
command and take corrective action. If necessary,
contact IBM Software Support. BNH097I COMMAND FAILED. A DATA
TRANSPORT FAILURE OCCURRED.
BNH096I DEFFOCPT STATEMENT IN
member1 FOR ALERT Explanation
FORWARDING PROTOCOL
protocol1 IS IGNORED DUE You entered a command that required data to be sent
TO "ALERTFWD protocol2" or received using a data transport, such as the LU 6.2
STATEMENT IN member2. transport. During processing of the command, a data
transport failure occurred, causing the processing of
the command to end.
Explanation
If the failing command is a hardware monitor
The ALERTFWD statement in member member2
command, you also receive either message BNH094I
defines the alert forwarding protocol protocol2 for your
or BNJ923I on the command facility screen, giving the
node, either explicitly or by default. The DEFFOCPT
reason for the data transport failure.
statement for category ALERT in member member1
defines an alert focal point for the alert forwarding If message BNH097I is a result of using the alerts
protocol protocol1. The DEFFOCPT statement is dynamic panel to request an alert from a hardware
ignored. monitor in another domain, no further alerts are
displayed on the alerts dynamic panel.

140 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
Processing continues. Processing continues.
BNH100I IMPROPER MSU RECEIVED BY
Operator response APPLICATION loc_appl FROM
Notify the system programmer. APPLICATION sending_appl IN
NODE netid.nau. SNA SENSE CODE
IS X'sensecod'.
System programmer response
If either message BNH094I or BNJ923I is present, Explanation
respond with its corrective action. Otherwise contact
IBM Software Support. Local MS application loc_appl received an improper
MSU from MS application sending_appl in node
BNH098I RESPONSE FAILED. A DATA netid.nau. The SNA sense code indicates why the local
TRANSPORT FAILURE OCCURRED. MS application rejected the MSU.
If loc_appl is ALERT, the NetView Alert_Netop
Explanation MS application received the improper MSU. This
The NetView program attempted to send response message is followed by other messages, such as
data back to a requestor using a data transport, such BNJ052I, BNJ049I, and BNJ050I, which provide
as the LU 6.2 transport, when a failure occurred. This further information concerning the improper MSU.
inability to send response data back to the requestor Message Variables
eventually causes the requestor to timeout.
loc_appl
If the source of this message is the BNJDSERV task, The local MS application that received the
the requestor is an operator in another domain. This improper MSU. If you receive this information in
message is accompanied by either message BNH094I character format, see the REGISTER command in
or DSI295I which describes the reason for the data the NetView online help to see the corresponding
transport failure. Furthermore, if the data being sent is hexadecimal format.
a new alert to an operator viewing the alerts dynamic
sending_appl
panel in another domain, the alerts dynamic panel
The MS application that sent the improper MSU. If
receive no further alerts.
you receive this information in character format,
see the REGISTER command in the NetView
System action online help to see the corresponding hexadecimal
format. If the value of this field is UNKNOWN, the
Processing continues.
NetView program cannot determine the name of
the sending MS application.
Operator response netid.nau
Notify the system programmer. The node where sending_appl resides. If the value
of this field is UNKNOWN, the NetView program
cannot determine the node where the sending
System programmer response program resides. If the value of netid is *, the
Take corrective action as specified by message NetView program can determine the nau name,
BNH094I or DSI295I, if present. Otherwise, contact but not the netid name.
IBM Software Support. sensecod
BNH099I ALERT WAS NOT FORWARDED The sense code that indicates why the local MS
VIA SNA-MDS. IS LOCAL OR application rejected the MSU.
FORWARDED VIA NV-UNIQ.
System action
Explanation Processing continues.
The alert you selected is either a local alert or an
alert that was forwarded from a NetView program in Operator response
a remote domain using the NetView-unique LUC alert
forwarding protocol. Notify the system programmer.

Chapter 3. BNH Prefix Messages 141


System programmer response System programmer response
If the sending MS application is an application that Check the sense code in Systems network Architecture
is supplied by IBM, contact IBM Software Support. Formats and take corrective action.
Otherwise, check the sense code in Systems network
BNH103I COMMAND ISSUED AT: mm/dd/yy
Architecture network Product Formats or issue the
hh:mm:ss
SENSE command and take corrective action.
BNH101I ** USE THE “FOCALPT QUERY” Explanation
COMMAND TO DISPLAY THE
category FOCAL POINT ** This message is a line in a multiline write-to-operator
message (MLWTO). It shows the time the command
was issued, which caused the MLWTO to be created.
Explanation
Message Variables
The LIST FOCPT command no longer supports
displaying the focal point for category category. Use mm/dd/yy
the FOCALPT QUERY command to display the focal The date when the command was issued. The
point for this category of data. date format depends on the TRANSMSG member,
when in effect, and on the date operands of the
Message Variables
DEFAULTS and OVERRIDE commands.
category hh:mm:ss
The category of data for which focal point The time when the command was issued. The
information is to be displayed time format depends on the TRANSMSG member,
when in effect, and on the time operands of the
System action DEFAULTS and OVERRIDE commands.
Processing continues. BNH104I THE DBAUTO MAINTENANCE
ACTIONS HAVE BEEN STOPPED
FOR component
Operator response
Use the FOCALPT QUERY command to display the Explanation
focal point for this category.
The VSAM database has run out of space twice in a
BNH102I IMPROPER MSU RECEIVED BY certain period, which is defined by default in DSITBL01
NETVIEW. SNA SENSE CODE IS as 15 minutes. The action taken after the first time has
X'sensecod'. not been attempted again.
Message Variables
Explanation
component
The NetView program received an MSU record
Specifies the VSAM component, for example
that failed a parse check. The SNA Sense Code
HARDWARE MONITOR or TCPCONN.
indicates why this failed. Message BNH102I might be
accompanied with other messages, such as BNH116I,
BNJ052I, BNJ049I, and BNJ050I. These messages System action
provide more information concerning the improper None.
MSU.
Message Variables System programmer response
sensecod Either allocate additional space for the VSAM database
The sense code that indicates why the MSU failed or implement filtering.
a parse check
BNH105I THE DOMAIN 'domain' DOES
NOT SUPPORT APPLICATION
System action
applname.
Processing continues.

Operator response
Notify the system programmer.

142 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
The application routed a request for data to the If the status monitor on this system is the one
domain named. That domain cannot properly respond receiving status information, ensure that the O
to the request. SECSTAT statement in DSICNM is commented out. If
the O SECSTAT statement is already commented out,
Message Variables
determine if another status monitor on this system is
domain receiving the status updates. Only one STATMON per
The name of the domain system can receive status information.
applname BNH108I HARDWARE MONITOR MESSAGES
The name of the application ARE PRESENT. ENTER "NCCF" TO
VIEW THEM.
System action
The request is rejected. Explanation
BNJDSERV, the DST task of the Hardware Monitor,
Operator response encountered a failure while performing processing for
you.
See the help facility for the named application for
possible circumvention. If the application is WINDOW
and the remote domain is a NetView V2R3 domain, System action
you can often circumvent the problem by issuing Processing continues.
your command in a pipeline. If your command is
asynchronous, appropriate CORRWAIT and TOSTRING
stages must be added. Operator response
Enter the NCCF command to view the Hardware
Example:
Monitor-related messages, for example, the BNJ137I
WINDOW PIPE NETVIEW your-cmd-here or BNH109I messages. If you are viewing the
| COLLECT
| CONSOLE ONLY Alerts Dynamic panel when the BNH108I message is
received, this panel might not be updated when new
alerts are received until you enter the NCCF command
System programmer response and then later enter the NPDA command to return to
the Alerts Dynamic panel.
Consider applying the latest release of the NetView
code to the named domain. BNH109I DATA SERVICES FAILURE
ENCOUNTERED DURING ALERT
BNH107I STATMON HAS BEEN BROUGHT RETRIEVAL PROCESSING.
UP AS A SECONDARY STATUS
MONITOR. RESOURCE STATUS
WILL NOT BE AVAILABLE Explanation
THROUGH STATMON The Hardware Monitor attempted to retrieve an alert
from the Hardware Monitor database when a failure
Explanation occurred. Error messages have been issued to the
authorized message receiver.
For this NetView program, STATMON has been started
as a secondary status STATMON. STATMON shows all This alert retrieval processing is performed so that
statuses in the NEVACT state. No status information is an alert can be retrieved and then sent from the
available through STATMON. BNJDSERV DST task to your operator's task, where
it then is displayed as the newest alert at the top of
the Alerts Dynamic panel. This processing occurs even
System action though you might be viewing a panel other than the
STATMON processing continues to enable browse. Alerts Dynamic panel.

Operator response System action


Contact your system programmer. Processing continues.

Chapter 3. BNH Prefix Messages 143


Operator response Operator response
Notify the system programmer. You can bypass the logon screen when you log on to
the NetView program.
System programmer response BNH112I NETVIEW LOGON SCREEN BYPASS
Inspect the network log or syslog for messages IS NOW DISABLED
that explain the failure, for example, the BNJ020I,
BNJ021I, or BNJ022I messages. Explanation
The BNH109I message might be received because the A LOGONPW DISABLE or LOGONPW QUERY command
NetView program receives a burst of alerts where the was issued.
number of alerts received is larger than the alert wrap
count. One symptom of this is a BNJ022I message
System action
with a major code of 8 and a minor code of 16. To
correct this, either increase the size of the alert wrap The screen bypass function is disabled.
count, or in DSIPARM member BNJMBDST specify
ALCACHE WRAPCNT.
Operator response
BNH110I STOP TASK RECEIVED: TASK You cannot bypass the NetView logon screen when
taskname MUST STAY ACTIVE you log on to the NetView program.

Explanation BNH113W FULL SCREEN DISPLAYS ARE


NOT SUPPORTED IN THIS
A STOP command was issued for a task that is ENVIRONMENT.
required to be active.
Message Variables Explanation
taskname A request for a full screen display is issued while
The task name for which STOP TASK or STOP the current operator task environment has its output
FORCE was issued directed away from the NetView operator console.
Full screen display requests can be honored only
System action while output is displayed on the NetView console.
Examples of processes that direct their output away
The task responded to the STOP command. The task from the NetView console are NetView pipelines and
is necessary for the operation of the NetView program. NMC command response displays.
The task is apparently running because the message
was issued by the task in response to the STOP
System action
command. The task continues to operate or waits for
work. The request is rejected.

Operator response Operator response


None. The operator must not attempt to stop a task if it Enter the command that caused the error directly from
is running normally. the NetView operator console.
BNH111I NETVIEW LOGON SCREEN BYPASS BNH114I TARGET NETVIEW VERSION 2
IS NOW ENABLED RETURNS 18 LINES AT A TIME

Explanation Explanation
A LOGONPW ENABLE or LOGONPW QUERY command You are browsing a remote network log that is not
was issued. at a late enough release level to provide more than
18 lines at a time. This message is displayed by the
System action browse facility to explain why the number of lines is
less than if you were browsing the local log, or if the
The screen bypass function is enabled. target NetView system was at a later release level.
There is no problem. When translating this message,
the length is limited to 71 characters.

144 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH115A SPECIAL SECURITY IN EFFECT or follow the byte indicated by the offset. Therefore,
FOR BROWSE AND READSEC. the offset indicates an approximate location rather
than the exact location in the MSU.
Explanation Message Variables
The NetView program detected possible security offset
lapses during initialization. There might not be a A zero-origin offset to a byte in the MSU record.
CMDDEF statement for the READSEC command. The parse failure was detected at approximately
the location of this byte. When it has a value of 0,
BROWSE and other commands that might display
the parse failure might be because of a required
sensitive data derive their security from READSEC.
subvector not being present in a major vector.
To compensate for the possible security exposure,
READSEC treats all data that might be sensitive as
being fully protected. System action
This message is issued as each operator logs on, Processing continues.
or as each autotask is started, for as long as the
condition remains in effect. The first such message is Operator response
marked as primary as if it had been routed as a result
of the ASSIGN command with the PRI keyword. All Notify the system programmer.
subsequent copies are marked as secondary.
System programmer response
System action Determine the portion of the MSU record that is in
BROWSE and other requests to display disk resident error, and take corrective action.
data fail. Message DSI213I might be displayed.
BNH117I HARDWARE MONITOR DETECTED
INCOMPATIBLE DATA BASE
Operator response DataBaseName.
Report the error to the system programmer or security
administrator. Explanation
The hardware monitor database DataBaseName is not
System programmer response compatible with the release level of your NetView
program.
Review security procedures for READSEC in the IBM
Z NetView Security Reference. Issue the REFRESH Message Variables
command with the CMDAUTH keyword to establish the
DataBaseName
appropriate security.
The name of the incompatible database
BNH116I IMPROPER MSU RECEIVED BY
NETVIEW. OFFSET TO BYTE System action
WHERE THE PARSE FAILURE WAS
DETECTED IS offset. Processing continues.

Explanation Operator response


The NetView program received an MSU record Notify the system programmer.
that failed a parse check. The offset indicates the
approximate location in the MSU where the parse System programmer response
failure was detected. Message BNH116I might be
accompanied by other messages, such as BNH102I, Determine whether your release of the NetView
BNJ052I, BNJ049I, and BNJ050I. These messages program requires the hardware monitor database to be
provide more information concerning the improper erased and reallocated. If so, perform the reallocation
MSU. One or more BNJ049I messages display the and recycle the hardware monitor BNJDSERV task. If a
improper MSU record. Use the offset with the BNJ049I database reallocation is not required, or this message
messages to determine the approximate location of is issued after a reallocation is complete, contact IBM
where the parse failure was detected in the MSU Software Support.
record. Because of the nature of parsing MSUs, the BNH118E DATA SET ORGANIZATION orgtype
portion of the MSU that is in error can either precede OF dsn IS NOT SUPPORTED.

Chapter 3. BNH Prefix Messages 145


Explanation System programmer response
The data set organization of the data being read is If SECMIGR is needed by the operator, use the
incorrect. If the command is PIPE QSAM, then the NetView program ALLOCATE command to define the
specified data set must be either physical sequential DSIPRF DD. For information about the ALLOCATE
(PS) or partitioned organization (PO) in order to be command, see the NetView online help. For future use
read. of SECMIGR consider adding the DSIPRF DD to the
NetView startup procedure.
Message Variables
orgtype BNH121E DEFAULT OUTPUT MEMBER NAME
The data set organization of the data set specified WAS OVERRIDDEN BUT NO
with the command MEMBER NAME WAS SUPPLIED

dsn
The name of the data set that failed to be Explanation
processed The SECMIGR command default output member name
was overridden but no replacement was supplied.
System action
Processing stops. System action
The SECMIGR command fails.
Operator response
The data must be read by some other method (such Operator response
as a special purpose DST) or the data must be Reissue the SECMIGR command using the default
reorganized (possibly by IDCAMS). member name or supply a new member name for the
BNH119E NO MEMBER SPECIFIED. output.
BNH122E OUTPUT MEMBER NAME
Explanation membername IS INVALID

The command entered or the data set specified


requires a member name in order to be read. If the Explanation
command is PIPE QSAM, the specified data set is a The membername specified for output is too long.
PDS and a member must be specified for the data to
be read. Message Variables
membername
System action The specified output member name

Processing stops.
System action
Operator response The SECMIGR command fails.

Specify the necessary member name.


Operator response
BNH120E DSIPRF DD IS NOT AVAILABLE
Reissue the SECMIGR command using a valid member
name of 8 or fewer characters.
Explanation
BNH123E OUTPUT MEMBER membername
To run the SECMIGR command, the DSIPRF DD must IN DATASET dsname CANNOT
be allocated and must contain operator logon profiles. BE REPLACED BY THE SECMIGR
COMMAND
System action
The SECMIGR command fails. Explanation
The output membername in dsname cannot be
Operator response replaced. This condition occurs when a member exists
but does not contain the write protect key written
Contact your system programmer.

146 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


by the SECMIGR command. Only SECMIGR output System programmer response
members can be replaced.
Determine whether the output member name
Message Variables specified must be deleted so SECMIGR can use it as
membername a scratch file. If the member cannot be deleted update
Output member name that cannot be replaced the SECMIGR source code variable DEF_TMP_OUT with
an available member name.
dsname
Data set name containing the subject member BNH125E ONLY ONE CONVERSION OPTION
CAN BE SELECTED
System action
Explanation
The SECMIGR command fails.
Only one conversion option can be processed by
SECMIGR for each invocation.
Operator response
Reissue the SECMIGR command using a different System action
output member name or contact your system
programmer. The SECMIGR command fails.

System programmer response Operator response


Check the NetView log for additional information Select a single SECMIGR conversion option from the
related to the error. Determine if the output member panel and press enter.
name specified must be deleted so SECMIGR can use
BNH126E NO CONVERSION OPTION WAS
it for output. Reissue the SECMIGR command when an
SELECTED, SELECT AN OPTION OR
available output member is identified.
REQUEST HELP
BNH124E SECMIGR TEMPORARY MEMBER
membername IN DATASET dsname Explanation
CANNOT BE REPLACED BY THE
SECMIGR COMMAND None of the SECMIGR conversion options were
selected.
Explanation
System action
SECMIGR uses a scratch file or temporary member
when converting from scope of commands security The SECMIGR command fails.
to RACF® definitions (SCP2RACF). The membername
exists but does not contain the write protect key Operator response
written by the SECMIGR command. Only SECMIGR
output members can be replaced by SECMIGR. Select one conversion option by placing a character
next to it on the SECMIGR main panel. If you need
Message Variables additional information enter HELP or HELP SECMIGR
membername from the SECMIGR main panel.
Output member name that cannot be replaced
BNH127E OPERSEC SETTING 'opersec'
dsname SPECIFIED IS INVALID
Data set name containing the subject member
Explanation
System action
The opersec setting specified is not a valid value.
The SECMIGR command fails.
Message Variables

Operator response opersec


The OPERSEC setting
Contact your system programmer.

Chapter 3. BNH Prefix Messages 147


System action Explanation
If this message is issued during the execution of The SECMIGR default input member name was
command SECMIGR, the SECMIGR command fails. overridden, but no replacement was specified.
Otherwise, if this message is issued during NetView
Message Variables
initialization, the NetView program terminates.
parmtype
Operator response The input member name to be used for parmtype
parameters. Possible values are:
• If this message is issued during the execution
OPERATOR
of command SECMIGR, reissue the SECMIGR
Corresponds to the DD statement where the
command with SAFPW, SAFCHECK, or SAFDEF
member containing OPERATOR statements is
specified for the OPERSEC setting.
located (typically the member used is DSIOPF)
• If this message is issued during NetView
COMMAND
initialization, check and correct the value of
Corresponds to the DD statement where the
SECOPTS.OPERSEC statement.
member containing CMDMDL statements is
BNH128E DEFAULT parmtype DEFINITION located (typically the member used is DSICMD)
DD WAS OVERRIDDEN BUT NO SECTABLE
REPLACEMENT WAS SUPPLIED Corresponds to the DD statement where
the member containing the command
Explanation authorization table is located

The SECMIGR default DD name was overridden, but no


replacement was specified. System action
Message Variables The SECMIGR command fails.

parmtype
The DD statement where the input parameters for Operator response
parmtype is to be located. Possible values are: Reissue the SECMIGR command using the default
OPERATOR member name or specify a new member name for
Corresponds to the DD statement where the input.
member containing OPERATOR statements is BNH130I SECMIGR option CONVERSION
located (typically the member used is DSIOPF) COMPLETE. SEE OUTPUT MEMBER
COMMAND member
Corresponds to the DD statement where
the member containing CMDDEF statements Explanation
is located (typically the member used is
CNMCMD) The SECMIGR conversion option completed and output
SECTABLE member has been generated.
Corresponds to the DD statement where the Message Variables
member containing the temporary command
authorization table is located option
The specified SECMIGR conversion option.
Possible values are:
System action
OPS2RACF
The SECMIGR command fails. Operators to RACF
SPN2RACF
Operator response Spans to RACF
Reissue the SECMIGR command using the default DD SCP2TBL
name or specify a new DD name for input. Scope to NetView Security Table
TBL2RACF
BNH129E DEFAULT parmtype DEFINITION
NetView Security Table to RACF
MEMBER WAS OVERRIDDEN
BUT NO REPLACEMENT WAS SCP2RACF
SUPPLIED Scope to RACF

148 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


member Operator response
The requested output member name.
Record the file name displayed and contact your
BNH131E ERROR ALLOCATING SECMIGR system programmer.
OUTPUT FILE. ALLOCATE RC
retcode
System programmer response
Explanation See the NetView log for additional information related
to the error. Verify that the file exists and the operator
The SECMIGR command was unable to allocate the has access to it. If present, use the information in
output member. This message might be followed by subsequent messages to resolve the problem.
another message that contains additional information.
BNH133E THE NETVIEW COMMAND
Message Variables AUTHORIZATION TABLE tblname
retcode FAILED REFRESH TEST
The return code issued by the ALLOCATE
command Explanation
SECMIGR uses the TEST keyword of the REFRESH
System action command to validate the command authorization table
The SECMIGR command fails. before converting it. The command authorization table
contains errors.

Operator response Message Variables

Record the output member name and data set you tblname
selected and contact your system programmer. The NetView command authorization table that
contains the errors
System programmer response
System action
Check the NetView log for additional information
related to the error. Verify that the output member and The SECMIGR command fails.
data set is available to the operator and the data set
is not full. Update the data set or provide an alternate Operator response
data set for the operator to use as needed. See the
NetView online help for descriptions of the ALLOCATE Record the command authorization table name
return codes. displayed and contact your system programmer.

BNH132E SECMIGR DETECTED AN ERROR


WHILE READING file
System programmer response
Correct the NetView command authorization table
Explanation before converting it. It is possible that the NetView
command authorization table that has failed the
The SECMIGR command detected an error while trying REFRESH TEST is the current table. Tables load at
to read the file. This message might be followed NetView initialization even if they contain errors, but
by another message which contains additional SECMIGR requires a table that contains no syntax
information. errors.
Message Variables BNH134E THE OUTPUT MEMBER SELECTED
file COULD NOT BE WRITTEN TO OR
The file that cannot be accessed can be displayed CLOSED
in 2 forms. If a '/' is present, the file is of the format
DD_Name/member. If a '()' is present, the file is of Explanation
the format Data_Set_Name(member).
The SECMIGR command was unable to write to or
close your selected output member.
System action
The SECMIGR command fails. System action
The SECMIGR command fails.

Chapter 3. BNH Prefix Messages 149


Operator response Data Line:
cmdname dateadded timeadded operid usagecnt
Record the output data set and member name you modname modsize deleted type res echo parse sec
specified. Contact your system programmer. ignrlsup foldup (cmdsyns) (parmsyns)
Data Line Variables:
System programmer response
Col/Variable
Verify that the operator has write access to the output Explanation
data set and that enough space exists in the data set.
1/cmdname
BNH135E THE TEMPORARY COMMAND The name of the listed command.
AUTHORIZATION TABLE DD 10/dateadded
ddname IS NOT VALID The date the command was added to the
NetView program since the NetView program
Explanation was last started.
19/timeadded
The temporary command authorization table DD
The time the command was added to the
specified is not valid. A value of DSILIST or DSIPARM
NetView program since the NetView program
must be specified.
was last started.
Message Variables 28/operid
ddname The ID of the operator who added the
The specified DD name command to the NetView program. If this
is an internal (permanent) command, the
operator ID is SYSOP. If this is a command
System action
added by a CMDDEF statement during NetView
The SECMIGR command fails. initialization, the operator ID is the PPT
operator ID.
Operator response 37/usagecnt
The number of times this command was
Reissue the SECMIGR command with DSILIST or started since it was added.
DSIPARM specified for the temporary table DD. If
DSIPARM is used, the table is checked for syntax 48/modname
errors before the conversion to RACF statements. The module name of the command processor.
57/modsize
BNH137I nnnn NetView commands listed. The module size of the command processor
or zero if the command processor cannot be
Explanation found.
This message is issued when at least one command 64/deleted
matched the selection criteria specified on the If an asterisk (*), the command cannot be
DSILCMD command. deleted. If N or *, the command entry is active.
If Y, the command entry has been deleted but
Message Variables the storage has not been freed. Issue DELCMD
nnnn and specify FREE=Y to free the command
The number of NetView commands included in the storage. Permanent commands added during
list. NetView initialization cannot be deleted.
Label Line: 66/type
CMD_NAME DATE TIME OPER_ID USAGE_CNT The type of NetView command as defined
MOD_NAME MOD_SZ D TY R E P SE ILS F by the TYPE parameter on the ADDCMD
(CMD_SYNS)...(PARMS(SYNS)) command.

The label line is displayed on a single line, followed 69/res


by the data lines. The output list can be viewed If N, the command is not resident. If Y, the
by scrolling left and right if the command is issued command is resident.
with the NetView program LISTCMD or WINDOW 71/echo
commands. If N, the command string is not echoed
to screen of the issuing operator. If Y, the
command string is echoed.

150 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


73/parse BNH139E Unexpected SAF error extracting
If N, the command is not parsed before segname segment data from operid
execution. If Y, the command is parsed. SAF user profile.
75/sec
Indicates whether to perform security Explanation
verification on the command as defined by the
SEC parameter on the ADDCMD command. The NetView program was unable to perform a
RACROUTE EXTRACT of the named segment for the
78/ignrlsup named operator in the SAF USER class.
Indicates whether suppression characters
appended to the beginning of the command Message Variables
are ignored for command logging purposes. A operid
period (.) in column 80 indicates that there The ID of the requested SAF USER class operator
is no IGNRLSUP specification for the listed
command. segname
The name of the requested SAF USER class
See the ADDCMD command in the NetView segment
online help for more information.
82/foldup System action
Indicates whether the command is changed to
uppercase. If N, the command is not converted The command ends with a non-zero return code.
to uppercase. If Y, the command is converted
to uppercase. Operator response
84/(cmdsyns) Verify that there are no misspellings. If any
The list of command synonyms defined for this misspellings are found, correct them and reissue the
command listed within the parentheses and command. Otherwise, notify the system programmer.
separated by blanks, for example (cmdsyn1
cmdsyn2 ...). If there are no command
synonyms, only the parentheses are returned. System programmer response
+/(parmsyns) Check message BNH270E to determine the cause
The list of command parameters and of the error and make the necessary corrections as
associated synonyms listed within the indicated.
parentheses and separated by blanks. The
BNH140I WorkLoad Management service
synonyms are enclosed in parentheses
WLM_service failed for task
following the associated parameter and
task_ID
are also separated by blanks, for example
(parm1(syn1 syn2 ...) parm2(syna synb ...) ...).
If there are no parameter synonyms, only the Explanation
parentheses are returned. The starting column
The identified OS/390® or z/OS workload management
cannot be determined because of the varying
service failed.
nature of the command synonyms.
Message Variables
System action WLM_service
The name of the WLM service
Command processing continues.
task_ID
BNH138I No NetView command meets the The name of the NetView subtask experiencing the
selection criteria. WLM service failure

Explanation System action


This message is issued when there are no commands The NetView program continues processing.
matching the selection criteria specified on the
DSILCMD command.
Operator response
System action Notify your system programmer.

Command processing continues.

Chapter 3. BNH Prefix Messages 151


System programmer response Explanation
For serious errors, message DWO050E might also The MVS command is sent to the NetView program for
be sent to the NetView log. Check the NetView log automation testing. This message is sent only when
for additional messages and make any necessary CNMCAUT is set to TEST.
corrections.
Message Variables
BNH141E PPI REQUEST ISSUED FROM command
NETVIEW MVS COMMAND EXIT The first 30 characters of the MVS command
FAILED. TYPE=reqtype, RC=rc

Operator response
Explanation
None
NetView MVS Command Exit module, DSIMCAEX
issues a PPI request to the NetView program that fails. BNH144I MVS COMMAND IGNORED BY
NETVIEW. REASON: reason.
Message Variables
COMMAND: command
regtype
The PPI request type, 0014 Explanation
rc
The return code from the PPI request The MVS command is not sent to the NetView program
for processing. This message is sent only when
CNMCAUT is set to TEST
System action
Message Variables
The MVS command is not sent to the NetView
program. reason
The reason code, can be one of the following:

Operator response BUILT-IN COMMAND IGNORED


The command entered is one of the built-in
If the return code is 24, the PPI is not active, make commands that are not processed by the
sure that the PPI program is started. If the return code NetView program.
is 4 (PPI receiver is not active), 26 (the PPI receiver is
CONSOLE EXCLUDED
not defined) or 35 (the buffer queue of the PPI receiver
The console name is excluded by the CONSOLE
is full), make sure NetView program is active and the
EXCLUSION LIST
NetView optional task DSIMCAT is started. See the
IBM Z NetView Application Programmer's Guide for an CONSOLE NOT INCLUDED
explanation of all PPI request and return codes. The console name is not included in the
CONSOLE INCLUSION LIST
BNH142I MVS COMMAND MANAGEMENT IS
COMMAND EXCLUDED
SET TO mode
The command is excluded by the COMMAND
EXCLUSION LIST
Explanation COMMAND NOT INCLUDED
NetView MVS Command Management is set ON, OFF, The command is not included in the COMMAND
or to TEST as a result of the 'SET CNMCAUT=xx' EXCLUSION LIST
command. COMMAND TEXT TOO LONG
Message Variables The command text that was entered is too long

mode command
can be ON, OFF, or TEST The first 30 characters of the MVS command
BNH145E KEYWORD 'CNMCAUT' HAS
Operator response INVALID SUFFIX OR VALUE: value

None
Explanation
BNH143I MVS COMMAND SENT TO
NETVIEW: command A 'SET CNMCAUT=value' command is entered but the
suffix or the value is incorrect.
Message Variables

152 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


value Message Variables
The value entered
service
The UNIX service name that failed
System action retcode
The NetView program ignores the 'SET The hexadecimal value of the return code from the
CNMCAUT=value' command. service
rescode
Operator response The hexadecimal value of the reason code from the
service
Enter the correct command.
BNH146I NETVIEW MVS COMMAND EXIT System action
AND PARAMETER LIST ARE
INCOMPATIBLE The request fails.

Explanation Operator response


The NetView MVS command exit, DSIMCAEX, is driven Notify the system programmer.
by MVS, but the version indicator in the parameter list
has an unsupported version. System programmer response
See the appropriate manual in the Open Edition MVS
System action library for more information regarding the error.
The MVS release is not supported by this function, the BNH149I RESET REQUESTED FOR
command is not executed. 'command'
BNH147I username DEFINED AS UID = unn,
GID = gnn, HOME = 'homepath', Explanation
PROFILE = 'profname'
A request was issued to end the named command.

Explanation Message Variables

Information regarding an Open Edition (UNIX) user's command


name is returned. The name of the command

Message Variables
System action
username
Processing depends upon the command processing to
The UNIX name for the user
recognize the request.
unn
The numeric value associated with the user name
Operator response
gnn
The numeric value for the user group to which the If the command named does not end promptly, you
user is assigned might want to consider a stronger action, such as
RESET IMMED or a repeated STOP FORCE.
homepath
The initial directory for the user BNH150I format/action OUTPUT FOR
profname 'application' RECEIVED FROM
The profile command for the user attachname.

BNH148E UNIX SERVICE ERROR FOR


'service', RETURN CODE = Explanation
'retcode'X, REASON CODE = This is the first line of a multiline message issued in
'rescode'X. response to PIPE VET. The data following the message
line is from the virtual screen presented on the virtual
Explanation OST (VOST) attachname.

A failure has occurred in an Open Edition service call. For details on the data returned after this message is
issued, see IBM Z NetView Programming: Pipes.

Chapter 3. BNH Prefix Messages 153


Message Variables Explanation
format The PIPE stage reporting the error requires more
The formatting option specified on the VET data than was provided in the direction specified by
request. Valid values are ROWS and FIELDS. direction.
action Message Variables
The action option specified on the VET request.
Valid values are CURRENT and NEXT. direction
Can be either INPUT or OUTPUT
application
The name of the application or component created
by the command. If the value for application System action
is specified, the application allows dynamic
The pipeline ends before processing any data.
remapping of PF and PA keys using the NCCF
SET command. PF and PA keys can be used only
on a VET subsequent stage or command when Operator response
these keys cannot be remapped. The Application
This message results from a PIPE application
is null ('') if the application does not allow dynamic
programming error. Notify the system programmer.
remapping of PF and PA keys.
attachname
System programmer response
The name of the virtual screen being read. This
is the name specified on the ATTACH command Check the PIPE syntax and correct the number of
creating the VOST, or the command verb, if no streams.
name was specified on the ATTACH command.
BNH153E 'label' IS AN UNDEFINED LABEL.

Operator response
Explanation
No action is required. This message is to be handled by
a full-screen automation procedure. The label is used as a connector, but has not previously
been defined within the PIPE.
BNH151E TOO MANY direction STREAMS
Message Variables
WERE DEFINED.
label
Explanation The label used in the PIPE specification as a
connection that has not previously been defined
More data streams than the maximum number within that PIPE
supported by the PIPE stage were defined. The data
stream direction is indicated by direction.
System action
Message Variables
The pipeline ends before processing any data.
direction
Can be either INPUT or OUTPUT
Operator response
System action This message results from a PIPE application
programming error. Notify the system programmer.
The pipeline ends before processing any data.
System programmer response
Operator response
Check the coding of your PIPE statement and correct
This message results from a PIPE application the usage of the label shown in label.
programming error. Notify the system programmer.
BNH154E 'label' IS A DUPLICATE LABEL.

System programmer response


Explanation
Check the PIPE or stage syntax and correct the
number of streams. The label has been defined more than once within the
PIPE.
BNH152E INSUFFICIENT direction DATA
Message Variables
STREAMS PROVIDED.

154 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


label System action
The label used in the PIPE specification as a
connection that has been defined more than once Processing ends.
within that PIPE
Operator response
System action Inform your system programmer.
The pipeline ends before processing any data.
System programmer response
Operator response Correct the edit script by adding an appropriate input
This message results from a PIPE application order for the phrase.
programming error. Notify the system programmer. BNH157E KEYWORD keyword CANNOT BE
USED WITHIN A PHRASE.
System programmer response
Check the coding of your PIPE statement and correct Explanation
the usage of the label shown in label. An edit phrase has been started with an input order.
BNH155E PIPELINE 'name' IS CLOGGED. The keyword specified was encountered after the
input order and is either a global or input order. An
output order must end the phrase before the global or
Explanation input order.
Pipeline processing halted because of a deadlock. 2 Message Variables
or more stages are waiting on each other to produce
or accept messages. Further information about the keyword
deadlock can be obtained by using PIPE command The keyword in error
option DEBUG 2.
Message Variables System action
name Processing ends.
The name of the pipeline that is obstructed
Operator response
System action Inform your system programmer.
The pipeline ends prematurely. Partial results might
have been output. System programmer response
Correct the edit script by either adding an appropriate
Operator response output order to end the existing phrase or by moving a
Inform the system programmer. global order before the input order.
BNH158E order ORDER MISSING.
System programmer response
Check the coding of your pipeline specification and Explanation
correct the error. An edit phrase ended before an order of the type order
BNH156E KEYWORD keyword CAN ONLY BE was encountered.
USED WITHIN A PHRASE. Message Variables
order
Explanation The order in error
The keyword named is either an output order or a
conversion order. You must begin a phrase with an System action
input order before you can use these types of orders.
Processing ends.
Message Variables
keyword
The keyword in error

Chapter 3. BNH Prefix Messages 155


Operator response 0 - 9999. This is in columns 42-45 of the message
with a blank in column 46.
Inform your system programmer.
curget
The current DSIGET storage utilization in KB. The
System programmer response range is 0 - 999999. This is in columns 47 - 52 of
Correct the edit script by adding an appropriate order the message with a blank in column 53.
to the edit phrase. maxget
The maximum storage limit for this task in KB. The
BNH159I opername taskname curcpu
range is 0 - 999999. This is in columns 54 - 59 of
sesscpu maxcpu limcpu curget
the message with a blank in column 60.
maxget limget slowget curmqi
sessmqi maxmqi limmqi curmqo limget
sessmqo maxmqo limmqo curi/o The applicable maximum storage limit for this task
sessi/o maxi/o limi/o curpen in KB. The range is 0 - 999999. This is in columns
sesspen pendpen totpen getkbm 61 - 66 of the message with a blank in column 67.
getsess g24kbm g24sess frekbm slowget
fresess f24kbm f24sess pentime The applicable storage slowdown limit for this task
pentask in KB. The range is 0 - 999999. This is in columns
68 - 73 of the message with a blank in column 74.
Explanation curmqi
The current rate of message traffic from other
This message is the output of the DSITSTAT command.
tasks to this task in KB per minute. The range is
This message lists tasks with their CPU, storage,
0 - 999999999. This is in columns 65 - 83 of the
I/O and message queueing statistics, and defined
message with a blank in column 84.
limits. All numbers are expressed in decimals with no
punctuation. All data is aligned in columns to aid in sessmqi
parsing the data using REXX procedures. Other than The overall session rate of message traffic from
the opername and the taskname columns, no column other tasks to this task in KB per minute. The range
is left blank. Use the SUBSTR() function when you is 0 - 999999999. This is in columns 85-93 of the
parse the data. message with a blank in column 94.

Message Variables maxmqi


The maximum measured limit for the rate of
opername message traffic from other tasks to this task in KB
The operator name or task ID (TVBOPID) of an per minute. The range is 0 - 999999999. This is
active task. This is in columns 9 - 16 of the in columns 95-103 of the message with a blank in
message with a blank in column 17. column 104.
taskname limmqi
The LU name or task ID (TVBLUNAM) of an active The applicable set limit for the rate of message
task. This is in column 18 - 25 of the message with traffic from other tasks to this task in KB per
a blank in column 26. minute. The range is 0 - 999999999. This is in
curcpu columns 105 - 113 of the message with a blank in
The current task utilization in 0.01% units. The column 114.
range is 0 - 9999. This is in columns 27 - 30 of the curmqo
message with a blank in column 31. The current rate of message traffic from this task
sesscpu to other tasks in KB per minute. The range is 0 -
The task utilization for the entire session in 0.01% 999999999. This is in columns 115 - 123 of the
units. The range is 0 - 9999. This is in columns 32 - message with a blank in column 124.
35 of the message with a blank in column 36. sessmqo
maxcpu The overall session rate of message traffic from
The highest task utilization for the entire session this task to other task in KB per minute. The range
in 0.01% in units. The range is 0 - 9999. This is is 0 - 999999999. This is in columns 125 - 133 of
in columns 37 - 40 of the message with a blank in the message with a blank in column 134.
column 41. maxmqo
limcpu The maximum measured limit for the rate of
The applicable CPU limit (from OVERRIDE or message traffic from this task to other tasks in KB
DEFAULTS command), in 0.01% units. The range is per minute. The range is 0 - 999999999. This is in

156 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


columns 135 - 143 of the message with a blank in columns 235 - 243 of the message with a blank in
column 144. column 244.
limmqo g24kbm
The applicable set limit for the rate of message The current rate of DSIGET activity in KB per
traffic from this task to other tasks in KB per minute for only the storage in the 24-bit address
minute. The range is 0 - 999999999. This is in area. The range is 0 - 999999999. This is in
columns 145 - 153 of the message with a blank in columns 245-253 of the message with a blank in
column 154. column 254.
curi/o g24sess
The current number of I/Os per minute for this The session rate of DSIGET activity in KB per
task. The range is 0 - 999999999. This is in minute for only the storage in the 24-bit address
columns 155 - 163 of the message with a blank area. The range is 0 - 999999999. This is in
in column 164. columns 255-263 of the message with a blank in
sessi/o column 264.
The number of I/Os per minute recorded for this frekbm
task. The range is 0 - 999999999. This is in The current rate of DSIFRE activity in KB per
columns 165 - 173 of the message with a blank minute. The range is 0 - 999999999. This is in
in column 174. columns 265 - 273 of the message with a blank in
maxi/o column 274.
The maximum number of I/Os per minute recorded fresess
for this task. The range is 0 - 999999999. This is in The session rate of DSIFRE activity in kilobytes per
columns 175 - 183 of the message with a blank in minute. The range is 0 - 999999999. This is in
column 184. columns 275 - 283 of the message with a blank in
limi/o column 284.
The applicable limit for the number of I/Os per f24kbm
minute for this task. The range is 0 - 999999999. The current rate of DSIFRE activity in KB per
This is in columns 185 - 193 of the message with a minute for only the storage in the 24-bit address
blank in column 194. area. The range is 0 - 999999999. This is in
curpen columns 285 - 293 of the message with a blank
The current penalty time ratio in 0.01%. The range in column 294.
is 0 - 9999. This is in columns 195 - 198 of the f24sess
message with a blank in column 199. The session rate of DSIFRE activity in KB per
sesspen minute for only the storage in the 24-bit address
The session penalty time ration in 0.01%. The area. The range is 0 - 999999999. This is in
range is 0 - 9999. This is in columns 200 - 203 columns 295 - 303 of the message.
of the message with a blank in column 204. pentime
pendpen The number of penalty seconds that this task has
The current task delay time in 0.01 seconds. The caused other tasks because of its MAXMQIN limit.
range is 0 - 999999999. This is in columns 205 - The range is 0 - 999999999. This is in columns
213 of the message with a blank in column 214. 305 - 313 of the message.

totpen pentask
The total time spent in penalty wait in 0.01 The first 8 bytes contain the name of the task
seconds. The range is 0 - 999999999. This is in that caused this task to slow down because of a
columns 215 - 223 of the message with a blank in MAXMQIN limit. The rightmost byte contains an
column 224. indicator as follows:

getkbm +
The current rate of DSIGET activity in KB per Indicates that the task is currently causing a
minute. The range is 0 - 999999999. This is in penalty.
columns 225 - 233 of the message with a blank in -
column 234. Indicates that the task is not currently causing
getsess a penalty, but was the last task to do so.
The session rate of DSIGET activity in KB per This is in columns 315 - 323 of the message.
minute. The range is 0 - 999999999. This is in

Chapter 3. BNH Prefix Messages 157


System action System programmer response
This message is issued when the DSITSTAT command If the storage loss is caused by user-written programs
runs. or the amount of storage loss appears excessive,
consult the IBM Z NetView Troubleshooting Guide.
Operator response For additional help, contact IBM Software Support. If
you have programs written in Assembler that acquire
None. The NetView VIEW or WINDOW commands can storage on a global basis, use the MAINTSK(YES)
be used in REXX procedures to format and display this parameter on the DSIGET macro to inform the
data. You can use the TASKMON command instead of NetView program that the storage is permanent.
the DSITSTAT command to view task resource data
formatted for display. BNH161I 'keyword' = 'value' LIMIT REACHED
FOR TASK 'opid' 'luname'

System programmer response


Explanation
Use this data to monitor and display NetView resource
utilization. You can also use the TASKMON command. This message is issued when a task exceeds a
resource limit set by the DEFAULTS or OVERRIDE
BNH160I taskid LEFT nnnn BYTES OF command.
STORAGE, TOTAL= mmmm
You might receive BNH161I with the keyword
AVLSLOW even if there is no SLOWSTG limit set for
Explanation the task, or before the specified SLOWSTG limit is
This message is issued when a task ends without exceeded. In this case, the message indicates that the
having freed the global storage it had. This message NetView region is nearing depletion and the amount
reports the amount of unaccounted storage and the of free space is small compared to how much storage
total accumulated amount for the life of the address the task is using. This slowdown provides a method for
space. prioritizing storage requests when storage is depleted.
The NetView program delays storage requests on
Note: This message can appear with additional lines behalf of requestors to try to ride out the surge.
for diagnostic purposes.
You might receive BNH161I with the keyword AVLMAX
Message Variables even if there is no MAXSTG limit set for the task or
taskid before the specified MAXSTG limit is exceeded. In this
The operator name or task ID of the ending task case, the message indicates that the NetView region
is nearing depletion, and the amount of free space
nnnn is small compared to how much storage the task is
The decimal number of bytes of unaccounted using. This task has incurred DSIGET failures. This
storage for this task isolates storage failures to the tasks that are the most
mmmm severely impacted, while allowing the rest of the tasks
The decimal total accumulated unaccounted to function.
storage in bytes
Message Variables
keyword
System action
The name of the limit that was reached. This is the
This message is issued when a task ends and its global same name as the non-synonym keywords used on
storage counter is not zero. The count is added to the the DEFAULTS and OVERRIDE commands.
total amount of unaccounted storage. value
The decimal number value for the limit that was
Operator response reached for this task.
Notify the system programmer if the message appears opid
frequently or the amount of storage loss is significant. The operator ID or task name of the affected task.
If you use RESET IMMED, STOP FORCE, or a task luname
ABENDs for whatever reason, a storage loss might The LU name or task name of the affected task.
result. This message is held on the screen by default.
You can remove this message from the screen
manually.

158 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
This message is issued when the specific limit is This message is issued when the specific limit is
reached or exceeded. This message is held on the reached or exceeded. This message is held on the
NetView screen by default. The NetView program acts NetView screen by default. This message is deleted
to slow down tasks or reject storage requests to keep by the NetView program when the condition being
the task within the stated limits. This message is monitored stays below the established limits by at
deleted by the NetView program when the condition least 10% for approximately one minute. You can
being monitored stays below the established limits manually remove the message from the screen.
for approximately one minute or if a new higher
limit applies after using the DEFAULTS and OVERRIDE Operator response
command.
Decrease NetView activity to minimize the amount
of storage used. Use the RESOURCE command to
Operator response
determine the current storage usage. 2 new lines of
Monitor the affected tasks to assess whether a output for the TASKMON command tell you what the
problem exists. A high limit value, when exceeded, NetView region sizes are for the storage below and
might indicate a system stress or loop condition. A above the 16M boundary.
low limit value, when exceeded, might indicate that
load-balancing is behaving normally. System programmer response
Use the DEFAULTS and OVERRIDE commands to
Ensure the NetView procedure has sufficient region
adjust limits for tasks. You can remove this message
space defined on the EXEC JCL statement.
from the screen manually.
BNH163I THE domainid ABOVE 16M
System programmer response STORAGE IS nn% USED, mmmK IS
LEFT
You might prefer to automate the message either to
correct a situation,or to suppress the message if it is
Explanation
the result of a normal load-balancing policy.
This message is issued when the NetView address
To avoid receiving message BNH161 with keywords
space has used 80% or more of the storage above the
AVLMAX or AVLSLOW, run the NetView program in a
16M boundary. This message is issued again at 85%,
larger region or reduce the storage usage by stopping
90%, 95%, and 100%.
any unneeded tasks. Run the NetView program with as
large a region size as practical based upon your system Message Variables
paging capacity.
domainid
BNH162I THE domainid BELOW 16M The name of the domain ID
STORAGE IS nn% USED, mmmK IS nn
LEFT The percentage of storage above 16M that is in use
mmmK
Explanation The decimal number of K bytes left above 16M
This message is issued when the NetView address
space has used 80% or more of the storage below the System action
16M boundary. This message is issued again at 85%,
90%, 95%, and 100%. This message is issued when the specific limit is
reached or exceeded, and is held on the NetView
Message Variables screen by default. The message is deleted by the
domainid NetView program when the storage usage is reduced
The name of the domain ID to at least 10 percent below nn and remains below
that level for one minute.
nn
The percentage of storage below 16M that is in use
Operator response
mmmK
The decimal number of K- bytes left below 16M Remember to act to reduce NetView activity to bring
the storage usage down. Use the TASKMON command
to determine the current storage usage. 2 new lines
of output for the RESOURCE command indicate the

Chapter 3. BNH Prefix Messages 159


NetView region sizes for the storage below and above Explanation
the 16M boundary.
This message is issued when a task ends with
messages on its message queues.
System programmer response
Message Variables
Ensure the NetView procedure has sufficient region
space defined on the EXEC JCL statement. taskname
The name of the task that ended with messages on
BNH164I 'object' CANNOT BE USED WITH its message queues
'function'
nnn
The number of bytes of messages left on the
Explanation queues
You attempted to perform a function on a data set
or other object that cannot be done. Some reasons System action
include:
The NetView program leaves the messages on the
• You attempted to use DSIVSAM to access the queue. The messages are processed when a task
DSITRACE task. The request is not allowed because starts that has those messages on its queues. This can
the trace data requires high data integrity. in some cases be a task unrelated to the task that left
• You attempted to USE DSIVSAM to PUT or DELETE the messages on its queue.
DSILOG data.
The DSILOG data set can be updated using only
Operator response
other NetView services such as DSIWLS or MSG LOG. Contact your system programmer.
• You attempted to use DSIVSMX to access a non-
VSAM data set. The DDNAME might be misspelled. System programmer response
• You attempted to use DSIVSMX to access a VSAM Determine if a user-written task caused the problem.
data set that is not a key-sequenced file. Review the program to determine if it frees messages
Message Variables from its message queues before ending. If an IBM task
is involved, contact IBM Software Support.
object
The DDNAME, data set name, task name, or other BNH166I
object that cannot be processed
function Explanation
The command name (for example, DSIVSAM or
DSIVSMX), command subfunction (for example, This message is used internally by the NetView
PUT or DEL), or other function that cannot access program and should not be displayed on NetView
the specific object consoles.
BNH167I TASK 'taskname' MACRO
System action 'macroname' FUNCTION 'fname'
ERROR CODE 'code'
The request is not processed.
Explanation
Operator response
This message is issued when a task has an error return
Notify the system programmer. code from a system or NetView macro service.
Message Variables
System programmer response
taskname
Review the use of the specified function. Determine The name of the task with the error
whether a spelling error or variable substitution error
caused the problem. Correct the command, and try macroname
again. The name of the macro with the error
fname
BNH165I 'taskname' LEFT nnn BYTES OF For multifunction macros, the name of the function
STORAGE ON MESSAGE QUEUES that failed

160 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


code have a definition error (DSITCPCF member for
The macro return code in decimal DSITCPIP), or the TCPIP profile member must
have statements coded to reserve port number
System action 512 and 514 for NetView procedure name for RSH,
REXEC, and IPLOG commands.
The NetView recovery action can vary depending on
whether the macro can be retried. If the message BNH168I LOGON REJECTED, ALL SOCKETS
repeats after a specific period, The NetView program IN USE.
assumes that the error is recoverable. For MACRO
EZASMI, FUNCTION BIND, ERROR CODE 48, the Explanation
NetView program retries the macro.
This message is issued when you attempt to log on to
the NetView program and all the defined sockets are in
Operator response use.
Determine whether the problem is the result of
inactivating some other program or other resource. For System action
macro EZASMI for the DSITCPIP task, the error might
The logon attempt is rejected.
indicate that TCP/IP is not active in the system or that
the DSITCPIP task definition member has an incorrect
procedure name, socket number, or other error. Operator response
Try again later. If the problem persists, have the
System programmer response system programmer increase the number of sockets
for DSITCPIP.
Determine if the error is caused by a definition
problem or a programming error. Error numbers for
EZASMI and their meanings are: System programmer response
61 Update the DSITCPCF member to enable more
The requested connection was refused by the operators to log on.
remote host. Verify that the server application is
active and monitoring the specified port. BNH169I APPEND OPTION CHANGED
TO IGNORE IN numcmd SET
156 COMMANDS.
A z/OS UNIX System Services process initialization
failure occurred. This is usually an indication
that the appropriate OMVS RACF segment is Explanation
not defined for the user ID associated with The APPEND option was not valid for at least one
the application. The RACF OMVS segment might specified key setting and was changed to IGNORE. It is
not be defined or it might contain errors, such possible that APPEND was specified for a PA key. See
as an improper HOME() directory specification. message DSI614I in the NetView online help.
To resolve the problem, the tasks identified in
the BNH167I message have an OMVS segment Message Variables
defined. numcmd
1036 The number of SET commands affected
TCP/IP is not installed or is not active. DSITCPIP
taskname attempts to reconnect once per minute. System action
10110
For macro INITAPI, this code indicates that an The NetView program substitutes IGNORE for the
attempt was made to initialize the TCP/IP API affected definitions.
using a release of TCP/IP before V3R2.
10218 System programmer response
The TCP/IP named by the INITAPI macro is not Check the use of APPEND in the file referenced by the
active. DSITCPIP taskname attempts to reconnect PFKDEF command list.
once per minute.
BNH170I CONFLICTING VALUES SPECIFIED
others
FOR CTL AND NGMFVSPN
The connection was broken or there is
ATTRIBUTES FOR OPERATOR
a programming error. If your other TCP/IP
'operid'. VIEWS WILL NOT BE
connections appear to be working, you might

Chapter 3. BNH Prefix Messages 161


SPAN RESTRICTED FOR THE SAF product that does not support the NGMFVSPN
OPERATOR attribute.

Explanation System action


The CTL attribute for the operator is specified as Because the NGMFVSPN attribute is not supported in
GLOBAL and conflicts with any value other than 'N' the NETVIEW segment of the SAF product, a default
(none) for the span_level setting in the first position of no span checking is used. Any operator logging
of the NGMFVSPN attribute. The specified NGMFVSPN on while operator attributes are specified in the SAF
value is ignored and no span authority checking is product is able to display all views and resources in
performed on NMC views for the operator. views.
Message Variables
Operator response
operid
The operator that logged on with conflicting Notify the system programmer.
attributes
System programmer response
System action
To enable the NGMFVSPN attribute, one of the
A setting of CTL=GLOBAL means that the operator is following must be done:
authorized to display all views and all resources in
• Upgrade the SAF product or apply a PTF to bring
views. The operator is not restricted from displaying
the SAF product to a level that contains support for
any NMC views.
the NGMFVSPN field in the NETVIEW segment. See
the IBM Z NetView Security Reference to determine
Operator response the release number or PTF necessary for your SAF
product.
Notify the system programmer.
• Define operator attributes in a NetView profile
member in DSIPARM and issue the REFRESH
System programmer response command to dynamically refresh the NetView
When CTL=GLOBAL is specified for an operator ID, product to use operator attributes from the NetView
span checking does not need to be performed. If the profiles instead of from the SAF product. See the
operator authority is global, keep the CTL=GLOBAL IBM Z NetView Administration Reference for an
setting and change the first position in the NGMFVSPN explanation of possible values for the OPERSEC
attribute to N. setting on the OPTIONS statement.
If any restrictions are needed for this operator BNH172I INCORRECT VALUE 'value' FOUND
ID, change the CTL setting to CTL=SPECIFIC or IN THE position POSITION OF THE
CTL=GENERAL and specify the spans for which the NGMFVSPN FIELD FOR OPERATOR
the operator is authorized. Then make sure that the operator. THE DEFAULT VALUE OF
NGMFVSPN setting is compatible with the CTL setting. 'default_value' WILL BE USED
The CTL and NGMFVSPN settings are defined in the
NetView operator profile or in the NETVIEW segment Explanation
of an SAF product. For more information, see the IBM Z The NGMFVSPN setting specified for the operator
NetView Security Reference. contains an incorrect value. The default value for
BNH171I SPAN RESTRICTION OF VIEWS IS this position of the NGMFVSPN field is used for the
NOT ENABLED FOR THIS SYSTEM operator.
Message Variables
Explanation value
The NGMFVSPN attribute is not supported in the The incorrect value found in the NGMFVSPN field
release of the SAF product that you are using. The position
NGMFVSPN attribute is defined in the NETVIEW The position where the incorrect value was found
segment of an SAF product. Span-checking for NMC
operator
views is not available for operators who log on
The operator that logged on with an incorrect value
with operator attributes defined in a release of an
specified in the NGMFVSPN field

162 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


default_value seg_name
The default value for the position in the The name of the requested SAF USER class
NGMFVSPN field segment

System action System action


The operator is allowed to log on, but the default value The command ends with a non-zero return code.
is substituted for the incorrect value in the NGMFVSPN
field. Operator response
Verify that there are no misspellings. If any
Operator response
misspellings are found, correct them and reissue the
Notify the system programmer. command. Otherwise, notify the system programmer.

System programmer response System programmer response


Correct the NGMFVSPN value specified for the Determine if the operator is defined in the SAF USER
operator in the operator profile or in the NETVIEW class. If not, define the operator and the segment.
segment of an SAF product. See the IBM Z NetView If the operator is defined in the SAF USER class,
Security Reference for information about how to code determine if the SAF segment data is defined for the
the NGMFVSPN field. requested operator. If not, define the SAF operator's
segment data as needed.
BNH174I THIS TASK IS IDLE, ENTER A
COMMAND. BNH176I Display of opid SAF NETVIEW
segment data.
Explanation
Explanation
The NetView program issues this message in a panel
for TCP/IP-connected operators. This message is This is the header line of an MLWTO message, which
issued because the command or component that was is produced by the LIST SAFOP command and contains
running in this window has ended and the window has the NetView segment data. Each data line is indented,
no task to perform. The window has an input area labeled with the SAF ADDUSER or ALTUSER keyword
where you can enter a command. parameter used to set the displayed value, and
appended with a colon. The values follow the colon
Operator response and are separated by blanks. Blanks follow the colon if
the value was not set. The output is displayed with the
You can enter a command. If you want the NetView colons in the same column.
full screen window task to end, enter the LOGOFF
Message Variables
command from this window.
opid
BNH175I The seg_name segment was not
The ID of the requested SAF USER class operator.
found in the oper_id SAF user
profile.
System action
Explanation Command processing continues.
The NetView program was unable to perform a BNH177I Display of opid SAF BASE segment
RACROUTE EXTRACT of the named segment for the data.
named operator in the SAF USER class. Either the
requested SAF operator is not defined in the SAF USER
Explanation
class or the segment is not defined in the profile of the
SAF operator. This is the header line of an MLWTO message,
which is produced by the LIST SAFOP command and
Message Variables
contains the RACF base segment data. Each data
oper_id line is indented, labeled with the SAF ADDUSER,
The ID of the requested SAF USER class operator ALTUSER, CONNECT keyword parameter used to set
the displayed value, and appended with a colon. The
values follow the colon and are separated by blanks.
Blanks follow the colon if the value was not set. The

Chapter 3. BNH Prefix Messages 163


output for non-group data is displayed with the colons opid
in the same column. The output for group data is The ID of the requested SAF USER class operator.
displayed with the colons in the same column, but
indented 2 columns from the non-group data. Each set System action
of group data is separated by a blank line from other
sets of group data or non-group data. Command processing continues.
Note: The value of PW PHRASE INTERVAL is N/A if BNH180I INTRUSION DETECTION MESSAGE
you are not running z/OS v2.5, with the appropriate RECEIVED.
maintenance, or later. For more information, see the
IBM Z NetView Installation: Migration Guide.
Explanation
Message Variables
An Intrusion Detection Services (IDS) message has
opid been forwarded from the UNIX System Services
The ID of the requested SAF USER class operator syslog. This message is the first line of an ML2
message. The next line of the message contains the
System action complete text of the syslog message, including the
syslog header. This message is used by NetView
Command processing continues. automation.
BNH178I Display of opid SAF OMVS segment
data. System action
Command processing continues.
Explanation
BNH181I ZERT ENFORCEMENT POLICY
This is the header line of an MLWTO message, which is MESSAGE RECEIVED FROM
produced by the LIST SAFOP command and contains notification_location
the SAF OMVS segment data. Each data line is
indented, labeled with the SAF ADDUSER or ALTUSER
Explanation
keyword parameter used to set the displayed value,
and appended with a colon. The values follow the A z/OS Encryption Readiness Technology (zERT) policy
colon and are separated by blanks. Blanks follow the message was forwarded from the Communications
colon if the value was not set. The output is displayed Server and received by the NetView program with
with the colons in the same column. information about the connection and policy name.
The actions defined in the zERT policy will determine
Message Variables
the action on the connection.
opid
Each data line includes the following information:
The ID of the requested SAF USER class operator
Column
Column name: Description
System action
1-8
Command processing continues. Job Name: The jobname of the application that is
BNH179I Display of opid SAF LANGUAGE associated with this connection.
segment data. 12-19
User ID: The user ID that opened the socket for
Explanation this connection.
23-30
This is the header line of an MLWTO message, which Date: The date when the connection was
is produced by the LIST SAFOP command and contains determined to match the zERT policy rule.
the SAF LANGUAGE segment data. Each data line is
indented, labeled with the SAF ADDUSER or ALTUSER 34-41
keyword parameter used to set the displayed value, Time: The time when the connection was
and appended with a colon. The values follow the determined to match the zERT policy rule.
colon and are separated by blanks. Blanks follow the 45-52
colon if the value was not set. The output is displayed ConnID: The transport layer connection ID
with the colons in the same column. in hexadecimal, that uniquely identifies this
connection.
Message Variables

164 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


56-100 • If secproto is IPSec, symenc1 value is the tunnel
Remote Address: The remote IPv4 or IPv6 encryption algorithm (phase 2).
address. • If secproto is TLS, symenc1 value is the
102-145 symmetric encryption algorithm that is used by
Local Address: The local IPv4 or IPv6 address. the cipher suite.
147-151 • If secproto is SSH, symenc1 value is the
Remote Port: The remote port or port range. encryption algorithm for inbound traffic.
161-165 • If secproto is None, symenc1 value is N/A.
Local Port: The local port or port range.
The possible values for this field are
176-178 the symmetric encryption algorithms that
Trans Protocol: The transport protocol of the can be configured for the zERT rule.
connection. See the SymmetricEncryption parameter of
193-197 ZERTSymmetricEncryption statement in z/OS
Msg Protocol: The security protocol (cryptographic Communications Server: IP Configuration Reference
protection) that triggered this event for the for more information.
connection. The possible values are: 258-275
• IPSec - the connection is protected by IPSec Symmetric Encryption 2: The symmetric
encryption algorithm used to protect the
• TLS - the connection is protected by TLS connection.
• SSH - the connection is protected by SSH
• If secproto is IPSec, symenc2 value is the IKE
• None - there was no recognized protection for tunnel encryption algorithm (phase 1).
the connection
• If secproto is TLS, symenc2 value is N/A.
208-114 • If secproto is SSH, symenc2 value is the
ProtoVersion: The security protocol version. encryption algorithm for outbound traffic.
• If secproto is IPSec, security protocol version is • If secproto is None, symenc2 value is N/A.
not applicable, and the value displays N/A.
283-300
• If secproto is TLS, the possible values for Message Authentication 1: The message
secprotoversion are: authentication algorithm used to protect the
– SSLv2 connection.
– SSLv3 • If secproto is IPSec, msgauth1 value is the tunnel
– TLSv1.0 authentication algorithm (phase 2).

– TLSv1.1 • If secproto is TLS, msgauth1 value is the


message authentication algorithm that is used by
– TLSv1.2 the cipher suite.
– TLSv1.3 • If secproto is SSH, msgauth1 value is the
• If secproto is SSH, the possible values for message authentication algorithm for inbound
secprotoversion are: traffic.
– SSHv1 • If secproto is None, msgauth1 value is N/A. The
possible values for this field are the message
– SSHv2
authentication algorithms that can be configured
• If secproto is None, security protocol version is for the zERT rule.
not applicable, and the value displays N/A.
See the MessageAuthentication parameter of
223-225 ZERTMessageAuthentication statement in z/OS
ConnDir: The direction in which the connection Communications Server: IP Configuration Reference
was initiated (inbound or outbound). Not available for more information.
in the MACRO. See the policy file for connection
310-327
direction.
Message Authentication 2: The message
233-250 authentication algorithm used to protect the
Symmetric Encryption 1: The symmetric connection.
encryption algorithm used to protect the
connection. • If secproto is IPSec, msgauth2 value is the IKE
tunnel encryption algorithm (phase 1).

Chapter 3. BNH Prefix Messages 165


• If secproto is TLS, msgauth2 value is N/A. racroute_rc
• If secproto is SSH, msgauth2 value is the The return code from the RACROUTE macro
message authentication algorithm for outbound request
traffic. The request type specified on the RACROUTE
• If secproto is None, msgauth2 value is N/A. macro
security_rc
337-356
The return code from the security product
Key Exchange: Key exchange algorithm used to
protect the connection. security_rsn
The reason code from the security product
• If secproto is IPSec, kex value is N/A.
• If secproto is TLS, kex value is the key exchange System action
algorithm used by the cipher suite. The possible
values for this field are the key exchange None.
algorithms specific to TLS that can be configured
for the zERT rule. See the TLSKeyExchange Operator response
parameter of ZERTKeyExchange statement in
z/OS Communications Server: IP Configuration Notify the person in your organization responsible for
Reference for more information. security.
• If secproto is SSH, kex value is the key
exchange algorithm method. The possible System programmer response
values for this field are the key exchange
If you specified REQUEST TYPE=LIST and this
algorithms specific to SSH that can be configured
message is accompanied by message BNH209, a value
for the zERT rule. See the SSHKeyExchange
of zero for all of the return and reason codes can
parameter of ZERTKeyExchange statement in
signify that the GLOBAL=YES facility of the RACROUTE
z/OS Communications Server: IP Configuration
REQUEST=LIST function is not available.
Reference for more information.
• If secproto is None, kex value is N/A. BNH183I CURRENT SCROLL VALUE IS val

358-405
Policy Rule: The name of the zERT rule to which Explanation
this connection mapped. In Browse (when running without scroll fields) or
408-410 WINDOW, this message indicates the current scroll
Policy Action: The name of the zERT action for the value. Whenever this message is visible and a scroll
matching zERT rule. N/A in the MACRO see the command (FORWARD, BACK, LEFT, or RIGHT) is
policy file. issued, this value is used unless the operator has
typed a different value on the command line.
Message Variables
To eliminate this message and return to the default
notification_location scroll amount, press the ENTER key or issue any
The message notification will come from an SMF nonscroll command.
record or SYSLOGD.
Message Variables
BNH182E RACROUTE RC = X'racroute_rc',
REQUEST TYPE = 'request', val
SECURITY PRODUCT RC = The scroll value
X'security_rc' AND REASON = BNH184E CONFLICTING PROTECT AND
X'security_rsn' EXEMPT STATEMENTS FOUND
IN COMMAND AUTHORIZATION
Explanation TABLE MEMBER member_name AT
SEQUENCE NUMBER seq_number
The specified RACROUTE request failed with the FOR THE COMMAND IDENTIFIER
specified return code and reason code. This message cmd_id
is preceded by another message that describes the
problem that caused the failure.
Explanation
Message Variables
A command identifier was used on both a PROTECT
statement and an EXEMPT statement in the command

166 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


authorization table. This is a conflict because these Explanation
2 statements have different meanings. A command
identifier cannot be protected from unauthorized An internal error occurred preventing the QOS
use and also exempted from command authorization command from being completed.
checking. Message Variables
Message Variables operator_id
member_name The operator ID that is being checked
The member name where the conflicting command
authorization table statement was found. System action
seq_number The QOS command fails.
The sequence number within the specified
member or file. If there is no sequence number for
this statement, the value '(NO SEQ)' is returned in Operator response
the message. Notify the system programmer.
cmd_id
The command identifier that was specified on the System programmer response
PROTECT and EXEMPT statements.
See the NetView log for message DWO050E, which
contains additional information about the location of
System action the problem. Contact IBM Software Support with this
This table load statement is ignored and processing of information.
the remaining table load statement continues.
BNH186E THE SECURITY ENVIRONMENT
If this message was issued during NetView FOR THE NETVIEW MAIN TASK
initialization, the first of the 2 conflicting statements DOES NOT EXIST
is in effect, and the one identified in this message is
not in effect. Explanation
If this message was issued in response to a REFRESH
The pointer to the security environment for the
command, the command authorization table is not
NetView main task does not exist.
loaded.

System action
Operator response
If this message is issued during NetView initialization,
Notify the system programmer or person in charge
then initialization fails. If this message is issued in
of writing the command authorization table load
response to a REFRESH command, the REFRESH
statements.
command fails.
Note: Other problems might be encountered in
System programmer response
the NetView product as a result of the security
Edit your set of command authorization table environment not existing.
load statements. Decide whether the command
identifier must be protected from unauthorized use or Operator response
exempted from command authorization. Then delete
the conflicting statement. The conflicting statements Notify the system programmer.
might exist in different members if %INCLUDE was
used. System programmer response
If this message was received at NetView initialization
Recycle the NetView program when the problem is
and was truncated, you can issue a REFRESH
resolved. If you want to reduce the number of calls
command with the TEST keyword to get a complete
made to the security product until the problem is
copy of the error message.
resolved, you can specify the following options on the
BNH185E AN INTERNAL ERROR OCCURRED REFRESH command:
DURING PROCESSING OF THE • OPERSEC=NETVPW for operator authorization
QOS COMMAND FOR THE OPID checking
'operator_id'
• OPSPAN=NETV for span security

Chapter 3. BNH Prefix Messages 167


• CMDAUTH=TABLE,TBLNAME='table_name' for System programmer response
command security
Check to see if the dataspace for the NETCMDS class
For additional information about the REFRESH was deleted.
command, see the NetView online help.
For RACF, you can issue a 'SETR LIST' command
You can also specify the following statements in the from an authorized TSO operator to determine if the
CNMSTUSR member: NETCMDS class is RACLISTed. If the NETCMDS class
• SECOPTS.OPERSEC = NETVPW for operator does not appear under one of the 2 RACLISTed output
authorization checking lines, the dataspace was deleted.
• SECOPTS.OPSPAN = NETV for span security It is possible that someone issued a SETR
NORACLIST(NETCMDS), which caused the dataspace
• SECOPTS.CMDAUTH = TABLE.table_name for
to be deleted. This can be corrected by issuing a SETR
command security
RACLIST(NETCMDS) command from an authorized
Examine the system log to determine whether TSO operator or by recycling the NetView program.
problems occurred in the system that might cause
If someone is authorized to use the NetView REFRESH
the security environment not to exist. If the problem
command, you also have the option of changing
persists, contact IBM Software Support.
your command security setting. For example, you
BNH187E THE BACKUP COMMAND might want to temporarily use another command
AUTHORIZATION TABLE OR THE authorization table until the problem in the security
SAFNODEC SETTING WILL BE product is corrected.
USED FOR COMMAND AUTHORITY
BNH188I COMMAND AUTHORIZATION
DECISIONS DUE TO A PROBLEM
USING THE NETCMDS CLASS HAS
WITH THE DATASPACE FOR THE
RESUMED
NETCMDS CLASS

Explanation Explanation
There was previously a problem with the dataspace for
When the NetView program attempted to make a
the NETCMDS class, detailed by message BNH187, but
command authorization call to the security product,
is resolved.
a return code was received from the security product
indicating that the dataspace for the NETCMDS was
not accessible. The dataspace for the NETCMDS class System action
might have been deleted.
The NETCMDS class of the security product is used for
NetView command security.
System action
If a backup command authorization table exists, it System programmer response
is used for command authority decisions until the
See message BNH187 for additional information.
dataspace problem has been resolved. If a backup
command authorization table does not exist, the BNH189E RETURN CODE FROM THE
SAFNODEC setting is used for command authorization RACROUTE request_type REQUEST
decisions until the dataspace problem has been IS X'racroute_return', THE
resolved. SECURITY PRODUCT RETURN
CODE IS X'security_return', AND
Message BNH189 is issued following this message
THE SECURITY PRODUCT REASON
to give the security product return codes. When
CODE IS X'security_reason'
the problem with the dataspace for the NETCMDS
class is resolved, message BNH188 is issued and
command authorization checks in the NETCMDS class Explanation
are resumed.
This message is used to display the security product
return codes after an error has been detected.
Operator response This message might follow other messages, such as
BNH187, which describe the specific error.
Notify the system programmer or security
administrator. Message Variables

168 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


request_type Operator response
Request type that was used on the RACROUTE
macro invocation Notify the system programmer.
racroute_return
The RACROUTE macro return code System programmer response
security_return Correct one or both CNMSTYLE statements. For more
The security product return code information, see instructions in CNMSTYLE sample.
security_reason BNH193I ERROR MONITORING SYSLOG
The security product reason code 'filename'

System action Explanation


The system action is dependent on the error that The NetView program has encountered an error
caused this message to be issued. attempting to receive updates from the specified
USS syslog file. Possible problems fall into these
System programmer response general areas: problems with the NetView UNIX pipe
stage, problems with the OMVS tail command, or
See previous error messages that apply to the data in problems with the format of a syslog record. Additional
this message. messages accompany message BNH193 that further
BNH190E VALUE value WAS CHOSEN FOR identify the problem.
KEYWORD keyword BUT THE SAF Message Variables
PRODUCT IS NOT ACTIVE
filename
The fully qualified name of the USS syslog file that
Explanation is being monitored for updates.
The keyword and value caused a status request to be
issued against the SAF product, but the SAF product System action
did not return an active status.
For UNIX pipe stage or tail command errors, the
Message Variables NetView program stops monitoring the file. For record
value format errors, processing continues, but the incorrect
The value of the keyword syslog entry is ignored and logged.
keyword
The specified keyword Operator response
Notify the system programmer.
System action
The REFRESH command fails. System programmer response
Examine the additional messages that accompany
Operator response BNH193 to determine the cause of the problem.
Notify the system programmer. BNH194E KEYWORD keywd IS MISSING

System programmer response Explanation


Activate the SAF product, then issue the REFRESH A required keyword is missing from a command or
command again to obtain the settings that are wanted. definition.
BNH191E Policy autotask is different from Message Variables
AON autoTask. This configuration keywd
is not supported. The missing keyword.

Explanation System action


function.autotask.Policy and function.autotask.AON The command or definition fails, subject to other
are incorrectly defined in the CNMSTYLE statements. accompanying messages.

Chapter 3. BNH Prefix Messages 169


Operator response Operator response
See the applicable command help or contact the Start the external log task DSIELTSK.
system programmer.
System programmer response
System programmer response
Verify that the external log task DSIELTSK is active.
Correct the associated definition.
BNH197E UNABLE TO WRITE TO EXTERNAL
BNH195E AN INCORRECT AUDIT LOG, CMDDEF STATEMENT
SPECIFICATION WAS FOUND IN DSIELDAT IS MISSING
THE COMMAND AUTHORIZATION
TABLE Explanation
The NetView program tried to write a record to
Explanation
the external log, but the write failed because the
The audit specification format was incorrect. The DSIELDAT CMDDEF statement is not specified in
correct format of the AUDIT specification is one of the CNMCMD for the external log function. This can occur
following: if you are auditing a command authorization table, but
the appropriate setup has not been performed for the
• PROTECT (AUDIT=value) command_identifier
external log.
• EXEMPT (AUDIT=value) command_identifier
where value for PROTECT can be FAILURES, ALL, or System action
NONE, and value for EXEMPT can be ALL, or NONE.
Up to 255 bytes of the table load statement in error Processing continues with no record being written to
are included in message BNH256I, which follows this the external log.
message.
Operator response
System action Check for the external log CMDDEF statement
This table load statement is ignored; processing of the DSIELDAT in CNMCMD.
remaining table load statements continues.
System programmer response
Operator response Include the external log CMDDEF statement DSIELDAT
Notify the system programmer or the person in charge in CNMCMD. If you add a CMDDEF statement, recycle
of writing the command authorization table load the NetView program for the statement to take effect.
statements. Or, use ADDCMD to dynamically add the DSIELDAT
command. See the online help for more information
about ADDCMD. External logging resumes when the
System programmer response DSIELTSK task is restarted.
Edit the set of table load statements identified in the BNH198I TEST OF COMMAND
message. Correct the syntax error that was identified. AUTHORIZATION TABLE tblname
BNH196E UNABLE TO WRITE TO EXTERNAL COMPLETED WITH ERRORS
LOG, DSIELTSK IS NOT ACTIVE
Explanation
Explanation This message is displayed after the TEST option of
The NetView program tried to write a record to the the REFRESH CMDAUTH=TABLE command completes.
external log, but the write failed because the external Errors were encountered while testing the table.
log task DSIELTSK is not active. This can occur if you Message Variables
are auditing a command authorization table and the
external log has not been properly set up. tblname
The name of the table being tested

System action
System action
Processing continues with no record being written to
the external log. The command completes with errors.

170 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH199E AN INTERNAL ERROR OCCURRED BNH200E VALUE value1 FOR KEYWORD
WHILE SCANNING THE COMMAND keyword IS IGNORED. DEFAULT
AUTHORIZATION TABLE FOR THE VALUE value2 IS USED.
COMMAND 'command_name' AND
THE USER ID 'userid' Explanation
The command or statement has conflicting keywords
Explanation
or keyword values that are not valid. The specified
An internal error occurred, preventing the command value1 for the keyword is ignored and the default value
authority check from being completed. is used.
Message Variables Message Variables
command_name value1
The name of the command being checked in The ignored value
the command authorization table. If a keyword keyword
authorization was in process at the time of the The ignored keyword
error, the keyword name and value name are also
shown. Command_name can be in any of the value2
following forms: The default value being used

• command
System action
• command.keyword
The command fails or the statement uses the default
• command.keyword.value
value.
The command, keyword, and value that are shown
have already undergone translation for the special Operator response
reserved characters. For example, any asterisks (*)
have been changed to plus signs (+). Verify that the default values are acceptable. If not,
notify the system programmer.
userid
The user ID that is being checked in the command
authorization table. If AUTHCHK=SOURCEID is in System programmer response
effect, this user ID can be different from the user
Update the appropriate command or statement.
ID of the task that is running the command. For
information about AUTHCHK=SOURCEID, see the BNH202E UNIX SYSTEM SERVICE service
REFRESH command. FAILED. SOCKET CLOSED.

System action Explanation


Because a command authority check cannot be A failure has occurred in a UNIX system service call.
completed, the authority to issue the command is not This message follows message BNH148E.
granted.
Message Variables

Operator response service


The UNIX service name that failed.
Notify the system programmer.
System action
System programmer response
The request fails.
Look for a series of DWO050 messages in the NetView
log that provides more information about the location
of the problem. Contact IBM Software Support with
Operator response
this information. Notify the system programmer.
See the IBM Z NetView Administration Reference for
more information about which characters are reserved System programmer response
and translated.
See the appropriate manual in the Open Edition MVS
library for more information regarding the error.

Chapter 3. BNH Prefix Messages 171


BNH203E VALUE value FOR KEYWORD Operator response
keyword IS INCORRECT
Check the values for the keywords and enter the
command again.
Explanation
An incorrect definition was encountered during System programmer response
processing.
Evaluate the combination of values for the keywords
Message Variables and change values as needed.
value BNH208E VALUE value WAS CHOSEN FOR
The keyword value KEYWORD keyword BUT THE
keyword classname SECURITY CLASS OF
The incorrect keyword THE SAF PRODUCT CANNOT BE
ACCESSED
System action
Explanation
The command or NetView initialization fails.
The specified keyword and value caused a status
request to be issued against the SAF product for the
Operator response given classname, but the SAF product did not return a
Notify the system programmer. status.
Message Variables
System programmer response
value
Correct the definition. The value of the keyword
BNH207E VALUE value1 FOR KEYWORD keyword
keyword1 CONFLICTS WITH The specified keyword
VALUE value2 FOR KEYWORD classname
keyword2 The name of the class (NETCMDS, NETSPAN, or
APPL)
Explanation
System action
The command or statement has conflicting keywords
or keyword values that are not valid. If this message If this message is issued during NetView initialization,
results from a TCPCONN command, the command initialization fails. Otherwise, the REFRESH command
fails. Otherwise, the specified value for the keyword fails.
is ignored and the default value is used.
Message Variables Operator response
value1 Notify the system programmer.
The value of the first keyword
keyword1 System programmer response
The first keyword
Check that you have RACF 2.1 or an equivalent SAF
value2 product installed and that the given class is active.
The value of the second keyword
BNH209E THE cmdclass SECURITY CLASS
keyword2
COULD NOT BE LOADED INTO
The second keyword
STORAGE

System action
Explanation
The command fails or the statement uses the default
During a REFRESH command, the NetView program
value.
issued a RACROUTE REQUEST=LIST,GLOBAL=YES to
load the specified security class into storage, but the
load failed. This message is accompanied by message
BNH182.

172 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables Explanation
cmdclass The command authorization table that is specified on
The name of the class (NETCMDS) the SECOPTS.CMDAUTH statement in the CNMSTYLE
member, or on the REFRESH command, fails to
System action initialize.

The command fails. Message Variables


tblname
Operator response The name of the table

Notify the system programmer.


System action
System programmer response If this message is issued during NetView initialization,
then initialization fails. If this message is issued in
Verify that the GLOBAL=YES option is available and response to a REFRESH command, the REFRESH
active for the security product for the specified class. command fails.
BNH210I COMMAND AUTHORIZATION
TABLE tblname HAS BEEN Operator response
INITIALIZED
Check the value that was specified for tblname on
the REFRESH command. If this error occurs during
Explanation initialization, notify the system programmer.
A command authorization table has been initialized
during NetView initialization or REFRESH command System programmer response
processing.
Ensure that the table name specified is in the
Message Variables DSIPARM concatenation. If this error occurs during
tblname NetView initialization, ensure that the table name
The name of the command authorization table is entered correctly on the SECOPTS.CMDAUTH
statement in the CNMSTYLE member. See the
messages that were issued previously to determine
System action the exact cause of the error.
The command completes successfully. BNH213E BACKUP COMMAND
BNH211I BACKUP COMMAND AUTHORIZATION TABLE tblname
AUTHORIZATION TABLE backtbl INITIALIZATION FAILURE
HAS BEEN INITIALIZED
Explanation
Explanation A backup command authorization table that is
A backup command authorization table has been specified on the REFRESH command failed to initialize.
initialized during NetView initialization or REFRESH Message Variables
command processing.
tblname
Message Variables The name of the backup table
backtbl
The name of the backup table System action
The REFRESH command fails.
System action
The command completes successfully. Operator response
BNH212E COMMAND AUTHORIZATION Check the value that is specified for BACKTBL on the
TABLE tblname INITIALIZATION REFRESH command.
FAILURE

Chapter 3. BNH Prefix Messages 173


System programmer response option
The name of the option.
Ensure that the backup table name specified is in
the DSIPARM concatenation. See messages that were
issued previously to determine the exact cause of the System action
error. The command ends, and the operation is not
BNH214E KEYWORD keyword1 CONFLICTS performed.
WITH VALUE value2 FOR
KEYWORD keyword2 Operator response
Check the value for the keyword1, and enter the
Explanation command again.
The command or statement has conflicting keywords
or keyword values that are not valid. The specified System programmer response
value for the keyword is ignored and the default value
is used. Check that the value entered and the current setting
for the option. If the message is a response to a
Message Variables REFRESH command, you can use the LIST SECOPTS
keyword1 command to display the current setting. If the
The first keyword message is a response to a DEFAULTS or OVERRIDE
command, check the value that is given for the option
value2 in the CNMSTYLE member, or list the current default
The value of the second keyword value. Either change the value of the keyword1 or
keyword2 change the value for the option.
The second keyword
BNH217E REFRESH OPERS COMMAND HAS
NO EFFECT WHEN USING THE
System action SAFDEF OPTION
The command fails or the statement uses the default
value. Explanation
A REFRESH OPERS command was entered while the
Operator response current option for operator security is SAFDEF.
Check the keywords and enter the command again.
System action
System programmer response The command ends with no action taken.
Evaluate the keyword and value combination and BNH218I TEST OF COMMAND
change the keywords or values as necessary. AUTHORIZATION TABLE tblname
COMPLETED SUCCESSFULLY
BNH215E VALUE value1 FOR KEYWORD
keyword1 CONFLICTS WITH
CURRENT VALUE value2 FOR Explanation
option
This message is displayed after the TEST option of the
REFRESH CMDAUTH=TABLE command completes.
Explanation
Message Variables
The value for the specified keyword1 conflicts with the
tblname
current setting of the specified option.
The name of the table being tested
Message Variables
value1 System action
The value of the keyword
The command completes successfully.
keyword1
The keyword BNH219E command COMMAND FAILED. dd
NOT ALLOCATED.
value2
The current value of the conflicting option

174 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation See the IBM Z NetView Security Reference for an
explanation of the default values used for each
An attempt was made to open the data set associated attribute.
with the specified DD, but the DD is not allocated. For
the REFRESH command, DSIPRF is needed for profile
information when operators are defined through the Operator response
NetView program. Verify the value and notify the system programmer if it
Message Variables is not an allowable value.

command
The command that failed System programmer response
dd Check the NetView segment of the security software
The DD that is not allocated product to see if the value for the specified keyword
must be corrected in the segment.
System action BNH221E USER IS NOT AUTHORIZED TO
domain_name IN THE SECURITY
The command ends.
SOFTWARE APPL CLASS

Operator response
Explanation
Determine whether you entered the command
The operator trying to log on has not been permitted
correctly. If the command is entered correctly, allocate
to access the profile in the security product APPL class
the specified data set. If the data set cannot be
for this NetView domain name.
allocated, notify the system programmer.
Message Variables
System programmer response domain_name
The name of this domain
Allocate the data set.
BNH220E UNEXPECTED DATA VALUE System action
ENCOUNTERED FOR KEYWORD
keyword IN THE NETVIEW The attempted logon is rejected.
SEGMENT OF THE SECURITY
PRODUCT FOR OPERATOR opid. Operator response
THE DEFAULT VALUE OF value IS
USED Contact your security administrator in order to be
permitted to access the profile in the APPL class that
protects this NetView system.
Explanation
During logon processing, a keyword with an incorrect System programmer response
value was found in the NetView segment of the
security software product. Permit the user ID of the operator to access the profile
protecting the NetView system in the security software
Message Variables APPL class.
keyword
BNH223E SPAN spanname CANNOT BE
The keyword from the NetView segment
ACTIVATED FOR operid
opid
The operator ID
Explanation
value
The default value being used The specified span cannot be activated for the named
operator because of one of the following reasons:
System action • The operator has not been authorized to start the
span in the NETSPAN class of the security product.
Logon processing continues with the default value
being used. • The operator has CTL=GLOBAL specified, and
starting the span is not necessary and is not allowed.
• The span is not defined in the NETSPAN class of the
security product.

Chapter 3. BNH Prefix Messages 175


• The NETSPAN class of the security product is not resource
active. The resource name queried
The CTL=GLOBAL setting is specified either in the accesslvl
DSIPRF profile of the operator or in the NETVIEW The requested access level of the resource
segment of the security product. IF OPERSEC=SAFDEF BNH225I operid IS NOT ALLOWED ACCESS
was in effect when the operator logged on, the CTL TO resource AT ACCESS LEVEL
setting was obtained from the NETVIEW segment accesslvl
of the security product. For more information about
OPERSEC, see the REFRESH command.
Explanation
Message Variables
This message is displayed when an operator issues
spanname a QRS command. The operid is denied access to
The name of the span the resource at the specified access level. When
operid running span-of-control for resource, the resource is
The operator identifier not defined in one of the active spans at that operid
access level.
System action Message Variables
The command ends and the span is not activated. operid
The NetView operator ID
Operator response resource
The queried resource name
If the specified span must be activated, see the
system programmer. accesslvl
The requested access level to the resource.
System programmer response BNH226I PROFILES ARE NOT USED
WHEN OPERATORS ARE DEFINED
Add the span to the NETSPAN class, if necessary, and
THROUGH SAF
ensure the operator has access to the span.
BNH224I operid IS ALLOWED ACCESS Explanation
TO resource AT ACCESS LEVEL
accesslvl An attempt was made to either list the contents of a
profile or to provide a list of profile names. Profiles are
not used when OPERSEC=SAFDEF.
Explanation
This message is displayed after an operator issues a System action
QRS command. The operid can access the resource
at the specified access level. When running span of Profiles are not displayed.
control for resources, the following conditions apply: BNH227I SCOPE INFORMATION IS
• The operator has SPECIFIC specified for that CTL NOT AVAILABLE. COMMAND
logon attribute (the default) and the resource is AUTHORITY CHECKING IS BEING
defined in one of the active spans at the specified DONE THROUGH option.
access level for the operator.
• The operator has GLOBAL specified for the CTL logon Explanation
attribute.
An attempt was made to list the commands available
• The operator has GENERAL specified for the CTL to an operator using the SCOPE option, but this
logon attribute and this resource is defined in one method of command authority verification is no longer
of the active spans at the specified access level for supported.
the operator, or this resource is not in any defined
span. Message Variables

Message Variables option


The option being used for command authority
operid verification, such as TABLE or SAF
The NetView operator ID

176 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The command ends and no action is taken. This message is part of a multiline write-to-operator
(MLWTO) message. It is displayed after messages
BNH228I OPTION VALUE LAST UPDATED BNH228I and BNH229I.
UPDATE ID

System action
Explanation
The LIST SECOPTS command completes.
This message contains column headings for the
LIST SECOPTS command. This message is part of a BNH231E TASK taskname COULD NOT
multiline write-to-operator (MLWTO) with messages OBTAIN EXTENDED CONSOLE
BNH229I and BNH230I following. console_name. CONSOLE NAME IS
NOT VALID.
System action
Explanation
LIST SECOPTS data follows this message.
A NetView task attempted to obtain an extended
BNH229I option value mm/dd/yy hh:mm:ss console, but the console name used does not comply
updateid with the rules for EMCS console names.
Message Variables
Explanation
taskname
The operator issued the LIST SECOPTS command.
The task that attempted to obtain the console
This message is part of a multiline write-to-operator
(MLWTO) and is displayed after the header message console_name
BNH228I. This message contains either the security The console name specified
options and information about the options or a
separator line. This message is followed by message System action
BNH230I.
If the command entered was GETCONID, no console is
Message Variables obtained. If an MVS command was entered, a console
option is not obtained and the MVS command is not issued.
Thev eight-character field containing the name of
the security option, for example, AUTHCHK. Operator response
value Use the GETCONID with the CONSOLE= keyword to
The eight-character field containing the value of specify a valid console name.
the security option.
mm/dd/yy hh:mm:ss
System programmer response
The 17-character date and time of the last update
to the security option. The date and time formats An incorrect extended console name was detected.
depend on the TRANSMSG member, when in This console name was either:
effect, and on the date and time operands of the
• Specified on the CONSOLE= parameter of the
DEFAULTS and OVERRIDE commands.
GETCONID command
updateid
• The default console when GETCONID did not include
The ID of the last task to update the security
a CONSOLE= parameter
option or INITIALIZATION if the option has not
been changed by any task. • The default console when the MVS command was
issued
System action The default console name is either:
Security options data is displayed. • The name specified on the SETCONID command.

BNH230I END OF LIST SECOPTS • The name determined from the value of ConsMask
INFORMATION in the CNMSTYLE member, when that value is not
an asterisk (*). For more information about the
ConsMask statement, see the CNMSTYLE member.

Chapter 3. BNH Prefix Messages 177


• The name defined with the CONSNAME keyword in Operator response
the NetView segment of the SAF product.
Notify the person in your organization who is
• The name defined with the CONSNAME keyword in responsible for security administration that you are
the NetView operator profile. unable to issue the command.
• The task name if no other name was assigned.
For information about AUTHCHK=SOURCEID, see the
Correct the console name. The name must be 2 - 8 REFRESH command or the IBM Z NetView Security
characters, as required by MVS. Valid characters for Reference.
console names are A-Z, 0-9, @, #, or $. The first
character of the console name must be alphabetic (A-
System programmer response
Z) or one of the following special characters: @, #, or
$. If the user is required to issue the command as part
of their duties, modify the security definitions to allow
Note: If the console name defaulted to the task
access to the command. Message BNH233E is also
name, the task name might not be a valid console
displayed to identify the command ID that prevented
name. In this case, consider using the GETCONID or
the user ID from issuing the command.
SETCONID command with the CONSOLE= keyword in
this operator's initial command list. If the console BNH233E THE COMMAND 'command' IS
name contains one or more asterisks, it is likely that PROTECTED BY COMMAND
the value that is chosen for the ConsMask statement in IDENTIFIER 'commandid' IN
the CNMSTYLE member is incorrect. In this case, reset 'auth_method'
the common global variable CNMSTYLE.CONSMASK to
a valid mask value as described in the CNMSTYLE
Explanation
member. Then, the problem is resolved on a given
task after the next logon or after a new console A user ID is not authorized to issue command
name is specified using the GETCONID or SETCONID protected by commandid.
command. See IBM Z NetView Installation: Getting
Message Variables
Started for information about updating the CNMSTYLE
member. command
The command as defined in the CMDDEF
BNH232E 'userid' IS NOT AUTHORIZED TO
statement. This is inserted even if a synonym
ISSUE COMMAND 'command'
for the command was issued by the user. The
insert might contain 2 question marks, '??', if
Explanation a suppression character was used when the
command was issued.
The userid does not have the necessary authorization
to issue command. commandid
The command identifier that prevented the user
Message Variables from issuing the command. If the command
userid identifier is not known, the value '-NOT
The user ID attempting to issue the command. If AVAILABLE-' is inserted in its place. If a
AUTHCHK=SOURCEID is in effect, this user ID can suppression character was used, the value '??'
be different from the user ID of the task that is might be inserted for the command identifier.
running the command. auth_method
command The method of command authorization in effect
The command as defined in the CMDDEF when the failure occurred.
statement. This is inserted even if a synonym
for the command was issued by the user. The System action
insert might contain 2 question marks, '??', if
a suppression character was used when the The command issued by the user ID is rejected.
command was issued.
Operator response
System action Notify the person in your organization who is
The command is rejected. responsible for security administration that you are
unable to issue the command.

178 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
If the user is required to issue the command as part A user ID is not authorized to issue a command with
of their duties, modify the security definitions in use to the specified keyword because it is protected by the
allow access to the command identifier. The BNH232E commandid specified.
message is issued before this message to identify the
Message Variables
command that is issued and the user ID that is not
authorized to issue the command. keyword
The keyword as specified by the command
BNH234E 'userid' IS NOT AUTHORIZED TO processor. This is inserted even if a synonym
USE KEYWORD 'keyword' for the keyword was issued by the user. The
insert might contain 2 question marks, '??', if
Explanation a suppression character was used when the
command was issued.
The userid does not have the necessary authorization
to use the specified keyword. commandid
The command ID that prevented the user from
Message Variables issuing a command with the keyword. If the
userid command ID is not known, the value '-NOT
The user ID attempting to issue the command. If AVAILABLE-' is inserted. If a suppression character
AUTHCHK=SOURCEID is in effect, this user ID can was used, the value '??' might be inserted for the
be different from the user ID of the task that is command identifier.
running the command. auth_method
keyword The method of command authorization in effect
The keyword as specified by the command when the failure occurred.
processor. This is inserted even if a synonym
for the keyword was issued by the user. The System action
insert might contain 2 question marks, '??', if
a suppression character was used when the The command is rejected.
command was issued.
Operator response
System action Notify the person who is responsible for security in
The command is rejected. your organization that you are unable to issue the
command with the keyword.
Operator response
System programmer response
Notify the person in your organization who is
responsible for security administration that you were If the user is required to issue the command and
unable to issue the command with the keyword keyword as part of their duties, modify the security
specified. definitions in use to access the command identifier.
The BNH234E message, which is issued before this
For information about AUTHCHK=SOURCEID, see the message, identifies the keyword that was issued and
REFRESH command or the IBM Z NetView Security the user ID that was not authorized to issue the
Reference. command with the keyword.
BNH236E 'userid' IS NOT AUTHORIZED TO
System programmer response USE THE KEYWORD 'keyword' AND
If the user is required to issue the keyword as part of VALUE 'value' COMBINATION
their duties, modify the security definitions in use to
allow them to access the command identifier. Message Explanation
BNH235E is issued to identify the command ID that
prevented the user ID from issuing the keyword. The userid does not have the necessary authorization
to use the specified keyword and value combination.
BNH235E THE KEYWORD 'keyword' IS
PROTECTED BY COMMAND Message Variables
IDENTIFIER 'commandid' IN userid
'auth_method' The user ID attempting to issue the command. If
AUTHCHK=SOURCEID is in effect, this user ID can

Chapter 3. BNH Prefix Messages 179


be different from the user ID of the task that is a suppression character was used when the
running the command. command was issued.
keyword value
The keyword as specified by the command The value specified for the keyword by the user
processor. This is inserted even if a synonym or the value as defined in the CMDDEF statement.
for the keyword was issued by the user. The The insert might contain 2 question marks, '??',
insert might contain 2 question marks, '??', if if a suppression character was used when the
a suppression character was used when the command was issued.
command was issued. commandid
value The command ID that prevented the user from
The value specified for the keyword by the user issuing a command with the keyword and value
or the value as defined in the CMDDEF statement. combination. If the command ID is not known,
The insert might contain 2 question marks, '??', the value '-NOT AVAILABLE-' is inserted. If a
if a suppression character was used when the suppression character was used, the value '??'
command was issued. might be inserted for the command identifier.
auth_method
System action The method of command authorization in effect
when the failure occurred.
The command is rejected.

System action
Operator response
The command is rejected.
Notify the person in your organization who is
responsible for security administration that you were
unable to issue the command with the keyword and Operator response
value that you specified. Notify the person in your organization who is
For information about AUTHCHK=SOURCEID, see the responsible for security administration that you are
REFRESH command or the IBM Z NetView Security unable to issue the command with the keyword and
Reference. value.

System programmer response System programmer response


If the user is required to issue the keyword and value If the user is required to issue the command with
as part of their duties, modify the security definitions the keyword and value as part of their duties, modify
in use to allow them to access the command ID. the security definitions in use to permit them to the
Message BNH237E is issued to identify the command command identifier. Message BNH236E is issued prior
ID which prevented the user ID from issuing the to this message to identify the keyword and value that
keyword and value combination. was issued and the user ID that is not authorized
to issue the command with the keyword and value
BNH237E THE KEYWORD 'keyword' AND combination.
VALUE 'value' ARE PROTECTED
BY COMMAND IDENTIFIER BNH238E UNEXPECTED RETURN CODE
'commandid' IN 'auth_method' FROM THE SYSTEM
AUTHORIZATION FACILITY.
RACROUTE MACRO RC IS
Explanation X'racroute_rc', REQUEST TYPE IS
A user ID is not authorized to issue a command with 'request', SECURITY PRODUCT
the specified keyword and value combination because RC IS X'security_rc', SECURITY
it is protected by the commandid specified. PRODUCT REASON CODE
IS X'security_rsn', COMMAND
Message Variables IDENTIFIER IS 'identifier'
keyword
The keyword as specified by the command Explanation
processor. This is inserted even if a synonym
for the keyword was issued by the user. The An unexpected return code was received from the SAF
insert might contain 2 question marks, '??', if program.
Message Variables

180 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


racroute_rc userid
The RACROUTE macro return code. The user ID attempting to establish a security
request environment
The type of request that was passed to the security opersec
product. The OPERSEC setting when the message was
security_rc issued, or 'SUBMIT', if the error is related to the
The return code from the security product. SUBMIT command processing

security_rsn macro_rc
The reason code from the security product. The return code from the RACROUTE macro

identifier request_type
The command identifier passed to the system The type of request specified on the RACROUTE
authorization facility. The command identifier macro
consists of the netid, luname, command, keyword environment
(if present), and value (if present) concatenated The function specified on the RACROUTE macro
with a period as the separator between fields. rc
When a command identifier is not required for The return code from the security product
the request type, N/A is inserted. If a suppression
character was used, the value '??' might be rsncode
inserted for the command identifier. The reason code from the security product

System action System action


If a backup command authorization table is available, If this message is issued because of the reconciling
the command authority is determined by searching of security environments after a REFRESH of the
the backup table. If a backup command authorization OPERSEC setting (the value of 'opersec' is not
table is not available, a command authority check 'SUBMIT'):
cannot be completed, and the authority to issue the • An attempt to establish the security environment is
command is not granted. made each time a command is issued.
• Message BNH273I is issued when the security
Operator response environment is successfully updated.
Notify the system programmer or the person in • If CMDAUTH is set to TABLE or SAF and a backup
your organization responsible for the security of the table is specified, command processing continues.
command issued, the return code, and the request If CMDAUTH is set to SAF and no backup table is
type. specified, all commands to be verified by the SAF
product are rejected until the security environment
BNH239E THE SECURITY ENVIRONMENT is established.
FOR userid CANNOT BE
ESTABLISHED FOR THE OPERSEC
VALUE OF 'opersec'. THE Operator response
RACROUTE MACRO RETURN CODE Notify the system programmer or the person in
IS 'macro_rc' FOR 'request_type' your organization responsible for security. Provide the
AND 'environment'. THE SECURITY complete message text to help with the resolution of
PRODUCT RETURN CODE IS 'rc' the problem.
AND THE REASON CODE IS
'rsncode'
System programmer response
Explanation Make any necessary changes to the security product
based on the information provided with this message.
The NetView program cannot update the security Examine the RACROUTE macro return code and
environment for the user. This failure can occur if the the security product return and reason codes for
user is not defined to the security product or if the the request type and environment. An attempt to
security product is not active. establish the security environment is made each time
Message Variables a command is issued. Message BNH273I is issued
when the security environment is established.

Chapter 3. BNH Prefix Messages 181


BNH240E THE COMMAND AUTHORIZATION Operator response
TABLE tblname DOES NOT EXIST
If your intent was not to bypass command
authorization processing, check the value specified for
Explanation tblname on the REFRESH command.
The command authorization table that is specified on
the SECOPTS.CMDAUTH statement in the CNMSTYLE System programmer response
member, or on the REFRESH command, does not exist
and cannot be initialized. If you want command authorization to be performed,
use the REFRESH command to specify a different
Message Variables command authorization table or to specify another
tblname method of command authorization processing.
The name of the table BNH242E A COMMAND IDENTIFIER HAS A
LENGTH ERROR IN THE COMMAND
System action AUTHORIZATION TABLE

If this message was issued during NetView


initialization, initialization fails. If this message is Explanation
issued in response to a REFRESH command, the A command identifier in the command authorization
REFRESH command fails. table has either a total length that is not valid or a
field length that is incorrect. Up to 255 bytes of the
Operator response table load statement in error are included in message
BNH256I.
Check the value specified for tblname on the REFRESH
command. If the error occurred during initialization,
notify the system programmer. System action
This table load statement is ignored, and processing of
System programmer response the remaining table load statements continues.

Ensure that the table name that is specified


is available through the DSIPARM data set Operator response
concatenation. If the error occurred during NetView Notify the system programmer or person in charge
initialization, ensure that the table name is specified of writing the command authorization table load
correctly on the SECOPTS.CMDAUTH statement in the statements.
CNMSTYLE member.
BNH241I THE COMMAND AUTHORIZATION System programmer response
TABLE tblname CONTAINS NO
Locate the incorrect table load statement. The total
VALID STATEMENTS
length of the command identifier must be less
than or equal to 246 characters. Also, each field
Explanation of the command identifier must contain 1 or more
The command authorization table contains no valid characters. If table variables are being used, ensure
statements. that the variable values that are substituted into the
command identifier do not cause the total length of
Message Variables the command identifier to exceed 246 characters.
tblname BNH243E AN UNDEFINED VARIABLE
The name of the table varname WAS FOUND IN
THE COMMAND AUTHORIZATION
System action TABLE

Because there are no valid statements in the table, no


command authorization is performed. Explanation
An undefined table variable is used in a command
authorization table load statement. Up to 255 bytes
of the table load statement in error are included in
message BNH256I.

182 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables Explanation
varname A command authorization table load statement
The name of the table variable contains an unrecognized statement type. Up to 255
bytes of the table load statement in error are included
System action in message BNH256I.

The table load statement is ignored, and processing of Message Variables


the remaining table load statements continues. stmt_type
The statement type in error
Operator response
Notify the system programmer or person in charge System action
of writing the command authorization table load The table load statement is ignored, and processing of
statements. the remaining table load statements continues.

System programmer response Operator response


Examine the table load statements and ensure that Notify the system programmer or the person in charge
the table variable that is identified in the message is of writing the command authorization table load
defined before being used. statements.
BNH244E AN INCORRECT NUMBER OF
FIELDS WAS FOUND FOR System programmer response
A COMMAND IDENTIFIER IN
THE COMMAND AUTHORIZATION Examine the table load statements identified to find
TABLE and correct the statement type in error. This message
can also be displayed when other syntax errors exist,
and the NetView program is attempting to process
Explanation some other part of your table as a statement type.
A command identifier in a table load statement has BNH246E AN UNMATCHED '<BEGIN>' OR
either too many or too few fields. Up to 255 bytes '<END>' LABEL WAS FOUND IN
of the table load statement in error are included in THE COMMAND AUTHORIZATION
message BNH256I. TABLE

System action Explanation


The table load statement is ignored, and processing of A <BEGIN> or <END> label is incorrect in the
the remaining table load statements continues. command authorization table. Up to 255 bytes of the
table containing the error are included in message
Operator response BNH256I.

Notify the system programmer or person in charge


of writing the command authorization table load System action
statements. If 2 <BEGIN> labels are encountered without an
intervening <END> label, information that exists
System programmer response between the first and second <BEGIN> labels is
discarded, and the second <BEGIN> label starts a new
Examine table load statements and ensure that the table statement.
command identifier has the appropriate format. This
message might also be displayed when other syntax
errors exist and the NetView program is attempting to Operator response
process some other part of your table as a command Notify the system programmer or person in charge
identifier. of writing the command authorization table load
BNH245E AN UNRECOGNIZED STATEMENT statements.
TYPE stmt_type WAS FOUND IN
THE COMMAND AUTHORIZATION
TABLE

Chapter 3. BNH Prefix Messages 183


System programmer response Message Variables

Examine the set of table load statements to find and varname


correct the usage of <BEGIN> and <END> labels. The variable name
Ensure that each <BEGIN> label has a corresponding
<END> label and that each <END> label has a System action
corresponding <BEGIN> label. Errors in <BEGIN> and
<END> labels can cause other errors to be noted The table load statement is ignored, and processing of
in surrounding statements. You might receive this the remaining table load statements continues.
message if an error is found in a different <BEGIN>
or <END> label, causing a <BEGIN> and <END> label Operator response
mismatch. If this is the cause, correcting the error in
the label resolves the label mismatch. You might also Notify the system programmer or person in charge
receive this message if there are too many records of writing the command authorization table load
coded between a <BEGIN> and the matching <END>. statements.
If so, there is a preceding BNH247E message.
BNH247E THE MAXIMUM LENGTH FOR A
System programmer response
TABLE LOAD STATEMENT WAS Examine the table load statements to ensure that the
EXCEEDED IN THE COMMAND table variable names are 1-32 characters in length.
AUTHORIZATION TABLE
BNH249E AN INCORRECT TABLE VARIABLE
USAGE WAS FOUND IN
Explanation THE COMMAND AUTHORIZATION
A table load statement exceeds the maximum TABLE
allowable length of 4096 bytes. Up to 255 bytes of the
table load statement in error are included in message Explanation
BNH256I.
A table variable is used incorrectly in a command
identifier. Up to 255 bytes of the table load statement
System action in error are included in message BNH256I.
The table load statement is ignored and processing of
the remaining table load statements continues. System action
The table load statement is ignored, and processing of
Operator response the remaining table load statements continues.
Notify the system programmer or person in charge
of writing the command authorization table load Operator response
statements.
Notify the system programmer or person in charge
of writing the command authorization table load
System programmer response statements.
Ensure that the table load statements do not exceed
the maximum length. System programmer response
BNH248E THE VARIABLE NAME Examine the table load statements to ensure that the
varname USED IN THE table variables are used only to replace entire fields of
COMMAND AUTHORIZATION the command identifier.
TABLE EXCEEDED THE MAXIMUM
ALLOWABLE LENGTH BNH250E AN INCOMPLETE 'stmttype'
DEFINITION WAS FOUND IN
THE COMMAND AUTHORIZATION
Explanation TABLE
A command authorization table contains a table
variable that is not valid. The variable name must be Explanation
1-32 characters in length. Up to 255 bytes of the
table load statement in error are included in message An incomplete statement was found in the command
BNH256I. authorization table. For example, a PROTECT
statement type was found without a corresponding

184 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command identifier. Up to 255 bytes of the table load Explanation
statement in error are included in message BNH256I.
A PROTECT, PERMIT, or EXEMPT statement in the
Message Variables command authorization table contains a command
stmttype identifier that uses a generic character improperly. Up
The type of the statement in error (PROTECT, to 255 bytes of the table load statement containing
EXEMPT, PERMIT, GROUP, or SETVAR) the error are included in message BNH256I.

System action System action


The table load statement is ignored, and processing of The table load statement is ignored, and processing of
the remaining table load statements continues. the remaining table load statements continues.

Operator response Operator response


Notify the system programmer or person in charge Notify the system programmer or person in charge
of writing the command authorization table load of writing the command authorization table load
statements. statements.

System programmer response System programmer response


Examine the set of table load statements identified in Examine the set of table load statements identified
the message and correct the problem. in the message. Ensure that the generic character (*)
is used only as a field replacement or as a trailing
BNH251E A DUPLICATE 'SETVAR' character in a field. For example, NETA.CNM*.* and
DEFINITION WAS FOUND IN NETA.CNM01.ABC* are valid, but NETA.CNM01.A*BC
THE COMMAND AUTHORIZATION is not. Another example is PROTECT * .*.*. that fails
TABLE because the * is followed by a space on the same
record, which is not the end of the command.
Explanation BNH253E THE GROUP NAME OR
More than one SETVAR statement is used for the USERID name USED IN
same table variable. Up to 255 bytes of the table load THE COMMAND AUTHORIZATION
statement in error are included in message BNH256I. TABLE EXCEEDED THE MAXIMUM
ALLOWABLE LENGTH
System action
Explanation
The table load statement is ignored, and processing of
the remaining table load statements continues. A group name or user ID used in the command
authorization table is not valid. Up to 255 bytes of the
table load statement in error are included in message
Operator response BNH256I.
Notify the system programmer or person in charge Message Variables
of writing the command authorization table load
statements. grpname
The group name or user ID in error
System programmer response
System action
Examine the set of table load statements identified in
the message. Ensure that all table variable names are The table load statement is ignored, and processing of
unique. the remaining table load statements continues.

BNH252E A COMMAND IDENTIFIER HAS AN


INCORRECT USE OF A GENERIC Operator response
CHARACTER IN THE COMMAND Notify the system programmer or person in charge
AUTHORIZATION TABLE of writing the command authorization table load
statements.

Chapter 3. BNH Prefix Messages 185


System programmer response BNH256I member_name :
sequence_number : load_statement
Examine the set of table load statements identified in
the message. Ensure that all group names and user
IDs are entered correctly. Group names and user IDs Explanation
can be 1-8 alphanumeric characters. This message includes up to 255 bytes of a table load
BNH254I OPERSEC VALUE HAS CHANGED. statement in error. A previous message identifies the
LOGON PANEL REFRESHED. error found in this table load statement.
Message Variables
Explanation member_name
The operator entered information about a logon panel The member name containing the incorrect table
displayed while OPERSEC=SAFDEF was in effect. The load statement.
value of OPERSEC has changed, and the logon panel sequence_number
has been refreshed to allow the operator to enter The sequence number within the specified
information in the PROFILE field of the logon panel. member name. If there are no sequence numbers
in the member, the value '(NO SEQ)' is specified.
System action load_statement
The statement in error. READSEC authority
The logon panel is refreshed.
checking is performed before this message is
issued. If the operator is not authorized to access
Operator response the table member in DSIPARM, load_statement is
replaced by suppressed.
Enter the appropriate password or password phrase
and a profile name if wanted.
System action
BNH255E AN INCORRECT SPECIFICATION
OF A COMMAND IDENTIFIER See the previous message indicating the error.
WAS FOUND IN THE COMMAND
BNH257I TO SEE YOUR KEY SETTINGS,
AUTHORIZATION TABLE
ENTER 'DISPFK'

Explanation
Explanation
A command identifier was specified incorrectly. For
This message is displayed (without message ID) by
example, a command identifier delimiter, such as a
some NetView applications in the immediate message
period, was found at the end of a command identifier
area. When this message is translated it is limited to
with nothing following it, or a blank was found in
79 characters.
the middle of a command identifier field or between
command identifier fields specified on the same
record in the command authorization table. Up to 255 Operator response
bytes of the table load statement in error are included
This message is informational only; no response is
in message BNH256I.
required.

System action BNH258E SPAN spanname CANNOT BE


DEACTIVATED FOR operid
The table load statement is ignored, and processing of
the remaining table load statements continues.
Explanation
Operator response The spanname cannot be deactivated for operid
because the operator is not authorized to the inactive
Notify the system programmer or person in charge span, the span name is unknown, or the span name is
of writing the command authorization table load already inactive.
statements.
Message Variables

System programmer response spanname


The name of the span
Examine the set of table load statements identified in
operid
the message. Correct the syntax error.
The operator identifier

186 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
The command ends. Notify the system programmer or the security
administrator.
Operator response
System programmer response
Contact the system programmer if access to this span
is required. Check the NetView segment of the security software
product to determine whether the value for the
System programmer response specified keyword must be corrected in the segment.

Add the span to the NETSPAN class, if necessary, and BNH262E AN EXPECTED USERID IS
authorize the operator access to the span. MISSING IN THE COMMAND
AUTHORIZATION TABLE
BNH259I SPAN spanname ACTIVATED FOR
operid AT ACCESS LEVEL accesslvl
Explanation
Explanation A delimiter in the GROUP statement in the command
authorization table indicates that a user ID might have
This message is displayed when the spanname is been omitted from the list. For example:
activated.
GROUP G1 OPER1,
Message Variables GROUP G2 OPER2,,OPER3

spanname This error message is for both G1 and G2 groups. For


The name of the span G1, the trailing comma (,) indicates that a user ID
operid follows. For G2, the 2 trailing commas (,,) indicate that
The operator identifier a user ID has been omitted between the delimiters. Up
accesslvl to 255 bytes of the table load statement in error are
The access level for the started span included in message BNH256I.

System action System action


The command ends. The table load statement is ignored, and processing of
the remaining table load statements continues.
BNH261E UNEXPECTED DATA VALUE
ENCOUNTERED FOR KEYWORD Operator response
keyword IN THE NETVIEW
SEGMENT OF THE SECURITY Notify the system programmer or person in charge
PRODUCT FOR OPERATOR opid. of writing the command authorization table load
THE DATA IS IGNORED statements.

Explanation System programmer response


The user profile in the NetView segment contains Examine the table load statements identified in the
unexpected data. The data is ignored. message. Correct the GROUP statement, adding user
IDs that belong to the group.
Message Variables
BNH263E name WAS USED AS BOTH A
keyword
USERID AND GROUP NAME IN
The keyword in the NetView segment
THE COMMAND AUTHORIZATION
opid TABLE
The operator identifier
Explanation
System action
The specified user ID has already been used as a
The data is ignored and logon continues. group name in the command authorization table, or
the group name has already been used as a user ID
in the command authorization table. Up to 255 bytes

Chapter 3. BNH Prefix Messages 187


of the table load statement in error are included in variable values can use only the asterisk as the last or
message BNH256I. only character of the value.
Message Variables Group names and user IDs cannot contain
ampersands, asterisks, or percent signs.
name
The duplicate user ID and group name BNH265E AN EXPECTED VARIABLE VALUE
IS MISSING IN THE COMMAND
System action AUTHORIZATION TABLE

The table load statement is ignored, and processing of


the remaining table load statements continues.
Explanation
A delimiter in the SETVAR statement in the command
Operator response authorization table indicates a value might have been
omitted from the list. For example:
Notify the system programmer or person in charge
of writing the command authorization table load SETVAR V1 VALUE1,
SETVAR V2 VALUE2,,VALUE3
statements.
This error message is for both of these cases. For
System programmer response V1, the trailing comma (,) indicates a value must have
followed. For V2, the 2 trailing commas (,,) indicate a
Examine the table load statements identified in the value was omitted between the delimiters. Up to 255
message. Ensure that the group names are unique in bytes of the table load statement in error are included
the command authorization table. in message BNH256I.
BNH264E AN INCORRECT CHARACTER
character WAS FOUND IN System action
THE COMMAND AUTHORIZATION
TABLE This table load statement is ignored, and processing of
the remaining table load statements continues.
Explanation
Operator response
A character that is not valid has been found in the
load statement of the command authorization table. Notify the system programmer or person in charge
Up to 255 bytes of the table load statement in error of writing the command authorization table load
are included in message BNH256I. statements.

Message Variables
System programmer response
character
The character that is not valid Examine the table load statements identified in the
message. Add variable values for the variable that is
being defined.
System action
BNH266E AN INCORRECT VARIABLE
The table load statement is ignored, and processing of VALUE value WAS FOUND IN
the remaining table load statements continues. THE COMMAND AUTHORIZATION
TABLE
Operator response
Notify the system programmer or person in charge Explanation
of writing the command authorization table load A value was specified for a variable within a SETVAR
statements. statement that exceeds the maximum allowable
length of 242 characters. Up to 255 bytes of the
System programmer response table load statement in error are included in message
BNH256I.
Examine the table load statements identified in the
message. Correct the character in error. Message Variables
Variable names cannot contain periods, ampersands, value
dashes, asterisks, or percent signs. Variable values The value in error
cannot contain periods, ampersands, or dashes. Also,

188 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
This table load statement is ignored, and processing of Profile information for the operator cannot be
the remaining table load statements continues. extracted from the NetView segment.

Operator response System action


Notify the system programmer or person in charge Logon ends.
of writing the command authorization table load
statements. Operator response
Notify the system programmer or the system security
System programmer response
administrator.
Examine the table load statements identified in the
message. Ensure that variable values do not exceed System programmer response
242 characters. Multiple variable values must be
separated by commas. Find the corresponding BNH270E message in the
NetView log, and use the return codes to determine
BNH267E EXTRANEOUS DATA WAS FOUND the exact cause of failure.
FOLLOWING A '<BEGIN>' OR
'<END>' LABEL IN THE COMMAND BNH269E AN INCORRECT USERID userid
AUTHORIZATION TABLE WAS FOUND IN THE COMMAND
AUTHORIZATION TABLE
Explanation
Explanation
A <BEGIN> or <END> label that is used to indicate
that a table statement spans more than one line, is An incorrect userid was found while processing a
incorrect. Up to 255 bytes of the table load statement GROUP statement in the command authorization table.
in error are included in message BNH256I. This message might be issued if the GROUP statement
contains multiple user IDs that are not separated by
commas or the userid exceeded eight characters. Up
System action
to 255 bytes of the table load statement in error are
This table load statement is ignored, and processing included in message BNH256I.
of the remaining table load statements continues.
Message Variables
If the <BEGIN> label is coded incorrectly, each line
of the table following the <BEGIN> and preceding userid
the corresponding <END> is treated as an individual The user ID in error
statement instead of one multiline statement. As a
result these individual statements produces other System action
errors. Also when a <BEGIN> or <END> label is
ignored the corresponding unmatched label produces This table load statement is ignored, and processing of
a BNH246E message. the remaining table load statements continues.

Operator response Operator response


Notify the system programmer or person in charge Notify the system programmer or person in charge
of writing the command authorization table load of writing the command authorization table load
statements. statements.

System programmer response System programmer response


Examine the table load statements identified in the Examine the table load statements identified in the
message. Ensure that each <BEGIN> and <END> label message. Ensure that the user IDs are specified
appears on a line by itself. correctly. Multiple user IDs must be separated by
commas.
BNH268A UNABLE TO EXTRACT PROFILE
INFORMATION FROM THE BNH270E A CALL TO THE SYSTEM
NETVIEW SEGMENT AUTHORIZATION FACILITY
FAILED FOR TASK task. TYPE

Chapter 3. BNH Prefix Messages 189


IS type, RACROUTE MACRO Explanation
RC IS X'racroute_rc', SECURITY
PRODUCT RC IS X'security_rc', You are logging on to a NetView system where
SECURITY PRODUCT REASON OPERSEC is SAFDEF. For an OST logon, the operator
CODE IS X'security_rsn' entered a profile name on a logon panel that was
displayed before the OPERSEC value was changed to
SAFDEF. For an NNT logon, the standard logon panel
Explanation is displayed. The operator enters a profile name on
A call to the System Authorization Facility failed for the the logon panel. The profile name that was entered
specified task. The return codes are provided to help is ignored and profile attributes from the NetView
with problem diagnosis. segment are used.

See the IBM Z NetView Security Reference for


information about the security product return and System action
reason codes. Logon continues.
Message Variables BNH272I THE OPERSEC VALUE IS SET TO
task SAFDEF. THE HARDCOPY FIELD
The task being verified WAS LEFT BLANK ON THE LOGON
PANEL AND THE DEFAULT OF NO
type
HARDCOPY LOG WILL BE USED.
The type of request that was passed to the security
product
racroute_rc
Explanation
The RACROUTE MACRO return code You are logging on to a NetView system where
security_rc OPERSEC is SAFDEF. For an OST logon, the operator
The security product return code left the hardcopy field blank on a logon panel that was
displayed before the OPERSEC value was changed to
security_rsn SAFDEF. For an NNT logon, the standard logon panel is
The security product reason code always displayed. The hardcopy field remains blank on
the logon panel. A hardcopy log is not started.
System action
Processing stops. System action
Logon continues.
Operator response
Notify the system programmer or system security Operator response
administrator. Provide the command entered and If a hardcopy log is needed, start the hardcopy log.
the complete message text to help determine the
problem. BNH273I THE SECURITY ENVIRONMENT
FOR userid IS NOW CORRECTED
System programmer response AND MATCHES THE OPERSEC
VALUE OF 'opersec'
Determine the cause of the SAF failure from the
return codes and take appropriate action to correct the
Explanation
problem.
The security environment has been correctly
BNH271I THE OPERSEC VALUE IS SET established for the specified user. This message
TO SAFDEF. THE PROFILE indicates that the problem identified in a prior
NAME ENTERED ON THE LOGON BNH239E message for this userid is now resolved.
PANEL IS IGNORED AND
PROFILE INFORMATION FROM Message Variables
THE NETVIEW SEGMENT WILL BE userid
USED The user attempting to establish a security
environment
opersec
The setting of OPERSEC when the message is
issued

190 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action undefined resources, this message can be avoided by
defining a generic resource in the NETCMDS class.
Processing continues. For more information, see the IBM Z NetView Security
BNH274E A COMMAND AUTHORIZATION Reference.
DECISION COULD NOT BE MADE BNH275E KEYWORD keyword2 CONFLICTS
BY THE SECURITY PRODUCT. WITH KEYWORD keyword1.
RACROUTE MACRO RC IS KEYWORD keyword2 IS IGNORED.
X'racroute_rc', REQUEST TYPE IS
'request', SECURITY PRODUCT
RC IS X'security_rc', SECURITY Explanation
PRODUCT REASON CODE The command or statement has conflicting keywords
IS X'security_rsn', COMMAND or keyword values that are not valid. The specified
IDENTIFIER IS 'identifier' value for the keyword is ignored and the default value
is used.
Explanation Message Variables
The security product is unable to decide on the keyword1
authority of the user to issue a command. The keyword that was entered first
Message Variables keyword2
racroute_rc The keyword that is in conflict
The return code from the RACROUTE macro.
request System action
The request type specified on the RACROUTE The command fails or the statement uses the default
macro. value.
security_rc
The return code from the security product. Operator response
security_rsn
Verify that keyword1 is the setting that is wanted. If
The reason code from the security product.
not, notify the system programmer.
identifier
The command identifier passed to the system
authorization facility. The command identifier System programmer response
consists of the net ID, LU name, command, Eliminate the inappropriate keyword.
keyword (if present), and value (if present)
concatenated with a period as the separator BNH276W THE PROFILE STATEMENT
between fields. When a command identifier is not CONSNAME OPERAND IS
required for the request type, N/A is inserted. If a INCORRECT
suppression character was used, the value ?? can
be used for the command identifier. Explanation
The CONSNAME operand on the PROFILE statement
System action specifies an incorrect value.
Processing continues.
System action
Operator response If this message is issued during NetView initialization,
Notify the person in your organization who is then initialization continues. If this message was
responsible for security. Provide the command entered issued during logon, this logon ends. You are prompted
and the complete message text to help with problem for the LOGON command.
resolution.
Operator response
System programmer response Notify the system programmer to have the PROFILE
This message is only issued when SAFNODEC=FAIL statement corrected.
and the command was not authorized or denied by
the SAF product. Take the appropriate actions. For

Chapter 3. BNH Prefix Messages 191


System programmer response System action
Correct the PROFILE definition statement for the If this message is issued during NetView initialization,
CONSNAME operand. See the IBM Z NetView Security then initialization fails. If this message is issued in
Reference for more information. response to a REFRESH command, the REFRESH
command fails.
BNH277I THE SOURCE ID FOR THE
'cmd_name' COMMAND CANNOT
BE DETERMINED. THE COMMAND Operator response
IS REJECTED Notify the system programmer.

Explanation System programmer response


A command has been received without an indication of Look for a series of DWO050 messages in the NetView
its origin. An authorization check cannot be made. log that detail the location of the problem. Contact
Message Variables IBM Software Support and provide the log information.
cmd_name BNH279E THE PERMIT STATEMENT IN
The command as defined in the CMDDEF MEMBER memname AT SEQUENCE
statement. This is inserted even if a synonym for NUMBER seqnum IS IGNORED
the command was issued by the user. The insert BECAUSE THE COMMAND
might contain 2 question marks, if a suppression IDENTIFIER identifier IS NOT
character was used when the command was PROTECTED IN THE COMMAND
issued. AUTHORIZATION TABLE

System action Explanation


The command is rejected. NetView processing A PERMIT statement is coded for a command identifier
continues. that is not protected with a PROTECT statement.
Message Variables
Operator response
memname
Notify the system programmer. The name of the member or file that contains the
incorrect PERMIT statement.
System programmer response seqnum
The sequence number within the specified
Look for message DWO050 in the NetView log, which member or file. If there is no sequence number
provides more information about the location of the for this PERMIT statement, the value '(NO SEQ)' is
problem. Determine whether the problem with the returned in the message.
source ID was caused by an error in a call made
by non-NetView code. The source ID can be set identifier
incorrectly when using the PPI command receiver or The command identifier from the incorrect PERMIT
using the DSIMQS service in assembler code. If the statement.
problem is the result of an error in NetView code,
contact IBM Software Support. System action
BNH278E AN INTERNAL ERROR OCCURRED This table load statement is ignored and processing of
WHILE BUILDING THE COMMAND the remaining table load statements continues.
AUTHORIZATION TABLE
Operator response
Explanation
Notify the system programmer or person in charge
An internal error occurred. The command of writing the command authorization table load
authorization table that was specified on the statements.
SECOPTS.CMDAUTH statement in the CNMSTYLE
member, or on the REFRESH command, cannot be
System programmer response
built.
Edit the set of table load statements identified in
the message. Ensure that the command identifier in

192 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


the PERMIT statement has a corresponding PROTECT System programmer response
statement.
Check the JCL listing in the MVS-produced NetView
If this message was received at NetView initialization job log resulting from the failed attempt to start
and was truncated, you can issue a REFRESH the NetView program. If the MVS system symbolics
command with the TEST keyword to get a complete were not substituted, it might be because they were
copy of the error message. not defined, were misspelled, or the MVS system
BNH280I applid IS AN INVALID OR symbolics are not supported by the level of the MVS
NONEXISTENT APPLICATION ID system on which the NetView JCL procedure was run.
FOR THIS REQUEST If the MVS system symbolics were substituted with
unexpected values, check the MVS system symbolic
Explanation definition values. Also, look for local symbolics defined
in the NetView JCL procedure that have the same
This application ID is either incorrect or does not exist, name as the MVS system symbolics. The local
in the context of this request. symbolics override the MVS system symbolics. Check
Message Variables for misplaced commas and extraneous parameters
in the JCL EXEC statement PARM field. Correct the
applid NetView initialization procedure JCL or the MVS
The application ID that is incorrect or nonexistent system symbolic definition in error.
BNH282A ARM REGISTRATION FAILED
Operator response WITH RETURN CODE insert1,
Correct the application ID and retry. REASON CODE insert2

BNH281A ERROR PROCESSING JCL EXEC


STATEMENT PARAMETER insert1 Explanation
This message indicates that the NetView program
Explanation or NetView Subsystem Interface (SSI) attempted to
register with the MVS automatic restart manager
This message indicates that either a syntax error or (ARM) but failed with the inserted return code and
an incorrect or extraneous NetView parameter value reason code. This might be caused by an incorrect
was found while processing the NetView parameters ARM name on the NetView startup procedure or by an
passed from the JCL EXEC statement in the PARM incorrect or unsupported ARM environment.
parameter.
Message Variables
Message Variables
insert1
insert1 The return code returned by the MVS IXCARM
The positional parameter of the JCL EXEC macro at the time of the error
statement in the PARM parameter that is in error
insert2
The reason code returned by the MVS IXCARM
System action macro at the time of the error
The NetView program ends following issuance of this
message. System action
The NetView program continues following issuance of
Operator response this message without the requested ARM support.
If any supplied parameters on the MVS start procedure
command are substituted in the JCL EXEC statement Operator response
in the PARM parameter, check for misspellings or
If the operator specified the ARM parameter on the
incorrect use of commas. Correct and reissue the
MVS start procedure command that was substituted in
MVS start procedure command. If no parameters
the JCL EXEC statement PARM parameter, check for
were supplied, report the problem to your system
misspellings or incorrect use of commas and reissue
programmer.
the MVS start procedure command. If the operator did
not specify any parameters, report the problem to your
system programmer.

Chapter 3. BNH Prefix Messages 193


System programmer response If support for the function is available, contact your
system programmer and indicate that the specified
See the z/OS MVS Programming Sysplex Services function has not been installed.
Reference for the IXCARM macro that describes the
return code and reason code in this message. Make
the changes specified, and start the NetView program System programmer response
again. If the problem persists, contact IBM Software Verify whether the function should be installed. If iso,
Support for assistance. see the NetView program directory for the installation
BNH283I MAKE A SELECTION USING steps required.
CURSOR OR SELECTION CODE BNH285I THE original COMMAND
AND PRESS ENTER. ENCOUNTERED AN ERROR WHEN
PROCESSING THE embedded
Explanation COMMAND. MESSAGE msgid
FOLLOWS WITH ADDITIONAL
To continue to the next panel, type a selection code or INFORMATION
move the cursor to your selection and press enter.

Explanation
Operator response
This message indicates that while trying to process
Select a valid option. the original command, another command (embedded
BNH284E command REQUEST IGNORED. command) failed. For more information about the
function SUPPORT IS NOT embedded command's failure, see msgid.
INSTALLED. Message Variables
original
Explanation The command that encountered the error while
The request cannot be processed because the function processing the embedded command.
was not installed. embedded
For example, this message is displayed if you try The command that failed. The msgid that follows
to execute an HLLENV command to set up PL/I provides more information about the reason for the
preinitialized environments without having NetView failure.
support for PL/I installed. msgid
The message that provides additional information
Message Variables
about the failure of the embedded command.
command
The command request that cannot be processed. System action
function
The original command ended.
The function that your current installation does not
support.
Operator response
System action Review message msgid, and correct the error. Contact
your system programmer, if necessary.
The command request is ignored.

Operator response System programmer response


Review message msgid, and correct the error. When
If appropriate, verify that the command was entered
corrected, the original command can be reissued.
correctly, then correct and reenter the command
request. BNH286E IMPROPER DATE OR TIME
If the command is BPX1SDD, then the UNIX System TEMPLATE 'template'. REASON
Services Set Dub Defaults request that is issued by CODE IS reason_code.
the NetView program during its initialization failed
when attempting to specify the options indicated by Explanation
function.
An unsupported date or time template was specified,
for example, in a DEFAULTS LONGDATE=template

194 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command. The reason_code indicates the error that Valid numbers are 0, 2 (MM), and 3 (MMM). For
was detected in the template. Message BNH286E example, templates YY/MMMM and YY/M/DD
is sometimes followed by other messages that help are incorrect.
pinpoint the location of the error.
7
Message Variables The DD (day token) contains an incorrect
number of Ds. Valid numbers are 0, 2 (DD), and
template
3 (DDD). For example, templates MM/DDDD
The unsupported date or time template
and YY/MM/D are incorrect.
reason_code
8
The error detected in the template
The HH (hour token) contains an incorrect
The following are reason code values and their number of Hs. Valid numbers are 0 and 2 (HH).
meanings: For example, templates HHH:MM and H:MM:SS
are incorrect.
1
Multiple tokens are present such as YY. 9
The MM (minute token) contains an incorrect
A date or time token, such as YY, can appear number of Ms. Valid numbers are 0 and 2 (MM).
only once in a template. For example, the For example, templates HH:MMM and HH:M:SS
following templates are incorrect: HH:MM:HH are incorrect.
(multiple HHs), YYDDDYY, YDDDY, and so on.
10
2 The SS (second token) contains an incorrect
Too many delimiters are present. number of Ss. Valid numbers are 0 and 2 (SS).
A maximum of 3 delimiters can separate For example, templates MM:SSS and HH:MM:S
tokens. For example, YY/MM/DD has 2 slash are incorrect.
delimiters, "YY.DDD" has three delimiters, 2 11
double quotations and one period. The input The year token is required in the long format
template incorrectly had 4 or more delimiters, date template. Specify the YY or YYYY (year)
for example, "YY/MM/" and -YY--MM-. token in the long format date template. For
example, "DEFAULTS LONGDATE=MM/DD" is
3
incorrect.
The template was not recognized as a date or a
time template. 12
The date token is required in the long format
The template was not recognized as a data or date template. Specify the DD or DDD (date
a time template. For example, the following token) in the long format date template. For
templates are incorrect: ABC, EE/FF/GG. Date example, "DEFAULTS SHORTDAT=YY/MM" is
templates must contain a YY or DD token; time incorrect.
templates must contain an HH or SS token.
13
4 The month token is required in the long format
The template is ambiguous; it contains both date template. Specify the MM or MMM (month
date and time tokens. token) in the long format date template. For
The template was recognized as both a date example, "DEFAULTS LONGDATE=YY/DD" is
and a time template, which is incorrect. For incorrect. However, the DDD Julian date is valid
example, templates HH:MM:DD and YY/MM/SS for both the DD and MM tokens, for example,
are incorrect. A valid template can contain only "DEFAULTS DATEFMT FORMAT=YYYY.DDD."
one token type. 14
The HH (hours) token is required in the long
5
or short format time template. For example,
The YY (year) token contains an incorrect
"DEFAULTS SHORTTIM=MM:SS" is incorrect.
number of Ys. Valid numbers are 0, 2 (YY), and
Specify the HH (hour token) in the long format
4 (YYYY). For example, templates Y/MM/DD
date template.
and YYYYY.DD are incorrect.
15
6
The MM (minutes token is required in the long
The MM (month) token contains an incorrect
or short format time template. For example,
number of Ms.
"DEFAULTS SHORTTIM=HH:SS" is incorrect.

Chapter 3. BNH Prefix Messages 195


Specify the MM (minute token) in the long 24
format date template. The template contains an improper delimiter.
16 For example, alphanumeric characters such as
The SS (seconds) token is required in the A-Z cannot be used. Note the following date
long format time template. For example, and time template delimiters conditions:
"OVERRIDE LONGTIME=HH:MM" is incorrect. • Always printable EBCDIC characters such as
Specify the SS (second token) in the long slash (/) and colon (:).
format date template.
• Alphanumeric characters, blanks, single
17 quotations, asterisks, left and right
The template is too long. parentheses, commas, equals, underscores,
The template is too long. The and national characters, such as @, #, and $,
maximum length for a long date or are not valid.
time template is eight characters, for
example, DEFAULTS LONGDATE=YY/MM/DD or System action
LONGTIME='HH:MM:SS'. Enclosing quotations,
when present, are not counted in the template The DEFAULTS/OVERRIDE date or time command is
length. The maximum length for a short date or ignored.
time template is five characters, for example,
SHORTDAT=MM/DD or SHORTTIM=HH:MM. Operator response
18 Correct the template. If necessary, see online help for
The template conflicts with the Date or Time the DEFAULTS or OVERRIDE commands. Reissue the
keyword in the command. command.
For example, in "DEFAULTS BNH287E DATA BASE 'DataBaseName'
LONGTIME=YY/MM/DD" the keyword is DETECTED BY 'ComponentName'
LONGTIME, but the template is a date COMPONENT
template. The keyword and the template must
both specify either a date or a time.
Explanation
19
The template is too short. The minimum length A damaged database was detected by NetView
for a template is 2 characters, for example, component ComponentName.
YY.The template is enclosed in quotation When the ComponentName is HMON, the hardware
marks, the quotations are not counted in the monitor detected the damaged VSAM database during
2-character minimum length. either SWITCH command or START TASK=BNJDSERV
20 command processing. The command cannot
No template was specified between the successfully complete because of the damaged
quotation marks. The template contains database. You must erase and reallocate hardware
back-to-back quotations with no template monitor database DataBaseName to correct the
present between the quotations, for example, problem.
DEFAULTS LONGDATE=". Message Variables
21
DataBaseName
The template is missing an end
The name of the damaged database
quotation mark. For example, DEFAULTS
LONGDATE='MM/DD/YY. ComponentName
The NetView component that detected the
22
damaged database
The template is missing a beginning
quotation mark, For example, DEFAULTS
LONGDATE=MM/DD/YY'. System action
23 Processing continues.
The template contains only spaces. For
example, DEFAULTS LONGDATE='bbbbbbbb'
Operator response
(where b represents a space).
Perform the actions listed for each component. If the
problem persists, contact IBM Software Support.

196 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH288E PIPE OR CLIST COULD NOT SEND Message Variables
ALERT TO ALERT ADAPTER DUE TO member
MISSING 'TECROUTE'. The PARMLIB member name: CNMCAUxx

Explanation System action


A PIPE or CLIST was invoked from the automation Processing continues.
table and attempted to send an alert to the
Event/Automation Service Alert Adapter. The attempt BNH295I TOP OF LOG ENCOUNTERED
failed because the PIPE or CLIST command in the
automation table was not preceded by the TECROUTE Explanation
designation. See samples CNMSIHSA and CNMEALUS
for more information. While browsing the NetView log, a browse request
resulted in the top of the log being encountered. The
Note: Even though the PIPE or CLIST cannot send the
result is that the top of the log is displayed.
alert to the alert adapter, the alert is sent to the alert
adapter by the Hardware Monitor if the alert passes BNH296I BOTTOM OF LOG ENCOUNTERED
the TECROUTE and AREC filters.
Explanation
System action
While browsing the NetView log, a browse request
Processing continues. resulted in the bottom of the log being encountered.
When issued as a result of the LOCATE log browse
Operator response subcommand, the date/time or sequence number
requested was beyond the bottom of the log. The
Notify the system programmer to correct the PIPE or
result is that the bottom of the log is displayed.
CLIST command.
When issued as a result of the ALL log browse
System programmer response subcommand, the ALL search did not find any records
forward from the starting line through the end of
Inspect the automation table, and add TECROUTE to the log. The result is that the search was then
the beginning of the PIPE or CLIST command. performed from the starting line in a backwards
manner. The matching records are displayed along
BNH293I NETVIEW CNMCAUT MODE IS
with this message.
mode, PARMLIB MEMBER LOADED
is member BNH297I OUTSTANDING REQUEST HAS
BEEN CANCELLED
Explanation
This message is sent as a result of the DISPLAY
Explanation
CNMCAUT or D CNMCAUT command. While you were browsing the NetView log, a request
Message Variables was in progress and you canceled the outstanding
request. For example, you might have pressed Enter
mode alone on a log browse panel that had a request in
The CNMCAUT setting. It can be ON, OFF, or TEST. progress (as indicated by message DSI360I). Your
member browse screen remains as it was before the canceled
The CNMCAUaa PARMLIB that is currently active. If request being issued.
member is NONE, no CNMCAUaa member is active. BNH298I TARGET NETVIEW PRIOR TO
BNH294I NETVIEW MVS COMMAND EXIT ver_rel DOES NOT SUPPORT THE
IS LOADING PARMLIB MEMBER: command REQUEST
member
Explanation
Explanation The command request was issued for a target NetView
As a result of processing the 'SET CNMCAUT=value' system that does not support the command. The
command, the NetView MVS Command Exit is loading target NetView system must be at least at the version
the PARMLIB member. and release indicated by ver_rel.

Chapter 3. BNH Prefix Messages 197


Message Variables BNH301E AN UNRECOGNIZED STATEMENT
TYPE type WAS FOUND IN THE
ver_rel
NETVIEW SPAN TABLE
The version and release.
command
The command that is not supported. Explanation
BNH299I srvc_name caching for 'pattern' is The NetView program did not recognize a statement in
disabled. the NetView span table.
Message Variables
Explanation type
Caching for members matching 'pattern' by service The unknown statement type
srvc_name is now disabled.
If you issued a MEMSTOUT command and requested
System action
the UNLOAD option, then all members with a name The NetView span table is not loaded. Up to 255
matching 'pattern' are no longer cached by the bytes of the NetView span table statement in error are
MEMSTORE automated caching service. included in message BNH311I.
Message Variables
srvc_name
Operator response
The name of the service that cached the members Notify the system programmer to correct the
matching the specified pattern. statement.
pattern
A pattern identifying one or more members. System programmer response
DSIPARM.CNMSTYLE or *.CNMSTYLE or DSIPARM.*
are examples. Specify a valid statement type and end the statement
with a semicolon.

System action BNH302E A 'SPANDEF' STATEMENT FORMAT


IN THE NETVIEW SPAN TABLE IS
Processing continues. NOT VALID.
BNH300E THE MAXIMUM LENGTH OF A
STATEMENT WAS EXCEEDED IN Explanation
THE NETVIEW SPAN TABLE
The NetView program detected a syntax error, in a
SPANDEF statement, in the NetView span table.
Explanation
The NetView program detected a statement in the System action
NetView span table that exceeded 455 lines.
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are
System action included in message BNH311I.
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are Operator response
included in message BNH311I.
Notify the system programmer to correct the
statement.
Operator response
Notify the system programmer to correct the System programmer response
statement.
Create the SPANDEF statement in the form:

System programmer response SPANDEF SPAN = (span_list),


RESOURCE = (resource_list),
Decrease the number of statement lines until they do VIEW = (view_list);
not exceed 455. Ensure that each logical statement
ends with a semicolon.

198 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH303E A 'SPANSYN' STATEMENT FORMAT identifier; generic characters are not allowed within
IN THE NETVIEW SPAN TABLE IS specified span names.
NOT VALID.
System action
Explanation The NetView span table is not loaded. Up to 255
The NetView program detected a syntax error in a bytes of the NetView span table statement in error are
SPANSYN statement in the NetView span table. included in message BNH311I.

System action Operator response


The NetView span table is not loaded. Up to 255 Notify the system programmer to correct the
bytes of the NetView span table statement in error are statement.
included in message BNH311I.
System programmer response
Operator response Correct the statement.
Notify the system programmer to correct the
BNH306E THE NETVIEW SPAN TABLE
statement.
CONTAINS NO VALID
STATEMENTS
System programmer response
Create the SPANSYN statement in the form: Explanation
SPANSYN %name% = value ; The NetView program did not find any valid statements
in the NetView span table being loaded.
BNH304E THE LAST STATEMENT IN THE
NETVIEW SPAN TABLE DOES NOT System action
END WITH A SEMICOLON
The NetView span table is not loaded.
Explanation
Operator response
The last statement in the NetView span table does not
end with a semicolon. Notify the system programmer to correct the
statements.
System action
System programmer response
The NetView span table is not loaded.
Correct the table statements.
Operator response BNH307E THE NETVIEW SPAN TABLE
tablename DOES NOT EXIST
Notify the system programmer to correct the
statement.
Explanation
System programmer response The NetView program was unable to find the specified
NetView span table.
End the last statement in the NetView span table with
a semicolon. Message Variables

BNH305E A GENERIC SPECIFICATION WAS tablename


USED INCORRECTLY IN THE The NetView span table
NETVIEW SPAN TABLE
System action
Explanation None.
The NetView program detected a statement in the
NetView span table that contains an incorrect generic
specification. For example, double asterisks must be
located at the beginning or end of a resource or view

Chapter 3. BNH Prefix Messages 199


Operator response Operator response
Notify the system programmer to determine the Notify the system programmer to correct the
correct table name. statement.
BNH308E THE RESOURCE NAME
resource_name SPECIFIED IN THE System programmer response
NETVIEW SPAN TABLE HAS AN Specify a valid span name.
INCORRECT LENGTH
BNH310E THE VIEW NAME view_name
SPECIFIED IN THE NETVIEW
Explanation
SPAN TABLE HAS AN INCORRECT
While loading a NetView span table, the NetView LENGTH
program detected a resource name that was null or
exceeded 255 characters in length. Explanation
Message Variables
While loading a NetView span table, the NetView
resource_name program detected a view name that was null or
The resource name in error. If a null resource exceeded 32 characters in length.
name is specified, resource_name is displayed as
Message Variables
a blank.
view_name
The view name in error. If a null view name is
System action
specified, view_name is displayed as a blank.
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are System action
included in message BNH311I.
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are
Operator response
included in message BNH311I.
Notify the system programmer to correct the
statement. Operator response
Notify the system programmer to correct the
System programmer response
statement.
Specify a valid resource name.
BNH309E THE SPAN NAME span_name System programmer response
SPECIFIED IN THE NETVIEW Specify a valid view name.
SPAN TABLE HAS AN INCORRECT
LENGTH BNH311I member_name :
sequence_number :
statement_in_error
Explanation
While loading a NetView span table, the NetView Explanation
program detected a span name that was null or
exceeded 8 characters in length. This message includes up to 255 bytes of a NetView
span table statement in error. A previous message
Message Variables
identifies the error found in this NetView span table
span_name statement.
The span name in error
Message Variables
member_name
System action
NetView span table member name.
The NetView span table is not loaded. Up to 255 sequence_number
bytes of the NetView span table statement in error are The sequence number of the statement in error,
included in message BNH311I. if present. The sequence number is located in
column 73-80.

200 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


statement_in_error System action
The span table statement in error.
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are
System action included in message BNH311I.
The NetView span table is not loaded.
Operator response
Operator response Notify the system programmer to correct the
Notify the system programmer. statement.

System programmer response System programmer response


Correct any statements in error. Correct the SPANDEF statement.

BNH312E REQUIRED KEYWORD MISSING BNH314E AN INCORRECT SYNONYM USAGE


FROM A 'SPANDEF' STATEMENT IN OF 'synonym_name' WAS FOUND
THE NETVIEW SPAN TABLE IN THE NETVIEW SPAN TABLE

Explanation Explanation
The NetView program detected a SPANDEF statement The NetView program detected an incorrect use of a
that is missing a SPAN keyword, or that has a SPAN NetView span table synonym. This can be caused by:
keyword and does not have a RESOURCE or VIEW • Attempting to substitute a synonym that was not
keyword. defined
• Attempting to substitute a synonym that had an error
System action on its defining SPANSYN statement
The NetView span table is not loaded. Up to 255 Message Variables
bytes of the NetView span table statement in error are
included in message BNH311I. synonym_name
The synonym in error

Operator response
System action
Notify the system programmer to correct the
statement. The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are
included in message BNH311I.
System programmer response
Each SPANDEF statement in the NetView span table Operator response
requires a SPAN keyword as the first keyword,
followed by either a RESOURCE or VIEW keyword, or Notify the system programmer to correct the
both. statement.

BNH313E AN UNRECOGNIZED KEYWORD


System programmer response
keyword WAS FOUND ON A
'SPANDEF' STATEMENT IN THE Correct the statement and reload the table.
NETVIEW SPAN TABLE
BNH315E SYNONYM SUBSTITUTION
CHARACTER '%' FOUND WITHOUT
Explanation MATCHING END CHARACTER IN
The NetView program detected a keyword other than THE NETVIEW SPAN TABLE
SPAN, RESOURCE, or VIEW on a SPANDEF statement.
Message Variables
Explanation
The NetView program detected a synonym
keyword
substitution indicator character (a percent sign '%'),
The unrecognized keyword
but did not detect a second percent sign to indicate
the end of the synonym name. This can be caused by:

Chapter 3. BNH Prefix Messages 201


• Using a percent sign in a resource name or view Explanation
name without intending for it to be taken for a
synonym. Percent signs are reserved characters in A SPANSYN statement defines a synonym that was
the NetView span table. already defined earlier in the NetView span table.
• Using a percent sign to indicate the beginning of a Message Variables
synonym name without a matching ending percent synonym_name
sign. The synonym name that is already defined

System action System action


The NetView span table is not loaded. Up to 255 The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are bytes of the NetView span table statement in error are
included in message BNH311I. included in message BNH311I.

Operator response Operator response


Notify the system programmer to correct the Notify the system programmer to correct the
statement. statement.

System programmer response System programmer response


Correct the statement and reload the table. If the view Correct the statement and reload the table.
name or the resource name contains a percent sign, it
must be preceded by the escape character (“). BNH318I SPAN spanname IS NOT DEFINED
TO NETVIEW IN tablename
BNH316E THE SYNONYM NAME ON A
SPANSYN STATEMENT IN THE
NETVIEW SPAN TABLE IS TOO Explanation
LONG The spanname entered in the LIST SPAN=spanname
command is not defined to NetView in a span
Explanation definition; therefore, it has no resources or views. A
wrong spanname might have been entered, or the
A SPANSYN statement defines a synonym with a name spanname is defined in operator profiles, but not
longer than the maximum allowable length. A synonym associated with any resources or views in the NetView
name is limited to 32 characters. span table.
Message Variables
System action
spanname
The NetView span table is not loaded. Up to 255 The span name entered in the LIST command
bytes of the NetView span table statement in error are
included in message BNH311I. tablename
The span table name or SPANTBL, if no table is in
use.
Operator response
BNH319E AN OMIT LIST WAS SPECIFIED
Notify the system programmer to correct the INCORRECTLY IN THE NETVIEW
statement. SPAN TABLE

System programmer response Explanation


Correct the statement and reload the table. A SPANDEF statement contained an incorrect
BNH317E THE SYNONYM 'synonym_name' specification for a list of resources or view names that
WAS ALREADY DEFINED IN THE are to be omitted. It is possible that:
NETVIEW SPAN TABLE • Either the less than (<) or greater than (>) symbol
was used in a resource view name. These 2 symbols
are reserved characters in the NetView span table.
• Either the less than (<) or greater than (>) symbol
was missing.

202 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• The name to be omitted was specified as a null string System programmer response
(<>).
Ensure that the table name specified is in the
DSIPARM concatenation. See any messages that were
System action issued previously to determine the exact cause of the
The NetView span table is not loaded. Up to 255 error.
bytes of the NetView span table statement in error are BNH323I TEST OF NETVIEW SPAN TABLE
included in message BNH311I. tblname COMPLETED WITH
ERRORS
Operator response
Notify the system programmer to correct the Explanation
statement. This message is displayed after the TEST option of the
REFRESH SPANAUTH=TABLE command completes.
System programmer response Errors were encountered while testing the table.
Correct the statement and reload the table. If the Message Variables
resource or the view name contains a less than (<) or tblname
greater than (>) symbol, it must be preceded by the The name of the table being tested
escape character (“).
BNH321I NETVIEW SPAN TABLE tblname System action
HAS BEEN INITIALIZED
The command completes with errors.
Explanation BNH324I TEST OF NETVIEW SPAN
TABLE tblname COMPLETED
A NetView span table has been initialized SUCCESSFULLY
during NetView initialization or REFRESH command
processing.
Explanation
Message Variables
This message is displayed after the TEST option of the
tblname REFRESH SPANAUTH=TABLE command completes.
The name of the NetView span table
Message Variables
System action tblname
The name of the table being tested
The command completes successfully.
BNH322E NETVIEW SPAN TABLE tblname System action
INITIALIZATION FAILURE
The command completes successfully.
Explanation BNH325I Table loaded by opid at date time
The NetView span table that is specified on the
REFRESH command fails to initialize. Explanation
Message Variables This is the label line for a multiline line table. It lists
the date and time when the table was created.
tblname
The name of the NetView span table Message Variables
opid
System action The operator ID where the table load occurred
The REFRESH command fails. date
The date the table was created

Operator response time


The time the table was created
Check the value that was specified for tblname on
the REFRESH command. If this error occurs during BNH326E AN ESCAPE CHARACTER (") WAS
initialization, notify the system programmer. FOUND IN THE NETVIEW SPAN

Chapter 3. BNH Prefix Messages 203


TABLE WITHOUT A SUBSEQUENT • Mismatched shift-in character and shift-out
RESERVED CHARACTER characters
• A line containing a shift-out character with no
Explanation following shift-in character
The NetView program detected an escape character Although NetView span table statements can span
without a subsequent character. multiple lines of text, each line must contain complete
DBCS strings.
System action
System action
The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are The NetView span table is not loaded. Up to 255
included in message BNH311I. bytes of the NetView span table statement in error are
included in message BNH311I.
Operator response
Operator response
Notify the system programmer to correct the
statement. Notify the system programmer to correct the
statement.
System programmer response
System programmer response
Correct the statement and reload the table.
Correct the statement and reload the table.
BNH327E A DUPLICATE KEYWORD 'keyword'
WAS SPECIFIED IN THE NETVIEW BNH329E AN ODD NUMBER OF DOUBLE-
SPAN TABLE BYTE CHARACTERS WERE
SPECIFIED IN THE NETVIEW
SPAN TABLE
Explanation
A keyword on a SPANDEF statement in the NetView Explanation
span table was specified more than once. Each
keyword can be specified only once per statement; the A record in the NetView span table contains an odd
keyword might contain multiple values. number of double-byte (DBCS) characters. An even
number of bytes must be specified between the shift-
out and shift-in characters on a record.
System action
The NetView span table is not loaded. Up to 255 System action
bytes of the NetView span table statement in error are
included in message BNH311I. The NetView span table is not loaded. Up to 255
bytes of the NetView span table statement in error are
included in message BNH311I.
Operator response
Notify the system programmer to correct the Operator response
statement.
Notify the system programmer to correct the
statement.
System programmer response
Correct the statement and reload the table. System programmer response
BNH328E MISMATCHED SHIFT-IN OR Correct the statement and reload the table.
SHIFT-OUT DBCS CHARACTERS
WERE FOUND IN THE NETVIEW BNH330I NO SAF operid USER FOUND.
SPAN TABLE
Explanation
Explanation The NetView program was unable to perform a
The NetView program detected an error in a DBCS RACROUTE EXTRACT for the operator, operid, in the
string. This can be caused by: SAF USE class.

204 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables Explanation
operid This is the first line of a multiline message that is
The operator issuing the command issued in response to a SETRVAR QUERY command.
Subsequent data lines in this message list the
System action variable name with its value in character format and
corresponding hexadecimal format.
The command ends with a non-zero return code.
Message Variables
Operator response ssiName
The 4-character name of the NetView Subsystem
Verify that there are no misspellings. If any Interface (SSI) holding the variables.
misspellings are found, correct them and reissue the
command. Otherwise, notify the system programmer. nn
The number of data lines (one for each variable)
that follow this message.
System programmer response
BNH333E THE OMIT NAME 'omit_name' IS
Determine if the user is defined in the SAF USER class. NOT A POSSIBLE SUBSET OF
If not, define the user as needed. THE type NAME 'name' IN THE
BNH331E A SPAN NAME CONTAINS AN NETVIEW SPAN TABLE
INCORRECT CHARACTER IN THE
NETVIEW SPAN TABLE Explanation
A SPANDEF statement contained an incorrect
Explanation specification for a resource or view name that is to be
Span names defined in the NetView span table cannot omitted. It is possible that:
contain the following reserved characters: • The resource or view name for which the omit string
was specified did not contain wildcard characters.
Charact Hexadecimal
er value Description • The resource or view name for which the omit string
was specified is identical to the omit string.
X'0E' and DBCS Shift-in and Shift-out
• The omit string is not an appropriate subset of the
X'0F'
resource or view name for which it was specified.
* X'5C' Asterisk Message Variables
? X'6F' Question mark omit_name
" X'7F' Quotation mark The omit specification on the SPANDEF statement
type
The type of name (RESOURCE or VIEW)
System action
name
The NetView span table is not loaded. Up to 255 The resource or view name for which the "omit"
bytes of the NetView span table statement in error are was specified
included in message BNH311I.
System action
Operator response
The NetView span table is not loaded. Up to 255
Notify the system programmer to correct the bytes of the NetView span table statement in error are
statement. included in message BNH311I.

System programmer response Operator response


Correct the statement and reload the table. Notify the system programmer to correct the
statement.
BNH332I For ssiName there are nn revision
variables.
System programmer response
Correct the statement and reload the table.

Chapter 3. BNH Prefix Messages 205


BNH334I REQUESTED ACCESS to name Operator response
DENIED FOR operid. RETURN
CODE = rc If spans were to be used, notify the system
programmer.

Explanation
System programmer response
The operator issued the QRS command to determine
access for the specified name. Access was denied If spans are to be used, the REFRESH command
because of the reason specified by the given return can be used to create a NetView span table from a
code. member in DSIPARM.

Message Variables BNH336I ddname MEMBER mem IS BEING


USED FOR NETVIEW AUTOMATION
name TABLE TESTING
Either a resource, view, or RODM object ID
operid Explanation
The operator issuing the command
The specified member in either DSIPARM or DSIASRC
rc
DD statement (ddname) contains the automation
The return code from the request. These are
statements being tested.
possible return codes:
Message Variables
• 128 - Operator specified in the QRS command is
not logged on. ddname
• 160 - No span authorization definition is defined The data set containing the automation table
in the NetView program. member under test. Possible values are DSIPARM
and DSIASRC.
• 200 - No span table is loaded.
mem
• 204 - A View was requested, but a required The name of the automation table member under
Dynamic Span table is not loaded. test.

System action System action


The command fails. The automation table test can begin. Testing starts
when the AUTOTEST SOURCE command is issued.
Operator response
BNH337I NO TEST AUTOMATION TABLE IS
If the command was entered incorrectly, reenter the LOADED
command. Otherwise, notify the system programmer.
Explanation
System programmer response
The test automation table is not loaded.
Load the appropriate span table.
BNH338I TEST AUTOMATION TABLE tblname
BNH335I A SPAN TABLE DOES NOT EXIST HAS BEEN COMPILED AND
LOADED AT time BY operid
Explanation
Explanation
An attempt was made to display the list of resources
associated with a specified span on the LIST The test automation table is active.
SPAN=spanname command, but no span table is in
Message Variables
use.
tblname
Member name in the format
System action
DDname.Membername
The command fails. time
Date-time when the table was activated
operid
Operator ID or task name that activated the table

206 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH339I TEST AUTOMATION TABLE Explanation
LISTING = membername
Automation recording has been stopped.

Explanation Message Variables

The specified member in DSILIST contains the test membername


automation table listing. The member specified by the RECORD keyword

Message Variables BNH343I AUTOMATION RECORDING


IS ALREADY ACTIVE,
membername MEMBER=membername
The member in DSILIST that contains the
automation table listing produced by the
AUTOTEST command Explanation
BNH340I AUTOMATION TABLE TESTING IS A request was made to record messages and MSUs
ACTIVATED AT time BY operid as they flow into the active automation table analysis
process, but recording was already active.

Explanation Message Variables

Automation table testing has started. membername


The member specified by the previous RECORD
Message Variables keyword
time
Date-time when the automation table testing System action
started
The command is ignored.
operid
Operator ID or task that initiated the automation BNH344I AUTOMATION TABLE TESTING IS
table test NOT ACTIVE

BNH341I AUTOMATION TABLE TESTING


SOURCE = tblsource , REPORT = Explanation
reportmember , TASK = taskname A request was made to end automation table testing,
but testing was not active.
Explanation
This message usually accompanies message BNH340I System action
and provides additional details about active The command is ignored.
automation table testing.
BNH345I AUTOMATION RECORDING TO
Message Variables MEMBER membername IS
tblsource ACTIVATED AT time BY operid
The source of the messages and MSUs for the
automation table under test. Possible values are Explanation
PARALLEL or the name of a member in DSIASRC
containing previously recorded messages and Automation table recording has started.
MSUs. Message Variables
reportmember
membername
The name of the member in DSIARPT that contains
The member specified by the RECORD keyword
the report created by the AUTOTEST command.
time
taskname
Date-time when the automation table recording
The name of the task under which automation
started
table testing is being run. NONE indicates that
no task was specified, and automation testing for operid
each given message or MSU occurs on whatever Operator ID or task that initiated the automation
task normally automates that message or MSU. table recording

BNH342I AUTOMATION RECORDING


STOPPED, MEMBER=membername

Chapter 3. BNH Prefix Messages 207


System action BNH349I TEST AUTOMATION TABLE
COUNTERS RESET BY operid AT
Recording of the automation table testing begins. time
BNH346I AUTOMATION RECORDING IS NOT
ACTIVE Explanation
The test automation table usage counters were reset
Explanation to zero.
The automation table recording of messages and Message Variables
MSUs is not active.
operid
The operator ID or task that issued the AUTOCNT
System action command
The command is ignored. time
BNH347I TEST AUTOMATION TABLE The date-time when the AUTOCNT RESET
LISTING membername command was issued
SUCCESSFULLY GENERATED
System action
Explanation The automation table counters are reset.
An AUTOTEST command was issued with the LISTING BNH350E NETVIEW HIGH-LEVEL LANGUAGE
keyword. The listing has been successfully created. SUPPORT HAS BEEN
Message Variables SUCCESSFULLY INITIALIZED
WITH env LIBRARIES
membername
The name of the member in the DSILIST data set
containing the listing
Explanation
The NetView High-Level Language function has been
BNH348I TEST AUTOMATION TABLE
successfully initialized with the specified runtime
LISTING membername
environment.
GENERATION FAILED
Message Variables
Explanation env
An AUTOTEST command was issued with the LISTING Indicates the specific runtime support with which
keyword. An error occurred while creating the listing. the NetView program is installed. This value is
either LE/370 or non-LE/370.
Message Variables
membername System action
The name of the member in the DSILIST data set
NetView high-level language function has been
on which the AUTOTEST command was issued
initialized and is ready to process command
processors and preinitialization requests.
System action
BNH351I HEARTBEAT slot_values
The listing is not created.
Explanation
Operator response
This message is used to carry slot values for the
Notify the system programmer. heartbeat event. It is intended to be converted to a
heartbeat event and routed to a topology server.
System programmer response Message Variables
Determine the reason for the failure. One possible slot_values
explanation is that the DSILIST data set or its volume The values to be built into the heartbeat event.
is full. Correct the problem, and reissue the AUTOTEST
command to create an automation table listing. BNH352I THRESHOLD slot_values

208 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation module_name
The name of the module in which the error
This message is used to carry slot values for the occurred
threshold event for component monitors. It is intended
to be converted to a threshold event and routed to a retcode
topology server. The return code for the module

Message Variables
System action
slot_values
The command is canceled.
The values to be built into the threshold event
BNH353I REL THRESHOLD slot_values Operator response
Notify the system programmer.
Explanation
This message is used to carry slot values for System programmer response
the threshold event for relationship monitors. It is
intended to be converted to a threshold event and Contact IBM Software Support, and provide the
routed to a topology server. information from this message.
Message Variables BNH356E command COMMAND ENDED DUE
TO REXX SYNTAX ERROR IN
slot_values
LINE line_number OF MODULE
The values to be built into the threshold event
module_name. RETURN CODE =
BNH354I CONN CHANGE slot_values retcode.

Explanation Explanation
This message is used to carry slot values for A REXX syntax error was encountered at the specified
the connection change event. It is intended to be line of the specified module.
converted to a connection change event and routed to
Message Variables
a topology server.
command
Message Variables
The name of the command
slot_values line_number
The values to be built into the connection change The number of the line in which the error occurred
event
module_name
BNH355E command COMMAND ENDED The name of the module in which the error
DUE TO REXX NOVALUE ERROR occurred.
FOR VARIABLE variable IN retcode
LINE line_number OF MODULE The REXX return code
module_name. RETURN CODE =
retcode.
System action
Explanation The command is canceled.
A REXX NOVALUE error occurred for the listed variable
at the specified line of the specified module. Operator response
Message Variables Notify the system programmer.

command
The name of the command System programmer response
variable Contact IBM Software Support, and provide the
The name of the variable information from this message.
line_number BNH357E TIMER COMMAND FAILED TO
The number of the line in which the error occurred START. TYPE: type ID: id TASK:
task MQSRC: mqsrc INTERVAL:

Chapter 3. BNH Prefix Messages 209


int1 int2 CONTINUE: cont CMD: converted to APM_CI_CHANGE events and routed to
cmd a topology server.
Message Variables
Explanation
slot_values
A timed command cannot be queued to a task to be The values to be built into the component
executed. If you specified the EVERY command, the information change event
timer might not continue to be queued, depending on
the EVERYCON option that was in effect for that EVERY BNH359I SYS MONITOR slot_values.
command on the task that issued it.
Message Variables
Explanation
This message carries slot values for the system
type
monitor event. The slot values are converted to
The command that specified this timed command
APM_SYS_MONITOR events and routed to a topology
(AFTER, AT, or EVERY).
server.
id
The identifier associated with this timer. Message Variables
task slot_values
The task or group name to which the timed The values to be built into the system monitor
command cannot be queued. event
mqsrc BNH360I req REQUEST COMPLETED FOR
The non-zero return code from the internal DSIPARM MEMBER mem AT
DSIMQS macro. LOCATION loc WITHIN THE LIST
int1 OF AUTOMATION TABLES
The interval of days specified on the EVERY
command. If no days were specified, this field is Explanation
N/A.
The request to INSERT, SWAP, or REMOVE a table
Note: This field is the same as the output from within the list of automation tables was processed
LIST TIMER. successfully. For an INSERT or SWAP request, the
int2 new automation table was inserted at the indicated
The interval of hours specified on the EVERY location within the list of automation tables. For a
command. If no hours were specified, this field is REMOVE request, the table at the specified location
N/A. was removed from the list of automation tables.

Note: This field is the same as the output from Message Variables
LIST TIMER. req
cont The type of request:
The EVERYCON setting for an EVERY timer (YES or • INSERT
NO). This is always NO for AT and AFTER timers.
• SWAP
cmd
The text of the command which cannot be run. The • REMOVE
text can be up to 255 characters. mem
The member name specified with the INSERT and
Operator response SWAP requests or the table name specified with
the REMOVE request
See IBM Z NetView Programming: Assembler for more
loc
information about the DSIMQS macro.
The numeric location of the automation table being
BNH358I CI CHANGE slot_values. affected within the list of automation tables

Explanation System action


This message carries slot values for the component The request to INSERT, SWAP, or REMOVE an
information change event. The slot values are automation table was processed successfully.

210 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH361I THE AUTOMATION TABLE date
CONSISTS OF THE FOLLOWING The date that the action resulting in the current
LIST OF MEMBERS status was performed.
time
Explanation The time that the action resulting in the current
status was performed.
This message is the title of a multiline write-to-
operator (MLWTO) message that is generated by the lock_indicator
AUTOTBL STATUS command. The MLWTO is followed This insert indicates whether the table is
by BNH362I messages that describe the status of the designated as the first or last table within the list of
tables that contain the list of automation tables. automation tables. Possible values are:

This message indicates that automation might consist • FIRST


of a series of automation tables and that users • LAST
and applications must maintain the order of the • omitted
automation tables. If you are replacing the entire
sequence of automation tables, use the INSERT If a table is locked as the first or last table, it must
keyword with the AUTOTBL MEMBER command. be removed from the list before another table can
replace it with the FIRST or LAST keyword, unless
Note: For readability, BNH362I message numbers are SWAP is used with the NAME keyword.
suppressed within the MLWTO.
If SWAP NAME is specified and the member
BNH362I oper COMPLETED act FOR specified matches the table specified with the
TABLE #num: tbl AT date time NAME keyword, the FIRST or LAST table can be
lock_indicator swapped and the lock_indicator value is retained.
BNH363I THE AUTOMATION TABLE
Explanation CONTAINS THE FOLLOWING
Instances of this message contain the status DISABLED STATEMENTS:
information related to MLWTO message BNH361I,
generated by the AUTOTBL STATUS command. This Explanation
message indicates the status and tracking information
for an individual automation table within the list of This message is the title of a multiline write-to-
active automation tables. operator (MLWTO) message that is generated by the
AUTOTBL STATUS command. The MLWTO is followed
Message Variables by BNH364I messages that describe any statements
oper or groups of statements that are disabled within the
The operator whose action resulted in the status. list of automation tables.
act Note: For readability, BNH364I message numbers are
The action that indicates the status of the suppressed within the MLWTO.
individual automation table. Possible values are:
BNH364I TABLE: tbl INCLUDE: incl keyword:
• INSERT label
• DISABLE
• ENABLE Explanation
For automation table processing, INSERT and Instances of this message contain the status
ENABLE are synonyms. ENABLE can be used for information related to MLWTO message BNH363I,
problem determination if a table was temporarily generated by the AUTOTBL STATUS command. This
disabled. message indicates the statements or groups of
statements that are disabled within the automation
tbl tables.
The table name of the individual automation table
for which status is displayed. Message Variables
num tbl
The numeric location of the table within the list of The table in which the indicated statements are
automation tables. located.

Chapter 3. BNH Prefix Messages 211


incl Explanation
The INCLUDE member in which the statement or
statements indicated by the label are located. This The request to ENABLE or DISABLE a statement
variable applies only if the member is not the or statements within the specified table processed
high-level member for an automation table within successfully. The statement or statements identified
the list of tables. Otherwise, this variable can be by the table, keyword, and value inserts have been
ignored and is identified as not applicable (n/a). enabled or disabled.
keyword Message Variables
The keyword that describes how the disabled req
statement or statements are indicated. A colon The type of request:
(:) is added to the keyword for readability. This
variable can be one of the following values: • ENABLE
• SEQUENCE: • DISABLE
• LABEL: table
The name of the table within which the statements
• ENDLABEL:
to be enabled or disabled are found.
• BLOCK:
keyword
• GROUP: The keyword that identifies the manner in which
Note: If an entire table or INCLUDE member is the statements to be enabled or disabled are
disabled, this variable is suppressed. specified. A colon (:) is added to the keyword
for readability. The keyword might be one of the
label following values:
The label in combination with the keyword,
indicates the statement or statements that are SEQUENCE:
disabled within the specified member. The statement to be enabled or disabled is
identified by a sequence number from the
Note: If an entire table or INCLUDE member is statement in the original automation table
disabled, this variable is suppressed. source member.
BNH365E AUTOTBL MEMBER SPECIFIED IS LABEL:
NOT UNIQUE WITHIN THE LIST OF The statement to be enabled or disabled is
ACTIVE AUTOMATION TABLES identified by a label name from the LABEL
syntax on the statement in the original
automation table source member.
Explanation
ENDLABEL:
The member specified with the AUTOTBL command is The statement to be enabled or disabled is
already a table within the list of automation tables. The identified by a label name from the ENDLABEL
AUTOTBL command must specify a member that does syntax on the statement in the original
not match one that is already in the list of automation automation table source member.
tables.
BLOCK:
The statements to be enabled or disabled
System action are identified by a label name from a LABEL/
The AUTOTBL command is ignored. No action is taken. ENDLABEL pair within the syntax of the
statements in the original automation table
source member.
Operator response
GROUP:
Do one of the following: The statements to be enabled or disabled
are identified by a label name from the
• Enter the AUTOTBL command again and specify a
GROUP syntax on the statements in the original
member that is not already in the list of automation
automation table source member.
tables.
• Use the AUTOTBL SWAP command to replace the Note: The sequence numbers and label names
automation table with the matching name. from the original automation table source
members can be found in the AUTOCNT report.
BNH366I AUTOTBL req REQUEST
COMPLETED FOR NAME: table
keyword value

212 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


value 204
The identifying sequence number or label name A request to replace the first table within the
that describes the statements or group of list of automation tables failed because the
statements to be enabled or disabled. table is established as the locked first table.
The table must be removed before a swap
System action attempt is successful. See the description of
the AUTOTBL command for more information
The request to enable or disable the specified about the FIRST keyword.
statement or statements was successfully completed. 208
BNH367E UNABLE TO COMPLETE AUTOTBL A request to replace the last table within the
req REQUEST. REASON CODE: list of automation tables failed because the
reason_code table is established as the locked last table.
The table must be removed before a swap
attempt is successful. See the description of
Explanation the AUTOTBL command for more information
The specified request cannot be completed about the LAST keyword.
successfully. The reason code describes the reason for 212
the unsuccessful request. A request to replace a table within the list of
Message Variables automation tables failed because the table to
replace was not found.
req
The type of request that resulted in the failure: DISABLE Reason Codes:

• INSERT 304
A disable request failed because it matches a
• SWAP disable request which is already applied.
• DISABLE 500
• ENABLE The request failed because the name specified
• MEMBER was not found as a table or include member
within the list of active automation tables.
reason_code
502
The reason code that indicates why the request
The request failed because the member
was not able to be processed.
specified was found more than once within the
The reason code can contain one of the following list of automation tables.
values: 504
INSERT Reason Codes: The request failed because the statement or
statements indicated are already affected by
104 another active disable request.
A request to establish a table as the first
table within the list of automation tables 506
failed because another table is already The request failed because one or more
established as the locked first table. The table statements in the group are already disabled
must be removed before similar attempts because of another request.
are successful. See the description of the 510
AUTOTBL command for more information The request failed because the sequence
about the FIRST keyword. number specified is not found in the indicated
108 member.
A request to establish a table as the last 512
table within the list of automation tables The request failed because the sequence
failed because another table is already number specified is not unique within the
established as the locked last table. The table indicated member.
must be removed before similar attempts 520
are successful. See the description of the The request failed because there is no
AUTOTBL command for more information statement within the specified member that
about the LAST keyword. matches the indicated label name specified
SWAP Reason Codes: using the LABEL syntax.

Chapter 3. BNH Prefix Messages 213


530 BNH368I NO ORIGINATING OPERATOR
The request failed because there is no IS DEFINED IN NETVIEW
statement within the specified automation FOR VTAM COMMAND WHEN
table with the indicated label name specified SPANCHK=SOURCEID.
using the ENDLABEL syntax.
540 Explanation
The request failed because a pair of LABEL
and ENDLABEL statements matching the This message is issued when a VTAM command is
indicated label name cannot be found in the entered and SPANCHK=SOURCEID is in effect, but
specified automation table. A LABEL and its the original operator ID is not defined to the NetView
corresponding ENDLABEL must be located at program.
the same nesting level of BEGIN blocks.
542 Operator response
The request failed because the specified Contact IBM Software Support.
BLOCK includes statements that are also
contained in another BLOCK that has been BNH369I VTAM COMMAND ORIGINATING
disabled. When statements are contained in OPERATOR operid IS NOT LOGGED
more than one BLOCK, only one BLOCK can be ON WHEN SPANCHK=SOURCEID.
disabled at a time.
550 Explanation
The request failed because a statement with
This message is issued when a VTAM command is
the specified GROUP name is not found in the
entered and the originating operator is not logged on.
specified automation table.
552 Message Variables
The request failed because the specified name operid
is not found as a table within the list of The operator ID
automation tables.
ENABLE Reason Codes: System action
404 The command is ignored.
An enable request failed because there are no
disable requests active.
Operator response
408
An enable request failed because it does not Set SPANCHK equal to the TARGETID or ensure that
match any of the active disable requests. the originating operator is logged on.
6XX BNH370I disposition condition table member
Any reason codes in the range of 600-699 statement tracetag
must not occur and must be reported to IBM
Software Support.
Explanation
MEMBER Reason Code:
Message BNH370I displays detailed trace information
704 for each part of each automation table statement that
A MEMBER request failed because the SWAP analyzes an AIFR.
or INSERT keyword was not specified. The
SWAP or INSERT keyword is required if there Message Variables
is a chain of automation tables or if there is a disposition
single table loaded as the FIRST or LAST table. Disposition indicating the following results of the
conditional test:
System action • PASS, if the conditional test was successful
The AUTOTBL command is ignored. No action is taken. • FAIL, if the conditional test was not successful
• ACTION, if an action item was attempted.
Operator response condition
Correct the problems that resulted in the failure, and Condition being evaluated.
reissue the command.

214 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


table Explanation
Name of the automation table.
A 'SET CNMCAUT=value' command is entered, but
member IEFPRMLB cannot read the PARMLIB member because
Name of the automation table member. of an I/O error.
statement
Label or sequence number of the automation
System action
table statement. If neither a label nor a sequence
number is present, N/A is specified. CNMCAUxx is not processed.
tracetag
Trace identifier. Operator response
BNH371E LOADING OF PARMLIB MEMBER Correct the error, and re-enter the command.
member FAILED
BNH374E ERROR ENCOUNTERED WHILE
OPENING PARMLIB
Explanation
CNMCAUxx member failed to load. The member is not Explanation
processed.
A 'SET CNMCAUT=xx' command is entered, but
Message Variables IEFPRMLB cannot open the PARMLIB member.
member
The member name CNMCAUxx System action
CNMCAUxx is not processed.
System action
The CNMCAUxx member is not processed. Operator response
Correct the error, and re-enter the command.
Operator response
BNH375I DDNAME MEMNAME HITS
Correct the error, and re-enter the command. LOADTASK STORAGE DATE TIME
BNH372E PARMLIB MEMBER member NOT DP
FOUND
Explanation
Explanation This multiline message is a successful response to the
A 'SET CNMCAUT=xx' command is entered, but LIST MEMSTAT command. Each data line describes a
IEFPRMLB cannot locate the CNMCAUxx member in member that was added to the table either because
PARMLIB. it was accessed on disk, or loaded by the INSTORE
pipeline stage. Members whose hit count has become
Message Variables 0.00 and are not loaded are listed only if they are
member not yet overwritten. CNME1054 (MEMSTORE) uses this
The PARMLIB member name: CNMCAUxx message to manage which members must be loaded
based on their hit counts.

System action Message Variables

PARMLIB member is not processed. Definitions of column labels:


DDNAME
Operator response The DDNAME associated with this member.
MEMNAME
Make sure CNMCAUxx is in PARMLIB, and reenter the
The name of this member.
command.
HITS
BNH373E I/O ERROR ENCOUNTERED WHILE The number of hits weighted by time. The NetView
READING PARMLIB program internally weighs hits according to age.
Hits in the last minute have full weight, hits over
an hour old have zero weight, and hits in between
have partial weight depending on their age. For

Chapter 3. BNH Prefix Messages 215


example, a value of 1.00 is equivalent to one hit in STATUS
the last minute or 2 hits with an average age of 30 The PPI status of the server, which is ACTIVE,
minutes. INACTIVE, or UNDEFINED. ACTIVE is typically
expected. INACTIVE might indicate that a server
Note: Any reference to a member which causes it
was active and then was cancelled, but it is still
to be read, such as executing, browsing or being
known to PPI. See the DISPPI command in the
specified as a command on an EXEC automation
NetView online help for more information. It might
table statement, causes an increase in the hit
be deleted by the PIPE PPI stage, which redefines
count.
and then deletes this receiver name. UNDEFINED
LOADTASK might indicate a server which failed to start, but is
The task which loaded this member (blank if not still defined to the NetView program. It might be
loaded). deleted with the STOP TSOSERV command.
STORAGE STARTER
The size in bytes (blank if not loaded). The NetView operator who started this server.
DATE BNH377E ALLOCATION OF A LOGICAL
The date of the loaded member (blank if not PARMLIB DATA SET FAILED
loaded).
TIME Explanation
The time of the loaded member (blank if not
loaded). A 'SET CNMCAUT=xx' command is entered, but
IEFPRMLB cannot allocate the PARMLIB data set.
DP
If a delete is pending, an asterisk appears in this
field (blank if no delete pending). This occurs when System action
a member has been unloaded by the INSTORE
CNMCAUxx is not processed.
stage command, but a process is still reading
that data. When all such processes complete, the
storage is freed. No process can start reading this Operator response
data after the unload request.
Correct the error, and re-enter the command.
BNH376I OPID TSOSERV MEMBER PPI
BNH378E LOGICAL PARMLIB DATA SET
NAME STATUS STARTER
CONCATENATION FAILED

Explanation Explanation
This multiline message is a successful response to
A 'SET CNMCAUT=xx' command is entered, but
the LIST STATUS=TSOSERV command. Each data line
IEFPRMLB cannot locate the PARMLIB data set.
describes a TSO server which has either been defined
as a global server or associated with a particular
NetView operator. See the START TSOSERV command System action
in the NetView online help. CNMCAUxx is not processed.
Message Variables
Definitions of column labels: Operator response
OPID Correct the error, and re-enter the command.
The NetView operator task associated with this
BNH379E LOAD OF THE PARMLIB READ
server. NONE indicates a global server.
ROUTINE FAILED
TSOSERV
The TSO user ID associated with this server.
Explanation
MEMBER
The DSIPARM member containing the JCl used to A 'SET CNMCAUT=xx' command is entered, but
start this server. With TSO NAME, this uniquely IEFPRMLB cannot read the PARMLIB member.
identifies a server.
PPI NAME System action
The PPI receiver name associated with this server CNMCAUxx is not processed.
by the NetView program.

216 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Correct the error, and re-enter the command. An AUTOTEST command was issued with the SOURCE
keyword while automation table testing was active.
BNH380I AUTOMATION TABLE TESTING
AND/OR RECORDING STOPPED Message Variables
DUE TO ERROR membername
The member name containing prerecorded
Explanation messages and MSUs that are currently being used
by the automation table under test
Automation table testing or recording stopped
because of an error. This message is followed by a
message explaining the cause of the error. System action
The command is ignored.
System action
BNH384I AUTOMATION TABLE TESTING
Automation table testing or recording stops. AND/OR RECORDING FAILED.
FAILING COMPONENT: component,
Operator response RC: returncode, MEMBER NAME:
membername
Notify the system programmer.
Explanation
System programmer response
An internal error has occurred during automation table
Correct the error, and restart testing or recording. testing.
BNH381I AUTOMATION TABLE TESTING IS Message Variables
IN PROGRESS, THE AUTOMATION
component
TABLE CANNOT BE CHANGED
The failing component
returncode
Explanation The return code encountered by the failing
An AUTOTEST command was issued with the MEMBER component
keyword while automation table testing was active. membername
The automation table member that was being
System action tested when the failure occurred

The command is ignored. Note: The message inserts are included to help IBM
Software Support diagnose the problem.
BNH382I AUTOMATION TABLE TESTING
STOPPED, SOURCE=membername
System action
Explanation Automation table testing stops.

Automation table testing has reached the end of the


member containing prerecorded messages and MSUs, Operator response
or automation table testing was stopped. Check for accompanying error messages (for example,
Message Variables CNM255 or DWO029) for additional information
and suggested responses. If you cannot find any
membername related messages, browse the network log. If the
The name of the member specified by the SOURCE AUTOTEST command continues to fail, notify the
keyword when automation table testing started system programmer.

System action System programmer response


Automation table testing completes. If BNH384 recurs without accompanying error
messages, browse the network log to try to locate
BNH383I AUTOMATION TABLE TESTING
related error messages. If found, take any necessary
IS ALREADY ACTIVE,
corrective actions. If you do not find related error
SOURCE=membername

Chapter 3. BNH Prefix Messages 217


messages, recycle the DSIATOPT task using STOP dsname
TASK=DSIATOPT. If the error persists, notify IBM The data set containing the automation table
Software Support. member
BNH385I ddname MEMBER membername IS memname
CLOSED. RETURN CODE=retcode The member name of the automation table
specified on the AUTOTEST command
Explanation
System action
The specified member in ddname is closed because
DSIATOPT ends. Automation table testing or recording does not start.

Message Variables
Operator response
ddname
The data set containing membername. Possible Notify the system programmer.
values are DSIASRC and DSIARPT.
membername System programmer response
The member in ddname where recording or Determine the reason for the failed storage request.
reporting was being written. NetView storage might need to be increased if no
abnormal storage utilization is found.
System action
BNH388E PARMLIB READER UNABLE TO
Automation table testing completes. ACCESS LOGICAL PARMLIB
BNH386E INCORRECT KEY STRING IN
MEMBER membername IN DATA Explanation
SET ddname A SET CNMCAUT=value command is entered, but
IEFPRMLB cannot access the logical PARMLIB.
Explanation
An AUTOTEST command was issued with the SOURCE System action
keyword, and the member specified as the source did CNMCAUxx is not processed.
not contain the correct key string as the first record.
This key string is created when a member is written by
the AUTOTEST command with the RECORD keyword. Operator response
Message Variables Correct the error, and re-enter the command.

membername BNH389E NETVIEW MVS COMMAND EXIT


The member name specified by the SOURCE ENCOUNTERED ERROR ISSUING
keyword. IEFPRMLB
ddname
The data set containing the source member. Explanation
Possible values are DSIASRC or DSIPARM.
NetView MVS Command Processing encountered an
error while issuing IEFPRML. This message is followed
System action by another message with the IEFPRMLB error.
Automation table testing does not start.
Operator response
BNH387E DSIGET FAILURE INITIALIZING
DATA SET OBJECT FOR DATA SET Correct the error, and re-enter the SET
dsname, MEMBER membername CNMCAUT=value command.
BNH390I PARMLIB READ BUFFER BEING
Explanation MADE LARGER
A failure occurred while obtaining storage for
automation table testing or recording.
Message Variables

218 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
A SET CNMCAUT=value command is entered, and a A CONSOLE EXCLUSION LIST, a CONSOLE INCLUSION
larger storage size is needed to process the PARMLIB LIST, a COMMAND EXCLUSION LIST, or a COMMAND
member. INCLUSION LIST is processed.
BNH391E PARMLIB DID NOT CLOSE Message Variables
type1
Explanation CONSOLE or COMMAND
IEFPRMLB fails to close the PARMLIB. type2
EXCLUSION or INCLUSION
System action BNH395I 'statement'
The NetView program ignores the message call and
continues processing. Explanation
This message follows an error message and echoes
Operator response the statement that is in error.
None
System action
BNH392E PARMLIB DID NOT UNALLOCATE
CNMCAUxx is not processed.
Explanation
Operator response
IEFPRMLB fails to unallocate the PARMLIB.
Correct the error, and re-enter the command.
System action BNH396E type EXCLUSION AND INCLUSION
LISTS ARE MUTUALLY EXCLUSIVE
The NetView program ignores the message call and
continues processing.
Explanation
Operator response Both an EXCLUSION LIST and an INCLUSION LIST
are found in the CNMCAUxx member. Use either an
None
EXCLUSION LIST or an INCLUSION LIST, but not both.
BNH393E SYNTAX ERROR IN CONSOLE Message Variables
EXCLUSION OR INCLUSION LIST
STATEMENT type
CONSOLE or COMMAND
Explanation
System action
An error is detected in a CONSOLE EXCLUSION LIST
or INCLUSION LIST. Only one console name can be CNMCAUxx is not processed.
specified on each line, and the console name can be 1
to 8 characters long. Operator response
Correct the error, and re-enter the command.
System action
BNH397E STATEMENT TYPE NOT
CNMCAUxx is not processed.
RECOGNIZED

Operator response Explanation


Correct the error, and re-enter the SET
A statement in the CNMCAUxx member is not
CNMCAUT=value command.
recognized and is not processed. Message BNH395I
BNH394I type1 type2 REQUESTED follows this message.
The following are some of the common errors:
• Column 1 is not an asterisk or a blank.

Chapter 3. BNH Prefix Messages 219


• Column 2 is blank and the line is not a continuation Explanation
line or a comment.
VTAM is not completing an asynchronous APPCCMD
• COMMAND INCLUSION LIST, COMMAND EXCLUSION macro issued by the NetView program. The NetView
LIST, CONSOLE INCLUSION LIST, and CONSOLE program is trying to send data to a partner LU over
EXCLUSION LIST must start on column 2. an LU 6.2 session. VTAM must complete its macro
processing before data can be sent to the destination.
System action All send requests to this destination are canceled.
Future send requests to this destination will fail with
CNMCAUxx is not processed.
this message until the macro completes. The send
requests can be generated by NetView commands,
Operator response such as RMTCMD, or by user-written applications that
use the Management services or High Performance
Correct the statement in error, and reenter the
send APIs available in the NetView program. The task
command.
name in the message indicates whether the problem
BNH398I NO VALID CONSOLE OR COMMAND has been encountered by an MS application or an
STATEMENTS FOUND IN PARMLIB HP application. HP application requests are processed
MEMBER member by task DSIHPDST, while MS application requests are
processed by task DSI6DST.
Explanation Message Variables
The CNMCAUxx member does not have any valid macro
statements. The type of APPCCMD macro VTAM is processing
Message Variables dest
The partner LU to which the NetView program is
member attempting to send data
The name of the PARMLIB member: CNMCAUxx
mm/dd/yy hh:mm:ss
The date and time when the macro was issued.
System action The date and time formats depend on the
CNMCAUxx is not processed. TRANSMSG member, when in effect, and on the
date and time operands of the DEFAULTS and
OVERRIDE commands.
Operator response
task
Correct the error, and re-enter the command. The NetView LU 6.2 task that issued the request
BNH399E EXCLUDED/INCLUDED COMMAND
TEXT IS TOO LONG System action
Send requests to the destination are canceled and
Explanation error notifications are returned to the applications
that issued the requests. Further error processing is
The command in the CNMCAUxx member is too
application-dependent.
long. The maximum length of the command is 122
characters.
Operator response
System action Notify the system programmer.
CNMCAUxx is not processed.
System programmer response
Operator response Try to determine why the VTAM macro is failing
to complete. Check for VTAM error messages and
Correct the error in CNMCAUxx, and re-issue the
verify VTAM connectivity to the destination. VTAM
command.
operator commands, such as VARY TERM, might make
BNH400E VTAM APPCCMD TIME-OUT. it possible to cancel the outstanding macro and retry
REQUEST= macro TIME= the request. Recycling DSI6DST or DSIHPDST might
mm/dd/yy hh:mm:ss LU= dest also stop the error condition.
TASK= task

220 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH401E LOAD FAILED FOR DB2 INTERFACE System action
MODULE 'module_name' WITH
ABEND CODE = X'abend_code' AND Processing continues.
REASON CODE = X'reason_code' BNH411I SEQUENT NAME STATE TASK DATE
TIME DURATION
Explanation
The NetView program cannot load the DB2 interface Explanation
modules when the NetView program is started. This is the second line of a multi-line message in
Message Variables response to a SEQUENT LIST command. It provides
the label line for subsequent BNH412I lines that
module_name contain the information represented by the column
The name of the module that cannot be loaded headings.
abend_code
The hexadecimal abend code generated by the System action
MVS LOAD macro and returned in register 1
Processing continues.
reason_code
The hexadecimal reason code generated by the BNH412I sequent_name state taskname date
MVS LOAD macro and returned in register 15 time duration

System action Explanation


The NetView program ignores the error and processing Third and subsequent lines of a multi-line message
continues. The PIPE SQL stage might fail. in response to a SEQUENT LIST command. These
provide information about SEQUENT names satisfying
Operator response the filters specified on the command.

Notify the system programmer. Message Variables


sequent_name
System programmer response 1 - 16 character name of the SEQUENT resource
being listed. If the line represents the same
Verify that the DB2 load module library can be SEQUENT name as the line above it, sequent_name
accessed by the NetView program. You might need is blank.
to add a STEPLIB DD statement to the NetView JCL.
state
The DB2SEC statement in the CNMSTYLE member
The state of the SEQUENT resource. It will be one
specifies whether the NetView program loads the
of the following states:
RRS interface modules, the CAF interface modules, or
neither. When this message is generated, the NetView HELD/X
initialization processing continues. The task shown in taskname is holding the
SEQUENT resource exclusively, and has been
BNH410I SEQUENT NAMES FOUND: num for the amount of time shown.
HELD/S
Explanation The task shown in taskname is holding the
This is the first line of a multi-line message in response SEQUENT resource as shared, and has been for
to a SEQUENT LIST command. If no matching names the amount of time shown.
are found based on the specified parameters, num will WAIT/X
be 0, and the response will be this message as a single The task shown in taskname is waiting for
line message. the SEQUENT resource to be released, to be
obtained exclusively, and has been for the
Message Variables
amount of time shown. This state does not
num necessarily mean that the SEQUENT resource
The number of SEQUENT resource names found, is currently owned, and cannot be obtained
the details of which are displayed in subsequent yet. If the first BNH412I for the sequent_name
messages. indicates HELD/X or HELD/S, it is currently
owned. If the first BNH412I indicates AVAIL,
the task is not yet in a state that can obtain

Chapter 3. BNH Prefix Messages 221


the SEQUENT resource (such as a high priority Explanation
command or a ROLL command interrupted the
program that issued the SEQUENT OBTAINEX). A single line message issued when a SEQUENT
resource is obtained or converted from shared to
WAIT/S exclusive and the SEQUENT name is being monitored.
The task shown in taskname is waiting for The message is logged and automatable. It is also
the SEQUENT resource to be released, to be displayed on an operator console if the MONOPER
obtained as shared, and has been for the keyword specified an operator that is currently logged
amount of time shown. This state does not on.
necessarily mean that the SEQUENT resource
is currently owned. If the first BNH412I for the Message Variables
sequent_name indicates HELD/X, it is currently cmd
owned exclusively, and cannot be obtained The command name that issued a SEQUENT
yet. If the first BNH412I indicates HELD/S, an OBTAINEX or SEQUENT OBTAINSH command that
exclusive request might be queued before this was satisfied.
one, which would have priority to obtain the
resource. If the first BNH412I indicates AVAIL, taskname
the task is not yet in a state that can obtain The task name under which the SEQUENT resource
the SEQUENT resource (such as a high priority was obtained.
command or a ROLL command interrupted the sequent_name
program that issued the SEQUENT OBTAINSH). The 1 - 16 character name of the SEQUENT
AVAIL resource that was obtained.
The displayed SEQUENT resource is available type
for obtaining by a program, and has been for The type of obtain request, which is either
the amount of time shown. EXCLUSIVE or SHARED.
taskname
The name of the task that is holding or waiting for System action
the displayed SEQUENT resource. If state is AVAIL,
The requesting command group resumes processing.
taskname is blank.
date BNH414I COMMAND cmd UNDER TASK
The date on which the displayed SEQUENT taskname RELEASE SEQUENT
resource was obtained (for HELD/X or HELD/S), sequent_name
requested to be obtained (for WAIT/X or WAIT/S),
or became available (for AVAIL). Explanation
time
A single line message issued when a SEQUENT
The time at which the displayed SEQUENT
resource is released and the SEQUENT name is being
resource was obtained (for HELD/X or HELD/S),
monitored. The message is logged and automatable.
requested to be obtained (for WAIT/X or WAIT/S),
It is also displayed on an operator console if the
or became available (for AVAIL).
MONOPER keyword specified an operator that is
duration currently logged on.
The amount of time that the displayed state has
been true. That is, the difference between the Message Variables
current time and the displayed date and time. If cmd
the amount of time is less than a day, the format of The command name that issued a SEQUENT
duration is hh:mm:ss. If the amount of time is at RELEASE command that was satisfied.
least a day, the format is ddd.hh:mm:ss.
taskname
The task name under which the SEQUENT resource
System action was released.
Processing continues. Note that the order of the lines sequent_name
for a particular SEQUENT name does not necessarily The 1 - 16 character name of the SEQUENT
imply the order in which obtain requests were or will resource that was released.
be satisfied.
BNH413I COMMAND cmd UNDER TASK System action
taskname OBTAINED SEQUENT Processing continues.
sequent_name AS type

222 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH415I COMMAND cmd UNDER TASK System action
taskname WAITING TO OBTAIN
SEQUENT sequent_name AS type Processing continues.
BNH417W SEQUENT sequent_name
Explanation FORCIBLY RELEASED UNDER
TASK taskname - CODE code
A single line message issued when a SEQUENT
resource is requested to be obtained, but is currently
held by another task and the SEQUENT name is being Explanation
monitored. The message is logged and automatable. A warning message issued when a SEQUENT resource
It is also displayed on an operator console if the that was held had to be released due to a situation
MONOPER keyword specified an operator that is represented by the given code. The program that
currently logged on. had obtained the SEQUENT resource did not explicitly
Message Variables release it, resulting in a situation that could lead to
problems.
cmd
The command name that issued a SEQUENT Message Variables
OBTAINEX or OBTAINSH command that has not sequent_name
yet been satisfied. The 1 - 16 character SEQUENT name that had
taskname been held, but is being forcibly released.
The task name under which the SEQUENT taskname
OBTAINEX or OBTAINSH was issued. The task name that had held the identified
sequent_name SEQUENT name.
The 1 - 16 character name of the SEQUENT code
resource that was requested. The numeric code indicating the situation causing
type the SEQUENT resource to be released. code can be
The type of obtain request, which is either one of the following values:
EXCLUSIVE or SHARED. 1
The command group which held the SEQUENT
System action resource terminated normally before issuing
the corresponding SEQUENT RELEASE.
The requesting command group is suspended until the
resource is available. 2
The command group which held the SEQUENT
BNH416I num SEQUENT FILTERS BEING resource terminated abnormally, possibly
MONITORED BY opid because of a RESET, before issuing the
corresponding SEQUENT RELEASE.
Explanation 3
The operator task logged off while the
The first line of a multi-line message (or the only
SEQUENT resource was held.
line if there are no names being monitored) issued
in response to a SEQUENT MONLIST command or a 4
SEQUENT MONITOR command. The operator task ABENDed while the
SEQUENT resource was held.
Message Variables
num System action
The number of SEQUENT MONITOR filters in
effect. If there are no filters in effect, num is 0 and Processing continues.
this message is a single line message. If there are BNH418W MORE THAN num SEQUENT
any names being monitored, num is 1 or greater NAMES DEFINED - PERFORMANCE
and subsequent lines in the multi-line message ISSUES MIGHT ARISE
list the filters, separated by blanks, with each line
containing as many filters as can fit on the line.
Explanation
opid
The operator ID specified by the MONOPER A warning message issued when the number of
keyword that is being sent monitoring messages, defined SEQUENT names has exceeded the current
or N/A if no monitor filters are in effect. limit imposed by the NetView program that allows for

Chapter 3. BNH Prefix Messages 223


reasonable performance. As more SEQUENT names BNH452I POLLING INTERVAL SET TO
are defined after this message is issued, the chances interval FOR COMPONENT
of performance concerns increase. component_id MONITOR
monitor_name
Message Variables
num
Explanation
The number of SEQUENT names that have been
defined that is the reasonable limit of names, The interval between the times that the current
considering performance concerns. If many more value of the monitor is checked against the threshold
SEQUENT names than this number are required, specifications has been set.
contact IBM support to request that this number
Message Variables
be increased. This number is currently 27340.
interval
BNH450I THRESHOLDS SET FOR
The time interval
COMPONENT component_id
MONITOR monitor_name component_id
The identifier for this application management
interface component
Explanation
monitor_name
Threshold specifications have been established The name of the monitor
defining the conditions under which threshold events
are issued to the topology server.
System action
Message Variables
The value of the monitor is checked each time the
component_id time interval expires. If a threshold specification is
The identifier for this application management matched, a threshold event is sent to the topology
interface component server.
monitor_name
BNH453E ERROR SETTING POLLING
The name of the monitor
INTERVAL FOR COMPONENT
component_id MONITOR
System action monitor_name, RC=retcode
When the current value of the monitor matches a
threshold specification, a threshold event is issued. Explanation
BNH451E ERROR SETTING THRESHOLDS An error occurred setting the interval between the
FOR COMPONENT component_id times that the current value of the monitor is checked
MONITOR monitor_name, against the threshold specifications.
RC=retcode Message Variables
component_id
Explanation The identifier for this application management
An error was encountered while establishing threshold interface component
specifications defining the conditions under which monitor_name
threshold events are issued to the topology server. The name of the monitor
Message Variables retcode
An error code indicating the condition
component_id
The identifier for this application management
interface component System action
monitor_name The value of the monitor is not periodically checked.
The name of the monitor
BNH454I VALUE FOR COMPONENT
retcode
component_id MONITOR
An error code indicating the condition
monitor_name IS value

System action
Threshold specifications are not established.

224 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
The current value of the monitor is displayed. An error was encountered querying the current
severity level of the monitor.
Message Variables
Message Variables
component_id
The identifier for this application management component_id
interface component The identifier for this application management
monitor_name interface component
The name of the monitor monitor_name
value The name of the monitor
The current value of the monitor retcode
An error code indicating the condition
BNH455E ERROR QUERYING VALUE
FOR COMPONENT component_id BNH458I HEARTBEAT INTERVAL SET
MONITOR monitor_name, TO interval FOR COMPONENT
RC=retcode component_id

Explanation Explanation
An error was encountered querying the current value The interval between the time that the component is
of the monitor. queried for UP/DOWN state is set.
Message Variables Message Variables
component_id interval
The identifier for this application management The time interval in seconds
interface component component_id
monitor_name The identifier for this application management
The name of the monitor interface component
retcode
An error code indicating the condition System action
BNH456I COMPONENT component_id The monitor value routine (passed to GEMREG)
MONITOR monitor_name is started periodically to check the state of the
SEVERITY LEVEL IS level, VALUE component. If the state is UP, a heartbeat event is
IS value issued to the topology server.
BNH459E ERROR QUERYING HEARTBEAT
Explanation INTERVAL FOR COMPONENT
The current severity level of the monitor is displayed. component_id RC=retcode

Message Variables
Explanation
component_id
The identifier for this application management An error occurred while setting the interval between
interface component the time that the component is queried for UP/DOWN
state.
monitor_name
The name of the monitor Message Variables
level component_id
The current severity level of the monitor The identifier for this application management
value interface component
The current value of the monitor retcode
An error code indicating the condition
BNH457E ERROR QUERYING SEVERITY
LEVEL FOR COMPONENT
component_id MONITOR System action
monitor_name, RC=retcode The state of the component is not periodically
checked.

Chapter 3. BNH Prefix Messages 225


BNH460I THRESHOLD SETTINGS FOR monitor_name
COMPONENT component_id The name of the monitor
MONITOR monitor_name retcode
An error code indicating the condition
Explanation BNH463I POLLING INTERVAL FOR
This message is the first in a series of messages that COMPONENT component_id
display the threshold specifications for a monitor. MONITOR monitor_name IS
interval
Message Variables
component_id Explanation
The identifier for this application management
interface component The interval between the times that the current
value of the monitor is checked against the threshold
monitor_name
specifications is displayed.
The name of the monitor
Message Variables
System action component_id
The identifier for this application management
Message BNH461I is issued for each threshold
interface component
specification.
monitor_name
BNH461I SEVERITY LEVEL = severity, The name of the monitor
OPERATOR = operator, VALUE =
value interval
The time interval in seconds

Explanation BNH464E ERROR QUERYING POLLING


INTERVAL FOR COMPONENT
Threshold specifications are displayed for the monitor component_id MONITOR
listed in message BNH460I. monitor_name, RC=retcode
Message Variables
severity Explanation
The severity of the threshold event to be issued if a An error occurred querying the interval between the
match occurs times that the current value of a monitor is checked
operator against the threshold specifications.
The operator used in comparing the current value Message Variables
of the monitor to the value of this threshold
specification component_id
The identifier for this application management
value
interface component
The value compared with the current value of the
monitor monitor_name
The name of the monitor
BNH462E ERROR QUERYING THRESHOLD
SETTINGS FOR COMPONENT retcode
component_id MONITOR An error code indicating the condition
monitor_name, RC=retcode BNH465I EVENT/AUTOMATION SERVICE
ADAPTER adapter_name IS state
Explanation
An error was encountered querying the threshold Explanation
settings of the monitor. The UP/DOWN state of the Event/Automation Service
Message Variables adapter is displayed.

component_id Message Variables


The identifier for this application management adapter_name
interface component The name of the adapter in the form:

226 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


procname.adapter_name Explanation
The procname is the name of the Event/ The VTAM ACB Monitor was activated by the
Automation Service procedure started, or the INITAMON command. The ACB status updates the
alias name, if used. The adapter_name is either flow from the VTAM of the focal point NetView
MESSAGEA, ALERTA, or EVENTRCV. program and all entry point NetView programs when
the state of an ACB changes. ACB data is stored in DB2
state and made available to ACB monitoring.
The state is either UP or DOWN.
BNH476I VTAM ACB MONITOR ENTRY
BNH466I TERMAMI COMMAND COMPLETE. POINT entry_point ACTIVATION IN
ALL AMI COMPONENTS PROGRESS.
DEREGISTERED
Explanation
Explanation
The ACB Monitor on the specified domain is being
The TERMAMI command has deregistered all activated by the INITAMON command. The entry
components, purged all timers, and cleaned up all point NetView name has either been specified on the
global variables. INITAMON command or it has been specified on the
BNH467I routine_type ROUTINE AMONLU keyword in the DSIAMII configuration file.
routine_name NOT FOUND BY Message Variables
command
entry_point
The NetView domain name of the ACB Monitor
Explanation entry point
An INIT or TERM routine was not found by either the BNH477I VTAM ACB MONITOR ACTIVATED
INITAMI command or the TERMAMI command. ON DOMAIN domain.
Message Variables
routine_type Explanation
The type of routine: The ACB Monitor on the specified domain has been
• 'INIT', if the INITAMI command was issued and activated by the INITAMON command. The domain
an INIT= routine that was not valid was coded in name has either been specified on the INITAMON
DSIAMII command or it has been specified on the AMONLU
keyword in the DSIAMII configuration file.
• 'TERM', if the TERMAMI command was issued
and a TERM= routine that was not valid was Message Variables
coded in DSIAMII domain
routine_name The NetView domain name of the ACB Monitor
The name of the routine as coded in DSIAMII focal point or entry point
command BNH478I VTAM ACB MONITOR INITIAL
Either the INITAMI or TERMAMI command REPORTING COMPLETE FOR CP
cpname.
Operator response
Explanation
Notify the system programmer.
A VTAM ACB Monitor focal point or entry point has
System programmer response completed initial reporting of all its applications,
and the VTAM ACB Monitor function in the NetView
Ensure that the initialization or termination routine is program has loaded all data into DB2.
in a data set listed in the DSICLD DD.
Message Variables
BNH475I VTAM ACB MONITOR ACTIVATION
cpname
IN PROGRESS.
The VTAM domain name of the ACB Monitor focal
point or entry point
BNH479E VTAM ACB MONITOR command
ERROR, REASON= reason_code.

Chapter 3. BNH Prefix Messages 227


Explanation start failure, ensure that the AUTOVTAC autotask is
defined on the entry point. If there is a VTAM exit
An error has occurred during processing of the activation failure, ensure that the exit is installed
INITAMON or TERMAMON command. correctly and the STATMON exit is not active on the
Message Variables entry point.

command BNH481E INVALID VALUE value FOR VTAM


INITAMON or TERMAMON ACB MONITOR CONFIGURATION
KEYWORD keyword.
reason_code
For INITAMON:
Explanation
1=Already active
2=Activation in progress A value that is not valid has been parsed in
3=Termination in progress configuration file DSIAMII for the VTAM ACB Monitor.
4=SQL error Message Variables
5=DB2 not initialized
value
6=Internal error The value that is not valid
For TERMAMON: keyword
101=Already inactive The DSIAMII keyword
102=Not issued on focal point
103=Entry point not active Operator response
Correct the keyword, and reissue the INITAMON
System programmer response command.
If this is an SQL error or the DB2 is not initialized, BNH482I VTAM ACB MONITOR
correct the problem. If this is an internal error, contact TERMINATION IN PROGRESS FOR
IBM Software Support. DOMAIN domain.
BNH480E ERROR ACTIVATING VTAM
ACB MONITOR ENTRY Explanation
POINT entry_point, REASON= Termination processing has started for a VTAM ACB
reason_code. Monitor focal point or entry point.
Message Variables
Explanation
domain
An error has occurred activating a VTAM ACB monitor
The NetView domain name of the ACB Monitor
entry point.
focal point or entry point
Message Variables
BNH483I VTAM ACB MONITOR
entry_point TERMINATION COMPLETE FOR
The NetView domain name of the ACB Monitor DOMAIN domain.
entry point
reason_code Explanation
1= RMTCMD connectivity failure The termination processing has completed for a VTAM
2= Autotask start failure ACB Monitor focal point or entry point. If termination
3= VTAM exit activation failure is being performed for the entire VTAM ACB Monitor
4= Invalid entry point name (as opposed to a single entry point), this message is
issued for the focal point domain and not the entry
5= Entry point already active
point domains.
6= Focal point not active
Message Variables
System programmer response domain
The NetView domain name of the ACB Monitor
If there is RMTCMD connectivity failure, ensure that
focal point or entry point
SNA connectivity exists between the focal point and
entry point NetView programs. If there is an autotask

228 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH484W DUPLICATE VTAM APPL appl resource_name
DISCOVERED ON CP cpname. The name of the VTAM resource for which
reporting has been modified. This is an application
name, model name, or generic resource name.
Explanation
cpname
A VTAM application has been discovered by the VTAM The VTAM domain on which that resource resides.
ACB Monitor with the same name as an application
already discovered on a different VTAM. This might BNH487I AMONRPT COMMAND COMPLETE.
indicate either an error in the VTAMLST definitions or
a VTAMLST definition being activated on an incorrect Explanation
VTAM.
Processing of an AMONRPT command is complete.
Message Variables Monitoring has been modified for all VTAM resources
appl matching the specified application, model, or generic
The name of the duplicate application resource.
cpname BNH488E SPECIFY APPL, GNAME, OR
The VTAM domain name where the duplicate MODEL KEYWORD.
application was discovered
Explanation
System programmer response
An AMONRPT command cannot be processed because
Investigate VTAMLST definitions to determine if an either the APPL (application), GNAME, or MODEL
error exists. keyword must be specified.
BNH485I VTAM ACB MONITOR STATUS
UPDATE DATA. Operator response
Retry the AMONRPT command specifying VTAM
Explanation resources for which monitoring is to be modified.
This message carries VTAM ACB Monitor status update BNH489E MODIFY RESOURCE COMMAND
buffers from an ACB Monitor entry point to the ACB FAILED FOR resource_name ON CP
Monitor focal point. The buffer is hexadecimal data cpname.
and is carried as the second line of this message.
BNH486I VTAM ACB MONITOR REPORTING Explanation
SET TO MONITOR= monitor_value The VTAM modify resource command failed.
SESCT= sesct_value FOR
RESOURCE resource_name ON CP Message Variables
cpname. resource_name
The name of the VTAM resource for which
Explanation reporting is to be modified. This is an application
name, model name, or generic resource name.
Termination processing has completed for a VTAM ACB
Monitor focal point or entry point. If termination is cpname
being performed for the entire VTAM ACB Monitor The VTAM domain on which that resource resides.
(as opposed to a single entry point), this message is
issued for the focal point domain and not the entry Operator response
point domains.
Attempt to issue the VTAM modify resource command
Message Variables on the appropriate VTAMs.
monitor_value
Specifies whether VTAM is sending status updates System programmer response
to the VTAM ACB Monitor. Valid values are yes or
no. Ensure VTAM resources are defined correctly.

sesct_value BNH491E MONITOR=NO AND SESCT=YES


Specifies whether VTAM is sending session count COMBINATION IS INVALID.
status updates to the VTAM ACB Monitor. Valid
values are yes or no.

Chapter 3. BNH Prefix Messages 229


Explanation reason_code

Setting session count reporting to YES and overall 1= No matches for search criteria
monitoring to NO is not valid. 2= SQL error
3= IP address required when port specified
Operator response 4= Parameter that is not valid

If session count reporting is wanted, set MONITOR to


YES. Operator response
BNH492I TN3270E CLIENT APPL applname If an IP address is required when the port is specified,
IP ADDRSS ipaddress IPPORT specify the IP address or prefix in addition to the port.
ipport HOSTNAME hostname ON
CP cpname TCP STACK jobname System programmer response
If there is an SQL error, verify that the DB2 is
Explanation functional.
A Telnet client has been located which matches search BNH495I NUMBER OF NETVIEW
criteria given in the Locate Client Local or Locate Client APPLICATIONS: numnvapp
Global Telnet server instrumentation tasks.
Message Variables Explanation
applname This is a multiline message written in response to
The VTAM application name (applname) of the the NVSTAT command. This message consists of one
Telnet client header line followed by a variable number of data
ipaddress lines, each describing the configuration and status
The IP address of the Telnet client of NetView applications. This message is intended
for parsing by REXX processing. A REXX sample,
ipport
CNMSNVST, is provided to format the information from
The IP port of the Telnet client
this message for readability.
hostname
The IP host name of the Telnet client Each data line includes the following information:

cpname Columns
The VTAM cp name (cpname) where the Description
application name (applname) resides 1-9
jobname Reserved field.
The job name of the Telnet server (the TCP stack) 10-17
The NetView domain name.
BNH493I LOCATE TN3270E CLIENTS
COMPLETE. 19-34
The role of this NetView program. Valid values are
network, SA, GDPS, or a user-defined description.
Explanation
36-41
All Telnet clients that match search criteria given in The sysplex role for this NetView program. The
the Locate Client Local or Locate Client Global Telnet following values are valid:
server instrumentation tasks have been located.
• BASIC: Basic NetView program.
BNH494I NO MATCHING TN3270E CLIENTS
• EBASIC: Basic NetView program in a sysplex
FOUND, REASON= reason_code.
with an enterprise master NetView program.
• EMASTER: Enterprise master NetView program.
Explanation
• EMCAP: Master-capable NetView program in
No Telnet clients that match search criteria given in a sysplex with an enterprise master NetView
the Locate Client Local or Locate Client Global Telnet program.
server instrumentation tasks have been located.
• MASTER: Master NetView program.
Message Variables • MCAP: Master-capable NetView program.

230 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• RBASIC: Basic NetView program outside the 170-174
sysplex that is forwarding data to the enterprise The port number that is used for RMTCMD.
master program. 176-179
• RMASTER: Master NetView program outside the The version of the NetView program.
sysplex that is forwarding data to the enterprise
Usage: Beginning with NetView Version 6 Release
master program.
2 Modification 1, the version columns contain the
• RMCAP: Master-capable NetView program release data in the format Vvrm, where v is the
outside the sysplex that is forwarding data to the version, r is the release, and m is the modification
enterprise master program. level. The V6R2M1 format is V621. Any version
43-46 without a modification level uses a zero for m, such
The sysplex rank for this NetView program. The as V610 for Version 6, Release 1.
following values are valid: 181-188
• -1: Not participating in the sysplex group The name of the sysplex.

• 0: Basic NetView program 190-193


The SMF system ID.
• 1-249: Master-capable NetView program
Message Variables
• 250: Master NetView program
numnvapp
48-76
The total number of NetView applications known
A list of XCF groups of which this NetView program
to this NetView program.
is a member. The length of this field includes the
parentheses enclosing the group information.
78-83
System action
The current NetView CPU percentage. This is The NVSTAT command processing is completed.
the sum of processor utilization percentages for
NetView tasks reported by the TASKMON * CPU BNH496I NUMBER OF TELNET SERVERS:
command. numsvrs
85-94
The current NetView storage utilization in Explanation
kilobytes. This is the sum of storage utilization This is a multiline message written in response to
values for active NetView tasks reported by the the TELNSTAT command. This message consists of
TASKMON * STG command. Note that only storage one header line followed by a variable number of
obtained by the NetView program's DSIGET macro data lines, each describing Telnet server configuration
is included in the total. and status. This message is intended for parsing
96-103 by REXX processing. A REXX sample, CNMSTNST, is
The name of the z/OS image. provided to format the information from this message
105-112 for readability.
The status of this NetView program. The following Each data line includes the following information:
values are valid:
Columns
• ACTIVE: The NetView program is running. Description
• INACTIVE: The NetView program is not running. 1-9
• LEAVING: The z/OS system on which the Reserved field.
NetView program is running is leaving the 10-17
sysplex. The Telnet server job name.
• UNKNOWN: The NetView program is no longer an 19-22
active member of the XCF sysplex group of which The MVS address space ID of the address space
it is a member. that opened the socket.
114-121 24-33
The VTAM network ID. The number of configured ports that are
associated with the Telnet server job.
123-168
The IPv4 or IPv6 address that is used for RMTCMD. 35-44
The address might be a DVIPA. The number of active ports that are associated
with the Telnet server job.

Chapter 3. BNH Prefix Messages 231


46-77 90-99
The status of the Telnet server. The current number of connections. When
79-86 the port is quiesced, this value is 0, even
The z/OS image name. if connections are active. When the port is
resumed, only new connections on this port
Message Variables are displayed. This information is retrieved
numsvrs from the z/OS Communications Server network
The total number of Telnet servers known to this management interface by using an active TCP
NetView program. listeners request. To see all the connections
for this port, issue the z/OS Communications
Server DISPLAY TCPIP,tnproc,TELNET command.
System action For more information, see z/OS Communications
The TELNSTAT command processing is completed. Server IP System Administrator's Commands.
101-110
BNH497I NUMBER OF TELNET SERVER
The total number of connections that are dropped
PORTS: numports
by this listener because the backlog was exceeded.
This attribute applies only to listener entries.
Explanation 112-119
This is a multiline message written in response to the The name of the TCP/IP stack job with which this
TNPTSTAT command. This message consists of one Telnet server has an affinity.
header line followed by a variable number of data 121-128
lines, each describing Telnet server port configuration The name of the sysplex.
and status. This message is intended for parsing
130-137
by REXX processing. A REXX sample, CNMSTPST, is
The z/OS image name.
provided to format the information from this message
for readability. 139-143
The release level of the z/OS operating system.
When a single Telnet port is listened to by multiple
TCP/IP stacks, there is one message for each listener. 145-152
The address of the TCB in the address space
Each data line includes the following information: that opened the connection. If the port status is
Columns QUIESCED, this attribute has no value.
Description 154-157
1-9 The SMF system ID.
Reserved field. 159-166
10-17 The name of the LPAR.
The Telnet server job name. Message Variables
19-22
numports
The MVS address space ID of the address space
The total number of Telnet server ports known to
that opened the socket.
this NetView program.
24-31
The text identification of the resource. This value
System action
represents the user who opened the socket. It is
updated during bind processing. The TNPTSTAT command processing is completed.
33-64 BNH498I NUMBER OF INTERFACES: numintf
The status of the Telnet server.
66-70 Explanation
The Telnet server port.
72-79 This is a multiline message written in response
The status of the Telnet server port. to the IFSTAT command. This message consists of
one header line followed by a variable number of
81-88 data lines, each describing an IP interface. This
The name of the TCP/IP job to which this Telnet message is intended for parsing by REXX processing.
server port is connected. A REXX sample, CNMSIFST, is provided to format the
information from this message for readability.

232 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Each data line includes the following information: System action
Columns The stage ends. The BNH501I, BNH502I, and
Description BNH514I messages are also issued to help describe
1-9 the error.
Reserved field.
10-17 Operator response
The TCP/IP job name where the interface was
See the SQL documentation for descriptions of SQL
found.
codes.
19-34
The interface name. BNH501I RDS: number DBSS: number;
number ROWS DONE; string
36-41
The interface index number.
43-45
Explanation
The numeric representation of the Interface This message follows the BNH500E message
type from the ibmMvsIfType object in the to display additional information from the SQL
ibmTcpipMvsIfTable interface table. communications area.
47-47 Message Variables
The IfOperStatus value.
number
50-50
The numbers that are obtained from the SQL
The IfAdminStatus value.
communications area.
53-56
string
The ifVLanId value.
Displays the flags. The blanks have been changed
58-59 to minus signs for alignment purposes.
The ifChpid value.
BNH502I MESSAGE PARAMETER string
61-105
The IP address of the interface.
Explanation
108-115
The name of the sysplex. The SQL communication area has a parameter string
with one or more items in it; each is listed in a separate
117-124
message.
The z/OS image name.
Message Variables
Message Variables
string
numintf
The parameter string from the SQL
The total number of active interfaces known to this
communications area. Each string can contain
NetView program.
more than one item; the items are listed in
separate messages.
System action
BNH503E SQL RC -934: UNABLE TO FIND
The INFTSTAT command processing is completed. MODULE module
BNH500E ERROR number FROM SQL,
DETECTED IN module Explanation
SQL is unable to initialize.
Explanation
Message Variables
A negative return code was received from SQL.
module
Message Variables The name of the module
number
The SQL return code System action
module The stage ends.
The name of the module

Chapter 3. BNH Prefix Messages 233


Operator response BNH507I SQL PROCESSING: string
The NetView JOB might refer to the SQL interface
modules that are not in link libraries. Explanation
BNH504E SQL RC -805: ACCESS MODULE An error occurred in a SQL statement.
name NOT FOUND; REFER TO Message Variables
INSTALLATION INSTRUCTIONS
AND THE CNMSJSQL SAMPLE TO string
GENERATE THE ACCESS MODULE The statement that contains the error
BNH508E DESCRIBE FOLLOWED BY "word";
Explanation MUST BE "SELECT"

The access module is not generated.


Explanation
Message Variables
You must provide the select statement that you want
name described.
The name of the access module
Message Variables
System action word
The operand you had specified
The stage ends.

System action
Operator response
The stage ends.
Contact your system programmer.

Operator response
System programmer response
Use the SELECT operand to designate the beginning of
An access module must be generated before the the query.
SQL stage command can access SQL. See the SQL
information about generating an access module. BNH509E SQL RC -205: COLUMN colname
NOT FOUND IN creator.table
BNH505E OBJECT EXISTS ALREADY

Explanation
Explanation
SQL indicates that colname was not located within the
SQL return code -601 is received, indicating that the specified table.
object you attempted to create is already known to
SQL. Message Variables
colname
System action The name of the column not found in the table.
The stage ends. creator.table
The name of the table.
BNH506E TABLE table DOES NOT EXIST
System action
Explanation
The stage ends.
SQL return code -204 is received, indicating that SQL
is unable to locate the table in its catalogs. BNH510E UNABLE TO OBTAIN HELP FROM
SQL (RETURN CODE number)
Message Variables
table Explanation
The name of the table
A nonzero return code is obtained when reading
the index to the SQL return code information in
System action SQLDBA.SYSTEXT1.
The stage ends. Message Variables

234 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


number BNH513E USE "SQL CONNECT TO" TO
The SQL return code IDENTIFY THE SUBSYSTEM
(REASON hex)
System action
The stage ends.
Explanation
The SQL stage received return code 12 from DSNALI
Operator response or DSNRLI. Typically, either the database is not the
default DSN or you are not authorized to use the
The error reported is typically -934 or -806, which plan DSISQLnn with the resource to which you are
indicate that the DB2 subsystem is not known or that connected.
the access module for the SQL stage command has not
been generated. If additional messages are received, Message Variables
see the NetView online help for those messages. hex
The hexadecimal reason code.
BNH511E SQL HAS NO INFORMATION
ABOUT topic
System action
Explanation The stage ends.
The help function tried to process a help request for
the SQL topic. The tables were successfully selected, Operator response
but the query result is null. This indicates that there is
Use SQL CONNECT TO to specify the subsystem name
no help information available for this topic.
to which you want to connect. This specification
Message Variables remains in effect until the PIPE command ends.
topic BNH514E 10 SQL STAGES ALREADY ACTIVE
The information for which you requested help.
Explanation
System action
There are already 10 active SQL stages.
The stage ends.
System action
Operator response
The stage ends.
Ensure that the values provided in the query are
correctly stated.
Operator response
BNH512E TOO FEW INPUT STREAMS
Change the pipeline topology so that some SQL stages
complete before you start others.
Explanation
BNH515I SQL STATEMENT PREPARED: string
EXECUTE is used to perform SQL commands.
The primary input stream has more SQLINSERT
Explanation
statements without values than there are additional
input streams defined. An error is reported by SQL while it is processing
a dynamically prepared statement. The statement is
System action substituted.

The stage ends. BNH516E CURSOR HAS BEEN CLOSED

Operator response Explanation


Provide the input for the first INSERT on the secondary SQL return code -504 is received while a cursor is used
input stream. The primary input stream is read for to read a line of a query or insert a line. Typically,
additional statements; it is not available for data. another SQL stage command has committed the unit
of work or rolled it back.

Chapter 3. BNH Prefix Messages 235


System action Message Variables

The stage ends. word


The name of the subsystem already in use.
Operator response
System action
Ensure that all concurrent SQL stages specify
NOCOMMIT. To ensure that a query is processed The stage ends.
correctly before the result is processed further, direct BNH520E DB2 ALREADY CONNECTED TO
the result to a stemmed array. It can then be SUBSYSTEM subsystem
referenced by a second pipeline when the return code
for the first one is tested and found to be valid.
Explanation
BNH517E TASK taskname IS NOT STARTED
The SQL stage tried to access the subsystem named
by the SSID operand coded on the SQL stage, but the
Explanation subsystem named in the BNH520E message is already
The NetView taskname is needed for the request. in use.

Message Variables Message Variables

taskname subsystem
The name of the NetView task The name of the subsystem already in use

System action System action


The stage ends. The SQL stage ends with an error.

Operator response System programmer response


Issue the START TASK=task command to start the Ensure procedures that specify the SSID in the SQL
task. pipe stage close the plan properly. This message can
result from using the NOCLOSE option that is not
BNH518E DB2 NOT PRESENT IN SYSTEM followed by a PIPE to close the plan. You cannot
access 2 different subsystems from a single task at
Explanation the same time. A PIPE SQL EXECUTE COMMIT WORK
command can be added to ensure that the plan is
On MVS, the module DSNALI or DSNRLI cannot be closed.
loaded. This indicates that DB2 libraries are not part of
the NetView procedure STEPLIB. BNH521E ERROR number REASON hex ON
CALL TO interface fn
System action
Explanation
The stage ends.
The return code (register 15) and reason code (register
0) substituted are received in response to a call to CAF
Operator response or RRS for interface fn.
Contact your system programmer. Message Variables
number
System programmer response
The error number
Ensure that DB2 is installed and available. hex
BNH519E DB2 CONNECTION USING PLAN The hexadecimal reason code.
word ALREADY ACTIVE interface fn
The value is DSNALI for CAF, and DSNRLI for RRS.
Explanation
System action
The option PLAN is specified, but a different plan is
already in use. The stage ends.

236 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH522E SUBSYSTEM subsystem IS NOT BNH525E LEFT PARENTHESIS MISSING
DEFINED
Explanation
Explanation
A left parenthesis is expected for a list of items, but
The subsystem identification specified on the SQL pipe was not found.
stage is not valid or not defined.
Message Variables System action
subsystem The PIPE command or stage ends.
The name of the subsystem
BNH526E RIGHT PARENTHESIS MISSING

System action
Explanation
The PIPE ends.
A left parenthesis for a list of items was encountered,
but the right parenthesis was not found.
Operator response
Contact your database administrator to determine System action
the subsystem ID to specify, or contact your system
The command ends.
programmer to generate the correct subsystem value
for the SQL pipe stage.
Operator response
System programmer response Issue the command again with the closing
parenthesis.
Define the correct subsystem to the SQL pipe stage.
BNH527E NOTHING SPECIFIED BETWEEN
BNH523E PLAN word IS NOT AUTHORIZED
PARENTHESES

Explanation
Explanation
DSNALI or DSNRLI returns reason code X'00F30034',
Only blank characters were found between the
which indicates that the user is not authorized for the
opening and closing parentheses.
substituted plan name.
Message Variables
System action
word
The PIPE command or stage ends.
The name of the substituted plan
BNH528I DB2 subsystem TERMINATED
System action CODE termcode

The stage ends.


Explanation
BNH524E SUBSYSTEM name IS NOT UP
The connection to DB2 subsystem ended because of
termcode.
Explanation
Message Variables
DSNALI or DSNRL1 returns reason code X'00F30002',
subsystem
X'00F30011', or X'00F30012' to indicate that the DB2
The name of the DB2 subsystem
system is not up.
termcode
Message Variables The termination code that caused DB2 to end.
name
The name of the subsystem System action
The connection is reestablished automatically when
System action DB2 is fully reinitialized.
The stage ends.

Chapter 3. BNH Prefix Messages 237


Operator response number
The handle number.
Restart the DB2 subsystem.
BNH529I DB2 subsystem NOT ACTIVE System action
Processing of the SQL request ends.
Explanation
The DB2 subsystem is not active or is in the process Operator response
of being started. The connection is established
automatically when DB2 is fully initialized. Contact your system programmer.

Message Variables
System programmer response
subsystem
The name of the DB2 subsystem. Contact IBM Software Support.
BNH533I data
System action
The DSIDB2MT task waits for notification from DB2 Explanation
when initialization has completed. This message is displayed when the NRMCTL
BNH530I Interface LEVEL DOES NOT MATCH LISTMON command is issued and contains the
DB2 subsystem standard text presentation form of an IPv6 address for
a monitored NetView domain.

Explanation The BNH533I message follows the BNH684I message


when that message indicates that the communication
The DB2 subsystem is at a different level than the mode is IPV6. The BNH533I message displays the
interface loaded by DSIDB2MT. NetView cannot use entire IPv6 address.
the DB2.
Message Variables
Message Variables
data
subsystem The IPv6 address of a host with a NetView domain
The name of the DB2 subsystem. being monitored by this NetView program. Leading
interface blanks are added to the insert so that the address
The name of the interface loaded by DSIDB2MT. is aligned with the IP ADDRESS column in the
NRMCTL LISTMON display.
System action
System action
The DSIDB2MT task ends.
Processing continues.
Operator response BNH535A nnnn MESSAGES NOW RETAINED
BY taskname
Contact your system programmer.

Explanation
System programmer response
The CNMCSSIR task has a queued backlog of
Change the NetView JCL to reference the correct
messages consisting of action and non-action
level of DB2 libraries. The DSNALI or DSNRLI module
messages marked with the DOMACTION(DELMSG) or
did not match the level of DB2 for the named DB2
DOMACTION(AUTOMATE) automation action, and that
subsystem.
backlog has exceeded the MAXCSSIR limit defined by
BNH531I INCORRECT HANDLE number ON the DEFAULTS command. These are messages which
CALL TO DSISQLRQ have not been removed by an MVS delete operator
message (DOM) signal. These messages might also
be queued in the Action Message Retention Facility
Explanation (AMRF) in MVS.
An internal processing error occurred.
Message Variables
Message Variables

238 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


nnnn sgn_rtd_num
The number of messages in the queue (the current Number of DOM signals routed by the CNMCSSIR
threshold value). task because there were matching held messages.
taskname rtd_msg_num
The CNMCSSIR task whose queue is exceeded. Number of retained messages awaiting delete
operator message (DOM) signals on the CNMCSSIR
System action queues.

This message is issued when CNMCSSIR detects that


System action
the action-message queue threshold value (DEFAULTS
MAXCSSIR=nnnn) has been reached. Message BNH536I is issued by the DSILSSIR STATS
command.
Operator response BNH537I taskname MG=umsg_num
Browse the NetView log to see if sample CNME1103 CD=cmd_num DM=sgn_rcvd_num
ran. This sample is meant to run when BNH535A is RT=sgn_rtd_num
issued. It is defined in the DSITBL01 (CNMS1015), the QH=rtd_msg_num
sample automation table. CNME1103 issues message
BNH539I to the NetView log for each message it Explanation
deletes. Notify your system programmer about the
messages reported by BNH539I. This message contains the MVS message and
command statistics by task.
If CNME1103 is not being issued, notify your system
programmer. Message Variables
taskname
System programmer response Name of the task that has extended console data
traffic statistics
If there are many BNH539I messages logged,
umsg_num
determine whether an application is issuing action
Number of unsolicited messages received by the
messages, or non-action messages marked with the
task
DOMACTION(DELMSG) or DOMACTION(AUTOMATE)
automation action, without issuing a DOM; this can be cmd_num
an application programming error. Number of commands received by the task

If CNME1103 is not issuing message BNH539I, sgn_rcvd_num


change the automation table to include automation for Number of delete operator message (DOM) signals
BNH535A. For example, see sample DSITBL01. received by the task
sgn_rtd_num
BNH536I MG=umsg_num CD=cmd_num Number of DOM signals routed by the task
DM=sgn_rcvd_num because there were matching held messages.
RT=sgn_rtd_num
QH=rtd_msg_num rtd_msg_num
Number of retained messages awaiting DOM
signals in the task's queue.
Explanation
This message contains the CNMCSSIR MVS message System action
and command statistics.
Message BNH537I is issued by the DSILSSIR
Message Variables ALLSTATS command.
umsg_num BNH538I systemid jobname jobnumber
Number of unsolicited messages received by the addspace_id wtoseq msg_type
CNMCSSIR task nvdel_id msg_text
cmd_num
Number of commands received by the CNMCSSIR Explanation
task
The messages listed in message BNH538I are waiting
sgn_rcvd_num
for delete operator message (DOM) signals from the
Number of DOM signals received by the CNMCSSIR
MVS system to delete them.
task

Chapter 3. BNH Prefix Messages 239


Message Variables Message Variables
systemid bnh538i_message_text
MVS system name The BNH538I message containing a description of
jobname the message that was deleted. CNME1103 uses
MVS job name command DSILSSIR to generate this text.

jobnumber
MVS job number System action
addspace_id Message BNH539I is written to the NetView log for
MVS address space identifier in hexadecimal each message deleted by CNME1103.
wtoseq
MVS WTO sequence number, as used by the DOM Operator response
macro
Notify your system programmer when you receive
msg_type multiple BNH539I messages.
Message types are as follows:
A System programmer response
Action message, or non-action message
marked with the DOMACTION(DELMSG) or Investigate these messages to determine which
DOMACTION(AUTOMATE) automation action. application is creating the backlog. Use information
in the BNH538I message to identify the job, address
M
space, and message text involved in the problem.
Multiple line message for which no end line
was received BNH541I lcldate lcltime (gmtdate gmttime)
T LOCAL TIME ADJUSTMENT
Solicited message that has not been STARTED
automated. If no DOM is received for this
message within approximately 11 seconds Explanation
after being issued, this message is deleted.
If this message is automated before being The NetView program has recognized that the local
deleted, it is either deleted (if no DOM is system time has changed. That is, the offset from
expected) or converted to a msg_type of A. GMT has changed. As a result, all timers specified
as LOCAL are adjusted so that they run at the
W same local time that they had before the time
Write-to-operator with reply change. In addition, session monitor tasks DSIAMLUT,
nvdel_id AAUTCNMI, and AAUTSKLP, if they are active, are
Identifier that you can use with the NetView DOM stopped and restarted to account for the time change.
command to delete the message from the NetView Note: The local date lcldate and local time lcltime
program without removing it from MVS represent the values that the NetView program was
msg_text using before the time change.
Text of the message that was retained
Message Variables

System action lcldate


The local date of when the time adjustment
Message BNH538I is issued by the DSILSSIR started.
SHOWMSG command and lists the messages in the
lcltime
CNMCSSIR action-message queue.
The local time of when the time adjustment
BNH539I CNME1103 DELETED started.
bnh538i_message_text gmtdate
The GMT date of when the time adjustment
Explanation started.
gmttime
This message is issued by CNME1103 to the NetView
The GMT time of when the time adjustment
log to identify messages that have been purged from
started.
the system because of the MAXCSSIR threshold being
reached. BNH542I lcldate lcltime (gmtdate gmttime)
LOCAL TIME ADJUSTMENT ENDED

240 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation is incorrect. The MVS system requires 1 - 8 characters
in the range of X'41' to X'FE'.
The NetView program has completed adjusting timers
that had been specified as LOCAL and has requested
that DSIAMLUT, AAUTCNMI, and AAUTSKLP be Operator response
recycled. Report the problem to the system programmer.
Message Variables
lcldate System programmer response
The local date of when the time adjustment Change the value that is specified in the
started. MVSPARM.Cmd.Designator style statement. You can
lcltime enable the new value by entering
The local time of when the time adjustment
RESTYLE MVSPARM
started.
gmtdate The new value becomes active when the NetView
The GMT date of when the time adjustment program is recycled.
started.
BNH545E PREFIX 'prefix_value' IS A
gmttime DUPLICATE
The GMT time of when the time adjustment
started.
Explanation
BNH543E UNEXPECTED CPF ERROR CODE=
return_code REASON= reason_code The prefix value is already registered to another
subsystem.

Explanation Message Variables

The CPF macro attempt failed. The return code has prefix_value
no recommended action in the description of the CPF The value that is specified on the
macro. MVSPARM.Cmd.Designator statement in the
CNMSTYLE member.
Message Variables
return_code System programmer response
The register 15 return code value from the CPF
MVS system macro. Change the value that is specified in the
MVSPARM.Cmd.Designator style statement. You can
reason_code enable the new value by entering
The register 0 reason code value from the CPF MVS
system macro. RESTYLE MVSPARM

The new value becomes active when the NetView


Operator response program is recycled.
Notify your system administrator. Keep a record of the
BNH546E PREFIX 'prefix_value' IS A SUBSET
error code and reason code. The NetView program
OF ANOTHER
can start without a command designator. See the
MVSPARM.Cmd.Designator statement in CNMSTYLE,
described in IBM Z NetView Administration Reference. Explanation
The prefix value conflicts with a value that is already
System programmer response registered to another subsystem. The specified prefix
is the abbreviation of another prefix in the subsystem.
Contact IBM Software Support.
In MVS, prefix values must be unique.
BNH544E THE PREFIX CHARACTERS ARE Message Variables
NOT VALID
prefix_value
The value that is specified on the
Explanation MVSPARM.Cmd.Designator statement in the
The value supplied on the style statement CNMSTYLE member.
MVSPARM.Cmd.Designator in the CNMSTYLE member

Chapter 3. BNH Prefix Messages 241


System programmer response then the object variable is the NetView domain
name. If the XCF group is valid but the member
Change the MVSPARM.Cmd.Designator statement to name that is specified on the MEM operand is not
provide a valid designator. in the group, then the object variable is the XCF
BNH547E PREFIX 'prefix_value' IS A group name.
SUPERSET OF ANOTHER
Operator response
Explanation Determine whether you want the function performed
The prefix value conflicts with a value that is already for any of the listed objects.
registered to another subsystem. Another prefix in the For the LOGTSTAT command, to activate SMF logging
subsystem is an abbreviation of the specified prefix for the specified task, enter one of the following
value. In MVS, the prefix must be unique. commands:
Message Variables
DEFAULTS LOGTSTAT=YES
prefix_value
The value specified on the or
MVSPARM.Cmd.Designator statement in the
OVERRIDE TASK=object,LOGTSTAT=YES
CNMSTYLE member.
Note: It is possible that SMF recording is not active
System programmer response because of MVS user exits that are in effect or
MVS commands that were issued. Ask your system
Change the MVSPARM.Cmd.Designator statement to programmer to determine the SMF settings for the
provide a valid designator. MVS program.
BNH548I 'function' IS NOT ACTIVE FOR For the TCPCONN or PKTS command, the specified
'object' stack is not defined. For more information, see
the command help for TCPCONN DEFINE or PKTS
Explanation DEFINE.
The request was not performed for the specified
object. System programmer response
• If this message is listed for the LOGTSTAT command, For the LOGTSTAT command, adjust the SMF settings
SMF recording was not active for the specified task. as needed to activate SMF recording.
• If this message is listed for the STOP XCFGROUP BNH549I CHRON NOTIFY= eventname BY=
command, then command processing failed. The issueoper ID= timerid ROUTE=
function and object inserts describe the reason for runoper COMMAND= 'text'
the failure, either an invalid XCF group name or
member name.
Explanation
Message Variables
This message is issued when a timer event occurs
function for a CHRON command that had the NOTIFY option
The name of the service that was not performed, specified. It provides auditing of RUN, REMOVE,
such as SMF for the LOGTSTAT command. IGNORE, and PURGE events.
For the STOP XCFGROUP command, if the NetView Message Variables
program has not joined the specified XCF group,
eventname
then the function variable is the name of the
The eventname can be one of the following:
specified XCF group. If the XCF group is valid
but the member name that is specified on MEM REMOVE
operand is not in the group, then the function Signifies that the timer was run and was
variable is the member name. removed because it was either specified to run
only once, or the time specified by the REMOVE
object operand had been reached.
The name of the object affected.
PURGE
For the STOP XCFGROUP command, if the NetView Signifies that the CHRON command was
program has not joined the specified XCF group, deleted using the PURGE command, or

242 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


because the AUTOLGN recovery option used Operator response
an operator name that is not defined to the
NetView program. If undesirable or unexpected results were received,
notify the system programmer.
IGNORE
Signifies that the CHRON command was
not run because RECOVERY=IGNORE was System programmer response
specified and the operator or task was not If undesirable or unexpected results were received,
active when the time was reached. review automation procedures and automation tables.
RUN
BNH550E REMOVE TIME IS LESS THAN OR
Signifies that the command was successfully
EQUAL TO RUN TIME
sent to the task.
SKIP
Signifies that one or more occurrences of the Explanation
command for timerid were not run because the The time specified by the REMOVE operand on the
local time changed, which caused the timer CHRON command is earlier or the same time as the
to be skipped. The timer is scheduled to run scheduled command run time.
at the next interval specified by the EVERY
keyword.
System action
issueoper
The name of the operator or task that issued the The NetView program ignores the CHRON command.
CHRON command.
timerid Operator response
The specified user or the system-generated timer Specify a remove time that is later than the time the
ID. command is run.
runoper
The name of the operator or task on which the System programmer response
command runs.
CHRONtext If the CHRON command was issued by a procedure,
The entire text of the original CHRON command, update the procedure to specify a valid value for the
with the following keywords appended: REMOVE time.

PGMAT BNH551I DB2 SSID CURRENTLY HAS NO


Specifies the date and time the command runs DEFAULT
in programmer format.
PGMINTVL Explanation
Specifies the interval time in programmer The SSID operand was omitted on the SQL pipe
format. stage and there is no default subsystem name for the
PGMFOR request.
Specifies the FOR interval in programmer
format.
System action
PGMOFF
Specifies the date and time corresponding to The NetView program ignores the PIPE.
the OFF time in programmer format.
PGMREMOV Operator response
Specifies the REMOVE date and time in Start the DSIDB2MT task to establish a default, or
programmer format. specify the SSID operand on the SQL pipe stage.

System action System programmer response


The message is sent to the operators specified with If the SQL stage was issued by a procedure, update
NOTIFY after the CHRON event is processed. the procedure to specify a valid value for the SSID
operand, or make sure the DSIDB2MT task is started.
BNH552I DB2 INTERFACES WERE NEVER
LOADED

Chapter 3. BNH Prefix Messages 243


Explanation Operator response
The NetView program did not load the DB2 interface Change the time and date, or add or fix the EVERY
modules when it was started. operand.

System action System programmer response


The NetView program cannot access DB2. Correct the procedure if the CHRON command was
part of automation programming.
Operator response BNH555I taskname ABEND DEFERRED FOR
Contact your system programmer. 'reason'

System programmer response Explanation


If DB2 access is needed and the DB2SEC CNMSTYLE Task taskname cannot be stopped because of 'reason'.
statement is set to *NONE*, copy the DB2SEC Possible causes are as follows:
statement from the CNMSTYLE member to the MVS CONSOLE RELEASE
CNMSTUSR or CxxSTGEN member and choose The task is releasing an MVS console. The release
another value before restarting the NetView program. can take more time if there are many consoles
Otherwise, review related messages that occurred allocated or released at the same time.
during NetView initialization. Verify that the DB2 load number
module library can be accessed by the NetView This message was issued incorrectly. The number
program. You might need to add a STEPLIB DD should have been translated to a reason by the
statement to the NetView JCL. NetView program. Contact IBM Software Support.
BNH553I CHRON DEBUG OUTPUT This message is sent to the NetView authorized
receiver once a minute during the delay in task
Explanation termination.

This message identifies the debugging output of the


CHRON command. System action
The NetView program only defers issuing System
System action Abend 0EC4 for tasks whose termination exceeds
a one minute criteria, until 'reason' processing is
The NetView program ignores the PIPE. completed. Other abends are not prevented during this
process. For example, a STOP FORCE command can
System programmer response cause an (untimed) System Abend 0EC4. BNH555I is
issued when the following occurs:
Forward the output to the IBM Software Support
representative who requested the information. 1. A normal logoff of the task has been scheduled.
2. The task has taken more than 1 minute to end.
BNH554E CHRON 'AT' TIME IS IN THE PAST.
3. The abend must not occur because of 'reason'.
Explanation
Operator response
You entered a CHRON command specifying an AT
time that is earlier than the current time, and no Monitor the task. If the task does not end, and
EVERY operand was specified. This message might the 'reason' is 'MVS CONSOLE RELEASE', the MVS
also appear if there was a syntax error in the EVERY extended console might not be usable until the
operand. NetView program is stopped, especially if the task is
forced to end by using additional STOP commands.
Notify the system programmer to consider writing an
System action
automated response to BNH555I.
The CHRON command is not scheduled.
System programmer response
Consider writing an automated procedure to process
BNH555I. Depending on the typical response time

244 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


for your system, you might need to time the task System action
termination and issue additional STOP commands
only if the task does not stop within the time The command does not continue.
period wanted. If the NetView program prints multiple
BNH555I messages for a task, generate an MVS Operator response
memory dump. This memory dump might be needed
to resolve an MVS console problem. Notify the system programmer.

BNH556I 'taskname1' IS WAITING FOR


System programmer response
'taskname2' TO CLOSE 'resource'
Correct the data definitions where appropriate.
Explanation BNH558E UNABLE TO CONTACT name USING
Task taskname1 cannot be stopped because aliases
taskname2 is using resource. Task taskname2 must
use CLOSE on the resource to enable taskname1 to Explanation
stop. When taskname1 is the name of the DSIDB2MT
task and the resource is a DB2 subsystem name, This message is issued when the enterprise master
then taskname2 used the PIPE SQL stage with NetView program has used all the aliases defined on
the NOCLOSE option and never released the plan. an ENT.SYSTEMS statement in the CNMSTYLE member
Taskname2 can complete the DB2 transactions by and cannot contact the specified system.
using PIPE SQL EXECUTE COMMIT WORK, or any other Message Variables
PIPE SQL request that does not specify NOCLOSE.
name
This message is sent once a minute during the delay in The name section of an ENT.SYSTEMS.name
termination for each task preventing taskname1 from statement in the CNMSTYLE member. The alias
stopping. or aliases on the statement can be NetView
programs that are part of a sysplex XCF group
System action with multiple NetView programs or a NetView
program in a stand-alone XCF configuration, for
The NetView program defers stopping taskname1 until example a monoplex system. The name can be 1
taskname2 is finished with the resource. - 8 alphanumeric characters including any of these
special characters:
Operator response # @ $
Verify taskname2 finishes using the resource. For DB2,
the plan is closed when the task ends, if action was not aliases
taken earlier. The aliases that were used.

System programmer response System action


Review the use of SQL on taskname2. There might Processing for the ENT.SYSTEMS.name statement
be a procedure using PIPE SQL NOCLOSE that does is complete. Additional ENT.SYSTEMS or ENT.INT
not issue PIPE SQL EXECUTE COMMIT WORK before statements are processed, if present.
exiting. BNH559E COMMAND cmd FAILED.
BNH557E MISMATCH DETECTED BETWEEN REASON=reason_code
var1 AND var2 ENTRIES IN var3.
Explanation
Explanation The indicated command failed during processing.
The data required by the command is not paired Message Variables
properly.
cmd
Message Variables The name of the command that failed.
var1, var2 reason_code
The data that is mismatched. The reason code that is returned.
var3 For the PLEXCTL command:
The location of the data definitions.

Chapter 3. BNH Prefix Messages 245


1 BNH560I KEEP Status for taskname
Command is redundant. For example,
PLEXCTL RANK=250 is specified on a
Explanation
system that is already a master, or
PLEXCTL TAKEOVER=DISALLOW is issued This is a multiline message written in response to
when takeovers are already disallowed. the QRYKEEP command. This message consists of a
2 header line followed by a variable number of data
The NetView program is not a member of the lines, each describing the KEEP class (global or local),
DSIPLXnn group. number of associated messages, total storage used,
timeout seconds, and the KEEP identifier.
3
The requesting member is not a master Message Variables
NetView program (TAKEOVER). taskname
4 The task name under which the QRYKEEP
Internal error encountered during processing. command was issued.
For the RESTYLE ENT command:
11
System action
The requesting member is not a sysplex The QRYKEEP command processing has completed.
master.
BNH561E IEFPRMLB ALLOCATE ISSUED
12 BY NETVIEW MVS COMMAND
ENTERPRISE definitions were not found and EXIT FAILED. RC=rc, REASON
previous ENTERPRISE definitions are not in CODE=reason
effect.
13 Explanation
Unable to contact any SYSTEMS aliases.
14 IEFPRMLB request is issued from the NetView MVS
The RESTYLE ENT command timed out waiting Command Exit (DSIMCAEX) as a result of the SET
for responses to ENT.SYSTEMS statement CNMCAUT=xx command. IEFPRMLB failed to allocate
processing. At least one ENT.SYSTEMS the PARMLIB.
statement was processed successfully. Message Variables
Processing for other statements might
complete successfully after the timeout. rc
The return code returned by IEFPRMLB in register
15 15.
The RESTYLE ENT command timed out waiting
for responses to ENT.SYSTEMS statement reason
processing. No ENT.SYSTEMS statement had The reason code returned by IEFPRMLB in register
processed successfully before the timeout. 0.
Processing for other statements might
complete successfully after the timeout. System action
16 CNMCAUxx is not processed.
ENT.GROUP statements were updated. The
requesting member is not a sysplex master.
Operator response
For DVIPA-related commands:
Correct the error and re-enter the command.
21
The command as it was entered must be BNH562E IEFPRMLB FREE ISSUED BY
issued from a master NetView program. NETVIEW MVS COMMAND
EXIT FAILED. RC=rc, REASON
CODE=reason
System action
Command processing stops. Explanation
IEFPRMLB failed to free the PARMLIB.
Operator response
Message Variables
Check the reason code for the appropriate action.

246 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


rc System programmer response
The return code returned by IEFPRMLB in register
15. Contact IBM Software Support.
reason BNH566E WILDCARD CHARACTERS CANNOT
The reason code returned by IEFPRMLB in register BE SPECIFIED AT BOTH ENDS
0. OF A COMMAND OR CONSOLE
STATEMENT
Operator response
Explanation
Correct the error and re-enter the command.
Wildcard character (*) is found at both the beginning
BNH563I NETVIEW CNMCAUT PARMLIB and the end of a statement. Message BNH395I follows
PROCESSING IS BUSY. PLEASE this message.
TRY AGAIN LATER.

System action
Explanation
CNMCAUaa member is not processed.
NetView MVS COMMAND MANAGEMENT is processing
a PARMLIB member.
Operator response
System action Correct the error and enter the command again.
CNMCAUxx is not processed. BNH567I NetView MVS command exit
termination requested for
module_name
Operator response
Re-enter the command at a later time. Explanation
BNH564E CONTINUATION LINE MISSING The MVS program ended the indicated NetView
FOR COMMAND MVS command exit. The exit might have also been
reloaded, if the message is in response to an MVS
Explanation SET MPF command. You can check the status of the
NetView command processing exits by using the MVS
Continuation column (column 72) for command D MPF command.
specified in command exclusion or inclusion list is not
blank but no continuation line is found. Message Variables
module_name
System action The name of the exit that ended. The following are
possible values for module_name:
CNMCAUxx is not processed.
DSIMCAEX
This exit is associated with MVS COMMAND
Operator response MGT.
Correct the statement in error and enter the SET DSIRVCEX
CNMCAUT=value command again. This exit is associated with MVS COMMAND
BNH565E NETVIEW MVS COMMAND EXIT REVISION.
INTERNAL ERROR. PLEASE
CONTACT TIVOLI. Operator response
If the NetView MVS Command Management is needed,
Explanation enter the SET MPF=xx command again.
An internal logic error is detected in NetView MVS BNH568I NETVIEW MVS COMMAND
COMMAND MANAGEMENT. MANAGEMENT PARMLIB MEMBER
member IS DELETED
System action
The NetView program ignores the message call and
continues processing.

Chapter 3. BNH Prefix Messages 247


Explanation Explanation
A SET CNMCAUT=DELETE command is issued and the This is an NLS translatable line generated for the
PARMLIB member member is now deleted DSIZKNYJ command that edits the DSITCPRF file
when cryptography exit DSIEX21 is active.
Message Variables
Note: The translated text must fit in 79 single
member
character positions to keep the screen format correct.
The PARMLIB member name, CNMCAUaa.
BNH569E NO NETVIEW MVS COMMAND Operator response
MANAGEMENT PARMLIB MEMBER
IS ACTIVE Read the information about the DSIZKNYJ edit screen.
BNH574I YOU ARE EDITING 'DSITCPRF' IN
Explanation 'DSIPRF'.
A SET CNMCAUT=DELETE command is issued but no
PARMLIB member is being used. Explanation
This is an NLS translatable line generated for the
System action DSIZKNYJ command that edits the DSITCPRF file
when cryptography exit DSIEX21 is active.
The command is ignored.
Note: The translated text must fit in 79 single
BNH571I F5=TOP F6=BOT F9=UP1
character positions to keep the screen format correct.
F10=DOWN1 F12=DONE

Operator response
Explanation
Read the information about the DSIZKNYJ edit screen.
This is an NLS translatable line generated for the
DSIZKNYJ command that edits the DSITCPRF file BNH575E SCREEN DATA ERROR, PLEASE
when cryptography exit DSIEX21 is active. TRY AGAIN.
Note: The translated text must fit in 79 single
character positions to keep the screen format correct. Explanation
The input data from the screen cannot be read by
Operator response DSIZKNYJ.
Read the information about the DSIZKNYJ edit screen. Note: The translated text must fit in 79 single
character positions to keep the screen format correct.
BNH572I You change displayed lines by
typing on them.
System action
Explanation The input is ignored and the screen is rewritten.
This is an NLS translatable line generated for the
DSIZKNYJ command that edits the DSITCPRF file Operator response
when cryptography exit DSIEX21 is active. Try the input again.
Note: The translated text must fit in 79 single
character positions to keep the screen format correct. System programmer response
Report the problem to IBM Software Support if the
Operator response problem was not caused by pressing the wrong keys.
Read the information about the DSIZKNYJ edit screen.
BNH576I YOU DELETE A LINE BY ERASING
BNH573I To add more data, type on the +++ THE DATA ON THAT LINE.
+-> line, and then press <ENTER>.
Explanation
This is an NLS translatable line generated for the
DSIZKNYJ command that edits the DSITCPRF file
when cryptography exit DSIEX21 is active.

248 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Note: The translated text must fit in 79 single Operator response
character positions to keep the screen format correct.
Enter the correct password or password phrase, or
press F3 to exit without modifying the file.
Operator response
BNH580I 'DSITCPRF' IS ALREADY BEING
Read the information about the DSIZKNYJ edit screen. EDITED.
BNH577I Enter DSITCPRF edit password
(twice). Explanation
DSIZKNYJ cannot access the DSITCPRF because the
Explanation file was being edited elsewhere, or was being re-
The DSITCPRF editor prompts you for the password encrypted automatically by the NetView program.
when writing the file to disk or reading it back in.
Note: The translated text must fit in 79 single System action
character positions to keep the screen format correct. The editor exits.
BNH581W 'DSITCPRF' IS NOT ENCRYPTED.
System action
The NetView program waits for the operator response. Explanation
This message is issued when the NetView program
Operator response detects an unencrypted DSITCPRF member and a
Enter the password, or use PF3 to exit the editor DSIEX21 user exit is active. This serves as a security
without changing the file. audit trail of the DSITCPRF member.

BNH578I F3=QUIT (NO SAVE) F12/


ENTER=PROCESS System action
The NetView program attempts to encrypt the file.
Explanation
This is an NLS translatable line generated for the System programmer response
DSIZKNYJ command that edits the DSITCPRF file If this message repeats, it might indicate that
when cryptography exit DSIEX21 is active. someone is replacing the encrypted DSITCPRF
Note: The translated text must fit in 79 single member with a plain text copy.
character positions to keep the screen format correct. BNH582W 'DSITCPRF' NEEDS RE-
ENCRYPTION.
Operator response
Read the information about the DSIZKNYJ edit screen. Explanation
BNH579I PASSWORD validation error. The NetView program detects that the file can be
Please try again. encrypted using the second key supplied by DSIEX21
and not the first one.

Explanation
System action
Either both passwords or password phrases did not
match each other, or the password or password phrase The NetView program encrypts the file again with the
is incorrect for the file being edited. new key.

Note: The translated text must fit in 79 single


character positions to keep the screen format correct. System programmer response
This message indicates that a key-update is in
System action process. Make sure that you expect these results.

The program prompts again for input. BNH583W 'DSITCPRF' ENCRYPTION


COMPLETED.

Chapter 3. BNH Prefix Messages 249


Explanation System programmer response
This message is issued when the NetView program Implement a DSIEX21 to enable DSIZKNYJ.
writes the newly encrypted DSITCPRF to disk.
BNH586I SYNTAX ERROR ON LINE nnnnnn

System action
Explanation
The NetView program continues processing with the
newly encrypted DSITCPRF member. DSIZKNYJ detected a syntax error on the line noted.
The line in error is displayed on the screen. This
message appears when you press F12 during an edit
System programmer response session. The first error in the file reported. Typical
Use this message for auditing the DSITCPRF change syntax errors are:
process. • Missing colon after operator ID.
BNH584E 'DSITCPRF' DECRYPTION • Less than 2 keys were specified.
UNSUCCESSFUL. Note: The translated text must fit in 79 single
character positions to keep the screen format correct.
Explanation Message Variables
The DSITCPRF processing cannot be decrypted and
nnnnnn
was not detected to be in plain text format. The
The line number in error.
DSITCPRF file is unusable.

Operator response
System action
Correct the error. Press F12 again to find the next error
The NetView program processes as if there are no
until the password prompt appears.
definitions in DSITCPRF.
BNH587I scope MASTER master_name
Operator response ACTIVE IN GROUP group_name.
TAKEOVER NOT ALLOWED.
Notify the system programmer.
Explanation
System programmer response
This message is issued when a system-defined master
Recreate the DSITCPRF file. You might need to erase NetView program (rank of 250) initializes and there is
the damaged copy of DSITCPRF to enable access. already a master in the sysplex that is not allowing
Stop and restart the CNMTAMEL task to allow access takeovers. This message can also be issued because of
to the new DSITCPRF file. If you create a new plain processing initiated by the PLEXCTL command.
text version of DSITCPRF, place it in the first DD
Message Variables
in the DSIPRFDD concatenation. Otherwise the plain
text copy remains accessible and is not replaced. The scope
encrypted version is filed in the first data set in the list The scope, which is SYSPLEX
of DDs and is used by the NetView program, even if a master_name
plain text copy exists elsewhere. The name of the master NetView program
BNH585E ENCRYPTION CAPABILITY IS NOT group_name
AVAILABLE. The name of the sysplex group

Explanation Operator response


You tried to use DSIZKNYJ without having an active When this situation occurs, the NetView program
DSIEX21. attempting to become the master sets its status to
master capable. If you want this NetView program to
System action be the master NetView program, allow takeovers of
the current master using the PLEXCTL command.
The request is ignored.

250 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH588I WAITING FOR scope MASTER IN XCFMSG receive stage is outstanding for the group, the
GROUP group_name TO BECOME messages are sent to the XCFMSG stage. Otherwise,
ACTIVE. the message is sent to the authorized receiver.
Message Variables
Explanation
member_name
This message is issued when a master-capable The name of the member
NetView program cannot find a master NetView group_name
program in the sysplex when it initializes. The name of the group
Message Variables message
scope The second line of the message containing the text
The scope, which is SYSPLEX of the received message.

group_name BNH591I name CONTACTED USING alias


The name of the XCF group
Explanation
System action This message is issued when an enterprise
The master-capable program waits the number of master NetView program successfully processes an
minutes specified in the XCF.TAKEOVER.INITWAIT ENT.SYSTEMS statement and establishes a connection
statement for a master to become active. If no master to another NetView program using one of the aliases
becomes active, the master-capable assumes the role on the ENT.SYSTEMS statement.
of the master NetView program. Message Variables
BNH589I GROUP group_name MEMBER name
member_name STATUS CHANGE. The name section of an ENT.SYSTEMS.name
NEW STATUS=status PREVIOUS statement in the CNMSTYLE member. The alias
STATUS=status or aliases on the statement can be NetView
programs that are part of a sysplex XCF group
Explanation with multiple NetView programs or a NetView
program in a stand-alone XCF configuration, for
This message is issued when a status change is example a monoplex system. The name can be 1
detected for a member in the group. - 8 alphanumeric characters including any of these
Message Variables special characters:
group_name # @ $
The name of the group
alias
member_name
The alias or domain name that is specified
The name of the member
on the ENT.SYSTEMS statement. If the alias
status is for a NetView program in a sysplex XCF
The status can be one of the following defined XCF group with multiple NetView programs, the alias
states: NetView program forwards information about all
• ACTIVE the NetView programs in its XCF group when it is
contacted because of ENT.SYSTEMS processing.
• CREATED
• FAILED BNH592I MEMBER member_name HAS
JOINED GROUP group_name.
• NOT-DEFINED
• QUIESCED Explanation
BNH590I XCF MESSAGE RECEIVED This message is issued when a new member is added
FROM member_name IN GROUP to a group. This message is sent to the authorized
group_name message receiver.
Message Variables
Explanation
member_name
This is the first message in a multiline message that The name of the new member
is issued when an XCF message is received. If an

Chapter 3. BNH Prefix Messages 251


group_name B'x... .... .... ....'
The name of the group A value of 1 indicates that takeovers have been
disallowed using the PLEXCTL command.
BNH593I MEMBER member_name HAS LEFT
GROUP group_name. B'.xxx .... .... ....'
Three bits indicating why this NetView program
has assumed the master role (if it is a master). The
Explanation following values can be displayed:
This message is issued when a member leaves a 000
group. This message is sent to the authorized receiver. Not a master NetView program
This message is also issued at the enterprise master 001
NetView program when a member leaves an XCF A backup NetView program has taken over as
group. master because another NetView program did
not assume the master role during the interval
Message Variables
specified on the XCF.TAKEOVER.INITWAIT
member_name statement for this NetView program.
The name of the former member 010
group_name Defined as a master NetView program with the
The name of the group XCF.RANK statement
BNH594I PLEXNAME GROUP MEMBER 100
SYSTEM STATUS ROLE RANK DUR A backup NetView program that has taken over
FLGS VER TIMESTMP TOKEN as master
110
Explanation A NetView program that used the PLEXCTL
command to become the master.
This message is a header message that is issued
in response to a LIST STATUS=XCFGRPS,GROUP= B'.... x... yy.. ....'
groupname | DSIPLXxx | DSIPLX* command. A value of 1 in the x position indicates that this
master NetView program is an enterprise master. If
The displayed information includes: it is an enterprise master, the values in yy indicate
• Sysplex name the enterprise data that they manage:

• Group name 10
DISCOVERY data
• Member name
01
• System on which it is run ACTIVEACTIVE data
• XCF status of the member 11
• Role that the NetView program has in the group: Both DISCOVERY data and ACTIVEACTIVE data
– B - Basic B'.... .xxx ..xx xxxx'
– C - Master-capable Reserved.

– M - Master Following the header message are formatted lines


containing the information corresponding to the
• Current numeric rank of the member
header columns.
• Value of the XCF.DURATION statement for that
NetView program Usage:

• Bit flags 1. If the group is a non-DSIPLX group, the character


string 'N/A' (not applicable) is inserted for user field
• Version and release of the NetView program
columns.
• Timestamp when the member became a master (if it
2. The timestamp field for master NetView programs
is a master)
contains the date (mm/dd/yy) and time (hh:mm:ss).
• XCF token for the member
3. The ROLE field is different in an environment that
The bit flags value contains 4 hexadecimal digits includes an enterprise master NetView program.
representing the following bits: The enterprise master is differentiated from the
sysplex master in the message output, and systems
that are not in the sysplex are identified.

252 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


When a group member is contacted by an • unavailable (0) - The hardware level is
enterprise master, an entry is added to the XCF unavailable. This is the value if the OSA Express
table with a ROLE field of EM, indicating enterprise SNMP subagent is running.
master. When the command is issued at the • unknown (1) - The hardware level is unknown.
sysplex containing the enterprise master, the ROLE
field values are prefixed with E for local sysplex • osaExp150 (2) - The hardware level is 1.50,
members or R for members outside the sysplex. which indicates the OSA-Express feature.

4. Beginning with NetView Version 6 Release 2 • osaExp175 (3) - The hardware level is 1.75,
Modification 1, the version columns contain the which indicates the OSA-Express feature.
release data in the format vrm, where v is the • osaExp300 (4) - The hardware level is 3.00,
version, r is the release, and m is the modification which indicates the OSA-Express2 feature.
level. The V6R2M1 format is 621. Any version • osaExp400 (5) - The hardware level is 4.00,
without a modification level uses a zero for m, such which indicates the OSA-Express3 feature.
as 610 for Version 6, Release 1.
• osaExp500 (6) - The hardware level is 5.00,
BNH596E SRB EXIT exit ABENDED WITH which indicates the OSA-Express4S feature.
CODE abend_code • osaExp600 (7) - The hardware level is 6.00,
which indicates the OSA-Express5S feature.
Explanation • osaExp6 (8) - The hardware level is 6, which
This message is issued to the authorized receiver indicates the OSA-Express6S feature.
when an XCF SRB exit ends abnormally. Additional 8-11
debugging information is written to the NetView log. The subtype. The type of OSA feature present. The
This information includes the Program Status Word, following values are valid:
the base register, the completion code, and the first
256 bytes of the System Diagnostic Work Area. • 65 - gigabitEthernet

Message Variables • 81 - fastEthernet


• 97 - oneThousandBaseTEthernet
exit
The name of the exit module • 145 - tenGigabitEthernet
abend_code • 161 - osaexp3gigabitEthernet
The abend code returned • 177 - osaexp3oneThousandBaseTEthernet
BNH597I NUMBER OF OSA PORTS: numosa • 193 - osaexp3tenGigabitEthernet
• 195 - osaexp5gigabitEthernet
Explanation • 196 - osaexp5oneThousandBaseTEthernet
This multiline message is written in response to the • 197 - osaexp5tenGigabitEthernet
OSAPORT command. It consists of one header line
13-44
followed by a variable number of data lines, each
The port name. The name of the port as specified
describing an OSA port. This message is intended
by the VTAM Transport Resource List Entry (TRLE).
for parsing by a REXX process. For readability, the
CNMSOSAP REXX sample is provided to format the 46-49
information from this message. The port number. The physical port number for this
port.
Each data line includes the following information:
51-54
Columns The port type. The physical port type. The
Description following values are valid:
1-4 • 65 - gigabitEthernet
The channel number. The channel path identifier
(CHPID) that corresponds to this device. • 81 - fastEthernet
6 • 97 - oneThousandBaseTEthernet
The channel hardware level. The hardware model • 145 - tenGigabitEthernet
of the channel. This data is valid only when • 161 - osaexp3gigabitEthernet
collected using OSA Express® Direct SNMP. The
following values are valid: • 177 - osaexp3oneThousandBaseTEthernet
• 193 - osaexp3tenGigabitEthernet

Chapter 3. BNH Prefix Messages 253


• 195 - osaexp5SgigabitEthernet • 5 - reserved5
• 196 - osaexp5SoneThousandBaseTEthernet • 6 - portTemporarilyDisabled
• 197 - osaexp5StenGigabitEthernet • 7 - reserved7
56-67 • 8 - reserved8
The active MAC address. A 6-byte octet string • 9 - serviceProcessorRequest
that contains the current MAC address in use on
• 10 - networkRequest
the OSA. The values are in canonical format. The
format is a 12-digit hexadecimal string. • 11 - osasfRequest
69-80 • 12 - configurationChange
The burned-in MAC address. A 6-byte octet string • 13 - linkFailureThresholdExceeded
that contains the burned-in MAC address on the
• 14 - reserved14
OSA. The values are in canonical format. The
format is a 12-digit hexadecimal string. • 15 - reserved15
82 The value can be a combination of the bits. For
The LAN traffic state. The LAN state, expressed more information about these values, see the
as a value of 0 - 8. A value of disabled (5) is Open Systems Adapter-Express Customer's Guide
further explained in the Disabled Status attribute. and Reference.
The following values can be received: 89-90
• 0 - undefined The configuration speed mode. The configured port
speed. This attribute indicates the speed that was
• 1 - unavailable
configured by the user for the OSA-Express Fast
• 2 - enabling Ethernet feature. For OSA-Express Gigabit or 10
• 3 - disabling Gigabit Ethernet features, it is not used and returns
-1. The following values can be received:
• 4 - enabled
• 5 - disabled • -1 - notValidGigabit

• 6 - linkMonitor • 0 - autoNegotiate

• 7 - definitionError • 1 - tenMbHalfDuplex

• 8 - configuredOffline • 2 - tenMbFullDuplex
• 3 - oneHundredMbHalfDuplex
For more information about these values, see the
Open Systems Adapter-Express Customer's Guide • 4 - oneHundredMbFullDuplex
and Reference. • 6 - oneThousandMbFullDuplex
84 • 8 - tenGigabitFullDuplex
The service mode. An indicator of whether the
processor is in service mode. Valid values are No 92
(0) and Yes (1). The active speed mode. The speed and mode in
which the OSA data is running. The values are
86-87 based on the type of OSA data, and a value of 1
The disabled status. A more detailed explanation indicates a different active speed mode depending
for the disabled state when the value of the LAN on the type of OSA data.
Traffic State attribute is 5 (disabled). When the
value of ibmOsaExp10GigEthLanTrafficState is not • For the OSA-Express 10 Gigabit Ethernet feature,
disabled (the LAN Traffic State attribute has a the following values can be received:
value other than 5), the value is stored as zero – 1 - unknown
and displayed as zeros. This value is displayed
as a 4-digit hexadecimal number mapped by the – 8 - tenGigabitFullDuplex
following bit settings: • For OSA-Express3, OSA-Express4S, OSA-
Express5S, and OSA-Express6S, the following
• 0 - reserved0
values can be received:
• 1 - internalPortFailure
– 0 - unknown
• 2 - reserved2
– 1 - tenMegabits
• 3 - reserved3
– 2 - tenMbFullDuplex
• 4 - reserved4
– 3 - oneHundredMbHalfDuplex

254 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


– 4 - oneHundredMbFullDuplex Columns
– 6 - oneThousandMbFullDuplex Description
– 8 - tenGigabitFullDuplex 1-16
The interface name. The textual name of the
• For OSA-Express, the following values can be interface.
received:
18-19
– 0 - unknown The HiperSockets channel path identifier (CHPID).
– 1 - tenMbHalfDuplex 21-24
– 2 - tenMbFullDuplex IQD network ID. An internal system-generated
identifier that represents the internal logical
– 3 - oneHundredMbHalfDuplex
network. The IQD (Internal QDIO) network ID is
– 4 - oneHundredMbFullDuplex associated with the IQD channel path ID (CHPID)
– 6 - oneThousandMbFullDuplex and can span the entire central processor complex
(CPC), based on the system configuration of the
94-101 IQD CHPID. Operating systems running on this
CPC name. The name of the central processor CPC that are connected to the same IQD network
complex (CPC) on which the OSA resides. ID use the same internal logical network and
103-106 therefore have network connectivity. The ID can
System ID. The SMF system ID. change during system initial machine load (IML) or
108-111 with dynamic I/O updates for the IQD CHPID.
Channel type. The following values are valid: 26-29
IP protocol. The IPv4 or IPv6 protocol for the
• osaExpress (16)
HiperSockets interface.
• osaDirectExpress (17)
31-34
• osaIntraensembleData (48): This value is The VLAN ID. A decimal number that indicates the
available with z/OS V1R12 Communications virtual LAN identifier that is to be assigned to a
Server or later. HiperSockets interface.
• osaIntraensembleManage (49): This value is 36
available with z/OS V1R12 Communications Interface operational status. The current
Server or later. operational state of the interface. This value is
Message Variables stored as an integer but displayed as a string. The
following values are valid:
numosa
The number of OSA ports displayed in this • 1 - up
message. • 2 - down
• 3 - testing
System action • 4 - unknown
The OSAPORT command processing is completed. • 5 - dormant
BNH598I NUMBER OF HIPERSOCKETS • 6 - notPresent
INTERFACES: numhiper • 7 - lowerLayerDown
38
Explanation Interface administration status. The preferred
This multiline message is written in response to the state of the interface. This value is stored as an
HIPERSOC command. It consists of one header line integer but displayed as a string. The following
followed by a variable number of data lines, each values are valid:
describing HiperSockets interface and configuration • 1 - up
and status information. This message is intended
• 2 - down
for parsing by a REXX process. For readability, the
CNMSHIPR REXX sample is provided to format the • 3 - testing
information from this message. 40
Each data line includes the following information: IQDIO routing enabled. An indication of whether
the IQDIOROUTING parameter is specified in
the IPCONFIG profile statement. When this

Chapter 3. BNH Prefix Messages 255


routing function is enabled, inbound packets numhiper
that are to be forwarded by this TCP/IP stack The number of HiperSockets that are displayed in
are eligible to be routed directly between a this message.
HiperSockets device and an OSA-Express device
in QDIO mode without needing to be sent to System action
this TCP/IP stack for forwarding. This type of
routing over a HiperSockets device (iQDIO) is The HIPERSOC command processing is completed.
called HiperSockets Accelerator.
BNH600I SOCKET INTERFACE INITIALIZED
42 WITH 'nnn' SOCKETS ON TCP/IP
QDIO accelerator enabled. An indication of 'tcpname'
whether the QDIOACCELERATOR parameter, which
enables the QDIO accelerator function, is specified
in the IPCONFIG profile statement. Explanation
44 The socket interface for a NetView task has
QDIO priority. An indication of which QDIO successfully completed initialization on the selected
outbound priority level is to be used. For traffic TCP/IP stack.
that is routed using HiperSockets Accelerator and Message Variables
that is received over a HiperSockets device and
routed to an OSA-Express in QDIO mode, the data nnn
is sent using the priority level, which can be 1 The maximum number of sockets available to the
- 4 with a default value of 1. For information NetView task in the socket interface.
about OSA-Express, see the z/OS Communications tcpname
Server: SNA network Implementation Guide. The The job identifier for the TCP/IP stack being used
IQDIO Routing and QDIO Accelerator functions are by the socket interface.
mutually exclusive. You can specify a QDIO priority
value with whichever function that you specify. If
neither function is specified, the QDIO priority field
System action
is zero. The NetView task waits for the next event, which might
46 now include a TCP/IP request on the socket interface.
Multiple write enabled. An indication that the BNH601I 'requestname' REQUEST ON
IQDMULTIWRITE parameter is specified in the SOCKET 'nnn' ENDED DUE
GLOBALCONFIG profile statement. When multiple TO SOCKET INTERFACE
write is enabled, HiperSockets interfaces are TERMINATION
configured to use HiperSockets multiple write
support when this function is supported by the
IBM System z® environment. Explanation
48 A socket-specific, asynchronous TCP/IP request made
zIIP multiple write enabled. An indication that by the socket interface ended, because the socket
the IQDIOMULTIWRITE subparameter for the ZIIP interface was ended on the NetView task.
parameter is specified in the GLOBALCONFIG
Message Variables
profile statement. When zIIP multiple write is
enabled, the stack is configured to displace CPU requestname
cycles for HiperSockets multiple write workload The name of the asynchronous TCP/IP request.
onto a zIIP. nnn
50-57 The descriptor number for the socket whose
The name of the central processor complex (CPC) request ended.
on which the HiperSockets interface resides.
59-66 System action
TCP/IP job name.
Processing continues.
68-75
System name. The name of the z/OS image.
Operator response
77-80
The SMF system ID. If desired, restart the socket interface.
Message Variables

256 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH602I 'requestname' REQUEST ENDED Message Variables
DUE TO SOCKET INTERFACE requestname
TERMINATION The name of the TCP/IP request.
nnn
Explanation The error number returned by TCP/IP.
An asynchronous TCP/IP request made by the socket
interface ended because the socket interface was System action
ended on the NetView task. This TCP/IP request was
not socket-specific. Processing continues.

Message Variables
Operator response
requestname
The name of the asynchronous TCP/IP request or If the error was because of the entry of erroneous
the command that issues the TCP/IP request. information, correct the error and reissue the
command. Otherwise, notify the system programmer.

System action
System programmer response
Processing continues.
Take the appropriate action based on the error:

Operator response • Incorrect TCP/IP definition - correct the error, restart


TCP/IP, and reinitialize the socket interface on the
Restart the socket interface. appropriate NetView task.
BNH603I CLIENT IDENTIFIER: NAME • Definition error in the DSIUDST initialization member
'jobname', TASK 'taskname' (sample name DSIUINIT) - correct the error and
recycle the DSIUDST task.
Explanation • SNMP trap automation task configuration error
- correct the error and restart the SNMP trap
This is a reply to the GETCLIENTID request on the automation task.
socket interface. It is the client identification of the
socket interface for the chosen TCP/IP stack on the • The error number is 47 (EAFNOSUPPORT when
NetView task. using the z/OS Communications EZASMI macro)
or 1114 (EAFNOSUPPORT when using z/OS UNIX
Message Variables C sockets) and the name of the TCP/IP request
jobname is SOCKET - the function might have requested a
The NetView job identifier. socket in the AF_INET6 address family and that
address family is not enabled on this host. If the
taskname AF_INET6 address family (IPv6 networking) cannot
The TCP/IP subtask identifier. be used with this NetView host, set IPv6Env to
NONE in the CNMSTYLE member. If you want to use
System action IPv6 networking, set IPv6Env to MIXED or ONLY in
the CNMSTYLE member and enable the AF_INET6
Processing continues.
address family in z/OS UNIX System Services.
BNH604I 'requestname' REQUEST FAILED, For information about enabling the AF_INET6
ERRNO = 'nnn' address family (domain) in the BPXPRMxx PARMLIB
member, see z/OS MVS Initialization and Tuning
Explanation Reference.
This message indicates that a TCP/IP request failed. BNH605I SOCKET INTERFACE HAS
The error number indicates the reason for the failure. TERMINATED
The socket interface issues this message for a TCP/IP
request that is not socket-specific. The DSIUDST Explanation
task logs this message when a request fails while
This message is produced in response to a TERM
attempting a TCP/IP-based remote operation. An
request on the socket interface.
SNMP trap automation task issues this message when
a z/OS UNIX C socket function fails.

Chapter 3. BNH Prefix Messages 257


System action Operator response
Processing continues without the functions of the Notify the system programmer.
socket interface on the NetView task.
BNH606I 'requestname' REQUEST System programmer response
COMPLETED SUCCESSFULLY. Perform problem determination procedures and
SOCKET 'nnn' HAS BEEN contact IBM Software Support.
ALLOCATED.
BNH608I 'requestname' REQUEST
COMPLETED SUCCESSFULLY
Explanation
A TCP/IP request made by the socket interface Explanation
succeeded and resulted in the allocation of a socket.
This message might be issued for the SOCKET, A request completed successfully.
ACCEPT, and TAKESOCKET requests.
The request might be a TCP/IP request made by the
Message Variables socket interface that returned no specific information
and was not socket-specific.
requestname
The name of the TCP/IP request. Message Variables
nnn requestname
The descriptor number for the socket allocated. The name of the request.

System action System action


Processing continues. Processing continues.
BNH609I 'requestname' REQUEST HAS
Operator response TIMED OUT
Depending upon the type of socket and TCP/IP
request causing the allocation of the socket, the Explanation
socket might now be ready for communications. If
the socket is not yet ready for communications, A TCP/IP request made by the socket interface timed
socket interface requests which prepare the socket for out. An example is a SELECT request made with the
communications might be issued. TIMEOUT parameter.

BNH607I UNEXPECTED ERROR WHILE Message Variables


PROCESSING THE 'requestname' requestname
REQUEST. THE SOCKET The name of the TCP/IP request.
INTERFACE WILL BE
TERMINATED.
System action
Explanation Processing continues.

When a TCP/IP request made by the socket BNH610I SOCKET nnn READY FOR
interface was being processed, an error condition that 'eventname'
compromised the ability to manage sockets occurred.
As a result, some serviceability information was Explanation
written to the network log, and the socket interface
was ended. A TCP/IP SELECT request made by the socket interface
completed and the socket shown was ready for the
Message Variables event indicated. When the SELECT request completes,
requestname there is one line for each socket that was ready for at
The name of the TCP/IP request. least one event.
Message Variables
System action nnn
Processing continues on the NetView task without the The descriptor number for a socket.
socket interface.

258 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


eventname address
One or more of READ, WRITE, and EXCEPTION, The IP address from which the connection request
separated by a blank when more than one occur. originated.
mmm
System action The number of the port from which the connection
request originated.
Processing continues.
lll
The descriptor number for the newly allocated
Operator response socket to which the accepted connection was
Issue the next socket interface request for processing assigned.
the event for which the socket is ready.
BNH611I SOCKET nnn CONNECTED TO
System action
address PORT mmm Processing continues.

Explanation Operator response


A TCP/IP CONNECT request made by the socket Issue the next socket interface request for
interface completed and the socket shown has a communicating using the newly established
connection with the indicated address and port. connection.
Message Variables BNH613I 'requestname' REQUEST ON
nnn SOCKET 'nnn' FAILED, ERRNO =
The descriptor number for a socket. 'mmm'
address
The IP address to which the connection was made. Explanation
mmm This message indicates that a TCP/IP request made
The number of the port to which the connection by the socket interface failed and provides the error
was made. number, which indicates the reason for the failure.
This message is for TCP/IP requests that are socket-
System action specific.
Message Variables
Processing continues.
requestname
Operator response The name of the TCP/IP request.
nnn
Issue the next socket interface request for
The descriptor number for the socket on which the
communicating using the newly established
TCP/IP request was made.
connection.
mmm
BNH612I SOCKET nnn ACCEPTED The error number returned by TCP/IP.
CONNECTION FROM address PORT
mmm. SOCKET lll HAS BEEN
ALLOCATED
System action
Processing continues.
Explanation
A TCP/IP ACCEPT request made by the socket
Operator response
interface completed and the connection has been If the error was because of the entry of erroneous
assigned to the newly allocated socket shown. information, correct the error and reissue the
Message Variables command. Otherwise, notify the system programmer.

nnn
The descriptor number for the passive socket that
System programmer response
accepted the connection request. If the error was because of an incorrect TCP/IP
definition, correct the error, restart TCP/IP, and

Chapter 3. BNH Prefix Messages 259


reinitialize the socket interface on the appropriate Explanation
NetView task.
This is an unsolicited message on a NetView task
BNH614I 'requestname' REQUEST ON using the socket interface that indicates the socket
SOCKET 'nnn' COMPLETED interface is terminating because of a should-not-
SUCCESSFULLY occur condition. Additional information regarding the
condition might have been written to the network log.
Explanation
A TCP/IP request made by the socket interface,
System action
one which returned no specific information and was Processing continues on the NetView task without the
socket-specific, succeeded. socket interface.
Message Variables
requestname
Operator response
The name of the TCP/IP request. Notify the system programmer.
nnn
The descriptor number for the socket on which the System programmer response
TCP/IP request was made.
Perform problem determination procedures and
contact IBM Software Support.
System action
BNH617I SOCKET 'nnn' SENT 'mmm' BYTES
Processing continues. OF DATA
BNH615I SOCKET INTERFACE
TERMINATING BECAUSE TCP/IP Explanation
'tcpname' HAS ENDED
This message is issued as the result of a successful
TCP/IP send request (SEND or SENDTO) made by the
Explanation socket interface.
This is an unsolicited message on a NetView task using Message Variables
the socket interface that indicates the TCP/IP stack
has ended and caused the termination of the socket nnn
interface. The descriptor number of the socket on which the
send request was made
Message Variables
mmm
tcpname The number of bytes which were sent.
The job identifier of the TCP/IP stack chosen when
the socket interface was initialized.
System action
System action Processing continues.

Processing continues.
Operator response
Operator response If not all bytes of data were sent, issue the next socket
interface request to send the data that was not sent
Notify the system programmer. previously.
BNH618I 'requestname' REQUEST ON
System programmer response SOCKET 'nnn' FAILED.
Perform problem determination procedures, if CONNECTION CLOSED
necessary, and restart TCP/IP.
BNH616I SOCKET INTERFACE
Explanation
TERMINATING DUE TO This message is issued as the result of a TCP/IP
UNEXPECTED ERROR receive request (RECV or RECVFROM) made by the
socket interface. The receive request failed, because
the socket connection was closed.

260 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


An SNMP trap automation task also issues this nnn
message if an incomplete protocol data unit has been The descriptor number of the socket on which the
buffered at the time the connection was closed. RECV request was issued.
Message Variables mmm
The number of bytes of data received.
requestname
The name of the receive request that failed.
System action
nnn
The descriptor number of the socket on which the Processing continues.
receive request was issued.
BNH621I 'data'

System action
Explanation
Processing continues.
One or more of these messages appears when
BNH619I SOCKET nnn RECEIVED mmm the NetView program shows data. When issued
BYTES OF DATA FROM address by the socket interface, this message shows data
PORT lll that satisfied a TCP/IP receive request (RECV or
RECVFROM). Up to 240 bytes of data follow the
message identifier. This message can appear as many
Explanation
times as necessary to present all of the received
This message is received as the result of a successful data. The socket interface does no conversion of the
TCP/IP RECVFROM request made by the socket received data.
interface. It shows how many bytes of data were
Message Variables
received and from where they came. If the socket
is an INET6 socket and the origin address is of link- data
local scope, then message BNH795I is received. One Some or all of the data to be displayed.
or more BNH621I messages with the data are then
issued. System action
Message Variables
In the socket interface, processing continues.
nnn
BNH622I SOCKET INTERFACE IS NOT
The descriptor number of the socket on which the
INITIALIZED
RECVFROM request was issued.
mmm
The number of bytes of data received. Explanation
address The socket interface was asked to process a request
The IP address of the origin of the data. before initialization of the interface.
lll
The originating port for the data. System action
Processing continues.
System action
Processing continues. Operator response
BNH620I SOCKET 'nnn' RECEIVED 'mmm' Request initialization of the socket interface, then re-
BYTES OF DATA enter the original request.
BNH623I SOCKET INTERFACE HAS
Explanation ALREADY BEEN INITIALIZED ON
TCP/IP 'tcpname'
This message is issued as the result of a successful
TCP/IP RECV request made by the socket interface. It
shows how many bytes of data were received. One or Explanation
more BNH621I messages follow with the data.
A NetView task requested initialization of the socket
Message Variables interface, and initialization had already been done.
Message Variables

Chapter 3. BNH Prefix Messages 261


tcpname THERE WERE NOT BETWEEN
The job identifier for the TCP/IP stack on which the 1-1048576 BYTES TO BE SENT
socket interface had previously initialized.
Explanation
System action
A TCP/IP send request (SEND or SENDTO) was made
Processing continues. using the socket interface, and the user attempted to
send more than the supported maximum number of
BNH624I SOCKET 'nnn' HAS NOT BEEN
bytes of data, 1048576 (1M).
ALLOCATED
Message Variables
Explanation requestname
The name of the TCP/IP request.
A socket-specific TCP/IP request was made using the
socket interface, and the descriptor number for the nnn
socket was valid but for a socket that had not yet been The descriptor number of the socket on which the
allocated. TCP/IP send request was issued.

Message Variables
System action
nnn
The descriptor number of the socket for which the Processing continues.
TCP/IP request was made.
Operator response
System action Correct the number of bytes of data to be sent and
Processing continues. reissue the request.

BNH625I 'requestname' REQUEST FAILED BNH627I SOCKET 'nnn' IS BUSY WITH THE
BECAUSE THE SOCKET 'requestname' REQUEST
INTERFACE IS TERMINATING
Explanation
Explanation A socket-specific TCP/IP request was made and the
A TCP/IP request was made using the socket interface, socket still had a previous request outstanding.
and the socket interface was in the process of Message Variables
terminating.
nnn
Message Variables The descriptor number of the socket for which the
requestname request was issued.
The name of the TCP/IP request. requestname
The name of the TCP/IP request.
System action
The request fails and socket interface termination
System action
continues. Processing continues.

Operator response Operator response


Notify the system programmer. Wait until the previous request completes on the
socket and reissue the request.
System programmer response BNH628I SOCKET INTERFACE IS BUSY
The socket interface is probably terminating because WITH THE 'requestname' REQUEST
of a should-not-occur condition. Perform problem
determination procedures and contact IBM Software Explanation
Support.
The socket interface was still processing a prior TCP/IP
BNH626I 'requestname' REQUEST ON request which was not socket-specific.
SOCKET 'nnn' FAILED BECAUSE
Message Variables

262 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


requestname Explanation
The name of the TCP/IP request.
This message is issued in response to an IOCTL
TCP/IP request made by the socket interface with the
System action SIOCATMARK option name.
Processing continues. Message Variables
nnn
Operator response The descriptor number of the socket to which the
Wait until the previous request completes and reissue information applies.
the request. status
Indicates whether the current location in data
BNH629I SOCKET 'nnn' IS NOT VALID
input is pointing at out-of-band data. This variable
has the value of IS or IS NOT.
Explanation
A socket descriptor number provided on a TCP/IP System action
request was outside the range of descriptor numbers
Processing continues.
allowed, based upon the number of sockets requested
when the socket interface was initialized on the BNH632I SOCKET nnn 'optionname' STATUS
NetView task. IS status
Message Variables
nnn
Explanation
The descriptor number of the socket provided on a This message is issued in response to a GETSOCKOPT
TCP/IP request. TCP/IP request made by the socket interface. It shows
whether the indicated option is enabled or disabled on
System action the socket.

Processing continues. Message Variables


nnn
Operator response The descriptor number of the socket to which the
information applies.
Correct the descriptor number and reissue the
optionname
request.
Socket characteristic whose status is requested.
BNH630I SOCKET 'nnn' HAS 'mmm' The option name can be one of the following, and
READABLE BYTES the corresponding GETSOCKOPT TCP/IP option
(which does not appear in the message) is shown
in parentheses.
Explanation
• BROADCAST (SO_BROADCAST)
This message is issued in response to an IOCTL
TCP/IP request made by the socket interface with the • KEEP-ALIVE (SO_KEEPALIVE)
FIONREAD option name. • LINGER (SO_LINGER)
Message Variables • IN-LINE OUT-OF-BAND DATA (SO_OOBINLINE)
nnn • LOCAL ADDRESS REUSABILITY
The descriptor number of the socket to which the (SO_REUSEADDR)
information applies. • IP MULTICAST DATAGRAM LOOP-BACK
mmm (IP_MULTICAST_LOOP)
The number of bytes of readable data available on • IPV6 MULTICAST DATAGRAM LOOP-BACK
the socket. (IPV6_MULTICAST_LOOP)
• IPV6-ONLY PACKET RESTRICTION
System action (IPV6_V6ONLY)
Processing continues. • SMALL PACKET SEND WITHOUT WAIT
(TCP_NODELAY)
BNH631I SOCKET nnn 'status' AT OUT-OF-
BAND DATA

Chapter 3. BNH Prefix Messages 263


status • IP MULTICAST TIME TO LIVE
Status of the socket option. Has the value (IP_MULTICAST_TTL)
ENABLED or DISABLED. • IPV6 MULTICAST HOP COUNT
(IPV6_MULTICAST_HOPS)
System action • IPV6 MULTICAST INTERFACE INDEX
Processing continues. (IPV6_MULTICAST_IF)
• IPV6 UNICAST HOP COUNT
BNH633I SOCKET nnn 'optionname' STATUS
(IPV6_UNICAST_HOPS)
IS status, TIME= mmm SECONDS
• PENDING ERRNO (SO_ERROR)
Explanation • RECEIVE BUFFER DATA SIZE (SO_RCVBUF)
• SEND BUFFER DATA SIZE (SO_SNDBUF)
This message is issued in response to a GETSOCKOPT
TCP/IP request made by the socket interface, and it is • TYPE (SO_TYPE)
only issued when the requested socket option name is setting
SO_LINGER and SO_LINGER is enabled. For each option above, the value has a different
Message Variables meaning, summarized for the options as follows.
nnn • IP MULTICAST INTERFACE ADDRESS: interface
The descriptor number of the socket to which the address for outbound multicast datagrams
information applies. • IP MULTICAST TIME TO LIVE: outbound
optionname multicast datagram time to live, in decimal
Has the value LINGER to indicate the SO_LINGER • IPV6 MULTICAST HOP COUNT: hop limit, in
socket option. decimal, for outbound IPv6 multicast datagrams
status • IPV6 MULTICAST INTERFACE INDEX: index, in
Has the value ENABLED to show that the linger decimal, of the IPv6 interface used to send
socket option is enabled. outbound multicast datagrams
mmm • IPV6 UNICAST HOP COUNT: hop limit, in
Linger time, in seconds. decimal, for outbound IPv6 unicast packets
• PENDING ERRNO: pending error number on the
System action socket, whose status is then cleared
Processing continues. • RECEIVE BUFFER DATA SIZE: size, in bytes, of
the data portion of the TCP/IP receive buffer
BNH634I SOCKET nnn 'optionname' IS
setting • SEND BUFFER DATA SIZE: size, in bytes, of the
data portion of the TCP/IP send buffer

Explanation • TYPE: socket type, can be STREAM, DATAGRAM,


or RAW
This message is issued in response to a GETSOCKOPT
TCP/IP request made by the socket interface, and it
System action
is issued for those socket options not covered by the
BNH632I message and the BNH633I message. Processing continues.
Message Variables BNH635I SOCKET nnn IS BOUND TO address
PORT mmm
nnn
The descriptor number of the socket to which the
information applies. Explanation
optionname This message is issued in response to a
Socket characteristic whose status is requested. GETSOCKNAME TCP/IP request made by the socket
The option name can be one of the following, and interface and describes the address and port to which
the corresponding GETSOCKOPT TCP/IP option the specified socket is bound.
(which does not appear in the message) is shown
in parentheses. Message Variables

• IP MULTICAST INTERFACE ADDRESS nnn


(IP_MULTICAST_IF) The descriptor number of the socket.

264 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


address If the requestname is AUTBYPAS or DSIAUTBS, an
The IP address to which the socket is bound. authorization bypass request failed with a return code
mmm of nnn.
The port number to which the socket is bound. The following are examples of other requests for which
the message displays:
System action • GETHOSTBYNAME and GETHOSTBYADDR requests
Processing continues. made by the socket interface
• GETHOSTID requests made by the socket interface
BNH636I SOCKET nnn PEER IS address
or DSIUDST task
PORT mmm
• TCP/IP API or other requests made by an SNMP trap
automation task
Explanation
Note: An error number is not returned for
This message is issued in response to a a GETHOSTBYADDR request, a GETHOSTBYNAME
GETPEERNAME TCP/IP request made by the socket request, or a GETHOSTID request.
interface and shows the address and port number of
the connection partner of the requested socket. If the requestname is WRITE TO NETVIEW
ENTERPRISE MANAGEMENT AGENT DATA SPACE,
Message Variables data targeted for display at the Tivoli Enterprise Portal
nnn could not be stored in the agent data space.
The descriptor number of the socket. Message Variables
address
requestname
The IP address of the connection partner of the
Either AUTBYPAS, DSIAUTBS, the name of the
socket.
TCP/IP request, or a data space write failure.
mmm
nnn
The port number of the connection partner of the
The return code indicating that the request failed.
socket.

System action System action


Processing continues.
Processing continues.
If the requestname is WRITE TO NETVIEW
BNH637I HOST IDENTIFIER IS address
ENTERPRISE MANAGEMENT AGENT DATA SPACE, the
information was not written successfully to the data
Explanation space, and is not in the Tivoli Enterprise Portal.
This message is issued in response to a GETHOSTID
TCP/IP request made by the socket interface and Operator response
shows the IP address of the host.
If the return code is the result of incorrect information,
Message Variables correct it and enter the request again. Otherwise,
contact your system programmer.
address
The internet address of the host. If the requestname is WRITE TO NETVIEW
ENTERPRISE MANAGEMENT AGENT DATA SPACE and
the return code is 808, verify that the agent is started.
System action
If the return code is other than 808, contact the
Processing continues. system programmer.
BNH638I 'requestname' REQUEST FAILED,
RETURN CODE 'nnn' System programmer response
The return code can be caused by set-up problems in
Explanation the internet network or in TCP/IP. If the problem is
a definition problem in TCP/IP, correct the error and
This message indicates that a request failed and restart TCP/IP.
provides the return code.

Chapter 3. BNH Prefix Messages 265


If the requestname is AUTBYPAS or DSIAUTBS, see The host name or IP address resolution request occurs
the IBM Z NetView Security Reference. Take the when the SOCKET command is used and its TYPE
appropriate action as indicated by the return code. keyword has one of the following values.
If the requestname is WRITE TO NETVIEW • GETADDRINFO
ENTERPRISE MANAGEMENT AGENT DATA SPACE and • GETHOSTBYADDR
the return code is other than 808, contact IBM
Software Support. • GETHOSTBYNAME
Message Variables
BNH639I HOST NAME IS 'hostname'
address
Explanation An IP address of a host.

This message is issued in response to any socket


interface request that might return the name of a
System action
host. Such a request occurs when the value of the Processing continues.
TYPE keyword of the SOCKET command is one of the
following. BNH642I requestname DISPLAY
TERMINATED DUE TO
• GETADDRINFO UNEXPECTED ERROR
• GETHOSTBYADDR
• GETHOSTBYNAME Explanation
• GETHOSTNAME This message is issued when an error is found in the
• GETNAMEINFO information returned by TCP/IP in response to a host
name or IP address resolution request made by the
Message Variables socket interface. Additional serviceability information
hostname might be written to the network log. The host name
The name of a host in the IP network. Depending or IP address resolution request occurs when the
upon the socket interface request, this might SOCKET command is used and its TYPE keyword has
contain an IP address instead of a host name. one of the following values.
• GETADDRINFO
System action • GETHOSTBYADDR
Processing continues. • GETHOSTBYNAME
BNH640I ALIAS NAME IS 'aliasname' • GETNAMEINFO
Message Variables
Explanation requestname
One or more copies of this message might be issued in The name of the resolution request.
response to a GETHOSTBYNAME or GETHOSTBYADDR
TCP/IP request made by the socket interface. It System action
contains an alias name definition for a TCP/IP host.
The display of returned host information ends.
Message Variables
aliasname Operator response
An alias name for a TCP/IP host.
Notify the system programmer.

System action
System programmer response
Processing continues.
Perform problem determination procedures and
BNH641I HOST ADDRESS IS address contact IBM Software Support.
BNH643I SOCKET 'nnn' HAS ALREADY BEEN
Explanation ALLOCATED
One or more copies of this message, containing an IP
address, might be issued in response to host name or
IP address resolution request by the socket interface.

266 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation determination procedures and contact IBM Software
Support.
A specific socket descriptor number was requested on
a SOCKET, ACCEPT, or TAKESOCKET socket interface BNH645I SOCKET 'nnn' DOES NOT HAVE AN
request, and that socket descriptor number was ACTIVE REQUEST
already allocated by a previous request.
Message Variables Explanation
nnn A socket interface CANCEL request was issued for an
The descriptor number for a socket. asynchronous socket-specific request, and no request
was outstanding on the chosen socket.
System action Message Variables
The SOCKET, ACCEPT, or TAKESOCKET socket nnn
command interface request fails and processing The descriptor number for a socket.
continues.
System action
Operator response Processing continues.
Choose a socket descriptor number within the range
BNH646I SOCKET INTERFACE DOES NOT
of valid socket descriptor numbers for the socket
HAVE AN ACTIVE REQUEST
interface on the NetView task and re-enter the
request. As an alternative, re-enter the request
without a specific socket descriptor number and allow Explanation
TCP/IP to select the next available socket descriptor
A socket interface CANCEL request was issued for
number, if there is one.
an asynchronous request that was not specific to a
BNH644I SOCKET INTERFACE socket, and no such request was outstanding.
TERMINATING BECAUSE TCP/IP
'tcpname' HAS TERMINATED THE System action
API CONNECTION
Processing continues.
Explanation BNH647I PRIORITY LEVEL: prilevel
This is an unsolicited message issued on a NetView
task when TCP/IP has ended the API connection Explanation
between TCP/IP and the socket interface. This is the priority level of the message assignment
Message Variables described by message DSI636I or DSI173I.
tcpname Message Variables
The job identifier for the TCP/IP stack on which the prilevel
socket interface had previously initialized. A priority level from 1 to 5, with 1 being the highest
and 5 the lowest.
System action
Any outstanding requests on the socket interface are System action
ended and message BNH601I or BNH602I is issued Command processing continues.
as a response to the outstanding request. The socket
interface ends. BNH648I 'member_id' removed from cache
by 'action'
Operator response
Explanation
Notify the system programmer.
The member identified by member_id was removed
from the cache by the action identified by action.
System programmer response
If the action is MEMSTOUT UNLOAD or MEMSTOUT
Determine the reason for the loss of the
REFRESH, then member_id was removed from the
API connection. If necessary, perform problem
cache as a result of the MEMSTOUT command having

Chapter 3. BNH Prefix Messages 267


been issued with one of these options. MEMSTOUT remove members from the name of the command and
operates only on members stored in the cache by the possibly also the name of the option that removed the
MEMSTORE automated caching service. member from the cache.
Message Variables BNH650I DUPLICATE VALUE SPECIFIED
FOR KEYWORD keyword
member_id
A string identifying a member found in the cache.
The format of the string is DDName.memberName. Explanation
action One or more values are the same for the named
The name of the command and possibly also the keyword. Each value must be unique when more than
name of the option that removed the member from one value is specified.
the cache. If the action is identified by a command,
then only a command name is shown. If the action Message Variables
is identified by a command name and option name, keyword
then both the command name and option name The keyword in error.
(such as MEMSTOUT UNLOAD) are shown
System action
System action
The command fails.
Processing continues.
BNH649I No members cached by srvc_name Operator response
found to action_name.
Check for duplicate values. Change the value that is a
duplicate or do not specify it a second time.
Explanation
BNH651I INVALID VALUE OF 0 SPECIFIED
No members added to the cache by srvc_name were WHEN MULTIPLE VALUES
found on which action srvc_name can be performed. ENTERED FOR KEYWORDkeyword
If srvc_name is MEMSTORE, then this message is
being issued in response to a user having started Explanation
the MEMSTOUT command. MEMSTOUT operates only
on members cached by the MEMSTORE automated A value of 0 was specified when multiple values were
caching service. No members that matched the specified for the named keyword. If multiple values
member name specified on the MEMSTOUT command are specified, they must all be non-zero. A value of 0
were found that had been cached by MEMSTORE and effectively turns off the action for the named keyword.
therefore none were removed from the cache. Message Variables
Message Variables keyword
srvc_name The keyword in error.
The name of the service that cached the members
to be acted upon. System action
action_name The command fails.
If srvc_name is MEMSTORE, the possible actions
are UNLOAD and REFRESH.
Operator response
System action Specify 0 as the only value or change the 0 value to a
non-zero value.
Processing continues.
BNH652I NETVIEW RESOURCE MANAGER
IS TERMINATING DUE TO 'reason'
Operator response
If srvc_name is MEMSTORE, then the MEMSTOUT Explanation
command might have been started to operate on
members not cached by the MEMSTORE service. The NetView Resource Manager is terminating for one of
MEMSTAT option of the LIST command can be used the following reasons.
to find out what members are cached and what task Message Variables
cached them. The PIPE INSTORE state can be used to

268 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


reason Operator response
The reason for termination.
If the default value is not acceptable, the user must
OPERATOR REQUEST stop NetView Resource Manager (SUSPNRM) and
The operator requested that NetView Resource restart it (INITNRM).
Manager end.
BNH654I COMMON GLOBAL VARIABLE
INTERNAL ERROR
variable HAS AN INVALID VALUE:
An internal error occurred that prevents
value
NetView Resource Manager from continuing.
See the associated error message.
INCORRECT PARAMETER VALUE Explanation
A value for a parameter that is necessary for A value for the named common global variable is
processing to continue is incorrect. See the incorrect for the current process.
associated error message.
Message Variables
AUTHORIZATION FAILURE
NetView Resource Manager cannot complete variable
initialization because it is unable to issue The name of the common global variable.
certain commands that need security value
authorization. See the associated error The value considered to be in error by the current
message. process.

System action System action


NetView Resource Manager ends. Processing continues, if possible.

Operator response Operator response


If the reason is INVALID PARAMETER VALUE, If the command is INITNRM, check for other messages
determine why the parameter value is incorrect and that explain what action was taken regarding the
correct it. incorrect value.

System programmer response System programmer response


If the reason is INTERNAL ERROR, report the error to If this message is received because an NRM.CMODE.x
IBM Software Support. statement specifies a value IPV6, verify that the
IPv6Env statement specifies a value of MIXED or
BNH653I NETVIEW RESOURCE MANAGER
ONLY. To support communication in an IPv6 network,
HAS ASSIGNED THE DEFAULT
the IPv6Env cannot be set to NONE.
VALUE OF default FOR
KEYWORDkeyword If the global variable is CNMSTYLE.NACMD.SUBNODE,
the coded name must be 1-32 characters in length,
Explanation using the character set A-Z, a-z, 0-9, $ . _ - : @ # and
must not use * . or # as the first character. Correct the
A keyword has a missing value or a value that is not value, use the RESTYLE NACMD command and use the
valid. The default value has been assigned so that STOPNA and NACMD commands to stop and restart
processing can continue. the connection to the NetView EMA agent to have the
Message Variables change take effect.

default BNH655I DISPLAY OF NETVIEW RESOURCE


The default value for the named keyword. MANAGER INFORMATION
keyword
The keyword for which the default value has been Explanation
assigned. This is the first line of a multiline display of information
for the NetView Resource Manager (NRM).
System action
BNH656I END OF NETVIEW RESOURCE
NetView Resource Manager processing continues. MANAGER DISPLAY

Chapter 3. BNH Prefix Messages 269


Explanation rodmname
The name of the RODM which stored the resource
This is the final line of a multiline display of information.
information for the NetView Resource Manager (NRM).
BNH661I HEARTBEAT INTERVAL: time
BNH657I NETVIEW RESOURCE MANAGER
IS INACTIVE
Explanation
Explanation As part of a multiline information display for the
NetView Resource Manager. When it is started with
The NetView Resource Manager (NRM) either has not TYPE=MGR, this line indicates the time interval,
been started, or it has been stopped. in seconds, between attempts to contact the
NetView Resource Managers that are performing agent
Operator response functions in order to gauge connectivity and, therefore,
the validity of status sent by the agent.
Start the NetView Resource Manager if the function is
to be used. Message Variables

BNH658I NETVIEW RESOURCE MANAGER time


WAS INITIALIZED ON date AT time The time, in seconds, between contact attempts.

Explanation System action


As part of a multiline information display for the If a reply to the contact is received in a time interval
NetView Resource Manager (NRM), this line indicates calculated based on the heart beat setting, then
the local date and time at which the NetView Resource processing continues. If such a reply is not received in
Manager was started. time, this is considered a loss of contact. Information
for the NetView domain represented by that agent
Message Variables is not considered valid and the information stored in
date RODM is updated accordingly.
The date on which the NetView Resource Manager
was started. Operator response
time If contact is considered lost, perform problem
The time at which the NetView Resource Manager determination procedures.
was started.
BNH662I SAMPLING RATE: time
BNH659I TYPE: nrmtype

Explanation
Explanation
As part of a multiline display of NetView Resource
As part of a multiline information display for the Manager information, this line shows the time interval,
NetView Resource Manager (NRM), this line indicates in seconds, between attempts to sample NetView
the type of NetView Resource Manager that was resource data. A zero value indicates that sampling is
started. not active.
Message Variables Message Variables
nrmtype time
The type of NetView Resource Manager, MGR, or The time, in seconds, between attempts; or 0
AGENT. (zero) if sampling is not active.
BNH660I RODM NAME: rodmname
System action
Explanation Processing continues.
As part of a multiline information display for the BNH663I COMMUNICATION RETRY COUNT:
NetView Resource Manager (NRM), when NRM is count
started with TYPE=MGR, this line indicates the name
of the RODM used to store the resource information.
Message Variables

270 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
As part of a multiline display of NetView Resource Processing continues.
Manager information, this message shows the number
BNH667I desthost mode port ipaddress
of attempts that are made to establish contact with
a host to which NetView resource data is to be
forwarded following an initial failure to establish Explanation
contact.
As part of a multiline display of NetView Resource
Message Variables Manager information, this line contains information for
a host to which NetView resource data is forwarded.
count
This line is repeated, as necessary, when there are
The number of retry attempts, in decimal form.
multiple host destinations.

System action Message Variables

Processing continues. desthost


The host name, host IP address, or domain name
BNH664I COMMUNICATION RETRY of a NetView Resource Manager to which NetView
INTERVAL: interval resource data is forwarded.
mode
Explanation The communication mode used to contact the
destination host and forward NetView resource
As part of a multiline display of NetView Resource data. The value is either SNA or IP.
Manager information, this message shows the time, in
seconds, between attempts to contact a host to which port
NetView resource data is to be forwarded. If the communication mode is IP or IPV6, then
this part of the message contains the port number,
Message Variables in decimal form, of the destination host to which
interval the NetView Resource Manager sends data to
The time, in seconds, between contact attempts. establish contact for forwarding NetView resource
data. This port number is to have been bound by
the DSIRTTR task in the NetView program at the
System action destination host. If the communication mode is
Processing continues. SNA, then this insert remains blank.
ipaddress
BNH665I HOST DESTINATION(S)
If the communication mode is IP or IPV6 and
the host name and IP address for the destination
Explanation host become known, then this part of the message
displays the IP address. If the communication
As part of a multiline display of NetView Resource
mode is SNA, then this insert remains blank.
Manager information, this line is a sub-header
introducing a list of one or more host destinations to
which NetView resource data is forwarded. System action
Processing continues.
System action
BNH668I START TYPE: starttype
Processing continues.
BNH666I NAME MODE PORT ADDRESS Explanation
As part of a multiline display of NetView Resource
Explanation Manager information, this line shows how exclusion
lists were built and used.
As part of a multiline display of NetView Resource
Manager information, this line is a sub-header line that Message Variables
labels columns of information for the list of one or
starttype
more host destinations that follow.
Description of how the NetView Resource Manager
is instructed to build and use exclusion lists, either
CTL or VARS.

Chapter 3. BNH Prefix Messages 271


CTL BNH672I DOMAIN EXCLUSION LIST:
Use exclusion list information set up by either
or both of a prior instance of the NetView
Explanation
Resource Manager or the NRMCTL command.
VARS As part of a multiline display of NetView Resource
Build exclusion list information entirely from Manager information, this line is a sub-header
information that is supplied in the CNMSTYLE introducing the list of domain name exclusion list
member and input on the INITNRM command. entries.

System action System action


Processing continues. Processing continues.

BNH669I TASK TYPE EXCLUSION LIST: BNH673I NETVIEW DOMAINS ARE NOT
MONITORED BY A NETVIEW
RESOURCE AGENT
Explanation
As part of a multiline display of NetView Resource Explanation
Manager information, this line is a sub-header
introducing a list of task types to be excluded from A request to list monitored NetView domains was
NetView resource monitoring. issued on a NetView resource agent. Only NetView
resource managers can monitor other NetView
domains.
System action
Processing continues. System action
BNH670I exclusionlistentry Processing continues.
BNH674I NO NETVIEW DOMAINS ARE
Explanation BEING MONITORED
As part of a multiline display of NetView Resource
Manager information, this line contains one excluded Explanation
item, which can be a task type, task name (with wild
cards), or a domain name (with wild cards). This line This message indicates that the NetView Resource
is repeated, as necessary, when there are multiple Manager was started with TYPE=MGR, but has not yet
excluded items. received NetView resource data from any agents.

Message Variables
System action
exclusionlistentry
An entry indicating one or more items to be Processing continues.
excluded. When this entry is for a task name or BNH677I INTERNAL ERROR OCCURRED
domain name, it can contain wildcard characters. FOR NETVIEW RESOURCE
MANAGER. RESULTS MAY BE
System action UNPREDICTABLE.

Processing continues.
Explanation
BNH671I TASK NAME EXCLUSION LIST:
An internal error occurred for NetView Resource
Manager. Processing continues, but the results might
Explanation be unpredictable.
As part of a multiline display of NetView Resource
Manager information, this line is a sub-header System action
introducing the list of task name exclusion list entries.
Processing continues.

System action
Processing continues.

272 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System action
Check for additional messages. Take appropriate Processing continues.
action as indicated by other messages.
BNH681I DOMAIN TASK COMMUNICATION
IP HOST
System programmer response
Notify IBM Software Support. Explanation
BNH678I INCORRECT NUMBER OF This is the first label line of a multiline display for
KEYWORD keyword VALUES listing NetView domains monitored by a NetView
SPECIFIED Resource Manager.

Explanation System action


The number of CMODE or PORT values specified Processing continues.
does not match the number of values specified for
BNH682I NAME NAME MODE ADDRESS
HOSTDEST.
NAME
Message Variables
keyword Explanation
The keyword that had an incorrect number of
This is the second label line of a multiline display
values.
for listing NetView domains monitored by a NetView
Resource Manager.
System action
NetView Resource Manager ends. System action
Processing continues.
Operator response
BNH683I ----------------------------------------
Specify the correct number of CMODE or PORT values. --------------
Specify either one value or the same number of values
that you specified for HOSTDEST.
Explanation
BNH679I NETVIEW RESOURCE MANAGER
This is the last label line of a multiline display for
INITIALIZATION IS action
listing NetView domains monitored by a NetView
Resource Manager. It denotes the end of column
Explanation headings.
NetView Resource Manager is initializing. There might
be a significant amount of time between when System action
initialization starts and completes because of the
Processing continues.
time involved in resolving TCP/IP host names and
addresses. A message is issued when initialization BNH684I domain taskname mode ipaddress
starts and another message is issued when it hostname
completes.
Message Variables Explanation
action A data line of a multiline display for listing NetView
The action is either STARTING or COMPLETE. domains monitored by a NetView Resource Manager.
This line is repeated, as necessary, when there are
BNH680I DISPLAY OF MONITORED
multiple NetView domains in the list.
NETVIEW DOMAINS
Message Variables
Explanation domain
The name of the NetView domain monitored by the
This is the control line of a multiline display for listing
NetView Resource Manager.
NetView domains monitored by a NetView Resource
Manager.

Chapter 3. BNH Prefix Messages 273


taskname hostdest
The name of the NetView autotask used for The NetView Resource Manager host with
NetView Resource Manager processing. The which the agent is trying to communicate.
default is AUTONRM. This is specified with the HOSTDEST
mode keyword on the INITNRM command, or the
The communication mode (SNA, IP, or IPV6) used NRM.HOSTDEST.x=hostdest statement in the
when NetView resource data is sent to the NetView CNMSTYLE member.
Resource Manager. If this line is for the NetView
domain of the NetView Resource Manager, then System action
this part of the message displays N/A.
NetView Resource Agent will not be monitored by the
ipaddress manager specified.
When the communication mode is IP, this displays
the IP address of the monitored NetView domain;
otherwise, it is left blank. Operator response
If the communication mode is IPV6, the IP address Ensure that the following are active and restart
of the monitored NetView domain is displayed in NetView Resource Manager:
the BNH533I message that immediately follows • On Manager host destination:
this message.
– Hardware Monitor
hostname
– DSIRTTR if the CMODE for the failing host
When the communication mode is IP or IPV6
destination is IP or IPV6
and the host name is known, this displays the
host name of the monitored NetView domain; – DSICRTR if the CMODE for the failing host
otherwise, it is left blank. destination is SNA
– DSIHPDST if the CMODE for the failing host
System action destination is SNA

Processing continues. – DSIUDST


– DSI6DST
BNH685I END OF MONITORED NETVIEW
DOMAINS DISPLAY • On Agent host:
– DSIUDST
Explanation – DSIHPDST if the CMODE for the failing host
destination is SNA
This is the end line of a multiline display for listing
NetView domains monitored by a NetView Resource – DSI6DST
Manager.
System programmer response
System action If the BNH699I message is received with this
Processing continues. message, then NetView Resource Manager cannot
obtain the necessary TCP/IP information it needs
BNH686I NETVIEW RESOURCE AGENT to communicate with the Manager host destination.
domain CANNOT SEND STATUS TO Determine the cause for the BNH699I message and
MANAGER hostdest restart NetView Resource Manager.
BNH687I NETVIEW RESOURCE AGENT
Explanation
domain IS SUCCESSFULLY
Communication between the NetView Resource Agent COMMUNICATING WITH
host and the NetView Resource Manager host cannot MANAGER hostdest
be established. All retry attempts have failed.
Message Variables Explanation
domain Communication between the NetView Resource Agent
The NetView domain of the NetView Resource host and the NetView Resource Manager host has
Agent host. been established. The NetView Resource Manager
host now receives NetView Resource Manager data
from the specified agent.

274 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables System action
domain NetView Resource Manager does not establish
The NetView domain of the NetView Resource communication between these hosts.
Agent host.
hostdest Operator response
The NetView Resource Manager host that the
agent with which the agent is communicating. Correct the HOSTDEST parameter in the CNMSTYLE
member or on the INITNRM command.
System action BNH690I IP ADDRESS: ipaddress PORT:
portnumber
NetView Resource Agent forwards NetView Resource
Manager data to the specified Manager.
Explanation
BNH688I KEYWORD keyword1 IS IGNORED
WHEN KEYWORD keyword2 IS This message is part of a multiline display in response
NOT SPECIFIED to one of the following commands:
• RMTCMD QUERY,RMTDOMS
Explanation • RMTCMD QUERY,IP,RMTAUTOS
Because a value was not assigned for keyword2, the • RMTCMD QUERY,IPV6,RMTAUTOS
value assigned for keyword2 is ignored.
It contains the internet address and port number for
Message Variables a remote NetView operations server task (DSIUDST)
to which the local DSIUDST task is connected by way
keyword1
of TCP/IP. This line is not present for remote NetView
Keyword that has been assigned a value which is
operations using SNA LU6.2.
ignored.
keyword2 When this message is issued in response to
Keyword that was specified. a RMTCMD QUERY,IP,RMTAUTOS command or a
RMTCMD QUERY,IPV6,RMTAUTOS command, the IP
address contained in the message is the IPv4 address
System action returned for a GETHOSTID request in the remote
Processing continues. NetView domain.
Message Variables
Operator response ipaddress
If the command is INITNRM, the PORT and CMODE The IP address.
keywords are not used if the HOSTDEST keyword has portnumber
not been assigned a value. Verify if keyword2 must be The port number.
specified.
BNH689I HOST DESTINATION destdomain System action
IS INVALID FOR NETVIEW
Processing continues.
RESOURCE AGENT agentdomain
BNH691I REMOTE OPERATIONS USING
Explanation TCP/IP tcpname TERMINATED DUE
TO reason
The domain of the NetView Resource Agent is the
same as the domain of the Manager host destination.
Explanation
Message Variables
TCP/IP-based remote operations which used the
destdomain identified TCP/IP stack were ended for the reason
The NetView Resource Manager host destination indicated. Additional messages might be logged to
NetView domain name. provide more details regarding the failure.
agentdomain Message Variables
The domain name of the NetView Resource agent
host. tcpname
The name of the TCP/IP stack.

Chapter 3. BNH Prefix Messages 275


reason not been enabled in the DSIUDST initialization
The reason for termination of TCP/IP-based member. The sample DSIUDST initialization member
remote operations, which can be one of the is DSIUINIT assigned so processing can continue.
following:
• TCP/IP TERMINATION System action
• API CONNECTION TERMINATION The TCP/IP-based remote operations command fails.
• AN UNEXPECTED ERROR
Operator response
System action Restart DSIUDST when definitions enabling TCP/IP-
TCP/IP-based remote operations cease and remote based remote operations are in place.
operators that were started for TCP/IP-based remote
operations requests are ended. System programmer response
If you want to run TCP/IP-based remote operations,
Operator response enable them in the initialization member of the
If TCP/IP-based remote operations ended because DSIUDST task.
TCP/IP was stopped, restart TCP/IP; otherwise, BNH694I CONNECTION WITH
perform problem determination procedures. netid.domainid DOES NOT EXIST
BNH692I UNABLE TO RESOLVE HOST NAME, OR IS IN PROCESS OF
RETURN CODE returncode TERMINATION

Explanation Explanation
A host name was supplied for a RMTCMD SEND A TCP/IP-based remote operations command that
command or as a host destination for NetView requires an existing connection with the target domain,
Resource Manager data, and the host name cannot be such as RMTCMD QUERY or ENDTASK, cannot be
resolved. completed because the connection either does not
exist or is in the process of terminating.
Message Variables
Message Variables
returncode
Return code from internal host name resolution netid
services. The network identifier of the target NetView
program.
System action domainid
The domain identifier of the target NetView
No attempt to contact the host is made. program.

Operator response System action


If the return code shown is 8, ensure that task The remote operations request fails.
DUIDGHB is active. The most likely cause for the other
return codes is that there is insufficient virtual storage
for processing the request.
Operator response
If the identification for the target NetView program is
System programmer response incorrect, correct it and reenter the command.

If necessary to prevent virtual storage shortages, BNH695I REMOTE OPERATIONS REQUEST


restart the NetView program with a larger region size. FOR netid.domainid TERMINATED
DUE TO reason
BNH693I REMOTE OPERATIONS USING
TCP/IP ARE NOT ENABLED
Explanation
Explanation A TCP/IP-based remote operations command for the
target NetView program failed for the indicated reason.
A TCP/IP-based remote operations command was
issued, but TCP/IP-based remote operations have Message Variables

276 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


netid netid
The network identifier of the target NetView The network identifier of the target NetView
program. program.
domainid domainid
The domain identifier of the target NetView The domain identifier of the target NetView
program. program.
reason
The reason for remote operations request System action
termination, which can be one of the following:
The RMTCMD SEND request fails.
• TCP/IP API TERMINATION
• TCP/IP REQUEST FAILURE Operator response
• CONNECTION TERMINATION Correct the information in error and reenter the
• CONNECTION TIME-OUT RMTCMD SEND command.
• TRANSPORT DETECTED ERROR BNH697I REMOTE OPERATIONS TCP/IP
The first three reasons can indicate the loss of SERVER SET-UP FAILED
a required system or network component. The
4th reason can indicate a performance problem Explanation
in a system or network component. The last
reason indicates that incorrect data was sent on The DSIUDST task cannot enable TCP/IP-based
the connection between NetView domains. The remote operations as requested in the initialization
network log contains messages with additional member. The network log contains at least one
details, in any case. other message that provides additional information
for the failure. The most common reasons include the
following:
System action
• TCP/IP is inactive.
The remote operations request fails.
• The incorrect TCP/IP stack name is provided in the
initialization member of the DSIUDST task.
Operator response
• DSIUDST cannot bind to the port specified in
If the failure was because of loss of a required system the initialization member because it is in use or
or network component, such as TCP/IP, restart the restricted.
component and retry the request.
BNH696I ADDRESS ipaddress1 CONFLICTS System action
WITH IP ADDRESS ipaddress2 DSIUDST tries to enable TCP/IP-based remote
FOR netid.domainid operations every minute until successful or the task
is stopped.
Explanation
A RMTCMD SEND request for the target NetView Operator response
program that is shown specified (or had a host name If TCP/IP is inactive or became inactive during
resolved to) an IP address that did not match the IP DSIUDST initialization, start TCP/IP.
address known for that target NetView domain.
Message Variables System programmer response
ipaddress1 If the messages indicate TCP/IP stack or port
The IP address specified by the user or found specification problems, correct the definitions and
when a host name specified by the user has been restart the applicable components. If the messages
resolved. indicate some other problem, contact IBM Software
ipaddress2 Support.
The IP address known for the target NetView
program. BNH698I netid1.domainid1 REQUESTED AT
IP ADDRESS ipaddress, PORT
portnumber, BUT netid2.domainid2
WAS FOUND THERE

Chapter 3. BNH Prefix Messages 277


Explanation Operator response
A TCP/IP-based RMTCMD SEND request for the Make sure that TCP/IP is active. To determine which
indicated target NetView program was issued, but remote host information is missing, issue the NRMCTL
when the connection was made, the indicated NetView LISTPARM command. If either NAME or ADDRESS is
domain was found to be there. blank under the HOST DESTINATION(S) field in the
NRMCTL display, and CMODE is set to either IP or IPV6,
Message Variables
then that is the remote host information that cannot be
netid1 resolved.
The IP address specified by the user or found
when a host name specified by the user has been System programmer response
resolved.
domainid1 If remote host information is missing, determine why
The domain identifier of the target NetView the resolver was unable to resolve a host name or IP
program that is expected to be at the IP address address.
and port number shown. BNH700E INVALID NUMBER OF
ipaddress PARAMETERS ON REGIP
The IP address of the host at which the target COMMAND.
NetView program is to be located.
portnumber Explanation
The port number on the host at which the target
A REGIP command was issued without parameters, or
NetView program is to be located.
more than 2.
netid2
The network identifier of the NetView program that
is found at the IP address and port number shown.
System action
domainid2 The REGIP command ends.
The domain identifier of the NetView program that
is found at the IP address and port number shown. Operator response
Reissue the command with the appropriate number of
System action parameters.
The RMTCMD SEND request fails. BNH701E INVALID FUNCTION function ON
BNH699I NETVIEW RESOURCE MANAGER REGIP COMMAND.
COMMUNICATION FAILURE:
reason Explanation
A function other than ADD, DELETE, or LIST was
Explanation specified on the REGIP command.
The NetView Resource Agent cannot communicate via Message Variables
TCP/IP because of incomplete information.
function
Message Variables The name of the incorrect function that was
reason specified.

• LOCAL TCP/IP HOST IS UNKNOWN


System action
• REMOTE TCP/IP HOST IS UNKNOWN
The REGIP command is ended.
System action
Operator response
If the reason is LOCAL TCP/IP HOST IS UNKNOWN,
then this NetView Resource Agent does not forward Reissue the command with a valid function.
status to a Manager host. If the reason is REMOTE
BNH702I REGISTERED IP ADDRESSES/
TCP/IP HOST IS UNKNOWN, then this NetView
HOSTS
Resource Agent does not forward status to a particular
host.

278 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
This is the first line of a MWLTO that displays the If issued by a pipe stage, correct the pipe.
hosts currently registered with the REGIP command.
BNH705E INVALID PRIORITY priority
Registered hosts are displayed on subsequent lines in
SPECIFIED.
an ipaddress : hostname format, one host per line.
BNH703I SYSLOGD MESSAGE RECEIVED. Explanation
FACILITY= facility. PRIORITY=
priority. ORIGIN= origin. An incorrect priority value priority was specified on the
IPLOG command or the IPLOG pipe stage.
Explanation Message Variables
This is the first line of a MWLTO that is generated when priority
the NetView program receives a syslog message from The incorrect value that was specified. See the
a registered host. The text of the syslog message is IPLOG command description for a list of valid
displayed in the subsequent lines of the MWLTO. priorities.
Message Variables
System action
facility
The component that originated the message. See Command processing ends.
the IPLOG command for a listing of the valid
facilities. Operator response
priority
Correct the error and reissue the command.
The message priority. See the IPLOG command for
a listing of the valid priorities.
origin System programmer response
The IP address from which the message was sent. If issued from a pipe stage, correct the pipe.
BNH706E NO SYSLOG MESSAGE SUPPLIED
System action
The message is run through the automation table. It is Explanation
not displayed unless action is taken in the automation
table to do so. If not suppressed, the message is An IPLOG command or pipe stage was issued without
logged by default. supplying a message to log.

BNH704E INVALID FACILITY facility


SPECIFIED.
System action
Command processing ends.
Explanation
An incorrect facility value facility was specified on the
Operator response
IPLOG command or the IPLOG pipe stage. Correct the command and re-enter it.
Message Variables
facility
System programmer response
The incorrect value that was specified. See the If issued from a pipe stage, correct the pipe.
IPLOG command description for a list of valid
facilities. BNH707E OPTION opt HAS INVALID VALUE
value.

System action
Explanation
Command processing ends.
This message was received because an option on
IPLOG, REXEC, RSH, TN3270, or on the NetView 3270
Operator response logon screen was specified with an incorrect value. For
Correct the error and reissue the command. example, the takeover option on the NetView logon
screen contains a priority or facility that is incorrect.

Chapter 3. BNH Prefix Messages 279


Message Variables host
The IP address of the host sending the message.
opt
The name of the option specified or retrieved.
value
System action
The incorrect value that was specified. The message is discarded and the IP connection to the
host ends.
System action BNH711I ENTER PASSWORD FOR REMOTE
Command processing ends. USER.

Operator response Explanation


Correct the command and enter it again. This is an NLS translatable line generated for the
REXEC command when displaying a password prompt
BNH708E REQUIRED HOSTNAME MISSING panel.
OR INVALID
System action
Explanation
Processing continues.
The required positional parameter hostname on
IPLOG, REXEC, RSH, or TN3270 is missing or contains
an incorrect value.
Operator response
Enter the password or password phrase.
System action BNH712I F3=QUIT ENTER=PROCESS
Command processing ends.
Explanation
Operator response This is an NLS translatable line generated for the
Correct the error and re-enter the command. REXEC command when displaying a password prompt
panel.
BNH709E INVALID NUMBER OF
PARAMETERS FOR LOG STAGE.
System action
Explanation Processing continues.

The IPLOG pipe stage was started with an incorrect


number of positional parameters.
Operator response
Press PF3 to exit the command. Press Enter to process
System action the password or password phrase.

Processing for the pipe stage ends. BNH713E NO USER ID SPECIFIED FOR
REXEC.
System programmer response
Explanation
Correct the incorrect pipe stage.
This message is issued when REXEC is started from a
BNH710I SYSLOGD MESSAGE RECEIVED CLIST without supplying a remote user ID.
FROM UNREGISTERED HOST host
System action
Explanation
Command processing ends.
The NetView program received a syslog message from
a host that has not been registered with the REGIP
command.
System programmer response
Message Variables Correct the CLIST.
BNH714E NO PASSWORD SPECIFIED FOR
REXEC.

280 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation BNH717W Conflicting ENTRY entry IN
DSIRHOST MEMBER.
The REXEC command was issued from a CLIST without
supplying a password. If REXEC is driven from an
environment in which interactive panels might cause Explanation
problems, such as a CLIST or automated environment, An entry in the DSIRHOST member of DSIPARM
the remuser field must be specified as remuser/ contains a host name or user name specifying an
password. access level that conflicts with an earlier entry for the
same host name or user name.
System action Message Variables
Command processing ends. entry
The entry in the DSIRHOST member of DSIPARM
System programmer response that contains the conflicting user name or host
name.
Correct the CLIST.
BNH715E UNABLE TO CREATE RHOSTS System action
TABLE.
The entry is discarded and processing of the
DSIRHOST member continues.
Explanation
During startup processing for the DSIRSH task, errors System programmer response
were encountered that made it impossible to construct
an RHOSTS table. Correct the errors in DSIRHOST and stop and restart
DSIRSH.
System action BNH718W UNABLE TO CREATE RHOST ENTRY
FOR host.
The task ends.

Explanation
System programmer response
An entry in the DSIRHOST member of DSIPARM
Correct any errors reported in the DSIRHOST member
cannot be processed because of an internal failure,
of DSIPARM.
such as a storage failure or the failure of the TCP/IP
BNH716W INCORRECT ENTRY entry IN GETHOSTBYNAME service.
DSIRHOST MEMBER. Message Variables
host
Explanation The host for which the RHOST ENTRY was not
The entry in the DSIRHOST member of DSIPARM created
contains errors.
Message Variables System action
entry DSIRHOST processing continues, but the entry is
The entry in the DSIRHOST member of DSIPARM discarded.
that contains errors.
BNH719E UNABLE TO CONNECT TO REMOTE
HOST.
System action
Processing of the DSIRHOST file continues, but the Explanation
erroneous entry is discarded.
One of the IP commands such as REXEC or RSH
cannot establish a TCP/IP connection to a remote host.
System programmer response A BNH167I message might also be issued giving more
information about the failure. This error can be caused
Correct the errors in DSIRHOST and stop and restart
by a server such as an RSH server not being active on
DSIRSH.
the remote host.

Chapter 3. BNH Prefix Messages 281


System action MESSAGE FROM host. MESSAGE
WILL BE TRUNCATED.
Command processing ends.

Explanation
System programmer response
The syslog server in the NetView program was able
If the error persists, determine why the TCP/IP to obtain storage to receive an entire syslog message
connection cannot be established. sent from a remote host. The requested storage would
BNH720E REMOTE ACCESS DENIED BY have been used to replace an existing receive buffer
server SERVER. with a larger one.
Message Variables
Explanation bytes
The NetView program encountered a security error The amount of storage that was requested.
while processing an REXEC or RSH request from host
a remote host. An entry cannot be found in the The IP address of the remote host that sent the
RHOSTS table validating the user (RSH request), or the message.
password or password phrase sent with the REXEC
request was incorrect. This message is sent to the
System action
requesting host in addition to being issued in the
NetView program. The syslog server uses the existing buffer to receive
as much of the message as it can. The remainder is
Message Variables
discarded.
server
The name of the server, either REXEC or RSH. BNH723W UNABLE TO OBTAIN bytes
BYTES OF STORAGE TO RECEIVE
command FROM host. RESPONSE
System action WILL BE TRUNCATED.
The IP connection ends.
Explanation
BNH721E UNABLE TO ATTACH task TASK.
ERROR CODE IS code. The RSH or REXEC server in the NetView program
is unable to obtain storage to receive a response to
Explanation a command sent to a remote host. The requested
storage would have been used to replace an existing
The NetView program was unable to start the operator receive buffer with a larger one.
ID requested by a remote host on an REXEC or RSH
request. Existing messages are issued for incorrect Message Variables
or already-active tasks. This indicates some type of bytes
internal error. The amount of storage that was requested.
Message Variables command
The command type, either RSH or REXEC.
task
The requested operator task. host
The IP address of the remote host that sent the
code
message.
The return code from the internal DSIUATTS
service.
System action
System action The server uses the existing buffer to receive as much
of the response as it can. The remainder is discarded.
Processing continues.
BNH724E TCP/IP INITIALIZATION FAILED.
System programmer response
Explanation
Contact IBM Software Support.
A NetView command was unable to initialize a TCP/IP
BNH722W UNABLE TO OBTAIN bytes BYTES
environment. This might be accompanied by BNH167
OF STORAGE FOR SYSLOGD
messages. If the message was a result of the REGIP

282 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command, the DSIIPLOG task might have to be Explanation
stopped and restarted.
One of the IP applications RSH, REXEC, IPLOG or
TN3270 attempted to initialize a TCP/IP environment
System action but the TCP address space name was not available.
The command ends.
System action
Operator response The command ends.
Notify the system programmer.
Operator response
System programmer response Issue the NetView DEFAULTS command to set the
Determine the reason for the TCP/IP failure. If TCPNAME default to the correct value.
necessary, perform problem determination procedures BNH728E COMMAND NOT ALLOWED IN
and contact IBM Software Support. TCP/IP ENVIRONMENT
BNH725I F3=QUIT PF6=ROLL
ENTER=PROCESS COMMAND Explanation
An IP command was issued under a task that is
Explanation already executing an IP command, or is a task
This is an NLS translatable message generated by the processing an RSH or REXEC request.
RSH command when it displays a full-screen panel for
command responses. System action
The command ends.
System action
BNH729E INTERNAL FAILURE IN TELNET
Processing continues. CLIENT.

Operator response Explanation


PF3 exists the command. PF6 rolls out to the next The TN3270 command encountered an internal error,
NetView component on the roll stack. Enter sends such as a storage request failure.
another command to the remote server or process
additional input waiting for the screen to be cleared.
System action
BNH726I REMOTE SHELL TERMINATED.
PF3=EXIT The command ends.
BNH730I TELNET SESSION TERMINATED BY
Explanation REMOTE HOST.
This is an NLS translatable message generated by the
RSH command when displaying a full-screen panel Explanation
for command responses. It indicates that the remote The telnet connection established by the TN3270
server has ended the TCP/IP connection. command has been ended by the remote host. This
might happen because of an error condition or in
System action response to a user request, such as logoff.
Processing continues.
System action
Operator response The command ends.
PF3 exists the panel. BNH731E MQS FAILED TO IP LOG TASK.
BNH727E TCP ADDRESS SPACE NAME NOT
AVAILABLE. Explanation
A REGIP request failed because the DSIIPLOG task is
inactive.

Chapter 3. BNH Prefix Messages 283


System action System action
The command ends. The command ends.
BNH736I No Workload Management
Operator response NetView Service Class Matches
Start the DSIIPLOG task and retry the command. Selection Criteria

BNH732E HOST VALUE NOT ALLOWED ON


Explanation
LIST.
The specified WLM NetView service class was not
Explanation found.

A REGIP LIST command was issued with a host name


System action
as the second parameter. The LIST format of the
REGIP command accepts only an "*" as the second Command continues processing.
parameter.
Operator response
System action
Check the spelling of the requested WLM NetView
The command ends. service class name and correct it if in error.
BNH737I statement
Operator response
Reissue the command as "REGIP * LIST" Explanation
BNH733I NO HOSTS REGISTERED. As a result of a D CNMCAUT=TABLE command, the
contents of PARMLIB member CNMCAUxx are listed.
Explanation Message Variables
This message is issued in response to a REGIP LIST statement
request when no remote hosts are registered. A console name of command text in CNMCAUxx.
BNH738E COMMAND NOT PROCESSED --
System action PPI SEND FAILURE
Processing continues.
Explanation
BNH734I SYSLOG MESSAGE ACCEPTED BY
TCP/IP. You entered a command (such as SET CNMCAUT=xx)
that is to be processed by the NetView MVS command
Explanation exit. That command cannot be processed in the
current environment (such as the CONSOLE address
The IPLOG command has completed successfully and space) and must be forwarded to the NetView address
the supplied syslog message has been accepted by space to be processed. However, the command cannot
TCP/IP to send out over the network. be forwarded at this time because the command
exit found that the PPI connection to the command
System action receiver is not active, or found that some other send
failure occurred.
Processing continues.
BNH735E COMMAND TERMINATED DUE TO System action
ERROR ON REMOTE SERVER
The command is not processed.

Explanation
Operator response
An RSH or REXEC command was ended because of an
Ensure that the PPI address space is started and
error on the remote host.
that NetView task DSIMCAT is active. Reenter the
command when the PPI connection DSIMCAT has
been restored. If the PPI address space has recently

284 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


been recycled, wait until task DSIMCAT issues BNH742I REMOTE OPERATIONS REQUEST
message DSI530I before reentering the command. FROM netid.domainid REJECTED
You can also enter the command from another DUE TO reason
environment, such as from the NetView program or
from TSO.
Explanation
BNH740I REMOTE OPERATIONS USING
This message notifies the authorized receiver that
TCP/IP tcpname ARE NOW
either incorrect data was sent on an existing remote
ENABLED
operations connection or there was a disallowed
remote operations connection attempt.
Explanation
Message Variables
The DSIUDST task sends this message to the
netid
authorized receiver to show that TCP/IP-based remote
The network identifier of the NetView program that
operations are enabled using the indicated TCP/IP
was the source of the request, or "*" (asterisk) if
stack.
unknown.
Message Variables domainid
tcpname The domain identifier of the NetView program that
The identifier of the TCP/IP stack was the source of the request, or "*" (asterisk) if
unknown.
Operator response reason
The reason the request was rejected, which can be
Perform TCP/IP-based remote operations, as needed. one of the following:
BNH741I REMOTE OPERATIONS FOR • TRANSPORT DATA ERROR
netid.domainid TERMINATED
• DUPLICATED ORIGIN DOMAIN
The first reason indicates that incorrect data
Explanation
was sent on the connection. This can mean
This message informs the authorized receiver that that the source of the connection request was
the connection between the remote NetView domain not a NetView domain. The second reason
and the current NetView domain has been lost. If the indicates that an attempt was made for a second
connection was ended by an ENDTASK request, the connection from a NetView domain. This can
operator issuing ENDTASK also gets this message. indicate connection attempts from 2 different
NetView programs with the same network and
Message Variables
domain identifiers.
netid
The network identifier for the remote NetView System action
program.
domainid The connection is ended.
The domain identifier for the remote NetView
program. System programmer response
Restrict the ability of others to connect to the remote
System action operations server (DSIUDST task) and ensure that the
Remote operators logged on for TCP/IP-based remote NetView domain ID is unique in each network.
operations using the connection are logged off. BNH743I REMOTE OPERATIONS FROM
netid.domainid TERMINATED
Operator response
If remote operations are to continue on the Explanation
remote NetView domain, enter the next RMTCMD This message informs the authorized receiver that the
SEND. Presuming the previous connection ended connection between another NetView domain and the
successfully, a new connection is established and the current NetView domain has been lost. The connection
remote operator is logged on to run the command. to which this message applies is one in which the
current NetView domain was the target of a RMTCMD
SEND request from another NetView domain.

Chapter 3. BNH Prefix Messages 285


Message Variables Operator response
netid Determine why the NetView programs have lost
The network identifier for the NetView program communication and take appropriate action.
that was the origin of remote operations over
TCP/IP. BNH745I NO 'keyword' LIMIT REACHED FOR
TASK 'opid' 'luname'
domainid
The domain identifier for the NetView program that
was the origin of remote operations over TCP/IP. Explanation
This message is issued when a task drops below any
System action specified threshold limits set by the DEFAULTS or
OVERRIDE command. This message must only be seen
Remote operators logged on for TCP/IP-based remote
when a BNH161I message for the same resource limit
operations using the connection are logged off.
has previously been issued.
Message Variables
Operator response
keyword
If remote operations are to continue between the
The name of the limit that was reached. This is the
NetView domain that originated them and the current
same name as the non-synonym keywords used on
NetView domain, an operator in the origin NetView
the DEFAULTS and OVERRIDE commands.
domain can enter the next RMTCMD SEND. Presuming
the previous connection ended successfully, a new opid
connection is established and the remote operator is The LU name or task name of the affected task.
logged on to run the commands. luname
BNH744I NETVIEW RESOURCE 'type' The operator ID or task name of the affected task.
'domain' HAS LOST
COMMUNICATION WITH 'type' System action
'domain'
This message is issued when the resource limit for the
task is in an acceptable range, as defined by the user.
Explanation Status on NMC for this object returns to "Satisfactory."
The message is issued when: BNH747I COMMAND NOT PROCESSED FOR
• A NetView Resource Manager has lost connectivity RESOURCE resource. NETVIEW
with a NetView Resource Agent. RESOURCE MANAGER AGENT
domain IS NOT MONITORED
• A NetView Resource Agent has lost connectivity with
a NetView Resource Manager.
Explanation
Message Variables
A command was issued against an NRM resource from
type the NetView management console. The domain where
The type of NetView Resource Manager host. The the resource resides is not currently being monitored.
value is MANAGER or AGENT. The command is not run.
domain
Message Variables
The NetView domain for the NetView Resource
Manager or Agent. resource
The resource against which the command has
been issued
System action
domain
If a NetView Resource Manager has lost connectivity The domain of the NetView Resource Agent
with an Agent NetView, then the resources for the
Agent NetView are put in UNKNOWN status. The Agent
is also deleted from the list of NetView programs being System action
monitored by that Manager. If a NetView Resource The command is not executed.
Agent has lost connectivity with a Manager NetView
program, then it attempts to reconnect with the
Manager NetView program.

286 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Determine why the agent is not being monitored A member identified by member_id was found in the
(for example, a SUSPNRM was issued to the agent, cache and it was stored in the cache by task_name.
or the agent lost communication with the manager).
A MEMSTOUT UNLOAD or REFRESH might have been
Take appropriate action to get the agent back in
issued for a member that was not stored in the cache
communication with the manager.
by the MEMSTORE automated caching service. The
BNH748I domainID NETVIEW message identifies the task that stored the member
SUCCESSFULLY CONNECTED TO in the cache. MEMSTOUT operates only on members
WLM cached by the MEMSTORE automated caching service.
Message Variables
Explanation
member_id
The NetView WLM.SubSystemName statement was A string identifying a member found in the cache.
uncommented causing the NetView program to The format of the string is DDName.memberName.
attempt to connect to the system work load manager task_name
(WLM). The attempt was successful. Name of task that cached the member.
Message Variables
domainID System action
The domain ID of the NetView program connected Processing continues.
to WLM
Operator response
System action
The PIPE INSTORE stage can be used to remove the
NetView initialization continues. member from the cache. If a MEMSTOUT UNLOAD was
BNH749I A SECURITY VIOLATION HAS issued, even though no member was removed from the
CAUSED SOCKET nnn TO BE cache, caching for members matching the member_id
SUSPENDED pattern specified is now disabled. See additional help
for the MEMSTOUT command to determine how to
reenable caching for the member.
Explanation
BNH751I operator LOGOFF OR DISCONNECT
A socket, allocated for a connection that was FROM NETVIEW. PLEASE
disallowed by security, has been placed in a SHUT DOWN YOUR BROWSER
suspended status. "Suspended status" means that TO PROTECT SENSITIVE
while a connection still exists between this socket INFORMATION.
and the origin of the connection request, no
communication requests involving the socket, other
than SOCKET TYPE=CLOSE, is allowed. Explanation
Message Variables The operator logged off or disconnected from the
NetView program.
nnn
The descriptor number for the socket Message Variables
operator
System action The operator ID that logged off or disconnected
from the NetView program.
The socket remains connected and suspended. Only a
SOCKET TYPE=CLOSE command can be issued for that
socket. System action
The session between the NetView program and the
Operator response browser ends.

Issue SOCKET TYPE=CLOSE for the suspended socket.


Operator response
BNH750I member_id was cached by
task_name To protect sensitive information, verify that all NetView
browser windows are closed.

Chapter 3. BNH Prefix Messages 287


BNH752I NETVIEW INTERNAL ERROR, BNH757E The SAFNODEC setting will be
PLEASE TRY AGAIN LATER. used for surrogate decisions due
to a problem with the dataspace
Explanation for the SURROGAT class.

The NetView program incurred an internal error.


Explanation
System action When the NetView program attempted to make a
surrogate authorization call to the security product, a
The command is not processed. return code was received from the security product
indicating that the dataspace for the SURROGAT class
Operator response was not accessible. The dataspace for the SURROGAT
class might have been deleted.
Enter the command again. If the problem persists,
notify your system programmer.
System action
BNH753I REQUEST NOT PROCESSED -
The SAFNODEC setting is used for surrogate
AUTHORIZATION REQUIRED.
authorization decisions until after the dataspace
problem is resolved.
Explanation
Message BNH189 is issued following this message
The operator ID is not authorized to run the command. to give the security product return codes. When the
problem with the dataspace for the SURROGAT class
System action is resolved, message BNH758 is issued and surrogate
checks in the SURROGAT class are resumed.
The command is not processed.
Operator response
Operator response
Notify the system programmer or security
When prompted, enter your NetView operator ID and administrator.
password or password phrase again.
BNH754I GROUP group_name MEMBER System programmer response
member_name HAS UPDATED
Look to see if the dataspace for the SURROGAT class
STATE FIELD. PREVIOUS
was deleted.
VALUE= previous_value . NEW
VALUE=new_value For RACF, you can issue a 'SETR LIST' command
from an authorized TSO operator to determine if the
SURROGAT class is RACLISTed. If the SURROGAT class
Explanation
does not appear under one of the 2 RACLISTed output
This message is issued when a group user exit is lines, the dataspace was deleted.
driven because an XCF member in a group in which
It is possible that someone issued a SETR
the NetView program participates has changed its user
NORACLIST(SURROGAT), which caused the dataspace
state field. The new and previous value of the field is
to be deleted. This can be corrected by issuing a SETR
indicated in the message. This message is sent to the
RACLIST(SURROGAT) command from an authorized
authorized receiver.
TSO operator or by recycling the NetView program.
Message Variables
BNH758I Surrogate authorization using the
group_name SURROGAT class has resumed.
The name of the group
member_name Explanation
The name of the member
There was previously a problem with the dataspace for
previous_value the SURROGAT class, detailed by message BNH757,
The previous 32-byte value of the field but the problem is resolved.
new_value
The current 32-byte value of the field

288 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action not issued a RESUME for which a SUSPEND was not
outstanding.
The SURROGAT class of the security product is used
for NetView surrogate security. BNH760I name does not have a CMDDEF
statement or it is not a command
procedure.
System programmer response
See message BNH757 for additional information. Explanation
BNH759E clist1 INVOKED AS clist2 CAUSED An entry was found in DSIPARM member DSIAUTB or
THE AUTBYPAS parm LIMIT TO BE DSIAUTBU that is not a command procedure or does
EXCEEDED not have a defined CMDDEF statement.
Message Variables
Explanation
name
A command procedure started the AUTBYPAS function The entry in DSIAUTB or DSIAUTBU
in a manner that exceeded the limits of a parameter.
This message might be generated as a result of
subroutine and function calls because each of these System action
calls is included in the suspend and resume counts. The entry is ignored.
The count is incremented when the subroutine
or function is started and decremented when the
subroutine or function returns to its invoker. Operator response
Message Variables Notify your system programmer.

clist1
The command procedure that issued the System programmer response
AUTBYPAS function in error If this is an entry provided with the NetView program,
clist2 contact IBM Software Support. If this is a user-written
The verb used to start the command procedure command procedure, ensure that you have defined the
entry correctly and that a CMDDEF statement exists.
parm
The AUTBYPAS parameter that caused the limit to BNH761E Attempt to initialize socket
be exceeded. For SUSPEND, the limit is 254 for interface on ipStack failed
each command procedure. For RESUME, the limit
is zero.
Explanation
System action An attempt to initialize a raw socket on the IP stack
with name ipStack failed.
The AUTBYPAS call is ignored and security settings are
not changed. Message Variables

If this message is issued as the result of a REXX ipStack


subroutine or function call, the call results in a REXX Either the default IP stack name or the IP stack
incorrect subroutine or function invocation message, specified by the -s or TCPNAME operand
and the subroutine or function is not called.
System action
Operator response Socket initialization ends.
Notify your system programmer.
Operator response
System programmer response Verify IP connectivity or specify an available IP stack
If this is a command procedure provided with the name.
NetView program, contact IBM Software Support. BNH763E No IP address or hostname
If this is a user-written command procedure, review specified for command
your use of SUSPEND and RESUME to ensure that you
have not exceeded 254 suspends or that you have

Chapter 3. BNH Prefix Messages 289


Explanation BNH765I Pinging ipHostname at ipAddress
with count packets of length length
An IP address or host name is required but was not bytes
specified for the indicated command. If the command
is FKXEDVPC, then the host name and IP address
are missing from the TCP390 stack definition data. Explanation
This can indicate problems with the stack or with the The specified IP host is being pinged with a finite
resource discovery function. number of echo requests (pings).
Message Variables
System action
ipHostname
The command ends. The name of the IP host being pinged
ipAddress
Operator response The address of the IP host being pinged
Specify a valid IP host name or address and count
reissue the command. If the indicated command is The number of pings being sent
FKXEDVPC, notify the system programmer.
length
The length (size) of the ping packets being sent
System programmer response
Investigate why the resource discovery function is not System action
working if it is being used. You might need to add
Processing continues
either a host name or an IP address to the TCP390
statement in the CNMPOLCY file. BNH766I Pinging ipHostname at ipAddress
indefinitely with packets of length
BNH764W Host name resolution timed out
length bytes

Explanation Explanation
This message is issued when a timeout (exceeding the
The specified IP host is being pinged with an indefinite
CNMIP.DNSTimeout provided time interval) occurs for
number of echo requests (pings).
either of the following types of resolver requests:
Message Variables
• Determine an IP address given a host name
• Determine a host name given an IP address ipHostname
The name of the IP host being pinged
ipAddress
System action
The address of the IP host being pinged
Processing continues. length
The length (size) of the ping packets being sent
Operator response
Verify network connectivity and domain name server System action
availability, or re-issue the command with the host The PING command continues until it ends, either
name or IP address the resolver was asked to manually or otherwise.
determine, if it is known.
If the host name or IP address the resolver was asked Operator response
to determine is not known, then contact the system
programmer. Enter the NCCF RESET command to end the command
and generate a summary report of pings sent,
received, and packet loss calculated.
System programmer response
BNH767I numBytes bytes received from
Ensure that the configuration of the resolver and ipAddress: seq=number in time ms
applicable domain name server(s) allow a specified
host name or IP address to be resolved.

290 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
A valid echo reply to an echo request (ping) was This is the second of the 2 summary messages
received generated at the conclusion of PING processing.
Message Variables Message Variables
numBytes min
The number of bytes in the echo reply The minimum round-trip time in milliseconds of
ipAddress any echo request for which a valid echo reply was
The origin (IP address) of the echo reply received
number max
The sequence number of the original echo request The maximum round-trip time in milliseconds of
(ping) for which this is the reply any echo request for which a valid echo reply was
received
time
The round-trip time of the echo request (ping) and avg
reply The average round-trip time for all echo requests
sent for which valid echo replies were received

System action
System action
Processing continues
Processing ends.
BNH768I Ping timed out
BNH771I Pinging of ipHostname at
ipAddress result
Explanation
No valid echo reply to an echo request (ping) was Explanation
received in the time allowed
This message is generated, at the conclusion of
processing, when a PING command is issued with the
System action -q or QUICK option.
Processing continues with the subsequent echo Message Variables
request
ipHostname
BNH769I ping packets sent, echo packets The name of the IP host being pinged
received, percent% packet loss
ipAddress
The address of the IP host being pinged
Explanation result
This is the first of the 2 summary messages generated The status of the ping. Values are SUCCEEDED or
at the conclusion of PING processing. FAILED
Message Variables BNH772I NUMBER OF CONNECTIONS:
numcon, MISSED BUFFERS:
ping
missbuf
The total number of echo requests (pings) sent
echo
Explanation
The total number of echo replies received
percent This is a multiline message written in response to the
The calculated percentage of echo requests for TCPCONN QUERY command. It consists of one header
which valid echo replies were not received line followed by a variable number of data lines,
each describing a TCP/IP connection. The number of
connections returned is determined by the MAXRECS
System action operand on the TCPCONN QUERY command. This
Processing continues message is designed for parsing by REXX and not
for reading by a person. A REXX sample, CNMSTCPC,
BNH770I Round trip times from min to max is provided to format the BNH772I information for
ms, averaging avg ms readability.

Chapter 3. BNH Prefix Messages 291


Note: TCPCONN QUERY displays all of the available 177-184
data, but some error conditions can delete data. The eight-digit hexadecimal representation of the
See any preceding error messages for possible TCB address of the local owner task.
explanations for missing data. 186-201
Each data line includes the following information: The 16-digit hexadecimal representation of the
TCP/IP socket resource ID.
Columns
Description 203-224
The number of bytes received over the connection
1-8 (right-aligned, with leading zeros omitted).
The TCP/IP name.
226-247
10-72 The number of bytes sent over the connection
The local IP address. If LADDR in the TCPCONN (right-aligned, with leading zeros omitted).
QUERY was specified in colon hexadecimal format,
this address is output in the form 249-256
hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhh The maximum send window size (right-aligned,
h, where each hhhh is a 0-to-4 character with leading zeros omitted).
hexadecimal value. If LADDR was specified in 258-262
dotted decimal format, this address is output in The retransmit count (right-aligned, with leading
the form ddd.ddd.ddd.ddd if it is an IPv4 zeros omitted).
address, or the form 264-271
ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.dd The protocol indicator (LINEMODE, TN3270,
d. ddd.ddd.ddd.ddd.ddd.ddd if it is an IPv6 TN3270E, or N/A).
address. In either case, ddd is a decimal number
from 0 to 255. Otherwise, this address is output in 273-280
the form ddd.ddd.ddd.ddd if it is an IPv4 The LU name, if reported by the z/OS
address, or the form Communications Server.
hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhh 282-289
h if it is an IPv6 address. Leading zeros are The target application name, if reported by the
stripped from output IPv4 addresses but not IPv6 z/OS Communications Server.
addresses. Unused columns on the right are blank. 291-298
74-78 The logmode name, if reported by the z/OS
The local port number (right-aligned with leading Communications Server.
zeros omitted).
Note: For help with the meanings of the values for
80-142 the following fields, see the CNMSTCPC sample: TTLS
The remote IP address, with formatting handled in connection status, TTLS policy status, termination
the same way as the local IP address. code, and status flags.
144-148 300-301
The remote port number (right-aligned with The 2-digit hexadecimal representation of the
leading zeros omitted). TTLS connection status.
150-157 303-304
The date and time the connection started, The 2-digit hexadecimal representation of the
formatted as an eight-character binary store-clock TTLS policy status.
value. This value can be converted into a printable
format using the PIPE EDIT command. 306-307
The 2-digit hexadecimal representation of the TCP
— connection termination code.
The following columns are included only for
inactive connections. 309-310
The 2-digit hexadecimal representation of the
159-166 status flags.
The date and time the connection ended,
formatted as an eight-character binary store-clock 312-313
value. This value can be converted into a printable The 2-digit hexadecimal representation of the type
format using the PIPE EDIT command. of service (ToS).
168-175 Message Variables
The socket resource name (the name of the
address space that established the connection).

292 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


numcon than the value of the MAXRECS keyword, and N/A
The total number of connections matching the if not.
input criteria. If this number exceeds MAXRECS, missbuf
the COUNT=YES operand must be specified on the The number of missing data buffers. An increased
TCPCONN QUERY command for this value to be value of missbuf indicates reduced accuracy of the
displayed. Otherwise, numcon is N/A. QUERY results.
missbuf tname
The number of missing data buffers. An increased The TCP name specified on the command. If no
value of missbuf indicates reduced accuracy of the TCP name is specified, the default TCP name is
QUERY results. used.

System action System action


The TCPCONN QUERY is complete. The PKTS QUERY is complete.
BNH773I NUMBER OF PACKETS: nump, BNH774I PURGE COMPLETED. nump
MISSED BUFFERS: missbuf, RECORD(S) OF TYPE ptype WERE
TCPNAME: tname PURGED FOR TCPNAME tname.

Explanation Explanation
This is a multiline message written in response to This message is returned in response to the TCPCONN
the PKTS QUERY command. It consists of one header PURGE or PKTS PURGE command and indicates
line followed by a variable number of data lines, each that the specified number of records have been
describing a traced packet. The number of packets purged from storage or DASD. If both active and
returned is determined by the MAXRECS operand on inactive connections have been purged, 2 BNH774I
the PKTS QUERY command. messages appear, one for active and one for inactive
Note: PKTS QUERY displays all of the available data, connections.
but some error conditions can cause some data to Message Variables
be missing. See any preceding error messages for
possible explanations for missing data. nump
The number of records that have been purged.
Each data line includes the following information in
binary form: ptype
The type of records that have been purged:
Columns
Description • ACTIVE-CONN (active connection records)
1-16 • INACTIVE-CONN (inactive connection records)
The Communications Server Component Trace • PACKET (packet trace records)
Element (CTE) header. The first 2 bytes are the
tname
record length.
The TCP/IP name of the stack. For inactive
17-nn connection records, the TCP/IP name can be an
The Communications Server Packet Trace Header asterisk (*).
(PTH) and data. The first 2 bytes are the PTH
length, followed by the packet data, starting with BNH775I NUMBER OF CONNECTIONS:
the IP header. numcon

The binary data can be converted into a printable form


using the PIPE EDIT command or the FMTPACKT pipe Explanation
stage. This is a multiline message written in response to the
Message Variables TCPCONN QUERYACT command. It consists of one
header line followed by a variable number of data
nump lines, each describing an active TCP/IP connection.
The number of matching traced data packets. If The number of connections returned can be limited by
COUNT=YES was specified on the PKTS QUERY the MAXRECS operand on the command, depending
command, this is the number of matching packets. on the actual number of connections that match
If COUNT=YES was not specified, the value of the criteria operands. This message is designed for
nump is the number of matching packets if less parsing by REXX and not for reading by a person. A

Chapter 3. BNH Prefix Messages 293


REXX sample, CNMSTCPC, is provided to format the 168-175
BNH775I information for readability. The job name of the address space that opened
the socket.
Note: TCPCONN QUERYACT displays all of the
available data, but some error conditions can cause 177-184
incomplete data. See any preceding error messages The eight-digit hexadecimal representation of the
for possible explanations for incomplete data. TCP/IP resource (connection) identifier.

Each data line includes the following information: 186-205


The total number of bytes received over the
Columns connection (right-aligned, with leading zeros
Description omitted).
1-8 207-226
The TCP/IP job name for which a connection The total number of bytes sent over the connection
endpoint is found. (right-aligned, with leading zeros omitted).
10-72 228-232
The local IP address. If LADDR in the TCPCONN The number of retransmitted segments (right-
QUERY was specified in colon hexadecimal format, aligned, with leading zeros omitted).
this address is output in the form
234-253
hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhh
The total number of segments received over
h, where each hhhh is a 0-to-4 character
the connection (right-aligned, with leading zeros
hexadecimal value. If LADDR was specified in
omitted).
dotted decimal format, this address is output in
the form ddd.ddd.ddd.ddd if it is an IPv4 255-274
address, or the form The total number of segments sent over the
ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.dd connection (right-aligned, with leading zeros
d. ddd.ddd.ddd.ddd.ddd.ddd if it is an IPv6 omitted).
address. In either case, ddd is a decimal number 276-279
from 0 to 255. Otherwise, this address is output in The connection state (right-aligned, with leading
the form ddd.ddd.ddd.ddd if it is an IPv4 zeros omitted). The meanings are as follows (the
address, or the form first 11 are defined by TCP/IP; in the last case,
hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhh z/OS Communications Server is in the process of
h if it is an IPv6 address. Leading zeros are deleting and cleaning up the TCB):
stripped from output IPv4 addresses but not IPv6
addresses. Unused columns on the right are blank. 1
CLOSED
74-78
The local port number (right-aligned with leading 2
zeros omitted). LISTENING

80-142 3
The remote IP address, with formatting handled in SYN_SENT
the same way as the local IP address. 4
144-148 SYN_RECEIVED
The remote port number (right-aligned with 5
leading zeros omitted). ESTABLISHED
150-157 6
The date and time the connection started, FIN_WAIT_1
formatted as an eight-character binary store-clock 7
value. This value can be converted into a printable FIN_WAIT_2
format using the PIPE EDIT command.
8
159-166 CLOSE_WAIT
The date and time of the last activity on this
connection, formatted as an eight-character binary 9
store-clock value. This value can be converted into lAST_ACK
a printable format using the PIPE EDIT command. 10
CLOSING

294 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


11 467-474
TIME_WAIT The TN3270 logmode name.
12 476-483
DELETE_TCB The protocol indicator (LINEMODE, TN3270,
281-290 TN3270E, or N/A).
The most recent timestamp value, in milliseconds, 485-487
received from the remote side of the connection. The AT-TLS policy status (right-aligned, with
leading zeros omitted). The meanings, defined by
292-301
the z/OS Communications Server, are as follows:
The time, in milliseconds, when the previous field
was updated. 0
303-310 unknown
The maximum send window size (right-aligned, 1
with leading zeros omitted). off
312-319 2
The current send window size (right-aligned, with no matching rule was found
leading zeros omitted). 3
321-325 matching rule indicates that AT-TLS is not used
The number of duplicate acknowledgments (right- 4
aligned, with leading zeros omitted). AT-TLS is enabled for this connection, but
327-327 application control has not been granted
Whether the local or remote end connected. 5
0 AT-TLS is enabled and is application-
Remote end issued connect controllable
1 489-491
Local end issued connect The AT-TLS connection status (right-aligned, with
leading zeros omitted). The meanings, defined by
329-344
the z/OS Communications Server, are as follows:
The interface name.
346-408 1
The TCP/IP host name that was discovered for the connection does not have a secure session
TCP/IP job name. established

410-417 2
The z/OS image name for which TCP/IP connection connection initial handshake in progress
information is requested. 3
419-422 connection has a secure session
The 4-digit hexadecimal identification of the 493-496
address space (ASID) that established the The hexadecimal AT-TLS SSL protocol. The
connection. meanings, defined by the z/OS Communications
424-431 Server, are as follows:
The eight-digit hexadecimal representation of the 0000
local owner task's TCB address. connection does not have a secure session
433-438 established
The six-digit hexadecimal representation of the 0200
three consecutive options bytes defined by the SSL version 2 is in use
z/OS Communications Server EZBNMRHC header
0300
file.
SSL version 3 is in use
440-447
0301
The TN3270 target application name.
TLS version 1 is in use
449-456
498-501
The TN3270 LU name.
The 4-digit hexadecimal representation of the AT-
458-465 TLS negotiated cipher.
The TN3270 user client name.

Chapter 3. BNH Prefix Messages 295


503-505 of data record that has been returned. This message is
The AT-TLS security type (right-aligned, with used internally by the NetView program.
leading zeros omitted). The meanings, defined by
Message Variables
the z/OS Communications Server, are as follows:
0 P/M
Connection does not have a secure session P
established The data was returned through the EZNMI
1 PIPE stage, which collects data from the
Client EZBNMIFR interface.
2 M
Server The data is from the SYSTCPSM socket
interface.
3
Server with client authentication - client stack
authentication type is PassThru The TCP/IP stack name.
4 ident
Server with client authentication - client Identifier for the data:
authentication type is Full 119
5 A type 119 SMF record
Server with client authentication - client N/A
authentication type is Required Data is not a type 119 SMF record
6 subtype
Server with client authentication - client If this is a type 119 SMF record, then subtype is
authentication type is SAFCheck the subtype of the record. If this field is N/A, then
507-514 the data is not a type 119 SMF record.
The AT-TLS partner user ID. sdata
Message Variables Formatted data specific to the type of record. For
example, for a subtype 4 SMF 119 profile record,
numcon there are 22 blank delimited numbers, where each
The total number of connections matching the number corresponds to the number of entries in
input criteria. If this number exceeds MAXRECS, the given section of the type 119 SMF record.
the COUNT=YES operand must be specified on the
TCPCONN QUERYACT command for this value to BNH789I CORRELATION LOOP DETECTED.
be displayed. Otherwise, numcon is N/A. MESSAGE/MSU REJECTED.

System action Explanation


The TCPCONN QUERYACT is complete. A message or MSU has been submitted for correlation
after already having completed the correlation
BNH776I P/M stack ident subtype sdata process. This indicates that there was an error in
coding the automation table. When an error condition
Explanation is detected in the pipe stage, the original input
message is still copied to the primary output stream,
BNH776I is a multiline message that returns a but no MQS to DSICORSV occurs.
data record that was collected through the network
Management Interface (NMI), either through the BNH790I NetView Resource Agent domain is
EZBNMIFR interface or the SYSTCPSM interface. If down-level. Processing continues.
the data record was collected through the SYSTCPSM
interface, then that data record is a type 119 SMF Explanation
record. If the data record was collected through the
EZBNMIFR interface, then the data resembles, but is The specified NetView Resource Agent domain is
not, a type 119 SMF record. The P/M indicator, the not running the NetView program level that supports
ident field, and the subtype field inform the user of the customizing the autotask name for NetView Resource
format of the data record. The sdata field contains a manager. Autotask AUTONRM is used for NetView
series of blank delimited numbers specific to the type Resource Manager processing on the specified
domain.

296 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action host information retrieval process, then the socket
type shown is STREAM.
Processing continues.
Message Variables
System programmer response socktype
The socket type, which is STREAM, DATAGRAM, or
Upgrade the NetView program level on the host RAW.
specified by domain.
BNH791I ADDRESS FAMILY IS family System action
Processing continues.
Explanation
BNH794I PROTOCOL NUMBER IS nnn
This message shows the address family applicable to
an IP address shown in a previous BNH641I message
issued in response to a GETADDRINFO request made Explanation
by the socket interface. The address family name This message displays the protocol number that must
shown can be used as the value of the FAMILY be assigned to a raw socket that must be used
keyword of the SOCKET command. to communicate with a service whose IP address
Message Variables is shown in a preceding BNH641I message. This
message is part of a set of messages returned by the
family socket interface for a TCP/IP GETADDRINFO request
The address family, INET or INET6. and is only received if the socket type shown in the
immediately preceding BNH792I message is RAW.
System action Message Variables
Processing continues. nnn
BNH792I PORT NUMBER IS nnn The protocol number. To associate the protocol
number with a protocol name, check the TCP/IP
protocol definitions.
Explanation
This message shows the port number applicable to System action
an IP address shown in a previous BNH641I message
issued in response to a GETADDRINFO request made Processing continues.
by the socket interface. It shows the port number BNH795I SCOPE ID IS scopeid
assigned to a TCP/IP service whose name was
included on the GETADDRINFO request; otherwise, the
port number is zero. Explanation
Message Variables This message displays the scope identifier (also known
as a zone identifier) associated with an IP address
nnn that appears in a preceding message. This message
The port number assigned to a TCP/IP service or is received only if the IP address in the preceding
zero. message is an IPv6 address of link-local scope.
Message Variables
System action
scopeid
Processing continues. The scope (zone) identifier. This identifier can
BNH793I SOCKET TYPE IS socktype be used as the value of the SCOPEID keyword
of the SOCKET command when attempting to
communicate with the host at that IP address.
Explanation
This message displays the type of socket that is used System action
to communicate with a service whose IP address
is shown in a preceding BNH641I message. This Processing continues.
message is part of a set of messages returned by the BNH796I SERVICE NAME IS service
socket interface for a TCP/IP GETADDRINFO request.
If the socket type cannot be determined during this

Chapter 3. BNH Prefix Messages 297


Explanation address is entered with the VTAM command
when DEFAULTS.IPV6Env=NONE is specified,
This message displays a service name as part of or an IPv4 address is entered when
the information returned for a TCP/IP GETNAMEINFO DEFAULTS.IPV6Env=ONLY is specified. Enter the
request made by the socket interface. This message is command again with a valid IP address.
received only if TCP/IP returned a service name.
BNH798I NO INTERFACES WERE RETURNED
Message Variables
service Explanation
The name of a service. This might instead contain
a port number, depending upon other information This message indicates that a TCP/IP IOCTL
supplied with the SOCKET TYPE=GETNAMEINFO request made by the socket interface completed
command. and returned no network interface information.
It might appear when OPTNAME=SIOCGHOMEIF6
or OPTNAME=SIOCGIFCONF is used with SOCKET
System action TYPE=IOCTL.
Processing continues.
BNH797I CONVERSION FAILED FOR IP System action
ADDRESS ipaddress WITH RC Processing continues.
retcode. COMMAND PROCESSING
TERMINATED. BNH799I INTERFACE NAME IS name

Explanation Explanation
The IP address passed to an address translation This message shows the name assigned to
routine cannot be converted as requested. Either the a TCP/IP network interface. It might be
IP address is incorrect or the parameters passed to issued in response to a TCP/IP IOCTL
the address translation routine are incorrect. request made by the socket interface (SOCKET
TYPE=IOCTL) using OPTNAME=SIOCGIFCONF or
Message Variables OPTNAME=SIOCGIFNAMEINDEX.
ipaddress Message Variables
The IP address that cannot be converted.
name
retcode
A 1 - 16 character network interface name.
The return code from the address translation
routine.
System action
System action
Processing continues.
The command fails.
BNH800I INTERFACE ADDRESS IS address

Operator response
Explanation
Take appropriate action depending on the value of
This message shows the IP address of a TCP/IP
retcode.
network interface. It might be issued in response
retcode = 0 to a TCP/IP GETSOCKOPT request made by the
Conversion was successful. socket interface (SOCKET TYPE=GETSOCKOPT) with
retcode = 4 through retcode = 16 OPTNAME=IP_MULTICAST_IF. It might also be issued
The address translation routine failed because of in response to a TCP/IP IOCTL request made by the
an internal error. Contact IBM Software Support. socket interface (SOCKET TYPE=IOCTL) with the value
of OPTNAME being one of the following.
retcode = 20 or higher (unless retcode = 300)
The IP address is incorrect. Enter the command • SIOCGHOMEIF6
again with a valid IP address. • SIOCGIFADDR
retcode = 300 • SIOCGIFBRDADDR
The IP address does not meet the specification
for the DEFAULTS.IPV6Env statement in the • SIOCGIFCONF
CNMSTYLE member. For example, an IPv6 • SIOCGIFDSTADDR

298 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables Operator response
address Reenter the command, specifying an appropriate IP
IP address assigned to the TCP/IP interface. address. For the SOCKET command, allocate a socket,
specifying FAMILY=INET6, then try the request again
System action with the original IP address. For RMTCMD, ensure that
the DSIUDST task can obtain sockets in the address
Processing continues. family appropriate for the IP address being used.
BNH801I INTERFACE INDEX IS nnn BNH803I VALUE value1 FOR KEYWORD
keyword1 CONFLICTS WITH
Explanation VALUE value2 FOR KEYWORD
keyword2
This message shows the interface index assigned
to a TCP/IP IPv6 interface. It might be issued
in response to a TCP/IP IOCTL request made by Explanation
the socket interface (SOCKET TYPE=IOCTL) using A command failed because the value of one valid
OPTNAME=SIOCGIFNAMEINDEX. keyword was not compatible with the value of another
Message Variables valid keyword. The keyword could be a CNMSTYLE
statement.
nnn
An index assigned by TCP/IP for an IPv6 interface. Message Variables
value1
System action The value causing the conflict.

Processing continues. keyword1


The keyword whose value is causing the conflict.
BNH802I SOCKET nnn ADDRESS FAMILY value2
IS INCOMPATIBLE WITH IP The other value with which the conflict occurs.
ADDRESS address
keyword2
The other keyword whose value is in conflict.
Explanation
This message indicates that a TCP/IP request was System action
made using an IP address that is incompatible with
the address family in which a socket was allocated. An Processing continues.
example of this is the use of an IP version 6 (IPv6)
address for a request on a socket allocated using Operator response
FAMILY=INET on the SOCKET command.
Correct the command specification and reenter the
Message Variables command. See the NetView online help for the syntax
nnn of the command involved.
If the command was SOCKET, this is the descriptor
number for the socket on which the TCP/IP request System programmer response
was made.
Correct the specified CNMSTYLE statement and ask
If the command was RMTCMD, this is the address the operator to reenter the command.
family of the sockets being used by the DSIUDST
task. BNH804I 'intfc_name' 'intfc_qual'
INTERFACE INITIALIZATION IS
address action
The IP address that was given on the command.
Explanation
System action
When the action is STARTING, the indicated interface
Processing continues. is initializing. When the action is COMPLETE, the
initialization process completed.

Chapter 3. BNH Prefix Messages 299


For the IBM Z NetView Enterprise Management Agent, data space. See the corresponding DWO050E
a Program to Program Interface (PPI) connection is message and reason code in the NetView log.
established with the NetView program. HALT REQUEST
For the ACTIVEACTIVE, DISCOVERY, DVIPA, or TEMA The NACMD command was canceled.
tower, data collection for the specified subtower is INTERNAL ERROR
starting. This is a condition that must not occur within
Message Variables NACMD command processing.
INVALID SYNTAX
intfc_name
A syntax error occurred when the NACMD
This can be one of the following:
command was issued. Either information was
• IBM Z NetView Enterprise Management Agent provided that was not valid or required
• ACTIVEACTIVE, DISCOVERY, DVIPA, or TEMA information was missing.
tower NACMD ALREADY ACTIVE
An NACMD command has already been issued
intfc_qual
for this NetView program.
For the IBM Z NetView Enterprise Management
Agent interface, this is the PPI receiver name for NETVIEW ENTERPRISE MANAGEMENT AGENT
the agent. TERMINATION
The IBM Z NetView Enterprise Management
For the ACTIVEACTIVE, DISCOVERY, DVIPA, or Agent has ended, which causes all data
TEMA tower, this is a subtower. collection for TEMA subtowers to stop.
action NETVIEW ENTERPRISE MANAGEMENT
The action is either STARTING or COMPLETE INTERNAL ERROR
The IBM Z NetView Enterprise Management
BNH805I 'intfc_name' 'intfc_qual''
Agent has ended with an internal error, which
INTERFACE HAS TERMINATED
causes all data collection for TEMA subtowers
DUE TO 'reason'
to stop.
OPERATOR REQUEST
Explanation
The operator requested one of the following
The specified interface has terminated because of the actions:
indicated reason.
• Stop the PPI connectivity between the
Message Variables NetView program and the IBM Z NetView
Enterprise Management Agent.
intfc_name
The interface name. • Stop data collection for a subtower.
intfc_qual • Stop the IBM Z NetView Enterprise
Qualifying information for the interface name. For Management Agent using the NetView
the IBM Z NetView Enterprise Management Agent STOPNA command or the z/OS STOP
interface, this is the PPI receiver name for the command. In this case, the message
agent. For the ACTIVEACTIVE, DISCOVERY, DVIPA includes a reason code of 00000012.
or TEMA tower, this is a subtower. PPI REGISTRATION FAILURE
reason An NACMD command failed to register a
The reason the interface ended, which can be one subnode to the IBM Z NetView Enterprise
of the following reasons: Management Agent.
CNME8202 FAILED PPI SESSION ENDING
The CNME8202 command list was ended by a A PPI session to the IBM Z NetView Enterprise
halt request. Management Agent ended. Look for the
corresponding DWO050E message and the
DATA COLLECTION TASK TERMINATION
reason code in the NetView log. See the
A data collector autotask is no longer active for
DWO050E message help for the appropriate
the specified subtower.
action to take based on the specified reason
DATA SPACE WRITE ERROR codes.
A failure occurred when trying to access the
REXX FAILURE SIGNAL
IBM Z NetView Enterprise Management Agent
A REXX failure occurred with the NACMD
command.

300 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


REXX NOVALUE ERROR 128-132
A REXX no value error occurred with the Internal Error.
NACMD command.
Contact IBM Software Support.
REXX SYNTAX ERROR
A REXX syntax error occurred with the NACMD 204
command. One or more of the following conditions has
occurred:
TEMA TOWER NOT ACTIVE
An NACMD command was issued, but the • The IBM Z NetView Enterprise Management
TEMA tower is not enabled in the CNMSTYLE Agent is inactive.
member. • The agent is active, but the NACMD
rc command was not issued.
Optional reason code. Verify that the agent is active and the NACMD
was issued successfully.
System action 400®+
The NACMD command ends and the connection to The IBM Z NetView Enterprise Management
the agent is disconnected or data collection has Agent data space could not be created. Look
been suspended for a TEMA, DVIPA, or DISCOVERY for the CNM273I message in the NetView
subtower. log or in the RKLVLOG log of the agent to
determine the reason for the failure. Contact
IBM Software Support.
Operator response
INTERNAL ERROR
Reissue the NACMD command if the HALT REQUEST Contact IBM Software Support.
or OPERATOR REQUEST reason is received. If the
INVALID SYNTAX
problem persists, contact the system programmer.
Verify that the NACMD parameters are correct in
the CNMSTYLE member.
System programmer response NACMD ALREADY ACTIVE
Take the appropriate action based on the reason An NACMD command was already issued for
received: this NetView program. If you want to issue the
command with different parameters, stop the
CNME8202 FAILED current NACMD command by using the STOPNA
Browse the NetView log for additional error command. Then issue the NACMD command again.
messages. Contact IBM Software Support.
NETVIEW ENTERPRISE MANAGEMENT AGENT
DATA COLLECTION TASK TERMINATION INTERNAL ERROR
Start the autotask associated with the specified Contact IBM Software Support.
ACTIVEACTIVE, DISCOVERY, DVIPA, or TEMA
subtower again. NETVIEW ENTERPRISE MANAGEMENT AGENT
TERMINATION
DATA SPACE WRITE ERROR If the IBM Z NetView Enterprise Management
The DWO050E message is written to the NetView Agent was stopped by an operator request, start
log when this reason is specified. Look for the the agent again. If the IBM Z NetView Enterprise
reason code in the DWO050E message and take Management Agent ended abnormally, look for
the appropriate action. error messages in syslog or RKLVLOG to determine
104 the reason for the failure. If you cannot resolve the
Internal Error. problem, contact IBM Software Support.
Contact IBM Software Support. PPI REGISTRATION FAILURE
Take the appropriate action as indicated by the
120 reason code. If the reason code is not included
Internal Error. with this message, look for the reason code in the
Contact IBM Software Support. DWO050E message that is written to the NetView
log.
124
NetView storage failure. 00000004
The IBM Z NetView Enterprise Management
Determine which task is using an excessive Agent PPI receiver is not active. Verify that
amount of storage and take action as
appropriate.

Chapter 3. BNH Prefix Messages 301


the NetView subsystem interface (SSI) and the 00000006
agent are active. The NACMD command or the data received
00000022 by the command is not valid. Stop the
Internal Error. current NACMD command and reissue it. If
the problem persists, contact IBM Software
Contact IBM Software Support. Support.
00000023 00000008
Internal Error. Unknown data was received on the local PPI
sender (LCLPPIRV). Stop the current NACMD
Contact IBM Software Support.
command and reissue it. If the problem
00000024 persists, contact IBM Software Support.
The PPI is not available. Verify that the 00000010
NetView subsystem interface (SSI) is active. The IBM Z NetView Enterprise Management
00000026 Agent subnode for this NetView program
The DESTPPI receiver is not defined or is ended. Verify that the agent is active and has
not yet active. Verify that the IBM Z NetView not encountered an abend.
Enterprise Management Agent is active. 00000201
00000028 The primary IBM Z NetView Enterprise
The NetView subsystem interface (SSI) is Management Agent PPI session is not
active, but the PPI option is not enabled. available. Verify that the NetView subsystem
Restart the SSI with the PPI option enabled. interface (SSI) is active with the PPI option
00000032 enabled. If the SSI is inactive, start it.
A NetView storage failure occurred. Determine 00000203
which task is using an excessive amount of A receive failure occurred for the PPI
storage and take action as appropriate. receiver for the IBM Z NetView Enterprise
00000033 Management Agent. Contact IBM Software
Internal Error. Support. Restarting the agent and reissuing the
NACMD command might resolve the problem.
Contact IBM Software Support.
00000204
00000035 The primary PPI session received an unknown
Internal Error. initial command. Contact IBM Software
Support. Stop the current NACMD and reissue
Contact IBM Software Support.
it.
00000040 00000207
Internal Error. A duplicate node name was found. Verify that
Contact IBM Software Support. the NetView programs issuing the NACMD
command have unique domain names.
00000090
Internal Error. 00000209
The PPI name was already defined. Restart the
Contact IBM Software Support. IBM Z NetView Enterprise Management Agent
PPI SESSION ENDING with a unique name.
The DWO050E message is written to the NetView REXX FAILURE SIGNAL
log when this reason is specified. Look for the Contact IBM Software Support.
reason code in the DWO050E message and take REXX NOVALUE ERROR
the appropriate action. Contact IBM Software Support.
00000001 REXX SYNTAX ERROR
The local PPI is not available. The NetView Contact IBM Software Support.
subsystem interface (SSI) might be down. Start
the SSI and try again. TEMA TOWER NOT ACTIVE
The NACMD command was issued, but the TEMA
00000003 tower is not enabled in the CNMSTYLE member.
The local PPI receiver failed. Start the IBM Z Enable the TEMA tower statement and recycle the
NetView Enterprise Management Agent again NetView program.
and reissue the NACMD command.

302 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH806I TAKE ACTION COMMAND • A command response was not received in the
'command' RECEIVED FOR TASK specified time The time to wait on the command
task_name response is specified in the following order:
1. The WAITSECS value on the NACMD, if not nulls.
Explanation 2. The CNMSTYLE.NACMD.WAITSECS variable.
The NetView program received a Take Action 3. The default value of 90 seconds.
command from one of the following sources:
• The command returned no output.
• IBM Z NetView Enterprise Management Agent
Message Variables
• The z/OS product which uses the Tivoli Management
Services infrastructure command
The Take Action command that failed.
This message provides an audit trail of commands
task_name
received by the NetView program.
The task name on which the command was run.
Message Variables
command Operator response
The take action command that was received from If you continue to receive BNH808I messages for IBM
one of the sources listed in the explanation. If the Z NetView Take Action commands, you might have
indicated command contains a sequence number issued an earlier command that is taking a long time
within parentheses, the command came from a to complete. Issue a RESET command to free up the
z/OS product that uses the Tivoli Management operator task on which the time-consuming command
Services infrastructure. For example: is running. If that does not work, issue a RESET IMMED
BNH806I TAKE ACTION COMMAND 'MVS D T command to free up the operator task. If that does not
(00000001)' RECEIVED FOR TASK SYSADMIN work, contact your system programmer.

The sequence number can be used to identify a


particular transaction. System programmer response
task_name Take appropriate actions to stop the time-consuming
The task name on which the command is run. command on the operator task. Stop the operator task
itself, if necessary. Consider increasing the WAITSECS
BNH807I TAKE ACTION RESPONSE SENT value for the NACMD command.
FOR COMMAND 'command' TASK
task_name BNH809I DVIPA DATA IS NOT AVAILABLE
FOR DOMAIN domain
Explanation
Explanation
The NetView program sent a response to the IBM
Z NetView Enterprise Management Agent for a Take A command requesting DVIPA data has been issued,
Action command: but no DVIPA data exists for the indicated domain.
This typically occurs when the DVIPA tower has not
Message Variables been enabled in the CNMSTYLE member.
command Message Variables
The Take Action command for which the response
was sent. domain
The name of the domain that does not contain
task_name
DVIPA data.
The task name on which the command was run.
BNH808I TAKE ACTION COMMAND System action
'command' FAILED FOR TASK
task_name The NetView program ignores the command.

Explanation Operator response


The Take Action command failed to complete. The Verify that the DVIPA tower has been enabled for
reasons for the failure are: the indicated domain by using the TOWER function
or by modifying the CNMSTYLE member. Issue the

Chapter 3. BNH Prefix Messages 303


command again. See IBM Z NetView Installation: !P
Getting Started for information about modifying the The destination protocol is unreachable (IPv4
CNMSTYLE member. only).
BNH810I Tracing IP route to target max hops !Q
hops The destination host is reachable, but cannot
accept the packet because the queue is full (IPv4
only).
Explanation
!R
A command to perform an IP trace route has been No route to destination (IPv6 only).
entered. This is the first line of output indicating the
!S
target host of the route being traced and the maximum
The route supplied for the message was incorrect
number of hops that are allowed in tracing that route.
(IPv4 only).
Message Variables !U
target Address is unreachable (IPv6 only).
The IP address and the host name, if known and
requested, of the target to which the route is being System action
traced.
The command continues unless the target has been
hops reported, in which case the command ends.
The maximum number of hops over which the
route is to be traced. BNH812I command ISSUED FOR task_name
COMPLETED WITH STATUS code
System action
Explanation
The command continues. Output after the completion
of each hop is displayed in turn. The specified command was issued for a task.
This message includes the completion status of the
BNH811I hop: addr (name) tlms t2ms command execution.
t3ms...tnms
Message Variables
Explanation command
The command that was issued.
A command to perform an IP trace route has been
entered and a hop has completed. The IP host found task_name
is reported along with the turnaround times on each The name of the task for which the command was
of the probes sent during the hop. Substitutes for issued.
turnaround times are as follows: • For the ACTVCTL, NACTL, and COLLCTL
Message Variables commands, the task name is a subtower name.

* • For the SOACTL command, the task name is the


Probe timed out. Web Services server name.

!A • For the STOPNA command, the task name is


Administratively prohibited (IPv6 only). either an operator ID or ALL.

!B code
Destination is beyond scope of source address The status code received from the command. The
(IPv6 only). possible status codes are:
!F 0
The packet must be fragmented. The command was successful.
!H 1
The destination host is unreachable. A timer is scheduled to run the command at a
later time.
!N
The destination network is unreachable (IPv4 4
only). The command was not successful.

304 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• If the command issued is STOPNA, the task 214-214
specified on the command was not running Indicates whether the distributed DVIPA port was
the NACMD command. dynamically added to distribution or explicitly
specified on a VIPADISTRIBUTE profile statement.
8
The following values can be specified:
The command was not successful.
1
If the command that is issued is STOPNA, the Indicates that the port was dynamically added
destination PPI receiver (DESTPPI) specified (TRUE).
on the NACMD command is not active.
2
Indicates that the port was explicitly defined
System action (FALSE).
If the command is STOPNA, the NACMD command 216-217
running on the specified task or tasks ends. The value of this object indicates certain attributes
BNH813I NUMBER OF DISTRIBUTED DVIPA of the distribution function for the DVIPA and port.
TARGETS: numtargs The port function value is presented as a 1-byte
hexadecimal number (representing 8 bits) where
the bits are assigned the following meanings and
Explanation bit 0 is the leftmost bit:
This is a multiline message written in response to the Bit 0 (distBaseWlm)
DVIPTARG command. This message consists of one Corresponds to the DISTMETHOD BASEWLM
header line followed by a variable number of data parameter on the VIPADISTRIBUTE profile
lines, each describing a distributed DVIPA target. This statement
message is intended for parsing by a REXX process.
Bit 1 (distRoundRobin)
A REXX sample, CNMSTARG, is provided to format the
Corresponds to the DISTMETHOD
information from this message for readability.
ROUNDROBIN parameter on the
Each data line includes the following information: VIPADISTRIBUTE profile statement
Columns Bit 2 (targetpathInactive)
Description Indicates that the distributor cannot send data
packets to the target stack because there is no
1-45
path to the target stack
The dynamic virtual IP address (DVIPA).
Bit 3 (distServerWlm)
47-51
Corresponds to the DISTMETHOD SERVERWLM
The distributed DVIPA port.
parameter on the VIPADISTRIBUTE profile
53-60 statement
The job name of the application server.
Bit 4 (local)
62-69 Indicates that the local target stack can be
The name of the z/OS image. used for outbound connections unless the local
71-133 target stack cannot process the connection
The TCP/IP host name of the target stack. Bit 5 (distWeightedActive)
135-179 Corresponds to the DISTMETHOD
The dynamic XCF IP address of the target stack. WEIGHTEDACTIVE parameter on the
VIPADISTRIBUTE profile statement.
181-190
The number of servers ready at the port on the Bit 6 (distTargetControlled)
target stack to service the connection requests. Corresponds to the DISTMETHOD
TARGCONTROLLED parameter on the
192-201
VIPADISTRIBUTE profile statement. This
The total number of connections for the dynamic
distribution method can be used only with
virtual IP address and port that have been
tier 1 targets that are not z/OS, such as
distributed to the target stack.
DataPower® appliances.
203-212
The current number of active connections for the Example: The hexadecimal value X'A0'
DVIPA and port that have been distributed to the (B'10100000') indicates that the distBaseWlm and
target stack. targetpathInactive bits are set.

Chapter 3. BNH Prefix Messages 305


219-226 Note: For the preferred server, this value has no
The XCF name used by this TCP/IP stack when meaning.
joining the sysplex.
Message Variables
228-235
The TCP/IP job name. numtargs
The total number of distributed DVIPA targets that
237-240 are displayed in this message.
The MVS address space ID of the address
space that opened the socket. This is a 4-digit
hexadecimal number. System action
242-249 The DVIPTARG command processing is completed.
The name of the sysplex.
BNH814I NUMBER OF APPLICATION
251-254 SERVERS: numserv
The SMF system ID.
256-256 Explanation
Hot standby server type. The server type when the
distribution method is HOTSTANDBY. The following This is a multiline message written in response to
values are valid: the DVIPHLTH command. This message consists of
one header line followed by a variable number of
• Backup (2): Specifies that this server is a backup data lines, each describing an application server that
target. A backup target is initially a hot-standby resides on a distributed DVIPA target stack. This
target. Connections are not distributed to hot- message is intended for parsing by a REXX process.
standby targets. If the active target becomes A REXX sample, CNMSDVPH, is provided to format the
unavailable, the distributor switches targets and information from this message for readability.
one of the hot-standby targets becomes the
active target. Columns
Description
• Preferred (1): Specifies that this server is
the preferred target. If AUTOSWITCHBACK is 1-8
configured, the preferred target is the active The job name of the application server.
target if it is available and has had no 10-54
health problems. If the active target becomes The dynamic virtual IP address (DVIPA).
unavailable, the distributor switches to a hot- 56-60
standby target, the active target becomes a hot- The DVIPA port.
standby target, and the selected hot-standby
target becomes the active target. 62-106
The dynamic XCF IP address of the target stack.
This data is available with z/OS V1R12
108-115
Communications Server or later.
The name of the z/OS image on which the target
258-258 stack resides.
Hot standby server status. The server status when
117-119
the distribution method is HOTSTANDBY. The
The health indicator of the server application on
following values are valid:
the target port. If several server applications share
• Backup (0): Specifies that this is currently a the port, it is the average of the individual values
backup (hot-standby) server. for all the server applications sharing the port. Any
• Active (1): Specifies that this is currently the value less than 100 percent indicates that one or
active server. more of the servers has problems.
121-130
This data is available with z/OS V1R12
The Workload Manager weight value for either the
Communications Server or later.
MVS system on which the target stack is located,
260-262 or for the specific server on the target stack.
Hot standby rank. When the distribution method is
132-134
HOTSTANDBY, an indication of the backup target
The percent of abnormal transaction completions
that is selected if the preferred target becomes
for the server application on the target port or the
unavailable. The backup target with the highest
average of the individual values for all the server
rank is used. Valid values are in the range 1-254;
applications sharing the port.
the default value is 1. This data is available with
z/OS V1R12 Communications Server or later.

306 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


136-138 176-178
The target server responsiveness rate for the The raw zIIP value modified by the proportion of
target server. The sysplex distributor monitors zIIP capacity that is currently being consumed by
the ability of a target server to process new the workload of the application as compared to the
connections. At each interval of approximately other processors (CP and zAAP).
one minute, the sysplex distributor generates a 180-189
target server responsiveness fraction percentage When the distribution method is weightedActive,
to indicate how well the server is accepting new this is the weight used by the distributor to
TCP connection setup requests. This value is not determine the proportion of active connections on
a measure of how well the server is servicing the this target.
connections.
191-198
140-142 The TCP/IP job name.
Target Connectivity Success Rate. This value is a
measure of the percentage of connection setup 200-207
requests routed from the distributor that are The name of the sysplex.
successfully received by the target for this server. 209-212
It is displayed as a percentage. The SMF system ID.
144-146 Message Variables
The Server Accept Efficiency Fraction. This value is
a measure, calculated at intervals of approximately numserv
one minute, that indicates the efficiency of the The number of application servers residing on
server application in accepting new connection distributed DVIPA target stacks that are displayed
requests and managing the backlog queue. This in this message.
value is displayed as a percentage.
148-150 System action
The Connection Establishment Rate. This value is The DVIPHLTH command processing is completed.
a measure of the percentage of the connection
setup requests received at the target that achieve BNH815I NUMBER OF DISTRIBUTED DVIPA
completion with the client, that is, arrive at the CONNECTION ROUTES: numroutes
connection established state. It is displayed as a
percentage. Explanation
152-154
This is a multiline message written in response to the
The raw composite weight for this application
DVIPDDCR command. This message consists of one
server. The composite weight is based on the
header line followed by a variable number of data
General CPU, zAAP, and zIIP processor utilization
lines, each describing a distributed DVIPA connection
of the application.
route. This message is intended for parsing by a REXX
156-158 process. A REXX sample, CNMSDDCR, is provided
The raw WLM general CP weight for this to format the information from this message for
application server. readability.
160-162 Columns
The raw WLM zAAP weight for this application Description
server.
1-45
164-166 The IP address of the source TCP/IP stack.
The raw WLM zIIP weight for this application
47-51
server.
The port number of the source TCP/IP stack (right-
168-170 aligned with leading zeros omitted).
The raw CP value modified by the proportion of
53-97
CP capacity that is currently being consumed by
The IP address of the target TCP/IP stack.
the workload of the application as compared to the
other processors (zAAP and zIIP). 99-103
The port number of the target TCP/IP stack (right-
172-174
aligned with leading zeros omitted).
The raw zAAP value modified by the proportion of
zAAP capacity that is currently being consumed by 105-149
the workload of the application as compared to the The dynamic XCF IP address of the target TCP/IP
other processors (CP and zIIP). stack.

Chapter 3. BNH Prefix Messages 307


151-154 BNH820E INVALID IP ADDRESS ipaddr
The configured timed affinity. The affinity value SPECIFIED
that is defined in the TIMEDAFFINITY parameter
on the VIPADISTRIBUTE TCP/IP profile statement.
Explanation
The TIMEDAFFINITY parameter indicates to the
sysplex distributor that connections to a particular The IP address ipaddr that was provided is not a valid
distributed DVIPA from the same client, as IPv4 address.
identified by the IP address, must be routed to the
Message Variables
same server instance, even when multiple server
instances are on a single target stack. ipaddr
156-159 The IP address that was provided.
The remaining timed affinity (in seconds).
161-170 System action
The number of currently established connections The operation fails.
associated with the Configured Time Affinity
attribute.
Operator response
172-187
The name of the IPv4 or IPv6 interface associated Enter a valid IPv4 address.
with the IP address.
BNH821I AT-TLS CONNECTION STATUS:
189-233 X'connection-status'
The gateway IP address.
235-236 Explanation
An indication of whether the VIPAROUTE
parameter is being used to route packets to the The Application Transparent Transport Layer Security
target stack for this connection. The value is a (AT-TLS) connection status value is displayed. See the
1-byte hexadecimal number where bit 0 is the z/OS Communications Server IP Programmer's Guide
leftmost bit and the bits have the following values: and Reference for more information about AT-TLS.

• Bit 0 (Yes): Indicates that the best available Message Variables


route, based on the VIPAROUTE parameters, is connection-status
being used to distribute packets to the target The following can be the status:
stack.
X'01'
• Bit 1 (No): Indicates that the dynamic XCF Connection not secure
interface is being used to distribute packets to
the target stack. X'02'
Handshake in progress
• Bit 2 (Unavailable): Indicates that the TCP/IP
stack attempted to use the route based on X'03'
the VIPAROUTE parameters but, because an Connection is secure
error was detected during VIPAROUTE statement
validation, the dynamic XCF interface is being System action
used to distribute packets to the target stack.
The command successfully completed.
• Bit >2: If bits greater than 2 are set, see z/OS
Communications Server documentation for more BNH822I AT-TLS POLICY STATUS: X'policy-
information. status'
238-241
The SMF system ID. Explanation
Message Variables The Application Transparent Transport Layer Security
(AT-TLS) policy status value is displayed. See the z/OS
numroutes Communications Server IP Programmer's Guide and
The number of distributed DVIPA connection Reference for more information about AT-TLS.
routes displayed in this message.
Message Variables
System action policy-status
The following can be the status:
The DVIPDDCR command processing is completed.

308 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


X'01' Each data line includes the following information:
AT-TLS not active Columns
X'02' Description
AT-TLS policy not found
1-45
X'03' The dynamic XCF IP address of the target TCP/IP
AT-TLS policy not enabled stack.
X'04' 47-91
AT-TLS policy enabled The IP address of the target TCP/IP stack.
X'05' 93-95
AT-TLS is enabled and application-controllable The VIPAROUTE status.
• 1: Defined
System action
• 2: Unavailable
The command successfully completed. • 3: Active
BNH823I AT-TLS ENCRYPTION PROTOCOL: • 4: Inactive
X'protocol' • >4: If bits greater than 4 are set, see z/OS
Communications Server documentation for more
Explanation information.
The Application Transparent Transport Layer Security 97-100
(AT-TLS) encryption value in use by this connection The SMF system ID of the system where the DVIPA
is displayed. See the z/OS Communications Server is configured.
IP Programmer's Guide and Reference for more
Message Variables
information about AT-TLS.
numvipa
Message Variables
The number of VIPA routes that are displayed in
protocol this message.
The following can be the type of encryption used
by this connection: System action
X'0000'
The VIPAROUT command processing is completed.
Unknown
X'0200' BNH825I THE AT-TLS SECURITY TYPE IS
SSLv2 X'security_type'.
X'0300'
SSLv3 Explanation
X'0301' The Application Transparent Transport Layer Security
TLSv1 (AT-TLS) policy security type value is displayed.
For more information about AT-TLS, see the z/OS
System action Communications Server: IP Programmer's Guide and
Reference.
The command successfully completed.
Message Variables
BNH824I NUMBER OF VIPA ROUTES:
security_type
numvipa
The type of security, as follows:
01
Explanation Client
This is a multiline message written in response to 02
the VIPAROUT command. This message consists of Server
one header line followed by a variable number of
data lines, each describing a VIPA route and its 03
status. This message is intended for parsing by a Server with client authentication,
REXX process. For readability, the CNMSVPRT REXX ClientAuthType=PassThru
sample is provided to format the information from this
message.

Chapter 3. BNH Prefix Messages 309


04 command revision tables contain a limited number of
Server with client authentication, non-text output orders.
ClientAuthType=Full
05 System action
Server with client authentication,
ClientAuthType=Required The command fails.

06
Server with client authentication, Operator response
ClientAuthType=SAFCheck Correct the indicated statement.
BNH834I insert1 insert2 insert3 insert4
System action insert5 insert6 insert7
The command completed successfully.
BNH829E AT-TLS POLICY X'policy-status' Explanation
NOT SUPPORTED This message is a data line of a multiline display.
Message Variables
Explanation
If the NACTL LISTCONN command was issued, the
The Application Transparent Transport Layer Security following values are displayed in this message:
(AT-TLS) connection was established using encryption,
but the policy is not supported by the NetView insert1
program. The supported policy status values are in the The name of the NetView operator task on which
range X'01' to X'04'. the NACMD command was issued.

Message Variables If the SOACTL LSTSRVRS command was issued,


this is the name of the Web Services server.
policy-status
The type of policy that is unsupported. insert2
The status of the Program to Program Interface
(PPI) connection to the IBM Z NetView Enterprise
System action Management Agent.
The connection was not successfully established. If the SOACTL LSTSRVRS command was issued,
this is the status of the Web Services server.
Operator response insert3
Contact the system programmer. The system leaf name for your NetView program
that is displayed in the Tivoli Enterprise Portal
Navigator tree under the NetView product leaf.
System programmer response This defaults to the NetView domain. If the
Check the AT-TLS policy definitions. Policy Status NACMD.SUBNODE statement in CNMSTYLE or an
codes are found in the z/OS SEZANMAC data set. included member has been coded, this value is
See the z/OS Communications Server IP Programmer's used. Only the first eight characters of the value
Guide and Reference for more information about are displayed.
SIOCTTLSCTL. insert4
BNH830I ONE OR MORE SPECIFIED The PPI receiver name of the IBM Z NetView
OUTPUT ORDERS ARE Enterprise Management Agent.
NOT SUPPORTED IN THIS insert5
ENVIRONMENT The PPI receiver name on which the NACMD
command receives Take Action commands and
data from the IBM Z NetView Enterprise
Explanation
Management Agent.
An output order other than NEXT, NEX2RD, or
Note: Dashes appear in this message as inserts.
a numeric character position was specified in an
environment that supports only text strings. Such BNH835I DISPLAY OF MAPPED TIVOLI
environments include WHEN statements in message ENTERPRISE PORTAL USER IDS
or command revision tables, and WTO statements
in command revision tables. REVISE statements in

310 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
This is the first line of a multiline message which lists This message is issued when the TESTPORT command
the mapping of Tivoli Enterprise Portal user IDs to successfully connects to a port. If TESTPORT was
NetView operator IDs. The mapping is defined in the issued from a timer, the timer is reset to the next
CNMSTYLE member with the NACMD.OPID statement. interval.
BNH836I TIVOLI ENTERPRISE PORTAL Message Variables
USER ID NETVIEW OPERATOR ID portnum
The port that is monitored.
Explanation host
This is the second line of a multiline message which The host device that is monitored.
lists the mapping of Tivoli Enterprise Portal user IDs to BNH840W SOCKET ERROR OCCURRED
NetView operator IDs. DURING IPPORTMON
BNH837I insert1 insert2 PROCESSING

Explanation Explanation
This message is a data line of a multiline display. This message is issued when the TESTPORT command
encounters an internal socket command failure. If
Message Variables TESTPORT was issued from a timer, the timer is reset
If the NACTL LISTOPID command was issued, the to the next interval.
following values are displayed in this message:
insert1 System programmer response
This the Tivoli Enterprise Portal user ID that is Check the logs for error messages, determine the
mapped to a NetView operator ID. reason for the failure, and take any corrective actions.
insert2
BNH841E parm PARAMETER MISSING FROM
This is the mapped NetView operator ID.
IPPORTMON DEFINITIONS
Note: Dashes appear in this message as inserts.
BNH838W PORT portnum ON HOST host IS Explanation
NOT RESPONDING The indicated parameter is missing.
Message Variables
Explanation
parm
This message is issued when the TESTPORT command
The parameter to be processed.
cannot open a connection to the specified host and
port. If TESTPORT was issued from a timer, the timer is
reset to the next interval. System action
Message Variables The TESTPORT command continues and processes all
complete definitions.
portnum
The port that is monitored.
System programmer response
host
The host device that is monitored. Add the missing parameter and then reissue the
TESTPORT command for the host or port definition
System programmer response that was in error.

Investigate to see whether the port must be recycled. BNH842I NO IPPORTMON DEFINITIONS
FOUND
BNH839I PORT portnum ON HOST host IS
ACTIVE
Explanation
The TESTPORT command was issued with no input
parameters and no variables were found to process.

Chapter 3. BNH Prefix Messages 311


System programmer response 143-158
The primary interface. The link name that is
Update the CNMSTYLE member with the appropriate designated as the default local host for use by the
variables or reissue the TESTPORT command with GETHOSTID() function. This value applies only to
input parameters. See IBM Z NetView Installation: IPv4 links.
Getting Started for information about updating the
CNMSTYLE member. 160-160
IPv6 Enabled indicator. A value of 1 indicates that
BNH843I NO DUPLICATE ENTRIES FOUND the stack is IPv6 enabled. A value of 2 indicates
IN FILE file the stack is not IPv6 enabled.
162-162
Explanation IPSec Enabled indicator. A value of 1 indicates that
the stack has an IP security policy defined and
The indicated policy file does not contain duplicate
active. A value of 2 indicates that the stack does
entries.
not have an IP security policy defined and enabled.
BNH844W FILE file HAS DUPLICATE ENTRIES 164-164
AT-TLS Enabled indicator. A value of 1 indicates
Explanation that the stack has a policy defined and active for
the application transparent transport layer security
The indicated policy file contains duplicate entries. (AT-TLS) protocol. A value of 2 indicates that the
BNH845I NUMBER OF STACKS: numstack stack does not have a policy defined and enabled
for the AT-TLS protocol.

Explanation 166-170
The z/OS version and release level in the form:
This is a multiline message written in response to VxRy
the STACSTAT command. This message consists of 172-175
one header line followed by a variable number of The SMF system ID.
data lines, each describing stack configuration and
status. This message is intended for parsing by a 177-184
REXX process. A REXX sample, CNMSSTAC, is provided The LPAR name.
to format the information from this message for 186-193
readability. The VTAM XCF group name.
Each data line includes the following information: 195-239
The IP address.
Columns
Description 241-241
Source VIPA Enabled indicator. An indication
1-9
that SOURCEVIPA support is enabled. When
Blanks (because of the removal of an obsolete
this support is enabled, TCP/IP uses the
field).
TCPSTACKSOURCEVIPA address (if specified) or
10-17 the corresponding virtual IP address in the HOME
The TCP/IP job name. list as the source IP address for outbound data
19-81 grams that do not have an explicit source address.
The TCP/IP short host name. A value of 1 indicates that this indicator is enabled
for this stack.
83-114
The status of the stack as reported by the z/OS 243-243
Communications Server. Source VIPAV6 Enabled indicator. An indication
that SOURCEVIPA support is enabled for IPv6. A
116-123
value of 1 indicates that this indicator is enabled
The name of the sysplex in which the stack is
for IPV6 for this stack.
active.
245-245
125-132
Specifies whether TCP/IP uses a stack-level IPv4
The XCF group name used by the stack when
address as the source address for outbound TCP
joining the sysplex.
connections.
134-141
The z/OS image name by which it knows itself.

312 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


247-247 Note: Any field that has a value of --- does not
Specifies whether TCP/IP uses a stack-level IPv6 apply to the DISPLAY option that was specified on the
address as the source address for outbound TCP DVIPSTAT command.
connections.
Columns
249-249 Description
An indication that SEGMENTATIONOFFLOAD
1-45
support is enabled. When this support is enabled,
The dynamic virtual IP address (DVIPA).
the stack offloads TCP segmentation to OSA-
Express features. Valid values are Yes and No. 47-54
The name of the sysplex in which the DVIPA is
251-251
active.
An indication that ZIIP IPSECURITY support is
enabled. When this support is enabled, CPU cycles 56-63
for IPSec workload to a zIIP should be displaced The XCF group name used by the stack when
when possible. Valid values are Yes and No. joining the sysplex.
253-255 65-72
The amount of time, in seconds, that determines The z/OS image name by which it knows itself.
how quickly the sysplex distributor and the target 74-136
servers of the sysplex distributor poll WLM for The TCP/IP short host name.
new weight values. A non-zero value indicates
138-145
that SYSPLEXWLMPOLL support is enabled. A short
The TCP/IP job name.
time results in quicker reactions to target status
changes. A valid value is 1 - 180 seconds. The 147-149
default value is 60. An indication of how the DVIPA was configured to
the TCP/IP stack. The following values are valid:
257-257
IPSecV6 Enabled indicator. An indication that the • unknown (1): An error occurred.
stack can have an IPv6 security policy defined and • backup (2): The VIPADYNAMIC VIPABACKUP
active. A value of 1 indicates that this indicator is TCP/IP profile statement was used to configure
enabled for IPv6. the given TCP/IP stack as a backup for the
Message Variables DVIPA.
numstack • define (3): The VIPADYNAMIC VIPADEFINE
The total number of TCP/IP stacks known to this TCP/IP profile statement was used to configure
NetView program. the given TCP/IP stack as the owner of the
DVIPA.

System action • rangeBind (4): The DVIPA was dynamically


defined when an application issued a BIND
The STACSTAT command processing is completed. function call.
BNH846I NUMBER OF DVIPA DEFINITIONS: • rangeIoctl (5): The DVIPA was dynamically
numdvipa defined when an application issued the
SIOCSVIPA IOCTL function call.
Explanation • target (6): The DVIPA was dynamically defined
on the stack because this stack is a target stack
This is a multiline message written in response to for the sysplex distributor function.
the DVIPSTAT command, for an application instance,
• >6: See z/OS Communications Server
and stack defined DVIPA. This message consists
documentation for more information.
of one header line followed by a variable number
of data lines, each describing DVIPA definition and 151-153
status information for all DVIPAs, application instance The status of the DVIPA on the given TCP/IP stack.
DVIPAs, or stack-defined DVIPAs for the system. This The following values are valid:
message is intended for parsing by a REXX process.
• unknown (1): An error occurred.
A REXX sample, CNMSDVIP, is provided to format the
information from this message for readability. • active (2): The DVIPA is active.
Each data line includes the following information. • backup (3): The given TCP/IP stack is currently a
backup owner for the DVIPA.

Chapter 3. BNH Prefix Messages 313


• moving (4): The DVIPA was active for the • none (1): Moveable status does not apply to
TCP/IP stack but the ownership transferred to the DVIPA. This value is used for entries where
another TCP/IP stack (for example, because of a backup is specified for the Origin and Status
takeover). fields.
• quiescing (5): The DVIPA is no longer a target • immediate (2): This DVIPA can be moved to
but still has connections. When all existing another stack as soon as the other stack
connections are closed, the status changes to requests ownership.
"deactivated" • whenIdle (3): This DVIPA can be moved to
• deactivated (6): The another stack when it has no connections on the
VARY,,TCPIP,SYSPLEX,DEACTIVATE command current stack.
was run for this DVIPA. The • nonDisruptive (4): This DVIPA can be moved
DVIPA remains deactivated until a to another stack as soon as the other stack
VARY,,TCPIP,SYSPLEX,REACTIVATE command is requests ownership. Existing connections are
run for this DVIPA. maintained by the new stack until they are
• deactLeavegroup (7): The closed, and new connection requests are
VARY,,TCPIP,SYSPLEX,DEACTIVATE command directed to the new stack.
was run for this DVIPA. and the • disruptive (5): Either this DVIPA is not moved to
VARY,,TCPIP,SYSPLEX,LEAVEGROUP command another stack, or it is moved and the existing
was run for this stack. If the stack connections are broken.
rejoins the sysplex group before a
VARY,,TCPIP,SYSPLEX,REACTIVATE command is • >5: See z/OS Communications Server
run for this DVIPA, this DVIPA remains documentation for more information.
deactivated and the DVIPA status changes to 170-172
deactivated. The status of the DVIPA on the given TCP/IP stack
• deactAutonomics (8): The in relation to the sysplex distributor function. The
VARY,,TCPIP,SYSPLEX,DEACTIVATE command following values are valid:
was run for this DVIPA and the stack left the • none (1): The DVIPA is not participating in a
sysplex group because of an error condition sysplex distributor function.
detected by the sysplex autonomics function.
If the stack rejoins the sysplex group before • distributor (2): The stack is a sysplex distributor
a VARY,,TCPIP,SYSPLEX,REACTIVATE command for the DVIPA.
is run for this DVIPA, this DVIPA remains • target (3): The stack is a target stack for the
deactivated and the DVIPA status changes to DVIPA.
deactivated. • distributorAndTarget (4): The stack is both a
• inactLeavegroup (9): The sysplex distributor and a target stack for the
VARY,,TCPIP,SYSPLEX,LEAVEGROUP command DVIPA.
was run for this stack, and the DVIPA is • >4: See z/OS Communications Server
currently inactive. The DVIPA is reactivated if a documentation for more information.
VARY,,TCPIP,SYSPLEX,JOINGROUP command is
run for this stack. 174-176
The status of this DVIPA on the stack in relation to
• inactAutonomics (10): The stack left the sysplex
the Service Manager function. The following values
group because of an error condition detected by
are valid:
the sysplex autonomics function.
1
• >10: See z/OS Communications Server
Indicates that the DVIPA is participating in the
documentation for more information.
Service Manager function (TRUE)
155-164 2
The rank of this stack in the chain of backup stacks Indicates that the DVIPA is not participating in
for a given DVIPA. the Service Manager function (FALSE)
Note: For entries whose Origin value is not 178-193
backup(2) or define(3), this value is set to -1. The name of the IPv4 or IPv6 interface.
166-168 195-198
An indication of how a DVIPA can be moved to The SMF system ID.
another TCP/IP stack. The following values are
valid:

314 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


200-207 47-51
The LPAR name. The distributed DVIPA port.
209-216 53-60
The NetView domain that reported the DVIPA. The name of the sysplex in which the distributed
218-225 DVIPA is active.
The date and time that the DVIPA was activated, 62-69
formatted as an eight-character binary store-clock The XCF group name used by the stack when
value. This value can be converted into a printable joining the sysplex.
format using the PIPE EDIT command. 71-78
227-234 The z/OS image name by which it knows itself.
The job name of the application server, if this is an 80-142
application instance DVIPA. The TCP/IP short host name.
236-238 144-151
Indicates whether a DVIPA with an origin of The TCP/IP job name.
VIPARANGE IOCTL was created for z/OS Container
Extensions. 153-162
The number of target stacks with servers ready
0 to service connection requests (right-aligned- with
The DVIPA was not created by z/OS Container leading zeros omitted).
Extensions.
164-173
1 The number of servers ready across all the
The DVIPA was created by z/OS Container target stacks to service connection requests (right-
Extensions. aligned- with leading zeros omitted).
-1 175-219
z/OS Communications Server V2.4 or later is The dynamic XCF IP address of the local stack. If
required for the z/OS Container Extensions DESTIP ALL was specified on the VIPADISTRIBUTE
function. profile statement, this field is set to blanks.
Message Variables 221-223
The method of distribution used for incoming
numdvipa
connection requests. The following values are
The total number of DVIPA definitions known to
valid:
this NetView program.
• baseWlm (1): Workload Manager (WLM) and
System action policy information are used to determine the
distribution.
The DVIPSTAT command processing is completed.
• roundRobin (2): WLM and policy information
BNH847I NUMBER OF DVIPA SYSPLEX are ignored and requests are distributed in a
DISTRIBUTORS: numdist round-robin fashion among the existing server
instances.
Explanation • serverWlm (3): Server-specific WLM and policy
information is used to determine distribution.
This is a multiline message written in response to
the DVIPPLEX command. This message consists of • weightedActive (4): WLM and policy information
one header line followed by a variable number of are not used to determine how to route
data lines, each describing a sysplex distributor. This future incoming connection requests for this
message is intended for parsing by a REXX process. distributed DVIPA. Instead, distribution of
A REXX sample, CNMSPLEX, is provided to format the incoming TCP connection requests is balanced
information from this message for readability. across the targets such that the number of active
connections on each target is proportionally
Each data line includes the following information: equivalent to a configured active connection
Columns weight for each target (specified on the DESTIP
Description parameter of each target).
1-45 • targetControlled (5): Incoming connection
The distributed dynamic virtual IP address requests are distributed using weights provided
(DVIPA). by the Tier 1 targets. This distribution method
can be used only with tier 1 targets, such as

Chapter 3. BNH Prefix Messages 315


DataPower appliances, that are not z/OS tier 1 • quiescing (5): The DVIPA is no longer a target
targets. but still has connections. When all existing
• hotStandby(6): One preferred target and at least connections are closed, the status changes to
one hot-standby target are configured. This "deactivated"..
distribution method is available with z/OS V1R12 • deactivated (6): The
Communications Server or later. VARY,,TCPIP,SYSPLEX,DEACTIVATE command
• >6: See z/OS Communications Server was run for this DVIPA. The
documentation for more information. DVIPA remains deactivated until a
VARY,,TCPIP,SYSPLEX,REACTIVATE command is
225-228 run for this DVIPA.
The duration in seconds for which the Sysplex
• deactLeavegroup (7): The
Distributor function maintains an affinity between
VARY,,TCPIP,SYSPLEX,DEACTIVATE command
connections from a specific client (as identified
was run for this DVIPA. and the
by source IP address) and a server instance on a
VARY,,TCPIP,SYSPLEX,LEAVEGROUP command
target stack.
was run for this stack. If the stack
230-230 rejoins the sysplex group before a
Indicates whether sysplex-wide ephemeral port VARY,,TCPIP,SYSPLEX,REACTIVATE command is
assignment is enabled for the distributed DVIPA. run for this DVIPA, this DVIPA remains
Following are the values: deactivated and the DVIPA status changes to
1 deactivated.
Indicates that the function is enabled (TRUE) • deactAutonomics (8): The
2 VARY,,TCPIP,SYSPLEX,DEACTIVATE command
Indicates that the function is disabled (FALSE) was run for this DVIPA and the stack left the
sysplex group because of an error condition
232-234 detected by the sysplex autonomics function.
Indicates whether TCP/IP target stacks should If the stack rejoins the sysplex group before
bypass sending connection requests for this a VARY,,TCPIP,SYSPLEX,REACTIVATE command
distributed DVIPA to the Sysplex Distributor stack is run for this DVIPA, this DVIPA remains
when a server application is available on the target deactivated and the DVIPA status changes to
stack. A value of -1 indicates that the target stack deactivated.
should send the connection request to the Sysplex
Distributor stack. This value corresponds to the • inactLeavegroup (9): The
NOOPTLOCAL parameter on the VIPADISTRIBUTE VARY,,TCPIP,SYSPLEX,LEAVEGROUP command
profile statement. A value of 0 to 16 indicates was run for this stack, and the DVIPA is
that the target stack should bypass sending the currently inactive. The DVIPA is reactivated if a
connection request to the Sysplex Distributor VARY,,TCPIP,SYSPLEX,JOINGROUP command is
stack, if possible, and influences the decision run for this stack.
process of the target stack. • inactAutonomics (10): The stack left the sysplex
236-239 group because of an error condition detected by
The SMF system ID. the sysplex autonomics function.

241-248 • >10: See z/OS Communications Server


The LPAR name. documentation for more information.

250-252 254-263
The status of the DVIPA on the given TCP/IP stack. The rank of this stack in the chain of backup stacks
The following values are valid: for a given DVIPA.

• unknown (1): An error occurred. For entries whose Origin value is not backup (2) or
define (3), this value is set to -1.
• active (2): The DVIPA is active.
• backup (3): The given TCP/IP stack is currently a 265-267
backup owner for the DVIPA. An indication of how a DVIPA can be moved to
another TCP/IP stack. The following values are
• moving (4): The DVIPA was active for the valid:
TCP/IP stack but the ownership transferred to
another TCP/IP stack (for example, because of a • none (1): Moveable status does not apply to
takeover). the DVIPA. This value is used for entries where
backup is specified for the Origin and Status
fields.

316 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• immediate (2): This DVIPA can be moved to 298-300
another stack as soon as the other stack When serverWlm is specified as the method
requests ownership. of distribution, this specifies the crossover cost
• whenIdle (3): This DVIPA can be moved to of running the targeted zAAP workload on
another stack when it has no connections on the a conventional processor instead of the zIIP
current stack. processor.

• nonDisruptive (4): This DVIPA can be moved 302-304


to another stack as soon as the other stack When serverWlm is specified as the method
requests ownership. Existing connections are of distribution, this specifies the weighting
maintained by the new stack until they are factor used by z/OS Workload Manager (WLM)
closed, and new connection requests are when comparing displaceable capacity at
directed to the new stack. different importance levels. This factors into the
SERVERWLM recommendation for each system.
• disruptive (5): Either this DVIPA is not moved to The following values are valid:
another stack, or it is moved and the existing
connections are broken. 0
Indicates WLM ignores importance levels
• >5: See z/OS Communications Server
documentation for more information. 1
Indicates WLM uses a weighting factor that
269-278 grows proportionally to the square root of the
The number of configured target TCP/IP stacks. importance level plus one
The number is right-aligned with leading zeros
2
omitted. For distributors with DESTIP=ALL defined,
Indicates WLM uses a weighting factor that
this value does not apply and is set to N/A (not
grows proportionally to the importance level
applicable).
plus one
280-280
3
An indication of whether the DESTIP ALL
Indicates WLM uses a weighting factor that
parameter is specified on the VIPADISTRIBUTE
grows proportionally to the square of the
statement. The following values are valid:
importance level plus one
0
>3
Indicates that the DESTIP ALL parameter is not
See z/OS Communications Server
specified (FALSE)
documentation for more information.
1
306-321
Indicates that the DESTIP ALL parameter is
The name of the IPv4 or IPv6 interface.
specified (TRUE)
323-327
282-284
The z/OS release level.
When baseWlm is specified as the method of
distribution, this specifies the proportion of the 329-329
workload that is expected to use conventional Auto switch back. An indication of whether
processors. the AUTOSWITCHBACK or NOAUTOSWITCHBACK
option for the HOTSTANDBY distribution method is
286-288
specified on the VIPADISTRIBUTE statement. The
When baseWlm is specified as the method of
following values are valid:
distribution, this specifies the proportion of the
workload that is expected to use zAAP processors. • No (0): Specifies that the distributor does not
290-292 switch back to the preferred target when it
When baseWlm is specified as the method of becomes available.
distribution, this specifies the proportion of the • Yes (1): Specifies that the distributor
workload that is expected to use zIIP processors. automatically switches distribution back to the
294-296 preferred target when the preferred target
When serverWlm is specified as the method becomes available.
of distribution, this specifies the crossover cost 331-331
of running the targeted zAAP workload on a Health switch. An indication of whether the
conventional processor instead of the zAAP HEALTHSWITCH or NOHEALTHSWITCH option for
processor. the HOTSTANDBY distribution method is specified

Chapter 3. BNH Prefix Messages 317


on the VIPADISTRIBUTE statement. The following 168-175
values are valid: The hexadecimal representation of the Connection
ID.
• No (0): Specifies that the distributor ignores
health metrics and switches from the active 177-184
target only if the target is not ready or if the The text identification of this resource. It
distributor does not have an active route to the represents the user who opened the socket and
target. is updated again during the bind processing.
• Yes (1): Specifies that the distributor 186-248
automatically switches from the active target if The TCP/IP host name that was discovered for the
the target is not healthy. TCP/IP job name.

Message Variables 250-257


For connections underlying TN3270 sessions, this
numdist is the SNA application name.
The total number of distributed DVIPA distributors
259-266
known to this NetView program.
For connections underlying TN3270 sessions, this
is the LU name.
System action 268-271
The DVIPPLEX command processing is completed. The SMF ID.

BNH849I NUMBER OF DVIPA 273-280


CONNECTIONS: numconns The date and time that the connection started,
formatted as an 8-character binary store-clock
value. This value can be converted into a printable
Explanation format using the PIPE EDIT command.
This message is a multiline message written in 282-289
response to the DVIPCONN command. This message The TCP/IP job name for which a connection
consists of one header line followed by a variable endpoint is found.
number of data lines, each describing a DVIPA 291-298
connection. This message is intended for parsing The date and time of the last activity on this
by a REXX process. A REXX sample, CNMSDVPC, is connection, formatted as an 8-character binary
provided to format the information from this message store-clock value. This value can be converted into
for readability. a printable format using the PIPE EDIT command.
Each data line includes the following information: 300-304
Columns The total number of segments retransmitted over
Description this connection since the connection started (right-
aligned, with leading zeros omitted).
1-45
The dynamic virtual IP address (DVIPA). 306-308
The percent of TCP segments that were
47-51
retransmitted over this connection since the
The DVIPA port.
connection started (right-aligned, with leading
53-97 zeros omitted).
The remote IP address for this connection.
310-329
99-103 The total number of segments that were received
The remote port for this connection. over this connection since the connection started
105-124 (right-aligned, with leading zeros omitted).
The number of bytes received over this connection 331-350
since the connection started. The total number of segments that were sent over
126-145 this connection since the connection started (right-
The number of bytes sent over this connection aligned, with leading zeros omitted).
since the connection started. 352-371
147-166 The total number of segments that were sent and
The total number of bytes sent and received over received over this connection since the connection
this connection since the connection started. started (right-aligned, with leading zeros omitted).

318 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


373-376 1
The connection state (right-aligned, with leading Local end issued connect
zeros omitted). The meanings are as follows. The 426-441
first 11 are defined by TCP/IP; in the last case,
The interface name.
z/OS Communications Server is in the process of
deleting and cleaning up the TCB. 443-450
The z/OS image name.
1
CLOSED 452-455
The 4-digit hexadecimal identification of the
2 address space (ASID) that established the
LISTENING connection.
3 457-464
SYN_SENT The 8-digit hexadecimal representation of the TCB
4 address of the local owner task.
SYN_RECEIVED 466-473
5 The TN3270 user client name.
ESTABLISHED 475-482
6 The TN3270 logmode name.
FIN_WAIT_1 484-491
7 The protocol indicator (LINEMODE, TN3270,
FIN_WAIT_2 TN3270E, or N/A).
8 493-495
CLOSE_WAIT The AT-TLS policy status (right-aligned, with
9 leading zeros omitted). The meanings, defined by
LAST_ACK the z/OS Communications Server, are as follows:

10 0
CLOSING Unknown
11 1
TIME_WAIT Off
12 2
DELETE_TCB No matching rule was found

378-387 3
The most recent timestamp value, in milliseconds, Matching rule indicates that AT-TLS is not used
received from the remote side of the connection. 4
389-398 AT-TLS is enabled for this connection, but
The time, in milliseconds, when the previous field application control has not been granted
was updated. 5
400-407 AT-TLS is enabled and is application-
The maximum send window size (right-aligned, controllable
with leading zeros omitted). 497-499
409-416 The AT-TLS connection status (right-aligned, with
The current send window size (right-aligned, with leading zeros omitted). The meanings, defined by
leading zeros omitted). the z/OS Communications Server, are as follows:
418-422 1
The number of duplicate acknowledgments (right- Connection does not have a secure session
aligned, with leading zeros omitted). established
424-424 2
Whether the local or remote end connected. The Connection initial handshake in progress
following values are valid: 3
0 Connection has a secure session
Remote end issued connect

Chapter 3. BNH Prefix Messages 319


501-504 System action
The hexadecimal AT-TLS SSL protocol. The
meanings, defined by the z/OS Communications The DVIPCONN command processing is completed.
Server, are as follows: BNH851I SUBNODE subnode HAS NO
0000 HEARTBEAT. DEREGISTERING
Connection does not have a secure session SUBNODE
established
0200 Explanation
SSL version 2 is in use
The IBM Z NetView Enterprise Management Agent was
0300 unable to communicate with the indicated subnode.
SSL version 3 is in use
Message Variables
0301
TLS version 1 is in use subnode
The subnode which missed its heartbeat.
506-509
The 4-digit hexadecimal representation of the AT-
TLS negotiated cipher. System action
511-513 The subnode is deregistered.
The AT-TLS security type (right-aligned, with
leading zeros omitted). The meanings, defined by BNH852I COMMAND OPERAND MISSING
the z/OS Communications Server, are as follows:
0
Explanation
Connection does not have a secure session This message is received because a command issued
established to the IBM Z NetView Enterprise Management Agent is
1 missing a required operand.
Client
2 System action
Server
The command fails.
3
Server with client authentication - client
Operator response
authentication type is PassThru
4 Issue the command with the required operand.
Server with client authentication - client BNH853I COMMAND UNKNOWN: command
authentication type is Full
5 Explanation
Server with client authentication - client
authentication type is Required This message is received because an unknown
command was issued to the IBM Z NetView Enterprise
6
Management Agent.
Server with client authentication - client
authentication type is SAFCheck Message Variables
515-522 command
The AT-TLS partner user ID. The name of the command that was issued.
524-531
The name of the sysplex. Operator response
533-537
Issue the correct command.
The z/OS release level.
BNH854I NETVIEW ENTERPRISE
Message Variables
MANAGEMENT AGENT
numconns SHUTDOWN OR STOP REQUESTED
The total number of DVIPA connections known to
this NetView program.

320 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation BNH858I NETVIEW ENTERPRISE
MANAGEMENT AGENT PROGRAM
The IBM Z NetView Enterprise Management Agent TO PROGRAM INTERFACE IS
received a shutdown or stop request. status
BNH855E ERROR INITIALIZING THE
NETVIEW ENTERPRISE Explanation
MANAGEMENT AGENT
A modify command was issued to display the Program
to Program Interface (PPI) status between the agent
Explanation and the NetView program.
The IBM Z NetView Enterprise Management Agent did Message Variables
not properly initialize.
status
The status of the PPI, which is active or inactive.
Operator response
BNH859I NETVIEW ENTERPRISE
Stop the agent and contact the system programmer.
MANAGEMENT AGENT
COMMUNICATION LAYER
System programmer response CURRENTLY TRACING: trace_types
Check the IBM Z NetView Enterprise Management
Agent RKLVLOG log file for error messages. See the Explanation
IBM Z NetView Troubleshooting Guide for information
This message is received when the IBM Z NetView
about locating the log file. Correct the problem and
Enterprise Management Agent communication layer
start the agent again.
trace has been enabled successfully. The message
BNH856I NETVIEW ENTERPRISE lists the selected trace types.
MANAGEMENT AGENT Message Variables
INITIALIZED SUCCESSFULLY.
trace_types
The trace type can be one or more of the following
Explanation values:
The IBM Z NetView Enterprise Management Agent BFR
started and the Program to Program Interface (PPI) Writes trace entries that display PPI send
receiver can accept data from the NetView program. and receiver buffer information exchanged
between the NetView program and the IBM Z
Operator response NetView Enterprise Management Agent.
You can now issue the NACMD command to start MOD
communication between the NetView program and the Writes trace entries for module and function
IBM Z NetView Enterprise Management Agent. entry and exit.
DEBUG
BNH857I PROGRAM TO PROGRAM
Writes internal diagnostic entries for use by
INTERFACE ppi_type ppi_name
IBM Software Support.
ALL
Explanation Writes trace entries for all of the previous types
A modify command was issued to display the Program of tracing.
to Program Interface (PPI) information. This message BNH860W NETVIEW ENTERPRISE
displays either the PPI receiver name or the PPI MANAGEMENT AGENT FAILED
sender name. TO INITIALIZE PPI RECEIVER:
Message Variables receiver, RC: return_code
ppi_type
The type of PPI name, which is SENDER or Explanation
RECEIVER. The IBM Z NetView Enterprise Management Agent was
ppi_name unable to initialize the specified PPI receiver. The PPI
The name of the PPI sender or receiver. receiver is defined in the configuration tool on the
Specify Configuration Parameters panel.

Chapter 3. BNH Prefix Messages 321


Message Variables • SLL enablement
receiver • Number of connection threads
The PPI receiver name that failed to initialize. • Wait time for command response
return_code • Server initialization files location (PDS name)
The return code from the PPI request.
• Trace levels
BNH861I DISTRIBUTED DVIPA STATISTICAL • Input queue count
LOGGING INFORMATION
• Output queue count
• Command queue count
Explanation
If the server is not active, the BNH864I message is
This is the first line of a multiline message for
displayed.
displaying information related to distributed DVIPA
statistical logging. The data lines for this message
provide keyword and value pairs for information Operator response
provided on the DVIPALOG command, and information Use this information to find the status of the Web
provided in the NetView CNMSTYLE member. Services servers. Report any problems to the system
BNH862I object FOUND IN location programmer.

Explanation System programmer response


This message is issued when an object that was Use the information to correct problems with the Web
previously missing or not found is now available for Services server.
processing.
BNH865I SERVER FAULT
Message Variables
object Explanation
Member name There is an error building the command.
location
The location of the object. For example, an in-
Operator response
storage member found in a data set.
Contact the system programmer.
BNH863I DISPLAY OF NETVIEW WEB
SERVICES INFORMATION
System programmer response
Explanation This is a SOAP message. Review the fault string and
details, then do what is suggested.
This message is displayed when the SOACTL command
is issued with either the LISTINFO or LSTSRVRS Bad response from command, Hlbrc=102
operand. Command Error. Contact IBM Software Support.
Command timed out, Hlbrc=103
System action Command Error. This indicates that the input
command timed-out before the response was
The command ends and information is displayed, received. Adjust the wait time value by updating
depending on the operand that was specified. the NVSP.srvrname.WAIT statement in the
If the SOACTL LSTSRVRS command was specified, a CNMSTYLE member.
list of Web Services server names and their status is Error building command
displayed. Command Error. Contact IBM Software Support.
If the SOACTL LISTINFO command was specified, the XSLT Parsing failed
following information is displayed for the specified Detailed message from the parser about specific
Web Services server: failure. This indicates that there is an error
with parsing the command. Verify that the input
• Owner task command uses valid XML code. If you are using
• Address family the ampersand symbol (&), greater than symbol
• Port address (>), or the less than symbol (<), verify that you
also used the escape character of semicolon (for

322 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


example, &amp;), or that you used the CDATA tag. indicated in this message and add the missing end
The IBM-037 and UTF-8 code pages are used tag.
for conversion between the host and distributed
BNH867I NUMBER OF DISTRIBUTED
environments. If you are using special characters,
DVIPA STATISTICAL RECORDS:
verify that they are printable in both code pages.
numrecords
BNH866I CLIENT FAULT
Explanation
Explanation
This is a multiline message written to display
The SOAP request or command is not valid. distributed DVIPA statistical records. This message
is issued in response to the CNMSDVST command
Operator response sample. It is also used to forward distributed DVIPA
statistical records to the master NetView program, in
Contact the system programmer. which case the data is formatted in the same manner
as the CNMDVIPP and CNMDVIPS data set record
System programmer response layout rather than the CNMSDVST command sample
format.
This is a SOAP message. Review the fault string and
details, then do what is suggested. See the DVIPA.STATS.Logto statement in the
CNMSTYLE member for more information about
Authentication failed, Hlbrc=101 logging distributed DVIPA statistical records at the
Command Error. Verify that the user ID and master NetView program. This message consists of
password or password phrase are correct. NetView one header line followed by a variable number of
SAF or RACF services are used to authenticate data lines, each describing distributed DVIPA statistics
the password or password phrase. The IBM-037 that were gathered between data collections. The first
and UTF-8 code pages are used for conversion CNMSDVST data line provides headings for the data
between the host and distributed environments. If records.
you are using a password phrase, ensure that only
characters that are printable in both code pages Note: If the value specified for the
are used. DVIPALOG.PriNumRecs or DVIPALOG.SecNumRecs
statement is equal to the maximum value that
Bad SOAP message is specified on the DVIPA.STATS.PRI.MAXR or
The SOAP request was not valid. Verify that the DVIPA.STATS.SEC.MAXR statement in the CNMSTYLE
SOAP input is formatted correctly and contains member, it can indicate that an I/O error occurred for
valid XML coding. If the input has special the data set and data loss might have occurred. If
characters, enclose them in a CDATA tag. this happens, a DWO970I message is written to the
Blank Command, Hlbrc=105 NetView log.
Command Error. Provide non-blank command
Each data record contains the following information:
input.
Invalid Method or URL Field
The request method is other than a GET or POST Description
method or the URL specified is not valid. #
Invalid Protocol, Expecting HTTP/1.1 Ascending sequence number
An HTTP/HTTPS request was made with a protocol Date
other than HTTP/1.1. Change the request to use Date of the distributed DVIPA data collection
the HTTP/1.1 protocol. Time
Resource not found Time of the distributed DVIPA data collection
The resource requested is not available. Verify LocalSys
that you have the correct authority to request Local z/OS image name
this resource. Also ensure that the location of
the resource matches the target location of the LclStack
request. Local TCPIP job name

XSLT Parsing failed, StreamTransform Error: DDVIPA


SAXParseException Distributed DVIPA
The XSLT parsing failed. An expected end of the Port
indicated tag was not found. See the line number Distributed DVIPA port

Chapter 3. BNH Prefix Messages 323


TargSys return_code
Distributed DVIPA target z/OS image name The return code from the z/OS Communications
TargStak Server NMI
Distributed DVIPA target TCPIP job name reason_code
DistribMethod The reason code from the z/OS Communications
Distribution method used for incoming connection Server NMI
requests. The values include BaseWLM, stack_name
Round-robin, ServerWLM, WeightedActive, The stack to which the NMI request was issued
TargetControlled, HotStandby, and Unknown. If
the distribution method is not BaseWLM or Operator response
ServerWLM, you do not see values for WLM
Weight and Percentage of WLM Weight. For Refer to the z/OS Communications Server: IP
more information about the distribution methods, Programmer's Guide and Reference manual for more
see z/OS Communications Server IP Configuration information.
Reference.
BNH869W THE CONNECTION TO THE
TotalConns NETVIEW WEB SERVICES SERVER
Number of connections for the DVIPA and port that 'srvrname' WAS REJECTED
were distributed to the target stack BECAUSE AT-TLS IS NOT
DeltaConns CONFIGURED OR ACTIVE FOR
Number of connections for the DVIPA and port that THIS SERVER.
were distributed to the target stack in the most
recent data collection Explanation
WLMweight
An attempt was made to connect to the NetView Web
Workload manager (WLM) weight value for either
Services server. The connection was rejected because
the z/OS images on which the target TCP/IP stack
the NVSP.srvrname.SECURE statement is set to YES,
is located or the specific server on the target stack
but AT-TLS is not configured or active for the port on
SD% which this Web Services server is listening.
Sysplex distributor percentage of new connections
for this distributed target in a data collection Message Variables
period srvrname
WLM% The name of the Web Services server.
Percentage WLM weight value indicating the
percentage of new connections that each Operator response
distributed target receives in an interval from WLM
Notify the system programmer.
BNH868I command RECEIVED AN ERROR
FROM THE network MANAGEMENT
INTERFACE: return_code
System programmer response
reason_code stack_name Check the NetView log for the BNH822I and BNH825I
messages. Review the NVSP.srvrname.SECURE
Explanation statement in the CNMSTYLE member and the
configuration of the TCP/IP stack and the policies that
A NetView command received an error from a are defined to the z/OS Communications Server Policy
z/OS Communications Server network Management Agent.
Interface (NMI). The return code, reason code, and
stack name are provided. If the command is collecting BNH874I SMF RECORD RECEIVED: sdata
data from multiple stacks, data is returned from all
stacks that do not receive an error. Explanation
Message Variables This is a 2-line message created by the CNMSMF3R
command sample when an SMF 30 record is received. It is
The NetView command running when the error intended for automation. The first line of this message
occurred contains specific data fields from the SMF 30 record
as described by the sdata field. The second line of
this message consists of the binary SMF 30 record

324 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


(truncated at 32000 characters) and is available to 67-74
automation but is not displayed or logged. SMF30PNM: subsystem or product name, for
example SMF
Message Variables
76-83
sdata SMF30SYN: system name
Contains formatted data taken from the SMF
30 record. The data is presented in column 85-92
format, where the first column of the sdata SMF30SYP: sysplex name
field corresponds to column 30 of the message 94-101
(originated from the beginning of the message). SMF30JBN: job or session name
All fields are left-aligned unless otherwise noted, 103-110
and are blank if not present. The field descriptions SMF30PGM: program name
include the SMF 30 field name. Note that the ASID
field is not in the SMF 30 record. It is the ASID 112-119
of the address space that originated the SMF 30 SMF30STM: step name
record. 121-128
SMF30UIF: user-defined identification field
Columns
Description 130-137
SMF30JNM: JES job identifier
30-33
SMF30RTY: record type in decimal, right- 139-141
aligned (the default value is 30) SMF30CLS: job class in decimal, right-aligned
35-37 143-162
SMF30STP: record subtype in decimal, right- SMF30USR: programmer name
aligned 164-171
• 4 - Step total SMF30GRP: RACF group ID

• 5 - Job ended or end of other work unit 173-180


SMF30RUD: RACF user ID
39-42
182-189
SMF30WID: work type indicator (for example:
SMF30PSN: name of the step that issued the
STC for started tasks and system address
procedure
spaces, TSO for TSO/E users, and so on)
191-194
44-48
SMF30SCC: step completion code, in
SMF30DTE: date that the record was moved to
hexadecimal format
the SMF buffer, in the form yyddd (local time)
196-199
50-56
SMF30STI: step or job termination indicator, in
SMF30TME: time since midnight that the
hexadecimal format
record was moved to the SMF buffer, in
hundredths of a second (decimal), right- 201-208
aligned SMF30ARC: abend reason code, in
hexadecimal format
58-61
ASID: Source address space identifier 210-217
SMF30WLM: workload name
63-65
SMF30TYP: subtype identification, right- 219-226
aligned SMF30SCN: service class name

• 1 - Job start or start of other work unit 228-235


SMF30GRN: resource group name
• 2 - Activity since the previous interval ended
• 3 - Activity for the last interval before the BNH877I NETVIEW ENTERPRISE
step ended MANAGEMENT AGENT INTERFACE
IS READY FOR WORK
• 4 - Step total
• 5 - Job ended or end of other work unit Explanation
• 6 - System address space
The Program to Program Interface (PPI) receiver used
by the IBM Z NetView Enterprise Management Agent

Chapter 3. BNH Prefix Messages 325


has successfully been defined and is waiting for subnode
communication from NetView hosts. The subnode name seen in the Tivoli Enterprise
Portal. This defaults to the NetView domain
Operator response where the NACMD command was issued, but can
be set using the NACMD.SUBNODE initialization
An NACMD command can now be issued to the IBM statement.
Z NetView Enterprise Management Agent to establish
communication between the NetView program and the BNH880I NETVIEW ENTERPRISE
agent. MANAGEMENT AGENT subnode
SUBNODE IS INACTIVE
BNH878I NETVIEW ENTERPRISE
MANAGEMENT AGENT INTERFACE
Explanation
HAS TERMINATED
The NACMD command has been stopped for one of
Explanation the following reasons and the data for the designated
NetView subnode is no longer available in the Tivoli
The Program to Program Interface (PPI) receiver used Enterprise Portal:
by the IBM Z NetView Enterprise Management Agent is
• Operator intervention
no longer active. This can occur for one of the following
reasons: • The IBM Z NetView Enterprise Management Agent
has been stopped
• The NetView subsystem interface (SSI) was stopped.
• The NetView program has been stopped
• The IBM Z NetView Enterprise Management Agent
was stopped. • An unexpected error occurred in the Program
to Program Interface (PPI) communication layer
• An unexpected error occurred. between the NetView program and the IBM Z
NetView Enterprise Management Agent.
System action Message Variables
The NACMD command ends and NetView data is no
subnode
longer available in the Tivoli Enterprise Portal for the
The subnode name seen in the Tivoli Enterprise
host on which this agent resides.
Portal. This defaults to the NetView domain
where the NACMD command was issued, but can
Operator response be set using the NACMD.SUBNODE initialization
statement.
Verify that the SSI is active with the PPI option
enabled and that the agent is active. If both are active,
contact the system programmer. Operator response
Verify that the NACMD command is active, the NetView
System programmer response program is active, and that the agent is active. If all are
active, contact the system programmer.
Check the system log and the agent RKLVLOG log
for messages pertaining to the failure. Contact IBM
Software Support if the problem cannot be resolved. System programmer response
BNH879I NETVIEW ENTERPRISE Check the system log, the NetView log, and the agent
MANAGEMENT AGENT subnode RKLVLOG log for messages pertaining to the failure.
SUBNODE IS ACTIVE Contact IBM Software Support if the problem cannot
be resolved.
Explanation BNH881I DATA COLLECTION FAILED
FOR SUBTOWER subtower_name,
An NACMD command was successfully issued from the
REASON 'reason'
NetView program to the IBM Z NetView Enterprise
Management Agent. The agent has registered the
subnode and data is now viewable for the designated Explanation
NetView subnode in the Tivoli Enterprise Portal.
The data collection command failed for one of the
Message Variables following reasons:

326 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


ADVISOR NOT AVAILABLE OR ROLE NOT PRIMARY – DVTAD
The connection for NetView data collection for the – DVCONN
specified subtower was not attempted because
there was no listening socket available for the – DVROUT
Lifeline Advisor component of the Multi-site • DISCOVERY subtowers:
workload Lifeline product. The Lifeline Advisor
– INTERFACES
component was either not started or not started
in the primary role. – TELNET
COMMAND FAILED Other possible values:
The NetView data collection command for the
• DVDEF (equivalent to DVIPA tower data
specified subtower failed. This can occur for the
collection)
following reasons:
• APPL (equivalent to NetView application data
• Data collection is started on a task other than collection under the DISCOVERY tower)
the one for which it was designated in the
CNMSTYLE member. The following ACTIVEACTIVE subtowers have data
collection that is managed through the ACTVCTL
• Data collection for the designated subtower is
command:
not supported on the current level of the z/OS
program. • DB2
• The underlying data collection command fails. • IMS
INACTIVE NACMD • LIFELINE
The NACMD command is not active. When the • VSAM
command ends, it stops all data collectors. This
reason code indicates that there might be a time reason
delay in stopping data collection after the NACMD The reason for the failure. The values are:
ends. • ADVISOR NOT AVAILABLE OR ROLE NOT
INTERNAL ERROR PRIMARY
An internal error occurred in the NetView program. • COMMAND FAILED
This can occur when any of the underlying NetView
• INACTIVE NACMD
services encounter problems such as insufficient
NetView storage or a task abnormally ending. • INTERNAL ERROR
TEMA TOWER NOT ENABLED • TEMA TOWER NOT ENABLED.
The NetView data collection command for the
specified subtower was not attempted because the System action
TEMA tower was not enabled. If support for the
monitoring agent is not wanted, you can ignore this Data collection for the designated subtower is
message. stopped.

Message Variables
Operator response
subtower_name
The name of the subtower for which data is being Take action based on the reason code received.
collected. For the COMMAND FAILED reason, review the NetView
The following TEMA subtowers have data log for additional messages. If necessary, contact your
collection that is managed through the NACTL system programmer.
command:
• HEALTH System programmer response
• CONNACT For an internal error, see the NetView log for a series
of DWO050I messages that provide more information
• CONINACT
about the problem.
• SESSACT
If the command failed, correct the autotask definitions
The following subtowers have data collection that in the CNMSTYLE member. If the problem persists,
is managed through the COLLCTL command: contact IBM Software Support with the information
• DVIPA subtowers: from the NetView log.

Chapter 3. BNH Prefix Messages 327


BNH882I DATA TRUNCATED FOR BNH891I DATA COLLECTION INTERVAL
WORKSPACE workspace, interval_name DEFAULTED TO
MAXIMUM ROW SIZE EXCEEDED interval

Explanation Explanation
A NetView command failed to write data to the This message is received when the data collection
z/OS data space because the data size exceeds interval that is defined in one of the following
the maximum number of rows that are defined for CNMSTYLE statements contains a value that is not
the workspace. The maximum number of rows is numeric or is out of range:
defined with the NACMD.ROWSxxx statement in the
• NACMD.INTxxx
CNMSTYLE member.
• DVIPA.INTxxx
Message Variables
• DISCOVERY.INTxxx
workspace
The name of the workspace for which data is being Message Variables
collected. interval_name
This is the name of the CNMSTYLE data collector
System action interval variable. The possible intervals are:

The data is truncated. • NACMD.INTHEALTH


• NACMD.INTCONNACT
Operator response • NACMD.INTCONINACT
Contact the system programmer with this information. • NACMD.INTSESSACT
• DVIPA.INTDVDEF
System programmer response • DVIPA.INTDVTAD
Make sure the correct row size is defined in the • DVIPA.INTDVCONN
CNMSTYLE member for that workspace. • DVIPA.INTDVROUT
BNH888I DISPLAY OF NETVIEW • DISCOVERY.INTINTERFACE
ENTERPRISE MANAGEMENT • DISCOVERY.INTTELNET
AGENT CONNECTIONS
• DISCOVERY.INTAPPL

Explanation interval
This is the default interval in seconds. See the
This is the first line of a multiline message for shipped CNMSTYLE member for the default values.
listing IBM Z NetView Enterprise Management Agent
connections.
Operator response
BNH889I TASK STATUS SOURCE DEST PPI
Contact your system programmer.
LCL PPI

System programmer response


Explanation
See the provided CNMSTYLE member for possible
This is the second line of a multiline message for
values. You can use the NACTL LISTINFO command or
listing Program to Program Interface (PPI) receivers
the COLLCTL LISTINFO command to select an optimal
used by the NetView program and the IBM Z NetView
interval.
Enterprise Management Agent.
BNH892I DISPLAY DATA COLLECTION
BNH890I NAME NAME RECEIVER RECEIVER
STATISTICS

Explanation Explanation
This is the third line of a multiline message for listing
This message is received when one of the following
Program to Program Interface (PPI) receivers used
commands is issued:
by the NetView program and the IBM Z NetView
Enterprise Management Agent. • COLLCTL LISTINFO

328 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• NACTL LISTINFO vost_name
Virtual OST (VOST) on which the Web Services
This message displays the average and maximum
server is started
time it takes for a data collector to complete a
data collection cycle. This information assists users BNH894I NETVIEW WEB SERVICES
in choosing an optimal data collection interval in the srvr_name function status
CNMSTYLE member. Each data collector has its own
data collection interval. This message also displays the
Explanation
number of iterations used to calculate average values.
This message is issued during Web Services server
For the NACTL LISTINFO command, statistics are
initialization and indicates the status of the SSL and
collected for the following IBM Z NetView Enterprise
CLIENTAUTH functions.
Management Agent subtowers:
Message Variables
• CONINACT
• CONNACT srvr_name
Name of the Web Services server
• HEALTH
function
• SESSACT The type of function:
For the COLLCTL LISTINFO command, statistics are • CLIENTAUTH
collected for the following NetView subtowers:
• SSL
• For the DVIPA tower:
status
– DVTAD Status of the Web Services server:
– DVCONN • Enabled
– DVROUT • Disabled
– DVDEF (DVIPA tower) • Active
• For the DISCOVERY tower: • Inactive
– INTERFACES
BNH895I NETVIEW WEB SERVICES
– TELNET srvr_name READY FOR WORK,
– APPL LISTENING ON PORT: port_number

Operator response Explanation


Contact your system programmer if a data collector is This message is issued when the Web Services server
inactive or the collection time is too slow. initialization is completed.
Message Variables
System programmer response srvr_name
You can use the information in this message to set an Name of the Web Services server
optimal data collection interval. port_number
Port on which the Web Services server is listening
BNH893I NETVIEW WEB SERVICES
'srvr_name' STARTING ON VOST BNH897I NETVIEW WEB SERVICES SERVER
vost_name srvr_name ENDED

Explanation Explanation
This message is issued when a Web Services server This message is issued when a Web Services server
starts. stops.
Message Variables Message Variables
srvr_name srvr_name
Name of the Web Services server Name of the Web Services server

Chapter 3. BNH Prefix Messages 329


Operator response BNH899I SERVER NAME STATUS
If the Web Services server ends abnormally, additional
error messages might be generated. See the message Explanation
help for these messages for further information. This is the second line of a multiline message that
lists Web Services server status when the SOACTL
System programmer response LSTSRVRS command is run.
If the Web Services server ends abnormally, see the BNH900I ENTERPRISE MASTER FOR TYPE
message help for any additional error messages that data_type ESTABLISHED
are generated.
BNH898E WEB SERVICES SERVER Explanation
'srvr_name' INITIALIZATION This message is issued on systems that have been
FAILED DUE TO reason_text RC=rc contacted by an enterprise master NetView program
and is forwarding management data to the enterprise
Explanation master NetView program.
This message is issued when the Web Services server The BNH900I message is the first message in a group
encounters errors during initialization. of messages that can include the BNH901I, BNH902I,
and BNH903I messages.
Message Variables
Message Variables
srvr_name
The name of the Web Services server data_type
Type of management data being forwarded. These
reason_text
are the types:
The reason for the failure:
• ACTIVEACTIVE
• BAD PARM VALUE
• DISCOVERY
• BIND FAILURE
• INITIALIZATION FAILED DUE TO MISSING OR BNH901I NEW MASTER: domain ON system
INVALID INITIALIZATION FILES IN XCF GROUP xcf_group IN
SYSPLEX sysplex
• LISTEN FAILURE
• OPEN SOCKET FAILURE
Explanation
• PTHREAD CREATE ERROR
This message identifies the new enterprise master
• PTHREAD INIT ERROR
NetView program.
• SETTING OF TRAP FAILED
Message Variables
rc
The return code of the failure domain
NetView domain name
system
Operator response
z/OS image name
Report the failure to the system programmer. xcf_group
XCF group of the enterprise master NetView
System programmer response program
Review the reason_text and take the corrective action: sysplex
Name of the sysplex, or the sysplex name used for
PTHREAD INIT ERROR a stand-alone system, where the enterprise master
Verify that the correct level of the Language NetView program resides
Environment® libraries is installed.
BNH902I OLD MASTER: domain ON system
PTHREAD CREATE ERROR
IN SYSPLEX sysplex
Verify that the correct level of the Language
Environment libraries is installed.
Explanation
For more information, see the DWO050 message in the
NetView log. This message identifies the old enterprise master
NetView program. This message is not issued if there

330 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


is no existing enterprise master NetView program sysplex
when a new enterprise master takes over. Name of the sysplex, or the sysplex name used for
a stand-alone system where the managed NetView
Message Variables
program resides
domain
BNH905I ENTERPRISE MASTER
NetView domain name
PROCESSING FINISHED. SYSTEMS
system FORWARDING DATA:
z/OS image name
sysplex Explanation
Name of the sysplex, or the sysplex name used for
a stand-alone system where the enterprise master This message is issued at an enterprise
NetView program resides master NetView program following completion of
ENT.SYSTEMS statement processing. It is followed by
BNH903I Reason: reason_code a BNH906I message that includes a list of the systems
that were taken over.
Explanation BNH906I DOMAIN SYSTEM SYSPLEX GROUP
This message specifies the reason that the enterprise TYPES domain image_name
master NetView program assumed control. sysplex xcf_group data_type
Message Variables
Explanation
reason_code
Indicates one of the following reasons: This message accompanies a BNH905I message and
contains a heading, followed by a list of managed
• 0: Initialization processing of ENT statements systems.
• 1: Restyle processing of ENT statements
Message Variables
• 2: Connectivity check driven by an internal
heartbeat timer domain
NetView domain name.
• 3: ACTVCTL TAKEOVER command processing
image_name
BNH904I ENTERPRISE MASTER SWITCH z/OS image name.
FOR TYPE data_type IN XCF
sysplex
GROUP xcf_group IN SYSPLEX
Name of the sysplex, or the sysplex name used for
sysplex
a stand-alone system where the managed NetView
program resides
Explanation xcf_group
This message is issued on a system that is being XCF group
acquired when it has an existing enterprise master data_type
NetView program. This message is not issued if there One or more types of data:
is no existing enterprise master NetView program
when a new enterprise master takes over. • ACTIVEACTIVE
• DISCOVERY
The BNH904I message is the first message in a
group of messages that can include the BNH901I and BNH907I ENTERPRISE MASTER REQUEST
BNH903I messages. REJECTED FOR GROUP xcf_group
IN SYSPLEX sysplex FOR TYPE
Message Variables
data_type. EXISTING MASTER
data_type IS system ON image_name
Type of data: IN SYSPLEX master_sysplex_id.
REASON=reason_code
• ACTIVEACTIVE
• DISCOVERY
Explanation
xcf_group
XCF group of the master NetView program The enterprise master request is rejected because
another NetView system is already an enterprise
master for this type of data. ENT.SYSTEMS
processing initiated by NetView initialization, RESTYLE

Chapter 3. BNH Prefix Messages 331


processing, or internal retry timers does not cause sysplex
the NetView system to take over as enterprise master Name of the sysplex, or the sysplex name used for
when another NetView system is already in that role. a stand-alone system where the managed NetView
program resides
Message Variables
BNH909I ERROR ENCOUNTERED IN
xcf_group
ENTERPRISE PROCESSING FOR
XCF group.
TYPE data_type AT domain_name
sysplex ON image_name IN SYSPLEX
Name of the sysplex, or the sysplex name used for sysplex
a stand-alone system
data_type Explanation
Type of data:
This message is issued to the log when an enterprise
• ACTIVEACTIVE master NetView program encounters an error in
• DISCOVERY takeover processing on the NetView domain identified
in the message. The error identified by the message
domain
applies only to the data_type, such as DISCOVERY,
NetView domain name
specified in the message. It mioght be able to take
system over for other types of data, such as ACTIVEACTIVE.
z/OS image name The errors are frequently due to configuration errors
master_sysplex_id at the remote system, such as a required tower not
Name of the sysplex, or the sysplex name used for being enabled. The data_type specifies the type of
a stand-alone system where the enterprise master enterprise.
NetView program resides This message can accompany a DSI416I message that
reason_code identifies the CNMEXCON DISCONNECT command as
Indicates why the existing enterprise master failing and also identifies the root error message.
assumed that role:
Message Variables
• 0 - Initialization processing of ENT statements
data_type
• 1 - Restyle processing of ENT statements Type of data:
• 2 - Connectivity check driven by an internal • ACTIVEACTIVE
heartbeat timer
• DISCOVERY
• 3 - ACTVCTL command processing
domain_name
BNH908I DOMAIN domain_name ON NetView domain name
SYSTEM image_name IN SYSPLEX
sysplex SUPPORTS ONLY THE image_name
DISCOVERY ENTERPRISE DATA z/OS system image
TYPE sysplex
Name of the sysplex
Explanation
System action
This message is issued at a master NetView program
when it encounters a system that does not support The data_type data is not forwarded to the enterprise
the ACTIVEACTIVE category of data. Depending on the master from the remote system. Other types of data
configuration, the master NetView program might take can be forwarded if the enterprise master is configured
over as master for DISCOVERY data. for more than one type.
Message Variables BNH910I NO SYSTEMS FORWARDING DATA
FOR TYPE data_type
domain_name
NetView domain name
image_name Explanation
z/OS image name. This message is issued when the NetView program
is unable to acquire any systems for the data_type
specified. BNH909 messages in the log might indicate
why it was unable to do so.

332 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


This message can accompany a BNH909I message. • Look in the NetView log for errors related to
the command. Contact the system programmer, if
Message Variables
necessary, to resolve the error.
data_type
Type of data: System programmer response
• ACTIVEACTIVE
Verify that the following conditions are true:
• DISCOVERY
• The local system, or the specified system (using the
BNH911I request: No data found for 'subject' NetView domain), has the specified data.
• The specified NetView domain is known to the
Explanation master NetView program in a sysplex or the
enterprise.
No data is available for the specified request. This
might be normal. Possible causes are as follows: – The enterprise master NetView program does not
have DVIPA data.
• No resources are configured or available.
– Use the LIST STATUS=XCFGRPS command to
• The command is for a domain that is not in the
determine acceptable domains from a master
sysplex.
NetView program.
• Other system failures, such as SNMP, have occurred.
• Related functions, such as SNMP, are active. See
• For the ACTVLIFE and ACTVREPL commands: IBM Z NetView Installation: Configuring Additional
Components for configuration information about the
– There is no data for the specified request. This
specified subject. Also, check the NetView log for
could be for one of the following reasons:
other messages that are related to this request.
- The command and its values are correct, and
For the ACTVLIFE and ACTVREPL commands:
there is no data.
- A value specified in the command is for a • Verify that the ACTIVEACTIVE towers and subtowers
resource that does not exist. are enabled on the correct systems.
- For the ACTVLIFE command, the Load Balancer • For the ACTVLIFE command, verify that the Multi-
might not be active. Site workload Lifeline product is active on the
system where the command is issued.
– A failure occurred collecting the requested
information. • For the ACTVREPL command, verify that the Q
replication, IMS replication, or VSAM replication
• For the LIST MSGQ command, all the specified product is active on the production system or
message queues of the target task are empty. systems.
Message Variables
BNH912I FiltType FILTER FiltName ALREADY
request EXISTS
The function for which no data was found.
subject Explanation
The requested data.
This message is issued when you issue a SAVE
command for an existing Canzlog filter.
System action
Message Variables
Processing for the request ends.
FiltType
Type of filter:
Operator response
• COMMON
Verify the format and spelling of the specified
• TASK
operands. If the command uses a domain name,
ensure that the correct domain is specified. If the FiltName
format, spelling, and domain are correct, notify the Filter name entered on the CANZLOG command
system programmer.
For the ACTVLIFE and ACTVREPL commands: System action
• Verify that the command is issued correctly. Processing for the request ends.

Chapter 3. BNH Prefix Messages 333


Operator response Explanation
This message indicates that a NetView module that
If you are saving a new filter, use a different filter
was processing Canzlog messages has no more
name. If you are changing an existing filter, use the
messages to process. If module is DSI4LCUI, this
REPLACE command.
indicates that NetView was processing messages
BNH913I IP ADDRESS INFORMATION NOT that occurred before the NetView subsystem was
AVAILABLE FOR DOMAIN domain initialized, but enountered a vacant plot.
IN SYSPLEX plex Message Variables
module
Explanation
The name of the NetView module that was
This message is issued when the NetView program is processing Canzlog messages.
not able to retrieve information about its IP addresses.
System action:
It is issued on the system named in the message, and
The vacant plot is left vacant in the active Canzlog data
at other NetViews that belong to the same XCF group.
space. This does not affect Canzlog browsing.
This condition is probably caused by TCP/IP being
inactive when NetView is initialized. When TCP/IP BNH916I THIS IS AN INCOMPLETE
becomes active, NetView automation attempts to MULTILINE MESSAGE
repair the problem.
Explanation:
Message Variables This message indicates that the associated message
is an incomplete multiline write-to-operator (MLWTO)
domain
message, and it is marked as incomplete in the
plex Canzlog log. This happens if all lines of a MLWTO are
not received within 40 seconds.
System action System action:
Other members in the NetView's XCF group, and any The Canzlog log checks for incomplete MLWTOs every
enterprise masters attempting to contact this NetView 11 seconds.
system attempts SNA communications. Depending on Operator response:
network configuration, this might fail, which can cause Notify the system programmer.
problems with data forwarding.
System programmer response:
BNH914I LONG MESSAGE TRUNCATED BY Contact IBM support to determine the reason for not
numtrunc LINES - USE SHOWTEXT receiving the complete MLWTO within the allowed
time span.
Explanation BNH917I The following gtype global
A multiline message was truncated for display by variables are too long for the
numtrunc lines. This can happen with verbose MVS requested function:
messages or other long messages.
The full text of the original message can be searched Explanation
while browsing the Canzlog log. The text of the This message indicates that one or more global
BNH914 message is not treated as part of the variables are too long for the request. See the
message and cannot be searched. Restrictions information for the associated command
Message Variables for the maximum supported length (for example,
GLOBALV SAVE).
numtrunc
The number of lines by which the message was This is a multiline message. The label line shown is
truncated. followed by the global variables that are too long, one
per line. Each data line consists of the variable name
Operator response: followed by one blank space and the value.
To see the complete message, issue the SHOWTEXT
command with the cursor on the truncated message, Message Variables
or use the PF key defined for this function (the default gtype
is PF2). COMMON (if common global variable), or task
BNH915I NO MORE MESSAGES LEFT TO BE name (if task global).
PROCESSED BY module System action:

334 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


The indicated variables were bypassed by the BNH920I count COMMAND STATISTICS
requested function. RECORDS DISPLAYED
Operator response:
Notify the system programmer. Explanation
This multiline message is issued in response to
System programmer response:
the CMDMON DISPLAY command. It consists of one
Consider whether the indicated variables require their
header line, 3 label lines, and one or more data lines.
lengths. If they do, this message can be automated.
The data lines contain statistical information about
Sample CNMS8053 shows how message BNH917I
primary and subordinate commands that run in the
can be automated to cause long variables and their
NetView address space.
values to be written to a sequential data set. Sample
CNMS8054 shows how the file can then be read to Each data line contains the following information:
restore the saved long variables.
Column Number
BNH918I Data has been truncated: qual1 Description
qual2 1-8
Command Name
Explanation
This log only message indicates that data has been The Command Name is one of the following values:
truncated. The only qual1 value currently is DSIVARS, • The name of the command as defined in a
which indicates that the DSIVARS assembler service command definition (CMDDEF) statement
retrieved a global variable on a GET request that was
truncated to 255 or more characters. This message • The name of a REXX or CLIST that is not defined
is intended for migration to a NetView release that using a command definition (CMDDEF) statement
supports values longer than 255 characters. The • The name of the command specified on the
message can indicate that a preexisting program ADDCMD NAME parameter
that was precluded from truncation should now be • The name of the PIPE specified on the PIPE
examined. NAME operand
Message Variables – If the PIPE NAME operand is not specified, the
qual1 command name is PIPE.
DSIVARS (global and local variable service) 10-17
qual2
Alternate Name
Global variable name
The Alternate Name is one of the following values:
Operator response:
Notify the system programmer. • PIPE if the command was PIPE
System programmer response: • The command synonym invoked for the specified
Consider whether the indicated variables require their Command Name as defined on a command
lengths, and whether an assembler program should be synonym (CMDSYN) statement
updated. • The first command synonym name defined for
BNH919I command : STATUS INFORMATION the specified Command Name, if one is specified
on a command synonym (CMDSYN) statement or
on the ADDCMD CMDSYN parameter
Explanation
• N/A if no command synonyms are defined for the
This message is in response to the specified status
specified Command Name
request command. If the command is CMDMON
LIST=STATUS, status pertaining to the Command 20-27
Statistics function is displayed.
Parent Name
Message Variables
The Parent Name is one of the following values:
command
• N/A if this is the primary command
The name of the command for which the status is
requested. – A primary command is a command that
is invoked directly by a NetView task, the
System action:
automation table, or a timer.
Processing continues.

Chapter 3. BNH Prefix Messages 335


• The name of the primary command if this is a • The I/O count for subordinate commands is
subordinate command the individual total for the specified subordinate
command.
– A subordinate command is a command that is
invoked from within another command. 117-124
29-36 Authorized User
Task Name The name of the authorizing task for the specified
command.
The name of the task under which the command is
run. Note:
38-54 • Label commands (EXCMD, RMTCMD) end with a
colon and are treated as follows:
Start Time
– If the command starts with a forward slash, the
The date and time that the specified command
Command Name is EXCMD and the Alternate
started.
Name is the actual label command.
56-72 – If the command does not start with a forward
End Time slash, the Command Name is RMTCMD and the
Alternate Name is N/A, the RMTSYN value, or the
The date and time that the specified command RMTALIAS value.
completed.
• The output of the CMDMON DISPLAY command
74-93 is sorted by the END TIME store clock (STCK)
CPU Time value. To change the order in which the output
is displayed, see the Command Statistics Data
The total CPU time, in centiseconds, that is used Formatter (CNMSCSFM) sample.
for the specified command.
Message Variables
• The CPU for primary commands, as seen in the
Parent Name column, is the cumulative total for count
all commands invoked by the primary command. The number of displayed records.

• The CPU for subordinate commands is the System action:


individual total for the specified subordinate Processing continues.
command. BNH921I INVALID DELIMITER FOUND FOR
95-104 REGULAR EXPRESSION 'pattern'
Maximum Storage
Explanation
The highest amount of storage, in kilobytes, that is
used by the specified command at any time during An invalid start delimiter for a regular expression was
command execution. encountered. This message accompanies message
DSI167E which identifies the text position of the error.
• The maximum storage for primary commands,
as seen in the Parent Name column, is the Message Variables
cumulative total for all commands invoked by the pattern
primary command. The regular expression in error.
• The maximum storage for subordinate
commands is the individual total for the specified System action
subordinate command.
The NetView program stops processing the regular
106-115 expression.
I/O Count
The total number of I/O operations that the Operator response
specified command performed. If the message appeared as a result of the command
• The I/O count for primary commands, as seen you entered, correct the regular expression in error,
in the Parent Name column, is the cumulative and reissue the command. For more details about
total for all commands invoked by the primary writing a regular expression, see the IBM Z NetView
command. Application Programmer's Guide.

336 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


If the message did not appear as a result of the pattern
command you entered, notify the system programmer. The regular expression in error.

System programmer response System action


Correct the regular expression in error. For more The NetView program stops processing the regular
details about writing a regular expression, see the IBM expression.
Z NetView Application Programmer's Guide.
BNH922I NO ENDING DELIMITER FOUND Operator response
FOR REGULAR EXPRESSION If the message appeared as a result of the command
'pattern' you entered, correct the regular expression in error,
and reissue the command. For more details about
Explanation writing a regular expression, see the IBM Z NetView
Application Programmer's Guide.
The specified regular expression has a valid start
delimiter, but no matching end delimiter. If the message did not appear as a result of the
command you entered, notify the system programmer.
Message Variables
pattern System programmer response
The regular expression in error.
Correct the regular expression in error. For more
details about writing a regular expression, see the IBM
System action Z NetView Application Programmer's Guide.
The NetView program stops processing the regular
BNH924I MISPLACED QUANTIFIER IN
expression.
REGULAR EXPRESSION 'pattern'

Operator response
Explanation
If the message appeared as a result of the command
A regular expression contains a quantifier that does
you entered, correct the regular expression in error,
not correspond to a valid token. This message
and reissue the command. For more details about
accompanies message DSI167E which identifies the
writing a regular expression, see the IBM Z NetView
text position of the error.
Application Programmer's Guide.
Message Variables
If the message did not appear as a result of the
command you entered, notify the system programmer. pattern
The regular expression in error.
System programmer response
System action
Correct the regular expression in error. For more
details about writing a regular expression, see the IBM The NetView program stops processing the regular
Z NetView Application Programmer's Guide. expression.
BNH923I UNMATCHED 'symbol' CHARACTER
IN REGULAR EXPRESSION Operator response
'pattern' If the message appeared as a result of the command
you entered, correct the regular expression in error,
Explanation and reissue the command. For more details about
writing a regular expression, see the IBM Z NetView
A regular expression with an unmatched grouping Application Programmer's Guide.
symbol, for example, an unescaped left parenthesis
without a corresponding unescaped right parenthesis, If the message did not appear as a result of the
was encountered. command you entered, notify the system programmer.
Message Variables
symbol
The unmatched grouping symbol.

Chapter 3. BNH Prefix Messages 337


System programmer response System action
Correct the regular expression in error. For more The NetView program stops processing the regular
details about writing a regular expression, see the IBM expression.
Z NetView Application Programmer's Guide.
BNH925I INVALID QUANTIFIER IN Operator response
REGULAR EXPRESSION 'pattern' If the message appeared as a result of the command
you entered, correct the regular expression in error,
Explanation and reissue the command. For more details about
writing a regular expression, see the IBM Z NetView
A regular expression with an invalid quantifier was
Application Programmer's Guide.
encountered. This message accompanies message
DSI167E which identifies the text position of the error. If the message did not appear as a result of the
command you entered, notify the system programmer.
Message Variables
pattern System programmer response
The regular expression in error.
Correct the regular expression in error. For more
details about writing a regular expression, see the IBM
System action Z NetView Application Programmer's Guide.
The NetView program stops processing the regular
BNH927I MISPLACED END OF STRING
expression.
ANCHOR IN REGULAR
EXPRESSION 'pattern'
Operator response
If the message appeared as a result of the command Explanation
you entered, correct the regular expression in error,
A regular expression with a misplaced unescaped "end
and reissue the command. For more details about
of string" ($) anchor was encountered. This message
writing a regular expression, see the IBM Z NetView
accompanies message DSI167E which identifies the
Application Programmer's Guide.
text position of the error.
If the message did not appear as a result of the
Message Variables
command you entered, notify the system programmer.
pattern
System programmer response The regular expression in error.

Correct the regular expression in error. For more


System action
details about writing a regular expression, see the IBM
Z NetView Application Programmer's Guide. The NetView program stops processing the regular
expression.
BNH926I MISPLACED BEGINNING OF
STRING ANCHOR IN REGULAR
EXPRESSION 'pattern' Operator response
If the message appeared as a result of the command
Explanation you entered, correct the regular expression in error,
and reissue the command. For more details about
A regular expression with a misplaced unescaped writing a regular expression, see the IBM Z NetView
"beginning of string" (^) anchor was encountered. Application Programmer's Guide.
This message accompanies message DSI167E which
identifies the text position of the error. If the message did not appear as a result of the
command you entered, notify the system programmer.
Message Variables
pattern System programmer response
The regular expression in error.
Correct the regular expression in error. For more
details about writing a regular expression, see the IBM
Z NetView Application Programmer's Guide.

338 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNH928I INVALID OPTION 'option' Operator response
FOLLOWS REGULAR EXPRESSION
'pattern' If the message appeared as a result of the command
you entered, correct the regular expression in error,
and reissue the command. For more details about
Explanation writing a regular expression, see the IBM Z NetView
A regular expression with an invalid option was Application Programmer's Guide.
encountered. This message accompanies message If the message did not appear as a result of the
DSI167E which identifies the text position of the error. command you entered, notify the system programmer.
Message Variables
option
System programmer response
The invalid option. Correct the regular expression in error. For more
pattern details about writing a regular expression, see the IBM
The regular expression in error. Z NetView Application Programmer's Guide.
BNH930I INVALID HEXADECIMAL
System action CHARACTER IN REGULAR
EXPRESSION 'pattern'
The NetView program stops processing the regular
expression.
Explanation
Operator response A regular expression with an invalid hexadecimal
character (following the \x escape sequence) was
If the message appeared as a result of the command
encountered. This message accompanies message
you entered, correct the regular expression in error,
DSI167E which identifies the text position of the error.
and reissue the command. For more details about
writing a regular expression, see the IBM Z NetView Message Variables
Application Programmer's Guide.
pattern
If the message did not appear as a result of the The regular expression in error.
command you entered, notify the system programmer.
System action
System programmer response The NetView program stops processing the regular
Correct the regular expression in error. For more expression.
details about writing a regular expression, see the IBM
Z NetView Application Programmer's Guide. Operator response
BNH929I UNSUPPORTED CHARACTER IN If the message appeared as a result of the command
REGULAR EXPRESSION 'pattern' you entered, correct the regular expression in error,
and reissue the command. For more details about
Explanation writing a regular expression, see the IBM Z NetView
Application Programmer's Guide.
A regular expression with an unescaped, unsupported
character was found. This message accompanies If the message did not appear as a result of the
message DSI167E which identifies the text position of command you entered, notify the system programmer.
the error.
Message Variables System programmer response
pattern Correct the regular expression in error. For more
The regular expression in error. details about writing a regular expression, see the IBM
Z NetView Application Programmer's Guide.
System action BNH931W COMMAND STATISTICS SMF
DATA SPACE RECORDING IS
The NetView program stops processing the regular
SUSPENDED
expression.

Chapter 3. BNH Prefix Messages 339


Explanation • CMDMON STATS=[ALL|PRIONLY]

The Command Statistics System Management Facility BNH932I SECURITY DETAILS FOR
(SMF) data space, CNMCMSMF, has reached its count CONNECTIONS. MISSED
maximum storage capacity for new records. No BUFFERS: missedcount
additional Command Statistics records are written to
the data space until the next z/OS SMF interval has Explanation
elapsed.
This is a multiline message written in response
All commands that are being monitored by the to the CONNSEC QUERY command. It consists of
Command Statistics function from the time this one header line followed by a variable number of
message is issued until the SMF records are written data lines, each describing security information for
are lost. a TCP/IP connection. The number of connections
returned is determined by the MAXRECS operand
System action on the CONNSEC QUERY command. This message is
designed for parsing by REXX and not for reading by a
When the Command Statistics SMF interval elapses, person. Columns in the data lines that do not contain
the records in the data space are written into one or data, such as, columns for protocol information for a
more SMF records, and writing to the data space will protocol not being used on the session, will be blank.
be resumed.
Note: CONNSEC QUERY displays all of the available
Message BNH934I will be issued once records are data, but some error conditions can prevent data from
being written to the data space again. being returned. See any preceding error messages for
possible explanations for missing data.
Operator response Each data line includes the following information:
Contact the system programmer. Columns
Description
System programmer response 1-8
Review how often this message and BNH934I occur. The TCP/IP name
10-72
If the messages occur frequently, consider taking one
The local IP address. If LADDR in the TCPCONN
or more of the following actions:
QUERY was specified in colon hexadecimal format,
• Increasing the value on the this address is output in the form
CMDMON.INIT.SMFDSSIZE statement in your hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh,
CNMSTYLE user member. where each hhhh is a 0 to 4 character hexadecimal
value. If LADDR was specified in dotted decimal
– If you choose this option, issue the following
format, this address is output in the form
commands for the new data space size to take
ddd.ddd.ddd.ddd if it is an IPv4 address, or the
effect:
form
- RESTYLE CMDMON ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.ddd.d
- CMDMON LOGSMF=NO dd.ddd.ddd.ddd.ddd if it is an IPv6 address. In
either case, ddd is a decimal number from 0 to
- CMDMON LOGSMF=YES 255. Otherwise, this address is output in the form
• Excluding more commands in the Command ddd.ddd.ddd.ddd if it is an IPv4 address, or the
Statistics Inclusion/Exclusion sample, CNMSCSIE. form hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh:hhhh
if it is an IPv6 address. Leading zeros are stripped
– If you choose this option, you will need to issue
from output IPv4 addresses but not IPv6
the following commands for the new inclusion/
addresses. Unused columns on the right are blank.
exclusion list to take effect:
74-78
- RESTYLE CMDMON The local port number (right-aligned with leading
- If the CMDMON.INIT.STATS CNMSTYLE zeros omitted).
statement value is not OFF, then monitoring 80-87
of commands will resume after the RESTYLE The jobname associated with the local socket
CMDMON command. Otherwise, issue the application.
following command to restart command
monitoring:

340 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


89-96 244-283
The z/OS userid associated with the local socket Inbound traffic IP filter rule name (blank if no
application. outbound filter rule associated with connection)
98-100 285-292
The security protocols being used for the Inbound traffic IP filter rule name extension (blank
connection. This is a 3-character field containing if no associated rule or rule name does not have an
Y or N characters for the security protocols in use extension).
on the session. From left to right, the flags are 294-297
for TLS, SSH and IPSec. Examples: TSL only: YNN; TLS/SSL protocol version. This is a 4-digit
SSH only: NYN; IPSec only: NNY; TSL and IPSec: hexadecimal value indicating the TLS/SSL version.
YNY; no encryption: NNN Possible values are:
102-164
• 0000: Unknown version
The remote IP address, with formatting handled in
the same way as the local IP address. • 0200: SSLv2
166-170 • 0300: SSLv3
The remote port number (right-aligned with • 0301: TLSv1.0
leading zeros omitted).
• 0302: TLSv1.1
172-179
• 0303: TLSv1.2
The date and time the connection started,
formatted as an 8-character binary store-clock 299-299
value. This value can be converted into a printable A 1-digit number set to 1 to indicate that
format using the PIPE EDIT command. AT-TLS cryptographic data protection operations
181-188 are bypassed for this connection as part of
The 8-digit hexadecimal representation of the a stack optimization for intra-host connections.
TCP/IP resource (connection) identifier. Only ATTLS peer authentication operations are
executed in this case.
190-190
A 1-digit decimal digit indicating the status of IP 301-301
filtering for outbound traffic on the connection. A 1-digit number indicating the source of the TLS
Possible values are: information being displayed. Possible values are:

• 0 – No associated outbound filter rule • 1: Stream observation

• 1 – Outbound traffic permitted in the clear • 2: Cryptographic protocol provider

• 2 – Outbound traffic permitted with IPSec 303-303


protection A 1-digit number indicating the TLS handshake
type. Possible values are:
• 3 – Outbound traffic blocked
• 1: Full handshake
192-231
Outbound traffic IP filter rule name (blank if no • 2: Abbreviated handshake
outbound filter rule associated with connection) 305-305
233-240 A 1-digit number indicating the TLS local
Outbound traffic IP filter rule name extension handshake role. Possible values are:
(blank if no associated rule or rule name does not
• 0: Unknown
have an extension).
• 1: Client
242-242
A 1-digit number indicating the status of IP • 2: Server
filtering for inbound traffic on the connection. • 3: Server with client authentication
Possible values are:
307-370
• 0 – No associated inbound filter rule Up to 64 hexadecimal digits representing the 32-
• 1 – Inbound traffic permitted in the clear byte binary TLS session ID. Shorter session IDS
will be left-justified and padded with blanks.
• 2 – Inbound traffic permitted with IPSec
protection 372-377
6 hexadecimal digits representing the negotiated
• 3 – Inbound traffic blocked
TLS cipher suite identifier. If the TLS version
is SSLv3 or higher, this is a 4-character value

Chapter 3. BNH Prefix Messages 341


in the first 4 bytes of this field, padded with • 001B: CAST 128 CBC
trailing blanks. See the TLS Cipher Suite registry at • 001C: ARC4 128
http://www.iana.org/assignments/tlsparameters/
tls-parameters.xhtml for a complete list of the 4- • 001D: ARC4 256
hexadecimal-character values. • 001E: ARC4
If the TLS version is SSLV2, then all 6 digits are • 001F: Rijndael CBC
used: • 0020: ACSS
• 010080: 128-bit RC4 with MD5 • 0021: ARIA 128 CBC
• 020080: 40-bit RC4 with MD5 • 0022: ARIA 256 CBC
• 030080: 128-bit RC2 with MD5 • 0023: ARIA 128 GCM
• 040080: 40-bit RC2 with MD5 • 0024: ARIA 256 GCM
• 050080: 128-bit IDEA with MD5 • 0025: Camellia 128 CBC
• 060040: DES with MD5 • 0026: Camellia 256 CBC
• 0700C0: 3DES with MD5 • 0027: Camellia 128 GCM
379-382 • 0028: Camellia 256 GCM
4 hexadecimal digits representing the symmetric • 0029: ChaCha20 Poly1305
encryption algorithm used by the TLS cipher suite.
Possible values are: • 002A: IDEA CBC
• 002B: SEED CBC
• 0000: Unknown
• 002C: Fortezza
• 0001: None
• 002D: GOST28147
• 0002: DES
• 002E: 2Fish CBC 256
• 0003: DES 40
• 002F: 2Fish CBC
• 0004: 3DES
• 0030: 2Fish CBC 192
• 0005: RC2 40
• 0031: 2Fish CBC 128
• 0006: RC2 128
• 0032: Serpent CBC 256
• 0007: RC2
• 0033: Serpent CBC 192
• 0008: RC4 40
• 0034: Serpent CBC 128
• 0009: RC4 128
• 000A: RC4 256 384-387
4 hexadecimal digits representing the message
• 000B: RC4 authentication algorithm used by the TLS cipher
• 000C: AES CBC 128 suite. Possible values are:
• 000D: AES CBC 192 • 0000: Unknown
• 000E: AES CBC 256 • 0001: No message authentication, or uses
• 000F: AES CTR 128 authenticated encryption algorithm like AESGCM
• 0010: AES CTR 192 • 0002: MD2
• 0011: AES CTR 256 • 0003: HMAC-MD5
• 0012: AES GCM 128 • 0004: HMAC-SHA1
• 0013: AES GCM 256 • 0005: HMAC-SHA2-224
• 0014: AES CCM 128 • 0006: HMAC-SHA2-256
• 0015: AES CCM 256 • 0007: HMAC-SHA2-384
• 0016: AES CCM8 128 • 0008: HMAC-SHA2-512
• 0017: AES CCM8 256 • 0009: AES-GMAC-128
• 0018: AES 256 • 000A: AES-GMAC-256
• 0019: Blowfish • 000B: AES-128-XCBC-96
• 001A: Blowfish CBC • 000C: HMAC-SHA2-256-128

342 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• 000D: HMAC-SHA2-384-192 • 2: FIPS 140 mode is enabled at level 1
• 000E: HMAC-SHA2-512-256 (synonymous with X'01')

• 000F: HMAC-MD5-96 • 3: FIPS 140 mode is enabled at level 2 (112-


bit strength enforced when creating new keys
• 0010: HMAC-SHA1-96 or performing digital signature generation and
• 0011: UMAC-64 encryption type operations. Digital signature
• 0012: UMAC-128 verification, decryption using 3DES and RSA
decryption with 80-bit key lengths allowed when
• 0013: RIPEMD-160 processing already protected information).
389-392 • 4: FIPS 140 mode is enabled at level 3 (112 bit
4 hexadecimal digits key exchange algorithm used or higher strength enforced as defined in NIST
by the TLS cipher suite. Possible values are: SP800-131A.)
• 0000: Unknown 396-397
• 0001: None 2 hexadecimal digits indicating cryptographic
operations. Possible values are:
• 0002: RSA
• 0003: RSA_EXPORT • 80: Encrypt-then-MAC processing is used

• 0004: RSA_PSK 399-399


One character (Y or N) representing the presence
• 0005: DH_RSA
of server certificate information for the connection
• 0006: DH_RSA_EXPORT
401-401
• 0007: DH_DSS One character (Y or N) representing the presence
• 0008: DH_ANON of client certificate information for the connection
• 0009: DH_ANON_EXPORT 403-413
The letter K followed by up to 10 decimal digits,
• 000A: DH_DSS_EXPORT
left-justified and padded with blanks, representing
• 000B: DHE_RSA the IPSec IKE tunnel identifier for the connection.
• 000C: DHE_RSA_EXPORT 415-415
• 000D: DHE_DSS 000E: DHE_DSS_EXPORT One decimal digit representing IPSec IKE major
version.
• 000F: DHE_PSK
417-417
• 0010: ECDH_ECDSA
One decimal digit representing IPSec IKE minor
• 0011: ECDH_RSA version.
• 0012: ECDH_ANON 419-466
• 0013: ECDHE_ECDSA IPSec IKE key exchange rule for the tunnel, left-
justified and padded with blanks.
• 0014: ECDHE_RSA
468-530
• 0015: ECDHE_PSK
Local IP address for the IPSec IKE tunnel
• 0016: KRB5 endpoint. It is in the same format as the IP
• 0017: KRB5_EXPORT address for the connection.
• 0018: PSK 532-594
Remote IP address for the IPSec IKE tunnel
• 0019: SRP_SHA_RSA
endpoint. It is in the same format the IP address
• 001A: SRP_SHA_DSS for the connection.
• 001B: SRP_SHA 596-597
394-394 2 hexadecimal digits representing the
1-digit number indicating the FIPS140 mode of the authentication method for the IPSec IKE local
TLS provider. Possible values are: endpoint. One of the following values:

• 0: Not in FIPS 140 mode • 00: Unknown or manual tunnel

• 1: FIPS 140 mode is enabled (80-bit strength • 01: None


enforced) • 02: RSA signature
• 03: Preshared key

Chapter 3. BNH Prefix Messages 343


• 04: ECDSA-256 signature If not 0, this value indicates the lifesize limit for the
• 05: ECDSA-384 signature tunnel, in Kbytes. Otherwise (value is 0), no lifesize
enforced.
• 06: ECDSA-521 signature
629-638
• 07: Digital signature Decimal number, left-justified and padded with
599-600 blanks, representing the IPSec IKE tunnel lifetime.
2 hexadecimal digits representing the This value indicates the total number of minutes
authentication method for the IPSec IKE remote the tunnel remains active.
endpoint. Same set of values as the local IPSec 640-649
IKE endpoint authentication. Decimal number, left-justified and padded
602-605 with blanks, representing the IPSec IKE
4 hexadecimal digits representing the IPSec reauthentication interval. Indicates the number of
IKE tunnel authentication algorithm. Same set minutes between reauthentication operations.
of values as the TLS message authentication 651-661
algorithm (columns 384-387) The letter M or Y (for manual or dynamic) followed
607-610 by up to 10 decimal digits representing the IPSec
4 hexadecimal digits representing the IPSec IKE tunnel identifier assigned by the system.
tunnel encryption algorithm. Same set of values as 663-663
the TLS encryption algorithm (columns 379-382). One decimal digit for the IPSec FIPS140 indicator.
612-613 If set to 1, cryptographic operations for this tunnel
2 hexadecimal digits representing the IPSec IKE are performed using cryptographic algorithms and
Diffie-Hellman group used to generate the keying modules that are designed to meet the FIPS 140
material for this IKE tunnel. One of the following requirements. If set to 0, cryptographic algorithms
values: and modules that do not meet the FIPS 140
requirements might be used.
• 00: Unknown or manual tunnel
665-665
• 01: Group1 A decimal digit representing the type of IPSec
• 02: Group 2 tunnel. Possible values are:
• 05: Group 5 • 1: Manual IPSec tunnel
• 0E: Group 14 • 2: Dynamic IPSec tunnel
• 13: Group 19 • 3: Shadow tunnel
• 14: Group 20 667-667
• 15: Group 21 A decimal digit representing the IPSec tunnel
• 18: Group 24 state. Possible values are:

• FF: No DH group used • 1: Manual or dynamic tunnel is active

615-616 • 2: Manual tunnel is inactive


2 hexadecimal digits representing the IPSec IKE 669-669
pseudo-random function used for seeding keying A decimal digit representing the IPSec
material. One of the following values: encapsulation mode. Possible values are:
• 00: Unknown or manual tunnel • 1: Tunnel mode
• 01: None • 2: Transport mode
• 02: HMAC-SHA2-256 671-672
• 03: HMAC-SHA2-384 2 hexadecimal digits representing the protocol
• 04: HMAC-SHA2-512 used for message authentication. One of the
following:
• 05: AES-128-XCBC
• 32 Encapsulating Security Payload (ESP)
• 06: HMAC-MD5
• 33: Authentication Header (AH)
• 07: HMAC-SHA1
674-677
618-627
4 hexadecimal digits representing the IPSec
Decimal number, left-justified and padded with
tunnel authentication algorithm. These are the
blanks, representing the IPSec IKE tunnel lifesize.

344 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


same values as the TLS message authentication • 80: Encrypt-then-MAC processing is used for
algorithm (columns 384-387) inbound traffic
679-682 • 40: Encrypt-then-MAC processing is used for
4 hexadecimal digits representing the IPSec outbound traffic
tunnel encryption algorithm. These are the same
733-740
values as the TLS encryption algorithm (columns
8 characters representing the SSH subcomponent
379-382).
(-padded with trailing blanks):
684-685
2 hexadecimal digits representing the Diffie- • 'SFTPS': sftp server
Hellman group used for IPSec perfect forward • 'SFTPC': sftp client
secrecy. Same set of values as IPSec IKE Diffie- • 'SCPS ' : scp server
Hellman group used to generate the keying
material • 'SCPC' : scp client

687-696 • 'SSH' : ssh client


Decimal number, left-justified and padded with • 'SSHD' : sshd daemon
blanks, representing the IPSec security association
742-745
lifesize in KBytes. Zero if IPSec tunnel type is
4 hexadecimal digits representing the first or only
manual.
peer authentication method used for this SSH
698-707 connection:
Decimal number, left-justified and padded with
blanks, representing the IPSec security association • 0000: Unknown
lifetime in minutes. Zero if IPSec tunnel type is • 0001: None
manual. • 0002: Password
709-718 • 0003: Public key
Decimal number, left-justified and padded with
blanks, representing the IPSec tunnel VPN lifetime • 0004: Host-based
in minutes (length of time after which the tunnel • 0005: Rhosts
family ceases to be refreshed). Zero indicates no • 0006: RhostsRSA
VPN lifetime limit is enforced.
• 0007: RSA
720-720
One character (Y or N) representing the presence • 0008: Keyboard-interactive
of local certificate information for the connection • 0009: Challenge-response
722-722 • 000A: Control socket 1
One character (Y or N) representing the presence • 000B: GSSAPI with MIC
of peer certificate information for the connection
• 000C: GSSAPI Key exchange
724-724
A 1-digit number indicating the SSH protocol 747-750
version. Possible values are: If not 0, the last of multiple authentication
methods used for this SSH connection. Same set
• 1: Version 1 of possible values as the first peer authentication
• 2: Version 2 method used for the connection.
726-726 752-755
A 1-digit number indicating the source of the SSH 4 hexadecimal digits representing the encryption
information being displayed. Possible values are: algorithm for SSH inbound traffic. Same set of
possible values as the TLS encryption algorithm
• 1: Stream observation (columns 379-382)
• 2: Cryptographic protocol provider 757-760
728-728 4 hexadecimal digits representing the message
1-digit number indicating the FIPS140 mode of the authentication algorithm for SSH inbound traffic.
SSH provider. Same set of possible values as the Same set of possible values as the TLS
TLS FIPS140 mode indicators. authentication algorithm (columns 384-387)
730-731 762-765
2 hexadecimal digits representing SSH 4 hexadecimal digits representing the key
cryptographic operations flags: exchange method for the SSH connection:

Chapter 3. BNH Prefix Messages 345


• 0000: Unknown 793-797
• 0001: None Length of raw client key for the SSH connection in
bits, left-justified and padded with blanks.
• 0002: Diffie-Hellman-group-exchangeSHA256
799-803
• 0003: Diffie-Hellman-group-exchangeSHA1 Length (in bytes) of the server public key
• 0004: Diffie-Hellman-group14-SHA1 fingerprint for the SSH connection. If no server
• 0005: Diffie-Hellman-group1-SHA1 public key is used, then this length is set to zero.

• 0006: ECDH-SHA2-NISTP256 805-809


Length (in bytes) of the client public key fingerprint
• 0007: ECDH-SHA2-NISTP384 for the SSH connection. If no client public key is
• 0008: ECDH-SHA2-NISTP521 used, then this length is set to zero.
• 0009: GSS-GROUP1-SHA1 811-938
• 000A: GSS-GROUP14-SHA1 The server public key fingerprint (a hash of the
public key used to identify that key) for the SSH
• 000B: GSS-GEX-SHA1 connection, left-justified and padded on the right
• 000C: ECMQV-SHA2 with X'00'.
• 000D: GSS-* 940-1067
• 000E: RSA1024-SHA1 The server public key fingerprint (a hash of the
public key used to identify that key) for the SSH
• 000F: RSA2048-SHA256 connection, left-justified and padded on the right
767-770 with X'00'.
4 hexadecimal digits representing the encryption 1069-1069
algorithm for SSH outbound traffic. Same set of One character (Y or N) representing the presence
possible values as the TLS encryption algorithm of SSH server certificate information for the
(columns 389-392) connection
772-775 1071-1071
4 hexadecimal digits representing the message One character (Y or N) representing the presence
authentication algorithm for SSH outbound traffic. of SSH client certificate information for the
Same set of possible values as the TLS connection
authentication algorithm (columns 384-387)
1073-1076
777-780 4 hexadecimal digits representing the TLS server
4 hexadecimal digits representing the type of raw certificate signature method. Possible values are:
server key for the SSH connection:
• X'0000': Unknown
• 0000: Unknown
• X'0001': None
• 0001: None
• X'0002': RSA with MD2
• 0002: RSA
• X'0003': RSA with MD5
• 0003: DSA
• X'0004': RSA with SHA1
• 0004: Diffie-Hellman (DH)
• X'0005': DSA with SHA1
• 0005: Elliptic Curve Cryptography (ECC)
• X'0006': RSA with SHA-224
• 0006: RSA1 (SSHV1 only)
• X'0007': RSA with SHA-256
• 0007: RSA_CERT (from OpenSSH certificate)
• X'0008': RSA with SHA-384
• 0008: DSA_CERT (from OpenSSH certificate)
• X'0009': RSA with SHA-512
• 0009: ECDSA_CERT (from OpenSSH certificate)
• X'000A': ECDSA with SHA1
782-786 • X'000B': ECDSA with SHA-224
Length of raw server key for the SSH connection in
bits, left-justified and padded with blanks. • X'000C': ECDSA with SHA-256

788-791 • X'000D': ECDSA with SHA-384


4 hexadecimal digits representing the type of raw • X'000E': ECDSA with SHA-512
client key for the SSH connection. Same set of • X'000F': DSA with SHA-224
possible values as the server key type.
• X'0010': DSA with SHA-256

346 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


1078-1081 1560-1563
4 hexadecimal digits representing the TLS server 4 hexadecimal digits representing the TLS client
certificate encryption method. Possible values are: certificate signature method. Set of possible
values are the same as the TLS server certificate
• 0000: Unknown
signature method.
• 0001: None
1565-1568
• 0002: RSA 4 hexadecimal digits representing the TLS client
• 0003: DSA certificate encryption method. Set of possible
values are the same as the TLS server certificate
• 0004: ECDSA
encryption method.
1083-1086 1570-1573
4 hexadecimal digits representing the TLS server 4 hexadecimal digits representing the TLS client
certificate digest algorithm. Possible values are: certificate digest algorithm. Set of possible values
• 0000: Unknown are the same as the TLS server certification digest
algorithm.
• 0001: None
1575-1614
• 0002: MD2
Up to 40 hexadecimal digits representing the
• 0003: MD5 TLS client certificate serial number. Shorter serial
• 0004: SHA1 numbers are left-justified and padded with blanks.
• 0005: SHA-224 1616-1632
TLS client certificate expiration date in the form
• 0006: SHA-256
MM/DD/YY HH:MM:SS
• 0007: SHA-384
1634-1637
• 0008: SHA-512 4 hexadecimal digits representing the TLS client
1088-1127 certificate key type. Set of possible values are the
Up to 40 hexadecimal digits representing the same as the TLS server certification key type.
TLS server certificate serial number. Shorter serial 1639-1643
numbers are left-justified and padded with blanks. A decimal number, left-justified and padded with
1129-1145 blanks, representing the TLS client certificate key
TLS server certificate expiration date in the form length
MM/DD/YY HH:MM:SS 1645-1844
1147-1150 The first 200 bytes of the TLS client certificate
4 hexadecimal digits representing the TLS server subject distinguished names field, left-justified and
certificate key type. Possible values are: padded with blanks.
1846-2045
• 0000: Unknown
The first 200 bytes of the TLS client issuer
• 0001: None distinguished names field, left-justified and
• 0002: RSA padded with blanks.
• 0003: DSA 2047-2050
4 hexadecimal digits representing the IPSec IKE
• 0004: Diffie-Hellman (DH)
local certificate signature method. Set of possible
• 0005: Elliptic Curve Cryptography (ECC) values are the same as the TLS server certificate
1152-1156 signature method.
A decimal number, left-justified and padded with 2052-2055
blanks, representing the TLS server certificate key 4 hexadecimal digits representing the IPSec IKE
length local certificate encryption method. Set of possible
1158-1357 values are the same as the TLS server certificate
The first 200 bytes of the the TLS server certificate encryption method.
subject distinguished names field, leftjustified and 2057-2060
padded with blanks. 4 hexadecimal digits representing the IPSec IKE
1359-1558 local certificate digest algorithm. Set of possible
The first 200 bytes of the TLS server certificate values are the same as the TLS server certification
issuer distinguished names field, left-justified and digest algorithm.
padded with blanks.

Chapter 3. BNH Prefix Messages 347


2062-2101 2613-2617
Up to 40 hexadecimal digits representing the A decimal number, left-justified and padded with
IPSec IKE local certificate serial number. Shorter blanks, representing the IPSec IKE peer certificate
serial numbers are left-justified and padded with key length
blanks. 2619-2818
2103-2119 The first 200 bytes of the IPSec IKE peer
IPSec IKE local certificate expiration date in the certificate subject distinguished names field, left-
form MM/DD/YY HH:MM:SS justified and padded with blanks.
2121-2124 2820-3019
4 hexadecimal digits representing the IPSec IKE The first 200 bytes of the IPSec IKE peer
local certificate key type. Possible values are the certificate issuer distinguished names field, left-
same as the TLS server certification key type. justified and padded with blanks.
2126-2130 3021-3024
A decimal number, left-justified and padded with 4 hexadecimal digits representing the SSH server
blanks, representing the IPSec IKE local certificate certificate signature method. Set of possible
key length values are the same as the TLS server certificate
2132-2331 signature method.
The first 200 bytes of the IPSec IKE local 3026-3029
certificate subject distinguished names field, 4 hexadecimal digits representing the SSH server
leftjustified and padded with blanks. certificate encryption method. Set of possible
2333-2532 values are the same as the TLS server certificate
The first 200 bytes of the IPSec IKE local encryption method.
certificate issuer distinguished names field, 3031-3034
leftjustified and padded with blanks. 4 hexadecimal digits representing the SSH server
2534-2537 certificate digest algorithm. Set of possible values
4 hexadecimal digits representing the IPSec IKE are the same as the TLS server certification digest
peer certificate signature method. Same set of algorithm.
possible values are the same as the TLS server 3036-3075
certificate signature method. Up to 40 hexadecimal digits representing the
2539-2542 SSH server certificate serial number. Shorter serial
4 hexadecimal digits representing the IPSec IKE numbers are left-justified and padded with blanks.
peer certificate encryption method. Same set 3077-3093
of possible values as the TLS server certificate SSH server certificate expiration date in the form
encryption method. MM/DD/YY HH:MM:SS
2544-2547 3095-3098
4 hexadecimal digits representing the IPSec IKE 4 hexadecimal digits representing the SSH server
peer certificate digest algorithm. Same set of certificate key type. Possible values are the same
possible values as the TLS server certification as the TLS server certification key type.
digest algorithm. 3100-3104
2549-2588 A decimal number, left-justified and padded with
Up to 40 hexadecimal digits representing the blanks, representing the SSH server certificate key
IPSec IKE peer certificate serial number. Shorter length
serial numbers are left-justified and padded with 3106-3305
blanks. The first 200 bytes of the SSH server certificate
2590-2606 subject distinguished names field, left-justified and
IPSec IKE peer certificate expiration date in the padded with blanks.
form MM/DD/YY HH:MM:SS 3307-3506
2608-2611 The first 200 bytes of the SSH server certificate
4 hexadecimal digits representing the IPSec IKE issuer distinguished names field, left-justified and
peer certificate key type. Same set of possible padded with blanks.
values as the TLS server certificate key type. 3508-3511
4 hexadecimal digits representing the SSH client
certificate signature method. Set of possible

348 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


values are the same as the TLS server certificate BNH933I TESTING COMPLETED. TOTAL
signature method. MATCHES: matchCount, TOTAL
3513-3516 COMPARISONS: compareCount
4 hexadecimal digits representing the SSH client
certificate encryption method. Set of possible Explanation
values are the same as the TLS server certificate
encryption method. Automation table testing has completed.
3518-3521 Message Variables
4 hexadecimal digits representing the SSH client matchCount
certificate digest algorithm. Set of possible values The total number of matches between the
are the same as the TLS server certification digest messages in the recording and the statements in
algorithm. the automation table.
3523-3562 compareCount
Up to 40 hexadecimal digits representing the The total number of comparisons between the
SSH client certificate serial number. Shorter serial messages in the recording and the statements in
numbers are left-justified and padded with blanks. the automation table.
3564-3580
BNH934I COMMAND STATISTICS SMF DATA
SSH client certificate expiration date in the form
SPACE RECORDING IS RESUMED.
MM/DD/YY HH:MM:SS
number RECORDS LOST
3582-3585
4 hexadecimal digits representing the SSH client
certificate key type. Possible values are the same Explanation
as the TLS server certification key type. Writing records to the Command Statistics System
3587-3591 Management Facility (SMF) data space, CNMCMSMF,
A decimal number, left-justified and padded with has resumed. This occurs after a z/OS SMF interval has
blanks, representing the SSH client certificate key elapsed, and the current records in the data space are
length written into SMF records.
3593-3792 This message is seen after the BNH931W message is
The first 200 bytes of the SSH client certificate issued.
subject distinguished names field, left-justified and
Message Variables
padded with blanks.
3794-3993 number
The first 200 bytes of the SSH client certificate The number of Command Statistics records that
issuer distinguished names field, left-justified and are not written to SMF records.
padded with blanks.
Message Variables
Operator response
Count Contact the system programmer.
The total number of connections matching the
input criteria. If this number exceeds MAXRECS, System programmer response
the COUNT=YES operand must be specified on the
Review how often this message and BNH931W occur.
CONNSEC QUERY command for this value to be
displayed. Otherwise, numcon is N/A. If the messages occur frequently, consider taking one
missedcount or more of the following actions:
The number of missing data buffers. An increased • Increasing the value on the
value of missedcount indicates reduced accuracy CMDMON.INIT.SMFDSSIZE statement in your
of the QUERY results. CNMSTYLE user member.
A REXX sample, CNMSZERT, is provided to format the – If you choose this option, issue the following
BNH932I information for readability. commands for the new data space size to take
effect:
System action - RESTYLE CMDMON
The CONNSEC QUERY is complete. - CMDMON LOGSMF=NO
- CMDMON LOGSMF=YES

Chapter 3. BNH Prefix Messages 349


• Excluding more commands in the Command Message Variables
Statistics Inclusion/Exclusion sample, CNMSCSIE.
function
– If you choose this option, you will need to issue The function that has been modified.
the following commands for the new inclusion/ state
exclusion list to take effect:
ENABLED
- RESTYLE CMDMON The function is ready to use.
- If the CMDMON.INIT.STATS CNMSTYLE DISABLED
statement value is not OFF, then monitoring The function is not ready to use.
of commands will resume after the RESTYLE
CMDMON command. Otherwise, issue the
following command to restart command System action
monitoring: Processing continues.
• CMDMON STATS=[ALL|PRIONLY] Usage Notes:
BNH935I COMMAND STATISTICS SMF The CANZLOG ARCHIVING function issues this
LOGGING ENDED DUE TO task message as a result of the CANZLOG BUILDARC
TASK TERMINATION. REASON: command. For the Canzlog Archiving function, the
reason states are as follows:
• ENABLED
Explanation
• DISABLED
The Command Statistics System Management Facility
BNH937A INVALID CREDENTIALS SUPPLIED
(SMF) function stops writing z/OS SMF records
because the autotask that performs this function is no
longer active. Explanation
Message Variables At least one credential, such as an operator ID,
password, or passphrase, was specified incorrectly
task
and access to the application requiring the credentials
The autotask that is no longer active.
was denied.
reason
The reason that the task is no longer active:
System action
• LOGOFF
Access to the application is denied. If this is a
• ABEND NetView logon and the maximum number of attempts
permitted has not been exceeded, the user is again
System action prompted for credentials. If the maximum number of
attempts has been exceeded, the session with the
The Command Statistics SMF function continues to user's terminal is terminated.
write records to the data space, but no z/OS SMF
records are written.
Operator response
Operator response If permitted, correct and reenter the credentials.
1. Restart the specified autotask using the AUTOTASK BNH938I PASSWORD OR PASSPHRASE
OPID=task command. CHANGED SUCCESSFULLY
2. Issue the following commands:
• CMDMON LOGSMF=NO
Explanation
• CMDMON LOGSMF=YES A password or passphrase has been successfully
changed for an operator or application ID.
BNH936I 'function' HAS BEEN state
System action
Explanation
Processing continues.
The function specified has been changed to the state
specified. BNH939I INVALID LOGON ATTEMPT FROM
TERMINAL terminal

350 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation BNH941I CNMSELTE: NO type STATEMENT
FOUND FOR COMMAND command
A logon to the NetView program was attempted and AND SORT KEY sortkey
rejected. This message is sent to the log and to the
terminal that is designated as an authorized receiver of
the message. Explanation
Message Variables This message is output during processing of the
CMDEDIT statement of CNMSTYLE, or by the ADDCMD
terminal command if the EDIT keyword was coded with value
The name of the terminal or the client's IP Y, and indicates one of the following errors in the
address. CNMSELTE sample:
• A SEARCH statement with no corresponding EDIT
System action statement.
The NetView program rejects the logon. • An EDIT statement with no corresponding SEARCH
BNH940I ONE OR MORE statementOne statement.
VALUES CONFLICT WITH THE Message Variables
statementTwo VALUE value FOR
DOMAIN domain type
The type of statement that was not found (SEARCH
or EDIT).
Explanation
command
A command failed because the value of one or The name of the command for which the
more CNMSTYLE statement specifications was not statements are being processed.
compatible with the value of the CNMSTYLE statement sortkey
specification on the given domain. The 1-8 character sort key for which a statement is
Message Variables missing.
statementOne
The CNMSTYLE statement specification whose System action
value is causing the conflict. If this error occurred during NetView initialization,
statementTwo the NetView program does not start. If this error did
The other CNMSTYLE statement whose value is in not occur during NetView initialization, the ADDCMD
conflict. command processing fails.
value
The value with which the conflict occurs. Operator response
domain Notify the system programmer.
The name of the domain with which the value
conflict occurs.
System programmer response
System action Examine the CNMSELTE sample and any included
members, and correct the error. For each command
Processing continues. that is referenced, SEARCH and EDIT statements must
be logically paired with a unique sort key. Refer to the
System programmer response IBM Z NetView Security Reference for a description of
the CNMSELTE sample.
Correct the specified CNMSTYLE statement and ask
the operator to reenter the command. BNH942I EDITING SPECIFICATIONS
ALREADY DEFINED FOR
If the message is received after issuing the CANZLOG COMMAND command
BUILDARC command, examine the value defined to
the ARCHIVE.HLQ CNMSTYLE statement for each
domain specified on the ARCHIVE.SHARED.DOMAINS Explanation
CNMSTYLE statement. A command was specified on the CMDEDIT statement
of CNMSTYLE, but editing specifications for the
command have already been defined to the NetView
program.

Chapter 3. BNH Prefix Messages 351


Message Variable Operator response
command Notify the system programmer.
The name of the command being processed.
System programmer response
System action
Remove the command name from the value of the
The specified command name is ignored; processing CMDEDIT statement.
continues.

352 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Chapter 4. BNJ Prefix Messages

This chapter lists the BNJ prefix messages.


The following messages are sent to the NetView terminal operator or the authorized message receiver. If
an authorized message receiver is not defined in the system or is not logged on, the messages destined
for the authorized message receiver are sent to the system console operator.
BNJ000I MESSAGE NUMBER nnn NOT System action
FOUND IN MESSAGE TABLE msgtbl
Processing continues.

Explanation
Operator response
During either a data services command processor
(DSCP) request for a message from the message table Notify the system programmer.
or the processing of NetView initialization statements
during installation (shown as either BNJAPAMA or System programmer response
as msgtbl), the message identifier field is zero or
Determine the cause of the macro failure. See IBM Z
is a value not found in the message CSECT or in
NetView Programming: Assembler for the meaning of
BNJAPAMA.
the return code.
Message Variables
BNJ002I EP/LOCAL RECORDING IS
nnn DEACTIVATED. ABEND ADDRESS:
The message number abaddress COMPLETION CODE:
msgtbl ccc
The message table name
Explanation
System action MVS only. System SVC 76 (IFBSVC76) detected an
DSCP processing or initialization processing continues. abend and notified BNJSVC76 to inactivate channel-
attached and EP link-attached error recording.
Operator response Message Variables
Give the message number to the system programmer. abaddress
The address where the abend occurred
System programmer response ccc
The NetView completion code
You request messages in the message CSECT msgtbl
and BNJAPAMA by message number. Verify that the
message number specified is correct and that the System action
identified message table or BNJAPAMA contains a The hardware monitor will continue to process
message with that number. SNA data. Recording of channel-attached or EP link-
BNJ001I BNJ76MPF RECEIVED A RETURN attached error data is ended.
CODE OF retcode FROM macro
MACRO Operator response
Notify the system programmer.
Explanation
The specified macro failed to run. System programmer response
Message Variables Record the abend address and completion code and
contact IBM Software Support.
retcode
The macro return code BNJ003A NPDA IS ALREADY ACTIVE. REPLY
macro 'A' TO ABORT OR 'C' TO CONTINUE
DSIGET, DSIMQS, or DSIFRE

© Copyright IBM Corp. 1997, 2022 353


Explanation containing the deliver RU is smaller than the deliver RU
plus the deliver RU trailer length, or the deliver trailer
The hardware monitor has been started and initialized. is not valid. Messages BNJ049I and BNJ050I follow
this message.
System action Message Variables
The NetView program stops the attempt to reinitialize module
hardware monitor (reply A) or retries the initiation The name of the NetView module that detected
attempt (reply C). the error
locid
Operator response The location within the NetView module that
Enter the appropriate response after consulting with detected the error
the system programmer.
System action
System programmer response Processing on this error record ends.
The hardware monitor might still be active. This
condition can be caused by trying to initiate two Operator response
hardware monitors or by a system failure that prevents
the hardware monitor from ending normally. Verify that Notify the system programmer.
there is no NetView job in the system before having the
operator respond. System programmer response
BNJ004I NPDA LOGGER BUFFERS FULL. Determine the problem from the locid. This value will
RECORD(S) OVERLAID be one of the following:
01
Explanation The buffer containing the deliver RU is not
valid. HDRMLENG plus HDRTDISP is greater than
The NetView logger (mapper) received records for
HDRBLENG. Contact IBM Software Support.
processing, but the buffers are filled with records
not yet processed. The NetView program overlays the 02
oldest records in the buffer with the newly received The deliver RU header, plus the embedded RU are
records. longer than HDRMLENG. Determine whether the
deliver RU or the buffer is not correct. If the deliver
RU is not valid, determine who generated it and
System action have it corrected. If the buffer is not valid, contact
Processing continues but the overlaid records are not IBM Software Support.
processed. 03
HDRMLENG ended before the end of the deliver RU
Operator response trailer was found. Determine whether the deliver
RU or the buffer is not correct. If the deliver RU
Notify the system programmer. is not valid, determine who generated it and have
it corrected. If the buffer is not valid, contact IBM
System programmer response Software Support.

For information about the lost record, interrogate the BNJ007I NCCF NOT STARTED BY
SYS1.LOGREC data set by means of the environmental INITIALIZER. NPDA LOGGING NOT
recording, editing, and printing program (EREP). AVAILABLE
To correct this condition, increase the BUFSIZE
parameter in the NetView procedure. Explanation
BNJ006I module locid THE FOLLOWING The command facility was not started by the hardware
DELIVER RU HAS BEEN REJECTED monitor initializes and the logging (mapping) of
channel-attached and EP link-attached data cannot
Explanation occur.

The module module detected that the buffer


containing the deliver RU is not valid, the buffer

354 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
The hardware monitor recording request is ignored. The current record being processed is not written to
the database.
Operator response
Operator response
Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response
Initiate command facility with or using the hardware
monitor procedure. This procedure loads the initializer Investigate the MSU to determine the subvector that is
load module that, in turn, passes control to the missing or not valid.
command facility.
BNJ010I module locid THE FOLLOWING
BNJ008A REPLY 'A' TO ABORT OR 'C' TO MSU RECORD HAS AN INVALID
CONTINUE SUBVECTOR LENGTH AT OFF-SET
off: record
Explanation
Explanation
Your reply to message BNJ003A is not valid.
The module module detected that the length of the
System action subvector specified at offset off is not correct.
Message Variables
Processing stops.
module
Operator response The name of the NetView module that detected
the error
Enter A or C after consulting with the system
locid
programmer.
The location within the NetView module that
detected the error
System programmer response off
Determine the appropriate response. The offset from the beginning of the DELIVER
header
BNJ009I module locid THE FOLLOWING MSU
record
RECORD HAS AN INVALID OR
The record that is not valid
MISSING vector SUBVECTOR

Explanation System action


If possible, processing of the record continues.
The MSU record being processed by module module
does not contain the required vector subvector, or the
vector subvector is in an incorrect format. Operator response
Message Variables Notify the system programmer.
module
The name of the NetView module that detected System programmer response
the error
Determine which device is generating the MSU record
locid and contact IBM Software Support.
The location within the NetView module that
detected the error BNJ011I module locid THE FOLLOWING
MSU RECORD HAS AN INVALID
vector SUBFIELD LENGTH AT OFF-SET
The subvector that was missing or not valid off: record

Chapter 4. BNJ Prefix Messages 355


Explanation Explanation
Module module detected that the length of the subfield The NetView program has ended the logger (mapper)
specified at offset off is not correct. as requested and recording of channel-attached
and EP link-attached data cannot occur. SNA data
Message Variables
recording continues.
module
The name of the NetView module that detected System action
the error
locid Processing continues for SNA data.
The location within the NetView module that BNJ016I DSIGET FAILED. NPDA LOGGER IS
detected the error TERMINATING
off
The offset from the beginning of the DELIVER Explanation
header
The recording task issued a DSIGET macro (a
record
GETMAIN request) to obtain storage for initialization.
The record that is not valid
The DSIGET macro return code of 04 indicates that the
requested storage is not available.
System action
If possible, processing of the record continues. System action
NetView processing continues but the recording of
Operator response channel-attached and EP link-attached data stops. The
recording of SNA data continues.
Notify the system programmer.

System programmer response Operator response


Notify the system programmer.
Determine which device is generating the MSU record
and contact IBM Software Support.
System programmer response
BNJ012I BNJLNPDA TASK ALREADY
ACTIVE Increase the region size for the command facility and
hardware monitor in the hardware monitor procedure
and rerun the procedure.
Explanation
BNJ019I INVALID INITIALIZATION CARD
You entered a command that requires data services,
record USING DEFAULT OF x FOR
but the data services task, BNJLNPDA, is already
threshtype
active.

System action Explanation


You specified the line-quality threshold (LQTHRESH) or
Hardware monitor processing continues.
the impulse hits threshold (IHTHRESH) incorrectly in
BNJ014I NPDA LOGGER IS ACTIVE the hardware monitor initialization table, BNJMBDST.
A default value will be used.
Explanation Message Variables
The logger (mapper) task has been successfully record
initialized. The initialization statement in error
x
System action The default value that will be used for the
threshold
Processing continues.
threshtype
BNJ015I NPDA LOGGER TERMINATED The threshold type, either LQTHRESH or
IHTHRESH

356 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
Processing continues with default value. Enter the command again that failed. If the same
condition occurs, notify the system programmer.
Operator response
System programmer response
Notify the system programmer.
See IBM Z NetView Programming: Assembler for
System programmer response information on the specific error and take the
appropriate corrective action.
Correct the incorrect value in BNJMBDST.
BNJ021I operatorid module locid THE
BNJ020I operatorid module locid VSAM SERVICE ROUTINE THAT INSERTS
I/O REQUEST FAILED TO START: THE LOGICAL RECORD INTO THE
DSIZVSMS R/C - MAJOR = majcode PHYSICAL RECORD RETURNED
MINOR = mincode, VSAM DATASET A NON-ZERO RETURN CODE.
= ddname, KEY 'keyval' RETURN CODE IS retcode

Explanation Explanation
DSIZVSMS detected an error in the I/O request and The service routine cannot successfully insert the
sent nonzero return codes majcode and mincode. logical temporary record into the physical temporary
If the return codes are both 9999, the DSIZVSMS record. Either there is not enough space in the physical
macro is not issued because the parameters passed record or the physical or logical record size is specified
by module module were not valid. incorrectly.
Message Variables Message Variables
operatorid operatorid
The NetView terminal operator identifier. If no The terminal operator identifier. If no operator is
operator is defined, this value is blank. defined, this value is NONE.
module module
The control section (CSECT) name where an error The name of the NetView module that detected
condition was detected. the error.
locid locid
The location within the named CSECT where an The location within the NetView module that
error condition was detected. detected the error.
majcode retcode
The DSIZVSMS REG15 return code. The code is in The return code returned by the service routine.
decimal.
mincode System action
The DSIZVSMS FDBK return code. The code is in
decimal. No further processing is attempted for the logical
temporary record. Data services command processor
ddname (DSCP) processing ends. Error message BNJ250I
The name of the VSAM data set that encountered or BNJ950I is sent to the presentation services
the error. If you cannot determine the ddname, this command processor (PSCP) for issuing to the NetView
value is UNKNOWN. terminal operator to indicate a failure in service.
keyval
The VSAM key used for the request. Operator response
Check for authorized receiver messages from
System action
BNJALTPA and notify the system programmer.
Data services command processor (DSCP) processing
ends for the particular database record. System programmer response
Check the following BNJALTPA return codes:

Chapter 4. BNJ Prefix Messages 357


4 maximum size allowed by the NetView DSIVSMX GET
Insufficient space in physical record and DSIVSAM GET commands.
8 BNJ023I operatorid module locid VSAM KEY
Physical or logical record size that is not valid keyval HAS AN INVALID FORMAT
BNJ022I operatorid module locid VSAM
I/O COMPLETION FAILURE: VSAM Explanation
R/C - MAJOR = majcode MINOR
= mincode, VSAM DATASET = The module requested a key keyval. The key that
ddname, KEY 'keyval' was returned contains information that cannot be
recognized by the module.

Explanation Message Variables

The module requested a key keyval using the VSAM operatorid


macro to initiate a VSAM I/O request. It did not The terminal operator identifier. If no operator is
complete successfully. defined, this value is NONE.
module
Message Variables
The name of the NetView module that detected
operatorid the error.
The terminal operator identifier. If no operator is locid
defined, this value is NONE. The location within the NetView module that
module detected the error.
The name of the NetView module that detected keyval
the error. The VSAM key value that is not valid.
locid
The location within the NetView module that System action
detected the error.
majcode Processing continues but the NetView program ignores
The VSAM completion code (REG15), in decimal. the key and data.

mincode
The VSAM completion code (FDBK), in decimal. Operator response
ddname Notify the system programmer.
The name of the VSAM data set that encountered
the error. If you cannot determine the ddname, this System programmer response
value = UNKNOWN.
Damage might be done to the VSAM database. Inspect
keyval
the database by printing it, then save the database and
The VSAM key used for the request.
re-create it. See IBM Z NetView Installation: Getting
Started for information on recreating the database.
System action
BNJ024I operatorid module locid THE
No further processing is attempted for this error SERVICE ROUTINE THAT GETS
record. MULTIPLE VSAM KEYS PUT
AN IMPROPER VALUE IN
Operator response DSXKBLST. DSXKBLST=value1,
DSXKBMAX=value2
Notify the system programmer to determine the type
of error indicated by the major and minor (REG15 and
FDBK) codes returned. Explanation
If the module is BNJAPUGR, locid is 01, the majcode The functional get keys service routine BNJAFGKA fills
is 8, and the mincode is 16, then there is a problem a buffer with multiple VSAM keys. The value value1
with the hardware monitor database. Reinitialize the must be greater than 0 and less than or equal to
hardware monitor EVENT or STATISTICAL database. value2.

If the module name starts with DSIVSMX or DSIVSAM, Message Variables


the majcode is 8, and the mincode is 44, then the
logical record size is larger than 32000, which is the

358 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


operatorid System action
The terminal operator identifier. If no operator is
defined, this value is NONE. Processing stops on the keys in the buffer but error
data might be displayed using key data from a previous
module buffer operation.
The name of the NetView module that detected
the error.
Operator response
locid
The location within the NetView module that Check for previous error messages and notify the
detected the error. system programmer.
value1
The number of keys in the buffer. System programmer response
value2 Check the return code from BNJAFGKA. This return
The maximum number of keys allowed in the code can mean an error return on basic input/output
buffer. operation from BNJAIORA, parameter, or a key length
that is not valid.
System action BNJ026I operatorid module locid THE
No further processing is attempted on the keys in the SERVICE ROUTINE THAT
buffer, but error information might be displayed using EXTRACTS COUNTS FROM ERROR
keys received in a previous buffer operation. RECORDS RETURNED A RETURN
CODE OF retcode
Operator response
Explanation
Notify the system programmer.
BNJAXPRA cannot identify the error record passed to
it.
System programmer response
Message Variables
Check the indicated module for an error in requesting
the service routine. If this fails, check the service operatorid
routine for an error. The terminal operator identifier. If no operator is
defined, this value is NONE.
BNJ025I operatorid module locid THE
SERVICE ROUTINE THAT GETS module
MULTIPLE VSAM KEYS RETURNED The name of the NetView module that detected
A RETURN CODE OF 16 the error.
locid
Explanation The location within the NetView module that
detected the error.
An error condition was detected in module at the retcode
functional get keys routine, BNJAFGKA, giving a return The BNJAXPRA return code.
code of 16, which indicates a processing failure.
Message Variables System action
operatorid Processing stops and the record is not written to the
The terminal operator identifier. If no operator is database.
defined, this value is NONE.
module
Operator response
The name of the NetView module that detected
the error. Notify the system programmer.
locid
The location within the NetView module that System programmer response
detected the error.
Check the following return codes given for BNJAXPRA:
4
Input option type not valid.

Chapter 4. BNJ Prefix Messages 359


8 Message Variables
RECFMS record type not valid.
operatorid
12 The ID of the terminal operator. If no operator is
RECMS record type not valid. defined, the value is NONE.
BNJ028I operatorid module locid INVALID module
RESOURCE name/type resource/ The name of the NetView module that detected
restype IN RECORD the error.
locid
Explanation The location within the NetView module where the
error was detected.
The module module detected unprintable characters
in a resource name or a resource type. Messages keyval
BNJ049I and BNJ050I follow this message. The VSAM key that is not valid.

Message Variables
System action
operatorid
System processing ends. Data services command
The terminal operator identifier. If no operator is
processor (DSCP) processing ends. Error message
defined, this value is NONE.
BNJ137I is issued to indicate a failure in service.
module
The name of the NetView module that detected
the error. Operator response
locid Notify the system programmer.
The location within the NetView module that
detected the error. System programmer response
name/type
Perform the following procedures:
The resource name or resource type that was not
valid. 1. Print the database and inspect it.
resource/restype 2. Save the database.
The resource name or resource type that was not 3. Re-create the database.
valid and that was taken from the record displayed
by BNJ049I. See IBM Z NetView Installation: Getting Started for
more information.
System action BNJ030I mm/dd hh:mm type ALERT
RECEIVED FROM THE FOLLOWING
Processing stops and the record is not written to the
RESOURCE: resource
database.

Explanation
Operator response
An alert was generated by threshold analysis or by the
Notify the system programmer.
NetView program.
Message Variables
System programmer response
mm/dd hh:mm
Determine the resource that generated the record,
The date and time the alert was issued. The
obtain a copy of the associated BNJ049I message
date and time formats depend on the TRANSMSG
from the network log, and contact IBM Software
member, when in effect, and on the date and
Support.
time operands of the DEFAULTS and OVERRIDE
BNJ029I operatorid module locid commands.
UNEXPECTED VSAM KEY keyval type
FOUND The type of alert that was issued.
resource
Explanation The resource name.
The specified key of the returned VSAM record is not
valid. The database is damaged.

360 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Message Variables

Processing continues. operatorid


The terminal operator identifier. If no operator is
defined, this value is NONE.
Operator response
module
Take appropriate action according to the information The name of the NetView module that detected
shown in the alert. the error.
BNJ031I operatorid module locid VSAM locid
DETAIL RECORDS FOR KEY keyval The location within the NetView module that
ARE NOT FOUND ON THE DATA detected the error.
BASE retcode
The NetView return code.
Explanation
When the module module finds multiple detail records System action
for the key specified, it uses a VSAM PUT operation to Data services command processor (DSCP) processing
write the temporary record. After the PUT operation is stops.
complete, the module attempts to get the remaining
detail records. You receive this message when the
module cannot find the remaining detail records. Operator response
Message Variables Notify the system programmer.

operatorid
The terminal operator identifier. If no operator is System programmer response
defined, this value is NONE. Increase the region size for the command facility and
module restart the hardware monitor procedure. See IBM Z
The name of the NetView module that detected NetView Programming: Assembler for the meaning of
the error. the return code.
locid BNJ033I operatorid module locid DSIMQS
The location within the NetView module that PASSED BACK A RETURN CODE OF
detected the error. retcode
keyval
The VSAM key value. Explanation
While attempting to send data to the Presentation
System action Services Command Processor (PSCP), the NetView
Processing stops for the specific terminal controller. message queuing routine indicated that the message
was not sent successfully.
Operator response Message Variables

Notify the system programmer. operatorid


The terminal operator identifier. If no operator is
defined, this value is NONE.
System programmer response
module
Check the identified module for a calling error. Check The name of the NetView module that detected
the database for missing records or records that are the error.
not valid.
locid
BNJ032I operatorid module locid DSIGET The location within the NetView module that
PASSED BACK A RETURN CODE OF detected the error.
retcode retcode
The NetView return code.
Explanation
The storage allocation routine indicated main storage
is unavailable for a work area.

Chapter 4. BNJ Prefix Messages 361


System action Explanation
Data services command processor (DSCP) processing The indicated length of the key for the requested
stops. record was either less than 1 or greater than the
allowed maximum.
Operator response Message Variables
Notify the system programmer. operatorid
The terminal operator identifier. If no operator is
System programmer response defined, this value is NONE.
module
Check the return code for DSIMQS in IBM Z NetView
The name of the NetView module that detected
Programming: Assembler for the specific type of error.
the error.
BNJ034I operatorid module1 locid THE locid
LOGIC RESUME POINTER The location within the NetView module that
(DSXRESMP) CONTAINS ZEROS. detected the error.
DSXRESMS CONTAINS module2
System action
Explanation
Data services command processor (DSCP) processing
A functional service routine was unable to return stops.
control to the data capturing routine that called it.
The data capturing routine address should be in
DSXRESMP.
Operator response
Message Variables Notify the system programmer.

operatorid
The terminal operator identifier. If no operator is
System programmer response
defined, this value is NONE. Determine the user request and the panel from which
module1 it was made and contact IBM Software Support.
The name of the NetView module that detected BNJ036I operatorid module locid INVALID
the error. INDEX NUMBER nnn DETECTED.
locid THE INDEX NUMBER IS NOT
The location within the NetView module that WITHIN THE RANGE OF THE
detected the error. MAPPING TABLE.
module2
The name of the module that last updated the Explanation
DSXRESMP field.
The record displayed by BNJ049I caused the
processing to set the index number nnn. The value
System action of nnn depends on the system incident reported. This
No further processing is attempted for the outstanding assigned index number was not within the range of
request. an internal table (BNJCMTBA) used by the NetView
program. Messages BNJ049I and BNJ050I follow this
message.
Operator response
Message Variables
Notify the system programmer.
operatorid
The terminal operator identifier. If no operator is
System programmer response defined, this value is NONE.
Determine whether the DSXRESMS field contains a module
valid module name and contact IBM Software Support. The name of the NetView module that detected
the error.
BNJ035I operatorid module locid INVALID
KEY SIZE locid
The location within the NetView module that
detected the error.

362 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


nnn BNJ038I operatorid module locid LOAD
The index number. FAILED FOR ERROR MAPPING
TABLE table ERROR RECORD THAT
System action FOLLOWS WAS NOT RECORDED
ON THE DATA BASE
Processing stops.
Explanation
Operator response
A DSILOD macro returned a nonzero return code for
Record the available information and notify the system module table. Messages BNJ049I and BNJ050I follow
programmer. this message.
Message Variables
System programmer response
operatorid
Determine the user request and the panel from which The terminal operator identifier. If no operator is
it was made, obtain a copy of the associated BNJ049I defined, this value is NONE.
message from the network log, and contact IBM
module
Software Support.
The name of the NetView module that detected
BNJ037I operatorid module locid NO the error.
MAPPING DATA AVAILABLE FOR locid
THE ERROR RECORD THAT The location within the NetView module that
FOLLOWS detected the error.
table
Explanation The mapping table needed to interpret the data
The record displayed by BNJ049I was found to contain record.
data not defined in the mapping table. The assigned
index number is within the range of the table but the System action
contents are hexadecimal zeros. Messages BNJ049I
and BNJ050I follow this message. Processing stops.

Message Variables
Operator response
operatorid
Record the information and notify the system
The terminal operator identifier. If no operator is
programmer.
defined, this value is NONE.
module
The name of the NetView module that detected System programmer response
the error. Determine whether the module table exists in the
locid NetView load library. Obtain a copy of the associated
The location within the NetView module that BNJ049I message from the network log, and contact
detected the error. IBM Software Support.
BNJ039I operatorid module locid
System action XTMREQTY HAS INVALID CODE
code, REQUEST WAS FROM
Processing stops.
APPLICATION applid

Operator response Explanation


Record the record displayed in BNJ049I and notify the
A return code that is not valid was found in XTMREQTY.
system programmer.
Message Variables
System programmer response operatorid
The terminal operator identifier. If no operator is
Determine the user request and the panel from which
defined, this value is NONE.
it was made and contact IBM Software Support.

Chapter 4. BNJ Prefix Messages 363


module Operator response
The name of the NetView module that detected
the error. Browse the network log, looking for message BNJ199I
or BNJ049I. BNJ199I indicates the hardware monitor
locid has no active database. BNJ049I indicates an alert
The location within the NetView module that was rejected by the hardware monitor, so a device in
detected the error. the network might be streaming improper alerts. If you
code cannot find message BNJ040I in the network log, look
The code that is not valid. for the following message numbers:
applid
BNJ006 BNJ009 BNJ010
The application initiating the request.
BNJ011 BNJ028 BNJ036
System action BNJ037 BNJ038 BNJ051
Processing continues. BNJ052 BNJ063 BNJ111
BNJ112 BNJ113 BNJ120
Operator response
BNJ124 BNJ125 BNJ145
Record the information available and notify the system
BNJ174 BNJ175 BNJ176
programmer.
BNJ177 BNJ178 BNJ179
System programmer response BNJ180
Determine the user request and the panel from which
it was made and contact IBM Software Support. Isolate the source of the messages using the
information in the messages. The product-set
BNJ040I MESSAGES FOR INVALID identification (PSID) and resource hierarchy are
ALERTS ARE BEING usually helpful in determining the source of the
SUPPRESSED. POSSIBLE messages.
STREAMING CONDITION
Notify the system programmer.

Explanation
System programmer response
The rate of alerts that are not valid being received
by the hardware monitor has exceeded the thresholds If message BNJ199I is present, the hardware monitor
set on the ERR_RATE statement in the initialization has no active database. Use the SWITCH command
member for the BNJDSERV task. The high rate can to activate either the primary or secondary database.
indicate that a device is streaming alerts, or that Otherwise identify and fix the device or program
the hardware monitor has no active database. See causing the streaming alert condition.
the IBM Z NetView Administration Reference for more BNJ041I operatorid BNJALTPA LOGICAL
information about the ERR_RATE statement. RECORD SIZE IS TOO SMALL

System action Explanation


Suppression of messages associated with alerts that The BNJALTPA service routine input parameters were
are not valid, or with the hardware monitor having set up incorrectly.
no active database continues as long as the number
of messages exceeds the threshold. This message is Message Variables
issued every time a specified number of messages has operatorid
been suppressed. The terminal operator identifier. If no operator is
If a device in the network is streaming alerts, network defined, this value is NONE.
or system performance can be degraded, depending
upon the number of alerts issued and the duration of System action
the streaming condition.
Data services command processor (DSCP) processing
stops.

364 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System programmer response
Notify the system programmer. Determine the user request and the panel from which
it was made and contact IBM Software Support.
System programmer response BNJ044I operatorid BNJALTPA PHYSICAL
Determine the user request and the panel from which RECORD SIZE IS TOO LARGE
it was made and contact IBM Software Support.
Explanation
BNJ042I operatorid BNJALTPA LOGICAL
RECORD SIZE IS TOO LARGE The BNJALTPA service routine input parameters were
set up incorrectly.
Explanation Message Variables
The BNJALTPA service routine input parameters were operatorid
set up incorrectly. The terminal operator identifier. If no operator is
defined, this value is NONE.
Message Variables
operatorid
System action
The terminal operator identifier. If no operator is
defined, this value is NONE. Data services command processor (DSCP) processing
stops.
System action
Operator response
Data services command processor (DSCP) processing
stops. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Determine the user request and the panel from which
it was made and contact IBM Software Support.
System programmer response BNJ045I EXCESSIVE RECORDING
Determine the user request and the panel from which DETECTED. BLOCK SET FOR
it was made and contact IBM Software Support. QUALIFIED RESOURCE: name1
name2 name3 name4 name5
BNJ043I operatorid BNJALTPA PHYSICAL
RECORD SIZE IS TOO SMALL
Explanation
Explanation Excessive hardware monitor event logging rate has
been detected and stopped.
The BNJALTPA service routine input parameters were
Message Variables
set up incorrectly.
name1...name5
Message Variables
The qualified resource name that was used to set
operatorid the rate recording filter.
The terminal operator identifier. If no operator is
defined, this value is NONE.
System action
System action Processing continues.

Data services command processor (DSCP) processing


Operator response
stops.
Notify the system programmer.
Operator response
System programmer response
Notify the system programmer.
Determine the cause of the excessive events. Delete
the filter entry after the problem has been resolved.

Chapter 4. BNJ Prefix Messages 365


BNJ046I record IS AN INVALID If locid is 01, message BNJ020I or BNJ022I will also
INITIALIZATION CARD. IT HAS be sent to the authorized receiver. Read the message
BEEN IGNORED for further assistance.
If locid is 02, message BNJ055I will also be sent to
Explanation the authorized receiver. Read the message for further
assistance.
A value that is not valid was detected on an
initialization statement. If locid is 03, an internal error has occurred. Contact
IBM Software Support.
Message Variables
BNJ048I FILTER ENTRY DOES NOT EXIST
record
FOR COMMAND: command
The initialization statement that is not valid

System action Explanation


You entered an SRF/SRFILTER command to delete a
Processing continues. The initialization statement is
filter, but no entry was found in the filter table to
ignored.
match the request.

Operator response Message Variables

Notify the system programmer. command


A rebuilt version of the SRF/SRFILTER command
that failed
System programmer response
Correct the initialization statement and enter the job System action
again.
The NetView program ignores the command and
BNJ047I operatorid module locid NPDA processing continues.
[PURGE|PRGATT] TERMINATED
ABNORMALLY Operator response
Verify that a filter entry exists in the filter table.
Explanation
You entered a PURGE or PRGATT command that ended BNJ049I record
abnormally.
Explanation
Message Variables
This message follows a hardware monitor message.
operatorid
The preceding message indicates why the hardware
The terminal operator identifier if it is defined
monitor rejected an RU. BNJ049I contains the RU
module that was rejected. If the RU had a deliver header
The name of the NetView module that detected and deliver trailer, these are also displayed. Multiple
the error BNJ049I messages can be used to display the entire
locid RU. The message can be longer than the width of the
The location within the NetView module that console, so use the network log to view the entire RU.
detected the error The last BNJ049I message is followed by BNJ050I.
Message Variables
System action record
Processing of the PURGE or PRGATT command ends. The record that was rejected by the hardware
monitor
Operator response
Operator response
Notify the system programmer.
See the message that preceded this message.
System programmer response BNJ050I END
The database might need to be reinitialized.

366 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
This message indicates the end of a multiline message. Notify the system programmer.
BNJ051I UNRECOGNIZED RECMS FROM:
name/type[,...]. System programmer response
Contact IBM Software Support.
Explanation
BNJ053I module locid ERROR RECORD
The hardware monitor did not recognize the data THAT FOLLOWS IS ACCEPTED BY
in the record maintenance statistics (RECMS). for NETVIEW
more information on RECMS. Messages BNJ049I and
BNJ050I follow this message. Explanation
Message Variables
Module module detected an error in the record
name/type[,...] displayed in BNJ049I. However, the error does
A hierarchy of zero to five name/type pairs, not prevent the NetView program from processing
indicating the source of the error record the record. BNJ053I might be accompanied with
other messages, such as BNH100I, which assist
in determining the error. See the IBM Z NetView
System action
Troubleshooting Guide for more information on the
No further processing is done on this error record. record containing the error. Messages BNJ049I and
BNJ050I follow this message.
Operator response Message Variables
Notify the system programmer. module
The name of the NetView module that detected
System programmer response the error
locid
Record the information in messages BNJ051I and
The location within the NetView module that
BNJ049I and contact IBM Software Support.
detected the error
BNJ052I module locid ERROR RECORD THAT
FOLLOWS IS NOT ACCEPTED BY System action
THIS MODULE
Processing continues for this record.
Explanation
Operator response
Module module detected an error that prevents the
error record displayed in BNJ049I from being mapped. Notify the system programmer.
The error record being examined is not recognized.
See the IBM Z NetView Troubleshooting Guide for more System programmer response
information on the record that cannot be mapped.
Messages BNJ049I and BNJ050I follow this message. Contact IBM Software Support.

Message Variables BNJ054I operatorid module1 locid


SOLICITED DATA WAS RECEIVED
module BUT THE I/O RESUME POINTER
The name of the NetView module that detected (DSXIORSP) CONTAINS ZEROS.
the error DSXIORSS CONTAINS module2
locid
The location within the NetView module that Explanation
detected the error
Module module1 requested solicited data and the
NetView program is receiving it. During the request,
System action
the DSXIORSP should be set to indicate the module
No further processing is done on this error record. that processes the solicited data. The pointer is zero.

Chapter 4. BNJ Prefix Messages 367


operatorid Operator response
The terminal operator identifier. If no operator is
defined, this value is NONE. Notify the system programmer.
module1
The name of the NetView module that detected System programmer response
the error. Determine whether the DSXIORSS field contains a
locid valid module name and contact IBM Software Support.
The location within the NetView module that
BNJ056I operatorid module locid DSCP IS
detected the error.
BEING DRIVEN BY DST BUT DOES
module2 NOT RECOGNIZE THE REQUEST
The last module to initialize DSXIORSP. CODE. DSRBFNCD CONTAINS
fcode
System action
Processing stops for the solicited data. Explanation
The data services task (DST) drives the data services
Operator response command processor (DSCP) for one of four valid
requests. The DSRBFNCD field contains the code fcode
Notify the system programmer. (in hexadecimal) that identifies which request the data
services command processor (DSCP) performs. The
System programmer response value in DSRBFNCD is not one of the four valid codes.
Determine whether the DSXIORSS field contains a Message Variables
valid module name and contact IBM Software Support. operatorid
BNJ055I operatorid module1 locid DATA The terminal operator identifier. If no operator is
FROM THE VSAM DATA BASE WAS defined, this value is NONE.
RECEIVED BUT THE I/O RESUME module
POINTER (DSXIORSP) CONTAINS The name of the NetView module that detected
ZEROS. DSXIORSS CONTAINS the error.
module2 locid
The location within the NetView module that
Explanation detected the error.
Module module1 issued a VSAM GET for data and the fcode
NetView program is receiving it. During the request, The unrecognized request code.
the DSXIORSP field should be set to indicate the
module that processes the record. The pointer is zero. System action
Message Variables The data services command processor (DSCP) returns
operatorid control to the NetView DST without taking action on
The terminal operator identifier. If no operator is the request.
defined, this value is NONE.
module1 Operator response
The name of the NetView module that detected Notify the system programmer.
the error.
locid
System programmer response
The location within the NetView module that
detected the error. Verify that the DST is setting the correct request
module2 code for the DSCP. If it is not, contact IBM Software
The last module to initialize DSXIORSP. Support.
BNJ057I operatorid module1 locid RETURN
System action CODE PASSED BACK TO DSCP
CONTROL IS INVALID. RETURN
Processing stops for the record. CODE IS retcode. DSXIORSS

368 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CONTAINS module2. DSXRESMS module1
CONTAINS module3. The name of the NetView module that detected
the error.
Explanation locid
The location within the NetView module that
An internal failure has occurred in data services detected the error.
processing.
typid
Message Variables The record type that is not valid.
operatorid module2
The terminal operator identifier. If no operator is The module that passed the record type that is not
defined, this value is NONE. valid.
module1
The name of the NetView module that detected System action
the error.
No solicitation is attempted.
locid
The location within the NetView module that
detected the error. Operator response
retcode Notify the system programmer.
The NetView return code.
module2 System programmer response
The module issuing the I/O.
Determine the user request and the panel from which
module3 it was made and contact IBM Software Support.
The return module.
BNJ059I operatorid module locid MODULE
CANNOT GET REQUESTED
System action STORAGE. REGISTER 15
Processing continues. CONTAINS retcode. THE SIZE OF
STORAGE REQUESTED WAS nnnn
Operator response
Explanation
Record the information available and notify the system
programmer. The module requested nnnn bytes of storage using the
DSIGET macro instruction. Register 15 contains the
return code from DSIGET.
System programmer response
Message Variables
Determine the user request and the panel from which
it was made and contact IBM Software Support. operatorid
The terminal operator identifier. If no operator is
BNJ058I operatorid module1 locid MODULE defined, this value is NONE.
CANNOT SOLICIT ERROR RECORD
BECAUSE RECORD TYPE typid IS module
INVALID. DSXRESMS CONTAINS The name of the NetView module that detected
module2 the error.
locid
Explanation The location within the NetView module that
detected the error.
Module module2 solicited data using the NetView retcode
REQMS command from secondary terminal The NetView macro return code (REG15).
controllers. The record type typid passed to this
module is not a valid record type. nnnn
The number of storage bytes.
Message Variables
operatorid System action
The terminal operator identifier. If no operator is
defined, this value is NONE. The solicitation is not performed. Processing
continues.

Chapter 4. BNJ Prefix Messages 369


Operator response BNJ061I operatorid module1 locid
SOLICITED DATA WAS RECEIVED
Notify the system programmer. BUT THE RESPONSE CODE IS
INVALID. DSRBRCMI CONTAINS
System programmer response value1. DSXSNAME CONTAINS
module2.
See the DSIGET macro documentation in IBM Z
NetView Programming: Assembler for information on
the specific error. Explanation
BNJ060I operatorid module1 locid Solicited data is being sent from the DST to the data
DSIZCSMS MACRO RETURNED services command processor (DSCP). The DST stores a
THE ERROR RETURN CODES code in the DSRBRCMI field to indicate if the solicited
OF MAJOR CODE majcode AND data requested is being received or if a negative
MINOR CODE mincode. DSXSNAME response is being sent.
CONTAINS module2 Message Variables
operatorid
Explanation The terminal operator identifier. If no operator is
Module module1 issued the DSIZCSMS macro. The defined, this value is NONE.
return codes majcode and mincode indicate an error. module1
Major code and minor code are also known as REG15 The name of the NetView module that detected
and FDBK, respectively. the error.
Message Variables locid
The location within the NetView module that
operatorid
detected the error.
The terminal operator identifier. If no operator is
defined, this value is NONE. value1
The response code that is not valid.
module1
The name of the NetView module that detected module2
the error. The module that called the solicitation modules.
locid
The location within the NetView module that System action
detected the error.
The solicited data is not recorded on the SNA
majcode database. No other attempt for solicitation is made for
The NetView return code (REG15). this request.
mincode
The NetView return code (FDBK). Operator response
module2
Notify the system programmer.
The module that called the solicitation modules.

System programmer response


System action
See the DSIZCSMS documentation in IBM Z NetView
Solicitation is not attempted. Programming: Assembler for information on the
specific error. You can use the DSXRESMS to identify
Operator response the module that called the solicitation modules if the
error is an interface problem.
Notify the system programmer.
BNJ062I operatorid module locid THE VSAM
System programmer response FUNCTIONAL ERASE MODULE
PASSED BACK A COMPLETION
See the DSIZCSMS documentation in IBM Z NetView CODE OF 16
Programming: Assembler for information on the
specific error. You can use the DSXRESMS to identify
Explanation
the module that called the solicitation modules if the
error is an interface problem. The functional erase service routine BNJAFERA
detected a VSAM error while attempting to erase

370 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


VSAM records. When it calls this module, it passes a System programmer response
completion code of 16.
Investigate the MSU to determine why it is being
Message Variables rejected.
operatorid BNJ065I operatorid module1 locid
The terminal operator identifier. If no operator is SOLICITATION RESULTED IN
defined, this value is NONE. A SNA NEGATIVE RESPONSE
module BUT THE SENSE CODE IS
The name of the NetView module that detected INVALID. TIDCBSNS CONTAINS
the error. aaa. DSXRESMS CONTAINS
locid module2
The location within the NetView module that
detected the error. Explanation
You issued a solicitation that resulted in an SNA
System action negative response. The NetView program does not
Processing continues for this request. recognize the sense code that indicated the reason for
the negative response.

Operator response Message Variables

Notify the system programmer. operatorid


The terminal operator identifier. If no operator is
defined, this value is NONE.
System programmer response
module1
Check the return code for BNJAFERA. A return code The name of the NetView module that detected
of 16 indicates an error return on basic input/output the error.
operation from BNJAIORA. It can also indicate an locid
incorrect input parameter. The location within the NetView module that
BNJ063I module locid THE MSU RECORD detected the error.
THAT FOLLOWS IS NOT ACCEPTED aaa
BY NPDA The contents of TIDCBSNS.
module2
Explanation The module that called the solicitation module.
The MSU record being processed by module module is
not acceptable to the hardware monitor. System action
Message Variables Processing continues.
module
The name of the NetView module that detected Operator response
the error. Notify the system programmer.
locid
The location within the NetView module that
System programmer response
detected the error.
Contact IBM Software Support.
System action BNJ066I record IS IGNORED. AN IMPROPER
No further processing is done on the current MSU DATA TYPE WAS DETECTED
record.
Explanation
Operator response A wrap count initialization statement contains an
Notify the system programmer. improper or missing data type. Examples of valid data
types are EV and AL. See the W (Wrap) statement
definition in IBM Z NetView Programming: Assembler
for more information.

Chapter 4. BNJ Prefix Messages 371


Message Variables module1
The name of the NetView module that detected
record
the error.
The initialization statement that is not valid
locid
The location within the NetView module that
System action detected the error.
Processing continues. module2
The module the NetView program cannot find.
Operator response
Notify the system programmer. System action
Processing of the presentation services command
System programmer response processor (PSCP) request stops.

Correct the initialization statement and recycle the


BNJDSERV task. Operator response
BNJ068I record IS INVALID. RTYPE Notify the system programmer after recording both
PARAMETER IS REQUIRED FOR module names.
EV AND ST OPTIONS OF THE W
(WRAP) STATEMENT System programmer response
Ensure the module is in the proper library. If the name
Explanation is not in the list of NetView data capture modules,
The resource type (RTYPE) parameter is missing from contact IBM Software Support.
an EV or ST wrap count initialization statement. BNJ070I RESOURCE NAME puname IN
Message Variables REQMS COMMAND IS INVALID

record
The initialization statement that is not valid Explanation
The puname specified in the REQMS command is
System action missing or is syntactically incorrect.

The initialization statement is ignored and processing Message Variables


continues. puname
The physical unit name
Operator response
Notify the system programmer. System action
The NetView program ignores the command and
System programmer response processing continues.

Correct the error and resubmit the job.


Operator response
BNJ069I operatorid module1 locid MODULE
NAMED IN PSCP REQUEST Supply or correct the puname and enter the command
module2 COULDN'T BE FOUND again.
BNJ071I record IS AN INVALID CTL
Explanation CARD. WRAP/RATIO CARD COUNT
IS NON-NUMERIC OR NOT
The NetView program cannot find the module PRECISELY THREE DIGITS. ALL
module2. HARDWARE MONITOR WRAP/
Message Variables RATIO INITIALIZATION CARDS
WILL BE IGNORED
operatorid
The terminal operator identifier. If no operator is
defined, this value is NONE.

372 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
The first input statement to BNJAPAMA in the The statement is ignored and processing continues.
initialization file was not recognized as the control
statement. Operator response
Message Variables
Notify the system programmer. If you need reports
record generation logging and the error was in the REPORTS
The initialization statement that is not valid statement, enter the REPORTS ON command from the
hardware monitor console as soon as the NetView
program is active.
System action
The remaining initialization statements are ignored. System programmer response
Correct the error and enter the job again.
Operator response
Notify the system programmer. BNJ074I record MUST HAVE A RESOURCE
TYPE OF LINE, CTRL, LCTL, LDEV,
LINK_ATT OR CHAN_ATT.
System programmer response
Correct the error and restart the task. Explanation
BNJ072I record MUST HAVE A DATA TYPE A resource type other than LINE, CTRL, LCTL, LDEV,
OF AL, EV, OR ST LINK_ATT, or CHAN_ATT was specified on an error-to-
traffic ratio initialization statement.
Explanation Message Variables
A data type of other than AL, EV, or ST was found on a record
wrap count initialization statement. The initialization statement that is not valid
Message Variables
System action
record
The initialization statement that is not valid Processing continues.

System action Operator response


Processing continues. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Correct the error and enter the job again.
BNJ075I record IS INVALID. THE COUNT
System programmer response IS NOT NUMERIC OR IS GREATER
Correct the error and enter the job again. THAN 3 DIGITS

BNJ073I record IS INVALID. W OR R OR


Explanation
REPORTS NOT GIVEN AS FIRST
PARAMETER A wrap count was either not specified or the specified
value is not valid on an initialization statement.
Explanation Message Variables
The first parameter of a reports, wrap, or ratio record
statement was not REPORTS or a W or an R. The initialization statement that is not valid
Message Variables
System action
record
The initialization statement that is not valid Processing continues.

Chapter 4. BNJ Prefix Messages 373


Operator response System programmer response
Notify the system programmer. Correct the error next time you update BNJMBDST.
BNJ078I NPDA INITIALIZATION CARDS
System programmer response ARE NOT IN PROPER SEQUENCE.
Correct the error and enter the job again. record WAS ENCOUNTERED
BEFORE THE CONTROL CARD
BNJ076I record IS INVALID. THE RATIO IS
GREATER THAN 250.
Explanation
Explanation The initialization statements specifying wrap count
values were out of sequence.
An error-to-traffic ratio value that is not valid was
Message Variables
specified on an initialization statement.
record
Message Variables
The initialization statement which is out of
record position.
The initialization statement that is not valid
System action
System action
The initialization statements are ignored.
Processing continues.
Operator response
Operator response
Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response
Correct the error and enter the job again.
Correct the error and enter the job again.
BNJ079I record HAS BEEN IGNORED.
BNJ077I record CONTAINS EXTRANEOUS MULTIPLE CARDS HAVE BEEN
PARAMETERS. THE CARD ENCOUNTERED.
HAS BEEN PROCESSED AND
EXTRANEOUS PARAMETERS HAVE
Explanation
BEEN IGNORED.
There is a duplicate initialization statement in the
Explanation hardware monitor initialization table, BNJMBDST.
Message Variables
There is an unnecessary parameter on an initialization
statement in the hardware monitor initialization table, record
BNJMBDST. The duplicate initialization statement.
Message Variables
System action
record
The initialization statement on which the The NetView program ignores the duplicate statement
unnecessary parameter appears. and processing continues.

System action Operator response


The NetView program ignores the unnecessary Notify the system programmer.
parameter and processing continues.
System programmer response
Operator response
Correct the error next time you update BNJMBDST.
Notify the system programmer.
BNJ080I module - BUFFER SIZE=bb, SLOT
SIZE=sss

374 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
When the hardware monitor procedure is started, The parameter field is missing. The initializer module
the initializer module module issues this message to BNJLINTB issues this message to the system operator;
identify the value used for the buffer size and the slot it is for MVS only.
size. The buffer size can be 8K, 12K, 16K, 20K, or
24K. The slot size can be 200 or 300 bytes. These System action
parameters are entered in the PARM field of the EXEC
statement in the hardware monitor procedure. Initialization continues, using defaults of an 8K buffer
size and a 300-byte slot size.
Message Variables
module Operator response
The initializer module.
Include the parameter field in the exec statement
bb
of the hardware monitor procedure and rerun the
The buffer size.
procedure. The buffer size can be 8K, 12K, 16K, 20K,
sss or 24K; the slot size can be 200 or 300 bytes.
The slot size.
BNJ083I BNJLINTB - STORAGE FOR
GLOBAL BUFFER NOT AVAILABLE
System action
Initialization continues and uses the buffer size and Explanation
slot size listed in the message.
The initializer module detected an error while
BNJ081I module - pos PARAMETER attempting to allocate storage in subpool 231 using
INVALID; USING DEFAULT a GETMAIN macro.

Explanation System action


This message is for MVS only. When the hardware Control is returned to the operating system.
monitor procedure is started, the initialization module
issues this message in the pos parameter (either
FIRST or SECOND). The buffer size can be 8K, 12K, Operator response
16K, 20K, or 24K. The slot size can be 200, 250, or Notify the system programmer.
300 bytes. These parameters are entered in the PARM
field of the EXEC statement in the hardware monitor
procedure.
System programmer response
Message Variables Contact IBM Software Support.

module BNJ084I xxxxxxxx ACTUAL WRAP/RATIO


The initialization module. CARDS SUBMITTED ARE GREATER
THAN SPECIFIED ON CTL CARD
pos
The position of the incorrect parameter, either
FIRST or SECOND. Explanation
This message is for MVS only. The actual number of
System action W or R statements submitted to the NetView initializer
exceeds the values defined in the CTL statement. This
Initialization continues using the defaults (8K buffer message appears for each extra W and R statement.
size and 300-byte slot size).
Message Variables
Operator response xxxxxxxx
The contents of the extra statement.
Correct the PARM field in the EXEC statement of the
hardware monitor procedure and rerun the procedure.
System action
BNJ082I BNJLINTB - NO INPUT PARMS,
USING DEFAULTS Processing returns to the operating system.

Chapter 4. BNJ Prefix Messages 375


Operator response Operator response
Notify the system programmer. Notify the system programmer. If you need reports
generation logging, enter the REPORTS ON command
System programmer response from the hardware monitor master console as soon as
the NetView program is active.
Correct the value defined in the CTL statement to
match the actual number of W or R statements and
System programmer response
enter the job again.
Correct the error and enter the job again, if necessary.
BNJ085I record IS INVALID. LOGGING
FOR REPORT GENERATION IS BNJ087I HARDWARE MONITOR DEFAULT
DISABLED RESOURCE TYPES USED. INVALID
HEX CODE: code
Explanation
Explanation
The NetView program found an error in the REPORTS
statement. A nonhexadecimal value was found while reading the
member BNJRESTY from the data set BNJPNL2.
Message Variables
Message Variables
record
The initialization statement that is not valid code
The hexadecimal code that is not valid.
System action
System action
The statement that is not valid is ignored, the
reports generation logging facility is turned OFF, and The resource types are not taken from BNJRESTY, but
processing continues. instead are read from an internal table.

Operator response Operator response


Notify the system programmer. If you need reports Notify the system programmer.
generation logging, enter the REPORTS ON command
from the hardware monitor master console as soon as System programmer response
the NetView program is active.
Edit BNJRESTY and correct the nonhexadecimal value
in question. Ensure that all remaining codes consist of
System programmer response
hexadecimal characters. To pick up the resource types,
Correct the error and enter the job again, if necessary. enter the RTTBL command.
BNJ086I record CONTAINS AN BNJ088I operatorid module locid MODULE
EXTRANEOUS PARAMETER. NAMED IN PSCP REQUEST aaa
LOGGING FOR REPORTS COULDN'T BE FOUND
GENERATION IS DISABLED
Explanation
Explanation
The presentation services command processor (PSCP)
The NetView program found an unnecessary cannot find the requested module.
parameter in the REPORTS statement.
Message Variables
Message Variables
operatorid
record The terminal operator identifier (if no operator is
The initialization statement that is not valid defined, this value is NONE).
module
System action The name of the NetView module that detected
the error.
The statement that is not valid is ignored, the
reports generation logging facility is turned OFF, and
processing continues.

376 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


locid BNJ091I HARDWARE MONITOR DEFAULT
The location within the NetView module that RESOURCE TYPES USED. macro
detected the error. RC= retcode
aaa
The PSCP request. Explanation
A nonzero return code was received while attempting
System action to read the hardware monitor resource types from
Processing continues. member BNJRESTY in data set BNJPNL2.
Message Variables
Operator response macro
Record the information available and notify the system The macro from which the nonzero return code
programmer. was received.
retcode
System programmer response The return code.

Determine the user request and the panel from which


it was made and contact IBM Software Support.
System action
The resource types are not taken from BNJRESTY, but
BNJ089I operatorid module locid MODULE
instead are read from an internal table.
NAMED IN PSCP REQUEST aaa
COULDN'T BE FOUND
Operator response
Explanation Notify the system programmer.
The presentation services command processor (PSCP)
cannot find the requested module. System programmer response
Message Variables See IBM Z NetView Programming: Assembler to locate
the return codes for the macro that failed. To pick up
operatorid
the resource types, enter the RTTBL command.
The terminal operator identifier (if no operator is
defined, this value is NONE). BNJ092I operatorid command COMMAND
module REJECTED - SECONDS INVALID IN
The name of the NetView module that detected CONSTANT TABLE, secs
the error.
locid Explanation
The location within the NetView module that The number of seconds placed in the NetView
detected the error. program's constants module is not valid. The number
aaa of seconds placed in the constants module is the
The PSCP request. maximum time that the NetView program will keep a
solicitation command outstanding, waiting for a reply
System action to the command.

Processing continues. Message Variables


operatorid
Operator response The terminal operator identifier.
command
Record the information available and notify the system
The solicitation command that was issued by the
programmer.
terminal operator.
secs
System programmer response The actual number of seconds in the constant
Determine the user request and the panel from which table.
it was made and contact IBM Software Support.

Chapter 4. BNJ Prefix Messages 377


System action Explanation
Command processing stops. A LOAD was issued for BNJVMA76, but the module
cannot be loaded. The NetView hardware monitor local
Operator response support is not available.

Notify the system programmer.


System action
System programmer response Initialization continues, but the NetView hardware
monitor local device support will not be available.
Correct the number of seconds in the constants
module, DSICTMOD.
Operator response
BNJ093I operatorid command COMMAND Notify the system programmer.
CANCELED. NO RESPONSE FROM
resource
System programmer response
Explanation Verify that the hardware monitor LOADLIB is within
the LOADLIB concatenation in the NETSTRT command
The maximum amount of time that the NetView list. Check the hardware monitor LOADLIB to verify
program will wait for a reply to the solicitation that BNJVMA76 is not link-edited. If not, link edit
command has been exceeded. The amount of time to BNJVMA76 into the hardware monitor LOADLIB.
wait for the reply is specified in the NetView constants
module, DSICTMOD. BNJ095I BNJLINTV - UNABLE TO
ESTABLISH IUCV CONNECTION:
Message Variables
ppp RC retcode
operatorid
The terminal operator identifier. Explanation
command
The solicitation command that was issued by the BNJLINTV was unable to establish an IUCV set
terminal operator. or connection. The NetView hardware monitor local
device support will not be available.
resource
The resource names to which the command was Message Variables
issued. ppp
The IUCV command issued.
System action retcode
The NetView program canceled the command. The return code.
Command processing stops.
System action
Operator response Initialization continues, but the NetView hardware
Notify the system programmer. monitor local device support will not be available.

System programmer response Operator response


Determine why the resource did not send a reply to the Notify the system programmer.
NetView program, or increase the amount of time in BNJ096I BNJLINTV - LOCAL SUPPORT NOT
the NetView constants module to wait for a reply. ACTIVATED
BNJ094I BNJLINTV - LOADING OF
BNJVMA76 FAILED. LOCAL Explanation
SUPPORT NOT ACTIVATED.
BNJLINTV was unable to establish an IUCV *LOGREC.
The NetView hardware monitor local device support
will not be available. Verify that the NetView directory
contains an IUCV *LOGREC entry.

378 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action name
The resource name.
Initialization continues, but the NetView hardware
monitor local device support will not be available.
System action
Operator response Processing continues.

Notify the system programmer.


Operator response
BNJ097I BNJLINTV - LOCAL SUPPORT HAS
BEEN TERMINATED Determine the status of the resource and enter the
command again, if appropriate.

Explanation BNJ103I SOLICITED RESOURCE name IS


NOT RECOGNIZED BY THE ACCESS
BNJLINTV was not connected because the NetView METHOD
hardware monitor local device support has been
ended.
Explanation
System action The resource is not recognized by the access method.

Initialization continues. Message Variables

BNJ098I BNJLINTV - IUCV INITIALIZATION name


HAS COMPLETED The resource name.

Explanation System action


BNJLINTV was able to establish an IUCV *LOGREC Processing continues.
path.
Operator response
System action Notify the system programmer.
Initialization continues.
BNJ101I REQUEST TO RESOURCE name
System programmer response
HAS BEEN SENT Determine from the configuration tables whether the
correct resource name was specified.
Explanation BNJ104I SOLICITED RESOURCE name
The solicitation for data from the specified resource DOES NOT SUPPORT
was successful. SOLICITATION

Message Variables
Explanation
name
The resource name. The access method or the specified resource does not
support solicitation.

System action Message Variables

Processing continues. name


The resource name.
BNJ102I SOLICITED RESOURCE name IS
NOT AVAILABLE
System action
Explanation Processing continues.

The specified resource is not connected or otherwise BNJ105I INSUFFICIENT RESOURCE


available for error solicitation. DETECTED DURING
SOLICITATION OF RESOURCE
Message Variables name

Chapter 4. BNJ Prefix Messages 379


Explanation BNJ108I operatorid module locid
REQUESTED SOLICITATION WITH
The specified resource is unable to respond to the VARIABLE DATA WITH LENGTH OF
solicitation. It is busy or has insufficient buffer space datalen, LENGTH MUST BE 247 OR
to make a response. LESS
Message Variables
name Explanation
The resource name. An internal error occurred while the NetView program
was building an REQMS record for solicitation.
System action Message Variables
Processing continues. operatorid
The terminal operator identifier (if no operator is
Operator response defined, this value is NONE).
Enter the command again. module
The name of the NetView module that detected
BNJ106I SOLICITED RESOURCE name IS IN the error.
FUNCTION ACTIVE STATE
locid
The location within the NetView module that
Explanation detected the error.
The specified resource is unable to respond to the datalen
solicitation because it is in an active state. The incorrect data length.
Message Variables
System action
name
The resource name. Solicitation is ignored and processing continues.

System action Operator response


Processing continues. Notify the system programmer.

Operator response System programmer response


Enter the command again. Note the attempted request and contact IBM Software
Support.
BNJ107I SOLICITATION FOR RESOURCE
name IS NOT SUCCESSFUL BNJ109I operatorid module locid
XTMCODE HAS INVALID CODE
code, REQUEST WAS FROM
Explanation APPLICATION applid
The solicitation of the specified resource did not
complete successfully. Explanation
Message Variables The cross-task message code issued by the specified
name application is not valid.
The resource name. Message Variables
operatorid
System action The terminal operator identifier (if no operator is
Processing continues. defined, this value is NONE).
module
Operator response The name of the NetView module that detected
the error.
Look for a BNJ-prefix message issued to the
authorized message receiver that explains the failure.
Correct the situation explained in the message.

380 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


locid module
The location within the NetView module that The name of the NetView module that detected
detected the error. the error.
code locid
The code that is not valid The location within the NetView module that
applid detected the error.
The application making the request.
System action
System action No further processing is done on this error record.
Processing continues.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Determine the device generating the NMVT record,
Contact IBM Software Support. obtain a copy of the associated BNJ049I message
from the network log, and contact IBM Software
BNJ110I MESSAGE OPTION PARAMETER c Support.
IN REQMS COMMAND IS INVALID
BNJ112I module locid THE FOLLOWING
MSU RECORD IS INVALID. IT HAS
Explanation NO VALID STATISTICAL COUNTER
You entered a message option parameter that was not SUBVECTOR
valid. The message option parameters allowed with
the REQMS command are Y or N. Explanation
Message Variables Module module has a table of valid management
c services unit (MSU) subvector types. The error record
The parameter that is not valid. being examined has a missing statistical counter
subvector. See Systems Network Architecture Formats
for more information on MSU records. Messages
System action BNJ049I and BNJ050I follow this message.
The REQMS command is ignored. Message Variables
module
Operator response The name of the NetView module that detected
Enter the command again using the correct message the error.
option. See the NetView online help for an explanation locid
of the command. The location within the NetView module that
detected the error.
BNJ111I module locid THE FOLLOWING
MSU RECORD HAS AN INVALID
OR MISSING PRODUCT SET ID System action
SUBVECTOR
No further processing is done on this error record.

Explanation Operator response


Module module has a table of valid network
Notify the system programmer.
management vector transport (NMVT) subvector
types. The error record being examined has a missing
product set ID subvector or one that is not valid. System programmer response
See Systems Network Architecture Formats for more
Determine the device generating the MSU record,
information on NMVT records. Messages BNJ049I and
obtain a copy of the associated BNJ049I message
BNJ050I follow this message.
from the network log, and contact IBM Software
Message Variables Support.

Chapter 4. BNJ Prefix Messages 381


BNJ113I module locid THE FOLLOWING MSU System action
RECORD IS INVALID. IT HAS NO
BASIC ALERT VECTOR Processing continues but the NetView reports
generation logging facility is turned OFF.

Explanation
Operator response
Module module has a table of valid management
services unit (MSU) subvector types. The error record Notify the system programmer.
being examined has a missing basic alert subvector.
See Systems Network Architecture Formats for more System programmer response
information on MSU records. Messages BNJ049I and
Increase the storage available for the NetView
BNJ050I follow this message.
program.
Message Variables
BNJ115I operatorid BNJABLEA locid
module REPORTS GENERATION LOGGING
The name of the NetView module that detected FAILURE. RC = 24
the error.
locid Explanation
The location within the NetView module that
detected the error. An error condition was detected in module BNJABLEA.
The NetView macro DSIWLS (reports generation
logging interface) detected an identifier (parameter)
System action that is not valid. See IBM Z NetView Programming:
No further processing is done on this error record. Assembler for more information on this NetView
macro.
Operator response Message Variables
Notify the system programmer. operatorid
The terminal operator identifier (if no operator is
defined, this value is NONE).
System programmer response
locid
Determine the device generating the MSU record, The location within the NetView module that
obtain a copy of the associated BNJ049I message detected the error.
from the network log, and contact IBM Software
Support.
System action
BNJ114I operatorid BNJABLEA locid
REPORTS GENERATION LOGGING Processing continues but this report generation record
TERMINATED BECAUSE NO was not logged. The NetView reports generation
STORAGE IS AVAILABLE facility remains ON. This message is not repeated for
consecutive occurrences of the same error. It repeats
only after finding a different error, logging a record, or
Explanation issuing the command REPORTS ON.
An error condition was detected in module BNJABLEA.
An attempt to write a NetView reports record failed Operator response
because of insufficient storage.
Notify the system programmer.
Message Variables
operatorid System programmer response
The terminal operator identifier (if no operator is
Determine the cause of macro failure.
defined, this value is NONE).
locid BNJ116I operatorid BNJABLEA locid
The location within the NetView module that REPORTS GENERATION LOGGING
detected the error. FAILURE. RC=28

382 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation retcode
The NetView macro return code.
While attempting to send data to the reports
generation logging task, the NetView message queuing
routine (DSIMQS) indicated that the message was not System action
sent successfully. The most common reason for this Processing continues but this reports generation
failure is that the NetView logging task is not active. record was not logged. The reports generation facility
This can be the logging task provided by NetView, remains ON. This message does not repeat for
or it can be a user-supplied logging task. See IBM Z consecutive occurrences of the same error. It repeats
NetView Programming: Assembler for more information only after finding a different error, logging a record, or
on DSIMQS. See the non-zero DSIMQS return codes issuing the command REPORTS ON.
for all the possible reasons that DSIMQS cannot
successfully send the message.
Operator response
Message Variables
Note the return code and notify the system
operatorid programmer.
The terminal operator identifier (if no operator is
defined, this value is NONE).
System programmer response
locid
The location within the NetView module that See IBM Z NetView Programming: Assembler for the
detected the error. meaning of the DSIWLS return code.
BNJ118I operatorid BNJAGEVA locid LOAD
System action FAILURE ATTEMPTING TO LOAD
BNJCEVTA
Processing continues but this report generation record
was not logged. The NetView reports generation
facility remains ON. This message does not repeat for Explanation
consecutive occurrences of the same error. It repeats An error condition was detected in module BNJAGEVA.
only after finding a different error, logging a record, or NetView macro DSILOD returned a nonzero return
issuing the command REPORTS ON. code when attempting to load module BNJCEVTA
during reports generation logging.
Operator response
Message Variables
Notify the system programmer.
operatorid
The terminal operator identifier (if no operator is
System programmer response defined, this value is NONE).
Determine the cause of the error. locid
The location within the NetView module that
BNJ117I operatorid BNJABLEA locid detected the error.
REPORTS GENERATION LOGGING
FAILURE. RC=retcode
System action
Explanation Processing continues and this reports generation
record is logged. The alert or event description
An error condition was detected in module BNJABLEA returned to module BNJABLEA is (GENERAL
while attempting to use the reports generation logging hh;SPECIFIC hh), where hh is the hexadecimal
interface (DSIWLS). representation of the general and specific codes.
Message Variables
operatorid Operator response
The terminal operator identifier (if no operator is Notify the system programmer.
defined, this value is NONE).
locid System programmer response
The location within the NetView module that
detected the error. Determine the cause of the DSILOD failure. See IBM
Z NetView Programming: Assembler for the meaning of
the return code.

Chapter 4. BNJ Prefix Messages 383


BNJ119I operatorid BNJABLEA locid Operator response
UNABLE TO LOAD BNJALM01
FROM BNJABLEA Notify the system programmer.

Explanation System programmer response


The NetView program detected an error condition in Determine the device generating the record, obtain a
module BNJABLEA. NetView macro DSILOD issued copy of the associated BNJ049I message from the
a nonzero return code when attempting to load network log, and contact IBM Software Support.
module BNJALM01 during reports generation logging BNJ121I operatorid module locid SOLICITED
processing. DATA WAS RECEIVED WITH A
Message Variables NEGATIVE REPLY CODE BUT THE
CODE IS INVALID. THE SENSE
operatorid CODE CONTAINS aaa. DSXRESMS
The terminal operator identifier (if no operator is CONTAINS module2
defined, this value is NONE).
locid Explanation
The location within the NetView module that
detected the error. Solicitation was successful but a negative reply code
was returned because an exception occurred while
running the command. The hardware monitor cannot
System action recognize the reply code.
Processing continues and the reports generation Message Variables
record is logged. However, the field BRFFAIL (failure
cause) is set to N/A (X'00'). operatorid
The terminal operator identifier (if no operator is
defined, this value is NONE).
Operator response
module1
Notify the system programmer. The name of the NetView module that detected
the error.
System programmer response locid
Determine the cause of the DSILOD failure. The location within the NetView module that
detected the error.
BNJ120I module locid THE FOLLOWING aaa
RECORD IS NOT RECOGNIZED BY The contents of the negative reply sense code.
NPDA
module2
The name of the NetView module that called the
Explanation solicitation modules.
Module module received a record type that is
not supported by the NetView program. Messages System action
BNJ049I and BNJ050I follow this message.
Processing continues.
Message Variables
module Operator response
The name of the NetView module that detected
the error. Notify the system programmer.
locid
The location within the NetView module that System programmer response
detected the error. Contact IBM Software Support.
BNJ122I operatorid module locid
System action SOLICITATION WAS SUCCESSFUL
No further processing is done on this error record. BUT THE SUBVECTOR
CONTAINING RESPONSE DATA IS
MISSING

384 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
Solicitation was successful, but X'50' subvector that Determine the device generating the NMVT record,
contains response data is missing. obtain a copy of the associated BNJ049I message
from the network log, and contact IBM Software
Message Variables
Support.
operatorid
The terminal operator identifier (if no operator is BNJ125I module locid THE FOLLOWING
defined, this value is NONE). NMVT RECORD IS INVALID, IT
HAS NO VALID LINK EVENT
module STATUS SUBVECTOR
The name of the NetView module that detected
the error.
Explanation
locid
The location within the NetView module that The module has a table of network management
detected the error. vector transport (NMVT) subvector types that are not
valid. The error record displayed by BNJ049I has a
missing subvector type (X'8A') that is required for the
System action NMVT record to be complete. Messages BNJ049I and
Processing continues. BNJ050I follow this message.
Message Variables
Operator response
module
Notify the system programmer. The name of the NetView module that detected
the error.
System programmer response locid
The location within the NetView module that
Contact IBM Software Support. detected the error.
BNJ124I module locid THE FOLLOWING
NMVT RECORD IS INVALID. System action
IT HAS NO VALID LINK
CONFIGURATION SUBVECTOR No further processing is done on this error record.

Explanation Operator response


The module has a table of network management Notify the system programmer.
vector transport (NMVT) subvector types that are not
valid. The error record displayed by BNJ049I has a System programmer response
missing subvector type (X'52') that is required for the
NMVT record to be complete. Messages BNJ049I and Determine the device generating the NMVT record,
BNJ050I follow this message. obtain a copy of the associated BNJ049I message
from the network log, and contact IBM Software
Message Variables Support.
module BNJ127I MULTIPLE ENTRIES EXIST FOR
The name of the NetView module that detected SPECIFIED RESOURCE; PURGE
the error. NOT PROCESSED. RETRY NPDA
locid PURGE COMMAND FROM AN
The location within the NetView module that NPDA SCREEN, THEN MAKE
detected the error. SELECTION FROM RESULTING
MULTIPLE ENTRIES SCREEN 70A
System action
Explanation
No further processing is done on this error record.
A timer-initiated PURGE command failed because a
multiple-entries condition exists.
Operator response
Notify the system programmer.

Chapter 4. BNJ Prefix Messages 385


System action SRATIO COMMAND FROM AN
NPDA SCREEN, THEN MAKE
The PURGE command is ignored. SELECTION FROM RESULTING
MULTIPLE ENTRIES SCREEN 70A
Operator response
Enter the PURGE command again from a hardware Explanation
monitor screen, and make a selection from multiple- A set ratio (SRATIO) command was issued from a
entries screen 70A. command list and a multiple-entries condition exists.
BNJ128I MULTIPLE ENTRIES EXIST FOR
SPECIFIED RESOURCE - PRGATT System action
NOT PROCESSED. RETRY NPDA
PRGATT COMMAND FROM AN The SRATIO command is ignored.
NPDA SCREEN, THEN MAKE
SELECTION FROM RESULTING Operator response
MULTIPLE ENTRIES SCREEN 70A
Enter SRATIO command again from a hardware
monitor screen, then make a selection from multiple-
Explanation entries screen 70A.
A timer-initiated purge attached (PRGATT) command BNJ131I MULTIPLE ENTRIES EXIST FOR
failed because a multiple-entries condition exists. SPECIFIED RESOURCE - REQUEST
NOT PROCESSED. RETRY NPDA
System action COMMAND FROM AN NPDA
SCREEN, THEN MAKE SELECTION
The PRGATT command is ignored. FROM RESULTING MULTIPLE
ENTRIES SCREEN 70A
Operator response
Enter the PRGATT command again from a hardware Explanation
monitor screen, then make a selection from multiple- A hardware monitor command was issued from a
entries screen 70A. command list and a multiple-entries condition exists.
BNJ129I MULTIPLE ENTRIES EXIST FOR
SPECIFIED RESOURCE - SWRAP System action
NOT PROCESSED. RETRY NPDA
SWRAP COMMAND FROM AN The command is ignored.
NPDA SCREEN, THEN MAKE
SELECTION FROM RESULTING Operator response
MULTIPLE ENTRIES SCREEN 70A
Enter the command again from a hardware monitor
screen, then make a selection from multiple-entries
Explanation screen 70A.
A set wrap (SWRAP) command was issued from a BNJ132I NO DATA EXISTS FOR RESOURCE
command list and a multiple-entries condition exists. SPECIFIED IN PURGE COMMAND

System action Explanation


The SWRAP command is ignored. The resource name is not valid or there is no data for
the specified resource. This message is also issued if a
Operator response resource type of CBUS was specified as an option for
the PURGE command. The adapter address (A) option
Enter the SWRAP command again from a hardware is not valid with a resource type of CBUS.
monitor screen, then make a selection from multiple-
entries screen 70A.
System action
BNJ130I MULTIPLE ENTRIES EXIST FOR
SPECIFIED RESOURCE - SRATIO The PURGE command is ignored.
NOT PROCESSED. RETRY NPDA

386 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Verify database contents and enter the request again This message is issued when hardware monitor
with a valid resource name. commands are issued from within command lists, by
the PPT, or from within sessions with other NetView
BNJ133I NO DATA EXISTS FOR RESOURCE components. This message acts as a substitute for
SPECIFIED IN PRGATT COMMAND message BNJ925I when there is no suitable hardware
monitor screen on which to display the message or
Explanation when the message is for a command that does not
result in a hardware monitor screen display.
The resource name is not valid or there is no data for
the specified resource.
System action
System action The request is ignored.
The purge attached (PRGATT) command is ignored. BNJ137I DATA SERVICES FAILURE IN
PROCESSING LAST COMMAND
Operator response
Explanation
Verify database contents and enter the request again
with a valid resource name. This message is issued when certain hardware monitor
commands are issued from within command lists, by
BNJ134I NO DATA EXISTS FOR SPECIFIED
the PPT, or from within sessions with other NetView
SWRAP COMMAND
components. This message acts as a substitute for
message BNJ950I when there is no suitable hardware
Explanation monitor screen on which to display the message or
when the message is for a command that does not
You issued a set wrap (SWRAP) command from a
result in a hardware monitor screen panel. Your last
command list. The specified resource name is not valid
request for information from the database failed. Error
or there is no data for the command specified.
messages have been issued to the authorized message
receiver.
System action
The SWRAP command is ignored. System action
The request is ignored.
Operator response
Verify database contents and enter the request again, System programmer response
if applicable.
Inspect the network log or syslog for a message
BNJ135I NO DATA EXISTS FOR RESOURCE explaining the failure; for example, message BNJ022I.
SPECIFIED IN SRATIO COMMAND
BNJ138I PURGE OF NPDA DATA BASE IN
PROGRESS
Explanation
You issued a set ratio (SRATIO) command from a Explanation
command list. The specified resource name is not valid
The PURGE/PRGATT command was entered correctly
or there is no data for the specified resource.
and the purge of the hardware monitor database is in
progress. Any other hardware monitor command can
System action be entered after this message is issued.
The SRATIO command is ignored.
System action
Operator response The database is being purged as specified.
Verify database contents and enter the request again BNJ139I PURGE OF 2ND/4TH LEVEL 'ST'
with a valid resource name. RESOURCE WITH TYPE 'LINE' IS
INVALID
BNJ136I NO DATA EXISTS FOR COMMAND
SPECIFIED

Chapter 4. BNJ Prefix Messages 387


Explanation Explanation
The specified resource has a count reflecting the level Your last PURGE or PRGATT command failed because
3 or level 5 attached resources. These counts are a PURGE or PRGATT command is currently in progress.
inaccurate if a purge is performed on this resource, so
purge is not allowed. System action
The NetView program ignores this command and
System action
processing continues.
The request is ignored.
BNJ140I NO RECORDS TO PURGE FOR DATA Operator response
AND DATE SPECIFIED IN THIS Wait for completion of the current PURGE or PRGATT
PURGE COMMAND command and reenter the new PURGE command.
BNJ144I operatorid module locid DSIFRE
Explanation
PASSED BACK A RETURN CODE OF
The PURGE, PRGATT or PURGEDB command was retcode
successfully completed but nothing has been purged
from the hardware monitor database. Explanation
Storage cannot be freed.
System action
Message Variables
The request is ignored.
operatorid
BNJ141I PURGE OF NPDA DATA BASE The terminal operator identifier. If no operator is
COMPLETED. defined, this value is NONE.
module
Explanation The name of the NetView module that detected
The PURGE command was successfully completed. the error.
locid
System action The location in the NetView module that detected
the error.
Processing continues.
retcode
BNJ142I THERE ARE NO RECORDS ON THE The DSIFRE return code.
NPDA DATA BASE PRIOR TO DATE
ENTERED System action
Processing continues.
Explanation
BNJ145I module locid MSU ERROR RECORD
The date entered with the PURGE command
THAT FOLLOWS IS NOT ACCEPTED
was earlier than the hardware monitor database
BY THIS MODULE
initialization date.

System action Explanation


Module module has detected a list of resource names,
Processing for the command ends.
resource types, or both, that is not valid, from an MSU.
Messages BNJ049I and BNJ050I follow this message.
Operator response
Message Variables
Verify dates and retry.
module
BNJ143I PURGE/PRGATT FAILED BECAUSE The name of the NetView module that detected
ANOTHER PURGE IS IN the error.
PROGRESS locid
The location within the NetView module that
detected the error.

388 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Note: The keyword order might change depending on
the alert content.
No further processing is done on this error record.
Message Variables
Operator response aaaa
Alert type.
Notify the system programmer.
bbbb
Alert description.
System programmer response
cccccccc
Obtain a copy of the associated BNJ049I message Alert ID.
from the network log and contact IBM Software dddddddd
Support. Product set ID.
BNJ146I mm/dd hh:mm G TYPE=aaaa eeee
DESC=bbbb ALID=cccccccc Probable causes.
PSID=dddddddd
ffff
PC=eeee,eeee,eeee
Actions.
ACTS=ffff, ... ,ffff
USER=gggg, ... ,gggg;gggg, ... ,gggg gggg
FAIL=hhhh, ... ,hhhh;hhhh, ... ,hhh User causes/actions.
h INST=iiii, ... ,iiii;iiii, ... ,iiii TEXT= hhhh
'jjjjjjjj...jjjj' Failure causes/actions.
HIER=kkkkkkkk,kkkk,kkkkkkkk,kk
iiii
kk, kkkkkkkk,kkkk,kkkkkkkk,
Install causes/actions.
kkkk,kkkkkkkk,kkkk DOMID=lllll -
or - mm/dd hh:mm N TYPE=aaaa jjjj
PSID=dddddddd MAJ=nn MIN=oo Product unique text.
ACT=pp QUAL= 'qqq','qqq','qqq' kkkkkkkk,kkkk
TEXT= 'jjjjjjjj...jjjj' Hierarchy name/type pairs.
HIER=kkkkkkkk,kkkk,kkkkkkkk,kk
lllll
kk, kkkkkkkk,kkkk,kkkkkkkk,
The domain ID of the host that generated this
kkkk,kkkkkkkk,kkkk DOMID=lllll
message and not necessarily of the host that
mm/dd hh:mm R BKID=rrr ACT=pp
originally recorded the record. For alerts forwarded
MIN=oo MAJ=nn TEXT= 'jjjjjjjj...jjjj'
through LUC, the domain ID of the host that
HIER=kkkkkkkk,kkkk,kkkkkkkk,kk
recorded the record is displayed. For records
kk, kkkkkkkk,kkkk,kkkkkkkk,
forwarded through message forwarding, the first
kkkk,kkkkkkkk,kkkk DOMID=lllll
resource type in HIER= has a type of DOM and the
resource name is the domain ID.
Explanation mm/dd hh:mm
The first message is the generic (G) format of The date and time of the alert. The date and time
BNJ146I. The second message is the nongeneric (N) formats depend on the TRANSMSG member, when
format of BNJ146I. The third message is the non- in effect, and on the date and time operands of the
NMVT (R) format of BNJ146I. This is an informational DEFAULTS and OVERRIDE commands.
message displayed whenever an NMVT alert (or non- nn
NMVT alert for type R) is logged to the hardware Major cause code.
monitor database and the OPER filter is set to pass the
oo
specific alert. The individual terms in the message are
Minor cause code.
the same as those used in the GENALERT command.
For more information on these terms, See the NetView pp
online help. For more information on the values in the Action cause code.
alert, see SNA Formats. If you are using this message qqq,qqq,qqq
for automation, consider automating the alert directly Product unique qualifiers.
rather than by using this message. See the IBM Z
rrr
NetView Automation Guide for more information on
Block ID.
automating alerts.

Chapter 4. BNJ Prefix Messages 389


BNJ147I operatorid module locid NO DATA System action
EXISTS FOR REQUESTED KEY
Processing stops for the current unsolicited record.

Explanation
System programmer response
A LAN XREF record without a corresponding network
name XREF record was found. If the message persists, see the IBM Z NetView
Troubleshooting Guide for possible causes of the
Message Variables storage shortage.
operatorid BNJ150I operatorid module locid
The terminal operator identifier. If no operator is HARDWARE MONITOR COULD NOT
defined, this value is NONE. OBTAIN STORAGE FOR ITS MAIN
module DST CONTROL BLOCK. DSIGET
The name of the NetView module that detected RETURN CODE WAS retcode. THE
the error. COMMAND ENTERED COULD NOT
BE PROCESSED DUE TO THE
locid
STORAGE FAILURE.
The location in the NetView module that detected
the error.
Explanation
System action The hardware monitor cannot continue processing
because it cannot obtain storage.
Processing continues.
Message Variables
System programmer response operatorid
Examine the database and determine why the problem The terminal operator identifier (if no operator is
has occurred. defined, this value is NONE).
module
BNJ149I operatorid module locid The name of the NetView module that detected
HARDWARE MONITOR COULD NOT the error.
OBTAIN STORAGE FOR ITS MAIN
DST CONTROL BLOCK. DSIGET locid
RETURN CODE WAS retcode. The location within the NetView module that
UNSOLICITED DATA WAS LOST detected the error.
DUE TO THE STORAGE FAILURE. retcode
The NetView return code.
Explanation
System action
The hardware monitor cannot continue processing
because it cannot obtain storage. Processing stops for the current command.
Message Variables
System programmer response
operatorid
The terminal operator identifier (if no operator is See the IBM Z NetView Troubleshooting Guide for
defined, this value is NONE). possible causes of the storage shortage.
module BNJ151I operatorid module locid
The name of the NetView module that detected HARDWARE MONITOR'S MQS
the error. BUFFER IS TOO SHORT. A LARGER
locid BUFFER WILL BE OBTAINED.
The location within the NetView module that
detected the error. Explanation
retcode
The hardware monitor requires a larger buffer than
The NetView return code.
is present to continue processing. An attempt will be
made to obtain the larger buffer.
Message Variables

390 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


operatorid operatorid
The terminal operator identifier (if no operator is The terminal operator identifier (if no operator is
defined, this value is NONE). defined, this value is NONE).
module module
The name of the NetView module that detected The name of the NetView module that detected
the error. the error.
locid locid
The location within the NetView module that The location within the NetView module that
detected the error. detected the error.
retcode
System action The NetView return code.
Processing continues.
System action
BNJ152I HARDWARE MONITOR
ENCOUNTERED A STORAGE Processing stops for the current operator-entered
FAILURE. IF A COMMAND WAS command or alert.
ENTERED, WAIT AND RE-ENTER.
System programmer response
Explanation See the IBM Z NetView Troubleshooting Guide for
The hardware monitor cannot continue processing possible causes of the storage shortage.
because it cannot obtain storage. BNJ154I operatorid module locid
HARDWARE MONITOR COULD NOT
System action OBTAIN STORAGE FOR ITS MAIN
DST CONTROL BLOCK. DSIGET
Processing stops for the current command or alert. RETURN CODE WAS retcode. AN
INCOMING ALERT, IF PRESENT,
Operator response COULD NOT BE IMMEDIATELY
DISPLAYED ON THE ALERTS
If the message occurred as a result of entering a
DYNAMIC SCREEN
command, wait 30 seconds and enter the command
again.
Explanation
System programmer response The hardware monitor was attempting to build the
Alerts-Dynamic display. An incoming alert, if present,
See the IBM Z NetView Troubleshooting Guide for
might be temporarily missing from the display because
possible causes of the storage shortage.
storage cannot be obtained.
BNJ153I operatorid module locid Message Variables
HARDWARE MONITOR COULD
NOT OBTAIN STORAGE FOR operatorid
ITS MQS BUFFER. DSIGET The terminal operator identifier (If no operator is
RETURN CODE WAS retcode. THE defined, this value is NONE)
PROCESSING OF AN ALERT OR AN module
OPERATOR-ENTERED COMMAND The name of the NetView module that detected
WAS UNABLE TO COMPLETE the error
BECAUSE OF THE STORAGE
locid
FAILURE
The location within the NetView module that
detected the error
Explanation retcode
The hardware monitor cannot continue processing The NetView return code
because it cannot obtain storage for its MQS buffer.
Message Variables System action
Processing continues.

Chapter 4. BNJ Prefix Messages 391


System programmer response Message Variables

See the IBM Z NetView Troubleshooting Guide for module


possible causes of the storage shortage. The name of the NetView module that detected
the error.
BNJ156I operatorid module locid UNABLE
locid
TO LOAD program TO ANALYZE
The location in the NetView module that detected
UNSOLICITED DATA
the error.
domain1
Explanation The name of the local domain.
Module module received a nonzero return code from domain2
DSILOD while attempting to load program during link The name of the focal point domain to which
event processing. the hardware monitor in domain1 attempted to
Message Variables forward an alert.

operatorid
The terminal operator identifier (if no operator is System action
defined, this value is NONE). The alert record will not be received by the focal point
module domain. Normal processing continues for the record in
The name of the NetView module that detected its local domain.
the error.
locid Operator response
The location within the NetView module that
Determine whether you received message BNH16I,
detected the error.
which means the task has reached its storage limit.
program If so, notify your system programmer.
Name of the analysis program that the NetView
program attempted to load.
System programmer response
System action See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
Processing continues, but the DCE data will not be
analyzed. BNJ170I module locid IMMEDIATE
DSICNMFS FAILURE. ATTEMPTED
TO FORWARD AN ALERT FROM
Operator response DOMAIN domain1 TO FOCAL
Notify the system programmer. POINT DOMAIN domain2, BUT
WAS UNSUCCESSFUL. DSICNMFS
RETURN CODE INDICATES THAT
System programmer response THE DCNM ROUTER TASK IS
See IBM Z NetView Programming: Assembler to INACTIVE
determine the cause of the DSILOD failure.
BNJ169I module locid IMMEDIATE Explanation
DSICNMFS FAILURE. ATTEMPTED The hardware monitor in domain1 attempted to use
TO FORWARD AN ALERT FROM the command facility macro DSICNMFS to forward an
DOMAIN domain1 TO FOCAL alert to its focal point domain of domain2, but cannot
POINT DOMAIN domain2, BUT because of the DCNM router task being inactive.
WAS UNSUCCESSFUL. DSICNMFS
RETURN CODE INDICATES AN OUT Message Variables
OF STORAGE CONDITION module
The name of the NetView module that detected
Explanation the error.

The hardware monitor in domain1 attempted to use locid


command facility macro DSICNMFS to forward an alert The location in the NetView module that detected
to its focal point domain of domain2, but cannot the error.
because of a lack of storage.

392 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


domain1 System action
The name of the local domain.
The alert record will not be received by the focal point
domain2 domain. Normal processing continues for the record in
The name of the focal point domain to which its local domain.
the hardware monitor in domain1 attempted to
forward an alert.
Operator response
System action Notify the system programmer.
The alert record is not received by the focal point
domain. Normal processing continues for the record System programmer response
in its local domain. Add the DSIFSOLP statement to your CNMCMD data
set. See the samples on the distribution tape for
Operator response NetView definitions.
Notify the system programmer. BNJ172I module locid IMMEDIATE
DSICNMFS FAILURE. ATTEMPTED
TO FORWARD AN ALERT FROM
System programmer response
DOMAIN domain1 TO FOCAL
Start the DCNM router task in the focal point domain. POINT DOMAIN domain2, BUT
See IBM Z NetView Installation: Configuring Additional WAS UNSUCCESSFUL. DSICNMFS
Components for information on forwarding alerts. RETURN CODE INDICATES THAT
THE REPLYCP PARAMETER OF
BNJ171I module locid IMMEDIATE
replycp IS NOT INSTALLED
DSICNMFS FAILURE. ATTEMPTED
TO FORWARD AN ALERT FROM
DOMAIN domain1 TO FOCAL Explanation
POINT DOMAIN domain2, BUT The hardware monitor in domain1 attempted to use
WAS UNSUCCESSFUL. DSICNMFS command facility macro DSICNMFS to forward an alert
RETURN CODE INDICATES THAT to its focal point domain of domain2, but cannot
DSIFSOLP IS NOT DEFINED because of the command processor name replycp not
being installed.
Explanation Message Variables
The hardware monitor in domain1 attempted to use
module
command facility macro DSICNMFS to forward an alert
The name of the NetView module that detected
to its focal point domain of domain2, but cannot
the error.
because of DSIFSOLP not being defined.
locid
Message Variables The location in the NetView module that detected
module the error.
The name of the NetView module that detected domain1
the error. The name of the local domain.
locid domain2
The location in the NetView module that detected The name of the focal point domain that the
the error. hardware monitor in domain1 attempted to
domain1 forward an alert.
The name of the local domain. replycp
domain2 The name of the command processor specified in
The name of the focal point domain that the the REPLYCP parameter of DSICNMFS.
hardware monitor in domain1 attempted to
forward an alert. System action
The alert record will not be received by the focal point
domain. Normal processing continues for the record in
its local domain.

Chapter 4. BNJ Prefix Messages 393


Operator response System action
Notify the system programmer. The alert record will not be received by the focal point
domain. Normal processing continues for the record in
System programmer response its local domain.

Add the CMDDEF statement for replycp to your


Operator response
CNMCMD data set. See the samples on the distribution
tape for NetView definitions. Notify the system programmer.
BNJ173I module locid IMMEDIATE
DSICNMFS FAILURE. ATTEMPTED System programmer response
TO FORWARD AN ALERT FROM Contact IBM Software Support.
DOMAIN domain1 TO FOCAL
POINT DOMAIN domain2, BUT BNJ174I module locid THE FOLLOWING
WAS UNSUCCESSFUL. DSICNMFS MSU RECORD IS INVALID, THE
RETURN CODE IS "retcode" X'yyyy' MAJOR VECTOR DOES
NOT FOLLOW THE X'xxxx' MAJOR
VECTOR.
Explanation
The hardware monitor in domain1 attempted to use Explanation
command facility macro DSICNMFS to forward an alert
to its focal point domain of domain2. The attempt was The MSU record being processed by module module
unsuccessful. The return code of retcode indicates the does not contain the two NMVTs X'xxxx' and X'yyyy'.
type of problem encountered.
Message Variables
Message Variables
module
module The name of the NetView module that detected
The name of the NetView module that detected the error.
the error. locid
locid The location within the NetView module that
The location in the NetView module that detected detected the error.
the error. xxxx
domain1 The first NMVT expected in the double major
The name of the local domain. vector.
domain2 yyyy
The name of the focal point domain that the The second NMVT expected in the double major
hardware monitor in domain1 attempted to vector.
forward an alert.
retcode System action
The return code. The return code is hexadecimal
No further processing is done on the current MSU
and will have one of the following values:
record.
4
No DSRB under DST or DSRB. not valid
Operator response
8
DSIFSRCT not valid. Notify the system programmer.
12
No CP specification under OST. System programmer response
16 Investigate the MSU to determine why it is being
NMVT too large. rejected.
36 BNJ175I module locid THE FOLLOWING
Time out value not valid. MSU RECORD IS INVALID, THE
X'130F' MAJOR VECTOR DOES
NOT CONTAIN AN EVENT REPORT

394 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


WITH VALID COUNTER DATA: record
record The record that was not valid.

Explanation System action


The module module detected an MSU that was No further processing is done on this record.
received with a second major vector identifier of
X'130F'. The X'130F' major vector is expected to Operator response
contain an event report with counter data. The counter
data was either missing or not valid. Notify the system programmer.
Message Variables
System programmer response
module
The name of the NetView module that detected Determine which device is generating the MSU record
the error. and contact IBM Software Support.
locid BNJ177I module locid THE FOLLOWING MSU
The location within the NetView module that RECORD IS INVALID, IT DOES NOT
detected the error. CONTAIN A VALID EVENT REPORT.
record
The record that was not valid. Explanation
The MSU record being processed by module module
System action does not contain a valid open systems interconnection
No further processing is done on this record. (OSI) event report.
Message Variables
Operator response module
Notify the system programmer. The name of the NetView module that detected
the error.
System programmer response locid
The location within the NetView module that
Determine which device is generating the MSU record detected the error.
and contact IBM Software Support.
BNJ176I module locid THE FOLLOWING MSU System action
RECORD HAS AN INVALID LENGTH
FIELD IN THE X'130F' MAJOR No further processing is done on the current MSU
VECTOR AT OFF-SET off: record record.

Explanation Operator response


The module module detected an MSU that was Notify the system programmer.
received with a second major vector identifier of
X'130F'. A length field that is not valid was detected System programmer response
in the X'130F' major vector at offset off.
Investigate the MSU to determine why it is being
Message Variables rejected.
module BNJ178I module locid INVALID NMVT RU
The name of the NetView module that detected LENGTH.
the error.
locid Explanation
The location within the NetView module that
detected the error. The length of the NMVT being processed by module
locid does not match the length contained in the
off
NMVT.
The offset from the beginning of the DELIVER
header. Message Variables

Chapter 4. BNJ Prefix Messages 395


module Explanation
The name of the NetView module that detected
the error. Module module cannot map the 1330/132F double
major vector into a corresponding generic alert NMVT.
locid
The location within the NetView module that Message Variables
detected the error. module
The name of the NetView module that detected
System action the error.
No further processing is done on the current MSU locid
record. The location within the NetView module that
detected the error.
Operator response
System action
Notify the system programmer.
No further processing is done on the current MSU
record.
System programmer response
Investigate the MSU to determine why it is being Operator response
rejected.
Notify the system programmer.
BNJ179I module locid UNRECOGNIZED/
UNSUPPORTED EVENT TYPE
System programmer response
Explanation Investigate the MSU to determine why it is being
rejected.
The current open systems interconnection (OSI) NMVT
being processed by the specified module contains an BNJ181I module locid MANDATORY IBM
unrecognizable or unsupported OSI event report. ALARM PARAMETER NOT FOUND

Message Variables
Explanation
module
The name of the NetView module that detected Module module cannot find an expected mandatory
the error. IBM alarm parameter in the open systems
interconnection (OSI) NMVT that is being processed.
locid
The location within the NetView module that Message Variables
detected the error. module
The name of the NetView module that detected
System action the error.
No further processing is done on the current MSU locid
record. The location within the NetView module that
detected the error.
Operator response
System action
Notify the system programmer.
No further processing is done on the current MSU
record.
System programmer response
Investigate the MSU to determine why it is being Operator response
rejected.
Notify the system programmer.
BNJ180I module locid UNABLE TO MAP THE
NMVT 1330/132F DMV
System programmer response
Investigate the MSU to determine why it is being
rejected.

396 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ182I module locid BNJCBERP REPORTS 41
A PROBLEM, RC = retcode A conversion indicator that is not valid is in the
navigation table.
Explanation 42
Object identification conversion table pointer is
Module module reports that an error was detected missing.
by BNJCBERP when processing the open systems
interconnection (OSI) information in the MSU being 43
processed. OSI integer length is greater than the
supported range.
Message Variables
44
module Output field is not the correct size.
The name of the NetView module that detected 45
the error. Object identifier name code point is not
locid recognized by BNJCOBID.
The location within the NetView module that 46
detected the error. OSI nesting level was exceeded.
retcode 48
The code returned by BNJCBERP. Values are: Error was returned by BNJCHTEA.
Code 49
Meaning Hex field to convert is too large.
04 50
End of data for a sequence of data within the Object description field has been filled.
OSI NMVT.
08 System action
Not found (error condition).
No further processing is done on the current portion
21
of the MSU record. The MSU record might be rejected,
Navigation table is not present.
depending on error severity.
22
OSI parameter identifier is out of range.
Operator response
23
A function that is not valid was requested. Notify the system programmer.
24
Maximum thread level was reached for Get System programmer response
Next Function. Investigate the MSU to determine the cause of the
25 error.
Conversion request lacks conversion area.
BNJ183I DATABASE database IS FULL
26
Get Next Function does not have a matching
thread. Explanation
27 The hardware monitor database database is full. This
Convert only has mismatched tags. message is issued only once when the user defined
28 threshold (DBFULL) is reached.
No Get Type was called before a conversion Message Variables
request.
database
29 The name of the database that is full.
Unsupported length was encountered in OSI
data.
System action
30
A combination of Primitive Form and Indefinite Processing continues, but records might not be
Length that is not valid was used in BER data. recorded until additional space is made available.

Chapter 4. BNJ Prefix Messages 397


Operator response System action
To make space available, you can switch to another The data capture request ends and returns control to
database or issue a PURGE or PRGATT command. the Presentation Services Command Processor (PSCP)
module making the request.
BNJ184I module locid INVALID
DATATYPE, REQUEST TYPE, OR
COMBINATION Operator response
Notify the system programmer.
Explanation
Module module has received a data capture request System programmer response
with a data type that was not valid, a request type that Investigate the record on the database to determine
was not valid, or combination of the two. the error.
Message Variables
BNJ186I module locid NO CORRELATION
module EXISTS
The name of the NetView module that detected
the error. Explanation
locid
Module module has received a data capture request
The location within the NetView module that
for correlation, but no matching correlation records
detected the error.
were found on the database.

System action Message Variables

The data capture request ends and returns control to module


the Presentation Services Command Processor (PSCP) The name of the NetView module that detected
module making the request. the error.
locid
The location within the NetView module that
Operator response
detected the error.
Notify the system programmer.
System action
System programmer response
The data capture request ends and returns control to
Investigate the record on the database to determine the Presentation Services Command Processor (PSCP)
the error. module making the request.
BNJ185I module locid INVALID RESOURCE
CORRELATION REQUEST Operator response
Notify the system programmer.
Explanation
Module module received a data capture request for a System programmer response
resource correlation that is not valid. Investigate the record on the database to determine
Message Variables the error.
module BNJ187I module locid INVALID CROSS
The name of the NetView module that detected TASK MESSAGE SEGMENTS(S)
the error. RECEIVED
locid
The location within the NetView module that Explanation
detected the error.
Module module has received a cross-task message
segment out of sequence.
Message Variables

398 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module Explanation
The name of the NetView module that detected
the error. Module module has detected a record on the database
being purged that is not an alert or event.
locid
The location within the NetView module that Message Variables
detected the error. module
The name of the NetView module that detected
System action the error.
The cross-task message request is discarded and a locid
reply is sent to the Presentation Services Command The location within the NetView module that
Processor (PSCP) module making the request. detected the error.

Operator response System action


Notify the system programmer. The message is displayed and the purge process
continues with the next record in the database.
System programmer response
Operator response
Investigate the request to determine why the
segments are arriving out of sequence. Notify the system programmer.

BNJ188I module locid SYSTEM SERVICE


ROUTINE FAILED. CROSS TASK
System programmer response
MESSAGE SEGMENTS NOT SAVED. Investigate the database to determine the record that
is not valid and make the appropriate corrections.
Explanation BNJ190I module locid PROCESSING ERROR
Module module has received a bad return code from a - STORAGE CORRUPTION
system service routine (for example, GET STORAGE).
Message Variables Explanation
module Module module did not find an expected subvector or
The name of the NetView module that detected subfield in storage. Storage has been corrupted.
the error. Message Variables
locid module
The location within the NetView module that The name of the NetView module that detected
detected the error. the error.
locid
System action The location within the NetView module that
The cross-task message request is discarded and a detected the error.
reply is sent to the Presentation Services Command
Processor (PSCP) module making the request. System action
The message is displayed and the purge process ends
Operator response for the current set correlation. Purging continues with
Notify the system programmer. the next correlation or event record.

System programmer response Operator response


Investigate the bad return code from the system Notify the system programmer.
service routine to determine why the error occurred.
BNJ189I module locid INVALID RECORD
System programmer response
TYPE Investigate the database to determine the record that
is not valid and make the appropriate corrections.

Chapter 4. BNJ Prefix Messages 399


BNJ191I record IS INVALID. RESOURCE System action
NAME OF DEFAULT RATIO CARD
MUST BE '*'. Request cannot be completed.

Explanation Operator response


A resource name that is not valid was specified on the Contact system programmer and try again.
error-to-traffic default ratio card. The resource name
must be '*' on this type of card. System programmer response
Message Variables Contact IBM Software Support if the condition
persists.
record
The initialization statement that is not valid. BNJ199I HARDWARE MONITOR DOES NOT
HAVE AN ACTIVE DATABASE. DATA
System action CANNOT BE WRITTEN TO THE
HARDWARE MONITOR DATABASE.
Processing continues.
Explanation
Operator response
The hardware monitor received data and attempted to
Notify the system programmer. write it to a hardware monitor database, but none are
active. Operator commands such a NPDA TOT EV also
System programmer response fail because of the hardware monitor not having an
active database.
Correct the error and enter the job again.
BNJ192I CODE POINT TEXT MAY HAVE System action
BEEN CHANGED - CONSIDER
RESTARTING YOUR NPDA Processing continues.
SESSION IF YOU HAVE NOT DONE
SO Operator response
Use the SWITCH command to activate the primary or
Explanation secondary hardware monitor database.
You had an active NPDA session at the time a code BNJ209I INVALID RESPONSE/SELECTION
point table was updated through the CPTBL command. NUMBER
The NPDA session, depending on what panels are
displayed and what code points were changed, might
display outdated text. You might get this message Explanation
when you enter an explicit NPDA command when you You responded incorrectly to a request for a command
already have an active NPDA session. Some NPDA entry. You entered the command options with
commands, such as MENU, actually do reset your incorrect spacing or, when prompted for a selection
NPDA session, while other commands do not. number, entered a letter instead of a number or a
number not on the display.
Operator response
To assure that NPDA will not display outdated code System action
point text, enter NPDA MENU or NPDA END. You can The system waits for a valid request.
then enter NPDA commands again.
BNJ193I INTERNAL FAILURE ACCESSING A Operator response
CODE POINT TABLE
Enter a valid request or enter another command.

Explanation BNJ211I NEW WRAP COUNT HAS BEEN SET

NPDA experienced a failure while accessing a code


point table.

400 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
This message, sent in response to an SWRAP The hardware monitor stops abnormally for this user.
command, indicates that a new wrap count value has Command facility processing continues.
been set for a resource.
Operator response
System action
Determine whether you received message BNH16I,
Processing continues. which means the task has reached its storage limit.
If so, notify your system programmer.
BNJ212I INVALID PU ID FORMAT/NO PU ID

System programmer response


Explanation
See the IBM Z NetView Troubleshooting Guide for
The PU ID in the command is not in the correct format
possible causes of the storage shortage. If necessary,
(8 hexadecimal digits) or is missing.
see the IBM Z NetView Tuning Guide for storage
calculation information.
System action
BNJ219I PROBLEM NOT FILED. LINK
The data request is ignored. TO INFORMATION/MANAGEMENT
NOT AVAILABLE
Operator response
Explanation
Enter a valid 8-character hexadecimal PU ID.
This message is issued to the hardware monitor
BNJ215I INVALID OR INSUFFICIENT
terminal user. An attempt to log on to Information/
OPERANDS SPECIFIED
Management has failed because of a load failure.

Explanation System action


You did not specify enough operands or you specified
The record is not logged to Information/Management
them incorrectly.
and processing continues.

System action Operator response


The NetView program ignores the command and
Notify the system programmer.
processing continues.

System programmer response


Operator response
Determine whether the Information/Management
See the NetView online help to determine the correct
load module BLGGDBWI is present in one of the
number of operands and enter the command again.
concatenated libraries.
BNJ218I operatorid INSUFFICIENT MAIN
BNJ224I INVALID CTRL REQUEST
STORAGE FOR NPDA PSCP
INITIALIZATION
Explanation
Explanation You entered a CTRL command with a control unit id
that is not valid.
The NetView presentation services command
processor (PSCP) cannot allocate enough main storage
to initialize a work area. System action
Message Variables The NetView program ignores the command and
processing continues.
operatorid
The terminal operator identifier (if no operator is
defined, this value is NONE). Operator response
Enter the command with the correct parameter.
BNJ225I INVALID LINE REQUEST

Chapter 4. BNJ Prefix Messages 401


Explanation System action
You entered a LINE command with a line name that is The NetView program ignores the command and
not valid. processing continues.

System action Operator response


The NetView program ignores the command and Verify address and enter the command with correct
processing continues. characters.
BNJ231I NPDA COMMAND PROCESSOR
Operator response INITIALIZING
Enter the command with the correct line name.
Explanation
BNJ226I INVALID REQUEST
You entered a command from a non-hardware monitor
Explanation panel that will not cause a hardware monitor panel
to be displayed. The hardware monitor command
You entered a command with a parameter that is not processor has not been initialized by a previous
valid. hardware monitor command.
Note: No not suppress this message. If the message is
System action suppressed, the hardware monitor command entered
The NetView program ignores the command and might not run.
processing continues.
System action
Operator response Processing continues.
Enter the command with the correct parameter.
Operator response
BNJ227I TASK BNJDSERV IS NOT ACTIVE
Wait for a hardware monitor response to the command
entered.
Explanation
You entered a command that requires data services, BNJ232I RESOURCE RESIDES IN DOMAIN
but the data services task, BNJDSERV, is not active. domainid

System action Explanation


Hardware monitor processing continues but error data This message is issued in response to a DDOMAIN
cannot be accessed from the database. command.
Message Variables
Operator response domainid
Notify the system programmer. The domain where the resource resides.

System programmer response System action


Restart the data services task using the STARTCNM Processing continues.
command. See the NetView online help for more BNJ233I RESOURCE NOT KNOWN TO NCCF
information on the STARTCNM command. OR FUNCTION NOT SUPPORTED
BNJ230I INVALID ADDRESS SPECIFIED
FOR NPDA RESOURCE TYPE Explanation
You entered a resource name that is not valid.
Explanation
You did not enter the EP/Local addresses as
hexadecimal characters.

402 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
The NetView program ignores the command and Verify the database contents, correct the parameters,
processing continues. and enter the command again, if applicable.
BNJ241I INVALID SYNTAX FOR DWRAP/
Operator response DRATIO COMMAND
Enter a valid resource name. See the system
programmer for the correct names to enter. Explanation
You entered the DWRAP or DRATIO command
System programmer response incorrectly.
Determine the correct resource name.
System action
BNJ239I WRAP COUNT FOR RESOURCE
name IS NOW nnn The NetView program ignores the command and
processing continues.
Explanation
Operator response
This message is sent in response to the SWRAP
command and indicates that the resource's wrap count See the NetView online help for the correct command
value changed to nnn. syntax. Enter the command again.
Message Variables BNJ243I CROSS DOMAIN RECORD
name TRANSMISSION ERROR
The resource name.
nnn Explanation
The new wrap count value. The records being accessed from a remote domain
were returned out of sequence.
System action
Processing continues. System action
BNJ240I COMMAND FAILED FOR The hardware monitor ends abnormally.
HIERARCHY resname
Operator response
Explanation Restart the domain and the hardware monitor and
The current database contains no records that then enter the command again.
match the resource resname that you entered for BNJ244I NO ERROR RECORDS FOUND FOR
the specified SWRAP, SRATIO, DWRAP, or DRATIO SPECIFIED RESOURCE
command. If no resource resname is displayed then
this message has been issued from within the
Hardware Monitor for a SWRAP, SRATIO, DWRAP, Explanation
or DRATIO command or for a selection from the No records were found for the specified resource
Multiple Entires panel for a SWRAP, SRATIO, DWRAP, during the database purge.
or DRATIO command.
Message Variables System action
resname No records were purged and processing continues.
The fully qualified resource name for which the
command failed. BNJ245I explanation SENSE= X'sense'

System action Explanation


Processing continues for other fully qualified resource The NetView program cannot process a solicited test
names that match the specified resource name. command, for the reason stated in the message.
Message Variables

Chapter 4. BNJ Prefix Messages 403


explanation X'081C00B2'
The reason for the failure, accompanied by a A modem failure has occurred during link
system sense code. problem determination.
sense X'081C00B3'
The possible codes are: The TIMEOUT THRESHOLD was reached for a
link problem determination response from a
X'080C0005'
modem.
A major vector key specified in an RU is not
supported. X'081C00B4'
The data transmission is too slow or too fast in
X'080C0006'
the node using the link connection during link
The major vector that contains the command is
problem determination for a modem.
not recognized or is not supported.
X'081C00B5'
X'080C0007'
The link problem determination response from
The request for a function is supported but
a modem contained a frame check sequence
the resource identified in that function is not
(FCS) that is not valid.
supported.
X'081C00B6'
X'08120000'
A format exception occurred for a link problem
The receiver cannot act on the request
determination response from the modem.
because of a temporary lack of resources.
X'081C00B7'
X'08170001'
An IBM LPDA-2 modem test was attempted
The link is inactive.
but a communication controller failed.
X'08170003'
X'081C00B8'
The switched link connection is inactive.
A modem or line error has occurred on the
X'08170005' service link.
The service link is inactive. No activate
X'08400012'
line was done, or a forced deactivate is in
Resource mismatch. The service link is defined
progress, for the service link on which IBM
as secondary, or has no active station that
LPDA-2 commands are processed for other
supports IBM LPDA-2.
channelized lines defined on this physical line.
X'086A81nn'
X'0818000A'
The key nn in subvector X'81' is not valid in the
An online terminal test is in progress.
condition under which it was processed.
X'0818000B'
X'086C0400'
An SDLC link, level 2 test is in progress.
Subvector X'04' is missing from the receiver
X'0818000C' list of subvectors.
An LPDA test for a modem is in progress.
X'086Fnn03'
X'08180005' The sum of the subfield lengths in subvector nn
The link problem determination test is in is incompatible with the subvector length.
progress.
X'086Fnn05'
X'08180006' Subvector nn has a length that is not valid.
An online terminal test is in progress.
X'086Fnn06'
X'08180007' A subfield within subvector nn has a length
The SDLC link test is in progress. that is not valid.
X'08180009' X'0870'
A modem panel test is in progress. A value in an unformatted NMVT subvector
X'081C0003' or in an unformatted portion of a partially
Modem check or line disabled. formatted NMVT subvector is not valid.
X'081C00B1' X'08770007'
The SDLC ABORT signal (eight 1 bits) was The line is defined as SECONDARY (SDLC only).
received during link problem determination for X'08770009'
a modem. No active station supporting IBM LPDA-2 was
found on an SDLC line.

404 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


X'08F0002' System programmer response
The sum of the subvector lengths is not
compatible with the major vector length. Start the BNJDSERV task.
BNJ261I NO DATA EXISTS FOR COMMAND
System action SPECIFIED
The NetView program ignores the request and
processing continues. Explanation
There is no data on the database for the command you
Operator response specified. The resource ID might not be valid or there
might not be any data for that resource.
Notify the system programmer.

System action
System programmer response
The NetView program ignores the command and
Check the service link definition. processing continues.
BNJ250I DATA SERVICES FAILURE IN
PROCESSING LAST COMMAND Operator response
Verify database contents and enter the command
Explanation again with a valid resource ID.
Your last request for information from the database BNJ263I NO DATA EXISTS FOR EP LINE
failed. Error messages were issued to the authorized ADDRESS SPECIFIED
message receiver.

Explanation
System action
No data for the specified EP line address is recorded in
The request is not processed. The COMMAND LIST the database.
panel is displayed.

System action
Operator response
The NetView program ignores the command and
Enter the request again. Notify the system processing continues.
programmer if the problem persists.

Operator response
System programmer response
Enter a command with a valid line address.
Determine the user request and the panel from which
it was made and contact IBM Software Support. BNJ264I PROSE TOO LONG FOR ALLOWED
BUFFER. TRUNCATION HAS
BNJ252I DST NOT ACTIVE - TASK ID IS OCCURRED
BNJDSERV

Explanation
Explanation
A user-altered action message is longer than the space
You entered an REQMS command. The correct task is allowed for the original data.
not active.

System action
System action
The displayed action message is reduced in size.
The NetView program ignores the command.

Operator response
Operator response
Notify the system programmer.
Notify the system programmer.

Chapter 4. BNJ Prefix Messages 405


System programmer response reason
The reason code. See Information/Management
Alter the user-specified message in the appropriate manuals for reason code descriptions.
CSECT to match the original size. See IBM Z NetView
Programming: Assembler for instructions.
System action
BNJ267I SOLICITATION FUNCTION NOT
SUPPORTED BY ACCESS METHOD Processing continues.
OR BY THIS DEVICE
Operator response
Explanation Record the reason code, and notify the system
An attempt was made to solicit data from a non-SDLC programmer.
device.
System programmer response
Operator response Take the appropriate action indicated by the reason
Determine that the station name is specified correctly code.
and retry the request. BNJ278I ERROR DURING PROCESSING
BNJ271I NO STATISTICAL DATA RECORDED BY INFO/MANAGEMENT. REASON
BY LINE CODE IS reason

Explanation Explanation
You issued a request for statistical data for a resource The NetView program is unable to establish a link
of type LINE. The hardware monitor does not record to Information/Management and the specified error
statistical data for type LINE. event is not recorded. Processing by Information/
Management occurred during customer, interface, or
environment error.
System action
Message Variables
Processing continues.
reason
BNJ276I PROBLEM FILED BY The reason code. See Information/Management
INFORMATION/MANAGEMENT, ID manuals for reason code descriptions. When the
IS id reason code is enclosed in an X and quotation
marks, for example X'365', then the reason code
Explanation is an Information/Management abend code.

This message indicates that the specified error event


information is filed as id.
System action
Message Variables Processing continues.

id
The ID used to file the error event information. The
Operator response
id variable can be as many as 8 digits. Record the reason code and notify the system
programmer.
System action
Processing continues.
System programmer response
Take the appropriate action indicated by the reason
BNJ277I ERROR IN PARAMETER LIST FROM
code.
NPDA. REASON CODE IS reason
BNJ280I THIS OPERATOR NOT
Explanation AUTHORIZED TO ISSUE PURGE
COMMAND
Information/Management detected an error situation
and the specified event cannot be recorded.
Explanation
Message Variables
You must be authorized to use a PURGE command.

406 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action BNJ285I PURGE OF NPDA DATA BASE IN
PROGRESS
Processing for the command stops.

Explanation
Operator response
The PURGE/PRGATT command was entered correctly
See the system programmer for authorization. and database purging is in progress. Any other
hardware monitor command can be entered after this
System programmer response message is issued.
See the IBM Z NetView Administration Reference for
information on authorizing operators. System action
BNJ281I INVALID DATE SPECIFIED FOR The database is being purged as specified.
NPDA PURGE COMMAND BNJ288I PURGE FOR 2ND/4TH LEVEL 'ST'
RESOURCE WITH TYPE 'LINE' IS
Explanation INVALID
You entered the purge date incorrectly or entered a
date later than today's date. Explanation
The resource you specified has counts reflecting the
System action level 3 or level 5 attached resources. These counts
become inaccurate if you perform a purge on this
The NetView program ignores the command and
resource. The purge is not valid.
processing continues.

System action
Operator response
The request is ignored.
Verify date values and enter the command with the
correct format. BNJ289I PURGE DATE IS LATER THAN
TODAY'S DATE
BNJ282I THERE ARE NO RECORDS ON THE
NPDA DATA BASE PRIOR TO DATE
ENTERED Explanation
You entered a purge date later than today's date.
Explanation
The date you entered with the PURGE command is System action
earlier than the database initialization date. The PURGE command is ignored and processing
continues.
System action
Processing for the command stops. Operator response
Enter the command again with a date equal to or
Operator response earlier than today's date.
Verify the dates and retry. BNJ290I PURGE DATE IS EARLIER THAN
OR EQUAL TO DATA BASE
BNJ284I PURGE OF NPDA DATA BASE
INITIALIZATION DATE
COMPLETED

Explanation
Explanation
The date entered on the PURGE command is earlier
The PURGE command completed successfully.
than or the same as the date the database was
initialized.
System action
Processing continues. System action
The PURGE command is ignored.

Chapter 4. BNJ Prefix Messages 407


Operator response Operator response
Enter the PURGE command again using a date later Use the hardware monitor to determine whether any
than the initialization date. records exist for the specified resource. Alerts cannot
be issued for resources that have no data recorded in
BNJ295I FUNCTION NOT SUPPORTED
the hardware monitor database.
FOR THIS OPERATING SYSTEM
ENVIRONMENT BNJ299I THIS DEVICE NAME IS NOT
CURRENTLY DEFINED IN THE
Explanation NETWORK CONFIGURATION

The function that you entered is not supported for the


Explanation
existing operating system.
The access method does not recognize the symbolic
System action name for the device.

The NetView program ignores the command and


System action
processing continues.
The NetView program ignores the command.
Operator response
Operator response
Enter a supported function.
Notify the system programmer.
BNJ296I ALERT FOR RESOURCE(S) SET ON

System programmer response


Explanation
Determine from the configuration tables whether the
You entered the SRATIO command. Events from the
correct resource name is specified.
specified resource will be recorded on the database as
alerts. BNJ300I INVALID COMMAND:
EXTRANEOUS PARAMETERS
System action SPECIFIED

Processing continues.
Explanation
BNJ297I ALERT FOR RESOURCE(S) SET OFF
You entered a command with more parameters than
necessary.
Explanation
You entered the SRATIO command. Events from the System action
specified resource will no longer be recorded on the
The NetView program ignores the command.
database as alerts.

Operator response
System action
See the NetView online help for the correct number of
Processing continues.
parameters.
BNJ298I NO RESOURCE FOUND FOR THE
BNJ321I EVENT DESCRIPTION CANNOT BE
ALERT REQUEST
RETRIEVED, LOAD FAILED FOR
CSECT module
Explanation
You entered the SRATIO command for a resource Explanation
name not known to the NetView program.
The NetView program failed to load the specified
module to retrieve event descriptions.
System action
Message Variables
The NetView program ignores the command and
processing continues.

408 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module Explanation
The CSECT that the NetView program failed to
load. This message is issued in response to a DR/DRATIO
or SR/SRATIO command. The threshold value has
been set to nnn and the alert enable status is status
System action for the specified resource resname. If no resource
Processing continues. resname is displayed, this message was issued from
within hardware monitor for either a DR/DRATIO or SR/
SRATIO command, or from a Multiple Entries panel for
Operator response either a DR/DRATIO or SR/SRATIO command.
Notify the system programmer. Message Variables
nnn
System programmer response The resource threshold value.
Determine whether the load module containing the status
NetView module is in the library. The alert enable status.
BNJ322I BNJCGEVA HAD RC=retcode FROM resname
DSIMBS TRYING TO RETRIEVE The fully qualified resource name for which the
EVENT DESCRIPTION aaa FROM command successfully completed.
CSECT module
System action
Explanation Processing continues.
A return code of retcode was received when the
BNJ325I WRAP dtype IS nnn FOR resource
hardware monitor attempted to retrieve an error
description aaa from CSECT module.
Explanation
Message Variables
This message is issued in response to a DWRAP or
retcode
SWRAP command for EV or ST type data. A wrap count
The NetView return code.
value of nnn is now current for dtype data for the
aaa resource name.
The error description.
Message Variables
module
The CSECT from which NetView was trying to dtype
retrieve the event description. The data type.
nnn
System action The wrap count value.
resource
Processing continues.
The resource name.

Operator response
System action
Record the information and notify the system
Processing continues.
programmer.
BNJ326I WRAP AL COUNT IS nnn
System programmer response
Determine the user request and the panel from which
Explanation
it was made and contact IBM Software Support. This message is issued in response to a DWRAP or
See IBM Z NetView Programming: Assembler for the SWRAP command for AL type data. A wrap count value
meaning of the return code. of nnn is now current for all alert data.
BNJ323I THRESHOLD VALUE = nnn AND Message Variables
STATUS = status FOR SPECIFIED
nnn
RESNAME resname
The wrap count value.

Chapter 4. BNJ Prefix Messages 409


System action System programmer response
Processing continues. Determine the user request and the panel from which
it was made and contact IBM Software Support.
BNJ336I DSIGET FAILED - MAIN STORAGE
NOT AVAILABLE BNJ344I TEMPORARY RECORD SPACE NOT
FREED
Explanation
Explanation
This message is issued in response to the DSIGET
macro. The requested storage is not available. An internal NetView failure occurred.

System action System action


Processing continues. Processing continues.

Operator response Operator response


Determine whether you received message BNH16I, Notify the system programmer.
which means the task has reached its storage limit.
If so, notify your system programmer. System programmer response
Determine the user request and the panel from which
System programmer response
it was made and contact IBM Software Support.
See the IBM Z NetView Troubleshooting Guide for
BNJ345I HIERARCHY TABLE FULL
possible causes of the storage shortage.
BNJ339I DATA BLOCKED BY FILTERS Explanation
An internal NetView failure occurred.
Explanation
The viewing filter is set to block all data on the System action
requested display.
Processing continues.
System action
Operator response
Processing continues.
Notify the system programmer.
Operator response
System programmer response
Display the viewing filter and delete the appropriate
entries to allow data to display. Determine the user request and the panel from which
it was made and contact IBM Software Support.
BNJ343I NODE NAME NOT IN TABLE
BNJ346I INVALID CONTROL RECORD
FOUND
Explanation
While processing the last command, the node name Explanation
for that command was not found in the node table.
An internal NetView failure occurred.
System action
System action
Processing stops.
Processing continues.
Operator response
Operator response
Record the parameters you entered and notify the
system programmer. Notify the system programmer.

410 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response System programmer response
Determine the user request and the panel from which Determine the user request and the panel from which
it was made and contact IBM Software Support. it was made and contact IBM Software Support.
BNJ347I NO CORE AVAILABLE FOR PAGE BNJ350I INVALID NODE ENTRY
TABLE EXTENSION
Explanation
Explanation
An internal NetView failure occurred.
An internal NetView failure occurred.
System action
System action
Processing continues.
Processing continues.
Operator response
Operator response
Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response
Determine the user request and the panel from which
Determine the user request and the panel from which it was made and contact IBM Software Support.
it was made and contact IBM Software Support.
BNJ364I ALERT FOR SEL# nn IS DELETED
BNJ348I NO CORE AVAILABLE FOR
TEMPORARY RECORD Explanation
The alert specified for deletion on either the Alerts-
Explanation
Static or the Alerts-History panel was deleted
An internal NetView failure occurred. successfully.
Message Variables
System action
nn
Processing continues. The selection number on the Alerts-Static or
Alerts-History panel corresponding to the alert
Operator response deleted.

Notify the system programmer.


System action
System programmer response Processing continues.

Determine the user request and the panel from which BNJ365I ALERT FOR SEL# nn IS NOT IN
it was made and contact IBM Software Support. ALERT DATA BASE

BNJ349I INVALID CALL TO BNJCGTDA - NO


Explanation
MORE RECORDS TO PROCESS
The alert specified for deletion does not exist on the
Explanation database. It might have been deleted earlier.

An internal NetView failure occurred. Message Variables


nn
System action The selection number on the Alerts-Static or
Alerts-History panel corresponding to the alert
Processing continues. deleted.

Operator response System action


Notify the system programmer. The alert continues to be displayed.

Chapter 4. BNJ Prefix Messages 411


Operator response Explanation
Enter a hardware monitor-explicit command or return You responded incorrectly to a request for a command
to the hardware monitor main menu. entry. You entered the command options with
incorrect spacing or, when prompted for a selection
BNJ367I INVALID LOGICAL RECORD number, entered a letter instead of a number or a
FOUND number not on the display.

Explanation System action


An internal NetView failure occurred. The system waits for your request.

System action Operator response


Processing continues. Enter a valid request or enter another command.

Operator response BNJ610I INVALID FUNCTION SELECTED

Record the current screen and request. Notify the


Explanation
system programmer.
The NetView program does not recognize the function
System programmer response you specified.

Determine the user request and the panel from which


System action
it was made and contact IBM Software Support.
The NetView program ignores the request and
BNJ378I SELECTION nn FILTER CODE; processing continues.
PRODUCT ID psi ALERT ID aic

Operator response
Explanation
See the NetView online help for the correct syntax of
You tried to determine a product set ID and an alert the command and enter the request again.
ID code for an alert or most recent event display. This
message is the normal response to such a request. BNJ611I SELECTED FUNCTION INVALID
FOR THE SELECTED RESOURCE
Message Variables
nn Explanation
The selection number.
psi You entered a request for a function that is not valid
The product set ID for the alert or event. for the resource named in the request.

aic
The alert ID code for the alert or event. System action
Note: The alert ID for all resolutions (both alert The NetView program ignores the request and
and event) will be 00000000. processing continues.

System action Operator response


Processing continues. See the NetView online help for the correct syntax of
the command and enter the request again.
Operator response BNJ612I INVALID SET FUNCTION
SPECIFIED
Record the code value for future use in an SRFILTER or
SVFILTER command.
Explanation
BNJ609I INVALID RESPONSE/SELECTION
NUMBER You entered an option that is not valid for a SET
command. The valid options are WRAP, PARM, or
THRESH.

412 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action BNJ615I BNJALTPA BLOCK SIZE TOO
SMALL
The NetView program ignores the request and
processing continues.
Explanation
Operator response The physical block size is insufficient to contain
the information required to build the display. The
See the NetView online help for the correct syntax of BNJALTPA service routine input parameters were set
the SET command and enter the command again. up incorrectly.
BNJ613I INVALID DISPLAY FUNCTION
SPECIFIED System action
Data services command processor (DSCP) processing
Explanation stops.
You entered an option that is not valid for a DISPLAY
command. The valid options are WRAP and THRESH. Operator response
Notify the system programmer.
System action
The NetView program ignores the request and System programmer response
processing continues.
Determine the user request and the panel from which
it was made and contact IBM Software Support.
Operator response
BNJ616I INVALID LOOP DISPLAY
See the NetView online help for the correct syntax of FUNCTION SPECIFIED
the DISPLAY command and enter the command again.
BNJ614I operatorid BNJD105B BAD VSAM Explanation
RECORD RETRIEVED key
You entered an option for a LOOP command that is not
valid. The valid options are STAT and ERROR.
Explanation
The module BNJD105B detected the retrieval of a loop System action
error VSAM record whose extended statistical counter
count value does not match the number of counter The NetView program ignores the request and
data fields in the record. processing continues.

Message Variables
Operator response
operatorid
The terminal operator identifier. If no operator is See the NetView online help for the correct syntax of
defined, this value is NONE. the LOOP command and enter the command again.
key BNJ618I SPECIFIED WRAP VALUE
The 76-byte key that precedes the record. INVALID/OUT OF RANGE

System action Explanation


No further processing is attempted for this error The wrap count specified in a DST initialization
record. parameter statement is either not numeric or exceeds
999.
Operator response
System action
Notify the system programmer.
The parameter statement is ignored.
System programmer response
Operator response
Refer to the VSAM library for more information.
Notify the system programmer.

Chapter 4. BNJ Prefix Messages 413


System programmer response Operator response
Check the syntax of the parameter statements in the Enter the command again after verifying the controller
initialization file. name.
BNJ619I INVALID WRAP TYPE SPECIFIED BNJ622I SOLICIT COMMAND OPTION opt IS
INVALID
Explanation
Explanation
The wrap type specified in a DST initialization
statement is unknown. You entered a SOLICIT command option opt that
is not valid. Valid command options are NOTIFY or
System action NONOTIFY.
Message Variables
The parameter statement is ignored.
opt
Operator response The command option that is not valid.

Notify the system programmer.


System action
System programmer response The NetView program ignores the command and
processing continues.
Check the syntax of the parameter statements in the
initialization file.
Operator response
BNJ620I NO CONTROLLER NAME WAS
See the NetView online help for the correct syntax of
SPECIFIED
the SOLICIT command and enter the command again.

Explanation BNJ623I NPDA DST IS INACTIVE

You entered a command that requires a controller


Explanation
name.
The command facility subtask does not have an active
System action data services task that contains a communications
network management (CNM) interface.
The NetView program ignores the command and
processing continues.
System action
Operator response Processing for the command is stopped.

Enter the command again with a controller name.


Operator response
BNJ621I CONTROLLER NAME ctrlname IS
Initiate the BNJDSERV task or notify the command
INVALID
facility operator to activate the hardware monitor,
depending on established procedures.
Explanation
BNJ624I SPECIFIED CONTROLLER NAME IS
You entered a controller name that started with a TOO LONG
character that is not valid. Names must start with an
alphabetic or national character.
Explanation
Message Variables
You entered a controller name that exceeded 8
ctrlname characters.
The controller name that is not valid.
System action
System action
The NetView program ignores the command and
The NetView program ignores the command and processing continues.
processing continues.

414 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response module
The name of the NetView module that detected
Enter the SOLICIT or SYSMON command again after the error.
determining the correct controller name.
function
BNJ625I SOLICIT FUNCTION function IS The unrecognized function request.
INVALID
System action
Explanation
Data services command processor (DSCP) processing
You entered a solicit command function function that stops.
is not valid. The valid functions are ERROR, RESP, ALL,
or BATCH.
Operator response
Message Variables
Notify the system programmer.
function
The command function that is not valid. System programmer response
Determine the user request and the panel from which
System action
it was made and contact IBM Software Support.
The NetView program ignores the command and
BNJ631I module RECEIVED NON-ZERO
processing continues.
RETURN CODE FROM DSICES

Operator response
Explanation
See the NetView online help for the correct syntax of
The module module detected a processing error while
the SOLICIT command and enter the command again.
attempting to determine the data services command
BNJ628I MESSAGE HAS BEEN TRUNCATED processor (DSCP) verb name.
Message Variables
Explanation
module
The NetView program found a user-altered message The name of the NetView module that detected
longer than 120 bytes. the error.

System action System action


The displayed message is reduced in size. Processing is stopped for the command.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Alter the user-specified message in the appropriate Verify that the DSCP verb used in module matches the
CSECT to be 120 bytes or less. See IBM Z NetView verb defined in the command definition statements
Programming: Assembler for instructions. (CMDDEFs).
BNJ630I module DETECTED INVALID BNJ634I TIMER VALUE nnn IS OUT OF
FUNCTION REQUEST function RANGE

Explanation Explanation
The NetView program detected an unrecognizable The NetView program found a threshold analysis
function request shown as function in module. response time interval timer value that is not valid.
Message Variables Message Variables

Chapter 4. BNJ Prefix Messages 415


nnn Operator response
The threshold analysis response time interval
timer value. See the NetView online help for the correct syntax of
the command and enter it again.

System action BNJ641I INVALID CONTROLLER NAME


SPECIFIED
Data services command processor (DSCP) processing
stops.
Explanation
Operator response You entered a controller name that started with a
character that is not valid. Names must start with an
Notify the system programmer. alphabetical, #, $, or @ character.

System programmer response System action


Determine the user request and the panel from which The NetView program ignores the command and
it was made and contact IBM Software Support after processing continues.
initiating a system trace.
BNJ639I module HEX/EBCDIC DATA Operator response
CONVERSION FAILED
Enter the command again after verifying the controller
name.
Explanation
BNJ642I TOO MANY PARAMETERS
The module module detected an error while converting SPECIFIED
hexadecimal data to EBCDIC.
Message Variables Explanation
module You entered a command that contains more
The name of the NetView module that detected parameters than required.
the error.

System action
System action
The NetView program ignores the command and
Processing stops. processing continues.

Operator response Operator response


Notify the system programmer. See the NetView online help for the correct syntax of
the command and enter it again.
System programmer response BNJ643I INVALID WORKSTATION NAME
Determine the user request and the panel from which SPECIFIED
it was made and contact IBM Software Support.
BNJ640I NO PARAMETERS SPECIFIED FOR Explanation
EXPLICIT COMMAND You entered a workstation name that was not valid.
Valid workstation names fall within a range of from
Explanation WS02 to WS31.

You entered a command that requires additional


parameters. System action
The NetView program ignores the command and
System action processing continues.

The NetView program ignores the command and


processing continues. Operator response
Enter the command again after determining the
correct workstation name.

416 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ644I INVALID LOOP NAME SPECIFIED Explanation
You entered a wrap area type that is unknown. Valid
Explanation wrap area types are STATUS, ERROR, or RESP.
You entered a loop name that is not valid. Valid loop
names fall within a range of from LP01 to LP08. System action
The NetView program ignores the command and
System action processing continues.
The NetView program ignores the command and
processing continues. Operator response
See the NetView online help for the valid wrap-area
Operator response types of the SET command and enter the command
Enter the command again after determining the again.
correct loop name. BNJ649I SPECIFIED THRESHOLD VALUE
BNJ645I INVALID THRESHOLD TYPE OUT OF RANGE
SPECIFIED
Explanation
Explanation You entered a threshold value that does not fall within
You entered a threshold type that is not valid. Valid the range from 0 to 9999.
threshold types are BASIC2, EXTEND, and RESP.
System action
System action The NetView program ignores the command and
The NetView program ignores the command and processing continues.
processing continues.
Operator response
Operator response Enter the command again after determining the
Enter the command again after determining the correct threshold value.
correct threshold type. BNJ650I NO MESSAGE TEXT SPECIFIED
BNJ646I RESOURCE NAME DOESN'T
CONTAIN LOOP OR WORKSTATION Explanation
NAME
You entered a message switching request but did not
specify any message text.
Explanation
You entered a controller name without a subresource. System action
Subresources include loops and workstations.
Processing continues.

System action
Operator response
The NetView program ignores the command and
processing continues. Enter the command again with message text.
BNJ653I STATUS CHECK INTERVAL OUT OF
Operator response RANGE

Enter the command again with the appropriate loop or


workstation names. Explanation
BNJ647I INVALID WRAP AREA TYPE You entered a status check interval value that exceeds
SPECIFIED 9999.

Chapter 4. BNJ Prefix Messages 417


System action BNJ657I WRAP VALUE OUT OF RANGE
The NetView program ignores the command and
processing continues. Explanation
The wrap count value you entered exceeds 999.
Operator response
Enter the command again after determining the System action
correct interval value. The wrap value remains unchanged and processing
BNJ654I INVALID PARAMETER TYPE continues.
SPECIFIED
Operator response
Explanation Enter the command again with the correct wrap value.
You entered a parameter type that is not valid. Valid BNJ658I NON-NUMERIC THRESHOLD
parameter types are TIMER or INTERVAL. VALUE ENTERED

System action Explanation


The NetView program ignores the command and The threshold value you entered is not numeric.
processing continues.

System action
Operator response
The threshold value remains unchanged and
Enter the command again after verifying the parameter processing continues.
type value.
BNJ655I NO RESOURCE NAME SPECIFIED Operator response
Enter the command again with the correct threshold
Explanation value.
You entered a command that requires a resource BNJ659I NO THRESHOLD VALUE ENTERED
name.

Explanation
System action
You entered the SET THRESH command without a
The NetView program ignores the command and threshold value.
processing continues.

System action
Operator response
The threshold value remains unchanged and
Enter the command again with a resource name. processing continues.
BNJ656I NON-NUMERIC WRAP VALUE
ENTERED Operator response
Enter the SET THRESH command again with a
Explanation threshold value.
You entered a wrap count value that is not numeric. BNJ660I INTERVAL VALUE MISSING

System action Explanation


The NetView program ignores the command and You entered a SET INTERVAL command without a
processing continues. status check interval specified.

Operator response
Enter the command again with the correct wrap count
value.

418 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
The interval value remains unchanged and processing Enter the command again with a correct wrap count
continues. value.
BNJ673I INVALID THRESHOLD PARAMETER
Operator response NAME DETECTED
Enter the SET INTERVAL command again with a check
interval value. Explanation
BNJ661I NO TIMER NAME SPECIFIED The NetView program detected a threshold parameter
name that is not valid while processing an initialization
Explanation statement.

You entered a SET PARM command with no timer


System action
name specified.
The NetView program ignores the parameter
System action statement.

The timer value remains unchanged and processing


Operator response
continues.
Notify the system programmer.
Operator response
System programmer response
Enter the SET PARM command again with a timer
name. Check the syntax of parameter statements in the
initialization file. See the IBM Z NetView Administration
BNJ662I SPECIFIED INTERVAL NON- Reference for more information.
NUMERIC
BNJ674I THRESHOLD PARAMETER TYPE
Explanation MISSING

You entered a status check interval that is not


Explanation
numeric.
The NetView program did not find a threshold
System action parameter type while processing an initialization
statement.
The status check interval value remains unchanged
and processing continues.
System action
Operator response The NetView program ignores the parameter
statement.
Enter the command again with the correct status
check interval.
Operator response
BNJ663I NO WRAP VALUE SPECIFIED Notify the system programmer.

Explanation System programmer response


You entered a SET WRAP command and failed to enter Check the syntax of parameter statements in the
a wrap count. initialization file. See the IBM Z NetView Administration
Reference for more information.
System action
BNJ675I INVALID THRESHOLD PARAMETER
The NetView program ignores the command and TYPE DETECTED
processing continues.
Explanation
An incorrect threshold parameter type was selected
while processing an initialization statement.

Chapter 4. BNJ Prefix Messages 419


System action System programmer response
The NetView program ignores the parameter Check the syntax of parameter statements in the
statement. initialization file. See the IBM Z NetView Administration
Reference for more information.
Operator response BNJ678I REQUIRED THRESHOLD
Notify the system programmer. PARAMETER(S) MISSING

System programmer response Explanation


Check the syntax of parameter statements in the The NetView program did not find required threshold
initialization file. See the IBM Z NetView Administration data while processing an initialization statement.
Reference for more information.
System action
BNJ676I INVALID TIMER NUMBER
DETECTED The NetView program ignores the parameter
statement.
Explanation
Operator response
The NetView program detected an interval timer
number not within the range of 1 to 15 while Notify the system programmer.
processing an initialization statement.
System programmer response
System action
Check the syntax of parameter statements in the
The NetView program ignores the parameter initialization file. See the IBM Z NetView Administration
statement. Reference for more information.
BNJ679I INVALID THRESHOLD VALUE
Operator response DETECTED - nnnn
Notify the system programmer.
Explanation
System programmer response The NetView program detected a value that is not
Check the syntax of parameter statements in the numeric or a value greater than 9999 while processing
initialization file. an initialization statement.
Message Variables
BNJ677I INVALID TIMER ID DETECTED
nnnn
Explanation The threshold value that is not valid.

The NetView program found a timer identifier of more


System action
than 8 characters while processing an initialization
statement. The NetView program ignores the parameter
statement.
System action
Operator response
The NetView program ignores the parameter
statement. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Check the syntax of parameter statements in the
initialization file. See the IBM Z NetView Administration
Reference for more information.
BNJ684I EITHER CONTROLLER ctrlname
DOES NOT SUPPORT REMOTE

420 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


SYSTEM MONITOR ACCESS OR BNJ686I INVALID ALERT FROM
THE TYPE OF COMMAND ENTERED THRESHOLD ANALYSIS
MAY ONLY BE ENTERED LOCALLY INSTALLATION EXIT nnn

Explanation Explanation
One of two problems has occurred. Either the Your exit returned a return code that is not valid.
controller ctrlname does not support remote system
Message Variables
monitor access (the controller diskette might have
been improperly generated). Or, a system monitor nnn
command was entered remotely from the NetView The return code that is not valid.
program but the command was of a type that might
be entered only locally.
System action
Message Variables
Processing continues.
ctrlname
The controller name.
Operator response
System action Notify the system programmer.

The controller rejects the command and processing


System programmer response
continues.
Correct the installation exit.
Operator response BNJ687I SOLICITATION OF CONTROLLER
Enter the command again if the name was specified ctrlname WAS NOT SUCCESSFUL
incorrectly. If the message is repeated, notify the
system programmer. Explanation
Solicitation of the controller named did not complete
System programmer response successfully.
If the command can be entered remotely, Message Variables
then re-create the controller diskette, specifying
communication network management controller ctrlname
support (CNM/CS) in the CPGEN. The controller name.

BNJ685I INSUFFICIENT RESOURCE


System action
DETECTED DURING REMOTE
SYSTEM MONITOR ACCESS TO Processing continues.
CONTROLLER ctrlname
Operator response
Explanation
Enter the command again and notify the system
The remote device ctrlname was unable to respond to programmer if the message repeats.
monitor access because it was busy or had insufficient
buffer space to construct a response. System programmer response
Message Variables
Contact IBM Software Support.
ctrlname
BNJ688I LOAD FAILED FOR MODULE module
The remote device name.

System action Explanation


The NetView program did not find the initialization
Processing continues.
module specified.

Operator response Message Variables

Enter the command again.

Chapter 4. BNJ Prefix Messages 421


module BNJ692I CONTROLLER ctrlname IS NOT
The name of the module that the NetView program AVAILABLE
was trying to load.
Explanation
System action
The specified controller ctrlname is not connected or is
The NetView program ignores the parameter otherwise unavailable for error solicitation.
statement.
Message Variables

Operator response ctrlname


The controller name.
Notify the system programmer.
System action
System programmer response
Processing continues.
Check the syntax of parameter statements in
the initialization routine. See the IBM Z NetView
Administration Reference for more information.
Operator response
Determine the status of the controller and enter the
BNJ689I INSUFFICIENT PARAMETERS
command again.
SPECIFIED FOR INITIALIZATION
BNJ693I CONTROLLER ctrlname IS NOT
Explanation RECOGNIZED BY THE ACCESS
METHOD
The initialization exit routine found a null parameter
statement in the initialization routine.
Explanation
System action The symbolic name ctrlname is not recognized by the
access method.
The NetView program ignores the parameter
statement. Message Variables
ctrlname
Operator response The controller name.

Notify the system programmer.


System action
System programmer response Processing continues.

Check the syntax of parameter statements in


the initialization routine. See the IBM Z NetView
Operator response
Administration Reference for more information. Notify the system programmer.
BNJ691I SOLICITATION OF CONTROLLER
ctrlname WAS SUCCESSFUL System programmer response
Determine from the configuration tables whether the
Explanation correct resource name was specified.
The solicitation for data from the specified controller is BNJ694I CONTROLLER ctrlname DOES NOT
successful. SUPPORT SOLICITATION
Message Variables
ctrlname
Explanation
The controller name. The specified controller ctrlname is not a device that
supports solicitation.
System action Message Variables
Processing continues. ctrlname
The controller name.

422 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
Processing continues. Processing continues.
BNJ695I INSUFFICIENT RESOURCE
DETECTED DURING Operator response
SOLICITATION OF CONTROLLER Enter the command again and notify the system
ctrlname programmer if the message repeats.

Explanation System programmer response


The device ctrlname is unable to respond to the Contact IBM Software Support.
solicitation because it is busy or has insufficient buffer
space to construct a response. BNJ698I BNJSWRPA DETECTED INVALID
ERASE REQUEST
Message Variables
ctrlname Explanation
The controller name.
An internal request was generated to erase VSAM
records that are not valid. The request is not valid.
System action
Processing continues. System action
The request stops.
Operator response
Enter the command again. Operator response
BNJ696I CONTROLLER ctrlname IS IN Notify the system programmer.
FUNCTION ACTIVE STATE

System programmer response


Explanation
Determine the user request and the panel from which
The controller ctrlname is unable to respond because it was made and contact IBM Software Support.
it is in active state.
BNJ699I CONTROLLER ctrlname DOES NOT
Message Variables SUPPORT REQUESTED FUNCTION
ctrlname
The controller name. Explanation
The specified controller ctrlname does not support the
System action function you requested.
Processing continues. Message Variables
ctrlname
Operator response
The controller name.
Enter the command again.
BNJ697I SYSTEM MONITOR ACCESS OF System action
CONTROLLER ctrlname WAS NOT The NetView program ignores the command and
SUCCESSFUL processing continues.

Explanation Operator response


The access to controller ctrlname did not complete Enter the command for the proper function or
successfully. controller.
Message Variables BNJ700I IMMEDIATE DSICNMFS FAILURE -
ctrlname OUT OF STORAGE
The controller name.

Chapter 4. BNJ Prefix Messages 423


Explanation Operator response
The hardware monitor attempted to send an OST If the failure is caused by the inability to establish
request for data to a DST in another domain through a cross domain LUC session, you can issue the
command facility macro DSICNMFS. DSICNMFS SDOMAIN command to establish a session using the
cannot send the OST request because of a lack of LU 6.2 or LU0 transport. If the SDOMAIN command
storage. is successful, issue the command again to retrieve
the data from another domain. Otherwise, notify the
You might also receive this message if you enter a
system programmer.
command that uses Distributed Data Base Retrieval
to retrieve data from another domain. The NetView
program cannot establish a cross domain LUC session System programmer response
because of the presence of intermediate nodes
Restart the DCNM router task.
between your node and the remote domain from which
you are retrieving data. BNJ702I IMMEDIATE DSICNMFS FAILURE -
DSIFSOLP NOT DEFINED
System action
Explanation
The request is ignored.
The hardware monitor attempted to send an OST
Operator response request for data to a DST in another domain through
command facility macro DSICNMFS. DSICNMFS
If the failure is caused by the inability to establish cannot send the OST request because DSIFSOLP is not
a cross domain LUC session, you can issue the defined.
SDOMAIN command to establish a session using the
LU 6.2 or LU0 transport. If the SDOMAIN command You might also receive this message if you enter a
is successful, issue the command again to retrieve command that uses Distributed Data Base Retrieval
the data from another domain. Otherwise, notify the to retrieve data from another domain. The NetView
system programmer. program cannot establish a cross domain LUC session
because of the presence of intermediate nodes
between your node and the remote domain from which
System programmer response you are retrieving data.
If the message persists, check the NetView storage
and adjust if necessary. See the IBM Z NetView System action
Troubleshooting Guide for more information.
The request is ignored.
BNJ701I IMMEDIATE DSICNMFS FAILURE -
DCNM ROUTER TASK IS INACTIVE Operator response
If the failure is caused by the inability to establish
Explanation
a cross domain LUC session, you can issue the
The hardware monitor attempted to send an OST SDOMAIN command to establish a session using the
request for data to a DST in another domain through LU 6.2 or LU0 transport. If the SDOMAIN command
command facility macro DSICNMFS. DSICNMFS is successful, issue the command again to retrieve
cannot send the OST request because of the DCNM the data from another domain. Otherwise, notify the
router task being inactive. system programmer.
You might also receive this message if you enter a
command that uses Distributed Data Base Retrieval System programmer response
to retrieve data from another domain. The NetView
Add the DSIFSOLP statement to your CNMCMD data
program cannot establish a cross domain LUC session
set. See the samples on the distribution tape for a list
because of the presence of intermediate nodes
of NetView definitions.
between your node and the remote domain from which
you are retrieving data. BNJ703I IMMED DSICNMFS FAILURE -
DSICNMFS REPLYCP PARM OF
System action replycp NOT PRESENT

The request is ignored.

424 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation retcode
The return code received from the command
The hardware monitor attempted to send an OST facility macro. The value will be one of the
request for data to a DST in another domain through following:
command facility macro DSICNMFS. DSICNMFS
cannot send the OST request because the command 20
processor replycp is not installed. The CMDDEF statement is missing or incorrect
for DSIFSOLP in CNMCMD.
Message Variables
24
replycp DSICRTR is inactive.
The name of the command processor specified in 28
the REPLYCP parameter of the DSICNMFS macro. Insufficient storage.
You might also receive this message if you enter a 32
command that uses Distributed Data Base Retrieval The CMDDEF statement is missing or incorrect
to retrieve data from another domain. The NetView for DSICHRSP in CNMCMD.
program cannot establish a cross domain LUC session
36
because of the presence of intermediate nodes
The time-out value exceeds the maximum
between your node and the remote domain from which
allowed (86,400 seconds) in DSICTMOD. The
you are retrieving data.
time value used is for FOCALPT or CHANGEFP
command.
System action Others
The request is ignored. NetView internal program error.
You might also receive this message if you enter a
Operator response command that uses Distributed Data Base Retrieval
to retrieve data from another domain. The NetView
If the failure is caused by the inability to establish
program cannot establish a cross domain LUC session
a cross domain LUC session, you can issue the
because of the presence of intermediate nodes
SDOMAIN command to establish a session using the
between your node and the remote domain from which
LU 6.2 or LU0 transport. If the SDOMAIN command
you are retrieving data.
is successful, issue the command again to retrieve
the data from another domain. Otherwise, notify the
system programmer. System action
The request is ignored.
System programmer response
Add the CMDDEF statement to your CNMCMD data set. Operator response
See the samples on the distribution tape for a list of
If the failure is caused by the inability to establish
NetView definitions.
a cross domain LUC session, you can issue the
BNJ704I IMMEDIATE macro FAILURE - SDOMAIN command to establish a session using the
RETURN CODE IS retcode LU 6.2 or LU0 transport. If the SDOMAIN command
is successful, issue the command again to retrieve
the data from another domain. Otherwise, notify the
Explanation system programmer.
The hardware monitor attempted to send an OST
request for data to a DST in another domain through System programmer response
command facility macro macro. The macro was unable
to send the OST request. The return code of retcode Use the return code information to correct the
indicates the type of problem encountered. problem. If the error is an internal error, contact IBM
Software Support.
Message Variables
BNJ705I NON-IMMEDIATE DSICNMFS
macro
FAILURE - OUT OF STORAGE
The macro that was unable to send the OST
request.
Explanation
The hardware monitor attempted to send an OST
request for data to a DST in another domain through

Chapter 4. BNJ Prefix Messages 425


command facility macro DSICNMFS. DSICNMFS LU 6.2 or LU0 transport. If the SDOMAIN command
cannot send the OST request because of a lack of is successful, issue the command again to retrieve
storage. the data from another domain. Otherwise, notify the
system programmer.
You might also receive this message if you enter a
command that uses Distributed Data Base Retrieval
to retrieve data from another domain. The NetView System programmer response
program cannot establish a cross domain LUC session
Restart the DCNM router task (DSICRTR) using
because of the presence of intermediate nodes
STARTCNM NPDA.
between your node and the remote domain from which
you are retrieving data. BNJ707I NON-IMMEDIATE DSICNMFS
FAILURE - TIME-OUT OCCURRED
System action
Explanation
The request is ignored.
The hardware monitor attempted to send an OST
Operator response request to a DST in another domain. A response was
not received within the allotted amount of time, and a
If the failure is caused by the inability to establish time-out condition occurred.
a cross domain LUC session, you can issue the
SDOMAIN command to establish a session using the You might also receive this message if you enter a
LU 6.2 or LU0 transport. If the SDOMAIN command command that uses Distributed Data Base Retrieval
is successful, issue the command again to retrieve to retrieve data from another domain. The NetView
the data from another domain. Otherwise, notify the program cannot establish a cross domain LUC session
system programmer. because of the presence of intermediate nodes
between your node and the remote domain from which
you are retrieving data.
System programmer response
See the IBM Z NetView Troubleshooting Guide for System action
possible causes of the storage shortage.
The request is ignored.
BNJ706I NON-IMMEDIATE DSICNMFS
FAILURE - DCNM ROUTER TASK IS Operator response
INACTIVE
If the failure is caused by the inability to establish
a cross domain LUC session, you can issue the
Explanation
SDOMAIN command to establish a session using the
The hardware monitor attempted to send an OST LU 6.2 or LU0 transport. If the SDOMAIN command
request for data to a DST in another domain. The is successful, issue the command again to retrieve
request failed because of the inactive DCNM router the data from another domain. Otherwise, notify the
task (DSICRTR). system programmer.
You might also receive this message if you enter a
command that uses Distributed Data Base Retrieval System programmer response
to retrieve data from another domain. The NetView
Increase the time-out value for hardware monitor data
program cannot establish a cross domain LUC session
retrieval (currently set to 120 seconds) in DSICTMOD,
because of the presence of intermediate nodes
or determine why this timeout occurred.
between your node and the remote domain from which
you are retrieving data. BNJ708I NON-IMMED DSICNMFS FAILURE -
IFRFRTCD='retcode'X, SNA SENSE
System action CODE='sensecode'X

The request is ignored.


Explanation
Operator response The hardware monitor attempted to send an OST
request to a DST in another domain and the request
If the failure is caused by the inability to establish failed. The retcode and sensecode indicate the type of
a cross domain LUC session, you can issue the problem encountered.
SDOMAIN command to establish a session using the
Message Variables

426 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


retcode If the return code is 04, retry at a later time. Consider
The return code. The return code is hexadecimal changing MAXSESS operand on the CNMAUTH
and will have one of the following values: definition statement to allow more sessions.
02 If the return code is 06, increase the available
The LUC task at the distributed host is not resources or storage.
available.
If the return code is F0, ensure VTAM and the
04 LUC task are active at both domains. Also, ensure
A session is not available. communication can be established between the two
06 domains.
Resources or storage are unavailable. For other return codes, see Systems Network
34 Architecture Formats for information on the sense
Allocation error. code. If needed, contact IBM Software Support.
36 BNJ709I NON-IMMEDIATE DSICNMFS
TPN not available, retry allowed. FAILURE - IFRFIMRC= X'retcode'
F0
System error. Explanation
Others
Problem with the NetView program. The hardware monitor attempted to send an OST
request to a DST in another domain and the request
sensecode failed. The IFRFIMRC value of retcode indicates the
The SNA sense code. type of problem encountered.
You might also receive this message if you enter a Message Variables
command that uses Distributed Data Base Retrieval
to retrieve data from another domain. The NetView retcode
program cannot establish a cross domain LUC session The return code. The return code is hexadecimal:
because of the presence of intermediate nodes 04 or 84
between your node and the remote domain from which No storage available.
you are retrieving data.
0C
The LUC task is not active.
System action Others
The request is ignored. Problem with the NetView program.
You might also receive this message if you enter a
Operator response command that uses Distributed Data Base Retrieval
to retrieve data from another domain. The NetView
If the failure is caused by the inability to establish program cannot establish a cross domain LUC session
a cross domain LUC session, you can issue the because of the presence of intermediate nodes
SDOMAIN command to establish a session using the between your node and the remote domain from which
LU 6.2 or LU0 transport. If the SDOMAIN command you are retrieving data.
is successful, issue the command again to retrieve
the data from another domain. Otherwise, notify the
system programmer. System action
If the sense code is 084B6031 or 084C0000, try to The request is ignored.
activate the router task (DSICRTR) in the other domain
with which you are trying to communicate. If the sense Operator response
code is 10086021, most likely the NetView program in
the other domain is an earlier release. If the failure is caused by the inability to establish
a cross domain LUC session, you can issue the
Otherwise, notify the system programmer. SDOMAIN command to establish a session using the
LU 6.2 or LU0 transport. If the SDOMAIN command
System programmer response is successful, issue the command again to retrieve
the data from another domain. Otherwise, notify the
If the return code is 02, ensure the LUC task is active. system programmer.

Chapter 4. BNJ Prefix Messages 427


System programmer response System action
If the return code is 04 or 84, increase the available Wrap count values have been changed and processing
storage. If the return code is 0C, ensure the LUC task continues.
is active. For other return codes, contact IBM Software
BNJ802I SET THRESHOLD HAS FAILED
Support.
- SPECIFIED RESOURCE(S) NOT
BNJ711I SD/SDOMAIN OPERAND domain FOUND
IS TOO LONG, GREATER THAN
FIVE CHARACTERS Explanation
The SET THRESHOLD command was not successful
Explanation
because the resources do not exist.
You entered the SDOMAIN command with a domain
name that is longer than five characters. Domain System action
names must be from one to five characters long.
The NetView program ignores the command and
Message Variables
processing continues.
domain
The domain name, entered on the SDOMAIN Operator response
command, that is not valid.
Enter the command again after verifying the resource
names.
System action
BNJ803I SET THRESHOLD COMMAND HAS
The NetView program ignores the command and
COMPLETED SUCCESSFULLY
processing continues.

Operator response Explanation


The SET THRESHOLD command completed
Enter the SDOMAIN command again with a valid
successfully.
domain name.
BNJ800I SET WRAP COMMAND HAS FAILED System action
- SPECIFIED RESOURCE(S) NOT
FOUND Threshold values have been changed and processing
continues.
Explanation BNJ804I SET PARAMETER HAS FAILED
- SPECIFIED CONTROLLER NOT
The SET WRAP command was not completed because
ACTIVE
the resource name you specified is not in the VSAM
file.
Explanation
System action The controller specified on the SET PARAMETER
command is currently unavailable.
The NetView program ignores the command and
processing continues.
System action
Operator response The NetView program ignores the command and
processing continues.
Enter the SET WRAP command again after verifying the
resource name.
Operator response
BNJ801I SET WRAP COMMAND HAS
COMPLETED SUCCESSFULLY Enter the command again after verifying that the
controller name is correct and that the controller is
active.
Explanation
BNJ805I SET PARAMETER COMMAND HAS
The SET WRAP command completed successfully.
COMPLETED SUCCESSFULLY

428 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
The SET PARAMETER command completed Contact IBM Software Support.
successfully.
BNJ812I SPECIFIED CONTROLLER NOT
AVAILABLE
System action
Parameter values have been changed and processing Explanation
continues.
The controller is not connected or is otherwise
BNJ806I INVALID TIMER NAME WAS unavailable for solicitation.
SPECIFIED
System action
Explanation
Processing continues.
You entered a timer name that does not exist in the
timer name table. Operator response
Determine the status of the controller and enter the
System action
command again.
The NetView program ignores the command and
BNJ813I SPECIFIED CONTROLLER NOT
processing continues.
RECOGNIZED BY THE ACCESS
METHOD
Operator response
Enter the command again after verifying the timer Explanation
name.
The controller name is not recognized by the access
BNJ807I SET PARAMETER COMMAND method.
TERMINATED, NPDA DST IS
INACTIVE System action
Processing continues.
Explanation
The NetView task BNJDSERV is not active. Operator response
Notify the system programmer.
System action
Processing of the hardware monitor stops. System programmer response
Determine from the configuration tables whether the
Operator response
correct resource name was specified.
Notify the authorized message receiver to activate the
data services task (BNJDSERV). BNJ814I SPECIFIED CONTROLLER IS IN
FUNCTION ACTIVE STATE
BNJ811I REQUEST TO CONTROLLER WAS
NOT SUCCESSFUL Explanation
The controller is unable to respond because it is in
Explanation
function active state.
Your request to the controller was not successful.
System action
System action
Processing continues.
Processing continues.
Operator response
Operator response
Enter the command again.
Enter the command again and notify the system
programmer if the message repeats.

Chapter 4. BNJ Prefix Messages 429


BNJ815I KEYWORD FOLLOWING AL/EV Explanation
DESCRIPTION MUST BE 'N' or 'A'
The remote device failed to respond to a solicitation
for data and no data exists from a previous solicitation.
Explanation
You entered an SRFILTER command. The keyword System action
following the AL/EV description code is not N or A.
The NetView program ignores the command and
processing continues.
System action
The NetView program ignores the command and Operator response
processing continues.
Notify the system programmer.

Operator response
System programmer response
Enter the command correctly.
Determine the status of the addressed device.
BNJ816I INVALID ALERT/EVENT
DESCRIPTION ENTERED BNJ819I CURRENT SOLICITATION
COMMAND FAILED

Explanation
Explanation
You entered the SRFILTER or an SVFILTER command.
The block ID or action code portion of the alert/event The remote device failed to respond to a data
description is not valid. solicitation.

System action System action


The NetView program ignores the command and The NetView program ignores the command and
processing continues. processing continues.

Operator response Operator response


Enter the command correctly. Notify the system programmer.

BNJ817I THE UPDATE PROBLEM ID IS


System programmer response
INVALID
Determine the status of the addressed device.
Explanation BNJ821I WARNING: LINK LEVEL 2 TEST
You tried to update the problem management HAS NOT BEEN SUCCESSFULLY
database. The problem identification is not valid. RUN

System action Explanation


The NetView program ignores the command and If the hardware monitor CTRL command with LINK
processing continues. option is processed before a successful LINK LEVEL 2
test (NetView LL2 command list), the CTRL command
with LINK option results show 0 transmits and 0
Operator response receives.
Enter the command again after verifying the problem
identification number. Operator response
BNJ818I CURRENT SOLICITATION FAILED Run the LINK LEVEL 2 test (NetView LL2 command list)
NO DATA EXISTS FOR THIS and perform the CTRL command with the LINK option
DEVICE to retrieve the results.
BNJ822I command COMMAND FAILED DUE
TO IMPROPER NODE NAME
netid.nau.

430 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
The command failed because either the netid name or The NetView program failed to load the module
the nau name specified is not valid. If only the nau module to run your command.
name is specified, then an "*" is displayed as the netid
Message Variables
in this message. The "*" indicates that you want VTAM
to determine the netid for you. module
The module that the NetView program was trying
Message Variables
to load.
command
The name of the failing command. System action
netid.nau
The improper node name. Processing for the command stops.

System action Operator response


Processing continues. Notify the system programmer.

Operator response System programmer response


Enter the command again with a valid node name. Verify that the requested load module is present in the
library.
BNJ900I NPDA MESSAGE NUMBER nnn
NOT FOUND IN MESSAGE TABLE BNJ902I LOAD FAILURE ON MODULE
BNJZMDMA module1. OPERATOR ID operatorid
CALLING FROM module2.
BNJCLODB/DSILOD RETCODE
Explanation retcode
During a request for a message from the message
table BNJZMDMA, the message ID field is 0 or a value Explanation
not found in the message CSECT.
The module module2 failed to load the specified
Message Variables module module1.
nnn Message Variables
The message identifier field.
module1
The module that the NetView program was trying
System action to load.
Processing continues. operatorid
The terminal operator identifier. If no operator is
Operator response defined, this value is NONE.
module2
Give the message number to the system programmer The module that tried to load module1.
for checking an internal error.
retcode
The NetView macro return code.
System programmer response
Messages in message CSECT BNJZMDMA are System action
requested by message number. Verify that the
message number specified is correct and that the The NetView program ignores the command.
identified message table contains a message with that
number. Operator response
BNJ901I COMMAND NOT PROCESSED: Notify the system programmer.
FAILED TO LOAD MODULE module
System programmer response
See IBM Z NetView Programming: Assembler for the
meaning of the return code. Verify that the module is

Chapter 4. BNJ Prefix Messages 431


present in the library and check the reason using the System programmer response
return code.
Initiate BNJDSERV in foreign domain by means
BNJ903I INSUFFICIENT STORAGE of ROUTE command or notify the command
AVAILABLE TO PROCESS A CROSS facility operator of the foreign domain to activate
DOMAIN REQUEST AT THIS TIME the hardware monitor depending on established
procedures.
Explanation BNJ905I INVALID COMMAND ENTERED
The NetView storage assignment for cross-domain OR INCORRECT OPERANDS
operation is not sufficient. SPECIFIED

System action Explanation


Processing for command stops. You entered an unrecognized command, incorrect
operands, or operands that were not valid for a
command.
Operator response
Determine whether you received the BNH16I System action
message, which means the task has reached its
storage limit. If so, notify your system programmer. The NetView program ignores the command and
If you did not receive a BNH161I message and if you processing continues.
had issued a START DOMAIN command, the BNJ903I
message indicates that the table that is allocated Operator response
for your cross-domain sessions reached its limit. You
can stop an active cross-domain session by issuing See the NetView online help or use the COMMAND
a STOP DOMAIN=domainid command, and issue the LIST display to determine the correct number of
failed START DOMAIN=domainid command again. If operands and enter the command again.
this problem persists, notify your system programmer. BNJ906I CMD FACILITY ROUTE CMD
DETECTED BY HARDWARE
System programmer response MONITOR - COMMAND WAS
REJECTED
If the BNJ903I message is issued as the result of
a START DOMAIN command, increase the numeric
value on the RRD.*=nn statement in the CNMSTYLE Explanation
member to allow more concurrent active cross-domain The NetView program detected a ROUTE command
sessions. For all other commands, see the IBM Z attempting to process a hardware monitor command in
NetView Troubleshooting Guide for possible causes of a remote domain. This is not a valid procedure under
the storage shortage. the NetView program.
BNJ904I DST NOT ACTIVE IN THE
REQUESTED REMOTE DOMAIN System action
Processing stops for the command.
Explanation
The domain you specified in the SDOMAIN command Operator response
does not have an active data services task (DST).
Issue a hardware monitor SDOMAIN command to
the remote domain. Then enter the desired hardware
System action monitor command.
Processing for the command stops. BNJ907I MAIN STORAGE CANNOT BE
OBTAINED FOR THE APPLICATION
Operator response CONTROL TABLE

Verify that the correct domain name is specified. If the


name is correct, notify the system programmer.

432 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
You cannot initialize the NetView program unless Enter the command again with a valid domain ID.
there is sufficient storage for the presentation services
BNJ911I SESSION DOMAIN NOW
command processor (PSCP).
netid1.nau1, WAS netid2.nau2

System action
Explanation
Processing stops.
This message is issued when the SDOMAIN command
completes successfully. When netid1.nau1 differs from
Operator response your host node name, the hardware monitor in your
Determine whether you received message BNH16I, host node has established a cross domain session with
which means the task has reached its storage limit. the hardware monitor in the remote node netid1.nau1.
If so, notify your system programmer. When netid1.nau1 is the same as your host node
name, there is no hardware monitor cross domain
session and your current node is the local node. You
System programmer response can issue the DDOMAIN command to display your host
See the IBM Z NetView Troubleshooting Guide for node name.
possible causes of the storage shortage. Message Variables
BNJ908I DATA SERVICES ERROR IN netid1.nau1
PROCESSING CROSS DOMAIN The node with which your hardware monitor has
REQUEST established a session. When this node matches
your host node, your host node is not in a cross-
Explanation domain session with a remote node. Otherwise,
the hardware monitor in your node is in a cross-
The data services command processor (DSCP) in the domain session with this netid1.nau1 node. If
foreign domain found an error condition. netid1 is an *, the cross domain session is
using either the LUC transport or LU0 transport.
System action Otherwise, the cross domain session is using the
LU 6.2 transport.
Processing stops for the command.
netid2.nau2
The previous node with which your hardware
Operator response monitor has established a session. If netid2 is an
*, the cross domain session is using either the LUC
Enter the command again. Notify the system
transport or LU0 transport.
programmer if unsuccessful.

System programmer response System action


Processing continues.
Determine the error from the command and remote
domain error messages. BNJ912I RELEASE LVLS INCOMPATIBLE
BETWEEN DOMAINS domain1 AND
BNJ910I NO DOMAIN NAME SPECIFIED
domain2
FOR SD/SDOMAIN COMMAND

Explanation Explanation
You entered an SDOMAIN command without a domain The hardware monitor release level in domain1 is
ID. not the same as in domain2. Cross-domain functions
cannot be processed at the foreign domain.

System action Message Variables

The NetView program ignores the command and domain1, domain2


processing continues. The two domains between which you are trying to
establish cross-domain operation.

Chapter 4. BNJ Prefix Messages 433


System action netid2.nau2
The name of your host node.
The session domain is restored to the previous level
and processing continues.
System action
Operator response Processing continues.

Notify the system programmer. BNJ915I RESOURCE RESIDES IN DOMAIN


domain
System programmer response
Explanation
Determine the hardware monitor release levels at both
domains and take appropriate action. The resource resides in the domain identified by
domain. This message is issued in response to a
BNJ913I HARDWARE MONITOR WAITING DDOMAIN command.
FOR DATA, ENTER "NPDA END" TO
CANCEL REQUEST. Message Variables
domain
Explanation The domain containing the resource.
Data retrieval activity for a previous command did not
complete. System action
Processing continues.
System action BNJ916I RESOURCE NOT KNOWN TO NCCF
The second command is rejected and processing
continues. Explanation
You entered a resource name that is not valid.
Operator response
Enter the command again when data services for System action
previous request have completed.
The NetView program ignores the command and
BNJ914I SESSION DOMAIN IS netid1.nau1, processing continues.
HOST DOMAIN IS netid2.nau2

Operator response
Explanation
Enter a valid resource name. See the system
This message is issued when the DDOMAIN command programmer for the correct names to enter.
is issued. When netid1.nau1 differs from netid2.nau2,
the hardware monitor in your host node has
established a cross domain session with the hardware System programmer response
monitor in the remote node netid1.nau1. When Determine the correct resource name.
netid1.nau1 is the same as netid2.nau2, there is no
hardware monitor cross domain session and your BNJ917I APPLICATION applid
current node is the local node. INITIALIZATION FAILED
Message Variables
Explanation
netid1.nau1
The node with which your hardware monitor has Application applid cannot be initialized because of
established a session. When this node matches insufficient storage.
your host node, your host node is not in a cross- Message Variables
domain session with a remote node. Otherwise,
the hardware monitor in your node is in a cross- applid
domain session with this netid1.nau1 node. If The application you are trying to initialize.
netid1 is an *, the cross domain session is
using either the LUC transport or LU0 transport. System action
Otherwise, the cross domain session is using the
LU 6.2 transport. Processing stops.

434 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Notify the system programmer. The NetView application cannot be initialized.

System programmer response System action


Allocate sufficient storage for the application. Processing stops.
BNJ918I NO AVAILABLE ENTRY IN THE
APPLICATION CONTROL TABLE Operator response
Notify the system programmer.
Explanation
The number of active commands to be run exceeds the System programmer response
size of the application control table. You are limited to Allocate sufficient storage for the NetView program.
five concurrent applications.
BNJ923I TASK task IS NOT ACTIVE
System action
Explanation
Processing stops for the command.
The specified task task has not been activated.
Operator response Message Variables
End one of the active commands and retry the failing task
command. The name of the task that was not activated.
BNJ920I INVALID RESPONSE / SELECTION
NUMBER System action
Processing stops for the command.
Explanation
You responded incorrectly to a request for a command Operator response
entry. You entered the command options with Notify the system programmer.
incorrect spacing or, when prompted for a selection
number, entered a letter rather than a number or a
number not on the display. System programmer response
Activate the specified task with the START command.
System action
BNJ924I CANNOT SEND TO SPECIFIED
The system waits for a response. DOMAIN

Operator response Explanation


Enter a valid response or enter another command. While accessing error data from a remote domain,
the NetView program cannot send request messages
BNJ921I applid ENDED to the specified domain because no session is
established between you and the remote domain.
Explanation
Application applid successfully completed processing. System action
Message Variables The NetView program ignores the command and
processing continues.
applid
The application name.
Operator response
System action Enter the START DOMAIN command for the specified
domain. See the NetView online help for the syntax
Processing continues. and usage of the START DOMAIN command.
BNJ922I INITIALIZATION FAILED

Chapter 4. BNJ Prefix Messages 435


BNJ925I NO DATA EXISTS FOR COMMAND NetView-unique LUC alert-forwarding protocol while
SPECIFIED the entry point and remaining intermediate nodes are
using the SNA-MDS LU 6.2 alert-forwarding protocol.
You can attempt to resolve this problem by migrating
Explanation
the NV-UNIQ-forwarding intermediate node to SNA-
The resource name is not valid, or there is no data MDS-forwarding.
for that resource. This message is also issued if a
BNJ927I CURRENT SOLICITATION
resource type of CBUS was specified as an option for
FAILED/NO DATA EXISTS FOR
the PURGE command. The adapter address (A) option
THIS DEVICE
is not valid with a resource type of CBUS. If you are
viewing statistics, the next resource level has no data
and this statistical tracking sequence is complete. Explanation
The remote device failed to respond to a solicitation
System action for data and no data exists from a previous solicitation.
The NetView program ignores the request.
System action
Operator response The NetView program ignores the command and
processing continues.
Verify the database contents and enter the request
again.
Operator response
BNJ926I SD/SDOMAIN COMMAND FAILED.
SESSION DOMAIN IS UNCHANGED Verify that the device exists and that you entered its
name correctly. If so, notify the system programmer.
Explanation
System programmer response
The NetView program cannot communicate with the
domain you specified in the SDOMAIN command. Determine the status of the addressed device.
BNJ928I INVALID COLOR ATTRIBUTE
System action FOUND FOR A PROMPT TOKEN
IN BNJPROMP. THE COLOR
The NetView program ignores the command and
ATTRIBUTE FOUND WAS color
processing continues.
FOR PROMPT TOKEN nnn. THIS
TOKEN WILL NOT BE COLORED OR
Operator response HIGHLIGHTED IN ANY PROMPT
Be sure the domain ID you specified in the SDOMAIN LINE
command is correct. If so, enter the START DOMAIN
command for the specified domain, then enter the Explanation
SDOMAIN command again. If the SDOMAIN command
When the hardware monitor's operator station task is
still fails, notify the system programmer.
initializing, tokens are read in from partitioned data set
(PDS) member BNJPROMP. This is a list of tokens that
System programmer response will be colored or highlighted in all prompt messages.
The SDOMAIN command attempts to establish a This message was issued because a color that is not
cross-domain session in the following sequence: LU valid, color, was found for a token, nnn.
6.2 transport, LUC transport, and LU0 transport. All Message Variables
attempts failed. Enter HELP SDOMAIN for information
on the messages issued when each attempt fails, and color
suggested corrective actions. The color attribute that is not valid
nnn
When your network configuration is such that you have
The prompt line token in BNJPROMP
alerts that are forwarded from entry point NetView
nodes through one or more intermediate nodes to
a NetView focalpoint, the NetView focal point might
not be able to establish a cross-domain session with
the entry point NetView program. This scenario might
occur when one of the intermediate nodes is using the

436 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System programmer response
The hardware monitor will continue processing; See the IBM Z NetView Troubleshooting Guide for
however, this token will not be colored or highlighted possible causes of the storage shortage.
in any prompt message.
BNJ934I operatorid module locid
HARDWARE MONITOR COULD
System programmer response NOT OBTAIN STORAGE FOR
Correct the color selection for the specified token in ITS MQS BUFFER. DSIGET
PDS member BNJPROMP. RETURN CODE WAS retcode. THE
PROCESSING OF AN ALERT OR AN
BNJ932I INVALID INVOCATION OF NPDA OPERATOR-ENTERED COMMAND
WAS UNABLE TO COMPLETE
Explanation BECAUSE OF THE STORAGE
FAILURE.
You tried to call the NetView display function by
means other than described in the NetView online
Explanation
help. The command facility task under which the
hardware monitor runs must be either the operator The hardware monitor cannot continue processing
station task (OST) or the NetView-NetView task (NNT). because it cannot obtain storage.
The hardware monitor cannot run under an automated
Message Variables
OST.
operatorid
System action The terminal operator identifier (if no operator is
defined, this value is NONE).
Returns to the command facility environment.
module
The name of the NetView module that detected
Operator response the error.
Notify the system programmer. locid
The location within the NetView module that
detected the error.
System programmer response
retcode
Determine which command facility task was in control The NetView return code.
when the attempt to invoke the hardware monitor was
made and correct the procedure to call the hardware
monitor through the OST or NNT tasks. System action
Processing stops for the current operator-entered
BNJ933I STORAGE FAILURE
command or alert.
ENCOUNTERED. IF COMMAND
ENTERED, WAIT AND REENTER.
System programmer response
Explanation See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
The hardware monitor cannot continue processing
because it cannot obtain storage. BNJ935I STORAGE FAILURE WHEN
PROCESSING REQMS COMMAND -
System action WAIT AND REENTER COMMAND.

Processing stops for the current command or alert.


Explanation
Operator response The hardware monitor cannot continue processing the
REQMS command because it cannot obtain storage.
If the message occurred as a result of entering a
command, wait 30 seconds and enter the command
again. Determine whether you received message System action
BNH16I, which means the task has reached its storage Processing stops for the current REQMS command.
limit. If so, notify your system programmer.

Chapter 4. BNJ Prefix Messages 437


Operator response as described in the NetView online help. If the error
persists, notify the system programmer.
Wait 30 seconds and enter the command again.
Determine whether you received message BNH16I,
which means the task has reached its storage limit. System programmer response
If so, notify your system programmer. Determine the user request and the display from
which it was made and contact IBM Software Support.
System programmer response BNJ961I AL/EV DESCRIPTION CODE ccccc
See the IBM Z NetView Troubleshooting Guide for DOES NOT EXIST OR IS NOT
possible causes of the storage shortage. SUPPORTED

BNJ950I DATA SERVICES FAILURE IN


PROCESSING LAST COMMAND Explanation
You tried to use an error description or probable cause
Explanation code and failed.

Your last request for information from the database Message Variables
failed. Error messages have been issued to the ccccc
authorized message receiver. The error description code or the probable cause
code.
System action
The NetView program does not process the request. If System action
you made the request from the hardware monitor, you Processing continues.
are moved to the beginning of the hardware monitor
tracking sequence and the COMMAND LIST display is
shown. Operator response
Enter the request for the code again ccccc and retry
Operator response the SRFILTER command. If the retry fails, record the
screens, code values, and commands and notify the
Enter the request again or enter a new command. system programmer.
BNJ960I TEXT FOR ccccc IS edpctext
System programmer response
Explanation Determine the user request and the display from
This message is in response to the DFILTER ccccc which it was made and contact IBM Software Support.
command. It verifies that the error description or BNJ962I AL/EV DESCRIPTION CODE FOR
probable cause code and text are those retrieved for SELECTION nn IS ccccc
eventual use in an SRFILTER command.
Message Variables Explanation
ccccc You tried to determine an event (alert) description or
The error description code or the probable cause probable cause identifying code for an alert or most
code. recent display. This message is the normal response to
edpctext such a request.
The error description or the probable cause text
Message Variables
associated with code ccccc.
nn
The selection number.
System action
ccccc
Processing continues. The error description code or the probable cause
code.
Operator response
If text for the specified code does not match the System action
expected text, enter the code retrieval request again Processing continues.

438 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response command
The command name.
Record the code value for future use in an SRFILTER
command.
System action
BNJ963I ALERT REQUESTED DOES NOT
EXIST The NetView program ignores the request.

Explanation Operator response


You tried to access a recommended action screen for If you need to enter the command, notify the system
an alert that was previously deleted. Rebuild the alert programmer.
screen from the database to access the recommended
screen. System programmer response
Evaluate the operator's requirements and add the
System action appropriate security access if required.
Processing continues. BNJ969I UNABLE TO INVOKE command
COMMAND DUE TO INSUFFICIENT
Operator response STORAGE

Enter another NetView command.


Explanation
BNJ965I END COMMAND HAS BEEN
ISSUED, SESSION WILL BE You entered a command that was not recognized by
TERMINATED the hardware monitor and that was to be routed to
other NetView components. However, the command
routing failed because of a storage shortage.
Explanation
Message Variables
The data services task (DST) ended or was never
activated. A hardware monitor END command was command
issued. The command name.

System action System action


The NetView program issues a hardware monitor END The NetView program ignores the request.
command.
Operator response
Operator response Enter the command again. (Some storage can be
Start a new session with the hardware monitor after regained by ending sessions with currently active
you restart the appropriate data services task (DST). NetView components using the END command.)

System programmer response System programmer response


Start the data services task (DST) for the hardware Verify NetView procedure region size.
monitor. BNJ970I UNABLE TO ROUTE command
BNJ968I THE NCCF COMMAND 'command' COMMAND TO NCCF, RC=retcode
IS NOT AUTHORIZED FROM MACRO macro

Explanation Explanation
You are not permitted to issue the command because You entered a command that was not recognized by
of security definitions that are in effect. The command the hardware monitor and that was to be routed to
entered, which was to be routed to other NetView other NetView components. However, the command
components, was not recognized by the hardware routing failed because of an internal problem. The
monitor. macro and return code listed here will aid in software
problem determination.
Message Variables

Chapter 4. BNJ Prefix Messages 439


Message Variables Explanation
command You attempted to copy the hardware monitor panel to
The name of the command you entered. the disk log. The command facility task did not have
retcode enough working storage to allow this.
The return code.
macro System action
The macro through which the hardware monitor
Processing continues.
attempted to route the command to the command
facility.
Operator response
System action Notify the system programmer.
The NetView program ignores the request.
System programmer response
Operator response Perform procedures for out-of-storage conditions.
Notify the system programmer. BNJ977I AN INVALID EXTERNAL LOG TYPE
WAS SPECIFIED. RC=24
System programmer response
Contact IBM Software Support.
Explanation
You attempted to copy the hardware monitor display
BNJ974I SCREEN HAS BEEN PRINTED
to the disk log. No command definition statement
(CMDDEF) was found for DSIELSMF in CNMCMD.
Explanation
You printed the hardware monitor panel on the System action
hardcopy task.
Processing continues.

System action Operator response


Message is printed and processing continues.
Notify the system programmer.
BNJ975I SCREEN LOGGED BUT NOT
PRINTED System programmer response
Place a CMDDEF in the CNMCMD file for module
Explanation DSIELSMF.
You copied the hardware monitor panel to the disk log.
BNJ978I DSIMQS FAILED WHEN
The hardcopy task was not active so the panel did not
ATTEMPTING TO SEND RECORD
print there.
TO EXTERNAL TASK. RC=28

System action Explanation


Processing continues.
You attempted to copy the hardware monitor panel
to the disk log. The DSIMQS failed while the NetView
Operator response program attempted to send the log record to the disk
log task.
If a hardcopy task print is desired, you must set one up
through the command facility.
System action
BNJ976I STORAGE NOT AVAILABLE TO
COPY USER INPUT BUFFER. Processing continues.
RC=04
Operator response
Notify the system programmer.

440 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response BNJ982I ERROR OCCURRED READING
MEMBER member
Contact IBM Software Support.
BNJ979I DSIWLS FAILED. RC=retcode Explanation
The DSIDKS macro returned an undefined error return
Explanation code after attempting to FIND or READ the indicated
You attempted to copy the hardware monitor panel to member member.
the disk log. The copy failed and the reason code is Message Variables
represented by retcode.
member
Message Variables The name of the member where the error
retcode occurred.
The code for problem determination.
System action
System action Processing continues.
Processing continues.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Contact IBM Software Support.
See DSIWLS in IBM Z NetView Programming: BNJ983I ERROR OCCURRED READING
Assembler for an explanation of the return code. MEMBER member. I/O ERROR.
BNJ980I SELECTION nn USER DATA: uuuuu RC=8.

Explanation Explanation
You asked for the user data for an alert on the Alerts- The DSIDKS macro returned a return code of 8
Static or Alerts-History panels, or an event on the Most because of an I/O error. DSIDKS was issued with either
Recent Events panel. the FIND or READ option.

Message Variables Message Variables

nn member
The selection number. The name of the member where the error
occurred.
uuuuu
The user data associated with the alert or event.
This value represents the first five characters of System action
user data from the X'33' subvector. The first five
Processing continues.
characters can be used for filtering. If the alert or
event does not have any user data, N/A is returned.
For a generic alert, the entire user data field is Operator response
displayed on the Event-Detail panel. Notify the system programmer.

System action System programmer response


Processing continues. Check the hardware/software path of the I/O
operation.
Operator response
BNJ984I ERROR OCCURRED READING
Record the uuuuu value for future use in an SRFILTER MEMBER member. NCCF
or SVFILTER command. DEFINITION NAME NOT OPEN

Chapter 4. BNJ Prefix Messages 441


Explanation Explanation
DSIDKS returned a return code of 12. The DSIDKS The DSIDKS macro returned a return code of 12.
macro was issued with the FIND option before The DSIDKS macro was issued with the READ option
the CONNECT option was issued for the data set before the FIND option was issued for member
containing member member. member.
Message Variables Message Variables
member member
The name of the member where the error The name of the member where the error
occurred. occurred.

System action System action


Processing continues. Processing continues.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Add BNJPNL1 and BNJPNL2 data sets to the NetView Contact IBM Software Support.
startup procedure for MVS.
BNJ987I ERROR OCCURRED READING
BNJ985I ERROR OCCURRED READING MEMBER member. MEMBER NOT
MEMBER member. END OF DATA FOUND. RC=4
REACHED. RC=4
Explanation
Explanation
An error return code of 4 has been received from
DSIDKS returned a return code of 4. The DSIDKS DSIDKS. The DSIDKS macro was issued with the FIND
macro was issued with the READ option to read the option and member member was not found.
next line of member member but end of data was
Message Variables
reached.
member
Message Variables
The name of the member where the error
member occurred.
The name of the member where the error
occurred. System action
Processing continues.
System action
Processing continues. Operator response
Notify the system programmer.
Operator response
Notify the system programmer. System programmer response
Data set BNJPNL1 or BNJPNL2 is missing member
System programmer response
member. Contact IBM Software Support.
Edit member in data set BNJPNL1 and BNJPNL2.
Check for missing lines or valid lines that must not be BNJ988I MAXIMUM NUMBER OF PROMPT
marked with an asterisk. TOKENS ALLOWED IN BNJPROMP
HAS BEEN EXCEEDED. TOKEN
BNJ986I ERROR OCCURRED READING 'nnn' WILL NOT BE COLORED OR
MEMBER member. DSIDKS FIND HIGHLIGHTED IN ANY PROMPT
OPTION NOT ISSUED LINE.

442 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
When the hardware monitor was reading the tokens Processing continues.
in partitioned data set (PDS) member BNJPROMP to
determine which tokens in prompt messages to color Operator response
or highlight, too many tokens were encountered. A
limit of 25 tokens can be specified. If you require a soft copy of the panel, use the NetView
START TASK command for DSILOG and enter the COPY
Message Variables
command again to write a copy of the panel to a file.
nnn
BNJ991I command COMMAND REJECTED.
The name of the token that will not be highlighted.
SECONDS INVALID IN CONSTANT
TABLE
System action
The hardware monitor continues processing; however, Explanation
the extra tokens will not be colored or highlighted in
The number of seconds that was placed in the NetView
any prompt messages.
program's constants table is not valid. The number
of seconds in the NetView program's constants table
System programmer response is the maximum amount of time that the NetView
Condense the list of tokens in PDS member program will keep a solicitation command outstanding,
BNJPROMP to 25. waiting on a reply to the command.
Message Variables
BNJ989I SCREEN NEITHER LOGGED NOR
PRINTED. NO HARDCOPY OR LOG command
TASK ACTIVE The solicitation command that was issued by the
terminal operator.
Explanation
System action
You attempted to use the hardware monitor COPY
command but the NetView DSILOG subtask and the Command processing stops.
hardcopy task are not activated.
System programmer response
System action
Correct the number of seconds in the constants
Processing continues. module, DSICTMOD.
BNJ992I command COMMAND CANCELED.
Operator response NO RESPONSE FROM resource
To get hard copy of the panel, notify the system
programmer to set up the hardcopy task to start at Explanation
logon. For a soft copy of the panel, use the NetView
START TASK command to start DSILOG then enter the The maximum amount of time that the NetView
COPY command again. program will wait for a reply to the solicitation
command has been exceeded. The amount of time to
wait for the reply is specified in the NetView constants
System programmer response module, DSICTMOD.
See the IBM Z NetView Security Reference for Message Variables
information on how to set up the hardcopy task.
command
BNJ990I SCREEN PRINTED, BUT NOT The solicitation command that was issued by the
LOGGED terminal operator.
resource
Explanation The resource names that the command was issued
to.
You attempted to use the hardware monitor COPY
command. The NetView hardcopy task is activated, but
the DSILOG subtask is not active.

Chapter 4. BNJ Prefix Messages 443


System action System action
The NetView program canceled the command. The event is not logged. Processing continues.
Command processing stops.
Operator response
System programmer response
Start the DSICRTR task.
Determine why the resource did not send a reply to the
NetView program or increase the amount of time in the BNJ998I BNJDSERV TERMINATED. ALL
NetView constants module to wait for a reply. FILTERS ARE LOST, PANEL IS NO
LONGER UPDATED
BNJ993I INVALID NUMBER OF ENTRIES,
ins, FOUND IN FIRST LINE OF PDS Explanation
MEMBER BNJDNUMB
The Alerts-Dynamic panel is not receiving any
new alerts because the BNJDSERV task ended. All
Explanation
recording filters and viewing filters are lost.
This message is displayed when the hardware monitor
component's OST is being initialized. The first line of System action
the partitioned data set (PDS) member, BNJDNUMB,
contains the number of entries in the remainder of this Processing continues.
PDS member. A number that is not valid was found in
the first line. Operator response
Message Variables Start the BNJDSERV task. If necessary, reset any
ins recording or viewing filters using the hardware monitor
The three characters representing the number of SRFILTER or SVFILTER commands. Issue the hardware
entries remaining in the PDS member. monitor ALERTSD command again, and the panel is
updated as alerts are received.
System action BNJ999I HARDWARE MONITOR DATABASE
HAS CHANGED. NEW DATABASE
The hardware monitor continues to initialize.
IS: database

Operator response
Explanation
Notify the system programmer.
The hardware monitor has processed a SWITCH
command that has changed its database database
System programmer response from primary to secondary or vice versa. You receive
this message if you are viewing the hardware monitor
Correct the first entry in the PDS member, BNJDNUMB,
Alerts-Dynamic or Alerts-Static panels.
to contain three valid numeric digits. Have the
operator issue the hardware monitor END command Message Variables
and then issue NPDA to return to the hardware
database
monitor. This will ensure BNJDNUMB is read into
The name of the new hardware monitor database.
memory at OST initialization. See the IBM Z NetView
Customization Guide for more information.
System action
BNJ994I DSIMQS FAILED - DSICRTR
INACTIVE Processing continues.
Note: If you are viewing the Alerts-Dynamic panel
Explanation and the SWITCH command is processed at the same
time that the hardware monitor is recording alerts
The hardware monitor received an NMVT event from
to the database that was active before the SWITCH
a locally attached resource. DSIMQS attempted to
command was issued, your Alerts-Dynamic panel
queue the event to the DSICRTR task but DSICRTR
might not be updated for those alerts that were in the
was inactive.
process of being recorded to that database.

444 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ1001I NO VALID COMBINATION OF BNJDSERV task initialization member, with the W
SUBVECTORS WAS FOUND IN THE (Wrap) statement (for example, W MSU_CORR 25).
NMVT.
System action
Explanation The message is displayed and the correlation request
A combination of subvectors or subfields that is not for the current record ends.
valid was encountered in the NMVT of the record
BNJ1003I module locid BNJCBERP REPORTS
currently being processed for display.
A PROBLEM, RC = retcode

System action Explanation


The message is displayed and the process ends for
Module module reports that an error was detected
the current portion of the panel. The displayed panel
by BNJCBERP when processing the open systems
might have missing information.
interconnection (OSI) information in the NMVT of the
record selected.
Operator response
Message Variables
Notify the system programmer.
module
The name of the NetView module that detected
System programmer response the error.
Investigate the database to determine the record that locid
is not valid and make the appropriate corrections. The location within the NetView module that
detected the error.
BNJ1002I NO CORRELATION WAS FOUND
retcode
The code returned by BNJCBERP. Values are:
Explanation
Code
No correlation information was found on the database Meaning
for the correlation request entered.
04
This message is displayed on a number of different End of data for a sequence of data within the
panels for the following reasons: OSI NMVT.
• If this message is displayed on the Alerts-Static, 08
Alerts-History, Most Recent Events, Event Detail, or Not found (error condition).
Correlated Events panels and the domain of the 21
record against which the correlation request was Navigation table is not present.
made is the same as the session domain, either only
22
one matching correlated event record was found on
OSI parameter identifier is out of range.
the database of the session domain or no matching
records were found. 23
A function that is not valid was requested.
• If this message is displayed on the Alerts-Static or
Alerts-History panels and the domain of the record 24
against which the correlation request was made is Maximum thread level was reached for Get
not the same as the session domain, no matching Next Function.
correlated event was found on the database of the 25
other domain. Conversion request lacks conversion area.
• If this message is displayed on the Multiple Entries 26
Correlated Events panel and the domain that was Get Next Function does not have a matching
selected is a remote domain, no matching correlated thread.
event record was found on the database of the
27
remote domain.
Convert only has mismatched tags.
There might be no correlated records if the MSU 28
or resource correlation wrap counts are set to zero. No Get Type was called before a conversion
These wrap counts are defined in BNJMBDST, the request.

Chapter 4. BNJ Prefix Messages 445


29 Explanation
Unsupported length was encountered in OSI
data. You entered a command with more parameters than
necessary.
41
A conversion indicator that is not valid is in the
navigation table. System action
42 The NetView program ignores the command.
Object identification conversion table pointer is
missing. Operator response
43
OSI integer length is greater than the See the NetView online help for the correct number of
supported range. parameters.

44 BNJ1301I INVALID RESOURCE NAME


Output field is not the correct size. resname ENTERED (MUST BE
LEVEL 3, 4 OR 5)
45
Object identifier name code point was not
recognized by BNJCOBID. Explanation
46 You specified a resource resname for a DR/DRATIO
OSI nesting level was exceeded. command that has no statistical records on the
48 database at resource level 3, 4, or 5. If no resource
Error was returned by BNJCHTEA. resname is displayed, this message was issued
from within the hardware monitor for a DR/DRATIO
49
command or from a Multiple Entries panel for a DR/
Hex field to convert is too large.
DRATIO command.
50
Object description field has been filled. Message Variables
resname
System action The fully qualified resource name.

Processing stops for the current portion of the NMVT


record. This might result in a panel with missing
System action
information. The NetView program ignores the command.

Operator response Operator response


Notify the system programmer. Verify the resource name and see the NetView online
help for more information on the uses and limitations
System programmer response of the DRATIO command.

Investigate the database to determine the record that BNJ1302I SPECIFIED COMMAND
is not valid and make the appropriate corrections. DISALLOWED WHILE VIEWING
MULTIPLE ENTRIES DISPLAY
BNJ1068I ENTER SEL# (FULLY QUALIFIED
RESOURCE) OR ALL (FOR
SPECIFIED RESOURCE ZZZZZZZZ)
Explanation
The command you entered cannot be processed from
Explanation a multiple-entries display.

This is a prompt message for panel NPDA-70A.


System action
BNJ1300I INVALID COMMAND:
The NetView program ignores the command.
EXTRANEOUS PARAMETERS
SPECIFIED
Operator response
See the NetView online help for those commands
allowed on the multiple-entries display.

446 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ1303I USER NOT AUTHORIZED TO ISSUE Explanation
COMMAND
You entered the MRECENT command without the N
parameter.
Explanation
You are not authorized to issue the command because System action
of security definitions that are in effect.
The NetView program ignores the command.

System action
Operator response
The NetView program ignores the command.
See the NetView online help for the correct syntax of
the MRECENT command and enter it again.
Operator response
BNJ1307I MINIMUM NUMBER OF
Contact the system programmer for a listing of KEYWORDS NOT SPECIFIED
commands authorized for your user ID.
Explanation
System programmer response
You entered a command with an insufficient number of
Determine the commands allowed for this operator. parameters.
BNJ1304I INVALID SELECTION LETTER
SPECIFIED System action
The NetView program ignores the command.
Explanation
The alphabetical character selected is not valid for this Operator response
display.
See the NetView online help for the correct syntax of
the command and enter it again.
System action
BNJ1308I INVALID SELECTION NUMBER
The NetView program ignores the request and SPECIFIED
processing continues.
Explanation
Operator response
You entered a selection number that is either not
Enter the selection number again using one of the numeric or is not within the range of those shown on
characters shown in the prompting line of the current the current display.
display.
BNJ1305I KEYWORD FOR DATA TYPE IS System action
INVALID - SHOULD BE 'EV' OR 'ST'
The NetView program ignores the request and
processing continues.
Explanation
You entered an incorrect data type. You can use in Operator response
addition to EV or ST keyword for data type you can also
use EVSTGMF or GMFALERT. Enter the command again using the correct selection
number.

System action BNJ1309I INVALID SELECTION - NO


DATA EXISTS FOR ATTACHED
The NetView program ignores the command. RESOURCES

Operator response Explanation


Enter the command again using the correct data type. There is no data on the database for the resources
BNJ1306I 'N' (FOR RESOURCE NAMES) MUST attached to the selected device.
BE USED WITH THIS COMMAND

Chapter 4. BNJ Prefix Messages 447


System action BNJ1314I INVALID SYNTAX - PARMS
ARE INVALID AFTER AN '*'
The NetView program ignores the request and FOLLOWING A QUALIFIER
processing continues.
BNJ1310I INVALID SELECTION - MOST Explanation
RECENT DATA DOES NOT EXIST
FOR THIS RESOURCE The hardware monitor syntax for fully qualified names
does not allow parameters to follow trailing asterisks
in any command.
Explanation
You entered a selection number for a resource that System action
does not have any most recent data.
The NetView program ignores the command.
System action
Operator response
The NetView program ignores the request and
processing continues. See the NetView online help for the correct use
of asterisks as command qualifiers and enter the
BNJ1311I PURGE COMMAND ACCEPTED command again.
BNJ1315I INVALID SYNTAX - QUALIFIERS
Explanation FOR RES-TYPE CANNOT BE
You entered the PURGE command correctly and the LONGER THAN 4 CHARS
database purge is in progress.
Explanation
System action You entered an incorrect resource type. Some valid
The database is purged. resource types are CHAN, COMC, CPU, CTRL, DEV,
IOCU, LCTL, LDEV, LINE, LOOP, SCU, TCU, WKST, or
BNJ1312I INVALID OPTION SPECIFIED IN product defined.
HELP COMMAND
System action
Explanation
The NetView program ignores the command.
You entered the HELP command improperly.
Operator response
System action
Enter the command again using the correct resource
The NetView program ignores the request and type.
processing continues.
BNJ1316I INVALID SYNTAX - '*' MUST
BNJ1313I INVALID SYNTAX - MAX NUMBER EITHER PRECEDE OR TERMINATE
OF RESOURCE QUALIFIERS FOR THE QUALIFIERS
THIS CMND IS 4
Explanation
Explanation
Asterisks used in fully qualified names cannot appear
You entered too many names for the fully qualified both before and after resource names.
resource name in the command.
System action
System action
The NetView program ignores the command.
The NetView program ignores the command.
Operator response
Operator response
See the NetView online help for the correct use
See the NetView online help for the correct syntax of of asterisks as command qualifiers and enter the
the command and enter it again. command again.

448 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ1317I INVALID SYNTAX - MAX NUMBER Explanation
OF RESOURCE QUALIFIERS FOR
THIS CMND IS 5 You entered an explicit command whose syntax
requires resource names or types. The command as
you entered it does not contain a resource name or
Explanation type.
You entered a command that indicated that data was
to be retrieved for a resource level that is not valid. System action
The command is ignored and processing continues.
System action
The command is ignored. Operator response
Enter the command again using resource names or
Operator response types.
See the NetView online help for the correct command BNJ1324I INVALID RESOURCE NAME
syntax and enter the command again. resname ENTERED (MUST BE
BNJ1318I INVALID SYNTAX - VALID LEVEL 2, 3, 4 OR 5)
KEYWORDS SIGNIFYING TYPE/
NAME ARE 'T' OR 'N' Explanation
You specified a resource resname for a DR/SRATIO
Explanation command that has no statistical records on the
A 'T' or 'N' was not found in the type or name position database at resource level 3, 4, or 5. If no resource
of the keyword. resname is displayed, this message was issued
from within the hardware monitor for a SR/SRATIO
command or from a Multiple Entries panel for a SR/
System action SRATIO command.
The command is ignored. Message Variables
resname
Operator response The fully qualified resource name for which the
Enter the command correctly. command failed.

BNJ1319I INVALID SYNTAX - ALL


ASTERISKS FOR RESOURCE
System action
QUALIFIERS ARE NOT ALLOWED The command is ignored.

Explanation Operator response


You entered a command using all asterisks as resource Verify the resource name and see the NetView online
names. help for more information on the uses and limitations
of the SRATIO command.
System action BNJ1327I DISPLAY ID NOT AUTHORIZED
The command is ignored.
Explanation
Operator response An internal NetView failure occurred.
See the NetView online help for the correct use of
asterisks while specifying resource names and enter System action
the command again.
Processing continues.
BNJ1320I INVALID SYNTAX - RESOURCE
TYPE(S) OR NAME(S) REQUIRED
BUT NOT PRESENT
Operator response
Record the current display and request issued. Notify
the system programmer.

Chapter 4. BNJ Prefix Messages 449


System programmer response Operator response
Determine the user request and the display from See the NetView online help for the correct threshold
which it was made. Contact IBM Software Support. values and enter the command again.
BNJ1328I CANNED TEXT LOAD MODULE BNJ1331I INVALID WRAP COUNT
CANNOT BE LOADED - MUST BE SPECIFIED
ADDED TO SYSTEM
Explanation
Explanation
You entered a wrap count value that is either not
An internal NetView failure occurred because a load numeric or is greater than the maximum value allowed
module is not in the system. for the data type. For the EV (Event) or ST (Stat) data
types, the maximum value allowed for IBM Z NetView
System action is 450, and the maximum value allowed for a prior
release of NetView is 999.
Processing continues.
System action
Operator response
The command is ignored.
Record the current display and request issued. Notify
the system programmer.
Operator response
System programmer response See the NetView online help for the correct wrap count
value, then enter the command again.
Determine which load module was requested and
whether it is in the library. BNJ1332I INVALID DATA TYPE SPECIFIED

BNJ1329I REQUIRED PARAMETER(S)


Explanation
MISSING IN COMMAND
You entered a command that does not contain the
Explanation correct data type. Valid data types are AL, EV, and ST.

You entered a command that does not contain the


System action
required parameters.
The command is ignored.
System action
Operator response
The command is ignored.
Enter the command again with the correct data type.
Operator response BNJ1333I INVALID RESOURCE NAME
See the NetView online help for the correct syntax and INDICATOR SPECIFIED
enter the command again.
Explanation
BNJ1330I INVALID THRESHOLD VALUE
SPECIFIED You entered a name that is not valid.

Explanation System action


You entered a threshold value that is either not The command is ignored and processing continues.
numeric or is greater than the maximum allowed.
Operator response
System action
Enter the command again after determining the
The command is ignored. correct resource name.
BNJ1334I LOAD FAILED FOR RECOMMENDED
ACTION PANEL

450 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
A request for a recommended action display cannot be Record information and notify the system programmer.
filled because of a load failure.
System programmer response
System action
Determine the user request and the terminal where it
The request is ignored and processing continues. was entered. Contact IBM Software Support.
BNJ1337I SRFILTER CMD REQUIRES ESREC/
Operator response AREC/OPER/ROUTE/ TECROUTE/
Record the current display and request. Notify the COLOR
system programmer.
Explanation
System programmer response You specified an incorrect recording filter type in an
Determine the module containing the requested SRFILTER command.
recommended action display and determine if it is
present in the library. System action
BNJ1335I COULD NOT SEND FULL The command is ignored.
SCREEN DUE TO DSIPSS ERROR
RC=retcode Operator response
Enter the command again using one of the recording
Explanation
filter types shown in the message.
An error occurred while attempting to write a hardware
monitor message to a terminal. BNJ1338I SRF/SRFILTER NOT EXECUTED,
DELETE/PASS/BLOCK/CLEAR
Message Variables MUST BE SPECIFIED
retcode
The code used for problem determination. Explanation
You specified an incorrect action type in an SRFILTER
System action command.
Processing continues.
System action
Operator response The command is ignored.
Notify the system programmer.
Operator response
System programmer response Enter the command again using one of the action types
See IBM Z NetView Programming: Assembler for an shown in the message.
explanation of the return code and correct the error. BNJ1340I INVALID ETYPE FOUND
BNJ1336I FOLLOWING 'E' PARAMETER OF
DSIGET FAILED - MAIN STORAGE
SRF/SRFILTER COMMAND
NOT AVAILABLE

Explanation Explanation
You specified an incorrect event type in an SRFILTER
An internal NetView failure occurred.
command. Valid event types are AVAL, BYPS, CUST,
DLRC, ENV, HELD, IMPD, IMR, INST, INTV, NTFY, PAFF,
System action PERF, PERM, PROC, REDL, RSLV, RSNT, SCUR, SNA,
Processing continues. TEMP, UNKN, and USER.

System action
The command is ignored.

Chapter 4. BNJ Prefix Messages 451


Operator response System action
Enter the command correctly. The NetView program ignores the command.
BNJ1341I SRF/SRFILTER COMMAND
ACCEPTED Operator response
Enter the command without the ALL option.
Explanation
BNJ1345I 'SEL# M ALL' IS NOT VALID FOR
You entered an SRFILTER command correctly. THIS ALERT

System action Explanation


Processing continues. The selected alert was first logged at a NetView
release that does not support the ALL option of the
BNJ1342I DATA SERVICES FAILURE WHILE MRECENT (M) command.
PROCESSING SRF/SRFILTER
COMMAND
System action
Explanation The NetView program ignores the command.
A failure occurred while processing an SRFILTER
command. Operator response
Enter the command without the ALL option.
System action
BNJ1351I INVALID NUMBER OF PARMS
The command is ignored. FOUND IN SVF/SVFILTER
COMMAND
Operator response
Explanation
Record the parameters you entered in the SRFILTER
command and notify the system programmer. You entered the SVFILTER command incorrectly.

System programmer response System action


Contact IBM Software Support. The command is ignored.
BNJ1343I 'DM' IS NOT VALID FOR THIS
RECORD Operator response
See the NetView online help for the correct syntax of
Explanation the SVFILTER command and enter it again.
The detail menu (DM) is not valid because the selected BNJ1352I PASS/BLOCK/CLEAR - NOT
record is not an NMVT or CP-MSU. SPECIFIED IN SVF/SVFILTER
COMMAND
System action
Explanation
The NetView program ignores the command.
You did not specify the correct action types in an
BNJ1344I 'SEL# M ALL' IS NOT SUPPORTED SVFILTER command.
AT THE FOREIGN DOMAIN

System action
Explanation
The command is ignored.
The selected alert was forwarded from a NetView
release that does not support the ALL option of the
MRECENT (M) command. Operator response
Enter the SVFILTER command again using one of the
action types shown in the message.

452 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ1353I INVALID ETYPE AFTER 'E' BNJ1357I FILTER ENTRY DELETE FAILED;
PARAMETER OF SVF/SVFILTER FILTER ENTRY HAS BEEN
COMMAND PREVIOUSLY DELETED

Explanation Explanation
You specified an incorrect event type in an SVFILTER You tried to delete a filter element that has already
command. Valid event types are: AVAL, BYPS, CUST, been deleted.
DLRC, ENV, HELD, IMPD, IMR, INST, INTV, NTFY, PAFF,
PERF, PERM, PROC, REDL, RSLV, RSNT, SCUR, SNA, System action
TEMP, UNKN, and USER.
The request is ignored and processing continues.
System action
Operator response
The command is ignored.
Redisplay the filter status and determine if the entry
still exists.
Operator response
BNJ1358I INVALID FILTER TYPE SPECIFIED
Enter the command correctly.
IN DF/DFILTER COMMAND
BNJ1354I TIME PARAMETER INVALID WHEN
USED WITH BLOCK KEYWORD Explanation
The filter type you specified in the DFILTER command
Explanation
is not valid. Valid filter types are AREC, C CODE,
You cannot specify a time parameter for blocking ESREC, OPER, ROUTE, and VIEW.
action in an SVFILTER command.
System action
System action
The command is ignored and processing continues.
The command is ignored.
Operator response
Operator response
Enter the command correctly.
See the NetView online help for the correct syntax of
BNJ1359I GLOSSARY LOOK-UP IS INVALID
the SVFILTER command and enter it again.
WITH NPDA INACTIVE
BNJ1355I SVF/SVFILTER COMMAND
ACCEPTED Explanation
The glossary look-up function is not valid when the
Explanation
hardware monitor is inactive.
You entered an SVFILTER command correctly.
System action
System action
The hardware monitor is activated and the command is
Processing continues. ignored.
BNJ1356I FILTER ENTRY SUCCESSFULLY
DELETED Operator response
Enter the glossary look-up command again.
Explanation Note: Only common terms located on the screen from
You entered the delete function for the specified filter which the look-up command is run will be displayed.
correctly.
BNJ1360I INVALID CTRL COMMAND OPTION

System action
Processing continues.

Chapter 4. BNJ Prefix Messages 453


Explanation Operator response
You specified the CTRL command with an incorrect Enter the command again specifying a valid keyword.
option. Valid options are LINK, LVL, and SEC. See the NetView online help for a list of valid keywords
for the command.
System action BNJ1366I RECORD OTHER THAN A LOCAL
The NetView program ignores the command. OR PRIMARY OBR INVOKED BY
BNJEOPRA

Operator response
Explanation
Enter the command correctly.
An internal NetView failure occurred.
BNJ1361I INVALID SYNTAX GIVEN FOR CTRL
COMMAND
System action
Explanation Processing continues.

You entered the CTRL command incorrectly.


Operator response
System action Notify the system programmer.

The NetView program ignores the command.


System programmer response
Operator response Determine the user request and the display from
which it was made and contact IBM Software Support.
See the NetView online help for the correct syntax of
CTRL and enter the command again. BNJ1368I INVALID COMMAND ISSUED

BNJ1362I KEYWORD FOLLOWING PASS/


Explanation
BLOCK MUST BE C/E/N/T/NREF/
TREF The NetView program does not recognize the
command you entered.
Explanation
System action
The characters following the action type in the filter
command are incorrect. The NetView program ignores the command.

System action Operator response


The NetView program ignores the command. See the NetView online help for the correct spelling
and syntax and enter the command again.
Operator response BNJ1369I KEYWORD FOLLOWING PASS
Enter the command again specifying one of the MUST BE C/P/E/N/T/NREF/TREF/
characters shown in the message. TIME/U

BNJ1363I INVALID KEYWORD FOLLOWING


Explanation
ETYPE
You used an incorrect keyword in a filter command.
Explanation
System action
This message is issued when an incorrect keyword
follows the event type. The NetView program ignores the command.

System action Operator response


The NetView program ignores the command. Enter the command again specifying one of the
keywords shown in the message.

454 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BNJ1370I KEYWORD FOLLOWING BLOCK System action
MUST BE C/P/E/N/T/NREF/TREF/
DOMAIN/U The NetView program ignores the command.

Explanation Operator response


You used an incorrect keyword in a filter command. Enter the command correctly.
BNJ1373I INVALID NON-NUMERIC
System action CHARACTER(S) SPECIFIED IN
TIME PARAMETER
The NetView program ignores the command.
Explanation
Operator response
You specified time parameter characters in a
Enter the command again specifying one of the command that are not valid.
keywords shown in the message.
BNJ1371I DR/DRATIO COMMAND INVALID System action
FOR TYPE/LEVEL OF SPECIFIED
RESOURCE NAME resname The NetView program ignores the command.

Explanation Operator response


The resource resname you specified is associated See the NetView online help for the correct characters
with a resource type/hierarchy level combination that to use and enter the command again.
is not supported for exceeding the error-to-traffic BNJ1374I TOO MANY DIGITS SPECIFIED
thresholds. Ratio commands are not valid for this IN HH/MM FIELD OF TIME
resource. If no resource resname is displayed, this PARAMETER
message was issued from within the hardware monitor
for a DR/DRATIO command or from a Multiple Entries
panel for a DR/DRATIO command. Explanation
Message Variables The number of digits you specified for hours alone,
hours with minutes, or minutes alone exceeds the
resname maximum allowable number of digits.
The fully qualified resource name for which the
command failed.
System action
System action The NetView program ignores the command.

The NetView program ignores the command.


Operator response
Operator response See the NetView online help for the correct syntax of
time specifications and enter the command again.
Ensure you entered the intended resource name
correctly. See the NetView online help to find the BNJ1375I MINUTES SPECIFIED WITH
resource types and levels that can be specified in the HOURS IN TIME PARAMETER
DRATIO command. CANNOT EXCEED 59

BNJ1372I INVALID TIME PARAMETER


SPECIFIED IN SVF/SVFILTER
Explanation
COMMAND The value for minutes you specified for hours with
minutes exceeds 59.
Explanation
You used a colon incorrectly or the number of digits
System action
you specified in the minutes parameter is less than The NetView program ignores the command.
required.

Chapter 4. BNJ Prefix Messages 455


Operator response Explanation
See the NetView online help for the correct syntax of You entered a DF/DFILTER command to display the
time specifications and enter the command again. current filter settings. You did not specify a valid filter.
BNJ1376I SET WRAP/RATIO COMMAND
ACCEPTED System action
The NetView program ignores the command.
Explanation
A SET WRAP or SET RATIO command completed Operator response
successfully. Enter the command again specifying one of the
keywords shown in the message.
System action
BNJ1381I NO MOST RECENT STATISTICAL
The values are changed and processing continues. DATA EXISTS FOR THIS
RESOURCE
BNJ1377I INVALID RESPONSE

Explanation
Explanation
You tried to view statistical data but none exists on the
You entered a screen control command on a hardware database for this resource.
monitor help panel that is not valid.

System action
System action
The NetView program ignores the request.
The NetView program ignores the request and
processing continues. BNJ1382I INVALID SYNTAX - 'TREF'/'NREF'
NOT VALID WITH THIS COMMAND
Operator response
Explanation
See the NetView online help for the correct function
response and enter the command again. You entered an explicit command that included TREF
or NREF as one of the parameters. These parameters
BNJ1379I INVALID REPLY - SEL# MUST BE are not valid with the explicit command you entered.
FOLLOWED BY 'DEL' (DELETE)

System action
Explanation
The NetView program ignores the request.
A selection number must be followed by DEL to delete
a filter element. You entered a selection number but
did not follow it with DEL. Operator response
See the NetView online help for more information and
System action enter the command again.
The NetView program ignores the request and BNJ1383I '*' AND '%' ARE NOT VALID WITH
processing continues. 'TREF'/'NREF'/'R'

Operator response Explanation


Enter the request again specifying the keyword shown You entered an explicit command that uses either an
in the message. asterisk (*) or a percent sign (%) with the TREF, NREF,
or R keywords. The asterisk and percent sign are not
BNJ1380I DFILTER CMD REQUIRES ESREC/ valid parameters.
AREC/OPER/ROUTE/ TECROUTE/
COLOR/VIEW/C CODE
System action
The NetView program ignores the request.

456 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response BNJ1388I SR/SRATIO COMMAND INVALID
FOR TYPE/LEVEL OF SPECIFIED
See the NetView online help and enter the command RESOURCE NAME resname
again.
BNJ1384I INVALID SYNTAX - VALID TYPE/ Explanation
NAME KEYWORDS ARE 'T' 'N'
'TREF' 'NREF' The resource resname you specified is associated
with a resource type/hierarchy level combination that
is not supported for exceeding the error-to-traffic
Explanation thresholds. Ratio commands are not valid for this
You entered an explicit command that calls for the resource. If no resource resname is displayed, this
name or type keyword and a name or type keyword message was issued from within the hardware monitor
that is not valid was used. for a SR/SRATIO command or from a Multiple Entries
panel for a SR/SRATIO command.
System action Message Variables
The NetView program ignores the request. resname
The fully qualified resource name for which the
command failed.
Operator response
See the NetView online help and enter the command System action
again.
The NetView program ignores the command.
BNJ1385I 'EV' COMMAND IS INVALID FROM
TOTAL EVENT DISPLAY
Operator response
Explanation Verify that you entered the intended resource name
correctly. See the NetView online help to find the
You entered EV from the Total Events display. This resource types and levels that can be specified in the
is not valid because the Total Events is already SRATIO command.
displayed.
BNJ1389I INVALID RESOURCE TYPE IN
RECORD
System action
The NetView program ignores the request. Explanation
A resource sent a data record that has a resource type
Operator response that is not valid.
See the NetView online help and enter the command
again. System action
BNJ1386I 'ST' COMMAND IS INVALID FROM Processing continues.
TOTAL STATISTICAL DISPLAY
Operator response
Explanation
Record the current display and request issued and
You entered ST from the Total Statistics display. This is notify the system programmer.
not valid because you are already in the Total Statistics
display.
System programmer response
System action Dump the database to determine which resource type
is not valid. Contact IBM Software Support.
The NetView program ignores the request.
BNJ1538I * = POTENTIAL MISSING
RESOURCE LEVELS DUE TO A
Operator response COMPLEX LINK
See the NetView online help and enter the command
again.

Chapter 4. BNJ Prefix Messages 457


Explanation System action
This is an informational message that notifies you that Processing continues but the state of reports is
there might be resource levels that do not appear in unchanged.
the list of resource names at the top of the NetView
display since the resource is attached through a Operator response
complex link. This message can appear on all displays
that contain a list of resource names except the ALERT, Enter the command again with a valid keyword.
TOTAL EVENT, or TOTAL STATISTICAL displays.
BNJ1543I INVALID COMMAND: FOREIGN
DOMAIN IS DOWN LEVEL FROM
System action THE HOST
Processing continues.
Explanation
Operator response The hardware monitor is in a cross-domain session
Use a system schematic to determine the complete with a foreign domain. However, the foreign domain is
configuration of the resource when this message an earlier release of the NetView program and does
appears. not support the command entered.

BNJ1540I SEQUENTIAL LOGGING FOR System action


REPORT GENERATION IS
ENABLED The command entered is ignored.
BNJ1550I NO DATA EXISTS FOR SELECTION
Explanation SPECIFIED
A REPORTS ON or REPORTS XLO command was
entered. Report generation is now enabled. Explanation
Note: This message is not related to the NetView You selected a menu item for which no data exists.
sequential logging function.
System action
System action
Processing continues.
Processing continues.
BNJ1541I SEQUENTIAL LOGGING FOR Operator response
REPORT GENERATION IS Save the menu on which this selection appeared and
DISABLED the data record. Notify the system programmer.

Explanation System programmer response


A REPORTS OFF command was entered. Report Determine the device generating the data record and
generation is now disabled. contact IBM Software Support.
Note: This message is not related to the NetView
BNJ1571I NO STORAGE AVAILABLE FOR
sequential logging function.
PAGE TABLE EXTENSION

System action Explanation


Processing continues.
An internal failure has occurred.
BNJ1542I KEYWORD FOLLOWING REPORTS
MUST BE ON OR OFF OR XLO System action
Processing continues.
Explanation
The keyword parameter following the REPORTS Operator response
command must be either ON, OFF, or XLO.
Notify the system programmer.

458 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response BNJ1575I OPTION *ALL NOT ALLOWED
WITH PRGATT COMMAND
Determine the user request and the panel from which
it was made. Contact IBM Software Support.
Explanation
BNJ1572I PURGE COMMAND ENTERED
FROM COMMAND LIST You entered *ALL as the final parameter on the
PRGATT command instead of a resource name.
Explanation
System action
A command list issued the PURGE/PRGATT command.
The PRGATT command is ignored.
System action
Operator response
Processing continues.
Check the PRGATT command syntax in the NetView
BNJ1573I ADDRESSABILITY TO A COLOR online help or enter the HELP command. Enter the
MAP SEGMENT WAS LOST PRGATT command again.
BNJ1576I COULD NOT SEND MESSAGE TO
Explanation SCREEN DUE TO DSIPSS ERROR
While processing a hardware monitor display, one of RC=retcode
the map segments cannot be accessed.
Explanation
System action An error occurred while attempting to write a hardware
Processing continues with a default map instead of the monitor message to a terminal.
map applicable to the display that was called. Message Variables
retcode
Operator response The DSIPSS return code.
Enter NPDA END. Then enter the command again that
you entered when the message was generated. If the System action
problem continues, notify the system programmer.
Processing continues.
System programmer response
Operator response
Check for an out-of-storage condition. If there is
one, follow the normal procedures for that particular Notify the system programmer.
installation. If there is no out-of-storage condition and
the problem continues, contact IBM Software Support. System programmer response
BNJ1574I NUMBER OF PAGES SPECIFIED See DSIPSS in IBM Z NetView Programming: Assembler
WAS INVALID for the meaning of the return code and correct the
error.
Explanation BNJ1577I COULD NOT CLASSIFY NODE node.
The nnn number on a FORWARD nnn or BACK nnn INTERNAL ERROR
command is not valid. nnn must be an unsigned
integer from 0 to 999. Explanation
A hardware monitor internal failure occurred. The
System action hardware monitor is unable to identify the method for
The NetView program ignores the request. presenting a new page or other display related to the
current display.
Operator response Message Variables
Enter the FORWARD or BACK command with a valid node
number. The name of the node.

Chapter 4. BNJ Prefix Messages 459


System action System action
The NetView program ignores the request. The Event Detail screen is displayed.

Operator response Operator response


Notify the system programmer. Log the problem to Information/Management from the
Event Detail screen.
System programmer response BNJ1594I NO STORAGE AVAILABLE FOR THE
Determine the user request and the screen from which NPDA COLORMAP TABLE
it was made and contact IBM Software Support.
Explanation
BNJ1579I NPDA COULD NOT CONNECT TO
COLOR MAP PDS BNJPNL2 An attempt to get storage for the color map table
failed.
Explanation
System action
While initializing an operator station task session for
the hardware monitor, a connection cannot be made to Processing stops.
the color map PDS, BNJPNL2. The result will be that a
default coloration or highlighting will be used for all of Operator response
the hardware monitor displays.
Determine whether you received message BNH16I,
which means the task has reached its storage limit.
System action
If so, notify your system programmer.
Processing continues with a default map being used
instead of the map applicable to the display that was System programmer response
just called.
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If the
Operator response
condition persists and the message is repeated,
Enter the hardware monitor END command. This will contact IBM Software Support.
end the hardware monitor. Then enter the command
BNJ1620I INVALID REPLY - SEL# MUST BE
again that was previously entered when the message
FOLLOWED BY 'D' (DETAIL)
was generated. If the problem continues, notify the
system programmer.
Explanation
System programmer response You entered a selection number that did not have the
required D following it.
Check the procedure that is used to start the hardware
monitor to verify that there is a DD statement for
BNJPNL2. If there is no such DD statement, include System action
one. If there is a DD statement, check for an out-of-
The NetView program ignores the command.
storage condition. If this condition exists, follow the
normal procedures for your installation. If there is no
out-of-storage condition and there is a DD statement Operator response
for BNJPNL2 and the problem continues, contact IBM
Enter the command again with the D following it.
Software Support.
BNJ1624I ERROR OCCURRED READING
BNJ1593I SNA PROBLEM NOT FILED (ENTER
MEMBER member
SEL# FROM ABOVE PLUS P)

Explanation
Explanation
The DSIDKS macro returned an undefined error return
You tried to file a problem to Information/Management
code after attempting to FIND or READ the indicated
from the Event Summary screen, which is not allowed.
member member.
Message Variables

460 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


member System action
The name of the member where the error
occurred. Processing continues.

System action Operator response


Processing continues. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Add BNJPNL1 and BNJPNL2 data sets to the NetView
startup procedure.

System programmer response BNJ1629I ERROR OCCURRED READING


MEMBER member. END OF DATA
Contact IBM Software Support. REACHED. RC=4
BNJ1627I ERROR OCCURRED READING
MEMBER member. I/O ERROR. Explanation
RC=8
DSIDKS returned a return code of 4. The DSIDKS
macro was issued with the READ option to read the
Explanation next line of member member but end of data was
The DSIDKS macro returned a return code of 8 reached.
because of an I/O error. DSIDKS was issued with either Message Variables
the FIND or READ option.
member
Message Variables The name of the member where the error
member occurred.
The name of the member where the error
occurred. System action
Processing continues.
System action
Processing continues. Operator response
Notify the system programmer.
Operator response
Notify the system programmer. System programmer response
Edit member in data set BNJPNL1 or BNJPNL2.
System programmer response
BNJ1630I ERROR OCCURRED READING
Check the hardware and software path of the I/O MEMBER member. DSIDKS FIND
operation. OPTION NOT ISSUED
BNJ1628I ERROR OCCURRED READING
MEMBER member. NCCF Explanation
DEFINITION NAME NOT OPEN
The DSIDKS macro returned a return code of 12.
The DSIDKS macro was issued with the READ option
Explanation before the FIND option was issued for member
DSIDKS returned a return code of 12. The DSIDKS member.
macro was issued with the FIND option before Message Variables
the CONNECT option was issued for the data set
containing member member. member
The name of the member where the error
Message Variables occurred.
member
The name of the member where the error
occurred.

Chapter 4. BNJ Prefix Messages 461


System action Explanation
Processing continues. You entered a command from the Alerts-Dynamic
panel (NPDA-30A) that is not valid.
Operator response Message Variables
Notify the system programmer. command
The command that is not valid.
System programmer response
System action
Contact IBM Software Support.
No action is taken on the command.
BNJ1633I ERROR OCCURRED READING
MEMBER member. MEMBER NOT
FOUND. RC=4. Operator response
Go to the Alerts-Static panel (NPDA-30B) to enter the
Explanation command.
An error return code of 4 has been received from BNJ1641I command IS NOT ALLOWED
DSIDKS. The DSIDKS macro was issued with the FIND WHILE THE ALERTS DYNAMIC
option and member member was not found. DISPLAY IS ACTIVE
Message Variables
Explanation
member
The name of the member where the error You entered a hardware monitor command that cannot
occurred. be processed because the Hardware Monitor Alerts-
Dynamic display is currently active.
System action Message Variables
Processing continues. command
The command that is not allowed.
Operator response
System action
Notify the system programmer.
No action is taken on the command.
System programmer response
Operator response
Data set BNJPNL1 or BNJPNL2 is missing member
member. Contact IBM Software Support. ROLL back to the Alerts-Dynamic display and then go
to the Alerts-Static panel (NPDA-30B) to enter the
BNJ1636I INVALID CTRL KEYWORD, ENTER
command.
'HELP CTRL' FOR CORRECT
KEYWORDS BNJ1651I CURRENT HELP SCREEN PAGE'S
NAME IS INVALID
Explanation
Explanation
You entered an unrecognizable CTRL command syntax.
A paging command was issued from a glossary or help
System action screen but the internal name for that screen contained
characters that are not valid. The current page number
The NetView program ignores the command. cannot be calculated.
The NetView program ignores the command.
Operator response
Enter HELP CTRL to see the correct syntax. Then enter Operator response
the CTRL command again.
Notify the system programmer.
BNJ1640I command COMMAND IS NOT
ALLOWED FROM THE ALERTS
DYNAMIC DISPLAY

462 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Operator response
Contact IBM Software Support. Notify the system programmer. NetView help is
probably not installed.
BNJ1652I THE MAXIMUM PAGE FIELD ON
CURRENT HELP SCREEN PAGE IS
UNREADABLE System programmer response
Ensure the NetView help facility is installed. If it is,
Explanation contact IBM Software Support.
A paging command was issued from a glossary or BNJ1902I 'A' (ADAPTER ADDRESS) NOT
help panel but the maximum page value contained VALID WITH THIS COMMAND
characters that are not valid. The maximum page
cannot be determined on "Page 1 of xx", where xx is Explanation
the maximum page.
This message is issued to the hardware monitor
terminal user. The adapter address for TOTAL and
System action
MRECENT commands is a valid parameter only when
The NetView program ignores the command. using the EV option.

Operator response System action


Notify the system programmer. The command is ignored.

System programmer response Operator response


Changing the hardware monitor help panels, while Enter the command correctly.
they are in use at the time of error, can cause this
problem. If no changes were made, or if the changes BNJ1903I INVALID ADAPTER ADDRESS
were correct, contact IBM Software Support. ENTERED

BNJ1653I FOREIGN DOMAIN IS DOWN Explanation


LEVEL, PRGATT IS NOT
SUPPORTED An adapter address that is not valid was entered with
the SRF command.
Explanation
System action
A purge attached (PRGATT) command was issued in
a cross-domain environment for the previous release. The command is ignored.
The PRGATT command is not supported for previous
releases of the NetView program. Operator response
Enter the command correctly.
System action
BNJ1904I KEYWORD FOLLOWING PASS/
The purge attached (PRGATT) command is ignored.
BLOCK/COLOR MUST BE
BNJ1657I REQUESTED HELP FACILITY IS A/C/P/E/N/T/NREF/TREF/U
NOT AVAILABLE
Explanation
Explanation
If the command that you entered was SRFILTER for
You tried to call the NetView help facility from the ESREC/AREC/OPER/ROUTE, the characters following
hardware monitor and it is not available. the action type in the filter command are incorrect.
If a COLOR recording filter was entered, then the
System action characters following the color parameters in the filter
command are incorrect.
Processing continues.

Chapter 4. BNJ Prefix Messages 463


System action BNJ1908I OPTION *ALL NOT ALLOWED
WHEN PURGING BY ADAPTER
The NetView program ignores the command. ADDRESS

Operator response Explanation


Enter the command again specifying one of the When the purge command by adapter address was
characters shown in the message. issued, *ALL was used instead of an adapter address.
BNJ1905I FOREIGN DOMAIN IS DOWN
LEVEL. PURGE BY ADAPTER System action
ADDRESS IS NOT SUPPORTED
The NetView program ignores the command.
Explanation
Operator response
A purge by adapter address command was issued in
a cross-domain environment for the previous release. Check the PRGATT command syntax in the NetView
The purge by adapter address command is not online help. Enter the PRGATT command again.
supported for previous releases. BNJ1909I NUMBER OF DETAIL RECORDS
PURGED EXCEEDS DETAIL
System action RECORD COUNT
The command is ignored.
Explanation
BNJ1906I EV IS ONLY VALID DATA TYPE
WHEN PURGING BY ADAPTER The hardware monitor maintains a count of the
ADDRESS number of detail records associated with a given
resource. The number of detail records purged from
the database has exceeded this count.
Explanation
A purge by adapter address command was issued with System action
a data type other than EV.
Processing continues.
System action BNJ1910I PURGE/PRGATT/SWRAP FAILED
BECAUSE ANOTHER PURGE/
The command is ignored. PRGATT/SWRAP IS IN PROGRESS

Operator response Explanation


Enter the command again using the correct data type. Your last PURGE, PRGATT, or SWRAP command failed
BNJ1907I PURGE BY ADAPTER ADDRESS because a PURGE, PRGATT, or SWRAP command is
NOT ALLOWED WITH PRGATT currently in progress.
COMMAND
System action
Explanation The NetView program ignores this command and
A PRGATT command was issued with a keyword of 'A' processing continues.
signifying adapter address.
Operator response
System action Wait for completion of the current PURGE, PRGATT or
The command is ignored. SWRAP command and reenter the command.
BNJ1913I INVALID COMMAND: FOREIGN
Operator response DOMAIN IS DOWN LEVEL FROM
THE HOST
Check the PRGATT command syntax in the NetView
online help. Enter the PRGATT command again.

464 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
The hardware monitor is in a cross-domain session Enter the command again specifying the correct
with a foreign domain. However, the foreign domain is product ID and alert ID.
an earlier release and does not support the command
BNJ1918I KEYWORD FOLLOWING PRODUCT
entered.
ID/ALERT ID MUST BE 'N' OR 'A'

System action
Explanation
The command is ignored; it is not supported in
previous releases. The characters following the product ID/alert ID
combination in the filter command are incorrect.
BNJ1914I INVALID SYNTAX - VALID
KEYWORDS ARE 'T,' 'N,' or 'A' System action
The NetView program ignores the command.
Explanation
A 'T,' 'N,' or 'A' was not found in the type/name/adapter Operator response
address position of the keyword.
Enter the command again specifying one of the
characters shown in the message.
System action
The NetView program ignores the command. BNJ1919I 'N' (RES), 'A' (ADPT) OR 'ALL N'
(RES) MUST BE USED WITH THIS
COMMAND
Operator response
Enter the command correctly. Explanation
BNJ1915I KEYWORD 'A' MUST BE FOLLOWED You entered an incorrect MRECENT EV command.
BY AN ADAPTER ADDRESS 'A'
System action
Explanation
The NetView program ignores the command.
The keyword 'A' must be followed by an adapter
address. A valid adapter address is considered to be Operator response
12 hexadecimal characters.
Enter the command correctly.
System action BNJ1920I RECORD(S) INCONSISTENT -
The NetView program ignores the command. CANNOT BE DISPLAYED ON THIS
SCREEN

Operator response
Explanation
Enter the command correctly.
Only one Most Recent Statistics panel can be
BNJ1916I INVALID PRODUCT ID/ALERT ID displayed for a command entered. There are records
ENTERED present on the database that cause panels (for
example, 51A and 51G) to be displayed.
Explanation
System action
Either the product ID or the alert ID was not valid.
The product ID must consist of either 4, 5, 7, or 9 The panel corresponding to the most recent record is
characters and the alert ID must consist of 1 to 8 displayed.
hexadecimal digits.
BNJ1921I INVALID SYNTAX - RESOURCE
NAMES/TYPES MUST PRECEDE
System action AND NOT FOLLOW A '%'
The NetView program ignores the command.

Chapter 4. BNJ Prefix Messages 465


Explanation Operator response
You have attempted to issue an SRFILTER (set Enter the command again from the appropriate panel.
recording filter) or SVFILTER (set viewing filter) Rerun the job.
command with an N or T keyword followed by a
BNJ1938I SEL# ADPT NOT VALID FROM
percent sign (%). One or more resource names or
MOST RECENT EVENTS BY
resource types must precede the '%' sign, and no
ADAPTER
resource names or resource types can follow the '%'
sign.
Explanation
System action You have entered SEL# ADPT from the Most Recent
The NetView program ignores the command. Events panel for an adapter address. This command
cannot be entered from the Total Events panel by
adapter address or from the Most Recent Events panel
Operator response by adapter address.
Enter the SRFILTER or SVFILTER command again with
at least one resource name or resource type preceding System action
the '%' sign, and no resource name or resource type
following the '%' sign. The NetView program ignores the command.

BNJ1936I INVALID SYNTAX - RESOURCE Operator response


NAMES CANNOT HAVE
CHARACTERS FOLLOWING AN * Enter the command again from the appropriate panel.
BNJ1941I NO RESPONSE HAS BEEN
Explanation RECEIVED FROM REMOTE device
You have attempted to issue an SRFILTER (set
recording filter) or SVFILTER (set viewing filter) Explanation
command with an N or NREF keyword that specifies
A TEST solicitation was successful but the local device
a resource name, and one or more of the resource
did not receive a response from the specified remote
names has an asterisk (*) followed by additional
device. A response data field is available for the
characters. For example, CNM*01 is not a valid use of
specified local device.
the asterisk, but CNM* is valid.
Message Variables
System action device
DSU/CSU or ACD.
The NetView program ignores the command.

Operator response System action


The LPDA-2 data panel is displayed with local device
Enter the command again without using an asterisk
data only.
followed by additional characters.
BNJ1937I SEL# ADPT NOT VALID FROM Operator response
TOTAL EVENTS BY ADAPTER
Notify the system programmer.
Explanation
System programmer response
You have entered SEL# ADPT from the Total Events
panel for an adapter address. This command cannot Contact IBM Software Support.
be entered from the Total Events panel by adapter
BNJ1942I LOCAL device RECEIVED
address or from the Most Recent Events panel by
RESPONSE WITH A BAD FCS
adapter address.

System action Explanation


A TEST solicitation was successful but the local device
The NetView program ignores the command.
received a response from the remote device with a bad

466 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


frame check sequence (FCS). A response data field is Message Variables
available for the local device.
mtype
Message Variables The DCE machine type in the 50 subvector.
device
DSU/CSU or ACD. System action
Panel NPDA-10AA is presented.
System action
The LPDA-2 data panel is displayed with local device Operator response
data only.
Notify the system programmer

Operator response System programmer response


Notify the system programmer.
Determine the DCE that is generating this 50 subvector
and contact IBM Software Support.
System programmer response
BNJ1947I INVALID SYNTAX - VALID
Contact IBM Software Support. KEYWORDS ARE 'T' OR 'N'
BNJ1943I LOCAL device RECEIVED
RESPONSE WITH INVALID Explanation
FORMAT
You entered an explicit command that calls for a type
or name keyword, and an type or name keyword that
Explanation was not valid was used.
The local device received a response with a correct
frame check, but a format that is not valid from the System action
remote device. A response data field is available for
The NetView program ignores the request.
the local device.
Message Variables Operator response
device See the NetView online help for the correct syntax and
DSU/CSU or ACD. enter the command again.

System action BNJ1948I 'R' PARAMETER ONLY VALID WITH


'ESREC DELETE' PARAMETERS
The LPDA-2 data panel is displayed with local device
data only.
Explanation
Operator response You entered an SRF/SRFILTER command with the
R parameter, but without the ESREC DELETE
Notify the system programmer. parameters. You cannot use R without ESREC DELETE.

System programmer response System action


Contact IBM Software Support. The NetView program ignores the command and
processing continues.
BNJ1945I MACHINE 'mtype' WITH
UNSUPPORTED LPDA-2 FAMILY ID
FOUND IN SUBVECTOR 50 Operator response
Enter the command correctly.
Explanation
BNJ1949I KEYWORD FOLLOWING DELETE
While trying to decode the 50 subvector that contains MUST BE R/A/C/P/E/N/T/NREF/
the data circuit-terminating equipment (DCE) data TREF/U
in order to present an LPDA-2 data panel, an
unrecognized local DCE machine type was found.

Chapter 4. BNJ Prefix Messages 467


Explanation System programmer response
You entered an SRFILTER command with the incorrect Investigate the database to determine which record is
characters following the action type. not valid and make the appropriate corrections.
BNJ1952I CORRELATOR RESOURCE NAME
System action EXCEEDS 56 CHARACTERS
The NetView program ignores the command and
processing continues. Explanation
You entered an MRECENT EV ALL N command with a
Operator response resource name that is not valid.
Enter the command again using one of the characters
shown in the message. System action
BNJ1950I THE SOURCE RECORD IS The NetView program ignores the command.
FLAWED, THE OUTPUT MAY BE
INCOMPLETE Operator response
Enter the command again with a valid resource name.
Explanation
BNJ1953I 'A'(ACTION), SEL# (CORRELATED
One or more errors were encountered while
EVENTS)
processing the statistical record. Processing continues
if possible, but the resulting display might not contain
all the expected data. Explanation
This is a prompt message for panel NPDA-43S.
System action
BNJ1954I 'A'(ACTION), SEL# (CORRELATED
Some data is not displayed. EVENTS) OR 'DM'(DETAIL MENU)

Operator response Explanation


Notify the system programmer. This is a prompt message for panel NPDA-43S.
BNJ1955I 'A'(ACTION), SEL# OR CE
System programmer response (CORRELATED EVENTS)
Determine the device that is generating the NMVT
record and contact IBM Software Support. Explanation
BNJ1951I NO CORRELATION IS PRESENT This is a prompt message for panel NPDA-43S.
BNJ1956I 'A'(ACTION), SEL# OR CE
Explanation (CORRELATED EVENTS) OR 'DM'
Subvector X'47' (MSU correlation) cannot be found (DETAIL MENU)
in the current record for which the correlation was
selected. Explanation
This is a prompt message for panel NPDA-43S.
System action
BNJ1957I SEL# OR 'A'(ACTION) OR CE
The message is displayed and the request for (CORRELATED EVENTS)
correlation for the current record ends.

Explanation
Operator response
This is a prompt message for panel NPDA-43R.
Notify the system programmer.
BNJ1958I ENTER SEL# FOR CORRELATED
EVENTS

468 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
This is a prompt message for panel NPDA-70B. A PRGATT command was issued with the specified
keyword.
BNJ1962E OSI DATA NOT DISPLAYED DUE TO
CONVERSION TABLES NOT BEING Message Variables
LOADED. keyword
The specified keyword.
Explanation
You cannot display OSI data contained in an event System action
record or counter set report statistical record on The command is ignored.
the current panel because the necessary OSI data
conversion tables cannot be loaded into storage.
Operator response
System action See the NetView online help for the correct syntax,
then enter the PRGATT command again.
The panel displays all available data. An associated
message is issued to the authorized operator and BNJ1966I DOWN-LEVEL TARGET NETVIEW
placed in the network log. DOES NOT CONTAIN A GMFALERT
DATABASE.
Operator response
Explanation
Notify the system programmer.
You previously issued an NPDA SDOMAIN command
System programmer response and established a session with a prior release of the
target NetView program. You later issued a PURGE
See the associated message BNJ901I or BNJ902I in GMFALERT command that cannot be processed in a
the network log and follow the documented response. prior NetView release.
BNJ1963I COMMAND NOT PROCESSED.
MULTIPLE ENTRIES System action
ENCOUNTERED The command is ignored.

Explanation BNJ2001I MORE THAN SIX DOMAIN NAMES


SPECIFIED ON THE SVF/SVFILTER
A command has been issued against a resource name COMMAND
for which multiple entries exist. The command was
issued from an environment other than a hardware
Explanation
monitor panel (NetView command list, autotask, PPT
or NCCF console). The ALL keyword was not specified You have attempted to issue an SVFILTER (set viewing
on the command invocation so the command is filter) command with more than six variable domain
rejected. name operands. Six variable domain name operands is
the maximum number allowed for this command.
System action
Operator response
The command is not processed.
Enter the SVFILTER command with a DOMAIN
Operator response keyword with six or fewer variable domain name
operands.
To issue the command against all fully qualified
resource names matching the supplied resource name, BNJ2002I DOMAIN PARAMETER INVALID
code the ALL keyword on the command invocation. To WHEN USED WITH PASS
issue the command against a single resource, use the KEYWORD
fully qualified resource name.
Explanation
BNJ1965I KEYWORD 'keyword' IS NOT
ALLOWED WITH THE PRGATT You have attempted to issue an SVFILTER (set viewing
COMMAND. filter) command with a DOMAIN keyword, using a PASS

Chapter 4. BNJ Prefix Messages 469


action. The DOMAIN keyword can only be specified Operator response
with a BLOCK action.
Enter the command again specifying at least one of the
color parameters.
Operator response
BNJ2005I MULTIPLE COLORS SPECIFIED
Enter the SVFILTER command with a DOMAIN WITH THE COLOR KEYWORD
keyword using a BLOCK action, specifying which
domains are to be filtered from view.
Explanation
BNJ2003I INVALID SYNTAX - DOMAIN NAME
CANNOT HAVE CHARACTERS If an SVFILTER command was entered, then multiple
FOLLOWING AN *. colors followed the COLOR keyword. If an SRFILTER
command was entered, then the recording filter type,
COLOR, was followed by more than one color. Only
Explanation one color can be specified on a command. The color
You have attempted to issue an SVFILTER (set viewing choices are: RED, TUR, BLU, YEL, WHI, PIN, or GRE.
filter) command with a DOMAIN keyword that specifies
a domain name that either contains an asterisk (*) System action
followed by additional characters or consists only of
an asterisk. The NetView program ignores the command.

System action Operator response


The NetView program ignores the command. Enter the command again specifying only one color.
BNJ2006I MULTIPLE HIGHLIGHT
Operator response PARAMETERS SPECIFIED WITH
COLOR KEYWORD
Enter the command again with domain names that do
not have characters following an asterisk or domain
names which do not consist only of an asterisk. Explanation
BNJ2004I NO COLOR PARAMETERS An SVFILTER command was entered with the COLOR
SPECIFIED FOLLOWING THE keyword followed by more than one highlighting
COLOR KEYWORD parameter, or an SRFILTER command was entered
with the recording filter type, COLOR, followed
by more than one highlighting parameter. Only
Explanation one highlighting parameter can be specified on
If an SVFILTER command was entered, then the a command. The highlighting choices are: BLINK,
COLOR keyword was not followed by a valid color REVERSE, or UNDRSCOR.
parameter. If an SRFILTER command was entered,
then the recording filter type, COLOR, was not followed System action
by a valid color parameter. Valid color parameters are:
The NetView program ignores the command.
• ALM or NOALM
• HIG Operator response
• BLI, REV, or UND
Enter the command again specifying only one
• RED, TUR, BLU, YEL, WHI, PIN, or GRE. highlighting parameter.
Up to four color parameters can be specified, by only BNJ2007I MULTIPLE ALARM PARAMETERS
one parameter from each of the four groups can be SPECIFIED WITH COLOR
used. KEYWORD

System action Explanation


The NetView program ignores the command. An SVFILTER command was entered with the COLOR
keyword followed by more than one alarm parameter,
or an SRFILTER command was entered with the
recording filter type, COLOR, followed by more than

470 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


one alarm parameter. Only one alarm parameter can BNJ2010I THE BLOCK ACTION CANNOT BE
be specified on a command. The alarm choices are: USED WHEN SPECIFYING COLOR
ALARM or NOALARM.
Explanation
System action
COLOR can only be specified when setting up a viewing
The NetView program ignores the command. filter with an action of PASS.

Operator response System action


Enter the command again specifying only one alarm The NetView program ignores the command.
parameter.
BNJ2008I PASS/BLOCK ARE NOT VALID Operator response
ACTIONS FOR THE COLOR FILTER
Enter the command again without the COLOR keyword.

Explanation BNJ2011I COLOR CANNOT BE SPECIFIED


WITH THE TIME KEYWORD.
A PASS or BLOCK action was used while a COLOR
filter was being set. PASS and BLOCK are not valid
Explanation
actions with the color filter. The recording filter type
COLOR can be followed by: CLEAR or one or more color COLOR cannot be used when filtering on TIME. The
parameters. TIME filter is used for event and statistical total
displays, and the COLOR keyword is used for the
System action coloring of alerts on the alert displays.

The NetView program ignores the command.


System action
Operator response The NetView program ignores the command.

Enter the command again specifying the correct


Operator response
parameters after the recording filter type COLOR.
Enter the command again without the COLOR keyword
BNJ2009I DELETE IS NOT A VALID ACTION
and color parameters.
WHEN SETTING A DEFAULT
BNJ2012I KEYWORD FOLLOWING AL/EV
Explanation DESCRIPTION MUST BE 'N'

While trying to set the recording filter default action,


Explanation
you specified the default action DELETE. Valid default
actions are: You entered an SVFILTER command. The keyword
following the AL/EV description code is not N.
• For ESREC, AREC, OPER, ROUTE
– PASS
System action
– BLOCK
The NetView program ignores the command and
• For COLOR processing continues.
– One or more valid color parameters
Operator response
System action Enter the command correctly.
The NetView program ignores the command. BNJ2015I THE "U" KEYWORD USER DATA
MUST BE 1 TO 5 CHARACTERS
Operator response
Enter the command again with a valid default for the Explanation
specified recording filter. The user data following the U keyword cannot be
longer than 5 characters.

Chapter 4. BNJ Prefix Messages 471


System action Operator response
The NetView program ignores the command. Enter the command again using one of the keywords
shown in the message.
Operator response BNJ2017I THE KEYWORD FOLLOWING USER
Enter the command again with a user data field that is DATA MUST BE E/N/T/NREF/TREF
1 to 5 characters.
Explanation
BNJ2016I THE KEYWORD FOLLOWING USER
DATA MUST BE A/E/N/T/NREF/ You entered an incorrect keyword after the user data.
TREF
System action
Explanation
The NetView program ignores the command.
You entered an incorrect keyword after the user data.
Operator response
System action
Enter the command again using one of the keywords
The NetView program ignores the command. shown in the message.

472 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Chapter 5. CNM Prefix Messages

This chapter lists the CNM prefix messages.


These messages are sent to the NetView terminal operator or the authorized message receiver. If an
authorized message receiver is not defined in the system or is not logged on, the messages destined for
the authorized message receiver are sent to the system console operator.
CNM000I MESSAGE msgno IS NOT IN CNM002I "command" FUNCTION IS
MESSAGE CSECT file COMPLETE

Explanation Explanation
A NetView module issued a CNM prefix message that The specified function has completed successfully.
was not defined in the specified message definition
Message Variables
module.
command
Message Variables
The name of a function or command
msgno
CNM003I INVALID SYNTAX ON FILTER
The message number
(TYPE "F") CONTINUATION
file RECORD
The message definition module where the
message should reside
Explanation
Operator response The previous F filter statement in DSICNM ended with
a comma, so the next record should have been a
Notify the system programmer. continuation record.

System programmer response System action


Contact IBM Software Support. The record is ignored and processing continues.
CNM001I THERE IS INSUFFICIENT VIRTUAL
STORAGE Operator response
Notify the system programmer.
Explanation
Status monitor is temporarily unable to obtain any System programmer response
virtual storage.
Correct the F statement. See the IBM Z NetView
Administration Reference for more information.
System action
CNM004I "msgind" IS AN INVALID
A request was not processed. MESSAGE INDICATOR

Operator response Explanation


Determine whether you received message BNH16I, The message indicator on an F statement in DSICNM
which means the task has reached its storage limit. member must be 1, 2, 3, or 4 and must be in column 5.
If so, notify your system programmer.
Message Variables
System programmer response msgind
The message indicator that is not valid
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
System action
The record is ignored and processing continues.

© Copyright IBM Corp. 1997, 2022 473


Operator response Message Variables

Notify the system programmer. request


The SNMP request specified on the command that
was entered
System programmer response
Code the 1, 2, 3, or 4 in column 5. See the IBM Z System action
NetView Administration Reference.
SNMP command processing ends normally.
CNM005I normal_SNMP_output
CNM008W SNMP request command
encountered errors
Explanation
This is a multiline message for the output of an SNMP Explanation
request.
Errors were reported during the SNMP request
Message Variables processing.
normal_SNMP_output Message Variables
The output generated from the SNMP request
request
The SNMP request PDU that was sent and
System action processed
The SNMP command runs successfully.
CNM006E SNMP_error System action
SNMP command processing completes.
Explanation
An error occurred during SNMP request or SNMP trap Operator response
automation processing. If the output is not expected, correct the command
Message Variables and issue it again. If the command is correct but
still results in unexpected errors, contact your system
SNMP_error programmer.
The returned string explaining the failure.
System programmer response
System action
Correct the failing condition, as appropriate.
SNMP command processing ends.
CNM009I STATUS MONITOR FULL SCREEN
SESSION WAS ABNORMALLY
Operator response TERMINATED
Correct and reissue the command. If the command is
correct but still fails, contact your system programmer. Explanation
You entered a STOP FORCE, STOP TASK, or VARY
System programmer response INACT command which caused the session to fail.
Depends upon the value of SNMP_error. Correct the
failing condition, as appropriate. System action
If the error was in the configuration of an SNMP trap Any full-screen status monitor sessions will be ended.
automation task, correct the error and restart the
SNMP trap automation task.
Operator response
CNM007I SNMP request request PDU sent
successfully Restart the status monitor.
CNM010I RESOURCE resource IS NOT
Explanation KNOWN TO STATUS MONITOR

The SNMP request did not result in any output and no


errors were detected.

474 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation commands require the status monitor to be initialized.
Each of these tasks are initialized when the authorized
The resource name you entered on the STATMON message receiver gets message CNM112I for that
command is not known to status monitor. task.
Message Variables Message Variables
resource task
The resource name The name of the task that has not been started;
either the status monitor or the log browse task.
System action
The STATMON command is not processed, and Operator response
the full-screen component of status monitor is not Wait for these tasks to initialize. Then enter the
displayed. command again.
CNM014I REVISION TABLE REPORT
Operator response FOLLOWS:
Ensure you spelled the resource name correctly. If so,
notify the system programmer. Explanation
This message is issued in response to a REVISE
System programmer response or REVISMSG command that specifies the REPORT
Ensure the resource is defined in VTAMLST and does keyword.
not have the STATOPT=OMIT keyword defined next to
CNM015I TOTAL HITS FOR THE FOLLOWING
it in VTAMLST.
UPON OR UPON-GROUP: number
CNM012I type Revision table table_name,
loaded by task_name, has Explanation
examined count objects since
being loaded, date time This message is issued in response to a REVISE
or REVISMSG command that specifies the REPORT
keyword.
Explanation
Message Variables
This message is issued in response to a REVISE
or REVISMSG command that specifies the STATUS number
keyword. The total number of UPON or UPON-group
statements found.
Message Variables
CNM016W Transmission by trname was
table_name
unsuccessful. See 'logfile' for
The name of the member from which the current
additional information.
revision table was compiled.
task_name
The operator ID or task name of the task that
Explanation
performed the revision table load. There was a problem and the indicated transmission
count attempt failed. There might be additional messages to
The total number of objects that are submitted further describe the failure.
during the time the table is active. Message Variables
date time
trname
The date and time that the table was activated.
The type of transmission being attempted. For
CNM013I task HAS NOT INITIALIZED example FTP, RMTCMD.
logfile
Explanation The name or type of the log file where messages
are written to assist in debugging the problem.
This message is issued in response to the operator
entering STATMON, PARSE, MONIT, CLRSTATS, or
BROWSE commands. Browsing the network log
requires the log browse task to be active; all the other

Chapter 5. CNM Prefix Messages 475


Operator response This is the first line of a multiline message. The second
and third lines show the command before and after the
In some cases, the log file must be deleted prior changed made by the REXX procedure named in the
to attempting the action again. If the failure was message.
associated with a command, review the help for that
command. If you specified TESTMODE=YES, this example shows
the 3 lines of messages:
System programmer response CNM019I 'Cmd Revision' has changed 'COMMAND'
data:
In some cases, the log file must be deleted prior DO
to attempting the action again. If the failure was AXE
d
associated with a command, review the help for that t
command.
If you specified TESTMODE=NO, you receive a
CNM017E Command cmd completed without DWO295I message, an example of which is contained
action 'missingAction' in the description of that message in IBM Z NetView
Messages and Codes Volume 2 (DUI-IHS).
Explanation
Message Variables
The specified command ends without performing the
name_of_REXX
specified action. The command might have ended
The name of the REXX procedure that caused a
abnormally.
change.
Message Variables
cmd System action
The command that was issued. None
missingAction
The command action, for example REISSUE, that
Operator response
was not performed.
None
CNM018I 'function' is in exclusive use by
'owner'. CNM024I DSIMQS FAILED SENDING
REFRESH BUFFER, DATA MAY BE
Explanation LOST

The specified function is prohibited from multiple use


Explanation
in its scope of operation. For example, the 'CMD
REVISION' function can be loaded into only one The status monitor is not able to refresh the Domain
NetView Subsystem Interface (SSI) in each Logical Status Summary panel; therefore, data might be lost.
Partition (LPAR).
Message Variables System action
function The refresh request is not processed.
Identifies the action or resource that is restricted.
owner System programmer response
An SSI name, a task name, or a command,
depending on the scope of operation of the If you continue to get this message, determine the
resource name. reason for DSIMQS failure.

CNM019I 'function' has changed 'type' data: CNM025I THERE IS A SYNTAX ERROR IN
YOUR REQUEST. ENTER HELP
command
Explanation
This message is issued as a result of a REISSUE Explanation
command, following a NETVONLY action by the
Command Revision Table. The CNM019I message is The command and any arguments were entered
issued only when the TESTMODE=YES option was incorrectly. See command help.
used when loading the Command Revision Table. Message Variables

476 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command Explanation
The name of the command whose syntax is not
valid. For the MONIT command: you tried to stop global
monitoring, but global monitoring is already stopped.

System action For the CMDMON command: you tried to stop


command statistics monitoring, but monitoring is
The command is not processed. already stopped.

Operator response System action


Look at the help panel for the command and try again The respective command is ignored, and monitoring
with correct syntax. remains inactive.
CNM026I "MONIT" NOT ALLOWED SINCE "O CNM029I YOUR REQUEST WAS IGNORED:
MONIT" RECORD NOT CODED IN GLOBAL MONITORING MUST BE
DSICNM ON

Explanation Explanation
You entered either the MONIT START or MONIT STOP You tried to start or stop monitoring for a specific
command but monitoring was not enabled by the resource but global monitoring is stopped.
system programmer.
System action
System action
The MONIT command is ignored.
The MONIT command is not processed.
Operator response
Operator response
Ask the lead operator to start global monitoring if you
Notify the system programmer. are to do monitoring.
CNM030I YOUR REQUEST WAS IGNORED:
System programmer response NOMONIT OPTION IS ON FOR
The O MONIT run option must be coded in DSICNM resource
member of DSIPARM data set for status monitor to
be able to monitor inactive nodes. Code either the O Explanation
MONIT record in DSICNM or tell the operators that
they cannot monitor network resources. You tried to start or stop monitoring for a resource that
is defined with the NOMONIT option in VTAMLST.
CNM027I YOUR REQUEST WAS IGNORED:
MONITORING IS ALREADY Message Variables
STARTED resource
The resource name issued on MONIT command.
Explanation
For the MONIT command: you tried to start global System action
monitoring, but global monitoring is already started. The MONIT command is ignored.
For the CMDMON command: you tried to start
command statistics monitoring, but monitoring is Operator response
already started.
Notify the system programmer.

System action
System programmer response
The respective command is ignored, and monitoring
remains active. Remove either the NOMONIT keyword in VTAMLST for
the resource or tell the operators that they cannot
CNM028I YOUR REQUEST WAS IGNORED: monitor that resource.
MONITORING IS ALREADY
STOPPED

Chapter 5. CNM Prefix Messages 477


CNM031I YOUR REQUEST WAS IGNORED: CNM033I YOUR REQUEST WAS IGNORED:
resource IS UNKNOWN TO STATUS resource IS NOT BEING
MONITOR MONITORED

Explanation Explanation
You specified a resource name on the MONIT You attempted to stop monitoring for a resource that is
command's ID= parameter that is not known to status not being monitored.
monitor.
Message Variables
Message Variables
resource
resource The resource name issued on MONIT command.
The resource name issued on MONIT command.
System action
System action
The MONIT command is ignored but monitoring
The MONIT command is ignored. remains off for that node.
CNM034I YOUR REQUEST WAS IGNORED:
Operator response resource IS NOT INACTIVE
Ensure you spell the resource name correctly. If the
problem recurs, ask the system programmer for a list Explanation
of valid resource names.
You tried to start or stop monitoring for a resource that
is not INACT (inactive) or not NEVACT (never active).
System programmer response One of the following is true:
Define the resource with a STATOPT statement to • You are running with global monitoring on.
use status monitor functions. See the IBM Z NetView
• The node does not have NOMONIT option coded in
Administration Reference for more information.
VTAMLST.
CNM032I YOUR REQUEST WAS IGNORED: Message Variables
resource IS ALREADY BEING
MONITORED resource
The resource name issued on MONIT command
Explanation
System action
You tried to start monitoring for a resource that
is already being monitored. All of the following The MONIT command is ignored.
conditions are true:
CNM035I REQUEST IGNORED: HIGHER
• You are running with global monitoring on (O MONIT RESOURCE IS NOT ACTIVE AND
is coded in DSICNM and user has issued MONIT NOT BEING MONITORED
START,ALL).
• The node does not have NOMONIT option coded in Explanation
VTAMLST.
The resource you specified cannot be monitored until
• The node's higher node is active or being monitored. the higher node is active or is being monitored.
Message Variables
resource System action
The resource name issued on the MONIT The MONIT command is ignored.
command.
Operator response
System action
Monitor the higher resource.
The MONIT command is ignored but the resource is
still being monitored. CNM036I resource CANNOT BE MONITORED
BECAUSE IT IS A MAJOR NODE

478 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
You attempted to start or stop monitoring a major An important message indicator has been highlighted
node. Major nodes cannot be monitored by status by an incoming message.
monitor.
Message Variables Operator response
resource Select the appropriate message indicator at the top of
The name of the resource specified on the MONIT any status monitor panel or the browse netlog panel to
command view the message.
CNM045I INITIALIZATION IS IMPOSSIBLE:
System action OPEN HAS FAILED FOR DSINDEF
The MONIT command is ignored.
Explanation
CNM037I MONITORING CANNOT BE
TURNED ON OR OFF FOR AN Macro DSIDKS TYPE[CONN] failed with a nonzero
APPLICATION NODE return code.

Explanation System action


You attempted to start or stop monitoring an The status monitor is not initialized.
application node. Applications cannot be monitored.
Operator response
System action
Notify the system programmer.
The MONIT command is ignored.
System programmer response
Operator response
Determine why DSINDEF did not open and correct the
If you want to activate the node, use VTAM's VARY ACT problem.
command.
CNM046I INITIALIZATION IS IMPOSSIBLE:
CNM038I MONITORING CANNOT BE DSINDEF IS INVALID
TURNED ON OR OFF FOR A CROSS
DOMAIN RESOURCE (CDRSC) Explanation
The DSINDEF member is not valid for one of the
Explanation
following reasons:
You attempted to start or stop monitoring for a cross-
• The DSINDEF member is empty
domain resource. Cross-domain resources cannot be
monitored. • Tje DSINDEF member contains only comment
records
System action • One or more lines in the DSINDEF member contains
incorrect syntax
MONIT command is ignored.
Operator response
Operator response
Notify the system programmer.
If you want to activate the node, use VTAM's VARY ACT
command.
System programmer response
CNM039I AN IMPORTANT MESSAGE HAS
Determine why the DSINDEF member is not valid
BEEN LOGGED - PLEASE BROWSE
and correct the problem. A valid resource definition
THE NETVIEW LOG
and activity table must be included in the DSINDEF
member for the status monitor to function. Ensure
that the DSINDDEF member does not contain any
symbolics. Run the CNMSJM12 sample job against

Chapter 5. CNM Prefix Messages 479


VTAMLST before running the CNMNDEF status monitor This record is generated by the status monitor
preprocessor if necessary. preprocessor when a GRAPHOPT statement is found
in any of the ATCCONxx members. The level of the
CNM047I FIND FAILED FOR DSINDEF
NetView program you are running no longer generates
this record; you are running with a downlevel DSINDEF
Explanation member. Status forwarding was available in previous
releases of NetView for resources created by the View
Macro DSIDKS TYPE[FIND] failed.
Preprocessor and displayed by NGMF. This function is
no longer supported.
Operator response
Notify the system programmer. System action
The unsupported record is ignored and does not affect
System programmer response the initialization of the status monitor task.
The DSINDEF file is missing.
Operator response
CNM048E BACKLEVEL DSINDEF - STATUS
MONITOR MAIN TASK IS Notify the system programmer.
TERMINATING
System programmer response
Explanation Remove the GRAPHOPT statemnet from any
The status monitor task failed to initialize because the ATCCONxx members (CNMS0003, CNMS0004,
level of the NetView program you are running requires CNM0005, CNM0102). The next time the status
that a network identifier list be contained at the end monition preprocessor is run, a current-level DSINDEF
of your DSINDEF. DSINDEF is created by running the will be created that does not contain the status
status monitor preprocessor. forwarding records. For instructions about running the
status monitor preprocessor, see the NetView online
help or the IBM Z NetView Installation: Configuring
System action Additional Components.
The status monitor task ends.
CNM051I ACB OPEN errtype FAILURE.
SHOWCB ERROR FIELD= fieldno
Operator response
Run the status monitor preprocessor to create a Explanation
current-level DSINDEF. Restart the status monitor
Open access control block (ACB) failed.
task.
Message Variables
System programmer response errtype
Either SOFT or HARD.
Verify that the DSINDEF created by running the status
monitor preprocessor is now at the correct level by fieldno
ensuring that the network identifier list is appended at The decimal value of VTAM SHOWCB macro
the end. ERROR field.

CNM049I STATUS FORWARDING RECORD IN


DSINDEF IS IGNORED Operator response
Notify the system programmer.
Explanation
The DSIPARM member DSINDEF used by STATMON System programmer response
contains an unsupported record. See the section on open/close errors and special
conditions in the appropriate VTAM manual.
*M**STATUS MONITOR ENABLED FOR STATUS FOCAL
POINT OPERATION**
**NOTE: THE ABOVE RECORD IS REQUIRED FOR
CNM052I ACB OPEN FAILURE.
STATUS FORWARDING* DDNAME=ddname, RC=vtamrcd,
FC=vtamfb

480 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
An open access control block (ACB) failed. The resource will not be reactivated by the status
monitor again until the status monitor is cycled.
Message Variables
ddname Operator response
The DDNAME of the file.
vtamrcd Activate the resource manually if required.
The VTAM internal return code.
vtamfb System programmer response
The VTAM internal feedback code. If appropriate, determine the cause of the resource's
inactivations, and verify that the value specified on
Operator response the M MAXREACT statement in the DSIPARM member
DSICNM is correct.
Notify the system programmer.
CNM077I TOO MANY CLISTS WERE
DEFINED IN DSICNM
System programmer response
Use the return and feedback codes to identify the Explanation
problem. See the appropriate VTAM manual for more
information. A maximum of 16 command lists can be defined on C
statements. Command lists after the 16th command
CNM075I DSICNM WAS NOT OPENED: list in DSICNM are not displayed on the status monitor
DEFAULTS USED detail panels when SCLIST is selected to list the
command lists.
Explanation
OPEN failed for DSICNM member of DSIPARM. System action
The first 16 command lists are displayed.
System action
Status monitor will initialize and not use any Operator response
information in DSICNM. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Code only 16 C statements in DSICNM. See the
IBM Z NetView Administration Reference for more
System programmer response information.

Determine why the OPEN failed and correct the CNM078I "timertype" IS AN INVALID TIMER
problem. TYPE ON TYPE T OR TYPE M
STATEMENT.
CNM076I M MAXREACT LIMIT REACHED
FOR "resource"
Explanation
Explanation The system programmer coded a type that is not
valid in columns 3-16 of the T PENDING, T APPLS, M
The status monitor MONIT function attempted to MAXREACT, or M REACTINT statement. The type must
reactivate the resource for the number of times be PENDING, APPLS, MAXREACT, or REACTINT.
specified by M MAXREACT. The status monitor will not
reactivate this resource. Message Variables

Message Variables "timertype"


The timer type that is not valid
"resource"
The resource for which the maximum reactivation
limit has been reached System action
The statement is ignored and processing continues.

Chapter 5. CNM Prefix Messages 481


Operator response Operator response
Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Correct the type T or type M record that is not valid The previous CNM090I message contains the
and is in DSICNM. The previous CNM090I message statement that is not valid in DSICNM. Correct the
contains the statement that is not valid in DSICNM. A statement in DSICNM. See the IBM Z NetView
Administration Reference for more information.
CNM079I "nn" IS AN INVALID TWO-DIGIT
TIMER INTERVAL FOR THE CNM081I COLOR CODE IS INVALID AND
"statement" STATEMENT. WAS IGNORED

Explanation Explanation
The system programmer coded a timer interval that The color indicator must be B, G, P, R, T, W, Y, or blank.
is not valid in columns 18 and 19 of the T PENDING,
T APPLS, M MAXREACT, or M REACTINT statement. System action
See the IBM Z NetView Administration Reference for
instructions on coding the timer interval. The status The statement is ignored and processing continues.
shown by the status monitor for one or more resources
might be incorrect because status solicitation (D Operator response
NET,APPLS or D NET,PENDING) or MONIT reactivation
attempts will not be issued at correct intervals. Notify the system programmer.
Message Variables
System programmer response
"nn
The 2-digit time interval that is not valid The previous CNM090I message contains the
statement that is not valid in DSICNM. Correct the
"statement"
color code in DSICNM. See the IBM Z NetView
The type of statement
Administration Reference for more information.

System action CNM082I AUTO ALERT INDICATOR WAS


IGNORED: CODE "Y", "N", OR
The statement is ignored and processing continues. BLANK
The interval will default to 00.
Explanation
Operator response
The auto-alert indicator must be Y, N, or blank.
Notify the system programmer.
System action
System programmer response
The statement is ignored and processing continues.
Correct the type T or type M record in DSICNM. The
previous CNM090I message contains a statement that
is not valid.
Operator response
Notify the system programmer.
CNM080I MESSAGE INDICATOR NUMBER IS
INVALID: RECORD WAS IGNORED
System programmer response
Explanation The previous CNM090I message contains the
statement that is not valid in DSICNM. Correct the
The only valid message indicator numbers are 1, 2, 3,
auto-alert indicator in DSICNM. See the IBM Z NetView
and 4.
Administration Reference for more information.

System action CNM083I HIGHLIGHT INDICATOR WAS


IGNORED: CODE "B", "R", "U", OR
The statement is ignored and processing continues. BLANK

482 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
The auto-alert highlight indicator must be B, R, U, or Notify the system programmer.
blank.
System programmer response
System action
The previous CNM090I message contains the
The statement is ignored and processing continues. statement that is not valid in DSICNM. Correct the
auto-alert sound alarm indicator in DSICNM. See the
Operator response IBM Z NetView Administration Reference for more
information.
Notify the system programmer.
CNM086I SIGNAL INDICATOR WAS
IGNORED: CODE "Y" FOR AUTO
System programmer response ALERT INDICATOR
The previous CNM090I message contains the
statement that is not valid in DSICNM. Correct the Explanation
auto-alert highlight indicator in DSICNM. See the
IBM Z NetView Administration Reference for more The auto-alert indicator must be Y to use a non-blank
information. value in auto-alert sound alarm indicator.

CNM084I HIGHLIGHT CODE WAS IGNORED:


System action
CODE "Y" FOR AUTO ALERT
INDICATOR The statement is ignored and processing continues.

Explanation Operator response


The auto-alert indicator must be Y to use a non-blank Notify the system programmer.
value for auto-alert highlight.
System programmer response
System action
The previous CNM090I message contains the
The statement is ignored and processing continues. statement that is not valid in DSICNM. Correct
the auto-alert sound alarm indicator or the auto-
Operator response alert indicator in DSICNM. See the IBM Z NetView
Administration Reference for more information.
Notify the system programmer.
CNM087I SYSTEM CONSOLE INDICATOR
WAS IGNORED: CODE "Y", "N", OR
System programmer response BLANK
The previous CNM090I message contains the
statement that is not valid in DSICNM. Correct the Explanation
auto-alert indicator or auto-alert highlight indicator
in DSICNM. See the IBM Z NetView Administration The system console indicator must be Y, N, or blank.
Reference for more information.
System action
CNM085I SIGNAL INDICATOR WAS
IGNORED: CODE "Y", "N", OR The statement is ignored and processing continues.
BLANK
Operator response
Explanation
Notify the system programmer.
The auto-alert sound alarm indicator must be Y, N, or
blank. System programmer response
The previous CNM090I message contains the
System action
statement that is not valid in DSICNM. Correct
The statement is ignored and processing continues. the system console indicator in DSICNM. See the

Chapter 5. CNM Prefix Messages 483


IBM Z NetView Administration Reference for more Operator response
information.
Notify the system programmer.
CNM089I *** WARNING *** ERRORS IN
RUN PARAMETERS
System programmer response
Explanation Ensure DSICNM is a member of DSIPARM. Ensure the
JCL is defined correctly for DSIPARM in the NetView
There are errors in DSICNM. A detailed message procedure. If you need further help, contact IBM
precedes this message. Software Support.
CNM092I DSICNM CODE "code" IS INVALID
System action
The statement is ignored and processing continues. Explanation
The code found in column 1 in DSICNM is not valid.
Operator response
Message Variables
Notify the system programmer.
code
The name of the code that is not valid.
System programmer response
Correct the errors in DSICNM. System action
CNM090I record The statement is ignored and processing continues.

Explanation Operator response


CNM090I is an echo of a DSICNM statement that Notify the system programmer.
contains an error. It is followed by a message that
explains the error.
System programmer response
Message Variables
Locate the error in DSICNM and correct it. See the
record IBM Z NetView Administration Reference for more
The record in DSICNM that is not valid. information.
CNM093I "optcode" IS AN INVALID OPTION
System action ON TYPE "O" RECORD IN DSICNM
The statement is ignored and processing continues.
Explanation
Operator response There is an O statement in DSICNM that is not valid.
Notify the system programmer. Message Variables
optcode
System programmer response The option code.
Correct the statement in DSICNM.
CNM091I DSICNM WAS NOT FOUND System action
The statement is ignored and processing continues.
Explanation
The DSICNM member of DSIPARM cannot be found. Operator response
Notify the system programmer.
System action
The status monitor ends. System programmer response
The only valid O statements are O MONIT and O
SECSTAT. Check the O statement in DSICNM.

484 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM094I STATUS UPDATE FOR RESOURCE = System action
resource IN NETWORK = network
FROM DOMAIN = domainid STATUS The SENDMSG record is ignored and processing
= status OLD STATUS = oldstatus continues.
CATEGORY = category
Operator response
Explanation Notify the system programmer.
A resource known to the status monitor has changed
status. This message is presented for automation System programmer response
purposes.
Correct the type on the SENDMSG record field and
Message Variables recycle the status monitor task.
resource CNM096E A SHIFT-IN WAS FOUND BEFORE
The name of the resource as defined in VTAM and A SHIFT-OUT FOR msgid IN
NCP definitions. TRANSLATION MEMBER member
network
The network name of the resource as known by the Explanation
NetView program.
The message translation statement for the specified
domainid
message identifier in the specified translation member
The domain name of the resource as known by the
contains a shift-in before a shift-out.
NetView program.
status Message Variables
The status of the resource reported by the status msgid
monitor. The message identifier in the message translation
oldstatus table.
The previous status of the resource as reported by member
the status monitor. The name of the translation member containing
category the message translations.
The type of resource as categorized by the status
monitor. System action
The command continues syntax checking with the
System action message translation in the member. No message
The message is sent to the authorized receiver. translation table is loaded into the NetView program.
The NetView program continues to display all
messages in English.
System programmer response
Use this message to automate the recovery of Operator response
resources.
Notify the system programmer.
CNM095I "text" IS AN INCORRECT OPTION
ON THE SENDMSG RECORD IN
DSICMN
System programmer response
Correct the syntax error in the message translation
Explanation statement in the specified translation member. Reload
the member using the TRANSMSG command. See the
An incorrect type was entered on the SENDMSG NetView online help or the IBM Z NetView Installation:
record. Configuring Additional Components for the correct
Message Variables syntax.

text CNM099I NO RESPONSE FROM number


The incorrect type entered on the SENDMSG NODES. TYPE command FOR
record. MORE INFORMATION.

Chapter 5. CNM Prefix Messages 485


Explanation Explanation
This message is printed as a header before the PRINT
This message indicates that one or more NetView
command prints any other Canzlog messages.
domains included in a multi-domain Canzlog request
has become unresponsive. Message Variables
Message Variables domain
The domain name of the host.
number
The number of domains that failed to respond to date&time
the current Canzlog request. The date and time when the PRINT command was
issued.
command
The command to enter to see status information filterspec
about all of the domains that are included in the The filter specification that the PRINT command
current Canzlog request. used.

System action: prefixes


Inactive domains are excluded from subsequent The message prefixes that the PRINT command
Canzlog requests. used.
detail_id_list
Operator response:
The MVS or NetView message details that the
Use the REFRESH command in the TARGET panel to
PRINT command used.
refresh the status information for all included domains.
If the affected domains become active again, you CNM103I STATUS MONITOR HAS STOPPED
can then include them in Canzlog requests. If the MONITORING RESOURCE resource
affected domains are still inactive, notify the system reason
programmer.
System programmer response: Explanation
Make sure remote operations are functioning properly
The status monitor has stopped monitoring a node for
on any domains shown as inactive.
one of the following reasons:
CNM100I THE LIST OF description STORED
• Constant (because of MONIT STOP,ALL command)
AT name
• Constant (because of MONIT STOP,ID= or VARY
command)
Explanation
This message results from the QRYGROUP command • Constant (because of MONIT STOP,ID= or VARY
and shows information about groups that are available command on higher node)
for multi-domain Canzlog browsing. The information • Constant (because the higher node was not
appended to the message is either a list of available monitored)
groups or a list of the members of a specified group, • An operator has issued a MONIT STOP,ID=resource
depending on the query that was issued. For more for the node that was previously monitored.
information, see the online help for the QRYGROUP
command. Message Variables
Message Variables resource
The resource name.
description
A description of the list that was requested. reason
The reason the status monitor stopped monitoring
name
a node.
The name of the location where the list members
are stored.
System action
CNM102I CANZLOG PRINT FROM DOMAIN
domain AT date&time FILTER: resource is no longer being monitored.
filterspec PREFIXES: prefixes CNM104I STATUS MONITOR HAS STARTED
DETAIL FOR MVS MESSAGE: MONITORING RESOURCE resource
detail_id_list DETAIL FOR
NETVIEW MESSAGE: detail_id_list

486 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation resource
The resource name.
The node has failed or the operator has issued a
MONIT START,ID=resource for an inactive node.
System action
Message Variables
The MONIT command is ignored.
resource
The resource name. CNM109I OPERATOR SUSPENDED
MONITORING. BROWSE CNM103I
MESSAGES IN LOG IF YOU NEED
System action TO KNOW WHAT NODES WERE
A VARY ACT,ID=resource is being issued once a minute AFFECTED.
until the resource leaves the inactive state.
CNM106I STATUS MONITOR HAS Explanation
REACTIVATED RESOURCE resource Node monitoring is switched off by operator.

Explanation System action


Status monitor has successfully reactivated node The MONIT STOP,ALL command was successful.
resource.
CNM110I OPERATOR STARTED
Message Variables MONITORING
resource
The resource name. Explanation
CNM107I STATUS MONITOR IS NOT Node monitoring is switched on by operator.
MONITORING resource DUE TO
NOMONIT OPTION
System action
Explanation The MONIT START,ALL command was successful.

Status monitor is not monitoring resource resource CNM112I task INITIALIZATION IS


because the NOMONIT parameter has been specified COMPLETE
on the node definition in VTAMLST for the resource.
Message Variables Explanation
resource The status monitor main task or status monitor browse
The resource name. task has completed initialization. If the insert is
STATUS MONITOR MAIN TASK, then you can now
enter any status monitor command.
Operator response
Message Variables
Notify the system programmer.
task
The status monitor main task or log browse task.
System programmer response
CNM113I THERE IS NOT AN ACTIVE LOG AT
If you want to monitor the node, remove the NOMONIT
THIS TIME
keyword in VTAMLST for that resource.
CNM108I STATUS MONITOR IS NOT Explanation
MONITORING resource; GLOBAL
MONITORING IS OFF The command BROWSE NETLOGA was entered but all
logs defined are inactive.
Explanation
Operator response
Status monitor cannot monitor resource resource
because the operator has switched off node Issue the command BROWSE NETLOGP or BROWSE
monitoring. NETLOGS to browse the primary or secondary log.
Alternatively, make one of the logs active by issuing
Message Variables a START TASK command on DSILOG or, if DSILOG

Chapter 5. CNM Prefix Messages 487


is already active, by issuing a SWITCH DSILOG,P or vsamfb
SWITCH DSILOG,S command. The VSAM internal feedback code. The code is in
decimal.
System programmer response
Operator response
Issue the LIST DSILOG command to determine the
state of the logger task. If the task is active but no Notify the system programmer.
logs are active, then either an operator has issued
the SWITCH DSILOG,T command or there has been System programmer response
an error writing to or opening the log. Errors in VSAM
processing might have been displayed in message Use the RCFB command list for a description of the
DSI556I. return codes and feedback codes. Use the feedback
information to identify the VSAM problem.
CNM114I MODCB FAILED: RETURN CODE =
4, ERROR CODE = errcode CNM117I BOTH LOGS ARE INACTIVE

Explanation Explanation
A return code of 4 was received after issuing the VSAM The command BROWSE NETLOGI was entered but
macro MODCB. The error code is in register 0. both logs are inactive.
Message Variables
Operator response
errcode
The contents of register 0 after entering MODCB Enter the command BROWSE NETLOGP or NETLOGS to
VSAM macro. The code is in decimal. browse the primary or secondary log.
CNM118I POINT FAILED: RETURN CODE = 8,
Operator response FEEDBACK CODE = vsamfb
Notify the system programmer.
Explanation
System programmer response The VSAM POINT macro returned a return code of 8.
Use the error code information to identify the VSAM Message Variables
problem.
vsamfb
CNM115I GENCB FOR READ LOG RPL FAILED The VSAM internal feedback code. The code is in
decimal.
Explanation
Operator response
The VSAM macro GENCB for the RPL control block
returned a code other than 0. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Use the RCFB command list for a description of the
return codes and feedback codes. Use the feedback
information to identify the VSAM problem.
System programmer response
CNM120I THE log LOG IS EMPTY
Use the VSAM manuals to correct the problem.
CNM116I POINT FAILED: RETURN CODE = Explanation
12, FEEDBACK CODE = vsamfb
The log you requested to browse is empty.
Explanation Message Variables
The VSAM POINT macro returned a return code of 12. log
ACTIVE or INACTIVE or PRIMARY or SECONDARY.
Message Variables
CNM121I POINT FAILED. RETURN CODE = 4

488 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation vsamfb
The VSAM feedback code. The code is in decimal.
The VSAM POINT macro returned a return code of 4.

Operator response
Operator response
Notify the system programmer.
Notify the system programmer.

System programmer response


System programmer response
Use the RCFB command list for a description of the
Use the return code information to identify the VSAM return codes and feedback codes. Use the information
problem. to identify the VSAM problem.
CNM122I THE SECONDARY LOG IS NOT CNM126I LOG BROWSE TASK WAS POSTED
DEFINED TO TERMINATE BY NCCF

Explanation Explanation
A BROWSE NETLOGS command was entered but a The termination ECB for the log browse task has been
secondary log is not defined. posted because of a STOP or CLOSE command.

Operator response Operator response


You might want to browse the primary log data set. Enter a START command to restart the task.
CNM123I GET FAILED. RETURN CODE = CNM127I LOG BROWSE TASK WAS POSTED
retcode WITH NO DATA

Explanation Explanation
The VSAM macro GET returned a return code of A buffer was sent to the log browse task that did not
retcode. contain a browse request.
Message Variables
retcode System action
The return code. The code is in decimal. The buffer is ignored and processing continues.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Use the return code information to identify the VSAM Determine which application sent the buffer. If it
problem. was a user application, correct the DSIMQS macro
CNM124I GET FAILED. RETURN CODE invocation. Otherwise, contact IBM Software Support.
= vsamrc, FEEDBACK CODE = CNM128I LOG BROWSE task ACB IS NOT
vsamfb OPEN

Explanation Explanation
The VSAM macro GET returned the return code vsamrc The access control block (ACB) for the log browse task
and the feedback code vsamfb. was closed in order to switch the logs and has not
Message Variables been reopened.

vsamrc Message Variables


The VSAM return code. The code is in decimal. task
The primary or secondary log browse task.

Chapter 5. CNM Prefix Messages 489


Operator response Explanation
Notify the system programmer. This is the separator line that appears immediately
after CNM131I.
System programmer response CNM133I element text delimiter
Use information from error messages issued when the
DSILOG tried to open the ACB to identify the problem. Explanation
CNM129I MODCB FAILED. RETURN CODE This statement is the parsed element as a result of
= vsamrcd, FEEDBACK CODE = the PARSE command. One or more occurrences of
vsamfb CNM133I follows the CNM132I separator line.
Message Variables
Explanation
element
The VSAM macro MODCB returned the return code The contents for ELEMENTS.
vsamrc and the feedback code vsamfb. text
Message Variables The contents for TEXT.
vsamrcd delimiter
The VSAM return code. The code is in decimal. The contents for DELIMITER.
vsamfb CNM134I END OF PARSE DISPLAY
The VSAM feedback code. The code is in decimal.
Explanation
Operator response
This follows the CNM133I messages to mark the end
Notify the system programmer. of the output from the PARSE command.
CNM135I THERE IS AN INVALID
System programmer response CHARACTER IN THE MODULE
Use the RCFB command list for a description of the NAME
return codes and feedback codes. Use the information
to identify the VSAM problem. Explanation
CNM130I THE DATA SET THAT WAS BEING The character in column 16 of an F statement is not
BROWSED HAS BEEN EMPTIED alphabetical or an &.
OR OTHER BROWSE PROBLEM
OCCURRED System action
The filter statement is ignored.
Explanation
The log task has switched to the data set that was Operator response
being browsed. In order to write to the data set, it was
emptied. Another condition in which this message can Notify the system programmer.
occur is the browse task restarted while an operator
was browsing the network log. System programmer response
CNM131I ELEMENT TEXT DELIMITER Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more
Explanation information.

These are headings for the responses to the PARSE CNM136I MESSAGE NUMBER OR FILTER
command. This message will be followed by CNM132I PARAMETER NEEDED: STATEMENT
and CNM133I. IGNORED
CNM132I ------------------------------------
Explanation
You did not enter the required fields following the
process number (class) on the F (filter) statement.

490 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The F statement is ignored. One of the filter message parameters is missing the
(, ¬, or = character, depending on the type of the
Operator response parameters.

Notify the system programmer.


System action
System programmer response The filter statement is ignored.

Locate the error in the F statement in the DSICNM


Operator response
member of DSIPARM and correct the syntax. Specify
the message number (beginning in column 7) and Notify the system programmer.
the filter parameter (beginning in column 16). See
the IBM Z NetView Administration Reference for more System programmer response
information on F statement.
Locate the error in DSICNM and correct it. See the
CNM137I PARAMETER NUMBER IS INVALID IBM Z NetView Administration Reference for more
information.
Explanation
CNM140I A COLON OR CLOSE PARENTHESIS
The parameter number must be a decimal number. WAS EXPECTED

System action Explanation


The filter statement is ignored. A colon was expected to separate substring values or a
close parenthesis was expected to close a value.
Operator response
System action
Notify the system programmer.
The filter statement is ignored.
System programmer response
Operator response
Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more Notify the system programmer.
information.
CNM138I A SUBSTRING LIMIT IS NOT System programmer response
NUMERIC Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more
Explanation information.
The substring limit must be a numeric value. CNM141I A CLOSE PARENTHESIS WAS
EXPECTED
System action
Explanation
The filter statement is ignored.
A close parenthesis was expected in order to close a
Operator response substring.

Notify the system programmer.


System action
System programmer response The filter statement is ignored.

Locate the error in DSICNM and correct it. See the


Operator response
IBM Z NetView Administration Reference for more
information. Notify the system programmer.
CNM139I "(", "¬", OR "=" WAS EXPECTED

Chapter 5. CNM Prefix Messages 491


System programmer response Operator response
Locate the error in DSICNM and correct it. See the Notify the system programmer.
IBM Z NetView Administration Reference for more
information. System programmer response
CNM142I "=", "<", OR ">" WAS EXPECTED Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more
Explanation information.
A logical operator has been left out of one of the filter CNM145I AN OPEN PARENTHESIS WAS
message parameters. EXPECTED

System action Explanation


The filter statement is ignored. An open parenthesis following the module name was
expected.
Operator response
System action
Notify the system programmer.
The filter statement is ignored.
System programmer response
Operator response
Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more Notify the system programmer.
information.
CNM143I A QUOTATION MARK WAS System programmer response
EXPECTED Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more
Explanation information.
A quotation mark was expected following the logical CNM146I AN AMPERSAND WAS EXPECTED
operator and preceding the value.
Explanation
System action
An & was expected to follow the open bracket.
The filter statement is ignored.
System action
Operator response
The filter statement is ignored.
Notify the system programmer.
Operator response
System programmer response
Notify the system programmer.
Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more System programmer response
information.
Locate the error in DSICNM and correct it. See the
CNM144I A COMPARATOR VALUE WAS IBM Z NetView Administration Reference for more
EXPECTED information.
CNM147I A COMMA WAS EXPECTED
Explanation
No comparison string value was found following the Explanation
logical operator.
Filter parameters are separated by a comma or by
a space. Apparently two parameters were given and
System action
were not separated by either method.
The filter statement is ignored.

492 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The filter statement is ignored. The only valid element types in DSICNM are numeric,
T, D, O, or M.
Operator response
System action
Notify the system programmer.
The filter statement is ignored.
System programmer response
Operator response
Locate problem area in DSICNM and insert a ',' or ' '
between the two parameters. Notify the system programmer.
CNM148I MAKE THE STRING AND
COMPARATOR LENGTH EQUAL System programmer response
Correct the element type parameter in column 16 in
Explanation DSICNM.
The string being compared and the comparator string CNM151I MODULE NAME CANNOT BE
length are not equal. LONGER THAN 8 CHARACTERS

System action Explanation


The filter statement is ignored. The module name has more than 8 characters.

Operator response System action


Notify the system programmer. The filter statement is ignored.

System programmer response Operator response


Locate the error in DSICNM and correct it. See the Notify the system programmer.
IBM Z NetView Administration Reference for more
information. System programmer response
CNM149I RECORD IGNORED: INVALID Locate the module name that is longer than 8
FILTER MESSAGE NUMBER characters and correct it.
CNM152I EOF REACHED BEFORE
Explanation
CONTINUATION RECORD FOUND
The filter message number must be left aligned and
start in column 7. A filter message number might have Explanation
been coded in column 8.
The last valid filter statement in DSICNM ends in
a comma, indicating that a continuation statement
System action
is needed. The end of file was reached before the
The filter statement is ignored. continuation record was found.

Operator response System action


Notify the system programmer. The record is ignored.

System programmer response System programmer response


Locate the error in DSICNM and insert the correct Add the missing continuation record to DSICNM.
message number starting in column 7.
CNM153I message
CNM150I ELEMENT TYPE NEEDS TO BE "T",
"D", "O", "M", OR NUMERIC

Chapter 5. CNM Prefix Messages 493


Explanation mj

This is a message that is sent to the authorized Message Variables


message receiver. vtammsg
Message Variables The VTAM message.

message
The message to the authorized message receiver. Operator response
CNM154I HOURLY OPERATOR MESSAGE Notify the system programmer.
INDICATOR STATISTICS
System programmer response
Explanation Ensure the levels of the NetView program and VTAM
This is the first line of the hourly message indicator are compatible. Ensure your installation has not
statistics display in the log. modified this message. If you need further help,
contact IBM Software Support.
CNM155I MI #1 MI #2 MI #3 MI #4
LOGTOTAL CNM162E mprocess BUFFERING IS
CRITICAL. MESSAGES LOST IN
APPROXIMATELY dtime SECONDS.
Explanation
This is the header line for the hourly message indicator Explanation
display.
Loss of automation of messages is possible in the near
CNM156I mi1 mi2 mi3 mi4 mi5 future.
Message Variables
Explanation
mprocess
This message gives the number of message indicators The type of buffering that is in danger. At the
that were triggered in the last hour by message current time, the only value that can appear is
indicator number. AUTOMATION.
Message Variables dtime
The estimated amount of time before automation
mi1
of messages is lost.
The number of times message indicator 1 was
matched in the past hour.
mi2
Operator response
The number of times message indicator 2 was Notify the system programmer.
matched in the past hour.
mi3 System programmer response
The number of times message indicator 3 was
matched in the past hour. Look for processes using excessive CPU or message
rates. Consider using message flood automation. Raise
mi4 the priority of NetView or CNMCSSIR task.
The number of times message indicator 4 was
matched in the past hour. CNM163I DATA BUFFERING STORAGE
mi5 HAS INCREASED TO newsize
The number of times message indicators 1, 2, 3, MEGABYTES FOR THE czstate
and 4 were matched in the past hour. CANZLOG DATA SPACE(S).

CNM161I THERE IS A MAPPING ERROR FOR


Explanation
MESSAGE vtammsg
The usable portion of the Canzlog data space is
Explanation increased by 8 MB.
Message Variables
The VTAM skeleton for vtammsg is different from
the message format of vtammsg expected by status
monitor.

494 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


newsize the operator might issue a RESYNC SUBSYSTEM
The new size of the Canzlog data space buffering command.
storage
CNM165I DATA BUFFERING USAGE IS
czstate AT MAXIMUM FOR THE czstate
• ACTIVE - The active Canzlog data space CANZLOG DATA SPACE(S).
• ARCHIVE - The archive Canzlog data space(s)
Explanation
System programmer response:
Ensure that enough auxiliary storage exists to support The usable storage in the Canzlog data space(s) has
the virtual storage used by the Canzlog data space. expanded enough times so that the maximum possible
storage has been used. If it is the active Canzlog
CNM164A mprocess FELL BEHIND. data space, the maximum possible storage is either
Ltype MESSAGE LOSS. FROM 512 MB or 2 GB. If it is the archive data space(s),
timestampOne TO timestampTwo. the maximum value is defined on the CNMSTYLE
statement ARCHIVE.BROWSE.DATASPACES or
Explanation ARCHIVE.BROWSE.MAXDSPSIZE.
The rate of automation of messages was much slower Message Variables
than the rate of logging messages. As a result, czstate
automation of some messages did not occur.
• ACTIVE - The active Canzlog data space
Message Variables
• ARCHIVE - The archive Canzlog data space(s)
Ltype
The type of message loss that occurred. The value System programmer response
can be either UNEXPECTED or EXPECTED.
If the active Canzlog data space had been defined
Unexpected message loss means a stress level with a maximum size of 512 MB by using the TINYDS
of 5 was reached. Expected message loss means initialization parameter in an IEFSSNxx PARMLIB
a lower SkipLevel was specified and the skip member, consider defining the data space with a
occurred before a critical situation could occur. maximum of the full 2 GB of storage by using or
mprocess defaulting the FULLDS initialization parameter.
The type of buffering that is in danger. At the If the set of archive Canzlog data spaces has reached
current time, the only value that can appear is its maximum size, consider increasing the size of
AUTOMATION. the Canzlog data space(s) defined on the CNMSTYLE
timestampOne statement ARCHIVE.BROWSE.DATASPACES or
Beginning date and time of message loss ARCHIVE.BROWSE.MAXDSPSIZE.
timestampTwo CNM166I number MESSAGES PRINTED
End date and time of message loss SUCCESSFULLY TO datasetname
WITH FILTER filterspec.
Operator response
Notify the system programmer.
Explanation
This message is issued when the PRINT command is
System programmer response successful.

Investigate system activity around the time indicated Note: If no messages match the PRINT command
by timestampOne to determine the cause of the criteria, message CNM214I is issued.
message processing hang. Check for the integrity Message Variables
of the system. Verify the status of all active jobs
and jobs that should be active. If messages are number
lost, this situation may affect automation as the The total number of messages printed.
actual automation resource status (IBM Z System datasetname
Automation) may no longer be accurate, and any The data set, data set name with member, or DD
actions triggered by those lost messages will not be name.
seen. To fix the resource status is such a situation, filterspec
The filter specification used.

Chapter 5. CNM Prefix Messages 495


CNM167I INVALID VALUE value IS statement
SPECIFIED FOR object. VALUE The type of initialization statement in error.
newvalue IS USED INSTEAD.
System action
Explanation Logging starts as if the statement in error was not
An invalid value was specified on a definition specified.
statement, command, or other object.
Message Variables Operator response
value Notify the system programmer.
The invalid value.
object System programmer response
The keyword, statement, or other value that was
Either remove the initialization statement that is in
given an invalid value.
error, or change the logging data sets to sequential
newvalue (DSTINIT PBSDN).
The value that is replacing the invalid value.
CNM204I FUNCTION REQUESTED IS NOT
VALID FOR BROWSE NETLOG
System action
The NetView program uses the replacement value for Explanation
the specified object. Processing continues.
The function you requested while browsing the
CNM200I NO TASKS WITH THE MATCHING network log is not valid.
TYPE, type, ARE CURRENTLY
ACTIVE CNM206I BROWSE DATA WAS TRUNCATED
AT LINE truncline OF totline
Explanation
Explanation
A trace was requested with a certain task type, but no
tasks of that type are active. Any tasks of the specified You issued a cross-domain member browse request
type will be traced when they become active. and the number of lines in the remote member
exceeded your RMTMAXL setting for DEFAULTS and
Message Variables OVERRIDE.
type Message Variables
A task type can be HCT, NNT, OPT, OST, PPT, or
MNT. truncline
The number of lines transferred from the remote
NetView program. This number reflects your
System action RMTMAXL setting for DEFAULTS and OVERRIDE
The trace request is accepted. and is not the total number of lines in the remote
member.
CNM201I task: statement STATEMENT CAN
totline
ONLY BE SPECIFIED FOR TASKS
The total number of lines in the remote member.
USING SEQUENTIAL LOGGING
Of totline total lines, only truncline lines were
SERVICES (NON-VSAM)
transferred.

Explanation
System action
The statement statement was specified in the
The browse command continues. There are truncline
initialization member of the task task. The task defined
lines in this browse session.
logging services so that VSAM logging was defined
(DSTINIT PDDNM) for a task other than DSITRACE or
DSILOG. Operator response
Message Variables Contact your system programmer. You can also logon
directly to the remote NetView program and issue the
task
BROWSE command.
The name of the task.

496 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
Determine if your installation's setting for RMTMAXL You browsed the network log with a time range that is
is appropriate. The DEFAULTS command can be used not valid.
to change the installation default for RMTMAXL and
Message Variables
the OVERRIDE command can be used to define the
RMTMAXL setting per operator. invalid_time
The time entered was not recognized as a valid
Note: A large RMTMAXL setting allows operators to
time.
browse large members cross-domain and can cause
LU6.2 RMTCMD communication delays because of
excessive or inadvertent data transfer. Operator response
CNM207I INPUT MUST BE NUMERIC AND Issue the command with the correct time specified.
>=1000 OR "*" FOR UNLIMITED
CNM211I INCORRECT DATE OPERAND
SEARCH
'invalid_date'. PLEASE RETRY

Explanation Explanation
You entered a non-numeric value other than * (the
You browsed the network log with a date range that is
asterisk means an unlimited search) in the search
not valid.
maximum field.
Message Variables
Operator response invalid_date
The date entered was not recognized as a valid
Enter a numeric value or * in the search maximum field
date.
and retry the search.
CNM208I INCORRECT OPERAND: keyword. Operator response
PLEASE RETRY
Issue the command with the correct date specified.
Explanation CNM212I INCORRECT DATE/TIME RANGE.
PLEASE RETRY
You entered parameters for message search or
filtering that were not recognized. See help for
BROWSE or FIND to see valid keywords. Explanation
Message Variables You browsed the network log with an incorrect time or
date range specified.
keyword
The keyword that is not valid.
Operator response
Operator response Issue the command with the correct time or date
range specified.
See the NetView online help for the correct syntax and
enter the command again. CNM213I Loss of data occurred for panel
being viewed. Please issue new
CNM209I No log entries for this date/time
request.
range

Explanation
Explanation
The records being viewed can no longer be found
You browsed the Canzlog log or the network log with a
in the data base. This could be due to (1) data
time range specified. No records satisfying your filters
overwritten in a Canzlog data space without archiving
were logged during this time range.
or (2) a switch occurring for the netlog or (3) netlog
CNM210I INCORRECT TIME OPERAND browse being restarted.
'invalid_time'. PLEASE RETRY
Operator response
Issue the browse request again.

Chapter 5. CNM Prefix Messages 497


System programmer response System programmer response
If Canzlog data is not being archived, consider See the appropriate OS/VS2 manual for a description
enabling Canzlog archiving by changing archive of the DYNALLOC information codes to determine if
statements in CNMSTYLE. any further action needs to be taken.
CNM214I All records have been filtered; no CNM217I NetView Program to Program
matching records found Interface is inactive

Explanation Explanation
The log browse or print request has resulted in all The NetView program-to-program interface (PPI) is
records being filtered. No records matched the filter inactive.
specifications that are in effect. CANZLOG or BLOG
filtering might be the cause. System action
If you are doing a NETLOGx browse, installation exit
One of the following actions occurs, depending on the
EXIT18 and other log browse requests can also be
function for which the message is received:
used to filter records.
• The alert processing task CNMCALRT waits until the
If you are doing a Canzlog browse, a second line which
PPI becomes active.
describes the filters may be added.
• IBM Z NetView Enterprise Management Agent
remains active but cannot complete initialization
Operator response until the PPI becomes active. The agent will
Issue the log browse or print request with different complete initialization when the PPI becomes active.
filters. Use the CANZLOG or BLOG input panel to
specify fewer filters. Operator response
CNM216I dataset DEALLOCATED BUT Start the PPI.
POSSIBLE ERROR OCCURRED ID =
ic CNM218I READ ERROR OCCURRED ON
DSICNM
Explanation
Explanation
You issued the FREE command to deallocate the
specified data set. The deallocation was successful, The NetView program cannot read the data set or file
but a possible error during subsequent processing was named DSICNM.
detected. This might be because of the disposition (for
example, KEEP or DELETE) that was specified on the System action
FREE command.
The status monitor ends.
Message Variables
dataset Operator response
The name of the data set or ddname that was
deallocated. Notify the system programmer.
ic
The information code from the DYNALLOC macro System programmer response
indicating the possible failure. Locate the error in DSICNM and correct it. See the
IBM Z NetView Administration Reference for more
System action information.
The specified data set is deallocated but subsequent CNM220I command : ACTIVE SESSIONS =
actions (for example, deleting the data set) might not 'num1', SESSION REQUESTS =
have been performed, depending on the information 'num2'
code (IC).
Explanation
Operator response This message is issued by command list APPLSPEN
Notify the system programmer. when the request is successful. It displays the number

498 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


of active sessions and the number of session requests System programmer response
for a particular application program.
Identify the problem by finding the SNA sense code
Message Variables in Systems Network Architecture Formats. Take the
command necessary corrective action.
The name of the command list invoked. CNM223I command : UNABLE TO VARY
num1 'node' ACTIVE
The number of active sessions for the application
program. Explanation
num2
The command list cannot vary the node to active.
The number of pending or queued logon requests
to the application program. Message Variables
CNM221I command : NAME = 'node', STATUS command
= 'status', DESIRED STATE = 'state' The name of the command list invoked.
node
Explanation The name of the node being recycled.
This message is issued by command list APPLSPEN
when the request is successful. It displays the status System action
and state for a particular application program. The specified command list ends.
Message Variables
command Operator response
The name of the command list invoked. Issue the command again. If the command list fails
node again, notify the system programmer.
The name of the node being displayed.
status System programmer response
The current status of the node as known to VTAM.
Ensure that the system response time is acceptable.
state Also, ensure that VTAM is properly installed and
The node state as known to VTAM. currently active, and that the NetView program is
CNM222I command : ENTER SENSE 'sense' receiving messages from VTAM.
FOR EXPLANATION OF FAILURE CNM225I command : COMMAND FAILED,
BNJDSERV NOT ACTIVE
Explanation
The command list failed because of the reason Explanation
indicated by the SNA sense code. Task BNJDSERV is not active.
Message Variables Message Variables
command command
The name of the command list invoked. The name of the command list invoked.
sense
The sense code of the failure. System action
The specified command list ends.
System action
The specified command list ends. Operator response
Issue STARTCNM NPDA to start the hardware monitor.
Operator response Then issue the command again. If the command list
Enter SENSE followed by the sense code to get fails again, notify the system programmer.
an explanation of the failure. Notify the system
programmer if necessary. System programmer response
Take any necessary corrective action.

Chapter 5. CNM Prefix Messages 499


CNM226I NetView Program to Program Explanation
Interface initialization is
completed The REXX interpreter might not be installed or it
might not be accessible through a JOBLIB, STEPLIB,
LINKLIB, or LPA.
Explanation
Message Variables
The program-to-program interface has been initialized
successfully and is now available for use. command
The name of the command list invoked.

System action
Operator response
Processing continues.
Notify the system programmer.
CNM227I NETView program to program
interface is not initialized
System programmer response
Explanation If the REXX interpreter is not installed, install TSO/E
REXX interpreter, or add a STEPLIB to the NetView
The program-to-program interface has not been job control language (JCL) pointing to the library
initialized because either it was not requested or it is containing the REXX interpreter code.
already active on another NetView subsystem address
space. CNM230I THE LEVEL OF THE ISTIECCE LOAD
MODULE IS INCOMPATIBLE WITH
THE NETVIEW RELEASE. STATUS
System action MONITOR WILL TERMINATE.
Processing continues.
Explanation
Operator response The copy of the module CNMIECCE, which is contained
Notify the system programmer. in the ISTIECCE load module, is not compatible with
the release of the NetView program.

System programmer response


System action
If the program-to-program interface is required,
check the startup job control language for the The status monitor ends.
NetView subsystem address space to ensure that the
program-to-program interface option was specified Operator response
correctly. If the program-to-program interface option
was correctly specified, ensure that the program-to- Notify the system programmer.
program interface is not already active on another
NetView subsystem address space. The MVS MODIFY System programmer response
command for the NetView subsystem address space
can be used to display the program-to-program Ensure that the library containing the CNMIECCE
interface status. module is included in the VTAM concatenation string.
A compatible level of the module CNMIECCE must be
CNM228I command : REXX INTERPRETER link-edited onto your system. Then restart the status
INSTALLED AND AVAILABLE. monitor.
CNM231I UNABLE TO LOAD MODULE
Explanation module1 FROM MODULE module2
This is a successful completion for the QREXX FOR TASK task
command.
Message Variables
Explanation
command A NetView module cannot be loaded.
The name of the command list invoked. Message Variables
CNM229I command : REXX INTERPRETER module1
NOT AVAILABLE. The name of the module that cannot be loaded.

500 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module2 Operator response
The name of the module that tried to load
module1. Notify the system programmer.
task
The name of the task. System programmer response
Verify that the module ISTIECCE is link-edited
System action correctly on your system, and that the library
containing the module ISTIECCE is included in VTAM's
The status monitor module cannot load the necessary concatenation string.
module for further processing. The status monitor
ends. CNM234I VTAM WAS UNABLE TO ACTIVATE
STATUS MONITOR RETURN CODE
= X'retcode'
Operator response
Notify the system programmer. Explanation
VTAM was not able to activate the status monitor.
System programmer response
Message Variables
Verify that the indicated module is link-edited correctly
on your system, and that the library containing the retcode
module is included in the concatenation string. The VTAM return code.
CNM232I UNABLE TO OBTAIN INTERNAL
LOCK System action
The status monitor ends.
Explanation
The status monitor was unable to obtain an internal Operator response
lock. Notify the system programmer.

System action System programmer response


The status monitor ends. For more information, refer to the z/OS
Communications Server library or contact IBM
Operator response Software Support.
Notify the system programmer. CNM235I VTAM HAS INSUFFICIENT
STORAGE TO ACTIVATE STATUS
System programmer response MONITOR

Contact IBM Software Support.


Explanation
CNM233I VTAM WAS UNABLE TO LOAD
VTAM cannot activate the status monitor because of
MODULE ISTIECCE FOR TASK task
insufficient storage.

Explanation System action


VTAM cannot load module ISTIECCE for task.
The status monitor ends.
Message Variables
task Operator response
The name of the task. Try again. Some storage space might have been freed.
If you continue to get this message, notify the system
System action programmer.
The status monitor ends.
System programmer response
Allocate more storage space for VTAM.

Chapter 5. CNM Prefix Messages 501


CNM236I commandname : functionname Message Variables
FAILED WITH RETURN CODE command
returncode The name of the command list invoked.

Explanation System action


The NetView procedure commandname attempted the The specified command list ends.
function functionname, it failed with a return code
returncode.
Operator response
Message Variables
Issue the command with the valid keywords.
commandname
The name of the procedure invoked. CNM238I STATUS MONITOR ACTIVATION/
functionname INACTIVATION IN PROGRESS
The name of a programming interface that
returned the error code in the command Explanation
procedure. This can be:
Processing for status monitor activation/inactivation
• a command name such as GETMLINE or continues.
GETMSIZE
• an indirectly called command name, such as System action
PRINT in NVINFO, which is invoked by using the
NETV PIPE stage. Processing for status monitor activation/inactivation
continues.
• the name of a macro such as DSIPSS
• the QSAM (WRITE) PIPE stage CNM239I STATUS MONITOR ACTIVATION/
INACTIVATION IS CONTINUING
returncode
The return code of the functionname that failed.
Explanation
System action Processing for status monitor activation/inactivation
continues.
The specified procedure ends.
System action
Operator response
Processing for status monitor activation/inactivation
Notify the system programmer. continues.
CNM240I WARNING : DUPLICATE
System programmer response ADDRESSES MAY BE REMOVED
Take the necessary corrective action. Identify the
problem by finding the return code for GETMSIZE, Explanation
GETMLINE, or PRINT in IBM Z NetView Programming:
REXX and the NetView Command List Language. When If you are trying to remove an adapter on a PC
a macro name is returned in the message text, the network, any other adapter with the same address is
command's attempt to use the macro failed. See IBM removed as well.
Z NetView Programming: Assembler to determine the
problem. System action
CNM237I command : "MESSAGE" OR If you CANCEL the action, no adapters are removed.
"ALERT" ARE THE ONLY VALID
KEYWORDS
Operator response
Explanation You can use CANCEL to cancel the action, or GO to
proceed.
Something other than MESSAGE or ALERT was entered
as an input keyword for the command list. MESSAGE CNM243I INVALID INPUT. PLEASE ENTER
and ALERT are the only valid input keywords. 'GO FOR' OR 'GO END'

502 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation CNM249E request : NO DATA FOUND FOR
'subject'
You entered something other than GO FOR or GO END.

Explanation
System action
There is no data available for the request you issued.
Processing continues when the response is entered
correctly. Message Variables
request
Operator response The function that encountered the error.
Enter GO FOR or GO END. subject
The requested data.
CNM246I OPERATION CANCELLED.
System action
Explanation
Processing for the request ends.
This message is issued in response to a GO END to
cancel the command.
Operator response
CNM247I UNABLE TO ISSUE IDCAMS.
Check the format and spelling of the operands you
SYSLST IS UNASSIGNED.
entered. If the format and spelling are correct, notify
the system programmer.
Explanation
The SYSLST LU is unassigned. IDCAMS cannot execute. System programmer response
If message DSI724 accompanies this message, find
System action the missing member and move it to the correct data
IDCAMS command fails. set. If the request was HELP, determine whether the
proper entry is in the HELPMAP sample.

Operator response CNM251I TRANSLATION ALREADY IN


EFFECT. command COMMAND
Issue the command again when SYSLST is assigned. IGNORED

System programmer response Explanation


Assign the SYSLST LU in NetView startup JCL. You entered a command to load a table of National
CNM248I MEMBER member OF MEMBER Language message translations, but a message
TYPE B NOT FOUND IN ANY translation table has previously been loaded and
SUBLIBRARY DEFINED TO THE is currently in use. The command can be issued
LIBDEF SEARCH STRING. successfully once for each NetView initialization.
Message Variables
Explanation command
The file you specified was not found in any sublibrary The name of the command entered.
defined to this procedure as a member type B.
Message Variables System action
member The command is rejected.
The name of the member. CNM252E MESSAGE SKELETON IS TOO LONG
FOR msgid IN TRANSLATION
System action MEMBER member

The command is ignored.


Explanation
Operator response The message translation statement for the specified
message identifier in the specified translation member
Enter the command using a valid member.

Chapter 5. CNM Prefix Messages 503


contains a message skeleton that is too long for the System programmer response
buffer.
Correct the message translations in the specified
Message Variables DSIMSG member. Issue the TRANSMSG command
msgid again to load the message translation table. See
The message identifier in the message translation the NetView online help or the IBM Z NetView
table. Installation: Configuring Additional Components for
more information.
member
The name of the translation member containing CNM255I MEMBER 'member' NOT FOUND IN
the message translations. DATA SET dataset

System action Explanation


The command continues syntax checking with the The specified member was not found in the specified
message translation in the member. No message data set.
translation table is loaded into the NetView program.
Message Variables
The NetView program continues to display all
messages in English. member
The name of the member not found
Operator response dataset
The name of a NetView data set
Notify the system programmer.

System action
System programmer response
The command containing the member name that was
Correct the syntax error in the message translation not found is rejected.
statement in the specified translation member. Reload
the member using the TRANSMSG command. See the
NetView online help or the IBM Z NetView Installation: Operator response
Configuring Additional Components for the correct Check that you specified the correct member name. If
syntax. you did, notify the system programmer.
CNM253I NO VALID MESSAGE
TRANSLATIONS IN DSIMSG System programmer response
MEMBER member
Check that the specified member is a member of one
of the data sets in the concatenation string for the
Explanation specified data set in your NetView startup procedure.
The specified member contains no valid message Issue the command again.
translations. CNM256I MESSAGE TRANSLATIONS HAVE
Message Variables NOT BEEN LOADED DUE TO
ERROR(S) DURING PROCESSING
member
The name of the DSIMSG member being
processed. Explanation
An error occurred while a command to load a table
System action of National Language message translations was being
processed. A message explaining the error was issued
No message translation table has been loaded into the previously. The NetView program did not load a
NetView program. The NetView program continues to message translation table into storage.
display all messages in English.

System action
Operator response
The NetView program continues to display all
Check that you specified the correct member name. If messages in English.
you did, notify the system programmer.

504 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
See the previously issued message for the appropriate A command required access to a VSAM file, but the
action. VSAM file was not open. This message is issued:
• By the LISTCAT command when the data services
System programmer response task does not have a VSAM file open.
See the previously issued message for the appropriate • By the DSIVSMX command to indicate that a VSAM
action. file is not open on the task that ran the DSIVSMX
command.
CNM257I MESSAGE TRANSLATIONS HAVE
BEEN LOADED FROM DSIMSG • By the DSIVSAM command to indicate that a VSAM
MEMBER member file is not open at the data services task used by the
command.

Explanation Message Variables

The command to load a table of National Language task


message translations from the specified member of The name of the NetView task attempting access
DSIMSG has completed successfully. to the VSAM file

Message Variables
System action
member
The name of the DSIMSG member containing the The command is not processed.
message translations.
Operator response
System action Notify the system programmer.
The NetView program continues processing, displaying
the translated version of those messages for which System programmer response
the specified DSIMSG member contained message
translations. Ensure that the task has an open VSAM database.
• Use the NetView SWITCH command to make a VSAM
CNM258I LSR BUFFERS NOT DEFINED
file active on a data services task.
• Use the ALLOC command to make a VSAM file
Explanation available to DSIVSMX.
You entered a VSAMPOOL command, but no LSR
CNM260I VSAM LSR/DFR RESOURCE POOL
buffers have been defined.
STATISTICS

System action Explanation


The command is not processed.
This is the title line generated for the VSAMPOOL
command.
Operator response
Notify the system programmer. System action
The VSAMPOOL command continues.
System programmer response
CNM261I cinv bufno bfrfnd bufrds nuiw uiw
Verify that the BLDVRP definitions in DSIZVLSR are erct
correct. Ensure that tasks using LSR/DFR are able to
initialize correctly.
Explanation
CNM259I TASK task DOES NOT HAVE AN
This is an information line generated by the
OPEN VSAM DATA BASE
VSAMPOOL command. It displays the VSAM statistics
for an LSR buffer pool.
Message Variables

Chapter 5. CNM Prefix Messages 505


cinv when in effect, and on the date operands of the
The control interval size of the buffer pool. DEFAULTS and OVERRIDE commands.
bufno ptf
The number of buffers in the buffer pool. The current program temporary fix applied to this
bfrfnd control section.
The number of retrieve requests where the record epa
was found in a buffer and did not require an I/O. The entry point address of the module (or control
bufrds section if control section was specified).
The number of retrieve requests where the record amode
was not found in a buffer and did require an I/O. The addressing mode of the load module (24 or
nuiw 31).
The number of write requests that VSAM had to attributes
perform because there were no buffers available to The linkage editor attributes of the load module
do a read. (REUS, RENT, AUTH).
uiw
The number of write requests that were not System action
deferred.
The DISPMOD command continues.
erct
The number of write errors. CNM264I TOTAL MODULE STORAGE IN USE:
storage BYTES
System action
Explanation
The VSAMPOOL command continues.
This line is generated by a DISPMOD ALL or DISPMOD
CNM262I END OF DISPLAY ALL ALL command. It displays the total amount of
storage currently in use by the NetView load modules.
Explanation Message Variables
This is a trailer line generated by the VSAMPOOL storage
command telling you that the VSAMPOOL command The amount of storage being used in bytes
has ended.

System action
System action
The DISPMOD command continues.
The VSAMPOOL command ends.
CNM265I END OF DISPLAY
CNM263I module length csect yy.ddd ptf epa
amode attributes
Explanation
Explanation This is the trailer line generated by the DISPMOD
command telling you that the DISPMOD command has
This is the detail line generated by the DISPMOD ended.
command. It displays NetView load module
information.
System action
Message Variables
The DISPMOD command ends.
module
The name of the load module. CNM266I MODULE: module CSECT: csect
NOT FOUND
length
The length of the load module.
csect Explanation
The name of the control section (CSECT) in the You entered a DISPMOD command and the specified
load module. control section in the specified module was not found.
yy.ddd Message Variables
The compile date of the control section. The
date format depends on the TRANSMSG member,

506 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


module System action
The name of the module
The command is not processed.
csect
The name of the control section (CSECT) in the
load module Operator response
Verify that the task is a data services task and was
System action spelled correctly on the command. If so, notify the
system programmer.
The command is not processed.

System programmer response


Operator response
Verify that the task is a valid NetView data services
Verify that the control section name was spelled task.
correctly. If so, notify the system programmer.
CNM269I DSIPSS FAILED. REGISTER 15=
X'retcode' ECB POST CODE= X'eee'
System programmer response
Verify that the control section is in the load module. Explanation
CNM267I MODULE: module NOT FOUND An error occurred trying to write to the NetView
terminal.
Explanation Message Variables
You entered a DISPMOD command and the module retcode
name you entered was not found. The return code from the DSIPSS macro
Message Variables eee
module The post code from the DSIPSS macro
The name of the module
System action
System action The command is not processed.
The command is not processed.
Operator response
Operator response Notify the system programmer.
Verify that the module name was spelled correctly. If
so, notify the system programmer. System programmer response
Identify the cause of the DSIPSS macro failure by
System programmer response looking up the return code and ECB post code in IBM Z
Verify that the module is a NetView module. NetView Programming: Assembler.

CNM268I TASK task IS NOT A DATA CNM270I ACCESS METHOD SERVICES


SERVICES TASK ENDED WITH A RETURN CODE
retcode
Explanation
Explanation
You entered a command with the name of a task that is
not a NetView data services task. You entered a IDCAMS command and the access
method services utility ended.
Message Variables
Message Variables
task
The name of the task you entered on the retcode
command. The return code returned from the access method
services utility.

Chapter 5. CNM Prefix Messages 507


System action macro
The name of the operating system macro that
The command ends. failed.
CNM271I ddname DD STATEMENT MISSING member
Member can be one of the following names:
Explanation • The member or file name being processed when
The specified DDNAME was incorrect or is not defined the error occurred.
in the NetView cataloged procedure, or allocated by • The name of the data space if this message
the ALLOC command. is issued for the IBM Z NetView Enterprise
Management Agent.
Message Variables
retcode
ddname
The return code from the macro that failed. This
The DDNAME you specified.
return code is in the format of xxx-yy. If the OPEN
macro or the CLOSE macro fails, the return code
System action can contain a system abend code, where xxx is
the abend code and yy is the abend reason code.
The command is not processed.
If an abend reason code is not available at the
time of the abend, yy will appear as 00. If retcode
Operator response contains a system abend code, you might also see
system messages associated with the abend. For
Verify that the DDNAME was spelled correctly. If so,
any other macro failure or for an OPEN macro
notify the system programmer.
failure or CLOSE macro failure that is not because
of an abend, retcode is the macro return code.
System programmer response WRITE macro failures can have a return code of
Verify that a DD statement with the ddname was zero (0).
coded in the NetView cataloged procedure or that this
DD name has been allocated to the NetView program. System action
A SYSPRINT DD statement must also be coded in the
The command is not processed.
NetView step of the NetView cataloged procedure.
CNM272I name IS NOW [ALLOCATED | Operator response
DEALLOCATED]
Notify the system programmer.
Explanation
System programmer response
An ALLOCATE or FREE command has completed
successfully. See the appropriate operating system manual for the
meaning of the macro return code or abend code.
Message Variables Examine the specified member or file to determine
name why the macro failed.
The DD name or data set name that was allocated The return code for the WRITE macro can be zero
or deallocated. (0). The WRITE macro failure might be because of an
attempt to write to a read-only disk or it might be
System action because of a hardware failure.
The command ends and processing continues. CNM274I FIND FAILED FOR MEMBER
member
CNM273I 'macro' MACRO FAILED FOR
member, RETURN CODE =
X'retcode' Explanation
You entered a SUBMIT or VPDALL command and the
Explanation specified member was not found or a FILEDEF for the
member is already in progress.
You entered a command and the specified operating
system macro failed. Message Variables
Message Variables

508 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


member retcode
The name of the member that cannot be found. The return code from the DYNALLOC macro
indicating the failure
System action ic
The information code from the DYNALLOC macro
The command is not processed. indicating the failure

Operator response System action


Verify that you entered the correct member name. The command is not processed.
If so, a FILEDEF for the member might already be
in progress. Retry the command. If you continue to
receive this message, notify the system programmer. Operator response
Verify that the data set specified is correct. If so, notify
System programmer response the system programmer.
Verify that the specified member name is correct. If
so, examine the member to determine the cause of the System programmer response
problem. See the appropriate MVS/ESA manual for a description
CNM275I INVALID JOB STATEMENT of the DYNALLOC return codes and information codes
to determine why the data set was not allocated,
the job was not submitted, or the data set was not
Explanation deallocated.
You entered a SUBMIT command for a data set that CNM277I DATA SET dataset NOT FOUND
contains a JCL JOB statement that is not valid.

Explanation
System action
An ALLOCATE or SUBMIT command cannot find the
The command is not processed. specified data set.
Message Variables
Operator response
dataset
Verify that the data set to be submitted contains a
The name of the data set to be allocated or the
valid batch job. If so, notify the system programmer.
name of the data set containing the job to be
submitted.
System programmer response
Examine the data set containing the job to be System action
submitted.
The command is not processed.
CNM276I DYNALLOC MACRO FAILED TO
[ALLOCATE| DEALLOCATE] dataset Operator response
RC=retcode IC=ic
Verify that the data set name was correctly specified.
If so, notify the system programmer.
Explanation
An ALLOCATE, AUTOCNT, AUTOTBL, AUTOTEST, System programmer response
QRYGLOBL, or SUBMIT command was unable to
allocate the specified data set, or a FREE command Verify that the specified data set is correct and that the
was unable to deallocate the specified data set. data set is cataloged.

Message Variables CNM278I DATA SET dataset UNAVAILABLE


dataset
The name of the data set to be allocated, the name Explanation
of the data set containing the job to be submitted, An ALLOCATE or SUBMIT command was unable to
or the name of the data set to be deallocated allocate the specified data set because it was already
allocated to another job.

Chapter 5. CNM Prefix Messages 509


Message Variables operatorid
The ID of the specified operator.
dataset
The name of the data set to be allocated or the retcode
name of the data set containing the job to be The return code from the DSIPSS macro.
submitted. msgid
The ID of the message that was to be displayed.
System action
The command is not processed. Operator response
If this message is displayed repeatedly, notify the
Operator response system programmer.

Wait and retry the ALLOCATE or SUBMIT command. If


the failure continues, notify the system programmer. System programmer response
If this message is displayed repeatedly for a particular
System programmer response operator, there might be a hardware problem with the
terminal used by that operator. Try to determine the
Examine the data set to be allocated or the data set cause of the error. If necessary, contact IBM Software
containing the job to be submitted. Investigate the job Support.
using the data set.
CNM281I NETVIEW ALERT RECEIVER ID=
CNM279I job(jobid) SUBMITTED receiverid IS ALREADY ACTIVE

Explanation Explanation
The SUBMIT command was successful. You attempted to establish a second NetView alert
Message Variables receiver with the receiver ID that is already active. The
NetView task ID for the alert receiver task is used as
job the program-to-program interface receiver ID with one
The name of the job you submitted. exception. The receiver ID is NETVALRT if the NetView
jobid task ID is CNMCALRT. This message is issued from
The job entry subsystem number assigned by JES the NetView alert receiver task. You can start multiple
to the job. NetView alert receivers when using different task IDs
or receiver IDs.
System action Message Variables
The SUBMIT command ends. receiverid
The receiver ID that is being used.
CNM280I PRESENTATION ERROR AT
STATION operatorid, DSIPSS RC =
retcode, MSGID = msgid System action
The NetView alert receiver ends.
Explanation
The NetView program encountered an error while Operator response
attempting to display a message to the specified Notify the system programmer.
operator. The message which was to be displayed
follows this message.
System programmer response
Note: Although the message might be truncated on
the screen, the entire message is present in the Ensure that the receiver ID is not being used by
network log. This message can occur intermittently another alert receiver task or program. You can use
because of random events. For example, an operator the NetView DISBQL command processor to find out
turned off the terminal in the middle of a NetView which program-to-program interface receiver IDs are
session. currently active.

Message Variables CNM282I DUPLICATE KEY VALUES FOUND

510 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation • KEEP - Data set is to be kept when freed.

You specified a value twice where only one was • DELETE - Data set is to be deleted when freed.
expected. For example, you might have done one of And the error information can be:
the following:
• *ERROR* - The data set cannot be read.
• Specified duplicate tasks on the TASK keyword of a
TRACE command. Note: The text '(OPER-DS)' indicates an "operator
data set" defined by the OVERRIDE command.
• Specified duplicate SAF request types on either the
SAFA or SAFF keyword of a TRACE command.
System action
• Specified or defaulted the same value for different
special characters in a PIPE options statement. Processing continues.
CNM300I command : ENTER 'HELP
System action command' FOR HELP
The command is rejected.
Explanation
Operator response See the help panel for assistance in using the
command list.
Enter the command without the duplicate values.
Message Variables
CNM299I ddname dataset member disp
command
The name of the command list invoked.
Explanation
This multi-line message lists the DDNAME, the data System action
set name, and the file that is allocated to the NetView
program. It also lists the status and disposition for the The specified command list ends.
data set.
The first line contains the message ID only. The Operator response
next two lines contain non-data message headers. See the command list help panel for syntax and usage.
Subsequent lines are message text lines and have the
format ddname dataset member disp. CNM301E command : 'parm' SHOULD BE ONE
OF optionlist
Message Variables
ddname Explanation
The data definition name of the file.
dataset The parameter value does not match one of the valid
The name of the data set, or the text '(INSTORE- options listed.
COMMON)' which denotes a member loaded by the Message Variables
INSTORE stage.
command
member The name of the command list invoked.
The name of the file.
parm
disp The parameter with the incorrect value.
The status, disposition, and error information of
the data set in the form of status,disposition,error optionlist
information, where status can be: The list of valid options for the parameter.

• NEW - Data set is new.


System action
• OLD - Data set is old.
The specified command list ends.
• MOD - Additions are to be made to the data set.
• SHR - The data set exists but exclusive control is
Operator response
not required.
Select a valid option for the parameter.
The disposition can be:
• SYSOUT - Data set is a system output data set. CNM302E command : parm CANNOT BE
SPECIFIED TWICE

Chapter 5. CNM Prefix Messages 511


Explanation parm
The parameter specified in the command list.
The command list parameter parm was specified more
than once while invoking the command list.
System action
Message Variables
The specified command list ends.
command
The name of the command list invoked.
Operator response
parm
The command list parameter that was specified Use one of valid options listed.
more than once.
CNM305E command : value NAMES MUST BE
ENTERED FOR 'command'
System action
The specified command list ends. Explanation
The number of path names specified is out of the valid
Operator response range for command.
Specify this parameter only once in the command list Message Variables
invocation.
command
CNM303E command : 'parm1' CANNOT BE The name of the command list invoked.
SPECIFIED WITH 'parm2'. value
The number or range of valid path names to be
Explanation specified.

The values parm1 and parm2 are mutually exclusive.


System action
Message Variables
The specified command list ends.
command
The name of the command list invoked.
Operator response
parm1
The parameter value. Enter the correct number of path names.
parm2 CNM306E command : INVALID
The parameter value. PARAMETER(S) parmlist

System action Explanation


The specified command list ends. The parameters listed are not valid for the command
list invoked, or not valid for your NetView environment.
Operator response Message Variables
Review the syntax of the command and issue the command
command again. The name of the command list invoked
CNM304E command : 'options' CAN ONLY BE parmlist
SPECIFIED WITH parm The list of incorrect parameters passed to the
command list
Explanation
System action
Only parameter options options can be used with the
parameter parm. The specified command list ends.
Message Variables
Operator response
command
The name of the command list invoked. Check the valid parameters for the command list or
NetView environment and issue the command again.
options
The list of valid parameter options.

512 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM310E command : EXACTLY value Explanation
PARAMETERS ARE REQUIRED
WHEN INVOKING command The command list timed out while waiting for a
response.

Explanation Message Variables

The number of parameters specified when invoking command


the command list is not correct. The name of the command list invoked.
time
Message Variables
The amount of time for a response.
command timeunit
The name of the command list invoked. The unit of time.
value
The number of parameters required for the System action
command list.
The command list ends.
System action
Operator response
The specified command list ends.
Issue the command again. If command list times out
again, notify the system programmer.
Operator response
Use the correct number of parameters when invoking System programmer response
command list.
Verify that the system response time is acceptable.
CNM311I command : NAME STATUS Verify that VTAM and the CNMI interface are properly
SESSION ID installed and currently active.
CNM315E command : 'resource' IS NOT A
Explanation
VALID RESOURCE NAME
This is a header message for a table that is to follow.
CNM313I normally follows and is the data for the Explanation
table.
The resource name specified is not a valid name or
Message Variables
was not found.
command
Message Variables
The name of the command list invoked.
command
CNM312I command : value SESSION(S) IN The name of the command list invoked.
THE state STATE FOR appl
resource
The resource name specified.
Explanation
This message lists the number of sessions with the System action
specified status for the specified application.
The command list ends.
Message Variables
command Operator response
The name of the command list invoked.
Check spelling of resource name.
value
The number of sessions with the specified status. CNM316E command : 'resource' IS NOT
A CROSS-DOMAIN RESOURCE
state
MANAGER
The session status (active, pending, and so forth).
appl
The application specified. Explanation
CNM314I command : NO RESPONSE FOR The resource specified is not a cross-domain resource
time timeunit - CLIST ENDING manager.

Chapter 5. CNM Prefix Messages 513


Message Variables CNM320E command : TWO PARAMETERS
ENTERED, FIRST PARAMETER NOT
command
A SCOPE PARM
The name of the command list invoked.
resource
The resource name specified. Explanation
The second parameter must be null when the first
System action parameter is NETID.

The command list ends. Message Variables


command
Operator response The name of the command list invoked.

Check the spelling of the resource name and its


function in the network. System action
CNM317I command : 'command' CANCELED The specified command list ends.
BY OPERATOR
Operator response
Explanation Check the syntax and issue the command again.
The operator canceled the command list while it was CNM321I command : START DELAY FOR
in the pending state. COMMAND cmdlist
Message Variables
command Explanation
The name of the command list invoked. The commands listed is delayed the number of
seconds specified in the DELAY command.
System action Message Variables
The specified command list is canceled. command
CNM318I command : command FINISHED, The name of the command list invoked.
LAST RESOURCE PROCESSED cmdlist
The list of commands to be delayed in execution.
Explanation
System action
The command list has processed the resources and
ended normally. The commands listed is delayed the number of
seconds specified in the DELAY command.
Message Variables
command CNM322E command : PARAMETER ERROR,
The name of the command list invoked. PARMS DO NOT FIT ANY
POSSIBILITY

System action
Explanation
The specified command list ends normally.
The command list cannot parse the invocation
CNM319I command : DETERMINING parameters into a valid option.
DYNAMIC CDRSC TERMINALS
Message Variables

Explanation command
The name of the command list invoked.
The command list invocation syntax is correct and the
command list is starting the terminal name search.
System action
Message Variables
The specified command list ends.
command
The name of the command list invoked.

514 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System action
Check the syntax and issue the command again. The command list ends.
CNM323I command : THE DISG CLIST IS
AVAILABLE TO OST TASKS ONLY. Operator response
YOU TRIED TO INVOKE DISG Restrict the hexadecimal values to the specified
FROM A NON-OST TASK. length.
CNM326E command : 'value' MUST BE
Explanation
BETWEEN lowvalue AND hivalue
DISG is available only from operator station command
lists. Explanation
Message Variables
The value entered is out of the valid range.
command
Message Variables
The name of the command list invoked.
command
The name of the command list invoked.
System action
value
DISG ends. The value of the number entered.
lowvalue
Operator response The lowest valid value.
Do not attempt to run DISG from a non-OST. hivalue
The highest valid value.
CNM324I command : X"hexvalue" = decvalue

System action
Explanation
The specified command list ends.
The decimal equivalent of the value entered in
hexadecimal is displayed.
Operator response
Message Variables
The value specified must be within the range given.
command
The name of the command list invoked. CNM327E command : AN ADDRESS MUST BE
hexvalue ENTERED
The value entered in hexadecimal.
decvalue Explanation
The decimal equivalent of the value entered in A starting address was not specified in the command
hexadecimal. list invocation.
CNM325E command : 'value' IS LONGER Message Variables
THAN length CHARACTERS
command
The name of the command list invoked.
Explanation
The value entered is larger than the algorithm can System action
process.
The specified command list ends.
Message Variables
command Operator response
The name of the command list invoked.
Specify a starting address in the command list
value invocation.
The value entered.
CNM328E command : MORE THAN value
length
PARAMETER(S) WERE ENTERED
The maximum valid length of the input value.

Chapter 5. CNM Prefix Messages 515


Explanation System action
The number of parameters entered exceeded the The specified command ends.
maximum number valid.
Message Variables Operator response
command Specify the command correctly. Issue the HELP
The name of the command list invoked. command if necessary.
value CNM331E command : THERE IS NO
The maximum number of valid parameters. HELP PANEL FOR RETURN CODE/
FEEDBACK CODE COMBINATION
System action 'retcode, fdbkcode'

The specified command list ends.


Explanation
Operator response The return code or feedback code specified does not
have a help panel or explanation available.
Check the syntax and issue the command with the
correct number of parameters. Message Variables

CNM329E command : 'retcode' MUST BE A command


value DIGIT CODE The name of the command list invoked.
retcode
Explanation The return code entered.
fdbkcode
The return codes and feedback codes must be either The feedback code entered.
one or two digits long.
Message Variables System action
command The specified command list ends.
The name of the command list invoked.
retcode Operator response
The value of return code or feedback code.
value Verify that the codes entered are correct.
The valid values for return code or feedback code. CNM332I command : NETWORK NODE node

System action Explanation


The specified command list ends. The network node specified is being recycled.
Message Variables
Operator response
command
Specify a return code or feedback code within the valid The name of the command list invoked.
range.
node
CNM330E command : parm PARAMETER The name of node being recycled.
MISSING OR INVALID
CNM333I command : node HAS BEEN action

Explanation
Explanation
A required parameter was not specified or was
The specified action has been taken on the node
specified incorrectly.
specified.
Message Variables
Message Variables
command
command
The name of the command invoked.
The name of the command list invoked.
parm
The name of the missing or incorrect parameter.

516 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


node PANEL DEFINITION CONTAINS
The node name. COMMENT LINES ONLY.
action
The action taken on the node. Explanation
CNM334I command : WHEN A SECOND Panel definitions must contain lines other than
PARAMETER IS NOT GIVEN, THE comments. No non-comment lines were found for this
TIME MUST BE IN SECONDS AND panel.
CANNOT CONTAIN A ':'
Message Variables

Explanation command
The command list, SHOWCODE, that issues
The default unit of time for the DELAY command must messages for VIEW.
be in seconds and cannot contain a colon (:).
panel
Message Variables The name of the panel containing the error.
command
The name of the command list invoked. Operator response
Notify the system programmer.
System action
The specified command list ends. System programmer response
Correct the panel, panel, to ensure that lines other
Operator response than comments are defined in the panel.
Check the syntax and issue the command again. CNM337I SHOWCODE : CODE 12 - YOU
ARE NOT AUTHORIZED TO
CNM335I command : CODE 4 - 'member' BROWSE 'member'. THE DSIKVS
WAS NOT FOUND MACRO RESULTED IN A NONZERO
RETURN CODE.
Explanation
The requested member does not exist in any of the Explanation
data sets searched, or an I/O error occurred. To Security checks failed for the member specified by the
understand which data sets are searched for the message in the data definition in which it was found.
BROWSE command, enter HELP BROWSE. The VIEW
command searches CNMPNL1 for the member. Message Variables
Message Variables member
The member name you requested to browse,
command which is prohibited.
The command list, SHOWCODE, that issues
messages for VIEW.
System action
member
The name of the member which was not found. BROWSE command processing stops.

Operator response Operator response


Correct the member name or notify the system If you believe the failure should not have occurred,
programmer. consult your security administrator or system
programmer.
System programmer response
System programmer response
Add the member name to the correct data set or
correct the reference to the member name. Review the security for the READSEC command.
Further information about the security failure can be
CNM336I command : CODE 8 - PANEL 'panel'
obtained by having the operator issue READSEC for
HAS A DEFINITION ERROR. THE
the member and the DD name where the member was
expected to be found.

Chapter 5. CNM Prefix Messages 517


CNM338I command : CODE 16 - VIEW panel
COMMAND PROCESSOR INVOKED The name of the incorrectly-defined panel.
WITH INVALID PARAMETERS. command
The name of the command list invoked
Explanation
The parameters used in the VIEW command processor System action
invocation do not meet the requirements specified in The command ends.
the message.
Message Variables Operator response
command Verify that the correct panel was specified. If it was,
The name of the command invoked. notify the system programmer.

System action System programmer response


The specified command ends. Correct the related data set definition.
CNM342I command : CODE 32 -
Operator response AN UNRECOVERABLE ERROR
Review the syntax and issue the command again. RESULTED FROM A MACRO
INVOCATION IN THE VIEW
CNM340I command : CODE 24 - INVALID COMMAND PROCESSOR.
INVOCATION OF THE VIEW
COMMAND PROCESSOR. YOU
TRIED TO INVOKE VIEW FROM A Explanation
NON-OST TASK OR AUTOMATED A macro invocation failed.
OST.
Message Variables

Explanation command
The name of the command invoked.
The invocation of the view command processor failed
because it was not invoked from an operator station
task. System action
Message Variables The specified command ends.

command
The name of the command list invoked. Operator response
Contact the system programmer.
System action
The invocation fails. System programmer response
Determine which macro invocation failed and
Operator response eliminate the error. You can determine which macro
failed by inspecting the DWO050 message that
Invoke the view command processor only from an OST appears in the log; this DWO050 message contains
task. additional information about the error.
CNM341I command : CODE 28 - THE CNM343I command : CODE 36
RECORD FORMAT OF THE PANEL - AN UNRECOVERABLE
OR FILE 'panel' WAS NOT 80 INTERNAL PROGRAMMING ERROR
BYTES OCCURRED IN THE VIEW
COMMAND PROCESSOR
Explanation
The specified panel does not have the required record Explanation
length of 80 bytes. An internal programming error caused the failure you
Message Variables observed.

518 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables cmd
The command entered.
command
The name of the command list invoked. opsys
The operating system under which the command
was entered.
System action
The view command processor fails. System action
The command is ignored.
Operator response
Contact the system programmer. Operator response
Use only commands supported by the operating
System programmer response system under which the NetView program is executing.
Contact IBM Software Support.
CNM351E command : YOU MAY NOT USE
CNM345I command : 'msgno' IS AN INVALID THE 'operand1' OPERAND WITH
ERROR MESSAGE NUMBER FROM 'operand2' OPERAND
'command'
Explanation
Explanation The operands specified are mutually exclusive.
The message number is not a valid error message Message Variables
number for the command list invoked.
command
Message Variables The name of the command list invoked.
command operand1
The name of the command list invoked. The operand specified as a parameter to the
msgno command list.
The message number. operand2
The operand specified as a parameter to the
System action command list.

The specified command list ends.


System action
Operator response The specified command list ends.

Contact the system programmer.


Operator response
System programmer response Review the syntax and issue the command again.

Check that the error message number in the calling CNM352E command : 'value' IS NOT A
command list did not change from the original VALID VALUE FOR THE 'operand'
installation, and that the message was not removed OPERAND
from the MESSAGES command list (CNME1028).
CNM346I command : 'cmd' IS NOT Explanation
SUPPORTED UNDER THE opsys The value entered for the operand is out of the valid
OPERATING SYSTEM range.
Message Variables
Explanation
command
A command was entered that is not supported under The name of the command list invoked.
this operating system.
value
Message Variables The value specified for the operand.
command operand
The name of the command list invoked. The name of the operand.

Chapter 5. CNM Prefix Messages 519


System action CNM357I command : PF KEY SETTINGS
NOW ESTABLISHED. 'DISPFK' TO
The specified command list ends. SEE YOUR PF KEY SETTINGS

Operator response Explanation


Check the syntax for the valid operand range and issue PF key initialization is complete and the command
the command again. DISPFK can be used to display the current PF key
CNM353I command : variable = value settings.
Message Variables
Explanation command
The value or values are displayed for the specified The name of the command list invoked.
variable.
CNM359I command : TIME = hh:mm DATE =
Message Variables mm/dd/yy
command
The name of the command list invoked. Explanation
variable The system time and date are displayed.
The system variable, local variable, function or
Message Variables
data type that describes the displayed value.
value command
The current value or values of the variable. If more The name of the command list invoked.
than one value is displayed, the message might be hh:mm
in the form of a multiline message, where each line The current time of day. The time format depends
contains one or more values. In this case, the value on the TRANSMSG member, when in effect, and on
on the first line might be a heading indication (not the time operands of the DEFAULTS and OVERRIDE
a value), such as, "As follows:". commands.
CNM354I command : COMMAND COMPLETE mm/dd/yy
The current date. The date format depends on the
TRANSMSG member, when in effect, and on the
Explanation date operands of the DEFAULTS and OVERRIDE
The command entered has completed. commands.
Message Variables CNM360E command : REQUIRED
PARAMETER MISSING: command
command
parm value
The name of the command list invoked.
CNM355I command : PF KEYS ARE ONLY Explanation
VALID FOR OST (LOCAL OPERATOR
TASK) A required parameter is missing from the command
list invocation.
Explanation Message Variables
The PF keys can only be used for an operator station command
task, not for a PPT, NNT, or automated OST. The name of the command list invoked.
Message Variables parm
The name of the missing parameter.
command
value
The name of the command list invoked.
The valid value or values of the missing parameter.

System action
System action
The PF keys are not set.
The specified command list ends.

520 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response command
The name of the command list invoked.
Check the syntax and issue the command again.
CNM361E command : INVALID RETURN System action
CODE 'retcode' FROM VIEW
COMMAND PROCESSOR The ACTION command list ends.

Explanation Operator response


The return code entered in the SHOWCODE command Use correct action code syntax.
list was not valid. CNM364I command : 'cmd' IS NOT A VALID
Message Variables COMMAND IN THE component
COMPONENT.
command
The name of the command list invoked.
Explanation
retcode
The return code entered. The command entered is not recognized in the
component specified.
System action Message Variables
The SHOWCODE command list ends. command
The name of the command list invoked.
Operator response cmd
The name of the command that was entered.
Check that the correct value for the return code was
entered. component
A NetView component such as the command
CNM362E command : A RESOURCE ID IS facility or hardware monitor.
REQUIRED FOR 'command'
System action
Explanation
The command is not executed.
A resource ID must be specified as a parameter when
invoking this command list.
Operator response
Message Variables
Use a command recognized in the specified
command component.
The name of the command list invoked.
CNM365I command : THERE IS NO
PICTORIAL DISPLAY AVAILABLE
System action FOR 'resource'
The specified command list ends.
Explanation
Operator response There is no display panel available for the resource
Specify a resource ID and issue the command again. specified.
Message Variables
CNM363E command : ACTION CODE MUST
BEGIN WITH 'D', 'E', 'I', or 'R' command
FOLLOWED BY 3 DIGITS The name of the command list invoked.
resource
Explanation The resource name specified.
The action code specified does not have the correct
format. System action
Message Variables The DISG command list ends.

Chapter 5. CNM Prefix Messages 521


Operator response Explanation
See the NetView online help for the resource types The system is in the process of gathering the desired
supported by DISG. line data.
CNM366I command : A PROCESSING Message Variables
ERROR HAS OCCURRED IN CLIST command
'command' The name of the command list invoked.

Explanation CNM370I command : GATHERING LOCAL


3270 MAJOR NODE DATA ...
An error occurred in the command list while PLEASE WAIT
attempting to collect the requested data.
Message Variables Explanation
command The system is in the process of gathering the desired
The name of the command list invoked. local 3270 major node data.
Message Variables
System action
command
The specified command list ends. The name of the command list invoked.
CNM371I command : GATHERING LOCAL
Operator response SNA MAJOR NODE DATA ...
Contact the system programmer. PLEASE WAIT

System programmer response Explanation


Verify that VTAM and the CNMI interface are properly The system is in the process of gathering the desired
installed and currently active. local SNA major node data.

CNM367I command : GATHERING LU Message Variables


DATA ... PLEASE WAIT command
The name of the command list invoked.
Explanation CNM372I command : GATHERING
The system is in the process of gathering the desired SWITCHED SNA MAJOR NODE
LU data. DATA ... PLEASE WAIT

Message Variables
Explanation
command
The name of the command list invoked. The system is in the process of gathering the desired
switched SNA major node data.
CNM368I command : GATHERING PU
DATA ... PLEASE WAIT Message Variables
command
Explanation The name of the command list invoked.

The system is in the process of gathering the desired CNM373I command : GATHERING NCP/
PU data. HOST DATA .. PLEASE WAIT

Message Variables
Explanation
command
The name of the command list invoked. The system is in the process of gathering the desired
NCP or host data.
CNM369I command : GATHERING LINE
DATA ... PLEASE WAIT Message Variables
command
The name of the command list invoked.

522 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM374I command : 'node' IS NOT A VALID Explanation
NODE NAME
The syntax entered for the command list is not correct.

Explanation Message Variables

The node name specified is not valid or does not exist. command
The name of the command list invoked.
Message Variables
command System action
The name of the command list invoked.
The specified command list ends.
node
The node name specified in command list
invocation. Operator response
Check the syntax and issue the command again.
System action CNM379I command : YOU CAN'T START A
The specified command list ends. TRACE IN YOUR OWN DOMAIN

Operator response Explanation


Issue the command again using the correct node The cross-domain resource specified belongs to the
name. domain from which the command was issued. CDRM
traces can be performed only on resources that are not
CNM375E command : TWO PARAMETERS owned by the requesting operator's domain.
(RETURN CODE AND FEEDBACK
CODE) ARE REQUIRED Message Variables
command
Explanation The name of the command list invoked.

A return code and a feedback code must be specified


for RCFB. System action
Message Variables The specified command list ends.

command
The name of the command list invoked. Operator response
Issue again the trace for a cross-domain resource not
System action owned by your domain.

RCFB ends. CNM380E command : TOO MANY


PARAMETERS WERE ENTERED
Operator response
Explanation
Specify both the return code and the feedback code
and issue the command again. There were more parameters specified for the
command list than were used.
CNM377I command : INPUT ACCEPTED AND
BEING PROCESSED ... PLEASE Message Variables
WAIT command
The name of the command list invoked.
Explanation
The input is currently being processed. System action
Message Variables The specified command list ends.

command
The name of the command list invoked. Operator response
CNM378E command : SYNTAX ERROR: Check the syntax and issue the command again with
ENTER 'HELP command' FOR HELP the correct number of parameters.

Chapter 5. CNM Prefix Messages 523


CNM381E command : HOST NOT SET UP System action
CORRECTLY FOR MSG FOCAL
POINT Processing ends.

Explanation Operator response


The target host specified is not set up to act as a You can define a PF key to the PFKDEF command
message focal point. and repeat the query or use the BROWSE or WINDOW
commands to see key definitions in any member.
command
The name of the command list invoked. CNM384I command : count PF OR PA KEY(S)
WERE NOT SET BECAUSE ERRORS
WERE ENCOUNTERED.
System action
The specified command list ends. Explanation
Some PF keys or PA keys cannot be set.
Operator response
Message Variables
Verify that the target host specified is correct. If target
host must be a focal point, but is not, contact the command
system programmer. The command that was attempting to issue the
SET command.
System programmer response count
The number of keys that were not set.
Perform the focal point setup.
CNM382I command : SPECIFIED DOMAIN System action
'domain' NOT ACTIVE
The setting of the other keys continues. There is no
effect on the keys that had errors.
Explanation
The specified domain or application program is not Operator response
active.
Notify the system programmer.
Message Variables
command System programmer response
The name of the command list invoked.
Issue LIST KEY=ALL to determine which keys are not
domain set. Browse the command named in the message to
The name of the domain or application program. determine how the keys are to be set. Issue the SET
command individually for these keys to obtain more
System action specific information on the errors.

The specified command list ends. CNM385I command : VTAM NOT ACTIVE:
COMMAND command CAN NOT BE
INVOKED
Operator response
Activate the specified domain or application program. Explanation
CNM383I NO ALTERNATE KEY DEFINITION The command list cannot be invoked when VTAM is not
FOUND. active.
Message Variables
Explanation
command
There is no PF or PA key currently defined in an The name of the command list invoked.
alternate set. Such key definitions are dependent on
the application from which queries are made.
System action
The specified command list ends.

524 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response CNM388I command : CODE 81 - PANEL
'panel' HAS A DEFINITION ERROR.
Start VTAM and issue the command again. THERE IS NO TEXT INDICATOR
CNM386I command : VTAM IS NOT ACTIVE LINE (***), OR MORE THAN
AT THIS TIME 49 OPTION DEFINITIONS WERE
FOUND.
Explanation
Explanation
VTAM is not active.
One of the following panel definition errors has
Message Variables occurred:
command • There was not a text indicator line.
The name of the command list invoked.
• More than 49 option definitions were found.
• An attempt was made to display a member that is
System action
not a panel.
The specified command list ends normally.
Message Variables

Operator response command


The command list that issues messages for VIEW.
If VTAM must be active, contact the system panel
programmer. The name of the panel containing the error.

System programmer response Operator response


Start VTAM. Notify the system programmer.
CNM387I Command code rc. Command
interrupted by trapped messages. System programmer response
Verify that the panel panel exists. If the panel exists,
Explanation perform one or both of the following steps:
The command was suspended by trapped messages. 1. Correct the definition error.
Trapped messages cause the suspension to allow the
invoking procedure to process the messages. 2. Add an entry for panel to the HELPMAP member
and correct the corresponding panel name.
Message Variables
CNM390I command : CODE 83 - PANEL
command 'panel' HAS A DEFINITION ERROR.
The name of the command invoked. THE COMMENT LINES APPEAR
rc WITHIN THE PANEL DEFINITION.
The return code indicating trapped message
suspension. Explanation
Comment lines are not permitted within the definition
System action of a panel. Comment lines were found in the definition
The specified command is suspended. of this panel.
Message Variables
Operator response
command
Notify the system programmer. The command list, SHOWCODE, that issues
messages for VIEW.
System programmer response panel
The name of the panel containing the error.
The calling procedure must process or dispose of the
trapped messages. After the trapped messages have
either been processed or disposed of, use the RESUME Operator response
command to continue. Notify the system programmer.

Chapter 5. CNM Prefix Messages 525


System programmer response command
The name of the command list that issued this
Correct the panel, panel, to ensure that there are no message.
comment lines in the panel definition.
fptype
CNM394I command : cmd COMMAND The focal point type (PRIMARY or BACKUP).
FAILED: NO FORWARD IDS
AVAILABLE
System action
Explanation The CHANGEFP command is ended.

No FORWARD operator IDs are available for alert and


Operator response
message forwarding.
See the NetView online help for more information on
Message Variables
the CHANGEFP command. Then issue the command
command again from the appropriate host with the correct
The name of the command list that issued this parameters.
message.
CNM396I command : MESSAGE msgnum
cmd TRUNCATED BEFORE BEING SENT
The name of the command that failed. CROSS DOMAIN

System action Explanation


If the NetView program was attempting to forward an A forwarded message was truncated because it was
alert or message to the primary focal point host, then more than 228 characters long.
an attempt will be made to forward this information to
the backup focal point host. If the NetView program Message Variables
was attempting to forward the information to the command
backup focal point host, then the information is not The name of the command list that issued this
forwarded. message.
msgnum
Operator response The number of the message that was truncated.
Notify the system programmer. CNM397I command : REQUEST TO CHANGE
FOCAL POINT SENT TO targetname
System programmer response
Check the network log of the domain specified in the Explanation
command to determine why FORWARD operator IDs The request to change the focal point has been sent
are not available. If the problem persists, increase the to the target domain or to the alert and message
number of FORWARD IDs. forwarding automated operator.
CNM395E command : fptype FOCAL POINT Message Variables
CANNOT BE THE SAME AS THE
TARGET DOMAIN command
The name of the command list that issued this
message.
Explanation
targetname
The primary focal point is the name of the domain in The alert and message forwarding automated
which the command was entered. The backup focal operator or the name of the domain for which the
point is the second parameter on the CHANGEFP focal point is being changed.
command. The target domain is the first parameter
on the CHANGEFP command. The focal point (primary System action
or backup) must be a domain other than the target
domain. Change focal point processing continues.
Message Variables CNM398E command : cmd COMMAND
FAILED. [ timeout - WAIT TIME
EXPIRED | msg ]

526 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
The command command list was unable to process The command is ignored.
the cmd command because an error occurred or
because the command timed out. Operator response
Message Variables
Notify the system programmer.
command
The name of the command list that issued this System programmer response
message.
The specified command list must be run under a
cmd
certain task, or is reserved for use by the alert and
The name of the command that failed.
message forwarding automated operator. If opertask is
timeout the name of a task, run the command list under the
The timeout value in seconds. appropriate NetView task. If opertask is the name of
msg an operator, ensure that the operator is defined as the
The message or messages resulting from the cmd alert and message forwarding automated operator.
command. Each message consists of an optional
CNM401I COMMAND LIST cmdlist -
message ID and the message text.
INSUFFICIENT STORAGE

System action Explanation


No further processing is done for this command list.
A GETMAIN request for storage failed during command
list processing.
Operator response
Message Variables
Notify the system programmer.
cmdlist
The name of the command list.
System programmer response
Examine the command command list to determine System action
why the cmd command failed. If a timeout has
The GETMAIN request is ignored and the command list
occurred, increase the timeout value defined in
processing continues.
the NetView initial command list. If msg is given,
see the appropriate NetView message or refer to
the appropriate VTAM manual to determine the Operator response
cause of the error, and then, if appropriate, change
Determine whether you received message BNH16I,
the definition in the alert and message forwarding
which means the task has reached its storage limit.
automated operator initial command list or the
If so, notify your system programmer.
NetView initial command list.
CNM399E command : THE command System programmer response
COMMAND IS NOT AVAILABLE TO
opertask See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
Explanation CNM402I TRACE START ACCEPTED
The specified command list is reserved for use by the
alert and message forwarding automated operator, or Explanation
must be run under a specific task.
The NetView program will start tracing REXX
Message Variables executable code.
command CNM403I TRACE START NOT ACCEPTED
The name of the command list that cannot run.
opertask Explanation
The name of the task or operator that is not valid to
issue the command list. The TS (trace start) command was not successful in
starting the TRACE.

Chapter 5. CNM Prefix Messages 527


Operator response CNM408I COMMAND LIST cmdlist ALREADY
LOADED - REPLACE NOT
Enter the TS command again. SPECIFIED
CNM404I TRACE END ACCEPTED
Explanation
Explanation The referenced command list is already loaded in main
The NetView program stops tracing REXX executable storage and the replace option was not specified on
code. the LOADCL command.

CNM405I TRACE END NOT ACCEPTED Message Variables


cmdlist
Explanation The name of the command list.

The TE (trace end) command was not successful in


ending the TRACE. System action
The command list is not replaced.
Operator response
Enter the TE command again. Operator response
CNM406I COMMAND LIST cmdlist LOADED Issue the command again with the replace option if a
new copy of the command list must be loaded in main
storage.
Explanation
CNM409I I/O FAILURE - COMMAND LIST
The referenced command list has been loaded in main cmdlist NOT LOADED
storage.
Message Variables Explanation
cmdlist An I/O error occurred during an attempt to load the
The name of the command list. command list in main storage.
CNM407I COMMAND LIST cmdlist - NESTED Message Variables
COMMAND LISTS EXCEEDED
LIMIT cmdlist
The name of the command list.

Explanation
System action
The specified command list is nested more levels than
valid. Processing of the LOADCL command continues.

Message Variables
Operator response
cmdlist
The name of the command list. Notify the system programmer.

System action System programmer response


Determine the origin of the I/O error.
The "signal on failure" condition becomes true and a
-1 return code is set. The command list processing CNM410E COMMAND LIST cmdlist - EXECIO
continues. 'operation' ERROR FOR DD
'ddname' - ABEND CODE X'code'
Operator response
Notify the system programmer. Explanation
The last EXECIO command to reference the specified
System programmer response file encountered an error performing the specified
operation, which might have resulted in an ABEND.
Correct the command list.
Message Variables

528 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


cmdlist Operator response
The name of the command list that contains the
EXECIO command. Correct and issue the DROPCL command again.
operation CNM413I REXX INTERPRETER NOT
The code that identifies the operation that INSTALLED
was being performed on behalf of the EXECIO
command. Explanation
ddname
REXX is not installed on your system.
The DDNAME of the file that the EXECIO command
was using.
code Operator response
This is the 8-character ABEND code from the Notify the system programmer.
TCBCMP field at the time of the error, which might
be related to the error. The first two characters can
be ignored. The next three characters are nonzero
System programmer response
for a SYSTEM ABEND. The last three characters are Verify that REXX is correctly installed on your system.
nonzero for a USER ABEND.
CNM414I COMMAND LIST cmdlist NOT
LOADED - NOT A VALID COMMAND
System action LIST
If the command list with the EXECIO command has
SIGNAL ON HALT coded, control is passed to the HALT Explanation
label. Otherwise, the command list ends.
A LOADCL command was issued for a command list
which is not REXX or bilingual.
Operator response
Message Variables
Notify the system programmer.
cmdlist
The name of the command list.
System programmer response
Correct the error. The system operator's console might System action
contain more detailed messages as to what caused the
error. Processing of the LOADCL command continues.

CNM411I COMMAND LIST cmdlist DROPPED


Operator response
Explanation Correct the command list and issue the LOADCL
command again.
The referenced command list has been dropped from
main storage. CNM415I LOAD FAILED FOR REXX
INTERPRETER MODULE module
Message Variables
cmdlist Explanation
The name of the command list.
REXX did not load successfully.
CNM412I COMMAND LIST cmdlist NOT
DROPPED - COMMAND LIST NOT Message Variables
FOUND module
The name of the REXX module that did not load
Explanation successfully.

The referenced command list appeared on a DROPCL


command, but it is not loaded in main storage.
System action
Message Variables Processing of the REXX command list is ended.

cmdlist
The name of the command list.
Operator response
Notify the system programmer.

Chapter 5. CNM Prefix Messages 529


System programmer response of environments to be exceeded. Run the LIST
STATUS=TASKS RXENVCNT=YES command to see
Ensure that the correct level of TSO/E is installed on how REXX environments are used by each task
your system and that sufficient storage is available. and to see how many are available to the NetView
CNM416I REXX INTERPRETER program and are used by the NetView program at
ENVIRONMENT INITIALIZATION the time this command is run.
FAILED FOR TASK task, RETURN 20/10024
CODE = retcode, REASON CODE = Processing was unsuccessful. The maximum
reason number of environments allowed for this task by
the DEFAULTS/OVERRIDE command was reached.
Explanation Check the DEFAULTS/OVERRIDE REXXENVL
settings for this task and change them as needed.
A task was unable to initialize REXX.
Verify that REXX is correctly installed on your system.
Message Variables
CNM417I COMMAND LIST cmdlist NOT
task LOADED - COMMAND LIST NOT
The name of the task. FOUND
retcode
The return code from the REXX interpreter. Explanation
reason
A command list name on the LOADCL command was
The reason code from the REXX interpreter or the
not found as a member of the DSICLD data set.
NetView program.
Message Variables
Operator response cmdlist
Notify the system programmer. The name of the command list.

System programmer response System action


See the TSO/E REXX Reference for a list of the return Processing of the LOADCL command continues.
and reason codes. The most common return/reason
codes are as follows: Operator response
20/21 Correct the command list name on the LOADCL
Processing was unsuccessful. A TSO/E REXX command, and issue the command again for that
module cannot be loaded into storage command list.
The most likely reason is that the TSO/E REXX CNM418I COMMAND LIST cmdlist - REXX
interpreter library was not included in your LPA TRACE START FAILED
library or your NetView STEPLIB.
20/24 Explanation
Processing was unsuccessful. The maximum
number of environments was initialized in the The TS (trace start) command was unable to start the
address space. trace.

The most likely reason is that the number of Message Variables


entries in the IRXANCHR table is insufficient for cmdlist
your NetView environment. Obtain a copy of the The name of the command list that is running.
IRXANCHR table from your TSO/E administrator.
This table is stored in the IRXTSMPE member of
the SYS1.SAMPLIB data set. See the TSO/E REXX
Operator response
Reference for an explanation about increasing Enter the TS command again.
the number of entries in the IRXANCHR table.
To determine the number of IRXANCHR entries CNM419I NO ACTION TAKEN ON ASSIGN
needed, see the IBM Z NetView Tuning Guide. A COMMAND: VALUE FOR listname
setting of CMD=HIGH in the CNMSTYLE member LIST IS INCORRECT.
can also result in command lists to stack, which
can eventually result in the maximum number

530 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
You entered the DELETE keyword but an operator The NetView program displays the incorrect command
name entered was not found in the assignment. If a list statement of the command list.
valid operator name is entered twice, it will not be
found the second time. Operator response
Message Variables
Notify the system programmer.
listname
PRI, COPY, or OP. System programmer response
Correct the command list statement that is in error.
System action
CNM422E cmdproc ISSUED WAIT CONTINUE
Processing for the ASSIGN command stops.
WITHOUT PREVIOUS WAIT

Operator response
Explanation
Check the syntax of the command you entered and
A high level language (HLL) or a REXX command
enter it again.
procedure issued a WAIT CONTINUE command
CNM420I COMMAND LIST cmdlist - without first issuing a valid WAIT command.
COMMAND TEXT TOO LONG
Message Variables
cmdproc
Explanation
The name of the HLL command procedure or REXX
You entered a command that was longer than 32000 command list that issued the WAIT CONTINUE
characters or a command operand that was longer command.
than 255 characters.
Message Variables System action
cmdlist The WAIT CONTINUE command is ignored.
The name of the command list.
Operator response
System action
Notify the system programmer.
The NetView program ignores the command.
System programmer response
Operator response
Correct the HLL command procedure or REXX
Correct the operand or command that is not valid and command list so that it issues a valid WAIT command
enter the command again. before the WAIT CONTINUE command.
CNM421I COMMAND LIST cmdlist - CNM423I COMMAND LIST cmdlist - INVALID
INVALID COMMAND command SYNTAX
ENCOUNTERED
Explanation
Explanation
A NetView REXX function detected a syntax error in its
The NetView program found a command that is not invocation. This error can result from extra operands
valid while processing the specified command list. specified or expected operands missing.
Message Variables Message Variables
cmdlist cmdlist
The name of the command list with the command The name of the command list containing the error.
that is not valid.
command
The command that is not valid.

Chapter 5. CNM Prefix Messages 531


System action cmdlist
The name of the command list.
If the command list does not have an active SIGNAL
ON SYNTAX, the statement in error is echoed, a REXX CNM426I COMMAND LIST cmdlist - NULL
error message is issued, and the command list ends. OPERAND INVALID FOR GLOBALV
STATEMENTS
Operator response
Explanation
Notify the system programmer that there are errors in
the named command list. A GLOBALV statement in cmdlist contains a null
operand. You cannot code null operands on GLOBALV
statements.
System programmer response
Message Variables
Correct the statement in the command list.
cmdlist
CNM424I COMMAND LIST cmdlist - The name of the REXX command list.
ACCESS TO COMMAND IS NOT
AUTHORIZED
Operator response
Explanation Enter the REXX command list with a valid operand. If
errors persist, notify the system programmer.
You are not permitted to issue the command found in
the command list.
System programmer response
Message Variables
Correct the GLOBALV statement. There can be only
cmdlist one blank or comma between operands. Delete extra
The name of the command list. blanks or commas.
CNM427I NO COMMAND LISTS HAVE BEEN
System action LOADED
A -3 return code is set in the special REXX RC variable.
If a REXX SIGNAL ON ERROR was active at the time Explanation
of the error, the error routine will be driven. The
command in error might be displayed, depending on No command lists have been loaded with the LOADCL
the current TRACE statement setting. command.

Operator response System action


Notify the system programmer. Processing of the DROPCL or MAPCL command is
ended.
System programmer response
Operator response
Make certain that the command is spelled correctly in
the command list. If it is spelled correctly, evaluate the Ensure that command lists have been loaded using
operator's requirements and add appropriate security LOADCL before attempting to use the DROPCL or
access if required. MAPCL command.

CNM425I DROP PENDING FOR COMMAND CNM428I COMMAND LIST cmdlist -


LIST cmdlist TERMINAL INPUT NOT valid FOR
TASK TYPE tasktype
Explanation
Explanation
This message is issued if you enter a DROPCL
command for a command list that is currently in use When running under the specified task, no input from a
or a command list that is already pending drop. The terminal is valid.
named command list will be dropped as soon as it is Message Variables
no longer in use.
cmdlist
Message Variables The name of the command list.

532 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


tasktype System action
The task type.
The command list stops processing until you enter a
response.
System action
The NetView program continues to process the Operator response
command list, but ignores the PARSE statement. In the
case of an interactive trace, the trace continues but no Enter GO to continue or enter GO TRACE OFF to
terminal input is valid. end the trace. Also, after receiving this message, you
can enter GO followed by a command or instruction
you want to execute at the point in the command
Operator response list where processing stopped. For example, to set
Notify the system programmer. a variable to a certain value at that point in the
command list you can enter:
System programmer response GO X=5

Do not run under the specified task. Or, to display the current value of a variable you can
CNM429I MAPCL DISPLAY enter:

GO SAY 'VAR1 CURRENTLY IS 'VAR1


Explanation
CNM432I COMMAND LIST cmdlist - INVALID
This message is a response to the MAPCL command.
OPERAND: operand
It precedes the MAPCL display. See the NetView online
help for details on the MAPCL display.
Explanation
System action An operand of a NetView REXX function was not
correctly specified.
The MAPCL display follows this message.
Message Variables
CNM430I COLUMN MISMATCH IN MAPCL
DISPLAY cmdlist
The name of the command list containing the error.
Explanation operand
The operand containing the error.
An unexpected number of columns was found for the
MAPCL display.
System action
System action If the command list does not have an active SIGNAL
ON SYNTAX, the statement in error is echoed, a REXX
The MAPCL display ends. error message is issued, and the command list ends.

Operator response Operator response


Notify the system programmer. Notify the system programmer that there are errors in
the specified command list.
System programmer response
Contact IBM Software Support. System programmer response
CNM431I REXX INTERACTIVE TRACE. Correct the statement in the command list.
ENTER 'GO TRACE OFF' TO END CNM433I COMMAND LIST cmdlist -
TRACE, ENTER 'GO' TO CONTINUE. COMMAND LIST FUNCTION
function INVALID FOR TASK TYPE:
Explanation [PPT | OST | NNT]
You are tracing a REXX command list, and a trace point
has been reached.

Chapter 5. CNM Prefix Messages 533


Explanation Explanation
The specified NetView REXX function is not supported An assisted command has been received from the
under the stated subtask type. NetView program-to-program interface. It has been
stored in a buffer awaiting operator action.
Message Variables
Message Variables
cmdlist
The name of the command list containing the error. command
function The command that saved the assisted command.
The name of the unsupported function.
Operator response
System action Use ASSISCMD to process the assisted command.
If the command list does not have an active SIGNAL CNM437W command: YOUR BUFFER
ON SYNTAX, the statement in error is echoed, a REXX IS ALMOST FULL. ENTER
error message is issued, and the command list ends. THE ASSISCMD BEFORE THE
MAXIMUM VALUE IS EXCEEDED.
Operator response
Notify the system programmer that there are errors in Explanation
the named command list. The assisted command buffer is almost full.
Message Variables
System programmer response
command
Correct the statement in the command list. For a The command that saved the assisted command.
description of the restrictions on commands under
various tasks, see IBM Z NetView Programming: REXX
and the NetView Command List Language. Operator response
CNM435I VTAM COMMUNICATION FAILURE. Use ASSISCMD to process the assisted commands in
STATUS INFORMATION HAS BEEN the buffer. If the buffer becomes full, future assisted
LOST. commands will be discarded.
CNM438E command: YOUR BUFFER IS FULL.
Explanation THE ASSISTED COMMAND HAS
BEEN DISCARDED.
A VTAM communication failure occurred.

Explanation
System action
The assisted command buffer is full. Another assisted
The status communication between the status monitor command was received from the program-to-program
and VTAM is ended. interface but it cannot be saved.
Message Variables
Operator response
command
Determine whether you received message BNH16I, The command that attempted to save the assisted
which means the task has reached its storage limit. command.
If so, notify your system programmer.

System action
System programmer response
The assisted command has been discarded.
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. If necessary,
see the IBM Z NetView Tuning Guide for more Operator response
information. Notify the system programmer.
CNM436I command: YOUR BUFFER NOW
CONTAINS ONE ASSISTED
COMMAND.

534 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
If the buffer for assisted commands is too small, An incorrect keyword delimiter was specified for the
increase the size of the buffer in SAVECMD. indicated command.
CNM439I VTAM HAS ENCOUNTERED AN Message Variables
ABEND DURING A PROGRAM keyworddelimiter
CALL TO THE NETVIEW ADDRESS The keyword delimiter that is not valid.
SPACE WHICH HAS TERMINATED
command
The name of the command specified.
Explanation
VTAM has encountered an abend during a program call System action
to the NetView address space which has ended.
The command specified is not executed.
System action
Operator response
Processing for the program call ends. No dump will be
issued. Notify the system programmer if the error occurred
in a command list. Otherwise, correct the keyword
delimiter in error and enter the command again.
System programmer response
Restart NetView program. System programmer response
CNM450I INVALID KEYWORD "keyword" Edit the command list and correct the keyword
SPECIFIED FOR command delimiter in error.
COMMAND
CNM452I REQUIRED KEYWORDS MISSING
FOR format FORMAT OF THE
Explanation command COMMAND
An incorrect keyword was specified for the indicated
command. Explanation
Message Variables The required keywords were not specified for the
keyword indicated command.
The incorrect keyword that was specified. Message Variables
command format
The name of the command specified. The format that was specified.
command
System action The name of the command.
The command specified is not executed.
System action
Operator response The command specified is not executed.
Notify the system programmer if the error occurred
in a command list. Otherwise, correct the keyword in Operator response
error and enter the command again.
Notify the system programmer if the error occurred in
a command list. Otherwise, add the required keywords
System programmer response and enter the command again.
Edit the command list and correct the keyword in error.
CNM451I INVALID KEYWORD DELIMITER System programmer response
'keyworddelimiter' SPECIFIED FOR Edit the command list and add the required keywords.
command COMMAND. EQUAL(=)
IS THE ONLY VALID KEYWORD CNM453I INVALID FORMAT "format"
DELIMITER SPECIFIED FOR command
COMMAND

Chapter 5. CNM Prefix Messages 535


Explanation KEYWORD "keyword" IN command
COMMAND
The format entered for the indicated command is not
valid.
Explanation
Message Variables
A data delimiter other than comma (,) and semicolon
format (;) was specified in the indicated command. Commas
The format that is not valid. are used to separate multiple data fields associated
command with any given keyword. The semicolon is only valid
The name of the command specified. with keywords USER, FAIL, and INST and is used to
separate action data values from cause data values.
System action Message Variables
The command specified is not executed. datadelimiter
The data delimiter that is not valid.
Operator response keyword
The name of the keyword specified.
Notify the system programmer if the error occurred in
a command list. Otherwise, enter the command again command
with a valid format. The name of the command specified.

System programmer response System action


Edit the command list and correct the format in error. The command is not executed.

CNM454I INVALID KEYWORD "keyword"


Operator response
SPECIFIED FOR format FORMAT
OF THE command COMMAND Notify the system programmer if the error occurred in
a command list. Otherwise, correct the data delimiter
Explanation error and enter the command again.

An incorrect keyword was specified for the format of


System programmer response
the indicated command.
Edit the command list and correct the data delimiter in
Message Variables
error.
keyword
The incorrect keyword specified. CNM456I INVALID DATA "datavalue"
SPECIFIED FOR KEYWORD
format "keyword" IN command COMMAND
The name of the format specified.
command Explanation
The name of the command specified.
A data value that is not valid was entered for the
specified keyword in the indicated command.
System action
Message Variables
The command is not executed.
datavalue
The incorrect data value.
Operator response
keyword
Notify the system programmer if the error occurred The name of the keyword specified.
in a command list. Otherwise, correct the keyword in
error and enter the command again. command
The name of the command specified.

System programmer response


System action
Edit the command list and correct the keyword in error.
The command is not executed.
CNM455I INVALID DATA DELIMITER
'datadelimiter' SPECIFIED FOR

536 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System action
Notify the system programmer if the error occurred in The command is not executed.
a command list. Otherwise, correct the data value in
error and enter the command again. Operator response
Notify the system programmer if the error occurred in
System programmer response
a command list. Otherwise, enter the command again
Edit the command list and correct the data values in with valid data.
error.
CNM457I INVALID FORMAT DELIMITER System programmer response
'formatdelimiter' SPECIFIED FOR Edit the command list and correct the data in error.
command COMMAND. BLANK
IS THE ONLY VALID FORMAT CNM459I NUMBER OF DATA VALUES
DELIMITER SPECIFIED FOR KEYWORD
"keyword" IN command COMMAND
EXCEEDS MAXIMUM
Explanation
A format delimiter that is not valid was specified in the Explanation
indicated command.
The number of data values entered for the specified
Message Variables
keyword exceeds the maximum number of data values
formatdelimiter accepted for that keyword.
The format delimiter that is not valid.
Message Variables
command
The name of the command specified. keyword
The keyword that is not valid.
command
System action
The name of the command specified.
The command is not executed.
System action
Operator response
The command is not executed.
Notify the system programmer if the error occurred in
a command list. Otherwise, enter the command again Operator response
with a valid format delimiter.
Notify the system programmer if the error occurred in
a command list. Otherwise, enter the command again
System programmer response
with a valid number of data values.
Edit the command list and correct the format delimiter
in error. System programmer response
CNM458I NO DATA OR INCOMPLETE Edit the command list and specify a valid number of
DATA SPECIFIED FOR KEYWORD data values for this keyword.
"keyword" IN command COMMAND
CNM460I ALERT RECORD CANNOT BE
LOGGED VIA command COMMAND.
Explanation
CNM ROUTER IS NOT ACTIVE
The data entered for the specified keyword is either
missing or incomplete. Explanation
Message Variables
There was an attempt to log an alert record when the
keyword CNM router was not active.
The keyword that is not valid.
Message Variables
command
The name of the command specified. command
The name of the command specified.

Chapter 5. CNM Prefix Messages 537


System action System action
The command is not executed. The command is not executed.

Operator response Operator response


Notify the system programmer. Notify the system programmer if the error occurred in
a command list. Otherwise, resolve the syntax error
System programmer response and enter the command again.

Start the CNM router task DSICRTR and resend the


System programmer response
alert.
Edit the command list and resolve the syntax error.
CNM461I CONFLICTING KEYWORDS
SPECIFIED IN cmd COMMAND CNM464I INVALID INPUT FOR command
COMMAND
Explanation
Explanation
Mutually exclusive keywords have been entered in the
indicated command. The input was not valid for the given command.
Message Variables Message Variables
cmd command
The name of the command specified. The name of the command specified.

System action System action


The command is not run. If this message is issued from a pipeline stage
command, the pipeline continues. Otherwise, the
Operator response command is not executed.

Notify the system programmer if the error occurred


Operator response
in a command list. Otherwise, resolve the keyword
conflict and enter the command again. Notify the system programmer if the error occurred in
a command list. Otherwise, resolve the input that is
System programmer response not valid and enter the command again.

Edit the command list and resolve the keyword


System programmer response
conflict.
Edit the command list and resolve the error.
CNM462I INVALID SYNTAX - UNBALANCED
OR MISSING DELIMITERS FOR CNM465I TIMER EVENT CANNOT BE
command COMMAND RESTORED - reason

Explanation Explanation
The command cannot be parsed because the This message is issued to the requesting operator
delimiters are unbalanced or missing. to indicate that the timer event displayed cannot be
restored. This message contains a multiline display of
Note: For the REVISE or REVISMSG command, the
the timer event that cannot be restored. You can write
CNM462I message is accompanied by the DSI417I
an automation routine to determine whether the timer
message which identifies the line. Syntax checking
event must be executed immediately or rescheduled
continues without this line. Therefore, subsequent
based on the contents of this message.
error messages might be reported which relate to the
CNM462I message. Message Variables
Message Variables reason
The detailed reason for failure.
command
The name of the command specified.

538 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action type
The type of TIMER request.
The timer event is discarded and deleted from the
Save/Restore database. CNM468I function OF type COMPLETED.
RETURN CODE retcode
Operator response
Explanation
Determine if the timer event is necessary. If so, issue
the scheduled command from the timer event that was This message is issued for a RESTORE command
rejected. for a timer request to the requesting operator to
indicate that the RESTORE command has completed. A
CNM466I RESTORE OF type ALREADY IN function of DELETE indicates that a RESTORE DELETE
PROGRESS has completed.
Message Variables
Explanation
function
This message is issued to the requesting operator The function can be RESTORE or RESTORE
to indicate that the RESTORE command has not DELETE.
been accepted. A previous RESTORE request has not
completed and only one outstanding RESTORE can type
be active at a time. This message is also issued if a The type of TIMER request.
RESTORE and a RESTORE DELETE command are both retcode
active at the same time. The return code from the RESTORE command. The
possible return codes are:
Message Variables
0
type
RESTORE command completed successfully.
The type of RESTORE request.
8
RESTORE command failed because of VSAM
System action errors.
The command is not executed. 12
No records were found.
Operator response 32
RESTORE command failed because of timeout
Notify the system programmer.
condition.

System programmer response


System action
Determine if the rejected RESTORE command still
If the return code from the RESTORE command is
needs to be executed. If it does, enter the rejected
8, message DWO191I or DWO192I, and message
RESTORE command again after the previous RESTORE
DWO168I are issued before this message. If the return
request has completed. The completion of a RESTORE
code from the RESTORE command is 32, message
request is indicated by the receipt of message
DWO191I or DWO192I, and message DWO398I are
CNM468I.
issued before this message.
CNM467I function OF type STARTED
CNM470I task: command COMMAND NOT
PERFORMED. OPEN FAILED FOR
Explanation ddname
This message is issued to the requesting operator to
indicate that the RESTORE command has been started Explanation
for a timer request. A function of DELETE indicates that
You have requested a SWITCH of the active data
a RESTORE DELETE has started.
set used by the sequential log function. The SWITCH
Message Variables failed.
function Message Variables
This function can be RESTORE or RESTORE
task
DELETE.
The name of the task that issued the message.

Chapter 5. CNM Prefix Messages 539


command Explanation
SWITCH or synonym you defined.
This is an informational message to indicate that the
ddname specified task does not have a data set open for
The DDNAME of the data set that failed to open. output.
Message Variables
System action
task
No change occurs to the active data set if the switch
The name of the task that issued the message.
was because of an operator command. If the switch
was because of the active data set running out of
space, then no data set will be active and message System action
CNM472I will be displayed. All DSIWLS requests for the task to perform sequential
logging will fail.
Operator response
Notify the system programmer. Operator response
Determine if a data set can be switched to so that
System programmer response sequential logging can continue.
See the accompanying system message to determine CNM473I task: PRIMARY DATA SET IS NOW
the reason for the open failure. INACTIVE
CNM471I task: command COMMAND NOT
PERFORMED. NO SECONDARY Explanation
DATA SET EXISTS This message is issued to the authorized receiver
when an event has occurred to cause the primary
Explanation sequential data set to be inactive.
The SWITCH that you requested failed because the Message Variables
secondary data set does not exist.
task
Message Variables The name of the task that issued the message.
task
The name of the task that issued the message. System action
command The primary sequential log is now being used for
SWITCH or synonym that you defined. output.
CNM474I task: exit INSTALLATION EXIT
System action PROVIDED INVALID RETURN
No change occurs to the active data set. CODE

Operator response Explanation


Notify the system programmer if a secondary data set This message is issued to the authorized receiver to
should exist. indicate the specified installation exit for task is not
coded correctly.

System programmer response Message Variables

Determine if the NetView task definition for task task


defines a secondary data set. A secondary data set The name of the task that issued the message.
is defined by the SBSDN operand on the DSTINIT exit
statement. The name of the installation exit (XITBN or XITBO).
CNM472I task: NO DATA SET(S) ARE NOW
ACTIVE System action
The task is activated as if the specified installation exit
was never driven.

540 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response count
The cumulative number of DASD write errors since
Notify the system programmer. the sequential log task started.

System programmer response System action


See IBM Z NetView Programming: Assembler for valid The sequential log task is not ended, but the log might
return codes from the specified installation exit. not reflect all of the records to be logged.
CNM476I SAVE REQUEST FOR type id IS
SUCCESSFUL Operator response
Verify the severity of the problem and change the
Explanation DASD unit if required.
This message reports the successful completion of a CNM480I task: SEQUENTIAL LOG REQUIRES
SAVE request. 'FUNCT=OTHER' TO BE CODED
Message Variables
type Explanation
The type of SAVE request. The sequential log task that you requested cannot be
id started because of a definition statement that is not
The timer event identification. valid.

CNM478I task: SEQUENTIAL LOG Message Variables


BLOCKSIZE(S) ARE INCORRECT task
The name of the task that issued the message.
Explanation
This message was issued because the blocksize is System action
less than 150 bytes, or because the blocksize of the The sequential log task ends.
primary and secondary files are not equal.
Message Variables Operator response
task Notify the system programmer.
The name of the task that issued the message.

System programmer response


System action
Determine if the NetView task definition for task is
The sequential log task ends. coded correctly.
CNM481I task: 'PBSDN' IS REQUIRED FOR
Operator response SEQUENTIAL LOG TASKS
Correct the blocksize in the startup procedure and
then issue the startup procedure again. Explanation
CNM479I task: DASD WRITE ERROR. count The sequential log task that you requested cannot be
ERROR(S) HAVE OCCURRED THUS started because of a missing definition statement.
FAR
Message Variables
Explanation task
The name of the task that issued the message.
An unrecoverable error occurred when writing records
to DASD.
System action
Message Variables
The sequential log task ends.
task
The name of the task that issued the message.
Operator response
Notify the system programmer.

Chapter 5. CNM Prefix Messages 541


System programmer response Explanation
Code a primary sequential data set to be used for A request to sequentially log a record that is larger
sequential logging. than the block size of the sequential log data set has
caused the sequential log function to truncate the
CNM482I task: PRIMARY DATA SET IS NOW record.
ACTIVE
Message Variables
Explanation task
The name of the task that issued the message.
For the sequential logging task, an automatic switch
(out of space condition on the active data set) or a
manual switch (SWITCH command) occurred to the System action
primary data set. A truncated record is written to the sequential log data
For the distributed DVIPA statistics autotask, the set.
defined record limit for the secondary data set
(DDNAME CNMDVIPS) was reached, and logging Operator response
moved to the primary data set.
Notify the system programmer.
Message Variables
task System programmer response
The name of the task that issued the message.
Check the BLKSIZE of the sequential log data sets and
adjust appropriately.
System action
CNM485I task: AUTOMATIC SWITCH NOT
The task begins writing to the primary data set.
PERFORMED. AUTOFLIP IS OFF
This can occur for the sequential logging task or the
distributed DVIPA statistics autotask.
Explanation
CNM483I task: SECONDARY DATA SET IS
NOW ACTIVE The secondary sequential log data set ran out of
space and an automatic switch cannot occur because
AUTOFLIP=NO was coded for the task definition.
Explanation
Message Variables
For the sequential logging task, an automatic switch
(out of space condition on the active data set) or a task
manual switch (SWITCH command) occurred to the The name of the task that issued the message.
secondary data set.
For the distributed DVIPA statistics autotask, the System action
defined record limit for the primary data set (DDNAME All sequential logging has stopped.
CNMDVIPP) was reached, and logging moved to the
secondary data set. CNM486I task: command COMMAND NOT
PERFORMED. NO DATA SETS ARE
Message Variables ACTIVE.
task
The name of the task that issued the message. Explanation
The SWITCH that you requested of the active data set
System action used by the sequential log function has failed.
The task begins writing to the secondary data set. Message Variables
This can occur for the sequential logging task or the
distributed DVIPA statistics autotask. task
The name of the task that issued the message.
CNM484I task: SEQUENTIAL LOG RECORD
HAS BEEN TRUNCATED command
The SWITCH or synonym you defined.

542 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM487I task: command COMMAND NOT task
PERFORMED. DATA SET ALREADY The name of the task that issued the message.
ACCESSIBLE locid
The location in the module that caused the failure.
Explanation
The SWITCH command you requested was not System action
performed because the desired data set was already The sequential log task is ended.
active.
Message Variables Operator response
task Determine whether you received message BNH16I,
The name of the task that issued the message. which means the task has reached its storage limit.
command If so, notify your system programmer.
SWITCH or synonym you defined.
System programmer response
System action See the IBM Z NetView Troubleshooting Guide for
No change occurs to the active data set. possible causes of the storage shortage.

CNM488I task: SEQ LOG DATA SET ddname CNM490I NO ACTION TAKEN ON ASSIGN
FAILED TO OPEN - PROCESSING COMMAND: SEC LIST NOT FOUND
FAILS
Explanation
Explanation You entered the keyword DELETE with the keyword
The data set identified by ddname failed to open. SEC, but a SEC list was not found in the assignment.
Message Variables
System action
task
The name of the task that issued the message. Processing for the ASSIGN command stops.
ddname
The name of the data set that failed to open. Operator response
Check the syntax of the command and enter it again.
System action
CNM491I ALL OPERATORS DELETED FROM
The sequential log task is ended. listname LIST: ASSIGNMENT
DROPPED
Operator response
Notify the system programmer.
Explanation
All operators assigned to the listname list have been
System programmer response deleted, therefore the message or group ID that was
assigned has been dropped.
See the accompanying operating system message that
gives more information about the problem. Message Variables
listname
CNM489I task locid: SEQ LOG STORAGE
PRI, COPY, or OP.
REQUEST FAILED - PROCESSING
FAILS CNM492I OPERATOR ID CONSOLE ID
CONSOLE NAME operatorid console
Explanation auto consolename END DISPLAY

Insufficient storage space is available to perform the


sequential log initialization.
Explanation
Message Variables Each insert line in the display of this message
represents an MVS console that was obtained by a
NetView task, or an MVS console that is associated

Chapter 5. CNM Prefix Messages 543


with a NetView autotask. MVS consoles obtained event was passed by the TECROUTE or TRAPROUT
using the MVS command or GETCONID command recording filter of the hardware monitor.
are used to enter MVS commands from the NetView
Message Variables
program. Consoles associated with an autotask by the
AUTOTASK command allow NetView commands to be member
issued from MVS. The name of the member that contains the
automation statement.
Message Variables
seqnum
operatorid The 8-character sequence number field of the first
The name of the NetView task that obtained the record of the automation statement that generated
console or the NetView autotask that is associated this command.
with an MVS console.
Note: If this message is displayed for a statement
console
that was added without sequence numbers, then
This variable contains one of the following:
seqnum will be the line number where the
• The word EXTENDED to indicate that the statement was found in the automation table
assigned or associated console is an EMCS member. The number will be in the format
console #nnnnnnn.
• The word INACTIVE to indicate that the assigned labgrp
or associated EMCS console is not available One of the following values:
• The word UNKNOWN to indicate that the EMCS 1. The LABEL, ENDLABEL or GROUP name
console has never been active in the MVS system specified on the statement. If none was
or sysplex. specified, then:
auto 2. (AUTOMATED MSU) if an MSU was automated
If the console ID is associated with an autotask, an rather than a message with readable text, or:
asterisk (*) appears in this variable. Otherwise, the
3. The message ID of the automated message
variable is blank.
following MSGID= , or:
consolename
4. (NO MSGID) if none of the previous values
The MVS console name.
apply.

System action commandtext


The command text, with variable substitution
Processing continues. done, that was produced by the EXEC action of the
indicated NetView automation statement.
CNM493I member : seqnum : labgrp :
commandtext
System action
Explanation This message is written to the network log under
the task where the NetView automation processing is
This message logs the entry of a command to
taking place.
the NetView program from NetView's automation
processing. The member of the NetView automation
statement that generated the command is shown System programmer response
in the message. This is followed by the seqnum The message is written to the network log for your
and labgrp of the automation table statement and information in verifying that your NetView automation
the command generated by the EXEC action of that statements are producing the expected results.
statement with variable values completely substituted.
CNM494E AUTOMATION STATEMENT SPANS
Note:
TOO MANY RECORDS
1. The domain ID of the CNM493I message indicates
the origin of the message or the MSU that was Explanation
being automated.
2. If the command string begins with TECROUTE, The automation statement in error spans too many
the command was forwarded to the hardware records. Do one of the following:
monitor and queued for execution if the associated • Rewrite your automation statement so that it uses
fewer records.

544 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• Separate your automation statement into two Explanation
separate automation statements.
The length of the variable name exceeds the maximum
length valid.
System action
Message Variables
The command processing continues with the next
automation statement. The automation table will not variable
be loaded. The variable name that is not valid

Operator response System action


Notify the system programmer that there are errors in The command processing continues with the next
the statements in the specified NetView automation automation statement. The automation table will not
member. be loaded.

System programmer response Operator response


Correct the automation statement in error and enter Notify the system programmer that there are errors in
the command again. the statements in the specified NetView automation
member.
CNM495E NUMBER OF CONDITIONAL
FUNCTIONS EXCEEDS THE LIMIT
System programmer response
Explanation Correct the automation statement in error and enter
the command again.
The conditional part of the automation statement in
error contains a number of Boolean functions that are CNM497E NUMBER OF VARIABLES USED
too complicated to evaluate. IN CONDITIONAL EXCEEDS THE
MAXIMUM
System action
Explanation
The command processing continues with the next
automation statement. The automation table will not The total number of variable names used in the
be loaded. conditions of an IF-THEN automation statement
exceeds the maximum allowed.
Operator response
System action
Notify the system programmer that there are errors in
the statements in the specified NetView automation The command processing continues with the next
member. automation statement. The automation table will not
be loaded.
System programmer response
Operator response
Correct the automation statement in error by doing
one of the following: Notify the system programmer that there are errors in
the statements in the specified NetView automation
• Simplify the conditional part of the statement to member.
avoid the excessive number of functions expressed.
• If using the OR Boolean operator, separate the System programmer response
statement into two separate automation statements
with the same action list. Correct the automation statement in error and enter
the command again.
Enter the command again.
CNM498E INDICATOR VALUE SPECIFIED IN
CNM496E VARIABLE NAME "variable" IS NETLOG ACTION IS INVALID
TOO LONG

Chapter 5. CNM Prefix Messages 545


Explanation Explanation
The status monitor indicator value specified in the The keyword1 keyword of the AUTOCNT, AUTOTBL, or
NETLOG action in a NetView automation statement is AUTOTEST command can be specified only with the
not 1, 2, 3, or 4. keyword2 keyword.
Message Variables
System action
keyword1
The command processing continues with the next The keyword that was specified
automation statement. The automation table will not keyword2
be loaded. The keyword that must be specified with keyword1

Operator response System action


Notify the system programmer that there are errors in The command processing ends.
the statements in the specified NetView automation
member.
Operator response
System programmer response Enter the command again with proper syntax. For
specific information on the command syntax, see the
Correct the automation statement in error and enter online help.
the command again.
CNM501I TEST OF NETVIEW AUTOMATION
CNM499E ROUTE LIST VALUE SPECIFIED IN FILE "member" WAS SUCCESSFUL
NETLOG ACTION IS INVALID

Explanation
Explanation
A test of a NetView automation member has
A value specified in the route list in the NETLOG action completed successfully.
of a NetView automation statement is not a valid
operator ID (defined in DSIOPF) not a valid group ID Message Variables
(assigned with the ASSIGN command), or not an *. member
The name of the automation member.
System action
CNM502E AUTOMATION STATEMENT DOES
The command processing continues with the next NOT BEGIN WITH VALID
automation statement. If the message occurs because KEYWORD
an operator ID is not currently defined, the automation
table will be loaded. If the message occurs for any Explanation
other reason, the automation table will not be loaded.
Each automation statement must begin with a valid
keyword or be a valid INCLUDE card. For AUTOTBL,
Operator response
these keywords include IF, ALWAYS, END, and SYN.
Notify the system programmer that there are errors in For the REVISE or REVISMSG command, entries must
the statements in the specified NetView automation begin with UPON.
member.
System action
System programmer response
The command processing continues syntax checking.
If this error prevented the automation table from The automation table will not be loaded.
loading, or the operator ID was in error, correct the
NETLOG action and issue the command again. If Operator response
the operator ID is not yet defined to the NetView
program, update DSIOPF, and issue the REFRESH Notify the system programmer that there are errors in
OPERS command. the statements in the specified NetView automation
member.
CNM500E keyword1 KEYWORD CAN ONLY
BE SPECIFIED WITH keyword2
KEYWORD

546 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Operator response
Correct the automation statement in error and enter Notify the system programmer that there are errors in
the command again. the statements in the specified NetView automation
member.
CNM503E INVALID SYMBOL 'symbol'
SPECIFIED IN CONDITIONAL
System programmer response
Explanation Correct the automation statement in error and enter
the command again.
A non-alphanumeric symbol was detected in the
conditional. This symbol is not valid in an automation CNM505E INVALID FUNCTION NAME
statement. "function" SPECIFIED IN
CONDITIONAL
Message Variables
symbol Explanation
The symbol that is not valid
A function name that is not valid was specified in the
automation statement.
System action
Message Variables
The command processing continues with the next
automation statement. The automation table will not function
be loaded. The function name that is not valid

Operator response System action


Notify the system programmer that there are errors in The command processing continues with the next
the statements in the specified NetView automation automation statement. The automation table will not
member. be loaded.

System programmer response Operator response


Correct the automation statement in error and enter Notify the system programmer that there are errors in
the command again. the statements in the specified NetView automation
member.
CNM504E INVALID CHARACTER STRING
'string' FOUND IN CONDITIONAL
System programmer response
Explanation Correct the automation statement in error and enter
the command again.
The indicated character string was found inside a
conditional. It is possible that you forgot to specify CNM506E INVALID VALUE 'value' SPECIFIED
a Boolean operator, or you incorrectly typed a FOR "function" FUNCTION
parenthesis.
Message Variables Explanation
string A value that is not valid was specified as a parameter
The character string in error for the named function.
Note: If the function is LABEL, ENDLABEL, or GROUP,
System action the value might be multiply defined or not paired
properly. See the IBM Z NetView Automation Guide
The command processing continues with the next
for information on syntax rules for the IF-THEN
automation statement. The automation table will not
statement.
be loaded.
Message Variables
value
The value that is not valid

Chapter 5. CNM Prefix Messages 547


function Explanation
The function for which the value was specified
A non-alphanumeric symbol was detected as a
parameter of the named function in the conditional.
System action This symbol is not valid in an automation statement.
The command processing continues with the next Message Variables
automation statement. The automation table will not
be loaded. symbol
The symbol that is not valid
Operator response function
The function named in the conditional
Notify the system programmer that there are errors in
the statements in the specified NetView automation
member.
System action
The command processing continues with the next
System programmer response automation statement. The automation table will not
be loaded.
Correct the automation statement in error and enter
the command again.
Operator response
CNM507E PARAMETER VALUE 'value'
Notify the system programmer that there are errors in
SPECIFIED FOR "function"
the statements in the specified NetView automation
FUNCTION IS INVALID
member.

Explanation System programmer response


The value specified as a parameter for the named
Correct the automation statement in error and enter
function is not valid.
the command again.
Message Variables
CNM509E THE COMPARISON OPERATOR
value FOLLOWING "function" FUNCTION
The value specified SPECIFICATION IS NOT VALID
function
The function for which the number was specified Explanation
Each function name must be followed by one of the
System action valid comparison operators for the specified function:
The command processing continues with the next =
automation statement. The automation table will not Equal
be loaded.
¬=
Not equal
Operator response <
Notify the system programmer that there are errors in Less than
the statements in the specified NetView automation <=
member. Less than or equal
=<
System programmer response Equal to or less than
Correct the automation statement in error and enter >
the command again. Greater than
CNM508E INVALID SYMBOL 'symbol' >=
SPECIFIED AS PARAMETER OF Greater than or equal
"function" FUNCTION =>
Equal to or greater than
Note: Not all operators are valid for every function.

548 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables Explanation
function The named function had more parameters specified
The function name than required for that function.
Message Variables
System action
function
The command processing continues with the next The function name
automation statement. The automation table will not
be loaded.
System action
Operator response The command processing continues with the next
automation statement. The automation table will not
Notify the system programmer that there are errors in be loaded.
the statements in the specified NetView automation
member.
Operator response
System programmer response Notify the system programmer that there are errors in
the statements in the specified NetView automation
Correct the automation statement in error and enter member.
the command again.
CNM510E QUOTES MUST BE SPECIFIED FOR System programmer response
VALUE OF "function" FUNCTION
Correct the automation statement in error and enter
the command again.
Explanation
CNM512E NO PARAMETER VALUE
The value specified for the named function did not SPECIFIED FOR "function"
begin or end with quotation marks. A valid string (such FUNCTION
as a bit string) is required for this function.
Message Variables Explanation
function A null value was specified as a parameter of the
The function or parameter name named function. If the default is desired, do not
specify the parentheses after the function name.
System action Message Variables
The command processing continues. If this message is function
issued as a result of an automation table statement, The function name
the automation table is not loaded. If this message is
issued as a result of a command being executed, the
command does not perform its intended function. System action
The command processing continues with the next
Operator response automation statement. The automation table will not
be loaded.
If this message is issued as a result of an automation
table statement, notify the system programmer that
there are errors in the statements in the specified Operator response
NetView automation member. Otherwise, correct the Notify the system programmer that there are errors in
command and try again. the statements in the specified NetView automation
member.
System programmer response
Correct the error and enter the command again. System programmer response
CNM511E TOO MANY PARAMETERS Correct the automation statement in error and enter
SPECIFIED FOR "function" the command again.
FUNCTION CNM513E INVALID SYMBOL 'symbol'
FOLLOWING "function" FUNCTION

Chapter 5. CNM Prefix Messages 549


Explanation Operator response
For an automation table, a nonalphanumeric symbol Notify the system programmer that there are errors in
was detected following the named function in the the statements in the specified NetView automation
conditional. This symbol is not valid in an automation member.
statement. For other commands, this message more
generally indicates a string which is not valid following System programmer response
another string. The two strings may not be adjacent.
Correct the automation statement in error and enter
Message Variables
the command again.
symbol
CNM515E NO VALUE SPECIFIED FOR
The symbol that is not valid
"function" FUNCTION
function
The function name
Explanation
System action No compare value was specified for the named
function. A valid parse template or bit string must be
The command processing continues with the next specified following the '=' or '¬='.
automation statement. The table will not be loaded.
Alternatively, the value is an indication of "no value",
such as "/NONE" being specified for TSONAME or
Operator response UNIXNAME prior to a TSO or UNIX command being
Notify the system programmer that there are errors in issued. A valid value must be specified for TSONAME
the statements in the specified NetView automation or UNIXNAME before issuing a TSO or UNIX command.
member. Message Variables
function
System programmer response The function name
Correct the automation statement in error and enter
the command again. System action
CNM514E INVALID SYMBOL 'symbol' USED If you are using the ASSIGN, AUTOTBL, or AUTOTEST
IN PARSE TEMPLATE OF "function" commands, the command processing continues with
FUNCTION the next automation statement. The automation table
will not be loaded.
Explanation If you are using the TSO or UNIX PIPE stages, these
A non-alphanumeric symbol or a variable name stages end.
beginning with a numeric character was detected
while processing a parse template. This symbol or Operator response
variable is not valid in a parse template.
If you are using the ASSIGN, AUTOTBL, or AUTOTEST
Message Variables commands, notify the system programmer that there
symbol are errors in the statements in the specified NetView
The symbol that is not valid automation member.

function If you are using the TSO or UNIX PIPE stages, specify a
The function name valid TSONAME or UNIXNAME.

System action System programmer response


The command processing continues with the next Correct the automation statement in error and enter
automation statement. The automation table will not the command again, or select a value for the function.
be loaded.
CNM516E VALUE SPECIFIED FOR "name"
type IS TOO LONG IN ddname
MEMBER member_name

550 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
The value specified exceeds the maximum length A bit string character that is not valid was specified. Bit
allowed. string characters can only be 0, 1, or X.
Message Variables Message Variables
name character
The name of the function, action, or keyword that The character in error
is in error. function
type The function name in error
Can be one of the following:
• FUNCTION - a function in an automation table System action
• ACTION - an action in an automation table The command processing continues with the next
• KEYWORD - a keyword in the CNMSTYLE automation statement. The automation table will not
member or other DSIPARM member where be loaded.
keyword=value pairs are allowed
ddname Operator response
The DD name where the specified member resides. Notify the system programmer that there are errors in
member_name the statements in the specified NetView automation
The name of the data set member in which the member.
error occurred.
System programmer response
System action Correct the automation statement in error and enter
• If the error is in an automation table, command the command again.
processing continues with the next automation
CNM518E AN INVALID NULL QUOTED
statement. The automation table is not loaded.
STRING WAS SPECIFIED FOR
• If the error is in another type of member, this "name" type
message may be followed by a subsequent message
containing the value in error. If the error occurs
during NetView initialization, the NetView program
Explanation
continues to initialize. A null quoted string that is not valid was specified for a
function or keyword.
Operator response Message Variables
Notify the system programmer that there are errors in name
the statements of the specified member. If the error The name of the function or keyword
occurs in the CxxSTYLE member or another member
type
read during NetView initialization, look for another
Can be one of the following:
message issued to the system console or network log
that contains the value in error. • FUNCTION - a function in an automation table
• KEYWORD - an action keyword in an automation
System programmer response table
Correct the statement in error. If the error was
issued for an automation table statement, reenter the Operator response
automation table command. If the error was found Notify the system programmer that there are errors in
during NetView initialization, restart NetView or use the statements in the specified NetView automation
the RESTYLE command, if applicable, to use the member.
corrected statement.
CNM517E INVALID BIT STRING CHARACTER System programmer response
'character' SPECIFIED FOR
"function" FUNCTION Correct the automation statement in error and reenter
the command.

Chapter 5. CNM Prefix Messages 551


CNM519E CONDITIONAL CONTAINS MORE action
LEFT PARENTHESES THAN RIGHT The name of the action that is not valid
PARENTHESES
System action
Explanation The command processing continues with the next
A case of unbalanced parentheses was detected for automation statement. The automation table will not
the conditional. be loaded.

System action Operator response


The command processing continues with the next Notify the system programmer that there are errors in
automation statement. The automation table will not the statements in the specified NetView automation
be loaded. member.

Operator response System programmer response


Notify the system programmer that there are errors in Correct the automation statement in error and enter
the statements in the specified NetView automation the command again.
member.
CNM522E PARAMETER SPECIFIED FOR
"action" ACTION IS INVALID
System programmer response
Correct the automation statement in error and enter Explanation
the command again.
An incorrect parameter was specified for the named
CNM520E CONDITIONAL CONTAINS MORE action. It is possible that:
RIGHT PARENTHESES THAN LEFT
• There were no parameters specified for the
PARENTHESES
requested action. If the default value was requested
for the named action, do not include that action in
Explanation the action list.
A case of unbalanced parentheses was detected for • The parameter was not correctly enclosed in
the conditional. parentheses.
Message Variables
System action action
The command processing continues with the next The name of the action that is not valid
automation statement. The automation table will not
be loaded. System action
The command processing continues with the next
Operator response automation statement. The automation table will not
Notify the system programmer that there are errors in be loaded.
the statements in the specified NetView automation
member. Operator response
Notify the system programmer that there are errors in
System programmer response the statements in the specified NetView automation
Correct the automation statement in error and enter member.
the command again.
CNM521E INVALID ACTION NAME "action" System programmer response
Correct the automation statement in error and enter
Explanation the command again.

The action name specified is not a valid action. CNM523E NO VALUE SPECIFIED FOR
PARAMETER OF "action" ACTION
Message Variables

552 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation CNM525E NO VALUE SPECIFIED FOR
"keyword" KEYWORD OF EXEC
No value was found within the parentheses for the ACTION
parameter of the named action. If the default value is
requested for a particular action, do not include that
action in the action list. Explanation
Message Variables A null value was specified for the named keyword. If it
was the CMD keyword, you must specify something to
action execute. If it was the ROUTE keyword and you wanted
The action name the default route situation, do not include the ROUTE
keyword for the EXEC action.
System action Message Variables
The command processing continues with the next keyword
automation statement. The automation table will not The keyword name
be loaded.

System action
Operator response
The command processing continues with the next
Notify the system programmer that there are errors in automation statement. The automation table will not
the statements in the specified NetView automation be loaded.
member.

Operator response
System programmer response
Notify the system programmer that there are errors in
Correct the automation statement in error and enter the statements in the specified NetView automation
the command again. member.
CNM524E INVALID SYMBOL 'symbol'
SPECIFIED IN ACTION LIST System programmer response
Correct the automation statement in error and enter
Explanation the command again.
A nonalphanumeric symbol was detected in the CNM526E PARAMETER VALUE SPECIFIED
action list. This symbol is not valid in an automation FOR "action" ACTION IS NOT
statement. VALID
Message Variables
symbol Explanation
The symbol in error The parameter for the specified action is not valid.
Valid parameters are as follows:
System action Action
The command processing continues with the next Parameter value
automation statement. The automation table will not CONTINUE
be loaded. YES, Y, NO, N, STOP, or S
AUTOMATED
Operator response YES, Y, NO, N, IGNORE, or I
Notify the system programmer that there are errors in TRACE
the statements in the specified NetView automation 1-16 character quoted string without blanks
member. any other action
YES, Y, NO, N
System programmer response Note: All parameters must be uppercase.
Correct the automation statement in error and enter Message Variables
the command again.
action
The action name in error

Chapter 5. CNM Prefix Messages 553


System action System action
The command processing continues with the next The command processing continues with the next
automation statement. The automation table will not automation statement. The automation table will not
be loaded. be loaded.

Operator response Operator response


Notify the system programmer that there are errors in Notify the system programmer that there are errors in
the statements in the specified NetView automation the statements in the specified NetView automation
member. member.

System programmer response System programmer response


Correct the automation statement in error and enter Correct the automation statement in error and enter
the command again. the command again.
CNM527E INVALID KEYWORD "keyword" CNM529E COMMAND OR COMMAND LIST
SPECIFIED IN EXEC ACTION NAME SPECIFIED FOR "CMD" IS
NOT A LITERAL
Explanation
Explanation
An incorrect keyword was specified for the EXEC
action. The command or command list named for all instances
of the EXEC action is not a literal.
Message Variables
keyword System action
The keyword in error
The command processing continues with the next
automation statement. The automation table will not
System action
be loaded.
The command processing continues with the next
automation statement. The automation table will not Operator response
be loaded.
Notify the system programmer that there are errors in
the statements in the specified NetView automation
Operator response
member.
Notify the system programmer that there are errors in
the statements in the specified NetView automation System programmer response
member.
Correct the automation statement in error and enter
the command again.
System programmer response
Correct the automation statement in error and enter CNM530E "keyword" KEYWORD SPECIFIED
the command again. MORE THAN ONCE IN EXEC
ACTION
CNM528E INVALID SPECIFICATION FOR
VALUE OF "keyword" KEYWORD Explanation
The CMD or ROUTE keyword can be specified only
Explanation
once in an EXEC action. Additional EXEC actions might
A value was incorrectly specified for a keyword. be required for this automation statement.
Message Variables Message Variables
keyword keyword
The named keyword The duplicated keyword

554 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Message Variables

The command processing continues with the next symbol


automation statement. The automation table will not The symbol that is not valid
be loaded. keyword
The keyword in error
Operator response
Notify the system programmer that there are errors in
System action
the statements in the specified NetView automation The command processing continues with the next
member. automation statement. The automation table will not
be loaded.
System programmer response
Correct the automation statement in error and enter
Operator response
the command again. Notify the system programmer that there are errors in
the statements in the specified NetView automation
CNM531E INVALID SYMBOL 'symbol'
member.
SPECIFIED WITHIN "action"
ACTION
System programmer response
Explanation Correct the automation statement in error and enter
the command again.
A non-alphanumeric symbol was detected in the
action specified. This symbol is not valid in an CNM533E FIRST VALUE FOR ROUTE
automation statement. KEYWORD IS INVALID
Message Variables
symbol
Explanation
The symbol in error The first value within the specification for the ROUTE
action keyword must be either ALL or ONE.
The action name
System action
System action The command processing continues with the next
The command processing continues with the next automation statement. The automation table will not
automation statement. The automation table will not be loaded.
be loaded.
Operator response
Operator response Notify the system programmer that there are errors in
Notify the system programmer that there are errors in the statements in the specified NetView automation
the statements in the specified NetView automation member.
member.
System programmer response
System programmer response Correct the automation statement in error and enter
Correct the automation statement in error and enter the command again.
the command again. CNM534E NO ROUTE VALUES WERE
CNM532E INVALID SYMBOL 'symbol' SPECIFIED AFTER "value" FOR
SPECIFIED FOR "keyword" ROUTE KEYWORD
KEYWORD OF EXEC ACTION
Explanation
Explanation There must be at least one operand specified following
A non-alphanumeric symbol was detected within the the ALL or ONE string. An operand can be an operator
named keyword specification for the EXEC action. This ID, a group name, *, or PPT.
symbol is not valid in an automation statement.

Chapter 5. CNM Prefix Messages 555


Message Variables Message Variables
value id
Either ALL or ONE The undefined operator ID that is the target of the
ROUTE or NETLOG.
System action keyword
The keyword that displays the operator ID.
The command processing continues with the next
automation statement. The automation table will not
be loaded. System action
The command continues.
Operator response
Notify the system programmer that there are errors in Operator response
the statements in the specified NetView automation Determine if the operator must be defined. If so, notify
member. the system programmer.

System programmer response System programmer response


Correct the automation statement in error and enter Determine why the operator ID is not defined. Make
the command again. the appropriate corrections and issue the command
CNM535E id ID SPECIFIED FOR ROUTE again. If NetView operators are defined in DSIOPF,
KEYWORD IS INVALID issue the REFRESH OPERS command after updating
DSIOPF. If NetView operators are defined in an SAF
product (such as RACF), add the operator definition to
Explanation the SAF product. If the problem is with an operator
While loading the NetView automation table, the group, see the NCCF LIST command (ASSIGN=GROUP
operator or group ID in the ROUTE keyword was found option).
to be not valid. CNM537E INCOMPLETE AUTOMATION
Message Variables STATEMENT SPECIFIED
id
The operator ID or group ID that is not valid Explanation
The automation statement being processed is
System action incomplete. It is possible that:
The command processing continues with the next • A semicolon was detected before the end of the
automation statement. The automation table will not automation statement was read.
be loaded. • A semicolon to indicate the end of a statement is
missing.
Operator response • An ending quotation mark is missing.
Notify the system programmer that there are errors in • Two consecutive quotation marks ('') were found in
the statements in the specified NetView automation the automation table function condition item.
member.
System action
System programmer response The command processing continues with the next
Correct the automation statement in error and enter automation statement. The automation table will not
the command again. be loaded.
CNM536W OPERATOR ID "id" SPECIFIED FOR
keyword KEYWORD IS UNKNOWN Operator response
Notify the system programmer that there are errors in
Explanation the statements in the specified NetView automation
member.
The operator ID specified on the ROUTE or NETLOG
keyword is not defined as a NetView operator.

556 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
If the statement in error contains a semicolon within The command name specified for the CMD keyword is
quotation marks, recode this statement so that the not valid. This message can be caused by:
semicolon is not the last non-blank character on the
• A syntax error specifying the CMD keyword
line. Correct the automation statement in error and
enter the command again. • Specifying a command or command list name that is
too long
CNM538I keyword SPECIFIED BUT id NOT
• Specifying a command or command list name that
ASSIGNED: ASSIGN COMMAND
does not exist
SUCCESSFUL
• Specifying a command or command list name that is
misspelled
Explanation
Message Variables
You entered one of the following keywords ADDFIRST,
ADDLAST, or REPLACE but the message ID or group command
ID was not assigned. The ASSIGN command was The name of the command that is not valid.
processed successfully.
Message Variables System action
keyword The command processing continues with the next
ADDFIRST, ADDLAST, or REPLACE. automation statement. The automation table is not
id loaded unless all of the following are true:
The message ID or group ID. • A field in the NetView constants module
(DSICTMOD) is changed to indicate that missing
CNM539E CONDITIONAL NESTING DEPTH
commands or command lists do not prevent the
HAS EXCEEDED THE LIMIT
automation table from loading successfully.
• This error is in fact caused by a missing or incorrectly
Explanation spelled command or command list name and not by
The conditional of the automation statement in error some other error.
contains nested functions that have exceeded the limit • There are no additional errors in the automation
and are too complicated to evaluate. table, and the TEST keyword was not specified on
the AUTOTBL command.
System action
The command processing continues with the next Operator response
automation statement. The automation table will not Notify the system programmer that there are errors in
be loaded. the statements in the specified NetView automation
member.
Operator response
Notify the system programmer that there are errors in System programmer response
the statements in the specified NetView automation Be sure that the command name is enclosed in single
member. quotation marks (') and that a blank is included to
separate the command name from any text that might
System programmer response follow it. Correct the automation statement in error
and enter the command again.
Restate the conditional more simply to avoid excessive
nesting. Correct the automation statement in error and CNM541I NetView subsystem ssi_name is
enter the command again. fully functional
If you are using the or Boolean operator, separate
your conditional into two automation statements with Explanation
the same action list or use the BEGIN/END sections. The NetView subsystem address space has initialized,
CNM540E INVALID COMMAND NAME thereby providing resources for Message Revision,
"command" SPECIFIED FOR CMD Command Revision, and optionally, the program-to-
KEYWORD OF EXEC ACTION program interface (PPI).

Chapter 5. CNM Prefix Messages 557


Message Variables the NetView subsystem in the IEFSSNXX member
of SYS1.PARMLIB. To activate the subsystem, you
ssi_name
can use the SETSSI system command. For more
The 4-character SSI name that is defined in the
information, see IBM Z NetView Installation: Getting
IEFSSNxx member of your SYS1.PARMLIB data
Started and IBM Z NetView Installation: Migration
set.
Guide.

System programmer response CNM544I Unable to obtain storage for


NetView subsystem table(SST)
No response is required, but you are now able to
load the Message Revision table or Command Revision
table.
Explanation
A GETMAIN command for the NetView subsystem
CNM542I Input parameters missing or
table (SST) in the MVS common service area (CSA)
invalid
failed.

Explanation System action


The input parameters passed to the NetView
The NetView subsystem initialization ends.
subsystem initialization module (CNMINIT) are
missing or not valid.
Operator response
System action Notify the system programmer.
The NetView subsystem initialization is ended.
System programmer response
Operator response Determine why CSA storage was unavailable.
Notify the system programmer. CNM545I Unable to obtain storage for cross
memory routines
System programmer response
Correct the parameters on the EXEC statement in the
Explanation
JCL. The NetView subsystem initialization module
(CNMINIT) was unable to obtain main storage in
CNM543I Unable to find NetView
the common service area (CSA) using the GETMAIN
subsystem communications table
command. The storage area was to be used as
for subsystem_name
autodata area for the cross-memory routines.

Explanation System action


During subsystem initialization, the system was unable
The NetView subsystem initialization is ended.
to locate the subsystem communications vector table
(SSCVT) with the subsystem name indicated.
Operator response
Message Variables
Notify the system programmer.
ssi_name
The 4-character subsystem name that is used in
IEFSSNxx definitions or with SETSSI commands. System programmer response
Determine why CSA storage was unavailable.
Operator response
CNM546I UNABLE TO OBTAIN STORAGE FOR
Notify the system programmer. MESSAGE AND COMMAND BUFFER
QUEUES
System programmer response
Explanation
Ensure that the first 4 characters in the name
of the NetView application job and the NetView The NetView subsystem initialization module
subsystem job are the same as the name of (CNMINIT) was unable to GETMAIN storage for the

558 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command buffer queues defined by the MSGBUF and 12
CMDBUF parameters in the EXEC statement in the JCL. GETMAIN for the vector table failed.
16
System action Logic error.
The NetView subsystem initialization is ended. 20
Load for a function routine abended.

Operator response 24
Bit setting in request flags that is not valid.
Determine whether you received message BNH16I,
28
which means the task has reached its storage limit.
Unable to process the create request (SSVT
If so, notify your system programmer.
already exists).
36
System programmer response Insufficient SSVT space for additional function
See the IBM Z NetView Troubleshooting Guide for routine addresses.
possible causes of the storage shortage.
CNM547I Unable to obtain storage for System action
IEFJSVEC and IEAVG700 calls The NetView subsystem initialization is ended.

Explanation Operator response


NetView module CNMCSSVT was unable to GETMAIN Notify the system programmer.
24-bit addressable storage necessary to call the
subsystem vector table service routine (IEFJSVEC) and
the subsystem console service routine (IEAVG700).
System programmer response
Do one of the following:
System action • For reason codes 04, 08, 16, 24, 28, and 36, contact
The NetView subsystem initialization is ended. IBM Software Support
• For reason code 12, determine why space for the
Operator response system queue area (SQA) was not available
• For reason code 20, verify that NetView modules
Determine whether you received message BNH16I, CNMCSSIC, CNMCSSIM, and CNMCSSIE are in global
which means the task has reached its storage limit. common service area (CSA) storage.
If so, notify your system programmer.
CNM549I Subsystem console services
System programmer response failure during broadcast

See the IBM Z NetView Troubleshooting Guide for


Explanation
possible causes of the storage shortage.
The subsystem console service routine (IEAVG700)
CNM548I unable to build NetView was unable to execute BROADCAST function because
subsystem vector table(SSVT) of the indicated reason code.

Explanation System action


The subsystem vector table service routine (IEFJSVEC) The NetView subsystem initialization is ended.
was unable to build the NetView subsystem vector
table (SSVT) because of the indicated system
condition code: Operator response
04 Notify the system programmer.
Identifier in IEFVTSPL or IEFJSBVT that is not
valid. System programmer response
08
Contact IBM Software Support.
Incorrect input (subsystem name was specified
incorrectly).

Chapter 5. CNM Prefix Messages 559


CNM550I Cross memory entry table System action
initialization failure
No MVS console is released.

Explanation CNM553E DSIPUSH PROCESSING FAILED.


RC = retcode
The NetView subsystem initialization module
(CNMINIT) was unable to connect the entry table to
the system linkage table index. Explanation
NetView received an error code from the DSIPUSH
System action macro while specifying the ABEND and LOGOFF
routine for a task that was obtaining an MVS console.
The NetView subsystem initialization is ended. retcode is the return code from the DSIPUSH macro.
Message Variables
Operator response
retcode
Notify the system programmer. A return code with the following definition:
04
System programmer response Storage is not available for specified request.
Contact IBM Software Support. xx
Specifies other return codes from the DSIPUSH
CNM551I NetView subsystem is already
macro
active

Explanation System action


Command processing is ended.
A NetView subsystem by the job name specified in
the START command is already active. Each NetView
subsystem has a unique 4-character name that is Operator response
defined in the IEFSSNXX member of SYS1.PARMLIB.
Try the command again later. If the problem persists,
The 4-character name must be used as the first 4
notify the system programmer.
characters of the job names used to start the NetView
subsystem and its corresponding application.
System programmer response
System action For return code 04, determine why space is not
available. For other return codes, see the DSIPUSH
The NetView subsystem initialization is ended.
macro in IBM Z NetView Programming: Assembler.

Operator response CNM554I NETVIEW SUBSYSTEM ROUTER


FOR subsystem IS ALREADY
Notify the system programmer. ACTIVE

System programmer response Explanation


If having an additional NetView subsystem active is The NetView subsystem router task for subsystem is
necessary, start another NetView subsystem with a already active.
unique 4-character name (defined in the IEFSSNXX
member of SYS1.PARMLIB). Message Variables
subsystem
CNM552I NO MVS CONSOLE ASSIGNED TO
The 4-character NetView subsystem name.
THIS OPERATOR

Explanation System action


The duplicate NetView subsystem router task is
An MVS console was not released because the
ended.
operator had no MVS console assigned.

560 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response NETVONLY which come from the MVS subsystem
interface are not processed for automation until the
Notify the system programmer. router task becomes active.
Message Variables
System programmer response
ssiname
Change the job name or the procedure (PROC) The 4-character SSI name defined in IEFSSNxx.
name, and restart the NetView program. The first 4
characters of the job name or PROC name used to
bring up the NetView address space are used as the Operator response
NetView subsystem name. You cannot start a second Start the NetView subsystem router task. If NETVONLY
NetView program with the same subsystem name. routing is required, you might also need to start the ?
CNM555I Invalid subsystem table MVSCmdRevision autotask.
(SST) found in subsystem CNM559I The NetView subsystem router for
communications vector table ssi_name is now active. NetView
(SSCVT). message automation has resumed.

Explanation Explanation
During initialization of the NetView subsystem, an The CNMCSSIR NetView subsystem router task has
SSCVT was found for this NetView subsystem name. resumed for the named subsystem. Commands,
However, the SST address obtained from this SSCVT is messages, and command revision specifying
not a valid SST for the NetView program. This might NETVONLY which come from the MVS subsystem
have been caused by using the same subsystem name interface can now be processed for automation.
to start different subsystem programs.
Message Variables
System action ssi_name
The four-character SSI name defined in IEFSSNxx.
Initialization of the NetView subsystem continues, but
a new SST is created. The pointer for the SST found in CNM562I NETVIEW NOT DEFINED AS A
the SSCVT is cleared and the storage for this control SUBSYSTEM
block (possibly in common service area (CSA) storage)
is not freed until the next system IPL. Although Explanation
initialization for the NetView subsystem continues, this
situation is probably the result of a user error and The NetView program is not defined as a subsystem in
might cause unpredictable results. the first four characters of the job name.

Operator response System action


Notify the system programmer. The processing is ended if the NetView program has
not been defined as a subsystem.
System programmer response
Operator response
If more than one subsystem was started with the
same name, change the subsystem start procedures Notify the system programmer.
so that each defined subsystem name can be used for
only one subsystem. If duplicate subsystem names did System programmer response
not cause this message to be displayed, contact IBM
Software Support. Add the first four characters of the NetView job name
to the list of subsystems in the IEFSSNXX member of
CNM558I The NetView subsystem router for SYS1.PARMLIB.
ssi_name is not active.
CNM563I NETVIEW SUBSYSTEM
PROCEDURE IS NOT ACTIVE
Explanation
The CNMCSSIR NetView subsystem router task is Explanation
not active for the named subsystem. Commands,
messages, and command revision specifying NetView subsystem procedure is not active.

Chapter 5. CNM Prefix Messages 561


System action CNM568I COMMAND KEYWORD IS MISSING
OR NOT AUTHORIZED
Some NetView functions will not work until the
procedure is started. These functions might include
the program-to-program interface (PPI), message Explanation
revision, and command revision. Authorization failed for an MVS command. The
operator did not specify a keyword, or the operator
Operator response is not authorized to use the password or password
phrase that was specified.
Start the NetView subsystem procedure.
CNM564I MVS COMMAND SYNTAX ERROR System action
OR OPERAND IS MISSING
The command does not run.
Explanation
Operator response
An MVS command was not entered properly or the text
of an MVS command was more than 126 characters in Check with your system programmer or security
length. administrator for access authorization.

System action System programmer response


The MVS command is not sent to MVS for processing. If the operator is to be allowed access to the
MVS command that was issued, update the security
definitions that are being used. If you are using
Operator response the NETCMDS class for command authorization or
Enter the command again with proper syntax. a command authorization table, you can determine
exactly security definition blocked the operator from
CNM567I NO MVS CONSOLE AVAILABLE- issuing the command by looking for the BNH237E
TRY AGAIN LATER message in the log.
CNM569I MVS CONSOLE RELEASED
Explanation
You were unable to obtain an MVS console. Explanation
The MVS console for this operator has been released.
System action This can occur as a result of a NetView command, an
If all MVS consoles are in use, the operator cannot MVS command, or an MVS condition.
issue any MVS commands until a console becomes
CNM570I STARTING AUTOMATION TASK
available.
operatorid

Operator response Explanation


Use the DISCONID command to determine which
An AUTOTASK command has started an automation
other operators have consoles assigned to them.
task named operatorid.
Determine if one of these operators can release their
console. If so, the operator can release a console using Message Variables
the RELCONID command. If no consoles are available
operatorid
to be released, notify your system programmer.
The automation task that was started.

System programmer response System action


There is an insufficient number of MVS consoles
Processing continues and the automation task starts
defined to support the number of operators issuing
logon processing.
MVS commands. You need to define more MVS
consoles or some of the operators have to release CNM571I 'value' IS NOT A VALID VALUE FOR
some consoles. keyword

562 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation • Choose a different MVS console.

You entered an AUTOTASK command with a • Use AUTOTASK OPID=operatorid,DROP to drop


CONSOLE=value and at least one of the following was the console, and then retry the original command.
true: This sequence moves the console from one
automation task to another.
• value was not a valid console name
CNM573I CONSOLE console HAS BEEN
• value was a reserved or restricted console name RELEASED FROM operatorid
Message Variables
value Explanation
The console name you attempted to assign. A console has been released as a result of an
keyword AUTOTASK command.
The keyword that was used to assign the console.
Message Variables

System action console


The MVS console name that was released.
Processing continues and the command request is not operatorid
executed. The NetView automation task for which the
console was released.
Operator response
Enter the AUTOTASK command again with a System action
valid console name. If the console name was The console is made available for other automation
a reserved or restricted console name, such as tasks.
value=INTERNAL, then specifying CONSOLE=*ANY*
might be appropriate. CNM574I CONSOLE console HAS BEEN
ASSIGNED TO operatorid
System programmer response
Explanation
Verify that the console value being used is valid for
your installation. An MVS console has been associated with an
automation task as a result of your AUTOTASK
CNM572I CONSOLE console IS IN USE BY command.
operatorid
Message Variables
Explanation console
The MVS console name that is associated with the
You entered an AUTOTASK command with a
autotask.
CONSOLE=console value where the console was
already assigned to a different NetView automation operatorid
task. The name of the autotask that processes NetView
commands entered from console.
Message Variables
console System action
The MVS console name you attempted to assign.
Processing continues.
operatorid
The NetView automation task that is using that CNM575I operatorid DOES NOT HAVE A
system console. CONSOLE ASSIGNED

System action Explanation


Processing continues and the command request is not You entered an AUTOTASK command with the DROP
executed. operand when the automation task did not have a
console currently assigned.
Operator response Message Variables
Do one of the following:

Chapter 5. CNM Prefix Messages 563


operatorid Operator response
The NetView automation task that was specified.
Notify the system programmer.

System action
System programmer response
Processing continues and the command request is not
executed. Include an AUTOTASK command in the NetView
startup procedure to define the MVS system
console access to the NetView program. The
Operator response AUTOTASK command can also be entered from
Do one of the following: an authorized NetView operator terminal. If the
console name was a reserved or restricted console
• Choose a different operator ID name, such as value=INTERNAL, then specifying
• Ignore the error, because the specified operator did CONSOLE=*INTERN* or CONSOLE=*ANY* might be
not have a console to drop. appropriate.
CNM576I ENTER "RESET" TO CANCEL CNM578E MLWTO ENDED IN ERROR
COMMAND WAIT
Explanation
Explanation The NetView program attempted to write another
You entered an AUTOTASK command with a message to a system console assigned to an
CONSOLE=nn value while the NetView subsystem automation task while a multiple line write to operator
(memory) was inactive. (MLWTO) was still being processed.

System action System action


The command waits until the subsystem starts or the Processing continues. The MLWTO processing is
RESET command is entered. stopped and the other message is processed.

Operator response Operator response


Do one of the following: Determine whether you received message BNH161I,
which means the task has reached its storage limit. If
• Wait until the NetView subsystem is active and
so, notify your system programmer.
the command completes before entering more
commands
System programmer response
• Use the RESET command to cause the AUTOTASK
command to end without processing. See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
CNM577I CONSOLE consname DOES NOT
HAVE ACCESS TO NETVIEW CNM579I AUTOMATION TASK NOT STARTED,
STORAGE NOT AVAILABLE
Explanation
Explanation
There is no AUTOTASK assigned to your console to
process the NetView command or command list. The automation task cannot be started because
of unavailable work storage space. The NetView
Message Variables
command or command list will not be processed.
consname
The console name that does not have an
System action
associated autotask.
The NetView command or command list is ignored.
System action
Operator response
The NetView command or command list is ignored.
Determine whether you received message BNH16I,
which means the task has reached its storage limit.
If so, notify your system programmer.

564 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response CNM583E INVALID SYNONYM DEFINITION
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. Explanation
CNM580I NetView subsystem address space The syntax for a SYN statement was not valid. The
is terminating format of the automation SYN statement is:

SYN %name% = 'value';


Explanation
This message is issued to report the following errors in
You issued an MVS STOP command for the NetView the SYN format:
subsystem address space.
• A required part of the SYN statement is missing
(such as a percent sign, equal sign, quotation mark
System action or synonym name)
The NetView subsystem address space will end. • A synonym name longer than 256 characters.
CNM581I NetView subsystem modify • A synonym name contains a percent sign or
command input is invalid semicolon.
• A synonym value contains a semicolon.
Explanation • Something follows the semicolon.
The input parameters are either missing or not valid on
the NetView subsystem MODIFY command. System action
The command processing continues with the next
System action automation statement. The automation table will not
The MODIFY command is rejected. be loaded.

Operator response Operator response


Verify the syntax of the MODIFY command to ensure Notify the system programmer that there are errors in
that it was entered correctly. the statements in the specified automation member.

CNM582E CONFLICTING MESSAGE/MSU


System programmer response
SPECIFICATION
Correct the automation statement in error and enter
Explanation the command again.

Conditionals and actions specific to message CNM584E [SYNONYM | VARIABLE ] 'name'


processing cannot be combined with conditionals and ALREADY DEFINED
actions specific to MSU processing in one entry. This
error can be related to specifications in a containing Explanation
BEGIN entry, as well as within the same statement.
For synonyms: The specified synonym name was
previously defined in the automation table. Synonyms
System action cannot be redefined using the same synonym name.
The command processing continues with the next For variables: The specified variable name was
automation statement. The automation table will not previously defined in this entry. You cannot assign
be loaded. the same variable name twice in the same entry.
Additionally, you cannot specify the VALUE(var)
Operator response function to use the value of a variable within the same
parse template which previously set the variable.
Notify the system programmer that there are errors in
the statements in the specified automation member. Message Variables
name
System programmer response The synonym name or variable name in error.

Correct the automation statement in error and enter


the command again.

Chapter 5. CNM Prefix Messages 565


System action Explanation
The command processing continues with the next An END statement without a corresponding BEGIN
automation statement. The automation table will not statement was encountered. This error can be caused
be loaded. by an error invalidating a previous entry containing the
matching BEGIN for this END.
Operator response
System action
Notify the system programmer that there are errors in
the statements in the specified automation member. The command processing continues with the next
automation statement. the automation table will not
System programmer response be loaded.

Correct the automation statement in error and enter


Operator response
the command again.
Notify the system programmer that there are errors in
CNM585E INVALID SYNONYM USAGE FOR the statements in the specified automation member.
'synname'

System programmer response


Explanation
Correct the BEGIN and END statements in error and
A synonym reference was not valid or an attempt was enter the command again.
made to invoke a synonym that is not defined. This
message is issued to report errors such as: CNM587E EXPECTED "END"(S) NOT FOUND
BEFORE THE END OF THE TABLE
• Attempting to substitute a synonym that was not
defined
• Attempting to substitute a synonym that had an error
Explanation
on its SYN statement For an automation table, at least one BEGIN statement
• Attempting to substitute a synonym that has a was encountered without a valid corresponding END
semicolon in its name statement. This error can be caused by either missing
END statements or one or more END statements that
• A percent sign that is not valid in an entry
are not valid. If caused by END statements that are not
Message Variables valid, there will be one or more CNM591E messages
preceding this message reporting an END that is not
synname
valid.
The synonym name in error
For a revision table, the end was encountered while
something further was expected.
System action
The command processing continues with the next System action
automation statement. The automation table will not
be loaded. The table is not loaded.

Operator response Operator response


Notify the system programmer that there are errors in Notify the system programmer that there are errors in
the statements in the specified automation member. the statements in the specified member.

System programmer response System programmer response


Correct the automation statement in error and enter Correct the table as required and enter the command
the command again. again.
If there is a previous CNM583E message invalidating CNM588E RETURN CODE retcode FROM ATF
the synonym definition, correcting the associated 'pgmname' AT filename : seqnum
synonym definition can resolve this error.
CNM586E "END" ENCOUNTERED WHICH
CANNOT BE MATCHED

566 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
A return code greater than 8 was returned in register Notify the system programmer that there are errors in
15 by pgmname. the statements in the specified member.
Message Variables
System programmer response
retcode
A return code greater than 8 Correct the %INCLUDE statement or statements in
pgmname error and enter or reenter the associated command.
The ATF program name See IBM Z NetView Programming: Assembler for
information on the DSIDKS macro.
filename
The name of the member containing the ATF CNM590E REQUIRED PARAMETER FOR
"function" FUNCTION MISSING
seqnum
The sequence number of the entry's first record
Explanation
System action You must specify a parameter for this function. This
error can be caused by such things as:
The referenced conditional is forced to FALSE and
automation processing continues. • A missing parameter specification
• A missing or misplaced left parenthesis
Operator response Message Variables
Notify the system programmer.
function
The name of the function in error
System programmer response
Determine why the ATF is returning this code and System action
correct the problem.
The command processing continues with the next
CNM589E INVALID INCLUDE CARD IN automation statement. The automation table will not
MEMBER 'member'. REASON CODE be loaded.
'reason'
Operator response
Explanation Notify the system programmer that there are errors in
A %INCLUDE statement that is not valid was specified the statements in the specified automation member.
in a member.
Message Variables System programmer response
member Correct the automation statement in error and enter
The name of the member containing the the command again.
%INCLUDE statement that is not valid. CNM591E INVALID SPECIFICATION OF
reason "keyword"
The return code from the DSIDKS macro.
Explanation
System action
There is an error in the specification of the reported
The %INCLUDE statement in error is ignored. If the keyword. This error can be caused by:
error occurred while processing an ASSIGN, AUTOTBL,
• A BEGIN or END keyword that is followed by
AUTOTEST, REVISE, or REVISMSG command,
something other than a semicolon
processing continues with the next statement, but the
table is not loaded. If it occurred while processing a • An ALWAYS keyword that is followed by something
CPTBL command, processing ends and the table is not other than an action or a BEGIN
replaced. If it occurred during initialization, no code • Something between a THEN keyword and a BEGIN
point table is loaded. keyword other than blanks
Message Variables

Chapter 5. CNM Prefix Messages 567


keyword Explanation
The name of the keyword in error
Automation is no longer active and all processes using
automation tables that were previously active have
System action ended. The storage associated with these automation
The command processing continues with the next tables is freed, and any ATFs associated with these
automation statement. The automation table will not automation tables are deleted.
be loaded. Note: STOP FORCE and RESET IMMED invocations
during ASSIGN, AUTOTBL, or AUTOTEST command
Operator response processing can cause this message to be false.
Consider the use of these commands against the PPT,
Notify the system programmer that there are errors in or any task currently processing the command, only for
the statements in the specified automation member. emergencies. These are usual clean-up actions.

System programmer response System programmer response


Correct the automation statement in error and enter This message usually indicates that regular cleanup
the command again. actions have occurred. There can be times when you
CNM592E VARIABLE "variable" NOT wait for this message to occur. For example, if an ATF
DEFINED WITHIN THE SCOPE OF must be replaced without changing its name, wait for
THIS ENTRY this message to ensure that a new ASSIGN, AUTOTBL,
or AUTOTEST invocation will load the new ATF rather
than picking up the previously loaded version.
Explanation
CNM594I NO MATCH WAS FOUND.
An error occurred because of the variable used in the LBFINDMX WAS EXCEEDED.
EXEC action of the automation table statement. This ENTER RFIND TO CONTINUE.
variable must be defined in the conditional portion of
the statement or in a prior BEGIN/END block definition
line that contains the current entry. This error can Explanation
be a result of an error in a previous entry containing No match for the specified string was found before
a BEGIN that was supposed to give a value to the the maximum number of lines was searched. This
variable specified by this message. limit was specified by the most recent DEFAULTS
Message Variables LBFINDMX command, and can be viewed by entering
LIST DEFAULTS. The log was advanced approximately
variable this number of lines.
The name of the variable in error.

Operator response
System action
If you want to continue the search from this point,
The command processing continues with the next enter RFIND (RF5 by default).
statement. The automation table will not be loaded.
CNM597I MAXIMUM ERROR COUNT
EXCEEDED
Operator response
Notify the system programmer that there are errors in Explanation
the statements in the specified automation member.
A process that involves toleration of errors it considers
to be minor has been ended because of excessive
System programmer response minor errors.
Correct the automation statement in error and enter
the command again. System action
CNM593I STORAGE AND ATFS ASSOCIATED The process ends.
WITH AUTOMATION ARE
RELEASED

568 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System action
See associated error messages and fix those problems The command processing continues with the next
or else report them to the system programmer. statement. The automation table is not loaded.

System programmer response Operator response


Fix the problems described by the associated error Notify the system programmer that there are errors in
messages. the statements in the specified automation member.
CNM598W Subsystem is not active for
ssi_name System programmer response
Remove or correct the execute-action command
Explanation indicated and enter the command again.
The named subsystem cannot process system CNM600I object status: object_status
messages or designated commands. This can be the
result of a SETSSI DEACTIVATE command, a missing Explanation
INITRTN parameter, or an inactive CNMPSSI (SSI
procedure). The NetView consolidated audit, NetView, and z/OS
log (Canzlog) has the reported status. If the status
Message Variables
is Active, CNM600I is the label line of a multiline
ssi_name message. The lines following the message provide this
The 4-character subsystem name that is used in information:
IEFSSNxx definitions or with SETSSI commands.
• The total number of messages that are captured by
the Canzlog function since the IPL.
Operator response • The approximate message rate over the last minute.
Notify the system programmer. • The date from which data is available for browsing.
• The name of the subsystem at which archiving is
System programmer response ongoing for the local LPAR that is named. If no
archiving is being done, that name is *none*.
Check the IEFSSNxx member of SYS1.PARMLIB for
the ssi_name reported. Add an INITRTN statement • The maximum possible storage size of the Canzlog
specifying DSI4LSIT. If you are migrating from an data space.
earlier version of the NetView program, consult • The current storage size of the Canzlog data space.
Installation: Migration Guide. If a SETSSI system
• The current stress level of message automation.
command deactivated the named subsystem, you can
reactivate it by starting or restarting the NetView SSI The stress level includes the following options:
procedure. If a CNM543 message is displayed, consult
– 5. Critical - message insertion is in the same plot
the help for that message.
as automation. The loss of message automation is
CNM599E COMMAND "command" INVALID imminent.
AS CMD KEYWORD OF EXEC – 4. Severe - no clear plots between insertion and
ACTION automation. This only occurs when the TINYDS or
FULLDS ceiling has been reached.
Explanation – 3. Constrained - only one clear plot between
The command you stated is not valid as an execute message insertion and message automation.
action command. Expansion is impossible as the TINYDS or FULLDS
ceiling has been reached.
Message Variables
– 2. Stressed - only one clear plot between
command message insertion and message automation.
The command that has DSIOCMD coded as the Expansion of the Canzlog data space is imminent.
MOD name in CNMCMD. – 1. Mild - message automation is behind by a
whole plot (~32,000 messages).
– 0. None - none of the above. The rate of
automating messages is as fast as message

Chapter 5. CNM Prefix Messages 569


insertion, so there is currently no danger of CNM604I SELECT 1 RESOURCE NAME FOR
missing automation of messages. THE DISPLAY COMMAND ON
• The user specified skip level and skip gap for this MENU
NetView program.
Message Variables Explanation
object With the MENU on the left side, you selected a verb
The NetView function whose status is being under Display. A resource name must be selected with
reported. At the current time, the only function the verb.
using this message is Canzlog. "Canzlog" is the
only value for the message variable at this time. System action
object_status No processing is done. You remain on the same status
Active or Inactive monitor panel on which you made your entry or
CNM601I ONE OR MORE MESSAGE entries.
INDICATORS HAVE BEEN POSTED
Operator response
Explanation Enter the command correctly.
You received a message defined as being in an CNM605I SELECT ACTIVITY AND ZERO OR
indicator class (1, 2, 3, or 4) that specifies the alarm ONE NODE ID UNDER NODE ID
sounds when messages in the class are received. COLUMN

System action Explanation


No processing is done. You remain on the same status On a status monitor detail panel, you selected an
monitor panel on which you made your entry or activity and something other than a node name. When
entries. activity is selected, you can select one node name
only.
Operator response
You might want to browse the network log to see the System action
important messages. No processing is done. You remain on the same status
CNM603I YOU SELECTED TOO MANY monitor panel on which you made your entry or
RESOURCE IDS: CHOOSE ONLY entries.
ONE
Operator response
Explanation Enter the command correctly.
You selected DISPLAY THIS NODE or DISPLAY CNM606I NOTHING SELECTED;PANEL
HIGHER NODE. Either more than one node ID under REFRESHED. ENTER "HELP
node ID columns or the higher node (on 3rd line) and STATMON SCREENS" FOR HELP
at least one node ID (under node ID column) was
selected.
Explanation
System action You pressed ENTER without making a light pen or
cursor selection.
No processing is done. You remain on the same status
monitor panel on which you made your entry or
entries. System action
The panel is refreshed. You remain on the same
Operator response status monitor panel on which you made your entry
or entries.
Enter the command correctly.
CNM607I "status" COUNT IS THE ONLY
COUNT THAT CAN BE SELECTED
WITH A COMMAND

570 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
Only the total for the detailed node IDs that are No processing is done. You remain on the same status
displayed on the panel can be selected with a monitor panel on which you made your entry or
command list or VTAM command. For example, if entries.
ACTIVE lines were selected to get to the current detail
panel, only the ACTIVE count on the summary line can Operator response
be selected.
Notify the system programmer.
Message Variables
status System programmer response
The label for the total of the detailed node IDs, for
example, ACTIVE. Remove the duplicate name from VTAMLST files.
CNM610I SELECT A COMMAND IN THE
System action COMMAND INTERFACE AREA
SHOWN TO YOUR LEFT
No processing is done. You remain on the same status
monitor panel on which you made your entry or
entries. Explanation
You selected an option for a command without
Operator response selecting the command itself.
Enter the command correctly.
System action
CNM608I ONE OR MORE RESOURCES MUST
BE SELECTED WITH DISPLAY OR No processing is done. You remain on the same status
VARY COMMAND monitor panel on which you made your entry or
entries.
Explanation CNM611I THERE IS NO SUMMARY OR
DETAIL FOR THIS LOWEST-LEVEL
You selected a VTAM VARY or DISPLAY command on
NODE
a status monitor detail panel. One or more resources
must be selected with the VTAM command chosen.
Explanation
System action You selected THIS NODE SUMMARY or THIS NODE
DETAIL from a status monitor detail panel. The
No processing is done. You remain on the same status
selected node has nothing defined below it in the
monitor panel on which you made your entry or
hierarchy. For example, an LU has nothing below it.
entries.

Operator response System action


No processing is done. You remain on the same status
Enter the command correctly.
monitor panel on which you made your entry or
CNM609I THERE IS MORE THAN ONE NODE entries.
WITH THE NAME YOU SELECTED
CNM612I TOO MANY SELECTIONS WERE
MADE
Explanation
An inconsistency occurred with duplicate node names. Explanation
This occurs only with a terminal and switched LUs.
You made too many selections on the current panel.
This code is to prevent you from displaying or varying
the wrong node. For example, if you are looking at
the never-active switched LUs, and for some reason System action
you vary one of these inactive, and there is a terminal
No processing is done. You remain on the same status
with the same name that is active, the terminal is
monitor panel on which you made your entry or
inactivated by mistake.
entries.

Chapter 5. CNM Prefix Messages 571


Operator response System action
Enter the command correctly. No processing is done. You remain on the same status
monitor panel on which you made your entry or
CNM613I PANEL REFRESHED. YOU MAY
entries.
SELECT A TOTAL, HIGHER NODE
OR MSG INDICATOR
Operator response
Explanation Enter the command correctly.
You did not make a selection and there was nothing on CNM617I NetView subsystem ssi_name
the command line when you pressed ENTER. initialized successfully

System action Explanation


No processing is done. You remain on the same status The NetView subsystem address space initialized,
monitor panel on which you made your entry or thereby providing resources for Message Revision,
entries. Command Revision, and optionally, the program-to-
program interface (PPI).
CNM614I YOU ENTERED AN INVALID VTAM
OR NETVIEW COMMAND Message Variables
ssi_name
Explanation The 4-character SSI name that is defined in the
IEFSSNxx member of your SYS1.PARMLIB data
The command you entered is not a valid NetView or
set.
VTAM command. Valid NetView commands are defined
on CMDDEF statements in CNMCMD. Also, some
NetView components support their own commands, System programmer response
such as FIND. No response is needed, but you can now load the
Message Revision Table or the Command Revision
System action Table.
No processing is done. You remain on the same panel. CNM618A NetView subsystem ssi_name has
not been initialized.
Operator response
Explanation
Enter a valid command.
The specified NetView subsystem was not initialized.
CNM615I PANEL REFRESHED. YOU MAY
The name was not found in an IEFSSNxx member
SELECT A TOTAL OR MESSAGE
during IPL, and no SETSSI ADD command was issued
INDICATOR AND ENTER
for the subsystem.
Message Variables
Explanation
ssi_name
You did not make a selection and there was nothing on
Subsystem name for which initialization failed.
the command line when you pressed ENTER.

System action System action


No automation of MVS messages is possible. Access
No processing is done. You remain on the same status
to the Canzlog log from this NetView instance is not
monitor panel on which you made your entry or
allowed.
entries.
CNM616I YOU MAY SELECT ONLY ONE CLIST System programmer response
If neither of the disabled functions is required, no
Explanation action is necessary.
On a status monitor detail panel, you selected more
If you do not require automation of MVS messages,
than one command list.
make sure that the MVSPARM.Msg.Automation

572 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


statement is set to NO in your CNMSTYLE definitions. If Explanation
you make a change to the MVSPARM statement, issue
the RESTYLE MVSPARM command for the change to You tried to make selections with the cursor or light
take effect. pen and on the command line.

To correct the problem, you can issue the MVS SETSSI


ADD command. For additional information about the System action
SETSSI command, see IBM Z NetView Installation: No processing is done. You remain on the same status
Getting Started. monitor panel on which you made your entry or
entries.
CNM619I REQUEST WAS IGNORED: THE
LEFT MARGIN OF THE LOG IS
ALREADY DISPLAYED Operator response
Either make selections or enter a command.
Explanation
CNM628I NO COMMAND, SELECTION, OR
The log is scrolled as far to the left as possible. PF KEYS ARE ALLOWED WITH A
MESSAGE INDICATOR
System action
No processing is done. You remain on the same status Explanation
monitor panel on which you made your entry or You tried to select a message indicator and a node or
entries. command.
CNM620I REQUEST WAS IGNORED: THE
RIGHT MARGIN OF THE LOG IS System action
ALREADY DISPLAYED
No processing is done. You remain on the same status
monitor panel on which you made your entry or
Explanation entries.
The log is scrolled as far to the right as possible.
Operator response
System action Either select a message indicator or select nodes or
commands.
No processing is done. You remain on the same status
monitor panel on which you made your entry or CNM630I The NetView subsystem interface
entries. is partially initialized by ssi_name.
CNM623I BROWSE TASK NOT ACTIVE
Explanation
Explanation The NetView subsystem interface that initialized
during system IPL is not able to support the program-
You requested a BROWSE SCREEN for a task that is not
to-program interface (PPI), Message Revision, or
active.
Command Revision because the procedure supporting
these functions has not been started. Message
System action automation is not affected.
The request is ignored. Message Variables
ssi_name
Operator response The 4-character SSI name defined in IEFSSNXX.
You must start both the log task and the browse
task to browse the network log. To start tasks, use System action
the START or STARTCNM command; see the NetView
online help for more information. Processing continues.

CNM626I NO SELECTIONS ARE ALLOWED


Operator response
WHEN A COMMAND IS TYPED ON
THE COMMAND LINE Notify the system programmer.

Chapter 5. CNM Prefix Messages 573


System programmer response Explanation
If the program-to-program interface (PPI), Message This message is issued when a user requests to stop
Revision, or Command Revision is needed for the SMF logging for Command Statistics function, but the
subsystem named, then the CNMPSSI process must SMF logging for Command Statistics function has not
be started. been running yet.
CNM631I NetView Program to Program
Interface is active on xxxx System action
The respective command is ignored, and the setting of
Explanation SMF recording of Command Statistics is intact.
The program-to-program interface is active and CNM681I UNABLE TO ESTABLISH
available on the NetView subsystem address space ERROR RECOVERY ENVIRONMENT
with the first four characters of the procedure or job DURING STATMON
name equal to xxxx. INITIALIZATION
Message Variables
Explanation
xxxx
The first four characters of the NetView subsystem An error was encountered while attempting to
address space procedure or job name. establish an error recovery environment for the status
monitor.
System action
System action
Processing continues.
The status monitor initialization is halted.
CNM632I NetView Program to Program
Interface is being terminated
Operator response
Explanation Notify the system programmer. Recycle the status
monitor.
The program-to-program interface ended because the
NetView subsystem address space ended.
System programmer response
System action Determine the type of error during the error recovery
environment initialization and restart the status
The program-to-program interface and NetView monitor.
subsystem address space end.
CNM682I STATUS MONITOR HAS
CNM634I YOUR REQUEST WAS IGNORED: SUSPENDED STATUS TRACKING
SMF LOGGING IS ALREADY FOR "resource" DUE TO NCP
STARTED ACTIVATION/RECOVERY (VTAM
MESSAGE msg)
Explanation
This message is issued when a user requests to start Explanation
SMF logging for Command Statistics function, but the A 10-minute timer was started during which many
SMF logging for Command Statistics function has been status monitor display commands were suppressed
running already. for this network control program (NCP) and its lower
nodes.
System action Message Variables
The respective command is ignored, and the setting of resource
SMF logging for Command Statistics is intact. The name of the network control program
CNM635I YOUR REQUEST WAS IGNORED: resource.
SMF LOGGING IS ALREADY msg
STOPPED The VTAM message.

574 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action characters. For table number 93, the entry exceeded
20 characters. No abbreviated entry was found directly
After 10 minutes, the status monitor assumes that the following the regular entry.
network control program has recovered, and normal
processing for these nodes resumes. Message Variables

CNM684I STATUS MONITOR HAS RESUMED codepoint


NORMAL STATUS TRACKING FOR The code point which requires an abbreviated
"resource" entry.

Explanation System action


The ten-minute timer for network control program If the error occurred while processing a CPTBL
(NCP) recovery has expired, and normal status monitor command, the code point table is not replaced. If it
processing resumes for the indicated network control occurred during initialization, the code point entry is
program and its lower nodes. ignored.

Message Variables
Operator response
resource
The name of the network control program Contact the system programmer.
resource.
System programmer response
CNM724I cmdlist : TIMEOUT OCCURRED
WHILE WAITING FOR TASK task Add or correct the abbreviated entry and invoke
TO TERMINATE OR RESTART CPTBL. Be sure the abbreviated entry directly follows
the regular entry whenever the regular entry's text
Explanation exceeds 25 characters (for table 92) or 20 characters
(for table 93). Syntax for code point tables is described
The command list specified did not end within the in the IBM Z NetView Customization Guide.
allotted time.
CNM726I DUPLICATE CODE POINT
Message Variables ENCOUNTERED - 'entry'
cmdlist
The name of the command list invoked. Explanation
task More than one regular entry was encountered for the
The name of the task that is ending or restarting. same code point in this table. Only one is allowed.
Message Variables
System action
entry
The specified command list ends. The entry which contains the duplicate code point.

Operator response System action


Contact the system programmer. The entry is ignored. The first entry for this code point
was processed.
System programmer response
Determine whether the timeout was because of Operator response
command list hanging or to excessive system loading. Contact the system programmer.
CNM725E ABBREVIATED ENTRY REQUIRED
FOR CODE POINT codepoint System programmer response
Eliminate or renumber one of the duplicate entries and
Explanation invoke CPTBL.
An entry for this code point was found, in table CNM727E TABLE 82 USES A TWO
number 92 or 93, whose text was within the maximum CHARACTER CODE POINT.
length, but was long enough to require an abbreviated THE FINAL TWO CHARACTERS
entry. For table number 92, the entry exceeded 25 SHOULD BE '00'

Chapter 5. CNM Prefix Messages 575


Explanation System programmer response
Code point table 82 uses a two-digit code point. The Correct the code point in error and invoke CPTBL.
final two digits must be 00. For example, the code Syntax for code point tables is described in the IBM
point 12 must be entered in the table as 1200. Z NetView Customization Guide.
CNM729E MAXIMUM LENGTH EXCEEDED
System action FOR codepoint. THE MAXIMUM
If the error occurred while processing a CPTBL LENGTH FOR THIS TABLE IS length
command, code point table 82 is not replaced. If it
occurred during initialization, the code point entries Explanation
are ignored.
The length of the text for this code point is greater than
that allowed for the table being built.
Operator response
Message Variables
Contact the system programmer.
codepoint
The code point for which the text was found to be
System programmer response too long.
Correct the code point in error and invoke CPTBL. length
Syntax for code point tables is described in the IBM The maximum length of the text allowed for the
Z NetView Customization Guide. table being built.
CNM728E TABLE NUMBER number INVALID
FOR member | embedmember System action
If the error occurred while processing a CPTBL
Explanation command, the code point table is not replaced. If it
occurred during initialization, the code point entries
The number on the control entry of the member/file
are ignored.
is not valid. Valid numbers are 92-96, 81, 82, 85 or
86. For initialization, the control entry number must
match the number implied by the member name (for Operator response
example, it must be 92 for BNJ92TBL). Contact the system programmer.
Message Variables
number System programmer response
The value specified on the control entry. Correct the code point in error and invoke CPTBL.
member Syntax for code point tables is described in the IBM
The name of the member/file being processed. Z NetView Customization Guide.
embedmember CNM731E INVALID LINE CONTINUATION
The name of an embedded member appears FOR codepoint. CONTINUED LINES
if this error occurred in a member included MUST HAVE A BLANK IN COLUMN
(%INCLUDE statement) in member. If multiple ONE AND END IN A SEMICOLON
levels of embedding occurred within member, only
the level where the error occurred is specified.
Explanation
System action A semicolon was not found at the end of the text or an
incorrect continuation line was encountered.
The code point table is not initialized or replaced.
Message Variables
Operator response codepoint
The code point with a missing semicolon or a
Contact the system programmer. continuation line.

System action
If the error occurred while processing a CPTBL
command, the code point table is not replaced. If it

576 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


occurred during initialization, the code point entries Operator response
are ignored. If a missing semicolon causes it to be
mistaken for a continuation line, this error might also Contact the system programmer.
cause the next code point in the table to be ignored.
System programmer response
Operator response Correct the code point table in error and invoke CPTBL.
Contact the system programmer. Syntax for code point tables is described in the IBM Z
NetView Customization Guide.

System programmer response CNM734E MEMBER member NOT FOUND IN


BNJPNL1
Correct the code point entry in error and invoke
CPTBL. If a semicolon was left out, enter it. If a second
line is needed, be sure it starts in column 2. Syntax Explanation
for code point tables is described in the IBM Z NetView The NetView program cannot locate the specified
Customization Guide. member or the member was empty.
CNM732E INVALID CODE POINT codepoint Message Variables
ENTERED. CODE POINTS MUST
CONSIST OF HEXADECIMAL member
CHARACTERS (0-9 OR A-F) The name of the data set member.

Explanation System action


A value found in the code point was not hexadecimal. Processing continues without the information from the
missing member.
Message Variables
codepoint Operator response
The code point that was not valid.
Contact the system programmer.

System action
System programmer response
If the error occurred while processing a CPTBL
command, the code point table is not replaced. If it Ensure the specified member is loaded and named
occurred during initialization, the code point entries correctly.
are ignored. CNM735I THE FOLLOWING ERRORS
ENCOUNTERED IN PROCESSING
Operator response MEMBER member

Contact the system programmer.


Explanation
System programmer response This is the header line for the error messages
encountered while processing a code point table.
Correct the code point entry in error and invoke
CPTBL. Be sure that the code point consists only of Message Variables
hexadecimal values. Syntax for code point tables is member
described in the IBM Z NetView Customization Guide. The name of the member with errors.
CNM733E UNEXPECTED END OF DATA
Operator response
Explanation Contact the system programmer.
End of file was encountered and no valid code point
entries were found. System programmer response
Correct the statements in error, which are described in
System action subsequent messages.
The code point table is not initialized or replaced.

Chapter 5. CNM Prefix Messages 577


CNM736I TEST OF CODE POINT MEMBER Explanation
member WAS SUCCESSFUL
The NetView program has experienced an internal
failure while processing this command.
Explanation
Message Variables
A test of a NetView code point member has
completed. All statements in the table are cmdname
syntactically correct. The name of the failing command.

Message Variables
System action
member
The name of the member specified by CPTBL. The command ends.

CNM737I TEST OF CODE POINT MEMBER


Operator response
member WAS UNSUCCESSFUL
Contact the system programmer.
Explanation
System programmer response
A test of a NetView code point member has
completed. Additional messages indicate incorrect Contact IBM Software Support.
statements.
CNM742I NO CANZLOG ARCHIVE BROWSE
Message Variables DATA SPACES CREATED
member
The name of the member specified by CPTBL. Explanation
CNM739E NUMBER OF CODE POINT The log browse task (DSILOGMT) tried to allocate
ENTRIES EXCEEDS TABLE number the number of Canzlog archive browse data
MAXIMUM spaces specified on the CNMSTYLE statement
ARCHIVE.BROWSE.DATASPACES, but was unable to
allocate any. As a result, browsing of archived
Explanation
messages is not possible. Possible causes are:
There are more than 65535 code points defined for
• The region size specified in the START job control
this table.
language (JCL) is too small.
Message Variables • Virtual storage is not sufficient.
number • You have an IEFUSI installation exit in use on your
The value specified on the control entry. system, and this exit is limiting the number of data
spaces that the NetView program can create.
System action
If the error occurred while processing a CPTBL System action
command, the code point table is not replaced. If None
it occurred during initialization, only the first 65535
entries are used.
Operator response
Operator response Notify the system programmer.

Contact the system programmer.


System programmer response
System programmer response Look for error messages issued by DSILOGMT that
indicate data space creation failures. Correct the cause
Correct the code point table and invoke CPTBL. of the failure and restart the NetView program.
CNM741E INTERNAL FAILURE CNM743I SOME MESSAGES THAT WERE
ENCOUNTERED IN PROCESSING ISSUED BEFORE THE NETVIEW
cmdname COMMAND SUBSYSTEM WAS INITIALIZED
WERE NOT LOGGED

578 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
The NetView program tried to copy the messages that The NetView program failed to release the data space
were logged in the system log (syslog) before NetView that was used to capture the IPL messages.
subsystem was initialized into the Canzlog data space.
Message Variables
Because of the large number of messages, some of the
messages might not be copied into the Canzlog data return_code
space. The return code
reason_code
System action The reason code
Processing continues.
System action
Operator response Processing continues.
Contact the system programmer.
Operator response
System programmer response Contact the system programmer.
Reduce the number of messages that are issued
before the NetView subsystem is initialized. System programmer response
CNM744E THE ALESERV TOKEN WAS Contact IBM Software Support.
NOT DELETED: RETURN CODE CNM746I THE user_module MODULE WAS
= return_code REASON CODE = NOT DELETED FROM THE SYSLOG
reason_code EXIT

Explanation Explanation
The NetView program failed to release the access list The NetView program tried to remove the specified
entry token (ALET) that was used to capture the IPL module from syslog user exit, but it failed. The
messages. NetView program uses this module to capture
Message Variables the messages that are logged before the NetView
subsystem is initialized.
return_code
The return code Message Variables
reason_code user_module
The reason code The user module (DSI4LCUI)

System action System action


Processing continues. Processing continues.

Operator response Operator response


Contact the system programmer. Contact the system programmer.

System programmer response System programmer response


Contact IBM Software Support. Contact IBM Software Support.
CNM745E THE DSPSERV TOKEN WAS CNM747I THE REQUIRED NUMBER OF
NOT DELETED: RETURN CODE PLOTS IN THE CANZLOG DATA
= return_code REASON CODE = SPACE ARE NOT AVAILABLE.
reason_code SOME MESSAGES MIGHT BE
MISSING

Chapter 5. CNM Prefix Messages 579


Explanation Notify the system programmer.

The number of plots that are required to move the IPL System programmer response:
data to the active Canzlog data space are not available. Shut down and deactivate the specified subsystem
Depending upon the shortage, some messages might and all associated instances of the NetView program.
not be logged. Apply the appropriate maintenance, and then follow
the instructions included in that maintenance for
restarting all instances of the NetView program.
System action
CNM880I parameter PARAMETER IS
Processing continues. INVALID ON command COMMAND

Operator response Explanation


Contact the system programmer. An unrecognized or unexpected parameter was
encountered on the command you entered.
System programmer response Message Variables
Increase the size of the active Canzlog data space. parameter
CNM748I THE user_module MODULE WAS The parameter that was not valid.
DELETED FROM THE SYSLOG EXIT command
The command that was entered.
Explanation
The module that is used to capture the messages that System action
are logged before the NetView subsystem is initialized The command is ignored.
was successfully removed from the syslog exit.
Message Variables Operator response
user_module Try the command again with the proper input.
The user module (DSI4LCUI)
CNM881I command COMMAND SYNTAX
ERROR
System action
Processing continues. Explanation
The command you entered did not have the proper
Operator response syntax.
None Message Variables
command
System programmer response The name of the command entered
None
CNM749A Incompatible NetView program System action
or subsystem is defined for The command is ignored.
subsystem subsystem.
Operator response
Explanation
The code for the specified subsystem is at a different Try the command again with the proper syntax.
support level from that of the NetView program issuing See the NetView online help for information on the
the message. command syntax

Message Variables CNM882I receiverid limit number

subsystem
The subsystem name of the incompatible NetView
component.
Operator response:

580 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
Used to build the multiline message display for the The Program-to-Program Interface (PPI) was invoked
display program-to-program interface receiver buffer for the specified request. The request failed with
queue limit command, DISBQL. return code rc. The request may have occurred when
attempting to start the TSO or UNIX server or when a
Message Variables
PIPE TSO or PIPE UNIX stage is used to communicate
receiverid with the TSO or UNIX server via the PPI.
The receiver ID. An asterisk (*) by this field
Message Variables
indicates that the program-to-program interface is
active. If the asterisk is not present, the receiver is request
not active. The type of request issued to the PPI. The
limit following table correlates the possible requests
The buffer limit. with the request code (DTRREQT) that was used.

number QRYPPI 1
The number of buffers on the queue.
QRYRCVR 2
CNM883I command COMMAND COMPLETE
GETCBS 3

Explanation INITRCVR 4

This message verifies that the previously entered TERMRCVR 9


command has completed. DELRCVR 10
Message Variables
SENDALRT 12
command
SENDDATA 14
The name of the command that was entered.
RECVDATA 22
CNM884I receiver RECEIVER NOT FOUND
PURGE 23
Explanation WAIT 24
The target receiver queue does not exist in the
program-to-program interface. rc
The return code from the request. If this is
Message Variables less than 1000, then this is the actual return
receiver code from the program-to-program interface (PPI).
The target receiver for the current command. Otherwise, it represents an internal error code. The
PPI return codes can be located in Appendix B
of the IBM Z NetView Application Programmer's
System action Guide.
If you issued the SETBQL command, the buffer queue
limit is not reset. If you issued the DISBQL command System action
or the DISPPI command, no receiver buffer queue
information is displayed. The command fails.

Operator response Operator response


Use the DISBQL command or DISPPI command Review the return code described above. If you cannot
to display the valid program-to-program interface determine the problem, report the failure to the IBM
receiver application names. Support Center.

CNM885E PPI ERROR OCCURRED FOR CNM901I THE RECORD FORMAT OF


FUNCTION request, RETURN CODE panelname IS INVALID: IT MUST
= rc BE 80 CHARACTERS

Chapter 5. CNM Prefix Messages 581


Explanation System programmer response
The online help facility driver can display only panels Check the panel definition for the panel currently being
that have an 80-character format. displayed. Either the panel name that corresponds to
the operator's action is typed incorrectly or the panel
Message Variables
is not in CNMPNL1.
panelname
The panel name. CNM910I 'command' REQUEST ACCEPTED

Operator response Explanation


Notify the system programmer. The specified request was accepted.
Message Variables
System programmer response command
Alter the data set or file so that the statement format is The name of a function or command.
80 characters.
Operator response
CNM902I THERE IS NO HELP PANEL FOR
THIS SCREEN If the indicated command begins with BPX1SDD, then
the UNIX System Services Set Dub Defaults request
Explanation succeeded with the indicated options. One or more
instances of the BNH284E message might have been
There is no valid HELP statement in the definition of issued. If no previous BNH284E message was issued,
the panel currently being displayed. then all the latest UNIX System Services dub defaults
functions are installed.
Operator response CNM911I INPUT IS NOT RECOGNIZED AS
There is no help panel available. If you feel one is A VALID OPTION OR AS A VALID
necessary, contact your system programmer. NETVIEW COMMAND

System programmer response Explanation


A help panel was not defined or was defined An option selection is the only type of command that
incorrectly. See the IBM Z NetView Customization is recognized by the help facility driver. A valid option
Guide for information on correctly coding a help panel consists of a single character that is defined to display
definition. a panel. If the input was not identified as a valid option
selection, the DSICES macro is issued to determine
CNM905I panelname WAS NOT FOUND whether the command line contains a valid regular
command. If the DSICES macro results in a return
Explanation code greater than 8, this message is issued.

You selected a valid option but the panel cannot be


found in the CNMPNL1 data sets.
Operator response
Message Variables If you typed an option or command that is valid from
the current panel, notify the system programmer. Be
panelname sure to note what you typed and the name of the
The panel name. current panel (displayed in the upper left corner of the
panel).
Operator response
Notify the system programmer. Be sure to note which
System programmer response
PF key or option selection resulted in this message, Check the panel definition. If an option selection was
the name of the panel from the upper left corner of the typed correctly, then it was omitted or incorrectly
panel, and the name of the panel in the message. coded in the definition of the current panel. See the
IBM Z NetView Customization Guide for information on
coding option definitions.

582 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM912I panelname CANNOT BE Explanation
DISPLAYED: IT HAS A
DEFINITION ERROR The current panel does not have a blank option
defined, therefore it is the last panel in the current
path.
Explanation
A panel format that is not valid has been detected Operator response
in the definition for the next panel to be displayed.
The panel contained comment lines only, or the Select an option or an active PF key. If the current
panel length exceeded 24 lines, or there was no text panel should have had a continuation page, note the
indicator line (***) in the panel definition, or comment panel name in the upper left corner and notify the
lines were coded in addition to the first consecutive system programmer.
lines of the panel definition, or more than one input
field was defined, or more than one cursor position System programmer response
was defined, or there were more than 49 option
Check the panel definition. See the IBM Z NetView
definition statements in the panel definition.
Customization Guide for information on coding
Message Variables continuation panels.
panelname CNM915I THE CURRENT PANEL IS THE
The panel name. BOTTOM OF THE PATH

Operator response Explanation


Notify the system programmer noting the panel named The current panel does not have a blank option
in the message. defined so it is the last panel in the current path
through the hierarchy.
System programmer response
Check panel definition for errors. See the IBM Z Operator response
NetView Customization Guide for complete information Select an option or an active function key.
on coding panel definitions.
CNM916I THE BOTTOM OF PATH CANNOT
CNM913I INTERNAL STACK IS FULL: GO BE REACHED: panelname HAS A
BACK TO A MENU AND MAKE DEFINITION ERROR
ANOTHER SELECTION
Explanation
Explanation
A panel format that is not valid has been detected
The internal stack that records your selections and the in the definition of the named panel, or the
path you took through the panel hierarchy has reached panel definition contained blank line statements that
its limit of 100 panels. resulted in an undefined continuation panel. Because
this panel was in the path for which a request for the
Operator response BOTTOM panel was requested, the last panel cannot
be reached for one of the following reasons:
Notify the system programmer, noting panel name in
upper left corner. You might continue viewing panels • The panel contained comment lines only
by going back to a previous menu and selecting a • The panel length exceeded 24 lines
different option to take another path through the • There was no text indicator line (***) in the panel
hierarchy of panels. definition
• Comment lines were coded in addition to the first
System programmer response consecutive lines of the panel definition
Shorten the path length through the panel hierarchy to • More than one input field was defined
prevent the problem from recurring. • More than one cursor position was defined
CNM914I THERE IS NO CONTINUATION • There were more than 49 option definition
PANEL statements in the panel definition.
Message Variables

Chapter 5. CNM Prefix Messages 583


panelname Explanation
The panel name.
The panel currently displayed is the first panel that
was displayed when you entered the online help
Operator response facility so it is the entry point.
Notify the system programmer noting the panel named
in the message. Operator response
Select an option or an active function key.
System programmer response
CNM920I REPEAT FIND WILL NOT WORK
Check panel definition for errors. See the IBM Z UNTIL YOU HAVE ISSUED A FIND
NetView Customization Guide for information on coding COMMAND
continuation panels.
CNM917I THE BOTTOM OF THE PATH Explanation
CANNOT BE REACHED: INTERNAL
STACK IS FULL A REPEAT command was issued before issuing a FIND
command. There is no string for which a FIND can be
repeated.
Explanation
In attempting to reach the last panel in the path, Operator response
the internal stack, which records your selections and
the path you took through the panel hierarchy, has Enter a valid FIND command, and then enter the
reached its limit. REPEAT command again.
CNM921I USE P OR N TO SPECIFY SEARCH
Operator response DIRECTION

Notify the system programmer, noting the panel name


in the upper left corner. You can continue viewing Explanation
panels by going back to a previous menu and selecting A letter other than P or N or a parameter other than
a different option to take another path through the NEXT or PREV was entered in the FIND command
hierarchy of panels, or you can advance one panel at a where search direction is to be specified.
time until the message is displayed again.

Operator response
System programmer response
Enter a valid FIND command.
Shorten the path length through the panel hierarchy to
prevent the problem from recurring. CNM922I NO TARGET WAS FOUND FOR THE
REQUESTED SEARCH ARGUMENT
CNM918I THE CURRENT PANEL IS THE
FIRST PANEL IN SELECTION
Explanation
Explanation No match for the specified string was found in the file
or in the remainder of the file.
The panel currently displayed is the first panel in the
current path. Or, the current panel was the first panel
displayed when you entered the help facility so it is Operator response
considered to be the top of the path. If using FIND or REPEAT, enter a REPEAT request to
start the search again from the beginning of the file.
Operator response Otherwise, correct the string and try again.

Select an option or an active function key. CNM923I YOUR INPUT IS INVALID: ISSUE
A FIND COMMAND OR A VALID
CNM919I THE CURRENT PANEL IS THE NETVIEW COMMAND
ENTRY POINT

Explanation
You did not enter a valid command.

584 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response CNM928I SEARCH ARGUMENT ERROR:
INVALID PARAMETER SPECIFIED
Check the spelling of the command you entered. If OR MISSING QUOTES
you think your input was valid, notify the system
programmer.
Explanation
System programmer response You entered the FIND command followed by a string
of characters with imbedded blanks but the string
If this is not a valid subcommand for this component, was not enclosed in quotation marks or you specified
such as FIND, check the definition in CNMCMD. If the the 'P', 'N', 'LLL', or 'RRR' parameter on your search
command should invoke a command list, check the argument, but you are not browsing the log.
command list definition in DSICLD.
CNM924I NO MATCH WAS FOUND - Operator response
LBFINDMX WAS EXCEEDED -
ENTER RFIND TO CONTINUE Put a single quotation mark (') before the phrase you
want to find and another quotation mark after the
phrase you want to find. If you are not browsing the
Explanation log, do not specify any parameters with the search
You moved within the log by approximately the argument.
number of records specified by LBFINDMX without CNM929I YOUR INPUT IS INVALID DUE TO
finding the specified target. For more information on NONBLANK CHARACTERS AFTER
LBFINDMX, see the help for the DEFAULTS command SECOND QUOTE
in IBM Z NetView Command Reference Volume 1 (A-N).

Explanation
Operator response
You entered the FIND command followed by a string of
Check the FIND target for correctness. To continue characters enclosed in quotation marks but there were
searching, enter RFIND (PF5 by default). non-blank characters following the second quotation
CNM926I ENTER WHAT YOU WANT TO FIND mark.
ENCLOSED IN QUOTES AFTER
"FIND" COMMAND Operator response
If your search argument contains a quotation mark,
Explanation type two single quotation marks in the search
You entered a FIND command without a search argument.
argument. CNM931I THE TOP OF DATA IS ALREADY
DISPLAYED ON THE SCREEN
Operator response
Enter the FIND command followed by a search Explanation
argument. You requested TOP or BACK, but the first line is
CNM927I ENTER "HALF", "MAX", "PAGE", already displayed.
"CSR", OR A NUMBER IN THE
SCROLL INPUT FIELD Operator response
Enter a valid command or press an active PF key.
Explanation
CNM932I THE LAST LINE IS ALREADY
The value you entered in the scroll input field did not DISPLAYED ON THE SCREEN
contain a valid value.

Explanation
Operator response
You requested BOTTOM or FORWARD, but the last line
Correct the value in the scroll input field and retry the is already displayed.
command or PF key.

Chapter 5. CNM Prefix Messages 585


Operator response CNM937I [BROWSE | STATMON] REQUEST
ALREADY IN PROGRESS
Enter a valid command or press an active PF key.
CNM933I SEARCH LIMITS ARE INVALID Explanation
You entered a browse or status monitor request and
Explanation then a message interrupted the screen. Then you
You entered a command with column search limits entered another command before the first one had
that are not correct. finished.

Operator response Operator response


Enter the command with valid column search limits. Issue a ROLL or RETURN to go back to the original
activity.
CNM934I INVALID DELIMITED STRING
ENCOUNTERED CNM938I VTAM command FAILED.
POSSIBLE DATA LOSS. RETURN
CODES FROM VTAM: R15= reg15,
Explanation R0= reg0.
You entered a delimited string that was not valid. The
problem might be in your last command, or it might be Explanation
that the current VIEW panel was specified incorrectly.
A VTAM macro failed. CNMTARCA sends this message
in four events:
Operator response
• The VTAM RCVCMD macro gave a bad return code.
If you typed a command incorrectly, please try again.
If you made a selection from a panel, that panel needs • The VTAM CHECK macro following the RCVCMD
to be corrected. macro gave a bad return code.
• The VTAM SNDCMD macro gave a bad return code.
CNM935I LOG BROWSE TASK
INITIALIZATION STARTED, • The VTAM CHECK following the SNDCMD macro gave
WAITING FOR STATUS MONITOR a bad return code.
MAIN TASK TO ACTIVATE Message Variables
command
Explanation The name of the VTAM command that failed.
Initialization for the log browse task started, but the reg15
system is waiting for the status monitor main task to Register 15 from command.
activate.
reg0
Register 0 from command.
Operator response
Start the status monitor task. System action
CNM936I SECONDARY LOG IS NOT DEFINED Processing continues. If there are five consecutive
TO LOG BROWSE TASK failures of SNDCMD or RCVCMD, the status monitor
ends.
Explanation
Operator response
There are two network logs defined but the secondary
log was not defined to the log browse task. Either Notify the system programmer.
there was an error in opening the ACB (a DSI message
might also be issued) or the DSILOG task was re- System programmer response
initialized to add a secondary log, but the log browse
task was not re-initialized. Investigate the cause of the macro failures from
the VTAM return codes. See VTAM programming
publications.
Operator response
Re-initialize the log browse task.

586 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


CNM939I PROCESSING STOPPED AFTER System programmer response
999999 RESOURCES. FURTHER
DEFINITIONS WILL BE UNKNOWN Determine the cause of the write failure (for example,
TO STATMON terminal not capable).
CNM943I LSR OPTION SPECIFIED FOR
Explanation NETLOG. BROWSE CAN NOT
ACCESS THE NETLOG.
You defined too many VTAM resources to the status
monitor.
Explanation
Operator response The log browse cannot access the NETLOG when the
NETLOG VSAM data sets are using the LSR or the DFR
Notify the system programmer. options. The NETLOG can only be used with the NSR
option.
System programmer response
Reduce the VTAM resources defined to the status System action
monitor through STATOPT=OMIT statements or use an BROWSE does not initialize and the request is ended.
alternate VTAMLST.
CNM940I TOO MANY OPERANDS. PLEASE Operator response
RETRY.
Notify the system programmer.

Explanation
System programmer response
You entered too many operands.
Determine whether the DSILOGP and the DSILOGS
VSAM data sets were correctly defined.
Operator response
CNM945I STATUS MONITOR WAS NOT ABLE
Retry with correct syntax. TO SEND MESSAGE TO STATUS
CNM941I task IS TERMINATING FOCAL POINT. RC = retcode.
RECOVERY IN PROCESS.

Explanation
Explanation
The task you specified is ending.
The status monitor cannot send a message to the
Message Variables status focal point because an MQS failure occurred.
task Message Variables
The name of the task that is ending.
retcode
CNM942I SCREEN-WRITE ERROR. BROWSE The return code issued by the DSIMQS macro
TERMINATED (hexadecimal).

Explanation System action


The view command processor failed while attempting The status monitor attempts to recover from the error.
to write a screen.
Operator response
System action
Start the CNMTAMEL task if it is not active. If the
The BROWSE function was removed from your LRC problem persists, notify the system programmer.
stack.
System programmer response
Operator response
Use the return code provided in the message to
Notify the system programmer. determine the cause of the MQS failure. See IBM Z
NetView Programming: Assembler for information on
the return code.

Chapter 5. CNM Prefix Messages 587


CNM946E STATUS MONITOR WAS NOT ABLE System action
TO FREE A CROSS TASK BUFFER.
RC = retcode. THIS BUFFER WILL The function using the specified object does not run.
BE FREED WHEN NETVIEW ENDS.
Operator response
Explanation Contact the system programmer or shorten the object
The status monitor cannot free a piece of storage it and retry the function.
received. CNM951E INSERT NUMBER insert MUST BE 1
Message Variables TO 3 CHARS LONG FOR msgid IN
TRANSLATION MEMBER member
retcode
The return code issued by the DSIFRE macro
(hexadecimal). Explanation
The message translation statement for the specified
System action message identifier in the specified translation member
contains an insert number that is not valid. The length
The buffer is not freed until the NetView program of the insert must be 1 to 3 characters.
ends.
Message Variables

Operator response insert


The insert number whose length is not valid.
Notify the system programmer.
msgid
The message identifier in the message translation
System programmer response table.
Use the return code provided to determine the cause member
of the DSIFRE macro failure. See IBM Z NetView The name of the translation member containing
Programming: Assembler for information on the return the message translations.
code.
CNM948I CINV BUFNO BFRFND BUFRDS System action
NUIW UIW ERCT The command continues syntax checking with the
message translation in the member. No message
Explanation translation table is loaded into the NetView program.
The NetView program continues to display all
This is the label line generated by the VSAMPOOL messages in English.
command. It identifies the statistics displayed by the
command.
Operator response
System action Notify the system programmer.
The VSAMPOOL command continues.
System programmer response
CNM949I obj IS TOO LONG
Correct the syntax error in the message translation
statement in the specified translation member. Reload
Explanation the member using the TRANSMSG command. See the
An object is too long for the function that uses it. NetView online help or the IBM Z NetView Installation:
Configuring Additional Components for the correct
Message Variables syntax.
obj CNM952E INSERT NUMBER insert CANNOT
The object that is too long. BE CONVERTED FROM EBCDIC
If the object is an automation table, it might TO BINARY FOR msgid IN
exceed the product environment's limit of 3000 TRANSLATION MEMBER member
characters other than comments and blanks.

588 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation member
The name of the translation member containing
The message translation statement for the specified the message translations.
message identifier in the specified translation member
contains an insert number that is not valid. The insert
number specified cannot be converted from EBCDIC to System action
binary. The command continues syntax checking with the
Message Variables message translation in the member. No message
translation table is loaded into the NetView program.
insert The NetView program continues to display all
The insert number that cannot be converted. messages in English.
msgid
The message identifier in the message translation Operator response
table.
Notify the system programmer.
member
The name of the translation member containing
the message translations. System programmer response
Correct the syntax error in the message translation
System action statement in the specified translation member. Reload
the member using the TRANSMSG command. See the
The command continues syntax checking with the
NetView online help or the IBM Z NetView Installation:
message translation in the member. No message
Configuring Additional Components for the correct
translation table is loaded into the NetView program.
syntax.
The NetView program continues to display all
messages in English. CNM954E INSERT LENGTH SPECIFICATION
MUST BE 1 OR 2 CHARS LONG FOR
Operator response msgid IN TRANSLATION MEMBER
member
Notify the system programmer.
Explanation
System programmer response
The message translation statement for the specified
Correct the syntax error in the message translation message identifier in the specified translation member
statement in the specified translation member. Reload contains an insert length that is not valid. The insert
the member using the TRANSMSG command. See the length specified must be 1 or 2 characters.
NetView online help or the IBM Z NetView Installation:
Configuring Additional Components for the correct Message Variables
syntax. msgid
The message identifier in the message translation
CNM953E INSERT NUMBER insert RANGE
table.
MUST BE 1 TO 128 FOR msgid IN
TRANSLATION MEMBER member member
The name of the translation member containing
the message translations.
Explanation
The message translation statement for the specified System action
message identifier in the specified translation member
contains an insert number that is not valid. The valid The command continues syntax checking with the
range of the insert number is 1-128. message translation in the member. No message
translation table is loaded into the NetView program.
Message Variables The NetView program continues to display all
insert messages in English.
The insert number that has a range that is not
valid. Operator response
msgid
Notify the system programmer.
The message identifier in the message translation
table.

Chapter 5. CNM Prefix Messages 589


System programmer response contains an insert length that is not valid. The valid
range of the insert length is 1-99.
Correct the syntax error in the message translation
statement in the specified translation member. Reload Message Variables
the member using the TRANSMSG command. See the msgid
NetView online help or the IBM Z NetView Installation: The message identifier in the message translation
Configuring Additional Components for the correct table.
syntax.
member
CNM955E INSERT LENGTH CANNOT BE The name of the translation member containing
CONVERTED FROM EBCDIC the message translations.
TO BINARY FOR msgid IN
TRANSLATION MEMBER member
System action
Explanation The command continues syntax checking with the
message translation in the member. No message
The message translation statement for the specified translation table is loaded into the NetView program.
message identifier in the specified translation member The NetView program continues to display all
contains an insert length that is not valid. The insert messages in English.
length cannot be converted from EBCDIC to binary.
Message Variables Operator response
msgid Notify the system programmer.
The message identifier in the message translation
table. System programmer response
member
The name of the translation member containing Correct the syntax error in the message translation
the message translations. statement in the specified translation member. Reload
the member using the TRANSMSG command. See the
NetView online help or the IBM Z NetView Installation:
System action Configuring Additional Components for the correct
The command continues syntax checking with the syntax.
message translation in the member. No message CNM957E CHARACTER character WAS
translation table is loaded into the NetView program. FOUND WHERE A DELIMITER
The NetView program continues to display all WAS EXPECTED FOR msgid IN
messages in English. TRANSLATION MEMBER member

Operator response Explanation


Notify the system programmer. The message translation statement for the specified
message identifier in the specified translation member
System programmer response contains a delimiter that is not valid. A period, asterisk,
or a blank was expected.
Correct the syntax error in the message translation
statement in the specified translation member. Reload Message Variables
the member using the TRANSMSG command. See the character
NetView online help or the IBM Z NetView Installation: The unexpected character.
Configuring Additional Components for the correct
syntax. msgid
The message identifier in the message translation
CNM956E INSERT LENGTH SPECIFICATION table.
RANGE MUST BE 1 TO 99 FOR member
msgid IN TRANSLATION MEMBER The name of the translation member containing
member the message translations.

Explanation
The message translation statement for the specified
message identifier in the specified translation member

590 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action CNM959E NO SHIFT-IN WAS FOUND FOR
A MATCHING SHIFT-OUT FOR
The command continues syntax checking with the msgid IN TRANSLATION MEMBER
message translation in the member. No message member
translation table is loaded into the NetView program.
The NetView program continues to display all
messages in English. Explanation
The message translation statement for the specified
Operator response message identifier in the specified translation member
contains a shift-out without a matching shift-in.
Notify the system programmer.
Message Variables
System programmer response msgid
The message identifier in the message translation
Correct the syntax error in the message translation
table.
statement in the specified translation member. Reload
the member using the TRANSMSG command. See the member
NetView online help or the IBM Z NetView Installation: The name of the translation member containing
Configuring Additional Components for the correct the message translations.
syntax.
CNM958E AN ODD NUMBER OF BYTES WAS
System action
FOUND BETWEEN A SHIFT-OUT/ The command continues syntax checking with the
SHIFT-IN PAIR FOR msgid IN message translation in the member. No message
TRANSLATION MEMBER member translation table is loaded into the NetView program.
The NetView program continues to display all
Explanation messages in English.

The message translation statement for the specified


message identifier in the specified translation member
Operator response
contains an odd number of bytes between a shift-out/ Notify the system programmer.
shift-in pair.
Message Variables System programmer response
msgid Correct the syntax error in the message translation
The message identifier in the message translation statement in the specified translation member. Reload
table. the member using the TRANSMSG command.
member CNM960I QSAM OPEN FAILURE.
The name of the translation member containing DDNAME=ddname
the message translations.

Explanation
System action
Open DCB failed.
The command continues syntax checking with the
message translation in the member. No message Message Variables
translation table is loaded into the NetView program. ddname
The NetView program continues to display all The DDNAME that cannot be opened.
messages in English.

System action
Operator response
The utility is ended.
Notify the system programmer.

Operator response
System programmer response
Notify the system programmer.
Correct the syntax error in the message translation
statement in the specified translation member. Reload
the member using the TRANSMSG command.

Chapter 5. CNM Prefix Messages 591


System programmer response ddname
The DDNAME.
Check the DD or FILEDEF statement that is in error.
vtamrcd
CNM961I GENCB FAILED The VTAM internal return code.
vtamfb
Explanation The VTAM internal feedback code.
An error occurred while generating an ACB or RPL.
System action
System action The utility is ended.
The utility is ended.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Use the RCFB command list to determine the meaning
of the return/feedback codes.
Contact IBM Software Support.
CNM965I COMPRESSION SUCCESSFUL -
CNM962I EXPANSION SUCCESSFUL - END
END OF JOB
OF JOB

Explanation
Explanation
The compression of a VSAM help panel was
The expansion of a VSAM help panel was successful.
successful.
CNM963I NO PANELS FOUND IN SPECIFIED
CNM966I GET FAILED DDNAME=ddname,
RANGE. reason
RC=vtamrcd,FC=vtamfb

Explanation Explanation
There are no panels in the range that you specified.
The VSAM macro GET returned and issued a return
Message Variables code and feedback code.
reason Message Variables
The reason that no panels were found.
ddname
The DDNAME.
System action vtamrcd
The error message is written to the output file The VTAM internal return code.
generated by the message print job. vtamfb
The VTAM internal feedback code.
Operator response
Enter again the panels to be printed using a valid System action
range. The utility is ended.
CNM964I PUT FAILED DDNAME=ddname,
RC=vtamrcd,FC=vtamfb Operator response
Notify the system programmer.
Explanation
The VSAM macro PUT returned the return code System programmer response
vtamrcd and the feedback code vtamfb.
Use the RCFB command list to determine the meaning
Message Variables of the return/feedback codes.
CNM967I END OF JOB - CNMCFPRT

592 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation For the print utility (CNMCFPRT), you must enter
message IDs in columns 1 to 72 of the control
CNMCFPRT has completed processing. statement. Enter as many control statements as you
CNM968I PARAMETER INVALID - IGNORED need. You can enter part of an ID followed by an
asterisk (*). The partial ID and asterisk indicate that
you want to print the help for all messages with an ID
Explanation that begins with the same characters as the partial ID.
An incorrect parameter was specified for CNMCFPRT. Enter an asterisk by itself to print the entire message
The parameter is ignored. help file. Separate each ID or range of IDs with a
comma (,). For example, AAU000-AAU999, DSI001,
CNM001-CNM1*.
System programmer response
For expand (CNMCFEXP) utility, you can enter only one
Check the parameter and correct. It must be LC=nnn, panel ID. Any information after the panel ID is treated
where nnn is the number of lines per page. as a comment.
CNM969I ERROR COMPRESSING/ The help panels for a message consist of a primary
EXPANDING HELP PANEL. reason panel and optionally, continuation panels. The ID of
the primary panel is the message ID without the suffix.
Explanation The ID of a continuation panel is the same as the ID
of the primary panel with a one letter suffix added on.
An internal error occurred while attempting to The suffixes begin with A and continue in ascending
compress or expand a help panel. alphabetical order. For the compress utility, the panel
Message Variables ID you specify must follow these rules:

reason • The ID must be from 6 to 8 characters.


The reason for the error. • Characters 1 to 3 must be letters.
• Characters 4 to 7 can be letters or numbers.
System action • The last character must be a number for a primary
The utility is ended. panel or a letter for a continuation panel.
CNM971I INPUT PANEL CONTAINS TOO
Operator response MANY LINES
Notify the system programmer.
Explanation
System programmer response The input panel contains more than 87 input lines.
Contact IBM Software Support.
System action
CNM970I CONTROL STATEMENT MISSING
OR INVALID. reason The function is ended.

Explanation Operator response


A utility control statement is missing or not valid. Notify the system programmer.

Message Variables
System programmer response
reason
The reason a control statement is missing or not Change the input panel so that it has 87 lines or less.
valid. CNM972I VSAM CLOSE
FAILURE. DDNAME=ddname,
System action RC=vtamrcd,FC=vtamfb
The utility is ended.
Explanation
Operator response The VSAM CLOSE failed.
Correct the control statement and rerun the utility. Message Variables

Chapter 5. CNM Prefix Messages 593


ddname Operator response
The DDNAME.
Notify the system programmer.
vtamrcd
The VTAM internal return code.
System programmer response
vtamfb
The VTAM internal feedback code. Correct the HLL command procedure so that it does
not attempt multitasking.
Operator response CNM982E COMMAND PROCEDURE cmdproc
Notify the system programmer. CANCELED BY OPERATOR
REQUEST

System programmer response


Explanation
Use the RCFB command list to determine the meaning
of the return/feedback codes. If this message is issued The specified high level language (HLL) command
by CNMCFCMP, then an IDCAMS VERIFY must be procedure was canceled at the request of an operator.
done against the message data set before it can be Message Variables
successfully used again.
cmdproc
CNM973I QSAM CLOSE FAILURE. The name of the HLL command procedure that was
DDNAME=ddname canceled.

Explanation System action


A close DCB failed. The command procedure is canceled.
Message Variables CNM983E offset word1 word2 word3 word4
ddname char
The DDNAME that cannot be closed.
Explanation
Operator response This message contains minidump information. It is
Notify the system programmer. displayed when a high level language (HLL) command
procedure encounters an abnormal end or logoff
condition.
System programmer response
Message Variables
Check the DD or FILEDEF statement that is in error.
offset
CNM981E COMMAND PROCEDURE cmdproc The relative offset of this line of the minidump.
ATTEMPTED UNAUTHORIZED word1
MULTITASKING The first word of the minidump.
word2
Explanation The second word of the minidump.
The specified high level language (HLL) command word3
procedure attempted multitasking but is not The third word of the minidump.
authorized to do so.
word4
Message Variables The fourth word of the minidump.
cmdproc char
The name of the HLL command procedure that The character equivalent of word1, word2, word3,
attempted multitasking. and word4.

System action System action


The multitasking request is ignored. The command The HLL command procedure ends with an abnormal
procedure is ended. end or logoff condition.

594 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Operator response
Notify the system programmer. Enter a RID END command from the operator ID
currently using RID and enter the RID command again
System programmer response from your operator ID.

Use the minidump information to correct the CNM986I RID FUNCTION 'STEP | RUN |
command procedure. CONTINUE | END' COMPLETED
FOR TASK task
CNM984E command ATTEMPTED TO WAIT
FOR MESSAGES WITHOUT ACTIVE
Explanation
TRAP
A remote interactive debug (RID) command has
Explanation completed.
Message Variables
The specified high level language (HLL) or REXX
command procedure issued a WAIT command without task
first issuing a TRAP command. The name of the task specified for the completed
RID command.
Message Variables
command
System action
The name of the HLL or REXX command procedure
that issued the WAIT command. Processing continues.
CNM987I TASK task MOD module TYPE type
System action ID id SEQ seqnum
The WAIT command is ignored.
Explanation
Operator response This message contains output from a remote
Notify the system programmer. interactive debug (RID) command.
Message Variables
System programmer response task
Correct the HLL or REXX command procedure so that it The name of the task that RID is monitoring.
issues a TRAP command before the WAIT command. module
The name of the module that RID is monitoring.
CNM985E RID ALREADY IN USE FOR TASK
task BY OPERATOR operatorid type
The type of debug point.
Explanation id
The unique identifier of the debug point.
A remote interactive debug (RID) command was
seqnum
entered while RID was already in use for the task and
The debug sequence number.
operator specified in the message.
Message Variables System action
task
Processing continues.
The name of the task that RID is currently
monitoring. CNM988I MVT mvtaddr TVB tvbaddr TIB
operatorid tibaddr TRB trbaddr R13 r13addr
The ID of the operator currently using RID to status
monitor the specified task.
Explanation
System action This message contains output from a remote
The RID command is ignored. interactive debug (RID) command.
Message Variables

Chapter 5. CNM Prefix Messages 595


mvtaddr Message Variables
Address of main vector table (MVT).
retcode
tvbaddr The nonzero return code. The return code can be:
Address of task vector block (TVB).
4
tibaddr Insufficient storage for the ISA run-time
Address of task information block (TIB). option.
trbaddr 8
Address of transaction request block (TRB). Insufficient storage for the HEAP run-time
r13addr option.
Address of register 13. 999
status Language specified not valid.
Status of the RID command (R if running; S if
stopped). System action
The command procedure ends.
System action
Processing continues. Operator response
CNM989E NO COMMAND PROCEDURE Notify the system programmer.
ACTIVE WHICH ACCEPTS QUEUED
INPUT
System programmer response
Explanation For return code 4 and 8, increase the storage available
or decrease the storage requested for the ISA or HEAP
A command or a pipe stage has been invoked run-time options. For return code 999, ensure that the
which requires a procedure able to receive queued command processor is link-edited properly.
messages. No such procedure can be found. If this
message results from a QUEUE command, then there CNM992E ERROR BUILDING LANGUAGE
is not a high level language (HLL) command procedure INDEPENDENT ENVIRONMENT -
running that accepts queued input. RC=retcode

System action Explanation


The command or pipe stage fails. An error occurred while building the language
independent environment.
Operator response Message Variables
Notify the system programmer. retcode
The return code.
System programmer response
System action
See IBM Z NetView Programming: PL/I and C or to
IBM Z NetView Programming: Pipes for information The command procedure ends.
on the command that failed. For QUEUE command
problems, review setting the HLLOPTS control block Operator response
so a command procedure can accept queued input.
Notify the system programmer.
CNM991E ERROR BUILDING LANGUAGE
DEPENDENT ENVIRONMENT -
RC=retcode System programmer response
Note the return code in the message and contact IBM
Explanation Software Support.

The command procedure that builds the language CNM994E command COMMAND MUST
dependent environment returned a nonzero return BE INVOKED FROM HLL/REXX
code. ENVIRONMENT

596 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Message Variables

The command specified in the message was entered cmdproc


from something other than a high level language (HLL) The name of the HLL or REXX command procedure
or REXX command procedure. that issued the TRAP command.

Message Variables
System action
command
The name of the command. The TRAP command is ignored.

System action Operator response


The command is ignored. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Correct the HLL or REXX command procedure so that
the TRAP command specifies MESSAGES as the event
to trap.
System programmer response
CNM998E ABEND/LOGOFF WHILE RUNNING
Remove the specified command from anything other COMMAND PROCEDURE cmdproc
than HLL or REXX command procedures. EP=entryaddr
CNM996E COMMAND PROCEDURE cmdproc
TERMINATED, ERROR IN NESTED Explanation
COMMAND
The specified high level language (HLL) command
procedure encountered an abnormal end or logoff
Explanation condition.
The specified high level language (HLL) command Message Variables
procedure ended because of an error in a nested
command. cmdproc
The name of the HLL command procedure that
Message Variables encountered the abnormal end or logoff condition.
cmdproc entryaddr
The name of the HLL command procedure that The entry point address of the command
ended. procedure.

System action System action


The command procedure ends. The HLL command procedure ends with an abnormal
end or logoff condition. This message is followed by
Operator response minidump information in message CNM983E and trace
entries in message CNM999E.
Notify the system programmer.
Operator response
System programmer response
Notify the system programmer.
Determine the cause of the error.
CNM997E MISSING EVENT TYPE System programmer response
SPECIFICATION ON TRAP
Use the minidump and trace entries to correct the
COMMAND IN cmdproc
command procedure.

Explanation CNM999E id1 val1 id2 val2 id3 val3 id4 val4

A high-level language (HLL) or REXX command


procedure issued a TRAP command that did not
specify MESSAGES as the event to trap.

Chapter 5. CNM Prefix Messages 597


Explanation System action
This message contains trace entries. It is displayed The HLL command procedure ends with an abnormal
when a high-level language (HLL) command procedure end or logoff condition.
encounters an abnormal end or logoff condition.
Message Variables Operator response
id1, id2, id3, id4 Notify the system programmer.
The first failure data capture (FFDC) trace ID
entries. System programmer response
val1, val2, val3, val4
Use the trace entries to correct the command
The FFDC trace value entries.
procedure.

598 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Chapter 6. CNMPP Prefix Messages

The CNMPP messages are directed toward system programmers running the status monitor preprocessor.
Because operators do not receive these messages, an operator response is not required.
CNMPP01I ERROR DETECTED IN PARAMETER System programmer response
LIST
Correct keyword, operand, or both.

Explanation CNMPP04I BLDL FAILED FOR member.


MEMBER MISSING
One of the parameters given is either misspelled or
not valid. See IBM Z NetView Installation: Configuring
Additional Components for syntax. Explanation
The BLDL failed for one of the following reasons:
System action • The node given was not in VTAMLST.
Execution of the preprocessor stops. Status monitor • A permanent I/O error occurred.
functions will not work.
• Insufficient virtual storage is available
• The member was found but was empty.
System programmer response
• & symbolics are not supported.
See the message that follows this one and correct the
parameter list. A description of the network structure cannot be built.
Message Variables
CNMPP02I INITIAL OPTIONS MUST BE WARM
OR COLD member
The name of the VTAMLST file that the
Explanation preprocessor was searching for. If the member
was empty, this will be blank.
The initial option for the start of the procedure must be
either warm or cold. Anything else is not valid.
System action
System action Execution of the preprocessor stops. Status monitor
functions will not work.
Execution of the preprocessor stops. Status monitor
functions will not work.
System programmer response
System programmer response Supply the specified VTAMLST file and verify that it is
not empty.
Correct the parameter list.
CNMPP05I FIND FAILED FOR member.
CNMPP03I ALLOWABLE KEYWORDS ARE: MEMBER MISSING
LIST, CONFIG, CNMCON, HOSTSA,
or HOSTPU
Explanation
Explanation The node given was not in VTAMLST, a permanent
I/O error occurred, or insufficient virtual storage is
The parameter list did not contain a valid keyword available. A description of the network structure
or you might have specified a valid keyword with an cannot be built.
operand that is not valid.
Message Variables

System action member


The name of the missing file
Execution of the preprocessor stops. Status monitor
functions will not work.

© Copyright IBM Corp. 1997, 2022 599


System action System programmer response
Execution of the preprocessor stops. Status monitor Correct the STATOPT statement. See the IBM
functions will not work. Z NetView Administration Reference for more
information.
System programmer response CNMPP09I PROCESSING MAJOR NODE node
Supply the specified VTAMLST file.
Explanation
CNMPP06I OPEN FAILED FOR member
This message is provided as a checkpoint to let you
Explanation know how far along the preprocessor is.
Message Variables
The OPEN macro was issued to determine if a file
exists in a library. The DCBOFOPN flag turned off in node
the DCB indicates the OPEN failed and the file did not The name of the node being processed.
exist.
Message Variables System action
member Processing continues.
The name of the missing file.
CNMPP10I MAJOR NODE node OMITTED BY
OMIT OPTION
System action
Execution of the preprocessor stops. Status monitor Explanation
functions do not work.
The node given in the message has the option
STATOPT=OMIT in the VTAMLST.
System programmer response
Message Variables
Define the specified file.
node
CNMPP07I PREPROCESSING COMPLETED The name of the node that was omitted.

Explanation System action


VTAMLST has been successfully read and DSINDEF Processing continues.
has been built. Status monitor will now know about
only the nodes listed in DSINDEF. CNMPP11I MAJOR NODE node OMITTED. NOT
APPLICABLE
CNMPP08I SYNTAX ERROR DETECTED IN
STATOPT STATEMENT, LINE
Explanation
line_number statement
The major node is a type that is not valid for the status
Explanation monitor. This major node will not be known to the
status monitor.
A STATOPT statement does not conform to the
Message Variables
syntax described in the IBM Z NetView Administration
Reference. node
The name of the node that is not applicable.
Message Variables
line_number
System action
The line number where an error was detected.
statement Processing continues.
The statement in error. CNMPP12I FILEDEF FAILED FOR member
MEMBER MISSING
System action
The STATOPT statement is ignored and processing
continues.

600 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
CMS FILEDEF command was issued to link the DCB No major nodes of a type applicable to the status
to the corresponding CMS file. A nonzero return code monitor were found in VTAMLST.
from CMDSI macro issued to invoke the FILEDEF
command indicates that the file did not exist. System action
Message Variables
Execution of the preprocessor stops. Status monitor
member functions will not function.
The name of the missing file.
System programmer response
System action
Examine the VTAMLST major node definitions. See
Execution of the preprocessor stops. Status monitor IBM Z NetView Installation: Configuring Additional
functions will not work. Components for more information.
CNMPP23I GROUP group OMITTED BY OMIT
System programmer response OPTION
Define the specified file.
Explanation
CNMPP13I OPEN FAILED FOR CNMNDEF.
ANALYSIS IMPOSSIBLE The group given in the message has the option
STATOPT=OMIT in the VTAMLST.
Explanation Message Variables
An I/O error has occurred causing CNMNDEF not to group
open. The name of the group that was omitted.

System action System action


Execution of the preprocessor stops. Status monitor Processing continues.
functions will not work.
CNMPP24I LIMIT REACHED - PROCESSING
STOPPED AFTER 999999
System programmer response RESOURCES
Determine why CNMNDEF did not reopen.
Explanation
CNMPP16I MINOR NODE node OMITTED BY
OMIT OPTION More than 999999 resources were defined in the
VTAMLST. Note that, because the host is included, a
Explanation total of only 999998 resources appear on the Domain
Status Summary panels. Duplicate name checking
The node given in the message has the option cannot be completed.
STATOPT=OMIT in the VTAMLST.
Message Variables System action
node When the limit is reached, the NetView program
The name of the node that was omitted. ignores any resources that have not been processed.
These resources are not included in DSINDEF.
System action
System programmer response
Processing continues.
Reduce the VTAM resources defined to the status
CNMPP17I CNMNDEF DATA SET EMPTY- monitor through STATOPT=OMIT statements or use
ANALYSIS IMPOSSIBLE another VTAMLST.
CNMPP25I * WARNING * STORAGE
UNAVAILABLE

Chapter 6. CNMPP Prefix Messages 601


Explanation System action
The total area of virtual storage requested exceeds the Processing continues.
length available. Insufficient storage can prevent the
duplicate node names from being checked or cause System programmer response
the GRAPHOPT statements to process incorrectly.
DSINDEF is created, but rerun the CNMNDEF Make note of the warning and do one of the following:
procedure with sufficient storage.
• Code a STATOPT statement to OMIT this minor node
• Remove the code in VTAMLST that defines this node
System action
• Remove the definition from DSINDEF
Processing continues.
Note: & symbolics are not supported.

Operator response For more information about duplicate node names,


see IBM Z NetView Installation: Configuring Additional
Determine whether you received message BNH16I, Components.
which means the task has reached its storage limit.
If so, notify your system programmer. CNMPP28I NODE OMITTED - MORE THAN 8
CHARACTERS FOR NODE node
System programmer response
Explanation
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage. A major node name with more than eight characters
was specified. Eight characters is the maximum for
CNMPP26I NO ILLEGAL DUPLICATE NAMES VTAMLST.
WERE FOUND
Message Variables

Explanation node
The name of the node with greater than eight
In reading through DSINDEF, no illegal duplicate node characters.
names were found.
System action
System action
Processing continues.
Processing continues.
CNMPP27I * WARNING * node1 IN MAJOR System programmer response
NODE node2 IS AN ILLEGAL
DUPLICATE NAME PREVIOUSLY Rename the node to a valid eight-character name, or
USED IN MAJOR NODE node3 delete the node name altogether.
CNMPP29I I/O ERROR READING VTAM LIST
Explanation
A minor node name must be unique to each major Explanation
node. If it is defined by two or more major nodes, then A disk I/O error occurred.
this warning message will be displayed.
Message Variables System action
node1 Execution of the preprocessor stops. The status
The minor node defined to two major nodes monitor functions will not work.
node2
The major node name for which the minor node System programmer response
was illegally defined
Correct the I/O device error and retry.
node3
The major node name for which the minor node CNMPP30I INVALID OPERAND 'operand'
was first defined SPECIFIED IN THE GRAPHOPT
STATEMENT

602 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
An incorrect operand was specified on the GRAPHOPT The resource name in the GRAPHOPT statement is
statement. more than 8 characters long.
Message Variables
System action
operand
The incorrect operand. The GRAPHOPT statement is ignored.

System action Operator response


The GRAPHOPT statement is ignored. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Specify a valid resource name on the correct
GRAPHOPT statement so that the status monitor can
provide status forwarding for the NetView program.
System programmer response
For information about the GRAPHOPT statement, see
Specify the correct GRAPHOPT statement so that the IBM Z NetView Administration Reference.
the status monitor can provide status forwarding
for the NetView program. For information about CNMPP33I GRAPHOPT STATEMENT WITH
the GRAPHOPT statement, see the IBM Z NetView NAME/TYPE OPTION MUST HAVE
Administration Reference. EXACTLY 4 OPERANDS. THE
STATEMENT IS IGNORED.
CNMPP31I TOO MANY MAJOR NODES.
MAXIMUM ALLOWED IS 2000. ALL Explanation
SUBSEQUENT MAJOR NODES ARE
IGNORED. The GRAPHOPT statement with the NAME/TYPE
option has less than or more than four operands in it.
Explanation
System action
More than 2000 major nodes are defined in your
ATCCONxx and CNMCONxx members. If a major node The GRAPHOPT statement is ignored.
is defined more than once, each definition counts
toward the maximum of 2000. Operator response
Notify the system programmer.
System action
All major nodes specified after the maximum of 2000 System programmer response
are ignored.
Specify the correct GRAPHOPT statement so that
the status monitor can provide status forwarding
Operator response
for the NetView program. For information about
Notify the system programmer. the GRAPHOPT statement, see the IBM Z NetView
Administration Reference.
System programmer response CNMPP34I INCORRECT USE OF * IN
Place important major nodes at the beginning of the RESOURCE NAME. resname1
list to ensure that they are processed. TRUNCATED TO resname2.

CNMPP32I GRAPHOPT STATEMENT SYNTAX Explanation


IS NOT VALID. RESOURCE NAME
HAS MORE THAN 8 CHARACTERS. The GRAPHOPT statement with the NAME option
THE STATEMENT IS IGNORED. cannot have an asterisk in a resource name, except
as the last character in the string.
Message Variables

Chapter 6. CNMPP Prefix Messages 603


resname1 A BLANK MUST FOLLOW THE
The resource name as it was entered. GRAPHOPT KEYWORD.
resname2
The resource name after truncation. Explanation
The GRAPHOPT keyword must be followed by at least
System action one blank.
The GRAPHOPT statement uses the truncated
resource name resname2 instead of the specified System action
resource name resname1.
The GRAPHOPT statement is ignored.

Operator response
Operator response
Notify the system programmer.
Notify the system programmer.

System programmer response


System programmer response
Specify the correct GRAPHOPT statement so that
the status monitor can provide status forwarding Specify the correct GRAPHOPT statement so that
for the NetView program. For information about the status monitor can provide status forwarding
the GRAPHOPT statement, see the IBM Z NetView for the NetView program. For information about the
Administration Reference. GRAPHOPT statement, see IBM Z NetView Installation:
Configuring Additional Components.
CNMPP35I SYNTAX OF THE GRAPHOPT
STATEMENT IS NOT VALID.

604 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Chapter 7. DSI Prefix Messages

This chapter lists the DSI prefix messages from the NetView program.
The following messages are sent to the NetView terminal operator or the authorized message receiver. If
an authorized message receiver is not defined in the system or is not logged on, the messages destined
for the authorized message receiver are sent to the system console operator.
Messages DSI900 through DSI999 (which are not included in this book) are reserved for use with user-
written command processors, installation exit routines, and subtasks (see IBM Z NetView Programming:
Assembler). Certain messages described in this section appear only on the NetView log and are intended
to help the system programmer with debugging.
DSI000I NCCF MESSAGE msgid ISSUED Message Variables
BUT DOES NOT EXIST IN target:
MESSAGE TABLE msgtable - CALL
IGNORED LOG
The network log.
Explanation SYSOP
The system operator.
The NetView program found a storage shortage, an I/O
ALL
error, or the message number specified does not exist
Indicates that the message is sent to all
in the message definition module.
active operators and autotasks in the domain,
This message is truncated when the assigned length all operators and autotasks in other domains
of the original message is less than the length of that have established a cross-domain (NNT)
message DSI000I, or if it appears in the immediate session to the domain, and the system console.
message area. operatorid
Message Variables The operator or task name.
msgid
The message number. System action
msgtable The NetView program sends the message or the
The message definition module. internal request.
DSI002I INVALID COMMAND: 'command'
System action
The NetView program ignores the message call and Explanation
continues processing.
One of the following problems occurred:

Operator response • The NetView program does not recognize the


command.
Notify the system programmer.
• The command was entered incorrectly.
• The command is incompatible with the task that is
System programmer response running.
If msgid is a user-coded message, have it added to • The command list is defined as a TYPE=B or TYPE=I
the indicated message definition module. Otherwise, command in CNMCMD.
contact IBM Software Support.
• The command has a CMDDEF statement with
DSI001I MESSAGE SENT TO target TYPE=D.
• An I/O error might be present.
Explanation Message Variables
A message or a NetView internal request was command
successfully sent to the specified destination. The name of the command that is not valid. For
command names longer than 8 characters (none

© Copyright IBM Corp. 1997, 2022 605


of which are valid), the message variable can Explanation
show up to 16 characters to assist in problem
determination. An attempt to open the DSILOG data set or file has
failed. No disk logging occurs.

System action
System action
The NetView program ignores the command.
The NetView program does not log any activity.

System programmer response


Operator response
Check the CMDDEF definition for the command. If the
command is a command list, the type must be coded Notify the system programmer.
as TYPE=R, or left to default.
DSI003I DESTINATION OPERAND MISSING
System programmer response
OR INVALID Correct the problem with the DSILOG data set.
DSI006I PERMANENT I/O ERROR ON LOG
Explanation DATA SET
For a MSG or ROUTE command, you omitted the
routing indicator or it was not taken from the list Explanation
of valid options. If this message results from a VET
command or stage, the destination virtual OST (VOST) I/O errors occurred on the network disk log. You have
cannot be found. reached the I/O error limit for logging.

System action System action


The NetView program ignores the entire command The NetView program closes the log data set and ends
entry. logging.

Operator response Operator response


Check the command syntax in the NetView online Notify the system programmer.
help. For a MSG or ROUTE command, select an
operand from the list of valid options. Enter the System programmer response
entire command again. If this message resulted from
a VET command or stage, check the specification of Correct the problem with the network disk log.
the destination in the VET command and correct as DSI007I HARDCOPY UNABLE TO ACQUIRE
appropriate. PRINTER. macro FAILED - RTNCD
DSI004I TEXT OPERAND MISSING OR = X'vtamrcd' FDBK2 = X'vtamfb'
INVALID SENSE = X'vtamsens'. HARDCOPY
STOPPED

Explanation
Explanation
You omitted the text of the command, or you did not
enter it correctly. The access method cannot allocate the device to
the NetView program (RTNCD=X'10',FDBK2=X'00')
or the NetView hardcopy task is not authorized to
System action acquire devices on the APPL statement (RTNCD=X'14',
The NetView program ignores the entire command FDBK2=X'55'). The hardcopy task stops.
entry. Message Variables
macro
Operator response The name of the failing macro.
Check the command syntax in the NetView online help vtamrcd
and enter the command again. The VTAM internal return code.
DSI005I LOG DATA SET UNAVAILABLE

606 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


vtamfb • If the object is an autotask, use the AUTOTASK
The VTAM internal feedback code. command to start the task.
vtamsens • To activate the DSIRVCEX exit, see the IBM
The VTAM internal sense code. Z NetView Installation: Configuring Additional
Components.
System action DSI010I COMMAND VERB TOO LONG
The NetView program enters a STOP command for the
hardcopy task. Explanation
You used more than eight characters for the command
Operator response verb.
Notify the system programmer to correct the
condition. Enter the START command again for the System action
hardcopy task.
The NetView program ignores the command.

System programmer response


System programmer response
Make the printer available or authorize the NetView
program to use the printer. Use the RCFB and SENSE Check the spelling of the verb and enter the command
command lists to determine the meaning of the return, again.
feedback, and sense codes. See the device specific DSI011I EXTRANEOUS INFORMATION IN
documentation for the meaning of the user sense data. OPERAND FIELD
DSI008I 'object' NOT ACTIVE
Explanation
Explanation The NetView program found information not pertinent
to the command in the operand field.
A command was entered, but the object specified
in that command is not active. Because the object
specified in the command is not active, it cannot System action
respond.
The NetView program ignores the command.
If the command entered was an MSG command to
send a message to a group name, no operator in the
Operator response
group was active to receive the message.
Correct and enter the command again.
Message Variables
DSI012W 'action1' rejected. Task taskid is
object
engaged in 'action2'
The object or resource named in the command.

System action Explanation


The task named cannot perform the function named
One of the following actions occurs:
as 'action1' because all its resources are needed for
• For the REVISE command, tables are loaded as 'action2'.
reported, but are not active or are not fully capable.
Message Variables
• For the TRACE command, the NetView program
continues to process to the next specified task. action1
The function that cannot be performed
• For all other commands, the NetView program
ignores the command. taskid
The operator or task where the functions are to be
performed.
Operator response
action2
Consider the following responses: The function that the task is already doing.
• Check the spelling of the object specified in the
command. If it is incorrect, correct it and enter the
command again.

Chapter 7. DSI Prefix Messages 607


System action Operator response
The NetView program ignores the command. If NetView initialization or logon processing is not
complete, wait for it to complete and enter the
Operator response command again. If there is more than one panel of
interrupt messages, you can enter only the following
Define a new task for the action1 function. commands:
DSI013I COMMAND LIST cmdlist • AUTOWRAP
COMPLETE • CLEAR
• ENTER
Explanation
• RETRIEVE
The command list you entered has finished.
If the command failed for other reasons, notify the
Message Variables system programmer.
cmdlist
The name of the command list. System programmer response
Check the messages that are sent to the NetView
System action system operator and take the recommended actions.
The task is ready to process the next command. DSI016I NOT IN PAUSE OR WAIT STATUS
DSI014I INVALID OPERAND
Explanation
Explanation There are two reasons for receiving this message.
First, you might have entered a GO or STACK
You entered an unrecognized operand with the
command, but the command list for which it was
command.
entered is not in the PAUSE or WAIT state. Second, you
might have entered the GO or STACK command while
System action no command list was being processed.
The NetView program ignores the command.
System action
Operator response The NetView program ignores the command.
Check for syntax errors or spelling and enter the
command again. Operator response
DSI015A COMMAND NOT PROCESSED, If a W or a P appears in the upper right corner of
REENTER the screen, the wait or pause might be occurring at
a stacked level. If this occurs, enter the UNSTACK
command and then enter the GO or STACK command
Explanation
again.
You entered a command before NetView initialization
DSI017I CLOSE COMMAND ACCEPTED
or logon processing was complete, or you entered
the AUTOTBL or AUTOTEST command while a large
number of messages were being automated. Explanation
This message is also issued when a command fails to This message confirms that the NetView program ends
be processed for other resources. Check the messages in response to a CLOSE command.
that are sent to the NetView system operator for more
information on the cause of the failure. System action
Information messages are sent to all active stations
System action
and no new logons are accepted. The job step ends
The NetView program ignores the command. The after the last logoff.
command might be retrievable. If there is more than
one panel of interrupt messages, the =X= indicator is
displayed in the response area.

608 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response hclname
The name of the hardcopy log device.
Prepare to finish your session.
DSI018A SHUTDOWN IN PROGRESS System action
The NetView program updates tables to reflect the
Explanation new operator station.
The NetView program is closing down in response to a DSI021A INVALID OPERATOR
CLOSE command. IDENTIFICATION, REENTER

System action Explanation


No new logons are accepted. The job step ends after The NetView program has rejected your logon attempt
the last logoff. because it does not recognize your operator ID.
Note: You cannot use operator IDs that begin with
Operator response the characters DSI#. This is reserved for Virtual OSTs
Prepare to finish your session. (VOSTs). Also, you cannot use the name of an existing
task as an operator ID.
DSI019I MAXIMUM NUMBER OF LOGON
RETRIES HAS BEEN EXCEEDED If the current value of OPERSEC is SAFDEF, this
message can also mean that the operator ID is not
defined to the security product. You can use the LIST
Explanation SECOPTS command to determine the operator security
The maximum number of permitted logon attempts (OPERSEC) value.
(MAXLOGON) for this operator station was exceeded.
No more logon attempts are accepted. System action
The NetView program rejects the logon.
System action
The message is sent to the operator station whose Operator response
log on attempts were rejected and to the NetView
authorized receiver. Enter the logon again with the correct operands, or
enter LOGOFF in the operator ID field.
DSI020I OPERATOR operatorid LOGGED ON
FROM TERMINAL terminal USING DSI022A INVALID PASSWORD, REENTER
PROFILE (profile), HCL (hclname)
Explanation
Explanation The NetView program has rejected your logon attempt
The specified operator started a NetView session from because you entered a password or password phrase
the named terminal using the specified profile and that is not valid for your operator ID.
hardcopy log. Blanks are displayed after PROFILE if
the current value of OPERSEC is SAFDEF. Blanks are System action
displayed after HCL if there is no hardcopy log.
The NetView program rejects the logon.
Message Variables
operatorid Operator response
The operator identifier.
Enter the logon again with the correct password or
terminal password phrase.
The terminal identifier. This variable can indicate
either a logged-on terminal or an automated OST. Note: If you are entering a mixed-case password or
The value for a logged-on terminal is the terminal password phrase, check with the System Programmer
name or LU name. The values for an automated to ensure that your system supports mixed-case
OST can be NONE, if an autotask does not have an passwords or password phrases.
assigned console, or the console name.
profile
The name of the profile statement.

Chapter 7. DSI Prefix Messages 609


System programmer response System action
The case in which the password or password The NetView program rejects the command. The
phrase was entered can be significant. Check the command is saved on the retrieve stack for later
SECOPT.OPERSEC statement, described in the IBM retrieval.
Z NetView Administration Reference to determine
whether password or password phrase checking is Operator response
being performed by the NetView product or by an
SAF security product, such as the RACF product. Wait until NetView initialization is completed and re-
If password or password phrase checking is being enter the command. If initialization does not complete
performed by an SAF security product, a mixed- in a timely fashion, enter the CLOSE command.
case password or password phrase can be valid;
DSI026I session SESSION ENDING. macro
if password or password phrase checking is being
FAILED - RTNCD = X'vtamrcd'
performed by the NetView product, a mixed-case
FDBK2 = X'vtamfb' SENSE =
password or password phrase is not valid.
X'vtamsens'
DSI023A INVALID PROFILE
IDENTIFICATION, REENTER Explanation
This message is sent when the SENDSESS command
Explanation
fails or when you reach the retry count for the macro.
The NetView program has rejected your logon attempt Your session is over because the macro you used
because you entered a profile identification that was failed.
not recognized.
Message Variables
session
System action
The name of the session.
The NetView program rejects the logon. macro
The name of the failing macro.
Operator response vtamrcd
Enter the logon again with the correct profile operand. The VTAM internal return code.
vtamfb
DSI024A INVALID HARDCOPY LOG DEVICE,
The VTAM internal feedback code.
REENTER
vtamsens
The VTAM internal sense code.
Explanation
The NetView program rejected a logon attempt. The System action
hardcopy log device operand is not recognized.
The NetView program ends the session.
System action
Operator response
The NetView program rejects the logon.
Notify the system programmer.
Operator response
System programmer response
Enter the logon again with the correct hardcopy
operand. Use the RCFB and SENSE command lists to determine
the meaning of the return/feedback and sense
DSI025I Please wait for NetView codes. See the device-specific documentation for the
initialization to complete. meaning of the user sense data.
DSI027I SESSION BETWEEN domainid
Explanation AND operatorid COULD NOT BE
The NetView program cannot process the command ESTABLISHED
that you entered until initialization is completed.

610 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Message Variables

A cross-domain session cannot be established terminal


between the indicated operator and domain. The The name of the terminal.
NetView network services installation exit routine was n
issued and sent this message. The name of logon data field that is in error.
Message Variables
domainid
System action
The name of the domain. The NetView program rejects the logon.
operatorid DSI030I I/O ERROR READING object
The operator identifier.

Explanation
System action
An I/O error occurred while the NetView program was
The session is not established. The NetView program reading the command list, the named file, the specified
ignores the request. NetView automation member, the NetView automation
table listing, or the NetView automation table usage
Operator response report. The error might have occurred because the
NetView program tried to access a member that is not
Notify the system programmer. defined with a logical record length of 80.
Message Variables
System programmer response
object
Check the LOGMODE session parameters. You might
Any of the following:
be out of storage, or the domain might be inactive.
The domain might not have any NetView-NetView • The name of the command list that cannot be
sessions (NNTs) defined on CDMNSESS statements. read.
This message can also be received if an operator • The name of the profile definition that cannot be
attempts to start an NNT session with a standalone read.
NetView program as either the target or the originating
session. • The name of the DSIPARM, DSILIST, DSIARPT,
DSIASRC, or BNJPNL1 member that cannot be
DSI028I EXPECTED OPERAND MISSING read.
• The name of an embedded member appears if
Explanation the error indicated by the message occurred in a
member included (%INCLUDE card) in member.
You entered a command without the required operand. If multiple levels of embedding occurred within
member, only the level where the error occurred
System action is specified.
The NetView program ignores the command.
System action
Operator response Processing ends.
Check the syntax of the command in the NetView
online help. Enter the command again with the proper Operator response
operands. Specify another member, if appropriate, and notify the
DSI029I INVALID LOGON ATTEMPT FROM system programmer.
TERMINAL terminal, ERROR IN
THE 'n' FIELD System programmer response
Determine the cause of the error. If you edited the
Explanation data set since the NetView program was initialized, the
A logon to the NetView program was attempted and data set might need to be compressed.
rejected. This message is sent to the log and to the DSI031I SPECIFIED NAME 'name' INVALID
terminal that is designated as an authorized receiver of
the message.

Chapter 7. DSI Prefix Messages 611


Explanation name
The incorrect name specified or implied by default
One of the following conditions might have occurred: in the command.
• The name you entered might not exist.
• The name is not valid for the specified use. For System action
example, you might have issued the STOP TASK The command stops processing.
command for one of the following tasks: DSIATFMT,
DSIBRWMT, DSIDCBMT, DSILOGMT. The NetView
program automatically restarts these tasks. Operator response
• The name is not in your span of control. Verify that the name is an operator already in use.
• The name is that of a command list that is defined in Check that the operator is a valid NetView operator ID.
CNMCMD, but the member defined on the CMDDEF See the NetView online help for the correct command
statement cannot be found. syntax. Enter the command again if you had syntax
errors.
• An attempt was made to delete the specified
command name, but it cannot be deleted either DSI032I THE CONSTANT FOR THE
because it is not defined or because it is an internal CLIST STORAGE CONSERVATION
command and therefore cannot be deleted. OPTION IS OTHER THAN ONE OR
• The name is that of an operator that is currently in ZERO. CONSTANT IS ASSUMED TO
use or has been deleted from the NetView program. BE ONE.

• The name is that of an operator that is currently not


permitted in the APPL class of the SAF product to log Explanation
on to this NetView program. The constant for the CLIST Storage Conservation
• The name is reserved for use as the name of a Option can be a one (for active), or a zero (for inactive).
virtual OST (VOST) to be created with the ATTACH If you specify something other than one or zero for this
command. option in DSICTMOD, then the constant is assumed to
be one.
• The Tivoli Enterprise Portal Logonid value is too long
or contains characters that are not supported in
common global variable names. System action
• The mapped Tivoli Enterprise Portal Logonid does Processing continues with the option active.
not meet the operator ID criteria for the NetView
program.
Operator response
• The name is an autotask operator name that has
been revoked by the SAF product. Notify the system programmer.
• The socket path name for the Q replication, IMS
replication, or VSAM replication product does not System programmer response
start with a forward slash (/), which is required.
Change the CLIST Storage Conservation Option
For data collection, the invalid path is ignored, and constant in DSICTMOD to a one or zero before
there is no connection attempt. recycling the NetView program.
Additionally, no production system path DSI033I session SESSION STARTING FOR
configuration information will be forwarded to the operatorid
controller system for the particular data source
(DB2, IMS, or VSAM) and function (capture or apply). Explanation
This might impact the execution of the ACTVREPL
command. You entered a START command to establish a session
• ENT.GROUP definition processing identified a group for the specified operator.
that is not valid. A group might be including itself Message Variables
as a member or specifying an invalid group as a
member. session
Any of the following:
Message Variables
• A terminal name
• A domain name
• A hardcopy log device name

612 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


operatorid If the message results from the ATTACH command,
The operator identifier. the object is the attach name of the virtual OST
(VOST).
System action If the message results from the INITNRM
command, the object is NetView Resource
Internal tables are adjusted to reflect the new session.
Manager.
DSI034I COMMAND SCHEDULED BY
If the message results from CNMESTMN
AT/EVERY/AFTER COMMAND -
processing of the (TEMA)EMAAUTO.TEMS.procStr
'commandtext'
statement, the object is the value that is specified
on this CNMSTYLE member statement (the Tivoli
Explanation Enterprise Monitoring Server startup procedure).
You entered an AT, EVERY, or AFTER command. The
command displayed in the message is the command System action
that the NetView program will attempt to run when the
The NetView program ignores the command. If the
timer expires.
object is the Tivoli Enterprise Monitoring Server startup
Message Variables procedure name, the IBM Z NetView Enterprise
Management Agent automation is driven.
commandtext
The command to be run. DSI037I Process process_id spawned for
unix_command
Operator response
Explanation
If the command displayed in the message is not the
command you wish to run, use the PURGE command A process has been created to act on a request
to delete this command from the timer. from NetView program. This message is always logged
immediately as the process is created. The process_id
DSI035I SPAN span ACTIVATED FOR
returned can be used to end the spawned process, if
affectedid
desired.
Message Variables
Explanation
process_id
The span of control defined by span is activated for
The decimal value of the UNIX process ID
your terminal.
unix_command
Message Variables The command being invoked
span Note: When a command issued from a NetView
The name of the span list. command or command list includes a community
affectedid name, the community name is replaced by
The operator ID for which the span is activated. ******** for security purposes. The community
name is always replaced by ********, regardless
System action of the original length of the community name.

The span is started for the affectedid.


System action
DSI036I object ALREADY ACTIVE
Processing continues.

Explanation DSI038I operator ID reconnected

The object named by the entered command is already


Explanation
active.
This message indicates that you have been
Message Variables
reconnected. This message is issued when a logon
object establishes a connection to an existing task instead of
If the message results from the START command, starting a new task.
the object is the name of the span list.

Chapter 7. DSI Prefix Messages 613


Note: If the operator specified Profile, Hardcopy, or Message Variables
the Run Initial command, these values are ignored.
object
The insert operator ID is your operator ID.
Any of the following:

System action • A terminal name.


• A domain name.
Processing continues.
• A hardcopy log device name.
DSI039I MSG FROM id : text
• A task name.
• An operator identifier.
Explanation
The message designated by text is sent to your System action
terminal from the operator identified by operatorid.
This message can also be the result of an initial The NetView program rejects the START command.
NetView command at system startup. DSI042I object RESOURCE NOT AVAILABLE
Message Variables
id Explanation
The operator identifier or domain name originating The operator, hardcopy log, domain, terminal, task, or
the message. MVS console cannot be allocated. For VTAM resources,
text the path to the indicated resource might be broken.
The text of the message. For example, for a terminal, the unit might be turned
off.
System action A NetView task might not be available because it is
dependent on a system function (for example, VTAM)
The MSG command completed.
that is disabled.
DSI040I session SESSION RESTARTING
If this message appears as a result of the
FOR operatorid
GETCONID command, the EMCS console cannot be
allocated. Message DSI445I might provide diagnostic
Explanation information.
The session is starting. If this message appears as a result of the
AUTOTASK command, the MVS console with that
Message Variables
name is not currently defined to MVS, or else the
session name of the console is reserved. Reserved names
Any of the following: include INTERNAL, HC, INSTREAM, HARDCOPY, and
UNKNOWN. Because the NetView program and TSO
• A terminal name.
can dynamically allocate EMCS consoles, the NetView
• A domain name. program allows the association of the name to the
• A hardcopy log device name. autotask and issues WTOs to that console when it is
activated. This provides the capability to associate an
operatorid autotask to an EMCS console that becomes active after
The operator identifier. the autotask starts.
Message Variables
System action
object
The session restarts. Any of the following:
DSI041I object ALREADY ACTIVE OR IN • A terminal name
PROCESS OF BECOMING ACTIVE
• A domain name

Explanation • A hardcopy log device name


• A task name
You tried to start a session with a terminal or a
NetView program that is already in session. The • An operator identifier
NetView program rejected your request because it was • The MVS console
already busy.

614 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action span is in the operator profile, log off and log back on
again to gain access.
The NetView program rejects the START and
GETCONID commands. The NetView program
attempts to write WTOs to the console specified in the System programmer response
accepted AUTOTASK command. Add the span to the operator profile if necessary.
DSI044I UNABLE TO RESTART SESSION
Operator response FOR object. SIMLOGON FAILED
Determine why the resource is unavailable. Take the - RTNCD = X'vtamrcd' FDBK2 =
appropriate action to make the source available before X'vtamfb' SENSE = X'vtamsens'
entering the command again.
If you made a spelling or typing error, enter the Explanation
command again. If the name is correct, activate the Your session with a hardcopy log, a terminal, a domain,
MVS console. or an operator cannot be restarted. The return codes
associated with the attempt are shown.
System programmer response Message Variables
Determine if related MVS, VTAM, or NetView object
definitions are correct. Review any other messages Any of the following:
that are issued when the command fails.
• A terminal name.
DSI043I SPAN 'span' CANNOT BE
ACTIVATED FOR operatorid • A domain name.
• A hardcopy log device name.
Explanation • An operator identifier.
The specified span cannot be activated for the named vtamrcd
operator identifier because: The VTAM internal return code.
• The span is not in the operator's profile if span vtamfb
security is being done through the NetView product The VTAM internal feedback code.
when the operator logged on. NetView span vtamsens
security is specified by the SECOPTS.OPSPAN=NETV The VTAM internal sense code.
statement in the CNMSTYLE member, or by using the
REFRESH command. System action
• Span security was done through an SAF product
when the operator was logged on, but is currently The NetView program does not restart the session.
being done through the NetView product.
• Spans are not used because the operator had Operator response
CTL=GLOBAL specified at logon. Notify the system programmer.
Message Variables
span System programmer response
The name of the span list. Use the RCFB and SENSE command lists to determine
operatorid the meaning of the return/feedback and sense
The operator identifier. codes. See the device-specific documentation for the
meaning of the user sense data.
System action DSI045I RECONNECT BLOCKED. TRY
AGAIN.
The command ends.

Operator response Explanation


You were attempting to reconnect or takeover an
If the span needs to be activated and it is not in the
existing Operator Station Task (OST). That OST was
operator profile, see the system programmer. If the
unable to participate in the takeover, probably because
it is blocked or suspended.

Chapter 7. DSI Prefix Messages 615


Operator response DSI047E operation failed: tower not
enabled.
Retry the command. The OST might now be free. If
the target OST remains inaccessible and you log on
to NetView via VTAM, you can specify FORCE as the Explanation
takeover option. When FORCE is used, NetView always The requested operation failed because the required
tries to take over the existing OST without causing an supporting tower was not enabled.
abend. If that fails, NetView will issue a user abend
X'101' for the OST and then take over the session. Message Variables
If that also fails, NetView will issue a STOP FORCE operation
against the OST and log the operator on again. The The requested command, function, operation, or
STOP FORCE causes the OST to abend with abend service.
code X'EC4'. Storage and other resources might be
lost; data sets can be corrupted. tower
The name of the tower or fully qualified subtower
If you want to use the FORCE takeover option, or if you that is not enabled.
log on to NetView from NMC, ask a lead operator to
issue a STOP FORCE or STOP TASK for the OST.
System action
DSI046I UNABLE TO START SESSION FOR
The operation ended.
object. macro FAILED - RTNCD
= X'vtamrcd' FDBK2 = X'vtamfb'
SENSE = X'vtamsens' Operator response
Notify the system programmer.
Explanation
The session with the indicated device cannot be System programmer response
started. The return codes associated with the attempt
Enable the required tower in the CNMSTYLE member.
are shown.
DSI048A OPERATOR STATEMENT IS
Message Variables
INVALID IN object
object
A domain name or a hardcopy log device name.
Explanation
macro
The name of the failing macro. The password or password phrase that you entered
differs from the password or password phrase on the
vtamrcd definition statement.
The VTAM internal return code.
Message Variables
vtamfb
The VTAM internal feedback code. object
vtamsens The member containing the error or the name of
The VTAM internal sense code. an embedded member is displayed if the error
indicated by the message occurred in a member
included (%INCLUDE statement) in member. If
System action multiple levels of embedding occurred within
The NetView program does not restart the session. member, only the level where the error occurred
is specified.
Operator response
System action
Notify the system programmer.
Logon processing ends. You are prompted for the
LOGON command.
System programmer response
Use the RCFB and SENSE command lists to determine Operator response
the meaning of the return, feedback, and sense
codes. See the device-specific documentation for the Enter the password or password phrase again. If this
meaning of the user sense data. fails, try another operator ID and notify the system
programmer.

616 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Operator response
Correct the password or password phrase definition Notify the system programmer to have the statement
statement. See the IBM Z NetView Security Reference corrected.
for more information.
DSI049A PROFILEN STATEMENT IS System programmer response
INVALID IN object Correct the PROFILE statement. The profile statement
label must be the member name.
Explanation
DSI051A PROFILE NAME MISMATCH -
The PROFILEN definition statement you specified at MEMBER member
system definition has syntax errors.
Message Variables Explanation
object The name specified on the PROFILE statement does
The member containing the error or the name of not match the PROFILE member name.
an embedded member is displayed if the error
Message Variables
indicated by the message occurred in a member
included (%INCLUDE statement) in member. If member
multiple levels of embedding occurred within The name of a data set member
member, only the level where the error occurred
is specified. System action
If issued during initialization, initialization continues.
System action
However, the specified profile is not valid during
Logon processing ends. You are prompted for the logon. If issued during logon, this logon ends. You are
logon command. prompted for the logon command.

Operator response Operator response


Notify the system programmer to have the statement Notify the system programmer to correct the
corrected. statement.

System programmer response System programmer response


Replace the PROFILEN statement that is not valid. Ensure that the profile is filed in the proper member.
See the IBM Z NetView Security Reference for more If the profile is filed correctly, but the name is wrong,
information. change the PROFILE statement name field.
DSI050A PROFILE STATEMENT NAME FIELD DSI052I command COMMAND SELF-
INVALID - MEMBER member TERMINATED BY OPERATOR
REQUEST
Explanation
Explanation
The PROFILE statement name field specified is
missing or in error. There are two situations that return this message:
Message Variables • You entered a RESET command while another
command was processing.
member
The name of a data set member • You entered a CANCEL command while a command
list was running or was in a pause or wait state.
System action In either case, the command is accepted and the
original command or command list stops.
If this message is issued during initialization, NetView
initialization continues. However, the specified profile Message Variables
is not valid during logon. If this message is issued command
during logon, the logon ends. You are prompted for the The name of the command that ended.
LOGON command.

Chapter 7. DSI Prefix Messages 617


System action This message is followed by the SYNADAF I/O error
message with the following positional values:
Processing for the indicated command stops, allowing
the next command to be accepted. • Jobname
• Stepname
DSI053I NCCF CANNOT TERMINATE
SESSION session. macro FAILED • Unit address
- RTNCD = X'vtamrcd' FDBK2 = • Device type (UR for unit record, TA for magnetic tape,
X'vtamfb' SENSE = X'vtamsens' DA for direct access)
• DDNAME
Explanation • Operation (type of operation attempted)
You have reached the retry threshold. • Error description
Message Variables • Address (for UR, relative block number; for TA, track
session address; and for DA, block number)
The name of a specific NetView session. Message Variables
macro datasetid
The name of the failing macro. The name of the data set in error
vtamrcd member
The VTAM internal return code. The name of a data set member
vtamfb requesttype
The VTAM internal feedback code. The type of operation being performed on the data
vtamsens set
The VTAM internal sense code.
System action
System action The NetView program writes this message to the
The NetView program removes the remaining session network log only. The NetView program prohibits
control information from the internal tables. The tables further reading of the specified member for this
are reset to allow subsequent START commands to be request.
attempted.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Determine the cause of the error from this message
Use the RCFB and SENSE command lists to determine and from the messages following this one on the
the meaning of the return/feedback and sense screen or in the network log.
codes. See the device-specific documentation for the
DSI055I SESSION BETWEEN domainid AND
meaning of the user sense data.
operatorid IS LOST
DSI054I DSID = datasetid MEMBER =
member REQUEST = requesttype Explanation
The cross-domain session between the indicated
Explanation domain and the operator is lost. The NetView network
The system detected an I/O error. The NetView services installation exit routine was issued and it sent
program sends this message as a debugging aid. this message.
This condition can occur if a data set with a smaller Message Variables
BLKSIZE is concatenated before a data set with a
domainid
larger BLKSIZE. It can also occur if attempting to read
The name of the domain.
data from a data set extent that is created after the
NetView program was started. operatorid
The operator identifier.

618 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
Session cleanup begins. The span of control defined by the specified span is
inactivated for the affectedid operator ID.
Operator response Message Variables
Try to reinstate the session. If that does not work, span
notify the system programmer. The name of the span list.
affectedid
System programmer response The operator ID for which the span is deactivated.
Determine why the session was lost.
System action
DSI056I object SESSION STOPPING FOR
operatorid The span is deactivated.
DSI059A THE PROFILE STATEMENT
Explanation HARDCOPY OPERAND IS INVALID
This is a normal response to a STOP command entered
for the indicated device. Explanation
Message Variables The HCL operand on the PROFILE statement specifies
something other than the logical unit name of a
object NetView hardcopy device.
The name of the domain or the name of the
hardcopy log device.
System action
operatorid
The operator identifier. If issued during initialization, initialization continues. If
issued during logon, this logon ends. You are prompted
System action for the logon command.

The session between the specified device and


Operator response
operator ends.
Specify a valid HCL operand at the operator station or
DSI057A INVALID PROFILE STATEMENT notify the system programmer to have the PROFILE
OPERAND statement corrected. Log off.

Explanation System programmer response


The only valid operands for the PROFILE statement Correct the PROFILE definition statement HCL
are HCL=, CONSNAME=, and IC=. Some other operand operand, or the HARDCOPY statement in the
was specified. CNMSTYLE member, or both. See the IBM Z NetView
Security Reference for more information.
System action
DSI060A STATEMENT SEQUENCE ERROR IN
If issued during initialization, initialization continues. If PROFILE profile
issued during logon, this logon ends. You are prompted
for the logon command.
Explanation
Operator response The PROFILE statement is not the first non-comment
statement in the profile definition file.
Notify the system programmer.
Message Variables

System programmer response profile


The name of the profile definition.
Correct the operands on the statement. See the IBM Z
NetView Security Reference for more information.
DSI058I SPAN span DEACTIVATED FOR
affectedid

Chapter 7. DSI Prefix Messages 619


System action System action
If issued during initialization, initialization continues. If This logon ends. You are prompted for the logon
issued during logon, this logon ends. You are prompted command.
for the logon command.
Operator response
Operator response
Notify the system programmer. Try to log on later.
Notify the system programmer to have the definition
statements reordered or log on with a different profile. System programmer response
Evaluate the storage allocated to the NetView program
System programmer response
again, the MAXLOGON system definition statement, or
The profile definition statements must be reordered so both.
that the PROFILE statement is the first noncomment
statement to appear. See the IBM Z NetView Security DSI063A SETLOGON FAILED. RTNCD =
Reference for more information. X'vtamrcd'FDBK2 = X'vtamfb'
SENSE = X'vtamsens' APPLID =
DSI061A ERROR IN PROFILE MEMBER applid LUNAME = luname
member STATEMENT NUMBER
number Explanation
During subtask initialization, a SETLOGON failed. The
Explanation
return codes from RPLRTNCD and RPLFDBK2 are given
There is a system-definition error in the member for the system programmer's use in correcting the
whose name is given in the message. The error occurs problem.
in the indicated statement and results from the entry
Message Variables
of a verb that is unknown to the NetView program.
vtamrcd
Message Variables
The VTAM internal return code.
member vtamfb
The name of a data set member The VTAM internal feedback code.
number vtamsens
The number of the statement in error The VTAM internal sense code.
applid
System action The application for which SETLOGON failed.
This logon ends. You are prompted for the logon luname
command. The name of the logical unit.

Operator response System action


Notify the system programmer to have the statement The logon stops.
corrected.
Operator response
System programmer response
Report the problem and return codes to the system
Correct the specified statement before the operator programmer.
proceeds. See the IBM Z NetView Administration
Reference for more information.
System programmer response
DSI062I INADEQUATE SPACE TO BUILD A Use the RCFB and SENSE command lists to determine
PROFILE the meaning of the return/feedback and sense
codes. See the device-specific documentation for the
Explanation meaning of the user sense data.
A GETMAIN macro failed. DSI064A OPENACB FAILED, ACBOFLG =
X'code', ACBERROR = X'code',

620 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


APPLID = applid, LUNAME = applid
luname The application identifier.
luname
Explanation The name of the logical unit.
The VTAM OPEN ACB macro failed for the indicated
reason. This prevents establishment of the session System action
between applid and luname. If luname is the name of a terminal, the logon ends. If
Message Variables luname is SSCP, the DST is unable to open the CNMI
interface.
code
The code used for problem analysis.
Operator response
applid
The application identifier. Notify the system programmer.
luname
The name of the logical unit. System programmer response
Analyze the return codes to determine the reason for
System action the error.
If luname is the name of a terminal, the logon ends. DSI066I COMMAND NOT RUN DUE TO
If luname is the name of a NetView task, the following ENTRY OF RESET COMMAND
occurs:
• For VTAM-SESSION OSTS and NNTS: the task ends. Explanation
• FOR IP-SESSION OSTS, AUTOTASKS, VOSTS and Before an entered command can run, you entered a
OPTIONAL TASKS: the task does not end. RESET NORMAL command. The RESET command with
the NORMAL operand ends any running command.
If this message is issued because VTAM is inactive,
NetView will retry when VTAM start is recognized.
System action
Operator response The entered command does not run.

Inform the system programmer.


Operator response
System programmer response Enter the original command again, if desired. If the
command was AUTOTASK, it was probably waiting for
Determine the reason for the failure. After you correct the NetView subsystem initialization job to become
the problem, NetView can wait up to one minute to active.
open the ACB. Check your MPF table to ensure that
VTAM message IST020I is available for automation. DSI067I HALT NET,NORMAL HAS BEEN
If the ACB does not open automatically for an RECEIVED
autotask, try causing the autotask to invoke a DISPLAY
command. Optional tasks might have to be recycled. Explanation
DSI065I GENCB FAILED, REGISTER 15 = The normal HALT command requested that all active
X'code', REGISTER 0 = X'code' users log off as soon as possible.
APPLID = applid, LUNAME =
luname
System action
Explanation The NetView program continues processing. Active
user sessions are allowed to continue, but no further
The VTAM GENCB macro failed for the indicated logons are accepted.
reasons. This prevents the session between applid and
luname.
Operator response
Message Variables
Enter a LOGOFF command as soon as it becomes
code convenient.
The code used for problem analysis.

Chapter 7. DSI Prefix Messages 621


DSI068I USER operatorid ALREADY Operator response
LOGGED ON
If the resource name is not in error, check if there is
an active span table. This can be checked by issuing
Explanation the LIST SECOPTS command. If the output from this
You entered an operator ID that is already logged on to command shows that SPANAUTH has a value of NONE,
another terminal. then there is no active span table. If your operator
profile has CTL=SPECIFIC on the AUTH statement and
Message Variables there is no active span table, you will need to activate
operatorid a span table or else change the operator profile. If
The operator identifier. there is an active span table, you might need to start
an additional span for this operator.

System action DSI071I INVALID VTAM COMMAND

This logon ends. You are prompted for the logon


command. Explanation
The command was routed to VTAM as entered, but
Operator response VTAM does not recognize the command verb.

Log on with a different operator identifier, enter


LOGOFF in the operator identifier field, or specify YES System action
in the Takeover session field. The command does not run.
DSI069I SYNTAX ERROR
Operator response
Explanation Ensure that the command entered is a valid VTAM
You entered the command incorrectly. command or an accepted VTAM abbreviation. Correct
the command and enter it again.

System action DSI072A command COMMAND ABORTED.


macro RETURN CODE = retcode
The command does not run.

Explanation
Operator response
The specified system or NetView service macro
For the syntax of the command, see the NetView (DSIxxx) cannot provide the expected service, for the
online help, IBM Z NetView Command Reference reason specified by the return code.
Volume 1 (A-N), or IBM Z NetView Command Reference
Volume 2 (O-Z). Message Variables

DSI070A NO AUTHORIZATION FOR resource command


The name of the command that failed.

Explanation macro
The name of the failing macro.
The resource name specified on a VTAM command
retcode
cannot be routed because the specified name is not
The code used for problem analysis.
in your span of control.
Message Variables System action
resource The command stops running.
The name of the resource.

Operator response
System action
Retry the command. If the problem persists, notify the
The command does not run. system programmer.

622 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response DSI075I COMMAND LIST cmdlist
TERMINATED - NESTED COMMAND
See IBM Z NetView Programming: Assembler to LISTS EXCEEDED LIMIT
determine the cause of the problem. If the macro
is PPI, see IBM Z NetView Application Programmer's
Guide. Explanation
DSI073A COMMAND PROCESSOR UNABLE The specified command list has nested more levels
TO BUILD RESPONSE MESSAGE than the NetView program allows. The maximum
number that can be nested must not exceed the limit
of 250.
Explanation
Message Variables
The command processor cannot get the necessary
storage to build a buffer. The buffer is required for cmdlist
further processing or for sending a response message The name of the command list.
to the operator station.
System action
System action The specified command list stops.
The NetView program discards the message.
Operator response
Operator response Notify the system programmer.
Retry the command.
DSI074A MESSAGE NOT SENT TO System programmer response
operatorid. DSIMQS RETURN CODE Correct the command lists.
= retcode
DSI076I COMMAND TEXT TOO LONG
Explanation
Explanation
The message cannot be delivered to the intended
receiver using the DSIMQS macro. You entered one of the following:

Message Variables • NetView command that was longer than 32000


characters
operatorid
• VTAM command that was longer than 126
The operator identifier.
characters, not including resource network qualifiers
retcode
• Command operand that was longer than 255
The return code used for problem analysis.
characters
• A RUNCMD that is longer than 253 characters
System action
• Command and parameters longer than 15200
If the destination is an operator station, no further characters to be transported to a NetView domain
action is taken. If the destination is all stations, the by RMTCMD
program continues processing until no more receivers
are found.
System action
Operator response The NetView program ignores the command.

If the return code is 12, try to enter the command


again. Otherwise, notify the system programmer. Operator response
Correct the operand or command that is not valid and
System programmer response enter the command again.

Check the return code for DSIMQS in IBM Z NetView DSI077A 'operatorid' STATION NAME
Programming: Assembler for the specific type of error. UNKNOWN

Chapter 7. DSI Prefix Messages 623


Explanation System programmer response
The indicated operator identifier is not defined. Add command definition statements for DSISRP or
DSISTP to CNMCMD.
Message Variables
DSI081I OPERATOR operatorid,
operatorid
LOGOFF PROCEEDING:
The operator identifier.
TERMINAL=terminal

System action
Explanation
The command ends.
The operator at terminal logged off.

Operator response Message Variables

Check the syntax of the command as entered and operatorid


enter the command again with the proper station The operator identifier.
name. terminal
The terminal identifier. This variable can indicate
DSI078A INVALID 'initial command' either a logged-on terminal or an automated OST.
OPTION - ENTER YES OR NO The value for a logged-on terminal is the terminal
name or LU name. The values for an automated
Explanation OST can be NONE if an autotask does not have an
assigned console, or the console name.
The initial command option of the logon panel can be
YES or NO. You entered something else.
System action
System action The logoff completes.
This logon ends. You are prompted for the logon DSI082I AUTOWRAP STARTED
command.
Explanation
Operator response
This message is sent when the AUTOWRAP command
Enter YES or NO. specifies the YES, FULL, or nnn option.
DSI079I COMMAND MODULE name NOT IN
NCCF COMMAND TABLE System action
The AUTOWRAP facility is in effect. An A appears in the
Explanation upper-right corner of the terminal operator's screen.
The command modules for the START and STOP DSI083I AUTOWRAP STOPPED
commands (DSISRP and DSISTP) are required for a
logon. Explanation
Message Variables
This message is sent when the AUTOWRAP command
name specifies the NO option.
The command module names, DSISRP or DSISTP.
System action
System action
The AUTOWRAP facility stops.
The requested function cannot complete. A hardcopy
DSI084I OPEN FAILED FOR NCCF DATA SET
device cannot start or stop, or a reply cannot be made.
name

Operator response
Explanation
Notify the system programmer.
An I/O error occurred on the specified data set. The
data set might not be defined or might not be loaded.
Message Variables

624 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


name System programmer response
The name of the data set. If the command is PIPE
QSAM, this is the data definition name or fully Check for a possible I/O error. The DSIDKS macro tries
qualified data set name of the data for which the to log information about the failure.
read was attempted. DSI086I NCCF MEMBER 'member' NOT
FOUND ON DSIPARM
System action
If this is a DST, the DST subtask stops. If the Explanation
message is issued during initialization and name is The NetView program cannot locate the specified
not DSIVTAM, then initialization stops. If name is member, or the member was empty.
DSIVTAM, initialization continues. If name is DSIPRF
and this message is issued during a REFRESH Note: If member begins with a question mark (?), the
command, the REFRESH command ends. If the input is being received from a PIPE message stream
command is PIPE QSAM, the pipeline ends. A system instead of from a DSIPARM data set member.
message, typically IEC141I, might also be issued. Message Variables
member
Operator response The name of the member
Notify the system programmer. If the command is
PIPE QSAM, the problem might be that the specified System action
member does not exist.
If member is CNMCMD or DSIOPF, then initialization
stops. Otherwise, if initialization is in progress,
System programmer response initialization continues without the information from
Ensure that the data set is properly defined. If the the missing member. Otherwise, the command ends.
command is PIPE QSAM, look for a system message
issued in conjunction with this failure. The system Operator response
message will contain additional information about the
failure. Enter the command again with a correct member
name. If this message was not the result of an
DSI085I READ ERROR OCCURRED ON NCCF operator command, notify the system programmer.
DATA SET name
System programmer response
Explanation
Ensure the specified member is loaded and named
The NetView program cannot read the specified data correctly.
set.
DSI087I NCCF PROFILE MEMBER member
Message Variables NOT FOUND
name
The name of the data set Explanation
The specified user-named profile data set was
System action misnamed or cannot be located.
If this is a DST, the DST subtask stops. If the Message Variables
message is issued as the result of a SUBMIT
command, no batch job is submitted. Otherwise, member
NetView initialization ends. The name of the data set member

Operator response System action


If the message was issued as the result of a SUBMIT Processing continues.
command, enter the command again with a valid data
set. Otherwise, notify the system programmer. Operator response
Notify the system programmer.

Chapter 7. DSI Prefix Messages 625


System programmer response System action
Check the names of the data sets on PROFILEN If module refers to an installation exit (DSIEX01-
statements. DSIEX20), a default exit is used. For command
processors defined on CMDDEF statements, the verb
DSI089I INVALID STATEMENT IN NCCF
is not valid. In these cases, NetView initialization
MEMBER member
continues. In other cases, for example, translation-
table load failure, initialization ends. If module was
Explanation referenced in an automation table entry through the
ATF keyword, the AUTOTBL or AUTOTEST command
The NetView program found a statement that is not
fails and the current automation specification is
valid.
unchanged. If module refers to the value for the MOD
Message Variables keyword on the START TASK command, the named
task is not started.
member
The name of the data set member This message can also be issued by the ADDCMD
or DSILCMD command during NetView operation.
ADDCMD ends with an error and the command is
System action
not added. DSILCMD ignores the error and continues.
The NetView program ignores the statement that is However, module length information for the failing
not valid and displays the statement following this module will not be provided in the output.
message. For some cases, initialization might end. The
associated stack is not changed for a TCPCONN filter Operator response
statement.
Notify the system programmer.
Note: If the statement begins with "%INCLUDE", the
included member might not exist or might have a
problem with an associated message in the NetView System programmer response
log.
Ensure that the module is correctly named.

Operator response DSI091I INSUFFICIENT SPACE FOR NCCF


CONFIGURATION
Notify the system programmer.
Explanation
System programmer response
During initialization, the NetView program sends a
Check the statement and correct the error. GETMAIN or GETVIS access method command to
obtain storage for building control blocks. There is not
DSI090I LOAD FAILED FOR NCCF MODULE
enough storage available to support the configuration
module
specified.

Explanation System action


The specified module cannot be loaded. This message
NetView initialization ends.
might be issued as each operator logs on, or as each
autotask is started. The first such identical message is
marked as primary as if it had been routed as a result Operator response
of the ASSIGN command with the PRI keyword. All
Notify the system programmer.
subsequent copies are considered secondary.
This message can also be issued as the result of the System programmer response
execution of some NetView commands.
Specify additional storage or a smaller NetView
Message Variables configuration.
module
DSI092I INVALID VALUE SPECIFIED IN
The name of the module
object - DEFAULT IN USE

626 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
You specified an incorrect value for a system If this message occurred during initialization, NetView
parameter during NetView initialization. The statement initialization continues. If the message occurred after
that contains the incorrect value is printed following the REFRESH command, the REFRESH command
this message. completes. However, the operator ID with the missing
PROFILEN statement cannot log on to the system.
Message Variables
object Operator response
The member containing the error or the name
of an embedded member if the error indicated Notify the system programmer.
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple System programmer response
levels of embedding occurred within member, only
the level where the error occurred is specified. Delete the operator identification, or supply a
PROFILEN statement.
For the INITNRM command, the common global
variable in error appears as the object. DSI094I PROFILEN STATEMENT WITH
NO PRECEDING OPERATOR
System action STATEMENT ON object

The default value is used and NetView initialization


Explanation
continues.
A profile statement was supplied before the
Operator response operator was identified during NetView initialization
or REFRESH command processing. This is probably a
Notify the system programmer. sequence error, such as a PROFILEN statement that
appears before its associated OPERATOR statement.
System programmer response Message Variables
Check the value specified in the statement against the object
allowable values. For the INITNRM command, check The member containing the error or the name
the value of the common global variable in error. The of an embedded member if the error indicated
allowed values are listed in the comments of the by the message occurred in a member included
CNMSTYLE member. (%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only
DSI093I OPERATOR STATEMENT WITH NO
the level where the error occurred is specified.
PROFILEN STATEMENTS ON object

System action
Explanation
If this message occurred during initialization, NetView
An operator identification was specified on a
initialization continues. If it occurred after a REFRESH
statement for NetView operator definitions, but no
command, the REFRESH command completes.
profile information was supplied for that operator. A
PROFILEN statement is required for each operator
identified to the NetView program. Operator response
Message Variables Notify the system programmer.
object
The member containing the error or the name System programmer response
of an embedded member if the error indicated Check the order of the statements, and correct if
by the message occurred in a member included necessary.
(%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only DSI095I INVALID LENGTH FOUND ON A
the level where the error occurred is specified. SPECIFIED FIELD IN object

Chapter 7. DSI Prefix Messages 627


Explanation System programmer response
A field on the specified statement has the incorrect Check the sequence of statements, and correct if
length or is missing altogether. The statement necessary.
containing the error is printed after this message.
DSI097I CLOSING PARENTHESIS MISSING
Message Variables FOR SPAN OPERAND IN object
object
The member containing the error or the name Explanation
of an embedded member if the error indicated
In defining DSIVTAM, the specification of the SPAN
by the message occurred in a member included
operand (used with various operations, such as LU and
(%INCLUDE statement) in member. If multiple
APPL) did not have the required closing parenthesis.
levels of embedding occurred within member, only
the level where the error occurred is specified. Message Variables
object
System action The name of a data set member
NetView initialization continues; however, processing
for the statement is unpredictable. System action
NetView initialization continues.
Operator response
Notify the system programmer. Operator response
Notify the system programmer.
System programmer response
Check the length values in the statement against the System programmer response
allowable values.
The statement given after the message is the
DSI096I CMDMDL NOT FIRST STATEMENT statement following the missing closing parenthesis.
IN object Supply the missing parenthesis and enter it again.
DSI098I INVALID SPAN PARAMETER
Explanation ENCOUNTERED IN object
This is a probable sequence error. The CMDMDL
statement must be the first statement that is not Explanation
a comment statement in DSICMD (the command
The specified member contains a span name with a
definition file).
syntax error, a span that has not been defined, or a
Message Variables span name that has been changed.
object Message Variables
The member containing the error or the name
object
of an embedded member if the error indicated
The name of a data set member
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only System action
the level where the error occurred is specified.
If the message is received during logon, the operator
cannot log on using the specified profile. Otherwise,
System action the statement in error is issued after the message and
NetView initialization continues.
NetView initialization continues.

Operator response Operator response


Notify the system programmer.
Notify the system programmer.

628 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response program is to reside. The DOMAIN statement in the
CNMSTYLE member was missing or had a syntax error.
Check the syntax in the member against the syntax in
the IBM Z NetView Administration Reference. Message Variables

DSI099I MAXIMUM NUMBER OF SPANS object


EXCEEDED FOR ONE RESOURCE The member containing the error, or the name
IN object of an embedded member if the error indicated
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple
Explanation levels of embedding occurred within member, only
The statement that appears after this message the level where the error occurred is specified.
exceeded the allowable number of spans for a VTAM
resource. System action
Message Variables NetView initialization ends.
object
The name of a data set member Operator response
Notify the system programmer.
System action
NetView initialization continues. System programmer response
Supply the missing statement or correct the syntax
Operator response error.
Notify the system programmer. DSI102I INVALID PASSWORD OR NO
PASSWORD SPECIFIED ON
System programmer response OPERATOR STATEMENT IN object
Redefine the number of spans for the resource.
Explanation
DSI100I NO OPERATOR IDS SPECIFIED IN
DSIOPF - NCCF TERMINATED The password or password phrase parameter for the
specified operator identification is missing or contains
a syntax error.
Explanation
Message Variables
There are no operator identifications defined for the
operator data set. object
The member containing the error or the name
of an embedded member if the error indicated
System action by the message occurred in a member included
NetView initialization ends. (%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only
the level where the error occurred is specified.
Operator response
Notify the system programmer. System action
NetView initialization continues; however, the defined
System programmer response operator cannot log on.
Submit the required operator identifications to define
the member. Operator response
DSI101I DOMAINID REQUIRED AND NOT Notify the system programmer.
SPECIFIED TO NCCF IN object
System programmer response
Explanation
Supply the password or password phrase, correct the
To initialize the NetView program, specify the domain syntax error, or remove the PASSWORD keyword.
identification for the domain in which the NetView

Chapter 7. DSI Prefix Messages 629


DSI103I AUTH STATEMENT OPERAND IS Explanation
INVALID IN MEMBER member
The main task cannot determine the lengths of the
required NetView control blocks by using a SHOWCB.
Explanation The SHOWCB return code is code.
An AUTH statement with an operand that is not valid, Message Variables
or was duplicated, was found in the PROFILE member.
code
Message Variables The code used for problem analysis
member
The name of a data set member System action
The NetView program abnormally ends with a user
System action code of 3.
NetView initialization continues; however, an operator
is not able to log on with the specified profile. Operator response
Notify the system programmer.
Operator response
Notify the system programmer. System programmer response
Use the return code information in register 15 to
System programmer response correct the problem. Refer to the appropriate VTAM
Correct the operand and retry. manual for further information.

DSI104I ***** END OF NCCF HARDCOPY DSI108I STORAGE UNAVAILABLE FOR


LOG ***** MAIN TASK APPLID SUFFIX TABLE

Explanation Explanation
The hardcopy log task has finished printing all log You tried to start the NetView program in a partition or
records. region that was too small.

DSI105I NCCF INITIALIZATION FAILED


System action
Explanation The NetView program abnormally ends with a user
code of 4.
The NetView initialization module (DSISIM) failed and
returned a nonzero return code to the NetView main
Operator response
task (DSIMNT). This message comes after a message
from the initialization routine, explaining the reason for Notify the system programmer.
the failure.
System programmer response
System action
Increase the partition or region size, and restart the
The NetView program abnormally ends with a user NetView program.
code of 1.
DSI110I SETLOGON START TO ACCEPT
LOGONS FAILED - RTNCD =
Operator response X'vtamrcd' FDBK2 = X'vtamfb'
See the response for the message sent by the SENSE = X'vtamsens'
initialization routine.
Explanation
DSI107I SHOWCB FOR CONTROL BLOCK
LENGTHS FAILED - RTNCD = The NetView main task failed in its attempt to notify
X'code' REGISTER 15 = X'code' VTAM that the NetView program is ready to accept
logons.
Message Variables

630 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


vtamrcd System action
The VTAM internal return code.
Message DSI802A is sent. The NetView program
vtamfb awaits logons and NetView terminal operator
The VTAM internal feedback code. commands.
vtamsens
The VTAM internal sense code.
Operator response
System action Enter a valid command.

The NetView program abnormally ends with a user DSI113D No VTAM Application ID available,
code of 6. taskName unable to open ACB

Operator response Explanation


Notify the system programmer. The NetView program has tried every VTAM
application ID (APPLID) at least once and is unable
to find a name to use for the task taskName.
System programmer response
Message Variables
Refer to the VTAM documentation for the return/
feedback codes and the sense code. See the device- taskName
specific documentation for the meaning of the user The name of the task
sense data.
System action
DSI111I NCCF ABNORMALLY
TERMINATING - close REQUESTED If an ACB is required for the task (as with normal VTAM
BY operatorid logon), the task will end. Otherwise, the task remains
active and a value of notInit! is used for the APPLID
Explanation of the task.

This message is in response to the NetView terminal


Operator response
operator's reply to a WTOR message from the NetView
main task or in response to entry of CLOSE IMMED or Retry the failing operation. If the error persists, notify
CLOSE DUMP from a NetView operator station. the system programmer.
Message Variables
System programmer response
close
The CLOSE IMMED or CLOSE DUMP command If the error occurs frequently, increase the number
operatorid of APPL definition statements for NetView program.
The operator or SYSOP identifier NetView allows a maximum of 4096 ACBs to be
defined.

System action DSI114I node NOT ACCEPTABLE AS


HARDCOPY DEVICE
The NetView program abnormally ends with a user
code 20 if CLOSE DUMP was specified.
Explanation
DSI112I domain READY FOR LOGONS AND
SYSTEM OPERATOR COMMANDS The LU name specified on a HARDCOPY statement is
not a device that the NetView program supports for
hardcopy logging.
Explanation
Message Variables
The NetView program is initialized and ready to accept
logons. The NetView terminal operator can enter any node
appropriate commands at this point. See the online The name of the logical unit or terminal
help.
Message Variables System action
domain This hardcopy task remains active until the NetView
The NetView domain name program ends.

Chapter 7. DSI Prefix Messages 631


Operator response Operator response
Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Correct the HARDCOPY statement for the next If node is the name of a terminal and a POS statement
NetView run. was submitted for this terminal, replace the POS
statement with one that contains the LU name of a
DSI115I node NOT DEFINED FOR LOGON TO
supported device.
NCCF. LOGON REJECTED
If node is the name of a terminal and a POS statement
was not submitted for this terminal, you can take no
Explanation
further action. The device is the wrong type or model
The terminal node was not specified on a POS for a NetView terminal.
statement. An attempt was made by the NetView
If node is the application identifier of an external
program to log on the terminal node not previously
domain operator station task, increase the value on
defined by a POS statement.
the CDMNSESS statement on the levels of NetView
Message Variables previous to V5R1..
node DSI117I LOSTERM EXIT ENTERED FOR node
The name of the logical unit or terminal - REASON CODE = X'reason'

System action Explanation


The NetView program rejects the logon. You entered the NetView main task lost-terminal
installation exit routine for the specified terminal. The
Operator response reason for entry is shown by reason. Refer to the
appropriate VTAM manual for more information.
Notify the system programmer.
Message Variables

System programmer response node


The name of the logical unit or terminal
If logon is desired from the terminal node as a defined
reason
POS, submit a POS statement with the terminal's LU
The reason code used for problem analysis
name. You might also want to check for an out-of-
storage problem.
System action
DSI116I node NOT SUPPORTED AS NCCF
OPERATOR STATION TERMINAL. The NetView program ends the session with the
LOGON REJECTED terminal and returns it to VTAM.

Explanation Operator response


If node is the name of a terminal, the device is the Notify the system programmer.
wrong type or model for a NetView operator terminal.
If node is the application identifier of an external System programmer response
domain operator station task, the maximum number If required, reactivate the terminal. Refer to the
of operator station tasks in session with this NetView appropriate VTAM manual for more information.
program is exceeded.
DSI118I TPEND EXIT SCHEDULED
Message Variables
node Explanation
The name of the logical unit or terminal
The NetView program is closing down normally in
response to the system operator's entering a VTAM
System action HALT command.
The NetView program rejects the logon.

632 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action vtamfb
The VTAM internal feedback code.
The NetView main task remains active until all
subtasks have finished. No further logons are vtamsens
accepted. The VTAM internal sense code.

DSI119I OPNDST FAILED FOR node -


System action
RTNCD = X'vtamrcd' FDBK2 =
X'vtamfb' SENSE = X'vtamsens'. Logon stops.
LOGON ABORTED
Operator response
Explanation
Notify the system programmer.
A terminal trying to log on cannot be connected. The
terminal might be unavailable. System programmer response
Message Variables
Use the RCFB and SENSE command lists to determine
node the meaning of the return/feedback and sense
The name of the logical unit or terminal. codes. See the device-specific documentation for the
vtamrcd meaning of the user sense data.
The VTAM internal return code. DSI121I CLSDST RELEASE FAILED FOR
vtamfb node - RTNCD = X'vtamrcd' FDBK2
The VTAM internal feedback code. = X'vtamfb' SENSE = X'vtamsens'
vtamsens
The VTAM internal sense code. Explanation
The logon you entered was stopped or rejected, and
System action the NetView main task tried to break connection. The
attempt failed. The OPNDST was unsuccessful, and the
Logon stops.
CLSDST failed.

Operator response Message Variables


node
Notify the system programmer.
The name of the logical unit or terminal.
vtamrcd
System programmer response
The VTAM internal return code.
Use the RCFB and SENSE command lists to determine vtamfb
the meaning of the return/feedback and sense The VTAM internal feedback code.
codes. See the device-specific documentation for the
meaning of the user sense data. If the terminal is vtamsens
inactive, activate it and try to log on again. The VTAM internal sense code.

DSI120I INQUIRE TERMS FAILED FOR node


System action
- RTNCD = X'vtamrcd' FDBK2 =
X'vtamfb' SENSE = X'vtamsens'. The terminal remains in SIMLOGON state.
LOGON ABORTED
Operator response
Explanation
Notify the system programmer.
A node identification block (NIB) cannot be built for
the specified logical unit or terminal. System programmer response
Message Variables
Use the RCFB and SENSE command lists to determine
node the meaning of the return/feedback and sense
The name of the logical unit or terminal. codes. See the device-specific documentation for the
vtamrcd meaning of the user sense data.
The VTAM internal return code.

Chapter 7. DSI Prefix Messages 633


DSI122I NCCF IN SHUTDOWN MODE - codes. See the device-specific documentation for the
CLOSE NORMAL REQUESTED BY meaning of the user sense data.
operatorid
DSI124I STORAGE REQUEST FAILED FOR
NCCF domain_name
Explanation
You sent a CLOSE NORMAL from a NetView operator Explanation
station or from the system console.
A GETMAIN failed for NetView storage. This message
Message Variables is sent to the NetView system operator whenever a
storage request within a NetView region fails.
operatorid
The operator or SYSOP identifier Message Variables
domain_name
System action The domain ID of the NetView that has the
problem
No further logons (except for autotasks and distributed
autotasks) are allowed. If you requested CLOSE, the
NetView program allows you to enter CLOSE IMMED. System action
If processing a command, the command stops
Operator response running. If issued during initialization, then
initialization ends. Functions which require storage
If you entered CLOSE, enter CLOSE IMMED, if desired.
might be delayed or might end prematurely because
DSI123I INQUIRE SESSPARM FAILED FOR of the storage shortage.
node - RTNCD = X'vtamrcd' FDBK2
= X'vtamfb 'SENSE = X'vtamsens' Operator response
LOGON ABORTED
Notify the system programmer. Use the DEFAULTS or
OVERRIDE command to set storage limits on a task
Explanation
basis.
On VTAM systems only, the bind parameters for an
LU logging on to the NetView program cannot be System programmer response
examined.
Check the NetView storage, and adjust if necessary.
Message Variables
Implement storage slowdown limits on a task basis
node using the DEFAULTS or OVERRIDE command.
The name of the logical unit or terminal.
DSI125I CRITICAL STORAGE SHORTAGE
vtamrcd FOR NCCF domain_name
The VTAM internal return code.
vtamfb Explanation
The VTAM internal feedback code.
The NetView system operator receives this message
vtamsens
after the 50th failure of a storage request for the
The VTAM internal sense code.
NetView program.
Message Variables
System action
domain_name
Logon fails.
The domain ID of the NetView that has the
problem
Operator response
Notify the system programmer. System action
None, although response time was probably
System programmer response considerably slower before this message was issued.
Functions that require storage might be delayed or end
Use the RCFB and SENSE command lists to determine
prematurely because of the storage shortage.
the meaning of the return/feedback and sense

634 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response node
The name of the logical unit or terminal
Notify the system programmer. Use the DEFAULTS or
OVERRIDE commands to set storage limits on a task
basis. System action
If tasktype is a NetView subtask, the NetView program
System programmer response continues to run without the indicated subtask. If
tasktype is the NetView main task, the NetView
Increase the partition or address space for the program ends abnormally with a user code of 11
NetView program. Implement storage slowdown limits (X'00B').
on a task basis using the DEFAULTS or OVERRIDE
commands.
Operator response
DSI126I RESOURCE resource ACTIVATED
Notify the system programmer. If tasktype is OST, try
to log on later. If tasktype is HCT, enter a START
Explanation command for the task later. No recovery is possible
A resource entry is marked active using the START for NNT or PPT. If tasktype is PPT, the system tries to
command. enter a CLOSE command for the NetView program. If
tasktype is NCCF, increase the partition or region size
Message Variables and restart the NetView program.
resource
The name of the resource System programmer response
DSI127I RESOURCE resource INACTIVATED Determine whether the values for registers 0 and 15
are acceptable. Refer to the appropriate VTAM manual
Explanation for more information.

A resource entry is marked inactive using the STOP DSI129I STORAGE UNAVAILABLE FOR
command. Further commands involving this resource TASK CONTROL BLOCKS. action
can affect other domains if the resource is defined in ABORTED FOR tasktype node
the domain qualification table (DSIDQT).
Message Variables Explanation
resource Not enough storage is available for the required
The name of the resource NetView control blocks. If tasktype is OPT, PPT, or
NCCF, node is blank.
DSI128I GENCB FOR TASK cblock FAILED -
REGISTER 0 = X'code' REGISTER Message Variables
15 = X'code'. action ABORTED FOR action
tasktype node ATTACH or INITIALIZATION
tasktype
Explanation OPT, OST, NNT, HCT, or PPT for a NetView subtask,
NCCF for the NetView main task
The NetView program cannot create the indicated
control block (ACB, RPL, NIB, or EXLST) for the task. node
If tasktype is PPT or NCCF, node is blank. The name of the logical unit or terminal

Message Variables
System action
cblock
The ACB, EXLST, NIB, or RPL control block The NetView program continues to run without the
indicated subtask. If tasktype is the NetView main
code task, the NetView program ends abnormally with a
The codes used for problem analysis user code of 11 (X'00B').
action
ATTACH or INITIALIZATION
Operator response
tasktype
OST, NNT, HCT, or PPT for a NetView subtask, Notify the system programmer. If tasktype is OST, try
NCCF for the NetView main task to log on later. If tasktype is HCT or OPT, send a START
command for the hardcopy or optional task later. No

Chapter 7. DSI Prefix Messages 635


recovery is possible for NNT or PPT. If tasktype is PPT, Operator response
it might be advisable to send a CLOSE command for
the NetView program. If tasktype is NCCF, increase Continue the session.
the partition or region size and restart the NetView DSI132I INTERVENTION REQUIRED ON
program. HARDCOPY hclname - RTNCD =
X'vtamrcd' FDBK2 = X'vtamfb'
System programmer response SENSE = X'vtamsens'
Examine the storage size and increase it, if necessary.
Explanation
DSI130I ATTACH OF SUBTASK FAILED FOR
subtasktype node The hardcopy device is turned off, out of paper, or in
some other condition that requires your intervention.

Explanation Message Variables

The required control blocks were built for a subtask hclname


attempting to log on to the NetView program, but the The name of the hardcopy log device.
subtask cannot be attached. vtamrcd
Message Variables The VTAM internal return code.
vtamfb
subtasktype
The VTAM internal feedback code.
OST, NNT, PPT, or an optional task.
vtamsens
node
The VTAM internal sense code.
The name of the logical unit or terminal. The field
is blank if the subtask type is a PPT.
System action
System action No logging is performed. The print queue is purged,
and data might be lost.
The NetView program continues to run without the
indicated subtask.
Operator response
Operator response Use the RCFB and SENSE command lists to determine
the meaning of the return/feedback and sense
Notify the system programmer.
codes. See the device-specific documentation for the
meaning of the user sense data.
System programmer response
DSI133I CLSDST TO PASS luname TO
If the subtask is an OST, try to log on later. No recovery tasktype SUBTASK applid FAILED
is possible for an NNT or PPT. If the subtask is a - RTNCD = X'vtamrcd' FDBK2 =
PPT, send CLOSE for the NetView program. If the MOD X'vtamfb' SENSE = X'vtamsens'.
keyword of the START command was used, check that SESSION TERMINATED
the module name was spelled correctly and that the
module can be loaded.
Explanation
DSI131I COMMANDS ABENDED BY RESET The NetView main task cannot pass the indicated node
COMMAND. STATION HAS BEEN to the subtask, for the reasons shown. The subtask
RESET ends normally.
Message Variables
Explanation
luname
You entered RESET to cancel a command or
The name of the logical unit.
commands.
tasktype
OST, NNT, HCT, or PPT for a NetView subtask,
System action NCCF for the NetView main task.
Commands are canceled and processing continues. applid
The application identifier.

636 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


vtamrcd System programmer response
The VTAM internal return code.
Try to log on again. Use the RCFB and SENSE
vtamfb command lists to determine the meaning of the return/
The VTAM internal feedback code. feedback and sense codes. See the device-specific
vtamsens documentation for the meaning of the user sense data.
The VTAM internal sense code.
DSI135I NetView termination complete

System action
Explanation
The NetView program posts the subtask to end
normally. The NetView program ended successfully.
DSI136I LOGON FROM luname ABORTED AT
Operator response USER REQUEST

Try to log on again. Use the RCFB and SENSE


command lists to determine the meaning of the return/ Explanation
feedback and sense codes. See the device-specific The NetView program formatted the display screen
documentation for the meaning of the user sense data. for logon. You entered LOGOFF. This situation might
DSI134I SIMLOGON OF terminal PASSED result, for example, if you are logged on at terminal A
TO tasktype SUBTASK applid under user identification XYZ and someone else tries
FAILED - RTNCD = X'vtamrcd' to log on to terminal B using the XYZ identification. In
FDBK2 = X'vtamfb' SENSE = this case the operator at terminal B cannot log on, so
X'vtamsens' LOGOFF is entered, producing this message.
You might also receive this message if during logon
Explanation processing the user logon exit (EXIT12) returns a
nonzero return code that indicates logon processing
The NetView main task tried to send the is to be ended.
SIMLOGON command for a terminal. The attempt
was unsuccessful. If the subtask ended abnormally, Message Variables
automatic reinstatement is not possible. luname
Message Variables The name of the logical unit

terminal
The name of the terminal.
System action
tasktype The logon ends.
OST, NNT, HCT, or PPT for an NetView subtask, DSI137I start luname FAILED. NCCF IN
NCCF for the NetView main task. SHUTDOWN MODE
applid
The application identifier.
Explanation
vtamrcd
The VTAM internal return code. CLOSE was sent for the NetView program before you
entered START for the specified luname.
vtamfb
The VTAM internal feedback code. Message Variables
vtamsens luname
The VTAM internal sense code. The name of the logical unit

System action System action


The terminal is returned to VTAM when the subtask The request is ignored.
ends.
DSI138I OPEN FOR domain ACB FAILED -
ACBERFLG = X'code'
Operator response
Try to log on the terminal again.

Chapter 7. DSI Prefix Messages 637


Explanation open the ACB while VTAM is initializing. If this occurs,
no action is needed because the OPEN is retried after
The NetView main cannot open a VTAM access control 1 minute.
block (ACB) for the NetView program.
DSI140I REPLY TEXT LIMITED TO number
Message Variables CHARACTERS. REENTER REPLY
domain
The NetView domain that issued the message Explanation
code
The reply text is too long.
The code used for problem analysis
Message Variables
System action number
The maximum number of characters that can be
Processing is dependent upon the ACB failure code.
used in the reply
These codes are as follows:
A
15-second retry with no message for the following
System action
codes: The reply is not passed to VTAM.
• X'14' - Temporary storage shortage.
• X'52' - VTAM has been halted. Operator response
• X'5C' - VTAM is inactive. Enter the reply again, limiting it to the length specified
in the message.
• X'70' - CLOSE in process for this application
name. DSI141I macro FAILED. REGISTER 15 =
B X'code', REGISTER 0 = X'code',
1-minute retry with error message for the following LUNAME = luname extra extra
codes:
• X'24' - The password is not correct.
Explanation
• X'58' - The application is already active. The named macro failed. If the name starts with a
NetView prefix, such as DSI, see the IBM Z NetView
• X'5A' - The application is not defined to VTAM. Programming: Assembler manual for more information.
• X'68' - The AUTH=PPO application is already Otherwise, refer to the z/OS Communications Server
active. library.
C Message Variables
Error message with no retry. The task ends if it has
macro
a mandatory dependency on VTAM. This action is
The name of the failing macro instruction
taken for all codes not previously listed.
code
The codes used for problem analysis
Operator response
luname
If you see this message at 1-minute intervals (case B), The name of the logical unit
take action to either stop the task or make changes in
the VTAM definitions (for example, VARY NET,ACT,...). extra
Optional extra tokens that can aid problem
For case C, restart the NetView program or the task analysis
after correcting the problem. Refer to the appropriate
VTAM manual for more information.
System action
System programmer response Processing ends.

Cases B or C might require changes to your VTAM or


NetView definitions or to your operating procedures.
Operator response
Record the values in the message and notify the
Note: Code X'5A' can occur during a VTAM restart if
system programmer.
the NetView program is already active. VTAM can issue
return code X'5A' if the NetView program attempts to

638 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response secondaryappl
The secondary application identification
Take action based on the descriptions in the
appropriate manual.
System action
DSI142I STOP INITIATED FOR luname
operatorid. STATION REMOVED The NetView program ends the session between the
FROM ERROR STATUS terminal and the NetView main task.

Explanation Operator response


The NetView main task initiated a STOP for subtask Notify the system programmer.
cleanup of a task in error status. This condition begins
when the last active operator station task (OST) enters System programmer response
error status. All remaining OSTs in error status are
then cleaned up. Message DSI142I is sent for each For NSPE RU, if primaryappl is not the NetView main
such OST and is sent to the log, to the receiver of task APPLID, you can log on again. To clean up the RU
authorization messages, and to the NetView terminal you can log on again, regardless of the APPLIDs. In any
operator. case, there is no required response.

Message Variables DSI145I SESSION WITH luname


TERMINATED
luname
The name of the logical unit
Explanation
operatorid
The operator identifier The session ended between the terminal that receives
this message and the logical unit. The ending can be
asynchronous or requested.
System action
Message Variables
The NetView program ends the subtask normally after
storage cleanup. luname
The name of the logical unit
Operator response
System action
Notify the system programmer.
The NetView program cleans up the session.
System programmer response
Operator response
Any operatorid identified in the message is available
to the NetView program. You might now log on to the The session can be reinstated later.
NetView program.
DSI146I STOP FORCE ISSUED FOR task BY
DSI144I NSEXIT ENTERED FOR action RU. operatorid
SESSION TERMINATED BETWEEN
primaryappl AND secondaryappl Explanation
The NetView program has accepted and is processing
Explanation the STOP FORCE command for the identified task.
For network services procedure error (NSPE), the Message Variables
NetView main task tried to enter the SIMLOGON or
DST PASS commands. For CLEANUP, you entered VARY task
NET, INACT while the NetView program was in session The name of the task
with the terminal. operatorid
Message Variables The operator identifier

action
CLEANUP or NSPE System action
primaryappl The named task is stopped immediately.
The primary or main application identification

Chapter 7. DSI Prefix Messages 639


Operator response System action
Notify the system programmer. NetView initialization continues. The keywords that are
not valid are ignored.
System programmer response
Operator response
Determine the cause of the failure that prompted the
operator to enter STOP FORCE. Notify the system programmer.
DSI148I SEVERE ERROR - INVALID
VALUE SPECIFIED FOR KEYWORD System programmer response
keyword The NetView program does not support TCAM. Remove
the keywords.
Explanation
DSI151I MORE HELD MESSAGES EXIST
The value specified for the indicated keyword on AND ARE NOT SHOWN
the ACCESS statement is not valid. Therefore, the
statement is not valid. Explanation
Message Variables
There are more held and action messages than can
keyword be displayed. The additional messages are displayed
METHOD or SVC when the messages on the screen are removed.

System action System action


The incorrect statement is displayed after this The additional messages are stored until screen space
message, and the NetView program ends. is available.
Note: This message is subject to NLS translation, not
Operator response automation.
Notify the system programmer.
Operator response
System programmer response Reply to WTOR messages. Take action to resolve
action message requests (for example, mounting tapes
Correct the error, and restart the NetView program.
or setting switches).
DSI150I WARNING - TPROC OR SVC
DSI152I MOD = module ON CMDMDL STMT
KEYWORD ON ACCESS STMT IN
INVALID FOR ACCESS METHOD IN
object IGNORED FOR ACCESS
filename
METHOD VTAM

Explanation
Explanation
The module named on the CMDMDL statement that
The TPROC and SVC keywords coded on the ACCESS
follows this message is incompatible with the level of
statement are TCAM-dependent and are not supported
access method in use.
by the NetView program.
Message Variables
Message Variables
module
object
The module name
The member containing the error or the name
of an embedded member if the error indicated filename
by the message occurred in a member included The file where the CMDMDL statement is coded
(%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only System action
the level where the error occurred is specified.
The NetView program does not load the module
specified by module and does not recognize the
command associated with the CMDMDL statement in

640 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


error. The CMDMDL statement in error is displayed object
following the message. The member containing the error or the name
of an embedded member if the error indicated
Operator response by the message occurred in a member included
(%INCLUDE statement) in member. If multiple
Notify the system programmer. levels of embedding occurred within member, only
the level where the error occurred is specified.
System programmer response
System action
Correct the error.
The TASK statement in error is displayed after
DSI154I WARNING - TASK STMT KEYWORD
this message. NetView initialization continues. The
keyword IN ERROR IN object, TASK
NetView program uses the default value (if any) for the
WILL NOT BE ATTACHED
keyword in error.

Explanation Operator response


A keyword specified on the TASK statement is in error.
Notify the system programmer.
Message Variables
keyword System programmer response
The keyword specified. Determine whether the default keyword value is
object usable by the NetView program. If not, correct the
The member containing the error or the name TASK statement in error and restart the NetView
of an embedded member if the error indicated program.
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple DSI157I INVALID KEYWORD keyword
levels of embedding occurred within member, only ENCOUNTERED ON THE
the level where the error occurred is specified. FOLLOWING STMT IN object

System action Explanation


The task associated with the TASK statement is not You specified an incorrect keyword on a NetView
attached. The TASK statement in error is displayed definition statement.
after this message. NetView initialization continues. Message Variables
keyword
Operator response The keyword specified.
Notify the system programmer. object
The member containing the error or the name
System programmer response of an embedded member if the error indicated
by the message occurred in a member included
Determine whether the specified task is critical (%INCLUDE statement) in member. If multiple
to NetView processing. If it is, correct the TASK levels of embedding occurred within member, only
statement and restart the NetView program. the level where the error occurred is specified.
DSI156I WARNING - TASK STMT KEYWORD
keyword IN ERROR IN object, System action
DEFAULT VALUE IN USE
The definition statement in error is displayed following
this message. NetView initialization continues.
Explanation
You specified an incorrect keyword value on the TASK Operator response
statement.
Notify the system programmer.
Message Variables
keyword
The keyword specified.

Chapter 7. DSI Prefix Messages 641


System programmer response originates in domains that operate in the TCAM
environment.
Determine whether the error is critical to NetView
operation. If it is, correct the definition statement in DSI163I function FUNCTION NOT
error and restart the NetView program. SUPPORTED FOR entity

DSI160I COMMAND LIST cmdlist WARNING


- INVALID SYNTAX Explanation
A function run by or for the specified entity was not
Explanation supported for that entity.

A command list statement contains a syntax error. Message Variables

Message Variables function


The name of the function that was called or
cmdlist invoked
The name of the command list
entity
The name of an entity (for example, an operator
System action ID) that tried to run the function, or the name of
The command list statement in error displays along the entity upon which a function attempted to act
with this message. The command list continues with
default options. System action
The NetView program continues processing.
Operator response
Notify the system programmer. Operator response
If the entity is an operator ID, enter only commands
System programmer response for the system or task type that you are using.
Correct the command list statement. DSI164I PROFILE profile SPECIFIES
DSI162I UNAUTHORIZED RESOURCE FEATURES NOT SUPPORTED -
resource SENT DATA TO LUNAME PARAMETERS IGNORED
luname
Explanation
Explanation The profile you used specifies features not supported
A resource that is not defined to the NetView program in the current system environment.
sent data to a logical unit in session with the NetView Message Variables
program. No cross-domain session was active for that
operator. profile
The name of the profile definition
Message Variables
resource System action
The name of the resource
The unsupported feature parameters are ignored.
luname Processing continues.
The name of the logical unit

Operator response
System action
Notify the system programmer.
The NetView program ignores the data. This message
is sent to the authorized message receiver; it informs
the operator of a possible security exposure. System programmer response
Change the operator profile.
Operator response DSI165I RECEIVE ANY FOR LU luname
Investigate the terminal indicated in resource to HAS FAILED - RTNCD = X'vtamrcd'
determine the origin of the data. This message FDBK2 = X'vtamfb' SENSE =
X'vtamsens'

642 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation position
The numeric offset where the error was found.
RECEIVE ANY for cross-domain logon in VTAM failed. The error might be at the indicated position or the
Message Variables character after position.

luname Position in a pipeline specification will be counted


The name of the logical unit. from the beginning of the specification. Position
in a stage specification will be counted from the
vtamrcd
beginning the stage specification. In the case of an
The VTAM internal return code.
error in a stage specification, message DWO362E
vtamfb will follow DSI167E.
The VTAM internal feedback code.
text
vtamsens A few characters of the specification prior to the
The VTAM internal sense code. error to assist in locating the error.

System action System action


If you can retry the command, the NetView program See the system action for the messages accompanying
enters the RECEIVE ANY command again. If you this message. The pipeline or command ends before
cannot try the command again, the NetView program processing any data.
sends a CLSDST command for the failing LU before it
enters RECEIVE ANY again.
Operator response
System programmer response See the operator response for messages
accompanying this message for additional information.
Use the RCFB and SENSE command lists to determine
the meaning of the return/feedback and sense
codes. See the device-specific documentation for the System programmer response
meaning of the user sense data. If the condition See the programmer response for messages
persists, contact IBM Software Support regarding the accompanying this message for additional information.
LU in error.
DSI168I ATTACH OF SUBTASK FOR luname
DSI166I task IS ACTIVATED BY operatorid FAILED. NCCF IN SHUTDOWN
MODE
Explanation
A NetView optional task (for example, the DST) is Explanation
activated. The authorized message receiver receives this
Message Variables message. It indicates that luname cannot be attached
because CLOSE was entered.
task
The name of the task Message Variables
operatorid luname
The operator identifier The name of the logical unit

DSI167E ERROR OCCURRED SCANNING


AT POSITION position, PREVIOUS System action
TEXT: 'text'. The subtask is not attached.
DSI169I command FUNCTION CANNOT
Explanation BE PERFORMED. ANOTHER
An error was encountered while processing COMMAND HAS BEEN ISSUED
a command, stage specification, or pipeline AGAINST resource
specification.
This message indicates where the error occurred. It is Explanation
issued with another message describing the error. You entered the command indicated by command to
Message Variables perform an action on resource. A command that affects
the same resource is being processed.

Chapter 7. DSI Prefix Messages 643


Message Variables specified on the MODEENT macro (VTAM) are
incorrect.
command
The name of the command Message Variables
resource luname
The name of the resource or task The name of the logical unit

System action System action


The NetView program ignores the command. The logon is stopped.

Operator response Operator response


Try the command later. Notify the system programmer.
DSI170I task : NON-ZERO RETURN CODE
FROM SMF : REGISTER 15 = code System programmer response
Correct the parameters on the macro and retry the
Explanation logon.
While trying to write to the system management DSI172I SUBTASK 'subtask' ABENDED
facilities (SMF) log, the NetView program sent a WITH CODE X'code'
nonzero return code. To avoid sending the operator
redundant messages, the NetView program does not
issue this message if subsequent requests generate
Explanation
the same return code. The indicated subtask ended abnormally with the
Message Variables indicated ABEND code. If the subtask is an operator
station task (OST), this message appears on the
task display screen when the task is reinstated. For any
The name of the task other type of task, this message is queued to the
code authorized receiver. The left three characters of code
The code used for problem analysis are a system completion code, and the right three
characters are the application program (the NetView
program, IBM-written, or user-written) completion
System action code. See the online help for information on the
The command facility's action depends on the return application program completion code, and see the
code. If the return code is 98, a record type that is not system code manual for your operating system for
valid was found, or the length was bad. If the return system abend code information.
code is 99, an SMF request that is not valid was found. Message Variables
In either case, the record is not written to the log. For
all other return codes, see the SMF documentation for subtask
further information. Identifiers of the task that abended. This value is in
the form xxx/yyy where
Operator response xxx
the value contained in TVBLUNAM of the TVB
Notify the system programmer. for the task that abended. It can reflect one of
these values:
System programmer response • The VTAM LU name if there is one associated
Check the return code and take appropriate action. with the task that abended

DSI171A RECEIVED BIND IMAGE FOR • The operator ID of the task that abended
luname INVALID • Null, if TVBLUNAM is blanks or nulls
• Some other value that is stored in
Explanation TVBLUNAM

The NetView program received a BIND image for


luname that is not acceptable. The parameters

644 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


yyy DSI180I GROUP ID: group
the value contained in TVBOPID or TVBAPID
of the TVB for the task that abended. It can
Explanation
reflect one of these values:
This is a header line produced by the LIST
• The operator ID of the task that abended
ASSIGN=GROUP command. The NetView program
• The operator ID of the task that started the displayed all assigned group IDs.
task that abended
Message Variables
• Null, if there is currently no operator ID
defined for the task that abended group
The assigned group ID
• Some other value that is stored in TVBOPID
or TVBAPID DSI184I INVALID COMMAND NAME
code SPECIFIED
The code used for problem analysis
Explanation
System action This message was received for one of the following
Processing continues. reasons:
• A command was specified that is not valid.
Operator response • A command that is not valid was specified on the
IF-THEN statement.
Continue with reinstated session.
DSI173I AUTH MEMBER STRING: 'member' System action
The command is ignored and processing continues.
Explanation The LIST command stops. The IF-THEN statement
This is message produced by the LIST ASSIGN=AUTH command continues.
command. The NetView program found the member
you requested. If the first character of the member Operator response
name is an '*', this means the data was constructed
from a PIPE command and not a data set. Notify the system programmer.
Message Variables
System programmer response
member
The member name If this message was received in response to an issued
command or the LIST command, correct the command
name, as necessary.
System action
If this message was received in response to a
LIST command processing continues. command that is not valid on the IF-THEN statement,
DSI174I COPY MEMBER STRING: 'member' correct the command.
DSI185I statement STMT OUT OF
Explanation SEQUENCE IN list
This is a message produced by the LIST ASSIGN=COPY
command. The NetView program found the member Explanation
you requested. If the first character of the member The statement you specified was found at a point
name is an '*', this means the data was constructed in DSIJCMDS where a required predecessor is not
from a PIPE command and not a data set. present.
Message Variables Message Variables
member statement
The member name Any of the following:
• PARMSYN
System action
• CMDSYN
LIST command processing continues.

Chapter 7. DSI Prefix Messages 645


list System action
DSIJCMDS
The NetView program displays the incorrect command
list statement along with this message and ends the
System action command list. If the command list is part of a nested
The statement causing the error is displayed following chain, the error is passed to the command list's
this message. The NetView program ignores the predecessor in the chain.
statement.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Correct the command list statement that is in error.
Correct the statement sequence in the DSIJCMDS file. DSI188I COMMAND LIST cmdlist
DSI186I COMMAND LIST cmdlist TERMINATED - INVALID
TERMINATED - EXTRANEOUS OPERAND: operand
OPERAND: operand
Explanation
Explanation During command list processing, the NetView program
The NetView program found extra operands on a found an operand that is not valid. Because the
command list statement. NetView program cannot use a default value for this
operand, processing cannot continue.
Message Variables
Message Variables
cmdlist
The name of the command list cmdlist
The name of the command list.
operand
The extra operand operand
The operand that is not valid
System action
System action
The command list ends. The incorrect statement might
be displayed along with this message. If the command The NetView program displays the incorrect command
list is part of a nested chain, the error is passed to the list statement along with this message and ends the
command list's predecessor in the chain. command list. If the command list is part of a nested
chain, the error is passed to the command list's
predecessor in the chain.
Operator response
Notify the system programmer. Operator response
Notify the system programmer.
System programmer response
Correct the command list statement that is in error. System programmer response
DSI187I COMMAND LIST cmdlist Correct the command list statement that is in error.
TERMINATED - INVALID SYNTAX
DSI189I COMMAND LIST cmdlist
TERMINATED - INSUFFICIENT
Explanation STORAGE
A command list statement contains a syntax error.
Message Variables Explanation
cmdlist A GETMAIN request for storage failed during command
The name of the command list list processing.
Message Variables

646 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


cmdlist Explanation
The name of the command list
During command list processing, an expected operand
was missing on a command list statement. The
System action NetView program uses the default operand.
The NetView program ends the command list. If the Message Variables
command list is part of a nested chain, the error is
passed to the command list's predecessor in the chain. cmdlist
The name of the command list
Operator response operand
The missing operand
Determine whether you received message BNH16I,
which means the task has reached its storage limit.
If so, notify your system programmer.
System action
The NetView program displays the incorrect command
System programmer response list statement along with this message. The command
list processing continues with default options.
See the IBM Z NetView Troubleshooting Guide for
possible causes of the storage shortage.
Operator response
DSI190I COMMAND LIST cmdlist
Notify the system programmer.
TERMINATED - EXPECTED
OPERAND MISSING: operand
System programmer response
Explanation Correct the command list statement that is in error.
During command list processing, an expected operand DSI192I COMMAND LIST cmdlist WARNING
was missing on a command list statement. Because - INVALID OPERAND: operand
the NetView program cannot use a default value for
this operand, processing cannot continue.
Explanation
Message Variables
During command list processing, the NetView program
cmdlist found an operand that is not valid. The NetView
The name of the command list program uses a default operand.
operand Message Variables
The missing operand
cmdlist
The name of the command list
System action
operand
The NetView program displays the incorrect command The operand that is not valid
list statement along with this message and ends the
command list. If the command list is part of a nested
System action
chain, the error is passed to the command list's
predecessor in the chain. The NetView program displays the incorrect command
list statement along with this message. The command
Operator response list processing continues with default options.

Notify the system programmer.


Operator response
System programmer response Notify the system programmer.

Correct the command list statement that is in error.


System programmer response
DSI191I COMMAND LIST cmdlist WARNING
Correct the command list statement that is in error.
- EXPECTED OPERAND MISSING:
operand DSI193I COMMAND LIST cmdlist WARNING
- EXTRANEOUS OPERAND:
operand

Chapter 7. DSI Prefix Messages 647


Explanation Explanation
During command list processing, the NetView program The specified command is not supported under the
found an extra operand. stated subtask type.
Message Variables Message Variables
cmdlist cmdlist
The name of the command list The name of the command list
operand command
The extra operand The name of the command
type
System action NNT, OST, or PPT
The NetView program displays the incorrect command
list statement along with this message. The NetView System action
program ignores the extraneous operand, and the The NetView program displays the incorrect command
command list processing continues. list statement before this message. The NetView
program ignores the statement and the command list
Operator response processing continues.
Notify the system programmer.
Operator response
System programmer response Notify the system programmer.
Correct the command list statement that is in error.
System programmer response
DSI194I COMMAND LIST cmdlist WARNING
- LAST nn OPERAND(S) IGNORED Correct the command list statement that is in error.
For a description of restrictions on commands under
various tasks, see IBM Z NetView Programming: REXX
Explanation and the NetView Command List Language.
During command list processing, the NetView program DSI196I COMMAND LIST cmdlist
found unexpected operands. TERMINATED - INVALID LABEL:
Message Variables label
cmdlist
The name of the command list. Explanation
nn During command list processing, the NetView program
The number of unexpected operands. found a label that is not valid. Labels are coded as a
dash (-) followed by 1 to 11 alphanumeric characters
System action (A-Z, 0-9, #, @, $). Any command statement, except
a comment line, can have a label. Each label must be
The NetView program displays the incorrect command unique.
list statement along with this message. The NetView
For more information on command list labels, see
program ignores the unexpected operands and the
IBM Z NetView Programming: REXX and the NetView
command list processing continues.
Command List Language.

Operator response Message Variables

Notify the system programmer. cmdlist


The name of the command list
label
System programmer response
The command list label
Correct the command list statement that is in error.
DSI195I COMMAND LIST cmdlist WARNING System action
- command STATEMENT NOT The NetView program displays the command list
VALID FOR TASK TYPE: type statement containing the incorrect label along with

648 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


this message. The NetView program ends the System action
command list. If the command list is part of a nested
chain, the error is passed to the command list's Processing stops, and the command is ignored.
predecessor in the chain.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Determine the source of the command and correct
Correct the command list statement that is in error. the error. Possible sources are AT, EVERY, or AFTER
commands, or command lists running under the PPT
DSI197I COMMAND LIST cmdlist SELF - or the NNT.
TERMINATED
DSI199I COMMAND LIST cmdlist
TERMINATED - DUE TO
Explanation ARITHMETIC OVERFLOW
The specified command list set the return code to
-1 (negative one) on an &EXIT command list control Explanation
statement.
During command list processing, an arithmetic
Message Variables expression on a command list statement caused an
cmdlist arithmetic overflow.
The name of the command list Message Variables
cmdlist
System action The name of the command list
The NetView program displays the last statement
processed along with this message. The NetView System action
program ends the command list. If the command list
is part of a nested chain, the error is passed to the The statement that produced the error is displayed
command list's predecessor in the chain. along with this message. The NetView program ends
the command list. If the command list is part of a
DSI198I 'command' COMMAND NOT nested chain, the error is passed to the command list's
ALLOWED TO RUN UNDER task predecessor in the chain.
TASK
Operator response
Explanation
Notify the system programmer.
The command command or command processor
cannot run under the specified task or the task's
current environment (for example, an autotask or
System programmer response
distributed task). If this message was issued in Correct the statement in error.
response to a READSEC command or a QSAM PIPE
stage, the command is allowed but the specified DD DSI200I TASK task HAS TERMINATED
name cannot be resolved in this environment.
Message Variables
Explanation
command The named task completed the ending process. If
The name of a command it was caused by a STOP command, the operator
who issued the command receives this message
task when ending completes. If it was not caused by a
One of the following: STOP command, the message goes to the authorized
• A primary program operator interface task (PPT) receiver. If the START command was issued to
dynamically start a task and the load module specified
• A NetView-NetView task (NNT)
on the START command does not exist, the operator
• The name of the task. who issued the command receives this message when
ending completes.

Chapter 7. DSI Prefix Messages 649


Note: System action
1. If task is DSITACCD, the VOST associated with The command remains on the screen so you can
a previous TCPCONN START request has ended correct and resubmit it.
unexpectedly.
2. If task is DSITAPCD, the VOST associated with Operator response
a previous TCPCONN PKTS request has ended
unexpectedly. Determine the reason for rejection on the basis of
the error messages that came before this message.
Message Variables Correct the command and resubmit it.
task DSI203I DATE OR TIME VALUE IS OMITTED
The name of the task that ended OR NOT VALID

System action Explanation


Processing continues. The time parameter is missing or not valid. In some
instances, the time parameter might be correct and
Operator response the date parameter might be missing or not valid,
and in some instances, both the time parameter and
The named task can be restarted.
the date parameter might be missing or not valid. For
DSI201I TIMER REQUEST SCHEDULED FOR a description of valid time values, see the NetView
EXECUTION ID='name' online help.

Explanation System action


A timer request (AT, EVERY, or AFTER command) is The command is ignored.
now scheduled. The ID operand is displayed. If you did
not specify an ID operand on the AT, EVERY or AFTER Operator response
command, the NetView-generated identifier is shown.
Enter the command again, specifying a valid time
Message Variables value.
name DSI204I TIMER REQUEST ID NOT UNIQUE
The name of the timer request that is scheduled ID = 'name'
for execution

Explanation
System action
You entered a timer request and specified the name of
The specified timer request runs when you ask for it. If an already existing request on the ID=name operand.
the times are equal, the last one entered is the first to
run. Message Variables

DSI202I TIMER REQUEST FAILED TO BE name


SCHEDULED FOR EXECUTION The name of the timer request to be run
'name'
System action
Explanation The NetView program ignores the timer request.
A timer request (AT, EVERY, or AFTER command)
cannot be scheduled for this operator. Operator response
Message Variables Enter the command again, specifying a unique
name identifier.
If you specified an ID operand on the timer DSI205I number TIMER ELEMENTS
request, it is displayed in this insert. PURGED OP = 'operatorid'

650 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
This is a multiline message. This message lists the During command list processing, the NetView program
number of timer queue elements that were purged for tried to use a previously defined label a second time.
the specified operator. Following this information is the
Message Variables
list of purged timer IDs.
cmdlist
Message Variables
The name of the command list.
number label
The number of requests purged. The previously defined command list label.
operatorid
The operator identifier. System action
The NetView program ends the command list. If the
System action
command list is part of a nested chain, the error is
The purge was successful. passed to the command list's predecessor in the chain.
DSI206I COMMAND LIST cmdlist
TERMINATED - COMMAND LIST Operator response
FUNCTION function INVALID FOR Notify the system programmer.
TASK TYPE: type

System programmer response


Explanation
Correct the statement in error.
During command list processing, the NetView program
found a command list statement type that is not DSI208I TIME EXPIRATION - ID = 'name' -
supported under the specified task. CMD= 'command'
Message Variables
Explanation
cmdlist
The name of the command list. The timer-initiated command indicated in the message
is about to run.
function
The name of the function that is not valid. Message Variables
type name
NNT, OST, or PPT. The name of the timer request.
command
System action The name of the command.
The statement containing the error is displayed along
with this message. The NetView program ends the System action
command list. If the command list is part of a nested
If the command is valid, it will run.
chain, the error is passed to the command list's
predecessor in the chain. DSI209I COMMAND LIST cmdlist
WARNING - INVALID COMMAND
Operator response ENCOUNTERED - COMMAND
IGNORED
Notify the system programmer.
Explanation
System programmer response
The NetView program does not recognize the
Correct the statement in error. For a description of command, or the command is not allowed in a
restrictions on commands under various tasks, see command list.
IBM Z NetView Programming: REXX and the NetView
Command List Language. Message Variables

DSI207I COMMAND LIST cmdlist cmdlist


TERMINATED - LABEL MULTIPLY The name of the command list.
DEFINED: label

Chapter 7. DSI Prefix Messages 651


System action Message Variables

The command list statement in error is displayed along object


with this message. The command is ignored and the A specified keyword or value, or the name of a
command list continues. command
Note: The insert might contain the value of a
Operator response command, keyword, or value as defined in the
CMDDEF statement instead of a command synonym
Notify the system programmer. or parameter synonym that might have been entered.
The insert might contain two question marks (??) if a
System programmer response suppression character was used when the command
was issued. If this message is generated by the QSAM
Correct the command list statement in error. PIPE stage, it might also contain the resolved data
DSI210I COMMAND LIST cmdlist WARNING set name rather than the DD name that was input.
- ACCESS TO COMMAND IS The object might be 'CLSDST PASS'. See the System
NOT AUTHORIZED - COMMAND Programmer's Response below for more information.
IGNORED
System action
Explanation For the READSEC or LIST SAFOP command, the
You are not permitted to issue the command in the command ends, indicating access is not allowed.
command list because of security definitions in effect. Otherwise, the NetView program rejects the command.

Message Variables
Operator response
cmdlist
The name of the command list. Ensure that the command, DD name, or data set name
is spelled correctly. If it is spelled correctly, notify the
system programmer.
System action
The NetView program ignores the command. The System programmer response
command that is not authorized is displayed following
this message. The command list continues. Evaluate the operator's requirements and add
appropriate security access if required. If the object
specified is 'CLSDST PASS', the LU from which the
Operator response logon was attempted did not have "PASS" authority
Notify the system programmer. coded in your VTAM APPL definitions. See sample
CNMS0013 for example APPL statements.
System programmer response DSI214I task : I/O ERROR OCCURRED
ON VSAM DATA SET, DDNAME =
Evaluate the operator's requirements and add
ddname, RETURN CODE = X'code',
appropriate security access if required.
RPLFDBK = X'code'
DSI213I ACCESS TO 'object' IS NOT
AUTHORIZED Explanation
On a write to the specified VSAM file, an I/O error
Explanation occurred.
You are not permitted to issue the command because Message Variables
of security definitions that are in effect.
task
If this message is issued in response to the READSEC The name of the task.
command, DSIVSMX command, LISTA command, or
the QSAM PIPE stage, you are not allowed read access ddname
to the specified DD name or data set name. The name of the VSAM data set.
code
If this message is issued in response to the LIST
The codes used for problem analysis.
SAFOP command, your operator ID is not authorized
to access the SAF segment of the specified ID.

652 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action System action
The NetView program does not perform the output The command list continues.
operation.
Operator response
Operator response
Notify the system programmer that there are errors in
If the error is apparent from the return code and the named command list.
feedback code, take corrective action. Otherwise,
notify the system programmer. System programmer response
Correct the statement in the command list so that
System programmer response
truncation is not required.
Check the return code and feedback code, and correct
the error. DSI217I MAXIMUM INPUT LINES ALLOWED
IS 3
DSI215I COMMAND LIST cmdlist
TERMINATED - INVALID NUMBER Explanation
OF POSITIONAL PARAMETERS
A request to alter the input area of the screen
exceeded the maximum value of three lines. You
Explanation
cannot have more than three input lines.
The number of positional parameters you entered on
the command list call is more than the maximum of System action
31.
The NetView program ignores the command. The input
Message Variables
area remains at its current size.
cmdlist
The name of the command list. Operator response
Enter the command again with the number of lines
System action
(one to three) to alter.
The command list stops.
DSI219I COMMAND LIST cmdlist -
STATEMENT ECHO SUPPRESSED
Operator response
Enter the command list again with the proper number Explanation
of parameters.
The command list indicated by cmdlist contains a
DSI216I COMMAND LIST cmdlist WARNING statement with a suppression character.
- cmdlistfunc VALUE TRUNCATED
Message Variables
TO 255 CHARACTERS
cmdlist
The name of the command list.
Explanation
The length of the value returned by built-in System action
command list function cmdlistfunc is greater than 255
characters. The resulting value is truncated to the first The command list statement is not written to the
255 characters. terminal or the network logs.
Message Variables DSI220I INVALID VALUE SPECIFIED FOR
keyword IN object - DEFAULT
cmdlist
VALUE value USED
The name of the command list.
cmdlistfunc
The name of the built-in command list function Explanation
that returned the truncated value. The parameter value you specified is not valid for the
specified keyword.
Message Variables

Chapter 7. DSI Prefix Messages 653


keyword Explanation
The keyword specified.
The NetView program found an &WAIT statement
object with the CONTINUE operand with no previous &WAIT
The member containing the error or the name statement active.
of an embedded member if the error indicated
by the message occurred in a member included Message Variables
(%INCLUDE statement) in member. If multiple cmdlist
levels of embedding occurred within member, only The name of the command list.
the level where the error occurred is specified.
value
System action
The default value of the keyword.
The command list ends.
System action
Operator response
The NetView program initialization continues using the
default value. The statement in error is displayed along Notify the system programmer.
with this message.
System programmer response
Operator response
Correct the command list.
Notify the system programmer. If the default value is
DSI223I NOT IN WAIT STATUS - ENDWAIT
not desired, you might want to stop processing.
KEYWORD INVALID

System programmer response


Explanation
Correct the statement in error.
The NetView program found an ENDWAIT statement
DSI221I COMMAND LIST cmdlist with no previous &WAIT.
TERMINATED-SECOND WAIT
FUNCTION ISSUED System action
The command list ends.
Explanation
You entered a second &WAIT statement in the Operator response
command list.
Notify the system programmer.
Message Variables
cmdlist System programmer response
The name of the command list.
Correct the command list.
System action DSI224I COMMAND LIST cmdlist NOT IN
WAIT STATE
The command list ends because a second &WAIT is
issued while a previous &WAIT was still active.
Explanation
Operator response You issued a command to stop a command list from
waiting. The command list was not waiting.
Notify the system programmer.
Message Variables
System programmer response cmdlist
The name of the command list.
Correct the command list.
DSI222I COMMAND LIST cmdlist System action
TERMINATED - NO PRIOR WAIT
FUNCTION. CONTINUE OPERAND The command ends.
INVALID

654 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response System programmer response
Evaluate the situation with the command list and enter Correct the command list and enter the command
a RESET or CANCEL command. again.
DSI225I COMMAND LIST cmdlist WARNING DSI227I LOGON FAILURE. TRANSLATION
- DUPLICATE OR CONFLICTING TABLES NOT IN LOAD LIST FOR
KEYWORDS. keyword IS USED 'luname'

Explanation Explanation
You have conflicting or duplicate keywords in your Session parameters indicate that alternate code was
command list. selected for a logical unit, but supporting translate
tables are not included in the main task load list.
Message Variables
Message Variables
cmdlist
The name of the command list. luname
keyword The name of the logical unit.
The keyword specified.
System action
System action The session is not started for the indicated device. The
The command list continues. The NetView program NetView program continues.
uses the last keyword specified.
Operator response
Operator response Notify the system programmer.
Notify the system programmer.
System programmer response
System programmer response Include the required translate table CSECT.
Correct the command list. DSI229I INVALID VALUE ON DEFINITION
DSI226I COMMAND LIST cmdlist STATEMENT IN object -
TERMINATED - UNEXPECTED END STATEMENT IGNORED
OF COMMAND LIST
Explanation
Explanation You specified a value that is not valid for a given
A command list statement indicated continuation definition statement. The NetView program displays
of a statement, but no subsequent command list the incorrect statement.
statement was found. Message Variables
Message Variables object
cmdlist The member containing the error or the name
The name of the command list. of an embedded member if the error indicated
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple
System action levels of embedding occurred within member, only
The NetView program ends the command list. If the the level where the error occurred is specified.
command list is part of a nested chain, the error is If the member is CNMSCSIE (Command Statistics
passed to the command list's predecessor in the chain. Include/Exclude List), an invalid list item is
encountered. Ensure that each list item conforms to
Operator response the following rules:

Notify the system programmer. • Appear on its own line.


• Be no more than 8 characters in length.

Chapter 7. DSI Prefix Messages 655


• Contain no blanks in the middle of the item, for DSI233I STACK IS NOT ACTIVE AT THIS
example, AUTO CNT vs. AUTOCNT, but leading and LEVEL
trailing blanks are accepted.
Explanation
System action
You entered the UNSTACK command. A STACK
The NetView program ignores the incorrect statement command is active but a long-running command (LRC)
and continues processing. or command list that you entered after the STACK
command has not ended.
Operator response
Notify the system programmer.
System action
The NetView program ignores the request.
System programmer response
Correct the statement in error.
Operator response
End all command lists or LRCs that you entered
DSI230I STACK STARTED
after the STACK command. Then enter the UNSTACK
command.
Explanation
DSI234I DUPLICATE COMMAND
You entered the STACK command. 'commandname' DETECTED

System action Explanation


The active command list is suspended by the STACK The command, commandname, is defined more than
command. The PAUSE or WAIT state of the command once. This message is issued once during ADDCMD
list is also suspended and is restored when you enter command processing when the first duplicate
the UNSTACK command. Messages that satisfy the command or command synonym name is detected.
WAIT or TRAP conditions while the command list is
suspended are queued for processing until you enter During NetView initialization, ADDCMD commands
UNSTACK. Any commands or command procedures are generated from the CMDDEF statements
that were queued while you were in command list in CNMCMD. When these ADDCMD commands
PAUSE or command list WAIT, before you ran STACK, are generated, statements of the form
can run now. CMDDEF.commandname.MOD=modulename that have
the same commandname are defined as duplicates.
Message DSI234I is issued for the first occurrences
Operator response of these duplicates. The last occurrence is used
You can enter commands and command lists normally. to define the command to NetView program.
You can enter UNSTACK to resume the suspended When these ADDCMD commands are run, CMDDEFs
command list. End any command lists or long-running that attempt to define commands with the same
commands (LRCs) you started while a STACK was commandname as permanent NetView commands
active before you enter UNSTACK. If you do not, the will cause DSI234I to be issued. In this case,
system issues message DSI233I. the permanent NetView command is kept and the
CMDDEF command is not added. If the message
DSI231I NO element IS ACTIVE DSI234I is issued during NetView initialization,
a reconstituted CMDDEF statement follows the
Explanation message. This reconstituted CMDDEF, although it
might not be a true representation of the original
No components were found for the requested action. CMDDEF, has sufficient information to find the original
If you issued an UNSTACK command, you must first CMDDEF in error.
issue a STACK command
During NetView operation, the ADDCMD command
Message Variables might detect a duplicate command or command
element synonym name of either an internal NetView command
The name of the item required by the issued or a command defined in CNMCMD.
command.
Message Variables

656 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


commandname – Be sure the STACK CMDDEF statement in
The name of the command or command synonym CNMCMD has TYPE=B (both).
that is defined more than once – Be sure the STACK command was not issued by
user-written code under any task other than OST
System action or NNT.
This message is sent to the system console during – Check for a possible NetView internal error.
NetView initialization. NetView will continue to • X'14' or X'18' or X'1C'
initialize. The ADDCMD ends with an error and the
– There is a possible NetView internal error.
commandname is not added.
• X'20'
Operator response – There is a NetView internal error.
Notify the system programmer. DSI236I NCCF TRACE ACTIVATION FAILED:
value NOT AVAILABLE
System programmer response
Explanation
Delete the duplicate CMDDEF statement for the
command to avoid this message, or remove the The NetView trace cannot be activated.
duplicate ADDCMD command from your CLIST or
Message Variables
procedures.
value
Note: NetView defines internal commands which are
The logging method that is not available:
not modifiable by the user.
VSAM
DSI235I command FAILED. DSIPUSH Neither the primary nor the secondary data
MACRO - RETURN CODE = X'code' sets are available for logging.
GTF
Explanation The generalized trace facility (GTF) is not
A command or task issued a DSIPUSH macro and active.
received an error as indicated in register 15.
Message Variables System action
command The NetView trace remains inactive.
The name of the command that failed.
code Operator response
The error identification code in register 15. If you entered TRACE MODE=EXT, activate the
DSITRACE task and enter the command again. If you
System action entered TRACE MODE=GTF, start GTF and enter the
command again.
Processing continues.
DSI237I COMMAND LIST cmdlist
TERMINATED - NULL OPERAND
System programmer response
INVALID FOR GLOBAL COMMAND
Take the appropriate action indicated for the following LIST STATEMENTS
Register 15 errors:
• X'4' Explanation
– Try later when the NetView program is not so You cannot code null operands on global command list
busy. statements.
– Increase the region size for the NetView job if the Message Variables
problem persists.
cmdlist
– Check for a possible internal NetView error. The name of the command list.
• X'8'
– There is a NetView internal error.
• X'C' or X'10'

Chapter 7. DSI Prefix Messages 657


System action Explanation
The NetView program ends the command list. If the The screen size (row and column values) is defined
command list is part of a nested chain, the error is in Query Reply data, but the BIND data does not
passed to the command list's predecessor in the chain. indicate the 0×0 screen size, which is required when
the NetView program uses Query to determine the
Operator response screen size.

Enter the command list with a valid operand. If errors


System action
persist, notify the system programmer.
The NetView program initialization continues, using
System programmer response the screen size defined in the Query Reply.

Correct the global command list statements. There


Operator response
can be only one blank or comma between operands.
Delete any extra blanks or commas. Notify the system programmer. If you do not want
to use the screen size specified in Query Reply, stop
DSI238I command COMMAND FAILED, processing until the system programmer resolves the
INVALID PARAMETER: parameter conflict.

Explanation System programmer response


The command failed because of an incorrect Correct the LOGMODE entry that is used for logon so
parameter. the desired screen size is specified. Bytes 13-20 must
Message Variables be (zero) when the NetView program uses Query to
determine the screen size.
command
The command that failed. DSI240I task : LOG logtype IS NOW ACTIVE
parameter
The parameter that is not valid. Explanation
The network log or trace log has been started and
System action logging begins.
The NetView program stops processing the command. Message Variables
task
Operator response The name of the task.
Verify that you entered the parameter correctly. If so, logtype
notify the system programmer. The network or trace log.

System programmer response System action


Verify that the parameter is valid and that it was Log recording begins.
entered correctly.
DSI241I NCCF TRACE INACTIVE
Note: If the parameter is autotask_name (from
the CNMSTYLE member), it is likely that a
function.autotask.xxxxdbMaint definition was removed
Explanation
from the CNMSTYLE member (xxxx is the related The NCCF TRACE is not active. No tracing is being
component, such as HMON, SMON or SAVE). Until it performed. If the NetView program was performing
can be restored, and the NetView program recycled, MODE=INT tracing, the NetView program frees the
consider entering the related timer command. For storage for the trace table.
more information, see the CNME2009 command list.
DSI239I SCREEN SIZES FROM QUERY System action
REPLY AND BIND DATA ARE
Normal processing continues.
INCOMPATIBLE. SIZE FROM
QUERY REPLY WILL BE USED

658 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI242I NCCF TRACE ACTIVATION FAILED: DSPSERV
MACRO macro FAILED WITH See the Operator Response. If the operator was
RETURN CODE code not able to successfully start the trace, see
MVS Programming Authorized Assembler Services
Reference Volume 1.
Explanation
ALESERV
The NCCF trace cannot be activated. Note the name of See MVS Programming Authorized Assembler
the macro and the return code in order to determine Services Reference Volume 1.
why the trace activation failed.
DSIDYNRS
Message Variables Dump of NetView address space to determine
macro failure.
This can be one of the following: DSI243I NETVIEW TRACE IS NOW OFF
DSIGET
NetView macro that allocates storage for Explanation
internal control blocks.
This message is issued one when one or more TRACE
TCBTOKEN options are turned off. If all trace options are turned
MVS macro to retrieve the TTOKEN for the off, then TRACE becomes inactive.
jobstep task.
DSPSERV
System action
MVS macro that creates the trace data space.
ALESERV The trace is turned off.
MVS macro that accesses the trace data space. DSI244I NETVIEW TRACE ACTIVE FOR
DSIDYNRS TASK = task_list : MODE =
NetView macro that allows tracking of the mode_list, SIZE = nnn WITH
trace table usage. OPTIONS = option_list, SAF TRACE
= trace_type FOR REQUEST TYPES
code
= type_list
This is the return code from one of the macros
listed above.
Explanation
System action This message tells you which options and System
Authorization Facility (SAF) request types are now
The TRACE command with MODE=INT remains
active for the specified tasks.
inactive.
Message Variables
Operator response task_list
This value is either ALL, or a list of one or more
If the macro name is DSPSERV, the activation might
task names or task types, where the task types
have failed if TRACE END has been issued recently and
are HCT, NNT, OPT, OST, PPT, or MNT. The list is
trace data space is still in use. Wait for a brief interval
enclosed in parentheses when it contains more
and then enter the TRACE command again.
than one element.
For any other failure, notify the system programmer. mode_list
INT, EXT, or GTF.
System programmer response nnn
Note macro name and the return code. See the The size of the internal storage area in pages.
following to determine the error: When you log to the external NetView trace log or
to GTF, nnn is 0.
DSIGET
Dump of NetView address space to determine option_list
storage failure. A list of the options that are active. The options are
separated by blanks. Possible options are:
TCBTOKEN
See MVS Programming Authorized Assembler Option
Services Reference Volume 4. Meaning

Chapter 7. DSI Prefix Messages 659


QUE TOKENMAP
Intertask queuing of buffers using DSIMQS. Decode or encode a UTOKEN to or from user-
PSS readable format.
Presentation services that involve input from TOKENXTR
and output to the terminal screen using Extract a UTOKEN from the current address
DSIPSS. space or caller-specified ACEE.
DISP VERIFY
Dispatching of tasks including waiting Identify and verify a user at logon.
(DSIWAT), posting (DSIPOS), and dispatching
from a wait (resumption of processing from System action
DSIWAT).
STOR The NetView trace runs with the indicated options
Getting and freeing storage. and the indicated SAF request types for the specified
tasks.
UEXIT
Installation exit calls for DSIEX01 through DSI245I TRACE COMMAND NOT
DSIEX19 plus CNM interface input exit, CNM PROCESSED: PRIOR TRACE
interface output exit, DST INIT exit, VSAM INIT COMMAND COMPLETING FOR
exit, VSAM INPUT exit, and VSAM OUTPUT exit. target
MOD
Module entry and exit trace of a subset of the Explanation
NetView modules.
You issued a second TRACE command before the
SAF first one completed processing. You cannot process
Calls made to an SAF product. a second TRACE command while the first one is in
TCP progress.
IP related services. Message Variables
NONE
target
No options are currently active.
The operator identifier, or the identification of the
trace_type access method task.
ALL, FAILURES, or NONE.
type_list System action
A list of the SAF request types that are active. The
request types are separated by blanks. Possible The NetView program does not process this TRACE
types are: command.

Type
Meaning Operator response
AUTH Wait for the first TRACE command to complete, then
Check authority to access a resource. enter this TRACE command again. If it fails again
with the same task indicated, notify the system
EXTRACT
programmer.
Retrieve or replace specified fields for RACF
profile.
FASTAUTH System programmer response
Check authority to access a resource. Determine why the first TRACE command did not
LIST complete.
Build in-storage profiles for RACF-defined
DSI246I NCCF TRACE IS ALREADY ACTIVE:
resources.
keyword IS IGNORED
NONE
No SAF request types are active.
Explanation
STAT
Determine if RACF is active. The indicated keyword is only valid for an initial TRACE
command.
Message Variables

660 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


keyword file
The keyword specified. The name of the VSAM file that was not closed.

System action System action


The TRACE command ignores the keyword and Processing continues.
continues processing.
DSI247I NCCF TRACE ACTIVATION FAILED: Operator response
DSITRACE TASK NOT ACTIVE Notify the system programmer.

Explanation System programmer response


The NetView program does not start the trace because Ensure that the VSAM file is properly defined.
the DSITRACE is not active.
DSI250I UNABLE TO START SESSION FOR
ACF/VTAM APPLICATION = applid
System action
OF NCCF IN A FOREIGN DOMAIN
The NetView program does not process the command.
Explanation
Operator response
The NetView-NetView authorization table cannot find
Start the DSITRACE task and then enter the TRACE the application identifier in the BIND parameter.
command again. Otherwise, start the TRACE command
Message Variables
with MODE=INT.
applid
DSI248I NCCF STAE/ESTAE FAILED: VSAM The application identification
FILES MAY NOT BE CLOSED IF
ABEND OCCURS
System action
Explanation The NetView program does not start the session.
During the initialization of a data services task (DST),
the STAE/ESTAE macro failed. VSAM data can be lost if Operator response
this task abends. Notify the system programmer.

System action System programmer response


Task initialization continues. Check the definition of the VTAM application identifier
of the NetView program in a foreign domain to ensure
Operator response it is correct. See IBM Z NetView Installation: Getting
Started.
Notify the system programmer.
DSI251I taskid: DUPLICATE CDRMNAME |
System programmer response NCCFID: name FOUND IN THE
CDRMNAME-TO-NCCFID TABLE
If a user-defined task is involved, ensure that the
macro parameter list is defined properly. If a task
Explanation
that is provided by the NetView program is involved,
contact IBM Software Support. A CDRMNAME definition statement is repeated.
DSI249I NCCF CLOSE OF VSAM FILE=file Message Variables
FAILED taskid
The identification of the access method task.
Explanation name
The DST task cannot close the indicated VSAM file The duplicated name.
during a NetView ABEND.
Message Variables

Chapter 7. DSI Prefix Messages 661


System action Operator response
Processing continues. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Verify that the CNM application has defined the CNM
data type. The CNM data type can be, for example,
System programmer response session awareness or trace.

Correct the table. DSI254I taskid : SHOWCB FOR CONTROL


BLOCK LENGTHS FAILED -
DSI252I taskid : INVALID RECEIVE TYPE REGISTER 15 = X'code' REGISTER
FROM ACCESS METHOD RECEIVE 0 = X'code'
REQUEST - CID = cid, DATA TYPE =
type
Explanation
Explanation A SHOWCB macro was issued, but failed for the
reasons noted by registers 0 and 15 error codes.
You received information other than data from the
Message Variables
access method receive request. The data type (SESSA
or TRACE) identifies a session which receives SESSA taskid
(session awareness) or TRACE information. The identification of the access method task.
Message Variables code
The codes used for problem analysis.
taskid
The identification of the access method task.
System action
cid
The communications identifier provided by VTAM. The NetView program ends abnormally with a user
type code of 3.
SESSA or TRACE.
Operator response
Operator response Notify the system programmer.
Display VTAM session status information to verify that
the session for the given CID is valid. System programmer response
DSI253I taskid : INVALID DATA RECEIVED Use the error code information to correct the problem.
FROM ACCESS METHOD RECEIVE Refer to the appropriate VTAM or VSAM manual for
REQUEST - CID = cid, DATA TYPE = more information.
type
DSI255I taskid : GENCB FAILED FOR
cblock - REGISTER 15 = X'code'
Explanation REGISTER 0 = X'code'
You received data type information with no defined
destination from the access method receive request. Explanation
The data type (SESSA or TRACE) identifies a session
that receives SESSA (session awareness) or TRACE A GENCB macro was issued for the indicated control
information. block, but failed for the reasons noted by register 0
and 15 error codes.
Message Variables
Message Variables
taskid
The identification of the access method task. taskid
The identification of the access method task.
cid
The communications identifier provided by VTAM. cblock
The following control blocks:
type
SESSA or TRACE. • ACB

662 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• EXLST DSI258I CHANGE FOCAL POINT COMMAND
• NIB HAS BEEN SENT TO THE nodeid
FOR type DATA
• RPL
code Explanation
The codes used for problem analysis.
The focal point sent a request to the specified node
requesting that the node change its focal point for the
System action specified type of data.
If the task type is a NetView subtask, the NetView
Message Variables
program continues to run without the indicated
subtask. If the task type is the NetView main task, the nodeid
NetView program ends abnormally with a user code of The name of the node.
11 (X'00B'). type
The type of data for which the focal point is being
Operator response changed.

Notify the system programmer.


System action
System programmer response The focal point NetView program sends the request to
the node.
Use the error code information to correct the problem.
Refer to the appropriate VTAM manual for further DSI259E CHANGE FOCAL POINT COMMAND
information. FOR nodeid FAILED - THE task
TASK IS NOT ACTIVE
DSI256I taskid: OPEN ACB FAILED -
REGISTER 15 = X'code' ACBERROR
= X'code' Explanation
The change focal point command was not sent to the
Explanation specified distributed host because the task task is not
active.
An OPEN ACB macro was issued, but failed for the
reason noted by the error codes. Message Variables

Message Variables nodeid


The name of the distributed host
taskid
The identification of the access method task task
The task that is not active
code
The codes used for problem analysis
System action
System action The change focal point command is not processed.

The indicated subtask ends. The NetView program


continues to run without the subtask. For VSAM Operator response
requests the task is not ended. Start the task.
DSI260I CHANGE FOCAL POINT COMMAND
Operator response FOR DISTRIBUTED HOST nodeid
Notify the system programmer. FAILED OUT OF STORAGE

System programmer response Explanation


Use the error code information to correct the problem. The change focal point command was not sent to
Refer to the appropriate VTAM or VSAM manual for the specified distributed host because a request for
more information. storage failed.
Message Variables

Chapter 7. DSI Prefix Messages 663


nodeid started. The NetView program ignores any responses
The name of the distributed host for the canceled command.

System action Operator response


The change focal point command is not processed. The network command might have caused changes to
the device with which it was communicating. Verify
Operator response any changes made to the device and, if necessary,
reset the device using the VTAM command to restart
Notify the system programmer. the communications flow.
DSI263I command FAILED. SYSTEM ERROR
System programmer response - DSIFIND RETURN CODE = X'nn'
Check the NetView storage and adjust if necessary.
Explanation
DSI261I COMMAND command (TAG = tagid)
CANCELED BY operatorid The DSIFIND service macro cannot locate a long
running command element (LRCE) needed to resume
Explanation internal processing of a CCP load sequence.
Processing cannot proceed without it.
You canceled the command. The tagid shows which
command the operator canceled. Message Variables

Message Variables command


The name of the command that failed
command
nn
The name of the canceled command.
The hexadecimal code for problem analysis.
tagid
The tag identifier used in the command.
System action
operatorid
The operator that issued the command. The command gives a return code of 4 and stops
processing.

System action
Operator response
The NetView program cancels the command.
Enter the command again list. If the problem persists,
DSI262I COMMAND command (TAG = notify the system programmer.
tagid) CANCELED BY operatorid.
REQUEST ALREADY IN PROGRESS
IN THE NETWORK
System programmer response
Ensure the command list was not modified since
Explanation the time CCP generated it. Ensure that you follow
the correct sequence of CCPLOADI, CCPLOADT,
You canceled the command. The tagid tells you which and CCPLOADF commands. See IBM Z NetView
command was in progress. Programming: Assembler for more information about
Message Variables the meaning of the DSIFIND return code values.

command DSI264I command FAILED FOR device


The name of the command being canceled. - RTNCD = X'vtamrcd', FDBK2
= X'vtamfb', SYSTEM SENSE
tagid = X'vtamsens', USER SENSE =
The tag identifier used in the command. X'code'
operatorid
Identifies the operator that issued the command.
Explanation
System action The NetView program issues this message when the
command cannot complete successfully because of
The NetView program issues this message when the the error response received on the communications
network activity for the canceled command is already network management interface. The message contains

664 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


error codes to help the system programmer determine System action
the cause of the problem.
The command gives a return code of 4 and stops
Message Variables processing.
command
The name of the command that failed. Operator response
device The NetView program allows the command only from a
The name of the network device that was command list. Notify the system programmer that this
specified. command list failed and report the exact text of the
vtamrcd message.
The VTAM internal return code.
vtamfb System programmer response
The VTAM internal feedback code.
Ensure that the command list has not been modified
vtamsens since the last time the CCP generated it.
The VTAM internal sense code.
See the NetView online help for an explanation of
code
the parameter requirements for this command. The
The code used for problem analysis.
NetView program allows no optional parameters for
these commands. The NetView program requires all
System action defined operands and allows only a certain length
for the data parameter. Use a syntactically correct
NetView processing is ended for the command.
network node name. Allow enough space in the data
length for the command.
Operator response
This message does not show whether the node is
Notify the system programmer. defined in the network, or whether the data itself is
valid. It is concerned only with how the node, the
System programmer response network, and the data are specified as parameters of
the command.
Use the RCFB and SENSE command lists to determine
the meaning of the return, feedback, and sense DSI266I INVALID NUMBER OF
codes. Refer to device-specific documentation for the PARAMETERS ON command
meaning of the user sense data. COMMAND

DSI265I parameter PARAMETER INVALID


Explanation
ON command COMMAND
There are too many or too few parameters on
Explanation a CCPLOADI, CCPLOADT, CCPLOADF or CCPDR
command. An error occurred when you entered the
The parameter is missing or not valid on a CCPLOADI, parameters to a CCP command list, or there is an error
CCPLOADT, CCPLOADF, or CCPDR command. This in a CCP generated command list.
indicates a user error or an error in a CCP generated
Message Variables
command list.
command
Message Variables
The following commands:
parameter
• CCPDR
The name of the incorrect or missing parameter.
• CCPLOADF
command
One of the following commands: • CCPLOADI
• CCPDR • CCPLOADT
• CCPLOADF
System action
• CCPLOADI
• CCPLOADT The command gives a return code of 4 and stops
processing.

Chapter 7. DSI Prefix Messages 665


Operator response network node name. Allow enough space in the data
length for the command.
The NetView program allows this command only from
a command list. Notify the system programmer that This message does not show whether the node is
this command list failed and report the exact text of defined in the network, or whether the data itself is
this message. valid. It is concerned only with how the node, the
network, and the data are specified as parameters of
the command.
System programmer response
DSI268I command COMPLETE
Ensure that the command list was not modified since
the last time it was generated by CCP.
Explanation
See the NetView online help for an explanation of
the parameter requirements for this command. The The NetView program issues this message when the
NetView program allows no optional parameters for command ends and needs no further processing.
these commands. The NetView program requires all Note: This message tells you that the NetView
defined operands and allows only a certain length program has completed the processing and forwarding
for the data parameter. Use a syntactically correct of a command. This message might mean that the
network node name. Allow enough space in the data command has executed successfully and achieved the
length for the command. desired result. For example, if you use the MDMCNTL
This message does not show whether the node is command to change the speed for all remote modems
defined in the network, or whether the data itself is (MODEM=ALLRMT) and the command is accepted by
valid. It is concerned only with how the node, the the NetView program, you receive this message only.
network, and the data are specified as parameters of This message tells you that the command has been
the command. forwarded to the remote modems. This message does
not confirm that you have changed the speed of the
DSI267I TOO MUCH DATA IN CCPDR modems.
SEQUENCE
Message Variables
Explanation command
The name of the command.
The CCPDR command has a missing or incorrect
parameter. An error occurred when you entered the
parameters, or there is an error in a CCP generated System action
command list. NetView processing of the command is complete.
DSI269I command FAILED. INSTALLATION
System action ERROR
The command gives a return code of 4 and stops
processing. Explanation
The NetView program issues this message when a
Operator response DSICES or DSIPUSH macro fails under a command
The NetView program allows this command only from processor, or when a REXX error occurs. For example,
a command list. Notify the system programmer that this message is displayed if one of the commands has
this command list failed and report the exact text of RES=Y and the other command has RES=N.
this message.
If the procedure for the NetView SSI is specified, then
the command cannot be started because the Canzlog
System programmer response data space has not been initialized. Look for message
CNM598W for further information.
Ensure the command list was not modified since the
last time it was generated by CCP. Message Variables
See the NetView online help for an explanation of command
the parameter requirements for this command. The The name of the command that failed
NetView program allows no optional parameters for
these commands. The NetView program requires all System action
defined operands and allows only a certain length
for the data parameter. Use a syntactically correct The NetView program ignores the command.

666 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Notify the system programmer. The NetView program generates this message in
response to a CANCMD issued with the ID keyword.
System programmer response It indicates that no outstanding commands were found
for the node specified with the keyword.
Check for possible errors on the CMDDEF statements
Message Variables
for the commands listed and for the internal command
DSIYCLF. Ensure that the CMDDEF statement for device
DSIYOMRP is coded in CNMCMD. Correct all NetView The keyword value from the CANCMD command.
system definition errors.
DSI270I OUTSTANDING COMMANDS System action
DISPLAY NetView processing for the command is complete.

Explanation DSI275I DSIGDS DST IS NOT ACTIVE

This is the title line for the response to the DISPCMD


Explanation
command.
The NetView program did not start the indicated task
System action or you did not define it properly. A command function
that the operator requested requires this task.
Processing continues to produce the requested
display.
System action
DSI271I COMMAND OPERATOR ID/SP TAG The NetView program ignores the related command.

Explanation Operator response


This is the label line for the DISPCMD command.
Start the task again. If it does not start successfully,
DSI272I command operatorid device tagid notify the system programmer.

Explanation System programmer response


This is the data line for DISPCMD output. Check and modify the task definition. Start the task.

Message Variables DSI277I COMMAND WITH TAG = tagid NOT


CANCELED - NOT FOUND
command
The name of the command.
Explanation
operatorid
The operator that issued the command. The NetView program generates this message in
device response to a CANCMD issued with the TAG keyword.
The keyword value from the command. It indicates that the NetView program found no
outstanding command with a tag equal to the tag you
tagid specified with the TAG keyword.
The NetView-assigned identifier for the command.
Message Variables
DSI273I END OF OUTSTANDING
COMMANDS DISPLAY tagid
The TAG keyword value from the CANCMD
command.
Explanation
This is the end of the response to the DISPCMD System action
command.
NetView processing for the command is complete.
DSI274I COMMANDS FOR 'device' NOT
CANCELED - NONE FOUND
Operator response
Ensure you specified a valid tag.

Chapter 7. DSI Prefix Messages 667


System programmer response DSI280I command FOR DEVICE device
NOT PRECEDED BY A CCPLOADI
Enter DISPCMD to display outstanding commands with COMMAND
their unique identifying tags.
DSI278I VSE COMMAND 'command' NOT Explanation
ALLOWED
The NetView program issued a CCPLOADT or
CCPLOADF command and did not precede it by a
Explanation CCPLOADI command. The NetView program issues
The VSE command entered by the OCCF operator this command from a CCP-generated command list.
was rejected. The OCCF operator cannot issue the Message Variables
MSG NetView-Partition command. It is limited to the
system console. command
The CCPLOADF or CCPLOADT command.
Message Variables
device
command The device given on the CCPLOADT or CCPLOADF
The command text that is not valid. command.

System action System action


The VSE command is not passed to VSE/OCCF for The NetView program ends the processing of the load
execution. sequence and gives a return code of 4.
DSI279I command FOR device REJECTED:
ACCESS IS NOT AUTHORIZED Operator response
Notify the system programmer that the command list
Explanation you called failed with this message.
You are not permitted to issue the command because
of security definitions that are in effect. You cannot System programmer response
issue a CCPLOADI, CCPLOADT, CCPLOADF, or CCPDR
Ensure that the command list has not been modified
command. The NetView program might issue this
since the time it was generated by CCP. Ensure
message during a CCP-generated command list.
that the command list uses the proper sequence of
Message Variables commands.
command DSI289I LOAD SEQUENCE FROM operator1
The command as it was entered from the FOR device INTERRUPTED. LOAD
command list. SEQUENCE FROM operator2
device COMPLETED
The network name specified in the command.
Explanation
System action The first operator's load sequence was interrupted.
The NetView program gives a return code of 4 and The second operator's load sequence completed.
stops processing. Several load sequences can process while the first
operator's load sequence is interrupted.
Operator response Message Variables

If you need to perform the function that failed, notify operator1


the system programmer. The identification of the operator whose load
sequence was interrupted.
System programmer response device
The name of the device.
Evaluate the operator's requirements and add
operator2
appropriate security access if required.
The identification of the operator whose load
sequence processed most recently.

668 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Explanation
The NetView program stops processing and gives a A logoff or abend routine associated with a long
return code of 4. running command element cannot issue a successful
DSIFIND command against a data element critical
Operator response to the requested processing. The NetView program
issues this message for failures which cannot relate to
Contact the other NetView operators and coordinate a specific command or circumstance identifiable with a
loading the device. message insert.
DSI290I INVALID INVOCATION OF
COMMAND command BY System action
OPERATOR/TASK task The NetView program cannot end the processing.
This can result in a failure to delete load module
Explanation DSIYOCMN.
You issued a command outside its intended
environment. For example, you issued a command Operator response
that is for NetView internal use, or you issued a Notify the system programmer.
command that is not supported by a virtual OST
(VOST). The command might be designed for the
following purposes: System programmer response
• To be issued only as an internal function request Ensure none of the installation's user-written
command processors specify DSIYOTP as the name of
• To be issued only from a command list
a logoff or abend routine.
• Only browser subcommands are permitted if you are
browsing the log from the NetView Web interface. DSI292I CHANGE FOCAL POINT COMMAND
You can re-enter your command on the resulting FOR DISTRIBUTED HOST nodeid
panel or by selecting the Command Line link under FAILED RETURN CODE X'retcode'
NetView Support in the portfolio.
• To serve only as a place-holder entry in CNMCMD Explanation
to allow for command authorization checking (for The request to change a focal point cannot be sent to
example, RUNCMD service point commands) the specified distributed node because of the problem
Message Variables specified by the retcode.
command Message Variables
The name of the command processor nodeid
task The name of the distributed node.
The operator or task that called the command retcode
The return code for problem analysis, in
System action hexadecimal form. The value is one of the
following:
The command is not processed.
X'14'
The CMDDEF statement is missing or incorrect
Operator response for DSIFSOLP in CNMCMD.
Notify the system programmer. X'18'
DSICRTR is inactive.
System programmer response X'1C'
Ensure that the command name was a correct Insufficient storage.
operator command. Correct the error in the user X'20'
command list, installation exit routine, or command The CMDDEF statement is missing or incorrect
processor that is queuing the command. for DSICHRSP in CNMCMD.
DSI291I SYSTEM ERROR DURING X'24'
COMMAND PROCESSOR The time-out value exceeds the maximum
TERMINATION allowed (86,400 seconds) in DSICTMOD. The

Chapter 7. DSI Prefix Messages 669


time value used is for FOCALPT or CHANGEFP node rejects the NV-UNIQ request that caused this
command. message to be issued.
X'28' Message Variables
The command cannot be issued under a PPT.
domainid
Others The domain ID of the distributed host.
NetView internal program error.
reqtype
The requested type in CHANGEFP command.
System action
The command is not processed and the focal point System action
remains unchanged at the distributed node.
Processing continues and the focal point for the
distributed node remains unchanged.
Operator response
DSI295I OPTIONAL DATA SERVICE TASK
Start the DSICRTR task if the return code is X'18', task IS NOT ACTIVE - reporttask
indicating that DSICRTR is not active. If you receive
other return codes, notify the system programmer.
Explanation
System programmer response You did not start the task, or you did not define
it properly. A command function that you requested
Use the return code information to correct the requires this task.
problem. If the error is an internal error, contact IBM
Software Support. Message Variables

DSI293I FOCAL POINT AUTHORIZATION task


FOR type DATA HAS BEEN The name of the needed task.
ACCEPTED BY nodeid - reporttask
The name of the task that reports this condition.
Explanation However, this information might not always be
available.
The specified node has accepted the local NetView
program as its focal point for the type of data specified
System action
in the message.
The related command function ends. If the reporting
Message Variables
task information is available and it is the CNMCALRT
type task, CNMCALRT waits until the required task
The type of data for which the focal point is being (DSICRTR, for example) becomes active.
changed.
nodeid Operator response
The name of the node.
Start the indicated task. If it does not start
successfully, notify the system programmer.
System action
Processing continues. System programmer response
DSI294I domainid DOES NOT SUPPORT Ensure the operator properly defined and started the
THE REQUESTED TYPE reqtype task.
DSI296I command FAILED. INVALID DATA
Explanation RECEIVED FROM nodeid
The specified distributed host does not support the
requested type. Explanation
If reqtype is ALERT and you entered either a The command failed because the device sent
CHANGEFP or FOCALPT CHANGE command to send insufficient data or data that was not valid. As a result,
an NV-UNIQ request to the target node, the target the NetView program cannot perform the requested
node can be defined to support only the SNA-MDS LU command function.
6.2 alert forwarding protocol. If this is true, the target

670 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables System programmer response
command If the %INCLUDE statement is not valid, correct it. If
The name of the command. the %INCLUDE statement is valid, use the reason code
nodeid returned by DSIDKS to determine the problem and
The name of the network device. correct it.
See IBM Z NetView Programming: Assembler for an
System action explanation of the DSIDKS reason code.
The NetView program stops processing for the DSI300I command CANNOT RUN AS
command. AN IMMEDIATE COMMAND
PROCESSOR
Operator response
Explanation
Ensure you specified the nodeid correctly.
You defined the command as TYPE=I or TYPE=B on
System programmer response its CMDDEF statement or on an ADDCMD command.
Redefine it as TYPE=R.
Ensure the command was used properly. Also ensure
Message Variables
you defined the nodeid to the network correctly.
command
DSI297E INVALID INCLUDE CARD IN
The name of the command.
MEMBER object. RC = reason

System action
Explanation
The NetView program ignores the command.
An error occurred while processing a %INCLUDE
statement in the specified member. This message
can occur during initialization or as a result of the Operator response
REFRESH command. This message is the first line of
Notify the system programmer.
a multiline message. The second line is the %INCLUDE
statement in error.
System programmer response
Message Variables
Redefine the command as TYPE=R.
object
The name of the member, or the name of an DSI301I command ENDED DUE TO
embedded member appears if the error indicated TERMINATION OF TASK task
by the message occurred in a member included in
member with a %INCLUDE statement. If multiple Explanation
levels of embedding occurred within member, only
the level where the error occurred is specified. This command was in progress when its related data
services task ended. The NetView program issues this
reason
message to notify you that the command processing is
The reason code returned from disk services.
incomplete.

System action Message Variables

The NetView program ignores the %INCLUDE command


statement and continues processing if possible. The name of the command being ended.
task
The data services task name.
Operator response
Note the reason code that is displayed and the action System action
that caused the message to be displayed. Contact the
system programmer. The command ends.
DSI302I LOAD SEQUENCE FROM operator1
WAS REPLACED BY LOAD
SEQUENCE FROM operator2 FOR
device

Chapter 7. DSI Prefix Messages 671


Explanation System action
The NetView program took a load configuration Load sequence processing is complete.
sequence out of the queue and replaced it with a new
DSI305I DYNAMIC RECONFIGURATION
one entered by your command list for the node.
SEQUENCE COMPLETE FOR
Message Variables DEVICE device
operator1
The operator that issued the replaced sequence. Explanation
operator2 A dynamic reconfiguration sequence in a CCP-
The operator whose sequence replaces the other. generated command list successfully completed.
device Message Variables
The network name of the device being loaded.
device
The name of the device that was loaded.
System action
The NetView program processes the new load System action
sequence.
Processing for the CCPDR sequence is complete.
DSI303I command FAILED. INVALID USE
OF THE CNMI INTERFACE. MAJOR DSI306I INVALID INVOCATION OF
CODE = nn MINOR CODE = nn COMMAND LOGOFF OR ABEND
PROCESSOR
Explanation
Explanation
When the DSIZCSMS macro was issued, it produced
the indicated return codes. The request that was being The NetView program issues this message if you called
processed ends. the logoff or abend routine incorrectly.
Message Variables
System action
command
The name of the failing command. The processing ends.
nn
Decimal codes for problem determination. Operator response
Notify the system programmer.
System action
The NetView program stops processing the command. System programmer response
Ensure that none of the installation's user-written
System programmer response command processors specify DSIYOTP or DSIYCTRM
as logoff or abend routines using the DSIPUSH macro.
See IBM Z NetView Programming: Assembler for an
Also ensure that DSIYOTP and DSIYCTRM are not
explanation of DSIZCSMS macro return codes. If this
called as command processors or as resume routines.
request failed because of a user-written command,
rewrite the command. DSI307I NO COMMANDS OUTSTANDING TO
DISPLAY
DSI304I LOAD SEQUENCE COMPLETE FOR
DEVICE device
Explanation
Explanation The NetView program generates this message in
response to the DISPCMD command. You have no
A CCP-generated load sequence successfully
outstanding commands.
completed.
Message Variables System action
device
The processing of DISPCMD is complete.
The name of the device that was loaded.

672 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI308I NO COMMANDS OUTSTANDING Operator response
FOR OPERATOR 'operatorid'
Notify the system programmer.

Explanation
System programmer response
The NetView program generates this message in
response to the DISPCMD command. There are no Ensure the command list has not been modified since
outstanding commands for the specified operator. it was generated by CCP. Ensure the command list
uses the proper sequence of commands. See the
Message Variables NetView online help for the proper sequence of these
operatorid commands.
The operator identifier given in the DISPCMD DSI331I command COMPLETE. nn
command. COMMAND(S) WERE CANCELED

System action Explanation


The processing of DISPCMD is complete. After the referenced command completed, the
DSI309I NO COMMANDS OUTSTANDING indicated number of queued commands were
FOR 'deviceid' canceled.
Message Variables
Explanation command
The NetView program generates this message in The name of the command.
response to the DISPCMD command. There are no nn
outstanding commands for this device. The number of commands that were canceled.
Message Variables
System action
deviceid
The device named on the DISPCMD command. The system action is determined by the referenced
command:
System action CANCMD
The command completed. The count includes
The processing of DISPCMD ends. commands canceled both before and after they are
DSI310I CCPDR TYPE type FOR DEVICE sent to the device.
device NOT PRECEDED BY A KEEP
CCPDR TYPE F A global KEEP timed out. The task indicated by
the endcmd.AutoTask statement in the CNMSTYLE
Explanation member was not available to process commands
defined by the ENDCMD parameter.
The NetView program issued a CCPDR command with
CLOSE
the M or L parameter that was not preceded by a
Command processing during the time indicated
CCPDR with the F parameter. This message might be
by the endcmd.close.leeway statement in the
the result of a CCP-generated command list.
CNMSTYLE member was abruptly ended. This can
Message Variables occur because the time expired or because a
second CLOSE command was issued during the
type
leeway period.
The M or L parameter.
device DSI335I command CHANGE FOR ID =
The name of the device specified on the CCPDR name1 FAILED. VALUE value
command. INVALID FOR target = name2,
SENSE CODES = X'codes'
System action
Explanation
The CCPDR command stops processing and gives a
return code of 4. The NetView program uses this message to display
error feedback from a request to alter or query a line

Chapter 7. DSI Prefix Messages 673


or station attribute. The value indicated is not valid for has not been updated and run with the new fields to
the line or station named. produce the correct level of DSICTMOD.
Message Variables
System action
command
The name of the command. Initialization stops.
name1
The name of the destination network node. Operator response
value Notify the system programmer.
The value used on the command.
target System programmer response
LINE or STATION.
Perform the following steps:
name2
The line or station attached to the network node. 1. Update your customized copy of CNMS0055 from
codes the copy supplied with the NetView program.
The system sense codes. 2. Assemble a new copy of DSICTMOD.
DSI341I command FAILED FOR ID = name1.
System action INVALID target = 'name2', SENSE
Processing of the command ends. CODES = X'codes'

Operator response Explanation


Correct the value and enter the command again. The command failed because you used a line or station
name that is not valid.
DSI336I LOAD FAILED FOR NCCF MODULE
Message Variables
module IN object
command
Explanation The name of the command.
name1
An attempt to load the NCCF module failed.
The name of the destination network node.
Message Variables target
module LINE or STATION.
The NCCF module for which the load failed. name2
object The line or station attached to the network node.
The member containing the error, or the name codes
of an embedded member if the error indicated The system sense codes.
by the message occurred in a member included
(%INCLUDE statement) in member. If multiple
levels of embedding occurred within member, only
System action
the level where the error occurred is specified. Processing of the command ends.
DSI337A YOUR RUNNING COPY OF
NETVIEW CONSTANTS MODULE Operator response
DSICTMOD HAS NOT BEEN
Notify the system programmer and enter the
UPDATED TO THE CURRENT
command again using the correct name.
MAINTENANCE LEVEL.
DSI342I DEVICE NAME name1 ON
Explanation command DIFFERENT FROM
DEVICE NAME name2 ON
NetView initialization has detected that your running PRECEDING CCPLOADI
copy of the NetView constants module (DSICTMOD)
does not have the correct length. Your NetView
Explanation
program has undergone maintenance that increased
the length of DSICTMOD, but a copy of CNMS0055 The NetView program issues this message when it
tries to process a CCPLOADT or CCPLOADF command

674 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


with a name that is different from the name of the System action
preceding CCPLOADI command. The NetView program
might issue this message in response to a CCP- The NetView program ends the processing of the DR
generated command list. sequence and gives a return code of 4.

Message Variables
Operator response
name1
The network name specified on the CCPLOADT or Notify the system programmer that the command list
CCPLOADF. you used failed with this message.

command
CCPLOADT or CCPLOADF. System programmer response
name2 Ensure that the command list was not modified since it
The network name specified on the CCPLOADI. was generated by CCP. Ensure the command list uses
the proper sequence of commands and the proper
parameters.
System action
DSI345I TEST RESULT RETURNED HAS NO
The NetView program ends the processing of the load
CORRESPONDING EXPLANATION
sequence and gives a return code of 4.

Operator response Explanation


The NetView program issues this message when the
Notify the system programmer that the command list
device returns a test result code which it cannot
you used failed with this message.
identify as one supported by the NetView program.

System programmer response


System action
Ensure the command list was not modified since it was
The NetView program ends processing.
generated by CCP. Ensure that the command list uses
the proper sequence of commands and the proper
parameters. Operator response
DSI343I DEVICE NAME name1 ON Notify the system programmer.
CCPDR TYPE type DIFFERENT
DSI357I command keyword RESTRICTED
FROM DEVICE NAME name2 ON
TO COMMAND LIST USAGE
PRECEDING CCPDR TYPE F

Explanation Explanation
The NetView program issues this message in response
The NetView program issues this message when it
to a command that used a keyword restricted to
calls a CCPDR type M or type L command with a name
command lists.
parameter that is different from the preceding CCPDR
type F command. The NetView program can issue this Message Variables
message in response to a CCP-generated command
command
list.
The name of the command.
Message Variables keyword
name1 The keyword in question.
The network name specified on the CCPDR type M
or L. System action
type
The NetView program stops processing the command.
M or L.
name2
The network name specified on the CCPDR type F.
Operator response
If you need to enter this command, notify the system
programmer.

Chapter 7. DSI Prefix Messages 675


System programmer response • You specified a PF key number that is not valid.

Tell the operator the name of the command list needed Message Variables
to call this command. command
DSI358I command FAILED. ID 'nodename' The name of the NetView command that
IS status, SENSE CODES = established the given session with a remote
X'sensecode' device.
text
Explanation The reason the screen cannot be formatted as
specified by the remote device.
This message is issued in response to a command
whose destination is not valid, is unknown, or not
System action
activated.
The central site control facility reformats the data
Message Variables
that is in error according to established procedures.
command The modified panel is then displayed and processing
The name of the command. continues.
nodename
The name of the node entered with the keyword Operator response
ID. If the message is output from a LAN command,
nodename is the name of the node entered with Purge the command VSAM database. If the problem
the keyword SP. continues, notify the system programmer.

status
INVALID indicates that the node definition is System programmer response
missing. INACTIVE indicates that the node has not Document the circumstances of the error and contact
been activated. IBM Software Support.
sensecode
DSI360I command REQUEST IN PROGRESS
The system sense code returned with the
response.
Explanation
System action The command request is being processed by the
system.
The NetView program discontinues processing the
command. Message Variables
command
Operator response The name of the NetView command that
established the given session with a target
Ensure the resources you specified on the command
application.
are correct. If so, notify the system programmer.

System programmer response Operator response


Wait until the command request completes, or enter
Check the resource definition.
NetView commands while waiting.
DSI359I command SCREEN FORMATTING
DSI361I command REQUEST CURRENTLY
ERROR: text
OUTSTANDING FOR SESSION --
REQUEST REJECTED
Explanation
The NetView program is unable to properly format the Explanation
panel using the data provided by the data supplier. For
A command request is in progress. Another command
example:
request for the session cannot be entered at this time.
• The panel title, wording for the PF keys, data to be
Message Variables
placed on the message line, or data to be placed on
the command line is too long.
• You requested too many PF key definitions.

676 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


command command
The name of the NetView command that The name of the NetView command that
established the given session with a target established the given session with a remote
application. device.
source
System action The component that detected the problem. This
can be the CSCF, PU, or VSAM.
The request is ignored and the original command
processing continues. majcode
The major sense code data.

Operator response mincode


The minor sense code data.
You can do one of the following:
• Wait until the first request completes. System action
• Enter NetView commands while waiting. If the error was detected by the central site control
• If a panel is currently displayed, press the END PF facility (CSCF) or PU, the CSCF ends. If the error was
key to end the command session. detected by VSAM, the central site control facility
continues processing, although performance might be
DSI362I command PANEL TEMPLATE DATA degraded.
BASE IS FULL

System programmer response


Explanation
Determine the cause of the error based on the major
The command VSAM panel template database is full, and minor return codes. See the DSIZCSMS return
and command is unable to add any more records. codes in IBM Z NetView Programming: Assembler, or
Message Variables refer to the appropriate PU or VSAM manuals for codes
for those products.
command
The name of the NetView command that System errors refer principally to internal CSCF or
established the given session with a remote VSAM errors. If a system error occurred, collect
device. the error documentation and contact IBM Software
Support.
System action Network errors are indicated by SNA sense data from
the PU or VTAM. If a network error occurred, correct it
Processing continues, although performance might be and invoke the central site control facility again. This
degraded. The command variable cannot store any message can be accompanied by message DSI364I,
newly received panel templates in the database, and DSI366I, or both.
must request them of the remote device each time
they are needed. DSI364I EXCEPTION DATA FOR MSG
msgnum. dataname = X'data'
Operator response
Explanation
You can run a PURGE command to remove unwanted
panel template data records. This message is written to the network log in
conjunction with other messages. It provides further
DSI363I command ERROR DETECTED BY information about the error.
source. MAJOR CODE = majcode
MINOR CODE = mincode Message Variables
msgnum
Explanation The message to which the DSI364I message
applies.
An error related to the central site control facility
processing occurred. dataname
The pertinent identifier to which the exception
Message Variables data applies.

Chapter 7. DSI Prefix Messages 677


data If this message was issued for the DLA component,
The hexadecimal exception data that gives specific the description specifies the xml file name that is
information about the error. required by the Common Data Model.

Operator response System action


Notify the system programmer. This message is written to the network log only. It is
not displayed on the operator's screen.
System programmer response
Operator response
System errors refer principally to internal NetView
command processor errors or VSAM errors. If a system Notify the system programmer.
error occurred, collect the error documentation and
contact IBM Software Support. System programmer response
Network errors are indicated by SNA sense data
If a system error occurred, collect the error
from the remote device or VTAM. If a network error
documentation and contact IBM Software Support. If
occurred, correct it and issue the command again.
a network error occurred, correct it and invoke the
DSI365I WARNING: INVALID DATA central site control facility again.
STREAM RECEIVED
DSI367I command PANEL ID MISMATCH

Explanation Explanation
A data stream that is not valid was received by
The panel ID for the panel template sent from the
NetView program.
remote device is not the one expected; it does not
match the panel ID sent with the data to be displayed.
System action
Message Variables
This message can appear on an operator's screen
command
and in the network log. Either message DSI364I or
The name of the NetView command that
message BNH621I can accompany this message in
established the given session with a remote
order to provide additional information about the error.
device.

Operator response System action


Notify the system programmer.
In addition to being displayed on the operator's
screen, this message is written to the network log.
System programmer response When it is written to the log, message DSI366I can
also be written to provide further information about
Collect the error documentation and contact IBM
the error. If a panel is currently displayed, the message
Software Support.
is displayed on that panel. If not, command ends,
DSI366I ADDITIONAL INFORMATION FOR and the message is displayed on the command facility
MSG DSI416 remotefilename screen.

Explanation Operator response


This message always occurs in conjunction with Notify the system programmer.
the DWI416I message. The remotefilename variable
indicates the correct name for the DLA output file System programmer response
defined in the DLA.xml_filename parmin CNMSTYLE.
Collect the error documentation and contact IBM
Message Variables Software Support.
msgnum
DSI368I AN IMPORTANT MESSAGE HAS
The message number that is associated with this
BEEN WRITTEN TO THE NETVIEW
DSI366I message.
LOG
description
Additional information.

678 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System programmer response
An important message was written to the network log Verify that the DDNAME is valid and was entered
to provide information about the error. correctly. If the DDNAME conflicts with a required
allocation, then allocate the file with a different
System action DDNAME.

Previous messages have been written to the network DSI371I ALLOCATE COMMAND FAILED,
log. MUTUALLY EXCLUSIVE OPERANDS
ENTERED

Operator response
Explanation
Check the log for the important message. If necessary,
notify the system programmer. You entered an ALLOCATE command with operands
that cannot be used on the same command. They are
mutually exclusive.
System programmer response
Collect the error documentation and contact IBM System action
Software Support.
The NetView program stops processing the command.
DSI370I ALLOCATE COMMAND FAILED,
'ddname' IS ALREADY IN USE
Operator response
Explanation Determine which operands are mutually exclusive and
enter the command again correctly. If you are unable
You tried to allocate a file with a DDNAME that is to resolve the problem, notify the system programmer.
already allocated to the NetView program.
Message Variables System programmer response
ddname Determine which operands are mutually exclusive.
The DDNAME you specified on the ALLOCATE
command. DSI372I FREE COMMAND FAILED, 'file' IS
NOT ALLOCATED

System action
Explanation
The NetView program stops processing the command.
You tried to deallocate a file that was not allocated.

Operator response Message Variables

Verify that you entered the DDNAME correctly. If so, file


use the LISTA command to display the file currently The DDNAME or data set name specified on the
allocated with the DDNAME. FREE command.

If the LISTA command shows that the file you are


trying to allocate is already allocated, you do not need
System action
to issue another ALLOCATE command. If a different The NetView program stops processing the command.
file is allocated with the DDNAME you are trying to
allocate your file with, either use the FREE command
Operator response
to deallocate the other file, or allocate your file with a
different DDNAME. Verify that you entered the DDNAME or data set name
correctly. If the file that is not allocated should have
You can issue the ALLOCATE command without a
been, notify the system programmer.
DDNAME, and the NetView program assigns the file
a unique DDNAME. The NetView program issues a
message telling you the DDNAME it assigns. System programmer response
If you are unable to resolve the problem, notify the Determine why the file was not allocated. Possibly,
system programmer. the file was previously deallocated. If the file was
allocated with the FREE parameter, it is automatically
deallocated when it is closed.

Chapter 7. DSI Prefix Messages 679


DSI373I FREE COMMAND FAILED, FILE IS For other tasks, the task might have had a sudden
OPEN surge of messages.
Message Variables
Explanation
number
You tried to use the FREE command to free a file that is The number of buffers on the specified task's
currently open to the NetView program. message queue
task
System action The name of the task that is not processing its
message queue
The NetView program stops processing the command.

System action
Operator response
The NetView program continues normal processing.
Some NetView files cannot be freed by the FREE The specified task's message queue continues to build
command. These files are: up.
STEPLIB
CNMPNL1 Operator response
BNJPNL1
If the specified task is an OST, roll to the command
BNJPNL2
facility panel and turn on AUTOWRAP to allow the
DSIARPT messages to be processed. If the specified task is
DSIASRC a hardcopy task, take any necessary steps to return
DSICLD the printer to operating order so that processing can
DSILIST continue. For other tasks, monitor the task for more
DSILOG DSI374A messages. If any message queue continues
DSIMSG to build, you might want to issue a STOP FORCE
command for the task to keep the NetView program
DSIOPEN
from running out of storage.
DSIPARM
DSIPRF Notify the system programmer.
DSIVTAM
Other files allocated to the NetView program can be
System programmer response
freed before they are opened or after they are closed. The number of messages that can build up on a
Notify the system programmer. message queue without causing storage constraints
on all NetView processing varies, depending on how
System programmer response much storage beyond the NetView program's normal
usage is in the NetView region. You might need
Determine what the file was being used for when the to change the default thresholds accordingly. The
message was issued. Look for a situation where the file defaults for the task message queue thresholds are
is being used by multiple tasks and synchronization is defined in DSICTMOD, which assembles and link-edits
a problem. the NetView constants module.
DSI374A THRESHOLD REACHED, number Note: Consider routing this message to more than
BUFFERS ON MESSAGE QUEUE OF one operator to reduce the risk of the message not
task being displayed. Route the message using the ASSIGN
command or NetView automation.
Explanation DSI375I command FAILED, REQUEST
The threshold for the buffers on the message queue DENIED BY INSTALLATION
of the specified task was reached or exceeded. The VALIDATION EXIT
task is receiving messages but not processing them. If
the specified task is an OST, the operator might have Explanation
AUTOWRAP off, might be in a full-screen session, or
might have a device problem. If the specified task is a Your ALLOCATE or FREE command was canceled
hardcopy task, the printer might require intervention. by a user-written, dynamic-allocation, installation-
validation exit.

680 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables task
The name of the data services task specified on
command
the LISTCAT command.
ALLOCATE or FREE.

System action System action


Processing continues.
The NetView program stops processing the command.
DSI378I SESSION MONITOR SESSION AND
Operator response STORAGE INFORMATION

Notify the system programmer.


Explanation
System programmer response This message is the header line for a multiline
response to a SESSMDIS command entered from an
Determine why the command was rejected by your autotask or a NetView-NetView session. Information
installation exit. on network session counts and traffic rate, and session
monitor storage usage follows this message.
DSI376I SUBMIT COMMAND FAILED, RACF
AUTHORIZATION FAILED FOR
DATASET dataset System action
Processing continues.
Explanation
DSI379I DATA SERVICES REQUEST BLOCK
Your SUBMIT command failed because your RACF FOR task
profile does not allow you to access the data set you
are trying to submit.
Explanation
Message Variables
This message is the header line for a multiline
data set response to a DSRBS command entered from an
The name of the data set containing the job or jobs autotask, NetView-NetView session, or the PPT task.
you are submitting. Information on data services request block usage
for the data services task specified on the DSRBS
System action command follows this message.

The NetView program stops processing the command. Message Variables


task
Operator response The name of the data services task specified on
the DSRBS command.
Notify the system programmer.
System action
System programmer response
Processing continues.
Determine whether the user can be allowed to submit
the data set. If they can, give the user RACF access to DSI380I PMX HAS STARTED
the data set.
DSI377I LISTCAT OF ACTIVE VSAM DATA
Explanation
BASE FOR task The PROP/NCCF message exchange (PMX) has started.

Explanation System action


This message is the header line for a multiline PMX starts.
response to a LISTCAT command entered from an
autotask, NetView-NetView session, or the PPT task. DSI381I STORAGE FAILURE FOR DSICRTR,
VSAM performance and tuning statistics for the data ALERTS WILL NOT BE
services task specified on the LISTCAT command FORWARDED
follow this message.
Message Variables

Chapter 7. DSI Prefix Messages 681


Explanation System programmer response
Because of the storage failure, alerts cannot be Determine the reason why the alerts cannot be
forwarded to the focal point. forwarded.
DSI383I UNABLE TO SEND DATA TO
System action focalpt1, ALERTS ARE BEING
Processing continues without alerts being forwarded. FORWARDED TO focalpt2

Operator response Explanation


Notify the system programmer. The NetView program is unable to forward alerts to the
target focal point. Alerts are being forwarded to the
new primary or backup focal point.
System programmer response
Message Variables
Determine the cause of the storage failure for
DSICRTR. focalpt1
The name of the target focal point to which alerts
DSI382I UNABLE TO SEND DATA TO focalpt, cannot be forwarded.
n ALERTS NOT FORWARDED
focalpt2
The name of the new primary or backup focal point
Explanation to which alerts are being forwarded.
The NetView program is unable to forward alerts to the
focal point. System action
When using the SNA-MDS LU 6.2 alert forwarding Processing continues, with alerts being forwarded to
protocol, and communication has been lost with the the new focal point.
alert focal point, the hardware monitor attempts to
DSI384I UNABLE TO SEND DATA TO TASK
keep alerts in an alert cache until they can be sent to
task, TASK NOT ACTIVE
the focal point. If no cache is defined or if alerts roll
off the alert cache before communication with an alert
focal point is established, alerts can be lost. When Explanation
communication is re-established with an alert focal
An attempt to use the message queuing service (MQS)
point, these lost alerts cannot be forwarded and this
to queue a buffer from a foreign domain or a NetView
message is issued. Furthermore, if 10 000 alerts are
subtask to the specified task failed because the task
lost, this message is issued and the counter is reset to
was not active.
0.
Message Variables
Message Variables
task
focalpt
The name of the task to which the data was being
The name of the primary or backup target focal
sent
point to which alerts cannot be forwarded. When
using SNA-MDS alert forwarding and a current alert
focal point exists, the name of the focal point is System action
displayed as netid.nau. When no focal point exists,
The buffer storage is freed.
ALERTFP is displayed.
n
Operator response
The number of alerts that have not been
forwarded. Determine why the task is not active and if possible,
restart it.
System action DSI385I ASSIGN COMMAND
Processing continues without alerts being forwarded. UNSUCCESSFUL - MAXIMUM OF
255 OPERATORS REACHED

Operator response
Notify the system programmer.

682 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
You attempted to assign operators to a message RESETDB successfully cleared the VSAM database
routing group that has reached the maximum size of specified by ddname.
255 operators.
Message Variables

System action ddname


The DDNAME of the VSAM file.
If you specified only one operator name on the
ASSIGN command, that operator was not added to
System action
the message routing group. If you specified more than
one operator name, some of the operators might have The RESETDB command cleared the VSAM database.
been added to the group before the 255 maximum
was reached. DSI390I PMX IS NOT STARTED

Operator response Explanation


Notify the system programmer. The PROP/NCCF message exchange (PMX) was not
started.

System programmer response


System action
If more than one operator name was specified on
the ASSIGN command, issue a LIST ASSIGN=GROUP The related command is rejected.
command to determine which operators were not
added to the message routing group. In addition, Operator response
use the LIST command to determine if there are any
Start PMX and issue the related command again.
operator names in the group that can be deleted to
free up space for other names you want to add. DSI391E AUTHNAME FOR segname FAILED
R15 = retcode
DSI386I NETVIEW RESOURCE
UTILIZATION hh:mm:ss
Explanation
Explanation This message is for VM systems only. The specified
segment name was not installed correctly. The
This message is a response to a RESOURCE
NetView program cannot load this module as a
command entered from an autotask, NetView-to-
discontiguous shared segment under GCS.
NetView session, or an OST task. The message is
the header of a multiline message that displays total Message Variables
complex CPU utilization, NetView CPU utilization, and
segname
NetView storage. See the NetView online help for more
The name of the segment that cannot be
information about the RESOURCE command.
initialized.
Message Variables retcode
hh:mm:ss The register 15 return code from the AUTHNAME
The current time in hours, minutes, and seconds. GCS service:
The time format depends on the TRANSMSG • 00000004 indicates that there is already a copy
member, when in effect, and on the time operands of the shared segment module loaded. Multiple
of the DEFAULTS and OVERRIDE commands. NetView systems share the same copy. This is an
informational message only.
System action • FFFFFFFD indicates the NetView virtual machine
Processing continues. is not an authorized GCS machine.
• FFFFFFF8 and 00000008 indicate that segname
DSI387I DATA BASE ALLOCATED TO
was not installed as a shared segment.
'ddname' HAS BEEN CLEARED
• Other codes indicate possible NetView program
errors.

Chapter 7. DSI Prefix Messages 683


System action System programmer response
The NetView program ignores the condition and If message DSI391E was issued when the NetView
continues processing with limited STOP FORCE and program was started, see the description of DSI391E
CLOSE IMMED capabilities. The NetView program for further assistance (enter HELP DSI391). If
issues message DSI392E to the authorized message message DSI391E was not issued when the NetView
receiver to indicate that a STOP FORCE or CLOSE program was started, there is the possibility of a
IMMED command has not completed successfully. NetView program error. Check for storage shortage
error messages or other indications of damage. It
Operator response might be necessary to issue a CLOSE DUMP command
to diagnose the problem. If needed, contact IBM
Notify the system programmer. Software Support.
DSI393I LOCAL OPTION IGNORED, NOT
System programmer response SUPPORTED WITH INSTALLED
If the register 15 return code is FFFFFFFD, add an VERSION OF VM/SP
AUTHUSER statement to the GCS GROUP definition file
and regenerate GCS. Explanation
For other register 15 return codes, review the The LOCAL option on the GCS NETVIEW START
installation procedures for segname as a discontiguous command does not work on the version of the VM
shared segment. Verify that the DMKSNT ASSEMBLE operating system that you have installed.
file was updated for segname. Verify that the GCS
GROUP has segname defined as a shared segment. For
VM, verify that the G5664204 EXEC did not generate
System action
error messages for segname. Verify that both the CP Processing continues without support of local errors.
nucleus and GCS nucleus were regenerated to include
the DMKSNT update and GCS group changes. Use the
Operator response
CP DISPLAY command to verify that the SEGNAME
shared segment is loaded at the absolute address Notify the system programmer.
used when it was loaded during the installation.
If needed, contact IBM Software Support. System programmer response
DSI392E UNABLE TO SCHEDULE ABEND Do not specify the LOCAL option on the command.
257 FOR task
DSI394I INVALID OPTION(S) SPECIFIED

Explanation Explanation
This message is sent to the authorized message
You specified an option on the GCS NETVIEW START
receiver. The NetView program was unable to
command that is not valid.
complete processing of a CLOSE IMMED or STOP
FORCE command.
System action
Message Variables
The NetView program rejects the command.
task
The name of the task that cannot be ended.
Operator response
System action Notify the system programmer.
The NetView program ignores the condition and
continues processing. This message is issued each System programmer response
time a STOP FORCE is attempted for a task that cannot Correct the command and enter it again.
be stopped.
DSI395I SYSTEM ERROR, PMX START FAIL
Operator response
Explanation
Notify the system programmer.
You tried to start the PROP/NCCF message exchange
(PMX) and it failed to start.

684 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action DSI399I APPLICATION NETVIEW
PREVIOUSLY STARTED, REQUEST
The NetView program rejects the command. FAILED

Operator response Explanation


Notify the system programmer. You tried to start the NetView program or PROP/NCCF
message exchange (PMX) while the NetView program
System programmer response was running.
Determine the reason for the START command failure.
System action
DSI396I SYSTEM ERROR, NETVIEW START
FAIL The NetView program rejects this command and
continues to run.
Explanation DSI400A SECURITY SOFTWARE USER
IDENTIFICATION CANNOT BE
You tried to start the NetView program and it failed to
FOUND, REENTER
start.

Explanation
System action
The security software rejected your attempt to log
The NetView program rejects the command.
on for an operator task. The operator identification
entered is not defined to the security software. For
Operator response other tasks (for example PPT and CNMCSSIR), the task
name was not defined to the security software.
Notify the system programmer.

System action
System programmer response
The logon is rejected.
Determine the reason for the START command failure.
DSI397I INVALID OR MISSING Operator response
PARAMETERS
If you are trying to log on to an operator task, enter
the LOGON command again with the correct operator
Explanation identification, or enter LOGOFF in the operator ID field.
You entered a NetView command using incorrect If you are trying to log on to the PPT, notify the system
parameters. programmer.

System action System programmer response


The NetView program rejects the command. Add the operator identifier to the security software
data set. Verify that the PPT name has been added to
the security software data set.
Operator response
DSI401A SECURITY SOFTWARE PASSWORD
Correct the parameters and enter the command again.
IS NOT AUTHORIZED, REENTER
DSI398I APPLICATION PMX PREVIOUSLY
STARTED, REQUEST FAILED Explanation
The security software rejected your attempt to log on.
Explanation
The password or password phrase that you entered
You tried to start the NetView program or PROP/NCCF was not recognized.
message exchange (PMX) while PMX was running.
System action
System action
The NetView program rejects your logon.
The NetView program rejects this command and
continues to run PMX.

Chapter 7. DSI Prefix Messages 685


Operator response System programmer response
Enter the LOGON command again with the correct Correct the condition that caused the installation exit
password or password phrase, or enter LOGOFF in the to reject the logon or environment creation attempt.
operator ID field.
DSI404I SECURITY SOFTWARE IS NOT
Note: If you entered your operator identification ACTIVE
correctly, ask the system programmer to correct the
security software data set.
Explanation
System programmer response The NetView program rejected your logon, or an
attempt to create the security environment with
Verify the identification and correct the security other tasks (for example PPT and CNMCSSIR) failed,
software data set if necessary. because the security software is not active even
though you previously indicated security software
DSI402I SECURITY SOFTWARE PASSWORD
logon authorization. The security software either has
HAS EXPIRED
not been activated or has been stopped.

Explanation
System action
The security software rejected your attempt to log on.
The NetView program rejects your logon or
The password or password phrase you entered was
environment creation attempt.
recognized, but it has expired.

Operator response
System action
Enter LOGOFF in the operator ID field. Notify the
The logon is rejected.
NetView operator to activate the security software.

Operator response System programmer response


If only one password field is displayed on your logon
Activate the security software or change the value
panel, press the ENTER key to change the password
of SECOPTS.OPERSEC in the CNMSTYLE member, or
or password phrase. Enter the expired password or
by using the REFRESH command to specify a value
password phrase in the PASSWORD field and a new
that does not require security software. See IBM Z
password or password phrase in each of the two
NetView Installation: Getting Started for information
NEW PASSWORD fields. The passwords or password
about making changes to the CNMSTYLE member.
phrases that you type into both the NEW PASSWORD
fields must be identical. Log on again. DSI405I UNEXPECTED ERROR - REGISTER
15= X'code' SECURITY RC=
DSI403I SECURITY SOFTWARE FUNCTION
X'code1'
REJECTED BY INSTALLATION EXIT

Explanation
Explanation
An attempt to log on or for other tasks such as
For an operator task, one of the security software
the PPT and CNMCSSIR, an attempt to create the
installation exits rejected your attempt to log on. For
security environment for this task was rejected by
other tasks (for example PPT and CNMCSSIR), the
the security software. A condition occurred that the
security software installation exit rejected an attempt
NetView program was not prepared to handle with an
to create the security environment for this task.
explicit error message.

System action Message Variables


code
The logon or environment creation attempt is rejected.
The return code from the RACROUTE macro.
code1
Operator response The return code from the security software.
For an operator task, enter LOGOFF in the operator ID
field. Notify the system programmer of the condition.

686 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action stmt2
The second control statement.
The NetView program rejects your logon or
environment creation attempt.
System action
Operator response The NetView program processes the second control
statement you entered. The NetView program then
For an operator task, enter LOGOFF in the operator processes the first control statement you entered, but
ID field. Notify the system programmer of the code the program uses the default parameter values instead
returned in register 15 and of the security software of the values you specified.
return code.

Operator response
System programmer response
Notify the system programmer.
Refer to the appropriate MVS manual for more
information about the RACROUTE and security
software return codes. System programmer response
DSI406I task : AUTOFLIP=YES INVALID, Correct the order of the control statements.
SECONDARY DATASET NOT DSI408I NCCF MESSAGE msgnum ISSUED
ACCESSIBLE WITH STRING INSERT insnum
WHICH IS NOT DEFINED
Explanation
AUTOFLIP=YES requires a secondary data set. Either Explanation
there is no secondary data set or it cannot be opened. The NetView program issues the message and
Message Variables specifies an insert to be defined, but that insert was
not found.
task
The name of the task. Message Variables
msgnum
System action The number of the message.

Logging starts as if AUTOFLIP=NO was coded. insnum


The number of the insert that is not defined.

Operator response
System action
Notify the system programmer.
The NetView program displays this message with &n
as the insert number, where n is in the range of 1–9.
System programmer response
Fix the secondary data set if necessary. Otherwise, do Operator response
not code AUTOFLIP=YES on the LOGINIT statement.
Notify the system programmer.
DSI407I task : SEQUENCE ERROR: 'stmt1'
INCORRECTLY PRECEDES 'stmt2'
System programmer response
Explanation Check the definition in DSIMSG.

You have entered two control statements in incorrect DSI409I TASK DSIPRT COMPLETED
order. SUCCESSFULLY

Message Variables
Explanation
task
The disk log has printed successfully.
The name of the task.
stmt1 DSI410I DSIPARM MEMBER member BEING
The first control statement. USED FOR NETVIEW AUTOMATION

Chapter 7. DSI Prefix Messages 687


Explanation System programmer response
You receive this message upon completion of the Correct the automation statements in error and enter
AUTOTBL command or in response to an AUTOTBL the command again.
STATUS command. The automation table is reloaded
DSI415I END OF object ERROR DISPLAY
when this message is received in response to any
AUTOTBL MEMBER= command.
Explanation
Message Variables
This is the trailer line telling you that the display of
member
related error messages has ended.
The name of the member specified by the
AUTOTBL command. Message Variables
DSI411I NETVIEW AUTOMATION INACTIVE object
The name of the member or file with errors
Explanation
System action
You receive this message in response to an AUTOTBL
command or an AUTOCNT command. The NetView The command, or the initialization of this code point
automation table function is not being used. table, ends.
DSI416I PROCESSING FAILED FOR
System action 'command' COMMAND
Incoming messages/MSUs are not automated. This
does not mean that all processes that began while Explanation
automation was active have completed, or that storage
The command processing did not complete
and ATFs associated with old automation tables have
successfully. There might be additional messages to
been released.
further describe the failure.
DSI412I THE FOLLOWING ERRORS
Message Variables
ENCOUNTERED IN PROCESSING
DSIPARM MEMBER member command
The command you entered.
Explanation • For the ASSIGN, AUTOTBL, AUTOTEST, or CPTBL
command, the previous automation or code
This is the header line for the automation
point table still resides in storage. Associated
control statement error messages encountered while
messages might indicate the reason for the
processing an ASSIGN, AUTOTBL, or AUTOTEST
failure. However, if the command is ASSIGN,
command.
AUTOTBL, AUTOTEST, or CPTBL and the table
Note: If member begins with a question mark (?), the specified in command contains no entries, this is
input is being received from a PIPE message stream the only message you receive.
instead of a DSIPARM data set member. • For the AUTOTBL command, see the DSI410I or
Message Variables DSI411I message that follows to see the current
status.
member
The name of the member specified with the • For the AUTOTEST command, see the BNH336I
command or BNH337I message that follows to see the
current status.

System action • For the CNMFTP command, see the DSI366I


message that follows for the name of the xml file
The command continues. that is required by the Common Data Model.
• For the TCPCONN or PKTS command, the
Operator response problem can be that the z/OS Communications
Server is not at a high enough level, or is not
Notify the system programmer that there are errors in
configured to support these functions.
the specified NetView automation member.
• For the TASKUTIL command, there was an error
in the data collected for the available processors
on the system, which persisted for the maximum

688 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


number of data collection attempts. See the line number within the file where the error was
DWO050E message the TASKUTIL command detected.
also logged for data from the last collection text
attempt. The control statement containing a syntax error.
• For the RESOURCE command, there was an error READSEC authority checking is performed before
in the data collection that persisted for the this message is issued. If the operator is not
maximum number of data collection attempts. authorized to access the automation table member
See the DWO050E message the RESOURCE in DSIPARM, text is replaced by 'suppressed'.
command also logged for data from the last
Note: For a message revision table, this text might
collection attempt.
include information from multiple lines.

Operator response System action


Notify the system programmer of the problem.
The command continues.
• For the AUTOTBL command, if the current
automation status is unacceptable, reenter the Operator response
command with another file name or the OFF
operand. Notify the system programmer.
• For the AUTOTEST command, use the STATUS
operand to find out the status of automation table System programmer response
testing or recording.
Correct the automation control statement containing
• For the TASKUTIL command, reenter the command the error.
with a larger value for the DURATION keyword.
DSI418I TOO MANY exittype EXITS
• For the RESOURCE command, reenter the command.
DEFINED. EXTRA EXIT
If the problem persists, the TASKUTIL command
DEFINITIONS IGNORED
and the z/OS Resource Measurement Facility (RMF)
may be able to provide much of the information
that could not be collected successfully with the Explanation
RESOURCE command.
Too many exits of the specified type are defined. You
can define a maximum of 10 exits for a specific exit
System programmer response type for each task.
Correct the problem indicated by the associated Message Variables
messages. If this message occurs by itself, it can
exittype
indicate an empty or missing file.
The type of exit.
DSI417I file : seqnum : text
System action
Explanation Only the first 10 exits of the specified type are defined.
This message displays an automation control The NetView program ignores the additional exits.
statement containing a syntax error. It follows
immediately after the message giving the type of Operator response
syntax error. If the statement is greater than 256
characters, it is truncated. Notify the system programmer.
Message Variables
System programmer response
file
The name of the file that contains the entry in Define only 10 exits of the specified type.
error. DSI421I command FAILED FOR ID = node,
seqnum STATION = device
For an automation table, this is the 8-character
sequence number field of the first record of
the automation statement that generated this
error. For a message revision table, this is the

Chapter 7. DSI Prefix Messages 689


Explanation Explanation
The command has failed for the device owned by the This is the message associated with the error recovery
specified node. Message DSI422I or DSI428I follows action. It is preceded by DSI421I and DSI422I which
with error text which gives the reason for the failure. explain the error.
Message Variables Message Variables
command responsemsg
The name of the command as it was entered. A brief explanation of recovery procedures.
node
The name of the node that issues the command to System action
the station.
Processing continues and the NetView program
device ignores the request.
The PU name of the end-use device associated
with the modem pair.
Operator response
System action See the responsemsg to determine the response to the
failure.
Processing continues and the command request is not
run. DSI424I command DISPLAY FOR ID = node,
STATION = device
Operator response
Explanation
Respond according to the associated message
DSI422I or DSI428I. This is the initial message for the command display
message.
DSI422I codetype CODE = X'code' REASON
= errortext Message Variables
command
Explanation The name of the command as it was entered.

This is the failing reason code and text for the node
command specified in the associated message The name of the node that issues the command to
DSI421I. the station.
device
Message Variables
The PU name of the end-use device associated
codetype with the modem pair.
SENSE or RETURN.
code System action
The sense or return code received in the modem
response. Processing continues. The NetView program supplies
additional messages with specific information about
errortext the command request.
A brief explanation of the failure.
DSI428I SENSE = X'codes' REASON =
errortext
System action
Processing continues and the NetView program Explanation
ignores the command.
This is the failing sense code and text for the
command specified in the associated message
Operator response DSI421I. This indicates that the request failed
A corresponding recovery message, DSI423I, follows if because the using node detected an error specified by
more information is available. the sense code.

DSI423I RESPONSE = responsemsg Message Variables

690 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


codes Explanation
The system sense and modifier sense returned in
the error reply subvector or negative response. The request failed because you entered a value that
is not valid in a field. This message displays on
errortext the change screen with only the field that is not
A brief explanation of the failure. valid highlighted. The modem configuration does not
change.
System action
Processing continues and the NetView program System action
ignores the request. Processing continues and the NetView program
ignores the command.
Operator response
Notify the system programmer. Operator response
Check that the correct values are in the changed fields.
System programmer response If they are correct, notify the system programmer.
Refer to the appropriate VTAM manual for the
explanation of the system sense and modifier sense System programmer response
codes. Determine the correct values.
DSI430I field1 INCOMPATIBLE WITH field2 DSI432I MODEM CONFIGURATION
field3 disposition

Explanation Explanation
The request failed because you entered an This message indicates whether the request was
incompatible value in the field. This message is successful.
displayed on the change screen with the incompatible
field highlighted. The modem configuration does not Message Variables
change. disposition
Message Variables The state of the configuration.
field1 UPDATED
The value you entered for field1. The configuration was updated.
field2 NOT UPDATED
The value you entered for field2. The configuration was not updated.
field3 DSI433I INVALID PANEL COMMAND
The value you entered for field3.
Explanation
System action
The request failed because you entered a value that is
Processing continues and the NetView program not valid in the command field. This message displays
ignores the command. on the change screen with only the field that is not
valid highlighted. The modem configuration does not
Operator response change. The only valid command for this screen is
CANCEL.
Check that the correct values are in the change fields.
If they are correct, notify the system programmer.
System action
System programmer response Processing continues and the NetView program
ignores the request.
Determine the correct values.
DSI431I INVALID FIELD HIGHLIGHTED, Operator response
CONFIGURATION NOT UPDATED
Check that the correct command is in the command
field. If it is correct, notify the system programmer.

Chapter 7. DSI Prefix Messages 691


System programmer response Explanation
Determine the error and correct the command. The NetView program is unable to determine whether
the returned information came from the request
DSI434I DEFAULT VALUES RETURNED BY modem. It might have come from a modem on a link
MODEM FOR UNRELIABLE FIELDS segment level before the requested level.

Explanation System action


The modem found unreliable data in the RAM when Processing continues.
retrieving information that was to be returned for the
read configuration command. Rather than return this
information, the modem uses the default values found Operator response
in the ROM. Check the same modem (local or remote) on the link
segment level before this one. If it is idle, configure
System action that modem first. If it is running, go back to the original
modem and configure it in spite of the message.
Processing continues.

System programmer response


Operator response
If the second modem is idle, define configuration for
If this is a change configuration command, update the that modem.
fields and send them back to the modem.
DSI437I MODEM COMMAND INTERCEPTED
DSI435I command COMMAND ENDED DUE BY WRONG MODEM
TO stringinsert

Explanation
Explanation
The modem command that the NetView program sent
The command ended because of the reason given in out was intercepted by another modem on the link.
the string insert. That modem does not know its own address and
Message Variables assumes that any command it receives is meant for
itself.
command
The name of the failing command.
System action
stringinsert
The reason for the failure. The processing of this command stops.

System action Operator response


Processing stops. If the modem you requested is local, level 2, configure
the remote, level 1 modem first. If it is remote, level 1,
Operator response configure the local level 1 modem first. If it is remote,
level 2, the modem you need to configure is either the
If another command is in progress, wait until it ends local, level 1 modem or the local, level 2 modem.
and enter the command again. If there is not another
command in progress, enter the command again. If the
System programmer response
second attempt fails, notify the system programmer.
Define configuration for the modem that needs an
System programmer response address.

If this is a change configuration command, the fields DSI439I TOO MANY DIGITS IN PHONE
can still be updated and sent back to the modem. NUMBER(S)
Collect the problem determination data and contact
IBM Software Support. Explanation
DSI436I INFORMATION DISPLAYED MAY The phone numbers that you entered are too long for
NOT BE FROM REQUESTED the modem to use. The maximum number of digits a
MODEM modem can handle is 33 when you enter one phone

692 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


number. If you specify two numbers, the range is 16 System action
to 32, depending on how many digits of the prefix are
identical. The more digits of the prefix that are the The NetView program ignores the command and
same, the longer the number can be. The combination processing continues.
of the prefix and extensions must be less than 33.
Operator response
System action Wait for session establishment processing to
Processing continues and the command is ignored. complete, then enter the command again.
DSI445I macro FAILED. REGISTER 15
Operator response = X'xxxxxxxx' REGISTER 0 =
X'yyyyyyyy'
Ensure you have entered the correct phone numbers.
If the phone numbers are correct, notify the system
programmer that the modem cannot accept the phone Explanation
numbers. This error can be caused by either of the following:
• The VTAM macro macro failed while a terminal
System programmer response access facility session was starting.
If the phone numbers are correct, change them so • The MVS macro macro failed during a GETCONID,
that the modems can communicate over the switched MVS, or RELCONID command.
lines.
Message Variables
DSI443I COMMAND REJECTED - TOO MANY
OPERANDS macro
The name of the macro that failed.
xxxxxxxx
Explanation
The return code from register 15.
You specified too many operands on the command. yyyyyyyy
The reason code from register 0.
System action
The NetView program ignores the command. System action
The session does not start and the command does not
Operator response continue.
Enter the command again with the correct number of
operands. For command descriptions, see the NetView Operator response
online help. Notify the system programmer.
DSI444I SESSION BETWEEN APPLID =
applid AND SRCLU = srclu, SESSID System programmer response
= sessionid, COULD NOT BE ENDED
For the meanings of the return codes, refer to the
appropriate VTAM and MVS manuals.
Explanation
DSI446I INCOMPATIBLE OPTION: 'option'
The previously entered BGNSESS command did not SPECIFIED WITH 'keyword'
complete for the specified terminal access facility KEYWORD
operator-control session.
Message Variables Explanation
applid On a BGNSESS command, you entered an option
The application identifier. that is incompatible with the session type, such as
srclu D or INT. These options, for example, are not valid
The name of the logical unit. for an operator-control session. Or you specified the
sessionid DEFER option with the TEXT operand on a BGNSESS
The session identifier. command for a full-screen session.
Message Variables

Chapter 7. DSI Prefix Messages 693


option DSI449I ALL sesstype SESSIONS ENDING
A choice of keyword or parameter.
keyword Explanation
The keyword specified.
You entered an ENDSESS command to end all terminal
access facility sessions for operator control (ENDSESS
System action OPCTL,ALL) or full-screen (ENDSESS FLSCN,ALL).
The NetView program ignores the command. Message Variables
sesstype
Operator response The type of session:
Enter the command correctly. For a description of the • OPCTL for operator-control
command keywords, see the NetView online help.
• FLSCN for full-screen.
DSI447I NO sesstype SESSIONS ARE
ACTIVE
System action
Explanation The specified sessions are in the process of ending.
Message DSI496I is sent for each session that is
You tried one of the following: successfully ended.
• To end operator-control or full-screen terminal DSI450I DUPLICATE KEYWORD 'keyword'
access facility sessions, but none were active
• To display operator-control, full-screen, or all Explanation
terminal access facility sessions, but none were
active. You entered the specified keyword twice in the same
command.
Note: If you enter the LISTSESS command with no
operands and no sessions are active, the message Note: For the BGNSESS command, VIGIL and interrupt
received is NO TAF SESSIONS ARE ACTIVE. (INT) call the same function. Therefore, if you coded
both of these keywords, remove INT.
Message Variables
Message Variables
sesstype
The type of session, which is: keyword
The keyword specified.
• OPCTL for operator-control
• FLSCN for full-screen System action
• TAF if no sessions are active.
The NetView program ignores the command.

System action
Operator response
Processing continues.
Correct the error and enter the command again.
DSI448I COMMAND REJECTED - REQUIRED
DSI451I INCORRECT LENGTH OF OPERAND
KEYWORD OR OPERAND MISSING
'operand' - COMMAND IGNORED

Explanation
Explanation
A required keyword or operand was missing on a
The operand you specified on a command is too short
terminal access facility command.
or too long.

System action Message Variables

The NetView program ignores the command. operand


The name of the operand.

Operator response
System action
Enter the command correctly. For a description of the
command, see the NetView online help. The NetView program ignores the command.

694 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Operator response
Check the operand and enter the command again. If you need to enter the command, notify the system
programmer.
DSI453I COMMAND REJECTED -
TERMINATION IN PROGRESS FOR
SESSION BETWEEN APPLID = System programmer response
applid AND SRCLU = srclu Evaluate the operator's requirements and add
appropriate security access if required.
Explanation
DSI455I SESSION BETWEEN APPLID =
You entered a BGNSESS command to begin a session applid AND SRCLU = srclu HAS
between the specified application and logical unit BEEN DEFERRED
when the specified session was in the process of
ending. Explanation
Message Variables
The establishment of the specified terminal access
applid facility session is deferred until the destination system
The application identifier. chooses to initiate the session. This is the expected
srclu response.
The name of the logical unit. Message Variables
applid
System action The application identifier.
The NetView program ignores the BGNSESS command. srclu
The name of the logical unit.
Operator response
System action
If you need to restart the session, wait until the
existing session ends and you receive message Processing continues. The session is established when
DSI496I. initiated by the destination system.
DSI454I object = identifier SPECIFIED DSI456I RESUMING SESSION FOR APPLID
FOR command COMMAND IS = 'applid', REDUNDANT 'keyword'
NOT AUTHORIZED FOR THIS IGNORED
OPERATOR
Explanation
Explanation
You specified one of the keywords LOGMODE, TEXT, or
You are not authorized to access the specified DEFER on a BGNSESS command for a session that is
application or logical unit. already active.
Message Variables Message Variables
object applid
APPLID or SRCLU. The application identifier.
identifier keyword
The application identifier, or the name of the LOGMODE, TEXT, or DEFER.
logical unit.
command System action
The name of the command.
The session resumes, but the value specified for
keyword is ignored.
System action
DSI457I SESSION BETWEEN APPLID =
The NetView program ignores the command. applid AND SRCLU = srclu COULD
NOT BE ENDED

Chapter 7. DSI Prefix Messages 695


Explanation vtamrcd
The VTAM internal return code.
The previously entered BGNSESS command did not
complete for the specified terminal access facility full- vtamfb
screen session. The VTAM internal feedback code.
vtamsens
Message Variables
The VTAM internal sense code.
applid
The application identifier. Operator response
srclu
The name of the logical unit. Notify the system programmer.

System action System programmer response


Use the RCFB and SENSE command lists to determine
The command is ignored and processing continues.
the meaning of the return/feedback and sense
codes. See the device-specific documentation for the
Operator response meaning of the user sense data.
Wait for session establishment processing to DSI460I CANNOT SEND DATA TO APPLID
complete, then enter the command again. = applid - AWAITING OUTPUT ON
DSI458I STORAGE REQUEST FAILED FOR THAT SESSION
NCCF
Explanation
Explanation You tried to send full-screen data to the destination
There is not enough storage for the terminal access logical unit when the destination logical unit was not
facility to start a new session, to keep the current ready.
session active, or to perform the requested function. Message Variables
applid
System action The application identifier.
The session does not start or end, or the session
continues without the requested function being System action
processed.
The NetView program ignores the data.

Operator response
Operator response
If the session is ended, restart the session at a later
time. If you receive this message again, notify the Try sending the full-screen data again. If you
system programmer. continue to receive this message, notify the system
programmer.

System programmer response


System programmer response
Check the NetView storage, and increase it if
necessary. Determine why the destination logical unit is not ready,
and correct the problem.
DSI459I -RTNCD= X'vtamrcd' -FDBK2=
X'vtamfb'-SENSE= X'vtamsens' DSI461A SRCLU = srclu UNABLE TO ACCEPT
A SESSION FROM APPLID =
applid, SENSE = X'sense'
Explanation
This message follows messages DSI467I, DSI487I, Explanation
DSI497I, and DSI499I. It contains RPL error codes to
help the system programmer determine the cause of An application attempted to start a session between
the problem. the specified application and logical unit. The
application is not known to the terminal access facility
Message Variables (TAF) because an unsupported alias was used on the

696 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


BGNSESS command or because the session start-up System programmer response
was not initiated by a BGNSESS command.
Check that the logmode name specified in the
Message Variables BGNSESS command is the correct logmode entry.
srclu Also check the APPL definition for applid. Be sure
The name of the logical unit. that, for a full-screen session, an LU type-2 SRCLU
is specified; and that for an operator-control session,
applid an LU type-1 SRCLU is specified. An SRCLU cannot be
The application identifier. used simultaneously for OPCTL and FLSCN sessions.
sense
The sense code TAF used to reject the bind. DSI463I A SESSION HAS BEEN STARTED
TO APPLID = applid FROM SRCLU
= srclu
System action
The NetView program ignores the request. Explanation
You entered the BGNSESS command, and a session
Operator response was successfully started between the specified
Use the LISTSESS command to display your TAF application and logical unit.
sessions. Use the ENDSESS command to end Message Variables
sessions listed as STATUS INACT. Notify the system
programmer. applid
The application identifier.

System programmer response srclu


The name of the logical unit.
Determine the cause of the problem by looking up the
meaning of the sense code and by checking the APPL
System action
definition statements for the SCRLU. If the sense code
is X'080F', the minor node names defined for the TSO The session is established.
application might not be a derivative of the major node
name that you used to define the TSO application. See Operator response
the IBM Z NetView Installation: Configuring Additional
Components for more information. For an operator control session (BGNSESS OPCTL),
enter the desired SENDSESS commands for the
DSI462I UNABLE TO START SESSION FOR specified application.
APPLID = applid DUE TO INVALID
BIND PARAMETERS DSI464I CANNOT SEND DATA TO SESSID =
sessionid - AWAITING OUTPUT ON
THAT SESSION
Explanation
The specified application sent BIND parameters that Explanation
are not valid to the source logical unit specified by
SRCLU in the BGNSESS command. You entered a second SENDSESS command for the
same session before the response was received from
Message Variables
the first SENDSESS command.
applid
Message Variables
The application identifier.
sessionid
The session identifier.
System action
The session does not start. System action
The NetView program ignores the second SENDSESS
Operator response
command.
Ensure that the logmode name specified in the
BGNSESS command is correct. If it is correct, notify Operator response
the system programmer.
Wait until you receive a response to the first
SENDSESS command, and then enter the second

Chapter 7. DSI Prefix Messages 697


SENDSESS command again. If you do not receive a System programmer response
response, enter SENDSESS sessionid, * to send an
attention to the subsystem. Remove any BGNSESS FLSCN commands from
command lists that run under the PPT.
DSI465I SESSION NOT STARTED - TOO
MANY SESSIONS FOR SRCLU = DSI467I ALL SESSIONS ORIGINATING
srclu FROM SRCLU = srclu ARE LOST,
RECEIVE FAILED

Explanation
Explanation
A source logical unit (SRCLU) can have a maximum
of 30 operator-control sessions, and 1500 full-screen The SYNAD installation exit routine detected an error
sessions. You entered a BGNSESS command that on a session that is associated with the specified
exceeds this limit. logical unit. Message DSI459I follows this message
and contains RPL and sense information.
Message Variables
Message Variables
srclu
The name of the logical unit. srclu
The name of the logical unit.

System action
System action
The NetView program ignores the BGNSESS command.
All sessions to the specified srclu are stopped.

Operator response
Operator response
For a full-screen session, enter an ENDSESS command
to end some of the existing sessions if you require a Notify the system programmer.
new session. For operator-control sessions, enter the
BGNSESS command again, specifying a new SRCLU. System programmer response
DSI466I COMMAND REJECTED - FLSCN Refer to the appropriate VTAM manual to interpret the
SESSIONS CANNOT BE STARTED sense and RPL codes from message DSI459I.
IN THIS WAY
DSI468I SESSION TO APPLID = applid NOT
ACTIVE
Explanation
You entered a BGNSESS FLSCN command from a task Explanation
other than an operator station task (OST). One of the
following has occurred: You entered a RTRNSESS command for an inactive full-
screen session.
• You tried to route the BGNSESS command to another
domain. Message Variables

• You used the AT, EVERY, or AFTER command to applid


schedule BGNSESS under the primary POI task The application identifier.
(PPT).
• A command list containing BGNSESS was running System action
under the PPT.
The NetView program ignores the request.

System action Operator response


The NetView program ignores the BGNSESS command.
Use the BGNSESS FLSCN command to start the
session and then enter the command again. If you
Operator response have already entered the BGNSESS command to
start this session and the subsystem sends a "good
Enter the BGNSESS command in the correct manner.
morning" message, wait until you receive message
If you continue to receive this message, notify the
DSI493A before entering full-screen commands. If the
system programmer.
subsystem does not send a "good morning" message,

698 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


then enter the RTRNSESS command again after you have already entered the BGNSESS command to start
have received message DSI463I. this session, wait until you receive message DSI463I
before sending commands to the session. If you have
DSI469I ALL SESSIONS ORIGINATING
entered the ENDSESS command and now wish to send
FROM SRCLU = srclu ARE LOST,
more data, wait until you receive message DSI496I
SRCLU VARIED INACTIVE stating that the session has ended completely. Enter
the BGNSESS and SENDSESS commands again.
Explanation
DSI472I OPEN ACB FAILED. SRCLU = srclu
The network operator inactivated the specified logical IS ALREADY IN USE
unit.
Message Variables Explanation
srclu The session cannot be started because another
The name of the logical unit. operator is using this logical unit.
Message Variables
System action
srclu
All sessions to the specified logical unit end. The name of the logical unit
DSI470I TEXT MISSING OR INVALID
System action
Explanation The session does not start.
You entered a SENDSESS command without any text,
with text longer than 255 characters, or with text that Operator response
is not valid. Enter the BGNSESS command again, specifying
another SRCLU. If no other SRCLU is available, notify
System action the system programmer.
The NetView program ignores the SENDSESS
command. System programmer response
If necessary, define another SRCLU to VTAM.
Operator response
DSI473I SPECIFIED NAME SESSID =
Enter the SENDSESS command again, including the 'sessionid' INVALID
text to be sent to the subsystem.
DSI471I SESSION SESSID = sessionid NOT Explanation
ACTIVE You entered a SENDSESS command for an session that
is not valid. That is, the specified sessionid might be
Explanation more than eight characters.
You tried to send data to an operator-control session Message Variables
that is not active or is in the process of beginning or
sessionid
ending.
The session identifier.
Message Variables
sessionid System action
The session identifier. The NetView program ignores the SENDSESS
command.
System action
The NetView program ignores the command. Operator response
Check the session identifier you specified and enter
Operator response the SENDSESS command again, specifying a valid
session.
Use the BGNSESS OPCTL command to start the
session and then enter the command again. If you

Chapter 7. DSI Prefix Messages 699


DSI474I command COMMAND SELF- System programmer response
TERMINATED BY RESET
COMMAND If ACBERFLG is X'5A', define the logical unit to VTAM or
activate the major node. If ACBERFLG is X'5C', activate
the logical unit. If ACBERFLG is not one of the codes
Explanation shown above, refer to the appropriate VTAM manual
You entered a RESET command while a terminal for the code meaning.
access facility command was being processed. The DSI476I macro FAILED. REGISTER 15 =
terminal access facility command ended processing. X'code' REGISTER 0 = X'code'
Message Variables APPLID = applid, SRCLU = srclu

command
The name of the command. Explanation
The specified access method macro or the NetView
System action DSIPSS macro failed on a session between the
specified application and logical unit. The return codes
The command stops itself, allowing the next command in registers 0 and 15 are shown. For DSIPSS, only the
to run. return code in register 15 is meaningful.
DSI475I OPEN ACB FAILED. ACBERFLG = Message Variables
X'code' APPLID = 'applid',LU =
'luname' macro
The name of the failing macro instruction.

Explanation code
The codes used for problem analysis.
The ACB for the specified logical unit cannot be applid
opened. A session cannot be started to the specified The application identifier.
application. The reason for the failure is specified by
ACBERFLG. Following are two of the most common srclu
ACBERFLG settings: The name of the logical unit.

Setting
Meaning System action
X'5A' The session ends.
SRCLU is not defined to VTAM or the major node is
inactive. Operator response
X'5C'
Notify the system programmer.
SRCLU is inactive.
Message Variables
System programmer response
code
For the meaning of the access method return codes,
The code used for problem analysis.
refer to the appropriate VTAM manual, depending on
applid which system you use for your installation.
The application identifier.
For the meaning of the register 15 return code for
luname DSIPSS, see IBM Z NetView Programming: Assembler.
The name of the logical unit.
DSI477I SYNTAX ERROR
System action
Explanation
The NetView program does not start the session.
You entered a terminal access facility command
incorrectly.
Operator response
Notify the system programmer. System action
The NetView program ignores the command.

700 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Operator response
Correct the command and enter it again. For the If you wish to see the data that was sent, enter a
correct command syntax, see the NetView online help. RTRNSESS command to reconnect the session.
DSI478I CANNOT END SESSION object DSI481I COMMAND REJECTED - A
= identifier - TERMSESS NOT SESSION USING SESSID =
SCHEDULED - REGISTER 15 = sessionid ALREADY EXISTS
X'code' REGISTER 0 = X'code'
Explanation
Explanation
You entered a BGNSESS OPCTL command using a
You entered the VTAM TERMSESS macro for a session session identifier that is already in use.
and were not successful. The return codes in registers
Message Variables
0 and 15 are shown.
sessionid
Message Variables
The session identifier.
object
APPLID or SESSID. System action
identifier
The application or session identifier. The NetView program ignores the BGNSESS command.

code
The codes used for problem analysis. Operator response
Enter the BGNSESS command again with another
System action SESSID, or enter the ENDSESS command to end the
previous session and enter the command again.
The NetView program removes the remaining session
control information from its internal tables. The tables DSI482I CMDMDL STATEMENT IS MISSING
are reset to allow subsequent BGNSESS commands to OR IN ERROR FOR INTERNAL
be attempted. COMMAND command

Operator response Explanation


Notify the system programmer. The CMDMDL for the specified command is in error or
was not coded.
System programmer response Message Variables
Refer to the appropriate VTAM manual for the meaning command
of the return codes. It might be possible to restart the The name of the internal command.
session.
DSI479I DATA RECEIVED ON FULL SCREEN System action
SESSION FROM APPLID = applid Processing stops.

Explanation Operator response


Data was received from the specified application on a Notify the system programmer.
disconnected full-screen session.
Message Variables System programmer response
applid Ensure the CMDMDL statement for the specified
The application identifier. command is coded correctly. See the IBM Z NetView
Administration Reference for information on coding the
System action CMDMDL statement.

The NetView program saves the data for you. DSI483I NO SESSION EXISTS TO object =
'identifier'

Chapter 7. DSI Prefix Messages 701


Explanation System action
You entered a LISTSESS command, but the specified The NetView program ignores the command.
session is not active.
Message Variables Operator response
object Start the session using the BGNSESS command.
APPLID or SRCLU. For information on the BGNSESS command, see the
identifier NetView online help.
The application identifier, or the name of the DSI486I INVALID OPERAND OR KEYWORD
logical unit. 'value'

System action Explanation


The NetView program ignores the command. The specified operand or keyword is not valid.
Message Variables
Operator response
value
Check that you specified the correct application or The value specified
logical unit and enter the command again.
DSI484I NO sesstype SESSION ACTIVE TO System action
object = 'identifier'
The NetView program ignores the command.

Explanation
Operator response
You entered the ENDSESS or SENDSESS command for
an inactive or nonexistent session. Correct the error and enter the command again.

Message Variables DSI487I SESSION APPLID = applid SRCLU


= srclu SESSID = sessionid
sesstype ENDING. macro FAILED
The type of session:
• OPCTL for operator-control Explanation
• FLSCN for full-screen. The specified access method macro failed and
object session sessionid ends. Additional error information
APPLID or SESSID. is contained in message DSI459I, which follows this
message.
identifier
The application or session identifier. Message Variables
applid
System action The application identifier.
The NetView program ignores the command. srclu
The name of the logical unit.
Operator response sessionid
The session identifier.
Check the APPLID or SESSID value that you specified
on the command and enter the command again using macro
the correct value. The name of the failing macro instruction.

DSI485I COMMAND REJECTED - NO System action


SESSIONS ARE ACTIVE
The specified session ends.
Explanation
Operator response
You entered the SENDSESS command, but no sessions
are active. Try to restart the session. If you are unsuccessful,
notify the system programmer.

702 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response DSI490I SESSION STARTING TO APPLID
= applid FROM SRCLU = srclu
Refer to the appropriate VTAM manual to interpret SESSID = sessionid
the RPL and sense information displayed in message
DSI459I.
Explanation
DSI488I SESSION BETWEEN APPLID =
applid AND SRCLU = srclu COULD You entered a BGNSESS command for an operator-
NOT BE ESTABLISHED control session.
Message Variables
Explanation applid
The specified session cannot be established. The The application identifier
terminal access facility network services installation srclu
exit routine was entered and sent this message. The name of the logical unit
Message Variables sessionid
The session identifier
applid
The application identifier
srclu
System action
The name of the logical unit The BGNSESS command is in progress. If this
command is successful, message DSI463I is
System action displayed.

The NetView program does not establish a session and DSI491I SYSTEM ERROR - INVALID
begins to free the control blocks and storage. INTERNAL COMMAND command
RECEIVED

Operator response
Explanation
Start the session again. If it fails a second time, notify
the system programmer. An internal command processor is designed to receive
control only through an internal DSIMQS macro
instruction. It received control from another source,
System programmer response such as from a terminal.
Check the logmode session parameters. The Message Variables
application ran out of storage, or the application
specified with the applid keyword is not active. command
The name of the command
DSI489I EXPECTED OPERAND OR
KEYWORD 'value' MISSING
System action
Explanation The NetView program ignores the command.

You did not include a required operand or keyword in a


command.
Operator response
Message Variables Do not enter the CNMCAMQS, CNMXNLTU, or DSI809A
command. These are NetView internal commands.
value
The specified value DSI492I COMMAND REJECTED - A
SESSION BETWEEN APPLID =
applid AND SRCLU = srclu
System action ALREADY EXISTS
The NetView program ignores the command.
Explanation
Operator response You entered a BGNSESS command to establish a
Enter the command again with the required operand or session between applid and srclu, but you have
keyword. already started the session.

Chapter 7. DSI Prefix Messages 703


Message Variables • FLSCN for full-screen
applid object
The application identifier. APPLID or SESSID.
srclu identifier
The name of the logical unit. The application or session identifier

System action System action


The NetView program ignores the command. The specified session ends. If the ENDSESS command
is successful, message DSI496I is sent.
Operator response DSI496I sesstype SESSION BETWEEN
Use the existing session or start another session with a APPLID = applid AND SRCLU =
different SRCLU (for operator control sessions). srclu ENDED

DSI494I SESSION BETWEEN APPLID =


Explanation
applid AND SRCLU = srclu ENDED
The indicated session was successfully ended by
Explanation an ENDSESS command, or the access method has
notified the NetView program that the session
The access method notified the NetView program that between the specified logical unit and application has
the session between the specified logical unit and the ended.
application ended.
Message Variables
Message Variables
sesstype
applid The type of session:
The application identifier
• OPCTL for operator-control
srclu
• FLSCN for full-screen
The name of the logical unit
applid
System action The application identifier
srclu
The session ends.
The name of the logical unit

Operator response System action


If you need this session, start it again using the
The indicated session ends.
BGNSESS command. If you cannot start the session,
notify the system programmer.
Operator response
System programmer response If you need this session, restart it using the BGNSESS
command. If you cannot start the session, notify the
Determine the cause of the error and take the
system programmer.
appropriate actions.
DSI495I sesstype SESSION(S) FOR object = System programmer response
identifier ENDING
Determine the cause of the error and take the
appropriate action.
Explanation
DSI497I NCCF CANNOT TERMINATE
You entered an ENDSESS command to end the
SESSION object = identifier.
indicated terminal access facility session.
TERMSESS FAILED
Message Variables
sesstype Explanation
The type of session: The NetView program cannot end the specified
• OPCTL for operator-control session because the TERMSESS macro failed. Message

704 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI459I follows this message and contains RPL and applid
sense information. The application identifier
Message Variables srclu
The name of the logical unit
object
APPLID or SESSID macro
The name of the failing macro instruction
identifier
The application or session identifier
System action
System action The session does not start.

The NetView program removes the remaining session


control information from its internal tables. The tables Operator response
are reset so that you can start a session again with the Notify the system programmer.
BGNSESS command.

System programmer response


Operator response
Refer to the appropriate VTAM manual to interpret the
Notify the system programmer. sense and RPL codes from message DSI459I.
DSI500I object restarted.
System programmer response
Refer to the appropriate VTAM manual to interpret the Explanation
sense and RPL codes from message DSI459I.
The entity identified as object was started. This
DSI498I SRCLU HAS BEEN DEFAULTED message also indicates that the entity identified as
TO SRCLU = srclu FOR FLSCN object has previously been active.
SESSION TO APPLID = applid
Message Variables
Explanation object
The entity that was started.
BGNSESS has chosen a SRCLU for you, either because
you allowed the value to default or because you
previously used a different value System action
Message Variables Processing continues.

srclu
The name of the logical unit Operator response
applid The entity identified as object can now be used.
The application identifier
System programmer response
System action None
BGNSESS continues processing using the SRCLU value
DSI501I task: CNMI HAS BEEN CLOSED
named in the message.
DUE TO ERROR - RTNCD = X'code'
DSI499I UNABLE TO START SESSION TO FDBK2 = X'code'
APPLID = 'applid' FROM SRCLU =
'srclu' - macro FAILED Explanation
The access method CNM interface was closed because
Explanation of an unrecoverable error on the interface. Use the
The specified access method macro failed. The error RCFB command list for a description of the return/
codes are given in message DSI459I, which follows feedback codes.
this message. Message Variables
Message Variables task
The name of the task

Chapter 7. DSI Prefix Messages 705


code For other codes, refer to the appropriate VTAM manual
The code used for problem analysis for information. If you are unable to resolve the
problem, contact IBM Software Support.
System action DSI503I RETRIEVE COMMAND ONLY VALID
The data services task (DST) remains active for any FOR OST TASK
further VSAM data set processing, but the CNM
interface is unavailable until the DST is stopped and Explanation
started again after any corrective action is taken on the
Only a NetView operator can issue the RETRIEVE
error.
command. That operator must be running the NetView
program under the OST task.
Operator response
Notify the system programmer. System action
The NetView program ignores the command and
System programmer response continues.
If you are unable to determine the cause of the error,
contact IBM Software Support. Operator response
DSI502I task: CNMI ERROR DURING Do not use the RETRIEVE command.
CLOSE PROCESSING RC = code,
DSI504I RETRIEVED COMMAND IS LONGER
ACBOFLAG = value, ACBERROR =
THAN INPUT AREA
value

Explanation Explanation
You retrieved a command that is longer than the
During the CNM interface close processing, the CLOSE
current definition of the input area size.
ACB macro failed for the reason indicated. Refer to the
appropriate VTAM manual for more information.
System action
Message Variables
The NetView program truncates part of the original
task
command and displays only that portion of the
The name of the task
command that fits into the current input area.
code
The code used for problem analysis
Operator response
value
The flag or error value Enter INPUT 2 (or 3) to increase the size of the current
input area. Then enter the RETRIEVE command
again until the NetView program displays the desired
System action command in the input area.
The data services task (DST) proceeds as if the CNM
DSI505I COMMAND LIST cmdlist WARNING
interface closed successfully.
- UNBALANCED QUOTES MAY
CAUSE UNPREDICTABLE RESULTS
Operator response - PROCESSING CONTINUES
It might be possible to restart the DST if desired.
Notify the system programmer. Explanation
During command list statement processing, the
System programmer response NetView program encountered a blank-quotation mark
or comma-quotation mark sequence that denotes
When ACBERROR equals X'42', the problem is with
special character string processing. The matching
VTAM.
blank-quotation mark or comma-quotation mark was
When ACBERROR equals X'50', VTAM is no longer missing.
active; an operator probably stopped VTAM.
Message Variables

706 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


cmdlist System action
The name of the command list.
The data service task (DST) ends.

System action
Operator response
The command list continues.
Determine whether you received message BNH16I,
which means the task has reached its storage limit.
Operator response If so, notify your system programmer.
Notify the system programmer.
System programmer response
System programmer response See the IBM Z NetView Troubleshooting Guide for
See IBM Z NetView Programming: REXX and the possible causes of the storage shortage.
NetView Command List Language to determine how the DSI508I COMMAND LIST cmdlist WARNING
NetView program analyzes a command list statement - UNBALANCED SHIFT CODES -
and how to code special characters. STATEMENT IGNORED
DSI506I COMMAND LIST cmdlist WARNING
- SUBSTITUTION STRING Explanation
TRUNCATED TO 255 CHARACTERS
During command list statement processing, the
NetView program found mismatched shift-in and shift-
Explanation out codes. These codes enclose double-byte character
The NetView program found a string longer than 255 set (DBCS) data.
characters. The NetView program truncates everything Message Variables
after 255 characters. The NetView program follows
this message with two copies of the command list cmdlist
statement which is in error. The first copy shows the The name of the command list.
statement up to and including the variable that caused
the overflow. The second copy shows the variable after System action
substitution.
The command list continues. The statement with the
Message Variables unbalanced shift codes displays after this message.
cmdlist
The name of the command list. Operator response
You might need to stop the command list if the
System action error is in a required statement. Notify the system
The command list continues. programmer.

Operator response System programmer response


Notify the system programmer. See IBM Z NetView Programming: REXX and the
NetView Command List Language to determine how the
NetView program analyzes a command list statement
System programmer response and how to code shift-in and shift-out codes.
Correct the command list so the truncation is not DSI509I WARNING: IMPORTANT MESSAGE
required. messageid WAS NOT WRITTEN TO
DSI507I NOT ENOUGH STORAGE FOR DSILOG
RECORD THAT INITIALIZES
EMPTY VSAM DATASET Explanation
The indicated message was not written in the network
Explanation log and the important message (IM) fields of the Log
There is not enough storage to contain the record that Browse panel were not updated.
is used to initialize the empty VSAM data set. Message Variables

Chapter 7. DSI Prefix Messages 707


messageid the step number does not increase, a PURGE DST
The message ID of the IM message. command might be required.
zzzz aaaaaaa
System action Shows the status of the last DST request.
Processing continues. The zzzz can be VSAM, CNMI, or NONE.
The aaaaaaa is the last macro entered:
Operator response GET, UT, POINT, ERASE, ENDREQ, VERIFY,
FORWARD, or blank.
Notify the system programmer.
Operator response
System programmer response
If the request is hung, enter the PURGE DST command
Contact IBM Software Support. specifying xxxx for the REQ number.
DSI510I dstname: nnn REQUESTS PURGED DSI512I dstname: NO REQUESTS FOUND

Explanation Explanation
In response to a PURGE DST command, the DST You entered a LIST DST command, but there are
purged the stated number of active requests. no active requests that fit the parameters of the
command.
Message Variables
Message Variables
dstname
The name of the data services task. dstname
nnn The name of the data services task.
The number of requests purged. DSI515I PORT=portnumber

System action Explanation


The NetView program purges the request. You receive this message when a logical unit residing
DSI511I dstname: OP=operatorid, on an 8-port line adapter configuration is displayed.
REQ=xxxx, STEP=yyy, LAST=zzzz Message Variables
aaaaaaa
portnumber
The number in the format of 01AA to 15DD that
Explanation is translated from the allowable range of port
This message shows the status of a DST request. numbers supported (1—30 and 33—62).

Message Variables
System action
dstname
The name of the data services task. Processing continues.
operatorid DSI516I CLOSE NORMAL ALREADY IN
Identifies the operator that initiated the request. PROGRESS, COMMAND IGNORED
xxxx
A 4-digit request number from 0001 to 9999 that Explanation
is assigned to each DST request when it starts.
After 9999, the request numbers begin again at You issued a CLOSE NORMAL command while a prior
0000. CLOSE NORMAL was already in progress.

yyy
A 3-digit step-sequence number that increases System action
every time a command facility CNM interface The NetView program ignores the second CLOSE
(DSIZCSMS) or a VSAM (DSIZVSMS) macro NORMAL command.
instruction is entered. The step-sequence number
is used to indicate that a request is suspended. If

708 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response DSI521I task : PROCESSOR
FOR UNSOLICITED DATA
Wait for the original CLOSE NORMAL to complete or INCORRECTLY SPECIFIED
issue a CLOSE IMMED command.
DSI517I command IGNORED, NO OTHER Explanation
APPLICATION IS ACTIVE
There are two situations that return this message. A
DSTINIT initialization statement might have incorrectly
Explanation specified the CNMI unsolicited command processor
You issued a ROLL or RETURN command while no (through the UNSOL keyword), or the CMDDEF
application was active. statement for the specified command processor might
contain an error.
Message Variables
Message Variables
command
ROLL or RETURN. task
The name of the incorrect DST (data services task).
DSI518I UNASSIGNED PF/PA KEY
ENTERED: VALID KEYS ARE
DISPLAYED BELOW System action
Initialization for the data services task ends.
Explanation
You pressed an unassigned PF/PA key. Operator response
Notify the system programmer.
Operator response
Press only valid PF/PA keys. System programmer response
Determine which initialization statement is at fault
DSI520I task : INSUFFICIENT STORAGE
(either the DSTINIT or the corresponding CMDDEF
FOR subtask CONFIGURATION
statement), and correct it.

Explanation DSI522I task : PRIMARY VSAM DATASET


NOT SPECIFIED
Not enough storage is available for the type of subtask
specified by subtask.
Explanation
Message Variables
An initialization statement omitted or incorrectly
task specified the name of the primary VSAM data set.
The name of the task
Message Variables
subtask
The name of the subtask task
The name of the task.
System action
System action
The data services task (DST) ends.
The data services task (DST) ends.
Operator response
Operator response
Determine whether you received message BNH16I,
which means the task has reached its storage limit. Notify the system programmer.
If so, notify your system programmer.
System programmer response
System programmer response Correct the initialization statement.
See the IBM Z NetView Troubleshooting Guide for
DSI523I task : 0 DSRBS HAVE BEEN
possible causes of the storage shortage.
SPECIFIED

Chapter 7. DSI Prefix Messages 709


Explanation Operator response
An initialization statement specified both DSRBU=0 Notify the system programmer.
and DSRBO=0.
Message Variables System programmer response
task Remove the incorrect statement from the initialization
The name of the task. data set. The error might be within the member
specified on the MEM= operand of the task statement.
See the IBM Z NetView Administration Reference for
System action
more information.
The data services task (DST) ends.
DSI526I task : VERB 'verb' IN 'statement'

Operator response
Explanation
Notify the system programmer.
The indicated initialization statement contains a
command verb other than DSTINIT.
System programmer response
Message Variables
Correct the initialization statement.
task
DSI524I task : DST TERMINATING DUE TO The name of the task.
INCOMPLETE INITIALIZATION verb
A command verb.
Explanation statement
The initialization statements are incomplete or The command or control statement in error.
incorrect.
Message Variables System action
task The NetView program does not process the statement.
The name of the task.
Operator response
System action Notify the system programmer.
The data services task (DST) ends.
System programmer response
Operator response Correct the statement.
Notify the system programmer. DSI527I task : SYNTAX ERROR: 'object'
INVALID IN 'statement'
System programmer response
Correct the initialization statements. Explanation
DSI525I task : SYNTAX: 'statement' There is a syntax error in the indicated keyword or
parameter.

Explanation Message Variables

There is a length or a delimiter error in the label or in task


the verb on an initialization statement. The name of the task.

Message Variables object


The keyword or parameter specified.
task
statement
The name of the task
The command or control statement in error.
statement
The command or control statement in error

710 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
The NetView program assigns a default value to the Notify the system programmer.
keyword or parameter causing the error and continues.
System programmer response
Operator response
Correct the error in the installation exit routine or in
Notify the system programmer. the command processor that is queuing the command.
DSI530I 'task' : 'tasktype' IS READY AND
System programmer response WAITING FOR WORK
Correct the keyword or parameter causing the error.
Explanation
DSI528I task : UNIDENTIFIED VERB 'verb'
PASSED TO DST The NetView subtask indicated by tasktype is
initialized and ready to accept input. If this message
Explanation is issued in response to a STOP command, STOP
processing determined that the task being stopped
A command queued to the NetView data services appeared to be able to process normally. See the
task (DST) contains a command verb that cannot be NetView online help for more information on the STOP
identified or that is incompatible with the task type. command.
Message Variables Message Variables
task task
The name of the task. The name of the task.
verb tasktype
A command verb. OST, DST, NNT, HCT, PPT, or SUBSYSTEM ROUTER
for a NetView subtask, or NCCF for the NetView
System action main task.

The command is not processed.


System action
Operator response Awaits input.

Notify the system programmer. DSI531I 'task' : 'tasktype' IS TERMINATING

System programmer response Explanation


Correct the error in the installation exit routine or in The NetView subtask indicated by task is closing
the data services command processor (DSCP) that is down.
queuing the command. Ensure the CMDDEF statement Message Variables
for the command is correct.
task
DSI529I task : IMPROPER COMMAND The name of the task.
BUFFER PASSED TO DST
tasktype
OST, DST, NNT, HCT, PPT, OPT, or SUBSYSTEM
Explanation ROUTER for a NetView subtask, or NCCF for the
NetView main task.
A command queued to the NetView data services task
(DST) contains a command that cannot be identified or
that is incompatible with the task type. System action
Message Variables The NetView program closes the subtask.
task DSI532I subtask : DURING SUBTASK
The name of the task. INITIALIZATION DUPLICATE TASK
NAME WAS FOUND
System action
The command is not processed.

Chapter 7. DSI Prefix Messages 711


Explanation X'vtamrcd' FDBK2 = X'vtamfb'
SENSE = X'vtamsens'
The NetView program already has a subtask name
identical with that of the subtask currently being
initialized. An attempt was made to start an optional Explanation
task by the same name as a currently logged-on A CNM interface send or receive failed with the
operator. indicated error codes. Use the RCFB command list for
Message Variables a description of the return code and feedback code.
Use the SENSE command list for a description of the
subtask sense code.
The name of the task.
Message Variables
System action task
The name of the task
Subtask initialization ends.
action
SEND or RECEIVE
Operator response
vtamrcd
Notify the system programmer. The VTAM internal return code
vtamfb
System programmer response The VTAM internal feedback code.
Find the duplicate subtask name (TVBOPID) and vtamsens
assign a unique value to one of the duplicates. Start The VTAM internal sense code.
the optional task with a different task name.
DSI537A WARNING: UNSOLICITED CNM
System action
DATA WILL NOT BE RECEIVED — Depending on the type of error, the DST might remain
aaa INACTIVE active for further CNMI processing.

Explanation Operator response


The communication network management (CNM) Notify the system programmer.
router subtask either was not successfully activated or
has been ended. Unsolicited CNM data is not received
System programmer response
if this NetView subtask has been specified in the VTAM
global routing table as the unsolicited data receiver. Use the RCFB and SENSE command lists to determine
the meaning of the return, feedback, or sense
Message Variables
codes. See the device-specific documentation for the
aaa meaning of the user sense data. If you are unable
The name of the NetView CNM router subtask. to determine the cause of the error, contact IBM
Software Support.
System action DSI540I task: command NOT PERFORMED.
Processing continues. NO FILES ACTIVE

Operator response Explanation


After the system programmer corrects the cause of The insert command is SWITCH or its user-defined
the failure, use the START TASK command to start the synonym. No files were active.
CNM router subtask. Message Variables
task
System programmer response The name of the task.
Determine and correct the cause of the failure. command
The name of the command.
DSI538I task: CNMI ERROR DURING
action PROCESSING - RTNCD = DSI541I task: command COULD NOT BE
PERFORMED. REENTER

712 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation DSI544I task: command NOT PERFORMED.
NO SECONDARY FILE EXISTS
You entered the SWITCH command or its synonym for
a data set or file that is already being switched.
Explanation
Message Variables
You entered the SWITCH command or the synonym to
task switch activity to a secondary file or data set which
The name of the task. was not defined.
command
Message Variables
The name of the command.
task
Operator response The name of the task.
command
Enter the command again. The name of the command.
DSI542I task: command COMMAND NOT
PERFORMED. FILE ALREADY Operator response
ACCESSIBLE
Notify the system programmer.
Explanation
System programmer response
You entered a command for a file or data set that is
already open. If a secondary file is needed, define one. Otherwise,
do not use the SWITCH command for a secondary data
Message Variables set.
task DSI545I task: NO VSAM DATASET(S) NOW
The name of the task ACTIVE
command
The name of the command Explanation
DSI543I task: command COMMAND NOT You used the SWITCH command to make both primary
PERFORMED. OPEN FAILED and secondary VSAM data sets or files unavailable.
Note: If this message is specified as HOLD(Y) in the
Explanation automation table, it is automatically removed from the
You entered the SWITCH command or its synonym for screen when no longer applicable.
a file or data set that cannot be opened.
Message Variables
Message Variables task
task The name of the task.
The name of the task.
DSI546I task: PRIMARY VSAM DATASET IS
command NOW ACTIVE
The name of the command.
Explanation
Operator response
This message notifies you that logging has begun in
If you receive this message because the open failed the PRIMARY VSAM file.
for DSILOG or DSITRACE, check to see if another job is
using DSILOG or DSITRACE. If so, wait for the other job Note: If this message is specified as HOLD(Y) in the
to complete and enter the command again. Otherwise, automation table, it is automatically removed from the
notify the system programmer. screen when no longer applicable.
Message Variables
System programmer response task
See the messages that follow on the screen or log for The name of the task.
more information.

Chapter 7. DSI Prefix Messages 713


System action System action
Logging begins in the PRIMARY VSAM file. The command is not executed and the screen remains
full.
Operator response
Operator response
If you want a copy of the other VSAM log file, take that
copy now. Determine whether you received message BNH16I,
which means the task has reached its storage limit.
DSI547I task: SECONDARY VSAM DATA SET
If so, notify your system programmer.
IS NOW ACTIVE

System programmer response


Explanation
See the IBM Z NetView Troubleshooting Guide for
This message notifies you that logging has begun in possible causes of the storage shortage.
the SECONDARY VSAM file.
DSI550I command FAILED: INSUFFICIENT
Note: If this message is specified as HOLD(Y) in the
STORAGE OBTAINED IN module
automation table, it is automatically removed from the
screen when no longer applicable.
Explanation
Message Variables
A module began filling a full-screen buffer and ran out
task
of buffer space.
The name of the task.
Message Variables
System action command
The name of the command that failed
Logging begins in the SECONDARY VSAM file.
module
The name of the module with insufficient storage
Operator response space
If you want a copy of the other VSAM log file, take that
copy now. System action
DSI548I IMMEDIATE COMMANDS MAY NOT The command is canceled.
BE ISSUED FROM A FULL SCREEN
Operator response
Explanation
Determine whether you received message BNH16I,
You tried to issue an immediate command from a full which means the task has reached its storage limit.
screen. If so, notify your system programmer.

System action System programmer response


The command is not executed and the screen remains See the IBM Z NetView Troubleshooting Guide for
full. possible causes of the storage shortage.
DSI551I task: WARNING - ACB COULD
Operator response NOT BE GENERATED FOR A
Exit the full screen before entering an immediate SECONDARY VSAM DATASET
command.
DSI549I INSUFFICIENT STORAGE Explanation
AVAILABLE TO EXECUTE During initialization, a VSAM ACB cannot be
COMMAND ENTERED successfully generated for a secondary VSAM data set
or file.
Explanation Message Variables
You entered a command from a full screen; there was task
not enough storage available to execute the command. The name of the task.

714 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action Operator response
Processing continues. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. See the previous error message to determine the
reason for the failure.
System programmer response DSI554I task : DST VSAM SERVICES
See error message DSI555I to determine the cause of INITIALIZATION HAS FAILED
GENCB macro failure.
Explanation
DSI552I task: REQUIRED VSAM
INITIALIZATION RECORD NOT Because of severe errors during DST initialization, the
PROVIDED BY INSTALLATION DST cannot be initialized.
EXIT
Message Variables

Explanation task
The name of the task.
The installation exit routine did not provide a
substitution record that is required for initialization of
System action
the empty VSAM data set or file.
Processing continues.
Message Variables
task Operator response
The name of the task.
Notify the system programmer.
System action
System programmer response
The data set or file is not opened.
See message DSI555I to determine the cause of the
macro failure. If VSAM is required for this NetView
Operator response
program, correct the error and enter the START TASK
Notify the system programmer. command.
DSI555I task : VSAM 'action' MACRO
System programmer response ERROR RETURN CODE = X'code'
Provide the initialization record through the installation ERRCODE = X'code'
exit interface or initialize the data set using access
method services (AMS). Explanation
DSI553I task: ERROR OCCURRED DURING A VSAM macro error occurred. The VSAM hexadecimal
VSAM 'action' PROCESSING IN return codes are supplied as part of the message.
'object'
Message Variables

Explanation task
The name of the task.
VSAM OPEN or VERIFY processing found an error. action
Message Variables The following macros:
task • BLDVRP
The name of the task. • GENCB
action • OPEN
VERIFY or OPEN.
• CLOSE
object
• PUT
PRIMARY or SECONDARY.
• MODCB

Chapter 7. DSI Prefix Messages 715


• SHOWCB appropriate VSAM manual for OPEN and CLOSE return
• VERIFY codes and ACB error fields.

code DSI557I task: ERROR HAS OCCURRED


The code used for problem analysis. DURING VSAM EMPTY DATASET
PROCESSING
System action
Explanation
If the failing macro is BLDVRP, initialization ends. For
all other macros, processing continues. The NetView program issues this message following
message DSI507I, DSI520I, DSI552I, or DSI555I.
Operator response Message Variables

Notify the system programmer. task


The name of the task.
System programmer response
System action
Refer to the appropriate VSAM manual for an
explanation of the return codes. The system action depends on the preceding message:

DSI556I task: VSAM DATASET 'opncls' Message


COMPLETED, DDNAME = 'ddname' System Action
RETURN CODE = X'retcode', ACB DSI507I
ERROR FIELD = X'errcode' The data services task (DST) ends.
DSI520I
Explanation The DST ends.
OPEN or CLOSE was completed for the VSAM data set DSI552I
or file indicated by ddname. The data set or file is not opened.
DSI555I
Message Variables
If the failing macro is BLDVRP, initialization ends.
task For all other macros, processing continues.
The name of the task.
opncls Operator response
OPEN or CLOSE.
Notify the system programmer.
ddname
The name of the VSAM data set.
System programmer response
retcode
The return code used for problem analysis. Provide an initialization record through the installation
errcode exit interface or initialize the data set using access
The error code used for problem analysis. method services.
DSI558I task: TASK ABENDING DUE TO
System action I/O ERROR DURING VSAM VERIFY
MACRO PROCESSING. DDNAME =
Processing continues. See the NetView online help for 'ddname', RC= X'code'
more information on messages issued by the SWITCH
command.
Explanation
Operator response VSAM encountered an I/O error during VERIFY
processing. VSAM updated the RBA in its control
If the retcode or errcode are not zero, notify the system blocks to indicate that the I/O error occurred at the
programmer. end of the data set or file. User 1025 ABEND is sent to
prevent VSAM from closing the data set or file. Closing
System programmer response the data set or file incorrectly updates the catalog to
reflect the end of the data set or file and possibly
If the retcode and errcode are zero, the OPEN or causes a loss of a part of the data set or file.
CLOSE completed successfully; otherwise, refer to the

716 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Message Variables System action
task The NetView program cannot locate the message
The name of the task. because of the I/O error. It substitutes NetView
ddname message DSI000I.
The name of the VSAM data set.
code Operator response
The code used for problem analysis.
Notify the system programmer.

System action System programmer response


The data services task (DST) is detached. The data
Check the network log to determine the cause of the
sets or files are not accessible.
error.

Operator response DSI561I INVALID UNSOLICITED DATA


RECEIVED FROM spname
Notify the system programmer.
Explanation
System programmer response
The service point named in the message sent data that
Take the data set or file offline and audit it to ensure was not valid and solicited to network product support
integrity. Refer to the appropriate VSAM manual for (NPS®).
return code information.
Message Variables
DSI559I task: CNM NOT AVAILABLE.
spname
INITIALIZATION CONTINUES
The name of the service point that sent the data.

Explanation
System action
The CNM interface failed to open.
Processing continues and the data is ignored.
Message Variables
DSI562I UNSOLICITED DATA RECEIVED
task BY taskname NOT RECOGNIZED:
The name of the task. DATA = X'bbbb'

System action Explanation


Initialization continues. The CNM router received unsolicited data. Because the
data type was not recognized, it cannot be routed. Or,
Operator response DSIATOPT received an unsolicited message buffer that
was not valid.
Notify the system programmer.
The entire RU or buffer will be sent in a message as a
MLWTO.
System programmer response
Message Variables
If you desire the CNM interface, check to ensure that
the APPLID name for the DST used to open the ACB is taskname
defined to VTAM. The NetView task that detected the error.
bbbb
DSI560I I/O ERROR ON MESSAGE DATASET
The incorrect RU or buffer

Explanation System action


An I/O error occurred while the NetView program was
Processing continues and the error message is sent
reading the NetView message data set.
to the network log or to the authorized receiver if
taskname is DSICRTR.

Chapter 7. DSI Prefix Messages 717


System programmer response Operator response
Determine the cause of the routing failure. Notify the system programmer.
DSI563I DSIAMLUT DID NOT INITIALIZE
IN ESA MODE System programmer response
Determine the cause of the error from the return
Explanation and error codes listed in the message, and take the
appropriate action to correct the problem.
This message is only issued under NetView MVS/ESA.
It occurs when the DSIAMLUT task is brought up and DSI566I command FAILED. NO SERVICE
cannot use MVS/ESA functions to receive SAW and PIU POINT COMMAND GIVEN ON THE
data. COMMAND

System action Explanation


Data transfer from VTAM to session monitor will You did not specify a service point command in the
function correctly using the LU0 interface. command syntax.
Message Variables
Operator response
command
Notify the system programmer. The name of the command that failed.

System programmer response System action


Examine the system log to determine why VTAM The command is not processed.
cannot use the MVS/ESA functions for the SAW and
PIU data transfer. If you cannot determine the reason,
Operator response
contact IBM Software Support.
Enter the command again with the proper syntax.
DSI565I WARNING: VSAM FILE 'dataset'
UNAVAILABLE TO LOG BROWSE DSI568I command FAILED
TASK BECAUSE OF 'function' FOR 'SP_spkey=SP_spname,
ERROR: RETURN CODE = APPL_applkey=APPL_applname' :
X'retcode' ERRCODE = 'errcode' TRANSPORT ERROR, SENSE
CODE= X'code'
Explanation
Explanation
An unsuccessful attempt was made to perform the
function for the data set log data set. Therefore, the You entered an SPCS command for a specified service
browse task cannot browse this data set. point and application. The command failed and a
transport error occurred.
Message Variables
Message Variables
dataset
DD name of the primary or secondary network log command
data set. The command that failed.
function spkey
GENCB, SHOWCB, OPEN, CLOSE, or GETMAIN. The service point keyword. This is the actual
retcode keyword used on the command to specify the
The return code from the request. service point. It is SP or a synonym for SP.
errcode spname
The error code from the request, if any. If there is The service point name.
none, this field is filled in with two asterisks. applkey
The application keyword equals APPL or a
System action synonym for APPL.
applname
The specified data set is no longer available to be The application name.
browsed by the log browse task.

718 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


code System programmer response
The sense code number.
Determine the meanings of the error codes and system
sense data. See the device-specific documentation for
System action the meaning of the user sense data.
Processing continues. DSI570I command FAILED
FOR SP_spkey=SP_spname,
Operator response APPL_applkey=APPL_applname:
NOT SUPPORTED BY SP_spkey,
Notify the system programmer. SENSE CODE= X'code'

System programmer response Explanation


Determine the meanings of the error codes and system You entered an SPCS command for a specified service
sense data. See the device-specific documentation for point and application, and the command failed. That
the meaning of the user sense data. particular service point is not supported by the
DSI569I command FAILED specified service point.
FOR SP_spkey=SP_spname, Message Variables
APPL_applkey=APPL_applname:
INVALID RU SYNTAX, SENSE command
CODE= X'code' The command that failed.
spkey
Explanation The service point keyword. This is the actual
keyword used on the command to specify the
You entered an SPCS command for a specified service service point. It is SP or a synonym for SP.
point and application. The response unit (RU) syntax
spname
was not valid and the command failed.
The service point name.
Message Variables applkey
command The application keyword equals APPL or a
The command that failed. synonym for APPL.
spkey applname
The service point keyword. This is the actual The application name.
keyword used on the command to specify the code
service point. It is SP or a synonym for SP. The sense code number.
spname
The service point name. System action
applkey
Processing continues.
The application keyword equals APPL or a
synonym for APPL.
applname
Operator response
The application name. Notify the system programmer.
code
The sense code number. System programmer response
Determine the meanings of the error codes and system
System action sense data. See the device-specific documentation for
Processing continues. the meaning of the user sense data.
DSI571I command FAILED
Operator response FOR SP_spkey=SP_spname,
APPL_applkey=APPL_applname:
Notify the system programmer. FUNCTION NOT SUPPORTED BY
APPL_applkey, SENSE CODE=
X'code'

Chapter 7. DSI Prefix Messages 719


Explanation spkey
The service point keyword. This is the actual
You entered an SPCS command for a specified service keyword used on the command to specify the
point and application, and the command failed. The service point. It is SP or a synonym for SP.
requested function is not supported by the specified
application. spname
The service point name.
Message Variables
applkey
command The application keyword equals APPL or a
The command that failed. synonym for APPL.
spkey code
The service point keyword. This is the actual The sense code number.
keyword used on the command to specify the
service point. It is SP or a synonym for SP. System action
spname
Processing continues.
The service point name.
applkey
The application keyword equals APPL or a Operator response
synonym for APPL. Notify the system programmer.
applname
The application name. System programmer response
code
Determine the meanings of the error codes and system
The sense code number.
sense data. See the device-specific documentation for
the meaning of the user sense data.
System action
DSI573I command FAILED
Processing continues. FOR SP_spkey=SP_spname,
APPL_applkey=APPL_applname:
Operator response APPL_applkey NOT RECOGNIZED,
SENSE CODE= X'code'
Specify an application that supports the function you
are using.
Explanation
System programmer response You entered an SPCS command for a specified service
point and application, and the command failed. The
Determine the meanings of the error codes and system selected application is not recognized.
sense data. See the device-specific documentation for
the meaning of the user sense data. Message Variables
command
DSI572I command FAILED
The command that failed.
FOR SP_spkey=SP_spname,
APPL_applkey MISSING, SENSE spkey
CODE= X'code' The service point keyword. This is the actual
keyword used on the command to specify the
service point. It is SP or a synonym for SP.
Explanation
spname
You entered a LINK command for a specified service The service point name.
point and application, and the command failed. The
selected application is missing. applkey
The application keyword equals APPL or a
Message Variables synonym for APPL.
command applname
The command that failed. The application name.
code
The sense code number.

720 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action DSI575I command FAILED
FOR 'SP_spkey=SP_spname,
Processing continues. APPL_applkey=APPL_applname' :
TEST NOT SUPPORTED BY
Operator response APPL_applkey, SENSE CODE=
X'code'
Specify a valid application.

Explanation
System programmer response
You entered an SPCS command for a specified service
Determine the meanings of the error codes and system
point and application, and the command failed. The
sense data. See the device-specific documentation for
selected test was not supported by the requested
the meaning of the user sense data.
application.
DSI574I command FAILED Message Variables
FOR 'SP_spkey=SP_spname,
APPL_applkey=APPL_applname' : command
APPL_applkey BUSY OR NOT The command that failed.
AVAILABLE, SENSE CODE= X'code' spkey
The service point keyword. This is the actual
Explanation keyword used on the command to specify the
service point. It is SP or a synonym for SP.
You entered an SPCS command for a specified service
spname
point and application, and the command failed. The
The service point name.
selected application is not available.
applkey
Message Variables The application keyword equals APPL or a
command synonym for APPL.
The command that failed. applname
spkey The application name.
The service point keyword. This is the actual code
keyword used on the command to specify the The sense code number.
service point. It is SP or a synonym for SP.
spname System action
The service point name.
Processing continues.
applkey
The application keyword equals APPL or a
synonym for APPL. Operator response
applname Specify a valid application.
The application name.
code System programmer response
The sense code number.
Determine the meanings of the error codes and system
sense data. See the device-specific documentation for
System action the meaning of the user sense data.
Processing continues. DSI576I command FAILED
FOR SP_spkey=SP_spname,
Operator response APPL_applkey=APPL_applname:
LCC UNKNOWN, SENSE CODE=
Enter the command again later. The application is
X'code'
already processing another command.

Explanation
System programmer response
You entered an SPCS command for a specified service
Determine the meanings of the error codes and system
point and application, and the command failed. The
sense data. See the device-specific documentation for
specified link connection component is unknown.
the meaning of the user sense data.

Chapter 7. DSI Prefix Messages 721


Message Variables applkey
The application keyword equals APPL or a
command
synonym for APPL.
The command that failed.
applname
spkey
The application name.
The service point keyword. This is the actual
keyword used on the command to specify the selfkeyword
service point. It is SP or a synonym for SP. The self count keyword you selected.
spname selfvalue
The service point name. The number of tests specified.
applkey code
The application keyword equals APPL or a The sense code number.
synonym for APPL.
applname System action
The application name.
Processing continues.
code
The sense code number.
Operator response
System action Specify a different self count keyword or a different
application.
Processing continues.
System programmer response
Operator response
Determine the meanings of the error codes and system
Specify the correct LCC name. sense data. See the device-specific documentation for
the meaning of the user sense data.
System programmer response DSI579I command FAILED
Determine the meanings of the error codes and system FOR SP_spkey=SP_spname,
sense data. See the device-specific documentation for APPL_applkey=APPL_applname:
the meaning of the user sense data. LCC NOT RECOGNIZED BY
APPL_applkey, SENSE CODE=
DSI578I command FAILED X'code'
FOR 'SP_spkey=SP_spname,
APPL_applkey=APPL_applname' :
selfkeyword=selfvalue INVALID
Explanation
FOR APPL_applkey, SENSE CODE= You entered a LINK command for a specified service
X'code' point and application, and the command failed.
The selected application did not recognize the link
Explanation connection component you selected.

You entered a LINK command for a specified service Message Variables


point and application, and the command failed. The command
self-count name you selected is not valid for the The command that failed.
specified application.
spkey
Message Variables The service point keyword. This is the actual
keyword used on the command to specify the
command
service point. It is SP or a synonym for SP.
The command that failed.
spname
spkey
The service point name.
The service point keyword. This is the actual
keyword used on the command to specify the applkey
service point. It is SP or a synonym for SP. The application keyword equals APPL or a
synonym for APPL.
spname
The service point name. applname
The application name.

722 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


code System programmer response
The sense code number.
Determine the meanings of the error codes and system
sense data. See the device-specific documentation
System action for the meaning of the user sense data, or enter
Processing continues. SENSE code, where code is the sense code returned
in hexadecimal. For more information on the SENSE
command, see the NetView online help.
Operator response
DSI582I FAILURE DETECTED. FAILING
Specify the proper LCC name. RESOURCE CODE IS resource.
ERROR CODE IS error
System programmer response
Determine the meanings of the error codes and system Explanation
sense data. See the device-specific documentation for When associated with START, this message indicates a
the meaning of the user sense data. failure to start either the UNIX command server or the
DSI580I command FAILED indicated TSO command server.
FOR 'SP_spkey=SP_spname, Message Variables
APPL_applkey=APPL_applname' :
EXECUTION ERROR, SENSE resource
CODE= X'code' 'START-server' where server is the command server
name.
Explanation error
For START, one of the following error codes:
You entered a LINK command for a specified service
point and application. An execution error occurred and 16
the command failed. Failed to obtain PPI name because of
multiple concurrent START TSOSERV or START
Message Variables UNIXSERV commands
command 104
The command that failed. SUBMIT failed, see accompanying message
spkey 108
The service point keyword. This is the actual Protocol failure between NetView and the
keyword used on the command to specify the command server
service point. It is SP or a synonym for SP. Any other codes returned are PPI error codes.
spname
The service point name. System action
applkey
The application keyword equals APPL or a Processing continues.
synonym for APPL.
applname Operator response
The application name. Notify the system programmer.
code
The sense code number. System programmer response
Correct the indicated error condition. PPI error codes
System action are described in the IBM Z NetView Application
Processing continues. Programmer's Guide.
DSI585I INFORMATION MARKED BY '>'
Operator response EXCEEDS DISPLAY LENGTH AND
HAS BEEN TRUNCATED
Notify the system programmer.

Chapter 7. DSI Prefix Messages 723


Explanation Operator response
Data has been received that is too long to display on a Let the command procedure finish before issuing
full-screen panel. the RETURN command. If the command procedure
is paused or waiting, issue GO or CANCEL so the
System action command procedure can finish.

The system truncates the data and continues DSI588I COMMAND PROCEDURE cmdproc
processing. STACKED, ISSUE 'UNSTACK' TO
RESUME

Operator response
Explanation
Read the truncated data by invoking the command
through the command list. The operator has entered a RETURN or ROLL
command to return to the command facility from
a full-screen processor (such as session monitor or
System programmer response hardware monitor), and a paused or waiting command
Determine the reason for the long message reply; procedure has been stacked.
check your NetView/PC applications. Message Variables
DSI586I COMMAND PROCEDURE cmdproc cmdproc
IS RESUMED The name of the command procedure.

Explanation Operator response


The specified command procedure has resumed Issue UNSTACK to let the command procedure run, or
processing. issue any other valid command.
Message Variables DSI589I INPUT COMMANDS WAITING
cmdproc ON STACK, ISSUE 'STACK' TO
The name of the command procedure (including EXECUTE
HLL, REXX, and NetView command list language
command lists). Explanation
You entered one or more commands that were not
System action immediately executed because of an active command
Processing continues. list (running, waiting, or paused). These commands are
still waiting for execution. This message is issued upon
DSI587I returncmd IGNORED, COMMAND resumption of the command list after any interruption.
PROCEDURE cmdproc IS status
System action
Explanation
The command list continues in its current state.
You entered a RETURN command to return to a
full-screen processor (such as session monitor or
Operator response
hardware monitor), but the command fails because a
command procedure is currently running. If you take no action, the stacked commands will
continue to wait until your command list finishes.
Message Variables
If you want to run the stacked commands sooner,
returncmd issue the STACK command. You cannot inquire which
The command name of the return command. commands are pending or cancel them (except by
cmdproc logging off).
The name of the command procedure. DSI590I CMDDEF STATEMENTS MAY BE
status MISSING FOR module
The status of the command procedure, which
includes ACTIVE, PAUSED, STACKED, or WAITING.

724 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
One or more of the modules specified requires a The NetView program suppresses the display of
CMDDEF statement. messages at certain times. nnn suppressed messages
have arrived since a message was last displayed.
Message Variables
Of the nnn suppressed messages, hhh were “held”
module messages. A held message is one defined by your
The name of the module or modules lacking the programmer to be kept on your screen until you
CMDDEF statement in CNMCMD. remove it. The held messages are now being displayed
or will be displayed when there is enough room to
System action display them.
Message Variables
The command list does not run.
nnn
Operator response The number of suppressed messages written to
the log, including hhh.
Notify the system programmer.
hhh
The number of suppressed messages that are
System programmer response defined as held messages.
If the CMDDEF statement is missing from any of the
mentioned modules, add it to CNMCMD. If not missing, System action
then contact IBM Software Support.
Processing continues.
DSI592I COMMAND LIST cmdlist WARNING
- COMMAND TEXT TRUNCATED Operator response
Browse the log.
Explanation
DSI594A COMMAND PROCEDURE cmdproc
The length of the command text is greater than 32000
WARNING — type STATE ENTERED
characters or a command operand is longer than 255
characters. The NetView program truncates everything
after 32000 characters or after the last valid length Explanation
operand. While a full-screen command processor was running,
Message Variables a command procedure went into a state which
prevented the full-screen command processor from
cmdlist accepting input.
The name of the command list.
Message Variables
System action cmdproc
The name of the command procedure that
The command list continues.
contains the statement.
type
Operator response The type of state that the command procedure
Notify the system programmer. entered.

System programmer response System action


Correct the command list so the truncation is not The command facility screen is displayed. Input here
required. is accepted.

DSI593A nnn MESSAGE(S) NOT DISPLAYED.


OF THESE, hhh WERE HELD Operator response
MESSAGES. If the command procedure is waiting for an operator
response, enter the necessary information. Ensure that
a WAIT or &WAIT is satisfied before rolling to other
components.

Chapter 7. DSI Prefix Messages 725


DSI596I WAITING TO DISPLAY A PANEL, spkey
COMMAND NOT PROCESSED. HIT The service point keyword. This is the actual
ENTER keyword used on the command to specify the
service point. It is SP or a synonym for SP.
Explanation spname
The service point name.
You entered a command while your operator station
was waiting to present or return to a full-screen applkey
display. The application keyword equals APPL or a
synonym for APPL.
applname
System action
The application name.
The NetView program ignores the command and holds code
the screen (as if a HOLD command had been issued). The sense code number.

Operator response System action


You can go to the full-screen display and enter the Processing continues.
command again, or you can enter a HOLD, RESET,
CLEAR, or LOGOFF command from the held screen. To
go to the full-screen display, press ENTER. From the Operator response
full-screen display, you can enter the command again Do not specify duplicate LCC names.
on the command line if one is present, or you can roll
to the command facility and enter the command again. DSI599I command FAILED
FOR 'SP_spkey=SP_spname,
DSI597I TERMINATION OR STOP FORCE APPL_applkey=APPL_applname' :
ALREADY IN PROGRESS. NO ENTRY EXISTS IN THE ACTIVE
COMMAND IGNORED CONFIGURATION. SENSE CODE=
X'code'
Explanation
A START, STOP, or STOP FORCE command was issued Explanation
by the NetView operator while a previous STOP FORCE You entered an SPCS command for a specified service
command or termination is still active. point and application, and the command failed. No
entry exists in the active configuration as specified.
System action Message Variables
The termination or STOP FORCE continues and the command
command is ignored. The command that failed.
DSI598I command FAILED spkey
FOR 'SP_spkey=SP_spname, The service point keyword. This is the actual
APPL_applkey=APPL_applname' : keyword used on the command to specify the
INVALID SYNTAX DUPLICATE LCC service point. It is SP or a synonym for SP.
NAMES. SENSE CODE= X'code'
spname
The service point name.
Explanation applkey
You entered an SPCS command for a specified The application keyword equals APPL or a
service point and application, and the command failed synonym for APPL.
because of incorrect syntax. Duplicate link connection applname
component names cannot be used. The application name.
Message Variables code
The sense code number.
command
The command that failed.
System action
Processing continues.

726 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Explanation
Notify the system programmer. The command was not entered by a NetView terminal
operator. For example, the SET KEY command can only
System programmer response be entered by a NetView terminal operator.
Message Variables
Determine why there is no configuration data in the
service point. command
The name of the command.
DSI600I commandtext
DSI604I OPERAND 'object' INVALID
Explanation
Explanation
This message is a continuation of message DSI608I,
the display of PF or PA key settings. One of the following occurred:
Message Variables • The key you specified is not PA1 through PA3, or PF1
through PF24.
commandtext
The text of a command. • The command you entered is a command list that is
not defined in CNMCMD with a CMDDEF statement.
System action • The command you entered is not valid.

The LIST command continues. • An operand on the command you entered is not
valid.
DSI602I INVALID IFR CODE = code
Message Variables
RECEIVED FROM operatorid
object
Explanation Any of the following:
• A PF or PA key.
The NetView program has encountered an internal
function request (IFR) code that is not valid on its • The name of a command.
message queue. • An operand that is not valid.
Message Variables
code System action
The code used for problem analysis The NetView program ignores the command.
operatorid
The operator identifier Operator response
Correct and enter the command again.
System action
DSI606I DISPLAY OF PF/PA KEY SETTINGS
Processing continues.
FOR applid

Operator response Explanation


Notify the system programmer.
This is a major header line produced by the LIST KEY
command.
System programmer response
Message Variables
Check user-written command processors and user-
applid
written exit routines that use the NetView DSIMQS
The full screen application for which this key or set
service macro for communication to the TCT. The
of keys is set.
NetView program does not support TCAM; therefore,
rewrite these programs to use IFR codes 4, 5, 6, and 7
only. System action
DSI603I command COMMAND ISSUED The LIST command continues.
FOR NON-OST TASK. COMMAND
DSI607I KEY ----TYPE---- -----------
REJECTED
COMMAND------------ SET-APPL

Chapter 7. DSI Prefix Messages 727


Explanation System action
This is a title line produced by the LIST KEY command. The NetView program rejects the command.
It identifies the fields in the message DSI608I that
follows. Operator response
Do not enter this command. Use a PA or PF key. Notify
System action
the system programmer.
The LIST command continues.
DSI608I key keyno keyact, action System programmer response
commandtext setappl Remove the CMDDEF definition statement for the
incorrect verb from the CNMCMD definition file.
Explanation
DSI613I PF/PA KEY NOT SET FOR applid
This is a line produced by the LIST KEY command. It
identifies a PF or PA key and its respective command. Explanation
Message Variables
The PA or PF key that you pressed is not defined with
key the SET command.
PF or PA key.
Message Variables
keyno
The number of the PA key (1–3) or PF key (1–24). applid
The name of the full screen application.
keyact
IMMED or DELAY.
System action
action
APPEND or IGNORE. The command is rejected.
commandtext
The text of the command or command list. Operator response
setappl Enter a SET command for the desired PA or PF key, or
The applid for which this key was set. enter LIST KEY=ALL to find the PF or PA key that you
have already set.
System action DSI614I PA KEY AND APPEND OPTION
The LIST command continues. ARE INCOMPATIBLE. CHANGED
TO IGNORE
DSI611I pfkey NOT SET FOR applid
Explanation
Explanation
APPEND cannot be used as a SET option when setting
This key is not set for the given application. PA keys. APPEND requires data to be sent to the host.
Message Variables PA keys do not send data to the host.

applid
The name of the full screen application. System action
pfkey The NetView program substitutes IGNORE and
The name of a PF or PA key. APPEND in the SET command.

DSI612I INVALID VERB FOR DSIPFK


COMMAND PROCESSOR Operator response
If the key being defined by the SET command must
Explanation have the APPEND option, enter the SET command
again defining a PF key instead of a PA key.
The verb used to define the PF or PA key command
processor, DSIPFK, is not a PF or a PA key. DSI616I key NOT SET YET

728 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Operator response
This key can be set, but has not yet been set. Notify the system programmer.
Message Variables
System programmer response
key
The key that is not set. Contact IBM Software Support.
DSI620I PF KEY USE INVALID FROM
Operator response MODEM CONFIGURATION PANEL
Set the key if it was the correct choice, or enter the
correct key. You can enter LIST KEY=ALL to list the Explanation
current key settings.
You pressed a PF or PA key on the modem
DSI617I MAXIMUM NUMBER OF CMDSYN'S configuration panel.
FOR command EXCEEDED IN
DSI621I REXX INTERPRETER
object
UNAVAILABLE TO NETVIEW

Explanation
Explanation
The maximum number of command synonyms defined
The release of VM that you are using does not support
in a CMDSYN statement in CNMCMD is 255. The
NetView REXX.
maximum was exceeded.
Message Variables
System action
command
The NetView program continues processing.
The command name.
object
The member in which the error was found, or
Operator response
the name of an embedded member appears if Notify the system programmer.
the error indicated by the message occurred in
a member included (%INCLUDE statement) in
System programmer response
object. If multiple levels of embedding occurred
within object, only the level where the error To use NetView REXX on a VM system, have VM
occurred is specified. Release 6 REXX Enhancements SPE or a later release
of VM installed.
System action DSI622I DUPLICATE LCC NAMES NOT
The NetView program ignores the statement. ALLOWED

System programmer response Explanation


Remove the statement in error or another statement to The NetView program does not allow duplication
ensure there are no more than 255. between the entries in the command subfield.

DSI619I IMPROPER COMMAND BUFFER


System action
PASSED TO PPT
The NetView program ignores the entire command
Explanation entry.

A buffer queued to the PPT had either an incorrect


Operator response
format or an incorrect buffer type indicator in the
buffer head. Enter the command correctly. For a description of the
command subfields, see the NetView online help.
System action DSI623I LOAD FAILED FOR REXX MODULE
Processing continues and the command request does module
not run.

Chapter 7. DSI Prefix Messages 729


Explanation Explanation
The specified module cannot be loaded. An unexpected SYNAD or LERAD error occurred during
VTAM processing. Use the RCFB command list for a
Message Variables
description of the return code and feedback code. Use
module the SENSE command list for a description of the sense
The name of the module. code.
Message Variables
System action
taskid(source lu)
The module refers to a REXX exit. REXX initialization The name of the failed task or source LU (TAF).
continues. macro
The name of the failed macro.
Operator response vtamrcd
Notify the system programmer. The VTAM internal return code.
vtamfb
System programmer response The VTAM internal feedback code.
vtamsens
Ensure that the module is correctly installed and then
The VTAM internal sense code.
call IBM Software Support.
snocode
DSI624I INCONSISTENT PARAMETER The “should not occur” code as follows. Codes 2,
USAGE, A NON-PERSISTENT 6, and 7 indicate logic errors. Codes 3, 4, 5, 8, and
SESSION WAS DEFINED, BUT THE 9 indicate physical errors.
INACTIVITY INTERVAL IS ZERO
2
Unexpected RPLREQ request is out of range or
Explanation is not supported by NetView program.
You have specified PERSIST=NO on a DSTINIT or 3
CNMTARG definition statement, but you have not Unexpected VTAM return code or feedback
set the nonpersistent sessions time-out field in code for this request.
DSICTMOD. 4
Unexpected system sense value.
System action 5
The NetView program defaults the session to Unexpected user sense value for BSC 3270
persistent. The PERSIST=NO option is ignored. (non-TAF environment only).
6
Operator response RPL not found in DSINAT table (non-TAF
environment only).
Notify the system programmer.
7
Communication identifier (CID) is not valid.
System programmer response 8
Set the nonpersistent sessions timeout interval in Operator check on BSC remote (non-TAF
DSICTMOD to the number of seconds of inactivity that environment only).
the NetView program waits before bringing down its 9
LUC sessions. Assemble and link-edit DSICTMOD and Sense is 0 for nonlocal 3270 (non-TAF
recycle the NetView program. environment only).
DSI625I UNEXPECTED SYNAD OR LERAD
ERROR FOR taskid(source lu), System action
macro FAILED - RTNCD
• In a non-TAF environment, the NetView program
= X'vtamrcd' FDBK2 =
ends with abend 258 (X'102') with dump for logic
X'vtamfb' SYSTEM/USER SENSE =
errors (LERAD) or with abend 268 (X'10C') with no
X'vtamsens' SNOCODE = snocode
dump for physical errors (SYNAD).

730 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


• In a TAF environment, the NetView program ends DSI628I keyword=value IS NOT VALID
with abend 269 (X'10D') with a dump for logic errors FOR module IN object.
(LERAD) or the TAF session abends for physical keyword2=value2 IS ASSUMED
errors (SYNAD).
Explanation
Operator response
RES=N is not a valid keyword in this case. If you enter
Notify the system programmer. a command whose type is IMMEDIATE or BOTH, or the
module is one of the required listed RES=Y NetView
System programmer response commands, then RES=Y is assumed.

Use the RCFB and SENSE command lists to determine Message Variables
the meaning of the return/feedback and sense keyword=value
codes. See the device-specific documentation for the The keyword/value pair that violates the command
meaning of the user sense data. definition restrictions.
DSI626I LOAD FAILED FOR module, LOGON module
ABORTED The name of the module.
object
Explanation The member in which the error, or the name
of an embedded member if the error indicated
The appropriate logon authorization module (DSILAN, by the message occurred in a member included
DSILAM or DSILAR) cannot be loaded. The NetView (%INCLUDE statement) in object. If multiple levels
program did not accept your logon request. of embedding occurred within object, only the
Message Variables level where the error occurred is specified. If the
ADDCMD command issued this message, object is
module ADDCMD.
DSILAN, DSILAM, or DSILAR.
keyword2=value2
The keyword/value pair that is assumed.
Operator response
Notify the system programmer. System action
The NetView program uses the assumed keyword and
System programmer response value.
Determine why the load failed and correct the error.
Operator response
DSI627I LOAD FAILED FOR module,
COMMAND ABORTED Notify the system programmer.

Explanation System programmer response


The appropriate module for the command cannot be Modify the keyword/value pair on the CMDDEF
loaded. The command does not run. statement or the ADDCMD command to conform to
the usage restrictions. See the online help for more
Message Variables
information.
module
The name of the module. DSI630I PF/PA KEY VALUE TRUNCATED

Operator response Explanation


Notify the system programmer. The complete PF or PA key value you previously
defined in a SET command does not fit in the current
command input area.
System programmer response
Determine the reason for the load failure and correct System action
the error.
The input area is filled and the rest of the PF or PA key
value is truncated.

Chapter 7. DSI Prefix Messages 731


Operator response DSI633I command COMMAND
SUCCESSFULLY COMPLETED
Enter the INPUT command to increase the input area
size and retry the PF or PA key.
Explanation
DSI631I command NOT ALLOWED IN
command COMMAND You entered the command and it completed
successfully.
Explanation Message Variables

The specified command is not valid when used in SET. command


The name of the command
Message Variables
DSI634I "WARNING" - MORE THAN ONE
command VALID DEFFOCPT STATEMENT
The name of the command. WITH TYPE = type HAS
BEEN ENCOUNTERED. THE LAST
System action STATEMENT WILL BE ACCEPTED
The NetView program ignores the command.
Explanation
Operator response You defined more than one DEFFOCPT definition
statement with the same focal point type. This
Enter the command again using a valid command or
message is issued for each DEFFOCPT definition
command list name. See the NetView online help.
statement encountered after the first one of the same
DSI632I task : DUPLICATE KEYWORD type is processed.
'keyword' IGNORED ON 'stmt' Message Variables
STMT/CMD, FIRST VALUE USED
type
The focal point type (ALERT, STATUS, or
Explanation OPS_MGMT).
You specified a duplicate keyword on the control
statement or command. System action
Message Variables Processing continues. The system uses the name
task specified on the last DEFFOCPT statement as the focal
The name of the task. point.
keyword
The duplicate keyword specified. Operator response
stmt Notify the system programmer.
The control statement or command where the
duplicate keyword appears.
System programmer response
System action The system issues message DSI667I or DWO551I
after this message. You can tell by the focal point
The NetView program uses the first value specified for name in these messages if the system is using the
the keyword causing the error. correct focal point name.
If the focal point name is not correct, correct the
Operator response DEFFOCPT definition statements that reside in the
Notify the system programmer. DSICRTTD member if type is ALERT or STATUS.
Correct the statements in the DSI6INIT member if
type is OPS_MGMT. Then, recycle subtask DSICRTR or
System programmer response DSI6DST.
Determine whether the first keyword value is correct Remove any DEFFOCPT definition statements that are
for your environment. If the first value is not correct, not needed, whether the assumed focal point name is
correct the statement or command causing the error. correct or not. See the IBM Z NetView Administration

732 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Reference for more information on the DEFFOCPT Message Variables
definition statement.
operatoridn
DSI636I AUTH MESSAGE STRING: An operator identifier, where n is 1 through 5.
'message'
System action
Explanation Command processing continues.
This is a header line produced by the LIST MSG=AUTH
DSI640I OP(ALL): operatorid1 operatorid2
or LIST ASSIGN=AUTH command. The NetView
operatorid3 operatorid4
program found the message you requested.
operatorid5
Message Variables
message Explanation
The messages or commands.
This message shows either a list of up to five operators
assigned to receive copies of the messages given by a
System action specific string in message DSI174I, DSI637I or a list
of up to five operators assigned to a specific group ID
LIST command processing continues.
given in message DSI180I.
DSI637I COPY MESSAGE STRING: Message Variables
'message'
operatoridn
An operator identifier, where n is 1 through 5.
Explanation
This is a header line produced by the LIST MSG=COPY System action
or LIST ASSIGN=COPY command. The NetView
program found the message you requested. Command processing continues.
Message Variables DSI641I operatorids
message
The messages or commands. Explanation
This message is a continuation of a list of operators
System action that begins in message DSI638, DSI639, or DSI640.
Command processing continues. Message Variables
DSI638I PRI(1ST): operatoridn operatorids
Additional operator identifiers.
Explanation
System action
This is the list of up to five primary operators assigned
to be primary receivers by message DSI173I or Command processing continues.
DSI636I.
DSI642I END OF ASSIGN DISPLAY
Message Variables
operatoridn System action
An operator identifier, where n is 1 through 5.
Command processing continues.

System action DSI643I NO MESSAGE STRINGS/GROUP


IDS ARE ASSIGNED
Command processing continues.
DSI639I SEC(ALL): operatoridn Explanation
No message strings or group IDs are assigned for the
Explanation requested function.
This is a list of up to five operators assigned to be DSI644I MESSAGE STRING/GROUP ID
secondary receivers specified by message DSI173I or 'string' NOT ASSIGNED
DSI636I.

Chapter 7. DSI Prefix Messages 733


Explanation Operator response
The message string or group ID is not assigned or Correct the command specification and reenter the
there are no operators in the group. command. Correct the initialization member and
restart the task or notify the system programmer.
Message Variables
string System programmer response
The message string or group ID you entered.
Correct the initialization member and restart the task.
Operator response DSI647I DUPLICATE KEYWORD keyword
If you receive this message for an ASSIGN command
specifying the DROP operand, enter a LIST command Explanation
to determine which messages or groups are assigned.
You entered the keyword more than once.
DSI645I MESSAGE STRING/GROUP ID
Message Variables
'string' DROPPED
keyword
The keyword specified.
Explanation
The message string or group ID was dropped from the System action
assignment lists. If ALL is specified, then all of the
specified message or group assignments are dropped. If this message is the result of an operator entered
command, the command ends. If it is the result of an
Message Variables
error in a task initialization member, the task can be
string ended.
The message string, group ID, or ALL.
Operator response
System action
Correct the command specification and reenter the
The assignment is dropped. command. Correct the initialization member and
restart the task or notify the system programmer.
DSI646I KEYWORD 'keyword' IS INVALID

System programmer response


Explanation
Correct the initialization member and restart the task.
The keyword you used is not recognized. You might
have entered it incorrectly. DSI648I KEYWORD CONFLICT BETWEEN
keyword1 AND keyword2
If the DSI646I message is issued during NetView
initialization, an internally generated CMDDEF
statement or CNMSTYLE keyword follows the Explanation
message. This statement might not be a true The keywords (keyword1 and keyword2) cannot be
representation of the original statement, but has specified on the same occurrence of the command or
sufficient information that you can use to find the on the same statement in the initialization member.
original statement in error.
Message Variables
Message Variables
keyword1
keyword The first keyword specified.
The keyword specified.
keyword2
The second keyword specified.
System action
If this message is the result of an operator entered System action
command, the command ends. If it is the result of an
error in a task initialization member, the task can be If this message is the result of an operator entered
ended. command, the command ends. If it is the result of an
error in a task initialization member, the task can be
ended.

734 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response ended. For the TRACE command and for the PRIMARY
keyword, the BACKUP keyword, or both, the NetView
Correct the command specification and reenter the program continues to process to the next keyword and
command. Correct the initialization member and value specified (if any).
restart the task or notify the system programmer.

Operator response
System programmer response
Correct the keyword value and reenter the command.
Correct the initialization member and restart the task. Correct the initialization member and restart the task
DSI649I KEYWORD keyword HAS INVALID or notify the system programmer. Notify the system
VALUE: 'value' programmer for the PRIMARY keyword, the BACKUP
keyword, or both.

Explanation
System programmer response
You specified a value that is not valid for the keyword.
Correct the PRIMARY keyword, the BACKUP keyword,
If the message DSI649I is issued during NetView or both in the DEFFOCPT definition statement in the
initialization, a reconstituted CMDDEF statement appropriate subtask initialization member, DSI6INIT
follows the message. This reconstituted CMDDEF, or DSICRTTD member. Recycle the appropriate
although it might not be a true representation of the subtask, DSI6DST or DSICRTR for the changes to take
original CMDDEF, has sufficient information to find the effect.
original CMDDEF in error.
DSI650I INVALID SYNTAX: 'operand'
The following information applies to the REGISTER
command only: If keyword is COMMAND, then value
is not a valid NetView command. If keyword is APPL, Explanation
then value is either an architected application name You entered a command incorrectly or coded a
with improper syntax or a restricted application name. definition statement incorrectly.
Some of the architected MS application names now
have character constants that can be used in place of If the message DSI650I is issued during NetView
the hexadecimal values that are currently supported. initialization, a reconstituted statement either follows
The MS applications that have these constants are: the message or is contained in the message. This
reconstituted definition, although it might not be a true
Arch Name/Char Value representation of the original definition, has sufficient
Arch Value information to find the original definition in error.
Alert_Netop/ALERT
Message Variables
X'23F0F3F1'
Ops_Mgmt_Netop/OPS_MGMT operand
X'23F0F1F7' The operand in which the error was found. Other
error responses can be:
Ep_Ops_Mgmt/EP_OPS
X'23F0F1F6' • UNBALANCED QUOTES
Ms_Caps/MS_CAPS • PARENTHESES INCORRECT
X'23F0F1F1' • INVALID DELIMITER
If keyword is FPCAT, then value is an application name • DELIMITER MISSING
with improper syntax. • INCORRECT CONSECUTIVE DELIMITERS
Message Variables It is possible that a value was omitted or an extra
keyword delimiter was incorrectly included.
The keyword specified.
value System action
The value specified.
The command ends or the definition statement is not
processed.
System action
If this message is the result of an operator entered
command, the command ends. If it is the result of an
error in a task initialization member, the task can be

Chapter 7. DSI Prefix Messages 735


Operator response Operator response
If the message is issued because of an error in a Correct the command specification and enter the
command, correct the syntax of the command and command again. Correct the initialization member and
enter it again. If the message is issued because of restart the task or notify the system programmer.
an error in a definition statement, either correct the
DSI652I MESSAGE STRING/GROUP ID
syntax of the definition statement or notify the system
programmer. 'string1' INVALID: 'string2'
ALREADY ASSIGNED

System programmer response


Explanation
If the message is issued because of an error in
a definition statement, correct the syntax of the The assignment for string1 is not allowed because
definition statement. string2 is already defined.
Message Variables
DSI651I KEYWORD MISSING - ONE OF
FOLLOWING REQUIRED: keywords string1
The string of characters from the ASSIGN
Explanation command.
string2
Specify one of the keywords for the associated The string of characters from a previous ASSIGN
command. command.
If one of the keywords given below is present in the
message, consult the command's help panels for a System action
complete explanation of the format of the required
keyword. The NetView program rejects the assignment.
• INTEGER STRING
Operator response
• POSITION.LENGTH STRING
• DELIMITED STRING Enter a LIST MSG or LIST ASSIGN command to
determine if the desired message or group ID is
• DDNAME.MEMBER STRING assigned. If so, issue the ASSIGN command again with
• TOKEN STRING appropriate options. For more information, see the
• MORE-TOKENS STRING description of the ASSIGN command in the NetView
online help.
If the message DSI651I is issued during NetView
initialization, a reconstituted CMDDEF statement DSI653I VALUE MISSING FOR KEYWORD
follows the message. This reconstituted CMDDEF 'keyword'
statement, although it is not be a true representation
of the original CMDDEF, has sufficient information to Explanation
find the original CMDDEF in error.
You did not specify a value for the given keyword.
Message Variables
Message Variables
keywords
A set of keywords, at least one of which is required keyword
for the associated command. The keyword requiring a value.

System action System action


If this message is the result of an operator entered • If this message occurs during NetView initialization,
command, the command ends. If it is the result of an the NetView program continues to initialize.
error in a task initialization member, the task can be • If this message occurs when a NetView command
ended. was issued, the NetView program stops processing
the command.

736 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response keyword2
The keyword associated with value.
• If this message was issued during NetView
initialization, correct the statement in error and
restart NetView or use the RESTYLE command, if System action
applicable, to use the corrected statement. If this message is the result of an operator entered
• If this message was issued when a NetView command, the command ends. If it is the result of an
command was issued, reenter the corrected error in a task initialization member, the task can be
command. ended.

DSI654I KEYWORD 'keyword' CANNOT


HAVE A VALUE Operator response
Correct the command specification and enter the
Explanation command again. Correct the initialization member and
restart the task or notify the system programmer. See
You gave the keyword shown in the message a value, the NetView online help for the correct syntax.
but it cannot have a value.
DSI657I THE SAME TELEPHONE NUMBER
Message Variables
ENTERED TWICE
keyword
The keyword in error. Explanation
The command failed because you specified the same
System action telephone number twice on the CONNECT keyword.
If this message is the result of an operator entered
command, the command ends. If it is the result of an System action
error in a task initialization member, the task can be
ended. Processing continues and the NetView program
ignores the request.
Operator response
Operator response
Correct the command specification and enter the
command again. Correct the initialization member and Determine the phone numbers you need. Ensure each
restart the task or notify the system programmer. number is unique.
DSI660I STOP TASK ISSUED FOR task BY
System programmer response operatorid
Correct the initialization member and restart the task.
Explanation
DSI655I CONFLICT BETWEEN KEYWORD
'keyword1' AND VALUE 'value' FOR You entered a STOP TASK command for task. The
KEYWORD 'keyword2' command has been accepted and is being processed.
Message Variables
Explanation task
The command failed because of a conflict between a The name of the DST or OPT (user-written) task
keyword and a value for the second keyword. operatorid
Note: To use the CONNECT and DISCONN keywords, The operator identifier
MODEM must equal LOCAL. To use the CONTACT
keyword, MODEM can equal LOCAL or REMOTE only. System action
To use the SPEED keyword, LEVEL must equal 1.
The named task ends.
Message Variables
DSI661I STOP TASK ISSUED FOR task BY
keyword1 operatorid
The keyword causing the conflict.
value
The value causing the conflict.

Chapter 7. DSI Prefix Messages 737


Explanation 5
SLU protocols are not valid.
An operator issued a STOP TASK command. This
message is received by the operator who most 6
recently started the named task. If the operator Common protocols are not valid.
has logged off, the message goes to the authorized
receiver. System action
Message Variables If you received error codes 1, 2, or 3, the NetView
program denies the request for connection. If you
task
received error codes 4, 5, or 6, the NetView program
The name of the task being stopped
enforces the required values and the request for
operatorid connection continues.
The ID of the operator who issued the STOP
command.
Operator response
System action Choose a logmode name with the correct BIND
parameters. Notify the system programmer.
Processing continues. Any further messages issued by
the task named in the message go to the operator
named in this message. System programmer response
DSI662I SCREEN HELD Ensure that the BIND parameters in the logmode table
for the secondary logical unit are correct.

Explanation DSI664I HARDCOPY hclname ALREADY


ACTIVE USING logmode LOGMODE
You entered the command to hold the autowrap
function.
Explanation
System action You entered START HCL for a named hard copy printer
with a logmode already in use.
The autowrap function is held.
Message Variables
DSI663I ERRORS FOUND IN LOGMODE
logmode - CODE(S) codes hclname
The name of the hard-copy log device.

Explanation logmode
The logmode definition, or DEFAULT.
You entered the START DOMAIN command for a
domain with a logmode that had errors in the BIND
System action
parameters.
The printer is connected to the task but the logmode
Message Variables
you asked for is not used.
logmode
The logmode definition. Operator response
codes
The code used for problem analysis will be one of To use the requested logmode, enter STOP HCL and
the following: then START HCL for another printer using that logmode
or a printer not in use. Or, enter:
1
TS profile is not valid. STOP HCL=hclname,OP=ALL

2
When the printer has finished printing, and you receive
FM profile is not valid.
message DSI104I, enter START HCL for the required
3 logmode name.
LU type is not valid.
DSI665I KEYWORD CONFLICT BETWEEN
4 keyword1 AND keyword2.
PLU protocols are not valid. KEYWORD keyword2 IGNORED

738 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation type
The type of data for which focal point information
Keywords keyword1 and keyword2 can not be is being given.
specified in the same invocation of the command.
netid1
Message Variables The name of the network in which fpname resides.
keyword1 If this variable is not present, then fpname resides
The first keyword specified. in the local network.

keyword2 fpname
The second keyword specified. The name of the remote node that is the primary
focal point for the specified type.
netid2
System action
The name of the network in which backup resides.
The NetView program ignores keyword2. Keyword1 is This variable is not present if backup resides in the
processed normally. local network or if backup is NONE.
DSI666I INVALID FOCAL POINT backup
DEFINITION : TYPE type The name of the remote node that is the backup
focal point for the specified type. If no backup is
present, this variable is NONE.
Explanation
An unknown focal point type was defined on a System action
DEFFOCPT definition statement.
Processing continues.
Message Variables
DSI669I NO FOCAL POINTS DEFINED :
type TYPE type
The unknown focal point type.

Explanation
System action
This message is the response to a LIST FOCPT
The system ignores the statement and processing command if a focal point node is not defined for the
continues. hardware monitor, or if the router task (DSICRTR) is
not active.
Operator response Message Variables
Notify the system programmer. type
ALERT or STATUS.
System programmer response
Correct the DEFFOCPT definition statement with the System action
unknown focal point type. DEFFOCPT statements are Processing continues.
in member DSICRTTD or member DSI6INIT. Then,
recycle subtask DSICRTR or DSI6DST. See the IBM Z
NetView Administration Reference for more information Operator response
on the DEFFOCPT definition statement. Notify the system programmer.
DSI667I type FOCAL POINT: PRIMARY
'netid1.fpname' BACKUP System programmer response
'netid2.backup'
Check the network configuration and if necessary,
define the focal points.
Explanation
DSI670I NOT ENOUGH STORAGE TO
This message is the response to a LIST FOCPT PROCESS COMMAND command,
command. It can also occur when the NetView COMMAND NOT PROCESSED
program processes a DEFFOCPT definition statement.
Message Variables

Chapter 7. DSI Prefix Messages 739


Explanation If this message is received after you enter the
CHANGEFP command for type ALERT, check the
There is an out of storage condition. The NetView network log to see if the DWO130I SNA sense
program has encountered a processing error. code message precedes the DSI671I message. If
Message Variables it does, then the NetView program attempted to
send the CHANGEFP command to its specified target
command through one transport method (corresponding to
DEFFOCPT or LIST message DWO130I) and then another (corresponding
to message DSI671I), but both failed.
System action DSI672I UNABLE TO RECEIVE DCNM
Processing continues. CROSS-DOMAIN DATA

Operator response Explanation


Determine whether you received message BNH16I, This message is issued when an LU 0 RECEIVE fails.
which means the task has reached its storage limit.
If so, notify your system programmer. System action
Processing continues.
System programmer response
See the IBM Z NetView Troubleshooting Guide for Operator response
possible causes of the storage shortage. If necessary,
see the IBM Z NetView Tuning Guide for more storage Notify the system programmer.
calculation information.
DSI671I UNABLE TO ROUTE DCNM DATA System programmer response
BETWEEN DOMAIN domain AND Check definitions, restart appropriate devices or tasks.
luname
DSI676I descriptor OPERATOR ID
SPECIFIED ON OPERATOR
Explanation STATEMENT IN object
An LU 0 SEND request failed.
Message Variables Explanation
domain An OPERATOR statement in DSIOPF contains an error
The name of the domain trying to send the in the OPID (label) field.
distributed communications network management Message Variables
(DCNM) data.
descriptor
luname
The type of syntax problem. DUPLICATE implies
The name of the LU to which the DCNM data
that this OPID has already been defined. INVALID
cannot be routed. The LU can be a focal point or
implies that the OPID is prohibited, for example,
an LU in a foreign domain.
SYSOP or LOG, or that a character that is not valid
was found in OPID. A-Z, 0-9, #, @, and $ are the
System action only characters allowed.
Processing continues. object
The member in which the error was found, or the
name of an embedded member. If multiple levels
Operator response of embedding occurred within object, only the level
Notify the system programmer. where the error occurred is specified.

System programmer response System action


Investigate the reason why the SEND failed and The OPERATOR statement is ignored. Message
make corrections, if necessary. The network log might DSI813A might be generated during the NetView
contain information on why the SEND failed. initialization. If message DSI813A is generated,
NetView waits for a response.

740 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response DSI679I operator ON TERMINAL terminal
REVOKED BY SECURITY
Notify the system programmer. SOFTWARE

System programmer response Explanation


Correct the OPERATOR statement that is not valid. The security software has rejected your attempt to
For more information, see the IBM Z NetView log on because you exceeded the maximum number
Administration Reference. of attempts to log on with a password or password
DSI677I PORT SPECIFIED MUST BE phrase that is not valid.
CONFIGURED Message Variables
operator
Explanation The name of the operator attempting to log on.
The port specified as the “PORT USED FOR EXTERNAL terminal
CLOCK” must be a configured port. You specified a The name of the terminal from which an operator
port that is not configured. attempted to log on. The terminal name can be one
of the following:
System action • An LU identifier (for example, YOURLU)
The NetView program ignores the command and • An IP address (for example, 146.84.144.121)
highlights the names of ports that are not configured.
System action
Operator response
The LOGON command is rejected.
Replace each highlighted field with the name of a port
which is configured, or configure the port. To configure
Operator response
a port, fill in the fields in the corresponding column.
Notify the system programmer.
DSI678I COMMAND PROCEDURE cmdproc
TERMINATED - ERROR IN PRIOR
NESTED COMMAND PROCEDURE. System programmer response
Verify the operator ID and password or password
Explanation phrase. Correct the security software data set if
necessary.
The specified command procedure is the last one in a
nested chain to end because of an error in one of the DSI680I PORT SPECIFIED MUST BE
other command procedures in the nested chain. SYNCHRONOUS
Message Variables
Explanation
cmdproc
The name of the command procedure. The port specified as the PORT USED FOR EXTERNAL
CLOCKmust be defined as having a synchronous
transmission mode. You specified a port that is not so
System action
defined.
The NetView program ends the command procedure.
System action
Operator response
The NetView program ignores the command and
Notify the system programmer. highlights the names of ports that are not defined as
having a synchronous transmission mode.
System programmer response
Operator response
Correct the error in the prior nested command
procedure. Replace each highlighted field with the name of
a synchronous port, or define the port to have a
synchronous transmission mode.

Chapter 7. DSI Prefix Messages 741


DSI681I CHANNEL NUMBER FOR PORT Explanation
CAUSES INVALID CHANNEL
NUMBER COMBINATION You left one or more synchronous fields blank for
ports that you have defined as synchronous.

Explanation
System action
The highlighted channel number is not a valid option
because of the channel numbers already assigned to The NetView program ignores the command and
lower ports. A lower port is listed to the left of a given places a highlighted question mark in each blank field.
port on the DMPX change panel. For example, port A is
a lower port than port C. Operator response
Replace each highlighted question mark with a valid
System action value.
The NetView program ignores the command and DSI684I IF A PORT IS NOT BEING USED,
highlights the channel numbers that are not valid. ITS COLUMN MUST CONTAIN
BLANKS
Operator response
Replace the highlighted channel number with a Explanation
valid number. If more than one channel number is It appears that you did not intend to use one of the
highlighted, resolve them from left to right -- starting ports, because certain key fields in its column are
with port A and continuing to port D. In selecting the blank, but there are some nonblank values in the
channel numbers for the ports, remember that: column. If you do not intend to use a port, its column
• The channel number for port A must be 1. can only contain blanks.
• Each channel number for ports B, C, or D cannot
be more than one more than the largest channel System action
number to its left. The NetView program ignores the command and
• Any channel number might be reused to indicate highlights the nonblank values.
fan-in or fan-out ports.
DSI682I ALL ASYNCHRONOUS FIELDS Operator response
MUST BE FILLED IN FOR If you do not intend to use the port, blank out the
ASYNCHRONOUS PORTS highlighted fields in the corresponding column.
If you do intend to use the port, fill in transmission
Explanation mode, channel, and other appropriate fields in the
You left one or more asynchronous fields blank for column.
ports that you have defined as asynchronous.
DSI686I ALL ASYNCHRONOUS FIELDS
MUST BE BLANK FOR
System action SYNCHRONOUS PORTS
The NetView program ignores the command and
places a highlighted question mark in each blank field. Explanation
You filled in one or more “asynchronous” fields for a
Operator response port that is defined as synchronous. These fields must
be left blank.
Replace each highlighted question mark with a valid
value.
System action
DSI683I ALL SYNCHRONOUS FIELDS MUST
BE FILLED IN FOR SYNCHRONOUS The NetView program ignores the command and
PORTS highlights the fields.

Operator response
Replace each highlighted field with blanks.

742 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI687I ALL SYNCHRONOUS FIELDS MUST >19.2 KBPS), then the aggregate full speed is 19.2
BE BLANK FOR ASYNCHRONOUS KBPS.
PORTS
DSI689I THE SUM OF CHANNEL BACKUP
SPEEDS MUST ADD UP TO MODEM
Explanation BACKUP SPEED
You filled in one or more “synchronous” fields for
a port that is defined as asynchronous. These fields Explanation
must be left blank.
The sum of the individual channel backup speeds you
specified does not equal the backup speed of the
System action modem.
The NetView program ignores the command and For a channel used by an asynchronous port, the
highlights the fields. speed used to calculate the aggregate backup speed
is either 2.4 KBPS or the speed you specified for the
Operator response asynchronous port, whichever is greater.

Replace each highlighted field with blanks. For a channel used by one or more synchronous ports,
the speed used to calculate the aggregate backup
DSI688I THE SUM OF CHANNEL FULL speed is the backup speed you specified for each of
SPEEDS MUST ADD UP TO THE the synchronous channels.
MODEM FULL SPEED
System action
Explanation
The NetView program ignores the command. It
The sum of the individual channel full speeds you highlights the backup speed of all synchronous ports
specified does not equal the full speed of the modem. and the speed of all asynchronous ports.
For a channel used by an asynchronous port, the
speed used to calculate the aggregate full speed is Operator response
either 2.4 KBPS or the speed you specified for the
Ensure the individual backup speeds of the channels
asynchronous port, whichever is greater.
used by the synchronous ports, and the individual
For a channel used by one or more synchronous speeds of the channels used by the asynchronous
ports, the speed used to calculate the aggregate full ports, add up to the aggregate backup speed for the
speed is the full speed you specified for each of the modem.
synchronous channels.
Remember to use 2.4 KBPS for the speed of a channel
used by an asynchronous port, even if you specified
System action a slower speed, because the port actually uses this
amount of bandwidth. The backup speed of a channel
The NetView program ignores the command. It
used by more than one port is the backup speed of any
highlights the full speed of all synchronous ports and
of the ports.
the speed of all asynchronous ports.
Note that, for every channel but one, the backup speed
Operator response must be equal to the full speed. One channel must
have a backup speed that is exactly 2.4 KBPS less
Ensure the individual full speeds of the channels used than its full speed. The aggregate backup speed of the
by the synchronous ports, and the individual speeds of modem appears on the right side of the screen, on the
the channels used by the asynchronous ports, add up same line as the “BACKUP SPEED” fields. For example,
to the aggregate full speed of the modem. if you see (0.0->16.8 KBPS), then the aggregate
backup speed is 16.8 KBPS.
Remember to use 2.4 KBPS for the speed of a channel
used by an asynchronous port, even if you specified DSI690I BACKUP SPEED OF PORT MUST BE
a slower speed, because the port actually uses this LESS THAN OR EQUAL TO ITS FULL
amount of bandwidth. The full speed of a channel used SPEED
by more than one port is the full speed of any of its
ports. The aggregate full speed of the modem appears
on the right side of the screen, on the same line as
the “FULL SPEED” fields. For example, if you see (2.4-

Chapter 7. DSI Prefix Messages 743


Explanation System action
One or more backup speeds are incorrect because a The NetView program ignores the command and
port's backup speed cannot be greater than its full highlights the full-speed fields that do not match.
speed.
Operator response
System action
Select a single full speed for each port sharing a
The NetView program ignores the command and specific channel, and replace the highlighted speeds
highlights the backup speeds that are incorrect. with that value.
DSI693I FAN-OUT PORTS MUST HAVE
Operator response EQUAL FULL SPEEDS
Change the highlighted backup speeds so they are less
than or equal to the corresponding full speeds. Explanation
DSI691I CHANNEL NUMBER IS NOT You have specified different full speeds for one or
ALLOWED FOR THIS PORT more fan-out ports that share the same channel. All
fan-out ports that share a channel must operate at the
Explanation same full speed.

The highlighted channel numbers are not valid.


System action
System action The NetView program ignores the command and
highlights the backup speed fields that do not match.
The NetView program ignores the command and
highlights the channel numbers that are not valid.
Operator response
Operator response Select a single backup speed for each port sharing a
specific channel, and replace the highlighted speeds
Replace the highlighted fields with valid channel with that value.
numbers.
DSI694I FAN-IN PORTS MUST HAVE EQUAL
In selecting the channel numbers for the ports, BACKUP SPEEDS
remember that:
• The channel number for Port A must be 1. Explanation
• Each channel number for ports B, C or D cannot You have specified different backup speeds for one
be more than one greater than the largest channel or more fan-in ports that share the same channel. All
number to its left. fan-in ports that share a channel must operate at the
• Any channel number might be reused to indicate same backup speed.
fan-in or fan-out ports.
Thus, for example, the valid values for port C are 1, 2, System action
3, and blank; the valid values for port D are 1, 2, 3, 4, The NetView program ignores the command and
and blank. highlights the backup speed fields that do not match.
DSI692I FAN-IN PORTS MUST HAVE EQUAL
FULL SPEEDS Operator response
Select a single backup speed for each port sharing a
Explanation specific channel, and replace the highlighted speeds
You have specified different full speeds for one or with that value.
more fan-in ports that share the same channel. All DSI695I FAN-OUT PORTS MUST HAVE
fan-in ports that share a channel must operate at the EQUAL BACKUP SPEEDS
same full speed.

744 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation DSI698I A SYNCHRONOUS PORT CANNOT
SHARE A CHANNEL WITH AN
You have specified different backup speeds for one or ASYNCHRONOUS PORT
more fan-out ports that share the same channel. All
fan-out ports that share a channel must operate at the
same backup speed. Explanation
You attempted to define a synchronous port with the
System action same channel as an asynchronous port. A synchronous
port cannot share a channel with an asynchronous
The NetView program ignores the command and port.
highlights the backup speed fields that do not match.

System action
Operator response
The NetView program ignores the command and
Select a single backup speed for each port sharing a highlights the channel numbers that are not valid.
specific channel, and replace the highlighted speeds
with that value.
Operator response
DSI696I PORT CANNOT BE CONFIGURED
AS ASYNCHRONOUS Verify that the channel specified for this synchronous
port is correct. If it is correct, specify a different
channel number for the corresponding asynchronous
Explanation port.
You attempted to configure port A or C as DSI700I task: ALIAS INITIALIZATION
asynchronous; however, only ports B and D can be COMPLETE. RECORD COUNTS
configured as asynchronous. ARE: ORIGNET = recordcount, LU
= recordcount, COS = recordcount,
System action MODE = recordcount
The NetView program ignores the command and
highlights the transmission mode settings that are not Explanation
valid. DST initialization is complete. The translation tables
are now built. You can enter AINQ and AUPD
Operator response commands.
Change the highlighted values to either synchronous or Message Variables
blank (for an unused port).
task
DSI697I AN ASYNCHRONOUS PORT The name of the task
CANNOT SHARE A CHANNEL WITH recordcount
ANY OTHER PORT The number of records of each type (ORIGNET,
LU, COS, MODE) read and processed successfully
Explanation during initialization

You attempted to define an asynchronous port with the DSI701I task: DST INITIALIZATION FAILED
same channel as another port. An asynchronous port FOR THE ALIAS APPLICATION -
cannot share a channel with any other port. INSUFFICIENT STORAGE

System action Explanation


The NetView program ignores the command and When the NetView program built the base control
highlights the channel numbers that are not valid. blocks, insufficient storage was available to process
the records from the DSIPARM alias files.
Operator response Message Variables
Verify that the channel specified for this asynchronous task
port is correct. If it is correct, ensure that no other port The name of the task
is using the same channel.

Chapter 7. DSI Prefix Messages 745


Operator response Operator response
Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Determine the amount of additional storage you need You have an internal alias application logic error
for the alias application DST and the associated tables. caused by a mismatch in the translation tables. Collect
Add this amount to the NetView region or partition the problem determination data and contact IBM
size. Then restart the NetView program. Software Support.
DSI702I task: DST ABENDING FOR THE DSI704I task: DST ABENDING FOR THE
ALIAS APPLICATION - CNMI ALIAS APPLICATION - UNABLE TO
FAILURE MAJOR CODE=nn MINOR LOAD module
CODE =retcode
Explanation
Explanation
The NetView program cannot find one of the
You have a logic error when the alias application tries alias application load modules, or the load itself
to send a reply to the access method. encountered an I/O error.
Message Variables Message Variables
task task
The name of the task. The name of the task.
nn module
The return code for the failing CNM interface The name of the module that cannot be loaded.
request.
retcode Operator response
The return codes for the failing CNM interface
request. Notify the system programmer.

Operator response System programmer response


Notify the system programmer. Ensure the load module is on the appropriate library,
then restart the alias application.

System programmer response DSI705I task: DST ABENDING FOR THE


ALIAS APPLICATION - COMMAND
See the DSIZCSMS return codes listed in IBM Z PROCESSOR UNDEFINED - NAME
NetView Programming: Assembler to determine the = cmdproc
problem. If you have a system type error, collect
your error documentation and contact IBM Software
Support. If you have a network type failure or system Explanation
definition type error, correct it and restart the alias The NetView program does not recognize a command
application. processor needed to run the DST.
DSI703I task: DST ABENDING FOR THE Message Variables
ALIAS APPLICATION - LOGIC
ERROR task
The name of the task.
cmdproc
Explanation
The name of the command processor.
A logic error occurred in the alias application
processing. The alias tables are no longer usable. Operator response
Message Variables
Notify the system programmer.
task
The name of the task.

746 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
Define the command processor name on a CMDDEF An error occurred when an alias application tried to
statement, then restart the NetView program. connect to the DSIPARM data set. The DSIDKS return
code, nn, is displayed.
DSI706I hclname SESSIONS HAVE BEEN
STOPPED FOR ALL OPERATORS Message Variables
task
Explanation The name of the task.
This is a normal response to a STOP retcode
HCL=hclname,OP=ALL command entered for the The DSIDKS return code.
indicated hclname.
Message Variables System action
hclname Alias application continues, but no records from
The name of the hard-copy log device. DSIPARM are read into the tables.

System action Operator response


Sessions end between the specified hard-copy log Notify the system programmer.
device and all operators.
DSI707I INVALID ALIASMEM STATEMENT
System programmer response
NOT PROCESSED. EXTRA Ensure the DSIPARM data set is available. If a fix was
CHARACTERS AFTER ALIASMEM - made, have the operator enter the AUPD command to
'word', LABEL = 'label' process the data set.
DSI709I task: ALIAS TABLE BUILD FAILED
Explanation FOR object=name - LOAD FAILED
At least one extra character followed the ALIASMEM FOR MODULE=module.
keyword without an intervening blank.
Message Variables Explanation
word An error occurred when the NetView program tried to
ALIASMEMx. The x stands for an extra character, load one of the alias application modules required for
possibly followed by additional characters in the the table build process.
actual statement. Message Variables
label task
The statement label. This is blank if no label is The name of the task
present.
object
MEMBER
System action
name
Processing continues. However, the NetView program The name of an MVS member
ignores the incorrect statement.
module
The name of the module
Operator response
Notify the system programmer. System action
No updates are made to the alias tables for
System programmer response the specified member. Alias application processing
continues.
Correct the statement that is in error.
DSI708I task: ALIAS TABLE BUILD FAILED Operator response
FOR CONNECT TO DSIPARM.
DSIDKS RETURN CODE = retcode Notify the system programmer.

Chapter 7. DSI Prefix Messages 747


System programmer response System action
Ensure the load module is on the appropriate library. The alias tables might be partially updated with any
If the error is fixed, have the operator enter an AUPD records read before the error occurred. A message
command. follows that provides the number of records processed
successfully. Alias application processing continues.
DSI710I task: ALIAS TABLE BUILD FAILED
FOR object=name, I/O ERROR ON
ALIAS FILE Operator response
To provide more virtual storage, stop any unnecessary
Explanation NetView tasks or operators. If you are successful,
enter an AUPD command ADD for the member name.
An I/O error occurred while the NetView program was If not, inform the system programmer.
trying to read records from the specified member. The
remaining records were not affected.
System programmer response
Message Variables
Determine new virtual storage requirements and
task update NetView region or partition size. Restart the
The name of the task NetView program when the additional virtual storage is
object available.
MEMBER
DSI712I task: ALIAS TABLE BUILD FAILED
name FOR RECORD TYPE = type, LABEL =
The name of a member recordlabel, FROM object = name -
INVALID SEQUENCE
System action
The alias tables might be partially updated with any Explanation
records read before the error occurred. A message An ORIGNET record did not precede the LU, COS, or
follows that provides the number of records processed MODE record definitions on the specified member. The
successfully. Alias application processing continues. record is not added to the alias tables.
Message Variables
Operator response
task
Notify the system programmer. The name of the task
type
System programmer response Any of the following:
Check the I/O device to correct the I/O problem. When • A logical unit
you have corrected the error, have the operator enter
• The class of service
an AUPD command ADD for the member name.
• The type of operation
DSI711I task: ALIAS TABLE BUILD FAILED
FOR object=name, INSUFFICIENT recordlabel
STORAGE The definition statement label
object
Explanation MEMBER
name
The NetView program did not have enough storage
The name of a data set member
to build the base control blocks for the specified
member. The remaining records are not affected.
System action
Message Variables
Alias application processing continues. The NetView
task
program ignores any further LU, CO, and MODE
The name of the task.
records not preceded by an ORIGNET record. Message
object DSI700I follows indicating the number of records
MEMBER processed successfully.
name
The name of a member

748 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response the NetView program if additional virtual storage is
available to be allocated.
Notify the system programmer.
DSI714I task: ALIAS TABLE BUILD FAILED
FOR RECORD TYPE = type, LABEL =
System programmer response recordlabel, FROM object = name -
Fix the sequence error on the specified alias member. DUPLICATE ENTRY
Have the operator enter an AUPD command to process
the record. Explanation
DSI713I task: ALIAS TABLE BUILD FAILED The NetView program found a duplicate alias name
FOR RECORD TYPE = type, LABEL = for an origin network, or a duplicate real name for an
recordlabel, FROM object = name - origin or destination network pair. The record is not
INSUFFICIENT STORAGE added to the alias tables.
Message Variables
Explanation
task
The NetView program does not have enough storage The name of the task
to build additional translation tables for the specified
record. The record cannot be added to the existing type
tables. Any of the following:

Message Variables • A logical unit


• The class of service
task
The name of the task • The type of operation
type recordlabel
Any of the following: The definition statement label
• A logical unit object
MEMBER
• The class of service
name
• The type of operation
The name of a data set member
recordlabel
The definition statement label System action
object
MEMBER The NetView program ignores the duplicate record.
Alias application processing continues.
name
The name of a data set member
Operator response
System action Notify the system programmer.

The alias tables might be partially updated with any


records read before the error occurred. A message System programmer response
follows that provides the number of records processed Resolve the alias definition files. Have the operator
successfully. Alias application processing continues. enter an AUPD command for new or changed
members.
Operator response DSI715I object NOT PROCESSED. task:
Stop any unnecessary NetView tasks or operators to ALIAS object NAME INVALID,
provide more virtual storage. If you are successful, LABEL = 'recordlabel'
enter an AUPD command ADD for the member name
and record type. If you do not have enough storage, Explanation
notify the system programmer.
A member name specified on the ALIASMEM
statement is not valid because it does not contain 1– 8
System programmer response characters.
Determine new virtual storage requirements and Message Variables
update NetView region or partition size. Restart

Chapter 7. DSI Prefix Messages 749


object DSI717I task: INVALID ALIAS RECORD -
MEMBER UNBALANCED QUOTES. LABEL =
task 'recordlabel'
The name of the task
recordlabel Explanation
The definition statement label There are unmatched quotation marks in the alias
record.
System action Message Variables
The alias tables are updated with the valid member
task
names. The NetView program ignores the names that
The name of the task
are not valid and processing continues.
recordlabel
The definition statement label
Operator response
Notify the system programmer. System action
The NetView program ignores the alias record.
System programmer response Processing continues with the next record.
Fix the ALIASMEM statement. Have the operator enter
an AUPD command for new members if necessary. Operator response
DSI716I task: INVALID DELIMITER ON Notify the system programmer.
ALIAS DEFINITION STATEMENT.
LABEL = recordlabel, TYPE = type
System programmer response
Explanation Correct the record definition statement. Have the
operator enter the AUPD command if necessary.
You used a character other than a comma or a blank
between parameters on the alias definition statement. DSI718I task: EXTRA PARAMETERS ON
ALIAS RECORD IGNORED - LABEL
Message Variables = recordlabel
task
The name of the task Explanation
recordlabel The NetView program found extra parameters on the
The definition statement label alias record.
type
Message Variables
ORIGNET, LU, COS, or MODE
task
System action The name of the task
recordlabel
The parameter that appears before the incorrect
The definition statement label
delimiter, and any parameters that follow, are
ignored. The NetView program continues reading and
processing with the next sequential record. System action
The NetView program ignores the extra parameters.
Operator response
Notify the system programmer. Operator response
Notify the system programmer.
System programmer response
Correct the record definition statement. Have the System programmer response
operator enter an AUPD command for corrected To correct the record definition, eliminate the extra
members if necessary. parameters.

750 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI719I task: REQUIRED PARAMETER System action
MISSING. RECORD TYPE = type,
LABEL = recordlabel, object = name The NetView program continues reading and
processing with the next sequential record.

Explanation
Operator response
A required parameter on the ALIAS definition
statement is missing. Notify the system programmer.

Message Variables
System programmer response
task
Correct the record definition statement. Have the
The name of the task
operator enter an AUPD command for new members
type if necessary.
ORIGNET, LU, COS, or MODE
DSI721I task: ALIAS RECORD CONTAINS
recordlabel
INVALID DATA. LABEL =
The definition statement label
recordlabel, PARAMETER = parm,
object object = name
MEMBER
name Explanation
The name of a data set member
One of the parameters on your input statement had
data that is not valid.
System action
Message Variables
The NetView program ignores the record that is not
valid and continues reading and processing alias task
records. The name of the task
recordlabel
Operator response The definition statement label
parm
Notify the system programmer.
The parameter in error
object
System programmer response MEMBER
Correct the record definition statement. Have the name
operator enter the AUPD command if necessary. The name of a data set member
DSI720I task: ALIAS RECORD TYPE NOT
RECOGNIZED IN object = name, System action
LABEL = recordlabel
The NetView program continues reading and
processing with the next sequential record.
Explanation
The record type read from the specified DSIPARM Operator response
member was not equal to ORIGNET, LU, COS, or
MODE. Notify the system programmer.

Message Variables
System programmer response
task
Correct the record definition statement. Have the
The name of the task
operator enter an AUPD command for new members
object if necessary.
MEMBER
DSI722I task: ALIAS TABLE BUILD FAILED
name
FOR object = 'name', NOT FOUND
The name of a data set member
recordlabel
The definition statement label

Chapter 7. DSI Prefix Messages 751


Explanation Operator response
The specified member name on the ALIASMEM Stop any unnecessary NetView tasks or operators to
statement cannot be found in the DSIPARM data set. free up virtual storage. If you are successful, enter
an AUPD ADD command for the member name and
Message Variables
network identifier. If there is still not enough storage,
task notify the system programmer.
The name of the task.
object System programmer response
MEMBER
Determine new virtual storage requirements and
name update the NetView region or partition. Restart the
The name of a data set member NetView program if more virtual storage can be
allocated.
System action DSI724I NCCF MEMBER member NOT
The alias tables are updated with the valid members. FOUND ON ddname
The NetView program ignores the members that are
not valid. Explanation
The NetView program cannot locate the specified
Operator response member or the member was empty.
Notify the system programmer.
Message Variables
member
System programmer response
The name of a data set member
Ensure that the member name is valid. Have the ddname
operator enter an AUPD command for new members The data set name
if necessary.
DSI723I task: ALIAS TABLE BUILD FAILED System action
(INSUFFICIENT STORAGE) WHILE
PROCESSING object = name OF The NetView program ends the command.
NETWORK=networkid
Operator response
Explanation Notify the system programmer.
You do not have enough storage to build tables for the
specified network identifier. System programmer response
Message Variables Ensure the specified member is loaded or named
task correctly.
The name of the task. DSI725I THIS MODEM IS CURRENTLY
object OPERATING IN FAN IN/FAN OUT
MEMBER MODE
name
The name of a data set member Explanation
networkid This modem is currently operating in fan-in or fan-out
The identification of the network. mode. This means that all ports are sharing a single
channel; only one channel is defined and all ports are
System action defined to share this channel. This message is for your
information.
No tables are built for the specified network. The
NetView program ignores the command. DSI726I THIS MODEM IS CURRENTLY
OPERATING IN PURE DMPX MODE

752 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
The modem is currently operating in pure DMPX mode. The NetView program ignores the command and
This means that all ports are using unique channels; highlights the field that is not valid.
no channel is being used by more than one port. If
you want some of the ports to be inactive, the modem Operator response
defines them with their own channels and a speed of
0.0 KBPS. Replace the highlighted field with a valid port name.
DSI727I THIS MODEM IS CURRENTLY DSI730I CMDDEF STATEMENT MISSING
OPERATING IN MIXED MODE FOR ALIAS DATA SERVICES name
COMMAND PROCESSOR
Explanation
Explanation
The modem is currently operating in mixed mode. This
means that more than one channel is being used, and A CMDDEF statement required for alias command
that at least one of these channels is being shared processing was missing from the CNMCMD member of
by more than one port. Note that, if only one active DSIPARM.
channel is defined, but you want some of the ports to
Message Variables
be inactive, the modem defines the ports with their
own channels and a speed of 0.0 KBPS. Thus the name
modem appears to be in fan-in or fan-out mode to The identifying name of the command processor.
the host program, but more than one channel has been
defined. This message is for your information. System action
DSI728I BACKUP SPEED FOR PORT The NetView program does not run the requested
CANNOT BE 0 KBPS command (AINQ or AUPD).

Explanation Operator response


You specified a backup speed of 0 KBPS for either port Notify the system programmer.
A or the port specified for the external clock. This is
not a valid value.
System programmer response
System action Correct the CMDDEF definition statements in
CNMCMD. Have the operator restart the NetView
The NetView program ignores the command and program.
highlights the field that is not valid.
DSI731I action REQUEST UNSUCCESSFUL.
ALIAS DATA SERVICES TASK task
Operator response
NOT ACTIVE
If the backup speed field for port A is highlighted,
select a valid backup speed. Explanation
If the “PORT USED FOR EXTERNAL CLOCK” field The alias command (AINQ or AUPD) request failed.
is highlighted, select a valid backup speed for the The alias task is not active.
highlighted port or specify a different port.
Message Variables
For synchronous ports, valid backup speed values are
2.4, 4.8, 7.2, 9.6, 12.0, 14.4, and 16.8 KBPS. action
INQUIRY or UPDATE.
DSI729I PORT MUST BE SPECIFIED
task
The name of the task.
Explanation
You specified N as the port used for external clock. System action
When the transmit clock is external, specify a valid
port name. N is not a valid value. The NetView program does not run the requested
command (AINQ or AUPD).

Chapter 7. DSI Prefix Messages 753


Operator response action
INQUIRY or UPDATE.
Start the alias application if necessary, then enter the
command again. code
The code used for problem analysis.
DSI732I action REQUEST UNSUCCESSFUL. object
INSUFFICIENT STORAGE - NAME / MEMBERNAME
object. = name
name
One of the following:
Explanation
• The member name specified on an AUPD
The alias command (AINQ or AUPD) request failed. command, or the network name specified on an
The return code from the alias data services task AINQ request.
indicated the NetView program did not have enough
storage to complete the request. • The name of a data set member.

Message Variables
System action
action
The command ends.
INQUIRY or UPDATE
object
MEMBERNAME Operator response
name Notify the system programmer.
One of the following:
• The member name specified on an AUPD System programmer response
command, or the network name specified on an Collect the necessary problem data and contact IBM
AINQ request Software Support.
• The name of a data set member
DSI734I INQUIRY REQUEST
UNSUCCESSFUL. ORIGNET =
System action networkid NOT DEFINED - NAME =
name
The command ends. No updates are made to the alias
tables.
Explanation
Operator response The command was not processed. The ORIGNET value
specified on request was not found in your alias file.
Determine whether you received message BNH16I,
which means the task has reached its storage limit. Message Variables
If so, notify your system programmer.
networkid
The network ID specified for the ORIGNET
System programmer response parameter on the AINQ command, or UNKNOWN.
See the IBM Z NetView Troubleshooting Guide for name
possible causes of the storage shortage. If necessary, One of the following:
see the IBM Z NetView Tuning Guide for more storage
• The network resource name specified on the
calculation information.
AINQ command.
DSI733I action REQUEST UNSUCCESSFUL • The name of the data set member.
- INTERNAL ERROR. SENSE =
X'code', NAME/object=name
System action
Explanation The command ends.

The alias command (AINQ or AUPD) request failed.


The command was not processed because of an Operator response
internal logic error in the alias application. The sense Correct the ORIGNET value on the command and enter
code values define the specific reason for the failure. it again.
Message Variables

754 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI735I INQUIRY REQUEST 'networkid' NOT FOUND FOR object
UNSUCCESSFUL. NAME = resource = name
NOT FOUND FOR ORIGNET =
networkid TARGNET = networkid Explanation
The NetView program did not find the network
Explanation identifier on the AUPD command for the member
The ORIGNET and TARGNET parameters are not you specified on the AUPD command. You specified
processed. The NAME value you specified on the an incorrect member for the given network, or an
request was not found in the alias tables. incorrect network identifier for the given member was
specified, or both.
Message Variables
Message Variables
resource
The name value specified on the AINQ command. networkid
networkid The network identifier on the AUPD command.
The networks specified on the AINQ command. object
MEMBER
System action name
The name of a data set member
The NetView program rejects the command.

System action
Operator response
The NetView program rejects the command.
Correct the NAME value on the command and enter it
again.
Operator response
DSI736I command COMMAND FAILED.
SENSE CODE = X'code'. Correct the AUPD command so that the network
identifier specified does exist for the member
specified.
Explanation
DSI738I COUNT OF RECORDS DELETED
Your command failed and the indicated sense code FOR UPDATE OF object = name - LU
was returned to the NetView program. = nn, COS = nn, MODE = nn
Message Variables
command Explanation
The name of the command that failed. You have output from an AUPD command. The number
code of records deleted for the AUPD command is displayed
The sense code number. by record type. If you specified the ADD option,
message DSI751I follows this message which gives
the number of records added. The count of ORIGNET
System action
records is not shown in the message because the
The command is not processed. network identifier is not deleted. Only the translation
records defined by the specified member are deleted.
Operator response Message Variables
Notify the system programmer. object
MEMBER
System programmer response name
The name of a data set member
To obtain an explanation of the sense code, enter
the HELP SENSE command, or see Systems Network nn
Architecture Formats and take action based on the The number of records
explanation. DSI739I UPDATE REQUEST
DSI737I UPDATE REQUEST UNSUCCESSFUL FOR object =
UNSUCCESSFUL. NETWORK ID = name, I/O ERROR

Chapter 7. DSI Prefix Messages 755


Explanation Explanation
This message is output from an AUPD command. An You have output from the AUPD command. It is not
I/O error occurred on the file and the update cannot be possible to process your request because of a storage
completed. The tables can be updated while messages shortage.
DSI738I and DSI1751I display the record counts.
Message Variables
Message Variables
object
object MEMBER
MEMBER name
name The name of a data set member
The name of a data set member
System action
System action
The tables are partially updated and the messages
The alias tables are partially updated. DSI738I and DSI751I display the updated record
counts.
Operator response
Operator response
Notify the system programmer.
Determine whether you received message BNH16I,
System programmer response which means the task has reached its storage limit.
If so, notify your system programmer.
Check the I/O device to correct the I/O problem. When
you have corrected the error, have the operator enter
System programmer response
an AUPD ADD command for the specified member.
See the IBM Z NetView Troubleshooting Guide for
DSI740I UPDATE REQUEST
possible causes of the storage shortage. If necessary,
UNSUCCESSFUL FOR object =
see the IBM Z NetView Tuning Guide for more storage
name, NOT FOUND
calculation information.

Explanation DSI742I UPDATE REQUEST


UNSUCCESSFUL FOR object =
The specified member was not found in DSIPARM. name, LOAD FAILURE FOR
Your request cannot process. DSIATBLD
Message Variables
Explanation
object
MEMBER The AUPD command cannot load DSIATBLD, the
name required module.
The name of a data set member Message Variables
object
System action MEMBER
No updates have occurred. name
The name of a data set member
Operator response
System action
Enter the command again with the correct member
name. The command ends.
DSI741I UPDATE REQUEST
UNSUCCESSFUL FOR object = Operator response
name Notify the system programmer.

756 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System programmer response Explanation
Ensure the library that contains DSIATBLD is available. The alias command (AINQ or AUPD) request failed.
Have the operator enter the AUPD command again The NetView program found a duplicate keyword on an
when the load failure situation is corrected. AINQ or AUPD command.
DSI743I INQUIRY DATA - name = resource, Message Variables
ORIGNET = networkid, TYPE = type action
TARGNET = networkid INQUIRY or UPDATE.
keyword
Explanation The keyword specified.
This message is sent by the alias inquiry reply
processor to return inquiry data back to you. It System action
includes the input name to be translated, the type and
the class of the name, and the source and the target The request ends.
network identifiers specified on the AINQ command.
Message Variables Operator response
name Correct the command and enter it again.
ORIGNAME or TARGNAME. DSI746I action REQUEST UNSUCCESSFUL.
resource INVALID KEYWORD
The name of the resource. ENCOUNTERED - 'keyword'
networkid
The name of the network. Explanation
type The alias command (AINQ or AUPD) request failed.
LU, COS, or MODE. The NetView program found an incorrect keyword on
DSI744I INQUIRY RESULT - name = an AINQ or AUPD command.
translatedname, TARGNET = Message Variables
networkid CDRM = cdrmname
action
INQUIRY or UPDATE.
Explanation
keyword
The translated name is the name of the resource as it The keyword specified.
is known in the target network. This message is sent
by the alias inquiry reply processor to return inquiry
System action
results back to you.
The request ends.
Message Variables
name Operator response
ORIGNAME or TARGNAME.
translatedname Correct the command and enter it again.
The name resulting from the inquiry request DSI747I action REQUEST UNSUCCESSFUL.
networkid EXPECTED OPERAND OR VALUE
The name of the network MISSING - 'operand'
cdrmname
The ID of the SSCP that owns the network resource Explanation
(optional)
The alias command (AINQ or AUPD) request failed.
DSI745I action REQUEST UNSUCCESSFUL. The NetView program did not find a required operand
DUPLICATE KEYWORD on an AINQ or AUPD command, or the value for the
ENCOUNTERED - keyword given operand is missing.
Message Variables
action
INQUIRY or UPDATE.

Chapter 7. DSI Prefix Messages 757


operand System programmer response
The name of the missing operand or the operand
whose value is missing. This is an internal logic error. Collect the necessary
problem determination data and contact IBM Software
Support.
System action
DSI750I action REQUEST UNSUCCESSFUL.
The request ends. INVALID KEYWORD VALUE
ENCOUNTERED - 'value'
Operator response
Correct the command and enter it again. Explanation
DSI748I action REQUEST UNSUCCESSFUL. The alias command (AINQ or AUPD) request failed.
SYNTAX ERROR - operand You specified an incorrect value on a keyword
parameter.
Explanation Message Variables

The alias command (AINQ or AUPD) request failed. action


The syntax of your command is incorrect. The reason INQUIRY or UPDATE.
for the syntax error, or the incorrect operand or value
operand value, if specified, is displayed. If you did not The value specified.
specify an operand or operand value, the operand field
is blank.
System action
Message Variables
The request ends.
action
INQUIRY or UPDATE.
Operator response
operand
The name of the operand. Other possible Correct the keyword and enter the command again.
responses are DUPLICATE DELIMITER or DSI751I COUNT OF RECORDS ADDED FOR
UNBALANCED QUOTES. UPDATE OF object = name, -
ORIGNET = nn, LU = nn, COS = nn,
System action MODE = nn
The request ends.
Explanation
Operator response This message is the output from AUPD command.
The number of records you added for the UPDATE
Correct the command and enter it again. command is displayed by record type. If the records
DSI749I ILLOGICAL SOURCE OF REQUEST have also been deleted by the UPDATE command, this
message follows message DSI738I, which gives the
number of records deleted.
Explanation
Message Variables
The alias command processors (DSIAOIRP or
DSIAOURP) received a reply that did not originate from object
the alias application DST. MEMBER
name
System action The name of a data set member
nn
The NetView program ignores the reply.
The number of records.

Operator response DSI752I action REQUEST UNSUCCESSFUL.


CONFLICTING KEYWORDS
Notify the system programmer. ENCOUNTERED - keyword1,
keyword2

758 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation Explanation
The alias command (AINQ or AUPD) request failed. The new password or password phrase that you
You specified a conflicting pair of keywords on the entered was rejected by security software.
command.
Message Variables System action
action Both NEW PASSWORD fields are erased and the logon
INQUIRY or UPDATE. screen is refreshed with the other logon data intact. If
keyword1 the DSI809A prompt was issued for logon, it is issued
The first character string portion of the command. again with no logon data saved.

keyword2
The second character string portion of the Operator response
command. If you do not want to change your password or
password phrase from the logon screen, press ENTER
System action to continue logon. If you want to change your
password or password phrase, enter another password
The request ends. or password phrase in both NEW PASSWORD fields.
Notify the system programmer if failures continue.
Operator response If a password or password phrase change is not
Correct the command and enter it again. required from the DSI809A prompt, retype the
command leaving the NEW PASSWORD fields blank.
DSI753I NEW PASSWORDS DO NOT MATCH If you want to change your password or password
phrase, retype the command using another password
Explanation or password phrase in the NEW PASSWORD fields.
Notify the system programmer if failures continue.
You did not enter identical passwords or password
phrases in the NEW PASSWORD fields. If you do not want to change your password or
password phrase from the cross-domain logon screen,
retype the logon data leaving the NEW PASSWORD
System action fields blank. If you want to change the password or
The PASSWORD field and both NEW PASSWORD fields password phrase, enter another password in both NEW
are erased and the logon screen is refreshed with the PASSWORD fields. Notify the system programmer if
other logon data intact. If the DSI809A prompt or the failures continue.
cross-domain logon screen was issued for logon, it is Note: The SAF product might not allow a mix of
issued again with no logon data saved. passwords and password phrases in the existing
password and new password fields.
Operator response
If you do not want to change your password System programmer response
or password phrase from the logon screen, type Ensure that new passwords or password phrases are
your current password or password phrase in the being entered in accordance with your installation's
PASSWORD field and press ENTER. If you want to security software password or password phrase
change your password or password phrase, type requirements.
your current password or password phrase in the
PASSWORD field, and enter identical new passwords DSI755I OPERATOR userid IS NOT
or password phrases in each NEW PASSWORD field. AUTHORIZED TO USE TERMINAL
(terminal)
If a password or password phrase change is not
required from the DSI809A prompt, enter the
command again, leaving the NEW PASSWORD fields Explanation
blank. If you want to change your password or The user is not authorized by security software to log
password phrase, enter the command again using on to this terminal.
identical passwords or password phrases in the NEW
PASSWORD fields. Message Variables

DSI754I NEW PASSWORD NOT ACCEPTED userid


BY THE SECURITY SOFTWARE The name of the operator attempting to log on.

Chapter 7. DSI Prefix Messages 759


terminal Explanation
The name of the terminal from which an operator
attempted to log on. The terminal name can be one This message is issued after a successful logon and
of the following: password or password phrase change. The message is
issued with the successful logon message DSI020I.
• An LU identifier (for example, YOURLU)
Message Variables
• An IP address (for example, 146.84.144.121)
userid
The name of the operator that logged on.
System action
Logoff is forced. System action
The message is sent to the appropriate operator.
Operator response
DSI758I THE number NEW PASSWORD IS
Notify the system programmer.
MORE THAN 8 CHARACTERS LONG

System programmer response


Explanation
Ensure that:
The operator or a command list attempted to enter
• The operator is not authorized access to the system a new password that is more than eight characters
on this day. long. Eight characters is the maximum length of a new
• The operator is not authorized access to the system password entered from the DSI809A prompt or from a
at this time of day. command list.
• The terminal is not authorized access to the system Message Variables
on this day. number
• The terminal is not authorized access to the system FIRST or SECOND.
at this time of day.
DSI756I PASSWORDS CANNOT BE System action
CHANGED AT LOGON IN THIS The NetView program rejects the new password. If
INSTALLATION the new password was entered from the DSI809A
prompt, the NetView program issues the DSI809A
Explanation prompt again.
This message is issued when you enter data in the
NEW PASSWORD fields but no security product is Operator response
being used for logon verification. If the new password was entered from the DSI809A
prompt, enter again all data requested by the prompt.
System action Enter a value of eight characters or less in the NEW
PASSWORD fields.
Both NEW PASSWORD fields are erased and the logon
screen is refreshed with the other logon data intact. If If the new password was entered from a command list,
the DSI809A prompt or the cross domain logon screen notify the system programmer.
was issued for logon, it is issued again with no logon
data saved. System programmer response
Change the command list to issue a new password of
Operator response eight characters or less.
From the logon panel, press Enter to continue logon.
DSI759I DATA TYPE = type
From the DSI809A prompt, retype the command
leaving the NEW PASSWORD fields blank. From the Explanation
cross domain logon screen, retype the logon data
leaving the NEW PASSWORD fields blank. This message shows the configuration data type
that contains the error described in the associated
DSI757I PASSWORD HAS BEEN CHANGED message DSI422.
FOR userid
Message Variables

760 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


type function, see z/OS IBM License Manager Programming,
The configuration data type. publication SH19-4529.

System action System action


Processing continues and the NetView program NetView initalization stops and NetView ends.
ignores the command.
Operator response
Operator response
Notify the system programmer.
A corresponding recovery message, DSI423, follows.
DSI760E No valid license certificate was System programmer response
found for this NetView program. Ensure that a valid license certificate for NetView
NetView is terminating. exists in the IBM License Management database or
otherwise correct the problem that is specified. If a
Explanation valid license certificate exists and the error continues,
contact IBM Software Support.
During NetView initialization, a check was made to
determine if a license existed for this NetView, but no DSI768I domainid subcomponent APPCCMD
valid license was found. CONTROL = event FAILED - REG15
= X'r15', REG0 = X'r0', RTNCD =
System action X'vtamrcd', FDBK2 = X'vtamfb'

NetView initalization stops and NetView ends.


Explanation
Operator response An APPCCMD request failed. The APPCCMD might
have been issued by the NMC, the MS transport,
Notify the system programmer. or the high performance transport. The return codes
associated with the attempt are shown. Use the RCFB
System programmer response command list for a description of the return codes and
feedback codes.
Ensure that a valid license certificate for NetView
exists in the IBM License Management database. If a Message Variables
valid license certificate exists and the error continues, domainid
contact IBM Software Support. The name of the NetView domain from which the
message is issued
DSI761I NetView is terminating - IBM
License Management call returned subcomponent
the following values: Return code: The name of the command facility LU 6.2
retcode Status code: status. subcomponent that issued the message (ATTN Exit
or RPL Exit)
Explanation event
The CONTROL keyword value on the APPCCMD
During NetView initialization, a check was made that initiated the request
to determine if a license existed for this NetView
r15
using the z/OS ILMBREQ function. An error occurred
The value in register 15 (used for problem
and a correct license certificate was not found. A
analysis)
combination of return code and status code can be
used to determine the cause. r0
The value in register 0 (used for problem analysis)
Message Variables
vtamrcd
retcode The VTAM internal return code
The return code from the license request service
vtamfb
status The VTAM internal feedback code
The status code from the license request service
Note: For more information about the value of
return code and status code of the z/OS ILMBREQ

Chapter 7. DSI Prefix Messages 761


System action System action
Processing continues. Processing continues.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Use the RCFB command list to interpret the return For more information about the return codes, refer to
code and feedback codes and make the appropriate the z/OS Communications Server library. If you are
changes. unable to resolve the problem, contact IBM Software
Support.
DSI769I domainid subcomponent APPCCMD
event FAILED, LUNAME=luname, DSI770I domainid subcomponent APPCCMD
QUALIFY=X'qualify', CONTROL = event FAILED - REG15
FEEDBACK=(X'code1', X'code2', = X'r15', REG0 = X'r0'
X'code3')
Explanation
Explanation
An APPCCMD request issued by the NMC failed. The
An APPCCMD request failed. The APPCCMD might return codes associated with the attempt are shown.
have been issued by the NMC, the management
Message Variables
services (MS) transport, or the high performance
transport. The return codes associated with the domainid
attempt are shown. The name of the NetView domain from which the
message is issued.
Message Variables
subcomponent
domainid The name of the command facility LU 6.2
The name of the NetView domain from which the subcomponent that issued the message (ATTN Exit
message is issued. or RPL Exit).
subcomponent event
The name of the command facility APPC The CONTROL keyword value on the APPCCMD
subcomponent that issued the message (ATTN Exit that initiated the request
or RPL Exit).
r15
event The value in register 15 (used for problem
The CONTROL keyword value on the APPCCMD analysis).
that initiated the request.
r0
luname The value in register 0 (used for problem analysis).
The partner LU name.
qualify System action
The VTAM qualify option. See the description of
the constant values for the RPL6QUAL field in Processing continues.
the ISTRPL6X DSECT in the z/OS Communications
Server library. Operator response
code1
Notify the system programmer.
The primary return code used for problem analysis.
code2
The secondary return code used for problem System programmer response
analysis. Contact IBM Software Support.
code3
DSI771I domainid subcomponent DSIMQS
The RPL sense code used for problem analysis.
TO event COMMAND PROCESSOR
cmdproc IN SUBTASK subname
FAILED, TRANSACTION PROGRAM
= tpname, RC = X'retcode'

762 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation REQUESTED BY TRANSACTION
PROGRAM tpname
The application program supplied a command
processor to process the completion of the event
request. The attempt to drive the command processor Explanation
failed. The application program made an LU 6.2 request to
Message Variables VTAM. There is no command processor defined to
process the requested event.
domainid
The name of the NetView domain from which the Message Variables
message is issued. domainid
subcomponent The name of the NetView domain from which the
The name of the command facility LU 6.2 message is issued.
subcomponent that issued the message (ATTN Exit subcomponent
or RPL Exit). The name of the command facility LU 6.2
event subcomponent that issued the message (ATTN Exit
The CONTROL keyword value on the APPCCMD or RPL Exit).
that initiated the request (ALLOC, RESETRCV, keyword
DEALLOC, OPRCNTL, PREPRCV, RECEIVE, REJECT, The CONTROL keyword value on the APPCCMD
or SEND), or the exit or subexit that was driven that initiated the request (ALLOC, RESETRCV,
(FMH5 or TPEND). DEALLOC, OPRCNTL, PREPRCV, RECEIVE, REJECT,
cmdproc SEND or FMH-5).
The name of the command processor that was to tpname
be driven. The name of the application program that issued
subname the APPCCMD (in hexadecimal).
The name of the subtask under which the
command processor was to be driven. System action
tpname
For an FMH-5 event, NetView processing continues.
The name of the transaction program (in
For all other events, the subtask is ended.
hexadecimal).
retcode
The DSIMQS return code. Operator response
Notify the system programmer.
System action
Processing continues. System programmer response
If tpname is a program that is supplied by IBM, contact
Operator response IBM Software Support.

Verify that the subtask is active by using the LIST If the tpname is a customer-written program, define a
command. command processor to be driven for the event.

If the subtask is not active, start the subtask using the DSI773I domainid subcomponent TARGET
START command. TRANSACTION PROGRAM tpname
NOT FOUND
If the subtask is active, notify the system programmer.

Explanation
System programmer response
The application program issued a request to start a
See IBM Z NetView Programming: Assembler for conversation with a remote transaction program. The
information on the return code. If necessary, contact remote transaction program cannot be found.
IBM Software Support.
Message Variables
DSI772I domainid subcomponent NO
COMMAND PROCESSOR DEFINED domainid
FOR THE keyword EVENT The name of the NetView domain from which the
message is issued.

Chapter 7. DSI Prefix Messages 763


subcomponent Explanation
The name of the command facility LU 6.2
subcomponent that issued the message (ATTN You attempted to start CNM data transfer task task,
Exit). but did not provide CNMTARG names. Communication
with any NetView cross-domain CNM data transfer
tpname task is not possible.
The name of the transaction program specified in
the FMH-5 (in hexadecimal). Message Variables
task
System action The name of the task.
If the tpname in the message specifies a transaction
program associated with the NMC, processing System action
continues. If the tpname in the message is either The CNM data transfer task (DST) ends.
X'23F0F0F1' or X'23F0F0F2', the NetView program
rejects the conversation request it received. These
hexadecimal values indicate that either the DSI6DST Operator response
or DSIHPDST data services task is not active. Notify the system programmer.

Operator response System programmer response


If the tpname is X'23F0F0F1' or X'23F0F0F2', you Correct the statements on DSIPARM and have the
can try to start DSI6DST or DSIHPDST. For other operator restart the CNM DST. Provide CNMTARG
transaction programs, notify the system programmer. statements or change to CNMAUTH = GLOBAL.
DSI776I task: AUTHORIZATION IS GLOBAL
System programmer response
AND CNMTARG STATEMENT IS
If the tpname is a transaction program, contact IBM SPECIFIED
Software Support.
If the tpname is a customer-written program, define a Explanation
command processor to be driven for the event. Because the task you used indicated global
DSI774I FIELD MUST BE FILLED IN IF PORT authorization, the NetView program ignores the
IS BEING USED specific CNMTARG logical unit names that you
provided.
Explanation Message Variables
Both the transmission mode field and the channel field task
are required when defining a port. You left at least one The name of the task.
of these fields blank.
System action
System action CNM data transfer task (DST) continues and ignores
The NetView program ignores the command and the specific CNMTARG logical unit names that you
places a highlighted question mark in each blank field. provided.

Operator response Operator response


Replace each highlighted question mark with a valid Notify the system programmer.
value or blank out the entire column for a particular
port to show that it is not to be used. System programmer response
DSI775I task: CNMAUTH = SPECIFIC WAS If specific authorization is required, correct the CNM
SPECIFIED WITHOUT A CNMTARG DST statements on DSIPARM. Then stop and restart
STATEMENT the DST.
DSI777I task: WARNING - UNABLE TO
DEALLOCATE LUC RESOURCES

764 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


FOR THIS TERMINATING TASK - luname
TASK TERMINATION CONTINUES The session partner LU name.
cid
Explanation The communications identifier.
The task specified in the message is ending but is reason
unable to schedule cleanup of the LUC session control The failing reason code:
blocks for any LUC sessions established for this task Code
at the time of termination. Errors can occur during LUC Meaning
session establishment when this task is started again.
X'01'
Status of the sessions related to the unfreed control
LOSTTERM exit driven.
blocks is unpredictable.
X'02'
Message Variables TPEND exit driven.
task X'03'
If the task is a DST, this is the LU name of the task. NSEXIT exit driven.
If the task is an OST, this is the operator ID of the
X'04'
operator.
DFC state error.
X'05'
System action Error response received from access method
Task termination continues but this task's LUC session doing function specified by qual.
control blocks are not freed. X'06'
Response received was not valid.
Operator response X'07'
Insufficient resources.
Notify the system programmer.
X'08'
UNBIND received.
System programmer response
X'09'
If this message is issued when AAUTSKLP ends BIND response rejected.
and LUC session establishment errors occur when
AAUTSKLP is restarted, the session monitor must be X'0A'
stopped (STOPCNM NLDM) and restarted. System error.
qual
DSI778I task: LU SESSION WITH PARTNER
The qualified reason code:
= 'luname' TERMINATING, CID =
'cid', REASON = X'reason', QUAL Code
CODE = X'qual' Meaning
X'01'
Explanation SEND failure.
X'02'
The session ends because of an error, or if the failing
RECEIVE failure.
reason code is X'08'. If the session is allocated, the
owning TPN (partner name) in this domain will be X'03'
notified of the failure. The partner name is blank if OPNDST failure.
the LU name is not available. The LU name might not X'04'
be available if the initiator of this conversation has not OPNSEC failure.
transmitted its name to the partner.
Note: For further information concerning the
Note: This message is extended to message DSI795I, function specified by the qualified reason code,
if the session is allocated, and message DSI793I, if the refer to the appropriate VTAM manual.
failing reason code is X'05', X'08', or X'09'.
Message Variables System action
task The LU session ends.
The name of the task.
Note: If the partner LU name specified in the message
is a distributed host, then it is possible that alerts were

Chapter 7. DSI Prefix Messages 765


not transmitted from the distributed host during the taskid
session termination. The requesting task identifier.

Operator response Operator response


Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Access method traces might be required to determine Gather information to determine what command
the sequence of events leading up to this session end. processor calls for DSILCRTR to run under a task
other than the CNM data services task. Contact IBM
DSI779I task : WARNING - UNABLE Software Support.
TO TERMINATE SESSION WITH
PARTNER = 'luname', CID = 'cid' DSI781I task: UNABLE TO ALLOCATE
SESSION FOR 'luname',
Explanation PROCESSING TERMINATED

This is a severe error. The NetView program cannot


Explanation
end the session because of an access method failure.
The NetView program cannot reuse the session, but The allocation of a new session for the target logical
it can deallocate the associated conversation. If the unit failed. The target logical unit name might be blank
LU name is not available, the partner name might be if the LU name is not available because the initiator of
blank. An asynchronous error condition caused the this conversation has not transmitted his name to the
information to be deleted. partner. This message might be issued by itself, or it
might follow message DSI782I, DSI783I, or DSI784I.
Message Variables
Message Variables
task
The name of the task. task
luname The name of the task.
The partner LU name. luname
cid The name of the target logical unit.
The communications identifier.
System action
Operator response The allocation process ends.
Notify the system programmer.
Operator response
System programmer response Notify the system programmer.
If the reason for the failure is not a physical error,
contact IBM Software Support. The NetView program System programmer response
also issues message DSI783I with information about
the failing access method macro. If this message follows DSI782I, DSI783I, or DSI784I,
examine the information in the accompanying
DSI780I task: CNM DATA TRANSFER TASK message for assistance.
COMMAND ROUTER SCHEDULED
The message might be issued by itself because luname
UNDER INVALID TASK taskid
is not defined in DSILUCTD. If you require NetView-to-
NetView data transfer with luname, add a definition
Explanation for luname to DSILUCTD the next time the NetView
program is brought down. When the NetView program
A request using DSILCRTR as the command verb was
is brought back up, data transfer with luname will be
queued to a task other than the CNM data transfer
possible.
task. DSILCRTR rejects the request.
If the NetView storage shortage message (DSI124I)
Message Variables
precedes this message, examine the DSINLDM
task logmode table entry, which controls the session
The name of the task. parameters that were used in the session setup

766 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


attempt. A missing or erroneous RUSIZES keyword Use the RCFB command list for a description of
value can cause this error. the return code or feedback code. Use the SENSE
command list for a description of the sense code.
DSI782I task: macro FAILED FOR cblock -
REGISTER 15 = X'code' REGISTER Message Variables
0 = X'code' task
The name of the task.
Explanation action
A GENCB or MODCB macro issued during the INQUIRE, OPNDST, CLSDST, or TERMSESS.
allocation process failed. The reason is indicated by luname
the register 15 and register 0 error codes. Refer to the The name of the logical unit.
appropriate VTAM manual for more information. The
vtamrcd
target logical unit name is given in message DSI781I
The VTAM internal return code or feedback code.
which always follows message DSI782I.
vtamsens
Message Variables The VTAM internal sense code.
task
The name of the task. Operator response
macro Notify the system programmer.
GENCB or MODCB.
cblock
System programmer response
The NIB or RPL control block.
code Use the RCFB and SENSE command lists to determine
The codes used for problem analysis. the meaning of the return/feedback and sense
codes. See the device-specific documentation for the
meaning of the user sense data. If the problem is
System action a physical error (such as path error or NCP failure),
The allocation process ends. correct the error. If it is a logic error, contact IBM
Software Support.
Operator response DSI784I task: MAXIMUM SESSION COUNT
nn REACHED FOR luname
Notify the system programmer.

Explanation
System programmer response
The maximum number of sessions that this NetView
The NetView program provides this message to program is allowed to have active with the named
help determine the logic error problem. Find the NetView LU has been reached. The target logical unit
explanation for the register return codes in the name is given in message DSI781I which always
appropriate VTAM manual. follows this message. The target logical unit name
DSI783I task : action FAILED FOR 'luname' might be blank if the LU name is not available. The
RPL RTNCD/FDBK = X'vtamrcd', LU name might be unavailable if the initiator of this
RPL SENSE CODE = X'vtamsens' conversation has not transmitted its name to the
partner.
Explanation Message Variables
Message DSI781I gives the target logical unit name task
for INQUIRE and OPNDST failures. Message DSI779I The name of the task.
gives the target logical unit name for CLSDST and nn
TERMSESS failures. RTNCD/FDBK and SENSE values The maximum number of active sessions allowed.
note the macro request failure code. Refer to the
luname
appropriate VTAM manual for further information. If
The name of the target logical unit.
the LU name is not available, the target logical unit
name might be blank. An asynchronous error condition
deleted the information.

Chapter 7. DSI Prefix Messages 767


System action task
The name of the task.
The allocation request which prompted the start
session request fails. nn
The number of active sessions with the CNM or
AMLUSESS data services task.
Operator response
DSI788I task : --- END OF CNM SESSION
Notify the system programmer. STATUS DISPLAY

System programmer response Explanation


Increase the MAXSESS parameter of the CNMAUTH This is the trailer line received in response to LIST
definition statement if more parallel sessions are STATUS=CNMSESS.
needed. Restart the CNM data transfer task when
there are no more current users in order to implement Message Variables
the increase. task
DSI785I task : -- LUNAME CID NAME NAME The name of the task.
DSI789I task : --- LUNAME CID DATA TYPE
Explanation
This is the header line that is displayed in response to Explanation
the LIST STATUS = CNMSESS command. This is the heading you get when you enter the LIST
Note: This message is an extension of message STATUS=AMLUSESS command.
DSI794I. Message Variables
Message Variables task
task The name of the task.
The name of the task. DSI790I task : --- luname cid datatype
DSI786I task : --- luname cid local remote
Explanation
Explanation This is the information you get when you enter the
This is the message information which is received on LIST STATUS=AMLUSESS command.
the reply messages to LIST STATUS=CNMSESS. Message Variables
Message Variables task
task The name of the task.
The name of the task. luname
luname The name of the logical unit.
The name of the target logical unit. cid
cid The communication identifier.
The communication identifier. datatype
local The type of data for which the session was
The local TPN name (not blank if the session is established.
allocated). DSI791I task : --- END OF ACCESS METHOD
remote LU SESSION STATUS DISPLAY
The remote TPN name (if available).
DSI787I task : --- ACTSESS: nn Explanation
This is the last line you see after you enter the LIST
Explanation STATUS=AMLUSESS command.
This is the message information received in reply to Message Variables
the LIST STATUS=CNMSESS or AMLUSESS command.
task
Message Variables The name of the task.

768 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


DSI792I task : --- CNM SESSION FUNCTION Operator response
NOT SUPPORTED BY ACCESS
METHOD Notify the system programmer.

Explanation System programmer response


The version and release level of the access method do Use the RCFB and SENSE command lists to determine
not support establishing the CNM data transfer task the meaning of the return/feedback and sense
sessions. codes. See the device-specific documentation for the
meaning of the user sense data.
Message Variables
DSI794I task : --- LOCAL TPN REMOTE TPN
task
The name of the task.
Explanation
System action This is the header line which is displayed in response
to LIST STATUS=CNMSESS command.
Severe error. NetView CNM data transfer task
initialization process ends. Note: This message is extended to message DSI785I.
Message Variables
Operator response task
Notify the system programmer. The name of the task.
DSI795I OWNING TPN = 'tpname', OPID =
System programmer response 'id', REMOTE TPN = 'tpname'
Obtain VTAM V3 R1.1 or a later release.
Explanation
DSI793I FAILING API REQUEST = action
RPL RTNCD/FDBK = X'vtamrcd', The session ends because of an error. If the session
RPL SENSE CODE = X'vtamsens' is allocated, the owning TPN (partner name) in this
domain is notified of the failure condition. The partner
name might be blank if the LU name is not available
Explanation because the initiator of this conversation has not
The session ends because of an error, or if the failing transmitted his name to the partner.
API request field is RECEIVE, the session might end Message Variables
because the session is nonpersistent and the sender is
ending it. If the session is allocated, the owning TPN tpname
(partner name) in this domain is notified of the failure The TPN name (local or remote), if available.
condition. If the failing API request field is blank, the id
session did not end because of an access method The TVBOPID of local TPN.
error. Refer to the appropriate VTAM manual for further
information. Note: This message is an extension of message
DSI778I and is extended to message DSI793I.
Use the RCFB command list for a description of
the return code or feedback code. Use the SENSE
command list for a description of the sense code.
Operator response
Notify the system programmer.
Note: This is an extension of message DSI778I.
Message Variables
System programmer response
action
Access method traces might be required to determine
SEND, RECEIVE, OPNDST, or OPNSEC.
the sequence of events leading up to this session end.
vtamrcd
The VTAM internal return code or feedback code. DSI799I message module
vtamsens
The VTAM internal sense code. Explanation
IBM Software Support requested further information
on an error message you are receiving. This message is

Chapter 7. DSI Prefix Messages 769


used by IBM Software Support for problem diagnosis. queuetype
The message is written to the network log after certain Designated message queue type on the LIST
other error messages are issued and if you have MSGQ command. If not specified, the default type
entered MSGMODID=YES on a DEFAULTS command. is ALL.
Message Variables DSI801I TARGET TASK taskname IS NOT
SUPPORTED FOR DISPLAYING
message
PENDING MESSAGES
The message identifier of the previous message
that was issued.
module Explanation
The name of the module that issued the previous Only the task of type OST or NNT is supported for
message and a number that identifies the location displaying pending messages.
within the module where the message was issued.
Message Variables

System action taskname


Target task specified as an operand on the LIST
This message is not displayed, it is written to the MSGQ command, from which to display pending
network log only. messages.
DSI802A domainid REPLY WITH VALID
System programmer response NCCF SYSTEM OPERATOR
Provide the information contained in the message to COMMAND
IBM Software Support as requested.
Note: You cannot process this message with NetView Explanation
automation. This message appears on the system console. It
DSI800I DISPLAY PENDING MESSAGES IN initially follows message DSI112I, which indicates that
TASK taskname FOR MESSAGE the NetView program is ready to accept logons or
QUEUE TYPE queuetype NetView system operator commands. It also appears
on the system console after the CLOSE command has
been issued.
Explanation
Message Variables
The list is a multiple line message which shows the
pending messages in the message queues of the target domainid
task. Each line of the list describes the attributes of The name of the domain.
one pending message. These attributes include:
• Domain: Message domain ID System action
• Length: Total message text length The NetView program awaits your response.
• MType: Current message that is a pure message or a
command. Its value is either CMD or MSG. Operator response
• QType: Message queue type (either High, Normal, or Enter the appropriate CLOSE command or MSG.
Low)
DSI803A domainid REPLY INVALID. REPLY
• Sender: Message sender task name
WITH VALID NCCF TERMINAL
• Seq: Sequence number OPERATOR COMMAND
• Text: Message text. By default, only the first 16
characters of the first line of the message text are Explanation
displayed, unless MsgLen keyword is used on the
LIST MSGQ command. This message follows an incorrect reply to message
DSI802A.
• Time: Message time
Message Variables
Message Variables
domainid
taskname The name of the domain.
Target task name of which to display pending
messages.

770 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


System action responds by sending the logon prompt version of
DSI809A to the operator. The NetView program then
The NetView program awaits a correct response. waits for a response to the prompt.

Operator response Operator response


Enter one of the correct responses as shown in Respond to the prompt by entering the requested
message DSI802A. information:
DSI806A domainid NCCF IS ABOUT TO • Your operator ID.
ABEND - IF DUMP IS DESIRED,
• Your password.
REPLY 'Y' - OTHERWISE, REPLY 'N'
• The name of your profile. When the value of
OPERSEC is SAFDEF on the target domain, you can
Explanation use a comma (,) as a placeholder, or you can use a
This message is sent if the NetView program fails dummy profile name, which will be ignored.
during initialization. • The name of the hardcopy log device you want to
Message Variables start or NO if you do not want to start a hardcopy log
device.
domainid
The name of the domain. • YES if you want to run the initial command, NO if you
do not want to run the initial command.
• If you are on an MVS or VM system with security
System action
software installed and you want to change your
The NetView program awaits your response. password, two occurrences of a new password. (Do
not enter the new passwords with parentheses or
Operator response “optional:”).
If you receive the internal version of the message,
Enter the desired reply.
notify the system programmer.
DSI809A PLEASE ROUTE
OPID,PSWD,PROFILE, HARDCOPY, System programmer response
INITIAL CMD (optional: ,NEW
PSWD, NEW PSWD) — If the operator receives the internal version of the
or — PLEASE ROUTE message, check the cross-domain logon procedures
OPID,PASSWORD,PROFILE, for the installation, and change them as necessary.
HARDCOPY,INITIAL CMD For more information, see IBM Z NetView Installation:
Getting Started.
Explanation DSI812A domainid REPLY INVALID. REPLY
'Y' FOR DUMP OR 'N' FOR NO
The first message is DSI809A. If you are not using full-
DUMP
screen mode when logging on to the NetView program,
you receive this message as a logon prompt.
Explanation
The NetView program also uses an internal version
of this message. The internal version of DSI809A This message is sent in response to a reply that is not
contains the name of a NetView domain that was valid to message DSI806A.
successfully started.
Message Variables

System action domainid


The name of the domain.
How the NetView program responds to the receipt of
the internal DSI809A message depends on how you
System action
defined your installation options. You can define the
NetView program to respond by displaying the cross- The NetView program waits for the operator's
domain logon panel or by calling a cross-domain logon response.
command list.
If you do not specify use of the cross-domain panel or Operator response
a cross-domain command list, the NetView program
Enter one of the correct responses.

Chapter 7. DSI Prefix Messages 771


DSI813A domainid ERROR(S) HAVE Message Variables
OCCURRED IN INITIALIZATION. task
REPLY 'YES' TO CONTINUE OR 'NO' The name of the task for which the NetView
TO TERMINATE
ESTAE/ESTAI exit (DSIMSX) is driven:
• For NetView main task, it is SYSOP.
Explanation
• For an operator station task (OST), it is the
Errors have occurred in NetView initialization logged-on operator's ID.
processing. The error might affect NetView operation
or security. • For a data services task (DST), it is the task name
defined in the CNMSTYLE member.
Message Variables
• For a task name that cannot be determined,
domainid UNKNOWN is used.
The name of the domain
hhhhhh
Hexadecimal completion code. The first three
System action digits are the system completion code and the last
three are the user completion code.
The NetView program waits for your response.
domainid
The domain ID of the system taking the SVC dump.
Operator response
Notify the system programmer. System action
An SVC dump is taken. Message DSI820 is sent after
System programmer response the SVC dump is taken.
This message follows a series of NetView initialization
messages. See the system console for the messages Operator response
received prior to message DSI813A or browse the
system log if needed. Review these messages and Notify the system programmer.
decide whether to continue processing.
DSI814A domainid REPLY INVALID. REPLY System programmer response
'YES' OR 'NO' Once the SVC dump has completed, format the dump
for printing. Investigate the reason for the abend.
Explanation DSI820I SVC DUMP WAS ATTEMPTED,
You entered a reply that is not valid for message RETURN CODE FROM SVC
DSI813A. DUMP= X'retcode', REASON CODE=
X'reason'
Message Variables
domainid Explanation
The name of the domain.
An abend occurred.
System action Message Variables
The NetView program waits for a valid reply. retcode
The hexadecimal return code from SDUMP
Operator response reason
The hexadecimal reason code from SDUMP
Enter a valid response.
Refer to the z/OS MVS Programming library for more
DSI819I NETVIEW IS DUMPING FOR information.
TASK task. COMPLETION CODE=
X'hhhhhh', DOMAIN=domainid.
System action
Explanation The NetView ESTAE/ESTAI exit gets control and
performs an SVC dump.
An abend occurred. The NetView ESTAE/ESTAI exit
gets control and performs an SVC dump.

772 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Operator response Operator response
Notify the system programmer. Notify the system programmer.

System programmer response System programmer response


Once the SVC dump is complete, investigate the Upgrade all applications which use DSIPSS
reason for the dump. TYPE=PANEL. Two NetView services which might be
of use are DSIPSS TYPE=ASYPANEL and the VIEW
DSI821I domainid NCCF MAIN TASK
command. For additional information, see the IBM Z
FAILED. RETURN CODE= X'retcode'
NetView Programming: Assembler and IBM Z NetView
FROM ISSUE OF macro MACRO.
Customization Guide.
domainid NCCF IN SHUTDOWN
MODE DSI823I member HAS A MISSING OR
INCORRECT SIGNATURE
Explanation
Explanation
The NetView main task issues an ESTAE macro and the
macro returns a nonzero return code. A process within the IBM Automation Control for
z/OS product encountered a member with a missing
Message Variables
or incorrect signature. The process requires that a
domainid member on which it operates includes an encrypted
The domain where the NetView program resides. signature that matches the rest of its contents. Such
retcode members must not be changed by users because such
The return code from ESTAE macro. processes cannot use unsigned members.

macro Message Variables


The name of the ESTAE macro. member
The member with a missing or incorrect signature.
System action
The NetView main task abends with the user abend System action
code X'01', and asks you to specify whether or not a The process completes unsuccessfully.
system dump is desired.

Operator response
Operator response
Notify the system programmer.
If required, request a system dump.

System programmer response


System programmer response
If the member was changed, restore its original
Investigate ESTAE macro failure. contents.
DSI822I DSIPSS TYPE=PANEL DSI824I COMMAND ENTERED IS NOT
INVOCATION NEEDS TO BE SUPPORTED ON THIS LEVEL OF
REPLACED NETVIEW

Explanation Explanation
You invoked an application which uses DSIPSS You entered a command that is either not valid or is
TYPE=PANEL, an obsolete assembler interface. This not supported on the level of the NetView program
message appears, at most, once per NetView logon. that you are running.

System action System action


The NetView DSIPSS service fails and issues a return The command is not processed.
code of 8.
DSI891I USING DEFAULT MEMBER –
member

Chapter 7. DSI Prefix Messages 773


Explanation cmd_name
The name of the command that failed.
member is the default member being used.
rc
Message Variables The return code of the command that failed.
member command
The default member name The syntax of the command that failed, without
variable substitution.
System action
System action
The NetView program is using the default member.
Depending on the severity of the error, the command
procedure might continue processing.
Operator response
Notify the system programmer. Operator response
Review the output of the command procedure for
System programmer response
related error messages. If the return code is 4 or less,
Determine whether the member being used is correct the command procedure might continue processing.
for your environment.
DSI892I keyword KEYWORD USING System programmer response
DEFAULT VALUE OF value Determine why the command failed. Usually this is
because of a problem with a data set.
Explanation
DSI894E UNMATCHED COMMENT
The keyword keyword that was specified has a default DELIMITER IN MEMBER
value of value. member_name
Message Variables
Explanation
keyword
The keyword specified While processing comments in a data set member, an
value unmatched comment delimiter was found. Either an
The default value for the specified keyword. opening delimiter was found without a corresponding
closing delimiter, or a closing delimiter was found
without an opening one.
System action
Message Variables
The NetView program uses the default value for the
keyword. membername
The data set member with the unmatched
delimiter.
Operator response
Notify the system programmer. System action
The command procedure stops processing.
System programmer response
Determine whether the default value is correct for your Operator response
environment.
Notify the system programmer.
DSI893E cmd_name COMMAND FAILED
WITH A RC = rc : command
System programmer response
Explanation Review the member_name and correct the problem
with the comments. After correcting the problem,
A command issued by the REXX command procedure rerun the command procedure.
failed with the specified return code.
DSI895E UNMATCHED QUOTE IN MEMBER
Message Variables member_name ON LINE line_no

774 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Explanation System action
While processing a data set member, an unmatched Processing ended.
quotation mark was found on the specified line
number. Either an opening quotation mark was found Operator response
without a corresponding closing quotation mark, or a
closing quotation mark was found without an opening If the return code is not 0, notify the system
one. programmer.
Message Variables
System programmer response
member_name
The data set member with the unmatched If the return code is not 0, review the output and
quotation mark. correct any errors listed. After correcting the problem,
rerun the utility.
line_no
The line number in the command procedure where DSI897E COULD NOT FIND ANY DATA SETS
the syntax error occurred. FOR DDNAME ddname

System action Explanation


The command procedure stops processing. There are no data sets defined for the specified
DDNAME.
Operator response Message Variables
Notify the system programmer. ddname
DDNAME with no defined data sets.
System programmer response
Review the member_name and correct the problem System action
with the quotation marks. After correcting the Processing ends.
problem, rerun the command procedure.
DSI896E utility COMPLETED WITH RC = rc Operator response
Notify the system programmer.
Explanation
The utility completed processing. If the return code is System programmer response
not zero (0), review the output for error messages and
Review the JCL to determine which data sets are
take appropriate action.
defined for the specified DDNAME. Ensure that the
Message Variables data sets exist. If a data set is an output data set,
verify that the Exec has write-authority for it.
utility
Utility name: DSI898E COULD NOT FIND MEMBER
• CNMSTYLE Report Generator member_name IN DDNAME
ddname
• CNMSTYLE Migration Tool
rc Explanation
The utility return code:
The specified member was not found in the data set
0 concatenation for the listed DDNAME.
Successful completion.
Message Variables
4
The utility completed; review messages in the member_name
output. The data set member that cannot be found.
8 ddname
The utility did not complete; review messages DDNAME for the specified member.
in the output.

Chapter 7. DSI Prefix Messages 775


System action at 120 characters. More of the message text for that
message appears as text.
An error message is issued. Depending on the type
of processing being done, the Exec might continue. Message Variables
Otherwise, processing ends. msgid
The message identifier whose text is being
Operator response continued
Notify the system programmer. text
The continuation text from the indicated message
ID
System programmer response
Determine if the specified member is required for Operator response
correct processing. The missing member might be an
included member. If the specified member is required, Use the text from this message to read the entire text
correct the problem and rerun the Exec. intended for the indicated message.

DSI899I msgid text

Explanation
A previous message was sent to an MVS console, but
it was too long to fit on one line and was truncated

776 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Appendix A. Codes

This appendix provides information about the following abend and sense codes:
• NetView program abend codes, including:
– GMFHS abend codes
– RODM abend codes
• Alias sense codes
• LUC conversation request service return codes and sense codes
• Generic alert code points

NetView Abend Codes


An abend code is generated for an unrecoverable error. This completion code is issued when a logic error
occurs or a serious problem is detected. The code is presented on the abend dump listing as user code
Uxxxx, where xxxx is the decimal code as described in this section.
The system action for all codes is for the abending task to stop running.
This section contains abend codes issued by:
• AAU module
• Alias name translation facility
• BNJ module
• CNM module
• Command list function
• DSIOST and DSINNT
• DSIPPT
• DSIZDST
• DUI module
• DWO module
• GMFHS
• RODM

Table 1. NetView Abend Codes


Decimal Hex Explanation of the Abend
Code Code
001 X'001' NetView initialization failed. See the system log for any error messages that
indicate the reason for the failure.
002 X'002' OPEN failed for the NetView main task ACB.
003 X'003' SHOWCB failed for VTAM API control blocks.
004 X'004' DSIGET failed for the NetView main task APPLID suffix table.
006 X'006' SETLOGON START to accept logons failed.
009 X'009' The NetView main task cannot load the NetView message definition modules
DSIMDM or DSIMDMV. Verify that the required modules, panels, or tables are
properly installed. Also, verify that the modules, panels, or tables can be accessed
by the NetView application.

© Copyright IBM Corp. 1997, 2022 777


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
010 X'00A' The primary POI task ended abnormally because the maximum retry count for this
view was exceeded.
Note: A message might have preceded this abend.

011 X'00B' Control blocks cannot be built for the NetView main task.
012 X'00C' An installation exit that runs in 24-bit addressing mode needs to address a data
area that resides in 31-bit storage. The data area is at least one of the following:
the CNM input buffer, VSAM user data area, or VSAM key.
013 X'00D' The NetView program encountered an unsupported internal command request
code.
015 X'00F' NPS DST initialization failed.
016 X'010' The count fields of the control blocks DSIRAL and DSILAL or DSISAL are not equal.
This causes errors when calling NetView service routines.
017 X'011' The DSIRNK table is not large enough to hold the keywords of the command it is
processing. This abend only occurs if more keywords are defined for a command,
and the DSIRNK table in DSIYOSR is not updated to reflect the change.
018 X'012' Storage does not belong to the caller, or the length of the data record exceeds the
limit.
019 X'013' The NetView main task uses this code in response to a CLOSE ABEND command.
020 X'014' The NetView main task uses this code in response to a CLOSE DUMP command.
021 X'015' STACK is exceeded because of EXIT interrupts.
023 X'017' DSIGMN or DSIFMN is indicating that the issuing module cannot obtain a working
storage area because all working storage areas are in use.
024 X'018' LERAD/SYNAD stack was exceeded because of exit interrupts.
025 X'019' The interface to the high-level language (MVS only) environment (DSIHLINK) was
invoked for reasons other than initialization, resume, abend, logoff, or termination.
026 X'01A' The user attempted to use DSIHLLAR to perform illegal multitasking from a task
control block (TCB).
027 X'01B' The matching RPL is not found in the queue of waiting request blocks. Issued by
VPDTASK.
029 X'01D' The DSICES macro gives a return code that is not 0 or 20. The CNMTAMEL DSCP
verb name (DUIADISP) cannot be found. Abend issued from module DUIATIMR.
DUMP(NO).
030 X'01E' Resume issued for an ADX that was not suspended. Abend issued from module
DUIARES. DUMP(YES).
031 X'01F' Logic error. Abend issued from module DUISHMQA. DUMP (YES).
032 X'020' The DSILOD macro failed to load message table DUIAMSGS or service module
table DUIISVCT. Verify that these modules are properly installed. Also, verify that
the modules can be accessed by the NetView program. Abend issued from module
DUIINITA. DUMP(NO).

778 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
033 X'021' Cannot get storage during CNMTAMEL task initialization. Abend issued from
module DUIINITA. DUMP(YES).
034 X'022' Logic error. Abend issued from module DUISHQMA. DUMP(YES).
035 X'023' The DSILOD macro failed to load service modules. Verify that the NetView program
is properly installed and that all NetView modules can be accessed. Abend issued
from modules DUIDLOAD and DUIALOAD. DUMP(YES).
036 X'024' The DSIGET macro failed. Abend issued from module DUIMENTR. DUMP(YES).
037 X'025' Logic error. Abend issued from module DUISHMQA. DUMP(YES).
038 X'026' The LU 6.2 command processor definition macro DSIL6DFS failed. Abend issued
from module DUIINITA. DUMP(NO).
039 X'027' Cannot obtain required ADX control blocks. Abend issued from module DUIINITA.
DUMP(NO).
040 X'028' There is not enough available storage to build and initialize the resource status
collector list with the user-specified MAXSCCOUNT number. Abend issued from
module DUIDIMDP. DUMP(YES).
043 X'02B' There is not enough available storage to build the resource status collector list.
Abend issued from module DUIDITTP. DUMP(YES).
044 X'02C' VTAM APPCCMD macro not accepted or bad command verb. Abend issued from
modules DUIACNOS and DUIAAPPC. DUMP(YES).
045 X'02D' Call to module DUIACMIO is not valid. Abend issued from module DUIACNOS.
DUMP(YES).
046 X'02E' CNOS APPCCMD not accepted. Abend issued from module DUIACNOS. DUMP(YES).
047 X'02F' APPCCMD completed with return code ABEND. Abend issued from module
DUIADETE. DUMP(YES).
048 X'030' ADX pool value is not valid. Abend issued from module DUIAADXM. DUMP(YES).
049 X'031' Incorrect task when buffer origin is DSICRTR. Abend issued from module
DUISHQMA. DUMP(YES).
050 X'032' Incorrect buffer origin. Abend issued from module DUISHQMA. DUMP(YES).
051 X'033' Status sent by resource status collector in either a REPLY SYNCH or an UPDATE
vector is not valid. Abend issued from modules DUIDGADE and DUIDGUPE.
DUMP(YES).
053 X'035' Logic error. Abend issued from module DUIDIMRP. DUMP(YES).
054 X'036' Logic error. Abend issued from module DSIFRCFP. DUMP(YES).
055 X'037' Logic error. Abend issued from module DSIFRCFP. DUMP(YES).
056 X'038' Logic error. Abend issued from module DUISHMQA. DUMP(YES).
057 X'039' The DSILOD macro failed to load module DUIALOAD. Verify that this module is
properly installed and that it can be accessed by the NetView program. Abend
issued from module DUIINITA. DUMP(NO).

Appendix A. Codes 779


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
058 X'03A' The DSILOD macro failed to load module DUIDINIT. Verify that this module is
installed and that it can be accessed by the NetView program. Abend issued from
module DUIINITA. DUMP(NO).
059 X'03B' Logic error. Abend issued from module DSICSND. DUMP(YES).
060 X'03C' Call to DUIADISP is not valid. Abend issued from module DUIADISP. DUMP(YES).
061 X'03D' Logic error. Abend issued from module DUISHSNA. DUMP(YES).
063 X'03F' NETTYPE control block not found. Abend issued from module DUIDSSEG.
DUMP(YES).
064 X'040' Logic error. Abend issued from module DUIADISP. DUMP(YES).
065 X'041' Logic error. Abend issued from module DUIADISP. DUMP(YES).
066 X'042' Logic error. Abend issued from module DUIADISP. DUMP(YES).
067 X'043' Error in hashing function. Abend issued from module DUIDFPUR. DUMP(YES).
068 X'044' CNMTAMEL task initialization failed. Abend issued from module DUISDISP.
DUMP(NO).
069 X'045' A buffer was queued that was not valid. Abend issued from module DUIADISP.
DUMP(YES).
070 X'046' Logic error. Abend issued from module DUISHDEA. DUMP(YES).
071 X'047' Logic error. Abend issued from module DUIADISP. DUMP(YES).
072 X'048' Logic error. Abend issued from module DUIDHSHS. DUMP(YES).
073 X'049' Logic error. Abend issued from module DUIDHSHS. DUMP(YES).
074 X'04A' Logic error. Abend issued from module DUIDHSHS. DUMP(YES).
075 X'04B' Logic error. Abend issued from module DUIDIMNP. DUMP(YES).
076 X'04C' Logic error. Abend issued from module DUIDIMDP. DUMP(YES).
077 X'04D' Logic error. Abend issued from module DUIDIDCP. DUMP(YES).
078 X'04E' Logic error. Abend issued from module DUIATRPR. DUMP(YES).
079 X'04F' Logic error. Abend issued from module DUIDMQRY. DUMP(YES).
080 X'050' CSCF attempted to acquire storage using DSIGET. The attempt failed.
081 X'051' This code is used by the operator station task (OST) when an incorrect data stream
is received from a hardware device.
082 X'052' Used for stack overflow or underflow.
083 X'053' The NetView program detected an overlay of the DSICWB control block possibly
caused by the abending task's misuse of the CWBADATD field. This abend might be
accompanied by user abend 2304 (X'900') or other abends that indicate a storage
overlay.
085 X'055' The initialization routine cannot obtain storage for the primary anchor control block
whose address is returned in the bhlbptr parameter of CNMETIN (CNMETINIT).
Initialization of the server support API failed.

780 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
086 X'056' The initialization routine cannot load either of the required NetView load modules
DSIEHLAR, DSIEHL24, or both. Initialization of the server support API failed.
087 X'057' This abend code can be issued as follows:
• The MDS-RECEIVE cannot be defined.
• The PUSH of the logoff routine failed.
• A terminating error was encountered by the other initialization modules for the
transport.
• Bad syntax on the PARTNER statement.
• Failure in operations management or focal point initialization.
• Failure when attempting to issue a timer services request during task
initialization.
• Failure when attempting to push a logoff routine from the task being initialized.
This can be caused by a missing CMDDEF statement.
• Failure when attempting to define to the command facility one of the LU 6.2
transaction programs that the transport uses.

089 X'059' Unexpected error occurred in automation table processing. DUMP (YES).
090 X'05A' A return code that is not valid was received during GLOBALV processing.
091 X'05B' Should not occur: severe error returns from the NetView Bridge dispatcher.
092 X'05C' Logic error. Abend issued from module DUIDUPRQ. DUMP(YES).
093 X'05D' Logic error. Abend issued from module DUIDMCFV. DUMP(YES).
094 X'05E' Logic error. Abend issued from module DUIDMLUV. DUMP(YES).
095 X'05F' Logic error. Abend issued from module DUIDICDP. DUMP(YES).
096 X'060' Logic error. Abend issued from module DSIIBMHL. DUMP(YES).
097 X'061' DSIWAT time-out. A limit set in the DSIMVT control block was reached while task
message queues were blocked. See DSIMVT maco label MVTCPAWT for details.
098 X'062' Unrecoverable SELECT error. Abend issued from DUIASELE. DUMP(YES).
112 X'070' A Graphic Monitor Facility host subsystem (GMFHS) method detected an out-of-
storage condition. The Resource Object Data Manager (RODM) generates a log
record type 7 containing this abend code. The user application program triggering
the abending method receives a return code 12 with reason code 194.
113 X'071' The security software initialization for the primary POI task has failed.
115 X'073' The DSIPUSH macro failed. Abend issued from BNJAPAMA.
257 X'101' RESET IMMED or RESET DUMP command was issued. The error recovery routine of
some system services can generate a dump. See the STOP command in NetView
online help for more information.
258 X'102' Unexpected LERAD error under non-TAF environment.
259 X'103' An installation exit returned a return code that is not valid or USERSWAP is
selected, but the buffer is too small to hold the new record. Register 5 contains an
installation exit number, and register 6 contains a return code from the installation
exit.

Appendix A. Codes 781


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
261 X'105' Unexpected LOSTERM entry.
262 X'106' An installation exit returned a return code that is not valid or USERSWAP is
selected, but the buffer is too small to hold the new record. Register 5 contains an
installation exit number, and register 6 contains a return code from the installation
exit.
263 X'107' Installation exit DSIEX01 returned a code that is not valid or USERSWAP is
selected, but the buffer is too small to hold the new record. Register 3 contains
the installation exit return code.
264 X'108' The internal function request code is not valid.
266 X'10A' Terminal session was lost while a command was running in DSIRCV.
267 X'10B' Terminal session was lost while a command was running in DSIPS14.
268 X'10C' Unexpected SYNAD error. Hardware type error, see message DSI625I.
269 X'10D' Unexpected LERAD error under TAF environment.
270 X'10E' Unexpected DSIGET failure while processing a RMTCMD or ENDTASK command.
See NetView online help for information about the RMTCMD and ENDTASK
commands.
271 X'10F' A NetView function called another function (such as a SAF product) and the
maximum amount of time allowed for that call was exceeded. The task experienced
this abend to interrupt the request that was taking too long. If the function called
was an SAF product, the maximum time that is allowed is 10 seconds.
320 X'140' Unexpected return code from DSIDKS macro in module DSICCGO.
321 X'141' Unexpected function type returned by dictionary services in module DSICCFCN.
322 X'142' Unexpected return code from dictionary services in the DSICCSUB module and the
DSIRXFCR module.
323 X'143' Unexpected return code from the ISGLPRG service routine in the DSILPRGI
module.
336 X'150' Should not occur: either an unknown or unexpected return code was returned from
the REXX interpreter, or the requested storage length is a negative value or zero.
337 X'151' REXX obtained storage is not freed. DSIFRE was invoked to free storage on behalf
of REXX. Storage was not freed, but a dump was taken.
384 X'180' Unexpected return code from DSIKVS macro in module DSISTP.
385 X'181' Unexpected return code from DSIKVS macro in module DSISWCP.
386 X'182' Unexpected return code from DSIKVS macro in module DSISRP.
387 X'183' Unexpected return code from DSIKVS macro in module DSIEVP.
388 X'184' Unexpected return code from DSIKVS macro in module DSIATP.
518 X'206' An installation exit returned a code that is not valid or USERSWAP is selected, but
the buffer is too small to hold the new record. Register 5 contains the installation
exit number, and register 6 contains the return code from the installation exit.
520 X'208' A function type that is not valid was received.

782 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
550 X'226' DSIITM has detected a BUFHDR that is not valid in a buffer being traced for
either the PSS, QUE, or UEXIT trace option. Contact IBM Software Support for
programming assistance.
600 X'258' Logic error occurred in the NetView program. Contact IBM Software Support for
programming assistance.
666 X'29A' Logic error occurred in the NetView program. Contact IBM Software Support for
programming assistance.
668 X'29C' A reference to a freed CCV has been detected by the NetView program.
1024 X'400' I/O error during VSAM VERIFY macro processing.
1025 X'401' DSIGET failed to obtain storage.
1026 X'402' Subtask cannot complete initialization.
1027 X'403' Unable to send reply request unit to VTAM by the communication network
management interface.
1028 X'404' Logic error in alias application. Index value in control block is wrong.
1029 X'405' Unrecoverable error during alias initialization. Preceded by a description message.
1030 X'406' Unexpected return code following a DSIDKS macro.
1031 X'407' The VSAM POINT macro failed on the event log database in the database server
VSAM I/O initiate routine.
1032 X'408' The VSAM GET macro failed on the event log database in the database server VSAM
I/O initiate routine.
1033 X'409' The VSAM POINT macro failed in the COMPUTE INITIAL DATABASE STATUS
MODULE READ FIRST RECORD routine.
1034 X'40A' The VSAM GET macro failed in the COMPUTE INITIAL DATABASE STATUS MODULE
READ FIRST RECORD routine.
1035 X'40B' The VSAM POINT macro failed in the COMPUTE INITIAL DATABASE STATUS
MODULE READ MIDDLE RECORD routine.
1036 X'40C' The VSAM GET macro failed in the COMPUTE INITIAL DATABASE STATUS MODULE
READ MIDDLE RECORD routine.
1037 X'40D' Logic error. The first record in a logical wrap database is a seed record but the last
is not a seed.
1038 X'40E' Logic error. The binary search to locate the absolute low and high bounds of a
logical wrap database failed.
1039 X'40F' Logic error. A record returned from the VSAM GET macro did not match the
requested database ID.
1040 X'410' The VSAM GET macro failed in the COMPUTE INITIAL DATABASE STATUS MODULE
READ FIRST RECORD routine.
1041 X'411' The VSAM POINT macro failed in the COMPUTE INITIAL DATABASE STATUS
MODULE SEQUENTIAL READ RECORD routine.
1042 X'412' The VSAM GET macro failed in the COMPUTE INITIAL DATABASE STATUS MODULE
SEQUENTIAL READ RECORD routine.

Appendix A. Codes 783


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
1043 X'413' The VSAM GET macro failed in the GET FIRST RECORD FORWARD routine.
1044 X'414' The VSAM POINT macro failed in the READ PREVIOUS routine.
1045 X'415' The VSAM GET macro failed in the READ PREVIOUS routine.
1046 X'416' The VSAM GET macro failed in the READ LOGICAL WRAP RECORD routine.
1048 X'418' Logic error. Address of the positioning keys pointer in the READ LOGICAL WRAP
RECORD routine was zero.
1281 X'501' NetView issues this abend to cause task recovery. Indications are that this task
took an abend in NetView code running in an asynchronous exit while the task
mainline code was processing a REXX command procedure. The asynchronous exit
abend was intercepted by a REXX ESTAE routine that cleared REXX, then returned
control to this NetView task. The REXX intercept of the asynchronous task abend
did not allow NetView to correctly recover from the abend. NetView issues abend
1281 to achieve drive NetView task abend recovery. Check your system log for
information pertaining to the asynchronous exit abend. A dump is taken by this
abend in case it is needed to determine the cause of the asynchronous exit abend.
2000 X'7D0' Reserved for IBM Software Support
2001 X'7D1' Reserved for IBM Software Support
2002 X'7D2' Reserved for IBM Software Support
2003 X'7D3' Reserved for IBM Software Support
2004 X'7D4' Reserved for IBM Software Support
2005 X'7D5' Reserved for IBM Software Support
2006 X'7D6' Reserved for IBM Software Support
2007 X'7D7' Reserved for IBM Software Support
2008 X'7D8' Reserved for IBM Software Support
2009 X'7D9' Reserved for IBM Software Support
2304 X'900' Module requires a larger work area than found, for successful entry linkage.
2305 X'901' Status monitor did not initialize successfully.
2306 X'902' Nonzero return code received from DSILOD of any status monitor module. Verify
that the required modules, panels, or tables are properly installed. Also, verify that
the modules, panels, or tables can be accessed by the NetView application.
2307 X'903' Status monitor internal error.
2308 X'904' Status monitor internal error.
2309 X'905' Status monitor internal error.
2310 X'906' Five consecutive SNDCMD or RCVCMD failures occurred in CNMTARCA.
2311 X'907' The module called by CNMTFLTR to process message text has returned a result
larger than expected. Storage might have been overwritten.
2312 X'908' Status monitor initialization failed. Verify that the module ISTIECCE is available to
VTAM as outlined in IBM Z NetView Installation: Configuring Additional Components.

784 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
2320 X'910' A DROP = YES condition was encountered while in a full-screen panel. The session
was dropped.
2501 X'9C5' Note: This is a system abend code.
With Reason Code 0: RODM has cancelled the transaction based on the reply to
message EKG1326D. Message EKG1326D is issued when there are transactions
still running in RODM during RODM checkpoint or RODM termination.
With Reason Code 33: A RODM internal error has occurred; contact IBM Software
Support for programming assistance.

2816 X'B00' NetView subsystem detected a PC call to PPI service routine that is not valid.
2977 X'BA1' Session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2978 X'BA2' Session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2979 X'BA3' Session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2980 X'BA4' Session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2981 X'BA5' Session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2982 X'BA6' The session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2983 X'BA7' The session monitor detected a connectivity chain that is not valid. Contact IBM
Software Support for programming assistance.
2989 X'BAD' NetView has detected that a VTAM send has not completed. Either the send was
issued more than 3 minutes ago or the data queues are overloaded. Presentation
services output queues overload is defined as exceeding twice the value of
NORMQMAX as specified in the operators SCRNFMT. This is probably either an
operator terminal or VTAM problem.
3002 X'BBA' There is no page number table primary segment address in the hierarchy table.
3008 X'BC0' The NetView display panel size (PDXDVSIZ) is less than 21 lines, but it must be at
least 21 (24 minus 3) lines.
3010 X'BC2' The DSIPSS macro gives a nonzero return code. The FIRST, MIDDLE, and LAST
operands are not specified in the correct order, or too many DSIPSS macros have
been issued for the display panel size.
3083 X'C0B' The DSIGET macro is unable to obtain enough storage for the DSIMQS buffer.
3085 X'C0D' The DSIGET macro is unable to obtain enough storage for the DSIMAS buffer.
3086 X'C0E' The DSICES macro gives a nonzero return code. The routine failed to successfully
transfer control because it cannot find the task ID or the verb associated with it.
3089 X'C11' The DSIMBS macro gives a return code not equal to 0 or 12. The NetView program
cannot retrieve a message and message BNJ322I has been issued.
3339 X'D0B' The DSIGET macro gives a nonzero return code. A GETMAIN was unsuccessful.

Appendix A. Codes 785


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
3341 X'D0D' An unknown task ID was found in the CNMTAMEL request block.
3342 X'D0E' Incorrect receiver state of receiving session found.
3345 X'D11' Attempt to send a NetView message to authorized receiver using DSIMQS failed.
3346 X'D12' A call to DSILCS macro to free the allocated SWB was not successful.
3347 X'D13' Attempt to get the message size using DSIMBS failed.
3348 X'D14' A call to DUIFSMSG was not successful.
3349 X'D15' Testing of DSIDELAY flag is on.
3351 X'D17' Incorrect parameters passed to service routine DUIFEXPP.
3357 X'D1D' The MSU within an AIFR has garbled data that prevents it from being sent to the
GMFHS address space.
3358 X'D1E' Incorrect parameters passed to service routine DUIFEXPP.
3376 X'D30' Storage overlay has occurred. The storage suffix of the area to be freed is not valid.
3377 X'D31' Logic error in the GET QUEUE routine. A queue element in the queue map indicated
as free contains data.
3378 X'D32' Logic error in the FREE QUEUE routine. A queue entry to be freed was not found in
the queue map.
3380 X'D34' Logic error in the FREE MCB routine. The MCB entry to be freed was not found in
the MCB map.
3381 X'D35' A subtask within GMFHS did not end within 1 minute of the request to end the
address space. The subtask was abnormally ended.
3399 X'D47' An internal error in GMFHS has been detected. Contact IBM Software Support for
programming assistance.
3500 X'DAC' The DSIGET macro gives a nonzero return code. The routine was unable to load the
message buffer.
3501 X'DAD' The DSICES macro gives a return code that is not 0 or 20. The DSCP verb name
cannot be found.
3502 X'DAE' The DSIMQS macro gives a nonzero return code. A message to the NetView
authorized operator failed.
3601 X'E11' Neither screen buffer was flagged as active.
3602 X'E12' BNJCGTDA returned with a nonzero return code.
3603 X'E13' A data record that is not valid was detected.
3604 X'E14' BNJCRHTA returned a nonzero return code.
3605 X'E15' BNJCHUPA returned a nonzero return code.
3606 X'E16' BNJCSNDA returned a nonzero return code.
3607 X'E17' DSIGET failure detected.
3608 X'E18' Unknown parameter data detected by BNJP109A or BNJP110A.
3609 X'E19' The NetView DSCP verb is not defined in CNMCMD.

786 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
3610 X'E1A' An attempt to send a message using DSIMQS to the authorized operator failed.
3611 X'E1B' Internal processing error detected by BNJP101A.
3780 X'EC4' This is a system abend code. This abend is not an error; it is a normal result. If
a system recovery routine is in control (for example, for the consoles component)
a dump might be produced. These are some of the situations that can result in a
X'EC4' abend:
• OMVS was not started.
• VOST timeouts (for example, SNMP timeouts during resolver calls, or agent not
responding).
• NetView operator logoff hangs.
• The STOP FORCE command was issued against a task in the NetView address
space (MVS) to force the target task to stop.
• As the final step of NetView CLOSE IMMED processing, the abend was issued
against remaining tasks.
Note: CLOSE STOP is the recommended method to end the NetView program.

3994 X'F9A' The DSIMQS macro gives a nonzero return code. A message to the authorized
NetView operator failed.
3995 X'F9B' The DSIMBS macro gives a return code not equal to 0, 4, or 12. The NetView
program cannot construct a message.
3997 X'F9D' The DSIGET macro failed to obtain storage for the DSX.
3998 X'F9E' The DSIMQS macro gives a nonzero return code. A message to the NetView
authorized operator failed.
3999 X'F9F' The DSILCS macro failed for service work block (SWB).
4000 X'FA0' A format error was detected while deblocking the logical records within a
temporary database physical record.
4001 X'FA1' AAUCLODA cannot find the current panel hierarchy entry name in the node table,
and issued a return code of 4.
4002 X'FA2' There is no primary segment address in the page number table of the hierarchy
table.
4003 X'FA3' DSIGET was unable to obtain storage for a temporary record buffer.
4004 X'FA4' DSIGET was unable to obtain storage for a temporary record buffer.
4005 X'FA5' Module AAUSPOOL did not find the page identifier PGBN when attempting to free
storage. This might be caused by a bad pointer passed to AAUSPOOL.
4006 X'FA6' DSIMQS failed.
4007 X'FA7' DSIGET was unable to obtain storage for the NetView control block ADX.
4008 X'FA8' The NetView display panel size (PDXDVSIZ) is less than 21 lines, or NetView
termination was in progress while attempting to enter the session monitor. The
display panel size for the NetView program must be at least 21 (24 minus 3) lines.
4009 X'FA9' DSIGET was unable to obtain storage for a send or default receive control queue
element, or for a default send or receive buffer.

Appendix A. Codes 787


Abend Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
4010 X'FAA' An unrecoverable full-screen panel failure occurred. One possible cause for this is
entering NLDM X at a terminal that does not have extended data support.
4011 X'FAB' DSIGET was unable to obtain enough storage for a temporary buffer.
4012 X'FAC' DSICES was unable to obtain temporary work storage.
4013 X'FAD' AAUCGTDA cannot get a record and issued a return code greater than 4.
4015 X'FAF' The page number was not found in the buffer.
4017 X'FB1' No NetView control block SWB was provided by NetView macro DSILCS.
4018 X'FB2' Abend caused by any one of the following:
• Because of an incorrect SYSGEN, a PIU that is too large is sent to the terminal.
• NLDM X is entered from a terminal that does not have extended data support.
Use NLDM instead of NLDM X.
• A permanent I/O error.
No dump is provided for this abend.
4019 X'FB3' AAUMHTM cannot create a required session monitor hash table during
initialization. The most probable cause is insufficient memory.
4020 X'FB4' DSIGET was unable to obtain storage for the AAUTDIB pool.
4021 X'FB5' Both screen buffers are active.
4022 X'FB6' AAUCGTDA cannot get a record and issued a return code greater than 4.
4023 X'FB7' AAUMGTD failed while trying to get the next logical data record because a bad
record identification was retrieved.
4024 X'FB8' AAUCRHTA failed to reset the hierarchy table and issued a nonzero return code.
4025 X'FB9' AAUCHUPA failed to update the hierarchy table and issued a nonzero return code.
4026 X'FBA' AAUCSNDA issued a nonzero return code because of a DSIMQS failure.
4027 X'FBB' DSIGET was unable to obtain storage for a temporary record buffer.
4031 X'FBF' There is a slot in the output buffer that is not valid.
4033 X'FC1' A named storage area was not found.
4036 X'FC4' The address of the presentation services module to receive control is unresolved in
the node table.
4047 X'FCF' AAUCMBSA cannot retrieve a message and issued a nonzero return code.
4048 X'FD0' AAUCHUPA failed to update the hierarchy table and issued a nonzero return code.
4050 X'FD2' There is no space in the NetView SCT control block for a verb.
4051 X'FD3' DSIGET failed during PSCP initialization.
4052 X'FD4' AAUPCPEX failed to load.
4053 X'FD5' A named storage area was not found.
4064 X'FE0' Session monitor control block corruption detected. Contact IBM Software Support
for programming assistance.

788 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Sense Codes

Table 1. NetView Abend Codes (continued)


Decimal Hex Explanation of the Abend
Code Code
4065 X'FE1' DSILOD failed to load module AAUDMMTA, AAUDBRPA, AAUDBINA, or the failing
load module name is in message AAU083I. Verify that the required modules,
panels, or tables are properly installed. Also, verify that the modules, panels, or
tables can be accessed by the NetView application.
4066 X'FE2' DSIGET cannot obtain storage for AAUTNDB.
4067 X'FE3' This abend is issued from AAUACMPA under one of the following conditions:
• A VSAM record type cannot be found in the table of valid record types.
• The calculated target address of a record expansion operation exceeds the limit
of the buffer.
This abend can be caused by a record on the session monitor VSAM database that
is not valid (or corrupt) or, less likely, a storage overlay of the in-storage record type
table. A dump (IDCAMS print) of the session monitor VSAM database is required to
diagnose this abend (in addition to the abend dump of the NetView address space.)
4068 X'FE4' Session monitor detected an active session control block chain that is not valid.
Contact IBM Software Support for programming assistance.
4070 X'FE6' A named storage area was not found.
4071 X'FE7' No free ADX control blocks are available.
4072 X'FE8' A function that is not valid was requested for internal queue processing.
4073 X'FE9' Module AAUAHNDA issues this abend when:
• It is driven with a DSRB containing zeroes in both the DSRBUSER and DSRBUBUF
fields.
• An ADX is found with both the ADXLCFLG and ADXVFLG flags set.

4082 X'FF2' AAUZDSPA is not driven under OST or PPT.


4083 X'FF3' The DSIGET macro is unable to obtain enough storage for the DSIMQS buffer.
4085 X'FF5' The DSIMQS macro is unable to obtain enough storage for the DSIMQS buffer or
the format of the buffer is not valid.
4086 X'FF6' The DSICES macro failed to transfer control because it cannot find the task
identification or the verb associated with it. DSICES issued a nonzero return code.
4087 X'FF7' The DSIFRE service routine cannot free storage that was obtained using the
DSIGET macro. DSIFRE issued a nonzero return code.
4088 X'FF8' The control flag of the logical record cannot be found.
4092 X'FFC' The DSIGET macro is unable to obtain enough storage.
4093 X'FFD' DSIGET was unable to obtain storage for NetView control block SCT.
4094 X'FFE' DSIGET was unable to obtain storage for NetView control block ADX.
4095 X'FFF' The DSICES macro cannot find a required session monitor command processor.
DSICES issues a nonzero return code.

Alias Sense Codes


This section lists the global and alias request sense codes.

Appendix A. Codes 789


Sense Codes

Global Sense Codes


Table 2. Global Sense Codes
Sense Description of Global Sense Code
Code
0000 Request processed successfully.
1002 Inconsistent length fields in RU or too many specific requests in a single RU.
1003 A request code that is not valid is in network services (NS) header.
0812 Insufficient resources to process request.
FFFF Internal system failure.

Specific-Request Sense Codes


Table 3. Specific-Request Sense Codes
Sense Description of Sense Code
Code
0000 Request processed successfully.
0004 Associated network ID for name to be translated is not specified or is not valid.
0008 Name type specified in request is not valid.
000C Name length specified in request is not valid.
0014 No table exists for the origin network ID for the name.
0018 No table entry exists within the origin network table for specified name.
001C No table entry exists within the origin network table for combination of input name and
destination network ID.
0020 No table exists for the destination of name network ID.
0024 Specific request entry length is too small.

LUC Conversation Request Service Return Codes and Sense Codes


Table 4 on page 790 lists and describes LUC conversation request service return codes displayed in
messages DUI170E, DUI172E, DUI173E, DUI175E, and DUI176E.

Table 4. LUC Conversation Request Service Return Codes


Retur Description of Return Code
n
Code
X'02' CNM DATA TASK IS NOT AVAILABLE
X'04' SESSION IS NOT AVAILABLE
X'06' RESOURCES/STORAGE UNAVAIL
X'08' RESOURCE ID INCORRECT
X'0C' PENDING REQUEST NOT COMPLETE
X'10' DEALLOCATE NORMAL

790 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Code Points

Table 4. LUC Conversation Request Service Return Codes (continued)


Retur Description of Return Code
n
Code
X'14' DEALLOCATE ABEND: MAPPING OF INBOUND FMH7 SENSE CODES 08640000, 08640001,
AND 08640002
X'18' DEALLOCATE PENDING
X'1C' CONVERSATION STATE ERROR
X'20' INCOMPLETE LL SENT
X'24' TPN DEFINED-NO TRUNCATION: MAPPING OF INBOUND FMH7 SENSE CODE 08890000
X'28' TPN DEFINED-NO TRUNCATION: MAPPING OF INBOUND FMH7 SENSE CODE 08890001
X'2C' SVC DEFINED-NO TRUNCATION: MAPPING OF INBOUND FMH7 SENSE CODE 08890100
X'30' SVC DEFINED-TRUNCATION: MAPPING OF INBOUND FMH7 SENSE CODE 08890101
X'34' ALLOCATION ERROR: MAPPING OF INBOUND FMH7 SENSE CODES 10086021, 10086031,
10086032, 10086034, 10086041, 10086042, 10086043, 084C0000, 080F6051, 10086044
X'36' TPNAME NOT AVAIL - RETRY REQUEST: MAPPING OF INBOUND FMH7 SENSE CODE 084B6031
X'FO' SYSTEM ERROR
X'FF' REQUEST NOT VALID

Use the SENSE command to obtain descriptions of the sense codes listed in Table 4 on page 790. See
NetView online help for information about the SENSE command.
Table 5 on page 791 lists and describes LUC macro failure return codes displayed in messages DUI171E,
DUI172E, and DUI174E.

Table 5. LUC Macro Failure Return Codes


Retur Description of Return Code
n
Code
X'04' INSUFFICIENT STORAGE
X'08' REPLPRC IS NOT VALID
X'0C' LUC FUNCTION NOT AVAILABLE
X'10' SEND DATA BUFFER LENGTH < = 0
X'14' RECEIVE DATA BUFFER LENGTH < = 0

Use the SENSE command to obtain descriptions of the sense codes listed in Table 5 on page 791. See
NetView online help for information about the SENSE command.

Generic Alert Code Points


This section contains a list of the generic alert code points that the NetView program provides. The code
points are divided according to the subvector or subfield that carries the code point.

If you want information Refer to


On the code points provided by the NetView Systems Network Architecture Formats
program and the generic alert architecture

Appendix A. Codes 791


Code Points

If you want information Refer to


On defining your own NetView code points IBM Z NetView Customization Guide

Code Point Format


Some code points have qualifier or product set identifier information embedded within the code point
text. The position of the qualifier or product set identifier is marked by a $ within the text.

Explanation of Code Point Formats


These alerts are formatted as code points and text. The code point is a 1- or 2-byte hexadecimal value,
unique to each text. The text is the message displayed on the panel.

Resource Types (X'05')


The X'05' common subvector flows in management services units (MSUs) to communicate resource
names between MS components in nodes. When flowing in an MSU to a focal point, the Hierarchy/
Resource List (HRL) includes the names of the resources of the domain hierarchy for the affected
resource. The HRL containing the complete domain hierarchy is built from configuration knowledge in
the control point, the transmission header, and, if present in the NMVT for which this CP-MSU is being
sent, data from the HRL (containing a partial domain hierarchy) or the SNA address list (X'04') subvector,
or both.
The HRL subvector also carries the hierarchy of control points that received, processed, and forwarded a
CP-MSU, and, in some cases, the names of one or more resources; for example, session partners logically
associated with the reported hierarchy.
To view a listing of both the displayed text for the code point (1–4 characters) and the actual meaning of
the abbreviation, access member BNJRESTY in data set BNJPNL2.

If you want information Refer to


On the format of code point 05 Systems Network Architecture Formats

Recommended Actions (X'81')


The X'81' subfield has unique recommended action codes. This subfield contains code points for stored
text describing recommended actions to be taken to rectify an alert condition.
Some code points have qualifier or product set identifier information embedded within the code point
text. To view a listing of Recommended Actions (X'81'), access member BNJ81TBL in data set BNJPNL1.

If you want information Refer to


On customizing recommended action panels IBM Z NetView Customization Guide
On the format of the X'81' subfield Systems Network Architecture Formats

Detail Data (X'82')


The X'82' subfield contains product-specific detailed data to be displayed at an alert receiver. To view
Detail Data (X'82'), access member BNJ82TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'82' subfield Systems Network Architecture Formats

792 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Code Points

Detail Data (X'85')


The X'85' subfield contains product-specific detailed data to be displayed at an alert receiver. To view
Detail Data (X'85'), access member BNJ85TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'85' subfield Systems Network Architecture Formats

Actual Actions (X'86')


The X'86' subfield contains actual actions data. These major vectors are logged to the hardware monitor
database. To view Actual Actions (X'86'), access member BNJ86TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'86' subfield Systems Network Architecture Formats

Generic Alert Data/Resolution Data (X'92')


The X'92' subvector transports alert information in the form of code points that correspond to strings of
text stored at the alert receiver. It also transports an alert ID number that uniquely identifies a particular
alert.
The X'92' subvector can have two versions of message text as follows:
• Full version message text
• Abbreviated version message text
The abbreviated version of message text appears on the Alerts panel. The full version of the message
text appears on the Detail panel. To view Generic Alert Data/Resolution Data (X'92'), access member
BNJ92TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'92' subvector Systems Network Architecture Formats

Probable Causes (X'93')


The X'93' subvector contains one or more code points denoting probable causes of the alert condition.
The probable causes appear in order of decreasing probability.
The X'93' subvector can have two versions of message text as follows:
• Full version message text
• Abbreviated version message text
The abbreviated version of message text appears on the Alerts panel. The full version of the message text
appears on the Detail panel. To view listing of Probable Causes (X'93'), access member BNJ93TBL in data
set BNJPNL1.

If you want information Refer to


On the format of the X'93' subvector Systems Network Architecture Formats

User Causes (X'94')


The X'94' subvector transports code points for stored text detailing the probable user causes for the alert
condition and the recommended actions to be taken in connection with these causes. This subvector can
also transport additional detailed data to be inserted into the text, or indexed by the user cause or the
recommended action code points, or both.

Appendix A. Codes 793


Code Points

Some code points have qualifier or product set identifier information embedded within the code point
text. To view a listing of User Causes (X'94'), access member BNJ94TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'94' subvector Systems Network Architecture Formats

Install Causes (X'95')


The X'95' subvector transports code points for stored text detailing the probable install causes for the
alert condition and the recommended actions to be taken in connection with these causes. This subvector
can also transport additional detailed data to be inserted into the text, or indexed by the install cause or
the recommended action code points, or both. An install cause is a condition that results from the initial
installation or setup of some equipment.
To view a listing of Install Causes (X'95'), access member BNJ95TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'95' subvector Systems Network Architecture Formats

Failure Causes (X'96')


The X'96' subvector transports code points for stored text detailing the probable failure causes for the
alert condition and the recommended actions to be taken in connection with these causes. This subvector
can also transport additional detailed data to be inserted into the text, or indexed by the failure cause or
the recommended action code points, or both.
Some code points have qualifier or product set identifier information embedded within the code point
text. To view a listing of Failure Causes (X'96'), access member BNJ96TBL in data set BNJPNL1.

If you want information Refer to


On the format of the X'96' subvector Systems Network Architecture Formats

794 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries.
Consult your local IBM representative for information on the products and services currently available in
your area. Any reference to an IBM product, program, or service is not intended to state or imply that
only that IBM product, program, or service may be used. Any functionally equivalent product, program, or
service that does not infringe any IBM intellectual property right may be used instead. However, it is the
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not give you any license to these patents. You can
send license inquiries, in writing, to:

IBM Director of Licensing


IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing


Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore,
this statement might not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
2Z4A/101
11400 Burnet Road

© Copyright IBM Corp. 1997, 2022 795


Austin, TX 78758
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases
payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by
IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any
equivalent agreement between us.
Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.

Programming Interfaces
This publication documents information that is NOT intended to be used as Programming Interfaces of
IBM Z NetView.

Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at
"Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml .
Adobe is a trademark of Adobe Systems Incorporated in the United States, and/or other countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or
its affiliates.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or
both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and service names might be trademarks of IBM or other companies.

Privacy policy considerations


IBM Software products, including software as a service solutions, (“Software Offerings”) may use cookies
or other technologies to collect product usage information, to help improve the end user experience,
to tailor interactions with the end user or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings can help enable you
to collect personally identifiable information. If this Software Offering uses cookies to collect personally
identifiable information, specific information about this offering’s use of cookies is set forth below.
This Software Offering does not use cookies or other technologies to collect personally identifiable
information.
If the configurations deployed for this Software Offering provide you as customer the ability to collect
personally identifiable information from end users via cookies and other technologies, you should seek
your own legal advice about any laws applicable to such data collection, including any requirements for
notice and consent.
For more information about the use of various technologies, including cookies, for these purposes,
See IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://
www.ibm.com/privacy/details the section entitled “Cookies, Web Beacons and Other Technologies”

796 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)


and the “IBM Software Products and Software-as-a-Service Privacy Statement” at http://www.ibm.com/
software/info/product-privacy.

Notices 797
798 IBM Z NetView: Messages and Codes Volume 1 (AAU-DSI)
IBM®

GC27-2856-10

You might also like