Messages NGTU200 through NGTU299

This topic contains messages for the BMC AMI Utilities.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

NumberDescription
NGTU200

UNABLE TO PARSE VERSION AND RELEASE LEVEL string-1.

Explanation: The keyword VR in the parameter list to the BMC AMI Utilities Interactive REXX Exec NGTUTILI changes the ISPF Application ID. For example, VR(31) or VR(3.1) will set the value to SU31. The value string-1 is unacceptable.

User response: Either omit the keyword VR and its value, or provide a value of one or two digits.

NGTU201

PLEASE REENTER AS, FOR EXAMPLE, 'CDBUTILI VR(31)'.

Explanation: This message follows NGTU200. See the description of that message.

User response: This message follows NGTU200. See the action for that message.

NGTU202

String-1 (string-2)UNACCEPTABLE.

Explanation: String-1 is one of the keywords to the BMC AMI Utilities Interactive REXX exec NGTUTILI that allow you to set the names for the data sets it allocates. The value provided, string-2, is unacceptable.

User response: Execution of NGTUTILI continues, so no action is required. The next time you run NGTUTILI, either omit the keyword and take the default, or correct the keyword. The values of JOB, SYSPRINT, UTLPARMS and so on (which set the final qualifier) and of each part of DSNBODY (which sets the middle of the data set name) must each be 1-8 alphanumeric characters, the first of which may not be numeric.

NGTU203

UNLOADEXIT:  string-1 INITIALIZED FOR TABLE:  tableName

Explanation: The BMC AMI Unload user exit module named string-1, is initialized for the indicated table.

User response: No action is required.

NGTU204

ORDER YES IGNORED DUE TO ORDER BY OPTION

Explanation: BMC AMI Unload detected the ORDER YES option and an ORDER BY clause and ignored the ORDER YES option.

User response: BMC AMI Unload continues processing while ignoring the ORDER YES option.  Remove the ORDER YES option to avoid this message.

NGTU205

UNLOADEXIT:  string-1 DISCARDED number-1 ROW(S) AND SET STEP COND CODE to number-2.

Explanation: After BMC AMI Unload passed all table rows to the unload user exit module named string-1, the user exit module discarded number-1 rows and set the STEP CONDITION CODE to number-2.

User response: No action is required 

NGTU206

UNLOADEXIT:  string-1 RETURNED TERMINATION ERROR - RC=number-1.

Explanation: The BMC AMI Unload user exit module named string-1 returned a return code > 8 indicating a request to discontinue any further BMC AMI Unload processing.

User response: A return code > 8 from an unload user exit indicates a severe error was detected by the unload user exit.  Contact the source code of the unload user exit to determine the type of error detected.

NGTU207

string-1.

Explanation: The BMC AMI Unload user exit module returned one or more messages (string-1) to be printed.

User response: These messages are generated by the unload user exit, contact the source code of the unload user exit to determine what response, if any is desired.

NGTU208

UNLOADEXIT MODULE string-1 NOT FOUND.

Explanation: The unload user exit module specified as the UNLOADEXIT keyword could not be found in the current load library concatenation. The unload job could not continue and was terminated.

User response: Modify the load library concatenation to refer to the library that contains the specified UNLOADEXIT module or modify the unload statement to refer to an existing unload user exit module for the current load library concatenation. Rerun the job.

NGTU209

UNLOADEXIT: string-1 PROCESSED number-1 ROW(S).

Explanation: After BMC AMI Unload passed all table rows to the unload user exit module named "string-1", the user exit module processed "number-1" row(s) and BMC AMI Unload wrote them to the output data set.

User response: No action is required.

NGTU210

ALTER 'string-1' -

Explanation: A data set rename attempted from string-1. The new name will be reported in message NGTU211. Rename failures if any will be reported by message NGTU212.

User response: None unless NGTU212 is issued.

NGTU211

NEWNAME(string-1)

Explanation: A data set rename attempted to string-1 from name specified in message NGTU210. Rename failures if any will be reported by message NGTU212.

User response: None unless NGTU212 is issued.

NGTU212

RENAME FAILED RC=number-1 REASON CODE=number-2

Explanation: This message indicates a rename failure has taken place for the data sets reported by messages NGTU210 and NGTU211. number-1 number-2 are the return code and reason code for the failure.

User response: The return code and reason code are documented by IBM message IDC3009I, except reason 227, which indicates that the new name already exists. Correct the problem and rerun the JOB.

NGTU213

WHEN "INFILE ddname" IS USED, ONE OR ALL PARTS MUST BE SELECTED

