Messages

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

A message code usually consists of the following parts:

  • CTMJTxxx-nnS

    where CTMJT indicates that the message pertains to the Control-M JOBTRAC conversion tool, and where

    Item

    Explanation

    xxx

    3-character identifier of the program that produced the message.

    nn

    2-character numeric identifier for the message.

    S

    1-character alphabetic identifier for the severity of the message, as follows:

    • 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.

BLTnnnx ctmblt-message

Explanation: An error occurred in the CTMBLT utility. The CTMBLT utility is invoked during JOB1 of the conversion, to build job scheduling tables. For details of this utility, see the INCONTROL for z/OS Utilities Guide.

BLTnnn messages are generated by the CTMBLT utility, not by the conversion programs. nnn represents any message code issued by the utility. All BLT messages are individually documented and explained in the INCONTROL for z/OS Messages Manual.

System Action: The utility continues processing normally and terminates with a condition code of 8.

User Response: : Check the INCONTROL for z/OS Messages Manual for the meaning of the specific message, and perform the corrective action indicated. Then rerun the job, if necessary.

Message Series 1:

CTM89BE PLEASE SPECIFY MEMNAME

BLT893I CURRENT TABLE table-name LIBRARY schedule-lib-name indicate that a Jobtrac SCL member contains @BUSGRP/@SCHDID statements which will be used as the Control-M table name and that an empty Control-M table will be created under the SCL member name during the conversion process. This situation is not an error and may be ignored.

CTM89BE/BLT893I can also be ignored in the case that an SCL member (named in the BLT893I message) is empty or contains only comment statements.

Message Series 2:

BLT893I CURRENT TABLE table-name LIBRARY schedule-library

CTM391S INVALID COMBINATION OF PARAMETERS ENCOUNTERED

BLT895I JOB=CTMJOBPR, KEYWORD=TASKTYPE

The above series of messages indicates that a Jobtrac schedule type event was converted to the Control-M Started task CTMJOBPR. To correct this error, blank out the value specified for the OVERLIB parameter in the table-name Control-M table and in the CTMJOBPR job.

CTMJT001-10E scl mem SCL REFERBACK succ/pred UNSUPPORTD

Explanation: Predecessor and Successor schedule types (event names starting with 0) are not supported. If a schedule of this type is detected, the above message is issued and the schedules must be manually converted as outlined in 10. RELEASEn (SUCCESSOR and/or PREDECESSOR).

User Response: Manually convert the above entries.

CTMJT002-02W DOUBLE @-SIGN ENTRIES NOT SUPPORTED

Explanation: The EXCLPARM member in the CA-JOBTRAC TRACPARM library contains entries specifying exclusionary rules with double @-sign event prefixes. The conversion tool does not support these entries.

User Response: Manually convert the above entries.

CTMJT003-01E RESOURCE TABLE EXCEEDED

Explanation: The RESOURCE member in the CA-JOBTRAC TRACPARM library contains more than 250 entries.

User Response: Increase the MAXRES entry in the CTMJT003 program; rerun the ASMLINK and JOB1 jobs.

CTMJT003-00I mem, MEMBER PROCESSING STARTED

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

This informational message serves as the header message for any error messages that follow, which detail problems encountered during conversion of a CA-JOBTRAC feature.

CTMJT003-nnE txt NOT SUPPORTED [X]

Explanation: The conversion tool does not support the CA-JOBTRAC feature number nn, where nn is a 2-digit numeral, described in txt.

If X is included in the message, the process period specified in the text could not be converted due to a logical EXCEPT (X) relationship in the prior job record.

System Action: The event containing the unsupported option is not fully converted.

User Response: You must manually complete the job conversion.

CTMJT004-01E resrce_stmt UNSUPPORTED RESOURCE COND

Explanation: The resrce_stmt resource definition in the RESOURCE member of the CA-JOBTRAC TRACPARM library is not supported.

User Response: Manually convert the resrce_stmt resource definition.

System Action: The program continues processing.

CTMJT006-01E CCPF typeename NOT SUPPORTED

Explanation: The ename entry of the specified type (PROGRAM, STEPNAME, or PROCNAME) in the CA-JOBTRAC CCPF table could not be converted.

The ename entry is in a format that is not handled by the conversion tool. One of the following is true:

  • A program name other than * was specified.

  • A prefix and mask were specified for the step name.

  • A prefix and mask were specified for the procstep name.

