Pre-Con Ed: Upgrading UUJMA (CA 7 Agent) to CA Workload Automation System Agent

World®’16

UpgradingCAUniversalJobManagementAgenttoCAWorkloadAutomationSystemAgentCharlesWalls,PrincipalConsultant,CATechnologies

MFX19E

MAINFRAMEANDWORKLOADAUTOMATION

1 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

©2016CA.Allrightsreserved.Alltrademarksreferencedhereinbelongtotheirrespectivecompanies.

Thecontentprovidedinthis CAWorld2016presentationisintendedforinformationalpurposesonlyanddoesnotformanytypeofwarranty. The informationprovidedbyaCApartnerand/orCAcustomerhasnotbeenreviewedforaccuracybyCA.

ForInformationalPurposesOnlyTermsofthisPresentation


Abstract

Inthissession,CAWorkloadAutomationCA7®Edition(CAWACA7)customerswilllearnaboutthearchitecturedifferencesoftheagentsandroleresponsibilitycomparison.Wewillalsoreviewbasicmonitoringtechniquestroublingshootingissueswiththeagentpriortoescalation.

CharlesWalls

CATechnologiesPrincipalConsultant


Agenda

CAWORKLOADAUTOMATIONAGENTSOVERVIEW

UNIVERSALJOBMANAGEMENTAGENT(CAUUJMA)- HOWITWORKS

AGENTCOMMANDSANDMONITORING

CAWORKLOADAUTOMATIONSYSTEMAGENT- HOWITWORKS

ARCHITECTUREDIFFERENCES

MIGRATINGUUJMAWORKLOADTOCAWASYSTEMAGENT

1

2

3

4

5

6


CAWorkloadAutomationAgentsOverview

§ CAUUJMAandCAWorkloadAutomation(CAWA)SystemAgent…they’rebothworkloadagentscorrect?

§ CanIstilluseCAUUJMA?

§ WhyshouldIconsiderchanging?

§ IsCAUUJMAgoingaway?


CAWorkloadAutomationAgentsOverview

§ TerminologyUsedDuringOurSession– CAUUJMAUniversalJobManagementAgent– CCICommonCommunicationsInterface– CA7TOUNICA7Job tosubmitcrossplatformrequeststoCAUUJMA– XPJOBCA7usedtosubmitcrossplatformrequeststoCAUUJMA– CAWorkloadAutomationSystemAgentRelease11.3– AGJOBCA7usedtosubmitcrossplatformrequeststoCAWASystem

Agent


UniversalJobManagementAgent(CAUUJMA)

§ HowItWorks– SubmitsandTracksDistributedWorkloads– Sendsjobinitiation,terminations,failurestomainframe– UsesCACCSCCICommunicationsLayer(CCITCPGW)– CAUUJMACCIRMTD.RCusedtoconnecttotheMF– RequiredROOT/Administratorforinstall– Dynamicdatasetcreation/update– XNODEprimary|SecondaryserverforXPJOBtypes



Oid(WALCH05-U182868,CAI_OPR_SAFD ) Did( , ) type(L)Oid(WALCH05-U182868,CA_Cal_Chk ) Did( , ) type(L)Oid(WALCH05-U182868,ROUTER_SERVER ) Did( , ) type(L)Oid(WALCH05-U182868,EMSRVC_ROUTER_U ) Did( , ) type(L)Oid(WALCH05-U182868,CAU9SET SetUp Mgr ) Did( , ) type(L)Oid(WALCH05-U182868,SUBMITC Server ) Did( , ) type(L)Oid(A21SENF,CASCHED Job track ) Did( , ) type(R)Oid(A21SENF,CASCHED Server ) Did( , ) type(R)Oid(A21SENF,CA7XE21 Server ) Did( , ) type(R)Oid(A21SENF,CAU9SET SetUp Mgr ) Did( , ) type(R)Oid(A21SENF,SUBMITC Server ) Did( , ) type(R)Oid(A21SENF,CA7XE21 Job track ) Did( , ) type(R)Oid(A21SENF,CA-7 XTM UC07 ) Did( , ) type(R)

LOCAL=WALCH05-U182868WALCH05-U18286832768startupalias=walch055Remote=USI121MEA21SENF32768startupport=8500Remote=USI182MEA21SENF32768startupport=8500

§ ConfiguringCACCI– LocalHostNameslongerthan8requiredAlias– RemotestatementsrequiredforeachCAWACA7Instance



§ SupportPlatforms– HP,AIX,WIN,Linux,Linux/390– OS400,Solaris,Tandem

