pre-con ed: beyond the ae cli - leveraging ca workload automation ae web services

53
World ® ’1 6 Beyond the AE CLI - Leveraging CA Workload Automation AE Web Services Lee Roberson / Senior Principal Consultant / CA Technologies MFX20E MAINFRAME

Upload: ca-technologies

Post on 10-Jan-2017

69 views

Category:

Technology


2 download

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

14 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

CAWAAEWebServerInstallOption

14

15 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

CAWAAEWebServerServices– (Windows)

15

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

19 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

CAWAAEWebServicesSecurity- Authorization

19

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

52 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

Questions?Informatica