System Action: The specified CCPF entry is not converted. The conversion program continues normally.

User Response: Correct and convert the specified CCPF entry manually.

CTMJT006-02W SET GLOBAL COND-CODE USING MAXCCOK

Explanation: The CCPF table entry specified an event name of *.

Specifying an asterisk as the event name in a CCPF table indicates that a global default condition code check must be implemented for all jobs.

This option is more efficiently performed by implementation of the MAXCCOK parameter. For more information on the MAXCCOK parameter, see the CTMPARM member in the IOA PARM library.

System Action: The conversion tool ignores the global entry and continues normal operation.

User Response: The Control-M default is that all condition codes less than or equal to 4 are considered OK. You can optionally change this default so that Control-M considers only steps ending with a condition code of 0 as OK, by setting the MAXCCOK parameter in the CTMPARM member in the IOA PARM library to 0.

CTMJT008-01E %% varname VARIABLE VALUE OVERFLOW

Explanation: An attempt to convert the varname CA-JOBTRAC variable to Control-M format failed because the converted variable value contained too many characters. This may happen when CA-JOBTRAC 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 CA-JOBTRAC variable to Control-M format.

CTMJT008-02E jmf-stmt NOT SUPPORTED

Explanation: A JMF statement in the JMFSYM01 member (or an alternate member) of the CA-JOBTRAC DATELIB library is not supported.

User Response: Manually convert the JMF statement.

System Action: The program continues processing.

CTMJT009-01I MODIFICATIONS WERE DONE TO MEMBER memname DSNAME lib

Explanation: An informational message indicating that the conversion tool modified the memname JCL member in the lib JCL library.

CTMJT010-05/06E txt, MEMBER=memname

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

Some common problems encountered are

  • I/D=SCHD AJO feature not supported

  • ADI original schedule date (OSD) feature not supported

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

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

CTMJT010-02E JCL LIBRARY IS EMPTY

Explanation: A JCL library specified in the JBTJCL DD statement has no members.

System Action: Program terminates.

CTMJT010-08W UTILITY GJTRVSCH ENCOUNTERED - CONVERT TO CTMJOB, MEMBER=memname

Explanation: During the conversion processing, the CA-JOBTRAC GJTRVSCH procedure was encountered in a JCL EXEC statement in the memname member.

System Action: The JCL EXEC statement is not converted, but conversion processing continues.

User Response: Manually convert the GJTRVSCH procedure to the Control-M CTMJOB utility, which performs an equivalent function.

It is your responsibility to ensure that the CA-JOBTRAC SCL pointed to by the SYSIN statement, or directly contained in the JCL job stream, is converted to a Control-M table or ORDER statement.

For more information about the CTMJOB utility, see the INCONTROL for z/OS Utilities Guide.

CTMJT010-03I END CONVERSION OF JCL LIBRARY

Explanation: The JCL library conversion has ended.

User Response: None.

CTMJT011-01E INCLIB RECORD CANNOT BE CREATED DUE TO DATE CODES, CNTRLNAM=mem

Explanation: In converting an ADI statement in the PRODDATE member of the CA-JOBTRAC DATELIB library, the conversion tool encountered date codes (\code) that would cause the line to overflow beyond column 80 after conversion.

System Action: Processing continues.

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

CTMJT012-01E ADR xxx yyy NOT SUPPORTED DSN=zzz

Explanation: A Jobtrac ADR (Automatic Dataset Recognition) feature is not supported by the conversion tool.

xxx can be one of the following:

  • PROCESSP - the processing period specified in the CREATE or TRIGGER PROCESS PE is not supported or the CREATE and TRIGGER processing periods do not match. In this case, yyy is the value of the PROCESSP causing the error.

  • ACT - the action code is not supported. Currently the only supported actions are RUN and DCNT. In this case, yyy is the value of the ACT causing the error.

zzz - the dataset name of the Jobtrac triggering rule

User Response: If necessary, manually modify or create the CTO rule.

CTMJT013-01E AMR xxx yyy NOT SUPPORTED MSG=zzz

Explanation: A Jobtrac AMR (Automatic Message Recognition) feature is not supported by the conversion tool.