CA Workload Automation CA 7

TCP/IP

CCITCPGW

CCI

CAUUJMA

CCI CCI CCI CCI

CAUUJMA CAUUJMA CAUUJMA CAUUJMA



§ Challenges– SingleJobtype– Mostadvancedintegrationsrequiredawrapperscript– CCI

§ CCITCPGWMFGatewayinstallationrequirements§ MultipleSystemSupport§ Reliability


CAWorkloadAutomationSystemAgent

§ HowitWorks– DirectsubmitusingTCP/IP(nomainframeinitiators)– AESencryptionusingshortdatapackets– Nativejobtypetemplatesreducingoreliminatingscripting– DataEventsensorsandIntegrationpointstoyourbusinessapplications– CAWACA7willbroadcastnewlocationtoallagentsifmovedtoan

alternatesystem



I5

WindowsAIXHPUX

WebUIVTAMISPF

LINUX/z/LINUX

ERP

Database Web/ApplicationServices

CAWorkloadAutomationCA7

RemoteExecutionz/OS

TCP/IPAESEncryption

CAiDash



§ TypicalDeploymentRoleandResponsibility– Systems(SYS)– CA7Configuration/IAS

– ProductionControl(PC)– CAWACA7/CAWAAgentParameterfile§ /IAS,FUNC=RECONFIG

– ServerAdministration(ADM)– AgentInstallation

– Operations(OP)– MonitoringandErrorRecovery§ LQ,JOB=,LIST=ALL

§ AGFILE,JOB=



MANAGERNAME(CA7XE21)+

RETRYINTERVAL(4000)RETRYCOUNT(5)SLEEPTIME(300)

AGENTRCVRECEIVER1PORT(4701)

AGENTCW_AGENT2+

PLATFORM(NT)ASCIICRYPTNAME(CRYPT1)+

ADDRESS(USI199MX)PORT(7521)

AGENTEUI122MUX+

PLATFORM(UNIX)ASCIICRYPTNAME(MVS66)+

ADDRESS(EUI122MUX)PORT(7530)

§ ConfiguringCAWACA7tosupportCAWASystemAgent– ManagerandReceiverportarefixedvalues

§ CAWAAgentInstallpromptsforthesevalues– AgentStatementsareaddedtodefinetheagenttoCAWACA7

§ Characteristicsinclude– AgentName

– Platform

– Encryption

– Hostname



LAGENT

AGENT=*

AGENTName Active Host

CW_AGENT2 YES USI189WA

U182868 YES WALCH05-u182868.ca.com

BRAGENT NO BR_WIN_APPSERVER1

WA_AGENT YES 130.119.195.62

§ CAWASystemAgentCommand– /IAS,FUNC=RECONFIG|STARTCOM|STOPCOM

§ UpdatesCAWACA7afterchangestoAgentparameterfile§ StartandStopAgentCommunications

– LAGENT§ ListAgentsdefinedtoCAWA7andstate




ArchitectureDifferences

# Agent name

agentname=u182868

# Communications

#communication.inputport=7520

communication.managerid_1=CA7XE21

communication.manageraddress_1=usi121me

communication.managerport_1=4701

communication.monitorobject_1=u182868/AGENTMON1.0/MAIN

# Security

#security.filename=C:/Program Files/CA/WA Agent/security.txt

security.level=ON

security.cryptkey=C:/Program Files/CA/WA Agent/cryptkey.txt

§ CAWAAgentParameters– Submitjobsonbehalfofanotheruser– Communicationparameters– Security



§ Security– UJMAjobsubmissionmayrequireapasswordandavaliduserIDin

orderforajobtobeexecuted.§ ExtNodeL.schconfigurationfileforyouwithasingleentryof-n=*,*,Etoenablepasswordvalidationforallusersonallnodes.

– CAWASystemAgentuserIDscomefromeithertheCAWACA7jobdefinitionorfromtheagentPARMLIBdata.§ PasswordsassociatedwithuserIDs,agents,andjobtypesaremaintainedthroughtheAGPSWDcommand



§ SecurityCAWASystemAgent– AES32characterencryptions/FIPS140-2compliant– CAWASystemAgentLocalsecurityifenabledperformthefollowing

actions§ Ifthesecurity.txtfileexisttheagentusestherulesdefinedinthefile§ Ifarequestdoesnothaveamatchinthesecurityfiletheagentdeniestherequest.

§ ThefollowingruledeniesanyschedulingmanageruserfromsubmittingjobsundergemoranyuserIDsthatbeginwithgem,fromalldirectories.