Explanation: When INFILE ddname is used (where ddname is a valid JCL DD name), you can specify only a selection of one partition or all partitions.

User response: Use the PART keyword, correctly specify one or all partitions and rerun the job. 

NGTU214

LOCATE FAILED RC=number-1 REASON CODE=number-2

Explanation: This message indicates a getvol failure has taken place for the data set reported by messages NGTU213. number-1 and number-2 are the return code and reason code for the failure.

User response: The return code and reason code are documented by IBM message IDC3009I. Please refer to the instructions associated with message IDC3009I. Correct the problem and rerun the JOB.

NGTU215

VTOC READ ERROR, string-1, RC=hexstring-1, string-2, string-3.

Explanation: An error has occurred while reading the DSCB via the OBTAIN macro service. String-1 is the requested format of the DSCB. x''Hexstring-1'' is the return code from the macro service. String-2 is the VOLSER on which the VTOC exists. String-3 is the associated DSNAME.

User response: Lookup the error code in the 'DFSMS/USING ADVANCED SERVICES DATASETS' reference manual in the section titled 'DADSM OBTAIN RETURN CODES'. Attempt to correct the error or contact BMC Support.

NGTU216

string-1 DELETED

Explanation: The names data set was deleted. If this is a cluster, then the data data set was also deleted.

User response: No action is required.

NGTU217

string-1 DELETE FAILED

Explanation: The named data set was not deleted.

User response: Check JESMSGLG for error information and contact BMC Support.

NGTU218

XTEND ERR DD=string-1 Extend return and reason codes.

Explanation: An error has occurred while extending a VSAM data set using the MMSRV Macro. The exact reason for the failure is documented by a prior IEC070I or IEC161I message. This message is of interest to BMC Support.

User response: If there are IEC messages, lookup the messages in the IBM manual. If Not, contact BMC Support.

NGTU219

SORTVOLS=string-1 SPECIFIED, SO VOLUME SERIAL string-2 SELECTED FOR ALTER ADDVOLUMES COMMAND

Explanation: For DB2-managed objects, indicates the volume serial to be used in the following ALTER ADDVOLUMES command, according to the SORTVOLS value indicated.

User response: No action is required.

NGTU220

UNABLE TO CONVERT NULL CHARACTER STRING TO NUMERIC

Explanation: A BMC AMI Utilities attempted to convert a character string to a numeric value, but the character string had a length less than zero.

User response: Search the job output for related messages to determine where the empty character string originated.

NGTU222

NEED DSN (string-1) HELD BY (string-2) ON (string-3)

Explanation: UTILITY switch processing needs exclusive control of the above named data set which is currently held by the indicated job name on the designated system.

User response: No action is required.

NGTU223

LOAD STATEMENT FOR DD=ddName IN DSN(dataSetName)

CR=creatorName

TB=tableName

Explanation: This message confirms that BMC AMI Unload has written the load control cards and specifies their data definition name and data set name location.

User response: No action is required.

NGTU230

ALLOCATE F (string-1) DSN(string-2)

Explanation: This message describes the characteristics of a dynamically allocated sequential data set (for example, a COPY data set).

User response: No action is required.

NGTU231

UNIT(string-1) SPACE(number-1,number-2) MAXVOL(number-3) string-2 string-3 string-4 string-5

Explanation: This message describes the characteristics of a dynamically allocated sequential data set (for example, a COPY data set).

User response: No action is required.

NGTU232

STORAGE CLASS = string-1

Explanation: This message describes the characteristics of a dynamically allocated sequential data set (for example, a COPY data set).

User response: No action is required.

NGTU233

MANAGEMENT CLASS = managementClass

Explanation: This message describes the characteristics of a dynamically allocated sequential data set (for example, a COPY data set).

User response: No action is required.

NGTU234

DATA CLASS = dataClass

Explanation: This message describes the characteristics of a dynamically allocated sequential data set (for example, a COPY data set).

User response: No action is required.

NGTU235

textFromExit.

Explanation: The automation control point or user exit issues this message via the _PRTMSG or _PRTERR command and writes it to CDBPRINT. In most cases, this message is customer-provided text.

User response: No action is required.

NGTU236

WAITING ON string-1 string-2

Explanation: This message is issued when a resource is not available and a wait will be issued.

User response: No action is required.

NGTU237

WAIT ENDED string-1 string-2

Explanation: This message is issued when a resource is not available and a wait has been issued and completed.

User response: No action is required.

NGTU238

string-1 PARAMETER'S VALUE CHANGED BY XSUTGLOB EXIT (OLD =string-2 AND NEW =string-3)

