SOE in Action Examples of SOEEXEC usage - Nordic TWS conference

IBM Tivoli Workload Scheduler for z/OSSOE in ActionExamples of SOEEXEC usage© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSWhat is an SOEEXEC? A REXX program that calls SOE Any process you can do through the dialogs can be performed Some processes you can't are possible as well SOE will be extended by SOEEXECs written by IBM You can add to this yourselfSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSBuilding an Application from a CSV file SOEEXEC CSVBUILD creates a primitive application(s) Fields are mapped from the CSV file to YOUR specification Operations will be numbered to your policy Multiple applications will be created if too many operations created Fields can be defaulted Lookup lists can translate fieldsSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAn example of CSVBUILD//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=CSVBUILD//INPUTDEF DD *MAP(JOBN,HIGHRC,PRED,FORM,.,WSID)ADID(FRED) FORM(DD0001)WSID(CPU1) UPDATE(N)//CSVFILE DD *JOBAJOBB,4,JOBA,DD0002,HELLO,CPU2JOBC,,JOBA JOBQ,,GOODBYEJOBD,,JOBB JOBCJOBQJOBAJOBBJOBDJOBQJOBCSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSCSVBUILD considerations This creates primitive applications Run cycles, resources etc can be entered through the dialogs External dependencies need to be clarified CSVBUILD does the majority of the work for youSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSFind what Applications a job is in Give SOEXEC JOBFIND a jobname and it will tell you– Application ID– Valid From Date– Status– Workstation– Jobname (since you can use wildcards)– Operation number– Next used Operation Number– Next unused Operation number The output can be sent to a file or another SOEEXEC (via Stack) You can search for whole lists of jobs at onceSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAn example of JOBFIND//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBFIND,// ARGS='@JOBN(ZAPPED) INFILE(MOREJOBS) DATA(ODD)'//ODD DD SYSOUT=*//MOREJOBS DD *FRED*TWSC*SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSSample JOBFIND outputADID FROM S WSID JOB OP NXT AVL TAG---------------- ------ - ---- -------- --- --- --- ---BATLOADC 080530 P DUMM ZAPPED 010 000 011 ZAPPED+*BATLOADNONE 080608 A DUMM ZAPPED 254 255 000 ZAPPED+*BATLOAD2 080501 A DUMM ZAPPED 010 020 011 ZAPPED+*BATLOAD2 080901 A DUMM ZAPPED 010 011 012 ZAPPED+*BATLOAD2 081001 A DUMM ZAPPED 010 020 011 ZAPPED+*BATLOAD3 081105 P DUMM ZAPPED 010 020 011 ZAPPED+*BATLOAD3 081125 P DUMM ZAPPED 010 020 011 ZAPPED+*BATLOAD3 081130 P DUMM ZAPPED 010 020 011 ZAPPED+*BATLOAD4 081130 A DUMM ZAPPED 010 000 011 ZAPPED+*BATLOAD5 080219 A DUMM ZAPPED 010 000 011 ZAPPED+*BATLOAD6 080530 A DUMM ZAPPED 010 000 011 ZAPPED+*BATLOAD6COPY 080530 P DUMM ZAPPED 010 000 011 ZAPPED+*DISCONTEST 070828 A CPU1 TWSCDUM1 010 020 011 TWSC*+*DISCONTEST 070828 A CPU1 TWSCDUM2 020 030 021 TWSC*+*DISCONTEST 070828 A CPU1 TWSCDUM3 030 040 031 TWSC*+*DISCONTEST 070828 A CPU1 TWSCDUM4 040 050 041 TWSC*+*DISCONTEST 070828 A CPU1 TWSCDUM5 050 000 051 TWSC*+*SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSUpdating operations SOEEXEC JOBUPD allows operations to be updated You specify the job name and the attributes to update JOBUPD then calls JOBFIND to find the jobs It then generates Batch Loader (database update language) You can review or execute the Batch Loader Input can be ONE job, or a CSV fileSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSA simple example of JOBUPD//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBUPD,// ARGS='@JOBN(MYJOB) HIGHRC(4)'//OUTBL DD SYSOUT=* This example finds every occurrence of MYJOB in the database andchanges the highest return code to 4SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSA simple CSV example of JOBUPD//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBUPD,// ARGS='MAP(@JOBN,HIGHRC,DESCR)'//OUTBL DD SYSOUT=//CSVFILE DD *MYJOB,4,This is my jobOTHERJOB,,This is not my job This example finds every occurrence of MYJOB in the database andchanges the highest return code to 4 and sets the description, then justchanges the description for OTHERJOBSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAdding special resources//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBUPD,// ARGS='MAP(2) SKIP(2)'//OUTBL DD SYSOUT=//CSVFILE DD *,,,,TWS Change Input@JOBN,UPDSR,QUANTITY,USAGE,ONCOMPLETE,KEEPONERRMYJOB,MY#RESOURCE,1,S,,OTHERJOB,MY#OTHER#RESOURCE,1,X,N,K This example shows the addition of special resources to an operation.SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSRemoving special resources//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBUPD,// ARGS='MAP(2) SKIP(2)'//OUTBL DD SYSOUT=//CSVFILE DD *,,,,TWS Change Input@JOBN,DELSRMYJOB,MY#RESOURCEOTHERJOB,MY#OTHER#RESOURCE And of course they can be deleted just as easy.SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAnd wouldn't it be nice if?...//RUNPIF EXEC EQQYXJCL,// SUBSYS=TWSC,// CMD=JOBUPD,// ARGS='MAP(1) UPDATE(Y) SKIP(1) OPMODE(INSERT)'//OUTBL DD SYSOUT=*//CSVFILE DD *@JOBN,@WSID,WSID,DLTIME,DURATION,DESCRARMJ01U8,CPU1,SLAT,1730,1,SLA OperationGTMDA9ED,CPU1,SLAT,1130,1,SLA OperationGTMD90BA,CPU1,SLAT,0800,1,SLA OperationSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAnd don't forget… No updates are made unless you code UPDATE(Y). UPDATE(N) displays the Batch Loader it would have used.SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSDynamic Insertion - SUBLINK SUBLINK is given 3 classes of arguments –1. The Application you want to insert in the current plan2. Arguments to identify an individual job you might want to link it to3. Arguments to define how to link them SUBLINK will then –– Find the ADID, IA and OPNO to link to (if requested)– Look up all the successors to that operation (internal and external)– Insert the new application as a successor (if requested)– Make all the successors to the insertion point a successor to the new application(again if that is what you want)– SUBLINK can even ONLY submit the new application if the Operation is waiting inthe planSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAssumptions and consequences Assumes the FIRST operation is 001 and LAST is 255 You can override this The FIRST operation will be dependent on the insertion point The LAST operation will receive the successors You tie whatever you want internally to FIRST and LAST If the insertion point is not WAITING then an error will be reported ifit was required The new Application inherits all the dependencies of the insert point Any successors to the insert point will wait for the new applicationSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSFIXED1DYNAM1001 FIRST010 DYN1255 LASTDYNAM2001 FIRST010 DYN2255 LASTFIXED2FIXED3SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSA SUBLINK example//RUNPIF EXEC EQQYXJCL,// SUBSYS=CWSC,// CMD=SUBLINK//CMDIN DD *SUBMIT(ADHOC1) ALIAS(NEWNAME)@JOBN(TWSCCPEX) REQD(CONDITIONAL)LAST(005)SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSWhat else can be done? These are typical examples of what can be done Anything that you can do through the dialogs you can do through SOE The sort of things we might do…– Find predecessors and successors, even external ones– Find Special Resources anywhere in the database– NOP jobs in the Current PlanSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSHow do you design an SOEEXEC Start with the process you want to do – e.g. NOP operations Determine what your inputs need to be Match them up with SOE and TWS requirements Determine how to lookup any mismatch Write and SOEXEC to– Generate the SOE commands– CALL SOE– Process the feedbackSOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAn example of design To NOP a set of jobs in the Current Plan Your input may be a list of jobs The SOE commands to NOP one would look like this –MODIFY CPOC ADID(MYAPPL) IA(080612)MODIFY CPOP OPNO(10) OPCMD(NP) You must find each operation in the Current Plan Each operation must be an appropriate status or input arrival Generate the MODIFY commands.SOE in Action© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAnatomy of an SOEEXECCommands arepassed to SOEAsterisk in aby queuing them /*----------------------------------------------------------+DATA argumenton the stack| Initialise variables says | pass the+----------------------------------------------------------*/ data back on thePARSE ARG argSUBSYS argJOB argSTATUSstack/*----------------------------------------------------------+| Setup the SOE command |+----------------------------------------------------------*/QUEUE "OUTPUT CPOP=* DATA(*)" ,"FIELDS(CPOPADI=*,CPOPIA=*,CPOPNO=*,CPOPJBN=*)"QUEUE "LIST CPOPCOM JOBNAME("||argJOB||")" ,"STATUS("||argSTATUS||")"/*----------------------------------------------------------+Fields are split | Run the SOE command |by "00"x +----------------------------------------------------------*/pifRC = EQQYXTOP(argSUBSYS)IF pifRC 0 THENEXIT pifRCReadthewholestack/*----------------------------------------------------------+| Grab the output |+----------------------------------------------------------*/@ = "00"xDO WHILE QUEUED() 0PARSE PULL inADID (@) inIA (@) inOPNO (@) inJOB (@)SAY ">>" inADID inIA inOPNO inJOBENDSOE in ActionThe firstargument mustalways be TWSsubsystemDo somethingwith itAfter that youcan passwhatever youneed=* in a fielddefinition meansdrop the labelYou can buildyour commandsusing variablesThis calls SOE,passes theSUBSYS andprocesses thestackWe get thereturn code backPARSE out thedata© 2008 IBM Corporation

IBM Tivoli Workload Scheduler for z/OSAny questions?SOE in Action© 2008 IBM Corporation