xd*gem*+



000001CMDNAMEC:\SCRIPTS\DIR1.BAT

000002ARGS"USI1217YSETPARM=NOUPDATE=YES"

000003EXITCODE0SUCCESS

000001#7UNI

000002//CWX0003PJOB1520000,'MVSTOUNIX',CLASS=A,MSGCLASS=X

000004//SYSINDD*

000005NODE=U182868

000006SUBFILE=C:\SCRIPTS\DIR1.BAT

000007PARM1=USI1217YSETPARM=NOUPDATE=YES

000010//DDDSN=XPS.PASSWORD(CWX),DISP=SHR

§ Controlparametersfortheapplication– CAWACA7TOUNISYSINParameters– XPJOBdefinedaspartoftheCAWACA7definition– CAWASystemAgentstoredinCAWACA7JCLLibrary



LQ,JOB=CWX0003P,AGENT=CW_AGENT2

LIST=STATUS JOB=CWX0003P

JOB QUEUE CA-7 -DAY(DDD) AND TIME(HHMM)-- CPU SCH ENTRY MSTR JOB

NAME NAME JOB# DEADLINE SUB/START DUE-OUT SPEC/RUN ID MODE REQ STATUS

CWX0003P RDY 0548 284/1717 284/1617 284/1717 WIN- 001 DEMD 000 W-AGENT

§ ErrorRecovery– CA7TOUNICAUUJMAabendswithU4000ifAgentisoffline– CAXPJOBCAUUJMAissueserrorNODEFailed– CAWASystemAgentstatusisW-AGENT

§ JobwillwaituntilCAWAAgentisavailable§ Retryintervaldetermineshowlogbeforetimeout



§ CAWASystemAgentCommands– LJCKCommandforCrossPlatformJobs

§ Displayscrossplatformmessagethatwillbesenttotheremotenode§ ProvidesSyntaxcheckingforcrossplatformjobs§ ResolvesCAWACA7GlobalVariables


ArchitectureDifferencesLJCK,JOB=CWX0003P

DSN=CAIXE21.CA7.USERLIB DATE=16.284 PAGE 0001

JOB=CWX0003P MEMBER=CWX0003P JCLID=100 LIST=MERGE

***************************** JOB DEFINITION DATA *****************************

JOBNAME : CWX0003P

JOBTYPE : NT_JOB

AGENT : CW_AGENT2

USER :

************** DATA FROM PARMLIB (WITH EXPANSION AND SUBSTITUTION)*************

1. CMDNAME C:\SCRIPTS\DIR1.BAT

2. ARG "USI1217Y SETPARM=NO UPDATE=YES"

3. EXITCODE 9 SUCCESS

***************** DATA FROM AFM (ERRORS DISPLAYED WITH <nnnnn>)****************

AGENT CW_AGENT2

CMDNAME C:\SCRIPTS\DIR1.BAT

ARG "USI1217Y SETPARM=NO UPDATE=YES"

<00002> CAIAS0103E Invalid statement ARG for job/request type NT_JOB

EXITCODE 9 SUCCESS



----------------- CA-7 Job SPOOL For Agent cw_agent2 ---------

Jobname: CWX0003P CA7#: 0548 System: TEST SchId: 0001 Q-DtTm: 16284 1617

Job Type: NT_JOB Spool Offset: 0 Next Offset: EOF

----------------------------------------------------------------

Output of messages for workload object CWX0003P.N00548/TEST.S00001D162841617/M+

AIN

Start date Mon Oct 10 15:24:13 2016

C:\Program Files (x86)\CA\WA Agent R11.3.4>sleep.exe 10

§ CAWASystemAgentCommands– AGFILEretrievesCrossPlatformStandardOutput

§ ScriptoutputretainedonCAWASYSAgentServer§ DefaultistoretrievelastrununlessusingLIST=ALL§ OutputavailableinCA7WebClient



CWX0003P.N01485/TEST.S00001D162861411/MAIN State FAILED Cmpc(10)

SetEnd JobLogId(54F045CBD68D108E4055AB74787AC28FC35247F8)

User(cw_agent2) Host(WALCH05)

§ CAWASystemAgentReceiverandTransmitterLogs– LocatedinagentinstallDir/LOG– ReceiverLogcontainsinformationfromSchedulingmanager– TransmitterLogcontainsinformationsenttomanager


MigratingUUJMAWorkloadtoCAWASystemAgent

§ Beforeyoustartconvertingitisgoodtofollowgeneralgoodpracticeprinciples– ReviewCAWACA7Interfacesguideforr11.3/r12

