Messages CTMG00 through CTMGxx

This group includes messages for the Control-M for z/OS, Control-M/Assist, Control-M/Links for z/OS, and Control-M/Restart products.

CTMG00I ENTERPRISE/CS MAINFRAME GATEWAY STARTED

Explanation: This information message indicates a normal start of MVS Gateway for Enterprise Controlstation.

Corrective Action: No action is required.

CTMG01I ENTERPRISE/CS MAINFRAME GATEWAY TRACE LEVEL IS SET TO debugLevel

Explanation: This information message indicates that the Enterprise Controlstation Mainframe Gateway DEBUG level was set by an operator modify command (F).

The TRACE level is set to a new level. Each TRACE level activates the trace option on different components of the Enterprise Controlstation Mainframe Gateway.

Corrective Action: No action is required.

CTMG02E ENTERPRISE/CS MAINFRAME GATEWAY NOT APF-AUTHORIZED

Explanation: The Enterprise Controlstation Mainframe Gateway is not APF-authorized. The CTWGTW module is not in an APF-authorized library or does not have the AC attribute set to 1.

The Enterprise Controlstation Mainframe Gateway shuts down.

Corrective Action: Either add the library name in which CTWGTW resides to the IEAAPF00 member in SYS1.PARMLIB, or relink the module with the AC attribute set to 1.

CTMG03E INVALID MODIFY PARAMETER. VALID PARAMETERS ARE:

Explanation: An operator modify command (F) passed an erroneous parameter to the Enterprise Controlstation Mainframe Gateway. One or more GTWG25I messages are displayed on the operator console after this message, each containing a valid modify parameter.

The modify command is rejected.

Corrective Action: Enter a valid modify parameter.

CTMG04E BLDL/ATTACH FAILED FOR TASK modName

Explanation: Initialization of an IOA Gateway internal task failed. The system code indicating the exact reason can be found in the system log. Possible causes are:

• The modName module is not in the IOA Gateway Load library.
• Insufficient storage is available for the IOA Gateway.

The IOA Gateway shuts down.

Corrective Action: Call your system programmer for assistance. If necessary, increase the IOA Gateway REGION size.

CTMG05E UNRECOVERABLE ERROR ENCOUNTERED

Explanation: An unrecoverable error occurred in the operation of the Enterprise Controlstation Mainframe Gateway. The IOA Log, or the Enterprise Controlstation Mainframe Gateway JES messages file or SYSPRINT file, should contain a message with more details about the error. See also, CTWA01W.

The Enterprise Controlstation Mainframe Gateway shuts down.

Corrective Action: Call your system programmer for assistance. If the problem is not resolved, contact BMC Customer Support.

CTMG07I SHUT DOWN UPON REQUEST FROM OPERATOR

Explanation: This information message confirms that an operator command (P) was issued, requesting shutdown of MVS Gateway for Enterprise Controlstation. This message is followed by message GTWG20I, indicating completion of the shutdown.

MVS Gateway for Enterprise Controlstation starts to shut down.

Corrective Action: No action is required.

CTMG10E TRACE LEVEL MUST BE A NUMBER BETWEEN 0 AND 255

Explanation: An invalid TRACE level was entered, either in the operator modify command (F) or in the operator start command (S). When activating the Enterprise Controlstation trace facilities, specify a number from 0 through 255, inclusive, for the TRACE level. 0 specifies no tracing.

Corrective Action: Issue the command again with the correct TRACE level. The required TRACE level should be supplied by BMC Customer Support.

CTMG11I SERVICE ID "id" IS {ENABLED | DISABLED}

Explanation: This information message confirms the current enable or disable status of service ID, after the operator has issued an operator modify command (F) that enables or disables it.

Corrective Action: No action is required.

CTMG24E INTERVAL MUST BE A TWO-DIGIT NUMBER BETWEEN 03 AND 99 SECONDS

Explanation: Invalid Enterprise Controlstation Mainframe Gateway sleeping interval specified in an operator modify command (F). The Enterprise Controlstation Mainframe Gateway sleeping interval must be a two-digit number from 03 to 99 seconds.

The modify command is rejected.

Corrective Action: Enter a valid sleeping interval.

CTMG51E COMM GATEWAY INTERNAL ERROR. RC=rc

Explanation: An internal error occurred. A call to internal routine ECAPUT failed with return code rc.

The IOA Gateway shuts down.

Corrective Action: Contact your INCONTROL administrator.

