pre-con ed: beyond the ae cli - leveraging ca workload automation ae web services
TRANSCRIPT
World®’16
BeyondtheAECLI- LeveragingCAWorkloadAutomationAEWebServicesLeeRoberson/SeniorPrincipalConsultant/CATechnologies
MFX20E
MAINFRAME
1 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
©2016CA.Allrightsreserved.Alltrademarksreferencedhereinbelongtotheirrespectivecompanies.
Thecontentprovidedinthis CAWorld2016presentationisintendedforinformationalpurposesonlyanddoesnotformanytypeofwarranty. The informationprovidedbyaCApartnerand/orCAcustomerhasnotbeenreviewedforaccuracybyCA.
ForInformationalPurposesOnlyTermsofthisPresentation
2 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Abstract
LearnhowyoucanintegratewithCAWorkloadAutomation(CAWA)AEvialightweight,scalableandmaintainableCAWAAEWebServices.Thissessionwillprovide:
• OverviewoftheCAWAAEWebServicesRESTarchitecture
• SecurityImplementation
• Provideexamplejobmonitoringandcontrolusecasessuchasretrievingjobstatuses,andperformingjobactionsthroughtheCAWAAEWebServices
• IntroductiontotheCAWARESTClientthatcanbeusedbyanyCASchedulingenginetocallRESTfulWebServiceoperations
• AdemonstrationofcallingCAAEWebServiceswiththeCAWARESTClient
LeeRobersonSeniorPrincipalConsultant,CATechnologies
3 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
AgendaINTRODUCTIONTOCAWAAERESTWEBSERVICES
CAWAAEWEBSERVICESARCHITECTURE
CAWORKLOADAUTOMATIONRESTCLIENT
IMPLEMENTATION
SUPPORTEDRESTFULREQUESTS
SECURITYIMPLEMENTATION
1
2
3
4
5
6
DEMOEXAMPLESANDTROUBLESHOOTING7
4 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
APIs– TheSharp-endoftheApplicationEconomy
“Today,afirmwithoutapplicationprograminterfaces(APIs)…isliketheinternetwithouttheWorldWideWeb.”
“Inamodernenterprise,youmustbeabletousebothinternalandexternalAPIsinareliable,secureandscalablemanner”
10,000+PublicallylistedAPI’s
50%B2Bcollaborationthrough
APIsby2017
$750MAmazonbusinesslostif
latencyincreasesby100ms
5 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WAAEWebServicesJavaAPI C++APICLIs/DBAccess
RESTfulLight-weightAESDK AESDKAEClientUtilities
Introducedin11.3.5Introducedin11.0TraditionalApproach
CAWAAEProgrammaticInterfaces
Introducedin11.0
6 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWorkloadAutomationAEAPIs
ProgrammaticInterfacesandAPIstodefine,monitorandcontrolworkloadmanagementandbatchscheduling
Light-weightmodernRESTWebServiceAPIProvidesjobmonitoringandjobcontrolinterfacesUsesstandardHTTPGET/POSTrequestsPerformtaskssuchasretrievingajobstatusandperformingjobactions
Ready-to-useprogrammaticinterfacetoCAWorkloadAutomationAEUsesJNItointerfacewiththesamenativecodeClientlibrariesProvidesjobactions,statusretrievalandobjectadministration(create,update,delete
C++SDKClientApplicationsinterfacewiththeUnicenter AutoSysJMClientlibrariesLibrariesuseproprietaryRequest/ResponseProtocol(RRP)tocommunicatewithApplicationServer
AEWebServices JavaSDK C++SDK
7 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServices
§ NewRESTWebServicesinterface
§ FirstintroducedinCAWAAE11.3.5
§ Providesjobmonitoringandmanagementinterfaces:– Retrieve(limited)jobattributes,runtimedata,dependencies,and
relationships– Sendevent
§ Start,restart,cancel,on/offhold,on/office,on/offno_exec,forcestart
– Manageresourcesandglobalvariables– Replytojoboutstandingresponse
7
8 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServices
§ Fullsecurity/policysupport– Newpoliciestograntaccesstowebservicesadded
§ Auditing(accessibleviaautotrack)
§ InstalledwithASandSchedulerinstallationoptions
§ Includesanewwebservicesprogrammingguide
§ Willcontinuetobeextendedandenhancedinfuturereleases
8
9 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServices– KeyCapabilities
§ AlternativetoCAWAAEClientUtilities(CLI),directdatabaseaccessorCAWAAESDK(Java,C++)
§ Light-weightasopposedtoC++andJavaAPIs(SDK)
§ ExposeskeyCAWAAEoperationalmanagementandmonitoringfunctionsincluding:– ManageJobs,Machines,GlobalVariables,ConnectionProfiles
§ Doesnotprovidejobadministration/creation
9
10 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAERESTWebServices– KeyBenefits
§ Light-weightmodernRESTWebServices
§ AbstractionfromothermethodsemployedinthepastlikedirectlyaccesstheCAWAAEdatabase
§ Insulatesyoufromdatabaseschemachanges
§ RetrieveInformationonobjects(Jobsstatus,jobdependencies,globalvariables,machines,connectionprofiles
§ ObjectControls(ControlJobs,Machines,Globalvariables)
11 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServicesArchitecture
WebServicesConsumer
ApacheTomcatWebServer
Scheduler
ApplicationServer
SystemAgent
RDBMS
SystemAgentSystem
Agent
EEM
5520
8443
7507
7520
7500
7520
JDBCport
§ Awebservicestransactioninterfaces
withthefollowingcomponents:– CAWAAEWebserver(ApacheTomcat)
§ hostwebservices
– RDBMS(database)
§ accesstoCAWAAEdatabaseisenabledas
aRESTfulwebservice
§ Entitiesarequeried,created,andmodified
usingHTTPmethodssuchasGETandPOST
– CAEEM(security)
§ Sessionauthenticationinwebservicesis
securedusingCAEEM
12 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
AEWebServer(ApacheTomcat)
AEEventServer(RDBMS)
CAEEM(Security)
CAWAAEInstance
§ UsedtohosttheWebServices§ InstalledandconfiguredaspartoftheCAWAAEinstall§ WebServicesusesport9443tocommunicatewithTomcat§ Tomcatserverusesport5520tocommunicatewithCAEEM
§ AccesstotheCAWAAEdatabaseenabledasaRESTfulwebservice
§ Entitiesarequeried,created,andmodifiedusingHTTPmethodssuchasGETandPOST
§ SharingsameCAEEM§ RequiresexternalEEMsecurityconfigured(NativeAE
securitynotsupported)
CAWAAEWebServicesComponents
§ SessionauthenticationinwebservicessecuredusingCAEEM§ ensurestransactionssecuritybyprovidingidentity
authentication,authorization,andaccessmgmt.services§ AccesscontrolledbyLocalEEMApplicationGroup
13 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServices- Implementation
§ RESTfulstyle,usingtheCAguidelines
§ DocumentexchangeinJSONorXMLformats
§ StandardHTTPGET/POSTrequests
§ StandardHTTPreturncodes
§ RequiresEEM(NativeSecuritynotsupported)
§ AuthenticationwithEEM
§ AuthorizationwithEEMsecuritypolices13
16 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServer– UNIX/Linux
§ CAWAAEWebServerStatus:
§ StartCAWAAEWebServer:
§ StopCAWAAEWebServer:
16
17 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Authentication
§ SecurityofwebservicestransactionimplementedusingHTTPS
§ AuthenticationperformedusingTomcatJavaTM AuthenticationandAuthorizationService(JAAS)realmwithEEMsecurity
§ RequiresEEM(NativeSecuritynotsupported)
§ CAEEM-specificJAASLoginModuleauthenticateslogincredentialsusesBASICauthenticationoverSSL
§ AccesscontrolledbyLocalEEMApplicationGroupcalledWorkloadAutomationAEWebService
§ UserMUST belongtothisgroup
Authorization
§ AuthorizationchecksperformedbasedonauthenticateduserIDandexistingEEMWAAEpolicies
CAWAAEWebServices– Security
18 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServicesSecurity- Authentication
18
securityofawebservicestransactionisimplementedusingaHTTPSconnection,whichisHTTPbasicauthenticationoveraSecureSocketsLayer(SSL)connection
20 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
AuthenticationoverSecureSocketLayer(SSL)Connection
MusthaveSSLconnectiontosecurelogincredentials
§ TwoOptions:– UseaSelfSignedCertificate
§ Cannotberevokedifcompromised/donotprovideanacceptablesecuritylevel
§ canuseself-signedcertificatesfortestingandnon-commercialenvironments
– UseaTrustedCertificateissuedfromaTrustedCertificateAuthority§ Canberevokedifcompromised§ Recommendedforproductionenvironments
21 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Generateanduseaself-signedcertificate
§ GenerateaPrivateKeyandSelf-SignedCertificate– Removepreviouskeyfromthekeystore– keytool -delete-aliastomcat-keystore $AUTOUSER/webserver/conf/.keystore -storepass changeit
– Generateanewkey– keytool -deletetomcat-keyalg RSA–keystore $AUTOUSER/webserver/conf/.keystore \
– -storepass changeit -keypass changeit -keysize 1024-dname "cn=SERVER_NAME"-validity14600
§ RestarttheWebServerservice– unicntrl restartwaae_webserver.$AUTOSERV
22 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RequestanduseaTrustedcertificate
§ GenerateaPrivateKeyandSelf-SignedCertificate– Removepreviouskeyfromthekeystore– keytool -delete-aliastomcat-keystore $AUTOUSER/webserver/conf/.keystore -storepass changeit
– Generateanewkey– keytool –genkey -aliastomcat-keyalg RSA–keystore $AUTOUSER/webserver/conf/.keystore \
– -storepass changeit -keypass changeit -keysize 1024-dname "cn=SERVER_NAME"-validity14600
§ RequestaCertificate– Generateacertificaterequestfile(certreq.csr)– keytool -certreq -aliastomcat-keystore $AUTOUSER/webserver/conf/.keystore \
– -storepass changeit –filecertreq.csr
23 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RequestanduseaTrustedcertificate
§ RequestaCertificateinPEMformat
§ DownloadtheCertificatechain
§ AddtheCertificatestotheKeystore– keytool -importcert -aliasRootCA -fileRootCA.cer-keystore
$AUTOUSER/webserver/conf/.keystore -storepass changeit
– keytool -importcert -aliasSubCA -fileSubCA.cer-keystore$AUTOUSER/webserver/conf/.keystore -storepass changeit
§ RestarttheWebServerserviceunicntrl restartwaae_webserver.$AUTOSERV
24 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ReuseexistingKeyStore File
§ CopyexistingKeyStore File– Copyfromexistingtonewwebserver location– $AUTOUSER/webserver/conf/.keystore
§ RestarttheWebServerservice– unicntrl restartwaae_webserver.$AUTOSERV
25 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImportexistingPrivateKeyandCertificate
§ ImportCertificatefromPkcs12– keytool -importkeystore \
– -srckeystore myp12.p12-srcstoretype PKCS12-srcstorepass my-password\
– -deststorepass changeit -destkeypass changeit \
– -destkeystore $AUTOUSER/webserver/conf/.keystore \
– -alias1-destalias tomcatCopy fromexistingtonewwebserver location
§ RestarttheWebServerservice– unicntrl restartwaae_webserver.$AUTOSERV
26 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ServiceDirectory
§ WebservicegeneratesaWebApplicationDefinitionLanguage(WADL)dynamicallyatruntime
§ WADLisgeneratedinXMLformatanditprovidesamachine-readabledescriptionofaHTTP-based
webapplication
§ WebserviceletsyouaccesseitherthefullWADL,incaseofanapplication,orasingleresource
WADL
§ FollowingUniformResourceIdentifiers(URIs)areavailable:
– GET/AEWS/application.wadl -- fullWADL
– OPTIONS/AEWS/resource -- singleresourceWADL
26
27 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAERESTfulWebServicesCAWAAEWebServicesuseREST
– ResourceidentificationusingURI
§ Identifiesresourcebyname,locationorboth
– Example:http://www.ca.com/NA/Pages/Home.aspx
– UniformInterface
§ InteractwithresourcesusingbasicHTTPmethods:
– Create(HTTPPUT),Update(HTTPPOST),Read(HTTPGET),Delete(HTTPDELETE),Options(HTTPOPTIONS)
– Self-descriptive
§ ContenteasilyaccessedinformatsXML,JSONetc
– Stateful interactionsthroughhyperlinks
§ Pointstovalidfuturestatesoftheinteraction
StandardsrequirethatthisisCASE-SENSITIVE.ThisincludestheURIsaswellasthedocumentsexchanged.
28 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
AEWS
event
gvar
job-run-info
job-dependencies
jobjob1
job2job2
job5
job3
job4
var1
application
schema
Full WADL
Resource Retrieval
Resource Control
Schema in detail
CAWAAEWebServices- URIDirectory
29 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
SampleURI
§ ExampleresourceURItogetajob:
https://WSServer:9443/AEWS/job/sleep1
§ https - secureprotocol§ WSServer - nameofthewebserverhostcomputer§ 9443 - portnumberforthewebservercomputer§ AEWS/job - resourcename§ sleep1 - jobnameparameterassociatedwiththeresource
30 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServiceConfiguration
§ Log4j.xml– Containsloggingconfiguration
§ Tomcat-wrapper-license.conf– LicensegeneratedforJavaServiceWrapper(Tanuki )3.5.1364-bit
§ Wrapper.conf– License“Tomcat-wrapper-license.conf”includedhere
§ KeystoreFile– ContainsSSLJavakeystore andselfsignedcertificate
– /opt/CA/WorkloadAutomationAE/webserver/apache-tomcat-7.0.22/conf/.keystore
31 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWAAEWebServiceConfiguration
§ TomcatServer.xml– ContainsconnectorportandSSLconfiguration
§ Eiam.ws.config– ContainsEEMinformationlikeEEMserver,ApplicationInstance,user/pasword etc
§ JAASlogon.conf– ContainsEEMconfig information
§ Wrapper.conf– ContainsCAWAAEenvironmentdetails,logon.conf etc
§ NATIVEJDBCJARPATHpointingtoSYBASEjconn4.jar(DONOTUSEITFORNOW)
§ RUN_AS_USER=autosys (shouldmatchwhatas_server andevent_demon runas)
32 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LoggingImplementedusinglog4j
§ Loggingbyfunctionality— GeneralWSquerytracing- com.ca.waae.wsquery— Configuration- com.ca.waae.aehome— DatabaseAccess- com.ca.waae.dbaccess— Security- com.ca.waae.security
§ Outputfile:$AUTOUSER/out/waae-webservices.log
§ Defaultleveliswarn— SufficeswithDebuglevel
§ Changesautomatic— Noneedtorecycletomcat
33 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
SupportedRESTfulrequests
§ Resourceretrieval‒ Supportedresources:jobs,job-runs,job-dependencies,gvar‒ HandledbyHTTPGET‒ ResponseFormats:XML/JSON
§ Resourcecontrol‒ Supportedresources:eventstocontroljobsandgvar‒ HandledbyHTTPPOST‒ RequestFormats:XML/JSON‒ Needtopostthedata
34 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobRetrievalSupportedrequests
GETAEWS/jobmethod—RetrieveInformationofaSingleorMultipleJobs– URL: https://webserver:port/AEWS/job?parameters
– Example: https://WSServer:8443/AEWS/job?filter=machine==localhost
Parameters:§ Jobname -Nameofthejobtoretrieve§ Version=n -Versionfortherequest.Default:currentversion§ Locale -Userlocale.Default:en-US§ Filter=FilterCriteria Setofexpressionsusingoperators.§ Count=n -Maximumnumberofrecordstobe
returned§ startIndex=n -Startinglogicalpagenumber§ sortBy=col1[,col2]... -Ordertosorttheresults
Note:Multipleexpressionscanbelinkedwitheithertheand(;)andor(|)boolean operatorsExample:application==abc;group=yyy|machine=abc
Operators:== Matchexactly!= Notanexactmatch=@ Matchthepattern.
Awildcardcanbeused.!@ Notmatchthepattern.
Awildcardcanbeused.< Lessthan<= Lessthanorequalto> Greaterthan>= Greaterthanorequalto
35 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobRetrievalSupportedrequests
-- request--GEThttps://WSServer:8443/AEWS/job?filter=machine==localhost-- response--200OKServer:Apache-Coyote/1.1Cache-Control:privateExpires:Wed,31Dec196919:00:00ESTContent-Type:application/xmlTransfer-Encoding:chunkedContent-Encoding:gzipVary:Accept-EncodingDate:Fri,03Feb201215:25:12GMT<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><jobs>
<job><name>MAINT_CLEAN_AGENT_OUT</name><jobType>CMD</jobType><machine>localhost</machine>
<selfrel="self"href="https://WSServer:8443/AEWS/job/MAINT_CLEAN_AGENT_OUT"/><status>4</status></job>
<job><name>MAINT_CLEAN_ARCHIVE</name><jobType>CMD</jobType><machine>localhost</machine>
<selfrel="self"href="https://WSServer:8443/AEWS/job/MAINT_CLEAN_ARCHIVE"/><status>4</status></job><selfrel="self"href="https://WSServer:8443/AEWS/job?filter=machine==localhost"/></jobs>
-- request--GEThttps://WSServer:8443/AEWS/job?filter=machine==localhost-- response--200OKServer:Apache-Coyote/1.1Cache-Control:privateExpires:Wed,31Dec196919:00:00ESTContent-Type:application/jsonTransfer-Encoding:chunkedContent-Encoding:gzipVary:Accept-EncodingDate:Fri,03Feb201215:32:16GMT{"job":[{"name":"MAINT_CLEAN_AGENT_OUT","jobType":"CMD","machine":"localhost","self":{"@rel":"self","@href":"https://WSServer:8443/AEWS/job/MAINT_CLEAN_AGENT_OUT"},"status":"4"},{"name":"MAINT_CLEAN_ARCHIVE","jobType":"CMD","machine":"localhost","self":{"@rel":"self","@href":"https://WSServer:8443/AEWS/job/MAINT_CLEAN_ARCHIVE"},"status":"4"}],"self":{"@rel":"self","@href":"https://WSServer:8443/AEWS/job?filter=machine==localhost"}}
36 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobRetrievalSupportedrequests
GETAEWS/job/jobname method—RetrieveInformationofaSpecificJob– URL: https://webserver:port/AEWS/job/jobname?parameters
– Example: https://WSServer:8443/AEWS/job/sleep1
-- request--GEThttps://WSServer:8443/AEWS/job/sleep1-- response--200OKServer:Apache-Coyote/1.1Cache-Control:privateExpires:Wed,31Dec196919:00:00ESTContent-Type:application/xmlTransfer-Encoding:chunkedContent-Encoding:gzipVary:Accept-EncodingDate:Wed,01Feb201220:27:01GMT<?xmlversion="1.0"encoding="UTF-8"standalone="yes"?><job><name>sleep1</name><jobType>CMD</jobType><machine>WSServer</machine><selfrel="self"href="https://WSServer:8443/AEWS/job/sleep1"/><status>4</status></job>
-- request--GEThttps://WSServer:8443/AEWS/job/sleep1-- response--200OKServer:Apache-Coyote/1.1Cache-Control:privateExpires:Wed,31Dec196919:00:00ESTContent-Type:application/jsonTransfer-Encoding:chunkedContent-Encoding:gzipVary:Accept-EncodingDate:Wed,01Feb201220:27:14GMT{"name":"sleep1","jobType":"CMD","machine":"WSServer","self":{"@rel":"self",“@href":"https://WSServer:8443/AEWS/job/sleep1"},"status":"4"}
Parameters:• Jobname• Version• locale
37 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobRetrievalSupportedrequests
§ GETAEWS/job-dependencies/jobname method—RetrieveJobDependencyInformationofaSpecificJob– URL: https://webserver:port/AEWS/job-dependencies/jobname?parameters– Example: https://WSServer:8443/AEWS/job-dependencies/SAPjob
§ GETAEWS/job-run-info/jobname method—RetrieveJobRunInformationofaSpecificJob– URL: https://webserver:port/AEWS/job-run-info/jobname?parameters– Example: https://WSServer:8443/AEWS/job-run-info/test
§ GETAEWS/job-run-infomethod—RetrieveJobRunInformationofaSingleorMultipleJobs– URL: https://webserver:port/AEWS/job-run-info?parameters– Example: https://WSServer:8443/AEWS/job-run-info?filter=name=@test*
38 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobControlSupportedrequests
POSTAEWS/event/cancel-jobmethod—CancelaJob,ApplicationorGroup– URL: https://webserver:port/AEWS/event/cancel-job?parameters
Request ResponseXMLFormatPOSThttps://WSServer:8443/AEWS/event/cancel-jobContent-Type:application/xml<command><jobName>test</jobName><comment>testingcancel-job</comment></command>
JSONFormatPOSThttps://WSServer:8443/AEWS/event/cancel-jobContent-Type:application/json{"jobName":"test","comment":"testingcancel-job"}
201CreatedServer:Apache-Coyote/1.1Transfer-Encoding:chunkedContent-Encoding:gzipVary:Accept-EncodingDate:Tue,31Jan201213:06:47GMT
39 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobControlSupportedrequests
§ POSTAEWS/event/force-start-jobmethod—StartaJob,ApplicationorGroupbyForce– URL: https://webserver:port/AEWS/event/force-start-job?parameters
§ POSTAEWS/event/hold-jobmethod—PutaJob,ApplicationorGroupinON_HOLDstatus– URL: https://webserver:port/AEWS/event/hold-job?parameters
§ POSTAEWS/event/ice-jobmethod—PutaJob,ApplicationorGroupinON_ICEstatus– URL: https://webserver:port/AEWS/event/ice-job?parameters
§ POSTAEWS/event/noexec-jobmethod—PutaJob,ApplicationorGroupinON_NOEXECstatus– URL: https://webserver:port/AEWS/event/noexec-job?parameters
§ POSTAEWS/event/off-hold-jobmethod—TakeaJob,ApplicationorGroupOffHold
– URL: https://webserver:port/AEWS/event/off-hold-job?parameters
40 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobControlSupportedrequests
§ POSTAEWS/event/off-ice-jobmethod—TakeaJob,ApplicationorGroupOffIce– URL: https://webserver:port/AEWS/event/off-ice-start-job?parameters
§ POSTAEWS/event/off-noexec-jobmethod—TakeaJob,ApplicationorGroupinOffNOEXECstatus– URL: https://webserver:port/AEWS/event/off-no-exec-job?parameters
§ POSTAEWS/event/release-resources-jobmethod—ReleaseResourcesheldbyaJob,ApplicationorGroup– URL: https://webserver:port/AEWS/event/release-resources-job?parameters
§ POSTAEWS/event/reply-jobmethod—ReplytoaJob,ApplicationorGroup– URL: https://webserver:port/AEWS/event/reply-job?parameters
41 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
JobControlSupportedrequests
§ POSTAEWS/event/restart-jobmethod—RestartaJob
– URL: https://webserver:port/AEWS/event/restart-job?parameters
– Note: Appliestoz/OSorMicroFocus Jobonly
§ POSTAEWS/event/start-jobmethod—StartaJob,ApplicationorGroup– URL: https://webserver:port/AEWS/event/start-job?parameters
42 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
GlobalVariablesRetrievalSupportedrequests
§ GETAEWS/gvar/variableName method—RetrieveInformationofaSpecificGlobalVariable
– URL: https://webserver:port/gvar/variableName?parameters
– Example: https://WSServer:8443/AEWS/gvar/TestVar
§ GETAEWS/gvar method—RetrieveInformationofaSingleorMultipleGlobalVariables
– URL: https://webserver:port/gvar?parameters
– Example: https://WSServer:8443/AEWS/gvar?filter==name=@gvar*
43 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
GlobalVariablesControlSupportedrequests
§ POSTAEWS/event/delete-gvar/namemethod—DeleteaGlobalVariable
– URL: https://webserver:port/AEWS/event/delete-gvar/name?parameters
§ POSTAEWS/event/set-gvar/namemethod—CreateorUpdateaGlobalVariable
– URL: https://webserver:port/AEWS/event/set-gvar/name?parameters
44 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
§ Continuetoenhanceandexpandcapabilities
§ ObjectAdministration(create,update,deleteobjects(jobs,etc.))
44
CAWAAEWebServices– Lookingahead
45 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWorkloadAutomationRESTClient
§ wlarestclient.jar
§ JavabasedRESTfulwebservicesclientutility
§ AllowsyoutoexecutewebservicesimplementedusingtheRESTprotocol
§ CanbeusedwithanyCAWorkloadengineusingstandardcommandjob(CMD,Unix,NT)
46 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWorkloadAutomationRESTClient- Requirements
§ JavaRuntimeEnvironment1.8
47 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWorkloadAutomationRESTClient- Configuration
§ Datausedtodoacallcancomefromthreesources:– thecommandlinearguments– globalconfig– afile(alsoyml format)thatispassedasparametertothecommand
§ Notes:– commandlineargumentswilloverridethefileparametersandthefile
parameterswilloverridetheglobalone– Theoverridewillhappenjustforparameterswiththesamenamefrom
configurationswiththesamename
47
48 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWorkloadAutomationRESTClient- Configuration
§ GlobalPropertiesFile(config.yml)(Optional)– hastobecreatedinthesamedirectoryas"wlarestclient.jar"fileifitis
tobeused– fileusedtodefineparametersforeveryAPIcallmadebytheREST
client
48
49 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CAWARESTClient– CommandExamples
§ 1)java-jarwlarestclient.jarURL=http://apiserver/testingname=TEST– ThiswillcallthefollowingURL:http://apiserver/testing?name=TEST
§ 2)java-jarwlarestclient.jarPATH=input.parms TYPE=POSTINPUT=/usr/share/inputs/payload.txt– Thiswillreadthe"input.parms"fileforallsupportedparameters,
includingURL,andusethefileininputPath forpayload
49
50 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RecommendedSessions
SESSION# TITLE DATE/TIME
MFX122SVisionandRoadmap:CAWorkloadAutomationAE(AutoSys)
11/16/2016@12:45pm
BanyanA/B
MFX133SCriticalPathForecastingwithCAWorkloadAutomation(AE)iDash
11/16/2016@4:30pm
BanyanA/B
MFX132SRealWorldBestPracticeswithCAWorkloadAutomationAE11.3.6
11/17/2016at3:45pm
BanyanA/B
51 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MustSeeDemos
AdvancedWorkloadAnalytics
CAWLAiDashMFandWorkloadAutomation
SeamlessApplicationAutomationAgents&AdvancedIntegrationsMFandWorkloadAutomation
CAConversionasaService
CAWorkloadAutomationMFandWorkloadAutomation
Innovations:CrossEnterpriseWorkloadAutomationCAWLAAE&DEMFandWorkloadAutomation