Messages

This list contains messages produced by the components of the conversion tool, except those issued by the CTMBLT and CTMTLB utilities. Messages issued by these utilities are described in theINCONTROL for z/OS Messages Manual.

A message code usually consists of the following parts:

CTMZEKaa-nnx

where CTMZEK indicates that the message pertains to Control-M ZEKE conversion tool, and where:

Item

Explanation

aa

A 2-character identifier for the component that produced the message.

nn

A 2-character numeric identifier for the message.

x

A 1-character alphabetic identifier for the severity of the message.

Valid values are:

  • A: Action

  • E: Error

  • I: Information

  • S: Severe

  • W: Warning

Message descriptions contain any or all of the following:

Explanation: Description of the cause of the message, and other related information.

System Action: System action when this message is issued.

User Response: Recommended actions to correct the problem.

BLT895I JOB=jobname, KEYWORD=keywd

Explanation: This message is preceded by the BLT893I message. In relation to the general operation of the CTMBLT utility, both messages are explained in the INCONTROL for z/OS Messages Manual.

When the value of keywd is INTERVL-UNIT, the CTMBLT utility encountered the following:

  • INTERVAL=nnn (where nnn is a number exceeding 45)

  • INTERVAL-UNIT=D

This was created by the conversion tool from a ZEKE OCCURS clause in the form

EVERY nnn DAYS BEGINNING ...

Control-M does not support such criteria if the value of nnn is greater than 45. In such cases, you must perform the conversion manually.

Processing of the CTMBLT utility continues, and the utility terminates with a return code of 8.

User Response: Perform the conversion manually.

CTMZEK01-09E GENERIC STEP/PROC NAMES NOT SUPPORTED

Explanation: A stepname or a procname in the COND CODE section of the Main EVENTS Report (Part 1) contains an asterisk and one or more non-blanks. These generic stepnames and procnames are not supported by the conversion tool.

CTMZEK01-12E DAREP2 FILE ENDED PREMATURELY

Explanation: The CTMZEK01 program has read the ZEKE Main EVENTS report (Part 2) to end-of-file prematurely.

Most likely, the ZEKE Main EVENTS report (Part 2) has not been sorted on the same fields as the ZEKE Main LIST EVENTS report.

User Response: Rerun JOB0.

CTMZEK02-00I MESSAGES FOR jobname event_name table_name

Explanation: During the conversion process, at least one ZEKE feature could not be converted.

This information message serves as a header message for the following error messages that detail the problems encountered during conversion of a ZEKE feature.

CTMZEK02-01E COMPOUND NOT EXPRESSION (USING AND) NOT SUPPORTED

Explanation: In the analysis of the OCCURS clause of an event, a compound NOT expression contained an AND keyword, such as NOT (MAY AND DAY1).

System Action: The NOT expression cannot be properly converted. Processing of the OCCURS clause continues.

User Response: Manually convert the unprocessed or improperly processed keywords.

CTMZEK02-02E keywrd, INVALID COMBINATION OF (W)DAYS PARAMETERS

Explanation: In the analysis of the OCCURS clause of a job, the conversion tool encountered keywords that may be converted to an invalid combination of Control-M basic scheduling parameters. keywrd is the problematic keyword.

Most likely, the ZEKE events must be split into multiple Control-M jobs.

System Action: The ZEKE OCCURS keyword that corresponds to keywrd is not converted.

User Response: Examine the ZEKE OCCURS clause, and manually convert it to Control-M job scheduling definitions.

CTMZEK02-03W UNSUPPORTED OPTION: txt

Explanation: The possible causes for the issue of this message are:

  • The conversion tool does not support the txt ZEKE feature.

  • The conversion tool supports the txt ZEKE feature, but the proper conversion of the feature requires a calendar that was not defined in the ZEKE Calendar report.

System Action: The event containing the txt feature is not fully converted.

User Response: Complete the job conversion manually.

CTMZEK02-04E OPER= xx NOT SUPPORTED IN VAR STMT, "EQ" SUBSTITUTED

Explanation: In the analysis of a ZEKE WHEN clause of an event, a VAR expression contained a non-supported operator. The only operator supported by the conversion in VAR expression is 'EQ'.

System Action: The non-supported operator cannot be properly converted and is treated as if EQ were specified. Processing of the WHEN clause continues.

User Response: Determine if the action taken by the conversion is acceptable, otherwise, manually convert the improperly processed keywords.

CTMZEK02-05W MULTIPLE CTM JOB SCHEDULING DEFINITIONS MAY BE REQUIRED FOR OCCURS CLAUSE

Explanation: Due to the complexity of the ZEKE OCCURS clause, the conversion tool most likely will not be able to accurately convert the keywords to a single Control-M job scheduling definition.

Most likely, multiple Control-M job scheduling definitions will be required to properly convert the ZEKE OCCURS clause.

System Action: The event containing the OCCURS clause is not fully (or properly) converted.