CTMG52E INTERNAL ERROR: ASID=asid NOT FOUND

Explanation: An internal error occurred.

In this message, asid is the internal sequence number assigned to the server address space in which the error occurred.

The IOA Gateway shuts down.

Corrective Action: Contact your INCONTROL administrator.

CTMG53E OPEN OF DDNAME ddName FAILED

Explanation: An attempt to open a data set failed. The data set allocated by the specified DD name does not exist.

IOA Gateway shuts down.

Corrective Action: Determine why the data set allocated by the DD name in the startup procedure does not exist, fix the problem, and restart IOA Gateway.

CTMG63I DEALLOCATE SENT TO WORKSTATION GATEWAY ID=id APPLID=applId LU=luName

Explanation: This information message is issued during IOA Gateway shutdown or communication recycling. The deallocation was issued by the IOA Gateway APPLID applId. The corresponding partner or client LU is luName.

Corrective Action: No action is required.

CTMG65I DEALLOCATE RECEIVED FROM WORKSTATION GATEWAY ID=id APPLID=applId LU=luName

Explanation: This information message indicates that deallocation was issued by partner or client LU luName during communication re-cycling or shutdown initiated by the IOA Gateway. The corresponding IOA Gateway APPLID is applId.

Corrective Action: No action is required.

CTMG66W TPEND EXIT INVOKED. WORKSTATION GATEWAY ID=id APPLID=applId LU=luName REASON=rsn

Explanation: The connection between IOA Gateway APPLID applId and partner or client LU luName is being taken down by the VTAM operator.

Exit TPEND is invoked with a reason code of rsn. An attempt is made to recycle communication.

Corrective Action: See the VTAM programming manual for an explanation of TPEND reason codes. Take appropriate action based on the reason code.

CTMG67W ATTN LOSS EXIT INVOKED. WORKSTATION GATEWAY ID=id APPLID=applId LU=luName

Explanation: The connection between partner or client LU luName and IOA Gateway APPLID applId was lost. This message is followed by message COMG68I containing VTAM information.

The IOA Gateway attempts to restart communication.

Corrective Action: With message COMG68I, determine the cause of the connection disruption. Correct it, if possible. If necessary, call your VTAM system programmer for assistance.

CTMG68I RPL6SNSI=snsi RPL6RC=rc RPL6DETP=dept RPLSONCD=soncd

Explanation: This information message follows message COMG67I. It indicates that the connection between IOA Gateway and the partner/client was lost.

This message provides VTAM information for the VTAM system programmer. RPL6 fields are documented in the VTAM Programming for LU 6.2 manual, as follows:

• RPL6SNSI snsi - the section on VTAM sense codesSee also the VTAM messages and codes manual.
• RPL6RC rc - the appendix on return codes
• RPL6DEPT dept - at the end of ISTRPL6X DSECT (VTAM 3.3 and up)
• RPLSONCD soncd - the UNBIND Type Code, documented in the VTAM programming manual under the SCIP exit routine

Corrective Action: Determine the cause of the connection disruption and correct it.

CTMG71I PROBABLE VTAM IS HALTING

Explanation: This information message follows a message which indicates that a request from VTAM, such as an APPC command or an OPEN ACB command, failed. This message indicates that the probable reason for the failure is that VTAM is going down.

This message is followed by message COMG81I, COMG84I or COMG85I, which indicates the action that will be taken by IOA Gateway.

Corrective Action: No action is required.

CTMG72I PROBABLE APPLID NOT DEFINED

Explanation: This information message indicates that the probable reason for a VTAM request failure is that the APPLID specified in the OPEN ACB command is unknown to VTAM. It follows message COMG91W, which indicates that an OPEN ACB command has failed.

Possible causes are:

• The Major Node where the APPLID is defined was not activated.
• The APPLID defined to VTAM does not match the APPLID defined to IOA Gateway in the ECAPARM member.

This message is followed by message COMG83E, which indicates the action that will be taken by IOA Gateway.

Corrective Action: Activate the Major Node or correct the APPLID specification.

CTMG73I PROBABLE APPLID NOT DEFINED PROPERLY

Explanation: This information message indicates that the probable reason for the VTAM request failure is that the APPLID specified in the OPEN ACB is not a valid application definition, although it is known to VTAM. This could happen, for instance, if the APPLID defined to the IOA Gateway in the ECAPARM member is incorrect, but happens to match the name of another resource known to VTAM.