Explanation: Because the BMC AMI Automation exit routine XSUTGLOB was invoked, the default value for the parameter specified by string-1 changed from string-2 to string-3.

User response: No action is required.

NGTU240

QUEUE VALUE hexstring-1 NOT FOUND

Explanation: This message is issued when a call specifies a queue value that is not valid for the product.

User response: This is an internal logic error. It will be followed by a S0C3 abend. Call BMC Support.

NGTU241

+SYSINORDER(HONOR) IN USE. MERGING OF COMMON STATEMENTS CANNOT BE PERFORMED.

Explanation: Because the +SYSINORDER(HONOR) was specified, BMC AMI Unload does not merge common statements. Merging common BMC AMI Unload SYSIN statements can improve performance through the use of parallelism. 

User response: No action is required.

NGTU242

STATEMENT MERGE CANNOT PROCEED. NOT ALL UNLOAD STATEMENTS HAVE COMPLETED PRE-PROC. WILL RETRY.

Explanation: BMC AMI Unload cannot merge common SYSIN statements because not all statements have been preprocessed. BMC AMI Unload will retry merging common SYSIN statements. 

User response: No action is required.

NGTU243

DSN(string-1) RENAMED TO 'string-2'

Explanation: This message is issued after a successful rename of a data set representing a db2 table space or index object. The new name can be derived by substituting the 1st character of the 5th qualifier of the above named DSN with the renamed 'TO' character.

User response: No action is required.

NGTU244

OUTPUT TO TAPE USING OUTPUT NAME LONGER THAN 6 CHARS (string-1) WILL IGNORE DDNCOUNT number-1

Explanation: Because the specified name exceeds six characters, the UNLOADDDN with DDNCOUNT of number-1 is ignored.

User response: Correct the specified UNLOADDDN value and rerun the job.

NGTU245

OUTPUT TO TAPE FOR string-1 REQUIRES TAPE UNIT ALLOCATION

Explanation: The OUTPUT statement identified by string-1 does not specify the required TAPE UNIT allocation. Unload processing terminates with an error.

User response: Correct the allocation for the OUTPUT statement, and rerun the job.

NGTU246

OUTPUT string-1 ASSIGNED TO TAPE UNIT DD(string-2) STMT(number-1) IC(number-2) FSEQ(number-3) STATUS(string-3)

Explanation: The requested ddname string-1 was assigned to tape unit ddname string-2 with statement number and file sequence. string-3 represents a set of internal flag values.

User response: No action is required.

NGTU247

TRANSLATION FROM CCSID dataCcsid TO targetCcsid IS UNSUPPORTED FOR columnName

Explanation: BMC AMI Unload detected an error when attempting to use DIRECT NO and translation from dataCcsid to targetCcsid for the indicated column.

User response: Correct the targetCcsid specified in the CCSID option and rerun.

NGTU250

'USELRECL YES' IGNORED DUE TO 'string-1' OPTION.

Explanation: BMC AMI Unload ignores USELRECL YES if any of the following options is specified :

  • FORMAT UNLOAD
  • FORMAT CSV
  • FORMAT INTERNAL
  • FORMAT DELIMITED

User response: To honor USELRECL YES, you must specify either FORMAT STANDARD, FORMAT EXTERNAL, or FORMAT DSNTIAUL. Adjust the SYSIN statement and resubmit the job.

NGTU251

DIRECT AUTO NOT SUPPORTED WITH UNLOAD TABLESPACE. DIRECT YES IN EFFECT FOR databaseName.tableSpaceName

Explanation: BMC AMI Unload natively processes the use of UNLOAD TABLESPACE with DIRECT AUTO. Therefore, specification of DIRECT YES is in use for the indicated database or table space name.

User response: No action is required.

NGTU252

DIRECT string1 IN EFFECT FOR:
CR= creatorName 
TB= tableName

Explanation: This message indicates whether DIRECT YES or DIRECT NO is in effect for the indicated object.

User response: No action is required.

NGTU272

DB2 'string-1' SERVICE FAILED. CONTACT BMC SUPPORT

Explanation: An attempt to perform the above named internal DB2 function has failed. This is probably due to unavailable resource. Check the system log for a possible DSNT500I message.

User response: Correct the error and rerun your utility again or contact BMC Support.

NGTU273

INSTALL ERROR. moduleName LOAD MODULE NOT FOUND

Explanation: The BMC AMI Utilities product that you are running attempted to load the indicated module, but could not find it. This module is required.

User response: Verify that your STEPLIB or JOBLIB contains the required load libraries. Rerun the job step.

NGTU274

INSTALL ERROR. SCC SPE LEVEL (X'SPELevel') DOES NOT MEET REQUIREMENTS