User Response: Examine the OCCURS clause to determine if a manual conversion is necessary (perhaps into multiple job scheduling definition).

CTMZEK04-01E type-name NOT FOUND FOR XCOM cmd-name

Explanation: In analyzing an MSG, SCOM or ZCOM event, either the indicated job name, event number or event name in the MSG event or a ZSET or ZADD command could not be found in the ZEKE database.

System Action: The indicated job or event number or event name is not converted.

User Response: Manually convert the job or event number or event name.

CTMZEK04-02E UNSUPPORTED COMMAND cmnd FOUND IN COM

Explanation: An unsupported ZEKE command or parameter was found in a ZCOM or SCOM event. Currently, system commands and ZEKE ZSET, ZADD, ZHOLD, ZDISABLE, ZENABLE, ZREL, ZOK, ZDEL, and ZALTER DONE commands are supported in ZCOM and SCOM events. In addition certain ZEKE special name variables (LASTSTEP, LASTPG) are also not supported.

System Action: The SCOM or ZCOM command is not converted.

CTMZEK08-01E %% varname VARIABLE VALUE OVERFLOW

Explanation: An attempt to convert a ZEKE variable to Control-M format failed because the converted variable value contained too many characters. This may happen when ZEKE variables contain embedded blanks that the conversion tool replaces with '%%BLANKnn%%, which usually expands the length of the variable value.

System Action: The variable value is incompletely converted.

User Response: Manually convert the ZEKE variable to Control-M format.

CTMZEK08-02E %% varname IS RESERVE A-E VARIABLE

Explanation: A ZEKE variable was converted to Control-M format but the variable name is a Control-M reserved variable name.

System Action: The program continues processing.

User Response: The variable must be assigned a new name.

CTMZEK09-09I MODIFICATIONS WERE DONE TO MEMBER memb DSNAME lib

Explanation: An informational message indicating that the conversion tool modified the memb JCL member.

CTMZEK10-01E memb txt

Explanation: During conversion processing, a line in the memb JCL member could not be converted. txt is the JCL line in question.

Common problems encountered are as follows:

  • Unsupported ZEKE variables (such as the special names variable LASTSTEP, LASTPGM).

  • Unsupported ZEKE commands.

  • Unsupported ZEKESET statements (such as ON ERROR).

System Action: The indicated JCL line is not converted, but conversion processing continues.

User Response: If necessary, manually convert the indicated JCL line.

CTMZEK10-02E varname VARIABLE VALUE OVERFLOW

Explanation: An attempt to convert a ZEKE variable to Control-M format failed because the converted variable value contained too many characters. This may happen when ZEKE variables contain embedded blanks that the conversion tool replaces with '%%BLANKnn%%, which usually expands the length of the variable value.

System Action: The variable value is incompletely converted.

User Response: Manually convert the ZEKE variable to Control-M format.

CTMZEK10-03E memb JCL/DATA OVERFLOW FROM COL 71/80

Explanation: In converting a line in a JCL member, the conversion tool encountered data in column 71 (for lines beginning with //) or in column 80 (for lines not beginning with //), and this data will be lost.

When the conversion tool encounters a ZEKE $ variable or a constant appended to ZEKE Variable (such as $ABC.XYZ) the conversion tool converts the $ variable to a Control-M AutoEdit %% variable or to the AutoEdit Concatenation symbol %%. This action causes the JCL line in question to expand, which can potentially cause data at the end of the line to be lost.

System Action: Processing continues.

User Response: Examine the JCL line in question and manually ensure that no data is lost or truncated.

CTMZEK99-02E func FAILED FOR BLOCK blockname [MEMBER=memb DDNAME=ddname]

Explanation: The func MVS memory acquisition (GETMAIN) or free (FREEMAIN) function failed for the blockname block. The JCL REGION parameter specification is not large enough.

User Response: Increase the value of the REGION parameter for the failing step and rerun the job.

CTMZEKJC-00I jobname - MULTIPLE UCMD STEPS IN ONE JOB PROCESSED

Explanation: The multiple UCMD steps in the jobname job were processed as a single distributed job definition by combining the respective scripts in a single Embedded Script statement.

User Response: No action is required.

CTMZEKJC-04E jobname MULTIPLE UCMD STEPS IN ONE JOB PARTIALLY PROCESSED

Explanation: The multiple UCMD steps in the jobname job were not fully processed since the various steps involve different Node IDs or LOGON member names.

System Action: The scripts of the steps in the job are combined into a single Embedded Script statement until a different Node ID or LOGON member name is encountered, at which point processing is terminated for this job.

User Response: The user might need to manually create multiple distribute job definitions for this job.

CTMZEKJC-05E jobname &SYSUID NOT VALID VALUE FOR OWNER OPTION

Explanation: &SYSUID is not supported as a valid value substitution for the Control-M OWNER parameter.

User Response: Manually change the Control-M OWNER parameter for the jobname job or change the default for the OWNER option and rerun the conversion.