This message follows message COMG91W, which indicates that an OPEN ACB command has failed. It is followed by message COMG83E, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Correct the definition of the APPLID in the ECAPARM member.

CTMG74I PROBABLE ACB HAS ALREADY BEEN OPENED

Explanation: This information message indicates that the probable reason for the VTAM request failure is that the APPLID specified in the OPEN ACB command is already open and in use by another application.

Possible causes are:

• Another IOA Gateway with the same APPLID is already up.
• The APPLID defined to the IOA Gateway in the ECAPARM member is incorrect, but matches another APPLID definition.

This message follows message COMG91W, which indicates that an OPEN ACB command has failed. It is followed by message COMG85I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Correct the definition of the APPLID in the ECAPARM member, or take down one of the address spaces with the same APPLID.

CTMG75I PROBABLE APPLID DEACTIVATED

Explanation: This information message indicates that the probable reason for a VTAM request failure is that the APPLID was deactivated by a VARY NET,INACT command.

This message follows a message that indicates that a request from VTAM, such as an APPC command or an OPEN ACB command, failed. This message is followed by message COMG81I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Activate the APPLID.

CTMG76I PROBABLE VTAM IS NOT ACTIVE

Explanation: This information message indicates that the probable reason for a VTAM request failure is that VTAM is down.

This message follows message COMG91W, which indicates that an OPEN ACB command failed. It is followed by message COMG85I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: No action is required.

CTMG77I PROBABLE PARTNER DISCONNECTED

Explanation: This information message indicates that the probable reason for a VTAM request failure is that the conversation was lost due to abend or disconnection of the partner or client.

This message follows message COMG90E, which indicates that an APPC command has failed. It is followed by message COMG81I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Check the message issued by the partner or client and proceed accordingly.

CTMG78I PROBABLE CONNECTION LOST

Explanation: This information message indicates that the probable reason for a VTAM request failure is a communication disruption. This may be due to a resource failure on the route to the partner or client.

This message follows message COMG90E, which indicates that an APPC command has failed. It is followed by message COMG81I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Try to determine the cause of the communication disruption and correct it.

CTMG79I PROBABLE SESSION TERMINATED

Explanation: This information message indicates that the probable reason for a VTAM request failure is that a VTAM session termination occurred.

This message follows message COMG90E, which indicates that an APPC command has failed. It is followed by message COMG81I, which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Contact your INCONTROL administrator.

CTMG81I RE-START COMMUNICATION WILL BE ATTEMPTED

Explanation: This information message indicates that an attempt will be made to restart communication. Restarting communication involves preparing to receive a conversation allocation request from the partner or client LU, including opening the ACB if it is not already open.

This message follows other messages that provide details about an error that occurred.

The IOA Gateway attempts to restart communication.

Corrective Action: No action is required.

CTMG82I RE-CYCLE COMMUNICATION WILL BE ATTEMPTED

Explanation: This information message indicates that an attempt will be made to recycle communication. Communication is recycled when VTAM is going down or when the retry limit is exceeded. Recycling communication involves deallocating the conversation (if there is any), closing and then reopening the ACB, and preparing to receive a conversation allocation request from the partner or client LU.

This message follows other messages that provide details about an error that occurred.

The IOA Gateway attempts to recycle communication.

Corrective Action: No action is required.

CTMG83E THE COMM GATEWAY WILL BE SHUT DOWN

Explanation: This message indicates that the IOA Gateway will shut down. This message follows other messages that provide details about an error that occurred.

The IOA Gateway shuts down.

Corrective Action: If the shutdown is due to an error in the IOA Gateway, contact your INCONTROL administrator.

CTMG85I OPERATION WILL BE RE-ATTEMPTED AFTER ONE MINUTE

Explanation: This information message indicates that a failed operation will be retried until the retry limit is reached. This message follows other messages that provide details about an error that occurred.

The failed operation is retried. When the retry limit is exceeded, an attempt is made to recycle communication.

Corrective Action: No action is required.

CTMG90E APPCCMD appccmd FAILED. APPLID=applId R15=r15 R0=r0 RPL6RC=rc PARTNER LU=partner_lu

Explanation: An APPC command failed.

This message is followed by a message indicating the action that will be taken by the IOA Gateway. This message may be preceded by another message that provides more information about the error that occurred.

The following information in this message is for the VTAM system programmer:

• appccmd - Command that failed
• applId - APPLID that issued the failing command
• r15 - Register 15 returned by VTAM
• r0 - Register 0 returned by VTAM
• rc - RPL6RC returned by VTAM

The following fields are documented in the VTAM Programming for LU 6.2 Guide:

• APPCCMD - in the section on LU 6.2 macro instruction syntax and operands.
• RPL6RC - in the appendix on return codes.
• R0 and R15 - in the section on handling errors.

Corrective Action: If a second message gives a probable cause for the error, proceed according to the recommended User Response in that message. Otherwise, contact your VTAM system programmer.

CTMG91W OPEN ACB FAILED. APPLID=applId ACBERFLG=erflg

Explanation: An OPEN ACB command failed.

The following information in this message is for the VTAM system programmer:

• applId - APPLID that issued the failing command
• erflg - ACBERFLG returned by VTAM

Note:

ACBERFLG is documented in OPEN - Open One or More ACBs, ERROR Field, in the VTAM programming manual.

This message is followed by a message which indicates the action that will be taken by the IOA Gateway. This message may be preceded by another message which provides additional information about the error that occurred.

Corrective Action: If a second message gives a probable cause for the error, proceed according to the recommended user action for that message. Otherwise, contact your VTAM system programmer.

CTMG93W CLOSE ACB FAILED. APPLID=applId ACBERFLG=erflg

Explanation: A CLOSE ACB command has failed.

The following information in this message is for the VTAM system programmer:

• applId - APPLID that issued the failing command
• erflg - ACBERFLG returned by VTAM

Note:

ACBERFLG is documented in "CLOSE - Close One or More ACBs, ERROR Field", in the VTAM programming manual.

This message is followed by a message that indicates the action taken by the IOA Gateway.

Corrective Action: Determine the cause of the failure from ACBERFLG. If necessary, contact your VTAM system programmer.

CTMG94W SETLOGON FAILED. APPLID=applId R15=r15 R0=r0 RPLRTNCD=rtncd RPLFDBK2=fdbk2

Explanation: A SETLOGON command failed.

The following information in this message is for the VTAM system programmer:

• applId - APPLID that issued the failing command.
• r15 - Register 15 returned by VTAM.
• r0 - Register 0 returned by VTAM.
• rtncd - RPLRTNCD returned by VTAM.
• fdbk2 - RPLFDBK2 returned by VTAM.

The following fields are documented in the VTAM programming manual:

• RPLRTNCD
• RPLFDBK2
• R0, R15 - Chapter on handling errors and special conditions.

This message is followed by a message which indicates the action that will be taken by the IOA Gateway.

Corrective Action: Determine the cause of the failure from RPLRTNCD and RPLFDBK2. If necessary, contact your VTAM system programmer.

CTMG95E APPCCMD appc_cmd FAILED AFTER nn RETRIES. APPLID=applId PARTNER LU=partner_lu

Explanation: An APPC command failed after nn retries.

The following information in this message is for the VTAM system programmer:

• appc_cmd - Command that failed.
• applId - APPLID that issued the failing command.

This message is followed by a message which indicates the action that will be taken by IOA Gateway. This message may be preceded by another message providing additional information about the error that occurred.

The IOA Gateway attempts to recycle communications.

Corrective Action: If a second message gives a probable cause for the error, proceed according to the user action in that message. Otherwise, contact your VTAM system programmer.

CTMG96E APPCCMD SEND NOT COMPLETED WITHIN num MINUTES. APPLID=applId PARTNER LU=partner_lu

Explanation: A SEND operation was not completed within the specified number of minutes.

The IOA Gateway attempts to recycle communication.

Corrective Action: Contact BMC Customer Support.

CTMG97E GENCB FAILED. APPLID=applId R15=r15 R0=r0 RPLRTNCD=rplrc RPLFDBK2=fdbk2

Explanation: The IOA Gateway issued a GENCB macro to generate a control block, but the operation failed.

The following information in this message is for the VTAM system programmer:

• applId - APPLID that issued the failing command
• r15 - Register 15 returned by VTAM
• r0 - Register 0 returned by VTAM
• rtncd - RPLRTNCD returned by VTAM
• fdbk2 - RPLFDBK2 returned by VTAM

The following fields are documented in the VTAM Programming manual:

• RPLRTNCD
• RPLFDBK2
• R0, R15 - Chapter on handling errors and special conditions

The IOA Gateway shuts down.

Corrective Action: Use the diagnostic information in the message to determine the cause of the failure. Correct the problem accordingly.