### Start installation on UNIX Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-performing-direct-upgrade-backup-master-domain-manager Launch the server installation on UNIX operating systems using ./serverinst.sh. The acceptlicense and inst_dir parameters are required. ```bash ./serverinst.sh --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Start installation on Windows Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-performing-direct-upgrade-backup-master-domain-manager Launch the server installation on Windows operating systems using cscript serverinst.vbs. The acceptlicense and inst_dir parameters are required. ```batch cscript serverinst.vbs --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Launch server installation on Windows Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=pdufv91v1-performing-direct-upgrade-dynamic-domain-manager-its-backups-their-database Start the server installation process on Windows operating systems by running the serverinst.vbs script. The acceptlicense and inst_dir parameters are mandatory. ```batch cscript serverinst.vbs --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Example output for schema query Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=maintenance-administrative-tasks-oracle Sample output format when querying installed schemas. ```text SCHEMA_NAME ------------------------------ MDL mdm10.2.6 <˂TWS_user>> ``` -------------------------------- ### REXX example for NetView to stop a started task Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=groups-scheduling-closedown-online-systems-started-tasks This REXX code snippet is an example of how to intercept the EQQW776I message from IBM Z Workload Scheduler and stop a started task using NetView. Refer to the member EQQNETW1 in the sample library for the full example. ```REXX /* EQQNETW1 - Sample REXX exec to stop a started task */ ARG msgid msgtext /* Check if the message is EQQW776I */ IF msgid = 'EQQW776I' THEN DO SAY 'Intercepted EQQW776I message: ' msgtext /* Extract the started task name from msgtext */ /* The format of msgtext is typically: EQQW776I STARTED TASK taskname IS SCHEDULED TO BE STOPPED */ PARSE VAR msgtext . 'STARTED TASK' taskname . 'IS SCHEDULED TO BE STOPPED' IF taskname \= '' THEN DO SAY 'Stopping started task: ' taskname /* Issue the NetView command to stop the started task */ "STOP taskname" END END EXIT 0 ``` -------------------------------- ### Referenced Procedure with STARTING Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=cleanup-generating-copies-data-store Example of a procedure using the STARTING referback in a COND statement. ```JCL //XXXSPRO PROC //S1 EXEC PGM=IEFBR14,COND=(0,NE,STARTING.S1) //PEND ``` -------------------------------- ### INIT Instruction Examples Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=ocl-init Examples demonstrating the configuration of variable tables, subsystem names, and sorting parameters. ```text INIT VARTAB(&OADID) SUBSYS(OPCC) INIT SUBSYS(OPCC) INIT SORT(MAX) ``` -------------------------------- ### Started Task Procedure Definition Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=cleanup-generating-copies-data-store Example of a procedure definition used in a started task. ```JCL //FRED PROC //S1 EXEC PGM=IEFBR14 //S2 EXEC XXXSPRO // PEND ``` -------------------------------- ### Launch installation script Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-performing-direct-upgrade-master-domain-manager Execute the serverinst script to perform the upgrade, ensuring required parameters are provided. ```vbs cscript serverinst.vbs --acceptlicense yes --inst_dir INST_DIR ``` ```shell ./serverinst.sh --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Crit format example Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=showjobs-crit-format This example shows the output of the '%sj @#@;crit' command, illustrating critical job information including CPU, Schedule, Job, State, Priority, Estimated Start, Estimated Elapse, CP flag, and Critical Start. ```text %sj @#@;crit ``` ```text (Est) (Est) Crit CPU Schedule SchedTime Job State Pr Start Elapse CP Start MYCPU_F+#JSA 1600 03/05 ******** HOLD 10 JOBA1 HOLD 10 CP 1759 03/05 JOBA2 HOLD 10 1758 03/05 JOBA3 HOLD 10 1757 03/05 JOBA4 HOLD 10 C 1659 03/05 ``` -------------------------------- ### Launch server installation on UNIX Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=pdufv91v1-performing-direct-upgrade-dynamic-domain-manager-its-backups-their-database Initiate the server installation on UNIX operating systems using the serverinst.sh script. Ensure to provide the --acceptlicense yes and --inst_dir INST_DIR arguments. ```shell ./serverinst.sh --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Define Absolute Interval Start Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=statements-adxiv Example configuration for starting an absolute interval at 10:30 on the day before the successor's input arrival. ```text ADXIVFHH(10) ADXIVFMM(30) ADXIVFD(1) ADXIVFWHE(B) ``` -------------------------------- ### Define a Job Stream with Scheduled Start Time Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=showjobs-standard-format Example of a job stream definition scheduled for 17:00 with a job starting at 18:00. ```text SCHEDULE MASTERB1#JS_B ON RUNCYCLE RULE1 "FREQ=DAILY;" AT 1700 : MASTERB1#JOB1 AT 1800 END ``` -------------------------------- ### Install backup dynamic domain manager via serverinst Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-installing-new-backup-dynamic-domain-manager Executes the installation script with required database, user, and security parameters. Command line arguments override values defined in the serverinst.properties file. ```windows cscript serverinst.vbs --acceptlicense yes --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name --dbuser db_user --dbpassword db_password --wauser wa_user --wapassword wa_password --componenttype DDM --domain domain_name --master mdm_name --mdmbrokerhostname mdm_broker_host_name --sslkeysfolder certificate_files_path --sslpassword keystore_truststore_password --mdmhttpsport mdm_https_host_name --wlpdir Liberty_installation_dir\wlp ``` ```unix ./serverinst.sh --acceptlicense yes --rdbmstype db_type ``` -------------------------------- ### Filter Rows Not Starting with Specific Characters Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=substitution-object-variables Use VARSUB SCAN and VARSCAN with the FILTER(NE) option to exclude rows that start with specified characters. This example filters out rows starting with 'W' or 'I'. ```JCL VARSUB SCAN READ IEBGENR.SYSUT2 SOURCE(SYSOUT) OBJECT(MYOBJ) CLIP(1) DO RX = 1 TO !@MYOBJ VARSCAN MYOBJ FILTER(NE) TARGET(W,I) CURSOR(RX,CX) COLS(001,001) ACTION(ITERATE) WRITE OUTDATA "@V(@MYOBJ-!RX)" END ``` -------------------------------- ### Complete djobmanrc.cmd example Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=environment-customizing-job-processing-windows-workstation-djobmanrccmd A full example of a configured djobmanrc.cmd file including environment variables and launch logic. ```batch @ECHO OFF echo Invoking %USERNAME% DJOBMANRC.CMD V.1 set USERPROFILE=%USERPROFILE% ::Setup User Environment Phase set ALLUSERSPROFILE=C:\Documents and Settings\All Users set APPDATA=C:\Documents and Settings\petes\Application Data set CommonProgramFiles=C:\Program Files\Common Files set COMPUTERNAME=PSOTOJ set ComSpec=C:\WINDOWS\system32\cmd.exe set CURDRIVE=C set FP_NO_HOST_CHECK=NOset set HOMEDRIVE=c: set HOMEPATH=\docs set LOGONSERVER=\\PSOTOJ set NEWVAR=c:\tmp\tmp\mlist1 set NUMBER_OF_PROCESSORS=1 set OPC_CLIENT_ROOT=C:\opc\Client set OS=Windows_NT set Path=C:\Program Files\utils;C:\PROGRAM FILES\THINKPAD\UTILITIES;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\Program Files\IBM\Infoprint Select;C:\Utilities;C:\Notes;C:\Program Files\IBM\Trace Facility\;C:\Program Files\IBM\Personal Communications\;C:\Program Files\XLView\;C:\lotus\compnent\;C:\WINDOWS\Downloaded Program Files;C:\Program Files\Symantec\pcAnywhere\;"C:\Program Files\Symantec\Norton Ghost 2003";C:\Infoprint; set PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH set PCOMM_Root=C:\Program Files\IBM\Personal Communications\ set PDBASE=C:\Program Files\IBM\Infoprint Select set PDHOST= set PD_SOCKET=6874 set PROCESSOR_ARCHITECTURE=x86 set PROCESSOR_IDENTIFIER=x86 Family 6 Model 9 Stepping 5, GenuineIntel set PROCESSOR_LEVEL=6 set PROCESSOR_REVISION=0905 set ProgramFiles=C:\Program Files set PROMPT=$P$G set SESSIONNAME=Console set SystemDrive=C: set SystemRoot=C:\WINDOWS set TEMP=C:\DOCUME˜1\petes\LOCALS˜1\Temp set TMP=C:\DOCUME˜1\petes\LOCALS˜1\Temp set tvdebugflags=0x260 set tvlogsessioncount=5000 set TWS4APPS_JDKHOME=c:\win32app\TWS\pete\methods\_tools set USERDOMAIN=PSOTOJ set USERNAME=petes set USERPROFILE=C:\Documents and Settings\petes set windir=C:\WINDOWSPATH=c:\win32app\tws\twsuser:c:\win32app\tws\twsuser\bin:%PATH% set PATH=c:\win32app\TWS\twsuser;c:\win32app\TWS\twsuser\bin;%PATH% set EMAIL_ID=johndoe@yourcompany.com ::Launch Operation Phase %ARGS% ::Post Operations Phase :out ``` -------------------------------- ### General installation configuration Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=reference-server-components-installation-serverinst-script Sets basic installation parameters such as license acceptance and directory paths. ```shell cscript serverinst.vbs --acceptlicense yes|no [--lang lang_id] [--inst_dir install_dir] [--work_dir working_dir] [--skipcheckprereq true|false] [--skipcheckemptydir true|false] [--skipusercheck true|false] ``` ```shell ./serverinst.sh --acceptlicense yes|no [--lang lang_id] [--inst_dir install_dir] [--work_dir working_dir] [--data_dir wa_datadir] [--skipcheckprereq true|false] [--skipcheckemptydir true|false] ``` -------------------------------- ### Job Stream Example with Same-Day Start Time Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=showschedules-standard-format Illustrates the output format for a job stream when its estimated start time is on the same day it is scheduled to run. The (Est)Start parameter shows only the time. ```text SCHEDULE MASTERB1#JS_B ON RUNCYCLE RULE1 "FREQ=DAILY;" AT 1800 : MASTERB1#JOB1 END ``` ```text %ss @#@ (Est) (Est) Jobs Sch CPU Schedule SchedTime State Pr Start Elapse # OK Lim MASTERB1#JS_B 1800 08/18 HOLD 10(18:00) 1 0 ``` -------------------------------- ### Example Options File Path for 'netmeth' Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=ami-method-options-file The options file must have the same path name as its access method, with an '.opts' extension. This example shows the Windows path for the 'netmeth' method. ```text TWS_home\methods\netmeth.opts ``` -------------------------------- ### Start IBM Workload Scheduler services Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-performing-direct-upgrade-backup-master-domain-manager Start IBM Workload Scheduler services and WebSphere Application Server Liberty after the installation has completed. ```bash conman start conman startappserver StartUpLwa ``` -------------------------------- ### Manual Installation Steps Overview Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=configuring-run-eelinst-installation-aid This section lists the additional manual steps required to complete the installation on your z/OS environment. These include setting up exits, updating system libraries, and configuring security and network settings. ```text o Add SMF and JES event tracking exits. Complete this step only if you do not already have an IBM Z Workload Scheduler tracker active on the z/OS system. Otherwise, see the Scheduling with the Agent for z/OS manual. manual. o Update SYS1.PARMLIB. - Define the Agent for z/OS subsystem (IEFSSNnn). - Authorize the Agent for z/OS load module library (IEAAPFnn or PROgnn). - Update dump-content definitions. - Update the z/OS link-library definition (LNKLSTnn). - Update SMF parameters (SMFPRMnn). Apply this change only if you do not already run an IBM Z Workload Scheduler tracker on the z/OS system. - Choose whether to start the Agent for z/OS automatically (COMMNDnn). o Set up the RACF environment. o Set up the SSL environment. - Create as many private keys, certificates, and trusted certification authority (CA) chains as you plan to use in your network. - Configure the scheduler, by specifying the HTTPOPTS statement for each component of your network. o Update SYS1.PROCLIB. - Create a JCL procedure for the z/OS address space. o Activate TCP/IP connections. - Add TCP/IP network definitions. Define an IP address for the Agent for z/OS. - Add TCP/IP initialization options. Include initialization statement options in ``` -------------------------------- ### Define Absolute Interval Start Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=statements-adapd Example configuration for starting an absolute interval at 10:30 on the day before the successor's input arrival time. ```text APDIVFHH(10) APDIVFMM(30) APDIVFD(1) APDIVFWHE(B) ``` -------------------------------- ### Run the dbsetup command Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=birt-creating-database-in-distributed-environment Executes the database setup script with required positional parameters. ```shell dbsetup dbName dbTableSpace dbDataDir port db2Admin db2AdminPwd db2TablePrefix ``` ```shell dbsetup dbweb tsdbweb twsdbweb_data 50000 db2inst1 mypwd myprefix ``` -------------------------------- ### Start Event Processor using conman Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=emp-troubleshooting-event-rule-that-does-not-trigger-required-action Use this command to start the event processor when it is installed but not running. This is indicated by a lowercase 'e' in the STATE field. ```shell %startevtproc AWSJCL528I The event processor has been started successfully. ``` -------------------------------- ### Show serverinst command usage Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=reference-server-components-installation-serverinst-script Displays help information for the installation script. ```shell cscript serverinst.vbs -? | --usage | --help ``` ```shell ./serverinst.sh -? | --usage | --help ``` -------------------------------- ### StartUp Command Syntax Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=descriptions-startup Displays the syntax for the StartUp command. Use -V for version and -U for usage information. ```bash StartUp [ -V | -U ] ``` -------------------------------- ### Configure SHUTDOWNPOLICY Examples Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=statements-jtopts Examples demonstrating how different SHUTDOWNPOLICY values affect whether an operation starts based on estimated duration and remaining workstation time. ```text SHUTDOWNPOLICY(0) ``` ```text SHUTDOWNPOLICY(50) ``` ```text SHUTDOWNPOLICY(100) ``` ```text SHUTDOWNPOLICY(200) ``` -------------------------------- ### Upgrade agent instance example Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=cli-upgrading-when-there-are-corrupt-registry-files Example commands for upgrading an agent instance and recovering registry files. ```shell cscript twsinst -update -uname twsuser -password twspassword -acceptlicense yes -inst_dir "C:\Program Files\IBM\TWA" -recovInstReg true ``` ```shell ./twsinst -update -uname twsuser -inst_dir /opt/IBM/TWA -acceptlicense yes -recovInstReg true ``` -------------------------------- ### Start Z Monitoring agent Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=iczma-installing-configuring-z-monitoring-agent-in-local-environment Execute this command from the ITMagent_install_dir/bin directory to start the Z Monitoring agent. Replace ITMagent_instance_name with the actual instance name you specified during configuration. ```bash ./itmcmd agent -o ITMagent_instance_name start 20 ``` -------------------------------- ### Job Stream Example with Different-Day Start Time Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=showschedules-standard-format Demonstrates the output format for a job stream when its estimated start time is on a different day than its scheduled run time. The (Est)Start parameter includes both the date and time. ```text SCHEDULE MASTERB1#JS_A ON RUNCYCLE RULE1 "FREQ=DAILY;" AT 0500 : MASTERB1#JOB1 END ``` ```text %ss @#@ (Est) (Est) Jobs Sch CPU Schedule SchedTime State Pr Start Elapse # OK Lim MASTERB1#JS_A 0500 08/19 HOLD 10(08/19) 1 0 ``` -------------------------------- ### Install dynamic domain manager as backup on UNIX Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=pufv91v1-installing-new-dynamic-domain-manager-configured-as-backup Use the serverinst.sh script to perform the installation on UNIX-based systems. ```bash ./serverinst.sh --acceptlicense yes --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name ``` -------------------------------- ### Include users with same attribute type Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=attributes-selection-expressions Combine basic selection expressions of the same attribute type using '+'. This example selects groups starting with 'j' and groups starting with 'z'. ```text group=j@+group=z@ ``` -------------------------------- ### Example Configuration with Automatic Mapping Enabled Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=console-creating-eqqadmin-class-associate-racf-user-id This example demonstrates the configuration when automatic mapping is enabled and specific user profiles are defined. It shows how authorized users like ROOT and ROBINSON can access the system. ```shell RDEFINE EQQADMIN AUTOMAPPING APPLDATA(‘YES’) RDEFINE EQQADMIN admin@EU-HWS-LNX73.xyz.com APPLDATA(‘ROOT’) ``` -------------------------------- ### Original JCL for Started Task Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=cleanup-generating-copies-data-store Example of a simple JCL procedure before controller modification. ```JCL //MYSTC PROC //MYSTC EXEC PGM=IEFBR14 ``` -------------------------------- ### Sample trace configuration output Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=agent-twstrace-command-syntax Example of running the query command and the resulting output. ```shell twstrace -level -maxFiles -maxFileBytes ``` ```text AWSITA176I The trace properties are: level="1000", max files="3", file size="1024000". ``` -------------------------------- ### Run Print and Version Commands, then Prompt Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=program-running-composer Execute the print and version commands and then prompt for further commands. Assumes connection parameters are set in local configuration scripts. ```bash composer "p parms&v&" ``` -------------------------------- ### Export Start Reader Time Property Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=vpbjisjsi-passing-job-properties-from-one-job-another-in-same-job-stream-instance This example illustrates how to export the Start Reader Time property from a dynamic job on IBM Z Workload Scheduler Agent to another job. This corresponds to the 'Start Reader Time' Extra Information property. ```shell ${job:.zAgentStartReaderTime} ``` -------------------------------- ### Install Dynamic Workload Console on UNIX Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-upgrading-dynamic-workload-console-its-database Launch this command to start the Dynamic Workload Console upgrade on UNIX operating systems. Ensure to accept the license and specify the installation directory. ```shell ./dwcinst.sh --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Sample INIT Statement Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=statements-init Example of an INIT statement with SUBSYS, HIGHDATE, CWBASE, and LUNAME parameters. ```JCL INIT SUBSYS(OPCB) HIGHDATE(991231) CWBASE(72) LUNAME(SEIBM200.IS4MSV3B) ``` -------------------------------- ### Install Dynamic Workload Console on Windows Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=1026-upgrading-dynamic-workload-console-its-database Launch this command to start the Dynamic Workload Console upgrade on Windows operating systems. Ensure to accept the license and specify the installation directory. ```batch cscript dwcinst.vbs --acceptlicense yes --inst_dir INST_DIR ``` -------------------------------- ### Install Dynamic Domain Manager via serverinst Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=iddc-installing-dynamic-domain-manager-backup-dynamic-domain-manager Use these commands to install the dynamic domain manager component. Ensure all required database and user parameters are provided. ```shell cscript serverinst.vbs --acceptlicense yes --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name --dbuser db_user --dbpassword db_password --wauser wa_user --wapassword wa_password --componenttype DDM --domain domain_name --master mdm_name --mdmbrokerhostname mdm_broker_host_name --mdmhttpsport mdm_https_host_name --wlpdir Liberty_installation_dir\wlp ``` ```shell ./serverinst.sh --acceptlicense yes --rdbmstype db_type --dbhostname db_hostname --dbport db_port --dbname db_name --dbuser db_user --dbpassword db_password --wauser wa_user --wapassword wa_password --componenttype DDM --domain domain_name --master mdm_name --mdmbrokerhostname mdm_broker_host_name --mdmhttpsport mdm_https_host_name --wlpdir Liberty_installation_dir/wlp ``` -------------------------------- ### Select objects starting with specific characters Source: https://www.ibm.com/docs/en/workload-automation/10.2.6?topic=reports-regular-expressions Use a character class '[...]' to select objects that begin with one of the specified characters. This example filters for items starting with 'A', 'B', or 'C'. ```regex [ABC].* ```