xxx can be one of the following:

  • PROCESSP - the processing period specified in the PROCESS PE is not supported.

  • ACT - the action code is not supported. Currently the only supported actions are RUN, ALTR, RPLY, SUPP and CMD.

  • XCMD, XMSG, XALT - extended commands, messages and altered text lines are not supported.

  • DOCMD - an ACT=CMD text line was too long.

  • ALTOFFSET - non-zero altered text offset is not supported.

yyy - the value causing the error

zzz - the dataset name of the Jobtrac triggering rule

User Response: If necessary, manually modify or create the CTO rule.

CTMJT014-01E SCS xxx yyy NOT SUPPORTED CMD=zzz

Explanation: A Jobtrac SCS (System Command Scheduling) feature is not supported by the conversion tool.

xxx can be one of the following:

  • PROCESSP - the processing period specified in the PROCESS PE is not supported.

  • DOCMD - an ACT=CMD text line was too long.

yyy - the value causing the error

zzz - the dataset name of the Jobtrac triggering rule

User Response: If necessary, manually modify or create the CTO rule.

CTMJT099-02E func FAILED FOR area [MEMBER=memname DDNAME=ddname]

Explanation: An MVS memory acquisition (GETMAIN) or free (FREEMAIN) function failed for the specified area. This usually (but not always) occurs because 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.

CTMJTGAP-01E INTERNAL ERROR (rsn) IN PROCESSING, MEMBER=member_name

Explanation: Unsupported JCL syntax. An internal error with reason code (rsn) occurred while parsing the JCL containing the GJTRABTR utility in the member_ name member. The reason code (rsn) is intended for internal use only by BMC Customer Support.

System Action: Problematic member is skipped. The program continues processing.

User Response: Send the problematic member to BMC Customer Support for analysis.

CTMJTGAP-02E "DEP" PARAMETER VALUE IS NOT SUPPORTED, MEMBER=member_name

Explanation: While converting the JCL containing the GJTRABTR utility in the member_ name member, an unsupported value was used for the DEP parameter (only -Q is supported) in the MOD/POST command.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.

CTMJTGAP-03E A MANDATORY JOB PARAMETER IS MISSING, MEMBER=member_name

Explanation: A mandatory JOB parameter was missing, while converting the JCL containing GJTRABTR utility in the member_ name member.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.

CTMJTGAP-04E A VALUE USED FOR JOB NAME IS NOT SUPPORTED, MEMBER=member_name

Explanation: While converting the JCL containing the GJTRABTR utility in the member_ name member, an unsupported special symbol was detected in the job name.

System Action: Problematic member is skipped. The program continues processing.

User Response: Check input syntax of the member_ name member.

CTMJTGAP-05E MISSING PARAMETERS FOR JOBTRAC, MEMBER=member_name

Explanation: While converting the JCL containing the GJTRABTR utility in the member_ name member, an unsupported function was detected. Only ADD, MOD, POST, PURGE are supported.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.

CTMJTGAP-06E A SYSIN CARD STATEMENT IS NOT SUPPORTED, MEMBER=member_name

Explanation: While converting the JCL containing the GJTRABTR utility in the member_ name member, an unsupported SYSIN DD card was detected. The conversion only supports SYSIN statements from the input stream.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.

CTMJTGAP-07W DEP(-M) IS NOT SUPPORTED AND IS IGNORED, MEMBER=member_name

Explanation: The conversion process ignores the unsupported DEP(-M) parameter, while converting the JCL containing GJTRABTR utility in the member_ name member.

System Action: The program continues processing.

User Response: Check the input syntax of the member_ name member.

CTMJTGAP-08W PURGE WITH VERSION, PLEASE VERIFY, MEMBER=member_name

Explanation: Conversion process found PURGE with an unsupported version parameter, while converting the JCL containing the GJTRABTR utility in the member_ name member.

System Action: The program continues processing.

User Response: Check the input syntax of the member_ name member.

CTMJTGAP-09E JTRVSCH PARM1 MISSING, MEMBER=member_name

Explanation: The PARM1 parameter is missing when using the JTRVSCH procedure, while converting the JCL in the member_ name member.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.

CTMJTGAP-10E GJTRVSCH IS NOT SUPPORTED, MEMBER=member_name

Explanation: An unsupported GJTRVSCH program was found, while converting the JCL in the member_ name member.

System Action: Problematic member is skipped. The program continues processing.

User Response: Manually convert the member_ name member.