Getting Started
2.3
This documentation and related computer software program (hereinafter referred to as the Documentation) is for the end users informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (CA) at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies. This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the users responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed. To the extent permitted by applicable law, CA provides this documentation as is without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage. The use of any product referenced in this documentation and this documentation is governed by the end users applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. Provided with Restricted Rights as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
Contents
Contents
iii
A-1
Appendix B: Troubleshooting
Message Codes ................................................................ B-1
Index
iv
Getting Started
Chapter
Technical Support
For further technical assistance with this product, please contact Computer Associates Technical Support at http://esupport.ca.com/ for a complete list of locations and phone numbers. Technical support is available 24 hours a day, seven days a week.
11
Chapter
Minimum Requirements
This section identifies the minimum requirements on the target system and the mainframe that are necessary to install the product.
Target System
The minimum hardware and software requirements for the target system are as follows:
s s s
Platform: OS/390 Hardware: No specific requirements Software: Installation of Unicenter Framework for OS/390 version 2.2 and components CAIENF and CAICCI
21
Mainframe
The following software is required on the mainframe:
s s
TCP/IP (IBM or Interlink) CA90s Services Genlevel 9712 or higher, or Unicenter Common Services for UNIX - CAIRIM - CAICCI - CAIENF - CA-C Runtime
2 2
Getting Started
LNKLST Concatenation
LNKLST Concatenation
Unicenter AutoSys Connect Option does not require a LNKLST location to operate, although LNKLST can be used if your installation standards require it. It is not necessary because these modules are not used by any other applications. Additionally, using STEPLIB in the started procedure JCL will reduce the number of modules to search through in the LNKLST.
Dispatching Priority
We recommend that dispatching priority be set above batch processing and equal to noncritical online systems.
2 3
Chapter
Mainframe Installation
This chapter provides the step-by-step procedures to install the product on the mainframe.
2.
Mainframe Installation
31
3.
Unload the remaining libraries. Customize and submit install library member X01RST to restore the other libraries. Catalog the procedure. Customize and submit install library member X02PROCC to add the CACONNCT procedure to your installation procedure library. Create and customize batch scheduler JCL. The product uses a batch interface for scheduling jobs through all mainframe schedulers. For each supported scheduler there is a member in {install}.PARMLIB. The syntax of the member names for the scheduler JCL is:
ATCJxxx
4.
5.
where xxx specifies the three-byte scheduler identifier. Each ATCJxxx member contains sample JCL that must be customized. Refer to the batch interface documentation in the Unicenter AutoSys User Guide for the appropriate scheduler for batch interface JCL. See the appendix Initiating Jobs on a Mainframe for a list of valid scheduler identifiers. 6. Update the CAIENF database. SAMPJCL member XO3ENFJ defines events to CAIENF and makes them active. CAIENF must be shut down to run the job. Follow the directions in the SAMPJCL member to tailor the job, and then submit it. The job should end with a return code of zero. Note: Do not restart CAIENF until you complete Step 7. 7. Update the CAIENF startup options. SAMPJCL member XO4ENFR contains sample CAIENF startup options. XO4ENFR may be merged into the existing CAIENF startup options. Use care, since this may not be the only Computer Associates product using CAIENF. For information on the CAIENF startup options, see the Unicenter Framework for OS/390 Administrator Guide.
3 2
Getting Started
8.
Update the CAICCI startup options. Prior to starting the option, which utilizes the Common Communications Interface (CCI), you must add the SYSID and PROTOCOL command statements to the CCIPARM member (created during the OS/390 Framework installation). This is necessary to allow CCI (running on the mainframe) to communicate with its counterpart on the distributed platform. For example:
SYSID(MVSNODE) PROTOCOL(TCPIPGW,7000,01,MVSNODE)
where SYSID is a 1-8 character identifier that is unique throughout the CAICCI network, and PROTOCOL is used to specify the communications protocol supported by this local host node and its associated network parameters to access remote CAICCI nodes. Refer to your OS/390 Framework documentation for additional details on the individual operands of the PROTOCOL statement. You must ensure that you have executed installation member W010LINK contained within your OS/390 Framework installation sample JCL library. This link JCL member creates the CCI Gateway load module required for cross-platform communication. 9. Start CAIENF. Start (or restart) CAIENF. If you are restarting CAIENF, use the REINIT option:
S CAIENF,,,REINIT
10. Start the started task using the OS/390 command START CACONNCT. Ensure that you are executing ATCMAIN. The product runs as a started task in the OS/390 system; therefore, it must be started after each IPL. The started task procedure is placed into a PROCLIB during system installation. The product initializes for processing and stays active until the started task is terminated.
Mainframe Installation
3 3
Startup Options
Startup Options
This section discusses how to enable various job-specific functions by setting startup options. Enable these options after completion of the installation. The following options are discussed:
s s s
Monitoring OPC jobs Specifying Debug level Managing Unicenter AutoSys Connect Option-monitored jobs
Enabling this option ensures that jobs submitted outside of the OPC scheduling application are ignored, and not erroneously reported back to Unicenter AutoSys.
3 4
Getting Started
Startup Options
See the following table for a description of the Debug levels. For a complete list of message codes, see the appendix Troubleshooting. Debug Level 0 1 (Default) 2 3 4 5 6 7 8 9 Messages No messages are received. All Error and Warning messages, and some Informational messages. Agent-related messages. Includes messages from all prior levels. CCI notification and job initiation-related messages. Includes messages from all prior levels. Dependency request and application-related messages. Includes messages from all prior levels. Job processing-related messages. Includes messages from all prior levels. Processing console command messages. Includes messages from all prior levels. Event occurrence messages. Includes messages from all prior levels. Includes messages from all prior levels. Includes messages from all prior levels.
The Debug level can also be changed from the operator console with the following command:
/F{connect_started_task},DEBUG=n
Mainframe Installation
3 5
Startup Options
Setting Up the XCCODE Member To enable the product to report a specified job as failed, you must specify the JOB and/or JOBSTEP parameters in the XCCODE option.
where:
jobname
Specifies the name of the job. To create a comment line, enter an asterisk (*). Any line with an asterisk in this space is ignored in processing. Specifies the comparison operator for the return code: EQ Equal NE Not equal LT Less than LE Less than or equal GT Greater than GE Greater than or equal
operator
value
3 6
Getting Started
Startup Options
Conditions specified in the JOB parameter are compared with the final return code of a specified job. If the conditions are not met, the job is reported to have failed.
where:
jobname
Specifies the name of the job. To create a comment line, enter an asterisk (*). Any line with an asterisk in this space is ignored in processing. Specifies the name of the step. Specifies the comparison operator for the return code: EQ Equal NE Not equal LT Less than LE Less than or equal GT Greater than GE Greater than or equal
stepname operator
value
Specifies the value (0 to 4095) to compare to the return code. A job/step combination might match more than one line. The most specific line is considered a match, and the other lines are ignored. The sequence of the lines has no effect on the results, so they may be entered in any order. For example, all of the following lines match job PPR235 step CKEOJ. The second line is the most specific because it matches only one job/step combination. The second line is considered to be a match.
JOB JOB JOB JOB PPR235 PPR235 * * STEP STEP STEP STEP * CKEOJ OKEOJ * RC RC RC RC GT GT GT GT 0 12 0 0
Mainframe Installation
3 7
Startup Options
After locating the matching line, the option tests for the condition RC operator value. If the condition is true, the job is treated as JOBFAIL. If no matching line is found, the condition code is compared to the value of the JOB parameter. If the condition code is greater than that value, the job is treated as JOBFAIL. If the member contains a line with JOB * STEP *, that line matches any job/step combination not matched by any other line, and the JOB option is never used.
Examples Example 1: PPR235 is JOBFAIL if step EOMTBLD completes with RC higher than 4.
JOB PPR235 STEP EOMTBLD RC GT 4
Example 3: PRKA0140 is JOBFAIL if step S022 completes with RC higher than 0 or if step S040 completes with RC 24 or if any other step completes with RC higher than 4.
JOB PRKA0140 JOB PRKA0140 JOB PRKA0140 STEP S022 STEP S040 STEP * RC GT 0 RC EQ 24 RC GT 4
Activating the XCCODE Member To enable the XCCODE parmlib member for use, you must specify the XCCODE keyword in the PARM field on the PGM statement of the started task JCL as follows:
//CONNECT EXEC PGM=ATCMAIN,PARM=XCCODE
3 8
Getting Started
Startup Options
2.
3.
Mainframe Installation
3 9
Appendix
Operator Commands
Commands
Command STOP taskname F taskname DEBUG=n Description Brings the started task down. Sets the debugging level, where n is a number from 0 to 9. The volume of debugging messages increases as the debugging level increases. Displays a list of agents from which a ping message has been received. Displays a list of dependencies (jobnames) being monitored for execution.
Operator Commands
A1
Commands
Description Enables a refresh (update) of the specified storage, where operand can be PARMLIB, ATCJCL, or XCCODE. PARMLIBRefreshes private storage with any updated parmlib member. This includes all batch interface JCL members and the XCCODE parmlib member. ATCJCLRefreshes batch interface JCL private storage. XCCODERefreshes XCCODE private storage.
F taskname XCDLIST
Displays a list of XCCODE entries used to determine whether a job should fail based on job or jobstep condition code.
A 2
Getting Started
Appendix
Troubleshooting
This appendix contains message codes for Unicenter AutoSys Connect Option. Use the following list of messages as a resource for troubleshooting purposes.
Message Codes
The syntax of the Unicenter AutoSys Connect Option message codes is:
ATCxxxxC
where xxxx is a 4 -digit identifier and C specifies the type of message as follows:
s s s
ATC0001E
REQUEST AD FAILED - DATA COUNT IS ZERO An Add Dependency (external reference) request was formatted incorrectly.
ATC0002E
REQUEST AD FAILED - DATA LENGTH IS ZERO An Add Dependency (external reference) request was formatted incorrectly.
Troubleshooting
B1
Message Codes
ATC0003E
An attempt to add a dependency to the dependency array failed. Check the log to determine why the Add Dependency failed.
ATC0050E
ADD AGENT FAILED FOR NODE {nodename} - GETMAIN ERROR An attempt to add an agent to the agent array failed because a getmain call failed. Obtain an agent list report (see AGTLIST operator command) to determine the number of agents in the array. Each array entry is 32 bytes long. If the agent list report shows no errors, you may need to increase storage allocated to the started task.
ATC0051W
ADD AGENT IGNORED FOR NODE {nodename} DUPLICATE KEY An attempt to add an agent to the agent array failed because the agent already exists. This should never occur during normal operations and indicates a processing error. Obtain an agent list report (see AGTLIST operator command) and contact tech support.
ATC0052I
ADDED AUTOSYS AGENT ON NODE {nodename} PROCESS {processname} An attempt to add an agent to the agent array completed. The product keeps track of each agent pinging it. This informational message prints when the debugging level is >= 2
ATC0101E
FILTER PROCESSING FAILED GETMAIN ERROR An attempt to allocate working storage during filter processing failed. This error condition results in the shutdown of the started task. The user may need to increase storage allocated to the started task.
B 2
Getting Started
Message Codes
ATC0201E
UNRECOGNIZED CCI FUNCTION REQUESTED A call was made to the CCI function routine with invalid parameters. This should not occur during normal operations and represents a processing error.
ATC0202E
CCI SERVICES INITIALIZATION FAILED An attempt to initialize CCI services failed. Check previous messages in the log for an associated message. This should not occur during normal operations and could represent a processing error or setup error. Verify CCI is correctly installed and running on the mainframe side and contact tech support.
ATC0203I
HOST NODE IS {nodename} An attempt to initialize CCI services completed successfully and CCI node name is displayed as {nodename} in the message. This informational message appears in the beginning of the log when CCI services are initialized.
ATC0204I
CCI SERVICES HAVE BEEN INITIALIZED An attempt to initialize CCI services completed successfully. This informational message appears in the beginning of the log when CCI services are initialized.
ATC0251W
UNRECOGNIZED OPERATOR COMMAND An unrecognized operator command was entered for the started task. The command is ignored. This warning message indicates the operator command entered was not valid.
Troubleshooting
B 3
Message Codes
ATC0252W
DEBUG OPERATOR COMMAND FAILED INVALID DEBUGGING LEVEL The debug operator command was entered for the started task with an invalid debugging value. Valid debugging levels are 1-9. The command is ignored and the debugging level does not change. This warning message indicates the operator command entered was not valid.
ATC0253W
UNRECOGNIZED MODIFY OPERATOR COMMAND A modify operator command was entered for the started task but was not recognized. The command will be ignored. This warning message indicates the operator command entered was not valid.
ATC0254I
PROCESSING CONSOLE COMMAND This informational message is printed when an operator command is received. This message prints when the debugging level is >=6.
ATC0255I
STOP COMMAND ISSUED This informational message is printed when a stop operator command is received. The stop command shuts down the started task.
ATC0256I
DEBUGGING LEVEL IS SET TO {debuglevel} A debug operator command was entered and processed. The debugging level has been changed to debuglevel.
ATC0301E
NO DEPENDENCY FOUND FOR {jobname} The dependency for jobname was not found. A delete dependency request was sent from Unicenter AutoSys for a dependency that was not found in the dependency array. This can also be a processing error. Contact tech support if Unicenter AutoSys did not enter a delete dependency request.
B 4
Getting Started
Message Codes
ATC0302E
FIND DEPENDENCY FAILED A call to the dependency find routine failed. Check prior log messages to determine the cause. This can occur during processing of a delete dependency request from Unicenter AutoSys.
ATC0303E
DELETE DEPENDENCY FAILED A call to the dependency delete routine failed. Check prior log messages to determine the cause. This can occur during processing of a delete dependency request.
ATC0304I
DELETED DEPENDENCY FOR JOB {jobname} FOR NODE {nodename} A call to the dependency delete routine completed successfully for jobname sent from nodename. This can occur during processing of a delete dependency request. This informational message prints when the debugging level is >=4.
ATC0351E
ADD DEPENDENCY FAILED FOR JOB {jobname} GETMAIN ERROR An attempt to add a dependency to the dependency array failed because a getmain call failed. Obtain a dependency list report (see AGTLIST operator command) to determine the number of dependencies in the array. Each array entry is 64 bytes long. If the dependency list report shows no errors, the user may need to increase storage allocated to the started task.
ATC0352W
ADD DEPENDENCY IGNORED FOR JOB {jobname} DUPLICATE KEY An attempt to add a dependency to the dependency array failed because the dependency already exists. This warning message indicates an attempt to add a duplicate dependency. Obtain a dependency list report (see DEPLIST operator command).
Troubleshooting
B 5
Message Codes
ATC0353I
ADDED DEPENDENCY FOR JOB {jobname} FOR NODE {nodename} An attempt to add a dependency to the dependency array completed successfully. This addition occurred because of a start job request or an add dependency request from Unicenter AutoSys. This information message prints when the debugging level is >=4.
ATC0354I
AUTO-ADDED DEPENDENCY FOR JOB {jobname} FOR NODE {nodename} An attempt to add a dependency to the dependency array completed successfully. This addition is for the batch interface job that starts the job requested in the start job request from Unicenter AutoSys. This informational message prints when the debugging level is >=4.
ATC0401E
DELETE DEPENDENCY FAILED - INDEX IS NEGATIVE An attempt to delete a dependency from the dependency array failed because the specified index is negative. This is a processing error and should not occur during normal processing. Contact tech support.
ATC0402E
DELETE DEPENDENCY FAILED - INDEX IS PAST END OF ARRAY An attempt to delete a dependency from the dependency array failed because the specified index is past the end of the array. This is a processing error and should not occur during normal processing.
ATC0601E
UNRECOGNIZED ENF FUNCTION REQUESTED A call was made to the ENF function routine with invalid parameters. This should not occur during normal operations and represents a processing error.
B 6
Getting Started
Message Codes
ATC0602E
ENF INIT FAILED - ENF NOT ACTIVE An initialize call was made to the ENF function routine but ENF is not active. Verify that ENF is installed and running.
ATC0603E
ENF INIT CALL FAILED An initialize call was made to the ENF function routine but ENF is not active. Verify that ENF is installed and running.
ATC0604E
ENF STATUS CALL FAILED An initialize call was made to the ENF function routine, but ENF is not active. Verify that ENF is installed and running.
ATC0605I
ENF SERVICES HAVE BEEN INITIALIZED An initialize call was made to the ENF function routine and it completed successfully. This is an informational message.
ATC0606E
ENF LISTEN CALL FAILED - ENF IS INACTIVE A listen call was made to the ENF function routine but ENF is not active. Verify that ENF is installed and running.
ATC0607E
ENF LISTEN CALL FAILED A listen call was made to the ENF function routine but it failed. Verify that ENF is installed and running.
ATC0608E
ENF DATA CALL FAILED A data call was made to the ENF function routine but it failed. Verify that ENF is installed and running.
ATC0609E
FILTER PROCESSING FAILED A call to the filter processing routine failed. This should not occur during normal operations and represents a processing error.
Troubleshooting
B 7
Message Codes
ATC0610E
FIND DEPENDENCY ROUTINE FAILED A call to the find dependency routine failed. This should not occur during normal operations and represents a processing error.
ATC0611I
EVENT {eventname} OCCURRED FOR {jobname} - {jobnumber} This message is printed every time an ENF event occurs. This informational message is printed when the debug level is >= 7.
ATC0612I
PROCESSING {eventname} FOR {jobname} - {jobnumber} This message is printed every time an ENF event occurs and there is a dependency for the jobname. This informational message is printed when the debug level is >= 7.
ATC0613I
ENF INTERFACE HAS BEEN TERMINATED This informational message indicates that the interface to ENF services has been terminated.
ATC0651E
ENF GET CALL FAILED This message occurs when an ENF GET call has failed. This should not occur during normal operations and represents a processing error.
ATC0652E
ENF HAS TERMINATED - AUTOSYS CONNECT IS SHUTTING DOWN This message indicates that the product has detected that ENF is not running. The product shuts down if ENF is not running.
ATC0653I
PROCESSING ENF EVENT This message indicates that an ENF event is being processed because there is a dependency for this ENF event. This information message prints when the debugging level is >=5.
B 8
Getting Started
Message Codes
ATC0655I
DELETED DEPENDENCY FOR JOB {jobname} FOR NODE {nodename} A call to the dependency delete routine completed successfully for jobname sent from nodename. This can occur after a JOBTERM event for a dependency. This informational message prints when the debugging level is >=5.
ATC0701E
UNRECOGNIZED EVENT - {eventname} An attempt to send an event to Unicenter AutoSys has failed because the event is not recognized. This should not occur during normal operations and represents a processing error.
ATC0702E
SEND EVENT FAILED An attempt to send an event to Unicenter AutoSys has failed. This error can occur if CCI services are not available. Verify CCI is running. This should not occur during normal operations and represents a processing error.
ATC0703I
SENDING EVENT {eventname} TO NODE {nodename} An event is being sent to the agent residing on nodename. This informational message prints when the debugging level is >=3.
ATC0751E
ALLOCATION OF ATCPARM DD FAILED The product is attempting to read the JCL used as the batch interface to one or more mainframe schedulers, and was unable to dynamically allocate the ATCPARM DD. Verify the started procedure has an ATCPARM DD statement and the ATCPARM DD is allocating a valid data set.
ATC0752E
FIND FOR JCL MEMBER FAILED The product is attempting to read the JCL used as the batch interface to one or more mainframe schedulers. A FIND command failed. Verify that the ATCPARM DD is allocating a valid data set.
Troubleshooting
B 9
Message Codes
ATC0753E
GETMAIN ERROR READING JCL The product is attempting to read the JCL used as the batch interface to one or more mainframe schedulers. A GETMAIN failed. Allocate more storage to the started task.
ATC0754I
JCL ADDED MEMBER=membername Indicates that a batch JCL member has been read from the parmlib dataset and is now resident in memory for use. The membername in the message indicates which JCL member was loaded. This informational message prints when the debugging level is >=6.
ATC0801E
INTERNAL READER ALLOCATION FAILED An attempt to allocate an internal reader to be used to submit jobs to the various mainframe schedulers using a batch interface has failed. This should not occur during normal operations and represents a processing error.
ATC0802E
INTERNAL READER OPEN FAILED An attempt to allocate an internal reader to be used to submit job to the various mainframe schedulers using a batch interface has failed. This should not occur during normal operations and represents a processing error.
ATC0803W
COMMAND TEXT WAS TRUNCATED The command text was truncated while substituting the command text into the skeleton JCL. The product is attempting to submit a scheduler batch interface job for a start job request. Truncation can occur because the command text was too long. Check the length of command text.
ATC0851E
AUTOSYS/AUTOSYS CONNECT IS SHUTTING DOWN This message indicates that the option is shutting down. This may occur because of a processing error or the operation STOP command.
B 10
Getting Started
Message Codes
ATC0852E
UNRECOGNIZED PARAMETER ENCOUNTERED {parmname} This message indicates that an unrecognized parameter was found. Parameters are specified with the PARM keyword in the started task JCL. The unrecognized parameter is displayed as {parmname} in this message. Check the started task for an invalid parameter.
ATC0853E
UNRECOGNIZED DEBUG VALUE This message indicates that the option has found an unrecognized debugging level specified with the debug parameter. The debug parameters are specified with the PARM keyword in the started task JCL. Valid debugging values are 1-9. Check the started task for an invalid debugging level specified with the debug parameter.
ATC0854I
PROCESSING INPUT PARAMETERS This information message indicates that the input parameters are being processed. Parameters are specified with the PARM keyword in the started task JCL.
ATC0855E
DEBUGGING LEVEL IS SET TO {debuglevel} This informational message indicates that the debug parameter was specified and processed. The debugging level has been changed to {debuglevel}.
ATC0856I
FILTERING IS ENABLED FOR {schedulername } This informational message is indicates that the filter parameter was specified and processed. Filtering has been enabled for the scheduler {schedulername}.
Troubleshooting
B 11
Message Codes
ATC0857I
XCCODE PROCESSING IS ENABLED This informational message indicates that the xccode parameter was specified and processed. XCCODE processing has been enabled.
ATC0858E
CCI INITIALIZATION FAILED An attempt to initialize CCI services failed. This should not occur during normal operations and could represent a processing error or setup error. Verify CCI is correctly installed and running on the mainframe side and contact tech support.
ATC0859E
ENF INITIALIZATION FAILED An attempt to initialize ENF services failed. This should not occur during normal operations and could represent a processing error or setup error. Verify ENF is correctly installed and running on the mainframe side and contact tech support.
ATC0860E
OPC PIF INITIALIZATION FAILED An attempt to initialize OPC PIF services failed. This should not occur during normal operations and could represent a processing error or setup error. Verify OPC is correctly installed and running on the mainframe side and contact tech support.
ATC0861E
LINK TO MODULE ATCJCLR FAILED An attempt to link to module ATCJCLR failed. This should not occur during normal operations and could represent a setup error. Verify the ATCJCLR module is available to the started task and contact tech support.
ATC0862E
LINK TO MODULE ATCXCDR FAILED An attempt to link to module ATCXCDR failed. This should not occur during normal operations and could represent a setup error. Verify the ATCXCDR module is available to the started task and contact tech support.
B 12
Getting Started
Message Codes
ATC0863I
AUTOSYS/CONNECT {version} INITIALIZATION COMPLETE This informational message indicates that initialization of the started task is complete. Agent requests can now be processed, and dependencies can be monitored.
ATC0864I
AUTOSYS/CONNECT SHUTDOWN COMPLETE This informational message indicates that the shutdown processing of the started task is complete.
ATC0901E
RECEIVE BUFFER IS EMPTY Message processing has detected an empty CCI received buffer. The received message is ignored. This should not occur during normal operations and represents a processing error.
ATC0902E
RECEIVE BUFFER LENGTH IS INVALID Message processing has detected an empty CCI received buffer. The received message is ignored. This should not occur during normal operations and represents a processing error.
ATC0903E
START JOB REQUEST FAILED A start job request from an agent has failed. Check the job log to determine the cause of the failure.
ATC0904E
ADD DEPENDENCY REQUEST FAILED An add dependency (external reference) request from an agent has failed. Check the job log to determine the cause of the failure.
ATC0905E
DELETE DEPENDENCY REQUEST FAILED A delete dependency request from an agent has failed. Check the job log to determine the cause of the failure.
Troubleshooting
B 13
Message Codes
ATC0906E
AUTOSYS AGENT PING FAILED A ping request from an agent has failed. Check the job log to determine the cause of the failure.
ATC0907E
UNRECOGNIZED REQUEST IGNORED - {request} The product has received an unrecognized request, which it is ignoring. This should not occur during normal operations and represents a processing error.
ATC0908E
PROCESSING CCI MESSAGE The option has received a message from an agent. This informational message prints when the debugging level is >=3.
ATC0909I
REQUEST {requestcode} RECEIVED FROM NODE {nodename} The product has received request code from an agent on nodename. This informational message prints when the debugging level is >=4.
ATC1001E
UNRECOGNIZED OPC REQUEST, ABENDING The product has received an OPC request and is abending. This should not occur during normal operations and represents a processing error.
ATC1002E
LINK TO EQQYCOM (OPC PIF) FAILED An attempt to link to module EQQYCOM failed while trying to initialize the interface. This module is the OPC PIF module. Verify the EQQYCOM module is available to the started task and contact tech support.
ATC1003E
OPC PIF INIT CALL FAILED, RC = X {returncode} An initialize call was made to the OPC PIF and the call failed with a return code of {returncode}. Verify that OPC PIF is installed and available.
B 14
Getting Started
Message Codes
ATC1004I
OPC PIF HAS BEEN INITIALIZED An initialize call was made to OPC PIF and it completed successfully. This is an informational message.
ATC1005E
LINK TO EQQYCOM (OPC) FAILED An attempt to link to module EQQYCOM failed while trying to retrieve a list of OPC job. This module is the OPC PIF module. Verify the EQQYCOM module is available to the Connect started task and contact tech support.
ATC1006E
OPC PIF LIST CALL FAILED, RC = X {returncode } A list call was made to the OPC PIF and the call failed with a return code of {returncode}. Verify that OPC PIF is installed and available.
ATC1007E
OPC PIF PROCESSING ERROR, ABENDING While processing the output of an OPC PIF list call, the product encountered a processing error, and is abending for diagnostic purposes. This is a processing error and should not occur during normal processing. Contact tech support.
ATC1008E
OPC PIF SELECT CALL FAILED, RC = X {returncode } A select call was made to the OPC PIF and the call failed with a return code of {returncode}. Verify that OPC PIF is installed and available.
ATC1009I
OPC PIF LIST RETURNED X {entrycount } A list call was made to the OPC PIF and the call returned a list of length {entrycount}.
ATC1051E
UNRECOGNIZED SCHEDULER REQUESTED {schedulername} REQUEST IGNORED The product is processing a start job request and the scheduler requested is not supported. The start job request is ignored.
Troubleshooting
B 15
Message Codes
ATC1052E
NO JCL FOUND FOR SCHEDULER {schedulername} The product is unable to find a batch interface JCL member in the dataset allocated to ATCPARM in the started task during processing of a start job request. The start job request is ignored.
ATC1053E
COMMAND TEXT INVALID FOR SCHEDULER {schedulername} START FAILED FOR JOB {jobname} Invalid command text was encountered during the processing of a start job request. The start job request is ignored.
ATC1054E
INTERNAL READER SUBMIT FAILED FOR {jobname} An attempt to submit a batch job to the internal reader during processing of a start job request has failed. The start job request is ignored. Check the job log to determine the cause of the failure.
ATC1055E
ADD DEPENDENCY FAILED FOR {jobname} An attempt to add a dependency for a job during processing of a start job request has failed. The start job request is ignored. Check the job log to determine the cause of the failure.
ATC1056I
SUBMITTED {jobname1} FOR {jobname2} The product is processing a start job request and submitted jobname1 to start jobname2. This informational message prints when the debugging level is >=4.
ATC1057E
INTERNAL ERROR DATA COUNT IS ZERO FOR {jobname} An error was encountered during processing of a start job request. This should not occur during normal operations and represents a processing error.
B 16
Getting Started
Message Codes
ATC1058E
NO COMMAND OR COMMAND TEXT FOUND FOR {jobname} An error was encountered during processing of a start job request. This should not occur during normal operations and represents a processing error.
ATC1059E
GENERATE COMMAND TEXT FAILED FOR SCHEDULER {schedulername} START FAILED FOR {jobname} An error was encountered during processing of a start job request. This should not occur during normal operations and represents a processing error.
ATC1101E
XCCODE PROCESSING FAILED NO ENTRIES An attempt to perform xccode processing has failed because there are no xccode conditions specified. This should not occur during normal operations and represents a processing error.
ATC1102I
XCCODE SETTING JOBFAIL JOBSTEP CONDITION The status of this job is being set to JOBFAIL because of an xccode jobstep condition. This informational message prints when the debugging level is >=5.
ATC1103I
XCCODE SETTING JOBFAIL JOB CONDITION The status of this job is being set to JOBFAIL because of an xccode job condition. This informational message prints when the debugging level is >=5.
ATC1104I
XCCODE ENTRY BEST MATCH COMPARING RC An XCCODE condition entry that matches the current job being processed has been found. The return code of the step or job is compared against the XCCODE condition entry. This informational message prints when the debugging level is >=5.
Troubleshooting
B 17
Message Codes
ATC1105I
XCCODE SETTING SUCCESS JOB CONDITION The status of this job is being set to SUCCESS because of an XCCODE jobstep condition. This informational message prints when the debugging level is >=5.
ATC1151E
ALLOCATION OF ATCPARM CC FAILED An attempt to read the xccode member used to specify xccode conditions has failed, and the product was unable to dynamically allocate the ATCPARM DD. Verify the started procedure has an ATCPARM DD statement and the ATCPARM DD is allocating a valid data set.
ATC1152E
UNABLE TO LOCATE XCCODE MEMBER An attempt was made to read the XCCODE member used to specify xccode conditions. A FIND command failed. Verify that the XCCODE member appears in the dataset allocated by the ATCPARM DD in the started task JCL.
ATC1153E
FIND FOR XCCODE MEMBER FAILED An attempt was made to read the XCCODE member used to specify xccode conditions. A FIND command failed. Verify that the XCCODE member appears in the dataset allocated by the ATCPARM DD in the started task JCL.
ATC1154E
GETMAIN ERROR READING XCCODE MEMBER An attempt to read the XCCODE member into working storage because a getmain call failed. The user may need to increase storage allocated to the started task.
ATC1155E
XCCODE JOB KEYWORD NOT FOUND An attempt was made to parse the XCCODE member used to extract the xccode conditions, but XCCODE parsing did not find a job keyword. XCCODE parsing expects the job keyword to be the first keyword for an xccode condition. Verify that all xccode conditions contain a job keyword and that each condition is contained in only one line of the XCCODE member.
B 18
Getting Started
Message Codes
ATC1156E
XCCODE JOBNAME NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find a jobname. XCCODE parsing expects the jobname to follow the job keyword. Verify that all xccode conditions contain a jobname and that each condition is contained in only one line of the XCCODE member.
ATC1157E
XCCODE STEP KEYWORD NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find a step keyword. Verify the xccode conditions that are specified in the XCCODE member.
ATC1158E
XCCODE STEPNAME NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find a stepname value. XCCODE parsing expects the stepname value to follow the step keyword. Verify that all xccode conditions contain a stepname and that each condition is contained in only one line of the XCCODE member.
ATC1159E
XCCODE RC KEYWORD NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find an rc keyword. XCCODE parsing expects the rc keyword to follow the jobname or stepname value in a xccode condition. Verify that all xccode conditions contain an rc keyword and that each condition is contained in only one line of the XCCODE member.
Troubleshooting
B 19
Message Codes
ATC1160E
XCCODE OPERATOR NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find an operator. XCCODE parsing expects the operator to follow the rc keyword in a xccode condition. Verify that all xccode conditions contain operators and that each condition is contained in only one line of the XCCODE member.
ATC1161E
XCCODE VALUE NOT FOUND An attempt to parse the XCCODE member used to extract the xccode conditions was made, but XCCODE parsing did not find a value. XCCODE parsing expects the value to follow the operator in a xccode condition. Verify that all xccode conditions contain values and that each condition is contained in only one line of the XCCODE member.
ATC1162E
XCCODE CONDITION NOT ADDED - GETMAIN ERROR An attempt to read add a xccode condition to working storage failed because a getmain call failed. The user may need to increase storage allocated to the started task.
ATC1163E
ATCLXCD LIST NODE ENTRY ADDED Indicates an XCCODE condition was read from parmlib member XCCODE and is now resident in memory for XCCODE evaluation. This informational message prints when the debugging level is >=6.
ATC1201W
XCCODE NOT ENABLED REFRESH IGNORED An operator REFRESH command was issued for XCCODE, but the option is not enabled. Refresh processing is terminated.
ATC1202I
PROCESSING operator_command This informational message indicates the operator command being processed.
B 20
Getting Started
Message Codes
ATC1203I
REFRESH COMMAND COMPLETE An operator REFRESH command has been issued. The command operation has completed successfully. This is an informational message.
ATC1204E
REFRESH COMMAND FAILED An operator REFRESH command has been issued. The command operation has failed. Please see preceding messages in the operator console for information on why the command failed.
Troubleshooting
B 21
Appendix
AutoSys Machine
Hostnameguava Operating SystemUNIX Software InstalledCCI, AutoSys 3.5.1 Parameter Configuration: AUTOSYS=/opt/autotree/tst/autosys AUTUSER=/opt/autotree/tst/autouser AUTOSERV=ACE
Mainframe
Hostnamehoneydew Operating SystemOS/390 Software InstalledENF, Connect
The tutorial proceeds in the following order, and should be performed in its entirety: 1. 2. 3. Configure CCI. Start or restart CCI. Enable Unicenter AutoSys cross-platform scheduling support.
C1
Configure CCI
4. 5. 6.
Install client license key for mainframe (OS/390) machine. Define the option machine to Unicenter AutoSys. Submit command jobs to mainframe.
Configure CCI
To configure CCI: 1. 2. Log in as root (to edit the CCI configuration files). Configure the CCI remote daemon by opening the ccirmtd.prf file. The file is found in the following location:
$CAIGLBL0000/cci/config/guava/ccirmtd.prf
Note: For detailed syntax information regarding the ccirmtd.prf file, see ccirmtd.prf in the appendix Introducing CCI in the Unicenter AutoSys Installation and Getting Started Guide.
C 2
Getting Started
2.
Create the config.EXTERNAL file. To enable cross-platform dependencies, create a file named config.EXTERNAL in the $AUTOUSER directory and add the following entry:
HNY:CNCT=honeydew
Note: For further information on creating the config.EXTERNAL file, see Create the config.EXTERNAL File in the appendix Integrating with the Mainframe and Unicenter AutoSys Agents for AS/400 and OpenVMS in the Unicenter AutoSys User Guide.
C 3
Note: For detailed syntax information, see Defining Agent Machines to Unicenter AutoSys in the appendix Integrating with the Mainframe and Unicenter AutoSys Agents for AS/400 and OpenVMS in the Unicenter AutoSys User Guide.
auto_cnct Syntax
auto_cnct a node s scheduler code [-j jobname c command p parameters -d]
where: -a node specifies the hostname of the machine running the option (HONEYDEW) -s scheduler code specifies the scheduler the command is being issued to (see the following table). Code CA7 CAM CAS Scheduler CA-7 CA-Manager CA-Scheduler
C 4
Getting Started
-j jobname specifies the jobname to be monitored for status. -c command specifies the command word, such as ADD or RUN. -p parameters specifies the command parameters for the job. -d specifies to wait for the initiation and termination of the job.
Control-M
CA-JobTrac
C 5
3.
You can also define jobs as a combination of both command jobs and external dependencies.
s
C 6
Getting Started
Index
configuration file, C-3
A
auto_cnct, C-4 syntax, C-4 AutoSysAgentSupport parameter, C-3
F
FILTER option, 3-4
B
batch interface, 3-2
H
hardware requirements, 2-1
C
CAICCI startup options, 3-3 verifying, 3-9 CAIENF, 3-2 startup options, 3-2 CCI ccirmtd.prf file, C-2 configure, C-2 remote daemon, C-2 ccirmtd.prf file, C-2 local parameter, C-2 remote parameter, C-2 client license key, C-3 command jobs auto_cnct, C-4
J
JCL install, 3-1 JOB syntax, 3-6 JOBSTEP syntax, 3-7
L
libraries, 3-1 license key, C-3
Index1
M
mainframe requirements, 2-2 MAXUSER value, 2-2 member names syntax, 3-2 message codes, B-1 syntax, B-1
Connect-monitored jobs, 3-6 OPC only, 3-4 setting Debug, 3-4 support technical, 1-1
T
technical support, 1-1
O
OPC monitoring, 3-4 operator commands, A-1
X
XCCODE member activating, 3-8 JOB, 3-6 JOBSTEP, 3-7 setting up, 3-6
R
requirements CSA space, 2-2 hardware, 2-1 LNKLST, 2-3 mainframe, 2-2 operating system, 2-2 software, 2-1 target systems, 2-1
S
schedule identifier, 3-2 scheduler codes list of, C-4 scheduler JCL, 3-2 software requirements, 2-1 started task, A-1 startup options, 3-4
Index 2
Getting Started