§ Cross-PlatformSchedulingusingAGJOB§ CA7TOUNIConversionUtility§ CAXPJOBConversionUtility

– Createatestplan

– EngageCASupportifneeded



InstallCAWASystemAgent

ReviewCA7TOUNISYSINandDDconcatenation

Configure CAWACA7IAS(IntegratedAgentServices

ExecuteAGJOBTest

TOUNItoXPJOBConversionUtility

ComparisonReview

CAWASystemAgenttestreview

XPJOBtoAGJOBConversionUtility

Select candidatesforUtilitytesting



CAWACA7

TCP/IP

CCITCPGW

CCI

CAUUJMA

CAWASystemAgent

CAWASystemAgent

CCI

CAUUJMA

§ Compatibility– BothArchitecturescancoexist– BothAgentscanrunonthesameserver– Migratebyjob,applicationorserver



§ TheConversionutilitieshavetwobenefits.– Theutilityprovidesasemi-automatedmechanismforchangingyour

TOUNI/XPJOBstoUNIX(UNIX_JOB)orWindows(NT_JOB)definitions.– Theutilitymaintainsanyrequirements,triggers,andschedules

associatedwiththeoriginalXPJOBdefinition.

OneofthemostsignificantdifferencesyouseewhentheconversioncompletesisthelackofCA7TOUNIrunningasjobsontheMFandXPJOBPARMnnstatements



CMDNAMEC:\SCRIPTS\DIR1.BATARGS"USI1217YSETPARM=NOUPDATE=YES"EXITCODE0SUCCESS

000001#7UNI000002//CWX0003PJOB1520000,'MVSTOUNIX',000003//CLASS=A,MSGCLASS=X000004//SYSINDD*000005NODE=U182868000006SUBFILE=C:\SCRIPTS\DIR1.BAT000007PARM1=USI1217Y000008PARM2=SETPARM=NO000009PARM3=UPDATE=YES000010//DDDSN=XPS.PASSWORD(CWX),DISP=SHR000011/*

CAWACA7TOUNI

CAWACA7 SystemAgent



000001#7UNI

000002//CWX0003PJOB1520000,'MVSTOUNIX',

000003//CLASS=A,MSGCLASS=X

000004//SYSINDD*

000005NODE=U182868

000006SUBFILE=C:\SCRIPTS\DIR1.BAT

000010//DDDSN=XPS.PASSWORD(CWX),DISP=SHR

§ CA7TOUNIPre-ConversionUtility– TheutilitydynamicallyallocatesanypermanentSYSINDDdatasets

associatedwiththeCA7TOUNIjob– Theutilityaddseachrecordtothenewsequentialfileaspartofa

SYSINDD*statement.– CreatesIEBUPDTEaddingeachCA7TOUNIjobtoanewPDSforinputto

theconversionutility



§ CA7TOUNIConversionUtility– CreatesacopyofCAWACA7JCLLIBthatwillbeusedbyconversion

utility– Createssequentialfile(CONVCMDS)containingCAWACA7update

parameterstoconvertCA7TOUNIjobstoXPJOBS– CAWACA7BatchTerminal(BTI)jobusesoutputfileCONVCMDSto

executethechanges– Maintainsanyrequirements,triggers,andschedulesassociatedwith

theoriginalCA7TOUNIjob.TheprocessalsomaintainsPROFILEandSTEPLIBdatasetdefinitionsresultingfromtheoriginalCA7TOUNILOAD,ordoneusingtheDB.6panel.



§ XPJOBUtility– BackupcopiesofexistingXPJOBOptionalPARMLIBmembersare

created– Theconversionfile,XNODEandXPSWDcleanupfiles,andagentuser

ID/passwordfilearegenerated– BatchTerminalInterfaceprogramreadstheconversionfilethatwas

createdtoperformtheactualconversion– TheAgentSecurityfileisusedtoupdateuserIDsandpasswords

requiredtorunthejobsattheAgentsaredefined– cleanupoldXNODEandXPSWDentriesthattheoriginalXPJOBsused



§ XPJOBConversionUtility– Thefollowingconditionsandrulesmustbetruefortheconversionto

completesuccessfully:– TheXPJOBmusthavesuccessfullyexecutedinaCAWorkload

AutomationSEenvironmentwithoutQJCLupdates.Jobsthathavenotrunsuccessfullymostlikelyhaveerrorsthatwouldprecludetheirsuccessfulconversion.

– UtilityprovidesmigrationassistanceforCAUUJMAonlyjobsdestinedforaUNIXorWindowsenvironment.



§ XPJOBConversionUtility– TheXPJOBmusthavesuccessfullyexecutedinaCAWACA7– UtilityprovidesmigrationassistanceforCAUUJMAonlyjobsdestined

foraUNIXorWindowsenvironment.


AgentCommandsandMonitoring

§ CAUUJMAAgentCommands– UNIFSTAT- Liststatusofagentservices– UNISHUTDOWNALL– StopsallCAUUJMA/CCIServices– UNISTARTALL– StartsAllCAUUJMA/CCIServices– UNICYCLEALL– Stops/StartsallCAUUJMACCIServices

§ AWASystemAgentCommands– ./cybAgent &- StartsAgent– ./cybAgent –s- StopsAgent– ./cybAgent –v– statusandreleaseSPinformation


AgentCommandsandMonitoringLQ,JOB=CWX0003P,LIST=ALL

LIST=ALL JOB=CWX0003P DATE=16.284 PAGE 0001



CWX0003P REQ 0548 284/1717 284/1624 284/1717 WIN-AGJ 001 DEMD 001 R-C0010

--------------------------- JOB INFORMATION ---------------------------

. SYSTEM NAME = TEST

. DRCLASS = **NONE**

. AGENT: CW_AGENT2

------------------------- REQUIREMENTS STATUS -------------------------

_______ JOB RESTART REQUIRED

-------------------------- AGENT INFORMATION --------------------------

Job Type: NT_JOB JobNo: 14848

Agent: CW_AGENT2 Status:

User:

--------------------------- PARM INFORMATION --------------------------

CMDNAME C:\SCRIPTS\DIR1.BAT


AgentCommandsandMonitoringLQ,JOB=CWX0003P,AGENT=CW_AGENT2

LIST=STATUS JOB=CWX0003P



CWX0003P RDY 0548 284/1717 284/1617 284/1717 WIN- 001 DEMD 000 W-AGENT

LQ,JOB=CWX0003P

LIST=STATUS JOB=CWX0003P DATE=16.284 PAGE 0001



CWX0003P ACT 0532 284/1701 284/1600 284/1701 WIN-AGJ 001 DEMD 000

LQ,JOB=CWX0003P

LIST=STATUS JOB=CWX0003P DATE=16.287 PAGE 0001



CWX0003P REQ 1485 286/1511 286/1413 286/1511 WIN-AGJ 001 DEMD 001 R-C0010

------------------------- REQUIREMENTS STATUS -------------------------

_______ JOB RESTART REQUIRED


AgentCommandsandMonitoring

§ /Agentcommand– SendsarequesttoaCAWASystemAgenttoperformaspecificcontrol

actions§ Refreshtheagentsecurityfiles§ Clearlogfiles

§ Stoptheagentaftercurrentworkiscomplete

§ Updateaconfigurationsetting

§ Verifythecommunicationlinktotheagent

/AGENT,AGENT=CW_AGENT2,FUNC=PING

RESPONSE STATUS Plugin(status) User(cw_agent2)

Host(WALCH05)

SCM0-00 /AGENT COMPLETED AT 15:34:52 ON 16.286.


Questions?


RecommendedSessions

SESSION# TITLE DATE/TIME

MFX11E BenefitsofUpgradingtoCAWorkloadAutomationCA7Editionr12

11/15/2016at1:00pmJasmineC

MFX134S UseCase:MigratingfromTermaJawstoCAWorkloadAutomationiDash

11/17/2016at12:45pmBanyanA/B

MFX125S VisionandRoadmap:CAWorkloadAutomationCA7Edition 11/17/2016at3:45pmJasmineB

MFX137S EfficientlyManagerSLAsusingPredictiveAnalyticswithCAWorkloadAutomationCA7Edition

11/17/2016at4:30pmJasmineC


MustSeeDemos

Innovations:CrossEnterpriseWorkloadAutomationCAWLAAE&DEMFandWorkloadAutomation

SeamlessApplicationAutomation

Agents&AdvancedIntegrationsMFandWorkloadAutomation

CAConversionasaService

CAWorkloadAutomationMFandWorkloadAutomation

ModernWorkloadAutomation

CAWLADEMFandWorkloadAutomation


MainframeandWorkloadAutomation

FormoreinformationonMainframeandWorkloadAutomation,pleasevisit:http://cainc.to/9GQ2JI


Thankyou

Stayconnectedatcommunities.ca.com

Technology

Pre-Con Ed: Upgrading UUJMA (CA 7 Agent) to CA Workload Automation System Agent