Explanation: The BMC AMI Utilities product that you are running requires a later SPE level of the BMC DB2 Solution Common Code component (SCC) than is available on your system. This message displays the SCC SPE level that is available on your system.

User response: Verify that your STEPLIB or JOBLIB contains the correct SCC load library, and that all SCC maintenance has been applied. Rerun the job step. Contact BMC Support if you need assistance.

NGTU276

INSTALL ERROR. SCC VERSION (versionNumber) DOES NOT MEET REQUIREMENTS

Explanation: The BMC AMI Utilities product that you are running requires a later version of the BMC DB2 Solution Common Code component (SCC) than is available on your system. This message displays the SCC version that is available on your system.

User response: Verify that your STEPLIB or JOBLIB contains the correct SCC load library. Rerun the job step. Contact BMC Support if you need assistance.

NGTU289

UNABLE TO REPLICATE SELECT selectNumber , reasonText

Explanation: The command replication processor issues this message for the indicated SELECT number SELECT number n when a regeneration is bypassed for one  of the following reasons:

  • MULTIPLE SELECT NOT USED WITH UNLD
  • BYPART IS INELIGIBLE
  • EXCLUDE IS INELIGIBLE
  • DIRECT NO IS INELIGIBLE
  • COPY IS INELIGIBLE
  • NON-PARTITIONED IS INELIGIBLE
  • PBG IS INELIGIBLE
  • NUMBERED SYSREC INELIGIBLE

User response: No action is required.

NGTU290

UNABLE TO LOCATE type ddname FOR SELECT selectNumber

Explanation: In this message:

  • type is either SELECT or DD.
  • ddname is the required SELECT statement DD.
  • selectNumber is the number of the SELECT statement.

User response: No action is required.

NGTU291

ALL UNLOADS TO DDNAME ddname ARE MARKED IN ERROR DUE TO A PRIOR ERROR

Explanation: An error occurred while BMC AMI Unload was unloading one SELECT statement in a group of related SELECTs. Because these SELECT statements use the same SYSREC or SYSRED data sets, all SELECT statements in the group are marked in error. For a list of the SELECT statements in error, see the OBJREPRT output.

User response: Correct the original error and rerun the unload.

NGTU292

OUTPUT ddName CAN'T BE USED FOR PARTITIONED OBJECT FOR SELECT selectNumber.

Explanation: In this message:

  • ddname is the required SE:LECT statement DD.
  • selectNumber is the number of the SELECT statement.

User response: No action is required.

NGTU294

ERROR BUILDING LOAD COMMAND IN string-1

Explanation: BMC AMI Unload encountered an error while generating LOAD statements for the specified ddname.

User response: Search the job output for related messages to determine the cause of the error.

NGTU293

COMMAND REGENERATED BY phase

Explanation: The first line of this message identifies the issuer of the command regeneration. The phase is either MULTIPLE SELECT or NUMBERED SYSREC. Subsequent lines of this message contain the regenerated command.

User response: No action is required.

NGTU295

LOCATING type IMAGE COPIES for database.tableSpace

Explanation: BMC AMI Utilities is locating image copies of the specified type for the indicated database and table space.

User response: No action is required.

NGTU296

IMAGE COPY FOR TIMESTAMP time IS type AND WILL NOT BE USED

Explanation: You may receive this message for one of the following reasons:

  • You specified a SHRLEVEL REFERENCE but BMC AMI Utilities found a suitable SHRLEVEL CHANGE image copy before finding a SHRLEVEL REFERENCE copy.
  • BMC AMI Utilities found a concurrent copy and does not support this type.

This message will be followed by message NGTU299.

User response: If you want to use the latest image copy, specify SHRLEVEL CHANGE.

NGTU297

DUE TO DSNUM=0 COPY, PARTITION part WILL NOT USE IMAGE COPY

Explanation: BMC AMI Utilities found a suitable copy for partition part but also found a DSNUM=0 copy first, and will not use the partition level copy. This message will be followed by message NGTU299 indicating the image copy that is not being used.

User response: If you want to use the partition level image copy, specify the individual PART in a separate UNLOAD command.

NGTU298

IMAGE COPY FOR TIMESTAMP time WILL BE USED FOR PARTITION part

Explanation: Suitable image copies were found for partition part with the indicated timestamp. This message will be followed by message NGTU299.

User response: No action is required.

NGTU299

DSN dataSet, database.tableSpace

Explanation: The image copy shown is for the indicated database and table space. This is a secondary message, associated with other informational messages.

User response: No action is required.

Was this page helpful? Yes No Submitting... Thank you

Comments